@wildo-ai/saas-models 1.0.1 → 1.1.0

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

@@ -12,6 +12,16 @@ export declare enum FlowsActors_Status {
     READY = "ready",
     PENDING = "pending",
     PROCESSING = "processing",
+    /**
+     * The turn is SUSPENDED at a human-in-the-loop approval boundary: the agent called
+     * an approval-gated tool, the run state is persisted (see `pausedApproval` on the
+     * execution record), and the runtime is waiting for a decision — a
+     * `FLOWS_ACTORS_APPROVAL_RESPONSE` over WebSocket, or an A2A `input-required` task
+     * resolution. NON-terminal: resolves to PROCESSING→COMPLETED on approval, or a
+     * terminal state on denial/expiry. Machine (org/app) turns never enter this state —
+     * approval-gated tools are auto-denied for them (HITL is user-delegated-only in v1).
+     */
+    AWAITING_APPROVAL = "awaiting_approval",
     COMPLETED = "completed",
     FAILED = "failed",
     CANCELLED = "cancelled",
@@ -21,49 +31,49 @@ export declare const FlowsActors_LeafElements_RelationshipSchema: z.ZodDiscrimin
     kind: z.ZodLiteral<FlowsActors_ElementKind.ACTOR>;
     actorId: z.ZodString;
     actorSystemId: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<FlowsActors_ElementKind.FLOW_STEP>;
     flowId: z.ZodString;
     stepId: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<FlowsActors_ElementKind.TASK>;
     taskId: z.ZodString;
     actorSystemId: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<FlowsActors_ElementKind.PLAN_STEP>;
     planId: z.ZodString;
     planStepId: z.ZodString;
     actorSystemId: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>], "kind">;
+}, z.core.$strip>], "kind">;
 export type FlowsActors_LeafElements_Relationship = z.infer<typeof FlowsActors_LeafElements_RelationshipSchema>;
 export declare const FlowsActors_SimpleRelationshipSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<FlowsActors_ElementKind.ACTOR>;
     actorId: z.ZodString;
     actorSystemId: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<FlowsActors_ElementKind.FLOW>;
     flowId: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<FlowsActors_ElementKind.FLOW_STEP>;
     flowId: z.ZodString;
     stepId: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<FlowsActors_ElementKind.TASK>;
     taskId: z.ZodString;
     actorSystemId: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<FlowsActors_ElementKind.PLAN>;
     planId: z.ZodString;
     actorSystemId: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<FlowsActors_ElementKind.ACTOR_SYSTEM>;
     actorSystemId: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<FlowsActors_ElementKind.PLAN_STEP>;
     planId: z.ZodString;
     planStepId: z.ZodString;
     actorSystemId: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>], "kind">;
