@wildo-ai/saas-models 1.1.4 → 1.1.5

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

@@ -1 +1 @@
-{"version":3,"file":"actors.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/flows-actors/actors.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAA6B,MAAM,uCAAuC,CAAC;AACtG,OAAO,EAAmG,oBAAoB,EAAG,MAAM,sCAAsC,CAAC;AAe9K,oBAAY,mBAAmB;IAC7B,WAAW,gBAAgB;IAC3B,YAAY,iBAAiB;IAC7B,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,iBAAiB,sBAAsB;IACvC,cAAc,mBAAmB;CAClC;AAGD,oBAAY,mBAAmB;IAC7B,OAAO,YAAY;IACnB,cAAc,mBAAmB;IACjC,iBAAiB,sBAAsB;CACxC;AAED,eAAO,MAAM,WAAW;;;;;;;iBAOtB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAMhD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAS5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAO5D,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+BtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}
+{"version":3,"file":"actors.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/actors.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAA6B,MAAM,uCAAuC,CAAC;AACtG,OAAO,EAAmG,oBAAoB,EAAG,MAAM,sCAAsC,CAAC;AAgB9K,oBAAY,mBAAmB;IAC7B,WAAW,gBAAgB;IAC3B,YAAY,iBAAiB;IAC7B,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,iBAAiB,sBAAsB;IACvC,cAAc,mBAAmB;CAClC;AAGD;;;;;;;;;;;;;;;;GAgBG;AACH,oBAAY,mBAAmB;IAC7B,OAAO,YAAY;IACnB,cAAc,mBAAmB;IACjC,iBAAiB,sBAAsB;IACvC,YAAY,iBAAiB;CAC9B;AAED,eAAO,MAAM,WAAW;;;;;;;iBAOtB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAMhD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAS5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAO5D;;;;;;;;;GASG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;iBAG1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgC1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAGxF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoDtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

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

@@ -2,7 +2,8 @@ import { z } from "zod";
 import { WildoError_BackendSchema } from "../errors/errors.shared.schemas.js";
 import { FlowsActors_Status, describeFlowsActorsStatus } from "./flows-actors.commons.shared.schemas.js";
 import { FlowActorSystem_BaseSchema, FlowActorSystem_ErrorStates_Schema, FlowActorSystem_ExecutionSchema, FlowActorSystem_Kind, } from "./flows-actors.system.shared.schemas.js";
-import { Actors_Task_Schema, Actors_Walkthrough_Schema, ActorsSystem_ExecutionPlan_Schema } from "./tasks.actors.shared.schemas.js";
+import { Actors_Task_Schema, ActorsSystem_ExecutionPlan_Schema } from "./tasks.actors.shared.schemas.js";
+import { HumanDecision_RequestSchema } from "./human-decision.shared.schemas.js";
 //===============================================================
 //  Actor
 // --------
@@ -22,11 +23,29 @@ export var Actor_Role_Category;
     Actor_Role_Category["HUMAN_IN_THE_LOOP"] = "human_in_the_loop";
     Actor_Role_Category["FLOW_EXECUTION"] = "flow_execution";
 })(Actor_Role_Category || (Actor_Role_Category = {}));
