npm - @wildo-ai/saas-models - Versions diffs - 1.1.4 → 1.1.5 - Mend

@wildo-ai/saas-models 1.1.4 → 1.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1032) hide show

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

	@@ -1 +1 @@
1	- {"version":3,"file":"flows-actors.system.shared.schemas.js","sourceRoot":"","sources":["~~../../../~~src/flows-actors/flows-actors.system.shared.schemas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gCAAgC,EAAE,MAAM,6CAA6C,CAAC;AAE/F,OAAO,EAAE,6BAA6B,EAAE,~~iCAAiC,EAAE,~~kBAAkB,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;~~AACxK~~,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,mCAAmC,EAAE,MAAM,6CAA6C,CAAC;AAGlG,iEAAiE;AACjE,mCAAmC;AACnC,WAAW;AACX,mEAAmE;AACnE,iEAAiE;AACjE,EAAE;AACF,uEAAuE;AACvE,qCAAqC;AACrC,iEAAiE;AACjE,oEAAoE;AACpE,mCAAmC;AACnC,EAAE;AACF,wEAAwE;AACxE,sEAAsE;AACtE,wEAAwE;AACxE,6DAA6D;AAC7D,mEAAmE;AACnE,EAAE;AACF,iEAAiE;AAEjE,MAAM,CAAN,IAAY,oBAGX;AAHD,WAAY,oBAAoB;IAC9B,qCAAa,CAAA;IACb,uCAAe,CAAA;AACjB,CAAC,EAHW,oBAAoB,KAApB,oBAAoB,QAG/B;AAED,MAAM,CAAN,IAAY,sBAMX;AAND,WAAY,sBAAsB;IAChC,yCAAe,CAAA;IACf,2CAAiB,CAAA;IACjB,+CAAqB,CAAA;IACrB,mDAAyB,CAAA;IACzB,+CAAqB,CAAA;AACvB,CAAC,EANW,sBAAsB,KAAtB,sBAAsB,QAMjC;AAED,MAAM,CAAN,IAAY,0BAGX;AAHD,WAAY,0BAA0B;IACpC,2DAA6B,CAAA;IAC7B,mDAAqB,CAAA;AACvB,CAAC,EAHW,0BAA0B,KAA1B,0BAA0B,QAGrC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,GAAG,EAAW,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,WAAW,EAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,WAAW,EAAG,CAAC,CAAC,MAAM,EAAE;IACxB,IAAI,EAAU,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;IAC1C,MAAM,EAAQ,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC;IAC5C,UAAU,EAAI,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAAC,YAAY,CAAC;IAEjG,MAAM,EAAI,gCAAgC;IAE1C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAElC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AAUH,iEAAiE;AACjE,6BAA6B;AAC7B,iEAAiE;AAEjE,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CAAC;IACzD,~~oBAAoB,EAAE,CAAC,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC,QAAQ,EAAE;IAC1E,~~UAAU,EAAE,wBAAwB,CAAC,MAAM,CAAC;QAC1C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;IACrB,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACjC,UAAU,EAAE,6BAA6B;QACzC,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;CACJ,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,SAAS,EAAG,CAAC,CAAC,MAAM,EAAE;IACtB,IAAI,EAAO,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC;IAClC,SAAS,EAAE,mCAAmC,CAAC,QAAQ,EAAE;IAEzD,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAC9B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC;aAC/B,QAAQ,CAAC,yBAAyB,CAAC,4FAA4F,CAAC,CAAC;QACpI,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;IACpG,UAAU,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,CAAC,QAAQ,EAAE;CACjH,CAAC,CAAC","sourcesContent":["\nimport { z } from 'zod';\n\nimport { FlowsActors_Configuration_Schema } from './flows-actors.configuration.shared.schemas';\nimport { ActorsSystem_ExecutionPlan_Schema } from './tasks.actors.shared.schemas';\nimport { FlowsActors_Checkpoint_Schema, ~~FlowsActors_CircuitBreaker_Status,~~ FlowsActors_Status, describeFlowsActorsStatus } from './flows-actors.commons.shared.schemas';\nimport { WildoError_BackendSchema } from '../errors/errors.shared.schemas';\nimport { ExecutionContext_InitiatorIdsSchema } from '../runtime/execution-context.shared.schemas';\n\n\n//===============================================================\n// FlowActorSystem — BASE contract\n// --------\n// This module declares the fields EVERY flow-actor system carries,\n// whatever its `kind`. It is deliberately NOT a complete system.\n//\n// A system is always one of the two kind specializations, and each one\n// declares members this base cannot:\n// - `ActorSystem` (`actors.shared.schemas.ts`) adds `actors`\n// - `FlowSystem` (`flows.shared.schemas.ts`) adds `triggers`,\n// `steps`, `edges`, `finishes`\n//\n// The type meaning \"a system, of either kind\" is `FlowActorSystem`, the\n// discriminated union in `flows-actors.system.shared.definitions.ts`.\n// That is what every consumer signature (registry, factories, services)\n// should name. Naming the BASE there is what previously made\n// `system.actors` unreadable at every call site and forced a cast.\n//\n//===============================================================\n\nexport enum FlowActorSystem_Kind {\n FLOW = \"flow\",\n ACTOR = \"actor\",\n}\n\nexport enum FlowActorSystem_Status {\n DRAFT = \"draft\",\n ACTIVE = \"active\",\n INACTIVE = \"inactive\",\n DEPRECATED = \"deprecated\",\n ARCHIVED = \"archived\",\n}\n\nexport enum FlowActorSystem_Visibility {\n BACKEND_ONLY = \"backend_only\",\n FRONTEND = \"frontend\",\n}\n\n/*\n The base field set shared by every flow-actor system.\n \n Never parse a whole system with this schema. `z.object` strips undeclared\n * keys, so `FlowActorSystem_BaseSchema.parse(actorSystem)` returns a value with\n * the `actors` array silently removed. Nothing at the parse site reports it: the\n * call succeeds, and its result type is exactly the base, so the compiler has no\n * loss to complain about — the value only becomes wrong further downstream,\n * wherever the actor list was going to be read. Parse a system with the schema\n * of its kind (`ActorSystemSchema`) instead; this base exists to be\n * `.extend()`ed, not to validate.\n \n The name carries the `_Base` suffix precisely so that mistake is visible at\n * the call site rather than hidden behind the unqualified system name.\n /\nexport const FlowActorSystem_BaseSchema = z.object({\n ref : z.string().min(1),\n displayName : z.string().min(1),\n description : z.string(),\n kind : z.enum(FlowActorSystem_Kind),\n status : z.enum(FlowActorSystem_Status),\n visibility : z.enum(FlowActorSystem_Visibility).default(FlowActorSystem_Visibility.BACKEND_ONLY),\n\n config : FlowsActors_Configuration_Schema,\n\n version: z.string().optional(),\n createdAt: z.string().optional(),\n updatedAt: z.string().optional(),\n deletedAt: z.string().optional(),\n deprecatedAt: z.string().optional(),\n publishedAt: z.string().optional(),\n\n tags: z.array(z.string()).optional(),\n category: z.string().optional(),\n metadata: z.record(z.string(), z.string()).optional(),\n});\n\n/\n Base fields only — not a usable system on its own. Use `FlowActorSystem`\n * (the `ActorSystem \| FlowSystem` union) for \"a system of either kind\".\n */\nexport type FlowActorSystem_Base = z.infer<typeof FlowActorSystem_BaseSchema>;\n\n\n\n//===============================================================\n// FlowActorSystem Execution\n//===============================================================\n\nexport const FlowActorSystem_ErrorStates_Schema = z.object({\n ~~circuitBreakerStatus: z.enum(FlowsActors_CircuitBreaker_Status).optional(),\n~~ errorItems: WildoError_BackendSchema.extend({\n systemRef: 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\nexport type FlowActorSystem_ErrorStates = z.infer<typeof FlowActorSystem_ErrorStates_Schema>;\n\nexport const FlowActorSystem_ExecutionSchema = z.object({\n _id: z.string().optional(),\n systemRef : z.string(),\n kind : z.enum(FlowActorSystem_Kind),\n status: z.enum(FlowsActors_Status),\n initiator: ExecutionContext_InitiatorIdsSchema.optional(),\n\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.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 finishedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }).optional(),\n});\n\nexport type FlowActorSystem_Execution = z.infer<typeof FlowActorSystem_ExecutionSchema>;\n\n"]}
1	+ {"version":3,"file":"flows-actors.system.shared.schemas.js","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.system.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["\nimport { z } from 'zod';\n\nimport { FlowsActors_Configuration_Schema } from './flows-actors.configuration.shared.schemas';\nimport { ActorsSystem_ExecutionPlan_Schema } from './tasks.actors.shared.schemas';\nimport { FlowsActors_Checkpoint_Schema, FlowsActors_Status, describeFlowsActorsStatus } from './flows-actors.commons.shared.schemas';\nimport { WildoError_BackendSchema } from '../errors/errors.shared.schemas';\nimport { ExecutionContext_InitiatorIdsSchema } from '../runtime/execution-context.shared.schemas';\n\n\n//===============================================================\n// FlowActorSystem — BASE contract\n// --------\n// This module declares the fields EVERY flow-actor system carries,\n// whatever its `kind`. It is deliberately NOT a complete system.\n//\n// A system is always one of the two kind specializations, and each one\n// declares members this base cannot:\n// - `ActorSystem` (`actors.shared.schemas.ts`) adds `actors`\n// - `FlowSystem` (`flows.shared.schemas.ts`) adds `triggers`,\n// `steps`, `edges`, `finishes`\n//\n// The type meaning \"a system, of either kind\" is `FlowActorSystem`, the\n// discriminated union in `flows-actors.system.shared.definitions.ts`.\n// That is what every consumer signature (registry, factories, services)\n// should name. Naming the BASE there is what previously made\n// `system.actors` unreadable at every call site and forced a cast.\n//\n//===============================================================\n\nexport enum FlowActorSystem_Kind {\n FLOW = \"flow\",\n ACTOR = \"actor\",\n}\n\nexport enum FlowActorSystem_Status {\n DRAFT = \"draft\",\n ACTIVE = \"active\",\n INACTIVE = \"inactive\",\n DEPRECATED = \"deprecated\",\n ARCHIVED = \"archived\",\n}\n\nexport enum FlowActorSystem_Visibility {\n BACKEND_ONLY = \"backend_only\",\n FRONTEND = \"frontend\",\n}\n\n/*\n The base field set shared by every flow-actor system.\n \n Never parse a whole system with this schema. `z.object` strips undeclared\n * keys, so `FlowActorSystem_BaseSchema.parse(actorSystem)` returns a value with\n * the `actors` array silently removed. Nothing at the parse site reports it: the\n * call succeeds, and its result type is exactly the base, so the compiler has no\n * loss to complain about — the value only becomes wrong further downstream,\n * wherever the actor list was going to be read. Parse a system with the schema\n * of its kind (`ActorSystemSchema`) instead; this base exists to be\n * `.extend()`ed, not to validate.\n \n The name carries the `_Base` suffix precisely so that mistake is visible at\n * the call site rather than hidden behind the unqualified system name.\n /\nexport const FlowActorSystem_BaseSchema = z.object({\n ref : z.string().min(1),\n displayName : z.string().min(1),\n description : z.string(),\n kind : z.enum(FlowActorSystem_Kind),\n status : z.enum(FlowActorSystem_Status),\n visibility : z.enum(FlowActorSystem_Visibility).default(FlowActorSystem_Visibility.BACKEND_ONLY),\n\n config : FlowsActors_Configuration_Schema,\n\n version: z.string().optional(),\n createdAt: z.string().optional(),\n updatedAt: z.string().optional(),\n deletedAt: z.string().optional(),\n deprecatedAt: z.string().optional(),\n publishedAt: z.string().optional(),\n\n tags: z.array(z.string()).optional(),\n category: z.string().optional(),\n metadata: z.record(z.string(), z.string()).optional(),\n});\n\n/\n Base fields only — not a usable system on its own. Use `FlowActorSystem`\n * (the `ActorSystem \| FlowSystem` union) for \"a system of either kind\".\n */\nexport type FlowActorSystem_Base = z.infer<typeof FlowActorSystem_BaseSchema>;\n\n\n\n//===============================================================\n// FlowActorSystem Execution\n//===============================================================\n\nexport const FlowActorSystem_ErrorStates_Schema = z.object({\n errorItems: WildoError_BackendSchema.extend({\n systemRef: 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\nexport type FlowActorSystem_ErrorStates = z.infer<typeof FlowActorSystem_ErrorStates_Schema>;\n\nexport const FlowActorSystem_ExecutionSchema = z.object({\n _id: z.string().optional(),\n systemRef : z.string(),\n kind : z.enum(FlowActorSystem_Kind),\n status: z.enum(FlowsActors_Status),\n initiator: ExecutionContext_InitiatorIdsSchema.optional(),\n\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.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 finishedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }).optional(),\n});\n\nexport type FlowActorSystem_Execution = z.infer<typeof FlowActorSystem_ExecutionSchema>;\n\n"]}

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

@@ -238,7 +238,6 @@ export declare const FlowSystem_Execution_Schema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     errorStates: z.ZodOptional<z.ZodObject<{
-        circuitBreakerStatus: z.ZodOptional<z.ZodEnum<typeof import("./flows-actors.commons.shared.schemas").FlowsActors_CircuitBreaker_Status>>;
         checkpointChecks: z.ZodArray<z.ZodObject<{
             checkpoint: z.ZodObject<{
                 point: z.ZodDiscriminatedUnion<[z.ZodObject<{

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

	@@ -1 +1 @@
1	- {"version":3,"file":"flows.shared.schemas.d.ts","sourceRoot":"","sources":["~~../../../~~src/flows-actors/flows.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAA6B,MAAM,uCAAuC,CAAC;AACtG,OAAO,EAAE,sCAAsC,EAAE,MAAM,6CAA6C,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAuE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAIvK,oBAAY,cAAc;IACxB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,MAAM,WAAW;CAClB;AAMD,eAAO,MAAM,eAAe;;;;;;;;;iBAS1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAMxD,oBAAY,iBAAiB;IAC3B,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,cAAc,mBAAmB;IACjC,KAAK,UAAU;IACf,eAAe,oBAAoB;CACpC;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAU,iBAAiB,CAAC;IAChC,GAAG,EAAW,MAAM,CAAC;IACrB,WAAW,EAAG,MAAM,CAAC;IACrB,WAAW,CAAC,EAAG,MAAM,CAAC;IACtB,WAAW,CAAC,EAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,YAAY,GACtB,iBAAiB,GAAG;IAAE,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAA;CAAE,GACtD,iBAAiB,GAAG;IAAE,IAAI,EAAE,iBAAiB,CAAC,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACpG,iBAAiB,GAAG;IAAE,IAAI,EAAE,iBAAiB,CAAC,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,GAAG,GAAG,SAAS,CAAA;CAAE,GACtH,iBAAiB,GAAG;IAAE,IAAI,EAAE,iBAAiB,CAAC,cAAc,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,GAC1G,iBAAiB,GAAG;IAAE,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAU1E,oBAAY,cAAc;IAExB,UAAU,eAAe;IAGzB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,0BAA0B,+BAA+B,CAAE,0BAA0B;IACrF,cAAc,mBAAmB,CAAE,sBAAsB;IACzD,YAAY,iBAAiB;IAE7B,cAAc,mBAAmB,CAAE,iBAAiB;IACpD,aAAa,kBAAkB,CAAE,gBAAgB;IAGjD,cAAc,mBAAmB;IACjC,cAAc,mBAAmB;IACjC,YAAY,iBAAiB;IAC7B,gBAAgB,qBAAqB;IACrC,aAAa,kBAAkB;IAC/B,aAAa,kBAAkB;IAG/B,iBAAiB,sBAAsB,CAAE,mBAAmB;IAC5D,kBAAkB,uBAAuB,CAAE,kBAAkB;IAG7D,UAAU,eAAe;IACzB,UAAU,eAAe;IAIzB,WAAW,gBAAgB;IAC3B,gBAAgB,qBAAqB;IACrC,aAAa,kBAAkB;IAG/B,iBAAiB,sBAAsB;IACvC,iBAAiB,sBAAsB;CAExC;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC/B,YAAY,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,sCAAsC,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,oBAAY,0BAA0B;IACpC,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,YAAY,iBAAiB;IAC7B,SAAS,cAAc;IACvB,qBAAqB,0BAA0B;IAC/C,kBAAkB,uBAAuB;CAC1C;AAED,eAAO,MAAM,kCAAkC;;;;iBAI7C,CAAC;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F,MAAM,MAAM,SAAS,GACnB,cAAc,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC;IAAkB,QAAQ,EAAE,EAAoC,CAAA;CAAE,GACrH,cAAc,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC,QAAQ,CAAC;IAAoB,WAAW,EAAE,EAAoC,CAAA;CAAE,GACxH,cAAc,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC;IAAmB,SAAS,EAAE,EAAqC,CAAA;CAAE,GACvH,cAAc,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC,0BAA0B,CAAC;IAAE,iBAAiB,EAAE,EAAsD,CAAA;CAAE,GAChJ,cAAc,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC,cAAc,CAAC;IAAc,iBAAiB,EAAE,EAA0C,CAAA;CAAE,GACpI,cAAc,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC,YAAY,CAAC;IAAgB,QAAQ,EAAE,EAAwC,CAAA;CAAE,GACzH,cAAc,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC,cAAc,CAAC;IAAc,QAAQ,EAAE,EAA0C,CAAA;CAAE,GAC3H,cAAc,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC,aAAa,CAAC;IAAe,YAAY,EAAE,EAAyC,CAAA;CAAE,GAC9H,cAAc,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC,cAAc,CAAC;IAAc,QAAQ,EAAE,EAA0C,CAAA;CAAE,GAC3H,cAAc,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC,cAAc,CAAC;IAAc,WAAW,EAAE,EAA0C,CAAA;CAAE,GAC9H,cAAc,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC,YAAY,CAAC;IAAgB,IAAI,EAAE,EAAwC,CAAA;CAAE,GACrH,cAAc,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC,gBAAgB,CAAC;IAAY,QAAQ,EAAE,EAA4C,CAAA;CAAE,GAC7H,cAAc,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC,aAAa,CAAC;IAAe,KAAK,EAAE,EAAyC,CAAA;CAAE,GACvH,cAAc,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC,aAAa,CAAC;IAAe,KAAK,EAAE,EAAyC,CAAA;CAAE,GACvH,cAAc,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC,iBAAiB,CAAC;IAAW,SAAS,EAAE,EAA6C,CAAA;CAAE,GAC/H,cAAc,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC,kBAAkB,CAAC;IAAU,SAAS,EAAE,EAA8C,CAAA;CAAE,GAChI,cAAc,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC;IAAkB,QAAQ,EAAE,EAAsC,CAAA;CAAE,GACvH,cAAc,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC;IAAkB,QAAQ,EAAE,EAAsC,CAAA;CAAE,GACvH,cAAc,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC;IAAiB,KAAK,EAAE,EAAuC,CAAA;CAAE,GACrH,cAAc,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC,gBAAgB,CAAC;IAAY,KAAK,EAAE,EAA4C,CAAA;CAAE,GAC1H,cAAc,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC,aAAa,CAAC;IAAe,KAAK,EAAE,EAAyC,CAAA;CAAE,CAAA;AAQzH,eAAO,MAAM,iBAAiB,gCAAe,CAAC;AAC9C,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM5D;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,oBAAoB,GAAG;IAC9C,IAAI,EAAE,oBAAoB,CAAC,IAAI,CAAC;IAChC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB,CAAC;AAwCF,oDAAoD;AACpD,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;EAAmC,CAAC;AAEnF,qEAAqE;AACrE,eAAO,MAAM,4BAA4B,yEAAyC,CAAC;AACnF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAIlF,eAAO,MAAM,2BAA2B~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;~~iBAoBtC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}
1	+ {"version":3,"file":"flows.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/flows.shared.schemas.ts"],"names":[],"mappings":"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"}

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

	@@ -1 +1 @@
1	- {"version":3,"file":"flows.shared.schemas.js","sourceRoot":"","sources":["../../../src/flows-actors/flows.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 { FlowsActors_LeafElements_Configuration } from \"./flows-actors.configuration.shared.schemas\";\nimport { FlowActorSystem_Base, FlowActorSystem_ErrorStates_Schema, FlowActorSystem_ExecutionSchema, FlowActorSystem_Kind } from \"./flows-actors.system.shared.schemas\";\nimport { createSchemaFamily } from \"../resources/utils/schema-family-builder.utils\";\n\n\nexport enum Flow_Node_Type {\n TRIGGER = \"trigger\",\n STEP = \"step\",\n FINISH = \"finish\",\n}\n\n//===============================================================\n// Edge\n//===============================================================\n\nexport const Flow_EdgeSchema = z.object({\n from: z.object({\n type: z.enum(Flow_Node_Type),\n ref: z.string(),\n }),\n to: z.object({\n type: z.enum(Flow_Node_Type),\n ref: z.string(),\n }),\n});\nexport type Flow_Edge = z.infer<typeof Flow_EdgeSchema>;\n\n//===============================================================\n// Trigger\n//===============================================================\n\nexport enum Flow_Trigger_Type {\n MANUAL = \"manual\",\n SCHEDULE = \"schedule\",\n WEBHOOK = \"webhook\",\n RESOURCE_EVENT = \"resource_event\",\n EVENT = \"event\",\n TASK_COMPLETION = \"task_completion\",\n}\n\nexport type Flow_Trigger_Base = {\n type : Flow_Trigger_Type;\n ref : string;\n displayName : string;\n description? : string;\n inputSchema? : z.ZodSchema<any>;\n};\n\nexport type Flow_Trigger =\n Flow_Trigger_Base & { type: Flow_Trigger_Type.MANUAL } \|\n Flow_Trigger_Base & { type: Flow_Trigger_Type.SCHEDULE, cron: string, timezone: string \| undefined } \|\n Flow_Trigger_Base & { type: Flow_Trigger_Type.WEBHOOK, path: string, method: string, authentication: any \| undefined } \|\n Flow_Trigger_Base & { type: Flow_Trigger_Type.RESOURCE_EVENT, resourceType: string, operations: string[] } \|\n Flow_Trigger_Base & { type: Flow_Trigger_Type.EVENT, topics: string[] };\n\n\n\n\n\n//===============================================================\n// Step\n//===============================================================\n\nexport enum Flow_Step_Kind {\n // Agentic Steps\n AGENT_CALL = \"agent.call\",\n\n\n FUNCTION = \"function\",\n CONNECTOR = \"connector\",\n COMPUTE_RESOURCE_OPERATION = \"compute.resource.operation\", // operation on a resource\n COMPUTE_CUSTOM = \"compute.custom\", // custom compute step\n FLOW_SUBFLOW = \"flow.subflow\",\n\n ARTIFACT_WRITE = \"artifact.write\", // write artifact\n ARTIFACT_READ = \"artifact.read\", // read artifact\n\n // Control Steps\n CONTROL_BRANCH = \"control.branch\",\n CONTROL_SWITCH = \"control.switch\",\n CONTROL_LOOP = \"control.loop\",\n CONTROL_PARALLEL = \"control.parallel\",\n CONTROL_DELAY = \"control.delay\",\n CONTROL_RETRY = \"control.retry\",\n\n // State Steps\n STATE_MEMORY_READ = \"state.memory.read\", // read from memory\n STATE_MEMORY_WRITE = \"state.memory.write\", // write to memory\n\n // Event Steps\n EVENT_EMIT = \"event.emit\",\n EVENT_WAIT = \"event.wait\",\n // Artifact Steps\n\n // Error Handling\n ERROR_CATCH = \"error.catch\",\n ERROR_COMPENSATE = \"error.compensate\",\n ERROR_FINALLY = \"error.finally\",\n\n // Human\n HUMAN_IN_THE_LOOP = \"human.in.the.loop\",\n ACTOR_SYSTEM_CALL = \"actor.system.call\",\n\n}\n\nexport type Flow_Step_Base = {\n kind: Flow_Step_Kind;\n name: string;\n description?: string;\n inputSchema?: z.ZodSchema<any>;\n outputSchema?: z.ZodSchema<any>;\n config?: FlowsActors_LeafElements_Configuration;\n metadata?: Record<string, unknown>;\n};\n\nexport enum Flow_ControlSwith_Operator {\n EQUAL = \"equal\",\n NOT_EQUAL = \"not_equal\",\n GREATER_THAN = \"greater_than\",\n LESS_THAN = \"less_than\",\n GREATER_THAN_OR_EQUAL = \"greater_than_or_equal\",\n LESS_THAN_OR_EQUAL = \"less_than_or_equal\",\n}\n\nexport const Flow_ControlSwitch_ConditionSchema = z.object({\n operator: z.enum(Flow_ControlSwith_Operator),\n left: z.any(),\n right: z.any(),\n});\nexport type Flow_ControlSwitch_Condition = z.infer<typeof Flow_ControlSwitch_ConditionSchema>;\n\nexport type Flow_Step =\n Flow_Step_Base & { kind: Flow_Step_Kind.AGENT_CALL, agentRef: { /* TODO: add function schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.FUNCTION, functionRef: { / TODO: add function schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.CONNECTOR, connector: { / TODO: add connector schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.COMPUTE_RESOURCE_OPERATION, resourceOperation: { / TODO: add compute resource operation schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.COMPUTE_CUSTOM, customComputation: { / TODO: add compute custom schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.FLOW_SUBFLOW, fsubflow: { / TODO: add flow subflow schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.ARTIFACT_WRITE, artifact: { / TODO: add artifact write schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.ARTIFACT_READ, artifactRead: { / TODO: add artifact read schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.CONTROL_BRANCH, branches: { / TODO: add control branch schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.CONTROL_SWITCH, switchCases: { / TODO: add control switch schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.CONTROL_LOOP, loop: { / TODO: add control loop schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.CONTROL_PARALLEL, parallel: { / TODO: add control parallel schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.CONTROL_DELAY, delay: { / TODO: add control delay schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.CONTROL_RETRY, retry: { / TODO: add control retry schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.STATE_MEMORY_READ, memoryRef: { / TODO: add state memory read schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.STATE_MEMORY_WRITE, memoryRef: { / TODO: add state memory write schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.EVENT_EMIT, eventDef: { / TODO: add event emit schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.EVENT_WAIT, eventDef: { / TODO: add event wait schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.ERROR_CATCH, error: { / TODO: add error catch schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.ERROR_COMPENSATE, error: { / TODO: add error compensate schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.ERROR_FINALLY, error: { / TODO: add error finally schema / } }\n\n\n\n//===============================================================\n// FINISH\n//===============================================================\n\nexport const Flow_FinishSchema = z.object({});\nexport type Flow_Finish = z.infer<typeof Flow_FinishSchema>;\n\n//===============================================================\n// Flow System\n//===============================================================\n\n/\n The FLOW specialization of the system base — the type that OWNS the flow\n * graph (`triggers` / `steps` / `edges` / `finishes`). Still a hand-written\n * type rather than a Zod schema: `Flow_Trigger` and `Flow_Step` are TypeScript\n * unions with no runtime schema yet (the flow model is still maturing), which\n * is why `FlowActorSystem` can only be a TYPE union today and not a\n * `z.discriminatedUnion`.\n /\nexport type FlowSystem = FlowActorSystem_Base & {\n kind: FlowActorSystem_Kind.FLOW;\n triggers: Flow_Trigger[];\n steps: Flow_Step[];\n edges: Flow_Edge[];\n finishes: Flow_Finish[];\n};\n\n//===============================================================\n// Flow System Execution\n//===============================================================\n\n/* ──────────────────────────────────────────────────────────────\n * Flow Node Relationship Schema Family\n \n Uses createSchemaFamily for discriminated union by node type.\n * Each node type has a specific reference field.\n * ────────────────────────────────────────────────────────────── /\n\nconst flowNodeRelationshipSchemaFamily = createSchemaFamily({\n base: z.object({\n kind: z.enum(Flow_Node_Type),\n }),\n discriminator: {\n field: 'kind',\n baseValues: [], // All node types have variants\n },\n variants: {\n [Flow_Node_Type.TRIGGER]: {\n extend: z.object({\n triggerRef: z.string(),\n }),\n },\n [Flow_Node_Type.STEP]: {\n extend: z.object({\n stepRef: z.string(),\n }),\n },\n [Flow_Node_Type.FINISH]: {\n extend: z.object({\n finishRef: z.string(),\n }),\n },\n },\n});\n\n/* Exported schema family for advanced use cases /\nexport const Flow_Node_RelationshipSchemaFamily = flowNodeRelationshipSchemaFamily;\n\n/* Union of all flow node relationship types (from schema family) */\nexport const Flow_Node_RelationshipSchema = flowNodeRelationshipSchemaFamily.union;\nexport type Flow_Node_Relationship = z.infer<typeof Flow_Node_RelationshipSchema>;\n\n\n\nexport const FlowSystem_Execution_Schema = FlowActorSystem_ExecutionSchema.extend({\n kind: z.literal(FlowActorSystem_Kind.FLOW),\n\n nodeStates: z.object({\n node: Flow_Node_RelationshipSchema,\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 errorStates : FlowActorSystem_ErrorStates_Schema.extend({\n errorItems: WildoError_BackendSchema.extend({\n systemRef: z.string(),\n flowNode: Flow_Node_RelationshipSchema,\n }).array().optional(),\n }).optional(),\n});\nexport type FlowSystem_Execution = z.infer<typeof FlowSystem_Execution_Schema>;\n"]}
1	+ {"version":3,"file":"flows.shared.schemas.js","sourceRoot":"","sources":["../../../../src/flows-actors/flows.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 { FlowsActors_LeafElements_Configuration } from \"./flows-actors.configuration.shared.schemas\";\nimport { FlowActorSystem_Base, FlowActorSystem_ErrorStates_Schema, FlowActorSystem_ExecutionSchema, FlowActorSystem_Kind } from \"./flows-actors.system.shared.schemas\";\nimport { createSchemaFamily } from \"../resources/utils/schema-family-builder.utils\";\n\n\nexport enum Flow_Node_Type {\n TRIGGER = \"trigger\",\n STEP = \"step\",\n FINISH = \"finish\",\n}\n\n//===============================================================\n// Edge\n//===============================================================\n\nexport const Flow_EdgeSchema = z.object({\n from: z.object({\n type: z.enum(Flow_Node_Type),\n ref: z.string(),\n }),\n to: z.object({\n type: z.enum(Flow_Node_Type),\n ref: z.string(),\n }),\n});\nexport type Flow_Edge = z.infer<typeof Flow_EdgeSchema>;\n\n//===============================================================\n// Trigger\n//===============================================================\n\nexport enum Flow_Trigger_Type {\n MANUAL = \"manual\",\n SCHEDULE = \"schedule\",\n WEBHOOK = \"webhook\",\n RESOURCE_EVENT = \"resource_event\",\n EVENT = \"event\",\n TASK_COMPLETION = \"task_completion\",\n}\n\nexport type Flow_Trigger_Base = {\n type : Flow_Trigger_Type;\n ref : string;\n displayName : string;\n description? : string;\n inputSchema? : z.ZodSchema<any>;\n};\n\nexport type Flow_Trigger =\n Flow_Trigger_Base & { type: Flow_Trigger_Type.MANUAL } \|\n Flow_Trigger_Base & { type: Flow_Trigger_Type.SCHEDULE, cron: string, timezone: string \| undefined } \|\n Flow_Trigger_Base & { type: Flow_Trigger_Type.WEBHOOK, path: string, method: string, authentication: any \| undefined } \|\n Flow_Trigger_Base & { type: Flow_Trigger_Type.RESOURCE_EVENT, resourceType: string, operations: string[] } \|\n Flow_Trigger_Base & { type: Flow_Trigger_Type.EVENT, topics: string[] };\n\n\n\n\n\n//===============================================================\n// Step\n//===============================================================\n\nexport enum Flow_Step_Kind {\n // Agentic Steps\n AGENT_CALL = \"agent.call\",\n\n\n FUNCTION = \"function\",\n CONNECTOR = \"connector\",\n COMPUTE_RESOURCE_OPERATION = \"compute.resource.operation\", // operation on a resource\n COMPUTE_CUSTOM = \"compute.custom\", // custom compute step\n FLOW_SUBFLOW = \"flow.subflow\",\n\n ARTIFACT_WRITE = \"artifact.write\", // write artifact\n ARTIFACT_READ = \"artifact.read\", // read artifact\n\n // Control Steps\n CONTROL_BRANCH = \"control.branch\",\n CONTROL_SWITCH = \"control.switch\",\n CONTROL_LOOP = \"control.loop\",\n CONTROL_PARALLEL = \"control.parallel\",\n CONTROL_DELAY = \"control.delay\",\n CONTROL_RETRY = \"control.retry\",\n\n // State Steps\n STATE_MEMORY_READ = \"state.memory.read\", // read from memory\n STATE_MEMORY_WRITE = \"state.memory.write\", // write to memory\n\n // Event Steps\n EVENT_EMIT = \"event.emit\",\n EVENT_WAIT = \"event.wait\",\n // Artifact Steps\n\n // Error Handling\n ERROR_CATCH = \"error.catch\",\n ERROR_COMPENSATE = \"error.compensate\",\n ERROR_FINALLY = \"error.finally\",\n\n // Human\n HUMAN_IN_THE_LOOP = \"human.in.the.loop\",\n ACTOR_SYSTEM_CALL = \"actor.system.call\",\n\n}\n\nexport type Flow_Step_Base = {\n kind: Flow_Step_Kind;\n name: string;\n description?: string;\n inputSchema?: z.ZodSchema<any>;\n outputSchema?: z.ZodSchema<any>;\n config?: FlowsActors_LeafElements_Configuration;\n metadata?: Record<string, unknown>;\n};\n\nexport enum Flow_ControlSwith_Operator {\n EQUAL = \"equal\",\n NOT_EQUAL = \"not_equal\",\n GREATER_THAN = \"greater_than\",\n LESS_THAN = \"less_than\",\n GREATER_THAN_OR_EQUAL = \"greater_than_or_equal\",\n LESS_THAN_OR_EQUAL = \"less_than_or_equal\",\n}\n\nexport const Flow_ControlSwitch_ConditionSchema = z.object({\n operator: z.enum(Flow_ControlSwith_Operator),\n left: z.any(),\n right: z.any(),\n});\nexport type Flow_ControlSwitch_Condition = z.infer<typeof Flow_ControlSwitch_ConditionSchema>;\n\nexport type Flow_Step =\n Flow_Step_Base & { kind: Flow_Step_Kind.AGENT_CALL, agentRef: { /* TODO: add function schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.FUNCTION, functionRef: { / TODO: add function schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.CONNECTOR, connector: { / TODO: add connector schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.COMPUTE_RESOURCE_OPERATION, resourceOperation: { / TODO: add compute resource operation schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.COMPUTE_CUSTOM, customComputation: { / TODO: add compute custom schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.FLOW_SUBFLOW, fsubflow: { / TODO: add flow subflow schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.ARTIFACT_WRITE, artifact: { / TODO: add artifact write schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.ARTIFACT_READ, artifactRead: { / TODO: add artifact read schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.CONTROL_BRANCH, branches: { / TODO: add control branch schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.CONTROL_SWITCH, switchCases: { / TODO: add control switch schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.CONTROL_LOOP, loop: { / TODO: add control loop schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.CONTROL_PARALLEL, parallel: { / TODO: add control parallel schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.CONTROL_DELAY, delay: { / TODO: add control delay schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.CONTROL_RETRY, retry: { / TODO: add control retry schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.STATE_MEMORY_READ, memoryRef: { / TODO: add state memory read schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.STATE_MEMORY_WRITE, memoryRef: { / TODO: add state memory write schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.EVENT_EMIT, eventDef: { / TODO: add event emit schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.EVENT_WAIT, eventDef: { / TODO: add event wait schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.ERROR_CATCH, error: { / TODO: add error catch schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.ERROR_COMPENSATE, error: { / TODO: add error compensate schema / } } \|\n Flow_Step_Base & { kind: Flow_Step_Kind.ERROR_FINALLY, error: { / TODO: add error finally schema / } }\n\n\n\n//===============================================================\n// FINISH\n//===============================================================\n\nexport const Flow_FinishSchema = z.object({});\nexport type Flow_Finish = z.infer<typeof Flow_FinishSchema>;\n\n//===============================================================\n// Flow System\n//===============================================================\n\n/\n The FLOW specialization of the system base — the type that OWNS the flow\n * graph (`triggers` / `steps` / `edges` / `finishes`). Still a hand-written\n * type rather than a Zod schema: `Flow_Trigger` and `Flow_Step` are TypeScript\n * unions with no runtime schema yet (the flow model is still maturing), which\n * is why `FlowActorSystem` can only be a TYPE union today and not a\n * `z.discriminatedUnion`.\n /\nexport type FlowSystem = FlowActorSystem_Base & {\n kind: FlowActorSystem_Kind.FLOW;\n triggers: Flow_Trigger[];\n steps: Flow_Step[];\n edges: Flow_Edge[];\n finishes: Flow_Finish[];\n};\n\n//===============================================================\n// Flow System Execution\n//===============================================================\n\n/* ──────────────────────────────────────────────────────────────\n * Flow Node Relationship Schema Family\n \n Uses createSchemaFamily for discriminated union by node type.\n * Each node type has a specific reference field.\n * ────────────────────────────────────────────────────────────── /\n\nconst flowNodeRelationshipSchemaFamily = createSchemaFamily({\n base: z.object({\n kind: z.enum(Flow_Node_Type),\n }),\n discriminator: {\n field: 'kind',\n baseValues: [], // All node types have variants\n },\n variants: {\n [Flow_Node_Type.TRIGGER]: {\n extend: z.object({\n triggerRef: z.string(),\n }),\n },\n [Flow_Node_Type.STEP]: {\n extend: z.object({\n stepRef: z.string(),\n }),\n },\n [Flow_Node_Type.FINISH]: {\n extend: z.object({\n finishRef: z.string(),\n }),\n },\n },\n});\n\n/* Exported schema family for advanced use cases /\nexport const Flow_Node_RelationshipSchemaFamily = flowNodeRelationshipSchemaFamily;\n\n/* Union of all flow node relationship types (from schema family) */\nexport const Flow_Node_RelationshipSchema = flowNodeRelationshipSchemaFamily.union;\nexport type Flow_Node_Relationship = z.infer<typeof Flow_Node_RelationshipSchema>;\n\n\n\nexport const FlowSystem_Execution_Schema = FlowActorSystem_ExecutionSchema.extend({\n kind: z.literal(FlowActorSystem_Kind.FLOW),\n\n nodeStates: z.object({\n node: Flow_Node_RelationshipSchema,\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 errorStates : FlowActorSystem_ErrorStates_Schema.extend({\n errorItems: WildoError_BackendSchema.extend({\n systemRef: z.string(),\n flowNode: Flow_Node_RelationshipSchema,\n }).array().optional(),\n }).optional(),\n});\nexport type FlowSystem_Execution = z.infer<typeof FlowSystem_Execution_Schema>;\n"]}

package/dist/esm/flows-actors/human-decision.shared.schemas.d.ts ADDED Viewed

@@ -0,0 +1,121 @@
+import { z } from 'zod';
+/**
+ * What a person is being asked FOR in one field.
+ *
+ * The one named source for this vocabulary. `MetaWorkflow_ElicitationQuestionKind` in the
+ * application-creation layer is an alias of this enum rather than a second copy — the values decide
+ * how an answer is validated, so two enums that drift would mean a CHOICE accepted against the wrong
+ * option set.
+ */
+export declare enum HumanDecision_FieldKind {
+    /** Prose. The answer is whatever the person writes, trimmed, and must not be empty. */
+    FREE_TEXT = "free_text",
+    /** One of a closed set the request states. An answer outside `options` is REFUSED, never coerced. */
+    CHOICE = "choice",
+    /**
+     * Yes or no.
+     *
+     * The answer must resolve to an unambiguous affirmative or negative and is stored CANONICALLY, not
+     * as the person typed it — downstream readers compare a token rather than re-parsing prose. An
+     * answer that does not resolve ("probably") is refused rather than guessed, because these decide
+     * things: the regulated-domain screening questions are `CONFIRM`s, and one of them silently
+     * meaning "yes" is a compliance posture nobody chose. Resolution lives with the creation layer
+     * that owns the canonical vocabulary.
+     */
+    CONFIRM = "confirm"
+}
+/**
+ * What giving a particular answer MEANS for the work that is waiting.
+ *
+ * Closed, and deliberately three members rather than one per button. Hosts spell their buttons
+ * differently — accept/decline/cancel, submit/cancel, approve/deny — and a vocabulary with one
+ * member per spelling would have to grow every time a surface is added. What a reader actually needs
+ * to know is whether the waiting work proceeds, and whether it proceeds WITH the values.
+ */
+export declare enum HumanDecision_ResponseIntent {
+    /** Proceed, using the values supplied. Fields are validated and required. */
+    PROCEED_WITH_VALUES = "proceed_with_values",
+    /**
+     * Proceed WITHOUT values — the person declined to answer and the work continues on its own
+     * judgement, stating the assumption it made.
+     *
+     * This is also what a DENIAL is, and the distinction matters: denying a gated tool call does not
+     * abort the turn, it resumes it so the model can answer the refusal. Anything that ends the work
+     * is `ABORT`.
+     */
+    PROCEED_WITHOUT_VALUES = "proceed_without_values",
+    /** End the waiting work. Nothing is produced and no values are read. */
+    ABORT = "abort"
+}
+/** One thing a person is asked. `why` is the rationale a host may supply; an interview usually has none. */
+export declare const HumanDecision_FieldSchema: z.ZodObject<{
+    ref: z.ZodString;
+    question: z.ZodString;
+    kind: z.ZodEnum<typeof HumanDecision_FieldKind>;
+    options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    why: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type HumanDecision_Field = z.infer<typeof HumanDecision_FieldSchema>;
+/** One answer a person may give, and what it means for the waiting work. */
+export declare const HumanDecision_ResponseOptionSchema: z.ZodObject<{
+    ref: z.ZodString;
+    label: z.ZodString;
+    intent: z.ZodEnum<typeof HumanDecision_ResponseIntent>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type HumanDecision_ResponseOption = z.infer<typeof HumanDecision_ResponseOptionSchema>;
+/**
+ * Something is waiting for a person.
+ *
+ * Projected by whichever host owns the suspended work; never persisted by this layer.
+ */
+export declare const HumanDecision_RequestSchema: z.ZodObject<{
+    decisionId: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    fields: z.ZodArray<z.ZodObject<{
+        ref: z.ZodString;
+        question: z.ZodString;
+        kind: z.ZodEnum<typeof HumanDecision_FieldKind>;
+        options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        why: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    options: z.ZodArray<z.ZodObject<{
+        ref: z.ZodString;
+        label: z.ZodString;
+        intent: z.ZodEnum<typeof HumanDecision_ResponseIntent>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    requestedAt: z.ZodString;
+    expiresAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type HumanDecision_Request = z.infer<typeof HumanDecision_RequestSchema>;
+/** What a person answered. */
+export declare const HumanDecision_AnswerSchema: z.ZodObject<{
+    decisionId: z.ZodString;
+    optionRef: z.ZodString;
+    values: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        ref: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type HumanDecision_Answer = z.infer<typeof HumanDecision_AnswerSchema>;
+/** Refused because the answer does not settle the request it names. */
+export declare class HumanDecisionAnswerError extends Error {
+}
+/**
+ * Check an answer against the request it claims to settle, and return the values by ref.
+ *
+ * Refuses rather than coerces, at every branch, for the reason the CONFIRM doc gives: these answers
+ * decide things, and a silently-accepted wrong one becomes the record. `CONFIRM` resolution is NOT
+ * done here — this layer does not own the canonical affirmative/negative vocabulary — so a CONFIRM
+ * field is validated as non-empty and the creation layer canonicalises it.
+ *
+ * Note what is deliberately NOT validated: an option this request never offered is refused, but the
+ * INTENT is trusted, because the host authored both the option and its meaning.
+ */
+export declare function resolveHumanDecisionAnswer(request: HumanDecision_Request, answer: HumanDecision_Answer): {
+    readonly option: HumanDecision_ResponseOption;
+    readonly values: Readonly<Record<string, string>>;
+};
+//# sourceMappingURL=human-decision.shared.schemas.d.ts.map

package/dist/esm/flows-actors/human-decision.shared.schemas.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"human-decision.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/human-decision.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoExB;;;;;;;GAOG;AACH,oBAAY,uBAAuB;IACjC,uFAAuF;IACvF,SAAS,cAAc;IACvB,qGAAqG;IACrG,MAAM,WAAW;IACjB;;;;;;;;;OASG;IACH,OAAO,YAAY;CACpB;AAED;;;;;;;GAOG;AACH,oBAAY,4BAA4B;IACtC,6EAA6E;IAC7E,mBAAmB,wBAAwB;IAC3C;;;;;;;OAOG;IACH,sBAAsB,2BAA2B;IACjD,wEAAwE;IACxE,KAAK,UAAU;CAChB;AAED,4GAA4G;AAC5G,eAAO,MAAM,yBAAyB;;;;;;iBAmBpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,4EAA4E;AAC5E,eAAO,MAAM,kCAAkC;;;;;iBAQ7C,CAAC;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F;;;;GAIG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;iBA4BtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,8BAA8B;AAC9B,eAAO,MAAM,0BAA0B;;;;;;;iBAMrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,uEAAuE;AACvE,qBAAa,wBAAyB,SAAQ,KAAK;CAAG;AAEtD;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,oBAAoB,GAC3B;IAAE,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,CA+DtG"}

package/dist/esm/flows-actors/human-decision.shared.schemas.js ADDED Viewed

@@ -0,0 +1,252 @@
+import { z } from 'zod';
+//===============================================================
+//  HUMAN DECISION — one payload for every question a person is asked
+//
+// ## What this is, and what it deliberately is NOT
+//
+// This is the CONTRACT for "something is waiting for a person": what they are being asked, what
+// answers they may give, and what a given answer means. It is not a store.
+//
+// That distinction was measured rather than assumed, and it is the whole reason this file is small.
+// Three surfaces suspend on a human, and where each keeps its pending state has MOVED since this was
+// written — the table is the current state, 2026-09-20:
+//
+// | question | pending state lives in | its own shape |
+// |---|---|---|
+// | a mid-run clarification | the run's own ACTOR EXECUTION row — `suspension` (this payload) + `checkpoint` (the resume inputs), status `AWAITING_APPROVAL` | `PlaybookRunSuspensionCheckpoint` |
+// | a parked coding run | the durable actor-task row (`output.suspension`) — moves onto the same two execution fields with the coding lane (#1359) | `CodingAgent_SessionSuspension` |
+// | a playbook's up-front interview | nowhere — it is DECLARED on the playbook and asked before a run exists | `MetaWorkflow_ElicitationSpec` |
+//
+// The history, because the first line of that table was argued the other way twice. Until 2026-09-20
+// this header said "a playbook run creates no execution row at all, so there is no single plane to
+// move them onto" — true until #1343 gave a run an `ActorSystem_Execution`. It then said the
+// conclusion was unchanged because "that row records the RUN, not what the run is waiting for", and
+// that a clarification was "a disposable checkpoint whose whole point is that it costs nothing to
+// lose". #1360 measured that and reversed it: once the engine DRIVES the run (#1358), a wait that
+// lives beside the row needs a second handle, a second store and a second listing to say what the
+// row's own status should, and a suspended run settled `COMPLETED` on the plane while waiting on a
+// person. The row now says what the run is waiting for, and the engine resumes it under the same id.
+//
+// The up-front interview stays where it is for the reason it always had: it is answered BEFORE a run
+// exists to hang it on.
+//
+// Each host PROJECTS what it is waiting for into a `HumanDecision_Request`, and every reader — a
+// workbench panel, a CLI, a future notification — consumes only this. On the actor-system plane the
+// engine persists that projection itself (`ActorExecution_Suspension.decision`); elsewhere it is
+// built on read. What a person is being asked is everyone's either way.
+//
+// ## Why not extend the existing paused-approval state
+//
+// `FlowActorExecution_PausedApproval` looks like the obvious host and is the wrong one. It carries
+// `sdkModelMessages` ("the AI-SDK model-message array to RESUME from — opaque to us"),
+// `pendingToolName` and `pendingToolArgs`: it is an agent-STREAM resume contract. A playbook
+// interview has no model stream and no pending tool, so extending it would leave three required
+// fields meaningless for half its uses. Two distinct concepts, two schemas.
+//
+// ## Two lists, because one question is the special case and not the rule
+//
+// The pre-existing decision components each model exactly ONE question — an options-only choice, or
+// a single text input. A playbook interview asks fifteen at once, so neither fits, and a payload
+// built around "the question" would have had to grow a second shape immediately.
+//
+// So a request carries a FIELD SET and a RESPONSE SET, and every existing surface is a special case:
+// an options-only choice is fields `[]`; a single text prompt is one field with one option; a gated
+// tool call is fields plus approve/deny.
+//
+// ## The serialization trap this schema is written against
+//
+// `FlowActorExecution_PausedApproval.approvalId` was once typed as a uuid on the reasonable
+// assumption that an id is a uuid; the producing SDK emits `aitxt-…`. Serializing is `JSON.stringify`
+// and does NOT validate — only the resume's `parse` does — so every paused turn persisted perfectly
+// and became unresumable, reported as a corrupted blob naming the wrong cause. The unit fixtures used
+// real uuids and were therefore more conformant than production, so they could never reproduce it.
+//
+// Consequence, applied here: every identifier this schema BORROWS from a producer it does not own is
+// an opaque non-empty string, never a format. Assert a format only for ids this layer mints.
+//===============================================================
+/**
+ * What a person is being asked FOR in one field.
+ *
+ * The one named source for this vocabulary. `MetaWorkflow_ElicitationQuestionKind` in the
+ * application-creation layer is an alias of this enum rather than a second copy — the values decide
+ * how an answer is validated, so two enums that drift would mean a CHOICE accepted against the wrong
+ * option set.
+ */
+export var HumanDecision_FieldKind;
+(function (HumanDecision_FieldKind) {
+    /** Prose. The answer is whatever the person writes, trimmed, and must not be empty. */
+    HumanDecision_FieldKind["FREE_TEXT"] = "free_text";
+    /** One of a closed set the request states. An answer outside `options` is REFUSED, never coerced. */
+    HumanDecision_FieldKind["CHOICE"] = "choice";
+    /**
+     * Yes or no.
+     *
+     * The answer must resolve to an unambiguous affirmative or negative and is stored CANONICALLY, not
+     * as the person typed it — downstream readers compare a token rather than re-parsing prose. An
+     * answer that does not resolve ("probably") is refused rather than guessed, because these decide
+     * things: the regulated-domain screening questions are `CONFIRM`s, and one of them silently
+     * meaning "yes" is a compliance posture nobody chose. Resolution lives with the creation layer
+     * that owns the canonical vocabulary.
+     */
+    HumanDecision_FieldKind["CONFIRM"] = "confirm";
+})(HumanDecision_FieldKind || (HumanDecision_FieldKind = {}));
+/**
+ * What giving a particular answer MEANS for the work that is waiting.
+ *
+ * Closed, and deliberately three members rather than one per button. Hosts spell their buttons
+ * differently — accept/decline/cancel, submit/cancel, approve/deny — and a vocabulary with one
+ * member per spelling would have to grow every time a surface is added. What a reader actually needs
+ * to know is whether the waiting work proceeds, and whether it proceeds WITH the values.
+ */
+export var HumanDecision_ResponseIntent;
+(function (HumanDecision_ResponseIntent) {
+    /** Proceed, using the values supplied. Fields are validated and required. */
+    HumanDecision_ResponseIntent["PROCEED_WITH_VALUES"] = "proceed_with_values";
+    /**
+     * Proceed WITHOUT values — the person declined to answer and the work continues on its own
+     * judgement, stating the assumption it made.
+     *
+     * This is also what a DENIAL is, and the distinction matters: denying a gated tool call does not
+     * abort the turn, it resumes it so the model can answer the refusal. Anything that ends the work
+     * is `ABORT`.
+     */
+    HumanDecision_ResponseIntent["PROCEED_WITHOUT_VALUES"] = "proceed_without_values";
+    /** End the waiting work. Nothing is produced and no values are read. */
+    HumanDecision_ResponseIntent["ABORT"] = "abort";
+})(HumanDecision_ResponseIntent || (HumanDecision_ResponseIntent = {}));
+/** One thing a person is asked. `why` is the rationale a host may supply; an interview usually has none. */
+export const HumanDecision_FieldSchema = z.object({
+    /** Stable id the answer is matched by. Host-minted and OPAQUE to this layer — never a format. */
+    ref: z.string().min(1),
+    /** The question, in the words the person should read. Never derived from `ref`. */
+    question: z.string().min(1),
+    kind: z.enum(HumanDecision_FieldKind),
+    /** The complete set, and REQUIRED when `kind` is CHOICE — a choice with no options is unanswerable. */
+    options: z.array(z.string().min(1)).optional(),
+    /** What the waiting work would do differently depending on the answer, when the host can say. */
+    why: z.string().min(1).optional(),
+}).superRefine((field, context) => {
+    if (field.kind !== HumanDecision_FieldKind.CHOICE)
+        return;
+    if ((field.options ?? []).length === 0) {
+        context.addIssue({
+            code: 'custom',
+            message: `Field "${field.ref}" is a CHOICE and states no options, so it cannot be answered.`,
+            path: ['options'],
+        });
+    }
+});
+/** One answer a person may give, and what it means for the waiting work. */
+export const HumanDecision_ResponseOptionSchema = z.object({
+    /** Host-defined id echoed back on the answer. Open by design: a host names its own buttons. */
+    ref: z.string().min(1),
+    /** What the button says. Authored text, never humanized from `ref`. */
+    label: z.string().min(1),
+    intent: z.enum(HumanDecision_ResponseIntent),
+    /** Why a person would pick this one, when it is not obvious from the label. */
+    description: z.string().min(1).optional(),
+});
+/**
+ * Something is waiting for a person.
+ *
+ * Projected by whichever host owns the suspended work; never persisted by this layer.
+ */
+export const HumanDecision_RequestSchema = z.object({
+    /**
+     * Correlates this request with the answer that settles it.
+     *
+     * OPAQUE — hosts key it to whatever they already have (a run id, an ACP session id, an actor-task
+     * id), and this layer asserts only that it is present. See the file header for what asserting a
+     * format on a borrowed id once cost.
+     */
+    decisionId: z.string().min(1),
+    /** One line naming what is waiting, for a reader who has not been following the run. */
+    title: z.string().min(1),
+    /** What answering will cause, and what happens if nobody does. */
+    description: z.string().min(1),
+    /** May be empty: a pure approve/deny asks for a verdict and no values. */
+    fields: z.array(HumanDecision_FieldSchema),
+    /** At least one — a request nobody can answer is not a request. */
+    options: z.array(HumanDecision_ResponseOptionSchema).min(1),
+    /** ISO instant the request was raised. */
+    requestedAt: z.string().min(1),
+    /**
+     * ISO instant after which answering is refused.
+     *
+     * Optional, and ABSENT MEANS IT DOES NOT LAPSE — which is the honest reading for work that simply
+     * waits, such as a playbook checkpoint on disk. Do not default it: a deadline nothing enforces is
+     * the defect the paused-approval expiry was fixed for, where the field was declared, rendered, and
+     * never written by any producer.
+     */
+    expiresAt: z.string().min(1).optional(),
+});
+/** What a person answered. */
+export const HumanDecision_AnswerSchema = z.object({
+    decisionId: z.string().min(1),
+    /** Which `options[].ref` was chosen. */
+    optionRef: z.string().min(1),
+    /** One entry per answered field. Empty for an option whose intent is not PROCEED_WITH_VALUES. */
+    values: z.array(z.object({ ref: z.string().min(1), value: z.string() })).default([]),
+});
+/** Refused because the answer does not settle the request it names. */
+export class HumanDecisionAnswerError extends Error {
+}
+/**
+ * Check an answer against the request it claims to settle, and return the values by ref.
+ *
+ * Refuses rather than coerces, at every branch, for the reason the CONFIRM doc gives: these answers
+ * decide things, and a silently-accepted wrong one becomes the record. `CONFIRM` resolution is NOT
+ * done here — this layer does not own the canonical affirmative/negative vocabulary — so a CONFIRM
+ * field is validated as non-empty and the creation layer canonicalises it.
+ *
+ * Note what is deliberately NOT validated: an option this request never offered is refused, but the
+ * INTENT is trusted, because the host authored both the option and its meaning.
+ */
+export function resolveHumanDecisionAnswer(request, answer) {
+    if (answer.decisionId !== request.decisionId) {
+        throw new HumanDecisionAnswerError(`Answer names decision "${answer.decisionId}" but the request is "${request.decisionId}".`);
+    }
+    const option = request.options.find((candidate) => candidate.ref === answer.optionRef);
+    if (!option) {
+        throw new HumanDecisionAnswerError(`Decision "${request.decisionId}" never offered "${answer.optionRef}". Offered: ${request.options.map((entry) => entry.ref).join(', ')}.`);
+    }
+    if (option.intent !== HumanDecision_ResponseIntent.PROCEED_WITH_VALUES) {
+        if (answer.values.length > 0) {
+            throw new HumanDecisionAnswerError(`Option "${option.ref}" does not carry values, but ${answer.values.length} were supplied.`);
+        }
+        return { option, values: {} };
+    }
+    const byRef = new Map(request.fields.map((field) => [field.ref, field]));
+    const values = {};
+    for (const entry of answer.values) {
+        const field = byRef.get(entry.ref);
+        if (!field) {
+            throw new HumanDecisionAnswerError(`Decision "${request.decisionId}" never asks "${entry.ref}". Asked: ${[...byRef.keys()].join(', ')}.`);
+        }
+        if (Object.hasOwn(values, entry.ref)) {
+            throw new HumanDecisionAnswerError(`Field "${entry.ref}" was answered more than once.`);
+        }
+        const trimmed = entry.value.trim();
+        if (trimmed.length === 0) {
+            throw new HumanDecisionAnswerError(`Field "${entry.ref}" was answered with empty text.`);
+        }
+        if (field.kind === HumanDecision_FieldKind.CHOICE && !(field.options ?? []).includes(trimmed)) {
+            throw new HumanDecisionAnswerError(`Field "${entry.ref}" is a CHOICE; "${trimmed}" is not one of its options (${(field.options ?? []).join(', ')}).`);
+        }
+        values[entry.ref] = trimmed;
+    }
+    /*
+     * Every field must be answered, and the contract declares no optional ones.
+     *
+     * A missing answer is a gap in the interview rather than an implicit "no" — several questions are
+     * written to be answerable when they do not apply ("answer 'none' if there is no trigger"), so
+     * silently proceeding is how a record acquires an empty field that later reads as a decision
+     * somebody made.
+     */
+    const missing = request.fields.filter((field) => !Object.hasOwn(values, field.ref)).map((field) => field.ref);
+    if (missing.length > 0) {
+        throw new HumanDecisionAnswerError(`Decision "${request.decisionId}" needs an answer to every field it asks; missing: ${missing.join(', ')}.`);
+    }
+    return { option, values };
+}
+//# sourceMappingURL=human-decision.shared.schemas.js.map

package/dist/esm/flows-actors/human-decision.shared.schemas.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"human-decision.shared.schemas.js","sourceRoot":"","sources":["../../../../src/flows-actors/human-decision.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\n//===============================================================\n// HUMAN DECISION — one payload for every question a person is asked\n//\n// ## What this is, and what it deliberately is NOT\n//\n// This is the CONTRACT for \"something is waiting for a person\": what they are being asked, what\n// answers they may give, and what a given answer means. It is not a store.\n//\n// That distinction was measured rather than assumed, and it is the whole reason this file is small.\n// Three surfaces suspend on a human, and where each keeps its pending state has MOVED since this was\n// written — the table is the current state, 2026-09-20:\n//\n// | question | pending state lives in | its own shape |\n// |---|---|---|\n// | a mid-run clarification | the run's own ACTOR EXECUTION row — `suspension` (this payload) + `checkpoint` (the resume inputs), status `AWAITING_APPROVAL` | `PlaybookRunSuspensionCheckpoint` |\n// | a parked coding run | the durable actor-task row (`output.suspension`) — moves onto the same two execution fields with the coding lane (#1359) | `CodingAgent_SessionSuspension` |\n// | a playbook's up-front interview | nowhere — it is DECLARED on the playbook and asked before a run exists | `MetaWorkflow_ElicitationSpec` |\n//\n// The history, because the first line of that table was argued the other way twice. Until 2026-09-20\n// this header said \"a playbook run creates no execution row at all, so there is no single plane to\n// move them onto\" — true until #1343 gave a run an `ActorSystem_Execution`. It then said the\n// conclusion was unchanged because \"that row records the RUN, not what the run is waiting for\", and\n// that a clarification was \"a disposable checkpoint whose whole point is that it costs nothing to\n// lose\". #1360 measured that and reversed it: once the engine DRIVES the run (#1358), a wait that\n// lives beside the row needs a second handle, a second store and a second listing to say what the\n// row's own status should, and a suspended run settled `COMPLETED` on the plane while waiting on a\n// person. The row now says what the run is waiting for, and the engine resumes it under the same id.\n//\n// The up-front interview stays where it is for the reason it always had: it is answered BEFORE a run\n// exists to hang it on.\n//\n// Each host PROJECTS what it is waiting for into a `HumanDecision_Request`, and every reader — a\n// workbench panel, a CLI, a future notification — consumes only this. On the actor-system plane the\n// engine persists that projection itself (`ActorExecution_Suspension.decision`); elsewhere it is\n// built on read. What a person is being asked is everyone's either way.\n//\n// ## Why not extend the existing paused-approval state\n//\n// `FlowActorExecution_PausedApproval` looks like the obvious host and is the wrong one. It carries\n// `sdkModelMessages` (\"the AI-SDK model-message array to RESUME from — opaque to us\"),\n// `pendingToolName` and `pendingToolArgs`: it is an agent-STREAM resume contract. A playbook\n// interview has no model stream and no pending tool, so extending it would leave three required\n// fields meaningless for half its uses. Two distinct concepts, two schemas.\n//\n// ## Two lists, because one question is the special case and not the rule\n//\n// The pre-existing decision components each model exactly ONE question — an options-only choice, or\n// a single text input. A playbook interview asks fifteen at once, so neither fits, and a payload\n// built around \"the question\" would have had to grow a second shape immediately.\n//\n// So a request carries a FIELD SET and a RESPONSE SET, and every existing surface is a special case:\n// an options-only choice is fields `[]`; a single text prompt is one field with one option; a gated\n// tool call is fields plus approve/deny.\n//\n// ## The serialization trap this schema is written against\n//\n// `FlowActorExecution_PausedApproval.approvalId` was once typed as a uuid on the reasonable\n// assumption that an id is a uuid; the producing SDK emits `aitxt-…`. Serializing is `JSON.stringify`\n// and does NOT validate — only the resume's `parse` does — so every paused turn persisted perfectly\n// and became unresumable, reported as a corrupted blob naming the wrong cause. The unit fixtures used\n// real uuids and were therefore more conformant than production, so they could never reproduce it.\n//\n// Consequence, applied here: every identifier this schema BORROWS from a producer it does not own is\n// an opaque non-empty string, never a format. Assert a format only for ids this layer mints.\n//===============================================================\n\n/**\n * What a person is being asked FOR in one field.\n *\n * The one named source for this vocabulary. `MetaWorkflow_ElicitationQuestionKind` in the\n * application-creation layer is an alias of this enum rather than a second copy — the values decide\n * how an answer is validated, so two enums that drift would mean a CHOICE accepted against the wrong\n * option set.\n */\nexport enum HumanDecision_FieldKind {\n /** Prose. The answer is whatever the person writes, trimmed, and must not be empty. */\n FREE_TEXT = 'free_text',\n /** One of a closed set the request states. An answer outside `options` is REFUSED, never coerced. */\n CHOICE = 'choice',\n /**\n * Yes or no.\n *\n * The answer must resolve to an unambiguous affirmative or negative and is stored CANONICALLY, not\n * as the person typed it — downstream readers compare a token rather than re-parsing prose. An\n * answer that does not resolve (\"probably\") is refused rather than guessed, because these decide\n * things: the regulated-domain screening questions are `CONFIRM`s, and one of them silently\n * meaning \"yes\" is a compliance posture nobody chose. Resolution lives with the creation layer\n * that owns the canonical vocabulary.\n */\n CONFIRM = 'confirm',\n}\n\n/**\n * What giving a particular answer MEANS for the work that is waiting.\n *\n * Closed, and deliberately three members rather than one per button. Hosts spell their buttons\n * differently — accept/decline/cancel, submit/cancel, approve/deny — and a vocabulary with one\n * member per spelling would have to grow every time a surface is added. What a reader actually needs\n * to know is whether the waiting work proceeds, and whether it proceeds WITH the values.\n */\nexport enum HumanDecision_ResponseIntent {\n /** Proceed, using the values supplied. Fields are validated and required. */\n PROCEED_WITH_VALUES = 'proceed_with_values',\n /**\n * Proceed WITHOUT values — the person declined to answer and the work continues on its own\n * judgement, stating the assumption it made.\n *\n * This is also what a DENIAL is, and the distinction matters: denying a gated tool call does not\n * abort the turn, it resumes it so the model can answer the refusal. Anything that ends the work\n * is `ABORT`.\n */\n PROCEED_WITHOUT_VALUES = 'proceed_without_values',\n /** End the waiting work. Nothing is produced and no values are read. */\n ABORT = 'abort',\n}\n\n/** One thing a person is asked. `why` is the rationale a host may supply; an interview usually has none. */\nexport const HumanDecision_FieldSchema = z.object({\n /** Stable id the answer is matched by. Host-minted and OPAQUE to this layer — never a format. */\n ref: z.string().min(1),\n /** The question, in the words the person should read. Never derived from `ref`. */\n question: z.string().min(1),\n kind: z.enum(HumanDecision_FieldKind),\n /** The complete set, and REQUIRED when `kind` is CHOICE — a choice with no options is unanswerable. */\n options: z.array(z.string().min(1)).optional(),\n /** What the waiting work would do differently depending on the answer, when the host can say. */\n why: z.string().min(1).optional(),\n}).superRefine((field, context) => {\n if (field.kind !== HumanDecision_FieldKind.CHOICE) return;\n if ((field.options ?? []).length === 0) {\n context.addIssue({\n code: 'custom',\n message: `Field \"${field.ref}\" is a CHOICE and states no options, so it cannot be answered.`,\n path: ['options'],\n });\n }\n});\nexport type HumanDecision_Field = z.infer<typeof HumanDecision_FieldSchema>;\n\n/** One answer a person may give, and what it means for the waiting work. */\nexport const HumanDecision_ResponseOptionSchema = z.object({\n /** Host-defined id echoed back on the answer. Open by design: a host names its own buttons. */\n ref: z.string().min(1),\n /** What the button says. Authored text, never humanized from `ref`. */\n label: z.string().min(1),\n intent: z.enum(HumanDecision_ResponseIntent),\n /** Why a person would pick this one, when it is not obvious from the label. */\n description: z.string().min(1).optional(),\n});\nexport type HumanDecision_ResponseOption = z.infer<typeof HumanDecision_ResponseOptionSchema>;\n\n/**\n * Something is waiting for a person.\n *\n * Projected by whichever host owns the suspended work; never persisted by this layer.\n */\nexport const HumanDecision_RequestSchema = z.object({\n /**\n * Correlates this request with the answer that settles it.\n *\n * OPAQUE — hosts key it to whatever they already have (a run id, an ACP session id, an actor-task\n * id), and this layer asserts only that it is present. See the file header for what asserting a\n * format on a borrowed id once cost.\n */\n decisionId: z.string().min(1),\n /** One line naming what is waiting, for a reader who has not been following the run. */\n title: z.string().min(1),\n /** What answering will cause, and what happens if nobody does. */\n description: z.string().min(1),\n /** May be empty: a pure approve/deny asks for a verdict and no values. */\n fields: z.array(HumanDecision_FieldSchema),\n /** At least one — a request nobody can answer is not a request. */\n options: z.array(HumanDecision_ResponseOptionSchema).min(1),\n /** ISO instant the request was raised. */\n requestedAt: z.string().min(1),\n /**\n * ISO instant after which answering is refused.\n *\n * Optional, and ABSENT MEANS IT DOES NOT LAPSE — which is the honest reading for work that simply\n * waits, such as a playbook checkpoint on disk. Do not default it: a deadline nothing enforces is\n * the defect the paused-approval expiry was fixed for, where the field was declared, rendered, and\n * never written by any producer.\n */\n expiresAt: z.string().min(1).optional(),\n});\nexport type HumanDecision_Request = z.infer<typeof HumanDecision_RequestSchema>;\n\n/** What a person answered. */\nexport const HumanDecision_AnswerSchema = z.object({\n decisionId: z.string().min(1),\n /** Which `options[].ref` was chosen. */\n optionRef: z.string().min(1),\n /** One entry per answered field. Empty for an option whose intent is not PROCEED_WITH_VALUES. */\n values: z.array(z.object({ ref: z.string().min(1), value: z.string() })).default([]),\n});\nexport type HumanDecision_Answer = z.infer<typeof HumanDecision_AnswerSchema>;\n\n/** Refused because the answer does not settle the request it names. */\nexport class HumanDecisionAnswerError extends Error {}\n\n/**\n * Check an answer against the request it claims to settle, and return the values by ref.\n *\n * Refuses rather than coerces, at every branch, for the reason the CONFIRM doc gives: these answers\n * decide things, and a silently-accepted wrong one becomes the record. `CONFIRM` resolution is NOT\n * done here — this layer does not own the canonical affirmative/negative vocabulary — so a CONFIRM\n * field is validated as non-empty and the creation layer canonicalises it.\n *\n * Note what is deliberately NOT validated: an option this request never offered is refused, but the\n * INTENT is trusted, because the host authored both the option and its meaning.\n */\nexport function resolveHumanDecisionAnswer(\n request: HumanDecision_Request,\n answer: HumanDecision_Answer,\n): { readonly option: HumanDecision_ResponseOption; readonly values: Readonly<Record<string, string>> } {\n if (answer.decisionId !== request.decisionId) {\n throw new HumanDecisionAnswerError(\n `Answer names decision \"${answer.decisionId}\" but the request is \"${request.decisionId}\".`,\n );\n }\n\n const option = request.options.find((candidate) => candidate.ref === answer.optionRef);\n if (!option) {\n throw new HumanDecisionAnswerError(\n `Decision \"${request.decisionId}\" never offered \"${answer.optionRef}\". Offered: ${request.options.map((entry) => entry.ref).join(', ')}.`,\n );\n }\n\n if (option.intent !== HumanDecision_ResponseIntent.PROCEED_WITH_VALUES) {\n if (answer.values.length > 0) {\n throw new HumanDecisionAnswerError(\n `Option \"${option.ref}\" does not carry values, but ${answer.values.length} were supplied.`,\n );\n }\n return { option, values: {} };\n }\n\n const byRef = new Map(request.fields.map((field) => [field.ref, field]));\n const values: Record<string, string> = {};\n for (const entry of answer.values) {\n const field = byRef.get(entry.ref);\n if (!field) {\n throw new HumanDecisionAnswerError(\n `Decision \"${request.decisionId}\" never asks \"${entry.ref}\". Asked: ${[...byRef.keys()].join(', ')}.`,\n );\n }\n if (Object.hasOwn(values, entry.ref)) {\n throw new HumanDecisionAnswerError(`Field \"${entry.ref}\" was answered more than once.`);\n }\n const trimmed = entry.value.trim();\n if (trimmed.length === 0) {\n throw new HumanDecisionAnswerError(`Field \"${entry.ref}\" was answered with empty text.`);\n }\n if (field.kind === HumanDecision_FieldKind.CHOICE && !(field.options ?? []).includes(trimmed)) {\n throw new HumanDecisionAnswerError(\n `Field \"${entry.ref}\" is a CHOICE; \"${trimmed}\" is not one of its options (${(field.options ?? []).join(', ')}).`,\n );\n }\n values[entry.ref] = trimmed;\n }\n\n /*\n * Every field must be answered, and the contract declares no optional ones.\n *\n * A missing answer is a gap in the interview rather than an implicit \"no\" — several questions are\n * written to be answerable when they do not apply (\"answer 'none' if there is no trigger\"), so\n * silently proceeding is how a record acquires an empty field that later reads as a decision\n * somebody made.\n */\n const missing = request.fields.filter((field) => !Object.hasOwn(values, field.ref)).map((field) => field.ref);\n if (missing.length > 0) {\n throw new HumanDecisionAnswerError(\n `Decision \"${request.decisionId}\" needs an answer to every field it asks; missing: ${missing.join(', ')}.`,\n );\n }\n\n return { option, values };\n}\n"]}

package/dist/esm/flows-actors/mcp-servers.shared.schemas.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"mcp-servers.shared.schemas.d.ts","sourceRoot":"","sources":["~~../../../~~src/flows-actors/mcp-servers.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH;;;;;;;;;;;GAWG;AACH,oBAAY,wBAAwB;IAClC,sEAAsE;IACtE,WAAW,gBAAgB;IAC3B,gFAAgF;IAChF,GAAG,QAAQ;CACZ;AAED;;;;;;;GAOG;AACH,oBAAY,gCAAgC;IAC1C;;;;;OAKG;IACH,sBAAsB,2BAA2B;IACjD,uGAAuG;IACvG,YAAY,iBAAiB;IAC7B,oGAAoG;IACpG,IAAI,SAAS;CACd;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,qCAAqC;;;;~~iBAchD~~,CAAC;AACH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAEpG;;;;;;;GAOG;AACH,eAAO,MAAM,mCAAmC;;;iBAK9C,CAAC;AACH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;iBAStC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAMlE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM5D"}
1	+ {"version":3,"file":"mcp-servers.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/mcp-servers.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH;;;;;;;;;;;GAWG;AACH,oBAAY,wBAAwB;IAClC,sEAAsE;IACtE,WAAW,gBAAgB;IAC3B,gFAAgF;IAChF,GAAG,QAAQ;CACZ;AAED;;;;;;;GAOG;AACH,oBAAY,gCAAgC;IAC1C;;;;;OAKG;IACH,sBAAsB,2BAA2B;IACjD,uGAAuG;IACvG,YAAY,iBAAiB;IAC7B,oGAAoG;IACpG,IAAI,SAAS;CACd;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,qCAAqC;;;;iBAgBhD,CAAC;AACH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAEpG;;;;;;;GAOG;AACH,eAAO,MAAM,mCAAmC;;;iBAK9C,CAAC;AACH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;iBAStC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAMlE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM5D"}

package/dist/esm/flows-actors/mcp-servers.shared.schemas.js CHANGED Viewed

@@ -85,8 +85,10 @@ export var FlowsActors_McpCredentialSubject;
 export const FlowsActors_McpServerCredentialSchema = z.object({
     providerRef: z.string().min(1),
     /**
-     * The slug in the provider's `secretsContract` — the same identifier the env projection names, and
-     * the one both credential resolver ports require.
+     * The provider's `secretsContract` KEY (`accessToken`) — the one both credential resolver ports
+     * require, and NOT the slot's env-var spelling (`VENDOR_ACCESS_TOKEN`) the env projection names.
+     * Stored credentials are keyed on the key (#624), and this value reaches the stores verbatim, so a
+     * spelling here misses a credential that exists.
      *
      * DECLARED rather than derived, because it is not derivable: a provider's contract may carry
      * several secrets, and which of them authorizes an MCP endpoint is a fact about that vendor's