+}, z.core.$strip>], "kind">;
 export type FlowsActors_SimpleRelationship = z.infer<typeof FlowsActors_SimpleRelationshipSchema>;
 export declare enum FlowsActors_Relation {
     CREATED_BY = "created_by",
@@ -78,37 +88,37 @@ export declare const FlowsActors_RelationshipSchema: z.ZodDiscriminatedUnion<[z.
     kind: z.ZodLiteral<FlowsActors_ElementKind.FLOW>;
     relation: z.ZodEnum<typeof FlowsActors_Relation>;
     flowId: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<FlowsActors_ElementKind.ACTOR>;
     relation: z.ZodEnum<typeof FlowsActors_Relation>;
     actorId: z.ZodString;
     actorSystemId: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<FlowsActors_ElementKind.FLOW_STEP>;
     relation: z.ZodEnum<typeof FlowsActors_Relation>;
     flowId: z.ZodString;
     stepId: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<FlowsActors_ElementKind.TASK>;
     relation: z.ZodEnum<typeof FlowsActors_Relation>;
     taskId: z.ZodString;
     actorSystemId: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<FlowsActors_ElementKind.PLAN>;
     relation: z.ZodEnum<typeof FlowsActors_Relation>;
     planId: z.ZodString;
     actorSystemId: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<FlowsActors_ElementKind.PLAN_STEP>;
     relation: z.ZodEnum<typeof FlowsActors_Relation>;
     planId: z.ZodString;
     planStepId: z.ZodString;
     actorSystemId: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<FlowsActors_ElementKind.ACTOR_SYSTEM>;
     relation: z.ZodEnum<typeof FlowsActors_Relation>;
     actorSystemId: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>], "kind">;
+}, z.core.$strip>], "kind">;
 export type FlowsActors_Relationship = z.infer<typeof FlowsActors_RelationshipSchema>;
 export declare enum FlowsActors_Event_DeliveryStatus {
     PENDING = "pending",
@@ -124,7 +134,7 @@ export declare enum FlowsActors_Event_Type {
     REQUESTED = "requested",
     ACTIONED = "actioned"
 }
-export declare const FlowsActors_Event_ContextSchema: z.ZodObject<{}, z.core.$strip, core.$ZodObjectExtra>;
+export declare const FlowsActors_Event_ContextSchema: z.ZodObject<{}, z.core.$strip>;
 export type FlowsActors_Event_Context = z.infer<typeof FlowsActors_Event_ContextSchema>;
 export declare const FlowsActors_EventSchema: z.ZodObject<{
     _id: z.ZodOptional<z.ZodString>;
@@ -133,31 +143,31 @@ export declare const FlowsActors_EventSchema: z.ZodObject<{
         kind: z.ZodLiteral<FlowsActors_ElementKind.ACTOR>;
         actorId: z.ZodString;
         actorSystemId: z.ZodString;
-    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<FlowsActors_ElementKind.FLOW>;
         flowId: z.ZodString;
-    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<FlowsActors_ElementKind.FLOW_STEP>;
         flowId: z.ZodString;
         stepId: z.ZodString;
-    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<FlowsActors_ElementKind.TASK>;
         taskId: z.ZodString;
         actorSystemId: z.ZodString;
-    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<FlowsActors_ElementKind.PLAN>;
         planId: z.ZodString;
         actorSystemId: z.ZodString;
-    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<FlowsActors_ElementKind.ACTOR_SYSTEM>;
         actorSystemId: z.ZodString;
-    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<FlowsActors_ElementKind.PLAN_STEP>;
         planId: z.ZodString;
         planStepId: z.ZodString;
         actorSystemId: z.ZodString;
-    }, z.core.$strip, core.$ZodObjectExtra>], "kind">>;
-    eventContext: z.ZodOptional<z.ZodObject<{}, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>], "kind">>;
+    eventContext: z.ZodOptional<z.ZodObject<{}, z.core.$strip>>;
     topic: z.ZodString;
     payload: z.ZodAny;
     sequenceNumber: z.ZodOptional<z.ZodNumber>;