+/**
+ * HOW an actor does its work when the runtime drives it.
+ *
+ * `PROGRAMMATIC` (added 2026-09-20, #1358) is the mode of an actor whose behaviour is supplied by the
+ * HOST as code rather than by an agent, a flow or a person: the execution driver opens the actor's
+ * task, hands the opened identities to a host-supplied executor, and settles on its outcome. An actor
+ * is not an agent — a methodology step run by the app-creation companion, or a deterministic check,
+ * is an actor with no model behind it, and until this member existed such an actor had to borrow
+ * `AGENTIC` without an `agentRef`, which is a lie the registry cannot see.
+ *
+ * `FLOW_EXECUTION` is a PLANNED member and stays (decided by Paul, 2026-09-21, #1363). The Flow
+ * execution model is not implemented yet — `FlowsBackendService.executeFlow` refuses honestly — and
+ * it is intended: an actor whose work is a declared flow is part of what this system is for. No
+ * driver dispatches on this member today, so a reader sweep reports zero; that is the state of the
+ * build, not a verdict on the member. Do not delete it, the Flow model, or `Actor_Role_Category`'s
+ * matching member on that measurement.
+ */
 export var Actor_ExecutionMode;
 (function (Actor_ExecutionMode) {
     Actor_ExecutionMode["AGENTIC"] = "agentic";
     Actor_ExecutionMode["FLOW_EXECUTION"] = "flow_execution";
     Actor_ExecutionMode["HUMAN_INTERACTION"] = "human_interaction";
+    Actor_ExecutionMode["PROGRAMMATIC"] = "programmatic";
 })(Actor_ExecutionMode || (Actor_ExecutionMode = {}));
 export const ActorSchema = z.object({
     ref: z.string().min(1),
@@ -63,10 +82,88 @@ export const ActorSystemSchema = FlowActorSystem_BaseSchema.extend({
 //===============================================================
 //  Actor System Execution
 //===============================================================
+/**
+ * The human decision an execution is WAITING on — present exactly while its status is
+ * `AWAITING_APPROVAL`, and cleared by the resume that answers it.
+ *
+ * Until #1360 three stores held this for three kinds of question (a checkpoint file for a mid-run
+ * clarification, another for an interrupted composite, a task's `output.suspension` for a parked
+ * coding question), projecting one `HumanDecision_Request` each — the payload was unified by #1269
+ * and the storage was left where it was on the premise that a playbook run had no execution row.
+ * #1343 removed that premise. The decision lives on the row the run already has.
+ */
+export const ActorExecution_SuspensionSchema = z.object({
+    decision: HumanDecision_RequestSchema,
+    suspendedAt: z.iso.datetime(),
+});
+/**
+ * What a run left behind so that whatever runs next can CONTINUE it — the host's resume inputs.
+ *
+ * `context` is opaque to the engine, exactly as `FlowsActors_Checkpoint.context` is: the engine owns
+ * the slot and when it is written and read; the host that executes the work owns the content and
+ * validates it at its own boundary. Written while a run progresses (so a run whose process is taken
+ * away can be continued) and when a run suspends (so its resume can rebuild what it was doing).
+ *
+ * A checkpoint outliving its run is the ordinary signal of an INTERRUPTED run: the driver settles a
+ * run whose host died `ABORTED` at the next startup and leaves this in place, so "interrupted and
+ * resumable" is `ABORTED` with a checkpoint — a fact of the row, not a fourth status (#1360).
+ */
+export const ActorExecution_CheckpointSchema = z.object({
+    context: z.any(),
+    checkpointedAt: z.iso.datetime(),
+    /**
+     * The question a RESUMED run was answering, kept until the run moves past it.
+     *
+     * A resume clears `suspension` and moves the row to `PROCESSING`. When the host asked for a failed
+     * continuation to leave the question standing (`restoreSuspensionOnFailure`), a THROWN continuation
+     * is caught and the suspension restored. A continuation whose PROCESS dies throws nothing: the
+     * startup orphan sweep used to settle it `ABORTED`, and the person's answer went with it. Measured
+     * 2026-09-24 on a real domain-plan clarification: answered, resumed, and aborted 85 s later by a
+     * companion restart, which the dev loop performs every few minutes.
+     *
+     * So the resume writes the suspension here, and the sweep puts an orphan that carries one back to
+     * `AWAITING_APPROVAL` on the same question instead of aborting it. It lives on the CHECKPOINT
+     * because it is a resume input with the same lifetime: a host checkpoint written mid-run replaces
+     * the whole checkpoint and drops it (the run has moved past the question), a new suspension
+     * replaces it, and a settle that keeps the checkpoint strips it.
+     */
+    resumedSuspension: ActorExecution_SuspensionSchema.optional(),
+    /**
+     * How many continuations of the pending question DIED WITH THEIR PROCESS before this one (#1507).
+     *
+     * The startup sweep puts such a run back to waiting (see `resumedSuspension`), and nothing else
+     * remembers that a continuation ran: whatever it did and spent went with the process. Counted here so
+     * the host can say so — a playbook run records each as an unobserved part of its spend, so its total
+     * reads as a floor rather than as complete. Cleared once a host has accounted for them in the task's
+     * own record (a restored output after a thrown continuation), and whenever the run moves past the
+     * question: a new suspension replaces the checkpoint, a consuming settle clears it, and a settle that
+     * keeps it drops this count with `resumedSuspension`.
+     */
+    interruptedContinuations: z.number().int().positive().optional(),
+});
 export const ActorSystem_ExecutionSchema = FlowActorSystem_ExecutionSchema.extend({
     kind: z.literal(FlowActorSystem_Kind.ACTOR),
+    /** See {@link ActorExecution_SuspensionSchema}. `null` once answered; absent on a run that never asked. */
+    suspension: ActorExecution_SuspensionSchema.nullable().optional(),
+    /** See {@link ActorExecution_CheckpointSchema}. `null` once consumed; absent on a run that never wrote one. */
+    checkpoint: ActorExecution_CheckpointSchema.nullable().optional(),
+    /**
+     * What this execution runs EXCLUSIVELY — the subject of its single-flight lease (#1361).
+     *
+     * While an execution carrying a subject is `PENDING` or `PROCESSING`, the runtime refuses to open
+     * or resume another execution of the SAME system with the same subject. The lease IS the row: no
+     * second record says "busy", so nothing can disagree with what is actually running. A run that is
+     * waiting on a person (`AWAITING_APPROVAL`) does not hold it — it is not running — and a host's
+     * startup orphan sweep is what releases a lease whose holder died.
+     *
+     * Absent on the ordinary run, which excludes nothing. The subject's vocabulary is the opening
+     * domain's: the runtime compares it and never reads it.
+     *
+     * Until #1361 this principle was implemented three times in one consumer as in-memory flags, each
+     * of which a restart — or a second process — could not see.
+     */
+    exclusiveSubject: z.string().min(1).optional(),
     plan: ActorsSystem_ExecutionPlan_Schema.optional(),
-    walkthrough: Actors_Walkthrough_Schema.optional(),
     standaloneTasks: z.array(Actors_Task_Schema),
     standaloneTaskStates: z.object({
         taskId: z.string(),

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

@@ -1 +1 @@
-{"version":3,"file":"actors.shared.schemas.js","sourceRoot":"","sources":["../../../src/flows-actors/actors.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\nimport { WildoError_BackendSchema } from \"../errors/errors.shared.schemas\";\nimport { FlowsActors_Status, describeFlowsActorsStatus } from \"./flows-actors.commons.shared.schemas\";\nimport { FlowActorSystem_BaseSchema, FlowActorSystem_ErrorStates_Schema, FlowActorSystem_ExecutionSchema, FlowActorSystem_Kind, } from \"./flows-actors.system.shared.schemas\";\nimport { Actors_Task_Schema, Actors_Walkthrough_Schema, ActorsSystem_ExecutionPlan_Schema } from \"./tasks.actors.shared.schemas\";\n\n\n//===============================================================\n//  Actor\n// --------\n// Actors are reactive components that subscribe to event topics\n// and respond with automated processing. They enable event-driven\n// architecture by processing messages asynchronously, supporting\n// batch processing, filtering, and various error handling strategies.\n// Actors can emit new events, creating event chains and workflows.\n//===============================================================\n\n\nexport enum Actor_Role_Category {\n  COORDINATOR = \"coordinator\",\n  TASK_PLANNER = \"task_planner\",\n  OPERATOR = \"operator\",\n  ANALYZER = \"analyzer\",\n  REVIEWER = \"reviewer\",\n  HUMAN_IN_THE_LOOP = \"human_in_the_loop\",\n  FLOW_EXECUTION = \"flow_execution\"\n}\n\n\nexport enum Actor_ExecutionMode {\n  AGENTIC = \"agentic\",\n  FLOW_EXECUTION = \"flow_execution\",\n  HUMAN_INTERACTION = \"human_interaction\",\n}\n\nexport const ActorSchema = z.object({\n  ref: z.string().min(1),\n  displayName: z.string().min(1),\n  roleCategory: z.enum(Actor_Role_Category),\n  executionMode: z.enum(Actor_ExecutionMode),\n  agentRef: z.string().optional(),\n  flowRef: z.string().optional(),\n});\nexport type Actor = z.infer<typeof ActorSchema>;\n\n//===============================================================\n//  Actor System\n//===============================================================\n\n/**\n * The ACTOR specialization of the system base — the schema that OWNS a system's\n * actor list. `actors` is declared here and in no other system schema: the base\n * cannot declare it, because a FLOW system has no actors. (Unrelated `actors`\n * members exist on the TASK schemas; those point at one actor, they are not a\n * system's roster.)\n *\n * An actor system must therefore be parsed with this schema, or one derived\n * from it. Parsing one with `FlowActorSystem_BaseSchema` strips `actors`\n * silently — see the warning there.\n */\nexport const ActorSystemSchema = FlowActorSystem_BaseSchema.extend({\n  /**\n   * Narrows the inherited `kind` discriminant to ACTOR. The historical shape\n   * added a separate `type` field here while every consumer (backend registry,\n   * execution schemas, flows counterpart) discriminates on `kind` — fixed\n   * 2026-07-02 (meta-workflows Step 0 hygiene; no `.type` consumer existed).\n   */\n  kind: z.literal(FlowActorSystem_Kind.ACTOR),\n  actors: z.array(z.lazy(() => ActorSchema)),\n});\nexport type ActorSystem = z.infer<typeof ActorSystemSchema>;\n\n\n//===============================================================\n//  Actor System Execution\n//===============================================================\n\nexport const ActorSystem_ExecutionSchema = FlowActorSystem_ExecutionSchema.extend({\n  kind: z.literal(FlowActorSystem_Kind.ACTOR),\n\n  plan: ActorsSystem_ExecutionPlan_Schema.optional(),\n  walkthrough: Actors_Walkthrough_Schema.optional(),\n  standaloneTasks: z.array(Actors_Task_Schema),\n\n  standaloneTaskStates: z.object({\n    taskId: z.string(),\n    status: z.enum(FlowsActors_Status),\n    updatedAt: z.iso.datetime(),\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.iso.datetime(),\n    })),\n  }).array(),\n\n  /**\n   * Overrides the base `errorItems` with the actor-execution-scoped variant\n   * (adds taskId/planStepId locators). Historically this extension used a\n   * divergent `errors` key coexisting with the base `errorItems` — aligned\n   * 2026-07-02 (meta-workflows Step 0 hygiene; the field had no consumers).\n   */\n  errorStates : FlowActorSystem_ErrorStates_Schema.extend({\n    errorItems: WildoError_BackendSchema.extend({\n      systemRef: z.string(),\n      taskId: z.string().optional(),\n      planStepId: z.string().optional(),\n    }).array().optional(),\n  }).optional(),\n});\nexport type ActorSystem_Execution = z.infer<typeof ActorSystem_ExecutionSchema>;\n"]}
+{"version":3,"file":"actors.shared.schemas.js","sourceRoot":"","sources":["../../../../src/flows-actors/actors.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\nimport { WildoError_BackendSchema } from \"../errors/errors.shared.schemas\";\nimport { FlowsActors_Status, describeFlowsActorsStatus } from \"./flows-actors.commons.shared.schemas\";\nimport { FlowActorSystem_BaseSchema, FlowActorSystem_ErrorStates_Schema, FlowActorSystem_ExecutionSchema, FlowActorSystem_Kind, } from \"./flows-actors.system.shared.schemas\";\nimport { Actors_Task_Schema, ActorsSystem_ExecutionPlan_Schema } from \"./tasks.actors.shared.schemas\";\nimport { HumanDecision_RequestSchema } from \"./human-decision.shared.schemas\";\n\n\n//===============================================================\n//  Actor\n// --------\n// Actors are reactive components that subscribe to event topics\n// and respond with automated processing. They enable event-driven\n// architecture by processing messages asynchronously, supporting\n// batch processing, filtering, and various error handling strategies.\n// Actors can emit new events, creating event chains and workflows.\n//===============================================================\n\n\nexport enum Actor_Role_Category {\n  COORDINATOR = \"coordinator\",\n  TASK_PLANNER = \"task_planner\",\n  OPERATOR = \"operator\",\n  ANALYZER = \"analyzer\",\n  REVIEWER = \"reviewer\",\n  HUMAN_IN_THE_LOOP = \"human_in_the_loop\",\n  FLOW_EXECUTION = \"flow_execution\"\n}\n\n\n/**\n * HOW an actor does its work when the runtime drives it.\n *\n * `PROGRAMMATIC` (added 2026-09-20, #1358) is the mode of an actor whose behaviour is supplied by the\n * HOST as code rather than by an agent, a flow or a person: the execution driver opens the actor's\n * task, hands the opened identities to a host-supplied executor, and settles on its outcome. An actor\n * is not an agent — a methodology step run by the app-creation companion, or a deterministic check,\n * is an actor with no model behind it, and until this member existed such an actor had to borrow\n * `AGENTIC` without an `agentRef`, which is a lie the registry cannot see.\n *\n * `FLOW_EXECUTION` is a PLANNED member and stays (decided by Paul, 2026-09-21, #1363). The Flow\n * execution model is not implemented yet — `FlowsBackendService.executeFlow` refuses honestly — and\n * it is intended: an actor whose work is a declared flow is part of what this system is for. No\n * driver dispatches on this member today, so a reader sweep reports zero; that is the state of the\n * build, not a verdict on the member. Do not delete it, the Flow model, or `Actor_Role_Category`'s\n * matching member on that measurement.\n */\nexport enum Actor_ExecutionMode {\n  AGENTIC = \"agentic\",\n  FLOW_EXECUTION = \"flow_execution\",\n  HUMAN_INTERACTION = \"human_interaction\",\n  PROGRAMMATIC = \"programmatic\",\n}\n\nexport const ActorSchema = z.object({\n  ref: z.string().min(1),\n  displayName: z.string().min(1),\n  roleCategory: z.enum(Actor_Role_Category),\n  executionMode: z.enum(Actor_ExecutionMode),\n  agentRef: z.string().optional(),\n  flowRef: z.string().optional(),\n});\nexport type Actor = z.infer<typeof ActorSchema>;\n\n//===============================================================\n//  Actor System\n//===============================================================\n\n/**\n * The ACTOR specialization of the system base — the schema that OWNS a system's\n * actor list. `actors` is declared here and in no other system schema: the base\n * cannot declare it, because a FLOW system has no actors. (Unrelated `actors`\n * members exist on the TASK schemas; those point at one actor, they are not a\n * system's roster.)\n *\n * An actor system must therefore be parsed with this schema, or one derived\n * from it. Parsing one with `FlowActorSystem_BaseSchema` strips `actors`\n * silently — see the warning there.\n */\nexport const ActorSystemSchema = FlowActorSystem_BaseSchema.extend({\n  /**\n   * Narrows the inherited `kind` discriminant to ACTOR. The historical shape\n   * added a separate `type` field here while every consumer (backend registry,\n   * execution schemas, flows counterpart) discriminates on `kind` — fixed\n   * 2026-07-02 (meta-workflows Step 0 hygiene; no `.type` consumer existed).\n   */\n  kind: z.literal(FlowActorSystem_Kind.ACTOR),\n  actors: z.array(z.lazy(() => ActorSchema)),\n});\nexport type ActorSystem = z.infer<typeof ActorSystemSchema>;\n\n\n//===============================================================\n//  Actor System Execution\n//===============================================================\n\n/**\n * The human decision an execution is WAITING on — present exactly while its status is\n * `AWAITING_APPROVAL`, and cleared by the resume that answers it.\n *\n * Until #1360 three stores held this for three kinds of question (a checkpoint file for a mid-run\n * clarification, another for an interrupted composite, a task's `output.suspension` for a parked\n * coding question), projecting one `HumanDecision_Request` each — the payload was unified by #1269\n * and the storage was left where it was on the premise that a playbook run had no execution row.\n * #1343 removed that premise. The decision lives on the row the run already has.\n */\nexport const ActorExecution_SuspensionSchema = z.object({\n  decision: HumanDecision_RequestSchema,\n  suspendedAt: z.iso.datetime(),\n});\nexport type ActorExecution_Suspension = z.infer<typeof ActorExecution_SuspensionSchema>;\n\n/**\n * What a run left behind so that whatever runs next can CONTINUE it — the host's resume inputs.\n *\n * `context` is opaque to the engine, exactly as `FlowsActors_Checkpoint.context` is: the engine owns\n * the slot and when it is written and read; the host that executes the work owns the content and\n * validates it at its own boundary. Written while a run progresses (so a run whose process is taken\n * away can be continued) and when a run suspends (so its resume can rebuild what it was doing).\n *\n * A checkpoint outliving its run is the ordinary signal of an INTERRUPTED run: the driver settles a\n * run whose host died `ABORTED` at the next startup and leaves this in place, so \"interrupted and\n * resumable\" is `ABORTED` with a checkpoint — a fact of the row, not a fourth status (#1360).\n */\nexport const ActorExecution_CheckpointSchema = z.object({\n  context: z.any(),\n  checkpointedAt: z.iso.datetime(),\n  /**\n   * The question a RESUMED run was answering, kept until the run moves past it.\n   *\n   * A resume clears `suspension` and moves the row to `PROCESSING`. When the host asked for a failed\n   * continuation to leave the question standing (`restoreSuspensionOnFailure`), a THROWN continuation\n   * is caught and the suspension restored. A continuation whose PROCESS dies throws nothing: the\n   * startup orphan sweep used to settle it `ABORTED`, and the person's answer went with it. Measured\n   * 2026-09-24 on a real domain-plan clarification: answered, resumed, and aborted 85 s later by a\n   * companion restart, which the dev loop performs every few minutes.\n   *\n   * So the resume writes the suspension here, and the sweep puts an orphan that carries one back to\n   * `AWAITING_APPROVAL` on the same question instead of aborting it. It lives on the CHECKPOINT\n   * because it is a resume input with the same lifetime: a host checkpoint written mid-run replaces\n   * the whole checkpoint and drops it (the run has moved past the question), a new suspension\n   * replaces it, and a settle that keeps the checkpoint strips it.\n   */\n  resumedSuspension: ActorExecution_SuspensionSchema.optional(),\n  /**\n   * How many continuations of the pending question DIED WITH THEIR PROCESS before this one (#1507).\n   *\n   * The startup sweep puts such a run back to waiting (see `resumedSuspension`), and nothing else\n   * remembers that a continuation ran: whatever it did and spent went with the process. Counted here so\n   * the host can say so — a playbook run records each as an unobserved part of its spend, so its total\n   * reads as a floor rather than as complete. Cleared once a host has accounted for them in the task's\n   * own record (a restored output after a thrown continuation), and whenever the run moves past the\n   * question: a new suspension replaces the checkpoint, a consuming settle clears it, and a settle that\n   * keeps it drops this count with `resumedSuspension`.\n   */\n  interruptedContinuations: z.number().int().positive().optional(),\n});\nexport type ActorExecution_Checkpoint = z.infer<typeof ActorExecution_CheckpointSchema>;\n\n\nexport const ActorSystem_ExecutionSchema = FlowActorSystem_ExecutionSchema.extend({\n  kind: z.literal(FlowActorSystem_Kind.ACTOR),\n\n  /** See {@link ActorExecution_SuspensionSchema}. `null` once answered; absent on a run that never asked. */\n  suspension: ActorExecution_SuspensionSchema.nullable().optional(),\n  /** See {@link ActorExecution_CheckpointSchema}. `null` once consumed; absent on a run that never wrote one. */\n  checkpoint: ActorExecution_CheckpointSchema.nullable().optional(),\n\n  /**\n   * What this execution runs EXCLUSIVELY — the subject of its single-flight lease (#1361).\n   *\n   * While an execution carrying a subject is `PENDING` or `PROCESSING`, the runtime refuses to open\n   * or resume another execution of the SAME system with the same subject. The lease IS the row: no\n   * second record says \"busy\", so nothing can disagree with what is actually running. A run that is\n   * waiting on a person (`AWAITING_APPROVAL`) does not hold it — it is not running — and a host's\n   * startup orphan sweep is what releases a lease whose holder died.\n   *\n   * Absent on the ordinary run, which excludes nothing. The subject's vocabulary is the opening\n   * domain's: the runtime compares it and never reads it.\n   *\n   * Until #1361 this principle was implemented three times in one consumer as in-memory flags, each\n   * of which a restart — or a second process — could not see.\n   */\n  exclusiveSubject: z.string().min(1).optional(),\n\n  plan: ActorsSystem_ExecutionPlan_Schema.optional(),\n  standaloneTasks: z.array(Actors_Task_Schema),\n\n  standaloneTaskStates: z.object({\n    taskId: z.string(),\n    status: z.enum(FlowsActors_Status),\n    updatedAt: z.iso.datetime(),\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.iso.datetime(),\n    })),\n  }).array(),\n\n  /**\n   * Overrides the base `errorItems` with the actor-execution-scoped variant\n   * (adds taskId/planStepId locators). Historically this extension used a\n   * divergent `errors` key coexisting with the base `errorItems` — aligned\n   * 2026-07-02 (meta-workflows Step 0 hygiene; the field had no consumers).\n   */\n  errorStates : FlowActorSystem_ErrorStates_Schema.extend({\n    errorItems: WildoError_BackendSchema.extend({\n      systemRef: z.string(),\n      taskId: z.string().optional(),\n      planStepId: z.string().optional(),\n    }).array().optional(),\n  }).optional(),\n});\nexport type ActorSystem_Execution = z.infer<typeof ActorSystem_ExecutionSchema>;\n"]}

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

@@ -168,6 +168,12 @@ export declare const AgentCallTraceSchema: z.ZodObject<{
             validationIssues: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 code: z.ZodString;
                 path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                expected: z.ZodOptional<z.ZodString>;
+                format: z.ZodOptional<z.ZodString>;
+                pattern: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                keys: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                refinementMessage: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>>;
             finishReason: z.ZodOptional<z.ZodString>;
             generatedTextLength: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;

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

@@ -1 +1 @@
-{"version":3,"file":"agent-traceability.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/flows-actors/agent-traceability.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;GAUG;AACH,oBAAY,sBAAsB;IAChC,IAAI,SAAS;IACb,KAAK,UAAU;IACf,aAAa,kBAAkB;CAChC;AAED,wEAAwE;AACxE,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAIjF,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,sBAAsB,EACnC,YAAY,EAAE,sBAAsB,GACnC,OAAO,CAET;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,CAAC,EAAE,sBAAsB,EACzB,CAAC,EAAE,sBAAsB,GACxB,sBAAsB,CAExB;AAED,4EAA4E;AAC5E,eAAO,MAAM,6BAA6B;;iBAExC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,qDAAqD;AACrD,oBAAY,gBAAgB;IAC1B,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,oBAAY,kBAAkB;IAC5B,UAAU,eAAe;IACzB,SAAS,cAAc;CACxB;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;iBAIpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4B/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB;;;;;;iBAWlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,sBAAsB,CAAC;IAC9B,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE;;;;OAIG;IACH,QAAQ,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC"}
+{"version":3,"file":"agent-traceability.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/agent-traceability.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;GAUG;AACH,oBAAY,sBAAsB;IAChC,IAAI,SAAS;IACb,KAAK,UAAU;IACf,aAAa,kBAAkB;CAChC;AAED,wEAAwE;AACxE,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAIjF,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,sBAAsB,EACnC,YAAY,EAAE,sBAAsB,GACnC,OAAO,CAET;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,CAAC,EAAE,sBAAsB,EACzB,CAAC,EAAE,sBAAsB,GACxB,sBAAsB,CAExB;AAED,4EAA4E;AAC5E,eAAO,MAAM,6BAA6B;;iBAExC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,qDAAqD;AACrD,oBAAY,gBAAgB;IAC1B,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,oBAAY,kBAAkB;IAC5B,UAAU,eAAe;IACzB,SAAS,cAAc;CACxB;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;iBAIpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4B/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB;;;;;;iBAWlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,sBAAsB,CAAC;IAC9B,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE;;;;OAIG;IACH,QAAQ,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC"}

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

@@ -4,7 +4,7 @@ import { FlowsActors_IO_PartKind } from "./flows-actors.io.shared.schemas";
 import { ExecutionContext_InitiatorIds } from "../runtime/execution-context.shared.schemas";
 import z from "zod";
 import { FlowsActors_Relationship } from "./flows-actors.commons.shared.schemas";
-import { AppsBlueprint_FileFormat } from "./apps-blueprint/artifacts.apps-blueprint.shared.schemas";
+import { AgentFileFormat } from "@wildo-ai/zod-decorators";
 /** @wildo_source:part:start saas.models.flows-actors.agent-configuration facet:kind:api facet:audience:app-developer
  *
  * Agent execution settings that stay stable across transport changes.
@@ -162,7 +162,7 @@ export declare const FlowsActors_Agent_ConstraintSchema: z.ZodObject<{
 export type FlowsActors_Agent_Constraint = z.infer<typeof FlowsActors_Agent_ConstraintSchema>;
 export declare const FlowsActors_Agent_OutputSpecSchema: z.ZodObject<{
     type: z.ZodOptional<z.ZodEnum<typeof FlowsActors_IO_PartKind>>;
-    fileFormat: z.ZodOptional<z.ZodEnum<typeof AppsBlueprint_FileFormat>>;
+    fileFormat: z.ZodOptional<z.ZodEnum<typeof AgentFileFormat>>;
     lengthGuidance: z.ZodOptional<z.ZodEnum<typeof FlowsActors_Agent_Verbosity>>;
     includeReasoning: z.ZodOptional<z.ZodBoolean>;
     requiredSections: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -209,7 +209,7 @@ export declare const FlowsActors_Agent_PromptSpecSchema: z.ZodObject<{
     goal: z.ZodOptional<z.ZodString>;
     output: z.ZodOptional<z.ZodObject<{
         type: z.ZodOptional<z.ZodEnum<typeof FlowsActors_IO_PartKind>>;
-        fileFormat: z.ZodOptional<z.ZodEnum<typeof AppsBlueprint_FileFormat>>;
+        fileFormat: z.ZodOptional<z.ZodEnum<typeof AgentFileFormat>>;
         lengthGuidance: z.ZodOptional<z.ZodEnum<typeof FlowsActors_Agent_Verbosity>>;
         includeReasoning: z.ZodOptional<z.ZodBoolean>;
         requiredSections: z.ZodOptional<z.ZodArray<z.ZodString>>;

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

@@ -1 +1 @@
-{"version":3,"file":"agents.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/flows-actors/agents.shared.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agents.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/agents.shared.schemas.ts"],"names":[],"mappings":"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"}

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

@@ -1,7 +1,7 @@
 import { CodingAgent_OperationKey, ImageProvider_OperationKey, LLMProvider_OperationKey, LLMProvider_PromptFormat, } from "@wildo-ai/external-connectors-models";
 import { FlowsActors_IO_PartKind } from "./flows-actors.io.shared.schemas.js";
 import z from "zod";
-import { AppsBlueprint_FileFormat } from "./apps-blueprint/artifacts.apps-blueprint.shared.schemas.js";
+import { AgentFileFormat } from "@wildo-ai/zod-decorators";
 export var StructuredGenerationExecutionMode;
 (function (StructuredGenerationExecutionMode) {
     StructuredGenerationExecutionMode["CHUNKING_ALLOWED"] = "CHUNKING_ALLOWED";
@@ -113,7 +113,7 @@ export const FlowsActors_Agent_ConstraintSchema = z.object({
 });
 //===============================================================
 // FlowsActors_Agent Output Specification Schema (Task 3)
-// REUSES: FlowsActors_IO_PartKind, AppsBlueprint_FileFormat, FlowsActors_Agent_Verbosity
+// REUSES: FlowsActors_IO_PartKind, AgentFileFormat, FlowsActors_Agent_Verbosity
 //===============================================================
 export const FlowsActors_Agent_OutputSpecSchema = z.object({
     /**
@@ -122,10 +122,16 @@ export const FlowsActors_Agent_OutputSpecSchema = z.object({
      */
     type: z.enum(FlowsActors_IO_PartKind).optional(),
     /**
-     * File format hint (for FILE type or text formatting guidance)
-     * REUSES: AppsBlueprint_FileFormat (TEXT, TYPESCRIPT, MARKDOWN, JSON, YAML, etc.)
+     * File format hint (for FILE type or text formatting guidance).
+     *
+     * REUSES `AgentFileFormat` from `@wildo-ai/zod-decorators` — the one named source for the formats
+     * an agent emits, which also owns the extension and MIME mappings
+     * (`AgentFileFormatRegistry`). It is imported from the layer BELOW this one on purpose: the same
+     * vocabulary was previously declared twice, once here as `AppsBlueprint_FileFormat` and once
+     * there as string literals, because a consumer of `saas-models` could not have been the source
+     * without a dependency cycle.
      */
-    fileFormat: z.enum(AppsBlueprint_FileFormat).optional(),
+    fileFormat: z.enum(AgentFileFormat).optional(),
     /**
      * Length guidance - overrides style.verbosity for output specifically
      * REUSES: FlowsActors_Agent_Verbosity (LOW=concise, MEDIUM=moderate, HIGH=detailed)

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

@@ -1 +1 @@
-{"version":3,"file":"agents.shared.schemas.js","sourceRoot":"","sources":["../../../src/flows-actors/agents.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  CodingAgent_OperationDefinitionBase,\n  CodingAgent_OperationKey,\n  CodingAgent_OperationModelConfiguration,\n  ImageProvider_OperationDefinitionBase,\n  ImageProvider_OperationKey,\n  ImageProvider_OperationModelConfiguration,\n  LLMProvider_OperationDefinitionBase,\n  LLMProvider_OperationKey,\n  LLMProvider_OperationModelConfiguration,\n  LLMProvider_PromptFormat,\n} from \"@wildo-ai/external-connectors-models\";\nimport { FlowsActors_LeafElements_Configuration } from \"./flows-actors.configuration.shared.schemas\";\nimport { FlowsActors_IO_PartKind } from \"./flows-actors.io.shared.schemas\";\nimport { ExecutionContext_InitiatorIds } from \"../runtime/execution-context.shared.schemas\";\nimport { FlowActorSystem_Kind } from \"./flows-actors.system.shared.schemas\";\nimport z from \"zod\";\nimport { FlowsActors_Relationship } from \"./flows-actors.commons.shared.schemas\";\nimport { AppsBlueprint_FileFormat } from \"./apps-blueprint/artifacts.apps-blueprint.shared.schemas\";\n\n\n\n//===============================================================\n//  FlowsActors_Agent\n// --------\n// FlowsActors_Agents are AI-powered entities that execute agentic steps within\n// flows and actors. They encapsulate LLM configurations, skills,\n// and system prompts, enabling intelligent decision-making and\n// content generation. FlowsActors_Agents can be scoped to different levels\n// (platform, application, organization, user) for access control.\n//===============================================================\n\n\n//===============================================================\n// FlowsActors_Agent execution configuration\n// Keeps semantic LLM model config while allowing transport selection\n//===============================================================\n\n/** @wildo_source:part:start saas.models.flows-actors.agent-configuration facet:kind:api facet:audience:app-developer\n *\n * Agent execution settings that stay stable across transport changes.\n *\n * `providerRef` and `model` still come from the semantic LLM configuration,\n * while `executionProfileRef` selects one transport/runtime profile under the\n * provider's `AGENT_CLIENT_PROTOCOL` transport when execution should not use the default\n * API-backed path.\n */\nexport type FlowsActors_Agent_ExecutionConfiguration = LLMProvider_OperationModelConfiguration & {\n  executionProfileRef?: string;\n  /** Refuse provider fan-out when one budget reservation authorizes exactly one physical model call. */\n  structuredGenerationExecutionMode?: StructuredGenerationExecutionMode;\n  /**\n   * Immutable schema-shape ceiling used by both pre-admission planning and the physical structured-output executor.\n   * SINGLE_CALL_REQUIRED agents must declare this value so a provider configuration override cannot silently change\n   * the number of calls after one budget reservation has been admitted.\n   */\n  maximumStructuredOutputLeafFields?: number;\n};\n\nexport enum StructuredGenerationExecutionMode {\n  CHUNKING_ALLOWED = 'CHUNKING_ALLOWED',\n  SINGLE_CALL_REQUIRED = 'SINGLE_CALL_REQUIRED',\n}\n\n/**\n * The LLM/text execution arm of an agent config — the original shape,\n * unchanged. Its `operationKey` is an `LLMProvider_OperationKey`, which is\n * what discriminates this arm from the image arm below (the two operation-key\n * enums are disjoint, so TypeScript narrows the union by `operationKey`).\n * Produces the TEXT / STRUCTURED modality; the executor routes it to\n * `LLM_PROVIDER`.\n */\nexport type FlowsActors_Agent_LLMConfiguration = FlowsActors_LeafElements_Configuration & FlowsActors_Agent_ExecutionConfiguration & {\n  operationKey: LLMProvider_OperationKey,\n  seed?: number, // Random seed for deterministic output\n};\n\n/**\n * The IMAGE execution arm of an agent config. Carries image-generation\n * parameters (`size` / `quality` / `background` / …) instead of LLM sampling,\n * and an `ImageProvider_OperationKey`. Produces the IMAGE modality; the\n * executor routes it to `IMAGE_PROVIDER`. (AUDIO / VIDEO arms are reserved —\n * their config types land when those transports are wired.)\n */\nexport type FlowsActors_Agent_ImageConfiguration = FlowsActors_LeafElements_Configuration & ImageProvider_OperationModelConfiguration & {\n  operationKey: ImageProvider_OperationKey,\n  executionProfileRef?: string,\n};\n\n/**\n * The CODING execution arm of an agent config. Carries a workspace-mutating\n * agent reached over the Agent Client Protocol, and a `CodingAgent_OperationKey`.\n * Produces no artifact modality at all — its product is a CHANGED WORKSPACE,\n * which is why it sits on this axis rather than beside TEXT and IMAGE as\n * another thing to generate.\n *\n * `executionProfileRef` is REQUIRED here, unlike every other arm. A coding\n * agent cannot fall back to a default API-backed path: there is no such path,\n * and the profile is where the environment gate, the permission ceiling and the\n * host-configuration posture live. An agent that could omit it would be an\n * agent whose authority was unstated.\n */\nexport type FlowsActors_Agent_CodingConfiguration = FlowsActors_LeafElements_Configuration & CodingAgent_OperationModelConfiguration & {\n  operationKey: CodingAgent_OperationKey,\n  executionProfileRef: string,\n};\n\n/**\n * Agent execution config, discriminated by `operationKey` along the artifact\n * MODALITY axis. One agent concept; the arm selects the transport family.\n * Narrow with {@link isImageAgentConfiguration} or\n * {@link isCodingAgentConfiguration} before reading arm-specific fields.\n */\nexport type FlowsActors_Agent_Configuration =\n  | FlowsActors_Agent_LLMConfiguration\n  | FlowsActors_Agent_ImageConfiguration\n  | FlowsActors_Agent_CodingConfiguration;\n\n/**\n * Narrows an agent config to its IMAGE arm. The two `operationKey` enums are\n * disjoint, so membership in `ImageProvider_OperationKey` is a sound\n * discriminant.\n */\nexport function isImageAgentConfiguration(\n  config: FlowsActors_Agent_Configuration,\n): config is FlowsActors_Agent_ImageConfiguration {\n  return Object.values(ImageProvider_OperationKey).includes(config.operationKey as ImageProvider_OperationKey);\n}\n\n/**\n * Narrows an agent config to its LLM/text arm.\n *\n * Exists so consumers can narrow POSITIVELY. Writing `!isImageAgentConfiguration(config)`\n * to mean \"this is the LLM arm\" was correct only while the union had exactly two\n * members: the moment a third arm landed, that negation silently widened to\n * include it and the compiler reported a missing property somewhere else\n * entirely. A positive guard cannot absorb a future arm by accident.\n */\nexport function isLLMAgentConfiguration(\n  config: FlowsActors_Agent_Configuration,\n): config is FlowsActors_Agent_LLMConfiguration {\n  return Object.values(LLMProvider_OperationKey).includes(config.operationKey as LLMProvider_OperationKey);\n}\n\n/**\n * Narrows an agent config to its CODING arm. The operation-key enums are\n * pairwise disjoint, so membership in `CodingAgent_OperationKey` is a sound\n * discriminant — the same argument the image guard rests on.\n */\nexport function isCodingAgentConfiguration(\n  config: FlowsActors_Agent_Configuration,\n): config is FlowsActors_Agent_CodingConfiguration {\n  return Object.values(CodingAgent_OperationKey).includes(config.operationKey as CodingAgent_OperationKey);\n}\n/** @wildo_source:part:end saas.models.flows-actors.agent-configuration */\n\n\n\n\n/** @wildo_source:part:start saas.models.flows-actors.agent-definition facet:kind:api facet:audience:app-developer\n *\n * Agent lifecycle status. Only `ACTIVE` agents are invocable — invoking an\n * `INACTIVE` / `DEPRECATED` agent is refused at the call, not at registration,\n * so this is the switch for retiring an agent without deleting its definition\n * (and without breaking the refs that still name it).\n */\nexport enum FlowsActors_Agent_Status {\n  ACTIVE = \"active\",\n  INACTIVE = \"inactive\",\n  DEPRECATED = \"deprecated\",\n}\n/** @wildo_source:part:end saas.models.flows-actors.agent-definition */\n\n/** @wildo_source:part:start saas.models.flows-actors.agent-prompt-spec facet:kind:api facet:audience:app-developer\n *\n * What KIND of work the agent does. The prompt compiler turns this into the\n * agent's baseline behavioral instructions before your own `instructions[]` are\n * appended — so it is a real behavioral input, not a label. Pick the one that\n * matches the job: `GENERATION` (write something new), `ANALYSIS` (read and\n * report), `TRANSFORMATION` (reshape given input), `DECISION` (choose/judge),\n * `CHAT` (multi-turn conversation — see the chat-assistant skill), `CUSTOM`\n * (none of the baselines fit).\n */\nexport enum FlowsActors_Agent_Skill_Type {\n  GENERATION = \"generation\",\n  ANALYSIS = \"analysis\",\n  TRANSFORMATION = \"transformation\",\n  DECISION = \"decision\",\n  CHAT = \"chat\",\n  CUSTOM = \"custom\",\n}\n/** @wildo_source:part:end saas.models.flows-actors.agent-prompt-spec */\n\n\n\n\n//===============================================================\n// FlowsActors_Agent Style Preferences\n//===============================================================\n\nexport enum FlowsActors_Agent_Verbosity {\n  LOW = \"low\",\n  MEDIUM = \"medium\",\n  HIGH = \"high\",\n}\n\nexport enum FlowsActors_Agent_Tone {\n  NEUTRAL = \"neutral\",\n  CASUAL = \"casual\",\n  FORMAL = \"formal\",\n  TECHNICAL = \"technical\",\n}\n\n\n//===============================================================\n// FlowsActors_Agent Constraint Types (Task 1)\n// For prompt-level prohibitions with precedence + violation handling\n//===============================================================\n\nexport enum FlowsActors_Agent_ConstraintType {\n  SECURITY = \"security\",      // Never reveal API keys, never execute arbitrary code\n  SAFETY = \"safety\",          // Refuse harmful requests\n  PRIVACY = \"privacy\",        // Handle PII appropriately\n  SCOPE = \"scope\",            // Stay within task boundaries\n  COMPLIANCE = \"compliance\",  // Regulatory constraints\n}\n\n\n//===============================================================\n// FlowsActors_Agent Constraint Schema (Task 2)\n//===============================================================\n\nexport const FlowsActors_Agent_ConstraintSchema = z.object({\n  /** Unique constraint identifier */\n  id: z.string(),\n  /** The constraint text (prohibition) */\n  text: z.string(),\n  /** Constraint category */\n  type: z.enum(FlowsActors_Agent_ConstraintType),\n  /** Action on violation */\n  onViolation: z.enum([\"refuse\", \"warn\", \"log\"]).default(\"refuse\"),\n});\n\nexport type FlowsActors_Agent_Constraint = z.infer<typeof FlowsActors_Agent_ConstraintSchema>;\n\n\n//===============================================================\n// FlowsActors_Agent Output Specification Schema (Task 3)\n// REUSES: FlowsActors_IO_PartKind, AppsBlueprint_FileFormat, FlowsActors_Agent_Verbosity\n//===============================================================\n\nexport const FlowsActors_Agent_OutputSpecSchema = z.object({\n  /**\n   * Output type classification\n   * REUSES: FlowsActors_IO_PartKind (TEXT, FILE, RAW_DATA, STRUCTURED)\n   */\n  type: z.enum(FlowsActors_IO_PartKind).optional(),\n\n  /**\n   * File format hint (for FILE type or text formatting guidance)\n   * REUSES: AppsBlueprint_FileFormat (TEXT, TYPESCRIPT, MARKDOWN, JSON, YAML, etc.)\n   */\n  fileFormat: z.enum(AppsBlueprint_FileFormat).optional(),\n\n  /**\n   * Length guidance - overrides style.verbosity for output specifically\n   * REUSES: FlowsActors_Agent_Verbosity (LOW=concise, MEDIUM=moderate, HIGH=detailed)\n   */\n  lengthGuidance: z.enum(FlowsActors_Agent_Verbosity).optional(),\n\n  /** Include reasoning/explanation in output */\n  includeReasoning: z.boolean().optional(),\n\n  /** Required sections in output (e.g., [\"summary\", \"recommendations\"]) */\n  requiredSections: z.array(z.string()).optional(),\n});\n\nexport type FlowsActors_Agent_OutputSpec = z.infer<typeof FlowsActors_Agent_OutputSpecSchema>;\n\n\n//===============================================================\n// FlowsActors_Agent Uncertainty Policy (Task 4)\n// How to handle ambiguity in agent execution\n//===============================================================\n\nexport enum FlowsActors_Agent_UncertaintyPolicy {\n  ASK = \"ask\",                    // Ask for clarification\n  INFER = \"infer\",                // Make reasonable inferences\n  CONSERVATIVE = \"conservative\",  // Choose safest option\n  FAIL = \"fail\",                  // Return error on uncertainty\n}\n\n\n//===============================================================\n// FlowsActors_Agent Uncertainty Schema (Task 5)\n//===============================================================\n\nexport const FlowsActors_Agent_UncertaintySchema = z.object({\n  /** Policy when agent is uncertain */\n  policy: z.enum(FlowsActors_Agent_UncertaintyPolicy).default(FlowsActors_Agent_UncertaintyPolicy.ASK),\n  /** Confidence threshold (0-1) below which to apply policy */\n  confidenceThreshold: z.number().min(0).max(1).optional(),\n});\n\nexport type FlowsActors_Agent_Uncertainty = z.infer<typeof FlowsActors_Agent_UncertaintySchema>;\n\n\n//===============================================================\n// FlowsActors_Agent_PromptSpec (Clean Implementation)\n// Complete prompt specification - required on all agents\n// Replaces legacy skill.role/persona approach\n//===============================================================\n\n/** @wildo_source:part:start saas.models.flows-actors.agent-prompt-spec facet:kind:api facet:audience:app-developer\n *\n * The agent's prompt, authored as STRUCTURE rather than one prose blob. The\n * prompt compiler renders these fields into the provider's preferred format\n * (XML boundaries for Claude, message roles for OpenAI, …), so you never\n * hand-format a system prompt or branch on the provider yourself.\n *\n * `role` + `skillType` are the only required fields — start there and add the\n * rest as the behavior needs them. Precedence when the model must choose:\n * `constraints` (prohibitions — highest) > `instructions` (hard rules) >\n * `hints` (soft preferences). Keep the per-call task in the invocation's\n * `input.prompt`; keep everything durable about the agent here.\n */\nexport const FlowsActors_Agent_PromptSpecSchema = z.object({\n  //====================\n  // IDENTITY (migrated from legacy skill)\n  //====================\n\n  /**\n   * Agent's role description\n   * Explains what this agent does and its primary function\n   */\n  role: z.string(),\n\n  /**\n   * Agent's persona/character\n   * Defines the agent's personality, expertise, and communication approach\n   */\n  persona: z.string().optional(),\n\n  /**\n   * Agent skill type - determines baseline behavioral instructions\n   */\n  skillType: z.enum(FlowsActors_Agent_Skill_Type),\n\n  //====================\n  // CONSTRAINTS (highest precedence)\n  //====================\n\n  /**\n   * Constraints - HIGHEST precedence, never violate\n   * Different from instructions: constraints are prohibitions, instructions are rules\n   */\n  constraints: z.array(FlowsActors_Agent_ConstraintSchema).optional(),\n\n  //====================\n  // GOAL\n  //====================\n\n  /**\n   * Goal statement - what the agent aims to achieve\n   * Single sentence describing success criteria\n   */\n  goal: z.string().optional(),\n\n  //====================\n  // OUTPUT SPECIFICATION\n  //====================\n\n  /**\n   * Output specification - format and structure requirements\n   */\n  output: FlowsActors_Agent_OutputSpecSchema.optional(),\n\n  //====================\n  // INSTRUCTIONS & HINTS\n  //====================\n\n  /** Hard rules - behavioral instructions (in addition to skill type baseline) */\n  instructions: z.array(z.string()).default([]),\n\n  /** Soft hints - preferences, can be overridden by task constraints */\n  hints: z.array(z.string()).optional(),\n\n  //====================\n  // UNCERTAINTY HANDLING\n  //====================\n\n  /**\n   * Uncertainty handling policy\n   */\n  uncertainty: FlowsActors_Agent_UncertaintySchema.optional(),\n\n  //====================\n  // SCOPE BOUNDARIES\n  //====================\n\n  /**\n   * Scope boundaries - explicit \"don't do\" statements\n   * Helps prevent scope creep\n   */\n  outOfScope: z.array(z.string()).optional(),\n\n  //====================\n  // EXAMPLES (few-shot)\n  //====================\n\n  /**\n   * Examples - few-shot examples for better output quality\n   * Format: input/output pairs with optional explanation\n   */\n  examples: z.array(z.object({\n    input: z.string(),\n    output: z.string(),\n    explanation: z.string().optional(),\n  })).optional(),\n\n  //====================\n  // STYLE\n  //====================\n\n  /** Style preferences */\n  style: z.object({\n    verbosity: z.enum(FlowsActors_Agent_Verbosity).optional(),\n    tone: z.enum(FlowsActors_Agent_Tone).optional(),\n  }).optional(),\n\n  //====================\n  // CONTEXT CURATION\n  //====================\n\n  /** Context curation settings */\n  curation: z.object({\n    /** Maximum context items to include */\n    maxItems: z.number().min(1).max(100).optional(),\n    /** Minimum relevance score threshold (0-1) */\n    minRelevance: z.number().min(0).max(1).optional(),\n    /** Maximum total tokens for context */\n    maxTokens: z.number().optional(),\n  }).optional(),\n\n  //====================\n  // FORMAT & METADATA\n  //====================\n\n  /** Override provider's default prompt format */\n  promptFormatOverride: z.enum(LLMProvider_PromptFormat).optional(),\n\n  /**\n   * Prompt specification metadata for versioning and tracking\n   * Helps track prompt iterations and authorship for 200+ agents\n   */\n  metadata: z.object({\n    /** Semantic version of this prompt spec (e.g., \"1.2.0\") */\n    version: z.string().optional(),\n    /** Last modification date (ISO 8601) */\n    lastModified: z.string().optional(),\n    /** Author or team responsible */\n    author: z.string().optional(),\n    /** Brief changelog or reason for current version */\n    changelog: z.string().optional(),\n  }).optional(),\n});\n\nexport type FlowsActors_Agent_PromptSpec = z.infer<typeof FlowsActors_Agent_PromptSpecSchema>;\n/** @wildo_source:part:end saas.models.flows-actors.agent-prompt-spec */\n\n\n//===============================================================\n// FlowsActors_Agent Schema (Clean Implementation)\n// FlowsActors_Agents are AI-powered entities with specific roles and capabilities\n// They are called by Flow Steps (AGENT_CALL) and Actors (AGENTIC mode)\n//===============================================================\n\n/** @wildo_source:part:start saas.models.flows-actors.agent-definition facet:kind:api facet:audience:app-developer\n *\n * A callable AI unit. This is the whole authoring surface for \"give my app an\n * LLM capability\": author one of these, register it on your backend module's\n * `flowsActors.agents`, then invoke it by `ref`.\n *\n * The definition is DECLARATIVE and durable — provider, model, operation, and\n * prompt live here; the per-call task lives in the invocation. Nothing about\n * transport, retries, rate limiting, usage accounting, or tracing is yours to\n * write: the engine owns all of it once the agent is registered.\n *\n * Import path: `@wildo-ai/saas-models`.\n */\nexport type FlowsActors_Agent = {\n  //====================\n  // IDENTITY\n  //====================\n\n  /** Unique agent reference for flow/actor calls */\n  ref: string,\n\n  /** Human-readable display name */\n  displayName: string,\n\n  /** Agent lifecycle status */\n  status: FlowsActors_Agent_Status,\n\n  //====================\n  // EXECUTION CONFIGURATION (modality-discriminated)\n  //====================\n\n  /** Provider/model config, discriminated by modality (LLM/text | image | coding). */\n  config: FlowsActors_Agent_Configuration,\n\n  /** Operation definition (input/output schemas, etc.), per transport family. */\n  operationDefinition: LLMProvider_OperationDefinitionBase | ImageProvider_OperationDefinitionBase | CodingAgent_OperationDefinitionBase,\n\n  //====================\n  // ARTIFACT MODALITY (optional — explicit override; else derived from config)\n  //====================\n\n  /**\n   * The modality this agent PRODUCES, as documentation.\n   *\n   * Declarative only: no runtime path reads it. Dispatch is decided entirely by\n   * the arm of `config`, so setting or omitting this field changes nothing about\n   * which provider protocol the agent reaches. Set it to make a multimodal\n   * agent's output self-describing to a reader.\n   */\n  outputModality?: FlowsActors_IO_PartKind,\n\n  /** The modalities this agent CONSUMES (e.g. `[TEXT]` for text-to-image). */\n  inputModalities?: FlowsActors_IO_PartKind[],\n\n  //====================\n  // PROMPT SPECIFICATION (required)\n  //====================\n\n  /**\n   * Complete prompt specification\n   * Defines role, persona, constraints, instructions, output format, etc.\n   */\n  promptSpec: FlowsActors_Agent_PromptSpec,\n\n  //====================\n  // CAPABILITIES\n  //====================\n\n  /** Agent capabilities (tools, etc.) */\n  capabilities?: {\n    tools?: {\n      /**\n       * References to callable functions.\n       *\n       * RESOLVED: `AgentsBackendService` looks each ref up through\n       * `flowsActorsRegistry.getFunctionTool(ref)` and hands the model a callable tool. An unknown\n       * ref is skipped with a debug line rather than failing the turn.\n       */\n      functionRefs: string[],\n      /**\n       * References to MCP servers the agent may reach.\n       *\n       * ## CHECKED, NOT YET CALLABLE (#491)\n       *\n       * Each ref must name an MCP server the APPLICATION declared (`FlowsActors_McpServer`), and\n       * `FlowsActorsRegistryService` REFUSES at initialization an agent whose refs name none. That\n       * closes the shape this field was in: it used to resolve against nothing, so a shipped catalog\n       * carried seven refs (`filesystem-mcp`, `git-mcp`, `browser-mcp`, `mongodb-mcp`, …) that named\n       * no server anywhere while the agent card rendered them as capabilities — a claim shown to a\n       * user about a reach the agent did not have. The catalog is gone and the card no longer\n       * renders these.\n       *\n       * The check is deliberately stricter than `functionRefs`, which skip an unknown ref with a\n       * debug line: an unknown `functionRef` costs an agent one tool, whereas these were presented\n       * as a capability, and a refusal makes the old state unreachable rather than fixed once.\n       *\n       * ## What is still missing before a ref becomes a CALLABLE tool\n       *\n       * The declaration is checkable; the call is not yet made. `AgentsBackendService` resolves\n       * `functionRefs` and nothing else, so an agent carrying `mcpRefs` still has exactly the reach\n       * its `functionRefs` give it.\n       *\n       * 1. **An MCP client.** `saas-backend-lib/src/mcp/` is the SERVER Wildo exposes to external MCP\n       *    clients. There is no client, and no MCP client SDK in any manifest.\n       * 2. ~~A server registry~~ — BUILT. `registry.mcpServers`, declared per application.\n       * 3. **Credential resolution at call time.** Decided 2026-09-09: the call carries the acting\n       *    user's own delegated provider credential where present and the organization's connection\n       *    otherwise, from `userProviderCredentials` / `organizationProviderCredentials` rather than\n       *    a store invented for MCP. `FlowsActors_McpCredentialSubject` records that choice per\n       *    server; nothing reads it yet.\n       *\n       * Also decided, and not yet implemented: an unreachable server contributes NO tools to a turn\n       * rather than failing it — tools are discovered at turn start — and a call that fails mid-turn\n       * returns a typed error the agent can reason about. Both emit an audit event, because a server\n       * quietly unreachable for a week must be visible as that rather than as an agent that became\n       * less capable for no stated reason.\n       *\n       * Restoring these to any surface that presents them as a capability belongs in the same change\n       * that makes them callable.\n       */\n      mcpRefs: string[],\n    },\n  },\n\n  //====================\n  // VERSIONING\n  //====================\n\n  /** Agent definition version */\n  version?: string,\n\n  /** Creation timestamp (ISO 8601) */\n  createdAt: string,\n\n  /** Last update timestamp (ISO 8601) */\n  updatedAt?: string,\n};\n/** @wildo_source:part:end saas.models.flows-actors.agent-definition */\n\n\n/** @wildo_source:part:start saas.models.flows-actors.agent-invocation facet:kind:api facet:audience:app-developer\n *\n * One call to one agent — the envelope you build and hand to\n * `AgentsBackendService.invokeAgent`, and the SAME shape you get back with\n * `output` and `executionContext` filled in.\n *\n * What you supply:\n * - `agentRef` — the `ref` of a registered agent (unknown ref throws).\n * - `input` — the per-call task. `{ prompt }` for text; add `{ schema }` (a Zod\n *   schema) for `GENERATE_STRUCTURED`, which REQUIRES it. Anything else you put\n *   here is JSON-serialized into the user prompt.\n * - `output` — an empty value of the expected shape (`{ text: '' }`,\n *   `{ object: {} }`). It is a typing seed; the returned envelope replaces it.\n * - `initiator` / `invocationContext` / `artifactBindings` — `{}` / `[]` / `[]`\n *   when you have nothing to correlate.\n *\n * What comes back: `output` normalized to the operation's shape, and\n * `executionContext` enriched with `executionTime`, `finishedAt`, and provider\n * `usage` (tokens) when the transport reports it.\n *\n * Import path: `@wildo-ai/saas-models`.\n */\nexport type FlowsActors_Agent_Invocation<\n  InputSchema extends z.ZodSchema<any> = z.ZodSchema<any>,\n  OutputSchema extends z.ZodSchema<any> = z.ZodSchema<any>,\n  ContextSchema extends z.ZodSchema<any> = z.ZodSchema<any>,\n> = {\n  _id?: string,\n  agentRef: string,\n  initiator: ExecutionContext_InitiatorIds,\n  invocationContext : FlowsActors_Relationship[],\n\n  input: z.infer<InputSchema>,\n  output: z.infer<OutputSchema>,\n  executionContext: z.infer<ContextSchema>,\n  artifactBindings: {\n    kind: FlowsActors_IO_PartKind,\n    ref: string,\n  }[],\n\n};\n/** @wildo_source:part:end saas.models.flows-actors.agent-invocation */\n"]}
+{"version":3,"file":"agents.shared.schemas.js","sourceRoot":"","sources":["../../../../src/flows-actors/agents.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  CodingAgent_OperationDefinitionBase,\n  CodingAgent_OperationKey,\n  CodingAgent_OperationModelConfiguration,\n  ImageProvider_OperationDefinitionBase,\n  ImageProvider_OperationKey,\n  ImageProvider_OperationModelConfiguration,\n  LLMProvider_OperationDefinitionBase,\n  LLMProvider_OperationKey,\n  LLMProvider_OperationModelConfiguration,\n  LLMProvider_PromptFormat,\n} from \"@wildo-ai/external-connectors-models\";\nimport { FlowsActors_LeafElements_Configuration } from \"./flows-actors.configuration.shared.schemas\";\nimport { FlowsActors_IO_PartKind } from \"./flows-actors.io.shared.schemas\";\nimport { ExecutionContext_InitiatorIds } from \"../runtime/execution-context.shared.schemas\";\nimport { FlowActorSystem_Kind } from \"./flows-actors.system.shared.schemas\";\nimport z from \"zod\";\nimport { FlowsActors_Relationship } from \"./flows-actors.commons.shared.schemas\";\nimport { AgentFileFormat } from \"@wildo-ai/zod-decorators\";\n\n\n\n//===============================================================\n//  FlowsActors_Agent\n// --------\n// FlowsActors_Agents are AI-powered entities that execute agentic steps within\n// flows and actors. They encapsulate LLM configurations, skills,\n// and system prompts, enabling intelligent decision-making and\n// content generation. FlowsActors_Agents can be scoped to different levels\n// (platform, application, organization, user) for access control.\n//===============================================================\n\n\n//===============================================================\n// FlowsActors_Agent execution configuration\n// Keeps semantic LLM model config while allowing transport selection\n//===============================================================\n\n/** @wildo_source:part:start saas.models.flows-actors.agent-configuration facet:kind:api facet:audience:app-developer\n *\n * Agent execution settings that stay stable across transport changes.\n *\n * `providerRef` and `model` still come from the semantic LLM configuration,\n * while `executionProfileRef` selects one transport/runtime profile under the\n * provider's `AGENT_CLIENT_PROTOCOL` transport when execution should not use the default\n * API-backed path.\n */\nexport type FlowsActors_Agent_ExecutionConfiguration = LLMProvider_OperationModelConfiguration & {\n  executionProfileRef?: string;\n  /** Refuse provider fan-out when one budget reservation authorizes exactly one physical model call. */\n  structuredGenerationExecutionMode?: StructuredGenerationExecutionMode;\n  /**\n   * Immutable schema-shape ceiling used by both pre-admission planning and the physical structured-output executor.\n   * SINGLE_CALL_REQUIRED agents must declare this value so a provider configuration override cannot silently change\n   * the number of calls after one budget reservation has been admitted.\n   */\n  maximumStructuredOutputLeafFields?: number;\n};\n\nexport enum StructuredGenerationExecutionMode {\n  CHUNKING_ALLOWED = 'CHUNKING_ALLOWED',\n  SINGLE_CALL_REQUIRED = 'SINGLE_CALL_REQUIRED',\n}\n\n/**\n * The LLM/text execution arm of an agent config — the original shape,\n * unchanged. Its `operationKey` is an `LLMProvider_OperationKey`, which is\n * what discriminates this arm from the image arm below (the two operation-key\n * enums are disjoint, so TypeScript narrows the union by `operationKey`).\n * Produces the TEXT / STRUCTURED modality; the executor routes it to\n * `LLM_PROVIDER`.\n */\nexport type FlowsActors_Agent_LLMConfiguration = FlowsActors_LeafElements_Configuration & FlowsActors_Agent_ExecutionConfiguration & {\n  operationKey: LLMProvider_OperationKey,\n  seed?: number, // Random seed for deterministic output\n};\n\n/**\n * The IMAGE execution arm of an agent config. Carries image-generation\n * parameters (`size` / `quality` / `background` / …) instead of LLM sampling,\n * and an `ImageProvider_OperationKey`. Produces the IMAGE modality; the\n * executor routes it to `IMAGE_PROVIDER`. (AUDIO / VIDEO arms are reserved —\n * their config types land when those transports are wired.)\n */\nexport type FlowsActors_Agent_ImageConfiguration = FlowsActors_LeafElements_Configuration & ImageProvider_OperationModelConfiguration & {\n  operationKey: ImageProvider_OperationKey,\n  executionProfileRef?: string,\n};\n\n/**\n * The CODING execution arm of an agent config. Carries a workspace-mutating\n * agent reached over the Agent Client Protocol, and a `CodingAgent_OperationKey`.\n * Produces no artifact modality at all — its product is a CHANGED WORKSPACE,\n * which is why it sits on this axis rather than beside TEXT and IMAGE as\n * another thing to generate.\n *\n * `executionProfileRef` is REQUIRED here, unlike every other arm. A coding\n * agent cannot fall back to a default API-backed path: there is no such path,\n * and the profile is where the environment gate, the permission ceiling and the\n * host-configuration posture live. An agent that could omit it would be an\n * agent whose authority was unstated.\n */\nexport type FlowsActors_Agent_CodingConfiguration = FlowsActors_LeafElements_Configuration & CodingAgent_OperationModelConfiguration & {\n  operationKey: CodingAgent_OperationKey,\n  executionProfileRef: string,\n};\n\n/**\n * Agent execution config, discriminated by `operationKey` along the artifact\n * MODALITY axis. One agent concept; the arm selects the transport family.\n * Narrow with {@link isImageAgentConfiguration} or\n * {@link isCodingAgentConfiguration} before reading arm-specific fields.\n */\nexport type FlowsActors_Agent_Configuration =\n  | FlowsActors_Agent_LLMConfiguration\n  | FlowsActors_Agent_ImageConfiguration\n  | FlowsActors_Agent_CodingConfiguration;\n\n/**\n * Narrows an agent config to its IMAGE arm. The two `operationKey` enums are\n * disjoint, so membership in `ImageProvider_OperationKey` is a sound\n * discriminant.\n */\nexport function isImageAgentConfiguration(\n  config: FlowsActors_Agent_Configuration,\n): config is FlowsActors_Agent_ImageConfiguration {\n  return Object.values(ImageProvider_OperationKey).includes(config.operationKey as ImageProvider_OperationKey);\n}\n\n/**\n * Narrows an agent config to its LLM/text arm.\n *\n * Exists so consumers can narrow POSITIVELY. Writing `!isImageAgentConfiguration(config)`\n * to mean \"this is the LLM arm\" was correct only while the union had exactly two\n * members: the moment a third arm landed, that negation silently widened to\n * include it and the compiler reported a missing property somewhere else\n * entirely. A positive guard cannot absorb a future arm by accident.\n */\nexport function isLLMAgentConfiguration(\n  config: FlowsActors_Agent_Configuration,\n): config is FlowsActors_Agent_LLMConfiguration {\n  return Object.values(LLMProvider_OperationKey).includes(config.operationKey as LLMProvider_OperationKey);\n}\n\n/**\n * Narrows an agent config to its CODING arm. The operation-key enums are\n * pairwise disjoint, so membership in `CodingAgent_OperationKey` is a sound\n * discriminant — the same argument the image guard rests on.\n */\nexport function isCodingAgentConfiguration(\n  config: FlowsActors_Agent_Configuration,\n): config is FlowsActors_Agent_CodingConfiguration {\n  return Object.values(CodingAgent_OperationKey).includes(config.operationKey as CodingAgent_OperationKey);\n}\n/** @wildo_source:part:end saas.models.flows-actors.agent-configuration */\n\n\n\n\n/** @wildo_source:part:start saas.models.flows-actors.agent-definition facet:kind:api facet:audience:app-developer\n *\n * Agent lifecycle status. Only `ACTIVE` agents are invocable — invoking an\n * `INACTIVE` / `DEPRECATED` agent is refused at the call, not at registration,\n * so this is the switch for retiring an agent without deleting its definition\n * (and without breaking the refs that still name it).\n */\nexport enum FlowsActors_Agent_Status {\n  ACTIVE = \"active\",\n  INACTIVE = \"inactive\",\n  DEPRECATED = \"deprecated\",\n}\n/** @wildo_source:part:end saas.models.flows-actors.agent-definition */\n\n/** @wildo_source:part:start saas.models.flows-actors.agent-prompt-spec facet:kind:api facet:audience:app-developer\n *\n * What KIND of work the agent does. The prompt compiler turns this into the\n * agent's baseline behavioral instructions before your own `instructions[]` are\n * appended — so it is a real behavioral input, not a label. Pick the one that\n * matches the job: `GENERATION` (write something new), `ANALYSIS` (read and\n * report), `TRANSFORMATION` (reshape given input), `DECISION` (choose/judge),\n * `CHAT` (multi-turn conversation — see the chat-assistant skill), `CUSTOM`\n * (none of the baselines fit).\n */\nexport enum FlowsActors_Agent_Skill_Type {\n  GENERATION = \"generation\",\n  ANALYSIS = \"analysis\",\n  TRANSFORMATION = \"transformation\",\n  DECISION = \"decision\",\n  CHAT = \"chat\",\n  CUSTOM = \"custom\",\n}\n/** @wildo_source:part:end saas.models.flows-actors.agent-prompt-spec */\n\n\n\n\n//===============================================================\n// FlowsActors_Agent Style Preferences\n//===============================================================\n\nexport enum FlowsActors_Agent_Verbosity {\n  LOW = \"low\",\n  MEDIUM = \"medium\",\n  HIGH = \"high\",\n}\n\nexport enum FlowsActors_Agent_Tone {\n  NEUTRAL = \"neutral\",\n  CASUAL = \"casual\",\n  FORMAL = \"formal\",\n  TECHNICAL = \"technical\",\n}\n\n\n//===============================================================\n// FlowsActors_Agent Constraint Types (Task 1)\n// For prompt-level prohibitions with precedence + violation handling\n//===============================================================\n\nexport enum FlowsActors_Agent_ConstraintType {\n  SECURITY = \"security\",      // Never reveal API keys, never execute arbitrary code\n  SAFETY = \"safety\",          // Refuse harmful requests\n  PRIVACY = \"privacy\",        // Handle PII appropriately\n  SCOPE = \"scope\",            // Stay within task boundaries\n  COMPLIANCE = \"compliance\",  // Regulatory constraints\n}\n\n\n//===============================================================\n// FlowsActors_Agent Constraint Schema (Task 2)\n//===============================================================\n\nexport const FlowsActors_Agent_ConstraintSchema = z.object({\n  /** Unique constraint identifier */\n  id: z.string(),\n  /** The constraint text (prohibition) */\n  text: z.string(),\n  /** Constraint category */\n  type: z.enum(FlowsActors_Agent_ConstraintType),\n  /** Action on violation */\n  onViolation: z.enum([\"refuse\", \"warn\", \"log\"]).default(\"refuse\"),\n});\n\nexport type FlowsActors_Agent_Constraint = z.infer<typeof FlowsActors_Agent_ConstraintSchema>;\n\n\n//===============================================================\n// FlowsActors_Agent Output Specification Schema (Task 3)\n// REUSES: FlowsActors_IO_PartKind, AgentFileFormat, FlowsActors_Agent_Verbosity\n//===============================================================\n\nexport const FlowsActors_Agent_OutputSpecSchema = z.object({\n  /**\n   * Output type classification\n   * REUSES: FlowsActors_IO_PartKind (TEXT, FILE, RAW_DATA, STRUCTURED)\n   */\n  type: z.enum(FlowsActors_IO_PartKind).optional(),\n\n  /**\n   * File format hint (for FILE type or text formatting guidance).\n   *\n   * REUSES `AgentFileFormat` from `@wildo-ai/zod-decorators` — the one named source for the formats\n   * an agent emits, which also owns the extension and MIME mappings\n   * (`AgentFileFormatRegistry`). It is imported from the layer BELOW this one on purpose: the same\n   * vocabulary was previously declared twice, once here as `AppsBlueprint_FileFormat` and once\n   * there as string literals, because a consumer of `saas-models` could not have been the source\n   * without a dependency cycle.\n   */\n  fileFormat: z.enum(AgentFileFormat).optional(),\n\n  /**\n   * Length guidance - overrides style.verbosity for output specifically\n   * REUSES: FlowsActors_Agent_Verbosity (LOW=concise, MEDIUM=moderate, HIGH=detailed)\n   */\n  lengthGuidance: z.enum(FlowsActors_Agent_Verbosity).optional(),\n\n  /** Include reasoning/explanation in output */\n  includeReasoning: z.boolean().optional(),\n\n  /** Required sections in output (e.g., [\"summary\", \"recommendations\"]) */\n  requiredSections: z.array(z.string()).optional(),\n});\n\nexport type FlowsActors_Agent_OutputSpec = z.infer<typeof FlowsActors_Agent_OutputSpecSchema>;\n\n\n//===============================================================\n// FlowsActors_Agent Uncertainty Policy (Task 4)\n// How to handle ambiguity in agent execution\n//===============================================================\n\nexport enum FlowsActors_Agent_UncertaintyPolicy {\n  ASK = \"ask\",                    // Ask for clarification\n  INFER = \"infer\",                // Make reasonable inferences\n  CONSERVATIVE = \"conservative\",  // Choose safest option\n  FAIL = \"fail\",                  // Return error on uncertainty\n}\n\n\n//===============================================================\n// FlowsActors_Agent Uncertainty Schema (Task 5)\n//===============================================================\n\nexport const FlowsActors_Agent_UncertaintySchema = z.object({\n  /** Policy when agent is uncertain */\n  policy: z.enum(FlowsActors_Agent_UncertaintyPolicy).default(FlowsActors_Agent_UncertaintyPolicy.ASK),\n  /** Confidence threshold (0-1) below which to apply policy */\n  confidenceThreshold: z.number().min(0).max(1).optional(),\n});\n\nexport type FlowsActors_Agent_Uncertainty = z.infer<typeof FlowsActors_Agent_UncertaintySchema>;\n\n\n//===============================================================\n// FlowsActors_Agent_PromptSpec (Clean Implementation)\n// Complete prompt specification - required on all agents\n// Replaces legacy skill.role/persona approach\n//===============================================================\n\n/** @wildo_source:part:start saas.models.flows-actors.agent-prompt-spec facet:kind:api facet:audience:app-developer\n *\n * The agent's prompt, authored as STRUCTURE rather than one prose blob. The\n * prompt compiler renders these fields into the provider's preferred format\n * (XML boundaries for Claude, message roles for OpenAI, …), so you never\n * hand-format a system prompt or branch on the provider yourself.\n *\n * `role` + `skillType` are the only required fields — start there and add the\n * rest as the behavior needs them. Precedence when the model must choose:\n * `constraints` (prohibitions — highest) > `instructions` (hard rules) >\n * `hints` (soft preferences). Keep the per-call task in the invocation's\n * `input.prompt`; keep everything durable about the agent here.\n */\nexport const FlowsActors_Agent_PromptSpecSchema = z.object({\n  //====================\n  // IDENTITY (migrated from legacy skill)\n  //====================\n\n  /**\n   * Agent's role description\n   * Explains what this agent does and its primary function\n   */\n  role: z.string(),\n\n  /**\n   * Agent's persona/character\n   * Defines the agent's personality, expertise, and communication approach\n   */\n  persona: z.string().optional(),\n\n  /**\n   * Agent skill type - determines baseline behavioral instructions\n   */\n  skillType: z.enum(FlowsActors_Agent_Skill_Type),\n\n  //====================\n  // CONSTRAINTS (highest precedence)\n  //====================\n\n  /**\n   * Constraints - HIGHEST precedence, never violate\n   * Different from instructions: constraints are prohibitions, instructions are rules\n   */\n  constraints: z.array(FlowsActors_Agent_ConstraintSchema).optional(),\n\n  //====================\n  // GOAL\n  //====================\n\n  /**\n   * Goal statement - what the agent aims to achieve\n   * Single sentence describing success criteria\n   */\n  goal: z.string().optional(),\n\n  //====================\n  // OUTPUT SPECIFICATION\n  //====================\n\n  /**\n   * Output specification - format and structure requirements\n   */\n  output: FlowsActors_Agent_OutputSpecSchema.optional(),\n\n  //====================\n  // INSTRUCTIONS & HINTS\n  //====================\n\n  /** Hard rules - behavioral instructions (in addition to skill type baseline) */\n  instructions: z.array(z.string()).default([]),\n\n  /** Soft hints - preferences, can be overridden by task constraints */\n  hints: z.array(z.string()).optional(),\n\n  //====================\n  // UNCERTAINTY HANDLING\n  //====================\n\n  /**\n   * Uncertainty handling policy\n   */\n  uncertainty: FlowsActors_Agent_UncertaintySchema.optional(),\n\n  //====================\n  // SCOPE BOUNDARIES\n  //====================\n\n  /**\n   * Scope boundaries - explicit \"don't do\" statements\n   * Helps prevent scope creep\n   */\n  outOfScope: z.array(z.string()).optional(),\n\n  //====================\n  // EXAMPLES (few-shot)\n  //====================\n\n  /**\n   * Examples - few-shot examples for better output quality\n   * Format: input/output pairs with optional explanation\n   */\n  examples: z.array(z.object({\n    input: z.string(),\n    output: z.string(),\n    explanation: z.string().optional(),\n  })).optional(),\n\n  //====================\n  // STYLE\n  //====================\n\n  /** Style preferences */\n  style: z.object({\n    verbosity: z.enum(FlowsActors_Agent_Verbosity).optional(),\n    tone: z.enum(FlowsActors_Agent_Tone).optional(),\n  }).optional(),\n\n  //====================\n  // CONTEXT CURATION\n  //====================\n\n  /** Context curation settings */\n  curation: z.object({\n    /** Maximum context items to include */\n    maxItems: z.number().min(1).max(100).optional(),\n    /** Minimum relevance score threshold (0-1) */\n    minRelevance: z.number().min(0).max(1).optional(),\n    /** Maximum total tokens for context */\n    maxTokens: z.number().optional(),\n  }).optional(),\n\n  //====================\n  // FORMAT & METADATA\n  //====================\n\n  /** Override provider's default prompt format */\n  promptFormatOverride: z.enum(LLMProvider_PromptFormat).optional(),\n\n  /**\n   * Prompt specification metadata for versioning and tracking\n   * Helps track prompt iterations and authorship for 200+ agents\n   */\n  metadata: z.object({\n    /** Semantic version of this prompt spec (e.g., \"1.2.0\") */\n    version: z.string().optional(),\n    /** Last modification date (ISO 8601) */\n    lastModified: z.string().optional(),\n    /** Author or team responsible */\n    author: z.string().optional(),\n    /** Brief changelog or reason for current version */\n    changelog: z.string().optional(),\n  }).optional(),\n});\n\nexport type FlowsActors_Agent_PromptSpec = z.infer<typeof FlowsActors_Agent_PromptSpecSchema>;\n/** @wildo_source:part:end saas.models.flows-actors.agent-prompt-spec */\n\n\n//===============================================================\n// FlowsActors_Agent Schema (Clean Implementation)\n// FlowsActors_Agents are AI-powered entities with specific roles and capabilities\n// They are called by Flow Steps (AGENT_CALL) and Actors (AGENTIC mode)\n//===============================================================\n\n/** @wildo_source:part:start saas.models.flows-actors.agent-definition facet:kind:api facet:audience:app-developer\n *\n * A callable AI unit. This is the whole authoring surface for \"give my app an\n * LLM capability\": author one of these, register it on your backend module's\n * `flowsActors.agents`, then invoke it by `ref`.\n *\n * The definition is DECLARATIVE and durable — provider, model, operation, and\n * prompt live here; the per-call task lives in the invocation. Nothing about\n * transport, retries, rate limiting, usage accounting, or tracing is yours to\n * write: the engine owns all of it once the agent is registered.\n *\n * Import path: `@wildo-ai/saas-models`.\n */\nexport type FlowsActors_Agent = {\n  //====================\n  // IDENTITY\n  //====================\n\n  /** Unique agent reference for flow/actor calls */\n  ref: string,\n\n  /** Human-readable display name */\n  displayName: string,\n\n  /** Agent lifecycle status */\n  status: FlowsActors_Agent_Status,\n\n  //====================\n  // EXECUTION CONFIGURATION (modality-discriminated)\n  //====================\n\n  /** Provider/model config, discriminated by modality (LLM/text | image | coding). */\n  config: FlowsActors_Agent_Configuration,\n\n  /** Operation definition (input/output schemas, etc.), per transport family. */\n  operationDefinition: LLMProvider_OperationDefinitionBase | ImageProvider_OperationDefinitionBase | CodingAgent_OperationDefinitionBase,\n\n  //====================\n  // ARTIFACT MODALITY (optional — explicit override; else derived from config)\n  //====================\n\n  /**\n   * The modality this agent PRODUCES, as documentation.\n   *\n   * Declarative only: no runtime path reads it. Dispatch is decided entirely by\n   * the arm of `config`, so setting or omitting this field changes nothing about\n   * which provider protocol the agent reaches. Set it to make a multimodal\n   * agent's output self-describing to a reader.\n   */\n  outputModality?: FlowsActors_IO_PartKind,\n\n  /** The modalities this agent CONSUMES (e.g. `[TEXT]` for text-to-image). */\n  inputModalities?: FlowsActors_IO_PartKind[],\n\n  //====================\n  // PROMPT SPECIFICATION (required)\n  //====================\n\n  /**\n   * Complete prompt specification\n   * Defines role, persona, constraints, instructions, output format, etc.\n   */\n  promptSpec: FlowsActors_Agent_PromptSpec,\n\n  //====================\n  // CAPABILITIES\n  //====================\n\n  /** Agent capabilities (tools, etc.) */\n  capabilities?: {\n    tools?: {\n      /**\n       * References to callable functions.\n       *\n       * RESOLVED: `AgentsBackendService` looks each ref up through\n       * `flowsActorsRegistry.getFunctionTool(ref)` and hands the model a callable tool. An unknown\n       * ref is skipped with a debug line rather than failing the turn.\n       */\n      functionRefs: string[],\n      /**\n       * References to MCP servers the agent may reach.\n       *\n       * ## CHECKED, NOT YET CALLABLE (#491)\n       *\n       * Each ref must name an MCP server the APPLICATION declared (`FlowsActors_McpServer`), and\n       * `FlowsActorsRegistryService` REFUSES at initialization an agent whose refs name none. That\n       * closes the shape this field was in: it used to resolve against nothing, so a shipped catalog\n       * carried seven refs (`filesystem-mcp`, `git-mcp`, `browser-mcp`, `mongodb-mcp`, …) that named\n       * no server anywhere while the agent card rendered them as capabilities — a claim shown to a\n       * user about a reach the agent did not have. The catalog is gone and the card no longer\n       * renders these.\n       *\n       * The check is deliberately stricter than `functionRefs`, which skip an unknown ref with a\n       * debug line: an unknown `functionRef` costs an agent one tool, whereas these were presented\n       * as a capability, and a refusal makes the old state unreachable rather than fixed once.\n       *\n       * ## What is still missing before a ref becomes a CALLABLE tool\n       *\n       * The declaration is checkable; the call is not yet made. `AgentsBackendService` resolves\n       * `functionRefs` and nothing else, so an agent carrying `mcpRefs` still has exactly the reach\n       * its `functionRefs` give it.\n       *\n       * 1. **An MCP client.** `saas-backend-lib/src/mcp/` is the SERVER Wildo exposes to external MCP\n       *    clients. There is no client, and no MCP client SDK in any manifest.\n       * 2. ~~A server registry~~ — BUILT. `registry.mcpServers`, declared per application.\n       * 3. **Credential resolution at call time.** Decided 2026-09-09: the call carries the acting\n       *    user's own delegated provider credential where present and the organization's connection\n       *    otherwise, from `userProviderCredentials` / `organizationProviderCredentials` rather than\n       *    a store invented for MCP. `FlowsActors_McpCredentialSubject` records that choice per\n       *    server; nothing reads it yet.\n       *\n       * Also decided, and not yet implemented: an unreachable server contributes NO tools to a turn\n       * rather than failing it — tools are discovered at turn start — and a call that fails mid-turn\n       * returns a typed error the agent can reason about. Both emit an audit event, because a server\n       * quietly unreachable for a week must be visible as that rather than as an agent that became\n       * less capable for no stated reason.\n       *\n       * Restoring these to any surface that presents them as a capability belongs in the same change\n       * that makes them callable.\n       */\n      mcpRefs: string[],\n    },\n  },\n\n  //====================\n  // VERSIONING\n  //====================\n\n  /** Agent definition version */\n  version?: string,\n\n  /** Creation timestamp (ISO 8601) */\n  createdAt: string,\n\n  /** Last update timestamp (ISO 8601) */\n  updatedAt?: string,\n};\n/** @wildo_source:part:end saas.models.flows-actors.agent-definition */\n\n\n/** @wildo_source:part:start saas.models.flows-actors.agent-invocation facet:kind:api facet:audience:app-developer\n *\n * One call to one agent — the envelope you build and hand to\n * `AgentsBackendService.invokeAgent`, and the SAME shape you get back with\n * `output` and `executionContext` filled in.\n *\n * What you supply:\n * - `agentRef` — the `ref` of a registered agent (unknown ref throws).\n * - `input` — the per-call task. `{ prompt }` for text; add `{ schema }` (a Zod\n *   schema) for `GENERATE_STRUCTURED`, which REQUIRES it. Anything else you put\n *   here is JSON-serialized into the user prompt.\n * - `output` — an empty value of the expected shape (`{ text: '' }`,\n *   `{ object: {} }`). It is a typing seed; the returned envelope replaces it.\n * - `initiator` / `invocationContext` / `artifactBindings` — `{}` / `[]` / `[]`\n *   when you have nothing to correlate.\n *\n * What comes back: `output` normalized to the operation's shape, and\n * `executionContext` enriched with `executionTime`, `finishedAt`, and provider\n * `usage` (tokens) when the transport reports it.\n *\n * Import path: `@wildo-ai/saas-models`.\n */\nexport type FlowsActors_Agent_Invocation<\n  InputSchema extends z.ZodSchema<any> = z.ZodSchema<any>,\n  OutputSchema extends z.ZodSchema<any> = z.ZodSchema<any>,\n  ContextSchema extends z.ZodSchema<any> = z.ZodSchema<any>,\n> = {\n  _id?: string,\n  agentRef: string,\n  initiator: ExecutionContext_InitiatorIds,\n  invocationContext : FlowsActors_Relationship[],\n\n  input: z.infer<InputSchema>,\n  output: z.infer<OutputSchema>,\n  executionContext: z.infer<ContextSchema>,\n  artifactBindings: {\n    kind: FlowsActors_IO_PartKind,\n    ref: string,\n  }[],\n\n};\n/** @wildo_source:part:end saas.models.flows-actors.agent-invocation */\n"]}

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

@@ -565,6 +565,19 @@ export interface DeliberationProducer {
 export interface DeliberationExpertBinding {
     profile: RuntimeExpertProfile;
     agentRef: string;
+    /**
+     * What THIS seat reads beyond the shared brief — the per-role context slice (#1423).
+     *
+     * Every expert used to receive one identical `briefContext`, so a panel of narrow specialists
+     * differed only in charter prose: the design-system guardian and the brand strategist judged the same
+     * text. The per-role need was already declared as data — `ExpertRoleTemplate.shapingInputKinds` — and
+     * was applied once, at charter DERIVATION, then frozen into prose; nothing carried it into a run.
+     *
+     * Composed by the COMPANION, which owns the families, and appended by the machinery to this seat's
+     * prompts only. Absent means this seat reads the shared brief alone, which is what every seat did
+     * before. Selection from a DECLARED need, never a planner choosing per agent at run time (#251).
+     */
+    roleContext?: string;
 }
 /**
  * The full input of `executeDeliberation` — composed by the COMPANION

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

@@ -1 +1 @@
-{"version":3,"file":"deliberation.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/flows-actors/deliberation.shared.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"deliberation.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/deliberation.shared.schemas.ts"],"names":[],"mappings":"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"}