@wildo-ai/saas-models 1.1.4 → 1.1.6

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

@@ -32,7 +32,10 @@
  */
 import { z } from 'zod';
 import { initZodDecorators, addImpersonalizeWith } from '@wildo-ai/zod-decorators';
-import { FlowsActors_Status } from './flows-actors.commons.shared.schemas.js';
+import { FlowsActors_InitiationKind, FlowsActors_Status, describeFlowsActorsStatus } from './flows-actors.commons.shared.schemas.js';
+import { HumanDecision_Outcome, HumanDecision_RequesterKind, HumanDecision_RouteKind, ReviewClockBasis } from './human-decision.shared.schemas.js';
+import { AutonomousPrincipalSource, AutonomousTurnTrigger } from './autonomous-agents.shared.schemas.js';
+import { WorkUnitRefSchema } from '../resources/work-unit.shared.schemas.js';
 import { DataPortabilityProvenance } from '../compliance/privacy/subject-export.shared.schemas.js';
 import { PersonalDataCategory } from '../compliance/privacy/personal-data-category.shared.schemas.js';
 import { FlowActorSystem_Kind } from './flows-actors.system.shared.schemas.js';
@@ -71,7 +74,7 @@ export var FlowsActors_MessageContentType;
 })(FlowsActors_MessageContentType || (FlowsActors_MessageContentType = {}));
 export const FlowActorExecution_MessageSchema = z.object({
     /** Stable per-message id (client-correlatable across stream deltas). */
-    id: z.uuid(),
+    id: z.uuid().describe("The message's id (a UUID). For an agent reply it is the same `messageId` the live stream used, so a streamed reply can be matched to the stored one."),
     role: z.enum(FlowsActors_ConversationRole)
         .describe('Who produced this message.\n\nValues:\n'
         + '- `user`: the person, or the client acting for them.\n'
@@ -85,7 +88,7 @@ export const FlowActorExecution_MessageSchema = z.object({
         + '- `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(),
+    content: z.string().describe('The text of the message, rendered as `contentType` says. An agent reply is the full text assembled from what was streamed.'),
     /** Structured payload for `DATA`/`PROGRESS` messages (tool results, progress). */
     data: z.record(z.string(), z.unknown()).optional(),
     createdAt: z.date().default(() => new Date()),
@@ -135,8 +138,12 @@ export const FlowActorExecution_PausedApprovalSchema = z.object({
      * 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.
+     * names for it. Nothing new was invented. Two producers write it and both read "lapsed" from
+     * {@link isFlowActorPausedApprovalLapsed}: the refusal of a decision that arrives too late, and the
+     * scheduled sweep that fails a pause nobody answered (#484), every minute since gates declare their own lapse (#1628).
+     *
+     * (That vocabulary's doc used to say a DENIAL was terminal too. It is not — a denial resumes the
+     * turn so the model can answer the refusal — and the doc was corrected in the same change.)
      *
      * 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.
@@ -152,9 +159,10 @@ export const FlowActorExecution_PausedApprovalSchema = z.object({
  * 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.
+ * The DEFAULT, not a fixed rule: since #1628 a gate may declare its own lapse
+ * (`humanApproval.deadlines.lapseAfter`, always elapsed time), and this is what a gate declaring none
+ * gets. The gate is the right owner — how long "do you approve deleting this customer?" stays
+ * meaningful depends on the action, not on the application.
  */
 export const FLOW_ACTOR_APPROVAL_DEFAULT_TIMEOUT_MS = 24 * 60 * 60 * 1000;
 /** Serialize paused-approval state for the scalar `pausedApproval` string column. */
@@ -169,6 +177,31 @@ export function serializeFlowActorPausedApproval(state) {
 export function parseFlowActorPausedApproval(raw) {
     return FlowActorExecution_PausedApprovalSchema.parse(JSON.parse(raw));
 }
+/**
+ * Whether a paused turn's approval window has CLOSED at `now` — the ONE definition of "lapsed".
+ *
+ * Two consumers act on it and neither may re-derive it (#484): the approval-response path, which
+ * refuses a decision that arrives too late, and the scheduled sweep that fails a pause nobody ever
+ * answered. Written twice, they would drift at exactly the boundary that matters — one inclusive,
+ * one exclusive — and a decision arriving on the instant would be refused by one and resumed by the
+ * other.
+ *
+ * - **Inclusive at the instant.** `expiresAt` is the moment after which the turn "must not be
+ *   resumed", so at `expiresAt` itself the window is already closed.
+ * - **An absent expiry never lapses.** A suspension persisted before #465 carries none, and those
+ *   turns were paused under a contract with no timeout. Inventing one retroactively would fail them
+ *   on a rule they were never given.
+ * - **An unparseable instant never lapses.** `new Date('garbage')` is `NaN`, every comparison with
+ *   which is false. Failing a turn on a value nobody can read would turn a corrupted field into a
+ *   destroyed conversation; leaving it paused keeps it recoverable, and the resume path already
+ *   refuses a blob it cannot parse.
+ */
+export function isFlowActorPausedApprovalLapsed(paused, now) {
+    if (paused.expiresAt === undefined)
+        return false;
+    const expiresAtMs = new Date(paused.expiresAt).getTime();
+    return Number.isFinite(expiresAtMs) && expiresAtMs <= now.getTime();
+}
 //===============================================================
 //  Per-kind execution state (reused from the shared execution types)
 //===============================================================
@@ -177,7 +210,7 @@ export function parseFlowActorPausedApproval(raw) {
 // per-kind graph-state slots (`flowState` node-states / `actorState` plan+tasks,
 // sliced from `FlowSystem_Execution` / `ActorSystem_Execution`) are intentionally
 // NOT persisted yet: the v1 conversational runtime never writes them, and those
-// heavy nested sub-structures (required `plan`/`walkthrough`/`standaloneTasks`
+// heavy nested sub-structures (required `plan`/`standaloneTasks`
 // with embedded `_id`s) do not round-trip through the Zod→Mongoose embedded-
 // subdocument conversion as optional slots (empty subdocs get instantiated and
 // fail required-path validation). When the flow/actor orchestration runtime
@@ -239,10 +272,24 @@ export const FlowActorExecutionBaseSchema = z.object({
      * principal there and the `userId` owner FK already discriminates.
      */
     machineCredentialId: z.string().min(1).isDBIndexed(),
+    /**
+     * WHICH context this conversation was opened in — the client's `contextResourceIdentifiers` on
+     * `FLOWS_ACTORS_START`, folded into one indexed string by {@link canonicalizeFlowsActorsContextRef}
+     * so history can list by it with plain equality on every adapter. Set on create, immutable.
+     *
+     * It is a PARTITION, not an access filter: the owner FK, the agent instance and the machine
+     * credential above decide who may read a row; this decides which of a caller's own threads belong
+     * to the surface asking. Without it every thread a user ever opened against a system lists
+     * together, whatever it was about — measured 2026-09-22 on a tool that hosts one system for
+     * several applications sharing one database, where the threads of one application appeared in
+     * the next (#1454). `''` is "no context", never absent, so the equality filter can name it.
+     */
+    contextRef: z.string().isDBIndexed().excludeFromUpdate().default(''),
     status: z.enum(FlowsActors_Status).isDBIndexed().isSummaryField(),
     statusChanges: z.array(z.object({
-        status: z.enum(FlowsActors_Status),
-        timestamp: z.date(),
+        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.date().describe('When the run moved into `status`.'),
     })).default([]),
     // === Conversational log (chat history) ===
     /**
@@ -312,6 +359,146 @@ export const FlowActorExecutionBaseSchema = z.object({
     // runtime continuation state, not conversation content: generic client reads,
     // summaries and generated API schemas must never disclose it.
     pausedApproval: z.string().nullish().excludeFromCreate().isBackendOnly(),
+    /** Which door opened the turn (#1594). Set on create by the backend; absent on rows older than the column. */
+    initiationKind: z.enum(FlowsActors_InitiationKind).systemEnum('FlowsActors_InitiationKind').isBackendOnly().nullish(),
+    // === Autonomous turn (#1611) ===
+    //
+    // Written on CREATE by the autonomous entry point (`startAutonomousAgentTurn`) and by nothing else,
+    // and never updated: a turn keeps the agent, trigger and principal source it was opened with for its
+    // whole life, including after a reviewer's decision resumes it.
+    /**
+     * The declared autonomous agent this turn runs as. The resume re-resolves the machine principal from
+     * it (with the row's organization), so a binding removed while a decision waits stops the work.
+     */
+    autonomousAgentRef: z.string().min(1).isDBIndexed().excludeFromUpdate().optional(),
+    /** What started the turn. An INBOUND_DELIVERY turn is offered only read or reviewer-gated tools, for its whole life. */
+    autonomousTrigger: z.enum(AutonomousTurnTrigger).systemEnum('AutonomousTurnTrigger').excludeFromUpdate().optional(),
+    /** Where the machine principal came from when the turn started: the tenant's own client, or a firm's admitted one. */
+    autonomousPrincipalSource: z.enum(AutonomousPrincipalSource).systemEnum('AutonomousPrincipalSource').excludeFromUpdate().optional(),
+    /**
+     * The case the turn works on (#1598 attributes its model calls to it). Accepted at start only when the
+     * turn's own principal can READ that row.
+     */
+    caseRef: WorkUnitRefSchema.excludeFromUpdate().optional(),
+    /**
+     * The concurrency slot of a `SKIP_IF_ACTIVE` agent: `<agentRef>|<organizationId>` while the turn is
+     * active, absent otherwise. The unique index is what makes a second active turn's CREATE fail, which the
+     * entry point turns into a skip — the check is the store's, so two occurrences arriving at once cannot
+     * both see "none active".
+     *
+     * Released by the entry point, not by every terminal write: a terminal row still holding its key is
+     * reclaimed with a compare-and-swap (on the key AND a terminal status) the next time the slot is
+     * wanted. So a turn ended by a sweep, a lapse or an escalation lane needs no knowledge of the slot, and
+     * a live turn's key can never be taken. `.optional()` (not nullish) so a clear REMOVES the field: a
+     * stored null would be indexed by MongoDB's sparse index and collide with the next clear.
+     */
+    autonomousActiveSlotKey: z.string().min(1).isUnique({ scope: 'global', sparse: true }).isBackendOnly().optional(),
+    // === Pending human decision (#1594) ===
+    //
+    // Real COLUMNS, on the row that holds the resume compare-and-swap, never in a second store: #1360
+    // measured what a store beside the row costs (a second handle, drift, and a two-row write with no
+    // transaction, which lets a reassignment and an answer both win). Present only while `status` is
+    // AWAITING_APPROVAL; cleared by the CAS that releases the pause. All backend-only: the route says who
+    // may answer, and listing it to a generic reader would reveal that a decision exists.
+    //
+    // DEVIATION from the issue's column list, deliberately: it named a `pendingDecisionRole` beside
+    // `pendingDecisionEligibleRole`. For a ROLE route the route's role IS the eligible role, and a claimed
+    // decision recovers its role from `pendingDecisionClaimedAt` plus the unchanged eligible role — so a
+    // second column could only ever hold a copy that drifts.
+    /** The one decision id, shared by both planes and every audit row (`HumanDecision_Request.decisionId`). Minted by the engine at pause. */
+    pendingDecisionRef: z.string().min(1).isUnique({ scope: 'global', sparse: true }).isBackendOnly().nullish(),
+    pendingDecisionRouteKind: z.enum(HumanDecision_RouteKind).systemEnum('HumanDecision_RouteKind').isDBIndexed().isBackendOnly().nullish(),
+    /** The role every holder must meet (ROLE and ASSIGNEE). The listing's role filter. */
+    pendingDecisionEligibleRole: z.string().min(1).isDBIndexed().isBackendOnly().nullish(),
+    /** The organization the role is matched in. The listing's organization filter. */
+    pendingDecisionOrganizationId: z.string().min(1).isDBIndexed().isBackendOnly().nullish(),
+    /** Stamped from the requester's unit scope, so a unit-scoped holder can be matched (#1597). */
+    pendingDecisionOrganizationUnitId: z.string().min(1).isBackendOnly().nullish(),
+    /** ASSIGNEE only. The listing's "assigned to me" filter. */
+    pendingDecisionAssigneeUserId: z.string().min(1).isDBIndexed().isBackendOnly().nullish(),
+    /** Set when an ASSIGNEE route came from claiming a ROLE route; UNCLAIM restores ROLE. */
+    pendingDecisionClaimedAt: z.date().isBackendOnly().nullish(),
+    pendingDecisionRequesterKind: z.enum(HumanDecision_RequesterKind).systemEnum('HumanDecision_RequesterKind').isBackendOnly().nullish(),
+    /** The user id for USER and DELEGATED_CLIENT; the credential id for MACHINE. What the resume rebuilds authority from. */
+    pendingDecisionRequesterRef: z.string().min(1).isBackendOnly().nullish(),
+    /** DELEGATED_CLIENT only: the client the person delegated to, re-checked at resume. */
+    pendingDecisionRequesterClientId: z.string().min(1).isBackendOnly().nullish(),
+    pendingDecisionRequestedAt: z.date().isBackendOnly().nullish(),
+    /** When answering is refused. The expiry sweep selects on this column instead of parsing every blob. */
+    pendingDecisionExpiresAt: z.date().isDBIndexed().isBackendOnly().nullish(),
+    /** Incremented by every reassign, claim, unclaim and escalate; the answer's release CAS includes it, so an answer read under an older route loses. */
+    pendingDecisionRouteVersion: z.number().int().nonnegative().isBackendOnly().nullish(),
+    // === Pending decision deadlines (#1628) ===
+    //
+    // The two SERVICE-TARGET clocks (CLAIM, DECISION) beside the lapse above, armed at pause from the gate's
+    // `humanApproval.deadlines`. Each stage's due instant is stored, so the sweep never depends on the gate
+    // still resolving and a deployment never reshapes a running clock. Cleared with the rest of the pending
+    // decision. Backend-only, like the route.
+    //
+    // DEVIATION from #1628's column list, deliberately: it named the two deadlines and the next-due instant.
+    // The two WARNING instants and the two clock bases are stored too — a warning is `warnBefore` earlier on
+    // its own basis, and a resume must count the paused time on that basis; recomputing either would read the
+    // gate again, which is exactly the dependency storing the deadlines avoids.
+    pendingDecisionClaimDeadlineAt: z.date().isBackendOnly().nullish(),
+    /** Armed only when the gate's `claim.warnBefore` is declared. */
+    pendingDecisionClaimWarningAt: z.date().isBackendOnly().nullish(),
+    pendingDecisionClaimClockBasis: z.enum(ReviewClockBasis).systemEnum('ReviewClockBasis').isBackendOnly().nullish(),
+    pendingDecisionDecisionDeadlineAt: z.date().isBackendOnly().nullish(),
+    /** Armed only when the gate's `decision.warnBefore` is declared. */
+    pendingDecisionDecisionWarningAt: z.date().isBackendOnly().nullish(),
+    pendingDecisionDecisionClockBasis: z.enum(ReviewClockBasis).systemEnum('ReviewClockBasis').isBackendOnly().nullish(),
+    /**
+     * The earliest instant a stage may still fire at; `null` while the clocks are paused and once nothing is
+     * left to fire. The deadline sweep selects on this indexed column. Every write that fires a stage, pauses,
+     * resumes, claims or unclaims recomputes it in the same statement.
+     */
+    pendingDecisionNextDueAt: z.date().isDBIndexed().isBackendOnly().nullish(),
+    /** Set while the CLAIM and DECISION clocks are paused. Never stops the lapse. */
+    pendingDecisionClockPausedAt: z.date().isBackendOnly().nullish(),
+    /** The gate-declared pause state the clocks are paused in. */
+    pendingDecisionClockPauseStateRef: z.string().min(1).isBackendOnly().nullish(),
+    /** Paused time accumulated over every completed pause, in milliseconds of wall time. */
+    pendingDecisionClockPausedMs: z.number().int().nonnegative().isBackendOnly().nullish(),
+    /*
+     * One fired marker per stage. Each is written by a compare-and-swap on `(pendingDecisionRef, <marker> IS
+     * NULL)`, so a stage fires once however many hosts run the sweep, and only the writer that won runs the
+     * stage's actions. Four nullable timestamps rather than one "fired stages" array: an add-if-absent array
+     * swap is expressed differently on MongoDB and PostgreSQL, a null check is the same predicate on both.
+     */
+    pendingDecisionClaimWarningFiredAt: z.date().isBackendOnly().nullish(),
+    pendingDecisionClaimMissedFiredAt: z.date().isBackendOnly().nullish(),
+    pendingDecisionDecisionWarningFiredAt: z.date().isBackendOnly().nullish(),
+    pendingDecisionDecisionMissedFiredAt: z.date().isBackendOnly().nullish(),
+    // === Last resolved decision (#1594) ===
+    //
+    // Written INSIDE the CAS that releases the pause, so a crash after it still leaves a complete record
+    // of who decided what — the record #1599's corrections repair from.
+    /** The decision these fields describe. Also what a failed release write is re-read against (D10). */
+    lastResolvedDecisionRef: z.string().min(1).isDBIndexed().isBackendOnly().nullish(),
+    /** Absent for a lapse and for a withdrawal nobody answered. */
+    decidedByUserId: z.string().min(1).isBackendOnly().nullish(),
+    decidedAt: z.date().isBackendOnly().nullish(),
+    decisionOutcome: z.enum(HumanDecision_Outcome).systemEnum('HumanDecision_Outcome').isBackendOnly().nullish(),
+    decisionToolName: z.string().min(1).isBackendOnly().nullish(),
+    /** The argument NAMES a decider changed. Never their values. */
+    decisionModifiedArgumentNames: z.array(z.string()).isBackendOnly().nullish(),
+    // === Agent-work review record (#1599): the crash-repair marker ===
+    /**
+     * The decision whose agent-work record is still OWED. Set by the very write that settles a decision on an agent's
+     * proposal (the release, a lapse, a withdrawal) — so a process that dies before the record is written leaves the
+     * debt on the row — and cleared by a compare-and-swap once the record exists. The repair sweep selects on it.
+     */
+    pendingCorrectionRecordRef: z.string().min(1).isDBIndexed().isBackendOnly().nullish(),
+    /** When the settled proposal was PUT BEFORE the decider (#1594's claim instant, else its request instant). */
+    pendingCorrectionPresentedAt: z.date().isBackendOnly().nullish(),
+    /**
+     * The organization the owed decision was ROUTED in. The settling write clears the route columns
+     * (`pendingDecisionOrganizationId`), so without this a repaired record of a user thread with no case would name no
+     * tenant and fall out of that organization's override rate and export.
+     */
+    pendingCorrectionOrganizationId: z.string().min(1).isBackendOnly().nullish(),
+    /** The route role that admitted the decider of the owed decision, cleared by the settle for the same reason. */
+    pendingCorrectionAdmittedByRole: z.string().min(1).isBackendOnly().nullish(),
     // === Timing (system-managed; defaults are load-bearing — the create pipeline
     //     strips these then date-coerces, so a missing default → Invalid Date) ===
     createdAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),
@@ -356,8 +543,17 @@ export const flowActorExecutionsPolymorphicDeclaration = declarePolymorphicSchem
  */
 export const FlowActorExecutionUpdateInternalSchema = z.object({
     status: FlowActorExecutionBaseSchema.shape.status.optional(),
-    statusChanges: FlowActorExecutionBaseSchema.shape.statusChanges.optional(),
-    messages: FlowActorExecutionBaseSchema.shape.messages.optional(),
+    /*
+     * `.unwrap()` takes each field's `.default([])` off, and it must stay off. Zod 4 applies an inner
+     * default under `.optional()`, so `{ status: FAILED }` parsed to `{ status, statusChanges: [],
+     * messages: [] }`, and every partial update of a row reset its transcript and status history.
+     * Measured 2026-09-25 on Wonder Todos: a turn cut off by a companion restart was settled FAILED and
+     * lost the creator's message, and the page read "Nothing has been said yet". The same held for the
+     * resume claim, the pause and the lapsed-approval fail. A default belongs to CREATE; an absent
+     * field on an update means "unchanged".
+     */
+    statusChanges: FlowActorExecutionBaseSchema.shape.statusChanges.unwrap().optional(),
+    messages: FlowActorExecutionBaseSchema.shape.messages.unwrap().optional(),
     finishedAt: FlowActorExecutionBaseSchema.shape.finishedAt,
     /**
      * The suspended-turn state, written when a turn pauses for a human decision and cleared when one
@@ -375,5 +571,65 @@ export const FlowActorExecutionUpdateInternalSchema = z.object({
      * would leave a resumed turn still advertising a decision nobody can answer.
      */
     pausedApproval: FlowActorExecutionBaseSchema.shape.pausedApproval.nullish(),
+    // #1594 — the pending decision and the last resolution. Allow-listed here for the reason above: a field
+    // missing from this contract is a write that succeeds and persists nothing.
+    initiationKind: FlowActorExecutionBaseSchema.shape.initiationKind,
+    // #1611 — the slot is released by the autonomous entry point; `null` removes it (see the field).
+    autonomousActiveSlotKey: FlowActorExecutionBaseSchema.shape.autonomousActiveSlotKey.nullable(),
+    pendingDecisionRef: FlowActorExecutionBaseSchema.shape.pendingDecisionRef,
+    pendingDecisionRouteKind: FlowActorExecutionBaseSchema.shape.pendingDecisionRouteKind,
+    pendingDecisionEligibleRole: FlowActorExecutionBaseSchema.shape.pendingDecisionEligibleRole,
+    pendingDecisionOrganizationId: FlowActorExecutionBaseSchema.shape.pendingDecisionOrganizationId,
+    pendingDecisionOrganizationUnitId: FlowActorExecutionBaseSchema.shape.pendingDecisionOrganizationUnitId,
+    pendingDecisionAssigneeUserId: FlowActorExecutionBaseSchema.shape.pendingDecisionAssigneeUserId,
+    pendingDecisionClaimedAt: FlowActorExecutionBaseSchema.shape.pendingDecisionClaimedAt,
+    pendingDecisionRequesterKind: FlowActorExecutionBaseSchema.shape.pendingDecisionRequesterKind,
+    pendingDecisionRequesterRef: FlowActorExecutionBaseSchema.shape.pendingDecisionRequesterRef,
+    pendingDecisionRequesterClientId: FlowActorExecutionBaseSchema.shape.pendingDecisionRequesterClientId,
+    pendingDecisionRequestedAt: FlowActorExecutionBaseSchema.shape.pendingDecisionRequestedAt,
+    pendingDecisionExpiresAt: FlowActorExecutionBaseSchema.shape.pendingDecisionExpiresAt,
+    pendingDecisionRouteVersion: FlowActorExecutionBaseSchema.shape.pendingDecisionRouteVersion,
+    // #1628 — the deadline clocks, allow-listed for the same reason.
+    pendingDecisionClaimDeadlineAt: FlowActorExecutionBaseSchema.shape.pendingDecisionClaimDeadlineAt,
+    pendingDecisionClaimWarningAt: FlowActorExecutionBaseSchema.shape.pendingDecisionClaimWarningAt,
+    pendingDecisionClaimClockBasis: FlowActorExecutionBaseSchema.shape.pendingDecisionClaimClockBasis,
+    pendingDecisionDecisionDeadlineAt: FlowActorExecutionBaseSchema.shape.pendingDecisionDecisionDeadlineAt,
+    pendingDecisionDecisionWarningAt: FlowActorExecutionBaseSchema.shape.pendingDecisionDecisionWarningAt,
+    pendingDecisionDecisionClockBasis: FlowActorExecutionBaseSchema.shape.pendingDecisionDecisionClockBasis,
+    pendingDecisionNextDueAt: FlowActorExecutionBaseSchema.shape.pendingDecisionNextDueAt,
+    pendingDecisionClockPausedAt: FlowActorExecutionBaseSchema.shape.pendingDecisionClockPausedAt,
+    pendingDecisionClockPauseStateRef: FlowActorExecutionBaseSchema.shape.pendingDecisionClockPauseStateRef,
+    pendingDecisionClockPausedMs: FlowActorExecutionBaseSchema.shape.pendingDecisionClockPausedMs,
+    pendingDecisionClaimWarningFiredAt: FlowActorExecutionBaseSchema.shape.pendingDecisionClaimWarningFiredAt,
+    pendingDecisionClaimMissedFiredAt: FlowActorExecutionBaseSchema.shape.pendingDecisionClaimMissedFiredAt,
+    pendingDecisionDecisionWarningFiredAt: FlowActorExecutionBaseSchema.shape.pendingDecisionDecisionWarningFiredAt,
+    pendingDecisionDecisionMissedFiredAt: FlowActorExecutionBaseSchema.shape.pendingDecisionDecisionMissedFiredAt,
+    lastResolvedDecisionRef: FlowActorExecutionBaseSchema.shape.lastResolvedDecisionRef,
+    decidedByUserId: FlowActorExecutionBaseSchema.shape.decidedByUserId,
+    decidedAt: FlowActorExecutionBaseSchema.shape.decidedAt,
+    decisionOutcome: FlowActorExecutionBaseSchema.shape.decisionOutcome,
+    decisionToolName: FlowActorExecutionBaseSchema.shape.decisionToolName,
+    decisionModifiedArgumentNames: FlowActorExecutionBaseSchema.shape.decisionModifiedArgumentNames,
+    // #1599 — the agent-work record the settlement owes; allow-listed for the reason above.
+    pendingCorrectionRecordRef: FlowActorExecutionBaseSchema.shape.pendingCorrectionRecordRef,
+    pendingCorrectionPresentedAt: FlowActorExecutionBaseSchema.shape.pendingCorrectionPresentedAt,
+    pendingCorrectionOrganizationId: FlowActorExecutionBaseSchema.shape.pendingCorrectionOrganizationId,
+    pendingCorrectionAdmittedByRole: FlowActorExecutionBaseSchema.shape.pendingCorrectionAdmittedByRole,
 });
+/**
+ * One string for a set of context resource identifiers — `key=value` pairs sorted by key, joined
+ * with `;`. Deterministic, so the transport that opens a conversation and the surface that lists
+ * history compute the same value from the same identifiers; `''` for none.
+ *
+ * Keys and values carry no `=` or `;` in practice (they are resource types and ids); the function
+ * does not escape, so a value that did would fold two contexts into one, never split one in two.
+ */
+export function canonicalizeFlowsActorsContextRef(identifiers) {
+    if (!identifiers)
+        return '';
+    return Object.keys(identifiers)
+        .sort()
+        .map((key) => `${key}=${identifiers[key]}`)
+        .join(';');
+}
 //# sourceMappingURL=flows-actors-execution.shared.schemas.js.map

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    .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"]}
+{"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_InitiationKind, FlowsActors_Status, describeFlowsActorsStatus } from './flows-actors.commons.shared.schemas';\nimport { HumanDecision_Outcome, HumanDecision_RequesterKind, HumanDecision_RouteKind, ReviewClockBasis } from './human-decision.shared.schemas';\nimport { AutonomousPrincipalSource, AutonomousTurnTrigger } from './autonomous-agents.shared.schemas';\nimport { WorkUnitRefSchema } from '../resources/work-unit.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().describe(\"The message's id (a UUID). For an agent reply it is the same `messageId` the live stream used, so a streamed reply can be matched to the stored one.\"),\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().describe('The text of the message, rendered as `contentType` says. An agent reply is the full text assembled from what was streamed.'),\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   * names for it. Nothing new was invented. Two producers write it and both read \"lapsed\" from\n   * {@link isFlowActorPausedApprovalLapsed}: the refusal of a decision that arrives too late, and the\n   * scheduled sweep that fails a pause nobody answered (#484), every minute since gates declare their own lapse (#1628).\n   *\n   * (That vocabulary's doc used to say a DENIAL was terminal too. It is not — a denial resumes the\n   * turn so the model can answer the refusal — and the doc was corrected in the same change.)\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 * The DEFAULT, not a fixed rule: since #1628 a gate may declare its own lapse\n * (`humanApproval.deadlines.lapseAfter`, always elapsed time), and this is what a gate declaring none\n * gets. The gate is the right owner — how long \"do you approve deleting this customer?\" stays\n * meaningful depends on the action, not on the application.\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 * Whether a paused turn's approval window has CLOSED at `now` — the ONE definition of \"lapsed\".\n *\n * Two consumers act on it and neither may re-derive it (#484): the approval-response path, which\n * refuses a decision that arrives too late, and the scheduled sweep that fails a pause nobody ever\n * answered. Written twice, they would drift at exactly the boundary that matters — one inclusive,\n * one exclusive — and a decision arriving on the instant would be refused by one and resumed by the\n * other.\n *\n * - **Inclusive at the instant.** `expiresAt` is the moment after which the turn \"must not be\n *   resumed\", so at `expiresAt` itself the window is already closed.\n * - **An absent expiry never lapses.** A suspension persisted before #465 carries none, and those\n *   turns were paused under a contract with no timeout. Inventing one retroactively would fail them\n *   on a rule they were never given.\n * - **An unparseable instant never lapses.** `new Date('garbage')` is `NaN`, every comparison with\n *   which is false. Failing a turn on a value nobody can read would turn a corrupted field into a\n *   destroyed conversation; leaving it paused keeps it recoverable, and the resume path already\n *   refuses a blob it cannot parse.\n */\nexport function isFlowActorPausedApprovalLapsed(paused: Pick<FlowActorExecution_PausedApproval, 'expiresAt'>, now: Date): boolean {\n  if (paused.expiresAt === undefined) return false;\n  const expiresAtMs = new Date(paused.expiresAt).getTime();\n  return Number.isFinite(expiresAtMs) && expiresAtMs <= now.getTime();\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`/`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  /**\n   * WHICH context this conversation was opened in — the client's `contextResourceIdentifiers` on\n   * `FLOWS_ACTORS_START`, folded into one indexed string by {@link canonicalizeFlowsActorsContextRef}\n   * so history can list by it with plain equality on every adapter. Set on create, immutable.\n   *\n   * It is a PARTITION, not an access filter: the owner FK, the agent instance and the machine\n   * credential above decide who may read a row; this decides which of a caller's own threads belong\n   * to the surface asking. Without it every thread a user ever opened against a system lists\n   * together, whatever it was about — measured 2026-09-22 on a tool that hosts one system for\n   * several applications sharing one database, where the threads of one application appeared in\n   * the next (#1454). `''` is \"no context\", never absent, so the equality filter can name it.\n   */\n  contextRef: z.string().isDBIndexed().excludeFromUpdate().default(''),\n\n  status: z.enum(FlowsActors_Status).isDBIndexed().isSummaryField(),\n  statusChanges: z.array(z.object({\n    status: z.enum(FlowsActors_Status)\n      .describe(describeFlowsActorsStatus(\"The state this run moved into at `timestamp`. The list is the run's history, oldest first.\")),\n    timestamp: z.date().describe('When the run moved into `status`.'),\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  /** Which door opened the turn (#1594). Set on create by the backend; absent on rows older than the column. */\n  initiationKind: z.enum(FlowsActors_InitiationKind).systemEnum('FlowsActors_InitiationKind').isBackendOnly().nullish(),\n\n  // === Autonomous turn (#1611) ===\n  //\n  // Written on CREATE by the autonomous entry point (`startAutonomousAgentTurn`) and by nothing else,\n  // and never updated: a turn keeps the agent, trigger and principal source it was opened with for its\n  // whole life, including after a reviewer's decision resumes it.\n\n  /**\n   * The declared autonomous agent this turn runs as. The resume re-resolves the machine principal from\n   * it (with the row's organization), so a binding removed while a decision waits stops the work.\n   */\n  autonomousAgentRef: z.string().min(1).isDBIndexed().excludeFromUpdate().optional(),\n  /** What started the turn. An INBOUND_DELIVERY turn is offered only read or reviewer-gated tools, for its whole life. */\n  autonomousTrigger: z.enum(AutonomousTurnTrigger).systemEnum('AutonomousTurnTrigger').excludeFromUpdate().optional(),\n  /** Where the machine principal came from when the turn started: the tenant's own client, or a firm's admitted one. */\n  autonomousPrincipalSource: z.enum(AutonomousPrincipalSource).systemEnum('AutonomousPrincipalSource').excludeFromUpdate().optional(),\n  /**\n   * The case the turn works on (#1598 attributes its model calls to it). Accepted at start only when the\n   * turn's own principal can READ that row.\n   */\n  caseRef: WorkUnitRefSchema.excludeFromUpdate().optional(),\n  /**\n   * The concurrency slot of a `SKIP_IF_ACTIVE` agent: `<agentRef>|<organizationId>` while the turn is\n   * active, absent otherwise. The unique index is what makes a second active turn's CREATE fail, which the\n   * entry point turns into a skip — the check is the store's, so two occurrences arriving at once cannot\n   * both see \"none active\".\n   *\n   * Released by the entry point, not by every terminal write: a terminal row still holding its key is\n   * reclaimed with a compare-and-swap (on the key AND a terminal status) the next time the slot is\n   * wanted. So a turn ended by a sweep, a lapse or an escalation lane needs no knowledge of the slot, and\n   * a live turn's key can never be taken. `.optional()` (not nullish) so a clear REMOVES the field: a\n   * stored null would be indexed by MongoDB's sparse index and collide with the next clear.\n   */\n  autonomousActiveSlotKey: z.string().min(1).isUnique({ scope: 'global', sparse: true }).isBackendOnly().optional(),\n\n  // === Pending human decision (#1594) ===\n  //\n  // Real COLUMNS, on the row that holds the resume compare-and-swap, never in a second store: #1360\n  // measured what a store beside the row costs (a second handle, drift, and a two-row write with no\n  // transaction, which lets a reassignment and an answer both win). Present only while `status` is\n  // AWAITING_APPROVAL; cleared by the CAS that releases the pause. All backend-only: the route says who\n  // may answer, and listing it to a generic reader would reveal that a decision exists.\n  //\n  // DEVIATION from the issue's column list, deliberately: it named a `pendingDecisionRole` beside\n  // `pendingDecisionEligibleRole`. For a ROLE route the route's role IS the eligible role, and a claimed\n  // decision recovers its role from `pendingDecisionClaimedAt` plus the unchanged eligible role — so a\n  // second column could only ever hold a copy that drifts.\n\n  /** The one decision id, shared by both planes and every audit row (`HumanDecision_Request.decisionId`). Minted by the engine at pause. */\n  pendingDecisionRef: z.string().min(1).isUnique({ scope: 'global', sparse: true }).isBackendOnly().nullish(),\n  pendingDecisionRouteKind: z.enum(HumanDecision_RouteKind).systemEnum('HumanDecision_RouteKind').isDBIndexed().isBackendOnly().nullish(),\n  /** The role every holder must meet (ROLE and ASSIGNEE). The listing's role filter. */\n  pendingDecisionEligibleRole: z.string().min(1).isDBIndexed().isBackendOnly().nullish(),\n  /** The organization the role is matched in. The listing's organization filter. */\n  pendingDecisionOrganizationId: z.string().min(1).isDBIndexed().isBackendOnly().nullish(),\n  /** Stamped from the requester's unit scope, so a unit-scoped holder can be matched (#1597). */\n  pendingDecisionOrganizationUnitId: z.string().min(1).isBackendOnly().nullish(),\n  /** ASSIGNEE only. The listing's \"assigned to me\" filter. */\n  pendingDecisionAssigneeUserId: z.string().min(1).isDBIndexed().isBackendOnly().nullish(),\n  /** Set when an ASSIGNEE route came from claiming a ROLE route; UNCLAIM restores ROLE. */\n  pendingDecisionClaimedAt: z.date().isBackendOnly().nullish(),\n  pendingDecisionRequesterKind: z.enum(HumanDecision_RequesterKind).systemEnum('HumanDecision_RequesterKind').isBackendOnly().nullish(),\n  /** The user id for USER and DELEGATED_CLIENT; the credential id for MACHINE. What the resume rebuilds authority from. */\n  pendingDecisionRequesterRef: z.string().min(1).isBackendOnly().nullish(),\n  /** DELEGATED_CLIENT only: the client the person delegated to, re-checked at resume. */\n  pendingDecisionRequesterClientId: z.string().min(1).isBackendOnly().nullish(),\n  pendingDecisionRequestedAt: z.date().isBackendOnly().nullish(),\n  /** When answering is refused. The expiry sweep selects on this column instead of parsing every blob. */\n  pendingDecisionExpiresAt: z.date().isDBIndexed().isBackendOnly().nullish(),\n  /** Incremented by every reassign, claim, unclaim and escalate; the answer's release CAS includes it, so an answer read under an older route loses. */\n  pendingDecisionRouteVersion: z.number().int().nonnegative().isBackendOnly().nullish(),\n\n  // === Pending decision deadlines (#1628) ===\n  //\n  // The two SERVICE-TARGET clocks (CLAIM, DECISION) beside the lapse above, armed at pause from the gate's\n  // `humanApproval.deadlines`. Each stage's due instant is stored, so the sweep never depends on the gate\n  // still resolving and a deployment never reshapes a running clock. Cleared with the rest of the pending\n  // decision. Backend-only, like the route.\n  //\n  // DEVIATION from #1628's column list, deliberately: it named the two deadlines and the next-due instant.\n  // The two WARNING instants and the two clock bases are stored too — a warning is `warnBefore` earlier on\n  // its own basis, and a resume must count the paused time on that basis; recomputing either would read the\n  // gate again, which is exactly the dependency storing the deadlines avoids.\n\n  pendingDecisionClaimDeadlineAt: z.date().isBackendOnly().nullish(),\n  /** Armed only when the gate's `claim.warnBefore` is declared. */\n  pendingDecisionClaimWarningAt: z.date().isBackendOnly().nullish(),\n  pendingDecisionClaimClockBasis: z.enum(ReviewClockBasis).systemEnum('ReviewClockBasis').isBackendOnly().nullish(),\n  pendingDecisionDecisionDeadlineAt: z.date().isBackendOnly().nullish(),\n  /** Armed only when the gate's `decision.warnBefore` is declared. */\n  pendingDecisionDecisionWarningAt: z.date().isBackendOnly().nullish(),\n  pendingDecisionDecisionClockBasis: z.enum(ReviewClockBasis).systemEnum('ReviewClockBasis').isBackendOnly().nullish(),\n  /**\n   * The earliest instant a stage may still fire at; `null` while the clocks are paused and once nothing is\n   * left to fire. The deadline sweep selects on this indexed column. Every write that fires a stage, pauses,\n   * resumes, claims or unclaims recomputes it in the same statement.\n   */\n  pendingDecisionNextDueAt: z.date().isDBIndexed().isBackendOnly().nullish(),\n  /** Set while the CLAIM and DECISION clocks are paused. Never stops the lapse. */\n  pendingDecisionClockPausedAt: z.date().isBackendOnly().nullish(),\n  /** The gate-declared pause state the clocks are paused in. */\n  pendingDecisionClockPauseStateRef: z.string().min(1).isBackendOnly().nullish(),\n  /** Paused time accumulated over every completed pause, in milliseconds of wall time. */\n  pendingDecisionClockPausedMs: z.number().int().nonnegative().isBackendOnly().nullish(),\n  /*\n   * One fired marker per stage. Each is written by a compare-and-swap on `(pendingDecisionRef, <marker> IS\n   * NULL)`, so a stage fires once however many hosts run the sweep, and only the writer that won runs the\n   * stage's actions. Four nullable timestamps rather than one \"fired stages\" array: an add-if-absent array\n   * swap is expressed differently on MongoDB and PostgreSQL, a null check is the same predicate on both.\n   */\n  pendingDecisionClaimWarningFiredAt: z.date().isBackendOnly().nullish(),\n  pendingDecisionClaimMissedFiredAt: z.date().isBackendOnly().nullish(),\n  pendingDecisionDecisionWarningFiredAt: z.date().isBackendOnly().nullish(),\n  pendingDecisionDecisionMissedFiredAt: z.date().isBackendOnly().nullish(),\n\n  // === Last resolved decision (#1594) ===\n  //\n  // Written INSIDE the CAS that releases the pause, so a crash after it still leaves a complete record\n  // of who decided what — the record #1599's corrections repair from.\n\n  /** The decision these fields describe. Also what a failed release write is re-read against (D10). */\n  lastResolvedDecisionRef: z.string().min(1).isDBIndexed().isBackendOnly().nullish(),\n  /** Absent for a lapse and for a withdrawal nobody answered. */\n  decidedByUserId: z.string().min(1).isBackendOnly().nullish(),\n  decidedAt: z.date().isBackendOnly().nullish(),\n  decisionOutcome: z.enum(HumanDecision_Outcome).systemEnum('HumanDecision_Outcome').isBackendOnly().nullish(),\n  decisionToolName: z.string().min(1).isBackendOnly().nullish(),\n  /** The argument NAMES a decider changed. Never their values. */\n  decisionModifiedArgumentNames: z.array(z.string()).isBackendOnly().nullish(),\n\n  // === Agent-work review record (#1599): the crash-repair marker ===\n  /**\n   * The decision whose agent-work record is still OWED. Set by the very write that settles a decision on an agent's\n   * proposal (the release, a lapse, a withdrawal) — so a process that dies before the record is written leaves the\n   * debt on the row — and cleared by a compare-and-swap once the record exists. The repair sweep selects on it.\n   */\n  pendingCorrectionRecordRef: z.string().min(1).isDBIndexed().isBackendOnly().nullish(),\n  /** When the settled proposal was PUT BEFORE the decider (#1594's claim instant, else its request instant). */\n  pendingCorrectionPresentedAt: z.date().isBackendOnly().nullish(),\n  /**\n   * The organization the owed decision was ROUTED in. The settling write clears the route columns\n   * (`pendingDecisionOrganizationId`), so without this a repaired record of a user thread with no case would name no\n   * tenant and fall out of that organization's override rate and export.\n   */\n  pendingCorrectionOrganizationId: z.string().min(1).isBackendOnly().nullish(),\n  /** The route role that admitted the decider of the owed decision, cleared by the settle for the same reason. */\n  pendingCorrectionAdmittedByRole: z.string().min(1).isBackendOnly().nullish(),\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  /*\n   * `.unwrap()` takes each field's `.default([])` off, and it must stay off. Zod 4 applies an inner\n   * default under `.optional()`, so `{ status: FAILED }` parsed to `{ status, statusChanges: [],\n   * messages: [] }`, and every partial update of a row reset its transcript and status history.\n   * Measured 2026-09-25 on Wonder Todos: a turn cut off by a companion restart was settled FAILED and\n   * lost the creator's message, and the page read \"Nothing has been said yet\". The same held for the\n   * resume claim, the pause and the lapsed-approval fail. A default belongs to CREATE; an absent\n   * field on an update means \"unchanged\".\n   */\n  statusChanges: FlowActorExecutionBaseSchema.shape.statusChanges.unwrap().optional(),\n  messages: FlowActorExecutionBaseSchema.shape.messages.unwrap().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  // #1594 — the pending decision and the last resolution. Allow-listed here for the reason above: a field\n  // missing from this contract is a write that succeeds and persists nothing.\n  initiationKind: FlowActorExecutionBaseSchema.shape.initiationKind,\n  // #1611 — the slot is released by the autonomous entry point; `null` removes it (see the field).\n  autonomousActiveSlotKey: FlowActorExecutionBaseSchema.shape.autonomousActiveSlotKey.nullable(),\n  pendingDecisionRef: FlowActorExecutionBaseSchema.shape.pendingDecisionRef,\n  pendingDecisionRouteKind: FlowActorExecutionBaseSchema.shape.pendingDecisionRouteKind,\n  pendingDecisionEligibleRole: FlowActorExecutionBaseSchema.shape.pendingDecisionEligibleRole,\n  pendingDecisionOrganizationId: FlowActorExecutionBaseSchema.shape.pendingDecisionOrganizationId,\n  pendingDecisionOrganizationUnitId: FlowActorExecutionBaseSchema.shape.pendingDecisionOrganizationUnitId,\n  pendingDecisionAssigneeUserId: FlowActorExecutionBaseSchema.shape.pendingDecisionAssigneeUserId,\n  pendingDecisionClaimedAt: FlowActorExecutionBaseSchema.shape.pendingDecisionClaimedAt,\n  pendingDecisionRequesterKind: FlowActorExecutionBaseSchema.shape.pendingDecisionRequesterKind,\n  pendingDecisionRequesterRef: FlowActorExecutionBaseSchema.shape.pendingDecisionRequesterRef,\n  pendingDecisionRequesterClientId: FlowActorExecutionBaseSchema.shape.pendingDecisionRequesterClientId,\n  pendingDecisionRequestedAt: FlowActorExecutionBaseSchema.shape.pendingDecisionRequestedAt,\n  pendingDecisionExpiresAt: FlowActorExecutionBaseSchema.shape.pendingDecisionExpiresAt,\n  pendingDecisionRouteVersion: FlowActorExecutionBaseSchema.shape.pendingDecisionRouteVersion,\n  // #1628 — the deadline clocks, allow-listed for the same reason.\n  pendingDecisionClaimDeadlineAt: FlowActorExecutionBaseSchema.shape.pendingDecisionClaimDeadlineAt,\n  pendingDecisionClaimWarningAt: FlowActorExecutionBaseSchema.shape.pendingDecisionClaimWarningAt,\n  pendingDecisionClaimClockBasis: FlowActorExecutionBaseSchema.shape.pendingDecisionClaimClockBasis,\n  pendingDecisionDecisionDeadlineAt: FlowActorExecutionBaseSchema.shape.pendingDecisionDecisionDeadlineAt,\n  pendingDecisionDecisionWarningAt: FlowActorExecutionBaseSchema.shape.pendingDecisionDecisionWarningAt,\n  pendingDecisionDecisionClockBasis: FlowActorExecutionBaseSchema.shape.pendingDecisionDecisionClockBasis,\n  pendingDecisionNextDueAt: FlowActorExecutionBaseSchema.shape.pendingDecisionNextDueAt,\n  pendingDecisionClockPausedAt: FlowActorExecutionBaseSchema.shape.pendingDecisionClockPausedAt,\n  pendingDecisionClockPauseStateRef: FlowActorExecutionBaseSchema.shape.pendingDecisionClockPauseStateRef,\n  pendingDecisionClockPausedMs: FlowActorExecutionBaseSchema.shape.pendingDecisionClockPausedMs,\n  pendingDecisionClaimWarningFiredAt: FlowActorExecutionBaseSchema.shape.pendingDecisionClaimWarningFiredAt,\n  pendingDecisionClaimMissedFiredAt: FlowActorExecutionBaseSchema.shape.pendingDecisionClaimMissedFiredAt,\n  pendingDecisionDecisionWarningFiredAt: FlowActorExecutionBaseSchema.shape.pendingDecisionDecisionWarningFiredAt,\n  pendingDecisionDecisionMissedFiredAt: FlowActorExecutionBaseSchema.shape.pendingDecisionDecisionMissedFiredAt,\n  lastResolvedDecisionRef: FlowActorExecutionBaseSchema.shape.lastResolvedDecisionRef,\n  decidedByUserId: FlowActorExecutionBaseSchema.shape.decidedByUserId,\n  decidedAt: FlowActorExecutionBaseSchema.shape.decidedAt,\n  decisionOutcome: FlowActorExecutionBaseSchema.shape.decisionOutcome,\n  decisionToolName: FlowActorExecutionBaseSchema.shape.decisionToolName,\n  decisionModifiedArgumentNames: FlowActorExecutionBaseSchema.shape.decisionModifiedArgumentNames,\n  // #1599 — the agent-work record the settlement owes; allow-listed for the reason above.\n  pendingCorrectionRecordRef: FlowActorExecutionBaseSchema.shape.pendingCorrectionRecordRef,\n  pendingCorrectionPresentedAt: FlowActorExecutionBaseSchema.shape.pendingCorrectionPresentedAt,\n  pendingCorrectionOrganizationId: FlowActorExecutionBaseSchema.shape.pendingCorrectionOrganizationId,\n  pendingCorrectionAdmittedByRole: FlowActorExecutionBaseSchema.shape.pendingCorrectionAdmittedByRole,\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\n/**\n * One string for a set of context resource identifiers — `key=value` pairs sorted by key, joined\n * with `;`. Deterministic, so the transport that opens a conversation and the surface that lists\n * history compute the same value from the same identifiers; `''` for none.\n *\n * Keys and values carry no `=` or `;` in practice (they are resource types and ids); the function\n * does not escape, so a value that did would fold two contexts into one, never split one in two.\n */\nexport function canonicalizeFlowsActorsContextRef(identifiers: Readonly<Record<string, string>> | undefined): string {\n  if (!identifiers) return '';\n  return Object.keys(identifiers)\n    .sort()\n    .map((key) => `${key}=${identifiers[key]}`)\n    .join(';');\n}\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

@@ -48,7 +48,7 @@ import { FlowsActors_Status } from './flows-actors.commons.shared.schemas';
 import { type PolymorphicVariantDefinition } from '../resources/utils/resource-polymorphism.schemas';
 export declare const FlowActorTaskBaseSchema: z.ZodObject<{
     description: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>>;
-    topic: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodEnum<typeof import("./tasks.actors.shared.schemas").Actor_Task_Topics>>>>;
+    topic: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof import("./tasks.actors.shared.schemas").Actor_Task_Topics>>>>>;
     input: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodAny>>>;
     output: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodOptional<z.ZodAny>>>>;
     artifacts: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -182,7 +182,7 @@ export declare const FLOW_ACTOR_TASK_SCOPE_VARIANTS: PolymorphicVariantDefinitio
  */
 export declare const flowActorTasksPolymorphicDeclaration: import("..").PolymorphicSchemaDeclaration<z.ZodObject<{
     description: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>>;
-    topic: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodEnum<typeof import("./tasks.actors.shared.schemas").Actor_Task_Topics>>>>;
+    topic: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof import("./tasks.actors.shared.schemas").Actor_Task_Topics>>>>>;
     input: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodAny>>>;
     output: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodOptional<z.ZodAny>>>>;
     artifacts: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{