@wildo-ai/saas-models 1.1.3 → 1.1.5

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

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { FlowsActors_CircuitBreaker_Status, FlowsActors_ElementKind, FlowsActors_Status } from "./flows-actors.commons.shared.schemas";
+import { FlowsActors_ElementKind, FlowsActors_Status } from "./flows-actors.commons.shared.schemas";
 export declare enum Actors_Memory_Scope {
     SHORT_TERM = "short_term",
     LONG_TERM = "long_term",
@@ -91,37 +91,71 @@ export declare enum Actor_Task_Topics {
     RESEARCH = "RESEARCH",
     PLANNING = "PLANNING",
     IMPLEMENTATION = "IMPLEMENTATION",
-    VERIFICATION = "VERIFICATION"
+    VERIFICATION = "VERIFICATION",
+    /**
+     * One step of a METHOD — a playbook run, in the app-creation lane's words, though the member is
+     * named for the shape and not the consumer: a unit of work that follows an authored methodology
+     * and may itself plan, research, implement or verify. Added 2026-09-20 (#1358); until then a
+     * playbook run was filed under `PLANNING` with a comment recording the mismatch.
+     */
+    METHOD_STEP = "METHOD_STEP"
 }
 /**
- * The sanctioned correlation slot on a task (meta-workflows Step 1 / P-8).
+ * What a task is correlated BACK to, in the vocabulary of whichever domain dispatched it.
  *
- * All fields are optional: tasks created outside a journey carry an empty
- * context. Meta-workflow playbook runs populate these so a task row links
- * back to its journey / playbook / run without abusing `topic` (which stays
- * the 5-value work-kind enum) or the prompt-visible agent
- * `executionContext`.
+ * ## Why the engine owns an envelope and not a field list
  *
- * IMPORTANT: fields MUST be declared here before any producer sends them —
- * `z.object({})` strips every key on parse, so undeclared context silently
- * vanishes through the companion's create-task request derivation (which
- * reuses this schema via `Actors_Task_Schema.shape.context` and therefore
- * auto-inherits these fields).
+ * Until 2026-09-19 this object declared five fields by name — `journeyId`, `playbookRef`,
+ * `playbookVersion`, `playbookRunId`, `stepRef` — so the GENERIC actor task carried one named
+ * consumer's vocabulary. A second topic using the task plane inherited those names and had nowhere
+ * to put its own, which is the coupling #1332 exists to remove.
+ *
+ * They were also, all five, **never written**. Measured 2026-09-19: `journeyId` and `playbookRunId`
+ * had zero writers anywhere, the only production creator of a task passed `context: {}`, and the
+ * correlation the app-creation lane actually uses is a bespoke `workbenchBuildPlanTaskId` foreign
+ * key bolted onto the persisted platform row. So the engine was reserving five names for a
+ * correlation nobody populated.
+ *
+ * The forcing function that produced them is real and is why this is an ENVELOPE rather than
+ * nothing: `z.object({})` strips every key on parse, so a producer's context vanishes silently
+ * unless the schema declares somewhere to put it. The engine therefore owns the SLOT and its rule;
+ * the dispatching domain owns the CONTENT and validates it at its own boundary.
+ *
+ * ## The contract
+ *
+ * - `domain` names who the refs belong to, as a stable identifier (`application-creation`,
+ *   `technical-documentation`, an application's own). It is deliberately OPEN: the whole point is
+ *   that a topic the engine has never heard of can correlate its work.
+ * - `refs` is that domain's own key/value set. The engine checks only that keys and values are
+ *   non-empty strings; what the keys MEAN, and which are required, is the domain's schema to
+ *   declare and enforce where it creates the task.
+ *
+ * No domain payload is declared anywhere yet, deliberately: nothing writes a correlation today, and
+ * declaring a shape for a producer that does not exist is how the five dead fields happened. The
+ * first producer declares its own (see #1343, which is where a playbook run starts creating tasks).
+ */
+export declare const Actors_Task_Correlation_Schema: z.ZodObject<{
+    domain: z.ZodString;
+    refs: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>;
+export type Actors_Task_Correlation = z.infer<typeof Actors_Task_Correlation_Schema>;
+/**
+ * Task context. Absent correlation is the normal case — a task dispatched by nothing in particular
+ * carries none.
  */
 export declare const Actors_Task_Context_Schema: z.ZodObject<{
-    journeyId: z.ZodOptional<z.ZodString>;
-    playbookRef: z.ZodOptional<z.ZodString>;
-    playbookVersion: z.ZodOptional<z.ZodString>;
-    playbookRunId: z.ZodOptional<z.ZodString>;
-    stepRef: z.ZodOptional<z.ZodString>;
+    correlation: z.ZodOptional<z.ZodObject<{
+        domain: z.ZodString;
+        refs: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type Actors_Task_Context = z.infer<typeof Actors_Task_Context_Schema>;
 export declare const Actors_Task_Schema: z.ZodObject<{
     _id: z.ZodString;
     title: z.ZodString;
     description: z.ZodString;
-    topic: z.ZodEnum<typeof Actor_Task_Topics>;
-    status: z.ZodEnum<typeof FlowsActors_Status>;
+    topic: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof Actor_Task_Topics>>;
+    status: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof FlowsActors_Status>>;
     initiator: z.ZodObject<{
         organizationId: z.ZodOptional<z.ZodString>;
         userId: z.ZodOptional<z.ZodString>;
@@ -225,11 +259,10 @@ export declare const Actors_Task_Schema: z.ZodObject<{
         }, z.core.$strip>;
     }, z.core.$strip>;
     context: z.ZodObject<{
-        journeyId: z.ZodOptional<z.ZodString>;
-        playbookRef: z.ZodOptional<z.ZodString>;
-        playbookVersion: z.ZodOptional<z.ZodString>;
-        playbookRunId: z.ZodOptional<z.ZodString>;
-        stepRef: z.ZodOptional<z.ZodString>;
+        correlation: z.ZodOptional<z.ZodObject<{
+            domain: z.ZodString;
+            refs: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
     artifacts: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         ref: z.ZodString;
@@ -342,7 +375,6 @@ export declare const Actors_Task_Schema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     errorStates: z.ZodOptional<z.ZodObject<{
-        circuitBreakerStatus: z.ZodOptional<z.ZodEnum<typeof FlowsActors_CircuitBreaker_Status>>;
         errorItems: z.ZodOptional<z.ZodArray<z.ZodObject<{
             type: z.ZodEnum<typeof import("..").ErrorType>;
             severity: z.ZodEnum<typeof import("..").ErrorSeverity>;
@@ -604,7 +636,6 @@ export declare const ActorsSystem_ExecutionPlan_Schema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     errorStates: z.ZodOptional<z.ZodObject<{
-        circuitBreakerStatus: z.ZodOptional<z.ZodEnum<typeof FlowsActors_CircuitBreaker_Status>>;
         errorItems: z.ZodOptional<z.ZodArray<z.ZodObject<{
             type: z.ZodEnum<typeof import("..").ErrorType>;
             severity: z.ZodEnum<typeof import("..").ErrorSeverity>;
@@ -706,58 +737,4 @@ export declare const ActorsSystem_ExecutionPlan_Schema: z.ZodObject<{
     updatedAt: z.ZodString;
 }, z.core.$strip>;
 export type ActorsSystem_ExecutionPlan = z.infer<typeof ActorsSystem_ExecutionPlan_Schema>;
-export declare const Actors_Walkthrough_Schema: z.ZodObject<{
-    _id: z.ZodString;
-    name: z.ZodString;
-    description: z.ZodString;
-    status: z.ZodEnum<typeof FlowsActors_Status>;
-    initiator: z.ZodObject<{
-        organizationId: z.ZodOptional<z.ZodString>;
-        userId: z.ZodOptional<z.ZodString>;
-        applicationId: z.ZodOptional<z.ZodString>;
-        machineCredential: z.ZodOptional<z.ZodObject<{
-            authMethod: z.ZodEnum<typeof import("..").MachineAuthMethod>;
-            credentialId: z.ZodString;
-        }, z.core.$strip>>;
-        consumableTokenId: z.ZodOptional<z.ZodString>;
-        webhookProviderId: z.ZodOptional<z.ZodString>;
-        anonymousUserId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-    relationships: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
-        kind: z.ZodLiteral<FlowsActors_ElementKind.FLOW>;
-        relation: z.ZodEnum<typeof import("./flows-actors.commons.shared.schemas").FlowsActors_Relation>;
-        flowId: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<FlowsActors_ElementKind.ACTOR>;
-        relation: z.ZodEnum<typeof import("./flows-actors.commons.shared.schemas").FlowsActors_Relation>;
-        actorId: z.ZodString;
-        actorSystemId: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<FlowsActors_ElementKind.FLOW_STEP>;
-        relation: z.ZodEnum<typeof import("./flows-actors.commons.shared.schemas").FlowsActors_Relation>;
-        flowId: z.ZodString;
-        stepId: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<FlowsActors_ElementKind.TASK>;
-        relation: z.ZodEnum<typeof import("./flows-actors.commons.shared.schemas").FlowsActors_Relation>;
-        taskId: z.ZodString;
-        actorSystemId: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<FlowsActors_ElementKind.PLAN>;
-        relation: z.ZodEnum<typeof import("./flows-actors.commons.shared.schemas").FlowsActors_Relation>;
-        planId: z.ZodString;
-        actorSystemId: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<FlowsActors_ElementKind.PLAN_STEP>;
-        relation: z.ZodEnum<typeof import("./flows-actors.commons.shared.schemas").FlowsActors_Relation>;
-        planId: z.ZodString;
-        planStepId: z.ZodString;
-        actorSystemId: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<FlowsActors_ElementKind.ACTOR_SYSTEM>;
-        relation: z.ZodEnum<typeof import("./flows-actors.commons.shared.schemas").FlowsActors_Relation>;
-        actorSystemId: z.ZodString;
-    }, z.core.$strip>], "kind">>;
-}, z.core.$strip>;
-export type Actors_Walkthrough = z.infer<typeof Actors_Walkthrough_Schema>;
 //# sourceMappingURL=tasks.actors.shared.schemas.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tasks.actors.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/tasks.actors.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAiC,iCAAiC,EAAE,uBAAuB,EAAmE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAgBvO,oBAAY,mBAAmB;IAC7B,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB;AAED,eAAO,MAAM,yBAAyB;;;;;;;;;;;iBAOpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;iBAIpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAItC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAgBhF,oBAAY,iBAAiB;IAC3B,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,cAAc,mBAAmB;IACjC,YAAY,iBAAiB;CAC9B;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,0BAA0B;;;;;;iBAWrC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE7E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqD7B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAgB7D,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgBjD,CAAC;AACH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AAErG,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmC5C,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAM3F,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQpC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}
+{"version":3,"file":"tasks.actors.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/tasks.actors.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAiC,uBAAuB,EAAmE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AA2BpM,oBAAY,mBAAmB;IAC7B,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB;AAED,eAAO,MAAM,yBAAyB;;;;;;;;;;;iBAOpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;iBAIpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAItC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAgBhF,oBAAY,iBAAiB;IAC3B,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,cAAc,mBAAmB;IACjC,YAAY,iBAAiB;IAC7B;;;;;OAKG;IACH,WAAW,gBAAgB;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,8BAA8B;;;iBAKzC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAErF;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;iBAErC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE7E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4D7B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAgB7D,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgBjD,CAAC;AACH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AAErG,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkC5C,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC"}

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

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { ArtifactInstanceSchema } from "./flows-actors.io.shared.schemas.js";
-import { FlowsActors_Checkpoint_Schema, FlowsActors_CircuitBreaker_Status, FlowsActors_RelationshipSchema, FlowsActors_Status } from "./flows-actors.commons.shared.schemas.js";
+import { FlowsActors_Checkpoint_Schema, FlowsActors_RelationshipSchema, FlowsActors_Status } from "./flows-actors.commons.shared.schemas.js";
 import { WildoError_BackendSchema } from "../errors/errors.shared.schemas.js";
 import { ExecutionContext_InitiatorIdsSchema } from "../runtime/execution-context.shared.schemas.js";
 //===============================================================
@@ -11,6 +11,17 @@ import { ExecutionContext_InitiatorIdsSchema } from "../runtime/execution-contex
 // long-term (persistent knowledge), and working (active processing).
 // This enables stateful conversations, knowledge accumulation,
 // and context-aware decision making in AI-powered workflows.
+//
+// PLANNED SURFACE — KEEP (decided by Paul, 2026-09-21, #1363).
+// Nothing writes `Actors_Task.memory` yet, and that is NOT evidence it
+// is dead. Its intended meaning is the task's CONSOLIDATED memory: what
+// the content of an issue is to a piece of work — the elements that must
+// be kept as the task advances (decisions taken, facts established,
+// what was tried), registered ON the task so a later turn, a resumed
+// run or another actor reads them instead of re-deriving them. A
+// "zero readers" sweep will keep finding this field until its first
+// writer lands; do not delete it, its columns or its components on
+// that measurement.
 //===============================================================
 export var Actors_Memory_Scope;
 (function (Actors_Memory_Scope) {
@@ -52,40 +63,75 @@ export var Actor_Task_Topics;
     Actor_Task_Topics["PLANNING"] = "PLANNING";
     Actor_Task_Topics["IMPLEMENTATION"] = "IMPLEMENTATION";
     Actor_Task_Topics["VERIFICATION"] = "VERIFICATION";
+    /**
+     * One step of a METHOD — a playbook run, in the app-creation lane's words, though the member is
+     * named for the shape and not the consumer: a unit of work that follows an authored methodology
+     * and may itself plan, research, implement or verify. Added 2026-09-20 (#1358); until then a
+     * playbook run was filed under `PLANNING` with a comment recording the mismatch.
+     */
+    Actor_Task_Topics["METHOD_STEP"] = "METHOD_STEP";
 })(Actor_Task_Topics || (Actor_Task_Topics = {}));
 /**
- * The sanctioned correlation slot on a task (meta-workflows Step 1 / P-8).
+ * What a task is correlated BACK to, in the vocabulary of whichever domain dispatched it.
  *
- * All fields are optional: tasks created outside a journey carry an empty
- * context. Meta-workflow playbook runs populate these so a task row links
- * back to its journey / playbook / run without abusing `topic` (which stays
- * the 5-value work-kind enum) or the prompt-visible agent
- * `executionContext`.
+ * ## Why the engine owns an envelope and not a field list
  *
- * IMPORTANT: fields MUST be declared here before any producer sends them —
- * `z.object({})` strips every key on parse, so undeclared context silently
- * vanishes through the companion's create-task request derivation (which
- * reuses this schema via `Actors_Task_Schema.shape.context` and therefore
- * auto-inherits these fields).
+ * Until 2026-09-19 this object declared five fields by name — `journeyId`, `playbookRef`,
+ * `playbookVersion`, `playbookRunId`, `stepRef` — so the GENERIC actor task carried one named
+ * consumer's vocabulary. A second topic using the task plane inherited those names and had nowhere
+ * to put its own, which is the coupling #1332 exists to remove.
+ *
+ * They were also, all five, **never written**. Measured 2026-09-19: `journeyId` and `playbookRunId`
+ * had zero writers anywhere, the only production creator of a task passed `context: {}`, and the
+ * correlation the app-creation lane actually uses is a bespoke `workbenchBuildPlanTaskId` foreign
+ * key bolted onto the persisted platform row. So the engine was reserving five names for a
+ * correlation nobody populated.
+ *
+ * The forcing function that produced them is real and is why this is an ENVELOPE rather than
+ * nothing: `z.object({})` strips every key on parse, so a producer's context vanishes silently
+ * unless the schema declares somewhere to put it. The engine therefore owns the SLOT and its rule;
+ * the dispatching domain owns the CONTENT and validates it at its own boundary.
+ *
+ * ## The contract
+ *
+ * - `domain` names who the refs belong to, as a stable identifier (`application-creation`,
+ *   `technical-documentation`, an application's own). It is deliberately OPEN: the whole point is
+ *   that a topic the engine has never heard of can correlate its work.
+ * - `refs` is that domain's own key/value set. The engine checks only that keys and values are
+ *   non-empty strings; what the keys MEAN, and which are required, is the domain's schema to
+ *   declare and enforce where it creates the task.
+ *
+ * No domain payload is declared anywhere yet, deliberately: nothing writes a correlation today, and
+ * declaring a shape for a producer that does not exist is how the five dead fields happened. The
+ * first producer declares its own (see #1343, which is where a playbook run starts creating tasks).
+ */
+export const Actors_Task_Correlation_Schema = z.object({
+    /** Stable identifier of the domain whose vocabulary `refs` uses. */
+    domain: z.string().min(1),
+    /** That domain's correlation keys. Opaque to the engine; validated by the domain. */
+    refs: z.record(z.string().min(1), z.string().min(1)),
+});
+/**
+ * Task context. Absent correlation is the normal case — a task dispatched by nothing in particular
+ * carries none.
  */
 export const Actors_Task_Context_Schema = z.object({
-    /** Journey this task belongs to (`Journey_Definition.journeyId`). */
-    journeyId: z.string().min(1).optional(),
-    /** Playbook that emitted the task (`MetaWorkflowPlaybook.ref`). */
-    playbookRef: z.string().min(1).optional(),
-    /** Version of that playbook at dispatch time. */
-    playbookVersion: z.string().min(1).optional(),
-    /** ActorSystem execution `_id` of the playbook run that owns the task. */
-    playbookRunId: z.string().min(1).optional(),
-    /** Optional finer step locator inside the playbook's method. */
-    stepRef: z.string().min(1).optional(),
+    correlation: Actors_Task_Correlation_Schema.optional(),
 });
 export const Actors_Task_Schema = z.object({
     _id: z.string(),
     title: z.string(),
     description: z.string(),
-    topic: z.enum(Actor_Task_Topics),
-    status: z.enum(FlowsActors_Status),
+    /*
+     * Both vocabularies DECLARE themselves (#966), which is what lets their words be authored ONCE
+     * under `system_enums.<Name>.<value>` instead of per field path. Without the declaration the
+     * frontend cascade has no vocabulary to fall back to and renders the raw constant — `PROCESSING`,
+     * `IMPLEMENTATION` — which is precisely the "a missing label must LOOK missing" state, on two
+     * fields every surface that shows a task renders. Metadata only: an application that authors no
+     * block still renders the raw value, exactly as before.
+     */
+    topic: z.enum(Actor_Task_Topics).systemEnum('Actor_Task_Topics'),
+    status: z.enum(FlowsActors_Status).systemEnum('FlowsActors_Status'),
     initiator: ExecutionContext_InitiatorIdsSchema,
     relationships: z.array(FlowsActors_RelationshipSchema),
     actors: z.object({
@@ -107,7 +153,6 @@ export const Actors_Task_Schema = z.object({
         })),
     }).array(),
     errorStates: z.object({
-        circuitBreakerStatus: z.enum(FlowsActors_CircuitBreaker_Status).optional(),
         errorItems: WildoError_BackendSchema.extend({
             actorRef: z.string(),
         }).array().optional(),
@@ -162,7 +207,6 @@ export const ActorsSystem_ExecutionPlan_Schema = z.object({
         })),
     }).array(),
     errorStates: z.object({
-        circuitBreakerStatus: z.enum(FlowsActors_CircuitBreaker_Status).optional(),
         errorItems: WildoError_BackendSchema.extend({
             planStepId: z.string(),
         }).array().optional(),
@@ -175,16 +219,9 @@ export const ActorsSystem_ExecutionPlan_Schema = z.object({
     createdAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),
     updatedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),
 });
-//===============================================================
-//  Walkthrough
-//===============================================================
-export const Actors_Walkthrough_Schema = z.object({
-    _id: z.string(),
-    name: z.string(),
-    description: z.string(),
-    status: z.enum(FlowsActors_Status),
-    initiator: ExecutionContext_InitiatorIdsSchema,
-    relationships: z.array(FlowsActors_RelationshipSchema),
-    // TODO for real
-});
+/*
+ * `Actors_Walkthrough` was removed on 2026-09-20 (#1363): five identity fields and a `// TODO for
+ * real`, carried as an optional `walkthrough` on every actor execution — a column, a label and a
+ * display line for a thing with no writer, no reader and no definition of what it was.
+ */
 //# sourceMappingURL=tasks.actors.shared.schemas.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"tasks.actors.shared.schemas.js","sourceRoot":"","sources":["../../../../src/flows-actors/tasks.actors.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,6BAA6B,EAAE,iCAAiC,EAA4D,8BAA8B,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AACvO,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,mCAAmC,EAAE,MAAM,6CAA6C,CAAC;AAIlG,iEAAiE;AACjE,gBAAgB;AAChB,WAAW;AACX,wEAAwE;AACxE,2DAA2D;AAC3D,qEAAqE;AACrE,+DAA+D;AAC/D,6DAA6D;AAC7D,iEAAiE;AAEjE,MAAM,CAAN,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,gDAAyB,CAAA;IACzB,8CAAuB,CAAA;IACvB,0CAAmB,CAAA;AACrB,CAAC,EAJW,mBAAmB,KAAnB,mBAAmB,QAI9B;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACvD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,yBAAyB,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC3B,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,SAAS,EAAE,yBAAyB;IACpC,QAAQ,EAAE,yBAAyB;IACnC,OAAO,EAAE,yBAAyB;CACnC,CAAC,CAAC;AAMH,iEAAiE;AACjE,eAAe;AACf,WAAW;AACX,4EAA4E;AAC5E,sEAAsE;AACtE,oEAAoE;AACpE,gEAAgE;AAChE,kDAAkD;AAClD,iEAAiE;AAIjE,MAAM,CAAN,IAAY,iBAMX;AAND,WAAY,iBAAiB;IAC3B,8CAAyB,CAAA;IACzB,0CAAqB,CAAA;IACrB,0CAAqB,CAAA;IACrB,sDAAiC,CAAA;IACjC,kDAA6B,CAAA;AAC/B,CAAC,EANW,iBAAiB,KAAjB,iBAAiB,QAM5B;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,qEAAqE;IACrE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvC,mEAAmE;IACnE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzC,iDAAiD;IACjD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7C,0EAA0E;IAC1E,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3C,gEAAgE;IAChE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IAEf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC;IAEhC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC;IAClC,SAAS,EAAE,mCAAmC;IAC9C,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC;IAEtD,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,mEAAmE;QACnE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACrB,CAAC;IAEF,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE;IACd,MAAM,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAE1B,MAAM,EAAE,2BAA2B;IACnC,OAAO,EAAE,0BAA0B;IAGnC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,QAAQ,EAAE;IAGrD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC;QAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;QACpG,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;YAC9B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC;YAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;SACrG,CAAC,CAAC;KACJ,CAAC,CAAC,KAAK,EAAE;IAEV,WAAW,EAAG,CAAC,CAAC,MAAM,CAAC;QACrB,oBAAoB,EAAE,CAAC,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC,QAAQ,EAAE;QAC1E,UAAU,EAAE,wBAAwB,CAAC,MAAM,CAAC;YAC1C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;SACrB,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;QACrB,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;YACjC,UAAU,EAAE,6BAA6B;YACzC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;SACrG,CAAC,CAAC;QAEH,oBAAoB,EAAE,6BAA6B,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;KACvE,CAAC,CAAC,QAAQ,EAAE;IAEb,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;IACpG,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;IACpG,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAMH,iEAAiE;AACjE,8BAA8B;AAC9B,WAAW;AACX,uFAAuF;AACvF,6DAA6D;AAC7D,8DAA8D;AAC9D,iEAAiE;AACjE,uDAAuD;AACvD,iEAAiE;AAIjE,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7D,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC;IACtD,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC;IAElC,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAC9B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC;QAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;KACrG,CAAC,CAAC;IAEH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;IACpG,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;CAErG,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC;IAClC,SAAS,EAAE,mCAAmC;IAC9C,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC;IAEtD,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,sCAAsC,CAAC;IAG1D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC;QAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;QACpG,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;YAC9B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC;YAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;SACrG,CAAC,CAAC;KACJ,CAAC,CAAC,KAAK,EAAE;IAEV,WAAW,EAAG,CAAC,CAAC,MAAM,CAAC;QACrB,oBAAoB,EAAE,CAAC,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC,QAAQ,EAAE;QAC1E,UAAU,EAAE,wBAAwB,CAAC,MAAM,CAAC;YAC1C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;SACvB,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;QACrB,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;YACjC,UAAU,EAAE,6BAA6B;YACzC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;SACrG,CAAC,CAAC;QAEH,oBAAoB,EAAE,6BAA6B,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;KACvE,CAAC,CAAC,QAAQ,EAAE;IAEb,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;IACpG,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;CACrG,CAAC,CAAC;AAGH,iEAAiE;AACjE,eAAe;AACf,iEAAiE;AAEjE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC;IAClC,SAAS,EAAE,mCAAmC;IAC9C,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC;IACtD,gBAAgB;CACjB,CAAC,CAAC","sourcesContent":["import { z } from \"zod\";\n\nimport { ArtifactInstanceSchema } from \"./flows-actors.io.shared.schemas\";\nimport { FlowsActors_Checkpoint_Schema, FlowsActors_CircuitBreaker_Status, FlowsActors_ElementKind, FlowsActors_Event_ContextSchema, FlowsActors_RelationshipSchema, FlowsActors_Status } from \"./flows-actors.commons.shared.schemas\";\nimport { WildoError_BackendSchema } from \"../errors/errors.shared.schemas\";\nimport { ExecutionContext_InitiatorIdsSchema } from \"../runtime/execution-context.shared.schemas\";\nimport { Flow_Node_RelationshipSchema } from \"./flows.shared.schemas\";\nimport { Actor_Role_Category } from \"./actors.shared.schemas\";\n\n//===============================================================\n// Actors_Memory\n// --------\n// Actors_Memory provides contextual storage for agents and tasks across\n// different time horizons: short-term (immediate context),\n// long-term (persistent knowledge), and working (active processing).\n// This enables stateful conversations, knowledge accumulation,\n// and context-aware decision making in AI-powered workflows.\n//===============================================================\n\nexport enum Actors_Memory_Scope {\n  SHORT_TERM = \"short_term\",\n  LONG_TERM = \"long_term\",\n  WORKING = \"working\",\n}\n\nexport const Actors_Memory_EntrySchema = z.object({\n  key: z.string(),\n  value: z.any(),\n  type: z.enum([\"text\", \"json\", \"binary\"]),\n  timestamp: z.string(),\n  expiresAt: z.string().optional(),\n  metadata: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport type Actors_Memory_Entry = z.infer<typeof Actors_Memory_EntrySchema>;\n\nexport const Actors_Memory_StoreSchema = z.object({\n  entries: z.array(Actors_Memory_EntrySchema),\n  maxSize: z.number().optional(),\n  ttl: z.number().optional(),\n});\n\nexport type Actors_Memory_Store = z.infer<typeof Actors_Memory_StoreSchema>;\n\nexport const Actors_Memory_ContextSchema = z.object({\n  shortTerm: Actors_Memory_StoreSchema,\n  longTerm: Actors_Memory_StoreSchema,\n  working: Actors_Memory_StoreSchema,\n});\n\nexport type Actors_Memory_Context = z.infer<typeof Actors_Memory_ContextSchema>;\n\n\n\n//===============================================================\n//  Actors_Task\n// --------\n// Actors_Tasks represent individual execution instances of flows or actors,\n// tracking their lifecycle from creation to completion. They maintain\n// execution context, budget constraints, error states, and detailed\n// history for monitoring, debugging, and cost management across\n// the distributed workflow execution environment.\n//===============================================================\n\n\n\nexport enum Actor_Task_Topics {\n  WEB_SEARCH = \"WEB_SEARCH\",\n  RESEARCH = \"RESEARCH\",\n  PLANNING = \"PLANNING\",\n  IMPLEMENTATION = \"IMPLEMENTATION\",\n  VERIFICATION = \"VERIFICATION\"\n}\n\n/**\n * The sanctioned correlation slot on a task (meta-workflows Step 1 / P-8).\n *\n * All fields are optional: tasks created outside a journey carry an empty\n * context. Meta-workflow playbook runs populate these so a task row links\n * back to its journey / playbook / run without abusing `topic` (which stays\n * the 5-value work-kind enum) or the prompt-visible agent\n * `executionContext`.\n *\n * IMPORTANT: fields MUST be declared here before any producer sends them —\n * `z.object({})` strips every key on parse, so undeclared context silently\n * vanishes through the companion's create-task request derivation (which\n * reuses this schema via `Actors_Task_Schema.shape.context` and therefore\n * auto-inherits these fields).\n */\nexport const Actors_Task_Context_Schema = z.object({\n  /** Journey this task belongs to (`Journey_Definition.journeyId`). */\n  journeyId: z.string().min(1).optional(),\n  /** Playbook that emitted the task (`MetaWorkflowPlaybook.ref`). */\n  playbookRef: z.string().min(1).optional(),\n  /** Version of that playbook at dispatch time. */\n  playbookVersion: z.string().min(1).optional(),\n  /** ActorSystem execution `_id` of the playbook run that owns the task. */\n  playbookRunId: z.string().min(1).optional(),\n  /** Optional finer step locator inside the playbook's method. */\n  stepRef: z.string().min(1).optional(),\n});\n\nexport type Actors_Task_Context = z.infer<typeof Actors_Task_Context_Schema>;\n\nexport const Actors_Task_Schema = z.object({\n  _id: z.string(),\n\n  title: z.string(),\n  description: z.string(),\n  topic: z.enum(Actor_Task_Topics),\n\n  status: z.enum(FlowsActors_Status),\n  initiator: ExecutionContext_InitiatorIdsSchema,\n  relationships: z.array(FlowsActors_RelationshipSchema),\n\n  actors: z.object({\n    // actorKind: z.enum(Actor_Role_Category), // circular dependencies\n    actorRef: z.string(),\n  }),\n\n  input: z.any(),\n  output: z.any().optional(),\n\n  memory: Actors_Memory_ContextSchema,\n  context: Actors_Task_Context_Schema,\n\n\n  artifacts: z.array(ArtifactInstanceSchema).optional(),\n\n\n  actorStates: z.object({\n    actorRef: z.string(),\n    status: z.enum(FlowsActors_Status),\n    updatedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n    statusChanges: z.array(z.object({\n      status: z.enum(FlowsActors_Status),\n      timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n    })),\n  }).array(),\n\n  errorStates : z.object({\n    circuitBreakerStatus: z.enum(FlowsActors_CircuitBreaker_Status).optional(),\n    errorItems: WildoError_BackendSchema.extend({\n      actorRef: z.string(),\n    }).array().optional(),\n    checkpointChecks: z.array(z.object({\n      checkpoint: FlowsActors_Checkpoint_Schema,\n      timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n    })),\n\n    availableCheckpoints: FlowsActors_Checkpoint_Schema.array().optional(),\n  }).optional(),\n\n  createdAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n  updatedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n  startedAt: z.string().optional(),\n  completedAt: z.string().optional(),\n});\n\nexport type Actors_Task = z.infer<typeof Actors_Task_Schema>;\n\n\n\n//===============================================================\n//  ActorsSystem_ExecutionPlan\n// --------\n// ActorsSystem_ExecutionPlans represent AI-generated execution strategies that outline\n// the steps needed to accomplish complex tasks. They provide\n// cost and duration estimates, dependency mapping, and can be\n// approved before execution, enabling predictable and controlled\n// automated workflow generation by intelligent agents.\n//===============================================================\n\n\n\nexport const ActorsSystem_ExecutionPlan_Step_Schema = z.object({\n  _id: z.string(),\n  name: z.string().optional(),\n  description: z.string().optional(),\n  topic: z.string(),\n  relationships: z.array(FlowsActors_RelationshipSchema),\n  status: z.enum(FlowsActors_Status),\n\n  statusChanges: z.array(z.object({\n    status: z.enum(FlowsActors_Status),\n    timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n  })),\n\n  createdAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n  updatedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n\n});\nexport type ActorsSystem_ExecutionPlan_Step = z.infer<typeof ActorsSystem_ExecutionPlan_Step_Schema>;\n\nexport const ActorsSystem_ExecutionPlan_Schema = z.object({\n  _id: z.string(),\n  goalDescription: z.string(),\n  status: z.enum(FlowsActors_Status),\n  initiator: ExecutionContext_InitiatorIdsSchema,\n  relationships: z.array(FlowsActors_RelationshipSchema),\n\n  planSteps: z.array(ActorsSystem_ExecutionPlan_Step_Schema),\n\n\n  stepStates: z.object({\n    planStepId: z.string(),\n    status: z.enum(FlowsActors_Status),\n    updatedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n    statusChanges: z.array(z.object({\n      status: z.enum(FlowsActors_Status),\n      timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n    })),\n  }).array(),\n\n  errorStates : z.object({\n    circuitBreakerStatus: z.enum(FlowsActors_CircuitBreaker_Status).optional(),\n    errorItems: WildoError_BackendSchema.extend({\n      planStepId: z.string(),\n    }).array().optional(),\n    checkpointChecks: z.array(z.object({\n      checkpoint: FlowsActors_Checkpoint_Schema,\n      timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n    })),\n\n    availableCheckpoints: FlowsActors_Checkpoint_Schema.array().optional(),\n  }).optional(),\n\n  createdAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n  updatedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n});\nexport type ActorsSystem_ExecutionPlan = z.infer<typeof ActorsSystem_ExecutionPlan_Schema>;\n\n//===============================================================\n//  Walkthrough\n//===============================================================\n\nexport const Actors_Walkthrough_Schema = z.object({\n  _id: z.string(),\n  name: z.string(),\n  description: z.string(),\n  status: z.enum(FlowsActors_Status),\n  initiator: ExecutionContext_InitiatorIdsSchema,\n  relationships: z.array(FlowsActors_RelationshipSchema),\n  // TODO for real\n});\nexport type Actors_Walkthrough = z.infer<typeof Actors_Walkthrough_Schema>;\n"]}
+{"version":3,"file":"tasks.actors.shared.schemas.js","sourceRoot":"","sources":["../../../../src/flows-actors/tasks.actors.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\nimport { ArtifactInstanceSchema } from \"./flows-actors.io.shared.schemas\";\nimport { FlowsActors_Checkpoint_Schema, FlowsActors_ElementKind, FlowsActors_Event_ContextSchema, FlowsActors_RelationshipSchema, FlowsActors_Status } from \"./flows-actors.commons.shared.schemas\";\nimport { WildoError_BackendSchema } from \"../errors/errors.shared.schemas\";\nimport { ExecutionContext_InitiatorIdsSchema } from \"../runtime/execution-context.shared.schemas\";\nimport { Flow_Node_RelationshipSchema } from \"./flows.shared.schemas\";\nimport { Actor_Role_Category } from \"./actors.shared.schemas\";\n\n//===============================================================\n// Actors_Memory\n// --------\n// Actors_Memory provides contextual storage for agents and tasks across\n// different time horizons: short-term (immediate context),\n// long-term (persistent knowledge), and working (active processing).\n// This enables stateful conversations, knowledge accumulation,\n// and context-aware decision making in AI-powered workflows.\n//\n// PLANNED SURFACE — KEEP (decided by Paul, 2026-09-21, #1363).\n// Nothing writes `Actors_Task.memory` yet, and that is NOT evidence it\n// is dead. Its intended meaning is the task's CONSOLIDATED memory: what\n// the content of an issue is to a piece of work — the elements that must\n// be kept as the task advances (decisions taken, facts established,\n// what was tried), registered ON the task so a later turn, a resumed\n// run or another actor reads them instead of re-deriving them. A\n// \"zero readers\" sweep will keep finding this field until its first\n// writer lands; do not delete it, its columns or its components on\n// that measurement.\n//===============================================================\n\nexport enum Actors_Memory_Scope {\n  SHORT_TERM = \"short_term\",\n  LONG_TERM = \"long_term\",\n  WORKING = \"working\",\n}\n\nexport const Actors_Memory_EntrySchema = z.object({\n  key: z.string(),\n  value: z.any(),\n  type: z.enum([\"text\", \"json\", \"binary\"]),\n  timestamp: z.string(),\n  expiresAt: z.string().optional(),\n  metadata: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport type Actors_Memory_Entry = z.infer<typeof Actors_Memory_EntrySchema>;\n\nexport const Actors_Memory_StoreSchema = z.object({\n  entries: z.array(Actors_Memory_EntrySchema),\n  maxSize: z.number().optional(),\n  ttl: z.number().optional(),\n});\n\nexport type Actors_Memory_Store = z.infer<typeof Actors_Memory_StoreSchema>;\n\nexport const Actors_Memory_ContextSchema = z.object({\n  shortTerm: Actors_Memory_StoreSchema,\n  longTerm: Actors_Memory_StoreSchema,\n  working: Actors_Memory_StoreSchema,\n});\n\nexport type Actors_Memory_Context = z.infer<typeof Actors_Memory_ContextSchema>;\n\n\n\n//===============================================================\n//  Actors_Task\n// --------\n// Actors_Tasks represent individual execution instances of flows or actors,\n// tracking their lifecycle from creation to completion. They maintain\n// execution context, budget constraints, error states, and detailed\n// history for monitoring, debugging, and cost management across\n// the distributed workflow execution environment.\n//===============================================================\n\n\n\nexport enum Actor_Task_Topics {\n  WEB_SEARCH = \"WEB_SEARCH\",\n  RESEARCH = \"RESEARCH\",\n  PLANNING = \"PLANNING\",\n  IMPLEMENTATION = \"IMPLEMENTATION\",\n  VERIFICATION = \"VERIFICATION\",\n  /**\n   * One step of a METHOD — a playbook run, in the app-creation lane's words, though the member is\n   * named for the shape and not the consumer: a unit of work that follows an authored methodology\n   * and may itself plan, research, implement or verify. Added 2026-09-20 (#1358); until then a\n   * playbook run was filed under `PLANNING` with a comment recording the mismatch.\n   */\n  METHOD_STEP = \"METHOD_STEP\",\n}\n\n/**\n * What a task is correlated BACK to, in the vocabulary of whichever domain dispatched it.\n *\n * ## Why the engine owns an envelope and not a field list\n *\n * Until 2026-09-19 this object declared five fields by name — `journeyId`, `playbookRef`,\n * `playbookVersion`, `playbookRunId`, `stepRef` — so the GENERIC actor task carried one named\n * consumer's vocabulary. A second topic using the task plane inherited those names and had nowhere\n * to put its own, which is the coupling #1332 exists to remove.\n *\n * They were also, all five, **never written**. Measured 2026-09-19: `journeyId` and `playbookRunId`\n * had zero writers anywhere, the only production creator of a task passed `context: {}`, and the\n * correlation the app-creation lane actually uses is a bespoke `workbenchBuildPlanTaskId` foreign\n * key bolted onto the persisted platform row. So the engine was reserving five names for a\n * correlation nobody populated.\n *\n * The forcing function that produced them is real and is why this is an ENVELOPE rather than\n * nothing: `z.object({})` strips every key on parse, so a producer's context vanishes silently\n * unless the schema declares somewhere to put it. The engine therefore owns the SLOT and its rule;\n * the dispatching domain owns the CONTENT and validates it at its own boundary.\n *\n * ## The contract\n *\n * - `domain` names who the refs belong to, as a stable identifier (`application-creation`,\n *   `technical-documentation`, an application's own). It is deliberately OPEN: the whole point is\n *   that a topic the engine has never heard of can correlate its work.\n * - `refs` is that domain's own key/value set. The engine checks only that keys and values are\n *   non-empty strings; what the keys MEAN, and which are required, is the domain's schema to\n *   declare and enforce where it creates the task.\n *\n * No domain payload is declared anywhere yet, deliberately: nothing writes a correlation today, and\n * declaring a shape for a producer that does not exist is how the five dead fields happened. The\n * first producer declares its own (see #1343, which is where a playbook run starts creating tasks).\n */\nexport const Actors_Task_Correlation_Schema = z.object({\n  /** Stable identifier of the domain whose vocabulary `refs` uses. */\n  domain: z.string().min(1),\n  /** That domain's correlation keys. Opaque to the engine; validated by the domain. */\n  refs: z.record(z.string().min(1), z.string().min(1)),\n});\n\nexport type Actors_Task_Correlation = z.infer<typeof Actors_Task_Correlation_Schema>;\n\n/**\n * Task context. Absent correlation is the normal case — a task dispatched by nothing in particular\n * carries none.\n */\nexport const Actors_Task_Context_Schema = z.object({\n  correlation: Actors_Task_Correlation_Schema.optional(),\n});\n\nexport type Actors_Task_Context = z.infer<typeof Actors_Task_Context_Schema>;\n\nexport const Actors_Task_Schema = z.object({\n  _id: z.string(),\n\n  title: z.string(),\n  description: z.string(),\n  /*\n   * Both vocabularies DECLARE themselves (#966), which is what lets their words be authored ONCE\n   * under `system_enums.<Name>.<value>` instead of per field path. Without the declaration the\n   * frontend cascade has no vocabulary to fall back to and renders the raw constant — `PROCESSING`,\n   * `IMPLEMENTATION` — which is precisely the \"a missing label must LOOK missing\" state, on two\n   * fields every surface that shows a task renders. Metadata only: an application that authors no\n   * block still renders the raw value, exactly as before.\n   */\n  topic: z.enum(Actor_Task_Topics).systemEnum('Actor_Task_Topics'),\n\n  status: z.enum(FlowsActors_Status).systemEnum('FlowsActors_Status'),\n  initiator: ExecutionContext_InitiatorIdsSchema,\n  relationships: z.array(FlowsActors_RelationshipSchema),\n\n  actors: z.object({\n    // actorKind: z.enum(Actor_Role_Category), // circular dependencies\n    actorRef: z.string(),\n  }),\n\n  input: z.any(),\n  output: z.any().optional(),\n\n  memory: Actors_Memory_ContextSchema,\n  context: Actors_Task_Context_Schema,\n\n\n  artifacts: z.array(ArtifactInstanceSchema).optional(),\n\n\n  actorStates: z.object({\n    actorRef: z.string(),\n    status: z.enum(FlowsActors_Status),\n    updatedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n    statusChanges: z.array(z.object({\n      status: z.enum(FlowsActors_Status),\n      timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n    })),\n  }).array(),\n\n  errorStates : z.object({\n    errorItems: WildoError_BackendSchema.extend({\n      actorRef: z.string(),\n    }).array().optional(),\n    checkpointChecks: z.array(z.object({\n      checkpoint: FlowsActors_Checkpoint_Schema,\n      timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n    })),\n\n    availableCheckpoints: FlowsActors_Checkpoint_Schema.array().optional(),\n  }).optional(),\n\n  createdAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n  updatedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n  startedAt: z.string().optional(),\n  completedAt: z.string().optional(),\n});\n\nexport type Actors_Task = z.infer<typeof Actors_Task_Schema>;\n\n\n\n//===============================================================\n//  ActorsSystem_ExecutionPlan\n// --------\n// ActorsSystem_ExecutionPlans represent AI-generated execution strategies that outline\n// the steps needed to accomplish complex tasks. They provide\n// cost and duration estimates, dependency mapping, and can be\n// approved before execution, enabling predictable and controlled\n// automated workflow generation by intelligent agents.\n//===============================================================\n\n\n\nexport const ActorsSystem_ExecutionPlan_Step_Schema = z.object({\n  _id: z.string(),\n  name: z.string().optional(),\n  description: z.string().optional(),\n  topic: z.string(),\n  relationships: z.array(FlowsActors_RelationshipSchema),\n  status: z.enum(FlowsActors_Status),\n\n  statusChanges: z.array(z.object({\n    status: z.enum(FlowsActors_Status),\n    timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n  })),\n\n  createdAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n  updatedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n\n});\nexport type ActorsSystem_ExecutionPlan_Step = z.infer<typeof ActorsSystem_ExecutionPlan_Step_Schema>;\n\nexport const ActorsSystem_ExecutionPlan_Schema = z.object({\n  _id: z.string(),\n  goalDescription: z.string(),\n  status: z.enum(FlowsActors_Status),\n  initiator: ExecutionContext_InitiatorIdsSchema,\n  relationships: z.array(FlowsActors_RelationshipSchema),\n\n  planSteps: z.array(ActorsSystem_ExecutionPlan_Step_Schema),\n\n\n  stepStates: z.object({\n    planStepId: z.string(),\n    status: z.enum(FlowsActors_Status),\n    updatedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n    statusChanges: z.array(z.object({\n      status: z.enum(FlowsActors_Status),\n      timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n    })),\n  }).array(),\n\n  errorStates : z.object({\n    errorItems: WildoError_BackendSchema.extend({\n      planStepId: z.string(),\n    }).array().optional(),\n    checkpointChecks: z.array(z.object({\n      checkpoint: FlowsActors_Checkpoint_Schema,\n      timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n    })),\n\n    availableCheckpoints: FlowsActors_Checkpoint_Schema.array().optional(),\n  }).optional(),\n\n  createdAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n  updatedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n});\nexport type ActorsSystem_ExecutionPlan = z.infer<typeof ActorsSystem_ExecutionPlan_Schema>;\n\n/*\n * `Actors_Walkthrough` was removed on 2026-09-20 (#1363): five identity fields and a `// TODO for\n * real`, carried as an optional `walkthrough` on every actor execution — a column, a label and a\n * display line for a thing with no writer, no reader and no definition of what it was.\n */\n"]}