@@ -165,15 +175,15 @@ export declare const FlowsActors_EventSchema: z.ZodObject<{
         timestamp: z.ZodString;
         correlationId: z.ZodOptional<z.ZodString>;
         causationId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip, core.$ZodObjectExtra>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
 export type FlowsActors_Event = z.infer<typeof FlowsActors_EventSchema>;
 export declare const FlowsActors_Event_TemplateSchema: z.ZodObject<{
     eventType: z.ZodString;
-    eventContext: z.ZodOptional<z.ZodObject<{}, z.core.$strip, core.$ZodObjectExtra>>;
+    eventContext: z.ZodOptional<z.ZodObject<{}, z.core.$strip>>;
     topic: z.ZodString;
     payloadMapping: z.ZodRecord<z.ZodString, z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type FlowsActors_Event_Template = z.infer<typeof FlowsActors_Event_TemplateSchema>;
 export declare enum FlowsActors_CircuitBreaker_Status {
     CLOSED = "closed",// circuit is closed, requests are allowed
@@ -185,56 +195,60 @@ export declare const FlowsActors_Checkpoint_Schema: z.ZodObject<{
         kind: z.ZodLiteral<FlowsActors_ElementKind.ACTOR>;
         actorId: z.ZodString;
         actorSystemId: z.ZodString;
-    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<FlowsActors_ElementKind.FLOW_STEP>;
         flowId: z.ZodString;
         stepId: z.ZodString;
-    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<FlowsActors_ElementKind.TASK>;
         taskId: z.ZodString;
         actorSystemId: z.ZodString;
-    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<FlowsActors_ElementKind.PLAN_STEP>;
         planId: z.ZodString;
         planStepId: z.ZodString;
         actorSystemId: z.ZodString;
-    }, z.core.$strip, core.$ZodObjectExtra>], "kind">;
+    }, z.core.$strip>], "kind">;
     timestamp: z.ZodString;
     context: z.ZodOptional<z.ZodAny>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type FlowsActors_Checkpoint = z.infer<typeof FlowsActors_Checkpoint_Schema>;
 export declare const FlowsActors_Error_State_BaseSchema: z.ZodObject<{
     circuitBreakerStatus: z.ZodOptional<z.ZodEnum<typeof FlowsActors_CircuitBreaker_Status>>;
     error: z.ZodOptional<z.ZodObject<{
-        type: z.ZodEnum<typeof import("../index.js").ErrorType>;
-        severity: z.ZodEnum<typeof import("../index.js").ErrorSeverity>;
+        type: z.ZodEnum<typeof import("..").ErrorType>;
+        severity: z.ZodEnum<typeof import("..").ErrorSeverity>;
         operationPathKey: z.ZodOptional<z.ZodString>;
         timestamp: z.ZodDate;
-        context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        context: z.ZodOptional<z.ZodObject<{
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$catchall<z.ZodAny>>>;
         ipAddress: z.ZodOptional<z.ZodString>;
-        errorHandlingStrategy: z.ZodOptional<z.ZodEnum<typeof import("../index.js").ErrorHandling_Strategy>>;
-        retryPolicy: z.ZodOptional<z.ZodEnum<typeof import("../index.js").RetryPolicy_BackoffType>>;
+        errorHandlingStrategy: z.ZodOptional<z.ZodEnum<typeof import("..").ErrorHandling_Strategy>>;
+        retryPolicy: z.ZodOptional<z.ZodEnum<typeof import("..").RetryPolicy_BackoffType>>;
         maxRetries: z.ZodOptional<z.ZodNumber>;
         initialDelay: z.ZodOptional<z.ZodNumber>;
         baseDelay: z.ZodOptional<z.ZodNumber>;
         retryCount: z.ZodOptional<z.ZodNumber>;
         lastRetryTime: z.ZodOptional<z.ZodDate>;
-        backendActions: z.ZodArray<z.ZodEnum<typeof import("../index.js").ErrorActionBackend>>;
-        customMessageReference: z.ZodEnum<typeof import("../index.js").ErrorCustomMessageReference>;
+        backendActions: z.ZodArray<z.ZodEnum<typeof import("..").ErrorActionBackend>>;
+        customMessageReference: z.ZodEnum<typeof import("..").ErrorCustomMessageReference>;
         statusCode: z.ZodNumber;
         stack: z.ZodOptional<z.ZodString>;
-        requestUUID: z.ZodOptional<z.ZodString>;
+        correlationId: z.ZodOptional<z.ZodString>;
         initiatorIds: z.ZodNullable<z.ZodOptional<z.ZodObject<{
             organizationId: z.ZodOptional<z.ZodString>;
             userId: z.ZodOptional<z.ZodString>;
             applicationId: z.ZodOptional<z.ZodString>;
-            organizationApiKeyId: z.ZodOptional<z.ZodString>;
-            applicationApiKeyId: 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, core.$ZodObjectExtra>>>;
-        executionType: z.ZodOptional<z.ZodEnum<typeof import("../index.js").ExecutionContext_ExecutionType>>;
+        }, z.core.$strip>>>;
+        executionType: z.ZodOptional<z.ZodEnum<typeof import("..").ExecutionContext_ExecutionType>>;
         userGuidance: z.ZodOptional<z.ZodObject<{
             guidanceKey: z.ZodOptional<z.ZodString>;
             explanation: z.ZodOptional<z.ZodString>;
@@ -243,34 +257,71 @@ export declare const FlowsActors_Error_State_BaseSchema: z.ZodObject<{
             nextAction: z.ZodOptional<z.ZodObject<{
                 label: z.ZodString;
                 ref: z.ZodString;
-                type: z.ZodDefault<z.ZodEnum<typeof import("../index.js").NotificationNextStepType>>;
-            }, z.core.$strip, core.$ZodObjectExtra>>;
+                type: z.ZodDefault<z.ZodEnum<typeof import("..").NotificationNextStepType>>;
+            }, z.core.$strip>>;
             retryAfterSeconds: z.ZodOptional<z.ZodNumber>;
             missingConfiguration: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip, core.$ZodObjectExtra>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
     checkpoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
         point: z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<FlowsActors_ElementKind.ACTOR>;
             actorId: z.ZodString;
             actorSystemId: z.ZodString;
-        }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        }, z.core.$strip>, z.ZodObject<{
             kind: z.ZodLiteral<FlowsActors_ElementKind.FLOW_STEP>;
             flowId: z.ZodString;
             stepId: z.ZodString;
-        }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        }, z.core.$strip>, z.ZodObject<{
             kind: z.ZodLiteral<FlowsActors_ElementKind.TASK>;
             taskId: z.ZodString;
             actorSystemId: z.ZodString;
-        }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        }, z.core.$strip>, z.ZodObject<{
             kind: z.ZodLiteral<FlowsActors_ElementKind.PLAN_STEP>;
             planId: z.ZodString;
             planStepId: z.ZodString;
             actorSystemId: z.ZodString;
-        }, z.core.$strip, core.$ZodObjectExtra>], "kind">;
+        }, z.core.$strip>], "kind">;
         timestamp: z.ZodString;
         context: z.ZodOptional<z.ZodAny>;
