@swiss-ai-hub/web 0.318.0 → 0.320.0

package/sdk/client/types.gen.ts

@@ -355,6 +355,7 @@ export type AgentClassDto = {
     | Checkbox
     | ChipsInput
     | ColorPicker
+    | CronInput
     | DatePicker
     | Group
     | IconSelector
@@ -419,6 +420,12 @@ export type AgentClassDto = {
    * Whether the agent class can participate in a chat-based conversation
    */
   is_conversational: boolean;
+  /**
+   * Is Schedulable
+   *
+   * Whether the agent class can be run automatically on a cron schedule
+   */
+  is_schedulable?: boolean;
   /**
    * Is Online
    *
@@ -482,6 +489,7 @@ export type AgentConfigDto = {
     | Checkbox
     | ChipsInput
     | ColorPicker
+    | CronInput
     | DatePicker
     | Group
     | IconSelector
@@ -2784,10 +2792,7 @@ export type ChatCompletionRequest = {
    * Function Call
    */
   function_call?:
-    | "none"
-    | "auto"
-    | ChatCompletionFunctionCallOptionParam
-    | null;
+    "none" | "auto" | ChatCompletionFunctionCallOptionParam | null;
   /**
    * Functions
    */
@@ -2832,13 +2837,7 @@ export type ChatCompletionRequest = {
    * Reasoning Effort
    */
   reasoning_effort?:
-    | "none"
-    | "minimal"
-    | "low"
-    | "medium"
-    | "high"
-    | "xhigh"
-    | null;
+    "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | null;
   /**
    * Response Format
    */
@@ -3303,11 +3302,7 @@ export type Choice = {
    * Finish Reason
    */
   finish_reason:
-    | "stop"
-    | "length"
-    | "tool_calls"
-    | "content_filter"
-    | "function_call";
+    "stop" | "length" | "tool_calls" | "content_filter" | "function_call";
   /**
    * Index
    */
@@ -3850,6 +3845,7 @@ export type ContextualizedAgentEvent = {
     | ToolEvent
     | UserMessageEvent
     | RagStartEvent
+    | CronStartEvent
     | ExceptionEvent
     | RagSuccessStopEvent
     | RagFailureStopEvent
@@ -3873,7 +3869,8 @@ export type ContextualizedAgentEvent = {
     | UnreadMailListedEvent
     | MailFetchedEvent
     | MailMovedEvent
-    | MailBatchDraftedEvent;
+    | MailBatchDraftedEvent
+    | MailBatchClassifiedEvent;
 };
 
 /**
@@ -4141,6 +4138,208 @@ export type CreateTokenResponse = {
   token: string;
 };
 
+/**
+ * CronInput
+ *
+ * A FormKit element for editing the cron schedule of a schedulable agent profile.
+ *
+ * The element renders the five cron positions plus a timezone selector, and the submitted value
+ * matches the fields of `CronSchedule`:
+ * {
+ * "minute": str,
+ * "hour": str,
+ * "day_of_month": str,
+ * "month": str,
+ * "day_of_week": str,
+ * "timezone": str,
+ * }
+ *
+ * Presets and the plain-language summary of the current schedule are delivered by the Admin UI
+ * (see the cron schedule configuration UI issue); this element only declares the contract.
+ *
+ * ### Form Duality
+ * ```python
+ * from swiss_ai_hub.core.form.elements.cron_input import CronInput
+ * from swiss_ai_hub.core.scheduling.cron_schedule import CronSchedule
+ *
+ * class MyAgentConfig(AgentConfig):
+ * schedule: Annotated[
+ * CronSchedule | CronInput | None,
+ * Field(description="When this profile runs automatically"),
+ * ] = None
+ *
+ * # Form mode - for rendering:
+ * config = MyAgentConfig(schedule=CronInput(label=LocaleString(en="Schedule")))
+ *
+ * # Data mode - from submission (Pydantic validates into CronSchedule):
+ * config = MyAgentConfig(schedule=CronSchedule(hour="12", timezone="Europe/Zurich"))
+ * ```
+ */
+export type CronInput = {
+  /**
+   * Is Formkit Element
+   *
+   * Indicates that this element is a FormKit element
+   */
+  is_formkit_element?: true;
+  /**
+   * If
+   *
+   * Conditional expression to show this element
+   */
+  if?: string | null;
+  /**
+   * Id
+   *
+   * Unique identifier for this element
+   */
+  id?: string | null;
+  /**
+   * Nullable
+   *
+   * Render with a sibling toggle that sets this field to null when off
+   */
+  nullable?: boolean;
+  /**
+   * Defaultenabled
+   *
+   * 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.
+   */
+  defaultEnabled?: boolean | null;
+  /**
+   * Formkit
+   *
+   * Cron schedule input element.
+   */
+  formkit?: "cronInput";
+  /**
+   * Name
+   *
+   * Name of this field
+   */
+  name?: string | null;
+  /**
+   * Label
+   *
+   * Label of this field
+   */
+  label: LocaleString | string;
+  /**
+   * Help
+   *
+   * Help text of this field
+   */
+  help?: LocaleString | string | null;
+  /**
+   * Value
+   *
+   * Default value for this field
+   */
+  value?:
+    | string
+    | number
+    | number
+    | boolean
+    | Array<string>
+    | {
+        [key: string]: string;
+      }
+    | null;
+  /**
+   * Required
+   *
+   * Whether this field is required
+   */
+  required?: boolean;
+  /**
+   * Additional Validation Rules
+   *
+   * Validation expression
+   */
+  additional_validation_rules?: string | null;
+  /**
+   * Timezoneplaceholder
+   *
+   * Placeholder for the timezone select
+   */
+  timezonePlaceholder?: LocaleString | string | null;
+  /**
+   * Filter
+   *
+   * Whether to enable filtering/search on the timezone select
+   */
+  filter?: boolean;
+  /**
+   * Validation
+   */
+  readonly validation: string;
+  [key: string]: unknown;
+};
+
+/**
+ * CronStartEvent
+ *
+ * Start event fired by the cron scheduler — handling it is what makes an agent schedulable.
+ *
+ * Mirrors how accepting a `UserMessageEvent` makes an agent conversational: `AgentRunner` derives
+ * `is_schedulable` from the start events an agent declares, so a blueprint opts in by adding a step
+ * that consumes this event, with no separate registration.
+ *
+ * Scheduled runs are system runs, so `user` is always None and the agent must not depend on an
+ * initiating identity. Whatever tenant context the agent needs comes from its own profile
+ * configuration (as `OrgMemoryWriteConfig.tenant_id` already does), never from the run.
+ */
+export type CronStartEvent = {
+  /**
+   * Event Id
+   */
+  event_id?: string;
+  /**
+   * Created At
+   *
+   * The time (in ns since epoch) the event was stored in the event store
+   */
+  created_at?: number;
+  /**
+   * Display name for the event
+   */
+  display_name?: LocaleString | null;
+  /**
+   * Display description for the event
+   */
+  display_description?: LocaleString | null;
+  /**
+   * Locale
+   *
+   * The locale the scheduled run reports its display output in.
+   */
+  locale?: string;
+  /**
+   * Always None — scheduled runs are system-initiated and carry no execution identity.
+   */
+  user?: UserIdentity | null;
+  /**
+   * Scheduled For
+   *
+   * 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.
+   */
+  scheduled_for: Date;
+  /**
+   * Event Name
+   *
+   * The event type name, usually the class name. If unknown, uses _unknown_event_name.
+   * Used during deserialization to decide which subclass to instantiate.
+   */
+  readonly _event_name: string;
+  /**
+   * Parent Event Names
+   *
+   * Contains the names of all parent classes up until BaseEvent, ordered from deepest to least deep inheritance.
+   */
+  readonly _parent_event_names: Array<string>;
+  [key: string]: unknown;
+};
+
 /**
  * Custom
  *
@@ -5022,9 +5221,15 @@ export type DraftedReplyRef = {
   /**
    * Source Uid
    *
-   * IMAP UID of the source message within the source folder.
+   * 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.
    */
   source_uid: string;
+  /**
+   * Category
+   *
+   * Category the source message was classified under, when drafting followed a classification run. Null when the drafting blueprint does not classify.
+   */
+  category?: string | null;
   /**
    * Drafts Folder
    *
@@ -5638,6 +5843,12 @@ export type FullAgentInstanceDto = {
    * Whether the agent can participate in a chat-based conversation
    */
   is_conversational: boolean;
+  /**
+   * Is Schedulable
+   *
+   * Whether the agent can be run automatically on a cron schedule
+   */
+  is_schedulable?: boolean;
   /**
    * Start Events
    *
@@ -5749,6 +5960,7 @@ export type FullProcessInstanceDto = {
     | Checkbox
     | ChipsInput
     | ColorPicker
+    | CronInput
     | DatePicker
     | Group
     | IconSelector
@@ -5935,6 +6147,7 @@ export type Group = {
     | Checkbox
     | ChipsInput
     | ColorPicker
+    | CronInput
     | DatePicker
     | Group
     | IconSelector
@@ -6290,6 +6503,7 @@ export type HumanInDto = {
     | Checkbox
     | ChipsInput
     | ColorPicker
+    | CronInput
     | DatePicker
     | Group
     | IconSelector
@@ -6370,6 +6584,7 @@ export type HumanInSpecs = {
     | Checkbox
     | ChipsInput
     | ColorPicker
+    | CronInput
     | DatePicker
     | Group
     | IconSelector
@@ -8551,6 +8766,18 @@ export type LlmCostEvent = {
    * The name of the LLM service (e.g., 'openai/gpt-4') this event pertains to.
    */
   llm_name: string;
+  /**
+   * User Id
+   *
+   * Invoking user, so spend is queryable per user. None for runs with no user context.
+   */
+  user_id?: string | null;
+  /**
+   * Tenant Id
+   *
+   * Acting tenant, so spend is queryable per tenant. None for sysadmins and system runs.
+   */
+  tenant_id?: string | null;
   /**
    * Event Name
    *
@@ -8689,6 +8916,59 @@ export type LlmEvent = {
   [key: string]: unknown;
 };
 
+/**
+ * LLMSpend
+ *
+ * LLM spend aggregated over one attribution key (a user or a tenant).
+ *
+ * Costs come from the platform's own `LLMCostEvent` records rather than from LiteLLM's spend log:
+ * the gateway can only attribute the user, so the tenant dimension exists here alone (see #1451).
+ */
+export type LlmSpend = {
+  /**
+   * User Id
+   *
+   * Invoking user, None when grouping by tenant.
+   */
+  user_id?: string | null;
+  /**
+   * Tenant Id
+   *
+   * Acting tenant, None for runs outside a tenant.
+   */
+  tenant_id?: string | null;
+  /**
+   * Calls
+   *
+   * Number of LLM calls attributed to this key.
+   */
+  calls?: number;
+  /**
+   * Prompt Tokens Costs
+   *
+   * Cost of prompt tokens.
+   */
+  prompt_tokens_costs?: number;
+  /**
+   * Completion Tokens Costs
+   *
+   * Cost of completion tokens.
+   */
+  completion_tokens_costs?: number;
+  /**
+   * Embedding Tokens Costs
+   *
+   * Cost of embedding tokens.
+   */
+  embedding_tokens_costs?: number;
+  /**
+   * Total Costs
+   *
+   * Sum of prompt, completion and embedding costs.
+   */
+  total_costs?: number;
+};
+
 /**
  * LLMStopEvent
  */
@@ -9140,6 +9420,13 @@ export type LocaleInput = {
   placeholder?: LocaleString | string | null;
   /**
    * Validation
+   *
+   * Emits `localeRequired` where other elements emit FormKit's `required`.
+   *
+   * FormKit's `required` rule only asks whether a value is present, and this element's
+   * value is always a `{de, en, fr, it}` object — non-empty, therefore passing, even when
+   * every locale inside it is blank. `localeRequired` (registered in the frontend FormKit
+   * config) looks at the locale values themselves.
    */
   readonly validation: string;
   [key: string]: unknown;
@@ -9288,14 +9575,15 @@ export type MailAttachmentRef = {
 };
 
 /**
- * MailBatchDraftedEvent
+ * MailBatchClassifiedEvent
  *
- * Records that a batch of reply drafts was appended to the Drafts folder for a human to review and send.
+ * Summarises one classification run: how many messages were classified and where each was filed.
  *
- * The agent never sends — the drafts sitting in Drafts are the human handoff. Each source message is left unread and
- * marked as drafted so it is not drafted again on the next run.
+ * One event per run rather than one per message, matching `MailBatchDraftedEvent` — the per-message detail rides in
+ * `classified`. Filing is what prevents reprocessing: every message leaves the source folder, so the next unread
+ * listing cannot see it again.
  */
-export type MailBatchDraftedEvent = {
+export type MailBatchClassifiedEvent = {
   /**
    * Event Id
    */
@@ -9317,21 +9605,41 @@ export type MailBatchDraftedEvent = {
   /**
    * Source Folder
    *
-   * Folder the drafted messages were read from.
+   * Folder the classified messages were read from.
    */
   source_folder: string;
   /**
    * Count
    *
-   * Number of reply drafts created in this run.
+   * Number of messages classified and filed in this run.
    */
   count: number;
   /**
-   * Drafted
+   * Per Category
    *
-   * Per-message references to the created reply drafts.
+   * How many messages were filed under each configured category.
    */
-  drafted?: Array<DraftedReplyRef>;
+  per_category?: {
+    [key: string]: number;
+  };
+  /**
+   * Fallback Count
+   *
+   * How many messages went to the fallback folder instead of a category.
+   */
+  fallback_count?: number;
+  /**
+   * Failed Count
+   *
+   * 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.
+   */
+  failed_count?: number;
+  /**
+   * Classified
+   *
+   * Per-message classification verdicts and filing destinations.
+   */
+  classified?: Array<MailClassificationRef>;
   /**
    * Event Name
    *
@@ -9349,11 +9657,14 @@ export type MailBatchDraftedEvent = {
 };
 
 /**
- * MailFetchedEvent
+ * MailBatchDraftedEvent
  *
- * Carries a single fetched message — headers, body, and references to its stored attachments.
+ * Records that a batch of reply drafts was appended to the Drafts folder for a human to review and send.
+ *
+ * The agent never sends — the drafts sitting in Drafts are the human handoff. Each source message is left unread and
+ * marked as drafted so it is not drafted again on the next run.
  */
-export type MailFetchedEvent = {
+export type MailBatchDraftedEvent = {
   /**
    * Event Id
    */
@@ -9373,11 +9684,143 @@ export type MailFetchedEvent = {
    */
   display_description?: LocaleString | null;
   /**
-   * Message Id
+   * Source Folder
    *
-   * IMAP UID of the fetched message within the inbox folder.
+   * Folder the drafted messages were read from.
    */
-  message_id: string;
+  source_folder: string;
+  /**
+   * Count
+   *
+   * Number of reply drafts created in this run.
+   */
+  count: number;
+  /**
+   * Per Category
+   *
+   * How many drafts were created for each category, when drafting followed a classification run. Empty when the drafting blueprint does not classify.
+   */
+  per_category?: {
+    [key: string]: number;
+  };
+  /**
+   * Skipped Count
+   *
+   * Messages in the batch that got no draft: usually because their category was not opted in, or no category fitted them at all.
+   */
+  skipped_count?: number;
+  /**
+   * Drafted
+   *
+   * Per-message references to the created reply drafts.
+   */
+  drafted?: Array<DraftedReplyRef>;
+  /**
+   * Event Name
+   *
+   * The event type name, usually the class name. If unknown, uses _unknown_event_name.
+   * Used during deserialization to decide which subclass to instantiate.
+   */
+  readonly _event_name: string;
+  /**
+   * Parent Event Names
+   *
+   * Contains the names of all parent classes up until BaseEvent, ordered from deepest to least deep inheritance.
+   */
+  readonly _parent_event_names: Array<string>;
+  [key: string]: unknown;
+};
+
+/**
+ * MailClassificationRef
+ *
+ * One classified message and where it was filed — the per-message detail behind a run summary.
+ */
+export type MailClassificationRef = {
+  /**
+   * Message Id
+   *
+   * IMAP UID of the message within the source folder.
+   */
+  message_id: string;
+  /**
+   * Sender
+   *
+   * Raw From header of the message.
+   */
+  sender: string;
+  /**
+   * Subject
+   *
+   * Subject header of the message.
+   */
+  subject: string;
+  /**
+   * Category
+   *
+   * Configured category the message was filed under, or null when it went to the fallback folder because no category clearly fitted.
+   */
+  category?: string | null;
+  /**
+   * Target Folder
+   *
+   * Folder the message was filed into.
+   */
+  target_folder: string;
+  /**
+   * Reason
+   *
+   * Model's stated reason for the choice — the audit trail for a misfile.
+   */
+  reason: string;
+  /**
+   * Folder Created
+   *
+   * 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.
+   */
+  folder_created?: boolean;
+  /**
+   * Attachments
+   *
+   * References to the message's attachments stored in S3.
+   */
+  attachments?: Array<MailAttachmentRef>;
+  /**
+   * Reference to the original RFC822 message stored in S3.
+   */
+  original_message?: MailMessageRef | null;
+};
+
+/**
+ * MailFetchedEvent
+ *
+ * Carries a single fetched message — headers, body, and references to its stored attachments.
+ */
+export type MailFetchedEvent = {
+  /**
+   * Event Id
+   */
+  event_id?: string;
+  /**
+   * Created At
+   *
+   * The time (in ns since epoch) the event was stored in the event store
+   */
+  created_at?: number;
+  /**
+   * Display name for the event
+   */
+  display_name?: LocaleString | null;
+  /**
+   * Display description for the event
+   */
+  display_description?: LocaleString | null;
+  /**
+   * Message Id
+   *
+   * IMAP UID of the fetched message within the inbox folder.
+   */
+  message_id: string;
   /**
    * Sender
    *
@@ -9426,6 +9869,10 @@ export type MailFetchedEvent = {
    * References to the message's attachments stored in S3.
    */
   attachments?: Array<MailAttachmentRef>;
+  /**
+   * Reference to the original RFC822 message stored in S3, or null when it was not stored.
+   */
+  original_message?: MailMessageRef | null;
   /**
    * Event Name
    *
@@ -9442,6 +9889,43 @@ export type MailFetchedEvent = {
   [key: string]: unknown;
 };
 
+/**
+ * MailMessageRef
+ *
+ * Reference to a fetched message's original RFC822 bytes, stored in S3 rather than carried in the event.
+ *
+ * Mirrors ``MailAttachmentRef``: the message is referenced by ``file_id`` so the raw mail — which may be
+ * orders of magnitude larger than the summary the event carries — never enters the audit trail or the
+ * WebSocket stream. The stored object is the message **verbatim**, so it also preserves what the event
+ * deliberately omits: the recipients and the untrusted HTML body.
+ */
+export type MailMessageRef = {
+  /**
+   * Filename
+   *
+   * Filename the message is stored under, e.g. '1234.eml'. Must not contain path separators.
+   */
+  filename: string;
+  /**
+   * Content Type
+   *
+   * MIME type of the stored message.
+   */
+  content_type?: string;
+  /**
+   * File Id
+   *
+   * UUID4 file identifier; the S3 object key is derived from the agent identity at runtime.
+   */
+  file_id: string;
+  /**
+   * Size Bytes
+   *
+   * Size of the stored message in bytes.
+   */
+  size_bytes: number;
+};
+
 /**
  * MailMovedEvent
  *
@@ -9484,6 +9968,12 @@ export type MailMovedEvent = {
    * Folder the message was moved into.
    */
   target_folder: string;
+  /**
+   * Folder Created
+   *
+   * 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.
+   */
+  folder_created?: boolean;
   /**
    * Event Name
    *
@@ -10006,6 +10496,12 @@ export type MinimalAgentInstanceDto = {
    * Whether the agent can participate in a chat-based conversation
    */
   is_conversational: boolean;
+  /**
+   * Is Schedulable
+   *
+   * Whether the agent can be run automatically on a cron schedule
+   */
+  is_schedulable?: boolean;
 };
 
 /**
@@ -11482,6 +11978,7 @@ export type ProcessClassDto = {
     | Checkbox
     | ChipsInput
     | ColorPicker
+    | CronInput
     | DatePicker
     | Group
     | IconSelector
@@ -12516,6 +13013,7 @@ export type Repeater = {
     | Checkbox
     | ChipsInput
     | ColorPicker
+    | CronInput
     | DatePicker
     | Group
     | IconSelector
@@ -16611,6 +17109,7 @@ export type AgentClassDtoWritable = {
     | CheckboxWritable
     | ChipsInputWritable
     | ColorPickerWritable
+    | CronInputWritable
     | DatePickerWritable
     | GroupWritable
     | IconSelectorWritable
@@ -16675,6 +17174,12 @@ export type AgentClassDtoWritable = {
    * Whether the agent class can participate in a chat-based conversation
    */
   is_conversational: boolean;
+  /**
+   * Is Schedulable
+   *
+   * Whether the agent class can be run automatically on a cron schedule
+   */
+  is_schedulable?: boolean;
   /**
    * Is Online
    *
@@ -16738,6 +17243,7 @@ export type AgentConfigDtoWritable = {
     | CheckboxWritable
     | ChipsInputWritable
     | ColorPickerWritable
+    | CronInputWritable
     | DatePickerWritable
     | GroupWritable
     | IconSelectorWritable
@@ -18254,6 +18760,7 @@ export type ContextualizedAgentEventWritable = {
     | ToolEventWritable
     | UserMessageEventWritable
     | RagStartEventWritable
+    | CronStartEventWritable
     | ExceptionEventWritable
     | RagSuccessStopEventWritable
     | RagFailureStopEventWritable
@@ -18277,7 +18784,8 @@ export type ContextualizedAgentEventWritable = {
     | UnreadMailListedEventWritable
     | MailFetchedEventWritable
     | MailMovedEventWritable
-    | MailBatchDraftedEventWritable;
+    | MailBatchDraftedEventWritable
+    | MailBatchClassifiedEventWritable;
 };
 
 /**
@@ -18347,6 +18855,191 @@ export type ConversationTitleEventWritable = {
   [key: string]: unknown;
 };
 
+/**
+ * CronInput
+ *
+ * A FormKit element for editing the cron schedule of a schedulable agent profile.
+ *
+ * The element renders the five cron positions plus a timezone selector, and the submitted value
+ * matches the fields of `CronSchedule`:
+ * {
+ * "minute": str,
+ * "hour": str,
+ * "day_of_month": str,
+ * "month": str,
+ * "day_of_week": str,
+ * "timezone": str,
+ * }
+ *
+ * Presets and the plain-language summary of the current schedule are delivered by the Admin UI
+ * (see the cron schedule configuration UI issue); this element only declares the contract.
+ *
+ * ### Form Duality
+ * ```python
+ * from swiss_ai_hub.core.form.elements.cron_input import CronInput
+ * from swiss_ai_hub.core.scheduling.cron_schedule import CronSchedule
+ *
+ * class MyAgentConfig(AgentConfig):
+ * schedule: Annotated[
+ * CronSchedule | CronInput | None,
+ * Field(description="When this profile runs automatically"),
+ * ] = None
+ *
+ * # Form mode - for rendering:
+ * config = MyAgentConfig(schedule=CronInput(label=LocaleString(en="Schedule")))
+ *
+ * # Data mode - from submission (Pydantic validates into CronSchedule):
+ * config = MyAgentConfig(schedule=CronSchedule(hour="12", timezone="Europe/Zurich"))
+ * ```
+ */
+export type CronInputWritable = {
+  /**
+   * Is Formkit Element
+   *
+   * Indicates that this element is a FormKit element
+   */
+  is_formkit_element?: true;
+  /**
+   * If
+   *
+   * Conditional expression to show this element
+   */
+  if?: string | null;
+  /**
+   * Id
+   *
+   * Unique identifier for this element
+   */
+  id?: string | null;
+  /**
+   * Nullable
+   *
+   * Render with a sibling toggle that sets this field to null when off
+   */
+  nullable?: boolean;
+  /**
+   * Defaultenabled
+   *
+   * 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.
+   */
+  defaultEnabled?: boolean | null;
+  /**
+   * Formkit
+   *
+   * Cron schedule input element.
+   */
+  formkit?: "cronInput";
+  /**
+   * Name
+   *
+   * Name of this field
+   */
+  name?: string | null;
+  /**
+   * Label
+   *
+   * Label of this field
+   */
+  label: LocaleString | string;
+  /**
+   * Help
+   *
+   * Help text of this field
+   */
+  help?: LocaleString | string | null;
+  /**
+   * Value
+   *
+   * Default value for this field
+   */
+  value?:
+    | string
+    | number
+    | number
+    | boolean
+    | Array<string>
+    | {
+        [key: string]: string;
+      }
+    | null;
+  /**
+   * Required
+   *
+   * Whether this field is required
+   */
+  required?: boolean;
+  /**
+   * Additional Validation Rules
+   *
+   * Validation expression
+   */
+  additional_validation_rules?: string | null;
+  /**
+   * Timezoneplaceholder
+   *
+   * Placeholder for the timezone select
+   */
+  timezonePlaceholder?: LocaleString | string | null;
+  /**
+   * Filter
+   *
+   * Whether to enable filtering/search on the timezone select
+   */
+  filter?: boolean;
+  [key: string]: unknown;
+};
+
+/**
+ * CronStartEvent
+ *
+ * Start event fired by the cron scheduler — handling it is what makes an agent schedulable.
+ *
+ * Mirrors how accepting a `UserMessageEvent` makes an agent conversational: `AgentRunner` derives
+ * `is_schedulable` from the start events an agent declares, so a blueprint opts in by adding a step
+ * that consumes this event, with no separate registration.
+ *
+ * Scheduled runs are system runs, so `user` is always None and the agent must not depend on an
+ * initiating identity. Whatever tenant context the agent needs comes from its own profile
+ * configuration (as `OrgMemoryWriteConfig.tenant_id` already does), never from the run.
+ */
+export type CronStartEventWritable = {
+  /**
+   * Event Id
+   */
+  event_id?: string;
+  /**
+   * Created At
+   *
+   * The time (in ns since epoch) the event was stored in the event store
+   */
+  created_at?: number;
+  /**
+   * Display name for the event
+   */
+  display_name?: LocaleString | null;
+  /**
+   * Display description for the event
+   */
+  display_description?: LocaleString | null;
+  /**
+   * Locale
+   *
+   * The locale the scheduled run reports its display output in.
+   */
+  locale?: string;
+  /**
+   * Always None — scheduled runs are system-initiated and carry no execution identity.
+   */
+  user?: UserIdentity | null;
+  /**
+   * Scheduled For
+   *
+   * 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.
+   */
+  scheduled_for: Date;
+  [key: string]: unknown;
+};
+
 /**
  * DatePicker
  *
@@ -18857,6 +19550,12 @@ export type FullAgentInstanceDtoWritable = {
    * Whether the agent can participate in a chat-based conversation
    */
   is_conversational: boolean;
+  /**
+   * Is Schedulable
+   *
+   * Whether the agent can be run automatically on a cron schedule
+   */
+  is_schedulable?: boolean;
   /**
    * Start Events
    *
@@ -18968,6 +19667,7 @@ export type FullProcessInstanceDtoWritable = {
     | CheckboxWritable
     | ChipsInputWritable
     | ColorPickerWritable
+    | CronInputWritable
     | DatePickerWritable
     | GroupWritable
     | IconSelectorWritable
@@ -19093,6 +19793,7 @@ export type GroupWritable = {
     | CheckboxWritable
     | ChipsInputWritable
     | ColorPickerWritable
+    | CronInputWritable
     | DatePickerWritable
     | GroupWritable
     | IconSelectorWritable
@@ -19296,6 +19997,7 @@ export type HumanInDtoWritable = {
     | CheckboxWritable
     | ChipsInputWritable
     | ColorPickerWritable
+    | CronInputWritable
     | DatePickerWritable
     | GroupWritable
     | IconSelectorWritable
@@ -19376,6 +20078,7 @@ export type HumanInSpecsWritable = {
     | CheckboxWritable
     | ChipsInputWritable
     | ColorPickerWritable
+    | CronInputWritable
     | DatePickerWritable
     | GroupWritable
     | IconSelectorWritable
@@ -20823,6 +21526,18 @@ export type LlmCostEventWritable = {
    * The name of the LLM service (e.g., 'openai/gpt-4') this event pertains to.
    */
   llm_name: string;
+  /**
+   * User Id
+   *
+   * Invoking user, so spend is queryable per user. None for runs with no user context.
+   */
+  user_id?: string | null;
+  /**
+   * Tenant Id
+   *
+   * Acting tenant, so spend is queryable per tenant. None for sysadmins and system runs.
+   */
+  tenant_id?: string | null;
   [key: string]: unknown;
 };
 
@@ -21357,6 +22072,75 @@ export type LocaleInputWritable = {
   [key: string]: unknown;
 };
 
+/**
+ * MailBatchClassifiedEvent
+ *
+ * Summarises one classification run: how many messages were classified and where each was filed.
+ *
+ * One event per run rather than one per message, matching `MailBatchDraftedEvent` — the per-message detail rides in
+ * `classified`. Filing is what prevents reprocessing: every message leaves the source folder, so the next unread
+ * listing cannot see it again.
+ */
+export type MailBatchClassifiedEventWritable = {
+  /**
+   * Event Id
+   */
+  event_id?: string;
+  /**
+   * Created At
+   *
+   * The time (in ns since epoch) the event was stored in the event store
+   */
+  created_at?: number;
+  /**
+   * Display name for the event
+   */
+  display_name?: LocaleString | null;
+  /**
+   * Display description for the event
+   */
+  display_description?: LocaleString | null;
+  /**
+   * Source Folder
+   *
+   * Folder the classified messages were read from.
+   */
+  source_folder: string;
+  /**
+   * Count
+   *
+   * Number of messages classified and filed in this run.
+   */
+  count: number;
+  /**
+   * Per Category
+   *
+   * How many messages were filed under each configured category.
+   */
+  per_category?: {
+    [key: string]: number;
+  };
+  /**
+   * Fallback Count
+   *
+   * How many messages went to the fallback folder instead of a category.
+   */
+  fallback_count?: number;
+  /**
+   * Failed Count
+   *
+   * 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.
+   */
+  failed_count?: number;
+  /**
+   * Classified
+   *
+   * Per-message classification verdicts and filing destinations.
+   */
+  classified?: Array<MailClassificationRef>;
+  [key: string]: unknown;
+};
+
 /**
  * MailBatchDraftedEvent
  *
@@ -21396,6 +22180,20 @@ export type MailBatchDraftedEventWritable = {
    * Number of reply drafts created in this run.
    */
   count: number;
+  /**
+   * Per Category
+   *
+   * How many drafts were created for each category, when drafting followed a classification run. Empty when the drafting blueprint does not classify.
+   */
+  per_category?: {
+    [key: string]: number;
+  };
+  /**
+   * Skipped Count
+   *
+   * Messages in the batch that got no draft: usually because their category was not opted in, or no category fitted them at all.
+   */
+  skipped_count?: number;
   /**
    * Drafted
    *
@@ -21483,6 +22281,10 @@ export type MailFetchedEventWritable = {
    * References to the message's attachments stored in S3.
    */
   attachments?: Array<MailAttachmentRef>;
+  /**
+   * Reference to the original RFC822 message stored in S3, or null when it was not stored.
+   */
+  original_message?: MailMessageRef | null;
   [key: string]: unknown;
 };
 
@@ -21528,6 +22330,12 @@ export type MailMovedEventWritable = {
    * Folder the message was moved into.
    */
   target_folder: string;
+  /**
+   * Folder Created
+   *
+   * 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.
+   */
+  folder_created?: boolean;
   [key: string]: unknown;
 };
 
@@ -21661,6 +22469,12 @@ export type MinimalAgentInstanceDtoWritable = {
    * Whether the agent can participate in a chat-based conversation
    */
   is_conversational: boolean;
+  /**
+   * Is Schedulable
+   *
+   * Whether the agent can be run automatically on a cron schedule
+   */
+  is_schedulable?: boolean;
 };
 
 /**
@@ -22274,6 +23088,7 @@ export type ProcessClassDtoWritable = {
     | CheckboxWritable
     | ChipsInputWritable
     | ColorPickerWritable
+    | CronInputWritable
     | DatePickerWritable
     | GroupWritable
     | IconSelectorWritable
@@ -22945,6 +23760,7 @@ export type RepeaterWritable = {
     | CheckboxWritable
     | ChipsInputWritable
     | ColorPickerWritable
+    | CronInputWritable
     | DatePickerWritable
     | GroupWritable
     | IconSelectorWritable
@@ -25729,6 +26545,92 @@ export type GetAgentEventTimeseriesResponses = {
 export type GetAgentEventTimeseriesResponse =
   GetAgentEventTimeseriesResponses[keyof GetAgentEventTimeseriesResponses];
 
+export type GetLlmSpendByUserData = {
+  body?: never;
+  path: {
+    /**
+     * Tenant Id
+     *
+     * Tenant identifier: a name, ObjectId, or 'active'
+     */
+    tenant_id: string;
+  };
+  query?: {
+    /**
+     * Since
+     *
+     * Only count calls at or after this time. Defaults to the last 30 days.
+     */
+    since?: Date | null;
+  };
+  url: "/{tenant_id}/events/spend/users";
+};
+
+export type GetLlmSpendByUserErrors = {
+  /**
+   * Validation Error
+   */
+  422: HttpValidationError;
+};
+
+export type GetLlmSpendByUserError =
+  GetLlmSpendByUserErrors[keyof GetLlmSpendByUserErrors];
+
+export type GetLlmSpendByUserResponses = {
+  /**
+   * Response Get Llm Spend By User  Tenant Id  Events Spend Users Get
+   *
+   * Successful Response
+   */
+  200: Array<LlmSpend>;
+};
+
+export type GetLlmSpendByUserResponse =
+  GetLlmSpendByUserResponses[keyof GetLlmSpendByUserResponses];
+
+export type GetLlmSpendByTenantData = {
+  body?: never;
+  path: {
+    /**
+     * Tenant Id
+     *
+     * Tenant identifier: a name, ObjectId, or 'active'
+     */
+    tenant_id: string;
+  };
+  query?: {
+    /**
+     * Since
+     *
+     * Only count calls at or after this time. Defaults to the last 30 days.
+     */
+    since?: Date | null;
+  };
+  url: "/{tenant_id}/events/spend/tenants";
+};
+
+export type GetLlmSpendByTenantErrors = {
+  /**
+   * Validation Error
+   */
+  422: HttpValidationError;
+};
+
+export type GetLlmSpendByTenantError =
+  GetLlmSpendByTenantErrors[keyof GetLlmSpendByTenantErrors];
+
+export type GetLlmSpendByTenantResponses = {
+  /**
+   * Response Get Llm Spend By Tenant  Tenant Id  Events Spend Tenants Get
+   *
+   * Successful Response
+   */
+  200: Array<LlmSpend>;
+};
+
+export type GetLlmSpendByTenantResponse =
+  GetLlmSpendByTenantResponses[keyof GetLlmSpendByTenantResponses];
+
 export type GetLitellmModelsData = {
   body?: never;
   path: {