@wildo-ai/saas-models 1.1.2 → 1.1.4

package/dist/esm/flows-actors/flows-actors-execution.shared.schemas.js

@@ -72,8 +72,18 @@ export var FlowsActors_MessageContentType;
 export const FlowActorExecution_MessageSchema = z.object({
     /** Stable per-message id (client-correlatable across stream deltas). */
     id: z.uuid(),
-    role: z.enum(FlowsActors_ConversationRole),
-    contentType: z.enum(FlowsActors_MessageContentType).default(FlowsActors_MessageContentType.TEXT),
+    role: z.enum(FlowsActors_ConversationRole)
+        .describe('Who produced this message.\n\nValues:\n'
+        + '- `user`: the person, or the client acting for them.\n'
+        + '- `assistant`: the agent.\n'
+        + '- `system`: instructions the agent was given, not part of the conversation a person sees.\n'
+        + '- `tool`: the result of something the agent called.'),
+    contentType: z.enum(FlowsActors_MessageContentType).default(FlowsActors_MessageContentType.TEXT)
+        .describe('How to render `content`.\n\nValues:\n'
+        + '- `text`: plain text.\n'
+        + '- `markdown`: text with Markdown formatting.\n'
+        + '- `progress`: an interim note about work in flight; `data` carries the detail.\n'
+        + '- `data`: a structured payload rather than prose; read `data`, not `content`.'),
     /** Rendered text content (may be assembled from streamed deltas). */
     content: z.string(),
     /** Structured payload for `DATA`/`PROGRESS` messages (tool results, progress). */
@@ -117,9 +127,36 @@ export const FlowActorExecution_PausedApprovalSchema = z.object({
     pendingToolArgs: z.record(z.string(), z.unknown()).optional(),
     /** ISO timestamp when the approval was requested. */
     requestedAt: z.string(),
-    /** Optional ISO expiry after which the paused turn is auto-failed. */
+    /**
+     * ISO instant after which the paused turn must not be resumed.
+     *
+     * SET ON EVERY SUSPENSION since 2026-09-08 (#465). It was declared here, carried on the
+     * approval-request WebSocket payload and read and converted by the browser, and NO WRITER EVER SET
+     * IT — so a pending approval never expired and the field described a timeout that did not exist.
+     *
+     * The terminal state on expiry is `FlowsActors_Status.FAILED`, which the status vocabulary already
+     * named ("resolves to PROCESSING→COMPLETED on approval, or a terminal state on denial/expiry").
+     * Nothing new was invented for it.
+     *
+     * Still optional: a suspension persisted before that date carries none, and an absent expiry means
+     * the pause does not lapse — which is what those turns were paused under.
+     */
     expiresAt: z.string().optional(),
 });
+/**
+ * How long a human has to answer an approval-gated tool call before the turn is refused.
+ *
+ * **24 hours.** An agent pausing for a person should span a working day plus a night, so a request
+ * raised late in the afternoon is still answerable the next morning. Much beyond that and the
+ * decision stops being meaningful rather than merely late: the person is approving a tool call made
+ * against a conversation, a world and an intent that have all moved on, and "do you approve this?"
+ * with no memory of the question is a prompt people click through.
+ *
+ * A framework default rather than an operator knob, for now. If an application ever needs its own,
+ * the knob goes beside the consent lifetime in the auth config — but nobody has asked, and a
+ * timeout that every application authors identically is a default wearing a config field.
+ */
+export const FLOW_ACTOR_APPROVAL_DEFAULT_TIMEOUT_MS = 24 * 60 * 60 * 1000;
 /** Serialize paused-approval state for the scalar `pausedApproval` string column. */
 export function serializeFlowActorPausedApproval(state) {
     return JSON.stringify(state);

package/dist/esm/flows-actors/flows-actors-execution.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"flows-actors-execution.shared.schemas.js","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors-execution.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Flows-Actors Execution — Persisted Resource Schema (POLYMORPHIC)\n * ================================================================\n *\n * A persisted record of a single flow/actor **system execution** — in v1 the\n * durable source of truth for a conversational chat log (`messages[]`) plus the\n * execution's lifecycle status.\n *\n * POLYMORPHIC ACROSS OWNER SCOPE. The SAME base envelope is stamped out as THREE\n * genuine single-scope resources by `declarePolymorphicSchemas()`, one owner FK\n * injected per variant:\n *   - `userFlowActorExecutions`         (USER_SELF     — `userId`)         ← WS chat + user-delegated A2A\n *   - `organizationFlowActorExecutions` (ORGANIZATIONS — `organizationId`) ← org-machine A2A\n *   - `applicationFlowActorExecutions`  (APPLICATION   — `applicationId`)  ← app-machine A2A\n *\n * A conversation is owned by EXACTLY ONE scope (its injected owner FK). There is\n * no cross-scope audit dimension on the base — ownership IS the scope. This is the\n * honest \"one concept, N owners\" model (mirrors billing accounts / subscriptions)\n * and needs ZERO core-authorizer change: each variant satisfies its own scope\n * authorizer, and `polymorphicRole` resolves the operation roles per scope. A\n * machine (API key / OIDC client) reaches its org/app variant exactly as it\n * reaches any other org/app resource — standard RBAC via its granted roles.\n *\n * KIND-AGNOSTIC BY DESIGN. A `FlowActorSystem_Kind` discriminant lets the SAME\n * resource persist both flow and actor executions. v1 implements the ACTOR\n * conversational path; the FLOW path drops in without reshaping the base envelope.\n *\n * @see flows-actors.system.shared.schemas.ts — the base execution envelope\n * @see billing-account.shared.schemas.ts — the polymorphic-scope precedent\n * @see requests/websocket.shared.schemas.ts — the streamed message payload this\n *   log mirrors (`WS_FlowsActorsMessagePayloadSchema`)\n */\n\nimport { z } from 'zod';\nimport { initZodDecorators, addImpersonalizeWith } from '@wildo-ai/zod-decorators';\n\nimport { FLOWS_ACTORS_DEFAULT_AGENT_INSTANCE, FLOWS_ACTORS_NO_MACHINE_CREDENTIAL, FlowsActors_Status } from './flows-actors.commons.shared.schemas';\nimport { DataPortabilityProvenance } from '../compliance/privacy/subject-export.shared.schemas';\nimport { PersonalDataCategory } from '../compliance/privacy/personal-data-category.shared.schemas';\nimport { FlowActorSystem_Kind } from './flows-actors.system.shared.schemas';\nimport { RedactionType } from '../compliance/privacy/redaction.shared.schemas';\nimport {\n  CoreResourceType,\n  coreResourceShared_FieldIdentifier,\n} from '../resources/resources.shared.core.definitions';\nimport {\n  declarePolymorphicSchemas,\n  optOutPolymorphicAutoBusinessKey,\n  type PolymorphicVariantDefinition,\n} from '../resources/utils/resource-polymorphism.schemas';\n\ninitZodDecorators(z);\n\n//===============================================================\n//  Conversational message log\n//===============================================================\n\n/**\n * Author of a persisted conversational message. `TOOL` records a tool-call /\n * tool-result turn (grounding retrieval); `SYSTEM` records a system/status note.\n * WS-streamed messages are always server→client, so the transport shape carries\n * no role — the persisted log adds it to reconstruct a full transcript.\n */\nexport enum FlowsActors_ConversationRole {\n  USER = 'user',\n  ASSISTANT = 'assistant',\n  SYSTEM = 'system',\n  TOOL = 'tool',\n}\n\n/**\n * Rendering hint for a message body. Mirrors the streamed\n * `WS_FlowsActorsMessagePayloadSchema.messageType` literal union exactly\n * (`text | markdown | progress | data`) as an enum so the persisted log and the\n * live stream share one vocabulary (framework rule: enums over literal unions).\n */\nexport enum FlowsActors_MessageContentType {\n  TEXT = 'text',\n  MARKDOWN = 'markdown',\n  PROGRESS = 'progress',\n  DATA = 'data',\n}\n\nexport const FlowActorExecution_MessageSchema = z.object({\n  /** Stable per-message id (client-correlatable across stream deltas). */\n  id: z.uuid(),\n  role: z.enum(FlowsActors_ConversationRole),\n  contentType: z.enum(FlowsActors_MessageContentType).default(FlowsActors_MessageContentType.TEXT),\n  /** Rendered text content (may be assembled from streamed deltas). */\n  content: z.string(),\n  /** Structured payload for `DATA`/`PROGRESS` messages (tool results, progress). */\n  data: z.record(z.string(), z.unknown()).optional(),\n  createdAt: z.date().default(() => new Date()),\n});\nexport type FlowActorExecution_Message = z.infer<typeof FlowActorExecution_MessageSchema>;\n\n/**\n * The SUSPENDED-TURN state persisted when an agent turn pauses at a human-in-the-loop\n * approval boundary (execution `status` = `AWAITING_APPROVAL`). It is stored SERIALIZED as a\n * JSON string in the `pausedApproval` scalar field — NOT as a nested Zod object — because heavy\n * nested sub-structures do not round-trip through the Zod→Mongoose embedded-subdocument\n * conversion (see the per-kind state note below). Parse/serialize ONLY via the helpers below at\n * the persistence boundary; the record column itself stays a plain string.\n */\nexport const FlowActorExecution_PausedApprovalSchema = z.object({\n  /**\n   * Correlates the emitted approval REQUEST with the inbound decision (idempotency key).\n   *\n   * An OPAQUE identifier minted by the model SDK — NOT a Wildo id and NOT a UUID. It was typed\n   * `z.uuid()` on the reasonable-looking assumption that an id is a uuid, and the SDK produces\n   * values like `aitxt-3Xfhq68r7GTRXEuV1YzU4eEc`.\n   *\n   * That single wrong assumption made EVERY paused turn unresumable, and hid completely: serializing\n   * is `JSON.stringify` and does not validate, so the pause persisted perfectly; only the resume's\n   * `parse` rejected it, as a CORRUPTED blob. The turn then stayed paused forever with a\n   * \"state is unreadable\" error naming the wrong cause. Unit fixtures used a real uuid, so they were\n   * more conformant than production and could never reproduce it — the live lane found it.\n   *\n   * Validate it as an opaque non-empty string. We do not own the format and must not assert one.\n   */\n  approvalId: z.string().min(1),\n  /**\n   * The AI-SDK model-message array to RESUME from — opaque to us (the SDK's own resume\n   * contract). Captured when the approval-gated tool call suspended the stream; on the human\n   * decision the runtime appends a tool-approval-response and re-invokes with these messages.\n   */\n  sdkModelMessages: z.array(z.record(z.string(), z.unknown())),\n  /** The approval-gated tool the model wants to call (drives the human-facing prompt). */\n  pendingToolName: z.string(),\n  /** The pending tool call's arguments (drives the human-facing action description). */\n  pendingToolArgs: z.record(z.string(), z.unknown()).optional(),\n  /** ISO timestamp when the approval was requested. */\n  requestedAt: z.string(),\n  /** Optional ISO expiry after which the paused turn is auto-failed. */\n  expiresAt: z.string().optional(),\n});\nexport type FlowActorExecution_PausedApproval = z.infer<typeof FlowActorExecution_PausedApprovalSchema>;\n\n/** Serialize paused-approval state for the scalar `pausedApproval` string column. */\nexport function serializeFlowActorPausedApproval(state: FlowActorExecution_PausedApproval): string {\n  return JSON.stringify(state);\n}\n\n/**\n * Parse the scalar `pausedApproval` string column back to typed state. Throws (ZodError /\n * SyntaxError) on a malformed blob — a corrupted paused record must fail loudly at resume,\n * never silently resume from garbage.\n */\nexport function parseFlowActorPausedApproval(raw: string): FlowActorExecution_PausedApproval {\n  return FlowActorExecution_PausedApprovalSchema.parse(JSON.parse(raw));\n}\n\n//===============================================================\n//  Per-kind execution state (reused from the shared execution types)\n//===============================================================\n\n// NOTE (v1 scope): the persisted record is the CONVERSATIONAL envelope only —\n// `kind` + `status`/`statusChanges` + the `messages[]` chat log. The richer\n// per-kind graph-state slots (`flowState` node-states / `actorState` plan+tasks,\n// sliced from `FlowSystem_Execution` / `ActorSystem_Execution`) are intentionally\n// NOT persisted yet: the v1 conversational runtime never writes them, and those\n// heavy nested sub-structures (required `plan`/`walkthrough`/`standaloneTasks`\n// with embedded `_id`s) do not round-trip through the Zod→Mongoose embedded-\n// subdocument conversion as optional slots (empty subdocs get instantiated and\n// fail required-path validation). When the flow/actor orchestration runtime\n// actually produces graph state, add typed `flowState`/`actorState` back WITH the\n// embedded-subdocument treatment (see the zod↔mongoose nested-union / embedded-id\n// notes) rather than a raw `.pick()`. `kind` already preserves discrimination.\n\n//===============================================================\n//  Base execution record — NO owner scope FK (injected per variant)\n//===============================================================\n\n/**\n * The conversation envelope shared by every scope variant. It carries NO owner\n * scope FK: `declarePolymorphicSchemas()` injects exactly ONE (`userId` /\n * `organizationId` / `applicationId`) per variant. Do NOT add an `initiator`\n * snapshot here — a nested `initiator.userId`/`.organizationId` collides with the\n * contextual scope filter (it matches the field identifier at every schema path\n * and injects an exact-subdocument clause that never equals the stored snapshot,\n * so every scoped read/update silently matches zero rows). Ownership lives ONLY on\n * the single injected top-level owner FK.\n */\nexport const FlowActorExecutionBaseSchema = z.object({\n  /** MongoDB document id — auto-generated / auto-managed (excluded from create). */\n  _id: z.string().min(1).isPrimaryKey(),\n\n  /**\n   * Stable business id of the execution, generated by the conversational runtime\n   * and echoed over the WebSocket channel (`WS_FlowsActors*.executionId`). Unique\n   * per variant collection (a UUID — no cross-collection collision). Immutable\n   * once created.\n   */\n  executionId: z.uuid().isUnique({ scope: 'global', sparse: false }).excludeFromUpdate().isSummaryField(),\n\n  // === System identity (set on create, immutable) ===\n  /** Ref of the executed flow/actor system (`FlowActorSystem.ref`). */\n  systemRef: z.string().isDBIndexed().excludeFromUpdate().isSummaryField(),\n  /** Discriminant selecting which state slot is populated. */\n  kind: z.enum(FlowActorSystem_Kind).isDBIndexed().excludeFromUpdate().isSummaryField(),\n\n  // === Runtime status ===\n  /**\n   * WHICH agent this conversation was opened through — part of the read filter, not metadata.\n   *\n   * The task family carried this from gate #3; executions did not, so a caller holding a\n   * `contextId` could continue that thread through a DIFFERENT declared agent and load the prior\n   * transcript into the other agent's context. A2A agents are declared as separate resource servers\n   * with per-instance token audiences, and the plane at risk here holds the full message log — not\n   * a 120-character title (review finding G5-8).\n   *\n   * The WebSocket surface has no agent, and the default A2A agent is an identity of its own; both\n   * store {@link FLOWS_ACTORS_DEFAULT_AGENT_INSTANCE}.\n   */\n  resourceServerInstanceRef: z.string().min(1).isDBIndexed(),\n\n  /**\n   * WHICH machine credential opened this conversation — part of the read filter, not metadata.\n   *\n   * Identical axis and identical reasoning to the task family: the injected scope FK does not\n   * identify the principal on the machine variants (`applicationId` is a deployment singleton;\n   * `organizationId` is shared by every machine client of one tenant), so without it a\n   * separately-credentialed client could read and continue another client's conversation — which\n   * carries the full message log, not merely a title.\n   *\n   * User-delegated turns store {@link FLOWS_ACTORS_NO_MACHINE_CREDENTIAL}: the human is the\n   * principal there and the `userId` owner FK already discriminates.\n   */\n  machineCredentialId: z.string().min(1).isDBIndexed(),\n\n  status: z.enum(FlowsActors_Status).isDBIndexed().isSummaryField(),\n  statusChanges: z.array(z.object({\n    status: z.enum(FlowsActors_Status),\n    timestamp: z.date(),\n  })).default([]),\n\n  // === Conversational log (chat history) ===\n  /**\n   * The conversation transcript.\n   *\n   * ## Provenance: SUBJECT_PROVIDED, and the asymmetry is the reason (review finding F5-6)\n   *\n   * This array MIXES subject-authored turns (`role: USER`) with model-generated ones\n   * (`role: ASSISTANT`), and provenance is declared per FIELD — there is no per-element mechanism,\n   * so one classification must cover both. The two ways of being wrong are not equally bad:\n   *\n   *   • Classifying DERIVED would EXCLUDE the subject's own words from an Art. 20 bundle. That is a\n   *     failure of the right the article exists to serve.\n   *   • Classifying SUBJECT_PROVIDED includes the assistant's replies alongside them. That is\n   *     over-delivery — but of a transcript the subject was a party to and already saw, which is the\n   *     natural unit a person means by \"my conversation\".\n   *\n   * So the classification follows the ASYMMETRY, not a per-element truth we cannot express. Revisit\n   * only if per-element provenance ever exists; splitting the array by role at export time was\n   * considered and rejected as inventing a second mechanism for one field.\n   *\n   * ⚠️ **This is a LABELLING change, not a behaviour change**, and the first version of this note\n   * failed to say so. `resolvePortabilityFieldScope` maps `SUBJECT_PROVIDED` *and* `OBSERVED` to\n   * `INCLUDED`, and the resource default was already `OBSERVED` — so `messages` was in the Art. 20\n   * bundle before and after. Nothing about an export changes.\n   *\n   * The rejected alternative the first version omitted is the one that was actually in force:\n   * **`OBSERVED`** — \"data generated by the subject's USE of the service\", a defensible reading of a\n   * mixed transcript. It is rejected for precision rather than effect: the USER turns are authored\n   * BY the subject, not merely observed of them, and a classification should say the truest thing\n   * available even when two values resolve alike today.\n   *\n   * The task family's `output`/`artifacts` are DERIVED by contrast, and that is not an\n   * inconsistency: those are model output ABOUT the work, with no subject-authored content mixed in.\n   */\n  // RESET on erasure — returns this field to its schema default. It holds the conversation itself,\n  // which the category above correctly declares as personal data. RESET rather than REMOVE or MASK\n  // because the field is non-nullable WITH a `.default()`: REMOVE needs a clearable field and MASK\n  // needs a string. The value comes from the schema, so there is no second copy to drift.\n  messages: addImpersonalizeWith(\n  FlowActorExecution_MessageSchema.array().default([])\n      .portabilityProvenance(DataPortabilityProvenance.SUBJECT_PROVIDED)\n      // The conversation itself. Category as well as provenance, so a notice can enumerate it: the two\n      // axes answer different questions and a provenance alone leaves the field an OUTSTANDING gap.\n      .dataCategories(PersonalDataCategory.USER_CONTENT),\n    RedactionType.RESET,\n  ),\n\n  // === HITL (human-in-the-loop) suspension ===\n  /**\n   * Serialized {@link FlowActorExecution_PausedApproval} — present ONLY while `status` is\n   * `AWAITING_APPROVAL`. A scalar JSON string (see that schema's doc for why it is NOT a nested\n   * object: the Zod→Mongoose round-trip). Set on pause, cleared on resume / terminal completion;\n   * never authored on create.\n   */\n  /**\n   * Serialized suspended-turn state; `null` once a decision releases the pause.\n   *\n   * `.nullish()`, not `.optional()`, and the difference is load-bearing at the READ. Clearing writes\n   * an explicit `null`; the write then re-parses the row to project its response, and under\n   * `.optional()` that projection throws `expected string, received null`. The clear PERSISTS (there\n   * is no transaction to roll back) and the operation still fails — so the pause was released and\n   * the resume aborted, leaving the turn `failed` with its work never done, reported as a resource\n   * transformation error that names nothing about approvals.\n   *\n   * The input contract needing `.nullish()` (see `FlowActorExecutionUpdateInternalSchema`) is a\n   * SEPARATE surface from this one. Fixing only that gets the value written and still throws on the\n   * way out — both must admit null or neither does.\n   */\n  // This blob contains SDK resume messages and pending tool arguments. It is\n  // runtime continuation state, not conversation content: generic client reads,\n  // summaries and generated API schemas must never disclose it.\n  pausedApproval: z.string().nullish().excludeFromCreate().isBackendOnly(),\n\n  // === Timing (system-managed; defaults are load-bearing — the create pipeline\n  //     strips these then date-coerces, so a missing default → Invalid Date) ===\n  createdAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),\n  updatedAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate().isSummaryField(),\n  /** Set on terminal completion (via UPDATE); never on create. */\n  finishedAt: z.date().optional().excludeFromCreate().isSummaryField(),\n});\nexport type FlowActorExecutionBase = z.infer<typeof FlowActorExecutionBaseSchema>;\n\n//===============================================================\n//  Polymorphic declaration — one owner-scope variant per scope\n//===============================================================\n\n/**\n * The three owner-scope variants a flows-actors execution is stamped out for.\n * Each is `isPrimaryScope: true` (the injected owner FK is the primary scope), and\n * each opts OUT of the singleton auto-business-key: a conversation is MULTI-ROW\n * per scope (many discussions per user/org/app), so the injected owner FK must NOT\n * be marked `.isUnique()` — otherwise the second conversation per scope would fail\n * with a duplicate-key error. Mirrors subscriptions / usage-records / SSO\n * connections (all multi-row polymorphic resources).\n */\nexport const FLOW_ACTOR_EXECUTION_SCOPE_VARIANTS: PolymorphicVariantDefinition[] = [\n  { parentResourceType: CoreResourceType.USERS,         parentFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.USERS],         isPrimaryScope: true },\n  { parentResourceType: CoreResourceType.ORGANIZATIONS, parentFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.ORGANIZATIONS], isPrimaryScope: true },\n  { parentResourceType: CoreResourceType.APPLICATION,   parentFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.APPLICATION],   isPrimaryScope: true },\n].map(optOutPolymorphicAutoBusinessKey);\n\n/**\n * Polymorphic declaration for flows-actors executions. Produces 3 variants:\n *   - users        → `userFlowActorExecutions`         (`userId` injected)\n *   - organizations→ `organizationFlowActorExecutions` (`organizationId` injected)\n *   - applications → `applicationFlowActorExecutions`   (`applicationId` injected)\n */\nexport const flowActorExecutionsPolymorphicDeclaration = declarePolymorphicSchemas({\n  baseResourceType: 'flowActorExecutions',\n  baseFieldIdentifier: 'flowActorExecutionId',\n  baseEnumKey: 'FLOW_ACTOR_EXECUTIONS',\n  baseSchema: FlowActorExecutionBaseSchema,\n  variants: FLOW_ACTOR_EXECUTION_SCOPE_VARIANTS,\n});\n\n/**\n * Owner-agnostic UPDATE DTO — status transitions, appended messages, completion\n * time. Shared across all variants because it references NO owner FK (owner is\n * immutable). `updatedAt` is system-managed; identity fields are `.excludeFromUpdate()`.\n */\nexport const FlowActorExecutionUpdateInternalSchema = z.object({\n  status: FlowActorExecutionBaseSchema.shape.status.optional(),\n  statusChanges: FlowActorExecutionBaseSchema.shape.statusChanges.optional(),\n  messages: FlowActorExecutionBaseSchema.shape.messages.optional(),\n  finishedAt: FlowActorExecutionBaseSchema.shape.finishedAt,\n  /**\n   * The suspended-turn state, written when a turn pauses for a human decision and cleared when one\n   * arrives.\n   *\n   * ⚠️ THIS SCHEMA IS AN ALLOW-LIST, and omitting a field here does not fail — it makes the write\n   * SUCCEED and persist nothing. `pausedApproval` was added to the base envelope when the column was\n   * introduced but never here, so every approval pause wrote its status and its messages and\n   * silently dropped the one field that makes the turn resumable. The row read back as\n   * `AWAITING_APPROVAL` with no state to resume from: a turn stuck forever, with no error anywhere.\n   * Adding a persisted field is therefore never done without adding it to this contract.\n   *\n   * `.nullish()` rather than `.optional()` because clearing is a real transition: the resume writes\n   * an explicit `null` to release the pause, and under `.optional()` that null is rejected — which\n   * would leave a resumed turn still advertising a decision nobody can answer.\n   */\n  pausedApproval: FlowActorExecutionBaseSchema.shape.pausedApproval.nullish(),\n});\n\n//===============================================================\n//  Exported runtime type\n//===============================================================\n\n/**\n * Runtime shape of a persisted execution (the base envelope). The owner FK is\n * variant-specific (`userId` | `organizationId` | `applicationId`) and read from\n * the concrete variant; the conversational runtime supplies it explicitly on create.\n */\nexport type FlowActorExecution = z.infer<typeof FlowActorExecutionBaseSchema>;\n"]}
+{"version":3,"file":"flows-actors-execution.shared.schemas.js","sourceRoot":"","sources":["../../../src/flows-actors/flows-actors-execution.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Flows-Actors Execution — Persisted Resource Schema (POLYMORPHIC)\n * ================================================================\n *\n * A persisted record of a single flow/actor **system execution** — in v1 the\n * durable source of truth for a conversational chat log (`messages[]`) plus the\n * execution's lifecycle status.\n *\n * POLYMORPHIC ACROSS OWNER SCOPE. The SAME base envelope is stamped out as THREE\n * genuine single-scope resources by `declarePolymorphicSchemas()`, one owner FK\n * injected per variant:\n *   - `userFlowActorExecutions`         (USER_SELF     — `userId`)         ← WS chat + user-delegated A2A\n *   - `organizationFlowActorExecutions` (ORGANIZATIONS — `organizationId`) ← org-machine A2A\n *   - `applicationFlowActorExecutions`  (APPLICATION   — `applicationId`)  ← app-machine A2A\n *\n * A conversation is owned by EXACTLY ONE scope (its injected owner FK). There is\n * no cross-scope audit dimension on the base — ownership IS the scope. This is the\n * honest \"one concept, N owners\" model (mirrors billing accounts / subscriptions)\n * and needs ZERO core-authorizer change: each variant satisfies its own scope\n * authorizer, and `polymorphicRole` resolves the operation roles per scope. A\n * machine (API key / OIDC client) reaches its org/app variant exactly as it\n * reaches any other org/app resource — standard RBAC via its granted roles.\n *\n * KIND-AGNOSTIC BY DESIGN. A `FlowActorSystem_Kind` discriminant lets the SAME\n * resource persist both flow and actor executions. v1 implements the ACTOR\n * conversational path; the FLOW path drops in without reshaping the base envelope.\n *\n * @see flows-actors.system.shared.schemas.ts — the base execution envelope\n * @see billing-account.shared.schemas.ts — the polymorphic-scope precedent\n * @see requests/websocket.shared.schemas.ts — the streamed message payload this\n *   log mirrors (`WS_FlowsActorsMessagePayloadSchema`)\n */\n\nimport { z } from 'zod';\nimport { initZodDecorators, addImpersonalizeWith } from '@wildo-ai/zod-decorators';\n\nimport { FLOWS_ACTORS_DEFAULT_AGENT_INSTANCE, FLOWS_ACTORS_NO_MACHINE_CREDENTIAL, FlowsActors_Status } from './flows-actors.commons.shared.schemas';\nimport { DataPortabilityProvenance } from '../compliance/privacy/subject-export.shared.schemas';\nimport { PersonalDataCategory } from '../compliance/privacy/personal-data-category.shared.schemas';\nimport { FlowActorSystem_Kind } from './flows-actors.system.shared.schemas';\nimport { RedactionType } from '../compliance/privacy/redaction.shared.schemas';\nimport {\n  CoreResourceType,\n  coreResourceShared_FieldIdentifier,\n} from '../resources/resources.shared.core.definitions';\nimport {\n  declarePolymorphicSchemas,\n  optOutPolymorphicAutoBusinessKey,\n  type PolymorphicVariantDefinition,\n} from '../resources/utils/resource-polymorphism.schemas';\n\ninitZodDecorators(z);\n\n//===============================================================\n//  Conversational message log\n//===============================================================\n\n/**\n * Author of a persisted conversational message. `TOOL` records a tool-call /\n * tool-result turn (grounding retrieval); `SYSTEM` records a system/status note.\n * WS-streamed messages are always server→client, so the transport shape carries\n * no role — the persisted log adds it to reconstruct a full transcript.\n */\nexport enum FlowsActors_ConversationRole {\n  USER = 'user',\n  ASSISTANT = 'assistant',\n  SYSTEM = 'system',\n  TOOL = 'tool',\n}\n\n/**\n * Rendering hint for a message body. Mirrors the streamed\n * `WS_FlowsActorsMessagePayloadSchema.messageType` literal union exactly\n * (`text | markdown | progress | data`) as an enum so the persisted log and the\n * live stream share one vocabulary (framework rule: enums over literal unions).\n */\nexport enum FlowsActors_MessageContentType {\n  TEXT = 'text',\n  MARKDOWN = 'markdown',\n  PROGRESS = 'progress',\n  DATA = 'data',\n}\n\nexport const FlowActorExecution_MessageSchema = z.object({\n  /** Stable per-message id (client-correlatable across stream deltas). */\n  id: z.uuid(),\n  role: z.enum(FlowsActors_ConversationRole)\n    .describe(\n      'Who produced this message.\\n\\nValues:\\n'\n      + '- `user`: the person, or the client acting for them.\\n'\n      + '- `assistant`: the agent.\\n'\n      + '- `system`: instructions the agent was given, not part of the conversation a person sees.\\n'\n      + '- `tool`: the result of something the agent called.',\n    ),\n  contentType: z.enum(FlowsActors_MessageContentType).default(FlowsActors_MessageContentType.TEXT)\n    .describe(\n      'How to render `content`.\\n\\nValues:\\n'\n      + '- `text`: plain text.\\n'\n      + '- `markdown`: text with Markdown formatting.\\n'\n      + '- `progress`: an interim note about work in flight; `data` carries the detail.\\n'\n      + '- `data`: a structured payload rather than prose; read `data`, not `content`.',\n    ),\n  /** Rendered text content (may be assembled from streamed deltas). */\n  content: z.string(),\n  /** Structured payload for `DATA`/`PROGRESS` messages (tool results, progress). */\n  data: z.record(z.string(), z.unknown()).optional(),\n  createdAt: z.date().default(() => new Date()),\n});\nexport type FlowActorExecution_Message = z.infer<typeof FlowActorExecution_MessageSchema>;\n\n/**\n * The SUSPENDED-TURN state persisted when an agent turn pauses at a human-in-the-loop\n * approval boundary (execution `status` = `AWAITING_APPROVAL`). It is stored SERIALIZED as a\n * JSON string in the `pausedApproval` scalar field — NOT as a nested Zod object — because heavy\n * nested sub-structures do not round-trip through the Zod→Mongoose embedded-subdocument\n * conversion (see the per-kind state note below). Parse/serialize ONLY via the helpers below at\n * the persistence boundary; the record column itself stays a plain string.\n */\nexport const FlowActorExecution_PausedApprovalSchema = z.object({\n  /**\n   * Correlates the emitted approval REQUEST with the inbound decision (idempotency key).\n   *\n   * An OPAQUE identifier minted by the model SDK — NOT a Wildo id and NOT a UUID. It was typed\n   * `z.uuid()` on the reasonable-looking assumption that an id is a uuid, and the SDK produces\n   * values like `aitxt-3Xfhq68r7GTRXEuV1YzU4eEc`.\n   *\n   * That single wrong assumption made EVERY paused turn unresumable, and hid completely: serializing\n   * is `JSON.stringify` and does not validate, so the pause persisted perfectly; only the resume's\n   * `parse` rejected it, as a CORRUPTED blob. The turn then stayed paused forever with a\n   * \"state is unreadable\" error naming the wrong cause. Unit fixtures used a real uuid, so they were\n   * more conformant than production and could never reproduce it — the live lane found it.\n   *\n   * Validate it as an opaque non-empty string. We do not own the format and must not assert one.\n   */\n  approvalId: z.string().min(1),\n  /**\n   * The AI-SDK model-message array to RESUME from — opaque to us (the SDK's own resume\n   * contract). Captured when the approval-gated tool call suspended the stream; on the human\n   * decision the runtime appends a tool-approval-response and re-invokes with these messages.\n   */\n  sdkModelMessages: z.array(z.record(z.string(), z.unknown())),\n  /** The approval-gated tool the model wants to call (drives the human-facing prompt). */\n  pendingToolName: z.string(),\n  /** The pending tool call's arguments (drives the human-facing action description). */\n  pendingToolArgs: z.record(z.string(), z.unknown()).optional(),\n  /** ISO timestamp when the approval was requested. */\n  requestedAt: z.string(),\n  /**\n   * ISO instant after which the paused turn must not be resumed.\n   *\n   * SET ON EVERY SUSPENSION since 2026-09-08 (#465). It was declared here, carried on the\n   * approval-request WebSocket payload and read and converted by the browser, and NO WRITER EVER SET\n   * IT — so a pending approval never expired and the field described a timeout that did not exist.\n   *\n   * The terminal state on expiry is `FlowsActors_Status.FAILED`, which the status vocabulary already\n   * named (\"resolves to PROCESSING→COMPLETED on approval, or a terminal state on denial/expiry\").\n   * Nothing new was invented for it.\n   *\n   * Still optional: a suspension persisted before that date carries none, and an absent expiry means\n   * the pause does not lapse — which is what those turns were paused under.\n   */\n  expiresAt: z.string().optional(),\n});\nexport type FlowActorExecution_PausedApproval = z.infer<typeof FlowActorExecution_PausedApprovalSchema>;\n\n/**\n * How long a human has to answer an approval-gated tool call before the turn is refused.\n *\n * **24 hours.** An agent pausing for a person should span a working day plus a night, so a request\n * raised late in the afternoon is still answerable the next morning. Much beyond that and the\n * decision stops being meaningful rather than merely late: the person is approving a tool call made\n * against a conversation, a world and an intent that have all moved on, and \"do you approve this?\"\n * with no memory of the question is a prompt people click through.\n *\n * A framework default rather than an operator knob, for now. If an application ever needs its own,\n * the knob goes beside the consent lifetime in the auth config — but nobody has asked, and a\n * timeout that every application authors identically is a default wearing a config field.\n */\nexport const FLOW_ACTOR_APPROVAL_DEFAULT_TIMEOUT_MS = 24 * 60 * 60 * 1000;\n\n/** Serialize paused-approval state for the scalar `pausedApproval` string column. */\nexport function serializeFlowActorPausedApproval(state: FlowActorExecution_PausedApproval): string {\n  return JSON.stringify(state);\n}\n\n/**\n * Parse the scalar `pausedApproval` string column back to typed state. Throws (ZodError /\n * SyntaxError) on a malformed blob — a corrupted paused record must fail loudly at resume,\n * never silently resume from garbage.\n */\nexport function parseFlowActorPausedApproval(raw: string): FlowActorExecution_PausedApproval {\n  return FlowActorExecution_PausedApprovalSchema.parse(JSON.parse(raw));\n}\n\n//===============================================================\n//  Per-kind execution state (reused from the shared execution types)\n//===============================================================\n\n// NOTE (v1 scope): the persisted record is the CONVERSATIONAL envelope only —\n// `kind` + `status`/`statusChanges` + the `messages[]` chat log. The richer\n// per-kind graph-state slots (`flowState` node-states / `actorState` plan+tasks,\n// sliced from `FlowSystem_Execution` / `ActorSystem_Execution`) are intentionally\n// NOT persisted yet: the v1 conversational runtime never writes them, and those\n// heavy nested sub-structures (required `plan`/`walkthrough`/`standaloneTasks`\n// with embedded `_id`s) do not round-trip through the Zod→Mongoose embedded-\n// subdocument conversion as optional slots (empty subdocs get instantiated and\n// fail required-path validation). When the flow/actor orchestration runtime\n// actually produces graph state, add typed `flowState`/`actorState` back WITH the\n// embedded-subdocument treatment (see the zod↔mongoose nested-union / embedded-id\n// notes) rather than a raw `.pick()`. `kind` already preserves discrimination.\n\n//===============================================================\n//  Base execution record — NO owner scope FK (injected per variant)\n//===============================================================\n\n/**\n * The conversation envelope shared by every scope variant. It carries NO owner\n * scope FK: `declarePolymorphicSchemas()` injects exactly ONE (`userId` /\n * `organizationId` / `applicationId`) per variant. Do NOT add an `initiator`\n * snapshot here — a nested `initiator.userId`/`.organizationId` collides with the\n * contextual scope filter (it matches the field identifier at every schema path\n * and injects an exact-subdocument clause that never equals the stored snapshot,\n * so every scoped read/update silently matches zero rows). Ownership lives ONLY on\n * the single injected top-level owner FK.\n */\nexport const FlowActorExecutionBaseSchema = z.object({\n  /** MongoDB document id — auto-generated / auto-managed (excluded from create). */\n  _id: z.string().min(1).isPrimaryKey(),\n\n  /**\n   * Stable business id of the execution, generated by the conversational runtime\n   * and echoed over the WebSocket channel (`WS_FlowsActors*.executionId`). Unique\n   * per variant collection (a UUID — no cross-collection collision). Immutable\n   * once created.\n   */\n  executionId: z.uuid().isUnique({ scope: 'global', sparse: false }).excludeFromUpdate().isSummaryField(),\n\n  // === System identity (set on create, immutable) ===\n  /** Ref of the executed flow/actor system (`FlowActorSystem.ref`). */\n  systemRef: z.string().isDBIndexed().excludeFromUpdate().isSummaryField(),\n  /** Discriminant selecting which state slot is populated. */\n  kind: z.enum(FlowActorSystem_Kind).isDBIndexed().excludeFromUpdate().isSummaryField(),\n\n  // === Runtime status ===\n  /**\n   * WHICH agent this conversation was opened through — part of the read filter, not metadata.\n   *\n   * The task family carried this from gate #3; executions did not, so a caller holding a\n   * `contextId` could continue that thread through a DIFFERENT declared agent and load the prior\n   * transcript into the other agent's context. A2A agents are declared as separate resource servers\n   * with per-instance token audiences, and the plane at risk here holds the full message log — not\n   * a 120-character title (review finding G5-8).\n   *\n   * The WebSocket surface has no agent, and the default A2A agent is an identity of its own; both\n   * store {@link FLOWS_ACTORS_DEFAULT_AGENT_INSTANCE}.\n   */\n  resourceServerInstanceRef: z.string().min(1).isDBIndexed(),\n\n  /**\n   * WHICH machine credential opened this conversation — part of the read filter, not metadata.\n   *\n   * Identical axis and identical reasoning to the task family: the injected scope FK does not\n   * identify the principal on the machine variants (`applicationId` is a deployment singleton;\n   * `organizationId` is shared by every machine client of one tenant), so without it a\n   * separately-credentialed client could read and continue another client's conversation — which\n   * carries the full message log, not merely a title.\n   *\n   * User-delegated turns store {@link FLOWS_ACTORS_NO_MACHINE_CREDENTIAL}: the human is the\n   * principal there and the `userId` owner FK already discriminates.\n   */\n  machineCredentialId: z.string().min(1).isDBIndexed(),\n\n  status: z.enum(FlowsActors_Status).isDBIndexed().isSummaryField(),\n  statusChanges: z.array(z.object({\n    status: z.enum(FlowsActors_Status),\n    timestamp: z.date(),\n  })).default([]),\n\n  // === Conversational log (chat history) ===\n  /**\n   * The conversation transcript.\n   *\n   * ## Provenance: SUBJECT_PROVIDED, and the asymmetry is the reason (review finding F5-6)\n   *\n   * This array MIXES subject-authored turns (`role: USER`) with model-generated ones\n   * (`role: ASSISTANT`), and provenance is declared per FIELD — there is no per-element mechanism,\n   * so one classification must cover both. The two ways of being wrong are not equally bad:\n   *\n   *   • Classifying DERIVED would EXCLUDE the subject's own words from an Art. 20 bundle. That is a\n   *     failure of the right the article exists to serve.\n   *   • Classifying SUBJECT_PROVIDED includes the assistant's replies alongside them. That is\n   *     over-delivery — but of a transcript the subject was a party to and already saw, which is the\n   *     natural unit a person means by \"my conversation\".\n   *\n   * So the classification follows the ASYMMETRY, not a per-element truth we cannot express. Revisit\n   * only if per-element provenance ever exists; splitting the array by role at export time was\n   * considered and rejected as inventing a second mechanism for one field.\n   *\n   * ⚠️ **This is a LABELLING change, not a behaviour change**, and the first version of this note\n   * failed to say so. `resolvePortabilityFieldScope` maps `SUBJECT_PROVIDED` *and* `OBSERVED` to\n   * `INCLUDED`, and the resource default was already `OBSERVED` — so `messages` was in the Art. 20\n   * bundle before and after. Nothing about an export changes.\n   *\n   * The rejected alternative the first version omitted is the one that was actually in force:\n   * **`OBSERVED`** — \"data generated by the subject's USE of the service\", a defensible reading of a\n   * mixed transcript. It is rejected for precision rather than effect: the USER turns are authored\n   * BY the subject, not merely observed of them, and a classification should say the truest thing\n   * available even when two values resolve alike today.\n   *\n   * The task family's `output`/`artifacts` are DERIVED by contrast, and that is not an\n   * inconsistency: those are model output ABOUT the work, with no subject-authored content mixed in.\n   */\n  // RESET on erasure — returns this field to its schema default. It holds the conversation itself,\n  // which the category above correctly declares as personal data. RESET rather than REMOVE or MASK\n  // because the field is non-nullable WITH a `.default()`: REMOVE needs a clearable field and MASK\n  // needs a string. The value comes from the schema, so there is no second copy to drift.\n  messages: addImpersonalizeWith(\n  FlowActorExecution_MessageSchema.array().default([])\n      .portabilityProvenance(DataPortabilityProvenance.SUBJECT_PROVIDED)\n      // The conversation itself. Category as well as provenance, so a notice can enumerate it: the two\n      // axes answer different questions and a provenance alone leaves the field an OUTSTANDING gap.\n      .dataCategories(PersonalDataCategory.USER_CONTENT),\n    RedactionType.RESET,\n  ),\n\n  // === HITL (human-in-the-loop) suspension ===\n  /**\n   * Serialized {@link FlowActorExecution_PausedApproval} — present ONLY while `status` is\n   * `AWAITING_APPROVAL`. A scalar JSON string (see that schema's doc for why it is NOT a nested\n   * object: the Zod→Mongoose round-trip). Set on pause, cleared on resume / terminal completion;\n   * never authored on create.\n   */\n  /**\n   * Serialized suspended-turn state; `null` once a decision releases the pause.\n   *\n   * `.nullish()`, not `.optional()`, and the difference is load-bearing at the READ. Clearing writes\n   * an explicit `null`; the write then re-parses the row to project its response, and under\n   * `.optional()` that projection throws `expected string, received null`. The clear PERSISTS (there\n   * is no transaction to roll back) and the operation still fails — so the pause was released and\n   * the resume aborted, leaving the turn `failed` with its work never done, reported as a resource\n   * transformation error that names nothing about approvals.\n   *\n   * The input contract needing `.nullish()` (see `FlowActorExecutionUpdateInternalSchema`) is a\n   * SEPARATE surface from this one. Fixing only that gets the value written and still throws on the\n   * way out — both must admit null or neither does.\n   */\n  // This blob contains SDK resume messages and pending tool arguments. It is\n  // runtime continuation state, not conversation content: generic client reads,\n  // summaries and generated API schemas must never disclose it.\n  pausedApproval: z.string().nullish().excludeFromCreate().isBackendOnly(),\n\n  // === Timing (system-managed; defaults are load-bearing — the create pipeline\n  //     strips these then date-coerces, so a missing default → Invalid Date) ===\n  createdAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),\n  updatedAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate().isSummaryField(),\n  /** Set on terminal completion (via UPDATE); never on create. */\n  finishedAt: z.date().optional().excludeFromCreate().isSummaryField(),\n});\nexport type FlowActorExecutionBase = z.infer<typeof FlowActorExecutionBaseSchema>;\n\n//===============================================================\n//  Polymorphic declaration — one owner-scope variant per scope\n//===============================================================\n\n/**\n * The three owner-scope variants a flows-actors execution is stamped out for.\n * Each is `isPrimaryScope: true` (the injected owner FK is the primary scope), and\n * each opts OUT of the singleton auto-business-key: a conversation is MULTI-ROW\n * per scope (many discussions per user/org/app), so the injected owner FK must NOT\n * be marked `.isUnique()` — otherwise the second conversation per scope would fail\n * with a duplicate-key error. Mirrors subscriptions / usage-records / SSO\n * connections (all multi-row polymorphic resources).\n */\nexport const FLOW_ACTOR_EXECUTION_SCOPE_VARIANTS: PolymorphicVariantDefinition[] = [\n  { parentResourceType: CoreResourceType.USERS,         parentFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.USERS],         isPrimaryScope: true },\n  { parentResourceType: CoreResourceType.ORGANIZATIONS, parentFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.ORGANIZATIONS], isPrimaryScope: true },\n  { parentResourceType: CoreResourceType.APPLICATION,   parentFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.APPLICATION],   isPrimaryScope: true },\n].map(optOutPolymorphicAutoBusinessKey);\n\n/**\n * Polymorphic declaration for flows-actors executions. Produces 3 variants:\n *   - users        → `userFlowActorExecutions`         (`userId` injected)\n *   - organizations→ `organizationFlowActorExecutions` (`organizationId` injected)\n *   - applications → `applicationFlowActorExecutions`   (`applicationId` injected)\n */\nexport const flowActorExecutionsPolymorphicDeclaration = declarePolymorphicSchemas({\n  baseResourceType: 'flowActorExecutions',\n  baseFieldIdentifier: 'flowActorExecutionId',\n  baseEnumKey: 'FLOW_ACTOR_EXECUTIONS',\n  baseSchema: FlowActorExecutionBaseSchema,\n  variants: FLOW_ACTOR_EXECUTION_SCOPE_VARIANTS,\n});\n\n/**\n * Owner-agnostic UPDATE DTO — status transitions, appended messages, completion\n * time. Shared across all variants because it references NO owner FK (owner is\n * immutable). `updatedAt` is system-managed; identity fields are `.excludeFromUpdate()`.\n */\nexport const FlowActorExecutionUpdateInternalSchema = z.object({\n  status: FlowActorExecutionBaseSchema.shape.status.optional(),\n  statusChanges: FlowActorExecutionBaseSchema.shape.statusChanges.optional(),\n  messages: FlowActorExecutionBaseSchema.shape.messages.optional(),\n  finishedAt: FlowActorExecutionBaseSchema.shape.finishedAt,\n  /**\n   * The suspended-turn state, written when a turn pauses for a human decision and cleared when one\n   * arrives.\n   *\n   * ⚠️ THIS SCHEMA IS AN ALLOW-LIST, and omitting a field here does not fail — it makes the write\n   * SUCCEED and persist nothing. `pausedApproval` was added to the base envelope when the column was\n   * introduced but never here, so every approval pause wrote its status and its messages and\n   * silently dropped the one field that makes the turn resumable. The row read back as\n   * `AWAITING_APPROVAL` with no state to resume from: a turn stuck forever, with no error anywhere.\n   * Adding a persisted field is therefore never done without adding it to this contract.\n   *\n   * `.nullish()` rather than `.optional()` because clearing is a real transition: the resume writes\n   * an explicit `null` to release the pause, and under `.optional()` that null is rejected — which\n   * would leave a resumed turn still advertising a decision nobody can answer.\n   */\n  pausedApproval: FlowActorExecutionBaseSchema.shape.pausedApproval.nullish(),\n});\n\n//===============================================================\n//  Exported runtime type\n//===============================================================\n\n/**\n * Runtime shape of a persisted execution (the base envelope). The owner FK is\n * variant-specific (`userId` | `organizationId` | `applicationId`) and read from\n * the concrete variant; the conversational runtime supplies it explicitly on create.\n */\nexport type FlowActorExecution = z.infer<typeof FlowActorExecutionBaseSchema>;\n"]}

package/dist/esm/flows-actors/flows-actors-task.shared.resources-config.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flows-actors-task.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors-task.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAGH,OAAO,EAAE,qBAAqB,EAAoB,MAAM,gDAAgD,CAAC;AA4DzG;;;;;;;;;GASG;AACH,eAAO,MAAM,kCAAkC,oRAgL9C,CAAC"}
+{"version":3,"file":"flows-actors-task.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../src/flows-actors/flows-actors-task.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAGH,OAAO,EAAE,qBAAqB,EAAoB,MAAM,gDAAgD,CAAC;AA4DzG;;;;;;;;;GASG;AACH,eAAO,MAAM,kCAAkC,oRAgL9C,CAAC"}

package/dist/esm/flows-actors/flows-actors-task.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flows-actors-task.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors-task.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAsC,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAS/G,OAAO,EAGL,KAAK,4BAA4B,EAClC,MAAM,kDAAkD,CAAC;AAkB1D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8OlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAMxE;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,EAAE,4BAA4B,EAIlC,CAAC;AAExC;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAM/C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAe5C,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}
+{"version":3,"file":"flows-actors-task.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/flows-actors/flows-actors-task.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAsC,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAS/G,OAAO,EAGL,KAAK,4BAA4B,EAClC,MAAM,kDAAkD,CAAC;AAkB1D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8OlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAMxE;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,EAAE,4BAA4B,EAIlC,CAAC;AAExC;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAM/C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAe5C,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/esm/flows-actors/flows-actors.commons.shared.schemas.d.ts

@@ -27,6 +27,25 @@ export declare enum FlowsActors_Status {
     CANCELLED = "cancelled",
     ABORTED = "aborted"
 }
+/**
+ * What each run state MEANS to somebody watching a run — the words, made reachable.
+ *
+ * The members carry their meanings in JSDoc, which no runtime surface can read, so every surface
+ * that had to SHOW one either invented words or printed a bare token. The published API reference
+ * did the second: the top-level `status` field carries a description from its resource
+ * specification, and the identical enum one level down in `statusChanges[]` carried nothing,
+ * because field-doc injection reaches top-level properties only.
+ *
+ * Authored once here and rendered into every `.describe()` that needs it, so three schemas cannot
+ * drift into three accounts of one vocabulary. Exhaustive by type: a tenth state does not compile
+ * until it has been worded.
+ */
+export declare const FLOWS_ACTORS_STATUS_MEANINGS: Readonly<Record<FlowsActors_Status, string>>;
+/**
+ * One `Values:` legend, in the shape the generated API reference already uses for a described enum,
+ * so a NESTED field reads exactly like a top-level one rather than like a second convention.
+ */
+export declare function describeFlowsActorsStatus(lead: string): string;
 export declare const FlowsActors_LeafElements_RelationshipSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<FlowsActors_ElementKind.ACTOR>;
     actorId: z.ZodString;

package/dist/esm/flows-actors/flows-actors.commons.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flows-actors.commons.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.commons.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,oBAAY,uBAAuB;IACjC,IAAI,SAAS;IACb,KAAK,UAAU;IACf,YAAY,iBAAiB;IAC7B,SAAS,cAAc;IACvB,IAAI,eAAe;IACnB,IAAI,eAAe;IACnB,SAAS,oBAAoB;CAC9B;AAED,oBAAY,kBAAkB;IAC5B,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB;;;;;;;;OAQG;IACH,iBAAiB,sBAAsB;IACvC,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB;AAOD,eAAO,MAAM,2CAA2C;;;;;;;;;;;;;;;;;2BAsBtD,CAAC;AACH,MAAM,MAAM,qCAAqC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2CAA2C,CAAC,CAAC;AAGhH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAoC/C,CAAC;AACH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAGlG,oBAAY,oBAAoB;IAC9B,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,WAAW,gBAAgB;IAC3B,UAAU,eAAe;IACzB,UAAU,eAAe;CAC1B;AAED,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA0CzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAYtF,oBAAY,gCAAgC;IAC1C,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,WAAW,gBAAgB;CAC5B;AAED,oBAAY,sBAAsB;IAEhC,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,QAAQ,aAAa;CACtB;AAED,eAAO,MAAM,+BAA+B,gCAAe,CAAC;AAC5D,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgBlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,gCAAgC;;;;;iBAM3C,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAK1F,oBAAY,iCAAiC;IAC3C,MAAM,WAAW,CAAE,0CAA0C;IAC7D,IAAI,SAAS,CAAE,wCAAwC;IACvD,SAAS,cAAc;CACxB;AAED,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;iBAIxC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEnF,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAI7C,CAAC;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAI9F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,kCAAkC,qBAAqB,CAAC;AAErE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mCAAmC,cAAc,CAAC"}
+{"version":3,"file":"flows-actors.commons.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/flows-actors/flows-actors.commons.shared.schemas.ts"],"names":[],"mappings":"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"}