-    }, z.core.$strip, core.$ZodObjectExtra>>>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
 export type FlowsActors_Error_State_Base = z.infer<typeof FlowsActors_Error_State_BaseSchema>;
+/**
+ * The stored `machineCredentialId` of a turn that had NO machine credential — i.e. a
+ * user-delegated turn, where the human IS the principal and `userId` already discriminates.
+ *
+ * ## Why a sentinel rather than an absent field
+ *
+ * Both flows-actors families (executions and tasks) are owned by an injected scope FK, and for the
+ * MACHINE variants that FK does not identify the principal:
+ *
+ * - `applicationId` is a DEPLOYMENT SINGLETON, so every app-scope OAuth client resolves to the
+ *   same owner filter — client B could read and cancel client A's work.
+ * - `organizationId` is shared by every machine client of one tenant, with the same consequence
+ *   inside that tenant.
+ *
+ * Since the conversation title / task title carries the opening characters of the originating
+ * prompt, that is a cross-client disclosure of prompt text between separately-credentialed
+ * principals — the harm the per-agent axis was added to prevent, one axis short.
+ *
+ * Storing a normalised value on EVERY row (rather than leaving user-delegated rows null) keeps the
+ * filter a plain equality on both persistence adapters, instead of depending on how each one
+ * matches an absent field. The `*` characters cannot occur in a credential id.
+ */
+export declare const FLOWS_ACTORS_NO_MACHINE_CREDENTIAL = "*user-delegated*";
+/**
+ * The stored agent identity of the DEFAULT (unnamed) A2A agent, and of any transport that has no
+ * agent at all — the WebSocket conversation surface.
+ *
+ * Declared A2A instance refs are constrained to `^[a-z0-9][a-z0-9-]*$`, so the `*` characters make
+ * this unreachable by any real ref. Storing a normalised value on EVERY row keeps the read filter a
+ * plain equality on both persistence adapters rather than depending on how each matches an absent
+ * field.
+ *
+ * ONE source for both families: `A2A_DEFAULT_INSTANCE_REF` aliases this rather than restating it,
+ * because two constants with the same literal are exactly how the task and execution planes would
+ * drift apart.
+ */
+export declare const FLOWS_ACTORS_DEFAULT_AGENT_INSTANCE = "*default*";
 //# sourceMappingURL=flows-actors.commons.shared.schemas.d.ts.map

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

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

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

@@ -18,6 +18,16 @@ export var FlowsActors_Status;
     FlowsActors_Status["READY"] = "ready";
     FlowsActors_Status["PENDING"] = "pending";
     FlowsActors_Status["PROCESSING"] = "processing";
+    /**
+     * The turn is SUSPENDED at a human-in-the-loop approval boundary: the agent called
+     * an approval-gated tool, the run state is persisted (see `pausedApproval` on the
+     * execution record), and the runtime is waiting for a decision — a
+     * `FLOWS_ACTORS_APPROVAL_RESPONSE` over WebSocket, or an A2A `input-required` task
+     * resolution. NON-terminal: resolves to PROCESSING→COMPLETED on approval, or a
+     * terminal state on denial/expiry. Machine (org/app) turns never enter this state —
+     * approval-gated tools are auto-denied for them (HITL is user-delegated-only in v1).
+     */
+    FlowsActors_Status["AWAITING_APPROVAL"] = "awaiting_approval";
     FlowsActors_Status["COMPLETED"] = "completed";
     FlowsActors_Status["FAILED"] = "failed";
     FlowsActors_Status["CANCELLED"] = "cancelled";
