@swiss-ai-hub/web 0.319.0 → 0.321.0

package/sdk/client/schemas.gen.ts

@@ -495,7 +495,7 @@ export const AgentClassDTOSchema = {
         "FormKit elements defining the agent configuration form. Default values are embedded in the elements themselves.",
     },
     agent_config_specs: {
-      $ref: "#/components/schemas/AgentConfigSpecs",
+      $ref: "#/components/schemas/ConfigSpecs",
       description:
         "Validation specification including the JSON schema for form submissions. Used by ModelCreationService to create Pydantic models for validation.",
     },
@@ -737,29 +737,6 @@ export const AgentConfigDTOSchema = {
     "Encapsulates the data transfer object for an agent INSTANCE's configuration.\n\nContains instance-level data (agent_id, name, description, icon) and the\nconfiguration form. Values come from both:\n- AgentClassEntity: class-level form schema\n- AgentConfigEntityDocument: instance-specific name, description, icon, agent_id\n\nNOTE: This represents config for an INSTANCE (with agent_id), not an agent CLASS.",
 } as const;
 
-export const AgentConfigSpecsSchema = {
-  properties: {
-    agent_class: {
-      type: "string",
-      title: "Agent Class",
-      description: "The class name of the agent.",
-    },
-    agent_config_schema: {
-      additionalProperties: true,
-      type: "object",
-      title: "Agent Config Schema",
-      description:
-        "JSON schema for validating form submissions. Generated from the agent's configurable fields via to_configurable_submission_model().",
-      default: {},
-    },
-  },
-  type: "object",
-  required: ["agent_class"],
-  title: "AgentConfigSpecs",
-  description:
-    "Validation specification for agent configuration form submissions.\n\nContains ONLY the agent class identifier and JSON schema for validation.\nInstance-level fields (name, description, icon, agent_id) are stored\nseparately in AgentConfigEntityDocument and provided by the Agent class.\n\nThe JSON schema is generated from the agent's configurable fields via\nto_configurable_submission_model() and is used to validate form submissions.",
-} as const;
-
 export const AgentEventSchema = {
   properties: {
     event_id: {
@@ -1015,6 +992,12 @@ export const AgentInTheLoopExceptionEventSchema = {
       description:
         "The exception event from the delegated agent containing error details and failure context.",
     },
+    request_event_id: {
+      type: "string",
+      title: "Request Event Id",
+      description:
+        "`event_id` of the `AgentInTheLoopRequestEvent` that failed. Carried here for the same reason the response carries it — a fan-out caller that cannot attribute a failure cannot complete its batch.",
+    },
     _event_name: {
       type: "string",
       title: "Event Name",
@@ -1035,7 +1018,12 @@ export const AgentInTheLoopExceptionEventSchema = {
   },
   additionalProperties: true,
   type: "object",
-  required: ["exception_event", "_event_name", "_parent_event_names"],
+  required: [
+    "exception_event",
+    "request_event_id",
+    "_event_name",
+    "_parent_event_names",
+  ],
   title: "AgentInTheLoopExceptionEvent",
   description:
     "An error response from an agent when a delegated task fails.\n\n### Why AgentInTheLoopExceptionEvent?\nWhen an agent encounters an error during a delegated task, this event:\n- Signals workflow disruption (since it's a `ControlEvent`), allowing error handling in the original agent\n- Is visible to the UI (since it's also a `DisplayEvent`), enabling monitoring and debugging of agent failures\n- Provides a dedicated error channel separate from successful responses",
@@ -1119,9 +1107,22 @@ export const AgentInTheLoopRequestEventSchema = {
       type: "boolean",
       title: "Share Run Id",
       description:
-        "Whether to share the run context with the other agent. Warning: In almost all cases, you will not want to share the run!",
+        "Whether to share the run context with the other agent. Warning: In almost all cases, you will not want to share the run! The response subscription is scoped to the delegated run id, so sharing it makes every subscriber of a fan-out fire on every delegate.",
       default: false,
     },
+    timeout_seconds: {
+      anyOf: [
+        {
+          type: "number",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Timeout Seconds",
+      description:
+        "How long to wait for the delegated agent before synthesizing a failure. `None` (the default) waits forever, which is what a delegate that never starts — an offline agent, a mistyped agent_id — costs the caller: no stop event is ever published, so the caller's run never resumes. Set it when the caller cannot tolerate that, and note it only covers a delegate that does not answer: the timer lives in the caller's dispatcher process, so it dies with the response subscription it guards.",
+    },
     _event_name: {
       type: "string",
       title: "Event Name",
@@ -1192,6 +1193,12 @@ export const AgentInTheLoopResponseEventSchema = {
       description:
         "The stop event from the delegated agent containing the task results and marks the completion.",
     },
+    request_event_id: {
+      type: "string",
+      title: "Request Event Id",
+      description:
+        "`event_id` of the `AgentInTheLoopRequestEvent` this answer belongs to. The only thing that tells a caller which delegated answer is which: a run that delegates once can infer it, but a fan-out receives N of these on one topic and nothing else on the payload distinguishes them.",
+    },
     _event_name: {
       type: "string",
       title: "Event Name",
@@ -1212,7 +1219,12 @@ export const AgentInTheLoopResponseEventSchema = {
   },
   additionalProperties: true,
   type: "object",
-  required: ["stop_event", "_event_name", "_parent_event_names"],
+  required: [
+    "stop_event",
+    "request_event_id",
+    "_event_name",
+    "_parent_event_names",
+  ],
   title: "AgentInTheLoopResponseEvent",
   description:
     "A response from an agent after completing a delegated task.\n\n### Why AgentInTheLoopResponseEvent?\nWhen an agent completes a task delegated through an `AgentInTheLoopRequestEvent`, the response:\n- Influences the workflow (since it's a `ControlEvent`), allowing the original agent to resume based on the result\n- Is visible to the UI (since it's also a `DisplayEvent`), enabling monitoring of agent interactions",
@@ -1499,6 +1511,19 @@ export const AgentSelectorSchema = {
       description:
         "Optional filter: only show agent classes that accept this start event type. Matches against event_name or event_parents in the agent's start_events.",
     },
+    agentClass: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Agentclass",
+      description:
+        "Pin the selection to one agent class. The class dropdown is not rendered and the profile dropdown lists only that class's profiles. Use it when the config already knows which blueprint answers — a dropdown offering one choice asks the admin to make a decision that was never theirs.",
+    },
     classPlaceholder: {
       anyOf: [
         {
@@ -1538,6 +1563,8 @@ export const AgentSelectorSchema = {
     validation: {
       type: "string",
       title: "Validation",
+      description:
+        "Emits `agentRefRequired` where other elements emit FormKit's `required`.\n\nFormKit's `required` rule only asks whether a value is present, and this element's value is\nalways an `{agent_class, agent_id}` object. Picking a class alone emits a non-empty object with\na blank `agent_id`, which passes `required` and then delegates to a NATS wildcard at runtime.\n`agentRefRequired` (registered in the frontend FormKit config) looks at both halves.",
       readOnly: true,
     },
   },
@@ -1546,7 +1573,7 @@ export const AgentSelectorSchema = {
   required: ["label", "validation"],
   title: "AgentSelector",
   description:
-    'A FormKit element for selecting an agent class and instance ID.\n\nThis element renders as a cascading selection:\n1. Agent class dropdown (loads from /api/v1/agents/classes)\n2. Agent ID dropdown (populated based on selected class from /api/v1/agents/classes/{class}/instances)\n\nThe output is a structured object containing both the class name and the instance ID:\n{"agent_class": str, "agent_id": str}\n\n### Optional Filtering by Start Event\n\nWhen `start_event` is specified, only agent classes that accept the given event type\nare shown. For example, `start_event="AskExpertStartEvent"` filters to only show agents\nwhose `start_events` contain an event with matching `event_name` or `event_parents`.\n\nThis is similar to ModelSelect\'s `mode` parameter for filtering by model type.\n\n### Form Duality\n\nWhen used with AgentRef, the form submission is validated directly into AgentRef:\n\n```python\nfrom swiss_ai_hub.core.form.elements.agent_selector import AgentSelector\nfrom swiss_ai_hub.core.form.forms.AgentRef import AgentRef\n\nclass MyConfig(Form):\n    target_agent: Annotated[\n        AgentRef | AgentSelector,\n        Field(description="The target agent to invoke"),\n    ]\n\n    @classmethod\n    def as_form(cls) -> "MyConfig":\n        return cls(\n            target_agent=AgentSelector(\n                label=LocaleString(en="Target Agent", de="Ziel-Agent"),\n                start_event="SomeStartEvent",  # Optional filter\n            ),\n        )\n\n    # Data mode - from submission:\n    config = MyConfig(\n        target_agent=AgentRef(\n            agent_class="my_agent_class",\n            agent_id="my_agent_id",\n        ),\n    )\n```',
+    'A FormKit element for selecting an agent class and instance ID.\n\nThis element renders as a cascading selection:\n1. Agent class dropdown (loads from /api/v1/agents/classes)\n2. Agent ID dropdown (populated based on selected class from /api/v1/agents/classes/{class}/instances)\n\nThe output is a structured object containing both the class name and the instance ID:\n{"agent_class": str, "agent_id": str}\n\n### Optional Filtering by Start Event\n\nWhen `start_event` is specified, only agent classes that accept the given event type\nare shown. For example, `start_event="AskExpertStartEvent"` filters to only show agents\nwhose `start_events` contain an event with matching `event_name` or `event_parents`.\n\nThis is similar to ModelSelect\'s `mode` parameter for filtering by model type.\n\n### Pinning to One Agent Class\n\nWhen `agent_class` is specified, the class dropdown is not rendered at all and the profile dropdown lists only\nthat class\'s profiles. `start_event` is redundant then — the class is already decided — so set one or the other.\n\n### Form Duality\n\nWhen used with AgentRef, the form submission is validated directly into AgentRef:\n\n```python\nfrom swiss_ai_hub.core.form.elements.agent_selector import AgentSelector\nfrom swiss_ai_hub.core.form.forms.AgentRef import AgentRef\n\nclass MyConfig(Form):\n    target_agent: Annotated[\n        AgentRef | AgentSelector,\n        Field(description="The target agent to invoke"),\n    ]\n\n    @classmethod\n    def as_form(cls) -> "MyConfig":\n        return cls(\n            target_agent=AgentSelector(\n                label=LocaleString(en="Target Agent", de="Ziel-Agent"),\n                start_event="SomeStartEvent",  # Optional filter\n            ),\n        )\n\n    # Data mode - from submission:\n    config = MyConfig(\n        target_agent=AgentRef(\n            agent_class="my_agent_class",\n            agent_id="my_agent_id",\n        ),\n    )\n```',
 } as const;
 
 export const AgentSuitabilityAcceptEventSchema = {
@@ -2266,6 +2293,19 @@ export const BaseStoreMemoryEventSchema = {
       title: "Deleted Relations",
       description: "Deleted relations",
     },
+    llm_model_name: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Llm Model Name",
+      description:
+        "Model that extracted these memories (issue #1590), or None when the write stored verbatim text. Carried on this event only, for observability — it is not stored in mem0's metadata, so it cannot be recovered from the memory record itself once this event is gone.",
+    },
     _event_name: {
       type: "string",
       title: "Event Name",
@@ -2555,10 +2595,31 @@ export const CapabilitySchema = {
       description:
         "Exact access rule that grants this capability, or null for read-only capabilities.",
     },
+    companion_rules: {
+      items: {
+        type: "string",
+      },
+      type: "array",
+      title: "Companion Rules",
+      description:
+        "Rules written *and* removed together with `rule`. A knowledge database's row carries `<rule>.>` here: its namespaces belong to it, and a `.>` rule never matches its own root, so the row needs both forms to mean 'this whole database'.",
+      default: [],
+    },
+    revoked_rules: {
+      items: {
+        type: "string",
+      },
+      type: "array",
+      title: "Revoked Rules",
+      description:
+        "Rules removed with `rule`, never written with it. An agent class's row carries `<rule>.>` here: granting it would hand over every profile of the class in the deployment, other tenants' included, but a ceiling written before that was understood still holds it.",
+      default: [],
+    },
     granted: {
       type: "boolean",
       title: "Granted",
-      description: "Whether the draft rules grant this capability.",
+      description:
+        "Whether the draft rules grant `rule` and every `companion_rules` entry.",
     },
     locked: {
       type: "boolean",
@@ -5342,6 +5403,29 @@ export const CompletionUsageSchema = {
   description: "Usage statistics for the completion request.",
 } as const;
 
+export const ConfigSpecsSchema = {
+  properties: {
+    config_class: {
+      type: "string",
+      title: "Config Class",
+      description: "The class name of the configuration this schema describes.",
+      default: "",
+    },
+    config_schema: {
+      additionalProperties: true,
+      type: "object",
+      title: "Config Schema",
+      description:
+        "JSON schema for validating form submissions. Generated from the configuration's configurable fields via to_configurable_submission_model().",
+      default: {},
+    },
+  },
+  type: "object",
+  title: "ConfigSpecs",
+  description:
+    "Validation specification for a form-duality configuration, as announced by the service that owns it.\n\nCarries only the JSON schema the API validates submissions against, so a configuration class defined in\nan agent, process or pipeline container can be enforced by the API without that class being installed there.",
+} as const;
+
 export const ContextInsufficientRejectEventSchema = {
   properties: {
     event_id: {
@@ -5648,7 +5732,7 @@ export const ContextualizedAgentEventSchema = {
           $ref: "#/components/schemas/RAGStartEvent",
         },
         {
-          $ref: "#/components/schemas/ScheduledStartEvent",
+          $ref: "#/components/schemas/CronStartEvent",
         },
         {
           $ref: "#/components/schemas/ExceptionEvent",
@@ -5722,6 +5806,9 @@ export const ContextualizedAgentEventSchema = {
         {
           $ref: "#/components/schemas/MailBatchDraftedEvent",
         },
+        {
+          $ref: "#/components/schemas/MailBatchClassifiedEvent",
+        },
       ],
       title: "Event",
       description: "Data of the event itself.",
@@ -5875,6 +5962,28 @@ export const CreateAgentInstanceRequestSchema = {
     "Request body for creating a new agent instance.\nThe agent_class is provided in the URL path, not in the request body.",
 } as const;
 
+export const CreateDatabaseRequestSchema = {
+  properties: {
+    ingestor: {
+      type: "string",
+      title: "Ingestor",
+      description:
+        "The deployed ingestion pipeline that processes this database's documents. Valid values are served by GET /knowledge/ingestors.",
+      default: "document_ingestion",
+    },
+    configuration: {
+      additionalProperties: true,
+      type: "object",
+      title: "Configuration",
+      description:
+        "The database's configuration as submitted through the ingestor's announced form: its multilingual name and description plus every knob the pipeline declares. Validated against the ingestor's schema.",
+      default: {},
+    },
+  },
+  type: "object",
+  title: "CreateDatabaseRequest",
+} as const;
+
 export const CreateNamespaceRequestSchema = {
   properties: {
     folder_name: {
@@ -6247,7 +6356,93 @@ export const CronInputSchema = {
   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 `AgentSchedule`:\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.agent_schedule import AgentSchedule\n\nclass MyAgentConfig(AgentConfig):\n    schedule: Annotated[\n        AgentSchedule | 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 AgentSchedule):\nconfig = MyAgentConfig(schedule=AgentSchedule(hour="12", timezone="Europe/Zurich"))\n```',
+    '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 = {
@@ -6432,6 +6627,18 @@ export const DatabaseDTOSchema = {
       title: "Auto Sync",
       description: "Whether this database auto-syncs namespaces",
     },
+    deletable: {
+      type: "boolean",
+      title: "Deletable",
+      description:
+        "Whether the database itself may be deleted; false for auto-synced databases, whose content is owned by a source, and for the legacy default_rag/shared_rag databases, which are re-provisioned from deployment configuration. Namespaces and individual documents are governed separately and stay deletable.",
+    },
+    ingestor: {
+      type: "string",
+      title: "Ingestor",
+      description:
+        "Identifier of the ingestion pipeline that processes this database, as served by GET /knowledge/ingestors. Visible to anyone who can see the database, so a database-level rule holder learns how it is configured without seeing its namespaces.",
+    },
     namespaces: {
       items: {
         $ref: "#/components/schemas/NamespaceDTO",
@@ -6442,10 +6649,73 @@ export const DatabaseDTOSchema = {
     },
   },
   type: "object",
-  required: ["name", "display_name", "auto_sync", "namespaces"],
+  required: [
+    "name",
+    "display_name",
+    "auto_sync",
+    "deletable",
+    "ingestor",
+    "namespaces",
+  ],
   title: "DatabaseDTO",
 } as const;
 
+export const DatabaseResponseSchema = {
+  properties: {
+    name: {
+      type: "string",
+      title: "Name",
+      description:
+        "The database name (also the Milvus collection and Mongo store name).",
+    },
+    bucket_name: {
+      type: "string",
+      title: "Bucket Name",
+      description: "The S3 bucket / data lake container name.",
+    },
+    ingestor: {
+      type: "string",
+      title: "Ingestor",
+      description: "The deployed ingestion pipeline that owns this database.",
+    },
+    configuration: {
+      additionalProperties: true,
+      type: "object",
+      title: "Configuration",
+      description:
+        "The ingestor's settings for this database, as validated against its announced schema.",
+      default: {},
+    },
+    display_name: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Display Name",
+      description: "A user-friendly display name for the database.",
+    },
+    description: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Description",
+      description: "A brief description of the database's contents.",
+    },
+  },
+  type: "object",
+  required: ["name", "bucket_name", "ingestor"],
+  title: "DatabaseResponse",
+} as const;
+
 export const DatasetSchema = {
   properties: {
     id: {
@@ -7431,7 +7701,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",
@@ -8402,7 +8686,7 @@ export const FullProcessInstanceDTOSchema = {
         "List of agent work events that the process can receive. Agent work events are used to trigger the execution of an agent.",
     },
     process_config_specs: {
-      $ref: "#/components/schemas/ProcessConfigSpecs",
+      $ref: "#/components/schemas/ConfigSpecs",
       description:
         "Configuration specifications of the process class, including schema and parameters.",
     },
@@ -11292,6 +11576,151 @@ export const IngestedNodeSchema = {
     "A node represents a chunk of a document, like a paragraph, produced by a document parser and text splitter.\nThe attributes defined here are the minimal number of attributes that a node must have to ensure the\nUI can properly display it. Note that all attributes that are specific to text documents, like start_char_idx etc.\nmust be strictly optional, as we don't really know whether the node is indeed a text node. However, all attributes\nthat are purely technical, like the document_id to keep the back-ref to the ref_doc from which the node originates,\nare strictly necessary.",
 } as const;
 
+export const IngestorDTOSchema = {
+  properties: {
+    name: {
+      type: "string",
+      title: "Name",
+      description:
+        "Ingestor identifier, as served by GET /knowledge/ingestors.",
+    },
+    display_name: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Display Name",
+      description: "Localized name of the ingestion pipeline.",
+    },
+    description: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Description",
+      description: "Localized description of what the pipeline does.",
+    },
+    form: {
+      items: {
+        oneOf: [
+          {
+            $ref: "#/components/schemas/HtmlElement",
+          },
+          {
+            $ref: "#/components/schemas/AgentSelector",
+          },
+          {
+            $ref: "#/components/schemas/CascadeSelect",
+          },
+          {
+            $ref: "#/components/schemas/Checkbox",
+          },
+          {
+            $ref: "#/components/schemas/ChipsInput",
+          },
+          {
+            $ref: "#/components/schemas/ColorPicker",
+          },
+          {
+            $ref: "#/components/schemas/CronInput",
+          },
+          {
+            $ref: "#/components/schemas/DatePicker",
+          },
+          {
+            $ref: "#/components/schemas/Group",
+          },
+          {
+            $ref: "#/components/schemas/IconSelector",
+          },
+          {
+            $ref: "#/components/schemas/InputMask",
+          },
+          {
+            $ref: "#/components/schemas/InputNumber",
+          },
+          {
+            $ref: "#/components/schemas/InputOtp",
+          },
+          {
+            $ref: "#/components/schemas/InputText",
+          },
+          {
+            $ref: "#/components/schemas/KnowledgeDatabaseSelector",
+          },
+          {
+            $ref: "#/components/schemas/Knob",
+          },
+          {
+            $ref: "#/components/schemas/Listbox",
+          },
+          {
+            $ref: "#/components/schemas/LocaleInput",
+          },
+          {
+            $ref: "#/components/schemas/ModelSelect",
+          },
+          {
+            $ref: "#/components/schemas/MultiSelect",
+          },
+          {
+            $ref: "#/components/schemas/Password",
+          },
+          {
+            $ref: "#/components/schemas/RadioButton",
+          },
+          {
+            $ref: "#/components/schemas/Rating",
+          },
+          {
+            $ref: "#/components/schemas/Repeater",
+          },
+          {
+            $ref: "#/components/schemas/Select",
+          },
+          {
+            $ref: "#/components/schemas/SelectButton",
+          },
+          {
+            $ref: "#/components/schemas/Slider",
+          },
+          {
+            $ref: "#/components/schemas/TenantSelect",
+          },
+          {
+            $ref: "#/components/schemas/Textarea",
+          },
+          {
+            $ref: "#/components/schemas/ToggleButton",
+          },
+          {
+            $ref: "#/components/schemas/ToggleSwitch",
+          },
+          {
+            $ref: "#/components/schemas/VectorStoreInput",
+          },
+        ],
+      },
+      type: "array",
+      title: "Form",
+      description:
+        "FormKit elements a database of this ingestor is configured through, localized.",
+      default: [],
+    },
+  },
+  type: "object",
+  required: ["name", "display_name", "description"],
+  title: "IngestorDTO",
+} as const;
+
 export const InputAudioSchema = {
   properties: {
     data: {
@@ -12928,6 +13357,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",
@@ -13194,6 +13649,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: {
@@ -14082,6 +14600,108 @@ 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 MailBatchClassifiedEventSchema = {
+  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.",
+    },
+    _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: "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 MailBatchDraftedEventSchema = {
   properties: {
     event_id: {
@@ -14126,6 +14746,22 @@ export const MailBatchDraftedEventSchema = {
       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",
@@ -14160,6 +14796,81 @@ export const MailBatchDraftedEventSchema = {
     "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: {
@@ -14409,6 +15120,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",
@@ -17349,7 +18067,7 @@ export const ProcessClassDTOSchema = {
       description: "FormKit elements defining the configuration form.",
     },
     process_config_specs: {
-      $ref: "#/components/schemas/ProcessConfigSpecs",
+      $ref: "#/components/schemas/ConfigSpecs",
       description:
         "Configuration specifications of the process class, including schema and parameters.",
     },
@@ -17447,29 +18165,6 @@ export const ProcessConfigDTOSchema = {
   title: "ProcessConfigDTO",
 } as const;
 
-export const ProcessConfigSpecsSchema = {
-  properties: {
-    process_class: {
-      type: "string",
-      title: "Process Class",
-      description: "The class name of the process.",
-      default: "",
-    },
-    process_config_schema: {
-      additionalProperties: true,
-      type: "object",
-      title: "Process Config Schema",
-      description:
-        "JSON schema for validating form submissions. Generated from the process's configurable fields via to_configurable_submission_model().",
-      default: {},
-    },
-  },
-  type: "object",
-  title: "ProcessConfigSpecs",
-  description:
-    "Validation specification for process configuration form submissions.\n\nContains the process class identifier and JSON schema for validation.\nInstance-level fields (name, description, icon, process_id) are stored\nseparately in ProcessConfigEntityDocument and provided by the Process class.\n\nThe JSON schema is generated from the process's configurable fields via\nto_configurable_submission_model() and is used to validate form submissions.",
-} as const;
-
 export const ProcessHealthChecksSchema = {
   properties: {
     running: {
@@ -17884,10 +18579,12 @@ export const PromptTokensDetailsSchema = {
 export const RAGFailureReasonSchema = {
   type: "string",
   enum: [
+    "condensation_empty",
     "context_insufficient",
     "expert_declined",
     "expert_errored",
     "few_shot_rejected",
+    "input_too_large",
   ],
   title: "RAGFailureReason",
   description: "Why a RAG run failed to produce a useful answer.",
@@ -18012,8 +18709,16 @@ export const RAGStartEventSchema = {
       default: "de",
     },
     user: {
-      $ref: "#/components/schemas/UserIdentity",
-      description: "User on whose behalf the RAG run is executed.",
+      anyOf: [
+        {
+          $ref: "#/components/schemas/UserIdentity",
+        },
+        {
+          type: "null",
+        },
+      ],
+      description:
+        "User on whose behalf the RAG run is executed, when there is one. Optional because a delegating agent forwards whatever identity its own start event carries, and a scheduled run carries none — there is no service account to substitute. The RAG agent's user-memory steps are what read it, and they are skipped without it rather than attributing one caller's memories to a shared identity.",
     },
     messages: {
       items: {
@@ -18094,12 +18799,7 @@ export const RAGStartEventSchema = {
   },
   additionalProperties: true,
   type: "object",
-  required: [
-    "user",
-    "selected_namespaces",
-    "_event_name",
-    "_parent_event_names",
-  ],
+  required: ["selected_namespaces", "_event_name", "_parent_event_names"],
   title: "RAGStartEvent",
   description:
     "Namespace-aware start event for the RAG agent.\n\n`RAGStartEvent` is intended for non-chat publishers: custom domain front-ends that run their own namespace\nselection UI, or other agents delegating to RAG via `AgentInTheLoop`.",
@@ -19667,92 +20367,6 @@ export const RunStatisticsSchema = {
   description: "Statistics for a single run, intended for API response.",
 } as const;
 
-export const ScheduledStartEventSchema = {
-  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: "ScheduledStartEvent",
-  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 SearchContextCostPerQueryDTOSchema = {
   properties: {
     search_context_size_low: {
@@ -20908,7 +21522,7 @@ export const StandaloneQuestionCondenserEventSchema = {
   required: ["condensed_chat_message", "_event_name", "_parent_event_names"],
   title: "StandaloneQuestionCondenserEvent",
   description:
-    "Event to condense chat messages into a single standalone question as a chat message.",
+    "Event to condense chat messages into a single standalone question as a chat message.\n\nA blank condensation is refused by `condense_standalone_question`, before an event of this type can be\nbuilt. The invariant is deliberately *not* also a `field_validator` here: a validator on an event is not\nonly a publish-time contract, it runs on every `model_validate`, which is how the immutable log is read\nback — JetStream replays the whole stream on each agent start, and the API rebuilds a thread's timeline\nfrom the persisted display copy. Blank condensations did occur before the producer-side raise existed, so\nvalidating on read makes that history undeserializable: replay drops the event and\n`EventService.get_events_in_thread` fails the whole thread.",
 } as const;
 
 export const StartEventSchema = {
@@ -21105,113 +21719,139 @@ export const StoreOrganizationMemoryEventSchema = {
       title: "Deleted Relations",
       description: "Deleted relations",
     },
-    _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: [
-    "added_memories",
-    "updated_memories",
-    "deleted_memories",
-    "added_relations",
-    "deleted_relations",
-    "_event_name",
-    "_parent_event_names",
-  ],
-  title: "StoreOrganizationMemoryEvent",
-  description:
-    "Specialized BaseStoreMemoryEvent for organization-wide memories.\n\nEmitted when an agent stores shared organizational memories to long-term storage.\nThese memories are accessible to all users within the organization namespace.\nUnlike user memories (inferred from chat), organization memories are explicit facts provided by users.",
-} as const;
-
-export const StoreUserMemoryEventSchema = {
-  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: {
+    llm_model_name: {
       anyOf: [
         {
-          $ref: "#/components/schemas/LocaleString",
-        },
-        {
-          type: "null",
-        },
-      ],
-      description: "Display name for the event",
-    },
-    display_description: {
-      anyOf: [
-        {
-          $ref: "#/components/schemas/LocaleString",
+          type: "string",
         },
         {
           type: "null",
         },
       ],
-      description: "Display description for the event",
-    },
-    added_memories: {
-      items: {
-        type: "string",
-      },
-      type: "array",
-      title: "Added Memories",
-      description: "Newly added memory texts",
-    },
-    updated_memories: {
-      items: {
-        type: "string",
-      },
-      type: "array",
-      title: "Updated Memories",
-      description: "Updated memory texts",
-    },
-    deleted_memories: {
-      items: {
-        type: "string",
-      },
-      type: "array",
-      title: "Deleted Memories",
-      description: "Deleted memory texts",
-    },
-    added_relations: {
-      items: {
-        $ref: "#/components/schemas/MemoryRelation",
-      },
-      type: "array",
-      title: "Added Relations",
-      description: "Newly added relations",
-    },
-    deleted_relations: {
-      items: {
-        $ref: "#/components/schemas/MemoryRelation",
-      },
-      type: "array",
-      title: "Deleted Relations",
-      description: "Deleted relations",
+      title: "Llm Model Name",
+      description:
+        "Model that extracted these memories (issue #1590), or None when the write stored verbatim text. Carried on this event only, for observability — it is not stored in mem0's metadata, so it cannot be recovered from the memory record itself once this event is gone.",
+    },
+    _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: [
+    "added_memories",
+    "updated_memories",
+    "deleted_memories",
+    "added_relations",
+    "deleted_relations",
+    "_event_name",
+    "_parent_event_names",
+  ],
+  title: "StoreOrganizationMemoryEvent",
+  description:
+    "Specialized BaseStoreMemoryEvent for organization-wide memories.\n\nEmitted when an agent stores shared organizational memories to long-term storage.\nThese memories are accessible to all users within the organization namespace.\nUnlike user memories (inferred from chat), organization memories are explicit facts provided by users.",
+} as const;
+
+export const StoreUserMemoryEventSchema = {
+  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",
+    },
+    added_memories: {
+      items: {
+        type: "string",
+      },
+      type: "array",
+      title: "Added Memories",
+      description: "Newly added memory texts",
+    },
+    updated_memories: {
+      items: {
+        type: "string",
+      },
+      type: "array",
+      title: "Updated Memories",
+      description: "Updated memory texts",
+    },
+    deleted_memories: {
+      items: {
+        type: "string",
+      },
+      type: "array",
+      title: "Deleted Memories",
+      description: "Deleted memory texts",
+    },
+    added_relations: {
+      items: {
+        $ref: "#/components/schemas/MemoryRelation",
+      },
+      type: "array",
+      title: "Added Relations",
+      description: "Newly added relations",
+    },
+    deleted_relations: {
+      items: {
+        $ref: "#/components/schemas/MemoryRelation",
+      },
+      type: "array",
+      title: "Deleted Relations",
+      description: "Deleted relations",
+    },
+    llm_model_name: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Llm Model Name",
+      description:
+        "Model that extracted these memories (issue #1590), or None when the write stored verbatim text. Carried on this event only, for observability — it is not stored in mem0's metadata, so it cannot be recovered from the memory record itself once this event is gone.",
     },
     _event_name: {
       type: "string",
@@ -24237,7 +24877,7 @@ export const VectorStoreInputSchema = {
   required: ["label", "validation"],
   title: "VectorStoreInput",
   description:
-    'A FormKit element for selecting a vector store collection, namespaces, and\nthe metadata keys publishers are allowed to filter on at query time.\n\nThis element renders as three controls:\n1. Database dropdown (loads from /api/v1/knowledge/databases)\n2. Namespace multi-select (populated based on selected database)\n3. Free-form chips input for `allowed_metadata_filter_fields`\n\nThe output matches the three configurable fields of `MilvusVectorStoreConfig`:\n{\n    "collection_name": str,\n    "index_namespaces": list[str],\n    "allowed_metadata_filter_fields": list[str],\n}\n\n### Form Duality\nWhen used with MilvusVectorStoreConfig, the form submission is validated\ndirectly into MilvusVectorStoreConfig (connection settings are read from\nMilvusSettings at runtime).\n\n### Example Usage\n```python\nfrom swiss_ai_hub.core.form.elements.vector_store_input import VectorStoreInput\nfrom swiss_ai_hub.core.persistence.rag.vectors.stores.milvus_vector_store_config import MilvusVectorStoreConfig\n\nclass MyRetrieverConfig(Form):\n    vector_store: Annotated[\n        MilvusVectorStoreConfig | VectorStoreInput,\n        Field(description="The vector store configuration"),\n    ]\n\n# Form mode - for rendering:\nconfig = MyRetrieverConfig(\n    vector_store=VectorStoreInput(\n        label=LocaleString(en="Vector Store", de="Vektorspeicher"),\n    ),\n)\n\n# Data mode - from submission (Pydantic validates into MilvusVectorStoreConfig):\nconfig = MyRetrieverConfig(\n    vector_store=MilvusVectorStoreConfig(\n        collection_name="my-database",\n        index_namespaces=["namespace1", "namespace2"],\n        allowed_metadata_filter_fields=["department", "year"],\n    ),\n)\n```',
+    'A FormKit element for selecting a vector store collection, namespaces, and\nthe metadata keys publishers are allowed to filter on at query time.\n\nThis element renders as three controls:\n1. Database dropdown (loads from /api/v1/knowledge/databases)\n2. "All namespaces" switch, or a namespace multi-select populated from the selected database\n3. Free-form chips input for `allowed_metadata_filter_fields`\n\nThe output matches the configurable fields of `MilvusVectorStoreConfig`:\n{\n    "collection_name": str,\n    "index_namespaces": list[str],\n    "all_namespaces": bool,\n    "allowed_metadata_filter_fields": list[str],\n}\n\n### Form Duality\nWhen used with MilvusVectorStoreConfig, the form submission is validated\ndirectly into MilvusVectorStoreConfig (connection settings are read from\nMilvusSettings at runtime).\n\n### Example Usage\n```python\nfrom swiss_ai_hub.core.form.elements.vector_store_input import VectorStoreInput\nfrom swiss_ai_hub.core.persistence.rag.vectors.stores.milvus_vector_store_config import MilvusVectorStoreConfig\n\nclass MyRetrieverConfig(Form):\n    vector_store: Annotated[\n        MilvusVectorStoreConfig | VectorStoreInput,\n        Field(description="The vector store configuration"),\n    ]\n\n# Form mode - for rendering:\nconfig = MyRetrieverConfig(\n    vector_store=VectorStoreInput(\n        label=LocaleString(en="Vector Store", de="Vektorspeicher"),\n    ),\n)\n\n# Data mode - from submission (Pydantic validates into MilvusVectorStoreConfig):\nconfig = MyRetrieverConfig(\n    vector_store=MilvusVectorStoreConfig(\n        collection_name="my-database",\n        index_namespaces=["namespace1", "namespace2"],\n        allowed_metadata_filter_fields=["department", "year"],\n    ),\n)\n```',
 } as const;
 
 export const VideoBlockSchema = {
@@ -24809,7 +25449,7 @@ export const AgentClassDTOWritableSchema = {
         "FormKit elements defining the agent configuration form. Default values are embedded in the elements themselves.",
     },
     agent_config_specs: {
-      $ref: "#/components/schemas/AgentConfigSpecs",
+      $ref: "#/components/schemas/ConfigSpecs",
       description:
         "Validation specification including the JSON schema for form submissions. Used by ModelCreationService to create Pydantic models for validation.",
     },
@@ -25130,10 +25770,16 @@ export const AgentInTheLoopExceptionEventWritableSchema = {
       description:
         "The exception event from the delegated agent containing error details and failure context.",
     },
+    request_event_id: {
+      type: "string",
+      title: "Request Event Id",
+      description:
+        "`event_id` of the `AgentInTheLoopRequestEvent` that failed. Carried here for the same reason the response carries it — a fan-out caller that cannot attribute a failure cannot complete its batch.",
+    },
   },
   additionalProperties: true,
   type: "object",
-  required: ["exception_event"],
+  required: ["exception_event", "request_event_id"],
   title: "AgentInTheLoopExceptionEvent",
   description:
     "An error response from an agent when a delegated task fails.\n\n### Why AgentInTheLoopExceptionEvent?\nWhen an agent encounters an error during a delegated task, this event:\n- Signals workflow disruption (since it's a `ControlEvent`), allowing error handling in the original agent\n- Is visible to the UI (since it's also a `DisplayEvent`), enabling monitoring and debugging of agent failures\n- Provides a dedicated error channel separate from successful responses",
@@ -25217,9 +25863,22 @@ export const AgentInTheLoopRequestEventWritableSchema = {
       type: "boolean",
       title: "Share Run Id",
       description:
-        "Whether to share the run context with the other agent. Warning: In almost all cases, you will not want to share the run!",
+        "Whether to share the run context with the other agent. Warning: In almost all cases, you will not want to share the run! The response subscription is scoped to the delegated run id, so sharing it makes every subscriber of a fan-out fire on every delegate.",
       default: false,
     },
+    timeout_seconds: {
+      anyOf: [
+        {
+          type: "number",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Timeout Seconds",
+      description:
+        "How long to wait for the delegated agent before synthesizing a failure. `None` (the default) waits forever, which is what a delegate that never starts — an offline agent, a mistyped agent_id — costs the caller: no stop event is ever published, so the caller's run never resumes. Set it when the caller cannot tolerate that, and note it only covers a delegate that does not answer: the timer lives in the caller's dispatcher process, so it dies with the response subscription it guards.",
+    },
   },
   additionalProperties: true,
   type: "object",
@@ -25268,10 +25927,16 @@ export const AgentInTheLoopResponseEventWritableSchema = {
       description:
         "The stop event from the delegated agent containing the task results and marks the completion.",
     },
+    request_event_id: {
+      type: "string",
+      title: "Request Event Id",
+      description:
+        "`event_id` of the `AgentInTheLoopRequestEvent` this answer belongs to. The only thing that tells a caller which delegated answer is which: a run that delegates once can infer it, but a fan-out receives N of these on one topic and nothing else on the payload distinguishes them.",
+    },
   },
   additionalProperties: true,
   type: "object",
-  required: ["stop_event"],
+  required: ["stop_event", "request_event_id"],
   title: "AgentInTheLoopResponseEvent",
   description:
     "A response from an agent after completing a delegated task.\n\n### Why AgentInTheLoopResponseEvent?\nWhen an agent completes a task delegated through an `AgentInTheLoopRequestEvent`, the response:\n- Influences the workflow (since it's a `ControlEvent`), allowing the original agent to resume based on the result\n- Is visible to the UI (since it's also a `DisplayEvent`), enabling monitoring of agent interactions",
@@ -25497,6 +26162,19 @@ export const AgentSelectorWritableSchema = {
       description:
         "Optional filter: only show agent classes that accept this start event type. Matches against event_name or event_parents in the agent's start_events.",
     },
+    agentClass: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Agentclass",
+      description:
+        "Pin the selection to one agent class. The class dropdown is not rendered and the profile dropdown lists only that class's profiles. Use it when the config already knows which blueprint answers — a dropdown offering one choice asks the admin to make a decision that was never theirs.",
+    },
     classPlaceholder: {
       anyOf: [
         {
@@ -25539,7 +26217,7 @@ export const AgentSelectorWritableSchema = {
   required: ["label"],
   title: "AgentSelector",
   description:
-    'A FormKit element for selecting an agent class and instance ID.\n\nThis element renders as a cascading selection:\n1. Agent class dropdown (loads from /api/v1/agents/classes)\n2. Agent ID dropdown (populated based on selected class from /api/v1/agents/classes/{class}/instances)\n\nThe output is a structured object containing both the class name and the instance ID:\n{"agent_class": str, "agent_id": str}\n\n### Optional Filtering by Start Event\n\nWhen `start_event` is specified, only agent classes that accept the given event type\nare shown. For example, `start_event="AskExpertStartEvent"` filters to only show agents\nwhose `start_events` contain an event with matching `event_name` or `event_parents`.\n\nThis is similar to ModelSelect\'s `mode` parameter for filtering by model type.\n\n### Form Duality\n\nWhen used with AgentRef, the form submission is validated directly into AgentRef:\n\n```python\nfrom swiss_ai_hub.core.form.elements.agent_selector import AgentSelector\nfrom swiss_ai_hub.core.form.forms.AgentRef import AgentRef\n\nclass MyConfig(Form):\n    target_agent: Annotated[\n        AgentRef | AgentSelector,\n        Field(description="The target agent to invoke"),\n    ]\n\n    @classmethod\n    def as_form(cls) -> "MyConfig":\n        return cls(\n            target_agent=AgentSelector(\n                label=LocaleString(en="Target Agent", de="Ziel-Agent"),\n                start_event="SomeStartEvent",  # Optional filter\n            ),\n        )\n\n    # Data mode - from submission:\n    config = MyConfig(\n        target_agent=AgentRef(\n            agent_class="my_agent_class",\n            agent_id="my_agent_id",\n        ),\n    )\n```',
+    'A FormKit element for selecting an agent class and instance ID.\n\nThis element renders as a cascading selection:\n1. Agent class dropdown (loads from /api/v1/agents/classes)\n2. Agent ID dropdown (populated based on selected class from /api/v1/agents/classes/{class}/instances)\n\nThe output is a structured object containing both the class name and the instance ID:\n{"agent_class": str, "agent_id": str}\n\n### Optional Filtering by Start Event\n\nWhen `start_event` is specified, only agent classes that accept the given event type\nare shown. For example, `start_event="AskExpertStartEvent"` filters to only show agents\nwhose `start_events` contain an event with matching `event_name` or `event_parents`.\n\nThis is similar to ModelSelect\'s `mode` parameter for filtering by model type.\n\n### Pinning to One Agent Class\n\nWhen `agent_class` is specified, the class dropdown is not rendered at all and the profile dropdown lists only\nthat class\'s profiles. `start_event` is redundant then — the class is already decided — so set one or the other.\n\n### Form Duality\n\nWhen used with AgentRef, the form submission is validated directly into AgentRef:\n\n```python\nfrom swiss_ai_hub.core.form.elements.agent_selector import AgentSelector\nfrom swiss_ai_hub.core.form.forms.AgentRef import AgentRef\n\nclass MyConfig(Form):\n    target_agent: Annotated[\n        AgentRef | AgentSelector,\n        Field(description="The target agent to invoke"),\n    ]\n\n    @classmethod\n    def as_form(cls) -> "MyConfig":\n        return cls(\n            target_agent=AgentSelector(\n                label=LocaleString(en="Target Agent", de="Ziel-Agent"),\n                start_event="SomeStartEvent",  # Optional filter\n            ),\n        )\n\n    # Data mode - from submission:\n    config = MyConfig(\n        target_agent=AgentRef(\n            agent_class="my_agent_class",\n            agent_id="my_agent_id",\n        ),\n    )\n```',
 } as const;
 
 export const AgentSuitabilityAcceptEventWritableSchema = {
@@ -25973,6 +26651,19 @@ export const BaseStoreMemoryEventWritableSchema = {
       title: "Deleted Relations",
       description: "Deleted relations",
     },
+    llm_model_name: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Llm Model Name",
+      description:
+        "Model that extracted these memories (issue #1590), or None when the write stored verbatim text. Carried on this event only, for observability — it is not stored in mem0's metadata, so it cannot be recovered from the memory record itself once this event is gone.",
+    },
   },
   additionalProperties: true,
   type: "object",
@@ -27251,7 +27942,7 @@ export const ContextualizedAgentEventWritableSchema = {
           $ref: "#/components/schemas/RAGStartEventWritable",
         },
         {
-          $ref: "#/components/schemas/ScheduledStartEventWritable",
+          $ref: "#/components/schemas/CronStartEventWritable",
         },
         {
           $ref: "#/components/schemas/ExceptionEventWritable",
@@ -27325,6 +28016,9 @@ export const ContextualizedAgentEventWritableSchema = {
         {
           $ref: "#/components/schemas/MailBatchDraftedEventWritable",
         },
+        {
+          $ref: "#/components/schemas/MailBatchClassifiedEventWritable",
+        },
       ],
       title: "Event",
       description: "Data of the event itself.",
@@ -27595,7 +28289,76 @@ export const CronInputWritableSchema = {
   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 `AgentSchedule`:\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.agent_schedule import AgentSchedule\n\nclass MyAgentConfig(AgentConfig):\n    schedule: Annotated[\n        AgentSchedule | 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 AgentSchedule):\nconfig = MyAgentConfig(schedule=AgentSchedule(hour="12", timezone="Europe/Zurich"))\n```',
+    '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 = {
@@ -28435,7 +29198,7 @@ export const FullProcessInstanceDTOWritableSchema = {
         "List of agent work events that the process can receive. Agent work events are used to trigger the execution of an agent.",
     },
     process_config_specs: {
-      $ref: "#/components/schemas/ProcessConfigSpecs",
+      $ref: "#/components/schemas/ConfigSpecs",
       description:
         "Configuration specifications of the process class, including schema and parameters.",
     },
@@ -29959,6 +30722,151 @@ export const IconSelectorWritableSchema = {
     'A FormKit element for selecting or entering an Iconify icon name.\n\nThis element renders as an editable select with icon preview capability.\nUsers can either select from preset icon options or enter any valid Iconify icon name.\nThe selected/entered icon is displayed live in the input field.\n\n### Features\n- Dropdown with preset icon options (each showing the icon preview)\n- Editable input for entering custom Iconify icon names\n- Live icon preview in the input field\n- Supports any valid Iconify icon (e.g., \'lucide:bot\', \'meteor-icons:robot\')\n\n### Example Usage\n```python\nclass MyAgentConfig(AgentConfig):\n    icon: Annotated[\n        str | IconSelector,\n        Field(description="Icon for the agent"),\n    ]\n\n# Form mode - for rendering:\nconfig = MyAgentConfig(\n    ...,\n    icon=IconSelector(label=LocaleString(en="Icon", de="Symbol")),\n)\n\n# Data mode - from submission:\nconfig = MyAgentConfig(\n    ...,\n    icon="mage:robot",\n)\n```',
 } as const;
 
+export const IngestorDTOWritableSchema = {
+  properties: {
+    name: {
+      type: "string",
+      title: "Name",
+      description:
+        "Ingestor identifier, as served by GET /knowledge/ingestors.",
+    },
+    display_name: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Display Name",
+      description: "Localized name of the ingestion pipeline.",
+    },
+    description: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Description",
+      description: "Localized description of what the pipeline does.",
+    },
+    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 a database of this ingestor is configured through, localized.",
+      default: [],
+    },
+  },
+  type: "object",
+  required: ["name", "display_name", "description"],
+  title: "IngestorDTO",
+} as const;
+
 export const InputMaskWritableSchema = {
   properties: {
     is_formkit_element: {
@@ -31512,6 +32420,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",
@@ -32154,17 +33088,250 @@ export const ListboxWritableSchema = {
       title: "Additional Validation Rules",
       description: "Validation expression",
     },
-    disabled: {
-      type: "boolean",
-      title: "Disabled",
-      description: "Whether the input is disabled",
-      default: false,
+    disabled: {
+      type: "boolean",
+      title: "Disabled",
+      description: "Whether the input is disabled",
+      default: false,
+    },
+    readonly: {
+      type: "boolean",
+      title: "Readonly",
+      description: "Whether the input is readonly",
+      default: false,
+    },
+    placeholder: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/LocaleString",
+        },
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Placeholder",
+      description: "Placeholder text",
+    },
+    options: {
+      items: {
+        additionalProperties: true,
+        type: "object",
+      },
+      type: "array",
+      title: "Options",
+      description: "Array of selectable option objects",
+    },
+    optionLabel: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Optionlabel",
+      description: "Property name to use as the label of an option",
+    },
+    optionValue: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Optionvalue",
+      description: "Property name to use as the value of an option",
+    },
+    multiple: {
+      type: "boolean",
+      title: "Multiple",
+      description: "Whether to allow multiple selections",
+      default: false,
+    },
+    filter: {
+      type: "boolean",
+      title: "Filter",
+      description: "Whether to enable filtering",
+      default: false,
+    },
+  },
+  additionalProperties: true,
+  type: "object",
+  required: ["label", "options"],
+  title: "Listbox",
+  description: "https://formkit-primevue.netlify.app/inputs/Listbox",
+} as const;
+
+export const LocaleInputWritableSchema = {
+  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: "localeInput",
+      title: "Formkit",
+      description: "Locale input element.",
+      default: "localeInput",
+    },
+    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",
+    },
+    inputType: {
+      type: "string",
+      enum: ["text", "textarea"],
+      title: "Inputtype",
+      description:
+        "Input type: 'text' for single-line, 'textarea' for multi-line",
+      default: "text",
     },
-    readonly: {
-      type: "boolean",
-      title: "Readonly",
-      description: "Whether the input is readonly",
-      default: false,
+    rows: {
+      type: "integer",
+      title: "Rows",
+      description: "Number of rows for textarea mode (ignored for text mode)",
+      default: 3,
     },
     placeholder: {
       anyOf: [
@@ -32179,248 +33346,100 @@ export const ListboxWritableSchema = {
         },
       ],
       title: "Placeholder",
-      description: "Placeholder text",
-    },
-    options: {
-      items: {
-        additionalProperties: true,
-        type: "object",
-      },
-      type: "array",
-      title: "Options",
-      description: "Array of selectable option objects",
-    },
-    optionLabel: {
-      anyOf: [
-        {
-          type: "string",
-        },
-        {
-          type: "null",
-        },
-      ],
-      title: "Optionlabel",
-      description: "Property name to use as the label of an option",
-    },
-    optionValue: {
-      anyOf: [
-        {
-          type: "string",
-        },
-        {
-          type: "null",
-        },
-      ],
-      title: "Optionvalue",
-      description: "Property name to use as the value of an option",
-    },
-    multiple: {
-      type: "boolean",
-      title: "Multiple",
-      description: "Whether to allow multiple selections",
-      default: false,
-    },
-    filter: {
-      type: "boolean",
-      title: "Filter",
-      description: "Whether to enable filtering",
-      default: false,
+      description: "Placeholder text for each language",
     },
   },
   additionalProperties: true,
   type: "object",
-  required: ["label", "options"],
-  title: "Listbox",
-  description: "https://formkit-primevue.netlify.app/inputs/Listbox",
+  required: ["label"],
+  title: "LocaleInput",
+  description:
+    '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 LocaleInputWritableSchema = {
+export const MailBatchClassifiedEventWritableSchema = {
   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: {
+    event_id: {
       type: "string",
-      const: "localeInput",
-      title: "Formkit",
-      description: "Locale input element.",
-      default: "localeInput",
+      title: "Event Id",
     },
-    name: {
-      anyOf: [
-        {
-          type: "string",
-        },
-        {
-          type: "null",
-        },
-      ],
-      title: "Name",
-      description: "Name of this field",
+    created_at: {
+      type: "integer",
+      title: "Created At",
+      description:
+        "The time (in ns since epoch) the event was stored in the event store",
     },
-    label: {
+    display_name: {
       anyOf: [
         {
           $ref: "#/components/schemas/LocaleString",
         },
         {
-          type: "string",
+          type: "null",
         },
       ],
-      title: "Label",
-      description: "Label of this field",
+      description: "Display name for the event",
     },
-    help: {
+    display_description: {
       anyOf: [
         {
           $ref: "#/components/schemas/LocaleString",
         },
-        {
-          type: "string",
-        },
         {
           type: "null",
         },
       ],
-      title: "Help",
-      description: "Help text of this field",
+      description: "Display description for the event",
     },
-    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",
+    source_folder: {
+      type: "string",
+      title: "Source Folder",
+      description: "Folder the classified messages were read from.",
     },
-    required: {
-      type: "boolean",
-      title: "Required",
-      description: "Whether this field is required",
-      default: false,
+    count: {
+      type: "integer",
+      title: "Count",
+      description: "Number of messages classified and filed in this run.",
     },
-    additional_validation_rules: {
-      anyOf: [
-        {
-          type: "string",
-        },
-        {
-          type: "null",
-        },
-      ],
-      title: "Additional Validation Rules",
-      description: "Validation expression",
+    per_category: {
+      additionalProperties: {
+        type: "integer",
+      },
+      type: "object",
+      title: "Per Category",
+      description:
+        "How many messages were filed under each configured category.",
     },
-    inputType: {
-      type: "string",
-      enum: ["text", "textarea"],
-      title: "Inputtype",
+    fallback_count: {
+      type: "integer",
+      title: "Fallback Count",
       description:
-        "Input type: 'text' for single-line, 'textarea' for multi-line",
-      default: "text",
+        "How many messages went to the fallback folder instead of a category.",
+      default: 0,
     },
-    rows: {
+    failed_count: {
       type: "integer",
-      title: "Rows",
-      description: "Number of rows for textarea mode (ignored for text mode)",
-      default: 3,
+      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,
     },
-    placeholder: {
-      anyOf: [
-        {
-          $ref: "#/components/schemas/LocaleString",
-        },
-        {
-          type: "string",
-        },
-        {
-          type: "null",
-        },
-      ],
-      title: "Placeholder",
-      description: "Placeholder text for each language",
+    classified: {
+      items: {
+        $ref: "#/components/schemas/MailClassificationRef",
+      },
+      type: "array",
+      title: "Classified",
+      description:
+        "Per-message classification verdicts and filing destinations.",
     },
   },
   additionalProperties: true,
   type: "object",
-  required: ["label"],
-  title: "LocaleInput",
+  required: ["source_folder", "count"],
+  title: "MailBatchClassifiedEvent",
   description:
-    '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```',
+    "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 = {
@@ -32467,6 +33486,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",
@@ -32673,6 +33708,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",
@@ -33860,7 +34902,7 @@ export const ProcessClassDTOWritableSchema = {
       description: "FormKit elements defining the configuration form.",
     },
     process_config_specs: {
-      $ref: "#/components/schemas/ProcessConfigSpecs",
+      $ref: "#/components/schemas/ConfigSpecs",
       description:
         "Configuration specifications of the process class, including schema and parameters.",
     },
@@ -34127,8 +35169,16 @@ export const RAGStartEventWritableSchema = {
       default: "de",
     },
     user: {
-      $ref: "#/components/schemas/UserIdentity",
-      description: "User on whose behalf the RAG run is executed.",
+      anyOf: [
+        {
+          $ref: "#/components/schemas/UserIdentity",
+        },
+        {
+          type: "null",
+        },
+      ],
+      description:
+        "User on whose behalf the RAG run is executed, when there is one. Optional because a delegating agent forwards whatever identity its own start event carries, and a scheduled run carries none — there is no service account to substitute. The RAG agent's user-memory steps are what read it, and they are skipped without it rather than attributing one caller's memories to a shared identity.",
     },
     messages: {
       items: {
@@ -34192,7 +35242,7 @@ export const RAGStartEventWritableSchema = {
   },
   additionalProperties: true,
   type: "object",
-  required: ["user", "selected_namespaces"],
+  required: ["selected_namespaces"],
   title: "RAGStartEvent",
   description:
     "Namespace-aware start event for the RAG agent.\n\n`RAGStartEvent` is intended for non-chat publishers: custom domain front-ends that run their own namespace\nselection UI, or other agents delegating to RAG via `AgentInTheLoop`.",
@@ -35249,323 +36299,254 @@ export const RetrieverEventWritableSchema = {
       ],
       description: "Display description for the event",
     },
-    nodes: {
-      anyOf: [
-        {
-          items: {
-            $ref: "#/components/schemas/IngestedNode",
-          },
-          type: "array",
-        },
-        {
-          type: "null",
-        },
-      ],
-      title: "Nodes",
-      description:
-        "List of nodes retrieved by the retriever, including document IDs, scores, and content.",
-    },
-  },
-  additionalProperties: true,
-  type: "object",
-  title: "RetrieverEvent",
-} as const;
-
-export const RouteOptionsWritableSchema = {
-  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",
-    },
-    name: {
-      type: "string",
-      title: "Name",
-      description: "For UI purpose only",
-    },
-    description: {
-      type: "string",
-      title: "Description",
-      description: "For UI purpose only",
-    },
-    instructions: {
-      type: "string",
-      title: "Instructions",
-      description: "Instructions for LLM when to route here",
-    },
-    event: {
-      $ref: "#/components/schemas/ControlEventWritable",
-      description: "Possible event to route to",
-    },
-  },
-  additionalProperties: true,
-  type: "object",
-  required: ["name", "description", "instructions", "event"],
-  title: "RouteOptions",
-} as const;
-
-export const RouterEventWritableSchema = {
-  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",
-    },
-    routes: {
-      items: {
-        $ref: "#/components/schemas/RouteOptionsWritable",
-      },
-      type: "array",
-      title: "Routes",
-      description: "List of options",
-    },
-    selected_option: {
-      $ref: "#/components/schemas/RouteOptionsWritable",
-      description: "Selected option",
-    },
-    reason: {
-      type: "string",
-      title: "Reason",
-      description: "Reason for the decision",
-    },
-  },
-  additionalProperties: true,
-  type: "object",
-  required: ["routes", "selected_option", "reason"],
-  title: "RouterEvent",
-  description:
-    "A RouterEvent marks a point where an LLM decided which way to go in the workflow.",
-} as const;
-
-export const RunStatisticsWritableSchema = {
-  properties: {
-    n_events: {
-      type: "integer",
-      title: "N Events",
-      description: "Total number of events",
-      default: 0,
-    },
-    has_errors: {
-      type: "boolean",
-      title: "Has Errors",
-      description: "Has error events",
-      default: false,
-    },
-    has_pending: {
-      type: "boolean",
-      title: "Has Pending",
-      description: "Has pending events (more start than stop/exception events)",
-      default: false,
-    },
-    is_hitl: {
-      type: "boolean",
-      title: "Is Hitl",
-      description: "Has HITL events",
-      default: false,
-    },
-    open_hitl: {
-      type: "boolean",
-      title: "Open Hitl",
-      description: "Has open HITL requests",
-      default: false,
-    },
-    is_bitl: {
-      type: "boolean",
-      title: "Is Bitl",
-      description: "Has BITL events",
-      default: false,
-    },
-    open_bitl: {
-      type: "boolean",
-      title: "Open Bitl",
-      description: "Has open BITL requests",
-      default: false,
-    },
-    is_aitl: {
-      type: "boolean",
-      title: "Is Aitl",
-      description: "Has AITL events",
-      default: false,
-    },
-    open_aitl: {
-      type: "boolean",
-      title: "Open Aitl",
-      description: "Has open AITL requests",
-      default: false,
-    },
-    started_at: {
-      anyOf: [
-        {
-          type: "string",
-        },
-        {
-          type: "null",
-        },
-      ],
-      title: "Started At",
-      description: "Start time (ISO format string)",
-    },
-    ended_at: {
-      anyOf: [
-        {
-          type: "string",
-        },
-        {
-          type: "null",
-        },
-      ],
-      title: "Ended At",
-      description: "End time (ISO format string)",
-    },
-    duration: {
-      anyOf: [
-        {
-          type: "number",
-        },
-        {
-          type: "null",
-        },
-      ],
-      title: "Duration",
-      description: "Duration in seconds",
-    },
-    run_id: {
-      type: "string",
-      title: "Run Id",
-      description: "The run ID",
-    },
-    agent: {
-      $ref: "#/components/schemas/MinimalAgentInstanceDTOWritable",
-      description: "The agent that ran the run",
-    },
-  },
-  type: "object",
-  required: ["run_id", "agent"],
-  title: "RunStatistics",
-  description: "Statistics for a single run, intended for API response.",
-} as const;
-
-export const ScheduledStartEventWritableSchema = {
-  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: {
+    nodes: {
+      anyOf: [
+        {
+          items: {
+            $ref: "#/components/schemas/IngestedNode",
+          },
+          type: "array",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Nodes",
+      description:
+        "List of nodes retrieved by the retriever, including document IDs, scores, and content.",
+    },
+  },
+  additionalProperties: true,
+  type: "object",
+  title: "RetrieverEvent",
+} as const;
+
+export const RouteOptionsWritableSchema = {
+  properties: {
+    event_id: {
       type: "string",
-      title: "Locale",
+      title: "Event Id",
+    },
+    created_at: {
+      type: "integer",
+      title: "Created At",
       description:
-        "The locale the scheduled run reports its display output in.",
-      default: "de",
+        "The time (in ns since epoch) the event was stored in the event store",
     },
-    user: {
+    display_name: {
       anyOf: [
         {
-          $ref: "#/components/schemas/UserIdentity",
+          $ref: "#/components/schemas/LocaleString",
         },
         {
           type: "null",
         },
       ],
-      description:
-        "Always None — scheduled runs are system-initiated and carry no execution identity.",
+      description: "Display name for the event",
     },
-    scheduled_for: {
+    display_description: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/LocaleString",
+        },
+        {
+          type: "null",
+        },
+      ],
+      description: "Display description for the event",
+    },
+    name: {
       type: "string",
-      format: "date-time",
-      title: "Scheduled For",
+      title: "Name",
+      description: "For UI purpose only",
+    },
+    description: {
+      type: "string",
+      title: "Description",
+      description: "For UI purpose only",
+    },
+    instructions: {
+      type: "string",
+      title: "Instructions",
+      description: "Instructions for LLM when to route here",
+    },
+    event: {
+      $ref: "#/components/schemas/ControlEventWritable",
+      description: "Possible event to route to",
+    },
+  },
+  additionalProperties: true,
+  type: "object",
+  required: ["name", "description", "instructions", "event"],
+  title: "RouteOptions",
+} as const;
+
+export const RouterEventWritableSchema = {
+  properties: {
+    event_id: {
+      type: "string",
+      title: "Event Id",
+    },
+    created_at: {
+      type: "integer",
+      title: "Created At",
       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.",
+        "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",
+    },
+    routes: {
+      items: {
+        $ref: "#/components/schemas/RouteOptionsWritable",
+      },
+      type: "array",
+      title: "Routes",
+      description: "List of options",
+    },
+    selected_option: {
+      $ref: "#/components/schemas/RouteOptionsWritable",
+      description: "Selected option",
+    },
+    reason: {
+      type: "string",
+      title: "Reason",
+      description: "Reason for the decision",
     },
   },
   additionalProperties: true,
   type: "object",
-  required: ["scheduled_for"],
-  title: "ScheduledStartEvent",
+  required: ["routes", "selected_option", "reason"],
+  title: "RouterEvent",
   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.",
+    "A RouterEvent marks a point where an LLM decided which way to go in the workflow.",
+} as const;
+
+export const RunStatisticsWritableSchema = {
+  properties: {
+    n_events: {
+      type: "integer",
+      title: "N Events",
+      description: "Total number of events",
+      default: 0,
+    },
+    has_errors: {
+      type: "boolean",
+      title: "Has Errors",
+      description: "Has error events",
+      default: false,
+    },
+    has_pending: {
+      type: "boolean",
+      title: "Has Pending",
+      description: "Has pending events (more start than stop/exception events)",
+      default: false,
+    },
+    is_hitl: {
+      type: "boolean",
+      title: "Is Hitl",
+      description: "Has HITL events",
+      default: false,
+    },
+    open_hitl: {
+      type: "boolean",
+      title: "Open Hitl",
+      description: "Has open HITL requests",
+      default: false,
+    },
+    is_bitl: {
+      type: "boolean",
+      title: "Is Bitl",
+      description: "Has BITL events",
+      default: false,
+    },
+    open_bitl: {
+      type: "boolean",
+      title: "Open Bitl",
+      description: "Has open BITL requests",
+      default: false,
+    },
+    is_aitl: {
+      type: "boolean",
+      title: "Is Aitl",
+      description: "Has AITL events",
+      default: false,
+    },
+    open_aitl: {
+      type: "boolean",
+      title: "Open Aitl",
+      description: "Has open AITL requests",
+      default: false,
+    },
+    started_at: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Started At",
+      description: "Start time (ISO format string)",
+    },
+    ended_at: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Ended At",
+      description: "End time (ISO format string)",
+    },
+    duration: {
+      anyOf: [
+        {
+          type: "number",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Duration",
+      description: "Duration in seconds",
+    },
+    run_id: {
+      type: "string",
+      title: "Run Id",
+      description: "The run ID",
+    },
+    agent: {
+      $ref: "#/components/schemas/MinimalAgentInstanceDTOWritable",
+      description: "The agent that ran the run",
+    },
+  },
+  type: "object",
+  required: ["run_id", "agent"],
+  title: "RunStatistics",
+  description: "Statistics for a single run, intended for API response.",
 } as const;
 
 export const SelectWritableSchema = {
@@ -36526,7 +37507,7 @@ export const StandaloneQuestionCondenserEventWritableSchema = {
   required: ["condensed_chat_message"],
   title: "StandaloneQuestionCondenserEvent",
   description:
-    "Event to condense chat messages into a single standalone question as a chat message.",
+    "Event to condense chat messages into a single standalone question as a chat message.\n\nA blank condensation is refused by `condense_standalone_question`, before an event of this type can be\nbuilt. The invariant is deliberately *not* also a `field_validator` here: a validator on an event is not\nonly a publish-time contract, it runs on every `model_validate`, which is how the immutable log is read\nback — JetStream replays the whole stream on each agent start, and the API rebuilds a thread's timeline\nfrom the persisted display copy. Blank condensations did occur before the producer-side raise existed, so\nvalidating on read makes that history undeserializable: replay drops the event and\n`EventService.get_events_in_thread` fails the whole thread.",
 } as const;
 
 export const StartEventWritableSchema = {
@@ -36687,6 +37668,19 @@ export const StoreOrganizationMemoryEventWritableSchema = {
       title: "Deleted Relations",
       description: "Deleted relations",
     },
+    llm_model_name: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Llm Model Name",
+      description:
+        "Model that extracted these memories (issue #1590), or None when the write stored verbatim text. Carried on this event only, for observability — it is not stored in mem0's metadata, so it cannot be recovered from the memory record itself once this event is gone.",
+    },
   },
   additionalProperties: true,
   type: "object",
@@ -36776,6 +37770,19 @@ export const StoreUserMemoryEventWritableSchema = {
       title: "Deleted Relations",
       description: "Deleted relations",
     },
+    llm_model_name: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Llm Model Name",
+      description:
+        "Model that extracted these memories (issue #1590), or None when the write stored verbatim text. Carried on this event only, for observability — it is not stored in mem0's metadata, so it cannot be recovered from the memory record itself once this event is gone.",
+    },
   },
   additionalProperties: true,
   type: "object",
@@ -38346,5 +39353,5 @@ export const VectorStoreInputWritableSchema = {
   required: ["label"],
   title: "VectorStoreInput",
   description:
-    'A FormKit element for selecting a vector store collection, namespaces, and\nthe metadata keys publishers are allowed to filter on at query time.\n\nThis element renders as three controls:\n1. Database dropdown (loads from /api/v1/knowledge/databases)\n2. Namespace multi-select (populated based on selected database)\n3. Free-form chips input for `allowed_metadata_filter_fields`\n\nThe output matches the three configurable fields of `MilvusVectorStoreConfig`:\n{\n    "collection_name": str,\n    "index_namespaces": list[str],\n    "allowed_metadata_filter_fields": list[str],\n}\n\n### Form Duality\nWhen used with MilvusVectorStoreConfig, the form submission is validated\ndirectly into MilvusVectorStoreConfig (connection settings are read from\nMilvusSettings at runtime).\n\n### Example Usage\n```python\nfrom swiss_ai_hub.core.form.elements.vector_store_input import VectorStoreInput\nfrom swiss_ai_hub.core.persistence.rag.vectors.stores.milvus_vector_store_config import MilvusVectorStoreConfig\n\nclass MyRetrieverConfig(Form):\n    vector_store: Annotated[\n        MilvusVectorStoreConfig | VectorStoreInput,\n        Field(description="The vector store configuration"),\n    ]\n\n# Form mode - for rendering:\nconfig = MyRetrieverConfig(\n    vector_store=VectorStoreInput(\n        label=LocaleString(en="Vector Store", de="Vektorspeicher"),\n    ),\n)\n\n# Data mode - from submission (Pydantic validates into MilvusVectorStoreConfig):\nconfig = MyRetrieverConfig(\n    vector_store=MilvusVectorStoreConfig(\n        collection_name="my-database",\n        index_namespaces=["namespace1", "namespace2"],\n        allowed_metadata_filter_fields=["department", "year"],\n    ),\n)\n```',
+    'A FormKit element for selecting a vector store collection, namespaces, and\nthe metadata keys publishers are allowed to filter on at query time.\n\nThis element renders as three controls:\n1. Database dropdown (loads from /api/v1/knowledge/databases)\n2. "All namespaces" switch, or a namespace multi-select populated from the selected database\n3. Free-form chips input for `allowed_metadata_filter_fields`\n\nThe output matches the configurable fields of `MilvusVectorStoreConfig`:\n{\n    "collection_name": str,\n    "index_namespaces": list[str],\n    "all_namespaces": bool,\n    "allowed_metadata_filter_fields": list[str],\n}\n\n### Form Duality\nWhen used with MilvusVectorStoreConfig, the form submission is validated\ndirectly into MilvusVectorStoreConfig (connection settings are read from\nMilvusSettings at runtime).\n\n### Example Usage\n```python\nfrom swiss_ai_hub.core.form.elements.vector_store_input import VectorStoreInput\nfrom swiss_ai_hub.core.persistence.rag.vectors.stores.milvus_vector_store_config import MilvusVectorStoreConfig\n\nclass MyRetrieverConfig(Form):\n    vector_store: Annotated[\n        MilvusVectorStoreConfig | VectorStoreInput,\n        Field(description="The vector store configuration"),\n    ]\n\n# Form mode - for rendering:\nconfig = MyRetrieverConfig(\n    vector_store=VectorStoreInput(\n        label=LocaleString(en="Vector Store", de="Vektorspeicher"),\n    ),\n)\n\n# Data mode - from submission (Pydantic validates into MilvusVectorStoreConfig):\nconfig = MyRetrieverConfig(\n    vector_store=MilvusVectorStoreConfig(\n        collection_name="my-database",\n        index_namespaces=["namespace1", "namespace2"],\n        allowed_metadata_filter_fields=["department", "year"],\n    ),\n)\n```',
 } as const;