package/dist/esm/flows-actors/flows-actors.commons.shared.schemas.js

@@ -33,6 +33,39 @@ export var FlowsActors_Status;
     FlowsActors_Status["CANCELLED"] = "cancelled";
     FlowsActors_Status["ABORTED"] = "aborted";
 })(FlowsActors_Status || (FlowsActors_Status = {}));
+/**
+ * What each run state MEANS to somebody watching a run — the words, made reachable.
+ *
+ * The members carry their meanings in JSDoc, which no runtime surface can read, so every surface
+ * that had to SHOW one either invented words or printed a bare token. The published API reference
+ * did the second: the top-level `status` field carries a description from its resource
+ * specification, and the identical enum one level down in `statusChanges[]` carried nothing,
+ * because field-doc injection reaches top-level properties only.
+ *
+ * Authored once here and rendered into every `.describe()` that needs it, so three schemas cannot
+ * drift into three accounts of one vocabulary. Exhaustive by type: a tenth state does not compile
+ * until it has been worded.
+ */
+export const FLOWS_ACTORS_STATUS_MEANINGS = {
+    [FlowsActors_Status.READY]: 'Created and ready to start; no work has been done yet.',
+    [FlowsActors_Status.PENDING]: 'Accepted and queued, waiting for a runner to pick it up.',
+    [FlowsActors_Status.PROCESSING]: 'Running now.',
+    [FlowsActors_Status.AWAITING_APPROVAL]: 'Paused at an approval point: it called something a person must authorize, and it resumes or ends when that decision arrives.',
+    [FlowsActors_Status.COMPLETED]: 'Finished, and did what it set out to do.',
+    [FlowsActors_Status.FAILED]: 'Stopped because something went wrong.',
+    [FlowsActors_Status.CANCELLED]: 'Stopped because somebody asked it to stop.',
+    [FlowsActors_Status.ABORTED]: 'Stopped by the system rather than by a person — a shutdown, a timeout, a lost runner.',
+};
+/**
+ * One `Values:` legend, in the shape the generated API reference already uses for a described enum,
+ * so a NESTED field reads exactly like a top-level one rather than like a second convention.
+ */
+export function describeFlowsActorsStatus(lead) {
+    const legend = Object.entries(FLOWS_ACTORS_STATUS_MEANINGS)
+        .map(([value, meaning]) => `- \`${value}\`: ${meaning}`)
+        .join('\n');
+    return `${lead}\n\nValues:\n${legend}`;
+}
 //===============================================================
 //  Relationship
 //===============================================================