@@ -203,4 +213,41 @@ export const FlowsActors_Error_State_BaseSchema = z.object({
     error: WildoError_BackendSchema.optional(),
     checkpoints: FlowsActors_Checkpoint_Schema.array().optional(),
 });
-//# sourceMappingURL=flows-actors.commons.shared.schemas.js.map
+/**
+ * The stored `machineCredentialId` of a turn that had NO machine credential — i.e. a
+ * user-delegated turn, where the human IS the principal and `userId` already discriminates.
+ *
+ * ## Why a sentinel rather than an absent field
+ *
+ * Both flows-actors families (executions and tasks) are owned by an injected scope FK, and for the
+ * MACHINE variants that FK does not identify the principal:
+ *
+ * - `applicationId` is a DEPLOYMENT SINGLETON, so every app-scope OAuth client resolves to the
+ *   same owner filter — client B could read and cancel client A's work.
+ * - `organizationId` is shared by every machine client of one tenant, with the same consequence
+ *   inside that tenant.
+ *
+ * Since the conversation title / task title carries the opening characters of the originating
+ * prompt, that is a cross-client disclosure of prompt text between separately-credentialed
+ * principals — the harm the per-agent axis was added to prevent, one axis short.
+ *
+ * Storing a normalised value on EVERY row (rather than leaving user-delegated rows null) keeps the
+ * filter a plain equality on both persistence adapters, instead of depending on how each one
+ * matches an absent field. The `*` characters cannot occur in a credential id.
+ */
+export const FLOWS_ACTORS_NO_MACHINE_CREDENTIAL = '*user-delegated*';
+/**
+ * The stored agent identity of the DEFAULT (unnamed) A2A agent, and of any transport that has no
+ * agent at all — the WebSocket conversation surface.
+ *
+ * Declared A2A instance refs are constrained to `^[a-z0-9][a-z0-9-]*$`, so the `*` characters make
+ * this unreachable by any real ref. Storing a normalised value on EVERY row keeps the read filter a
+ * plain equality on both persistence adapters rather than depending on how each matches an absent
+ * field.
+ *
+ * ONE source for both families: `A2A_DEFAULT_INSTANCE_REF` aliases this rather than restating it,
+ * because two constants with the same literal are exactly how the task and execution planes would
+ * drift apart.
+ */
+export const FLOWS_ACTORS_DEFAULT_AGENT_INSTANCE = '*default*';
+//# sourceMappingURL=flows-actors.commons.shared.schemas.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"flows-actors.commons.shared.schemas.js","sourceRoot":"","sources":["../../../src/flows-actors/flows-actors.commons.shared.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"flows-actors.commons.shared.schemas.js","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.commons.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport { ResourcePrimaryScope } from \"../resources/resources.shared.schemas\";\nimport { RolesSchema } from \"../security/authorizations/roles.shared.schemas\";\nimport { WildoError_BackendSchema } from \"../errors/errors.shared.schemas\";\n\n//===============================================================\n//  General\n//===============================================================\n\nexport enum FlowsActors_ElementKind {\n  FLOW = \"flow\",\n  ACTOR = \"actor\",\n  ACTOR_SYSTEM = \"actor.system\",\n  FLOW_STEP = \"flow.step\",\n  TASK = \"actor.task\",\n  PLAN = \"actor.plan\",\n  PLAN_STEP = \"actor.plan.step\",\n}\n\nexport enum FlowsActors_Status {\n  READY = \"ready\",\n  PENDING = \"pending\",\n  PROCESSING = \"processing\",\n  /**\n   * The turn is SUSPENDED at a human-in-the-loop approval boundary: the agent called\n   * an approval-gated tool, the run state is persisted (see `pausedApproval` on the\n   * execution record), and the runtime is waiting for a decision — a\n   * `FLOWS_ACTORS_APPROVAL_RESPONSE` over WebSocket, or an A2A `input-required` task\n   * resolution. NON-terminal: resolves to PROCESSING→COMPLETED on approval, or a\n   * terminal state on denial/expiry. Machine (org/app) turns never enter this state —\n   * approval-gated tools are auto-denied for them (HITL is user-delegated-only in v1).\n   */\n  AWAITING_APPROVAL = \"awaiting_approval\",\n  COMPLETED = \"completed\",\n  FAILED = \"failed\",\n  CANCELLED = \"cancelled\",\n  ABORTED = \"aborted\",\n}\n\n//===============================================================\n//  Relationship\n//===============================================================\n\n\nexport const FlowsActors_LeafElements_RelationshipSchema = z.discriminatedUnion(\"kind\", [\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.ACTOR),\n    actorId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.FLOW_STEP),\n    flowId: z.string(),\n    stepId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.TASK),\n    taskId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.PLAN_STEP),\n    planId: z.string(),\n    planStepId: z.string(),\n    actorSystemId: z.string(),\n  }),\n]);\nexport type FlowsActors_LeafElements_Relationship = z.infer<typeof FlowsActors_LeafElements_RelationshipSchema>;\n\n\nexport const FlowsActors_SimpleRelationshipSchema = z.discriminatedUnion(\"kind\", [\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.ACTOR),\n    actorId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.FLOW),\n    flowId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.FLOW_STEP),\n    flowId: z.string(),\n    stepId: z.string(),\n  }),\n\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.TASK),\n    taskId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.PLAN),\n    planId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.ACTOR_SYSTEM),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.PLAN_STEP),\n    planId: z.string(),\n    planStepId: z.string(),\n    actorSystemId: z.string(),\n  }),\n]);\nexport type FlowsActors_SimpleRelationship = z.infer<typeof FlowsActors_SimpleRelationshipSchema>;\n\n\nexport enum FlowsActors_Relation {\n  CREATED_BY = \"created_by\",\n  PARENT_OF = \"parent_of\",\n  CHILD_OF = \"child_of\",\n  PART_OF = \"part_of\",\n  IS_FALLBACK = \"is_fallback\",\n  DEPENDS_ON = \"depends_on\",\n  BLOCKED_BY = \"blocked_by\",\n}\n\nexport const FlowsActors_RelationshipSchema = z.discriminatedUnion(\"kind\", [\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.FLOW),\n    relation: z.enum(FlowsActors_Relation),\n    flowId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.ACTOR),\n    relation: z.enum(FlowsActors_Relation),\n    actorId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.FLOW_STEP),\n    relation: z.enum(FlowsActors_Relation),\n    flowId: z.string(),\n    stepId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.TASK),\n    relation: z.enum(FlowsActors_Relation),\n    taskId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.PLAN),\n    relation: z.enum(FlowsActors_Relation),\n    planId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.PLAN_STEP),\n    relation: z.enum(FlowsActors_Relation),\n    planId: z.string(),\n    planStepId: z.string(),\n    actorSystemId: z.string(),\n  }),\n  z.object({\n    kind: z.literal(FlowsActors_ElementKind.ACTOR_SYSTEM),\n    relation: z.enum(FlowsActors_Relation),\n    actorSystemId: z.string(),\n  }),\n]);\nexport type FlowsActors_Relationship = z.infer<typeof FlowsActors_RelationshipSchema>;\n\n//===============================================================\n//  FlowsActors_Event\n// --------\n// FlowsActors_Events are immutable messages that flow through the system topics,\n// carrying payloads and metadata between flows and actors. They\n// enable loose coupling, traceability through correlation IDs,\n// and event sourcing patterns for building scalable, resilient\n// distributed systems with clear audit trails.\n//===============================================================\n\nexport enum FlowsActors_Event_DeliveryStatus {\n  PENDING = \"pending\",\n  DELIVERED = \"delivered\",\n  FAILED = \"failed\",\n  DEAD_LETTER = \"dead_letter\",\n}\n\nexport enum FlowsActors_Event_Type {\n\n  COMPLETED = \"completed\",\n  FAILED = \"failed\",\n  CANCELLED = \"cancelled\",\n  ABORTED = \"aborted\",\n  REQUESTED = \"requested\",\n  ACTIONED = \"actioned\",\n}\n\nexport const FlowsActors_Event_ContextSchema = z.object({});\nexport type FlowsActors_Event_Context = z.infer<typeof FlowsActors_Event_ContextSchema>;\n\nexport const FlowsActors_EventSchema = z.object({\n  _id: z.string().optional(),\n  eventType: z.enum(FlowsActors_Event_Type),\n  origin : FlowsActors_SimpleRelationshipSchema.optional(),\n  eventContext: FlowsActors_Event_ContextSchema.optional(),\n\n  topic: z.string(),\n  payload: z.any(),\n\n  sequenceNumber: z.number().optional(),\n  tracking : z.object({\n    timestamp: z.string(),\n\n    correlationId: z.string().optional(),\n    causationId: z.string().optional(),\n  }),\n});\nexport type FlowsActors_Event = z.infer<typeof FlowsActors_EventSchema>;\n\nexport const FlowsActors_Event_TemplateSchema = z.object({\n  eventType: z.string(),\n  eventContext: FlowsActors_Event_ContextSchema.optional(),\n  topic: z.string(),\n\n  payloadMapping: z.record(z.string(), z.string()),\n});\nexport type FlowsActors_Event_Template = z.infer<typeof FlowsActors_Event_TemplateSchema>;\n\n//===============================================================\n//  State\n//===============================================================\nexport enum FlowsActors_CircuitBreaker_Status {\n  CLOSED = \"closed\", // circuit is closed, requests are allowed\n  OPEN = \"open\", // circuit is open, requests are blocked\n  HALF_OPEN = \"half_open\", // circuit is half-open, requests are allowed after a timeout\n}\n\nexport const FlowsActors_Checkpoint_Schema = z.object({\n  point : FlowsActors_LeafElements_RelationshipSchema,\n  timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n  context: z.any().optional(),\n});\nexport type FlowsActors_Checkpoint = z.infer<typeof FlowsActors_Checkpoint_Schema>;\n\nexport const FlowsActors_Error_State_BaseSchema = z.object({\n  circuitBreakerStatus: z.enum(FlowsActors_CircuitBreaker_Status).optional(),\n  error: WildoError_BackendSchema.optional(),\n  checkpoints: FlowsActors_Checkpoint_Schema.array().optional(),\n});\nexport type FlowsActors_Error_State_Base = z.infer<typeof FlowsActors_Error_State_BaseSchema>;\n\n\n\n/**\n * The stored `machineCredentialId` of a turn that had NO machine credential — i.e. a\n * user-delegated turn, where the human IS the principal and `userId` already discriminates.\n *\n * ## Why a sentinel rather than an absent field\n *\n * Both flows-actors families (executions and tasks) are owned by an injected scope FK, and for the\n * MACHINE variants that FK does not identify the principal:\n *\n * - `applicationId` is a DEPLOYMENT SINGLETON, so every app-scope OAuth client resolves to the\n *   same owner filter — client B could read and cancel client A's work.\n * - `organizationId` is shared by every machine client of one tenant, with the same consequence\n *   inside that tenant.\n *\n * Since the conversation title / task title carries the opening characters of the originating\n * prompt, that is a cross-client disclosure of prompt text between separately-credentialed\n * principals — the harm the per-agent axis was added to prevent, one axis short.\n *\n * Storing a normalised value on EVERY row (rather than leaving user-delegated rows null) keeps the\n * filter a plain equality on both persistence adapters, instead of depending on how each one\n * matches an absent field. The `*` characters cannot occur in a credential id.\n */\nexport const FLOWS_ACTORS_NO_MACHINE_CREDENTIAL = '*user-delegated*';\n\n/**\n * The stored agent identity of the DEFAULT (unnamed) A2A agent, and of any transport that has no\n * agent at all — the WebSocket conversation surface.\n *\n * Declared A2A instance refs are constrained to `^[a-z0-9][a-z0-9-]*$`, so the `*` characters make\n * this unreachable by any real ref. Storing a normalised value on EVERY row keeps the read filter a\n * plain equality on both persistence adapters rather than depending on how each matches an absent\n * field.\n *\n * ONE source for both families: `A2A_DEFAULT_INSTANCE_REF` aliases this rather than restating it,\n * because two constants with the same literal are exactly how the task and execution planes would\n * drift apart.\n */\nexport const FLOWS_ACTORS_DEFAULT_AGENT_INSTANCE = '*default*';\n"]}