feat(scheduledrun): add cron-based agent execution

go/api/config/crd/bases/kagent.dev_scheduledruns.yaml

@@ -0,0 +1,220 @@
+---
+apiVersion: apiextensions.k8s.io/v1
+kind: CustomResourceDefinition
+metadata:
+  annotations:
+    controller-gen.kubebuilder.io/version: v0.19.0
+  name: scheduledruns.kagent.dev
+spec:
+  group: kagent.dev
+  names:
+    kind: ScheduledRun
+    listKind: ScheduledRunList
+    plural: scheduledruns
+    singular: scheduledrun
+  scope: Namespaced
+  versions:
+  - additionalPrinterColumns:
+    - jsonPath: .spec.schedule
+      name: Schedule
+      type: string
+    - jsonPath: .spec.suspend
+      name: Suspend
+      type: boolean
+    - jsonPath: .status.lastRunTime
+      name: Last Run
+      type: date
+    - jsonPath: .status.nextRunTime
+      name: Next Run
+      type: string
+    name: v1alpha2
+    schema:
+      openAPIV3Schema:
+        description: ScheduledRun is the Schema for the scheduledruns API.
+        properties:
+          apiVersion:
+            description: |-
+              APIVersion defines the versioned schema of this representation of an object.
+              Servers should convert recognized schemas to the latest internal value, and
+              may reject unrecognized values.
+              More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
+            type: string
+          kind:
+            description: |-
+              Kind is a string value representing the REST resource this object represents.
+              Servers may infer this from the endpoint the client submits requests to.
+              Cannot be updated.
+              In CamelCase.
+              More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+            type: string
+          metadata:
+            type: object
+          spec:
+            description: ScheduledRunSpec defines the desired state of ScheduledRun.
+            properties:
+              agentRef:
+                description: |-
+                  AgentRef is a reference to the Agent or SandboxAgent to execute. If
+                  Namespace is empty it defaults to the ScheduledRun's namespace.
+                properties:
+                  kind:
+                    default: Agent
+                    description: Kind selects the resource kind to run. Defaults to
+                      Agent.
+                    enum:
+                    - Agent
+                    - SandboxAgent
+                    type: string
+                  name:
+                    maxLength: 253
+                    minLength: 1
+                    pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?)(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$
+                    type: string
+                  namespace:
+                    maxLength: 63
+                    pattern: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
+                    type: string
+                required:
+                - name
+                type: object
+              maxRunHistory:
+                default: 10
+                description: MaxRunHistory is the maximum number of run history entries
+                  to retain.
+                maximum: 100
+                minimum: 1
+                type: integer
+              prompt:
+                description: Prompt is the text prompt to send to the agent on each
+                  run.
+                minLength: 1
+                type: string
+              schedule:
+                description: |-
+                  Schedule is a cron expression defining when to run the agent. Standard
+                  5-field cron syntax (minute hour day-of-month month day-of-week).
+                minLength: 1
+                type: string
+              suspend:
+                default: false
+                description: Suspend pauses scheduling and manual triggers when set
+                  to true.
+                type: boolean
+              timeZone:
+                default: UTC
+                description: |-
+                  TimeZone is an IANA time zone name (e.g. "America/Los_Angeles") used
+                  to interpret Schedule. Defaults to UTC.
+                type: string
+            required:
+            - agentRef
+            - prompt
+            - schedule
+            type: object
+          status:
+            description: ScheduledRunStatus defines the observed state of ScheduledRun.
+            properties:
+              conditions:
+                items:
+                  description: Condition contains details for one aspect of the current
+                    state of this API Resource.
+                  properties:
+                    lastTransitionTime:
+                      description: |-
+                        lastTransitionTime is the last time the condition transitioned from one status to another.
+                        This should be when the underlying condition changed.  If that is not known, then using the time when the API field changed is acceptable.
+                      format: date-time
+                      type: string
+                    message:
+                      description: |-
+                        message is a human readable message indicating details about the transition.
+                        This may be an empty string.
+                      maxLength: 32768
+                      type: string
+                    observedGeneration:
+                      description: |-
+                        observedGeneration represents the .metadata.generation that the condition was set based upon.
+                        For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
+                        with respect to the current state of the instance.
+                      format: int64
+                      minimum: 0
+                      type: integer
+                    reason:
+                      description: |-
+                        reason contains a programmatic identifier indicating the reason for the condition's last transition.
+                        Producers of specific condition types may define expected values and meanings for this field,
+                        and whether the values are considered a guaranteed API.
+                        The value should be a CamelCase string.
+                        This field may not be empty.
+                      maxLength: 1024
+                      minLength: 1
+                      pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
+                      type: string
+                    status:
+                      description: status of the condition, one of True, False, Unknown.
+                      enum:
+                      - "True"
+                      - "False"
+                      - Unknown
+                      type: string
+                    type:
+                      description: type of condition in CamelCase or in foo.example.com/CamelCase.
+                      maxLength: 316
+                      pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
+                      type: string
+                  required:
+                  - lastTransitionTime
+                  - message
+                  - reason
+                  - status
+                  - type
+                  type: object
+                type: array
+              lastRunTime:
+                format: date-time
+                type: string
+              nextRunTime:
+                format: date-time
+                type: string
+              observedGeneration:
+                format: int64
+                type: integer
+              runHistory:
+                items:
+                  description: |-
+                    RunHistoryEntry records one execution of a scheduled run. Status starts as
+                    either DispatchFailed (terminal) or Pending, then transitions to a terminal
+                    state once outcome polling resolves.
+                  properties:
+                    endTime:
+                      description: |-
+                        EndTime is set when Status reaches a terminal state — either
+                        immediately on DispatchFailed, or when outcome polling resolves.
+                      format: date-time
+                      type: string
+                    message:
+                      description: |-
+                        Message carries the dispatch error on DispatchFailed, or the agent's
+                        terminal status message on Failed/Timeout.
+                      type: string
+                    sessionId:
+                      type: string
+                    startTime:
+                      format: date-time
+                      type: string
+                    status:
+                      enum:
+                      - DispatchFailed
+                      - Pending
+                      - Succeeded
+                      - Failed
+                      - Timeout
+                      type: string
+                  type: object
+                type: array
+            type: object
+        type: object
+    served: true
+    storage: true
+    subresources:
+      status: {}