package/dist/esm/flows-actors/flows-actors.commons.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"flows-actors.commons.shared.schemas.js","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.commons.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport { ResourcePrimaryScope } from \"../resources/resources.shared.schemas\";\nimport { RolesSchema } from \"../security/authorizations/roles.shared.schemas\";\nimport { WildoError_BackendSchema } from \"../errors/errors.shared.schemas\";\n\n//===============================================================\n//  General\n//===============================================================\n\nexport enum FlowsActors_ElementKind {\n  FLOW = \"flow\",\n  ACTOR = \"actor\",\n  ACTOR_SYSTEM = \"actor.system\",\n  FLOW_STEP = \"flow.step\",\n  TASK = \"actor.task\",\n  PLAN = \"actor.plan\",\n  PLAN_STEP = \"actor.plan.step\",\n}\n\nexport enum FlowsActors_Status {\n  READY = \"ready\",\n  PENDING = \"pending\",\n  PROCESSING = \"processing\",\n  /**\n   * The turn is SUSPENDED at a human-in-the-loop approval boundary: the agent called\n   * an approval-gated tool, the run state is persisted (see `pausedApproval` on the\n   * execution record), and the runtime is waiting for a decision — a\n   * `FLOWS_ACTORS_APPROVAL_RESPONSE` over WebSocket, or an A2A `input-required` task\n   * resolution. NON-terminal: resolves to PROCESSING→COMPLETED on approval, or a\n   * terminal state on denial/expiry. Machine (org/app) turns never enter this state —\n   * approval-gated tools are auto-denied for them (HITL is user-delegated-only in v1).\n   */\n  AWAITING_APPROVAL = \"awaiting_approval\",\n  COMPLETED = \"completed\",\n  FAILED = \"failed\",\n  CANCELLED = \"cancelled\",\n  ABORTED = \"aborted\",\n}\n\n//===============================================================\n//  Relationship\n//===============================================================\n\n\nexport const FlowsActors_LeafElements_RelationshipSchema = z.discriminatedUnion(\"kind\", [\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.ACTOR),\n    actorId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.FLOW_STEP),\n    flowId: z.string(),\n    stepId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.TASK),\n    taskId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.PLAN_STEP),\n    planId: z.string(),\n    planStepId: z.string(),\n    actorSystemId: z.string(),\n  }),\n]);\nexport type FlowsActors_LeafElements_Relationship = z.infer<typeof FlowsActors_LeafElements_RelationshipSchema>;\n\n\nexport const FlowsActors_SimpleRelationshipSchema = z.discriminatedUnion(\"kind\", [\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.ACTOR),\n    actorId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.FLOW),\n    flowId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.FLOW_STEP),\n    flowId: z.string(),\n    stepId: z.string(),\n  }),\n\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.TASK),\n    taskId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.PLAN),\n    planId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.ACTOR_SYSTEM),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.PLAN_STEP),\n    planId: z.string(),\n    planStepId: z.string(),\n    actorSystemId: z.string(),\n  }),\n]);\nexport type FlowsActors_SimpleRelationship = z.infer<typeof FlowsActors_SimpleRelationshipSchema>;\n\n\nexport enum FlowsActors_Relation {\n  CREATED_BY = \"created_by\",\n  PARENT_OF = \"parent_of\",\n  CHILD_OF = \"child_of\",\n  PART_OF = \"part_of\",\n  IS_FALLBACK = \"is_fallback\",\n  DEPENDS_ON = \"depends_on\",\n  BLOCKED_BY = \"blocked_by\",\n}\n\nexport const FlowsActors_RelationshipSchema = z.discriminatedUnion(\"kind\", [\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.FLOW),\n    relation: z.enum(FlowsActors_Relation),\n    flowId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.ACTOR),\n    relation: z.enum(FlowsActors_Relation),\n    actorId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.FLOW_STEP),\n    relation: z.enum(FlowsActors_Relation),\n    flowId: z.string(),\n    stepId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.TASK),\n    relation: z.enum(FlowsActors_Relation),\n    taskId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.PLAN),\n    relation: z.enum(FlowsActors_Relation),\n    planId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.PLAN_STEP),\n    relation: z.enum(FlowsActors_Relation),\n    planId: z.string(),\n    planStepId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.ACTOR_SYSTEM),\n    relation: z.enum(FlowsActors_Relation),\n    actorSystemId: z.string(),\n  }),\n]);\nexport type FlowsActors_Relationship = z.infer<typeof FlowsActors_RelationshipSchema>;\n\n//===============================================================\n//  FlowsActors_Event\n// --------\n// FlowsActors_Events are immutable messages that flow through the system topics,\n// carrying payloads and metadata between flows and actors. They\n// enable loose coupling, traceability through correlation IDs,\n// and event sourcing patterns for building scalable, resilient\n// distributed systems with clear audit trails.\n//===============================================================\n\nexport enum FlowsActors_Event_DeliveryStatus {\n  PENDING = \"pending\",\n  DELIVERED = \"delivered\",\n  FAILED = \"failed\",\n  DEAD_LETTER = \"dead_letter\",\n}\n\nexport enum FlowsActors_Event_Type {\n\n  COMPLETED = \"completed\",\n  FAILED = \"failed\",\n  CANCELLED = \"cancelled\",\n  ABORTED = \"aborted\",\n  REQUESTED = \"requested\",\n  ACTIONED = \"actioned\",\n}\n\nexport const FlowsActors_Event_ContextSchema = z.object({});\nexport type FlowsActors_Event_Context = z.infer<typeof FlowsActors_Event_ContextSchema>;\n\nexport const FlowsActors_EventSchema = z.object({\n  _id: z.string().optional(),\n  eventType: z.enum(FlowsActors_Event_Type),\n  origin : FlowsActors_SimpleRelationshipSchema.optional(),\n  eventContext: FlowsActors_Event_ContextSchema.optional(),\n\n  topic: z.string(),\n  payload: z.any(),\n\n  sequenceNumber: z.number().optional(),\n  tracking : z.object({\n    timestamp: z.string(),\n\n    correlationId: z.string().optional(),\n    causationId: z.string().optional(),\n  }),\n});\nexport type FlowsActors_Event = z.infer<typeof FlowsActors_EventSchema>;\n\nexport const FlowsActors_Event_TemplateSchema = z.object({\n  eventType: z.string(),\n  eventContext: FlowsActors_Event_ContextSchema.optional(),\n  topic: z.string(),\n\n  payloadMapping: z.record(z.string(), z.string()),\n});\nexport type FlowsActors_Event_Template = z.infer<typeof FlowsActors_Event_TemplateSchema>;\n\n//===============================================================\n//  State\n//===============================================================\nexport enum FlowsActors_CircuitBreaker_Status {\n  CLOSED = \"closed\", // circuit is closed, requests are allowed\n  OPEN = \"open\", // circuit is open, requests are blocked\n  HALF_OPEN = \"half_open\", // circuit is half-open, requests are allowed after a timeout\n}\n\nexport const FlowsActors_Checkpoint_Schema = z.object({\n  point : FlowsActors_LeafElements_RelationshipSchema,\n  timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n  context: z.any().optional(),\n});\nexport type FlowsActors_Checkpoint = z.infer<typeof FlowsActors_Checkpoint_Schema>;\n\nexport const FlowsActors_Error_State_BaseSchema = z.object({\n  circuitBreakerStatus: z.enum(FlowsActors_CircuitBreaker_Status).optional(),\n  error: WildoError_BackendSchema.optional(),\n  checkpoints: FlowsActors_Checkpoint_Schema.array().optional(),\n});\nexport type FlowsActors_Error_State_Base = z.infer<typeof FlowsActors_Error_State_BaseSchema>;\n\n\n\n/**\n * The stored `machineCredentialId` of a turn that had NO machine credential — i.e. a\n * user-delegated turn, where the human IS the principal and `userId` already discriminates.\n *\n * ## Why a sentinel rather than an absent field\n *\n * Both flows-actors families (executions and tasks) are owned by an injected scope FK, and for the\n * MACHINE variants that FK does not identify the principal:\n *\n * - `applicationId` is a DEPLOYMENT SINGLETON, so every app-scope OAuth client resolves to the\n *   same owner filter — client B could read and cancel client A's work.\n * - `organizationId` is shared by every machine client of one tenant, with the same consequence\n *   inside that tenant.\n *\n * Since the conversation title / task title carries the opening characters of the originating\n * prompt, that is a cross-client disclosure of prompt text between separately-credentialed\n * principals — the harm the per-agent axis was added to prevent, one axis short.\n *\n * Storing a normalised value on EVERY row (rather than leaving user-delegated rows null) keeps the\n * filter a plain equality on both persistence adapters, instead of depending on how each one\n * matches an absent field. The `*` characters cannot occur in a credential id.\n */\nexport const FLOWS_ACTORS_NO_MACHINE_CREDENTIAL = '*user-delegated*';\n\n/**\n * The stored agent identity of the DEFAULT (unnamed) A2A agent, and of any transport that has no\n * agent at all — the WebSocket conversation surface.\n *\n * Declared A2A instance refs are constrained to `^[a-z0-9][a-z0-9-]*$`, so the `*` characters make\n * this unreachable by any real ref. Storing a normalised value on EVERY row keeps the read filter a\n * plain equality on both persistence adapters rather than depending on how each matches an absent\n * field.\n *\n * ONE source for both families: `A2A_DEFAULT_INSTANCE_REF` aliases this rather than restating it,\n * because two constants with the same literal are exactly how the task and execution planes would\n * drift apart.\n */\nexport const FLOWS_ACTORS_DEFAULT_AGENT_INSTANCE = '*default*';\n"]}
+{"version":3,"file":"flows-actors.commons.shared.schemas.js","sourceRoot":"","sources":["../../../src/flows-actors/flows-actors.commons.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,iEAAiE;AACjE,WAAW;AACX,iEAAiE;AAEjE,MAAM,CAAN,IAAY,uBAQX;AARD,WAAY,uBAAuB;IACjC,wCAAa,CAAA;IACb,0CAAe,CAAA;IACf,wDAA6B,CAAA;IAC7B,kDAAuB,CAAA;IACvB,8CAAmB,CAAA;IACnB,8CAAmB,CAAA;IACnB,wDAA6B,CAAA;AAC/B,CAAC,EARW,uBAAuB,KAAvB,uBAAuB,QAQlC;AAED,MAAM,CAAN,IAAY,kBAkBX;AAlBD,WAAY,kBAAkB;IAC5B,qCAAe,CAAA;IACf,yCAAmB,CAAA;IACnB,+CAAyB,CAAA;IACzB;;;;;;;;OAQG;IACH,6DAAuC,CAAA;IACvC,6CAAuB,CAAA;IACvB,uCAAiB,CAAA;IACjB,6CAAuB,CAAA;IACvB,yCAAmB,CAAA;AACrB,CAAC,EAlBW,kBAAkB,KAAlB,kBAAkB,QAkB7B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAiD;IACxF,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,wDAAwD;IACpF,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,0DAA0D;IACxF,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE,cAAc;IAC/C,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,EAAE,8HAA8H;IACtK,CAAC,kBAAkB,CAAC,SAAS,CAAC,EAAE,0CAA0C;IAC1E,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,uCAAuC;IACpE,CAAC,kBAAkB,CAAC,SAAS,CAAC,EAAE,4CAA4C;IAC5E,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,uFAAuF;CACtH,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,4BAA4B,CAAC;SACxD,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,KAAK,OAAO,OAAO,EAAE,CAAC;SACvD,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,GAAG,IAAI,gBAAgB,MAAM,EAAE,CAAC;AACzC,CAAC;AAED,iEAAiE;AACjE,gBAAgB;AAChB,iEAAiE;AAGjE,MAAM,CAAC,MAAM,2CAA2C,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACtF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,KAAK,CAAC;QAC9C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;KAC1B,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,SAAS,CAAC;QAClD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,IAAI,CAAC;QAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;KAC1B,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,SAAS,CAAC;QAClD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;KAC1B,CAAC;CACH,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC/E,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,KAAK,CAAC;QAC9C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;KAC1B,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,IAAI,CAAC;QAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,SAAS,CAAC;QAClD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB,CAAC;IAEF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,IAAI,CAAC;QAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;KAC1B,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,IAAI,CAAC;QAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;KAC1B,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,YAAY,CAAC;QACrD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;KAC1B,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,SAAS,CAAC;QAClD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;KAC1B,CAAC;CACH,CAAC,CAAC;AAIH,MAAM,CAAN,IAAY,oBAQX;AARD,WAAY,oBAAoB;IAC9B,iDAAyB,CAAA;IACzB,+CAAuB,CAAA;IACvB,6CAAqB,CAAA;IACrB,2CAAmB,CAAA;IACnB,mDAA2B,CAAA;IAC3B,iDAAyB,CAAA;IACzB,iDAAyB,CAAA;AAC3B,CAAC,EARW,oBAAoB,KAApB,oBAAoB,QAQ/B;AAED,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACzE,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,IAAI,CAAC;QAC7C,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;QACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,KAAK,CAAC;QAC9C,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;QACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;KAC1B,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,SAAS,CAAC;QAClD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;QACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,IAAI,CAAC;QAC7C,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;QACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;KAC1B,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,IAAI,CAAC;QAC7C,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;QACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;KAC1B,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,SAAS,CAAC;QAClD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;QACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;KAC1B,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,YAAY,CAAC;QACrD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;QACtC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;KAC1B,CAAC;CACH,CAAC,CAAC;AAGH,iEAAiE;AACjE,qBAAqB;AACrB,WAAW;AACX,iFAAiF;AACjF,gEAAgE;AAChE,+DAA+D;AAC/D,+DAA+D;AAC/D,+CAA+C;AAC/C,iEAAiE;AAEjE,MAAM,CAAN,IAAY,gCAKX;AALD,WAAY,gCAAgC;IAC1C,uDAAmB,CAAA;IACnB,2DAAuB,CAAA;IACvB,qDAAiB,CAAA;IACjB,+DAA2B,CAAA;AAC7B,CAAC,EALW,gCAAgC,KAAhC,gCAAgC,QAK3C;AAED,MAAM,CAAN,IAAY,sBAQX;AARD,WAAY,sBAAsB;IAEhC,iDAAuB,CAAA;IACvB,2CAAiB,CAAA;IACjB,iDAAuB,CAAA;IACvB,6CAAmB,CAAA;IACnB,iDAAuB,CAAA;IACvB,+CAAqB,CAAA;AACvB,CAAC,EARW,sBAAsB,KAAtB,sBAAsB,QAQjC;AAED,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAG5D,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC;IACzC,MAAM,EAAG,oCAAoC,CAAC,QAAQ,EAAE;IACxD,YAAY,EAAE,+BAA+B,CAAC,QAAQ,EAAE;IAExD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE;IAEhB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,QAAQ,EAAG,CAAC,CAAC,MAAM,CAAC;QAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QAErB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACpC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACnC,CAAC;CACH,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,YAAY,EAAE,+BAA+B,CAAC,QAAQ,EAAE;IACxD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IAEjB,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;CACjD,CAAC,CAAC;AAGH,iEAAiE;AACjE,SAAS;AACT,iEAAiE;AACjE,MAAM,CAAN,IAAY,iCAIX;AAJD,WAAY,iCAAiC;IAC3C,sDAAiB,CAAA;IACjB,kDAAa,CAAA;IACb,4DAAuB,CAAA;AACzB,CAAC,EAJW,iCAAiC,KAAjC,iCAAiC,QAI5C;AAED,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,KAAK,EAAG,2CAA2C;IACnD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;IACpG,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CAAC;IACzD,oBAAoB,EAAE,CAAC,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC,QAAQ,EAAE;IAC1E,KAAK,EAAE,wBAAwB,CAAC,QAAQ,EAAE;IAC1C,WAAW,EAAE,6BAA6B,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;CAC9D,CAAC,CAAC;AAKH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,kBAAkB,CAAC;AAErE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,WAAW,CAAC","sourcesContent":["import { z } from \"zod\";\nimport { ResourcePrimaryScope } from \"../resources/resources.shared.schemas\";\nimport { RolesSchema } from \"../security/authorizations/roles.shared.schemas\";\nimport { WildoError_BackendSchema } from \"../errors/errors.shared.schemas\";\n\n//===============================================================\n//  General\n//===============================================================\n\nexport enum FlowsActors_ElementKind {\n  FLOW = \"flow\",\n  ACTOR = \"actor\",\n  ACTOR_SYSTEM = \"actor.system\",\n  FLOW_STEP = \"flow.step\",\n  TASK = \"actor.task\",\n  PLAN = \"actor.plan\",\n  PLAN_STEP = \"actor.plan.step\",\n}\n\nexport enum FlowsActors_Status {\n  READY = \"ready\",\n  PENDING = \"pending\",\n  PROCESSING = \"processing\",\n  /**\n   * The turn is SUSPENDED at a human-in-the-loop approval boundary: the agent called\n   * an approval-gated tool, the run state is persisted (see `pausedApproval` on the\n   * execution record), and the runtime is waiting for a decision — a\n   * `FLOWS_ACTORS_APPROVAL_RESPONSE` over WebSocket, or an A2A `input-required` task\n   * resolution. NON-terminal: resolves to PROCESSING→COMPLETED on approval, or a\n   * terminal state on denial/expiry. Machine (org/app) turns never enter this state —\n   * approval-gated tools are auto-denied for them (HITL is user-delegated-only in v1).\n   */\n  AWAITING_APPROVAL = \"awaiting_approval\",\n  COMPLETED = \"completed\",\n  FAILED = \"failed\",\n  CANCELLED = \"cancelled\",\n  ABORTED = \"aborted\",\n}\n\n/**\n * What each run state MEANS to somebody watching a run — the words, made reachable.\n *\n * The members carry their meanings in JSDoc, which no runtime surface can read, so every surface\n * that had to SHOW one either invented words or printed a bare token. The published API reference\n * did the second: the top-level `status` field carries a description from its resource\n * specification, and the identical enum one level down in `statusChanges[]` carried nothing,\n * because field-doc injection reaches top-level properties only.\n *\n * Authored once here and rendered into every `.describe()` that needs it, so three schemas cannot\n * drift into three accounts of one vocabulary. Exhaustive by type: a tenth state does not compile\n * until it has been worded.\n */\nexport const FLOWS_ACTORS_STATUS_MEANINGS: Readonly<Record<FlowsActors_Status, string>> = {\n  [FlowsActors_Status.READY]: 'Created and ready to start; no work has been done yet.',\n  [FlowsActors_Status.PENDING]: 'Accepted and queued, waiting for a runner to pick it up.',\n  [FlowsActors_Status.PROCESSING]: 'Running now.',\n  [FlowsActors_Status.AWAITING_APPROVAL]: 'Paused at an approval point: it called something a person must authorize, and it resumes or ends when that decision arrives.',\n  [FlowsActors_Status.COMPLETED]: 'Finished, and did what it set out to do.',\n  [FlowsActors_Status.FAILED]: 'Stopped because something went wrong.',\n  [FlowsActors_Status.CANCELLED]: 'Stopped because somebody asked it to stop.',\n  [FlowsActors_Status.ABORTED]: 'Stopped by the system rather than by a person — a shutdown, a timeout, a lost runner.',\n};\n\n/**\n * One `Values:` legend, in the shape the generated API reference already uses for a described enum,\n * so a NESTED field reads exactly like a top-level one rather than like a second convention.\n */\nexport function describeFlowsActorsStatus(lead: string): string {\n  const legend = Object.entries(FLOWS_ACTORS_STATUS_MEANINGS)\n    .map(([value, meaning]) => `- \\`${value}\\`: ${meaning}`)\n    .join('\\n');\n  return `${lead}\\n\\nValues:\\n${legend}`;\n}\n\n//===============================================================\n//  Relationship\n//===============================================================\n\n\nexport const FlowsActors_LeafElements_RelationshipSchema = z.discriminatedUnion(\"kind\", [\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.ACTOR),\n    actorId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.FLOW_STEP),\n    flowId: z.string(),\n    stepId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.TASK),\n    taskId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.PLAN_STEP),\n    planId: z.string(),\n    planStepId: z.string(),\n    actorSystemId: z.string(),\n  }),\n]);\nexport type FlowsActors_LeafElements_Relationship = z.infer<typeof FlowsActors_LeafElements_RelationshipSchema>;\n\n\nexport const FlowsActors_SimpleRelationshipSchema = z.discriminatedUnion(\"kind\", [\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.ACTOR),\n    actorId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.FLOW),\n    flowId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.FLOW_STEP),\n    flowId: z.string(),\n    stepId: z.string(),\n  }),\n\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.TASK),\n    taskId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.PLAN),\n    planId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.ACTOR_SYSTEM),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.PLAN_STEP),\n    planId: z.string(),\n    planStepId: z.string(),\n    actorSystemId: z.string(),\n  }),\n]);\nexport type FlowsActors_SimpleRelationship = z.infer<typeof FlowsActors_SimpleRelationshipSchema>;\n\n\nexport enum FlowsActors_Relation {\n  CREATED_BY = \"created_by\",\n  PARENT_OF = \"parent_of\",\n  CHILD_OF = \"child_of\",\n  PART_OF = \"part_of\",\n  IS_FALLBACK = \"is_fallback\",\n  DEPENDS_ON = \"depends_on\",\n  BLOCKED_BY = \"blocked_by\",\n}\n\nexport const FlowsActors_RelationshipSchema = z.discriminatedUnion(\"kind\", [\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.FLOW),\n    relation: z.enum(FlowsActors_Relation),\n    flowId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.ACTOR),\n    relation: z.enum(FlowsActors_Relation),\n    actorId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.FLOW_STEP),\n    relation: z.enum(FlowsActors_Relation),\n    flowId: z.string(),\n    stepId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.TASK),\n    relation: z.enum(FlowsActors_Relation),\n    taskId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.PLAN),\n    relation: z.enum(FlowsActors_Relation),\n    planId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.PLAN_STEP),\n    relation: z.enum(FlowsActors_Relation),\n    planId: z.string(),\n    planStepId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.ACTOR_SYSTEM),\n    relation: z.enum(FlowsActors_Relation),\n    actorSystemId: z.string(),\n  }),\n]);\nexport type FlowsActors_Relationship = z.infer<typeof FlowsActors_RelationshipSchema>;\n\n//===============================================================\n//  FlowsActors_Event\n// --------\n// FlowsActors_Events are immutable messages that flow through the system topics,\n// carrying payloads and metadata between flows and actors. They\n// enable loose coupling, traceability through correlation IDs,\n// and event sourcing patterns for building scalable, resilient\n// distributed systems with clear audit trails.\n//===============================================================\n\nexport enum FlowsActors_Event_DeliveryStatus {\n  PENDING = \"pending\",\n  DELIVERED = \"delivered\",\n  FAILED = \"failed\",\n  DEAD_LETTER = \"dead_letter\",\n}\n\nexport enum FlowsActors_Event_Type {\n\n  COMPLETED = \"completed\",\n  FAILED = \"failed\",\n  CANCELLED = \"cancelled\",\n  ABORTED = \"aborted\",\n  REQUESTED = \"requested\",\n  ACTIONED = \"actioned\",\n}\n\nexport const FlowsActors_Event_ContextSchema = z.object({});\nexport type FlowsActors_Event_Context = z.infer<typeof FlowsActors_Event_ContextSchema>;\n\nexport const FlowsActors_EventSchema = z.object({\n  _id: z.string().optional(),\n  eventType: z.enum(FlowsActors_Event_Type),\n  origin : FlowsActors_SimpleRelationshipSchema.optional(),\n  eventContext: FlowsActors_Event_ContextSchema.optional(),\n\n  topic: z.string(),\n  payload: z.any(),\n\n  sequenceNumber: z.number().optional(),\n  tracking : z.object({\n    timestamp: z.string(),\n\n    correlationId: z.string().optional(),\n    causationId: z.string().optional(),\n  }),\n});\nexport type FlowsActors_Event = z.infer<typeof FlowsActors_EventSchema>;\n\nexport const FlowsActors_Event_TemplateSchema = z.object({\n  eventType: z.string(),\n  eventContext: FlowsActors_Event_ContextSchema.optional(),\n  topic: z.string(),\n\n  payloadMapping: z.record(z.string(), z.string()),\n});\nexport type FlowsActors_Event_Template = z.infer<typeof FlowsActors_Event_TemplateSchema>;\n\n//===============================================================\n//  State\n//===============================================================\nexport enum FlowsActors_CircuitBreaker_Status {\n  CLOSED = \"closed\", // circuit is closed, requests are allowed\n  OPEN = \"open\", // circuit is open, requests are blocked\n  HALF_OPEN = \"half_open\", // circuit is half-open, requests are allowed after a timeout\n}\n\nexport const FlowsActors_Checkpoint_Schema = z.object({\n  point : FlowsActors_LeafElements_RelationshipSchema,\n  timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n  context: z.any().optional(),\n});\nexport type FlowsActors_Checkpoint = z.infer<typeof FlowsActors_Checkpoint_Schema>;\n\nexport const FlowsActors_Error_State_BaseSchema = z.object({\n  circuitBreakerStatus: z.enum(FlowsActors_CircuitBreaker_Status).optional(),\n  error: WildoError_BackendSchema.optional(),\n  checkpoints: FlowsActors_Checkpoint_Schema.array().optional(),\n});\nexport type FlowsActors_Error_State_Base = z.infer<typeof FlowsActors_Error_State_BaseSchema>;\n\n\n\n/**\n * The stored `machineCredentialId` of a turn that had NO machine credential — i.e. a\n * user-delegated turn, where the human IS the principal and `userId` already discriminates.\n *\n * ## Why a sentinel rather than an absent field\n *\n * Both flows-actors families (executions and tasks) are owned by an injected scope FK, and for the\n * MACHINE variants that FK does not identify the principal:\n *\n * - `applicationId` is a DEPLOYMENT SINGLETON, so every app-scope OAuth client resolves to the\n *   same owner filter — client B could read and cancel client A's work.\n * - `organizationId` is shared by every machine client of one tenant, with the same consequence\n *   inside that tenant.\n *\n * Since the conversation title / task title carries the opening characters of the originating\n * prompt, that is a cross-client disclosure of prompt text between separately-credentialed\n * principals — the harm the per-agent axis was added to prevent, one axis short.\n *\n * Storing a normalised value on EVERY row (rather than leaving user-delegated rows null) keeps the\n * filter a plain equality on both persistence adapters, instead of depending on how each one\n * matches an absent field. The `*` characters cannot occur in a credential id.\n */\nexport const FLOWS_ACTORS_NO_MACHINE_CREDENTIAL = '*user-delegated*';\n\n/**\n * The stored agent identity of the DEFAULT (unnamed) A2A agent, and of any transport that has no\n * agent at all — the WebSocket conversation surface.\n *\n * Declared A2A instance refs are constrained to `^[a-z0-9][a-z0-9-]*$`, so the `*` characters make\n * this unreachable by any real ref. Storing a normalised value on EVERY row keeps the read filter a\n * plain equality on both persistence adapters rather than depending on how each matches an absent\n * field.\n *\n * ONE source for both families: `A2A_DEFAULT_INSTANCE_REF` aliases this rather than restating it,\n * because two constants with the same literal are exactly how the task and execution planes would\n * drift apart.\n */\nexport const FLOWS_ACTORS_DEFAULT_AGENT_INSTANCE = '*default*';\n"]}

package/dist/esm/flows-actors/flows-actors.configuration.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flows-actors.configuration.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.configuration.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,6BAA6B,EAAE,MAAM,sEAAsE,CAAC;AAGrH,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAqBzG,eAAO,MAAM,+BAA+B;;;;;;;;iBAQ1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAMxF,eAAO,MAAM,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;iBAS1D,CAAC;AACH,MAAM,MAAM,wCAAwC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+CAA+C,CAAC,CAAC;AAEvH,eAAO,MAAM,0CAA0C;;;;;;;;;;;;;;;;iBAOrD,CAAC;AACH,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0CAA0C,CAAC,CAAC;AAE7G,eAAO,MAAM,yCAAyC;;;;;;;;;;;iBAMpD,CAAC;AACH,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yCAAyC,CAAC,CAAC;AAE3G,eAAO,MAAM,2CAA2C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAItD,CAAC;AACH,MAAM,MAAM,oCAAoC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2CAA2C,CAAC,CAAC;AAE/G,eAAO,MAAM,2CAA2C;;;;;;;;iBAQtD,CAAC;AACH,MAAM,MAAM,qCAAqC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2CAA2C,CAAC,CAAC;AAEhH,eAAO,MAAM,6CAA6C;;;;;;;;;;;;iBAIxD,CAAC;AACH,MAAM,MAAM,sCAAsC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6CAA6C,CAAC,CAAC;AAEnH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAS3C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC"}
+{"version":3,"file":"flows-actors.configuration.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/flows-actors/flows-actors.configuration.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,6BAA6B,EAAE,MAAM,sEAAsE,CAAC;AAGrH,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAqBzG,eAAO,MAAM,+BAA+B;;;;;;;;iBAQ1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAMxF,eAAO,MAAM,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;iBAS1D,CAAC;AACH,MAAM,MAAM,wCAAwC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+CAA+C,CAAC,CAAC;AAEvH,eAAO,MAAM,0CAA0C;;;;;;;;;;;;;;;;iBAOrD,CAAC;AACH,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0CAA0C,CAAC,CAAC;AAE7G,eAAO,MAAM,yCAAyC;;;;;;;;;;;iBAMpD,CAAC;AACH,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yCAAyC,CAAC,CAAC;AAE3G,eAAO,MAAM,2CAA2C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAItD,CAAC;AACH,MAAM,MAAM,oCAAoC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2CAA2C,CAAC,CAAC;AAE/G,eAAO,MAAM,2CAA2C;;;;;;;;iBAQtD,CAAC;AACH,MAAM,MAAM,qCAAqC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2CAA2C,CAAC,CAAC;AAEhH,eAAO,MAAM,6CAA6C;;;;;;;;;;;;iBAIxD,CAAC;AACH,MAAM,MAAM,sCAAsC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6CAA6C,CAAC,CAAC;AAEnH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAS3C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC"}

package/dist/esm/flows-actors/flows-actors.frontend.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flows-actors.frontend.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.frontend.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AAazG;;;GAGG;AACH,eAAO,MAAM,4CAA4C;;;;;;iBAevD,CAAC;AACH,MAAM,MAAM,sCAAsC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4CAA4C,CAAC,CAAC;AAYlH,oBAAY,6BAA6B;IACvC,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,KAAK,UAAU;CAChB;AAED,eAAO,MAAM,+BAA+B;;;;;;;;;iBAc1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,+BAA+B;;;iBAG1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;iBAG9C,CAAC;AACH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG;;;GAGG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2B7C,CAAC;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F;;GAEG;AACH,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAEjD,CAAC;AACH,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AAUtG,eAAO,MAAM,uCAAuC;;;;;;;;;;;;iBAMlD,CAAC;AACH,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uCAAuC,CAAC,CAAC;AAExG,eAAO,MAAM,6CAA6C;;;;;;;;;;;;;;iBAExD,CAAC;AACH,MAAM,MAAM,uCAAuC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6CAA6C,CAAC,CAAC"}
+{"version":3,"file":"flows-actors.frontend.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/flows-actors/flows-actors.frontend.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AAazG;;;GAGG;AACH,eAAO,MAAM,4CAA4C;;;;;;iBAevD,CAAC;AACH,MAAM,MAAM,sCAAsC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4CAA4C,CAAC,CAAC;AAYlH,oBAAY,6BAA6B;IACvC,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,KAAK,UAAU;CAChB;AAED,eAAO,MAAM,+BAA+B;;;;;;;;;iBAc1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,+BAA+B;;;iBAG1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;iBAG9C,CAAC;AACH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG;;;GAGG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2B7C,CAAC;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F;;GAEG;AACH,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAEjD,CAAC;AACH,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AAUtG,eAAO,MAAM,uCAAuC;;;;;;;;;;;;iBAMlD,CAAC;AACH,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uCAAuC,CAAC,CAAC;AAExG,eAAO,MAAM,6CAA6C;;;;;;;;;;;;;;iBAExD,CAAC;AACH,MAAM,MAAM,uCAAuC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6CAA6C,CAAC,CAAC"}

package/dist/esm/flows-actors/flows-actors.io.shared.schemas.d.ts

@@ -1,15 +1,20 @@
 import { z } from "zod";
 /**
- * The artifact MODALITY axis — the single vocabulary the actor-agent system
- * uses to describe what an operation consumes and produces. An agent's
- * `operationDefinition.outputModality` names its produced modality; the
- * executor resolves that modality to a provider protocol (TEXT/STRUCTURED →
- * `LLM_PROVIDER`, IMAGE → `IMAGE_PROVIDER`, CODING → `AGENT_CLIENT_PROTOCOL`, …).
+ * The artifact MODALITY axis: the single vocabulary the actor-agent system
+ * uses to DESCRIBE what an operation consumes and produces.
  *
- * IMAGE is wired (gpt-image logo generation). AUDIO and VIDEO are RESERVED —
- * the modality is declarable but no provider serves it and the executor
- * fail-closes (NOT_IMPLEMENTED) until an `AUDIO_PROVIDER` / `VIDEO_PROVIDER`
- * transport lands.
+ * It is descriptive, not a dispatch key. Which provider protocol an agent
+ * reaches is decided by the arm of its `config` discriminated union (an image
+ * configuration routes to `IMAGE_PROVIDER`, a coding-agent configuration to
+ * `AGENT_CLIENT_PROTOCOL`, anything else to the `LLM_PROVIDER` path). An
+ * agent's `outputModality` is not read on that path.
+ *
+ * IMAGE is wired (gpt-image logo generation). AUDIO and VIDEO are RESERVED and
+ * no provider serves either. Nothing refuses them by modality: the
+ * configuration union simply has no audio or video arm, so an agent that would
+ * produce one cannot be declared. Adding such an arm therefore means adding the
+ * `AUDIO_PROVIDER` / `VIDEO_PROVIDER` transport in the same change, or the new
+ * arm reaches the LLM path and is answered by the wrong protocol.
  */
 export declare enum FlowsActors_IO_PartKind {
     TEXT = "text",

package/dist/esm/flows-actors/flows-actors.io.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flows-actors.io.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.io.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB;;;;;;;;;;;GAWG;AACH,oBAAY,uBAAuB;IACjC,IAAI,SAAS;IACb,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,yEAAyE;IACzE,KAAK,UAAU;IACf,0EAA0E;IAC1E,KAAK,UAAU;IACf,0EAA0E;IAC1E,KAAK,UAAU;CAChB;AAID,QAAA,MAAM,yBAAyB;;;;;;iBAM7B,CAAC;AAEH,eAAO,MAAM,wBAAwB,EAAE,OAAO,yBAAqD,CAAC;AACpG,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE3E,QAAA,MAAM,mCAAmC;;;;iBAIvC,CAAC;AAEH,eAAO,MAAM,kCAAkC,EAAE,OAAO,mCAAyE,CAAC;AAClI,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAE/F,QAAA,MAAM,4BAA4B;;;;;;;;;;;;;iBAgBhC,CAAC;AAEH,eAAO,MAAM,2BAA2B,EAAE,OAAO,4BAA2D,CAAC;AAC7G,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAGjF,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA0C3B,CAAC;AAEH,eAAO,MAAM,sBAAsB,EAAE,OAAO,uBAAiD,CAAC;AAC9F,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}
+{"version":3,"file":"flows-actors.io.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/flows-actors/flows-actors.io.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB;;;;;;;;;;;;;;;;GAgBG;AACH,oBAAY,uBAAuB;IACjC,IAAI,SAAS;IACb,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,yEAAyE;IACzE,KAAK,UAAU;IACf,0EAA0E;IAC1E,KAAK,UAAU;IACf,0EAA0E;IAC1E,KAAK,UAAU;CAChB;AAID,QAAA,MAAM,yBAAyB;;;;;;iBAM7B,CAAC;AAEH,eAAO,MAAM,wBAAwB,EAAE,OAAO,yBAAqD,CAAC;AACpG,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE3E,QAAA,MAAM,mCAAmC;;;;iBAIvC,CAAC;AAEH,eAAO,MAAM,kCAAkC,EAAE,OAAO,mCAAyE,CAAC;AAClI,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAE/F,QAAA,MAAM,4BAA4B;;;;;;;;;;;;;iBAgBhC,CAAC;AAEH,eAAO,MAAM,2BAA2B,EAAE,OAAO,4BAA2D,CAAC;AAC7G,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAGjF,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA0C3B,CAAC;AAEH,eAAO,MAAM,sBAAsB,EAAE,OAAO,uBAAiD,CAAC;AAC9F,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/esm/flows-actors/flows-actors.io.shared.schemas.js

@@ -9,16 +9,21 @@ import { z } from "zod";
 // of generated content across workflow executions.
 //===============================================================
 /**
- * The artifact MODALITY axis — the single vocabulary the actor-agent system
- * uses to describe what an operation consumes and produces. An agent's
- * `operationDefinition.outputModality` names its produced modality; the
- * executor resolves that modality to a provider protocol (TEXT/STRUCTURED →
- * `LLM_PROVIDER`, IMAGE → `IMAGE_PROVIDER`, CODING → `AGENT_CLIENT_PROTOCOL`, …).
+ * The artifact MODALITY axis: the single vocabulary the actor-agent system
+ * uses to DESCRIBE what an operation consumes and produces.
  *
- * IMAGE is wired (gpt-image logo generation). AUDIO and VIDEO are RESERVED —
- * the modality is declarable but no provider serves it and the executor
- * fail-closes (NOT_IMPLEMENTED) until an `AUDIO_PROVIDER` / `VIDEO_PROVIDER`
- * transport lands.
+ * It is descriptive, not a dispatch key. Which provider protocol an agent
+ * reaches is decided by the arm of its `config` discriminated union (an image
+ * configuration routes to `IMAGE_PROVIDER`, a coding-agent configuration to
+ * `AGENT_CLIENT_PROTOCOL`, anything else to the `LLM_PROVIDER` path). An
+ * agent's `outputModality` is not read on that path.
+ *
+ * IMAGE is wired (gpt-image logo generation). AUDIO and VIDEO are RESERVED and
+ * no provider serves either. Nothing refuses them by modality: the
+ * configuration union simply has no audio or video arm, so an agent that would
+ * produce one cannot be declared. Adding such an arm therefore means adding the
+ * `AUDIO_PROVIDER` / `VIDEO_PROVIDER` transport in the same change, or the new
+ * arm reaches the LLM path and is answered by the wrong protocol.
  */
 export var FlowsActors_IO_PartKind;
 (function (FlowsActors_IO_PartKind) {

package/dist/esm/flows-actors/flows-actors.io.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"flows-actors.io.shared.schemas.js","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.io.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\n\n\n//===============================================================\n//  Artifact\n// --------\n// Artifacts are outputs generated by steps during task execution,\n// including text, files, structured data, and binary content.\n// They provide persistent storage for intermediate and final results,\n// enabling data flow between steps, audit trails, and retrieval\n// of generated content across workflow executions.\n//===============================================================\n\n/**\n * The artifact MODALITY axis — the single vocabulary the actor-agent system\n * uses to describe what an operation consumes and produces. An agent's\n * `operationDefinition.outputModality` names its produced modality; the\n * executor resolves that modality to a provider protocol (TEXT/STRUCTURED →\n * `LLM_PROVIDER`, IMAGE → `IMAGE_PROVIDER`, CODING → `AGENT_CLIENT_PROTOCOL`, …).\n *\n * IMAGE is wired (gpt-image logo generation). AUDIO and VIDEO are RESERVED —\n * the modality is declarable but no provider serves it and the executor\n * fail-closes (NOT_IMPLEMENTED) until an `AUDIO_PROVIDER` / `VIDEO_PROVIDER`\n * transport lands.\n */\nexport enum FlowsActors_IO_PartKind {\n  TEXT = \"text\",\n  FILE = \"file\",\n  RAW_DATA = \"raw_data\",\n  STRUCTURED = \"structured\",\n  /** Generated image bytes (text-to-image). Wired via `IMAGE_PROVIDER`. */\n  IMAGE = \"image\",\n  /** RESERVED — generated audio. No transport yet; executor fail-closes. */\n  AUDIO = \"audio\",\n  /** RESERVED — generated video. No transport yet; executor fail-closes. */\n  VIDEO = \"video\",\n}\n\n\n\nconst _ArtifactDefinitionSchema = z.object({\n  type: z.enum(FlowsActors_IO_PartKind),\n  ref: z.string(),\n  displayName: z.string(),\n  description: z.string().optional(),\n  specs: z.any()\n});\n\nexport const ArtifactDefinitionSchema: typeof _ArtifactDefinitionSchema = _ArtifactDefinitionSchema;\nexport type ArtifactDefinition = z.infer<typeof _ArtifactDefinitionSchema>;\n\nconst _ArtifactInstance_ContentBaseSchema = z.object({\n  mimeType: z.string().optional(),\n  size: z.number().optional(),\n  checksum: z.string().optional(),\n});\n\nexport const ArtifactInstance_ContentBaseSchema: typeof _ArtifactInstance_ContentBaseSchema = _ArtifactInstance_ContentBaseSchema;\nexport type ArtifactInstance_ContentBase = z.infer<typeof _ArtifactInstance_ContentBaseSchema>;\n\nconst _ArtifactInstance_BaseSchema = z.object({\n  ref: z.string(),\n  definitionRef: z.string().optional(),\n  type: z.enum(FlowsActors_IO_PartKind),\n  name: z.string(),\n  description: z.string().optional(),\n  origin : z.object({\n    taskId: z.string().optional(),\n    stepId: z.string().optional(),\n  }),\n  \n \n  content: z.any(),\n  \n  createdAt: z.string(),\n  metadata: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport const ArtifactInstance_BaseSchema: typeof _ArtifactInstance_BaseSchema = _ArtifactInstance_BaseSchema;\nexport type ArtifactInstance_Base = z.infer<typeof _ArtifactInstance_BaseSchema>;\n\n\nconst _ArtifactInstanceSchema = z.discriminatedUnion(\"type\", [\n  _ArtifactInstance_BaseSchema.extend({ \n    type: z.literal(FlowsActors_IO_PartKind.TEXT), \n    content: _ArtifactInstance_ContentBaseSchema.extend({ \n      text: z.string() \n    }) \n  }),\n  _ArtifactInstance_BaseSchema.extend({ \n    type: z.literal(FlowsActors_IO_PartKind.FILE), \n    content: _ArtifactInstance_ContentBaseSchema.extend({ \n      storage: z.object({ data: z.string().optional(), url: z.string().optional(), path: z.string().optional() }) \n    }) \n  }),\n  _ArtifactInstance_BaseSchema.extend({ \n    type: z.literal(FlowsActors_IO_PartKind.RAW_DATA), \n    content: _ArtifactInstance_ContentBaseSchema.extend({ \n      // Artifact instances are durable/client-visible values, so they carry only\n      // the produced data. The executable Zod contract that validated the value\n      // remains in the runtime invocation contract, identified there by schema\n      // ref + digest; embedding a Zod instance here would neither serialize nor\n      // have an OpenAPI representation.\n      data: z.any(),\n    }) \n  }),\n  _ArtifactInstance_BaseSchema.extend({\n    type: z.literal(FlowsActors_IO_PartKind.STRUCTURED),\n    content: _ArtifactInstance_ContentBaseSchema.extend({\n      // Keep this branch symmetrical with RAW_DATA: validation authority is a\n      // runtime contract, while the persisted artifact is the validated value.\n      data: z.any(),\n    })\n  }),\n  _ArtifactInstance_BaseSchema.extend({\n    type: z.literal(FlowsActors_IO_PartKind.IMAGE),\n    content: _ArtifactInstance_ContentBaseSchema.extend({\n      // Same storage triad as FILE — a generated image is a file whose\n      // modality carries pixel dimensions worth surfacing without fetching.\n      storage: z.object({ data: z.string().optional(), url: z.string().optional(), path: z.string().optional() }),\n      width: z.number().int().positive().optional(),\n      height: z.number().int().positive().optional(),\n    })\n  }),\n]);\n\nexport const ArtifactInstanceSchema: typeof _ArtifactInstanceSchema = _ArtifactInstanceSchema;\nexport type ArtifactInstance = z.infer<typeof _ArtifactInstanceSchema>;\n"]}
+{"version":3,"file":"flows-actors.io.shared.schemas.js","sourceRoot":"","sources":["../../../src/flows-actors/flows-actors.io.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\n\n\n//===============================================================\n//  Artifact\n// --------\n// Artifacts are outputs generated by steps during task execution,\n// including text, files, structured data, and binary content.\n// They provide persistent storage for intermediate and final results,\n// enabling data flow between steps, audit trails, and retrieval\n// of generated content across workflow executions.\n//===============================================================\n\n/**\n * The artifact MODALITY axis: the single vocabulary the actor-agent system\n * uses to DESCRIBE what an operation consumes and produces.\n *\n * It is descriptive, not a dispatch key. Which provider protocol an agent\n * reaches is decided by the arm of its `config` discriminated union (an image\n * configuration routes to `IMAGE_PROVIDER`, a coding-agent configuration to\n * `AGENT_CLIENT_PROTOCOL`, anything else to the `LLM_PROVIDER` path). An\n * agent's `outputModality` is not read on that path.\n *\n * IMAGE is wired (gpt-image logo generation). AUDIO and VIDEO are RESERVED and\n * no provider serves either. Nothing refuses them by modality: the\n * configuration union simply has no audio or video arm, so an agent that would\n * produce one cannot be declared. Adding such an arm therefore means adding the\n * `AUDIO_PROVIDER` / `VIDEO_PROVIDER` transport in the same change, or the new\n * arm reaches the LLM path and is answered by the wrong protocol.\n */\nexport enum FlowsActors_IO_PartKind {\n  TEXT = \"text\",\n  FILE = \"file\",\n  RAW_DATA = \"raw_data\",\n  STRUCTURED = \"structured\",\n  /** Generated image bytes (text-to-image). Wired via `IMAGE_PROVIDER`. */\n  IMAGE = \"image\",\n  /** RESERVED — generated audio. No transport yet; executor fail-closes. */\n  AUDIO = \"audio\",\n  /** RESERVED — generated video. No transport yet; executor fail-closes. */\n  VIDEO = \"video\",\n}\n\n\n\nconst _ArtifactDefinitionSchema = z.object({\n  type: z.enum(FlowsActors_IO_PartKind),\n  ref: z.string(),\n  displayName: z.string(),\n  description: z.string().optional(),\n  specs: z.any()\n});\n\nexport const ArtifactDefinitionSchema: typeof _ArtifactDefinitionSchema = _ArtifactDefinitionSchema;\nexport type ArtifactDefinition = z.infer<typeof _ArtifactDefinitionSchema>;\n\nconst _ArtifactInstance_ContentBaseSchema = z.object({\n  mimeType: z.string().optional(),\n  size: z.number().optional(),\n  checksum: z.string().optional(),\n});\n\nexport const ArtifactInstance_ContentBaseSchema: typeof _ArtifactInstance_ContentBaseSchema = _ArtifactInstance_ContentBaseSchema;\nexport type ArtifactInstance_ContentBase = z.infer<typeof _ArtifactInstance_ContentBaseSchema>;\n\nconst _ArtifactInstance_BaseSchema = z.object({\n  ref: z.string(),\n  definitionRef: z.string().optional(),\n  type: z.enum(FlowsActors_IO_PartKind),\n  name: z.string(),\n  description: z.string().optional(),\n  origin : z.object({\n    taskId: z.string().optional(),\n    stepId: z.string().optional(),\n  }),\n  \n \n  content: z.any(),\n  \n  createdAt: z.string(),\n  metadata: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport const ArtifactInstance_BaseSchema: typeof _ArtifactInstance_BaseSchema = _ArtifactInstance_BaseSchema;\nexport type ArtifactInstance_Base = z.infer<typeof _ArtifactInstance_BaseSchema>;\n\n\nconst _ArtifactInstanceSchema = z.discriminatedUnion(\"type\", [\n  _ArtifactInstance_BaseSchema.extend({ \n    type: z.literal(FlowsActors_IO_PartKind.TEXT), \n    content: _ArtifactInstance_ContentBaseSchema.extend({ \n      text: z.string() \n    }) \n  }),\n  _ArtifactInstance_BaseSchema.extend({ \n    type: z.literal(FlowsActors_IO_PartKind.FILE), \n    content: _ArtifactInstance_ContentBaseSchema.extend({ \n      storage: z.object({ data: z.string().optional(), url: z.string().optional(), path: z.string().optional() }) \n    }) \n  }),\n  _ArtifactInstance_BaseSchema.extend({ \n    type: z.literal(FlowsActors_IO_PartKind.RAW_DATA), \n    content: _ArtifactInstance_ContentBaseSchema.extend({ \n      // Artifact instances are durable/client-visible values, so they carry only\n      // the produced data. The executable Zod contract that validated the value\n      // remains in the runtime invocation contract, identified there by schema\n      // ref + digest; embedding a Zod instance here would neither serialize nor\n      // have an OpenAPI representation.\n      data: z.any(),\n    }) \n  }),\n  _ArtifactInstance_BaseSchema.extend({\n    type: z.literal(FlowsActors_IO_PartKind.STRUCTURED),\n    content: _ArtifactInstance_ContentBaseSchema.extend({\n      // Keep this branch symmetrical with RAW_DATA: validation authority is a\n      // runtime contract, while the persisted artifact is the validated value.\n      data: z.any(),\n    })\n  }),\n  _ArtifactInstance_BaseSchema.extend({\n    type: z.literal(FlowsActors_IO_PartKind.IMAGE),\n    content: _ArtifactInstance_ContentBaseSchema.extend({\n      // Same storage triad as FILE — a generated image is a file whose\n      // modality carries pixel dimensions worth surfacing without fetching.\n      storage: z.object({ data: z.string().optional(), url: z.string().optional(), path: z.string().optional() }),\n      width: z.number().int().positive().optional(),\n      height: z.number().int().positive().optional(),\n    })\n  }),\n]);\n\nexport const ArtifactInstanceSchema: typeof _ArtifactInstanceSchema = _ArtifactInstanceSchema;\nexport type ArtifactInstance = z.infer<typeof _ArtifactInstanceSchema>;\n"]}

package/dist/esm/flows-actors/flows-actors.system.shared.definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flows-actors.system.shared.definitions.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.system.shared.definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAgBzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,UAAU,CAAC"}
+{"version":3,"file":"flows-actors.system.shared.definitions.d.ts","sourceRoot":"","sources":["../../../src/flows-actors/flows-actors.system.shared.definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAgBzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,UAAU,CAAC"}

package/dist/esm/flows-actors/flows-actors.system.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flows-actors.system.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.system.shared.schemas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAiC,iCAAiC,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAyB7I,oBAAY,oBAAoB;IAC9B,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED,oBAAY,sBAAsB;IAChC,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,QAAQ,aAAa;CACtB;AAED,oBAAY,0BAA0B;IACpC,YAAY,iBAAiB;IAC7B,QAAQ,aAAa;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoBrC,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAQ9E,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAS7C,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE7F,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;iBAe1C,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC"}
+{"version":3,"file":"flows-actors.system.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/flows-actors/flows-actors.system.shared.schemas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAiC,iCAAiC,EAAE,kBAAkB,EAA6B,MAAM,uCAAuC,CAAC;AAyBxK,oBAAY,oBAAoB;IAC9B,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED,oBAAY,sBAAsB;IAChC,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,QAAQ,aAAa;CACtB;AAED,oBAAY,0BAA0B;IACpC,YAAY,iBAAiB;IAC7B,QAAQ,aAAa;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoBrC,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAQ9E,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAS7C,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE7F,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;iBAgB1C,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC"}

package/dist/esm/flows-actors/flows-actors.system.shared.schemas.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { FlowsActors_Configuration_Schema } from './flows-actors.configuration.shared.schemas.js';
-import { FlowsActors_Checkpoint_Schema, FlowsActors_CircuitBreaker_Status, FlowsActors_Status } from './flows-actors.commons.shared.schemas.js';
+import { FlowsActors_Checkpoint_Schema, FlowsActors_CircuitBreaker_Status, FlowsActors_Status, describeFlowsActorsStatus } from './flows-actors.commons.shared.schemas.js';
 import { WildoError_BackendSchema } from '../errors/errors.shared.schemas.js';
 import { ExecutionContext_InitiatorIdsSchema } from '../runtime/execution-context.shared.schemas.js';
 //===============================================================
@@ -93,7 +93,8 @@ export const FlowActorSystem_ExecutionSchema = z.object({
     status: z.enum(FlowsActors_Status),
     initiator: ExecutionContext_InitiatorIdsSchema.optional(),
     statusChanges: z.array(z.object({
-        status: z.enum(FlowsActors_Status),
+        status: z.enum(FlowsActors_Status)
+            .describe(describeFlowsActorsStatus("The state this run moved into at `timestamp`. The list is the run's history, oldest first.")),
         timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),
     })),
     createdAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),