@swiss-ai-hub/web 0.318.0 → 0.320.0

package/sdk/client/schemas.gen.ts

@@ -409,6 +409,9 @@ export const AgentClassDTOSchema = {
           {
             $ref: "#/components/schemas/ColorPicker",
           },
+          {
+            $ref: "#/components/schemas/CronInput",
+          },
           {
             $ref: "#/components/schemas/DatePicker",
           },
@@ -543,6 +546,13 @@ export const AgentClassDTOSchema = {
       description:
         "Whether the agent class can participate in a chat-based conversation",
     },
+    is_schedulable: {
+      type: "boolean",
+      title: "Is Schedulable",
+      description:
+        "Whether the agent class can be run automatically on a cron schedule",
+      default: false,
+    },
     is_online: {
       anyOf: [
         {
@@ -630,6 +640,9 @@ export const AgentConfigDTOSchema = {
               {
                 $ref: "#/components/schemas/ColorPicker",
               },
+              {
+                $ref: "#/components/schemas/CronInput",
+              },
               {
                 $ref: "#/components/schemas/DatePicker",
               },
@@ -5634,6 +5647,9 @@ export const ContextualizedAgentEventSchema = {
         {
           $ref: "#/components/schemas/RAGStartEvent",
         },
+        {
+          $ref: "#/components/schemas/CronStartEvent",
+        },
         {
           $ref: "#/components/schemas/ExceptionEvent",
         },
@@ -5706,6 +5722,9 @@ export const ContextualizedAgentEventSchema = {
         {
           $ref: "#/components/schemas/MailBatchDraftedEvent",
         },
+        {
+          $ref: "#/components/schemas/MailBatchClassifiedEvent",
+        },
       ],
       title: "Event",
       description: "Data of the event itself.",
@@ -6048,6 +6067,278 @@ export const CreateTokenResponseSchema = {
   title: "CreateTokenResponse",
 } as const;
 
+export const CronInputSchema = {
+  properties: {
+    is_formkit_element: {
+      type: "boolean",
+      const: true,
+      title: "Is Formkit Element",
+      description: "Indicates that this element is a FormKit element",
+      default: true,
+    },
+    if: {
+      anyOf: [
+        {
+          type: "string",
+          pattern: "^\\$.+",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "If",
+      description: "Conditional expression to show this element",
+    },
+    id: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Id",
+      description: "Unique identifier for this element",
+    },
+    nullable: {
+      type: "boolean",
+      title: "Nullable",
+      description:
+        "Render with a sibling toggle that sets this field to null when off",
+      default: false,
+    },
+    defaultEnabled: {
+      anyOf: [
+        {
+          type: "boolean",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Defaultenabled",
+      description:
+        "For a nullable element, whether its toggle should start enabled on a fresh form (i.e. the field's data default is non-null). Ignored for non-nullable elements.",
+    },
+    formkit: {
+      type: "string",
+      const: "cronInput",
+      title: "Formkit",
+      description: "Cron schedule input element.",
+      default: "cronInput",
+    },
+    name: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Name",
+      description: "Name of this field",
+    },
+    label: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/LocaleString",
+        },
+        {
+          type: "string",
+        },
+      ],
+      title: "Label",
+      description: "Label of this field",
+    },
+    help: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/LocaleString",
+        },
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Help",
+      description: "Help text of this field",
+    },
+    value: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "integer",
+        },
+        {
+          type: "number",
+        },
+        {
+          type: "boolean",
+        },
+        {
+          items: {
+            type: "string",
+          },
+          type: "array",
+        },
+        {
+          additionalProperties: {
+            type: "string",
+          },
+          type: "object",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Value",
+      description: "Default value for this field",
+    },
+    required: {
+      type: "boolean",
+      title: "Required",
+      description: "Whether this field is required",
+      default: false,
+    },
+    additional_validation_rules: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Additional Validation Rules",
+      description: "Validation expression",
+    },
+    timezonePlaceholder: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/LocaleString",
+        },
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Timezoneplaceholder",
+      description: "Placeholder for the timezone select",
+    },
+    filter: {
+      type: "boolean",
+      title: "Filter",
+      description: "Whether to enable filtering/search on the timezone select",
+      default: true,
+    },
+    validation: {
+      type: "string",
+      title: "Validation",
+      readOnly: true,
+    },
+  },
+  additionalProperties: true,
+  type: "object",
+  required: ["label", "validation"],
+  title: "CronInput",
+  description:
+    'A FormKit element for editing the cron schedule of a schedulable agent profile.\n\nThe element renders the five cron positions plus a timezone selector, and the submitted value\nmatches the fields of `CronSchedule`:\n{\n    "minute": str,\n    "hour": str,\n    "day_of_month": str,\n    "month": str,\n    "day_of_week": str,\n    "timezone": str,\n}\n\nPresets and the plain-language summary of the current schedule are delivered by the Admin UI\n(see the cron schedule configuration UI issue); this element only declares the contract.\n\n### Form Duality\n```python\nfrom swiss_ai_hub.core.form.elements.cron_input import CronInput\nfrom swiss_ai_hub.core.scheduling.cron_schedule import CronSchedule\n\nclass MyAgentConfig(AgentConfig):\n    schedule: Annotated[\n        CronSchedule | CronInput | None,\n        Field(description="When this profile runs automatically"),\n    ] = None\n\n# Form mode - for rendering:\nconfig = MyAgentConfig(schedule=CronInput(label=LocaleString(en="Schedule")))\n\n# Data mode - from submission (Pydantic validates into CronSchedule):\nconfig = MyAgentConfig(schedule=CronSchedule(hour="12", timezone="Europe/Zurich"))\n```',
+} as const;
+
+export const CronStartEventSchema = {
+  properties: {
+    event_id: {
+      type: "string",
+      title: "Event Id",
+    },
+    created_at: {
+      type: "integer",
+      title: "Created At",
+      description:
+        "The time (in ns since epoch) the event was stored in the event store",
+    },
+    display_name: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/LocaleString",
+        },
+        {
+          type: "null",
+        },
+      ],
+      description: "Display name for the event",
+    },
+    display_description: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/LocaleString",
+        },
+        {
+          type: "null",
+        },
+      ],
+      description: "Display description for the event",
+    },
+    locale: {
+      type: "string",
+      title: "Locale",
+      description:
+        "The locale the scheduled run reports its display output in.",
+      default: "de",
+    },
+    user: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/UserIdentity",
+        },
+        {
+          type: "null",
+        },
+      ],
+      description:
+        "Always None — scheduled runs are system-initiated and carry no execution identity.",
+    },
+    scheduled_for: {
+      type: "string",
+      format: "date-time",
+      title: "Scheduled For",
+      description:
+        "The cron occurrence this run fires for, in UTC. Distinct from `created_at`, which records when the scheduler published the event — the two differ by the scheduler's tick latency.",
+    },
+    _event_name: {
+      type: "string",
+      title: "Event Name",
+      description:
+        "The event type name, usually the class name. If unknown, uses _unknown_event_name.\nUsed during deserialization to decide which subclass to instantiate.",
+      readOnly: true,
+    },
+    _parent_event_names: {
+      items: {
+        type: "string",
+      },
+      type: "array",
+      title: "Parent Event Names",
+      description:
+        "Contains the names of all parent classes up until BaseEvent, ordered from deepest to least deep inheritance.",
+      readOnly: true,
+    },
+  },
+  additionalProperties: true,
+  type: "object",
+  required: ["scheduled_for", "_event_name", "_parent_event_names"],
+  title: "CronStartEvent",
+  description:
+    "Start event fired by the cron scheduler — handling it is what makes an agent schedulable.\n\nMirrors how accepting a `UserMessageEvent` makes an agent conversational: `AgentRunner` derives\n`is_schedulable` from the start events an agent declares, so a blueprint opts in by adding a step\nthat consumes this event, with no separate registration.\n\nScheduled runs are system runs, so `user` is always None and the agent must not depend on an\ninitiating identity. Whatever tenant context the agent needs comes from its own profile\nconfiguration (as `OrgMemoryWriteConfig.tenant_id` already does), never from the run.",
+} as const;
+
 export const Custom_OutputSchema = {
   properties: {
     input: {
@@ -7229,7 +7520,21 @@ export const DraftedReplyRefSchema = {
     source_uid: {
       type: "string",
       title: "Source Uid",
-      description: "IMAP UID of the source message within the source folder.",
+      description:
+        "IMAP UID the source message had in the folder it was read from. A blueprint that files the message before drafting (EmailClassificationAgent) reports the pre-move UID, which no longer resolves on the server — it identifies the message within the run, not for a later fetch.",
+    },
+    category: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Category",
+      description:
+        "Category the source message was classified under, when drafting followed a classification run. Null when the drafting blueprint does not classify.",
     },
     drafts_folder: {
       type: "string",
@@ -8057,6 +8362,13 @@ export const FullAgentInstanceDTOSchema = {
       description:
         "Whether the agent can participate in a chat-based conversation",
     },
+    is_schedulable: {
+      type: "boolean",
+      title: "Is Schedulable",
+      description:
+        "Whether the agent can be run automatically on a cron schedule",
+      default: false,
+    },
     start_events: {
       items: {
         $ref: "#/components/schemas/EventSpecs",
@@ -8218,6 +8530,9 @@ export const FullProcessInstanceDTOSchema = {
           {
             $ref: "#/components/schemas/ColorPicker",
           },
+          {
+            $ref: "#/components/schemas/CronInput",
+          },
           {
             $ref: "#/components/schemas/DatePicker",
           },
@@ -8513,6 +8828,9 @@ export const GroupSchema = {
           {
             $ref: "#/components/schemas/ColorPicker",
           },
+          {
+            $ref: "#/components/schemas/CronInput",
+          },
           {
             $ref: "#/components/schemas/DatePicker",
           },
@@ -9029,6 +9347,9 @@ export const HumanInDTOSchema = {
           {
             $ref: "#/components/schemas/ColorPicker",
           },
+          {
+            $ref: "#/components/schemas/CronInput",
+          },
           {
             $ref: "#/components/schemas/DatePicker",
           },
@@ -9175,6 +9496,9 @@ export const HumanInSpecsSchema = {
           {
             $ref: "#/components/schemas/ColorPicker",
           },
+          {
+            $ref: "#/components/schemas/CronInput",
+          },
           {
             $ref: "#/components/schemas/DatePicker",
           },
@@ -12707,6 +13031,32 @@ export const LLMCostEventSchema = {
       description:
         "The name of the LLM service (e.g., 'openai/gpt-4') this event pertains to.",
     },
+    user_id: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "User Id",
+      description:
+        "Invoking user, so spend is queryable per user. None for runs with no user context.",
+    },
+    tenant_id: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Tenant Id",
+      description:
+        "Acting tenant, so spend is queryable per tenant. None for sysadmins and system runs.",
+    },
     _event_name: {
       type: "string",
       title: "Event Name",
@@ -12973,6 +13323,69 @@ export const LLMEventSchema = {
   title: "LLMEvent",
 } as const;
 
+export const LLMSpendSchema = {
+  properties: {
+    user_id: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "User Id",
+      description: "Invoking user, None when grouping by tenant.",
+    },
+    tenant_id: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Tenant Id",
+      description: "Acting tenant, None for runs outside a tenant.",
+    },
+    calls: {
+      type: "integer",
+      title: "Calls",
+      description: "Number of LLM calls attributed to this key.",
+      default: 0,
+    },
+    prompt_tokens_costs: {
+      type: "number",
+      title: "Prompt Tokens Costs",
+      description: "Cost of prompt tokens.",
+      default: 0,
+    },
+    completion_tokens_costs: {
+      type: "number",
+      title: "Completion Tokens Costs",
+      description: "Cost of completion tokens.",
+      default: 0,
+    },
+    embedding_tokens_costs: {
+      type: "number",
+      title: "Embedding Tokens Costs",
+      description: "Cost of embedding tokens.",
+      default: 0,
+    },
+    total_costs: {
+      type: "number",
+      title: "Total Costs",
+      description: "Sum of prompt, completion and embedding costs.",
+      default: 0,
+    },
+  },
+  type: "object",
+  title: "LLMSpend",
+  description:
+    "LLM spend aggregated over one attribution key (a user or a tenant).\n\nCosts come from the platform's own `LLMCostEvent` records rather than from LiteLLM's spend log:\nthe gateway can only attribute the user, so the tenant dimension exists here alone (see #1451).",
+} as const;
+
 export const LLMStopEventSchema = {
   properties: {
     event_id: {
@@ -13689,6 +14102,8 @@ export const LocaleInputSchema = {
     validation: {
       type: "string",
       title: "Validation",
+      description:
+        "Emits `localeRequired` where other elements emit FormKit's `required`.\n\nFormKit's `required` rule only asks whether a value is present, and this element's\nvalue is always a `{de, en, fr, it}` object — non-empty, therefore passing, even when\nevery locale inside it is blank. `localeRequired` (registered in the frontend FormKit\nconfig) looks at the locale values themselves.",
       readOnly: true,
     },
   },
@@ -13859,7 +14274,7 @@ export const MailAttachmentRefSchema = {
     "Reference to a fetched mail attachment whose bytes are stored in S3, not carried in the event.\n\nMirrors ``UserUploadedFile``: attachments are referenced by ``file_id`` (the S3 object key within the\nagent's dedicated bucket) so large binaries never bloat the persisted/streamed event.",
 } as const;
 
-export const MailBatchDraftedEventSchema = {
+export const MailBatchClassifiedEventSchema = {
   properties: {
     event_id: {
       type: "string",
@@ -13896,165 +14311,44 @@ export const MailBatchDraftedEventSchema = {
     source_folder: {
       type: "string",
       title: "Source Folder",
-      description: "Folder the drafted messages were read from.",
+      description: "Folder the classified messages were read from.",
     },
     count: {
       type: "integer",
       title: "Count",
-      description: "Number of reply drafts created in this run.",
-    },
-    drafted: {
-      items: {
-        $ref: "#/components/schemas/DraftedReplyRef",
-      },
-      type: "array",
-      title: "Drafted",
-      description: "Per-message references to the created reply drafts.",
-    },
-    _event_name: {
-      type: "string",
-      title: "Event Name",
-      description:
-        "The event type name, usually the class name. If unknown, uses _unknown_event_name.\nUsed during deserialization to decide which subclass to instantiate.",
-      readOnly: true,
+      description: "Number of messages classified and filed in this run.",
     },
-    _parent_event_names: {
-      items: {
-        type: "string",
+    per_category: {
+      additionalProperties: {
+        type: "integer",
       },
-      type: "array",
-      title: "Parent Event Names",
+      type: "object",
+      title: "Per Category",
       description:
-        "Contains the names of all parent classes up until BaseEvent, ordered from deepest to least deep inheritance.",
-      readOnly: true,
-    },
-  },
-  additionalProperties: true,
-  type: "object",
-  required: ["source_folder", "count", "_event_name", "_parent_event_names"],
-  title: "MailBatchDraftedEvent",
-  description:
-    "Records that a batch of reply drafts was appended to the Drafts folder for a human to review and send.\n\nThe agent never sends — the drafts sitting in Drafts are the human handoff. Each source message is left unread and\nmarked as drafted so it is not drafted again on the next run.",
-} as const;
-
-export const MailFetchedEventSchema = {
-  properties: {
-    event_id: {
-      type: "string",
-      title: "Event Id",
+        "How many messages were filed under each configured category.",
     },
-    created_at: {
+    fallback_count: {
       type: "integer",
-      title: "Created At",
+      title: "Fallback Count",
       description:
-        "The time (in ns since epoch) the event was stored in the event store",
-    },
-    display_name: {
-      anyOf: [
-        {
-          $ref: "#/components/schemas/LocaleString",
-        },
-        {
-          type: "null",
-        },
-      ],
-      description: "Display name for the event",
-    },
-    display_description: {
-      anyOf: [
-        {
-          $ref: "#/components/schemas/LocaleString",
-        },
-        {
-          type: "null",
-        },
-      ],
-      description: "Display description for the event",
-    },
-    message_id: {
-      type: "string",
-      title: "Message Id",
-      description: "IMAP UID of the fetched message within the inbox folder.",
-    },
-    sender: {
-      type: "string",
-      title: "Sender",
-      description: "Raw From header of the message.",
-    },
-    subject: {
-      type: "string",
-      title: "Subject",
-      description: "Subject header of the message.",
-    },
-    date: {
-      anyOf: [
-        {
-          type: "string",
-          format: "date-time",
-        },
-        {
-          type: "null",
-        },
-      ],
-      title: "Date",
-      description: "Date header of the message, if parseable.",
-    },
-    body_text: {
-      anyOf: [
-        {
-          type: "string",
-        },
-        {
-          type: "null",
-        },
-      ],
-      title: "Body Text",
-      description: "Plain-text body of the message, if present.",
+        "How many messages went to the fallback folder instead of a category.",
+      default: 0,
     },
-    rfc_message_id: {
-      anyOf: [
-        {
-          type: "string",
-        },
-        {
-          type: "null",
-        },
-      ],
-      title: "Rfc Message Id",
+    failed_count: {
+      type: "integer",
+      title: "Failed Count",
       description:
-        "RFC Message-ID header of the message — used to thread a reply draft.",
-    },
-    references: {
-      anyOf: [
-        {
-          type: "string",
-        },
-        {
-          type: "null",
-        },
-      ],
-      title: "References",
-      description: "RFC References header of the message, if present.",
-    },
-    reply_to: {
-      anyOf: [
-        {
-          type: "string",
-        },
-        {
-          type: "null",
-        },
-      ],
-      title: "Reply To",
-      description: "Reply-To header of the message, if present.",
+        "How many messages the classifier could not reach a verdict on at all. They are filed into the failure folder rather than left in the inbox, where they would be re-selected on every run forever.",
+      default: 0,
     },
-    attachments: {
+    classified: {
       items: {
-        $ref: "#/components/schemas/MailAttachmentRef",
+        $ref: "#/components/schemas/MailClassificationRef",
       },
       type: "array",
-      title: "Attachments",
-      description: "References to the message's attachments stored in S3.",
+      title: "Classified",
+      description:
+        "Per-message classification verdicts and filing destinations.",
     },
     _event_name: {
       type: "string",
@@ -14076,19 +14370,382 @@ export const MailFetchedEventSchema = {
   },
   additionalProperties: true,
   type: "object",
-  required: [
-    "message_id",
-    "sender",
-    "subject",
-    "_event_name",
-    "_parent_event_names",
-  ],
-  title: "MailFetchedEvent",
+  required: ["source_folder", "count", "_event_name", "_parent_event_names"],
+  title: "MailBatchClassifiedEvent",
   description:
-    "Carries a single fetched message — headers, body, and references to its stored attachments.",
+    "Summarises one classification run: how many messages were classified and where each was filed.\n\nOne event per run rather than one per message, matching `MailBatchDraftedEvent` — the per-message detail rides in\n`classified`. Filing is what prevents reprocessing: every message leaves the source folder, so the next unread\nlisting cannot see it again.",
 } as const;
 
-export const MailMovedEventSchema = {
+export const MailBatchDraftedEventSchema = {
+  properties: {
+    event_id: {
+      type: "string",
+      title: "Event Id",
+    },
+    created_at: {
+      type: "integer",
+      title: "Created At",
+      description:
+        "The time (in ns since epoch) the event was stored in the event store",
+    },
+    display_name: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/LocaleString",
+        },
+        {
+          type: "null",
+        },
+      ],
+      description: "Display name for the event",
+    },
+    display_description: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/LocaleString",
+        },
+        {
+          type: "null",
+        },
+      ],
+      description: "Display description for the event",
+    },
+    source_folder: {
+      type: "string",
+      title: "Source Folder",
+      description: "Folder the drafted messages were read from.",
+    },
+    count: {
+      type: "integer",
+      title: "Count",
+      description: "Number of reply drafts created in this run.",
+    },
+    per_category: {
+      additionalProperties: {
+        type: "integer",
+      },
+      type: "object",
+      title: "Per Category",
+      description:
+        "How many drafts were created for each category, when drafting followed a classification run. Empty when the drafting blueprint does not classify.",
+    },
+    skipped_count: {
+      type: "integer",
+      title: "Skipped Count",
+      description:
+        "Messages in the batch that got no draft: usually because their category was not opted in, or no category fitted them at all.",
+      default: 0,
+    },
+    drafted: {
+      items: {
+        $ref: "#/components/schemas/DraftedReplyRef",
+      },
+      type: "array",
+      title: "Drafted",
+      description: "Per-message references to the created reply drafts.",
+    },
+    _event_name: {
+      type: "string",
+      title: "Event Name",
+      description:
+        "The event type name, usually the class name. If unknown, uses _unknown_event_name.\nUsed during deserialization to decide which subclass to instantiate.",
+      readOnly: true,
+    },
+    _parent_event_names: {
+      items: {
+        type: "string",
+      },
+      type: "array",
+      title: "Parent Event Names",
+      description:
+        "Contains the names of all parent classes up until BaseEvent, ordered from deepest to least deep inheritance.",
+      readOnly: true,
+    },
+  },
+  additionalProperties: true,
+  type: "object",
+  required: ["source_folder", "count", "_event_name", "_parent_event_names"],
+  title: "MailBatchDraftedEvent",
+  description:
+    "Records that a batch of reply drafts was appended to the Drafts folder for a human to review and send.\n\nThe agent never sends — the drafts sitting in Drafts are the human handoff. Each source message is left unread and\nmarked as drafted so it is not drafted again on the next run.",
+} as const;
+
+export const MailClassificationRefSchema = {
+  properties: {
+    message_id: {
+      type: "string",
+      title: "Message Id",
+      description: "IMAP UID of the message within the source folder.",
+    },
+    sender: {
+      type: "string",
+      title: "Sender",
+      description: "Raw From header of the message.",
+    },
+    subject: {
+      type: "string",
+      title: "Subject",
+      description: "Subject header of the message.",
+    },
+    category: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Category",
+      description:
+        "Configured category the message was filed under, or null when it went to the fallback folder because no category clearly fitted.",
+    },
+    target_folder: {
+      type: "string",
+      title: "Target Folder",
+      description: "Folder the message was filed into.",
+    },
+    reason: {
+      type: "string",
+      title: "Reason",
+      description:
+        "Model's stated reason for the choice — the audit trail for a misfile.",
+    },
+    folder_created: {
+      type: "boolean",
+      title: "Folder Created",
+      description:
+        "Whether this message's target folder was created during the run. Folders are created once up front for the whole batch, so every message routed to a newly created folder carries this, not only the first one.",
+      default: false,
+    },
+    attachments: {
+      items: {
+        $ref: "#/components/schemas/MailAttachmentRef",
+      },
+      type: "array",
+      title: "Attachments",
+      description: "References to the message's attachments stored in S3.",
+    },
+    original_message: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/MailMessageRef",
+        },
+        {
+          type: "null",
+        },
+      ],
+      description: "Reference to the original RFC822 message stored in S3.",
+    },
+  },
+  type: "object",
+  required: ["message_id", "sender", "subject", "target_folder", "reason"],
+  title: "MailClassificationRef",
+  description:
+    "One classified message and where it was filed — the per-message detail behind a run summary.",
+} as const;
+
+export const MailFetchedEventSchema = {
+  properties: {
+    event_id: {
+      type: "string",
+      title: "Event Id",
+    },
+    created_at: {
+      type: "integer",
+      title: "Created At",
+      description:
+        "The time (in ns since epoch) the event was stored in the event store",
+    },
+    display_name: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/LocaleString",
+        },
+        {
+          type: "null",
+        },
+      ],
+      description: "Display name for the event",
+    },
+    display_description: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/LocaleString",
+        },
+        {
+          type: "null",
+        },
+      ],
+      description: "Display description for the event",
+    },
+    message_id: {
+      type: "string",
+      title: "Message Id",
+      description: "IMAP UID of the fetched message within the inbox folder.",
+    },
+    sender: {
+      type: "string",
+      title: "Sender",
+      description: "Raw From header of the message.",
+    },
+    subject: {
+      type: "string",
+      title: "Subject",
+      description: "Subject header of the message.",
+    },
+    date: {
+      anyOf: [
+        {
+          type: "string",
+          format: "date-time",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Date",
+      description: "Date header of the message, if parseable.",
+    },
+    body_text: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Body Text",
+      description: "Plain-text body of the message, if present.",
+    },
+    rfc_message_id: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Rfc Message Id",
+      description:
+        "RFC Message-ID header of the message — used to thread a reply draft.",
+    },
+    references: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "References",
+      description: "RFC References header of the message, if present.",
+    },
+    reply_to: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Reply To",
+      description: "Reply-To header of the message, if present.",
+    },
+    attachments: {
+      items: {
+        $ref: "#/components/schemas/MailAttachmentRef",
+      },
+      type: "array",
+      title: "Attachments",
+      description: "References to the message's attachments stored in S3.",
+    },
+    original_message: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/MailMessageRef",
+        },
+        {
+          type: "null",
+        },
+      ],
+      description:
+        "Reference to the original RFC822 message stored in S3, or null when it was not stored.",
+    },
+    _event_name: {
+      type: "string",
+      title: "Event Name",
+      description:
+        "The event type name, usually the class name. If unknown, uses _unknown_event_name.\nUsed during deserialization to decide which subclass to instantiate.",
+      readOnly: true,
+    },
+    _parent_event_names: {
+      items: {
+        type: "string",
+      },
+      type: "array",
+      title: "Parent Event Names",
+      description:
+        "Contains the names of all parent classes up until BaseEvent, ordered from deepest to least deep inheritance.",
+      readOnly: true,
+    },
+  },
+  additionalProperties: true,
+  type: "object",
+  required: [
+    "message_id",
+    "sender",
+    "subject",
+    "_event_name",
+    "_parent_event_names",
+  ],
+  title: "MailFetchedEvent",
+  description:
+    "Carries a single fetched message — headers, body, and references to its stored attachments.",
+} as const;
+
+export const MailMessageRefSchema = {
+  properties: {
+    filename: {
+      type: "string",
+      pattern: "^[^/\\\\]+$",
+      title: "Filename",
+      description:
+        "Filename the message is stored under, e.g. '1234.eml'. Must not contain path separators.",
+    },
+    content_type: {
+      type: "string",
+      title: "Content Type",
+      description: "MIME type of the stored message.",
+      default: "message/rfc822",
+    },
+    file_id: {
+      type: "string",
+      pattern:
+        "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+      title: "File Id",
+      description:
+        "UUID4 file identifier; the S3 object key is derived from the agent identity at runtime.",
+    },
+    size_bytes: {
+      type: "integer",
+      minimum: 0,
+      title: "Size Bytes",
+      description: "Size of the stored message in bytes.",
+    },
+  },
+  type: "object",
+  required: ["filename", "file_id", "size_bytes"],
+  title: "MailMessageRef",
+  description:
+    "Reference to a fetched message's original RFC822 bytes, stored in S3 rather than carried in the event.\n\nMirrors ``MailAttachmentRef``: the message is referenced by ``file_id`` so the raw mail — which may be\norders of magnitude larger than the summary the event carries — never enters the audit trail or the\nWebSocket stream. The stored object is the message **verbatim**, so it also preserves what the event\ndeliberately omits: the recipients and the untrusted HTML body.",
+} as const;
+
+export const MailMovedEventSchema = {
   properties: {
     event_id: {
       type: "string",
@@ -14137,6 +14794,13 @@ export const MailMovedEventSchema = {
       title: "Target Folder",
       description: "Folder the message was moved into.",
     },
+    folder_created: {
+      type: "boolean",
+      title: "Folder Created",
+      description:
+        "Whether the target folder did not exist and was created by this move — an agent adding a folder to someone's mailbox is a visible side effect and belongs in the audit trail.",
+      default: false,
+    },
     _event_name: {
       type: "string",
       title: "Event Name",
@@ -14837,6 +15501,13 @@ export const MinimalAgentInstanceDTOSchema = {
       description:
         "Whether the agent can participate in a chat-based conversation",
     },
+    is_schedulable: {
+      type: "boolean",
+      title: "Is Schedulable",
+      description:
+        "Whether the agent can be run automatically on a cron schedule",
+      default: false,
+    },
   },
   type: "object",
   required: ["agent_class", "agent_id", "agent_config", "is_conversational"],
@@ -16985,6 +17656,9 @@ export const ProcessClassDTOSchema = {
           {
             $ref: "#/components/schemas/ColorPicker",
           },
+          {
+            $ref: "#/components/schemas/CronInput",
+          },
           {
             $ref: "#/components/schemas/DatePicker",
           },
@@ -18536,6 +19210,9 @@ export const RepeaterSchema = {
           {
             $ref: "#/components/schemas/ColorPicker",
           },
+          {
+            $ref: "#/components/schemas/CronInput",
+          },
           {
             $ref: "#/components/schemas/DatePicker",
           },
@@ -24352,6 +25029,9 @@ export const AgentClassDTOWritableSchema = {
           {
             $ref: "#/components/schemas/ColorPickerWritable",
           },
+          {
+            $ref: "#/components/schemas/CronInputWritable",
+          },
           {
             $ref: "#/components/schemas/DatePickerWritable",
           },
@@ -24486,6 +25166,13 @@ export const AgentClassDTOWritableSchema = {
       description:
         "Whether the agent class can participate in a chat-based conversation",
     },
+    is_schedulable: {
+      type: "boolean",
+      title: "Is Schedulable",
+      description:
+        "Whether the agent class can be run automatically on a cron schedule",
+      default: false,
+    },
     is_online: {
       anyOf: [
         {
@@ -24573,6 +25260,9 @@ export const AgentConfigDTOWritableSchema = {
               {
                 $ref: "#/components/schemas/ColorPickerWritable",
               },
+              {
+                $ref: "#/components/schemas/CronInputWritable",
+              },
               {
                 $ref: "#/components/schemas/DatePickerWritable",
               },
@@ -26866,6 +27556,9 @@ export const ContextualizedAgentEventWritableSchema = {
         {
           $ref: "#/components/schemas/RAGStartEventWritable",
         },
+        {
+          $ref: "#/components/schemas/CronStartEventWritable",
+        },
         {
           $ref: "#/components/schemas/ExceptionEventWritable",
         },
@@ -26938,6 +27631,9 @@ export const ContextualizedAgentEventWritableSchema = {
         {
           $ref: "#/components/schemas/MailBatchDraftedEventWritable",
         },
+        {
+          $ref: "#/components/schemas/MailBatchClassifiedEventWritable",
+        },
       ],
       title: "Event",
       description: "Data of the event itself.",
@@ -27030,6 +27726,256 @@ export const ConversationTitleEventWritableSchema = {
     "Carries a generated title for the whole conversation (thread), produced by the agent once a\ntopic becomes identifiable. The agent has the richest context about the conversation, so it\nowns this metadata instead of leaving it to the chat UI's task model.\n\nA thread receives a single, stable title: the agent emits this event only on the turn where a\ntitle is first determined and never again for that thread.",
 } as const;
 
+export const CronInputWritableSchema = {
+  properties: {
+    is_formkit_element: {
+      type: "boolean",
+      const: true,
+      title: "Is Formkit Element",
+      description: "Indicates that this element is a FormKit element",
+      default: true,
+    },
+    if: {
+      anyOf: [
+        {
+          type: "string",
+          pattern: "^\\$.+",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "If",
+      description: "Conditional expression to show this element",
+    },
+    id: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Id",
+      description: "Unique identifier for this element",
+    },
+    nullable: {
+      type: "boolean",
+      title: "Nullable",
+      description:
+        "Render with a sibling toggle that sets this field to null when off",
+      default: false,
+    },
+    defaultEnabled: {
+      anyOf: [
+        {
+          type: "boolean",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Defaultenabled",
+      description:
+        "For a nullable element, whether its toggle should start enabled on a fresh form (i.e. the field's data default is non-null). Ignored for non-nullable elements.",
+    },
+    formkit: {
+      type: "string",
+      const: "cronInput",
+      title: "Formkit",
+      description: "Cron schedule input element.",
+      default: "cronInput",
+    },
+    name: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Name",
+      description: "Name of this field",
+    },
+    label: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/LocaleString",
+        },
+        {
+          type: "string",
+        },
+      ],
+      title: "Label",
+      description: "Label of this field",
+    },
+    help: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/LocaleString",
+        },
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Help",
+      description: "Help text of this field",
+    },
+    value: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "integer",
+        },
+        {
+          type: "number",
+        },
+        {
+          type: "boolean",
+        },
+        {
+          items: {
+            type: "string",
+          },
+          type: "array",
+        },
+        {
+          additionalProperties: {
+            type: "string",
+          },
+          type: "object",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Value",
+      description: "Default value for this field",
+    },
+    required: {
+      type: "boolean",
+      title: "Required",
+      description: "Whether this field is required",
+      default: false,
+    },
+    additional_validation_rules: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Additional Validation Rules",
+      description: "Validation expression",
+    },
+    timezonePlaceholder: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/LocaleString",
+        },
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Timezoneplaceholder",
+      description: "Placeholder for the timezone select",
+    },
+    filter: {
+      type: "boolean",
+      title: "Filter",
+      description: "Whether to enable filtering/search on the timezone select",
+      default: true,
+    },
+  },
+  additionalProperties: true,
+  type: "object",
+  required: ["label"],
+  title: "CronInput",
+  description:
+    'A FormKit element for editing the cron schedule of a schedulable agent profile.\n\nThe element renders the five cron positions plus a timezone selector, and the submitted value\nmatches the fields of `CronSchedule`:\n{\n    "minute": str,\n    "hour": str,\n    "day_of_month": str,\n    "month": str,\n    "day_of_week": str,\n    "timezone": str,\n}\n\nPresets and the plain-language summary of the current schedule are delivered by the Admin UI\n(see the cron schedule configuration UI issue); this element only declares the contract.\n\n### Form Duality\n```python\nfrom swiss_ai_hub.core.form.elements.cron_input import CronInput\nfrom swiss_ai_hub.core.scheduling.cron_schedule import CronSchedule\n\nclass MyAgentConfig(AgentConfig):\n    schedule: Annotated[\n        CronSchedule | CronInput | None,\n        Field(description="When this profile runs automatically"),\n    ] = None\n\n# Form mode - for rendering:\nconfig = MyAgentConfig(schedule=CronInput(label=LocaleString(en="Schedule")))\n\n# Data mode - from submission (Pydantic validates into CronSchedule):\nconfig = MyAgentConfig(schedule=CronSchedule(hour="12", timezone="Europe/Zurich"))\n```',
+} as const;
+
+export const CronStartEventWritableSchema = {
+  properties: {
+    event_id: {
+      type: "string",
+      title: "Event Id",
+    },
+    created_at: {
+      type: "integer",
+      title: "Created At",
+      description:
+        "The time (in ns since epoch) the event was stored in the event store",
+    },
+    display_name: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/LocaleString",
+        },
+        {
+          type: "null",
+        },
+      ],
+      description: "Display name for the event",
+    },
+    display_description: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/LocaleString",
+        },
+        {
+          type: "null",
+        },
+      ],
+      description: "Display description for the event",
+    },
+    locale: {
+      type: "string",
+      title: "Locale",
+      description:
+        "The locale the scheduled run reports its display output in.",
+      default: "de",
+    },
+    user: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/UserIdentity",
+        },
+        {
+          type: "null",
+        },
+      ],
+      description:
+        "Always None — scheduled runs are system-initiated and carry no execution identity.",
+    },
+    scheduled_for: {
+      type: "string",
+      format: "date-time",
+      title: "Scheduled For",
+      description:
+        "The cron occurrence this run fires for, in UTC. Distinct from `created_at`, which records when the scheduler published the event — the two differ by the scheduler's tick latency.",
+    },
+  },
+  additionalProperties: true,
+  type: "object",
+  required: ["scheduled_for"],
+  title: "CronStartEvent",
+  description:
+    "Start event fired by the cron scheduler — handling it is what makes an agent schedulable.\n\nMirrors how accepting a `UserMessageEvent` makes an agent conversational: `AgentRunner` derives\n`is_schedulable` from the start events an agent declares, so a blueprint opts in by adding a step\nthat consumes this event, with no separate registration.\n\nScheduled runs are system runs, so `user` is always None and the agent must not depend on an\ninitiating identity. Whatever tenant context the agent needs comes from its own profile\nconfiguration (as `OrgMemoryWriteConfig.tenant_id` already does), never from the run.",
+} as const;
+
 export const DatePickerWritableSchema = {
   properties: {
     is_formkit_element: {
@@ -27724,6 +28670,13 @@ export const FullAgentInstanceDTOWritableSchema = {
       description:
         "Whether the agent can participate in a chat-based conversation",
     },
+    is_schedulable: {
+      type: "boolean",
+      title: "Is Schedulable",
+      description:
+        "Whether the agent can be run automatically on a cron schedule",
+      default: false,
+    },
     start_events: {
       items: {
         $ref: "#/components/schemas/EventSpecs",
@@ -27885,6 +28838,9 @@ export const FullProcessInstanceDTOWritableSchema = {
           {
             $ref: "#/components/schemas/ColorPickerWritable",
           },
+          {
+            $ref: "#/components/schemas/CronInputWritable",
+          },
           {
             $ref: "#/components/schemas/DatePickerWritable",
           },
@@ -28110,6 +29066,9 @@ export const GroupWritableSchema = {
           {
             $ref: "#/components/schemas/ColorPickerWritable",
           },
+          {
+            $ref: "#/components/schemas/CronInputWritable",
+          },
           {
             $ref: "#/components/schemas/DatePickerWritable",
           },
@@ -28410,150 +29369,156 @@ export const HumanInDTOWritableSchema = {
             $ref: "#/components/schemas/ColorPickerWritable",
           },
           {
-            $ref: "#/components/schemas/DatePickerWritable",
-          },
-          {
-            $ref: "#/components/schemas/GroupWritable",
-          },
-          {
-            $ref: "#/components/schemas/IconSelectorWritable",
-          },
-          {
-            $ref: "#/components/schemas/InputMaskWritable",
-          },
-          {
-            $ref: "#/components/schemas/InputNumberWritable",
-          },
-          {
-            $ref: "#/components/schemas/InputOtpWritable",
-          },
-          {
-            $ref: "#/components/schemas/InputTextWritable",
-          },
-          {
-            $ref: "#/components/schemas/KnowledgeDatabaseSelectorWritable",
-          },
-          {
-            $ref: "#/components/schemas/KnobWritable",
-          },
-          {
-            $ref: "#/components/schemas/ListboxWritable",
-          },
-          {
-            $ref: "#/components/schemas/LocaleInputWritable",
-          },
-          {
-            $ref: "#/components/schemas/ModelSelectWritable",
-          },
-          {
-            $ref: "#/components/schemas/MultiSelectWritable",
-          },
-          {
-            $ref: "#/components/schemas/PasswordWritable",
-          },
-          {
-            $ref: "#/components/schemas/RadioButtonWritable",
-          },
-          {
-            $ref: "#/components/schemas/RatingWritable",
-          },
-          {
-            $ref: "#/components/schemas/RepeaterWritable",
-          },
-          {
-            $ref: "#/components/schemas/SelectWritable",
-          },
-          {
-            $ref: "#/components/schemas/SelectButtonWritable",
-          },
-          {
-            $ref: "#/components/schemas/SliderWritable",
-          },
-          {
-            $ref: "#/components/schemas/TenantSelectWritable",
-          },
-          {
-            $ref: "#/components/schemas/TextareaWritable",
-          },
-          {
-            $ref: "#/components/schemas/ToggleButtonWritable",
-          },
-          {
-            $ref: "#/components/schemas/ToggleSwitchWritable",
-          },
-          {
-            $ref: "#/components/schemas/VectorStoreInputWritable",
-          },
-        ],
-      },
-      type: "array",
-      title: "Form",
-      description: "Formkit elements of the work event.",
-      default: [],
-    },
-  },
-  type: "object",
-  required: [
-    "name",
-    "description",
-    "route",
-    "method",
-    "is_process_start",
-    "event_specs",
-  ],
-  title: "HumanInDTO",
-} as const;
-
-export const HumanInSpecsWritableSchema = {
-  properties: {
-    name: {
-      $ref: "#/components/schemas/LocaleString",
-      description: "The name of the work event.",
-    },
-    description: {
-      $ref: "#/components/schemas/LocaleString",
-      description:
-        "A description of the work event, providing details about its purpose.",
-    },
-    route: {
-      type: "string",
-      title: "Route",
-      description: "The route of the work event.",
-    },
-    method: {
-      type: "string",
-      title: "Method",
-      description: "The HTTP method of the work event.",
-    },
-    is_process_start: {
-      type: "boolean",
-      title: "Is Process Start",
-      description: "Whether the work event is a process start event.",
-    },
-    event_specs: {
-      $ref: "#/components/schemas/EventSpecs",
-      description: "The event specs of the work event.",
-    },
-    form: {
-      items: {
-        oneOf: [
-          {
-            $ref: "#/components/schemas/HtmlElement",
-          },
-          {
-            $ref: "#/components/schemas/AgentSelectorWritable",
-          },
-          {
-            $ref: "#/components/schemas/CascadeSelectWritable",
-          },
-          {
-            $ref: "#/components/schemas/CheckboxWritable",
-          },
-          {
-            $ref: "#/components/schemas/ChipsInputWritable",
-          },
-          {
-            $ref: "#/components/schemas/ColorPickerWritable",
+            $ref: "#/components/schemas/CronInputWritable",
+          },
+          {
+            $ref: "#/components/schemas/DatePickerWritable",
+          },
+          {
+            $ref: "#/components/schemas/GroupWritable",
+          },
+          {
+            $ref: "#/components/schemas/IconSelectorWritable",
+          },
+          {
+            $ref: "#/components/schemas/InputMaskWritable",
+          },
+          {
+            $ref: "#/components/schemas/InputNumberWritable",
+          },
+          {
+            $ref: "#/components/schemas/InputOtpWritable",
+          },
+          {
+            $ref: "#/components/schemas/InputTextWritable",
+          },
+          {
+            $ref: "#/components/schemas/KnowledgeDatabaseSelectorWritable",
+          },
+          {
+            $ref: "#/components/schemas/KnobWritable",
+          },
+          {
+            $ref: "#/components/schemas/ListboxWritable",
+          },
+          {
+            $ref: "#/components/schemas/LocaleInputWritable",
+          },
+          {
+            $ref: "#/components/schemas/ModelSelectWritable",
+          },
+          {
+            $ref: "#/components/schemas/MultiSelectWritable",
+          },
+          {
+            $ref: "#/components/schemas/PasswordWritable",
+          },
+          {
+            $ref: "#/components/schemas/RadioButtonWritable",
+          },
+          {
+            $ref: "#/components/schemas/RatingWritable",
+          },
+          {
+            $ref: "#/components/schemas/RepeaterWritable",
+          },
+          {
+            $ref: "#/components/schemas/SelectWritable",
+          },
+          {
+            $ref: "#/components/schemas/SelectButtonWritable",
+          },
+          {
+            $ref: "#/components/schemas/SliderWritable",
+          },
+          {
+            $ref: "#/components/schemas/TenantSelectWritable",
+          },
+          {
+            $ref: "#/components/schemas/TextareaWritable",
+          },
+          {
+            $ref: "#/components/schemas/ToggleButtonWritable",
+          },
+          {
+            $ref: "#/components/schemas/ToggleSwitchWritable",
+          },
+          {
+            $ref: "#/components/schemas/VectorStoreInputWritable",
+          },
+        ],
+      },
+      type: "array",
+      title: "Form",
+      description: "Formkit elements of the work event.",
+      default: [],
+    },
+  },
+  type: "object",
+  required: [
+    "name",
+    "description",
+    "route",
+    "method",
+    "is_process_start",
+    "event_specs",
+  ],
+  title: "HumanInDTO",
+} as const;
+
+export const HumanInSpecsWritableSchema = {
+  properties: {
+    name: {
+      $ref: "#/components/schemas/LocaleString",
+      description: "The name of the work event.",
+    },
+    description: {
+      $ref: "#/components/schemas/LocaleString",
+      description:
+        "A description of the work event, providing details about its purpose.",
+    },
+    route: {
+      type: "string",
+      title: "Route",
+      description: "The route of the work event.",
+    },
+    method: {
+      type: "string",
+      title: "Method",
+      description: "The HTTP method of the work event.",
+    },
+    is_process_start: {
+      type: "boolean",
+      title: "Is Process Start",
+      description: "Whether the work event is a process start event.",
+    },
+    event_specs: {
+      $ref: "#/components/schemas/EventSpecs",
+      description: "The event specs of the work event.",
+    },
+    form: {
+      items: {
+        oneOf: [
+          {
+            $ref: "#/components/schemas/HtmlElement",
+          },
+          {
+            $ref: "#/components/schemas/AgentSelectorWritable",
+          },
+          {
+            $ref: "#/components/schemas/CascadeSelectWritable",
+          },
+          {
+            $ref: "#/components/schemas/CheckboxWritable",
+          },
+          {
+            $ref: "#/components/schemas/ChipsInputWritable",
+          },
+          {
+            $ref: "#/components/schemas/ColorPickerWritable",
+          },
+          {
+            $ref: "#/components/schemas/CronInputWritable",
           },
           {
             $ref: "#/components/schemas/DatePickerWritable",
@@ -30925,6 +31890,32 @@ export const LLMCostEventWritableSchema = {
       description:
         "The name of the LLM service (e.g., 'openai/gpt-4') this event pertains to.",
     },
+    user_id: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "User Id",
+      description:
+        "Invoking user, so spend is queryable per user. None for runs with no user context.",
+    },
+    tenant_id: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Tenant Id",
+      description:
+        "Acting tenant, so spend is queryable per tenant. None for sysadmins and system runs.",
+    },
   },
   additionalProperties: true,
   type: "object",
@@ -31836,6 +32827,91 @@ export const LocaleInputWritableSchema = {
     'A FormKit element for entering multi-language text (LocaleString values).\n\nThis element renders as a text input with language switching capability,\nallowing users to enter translations for all supported languages (de, en, fr, it)\nin a single compact UI component.\n\nThe frontend renders this as an input field with a language selector, where users\ncan switch between languages to enter the corresponding translation.\n\n### Form Duality\nWhen used in a Form, this element captures a LocaleString value with translations\nfor each language. The form submission returns a dict with language keys.\n\n### Example Usage\n```python\nclass MyAgentConfig(AgentConfig):\n    custom_greeting: Annotated[\n        LocaleString | LocaleInput,\n        Field(description="Custom greeting message"),\n    ]\n\n# Form mode - for rendering:\nconfig = MyAgentConfig(\n    ...,\n    custom_greeting=LocaleInput(label=LocaleString(en="Greeting", de="Begrüßung")),\n)\n\n# Data mode - from submission:\nconfig = MyAgentConfig(\n    ...,\n    custom_greeting=LocaleString(en="Hello", de="Hallo", fr="Bonjour", it="Ciao"),\n)\n```',
 } as const;
 
+export const MailBatchClassifiedEventWritableSchema = {
+  properties: {
+    event_id: {
+      type: "string",
+      title: "Event Id",
+    },
+    created_at: {
+      type: "integer",
+      title: "Created At",
+      description:
+        "The time (in ns since epoch) the event was stored in the event store",
+    },
+    display_name: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/LocaleString",
+        },
+        {
+          type: "null",
+        },
+      ],
+      description: "Display name for the event",
+    },
+    display_description: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/LocaleString",
+        },
+        {
+          type: "null",
+        },
+      ],
+      description: "Display description for the event",
+    },
+    source_folder: {
+      type: "string",
+      title: "Source Folder",
+      description: "Folder the classified messages were read from.",
+    },
+    count: {
+      type: "integer",
+      title: "Count",
+      description: "Number of messages classified and filed in this run.",
+    },
+    per_category: {
+      additionalProperties: {
+        type: "integer",
+      },
+      type: "object",
+      title: "Per Category",
+      description:
+        "How many messages were filed under each configured category.",
+    },
+    fallback_count: {
+      type: "integer",
+      title: "Fallback Count",
+      description:
+        "How many messages went to the fallback folder instead of a category.",
+      default: 0,
+    },
+    failed_count: {
+      type: "integer",
+      title: "Failed Count",
+      description:
+        "How many messages the classifier could not reach a verdict on at all. They are filed into the failure folder rather than left in the inbox, where they would be re-selected on every run forever.",
+      default: 0,
+    },
+    classified: {
+      items: {
+        $ref: "#/components/schemas/MailClassificationRef",
+      },
+      type: "array",
+      title: "Classified",
+      description:
+        "Per-message classification verdicts and filing destinations.",
+    },
+  },
+  additionalProperties: true,
+  type: "object",
+  required: ["source_folder", "count"],
+  title: "MailBatchClassifiedEvent",
+  description:
+    "Summarises one classification run: how many messages were classified and where each was filed.\n\nOne event per run rather than one per message, matching `MailBatchDraftedEvent` — the per-message detail rides in\n`classified`. Filing is what prevents reprocessing: every message leaves the source folder, so the next unread\nlisting cannot see it again.",
+} as const;
+
 export const MailBatchDraftedEventWritableSchema = {
   properties: {
     event_id: {
@@ -31880,6 +32956,22 @@ export const MailBatchDraftedEventWritableSchema = {
       title: "Count",
       description: "Number of reply drafts created in this run.",
     },
+    per_category: {
+      additionalProperties: {
+        type: "integer",
+      },
+      type: "object",
+      title: "Per Category",
+      description:
+        "How many drafts were created for each category, when drafting followed a classification run. Empty when the drafting blueprint does not classify.",
+    },
+    skipped_count: {
+      type: "integer",
+      title: "Skipped Count",
+      description:
+        "Messages in the batch that got no draft: usually because their category was not opted in, or no category fitted them at all.",
+      default: 0,
+    },
     drafted: {
       items: {
         $ref: "#/components/schemas/DraftedReplyRef",
@@ -32016,6 +33108,18 @@ export const MailFetchedEventWritableSchema = {
       title: "Attachments",
       description: "References to the message's attachments stored in S3.",
     },
+    original_message: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/MailMessageRef",
+        },
+        {
+          type: "null",
+        },
+      ],
+      description:
+        "Reference to the original RFC822 message stored in S3, or null when it was not stored.",
+    },
   },
   additionalProperties: true,
   type: "object",
@@ -32074,6 +33178,13 @@ export const MailMovedEventWritableSchema = {
       title: "Target Folder",
       description: "Folder the message was moved into.",
     },
+    folder_created: {
+      type: "boolean",
+      title: "Folder Created",
+      description:
+        "Whether the target folder did not exist and was created by this move — an agent adding a folder to someone's mailbox is a visible side effect and belongs in the audit trail.",
+      default: false,
+    },
   },
   additionalProperties: true,
   type: "object",
@@ -32271,6 +33382,13 @@ export const MinimalAgentInstanceDTOWritableSchema = {
       description:
         "Whether the agent can participate in a chat-based conversation",
     },
+    is_schedulable: {
+      type: "boolean",
+      title: "Is Schedulable",
+      description:
+        "Whether the agent can be run automatically on a cron schedule",
+      default: false,
+    },
   },
   type: "object",
   required: ["agent_class", "agent_id", "agent_config", "is_conversational"],
@@ -33169,6 +34287,9 @@ export const ProcessClassDTOWritableSchema = {
           {
             $ref: "#/components/schemas/ColorPickerWritable",
           },
+          {
+            $ref: "#/components/schemas/CronInputWritable",
+          },
           {
             $ref: "#/components/schemas/DatePickerWritable",
           },
@@ -34274,6 +35395,9 @@ export const RepeaterWritableSchema = {
           {
             $ref: "#/components/schemas/ColorPickerWritable",
           },
+          {
+            $ref: "#/components/schemas/CronInputWritable",
+          },
           {
             $ref: "#/components/schemas/DatePickerWritable",
           },