@wildo-ai/saas-models 1.1.5 → 1.1.7

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

@@ -13,10 +13,31 @@ export var FlowsActors_ElementKind;
     FlowsActors_ElementKind["PLAN"] = "actor.plan";
     FlowsActors_ElementKind["PLAN_STEP"] = "actor.plan.step";
 })(FlowsActors_ElementKind || (FlowsActors_ElementKind = {}));
+/**
+ * Which door opened a conversational turn — persisted at turn start, because a decision raised later
+ * in the turn is routed and re-authorized differently depending on it (#1594), and the door is not
+ * recoverable from the row afterwards.
+ */
+export var FlowsActors_InitiationKind;
+(function (FlowsActors_InitiationKind) {
+    /** A signed-in person over the application's WebSocket. */
+    FlowsActors_InitiationKind["WEBSOCKET_SESSION"] = "websocket_session";
+    /** An A2A client — a machine principal, or a person through a client they delegated to. */
+    FlowsActors_InitiationKind["A2A_REQUEST"] = "a2a_request";
+    /** Background work with nobody at the keyboard. Written only by #1611's autonomous entry point. */
+    FlowsActors_InitiationKind["AUTONOMOUS"] = "autonomous";
+})(FlowsActors_InitiationKind || (FlowsActors_InitiationKind = {}));
 export var FlowsActors_Status;
 (function (FlowsActors_Status) {
     FlowsActors_Status["READY"] = "ready";
     FlowsActors_Status["PENDING"] = "pending";
+    /**
+     * Work is running in some process right now, and only that process can settle it. True only while that
+     * process lives, so a conversational turn holds a liveness lease for exactly as long as its row says
+     * PROCESSING; a row left PROCESSING by a process that died is failed by the five-minutely
+     * `interrupted-turn-sweep` once its lease has lapsed (#1780), and an A2A task by the hourly
+     * `a2a-abandoned-task-sweep`.
+     */
     FlowsActors_Status["PROCESSING"] = "processing";
     /**
      * The turn is SUSPENDED at a human-in-the-loop approval boundary: the agent called
@@ -26,7 +47,7 @@ export var FlowsActors_Status;
      * resolution. NON-terminal. A decision — approval OR denial — resumes it to PROCESSING
      * (a denial resumes so the agent can answer the refusal; it is not a cancellation). A
      * pause whose `expiresAt` passes unanswered becomes FAILED: refused at a late decision,
-     * or failed by the hourly `approval-pause-expiry-sweep` (#484). Machine (org/app) turns never enter this state —
+     * or failed by the per-minute `approval-pause-expiry-sweep` (#484). Machine (org/app) turns never enter this state —
      * approval-gated tools are auto-denied for them (HITL is user-delegated-only in v1).
      *
      * ## The same status on the ACTOR-SYSTEM plane, where the decision is a `HumanDecision_Request` (#1360)
@@ -37,7 +58,7 @@ export var FlowsActors_Status;
      * not two: an approval is the special case of a human decision with no fields and approve/deny
      * options (#1269), and A2A already projects this member to `input-required`, which is the general
      * meaning. What differs by plane is the MECHANISM, not the state: the conversational plane resumes
-     * an agent stream from `pausedApproval` and sweeps lapsed windows hourly; the actor-system plane
+     * an agent stream from `pausedApproval` and sweeps lapsed windows every minute; the actor-system plane
      * resumes a host executor from a checkpoint and is swept by nothing, because its decisions carry no
      * window unless the request declares one. The member's NAME is narrower than its meaning.
      */
@@ -295,4 +316,11 @@ export const FLOWS_ACTORS_NO_MACHINE_CREDENTIAL = '*user-delegated*';
  * drift apart.
  */
 export const FLOWS_ACTORS_DEFAULT_AGENT_INSTANCE = '*default*';
+/**
+ * The stored agent instance of an AUTONOMOUS turn (#1611), opened by the autonomous entry point with no
+ * transport at all. Part of every owner filter like the other sentinels, and unreachable by a declared
+ * A2A instance ref (`^[a-z0-9][a-z0-9-]*$`), so no A2A read, continuation or cancel can ever match an
+ * autonomous row: those rows are reached only through the decision verbs, which read by decision id.
+ */
+export const FLOWS_ACTORS_AUTONOMOUS_AGENT_INSTANCE = '*autonomous*';
 //# 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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","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. A decision — approval OR denial — resumes it to PROCESSING\n   * (a denial resumes so the agent can answer the refusal; it is not a cancellation). A\n   * pause whose `expiresAt` passes unanswered becomes FAILED: refused at a late decision,\n   * or failed by the hourly `approval-pause-expiry-sweep` (#484). 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   * ## The same status on the ACTOR-SYSTEM plane, where the decision is a `HumanDecision_Request` (#1360)\n   *\n   * An actor-system execution the engine's driver runs may also stop to ask a person — a mid-run\n   * clarification, a parked question — and it waits in THIS status, with the pending decision and the\n   * resume inputs on the row (`ActorSystem_Execution.suspension` / `.checkpoint`). It is one concept,\n   * not two: an approval is the special case of a human decision with no fields and approve/deny\n   * options (#1269), and A2A already projects this member to `input-required`, which is the general\n   * meaning. What differs by plane is the MECHANISM, not the state: the conversational plane resumes\n   * an agent stream from `pausedApproval` and sweeps lapsed windows hourly; the actor-system plane\n   * resumes a host executor from a checkpoint and is swept by nothing, because its decisions carry no\n   * window unless the request declares one. The member's NAME is narrower than its meaning.\n   */\n  AWAITING_APPROVAL = \"awaiting_approval\",\n  COMPLETED = \"completed\",\n  FAILED = \"failed\",\n  CANCELLED = \"cancelled\",\n  ABORTED = \"aborted\",\n}\n\n/**\n * What each run state MEANS to somebody watching a run — the words, made reachable.\n *\n * The members carry their meanings in JSDoc, which no runtime surface can read, so every surface\n * that had to SHOW one either invented words or printed a bare token. The published API reference\n * did the second: the top-level `status` field carries a description from its resource\n * specification, and the identical enum one level down in `statusChanges[]` carried nothing,\n * because field-doc injection reaches top-level properties only.\n *\n * Authored once here and rendered into every `.describe()` that needs it, so three schemas cannot\n * drift into three accounts of one vocabulary. Exhaustive by type: a tenth state does not compile\n * until it has been worded.\n */\nexport const FLOWS_ACTORS_STATUS_MEANINGS: Readonly<Record<FlowsActors_Status, string>> = {\n  [FlowsActors_Status.READY]: 'Created and ready to start; no work has been done yet.',\n  [FlowsActors_Status.PENDING]: 'Accepted and queued, waiting for a runner to pick it up.',\n  [FlowsActors_Status.PROCESSING]: 'Running now.',\n  [FlowsActors_Status.AWAITING_APPROVAL]: 'Paused on a person\\'s decision — the authorization of something it called, or an answer it asked for — and it resumes when that decision arrives. One that carries an approval window fails if nobody decides before it closes.',\n  [FlowsActors_Status.COMPLETED]: 'Finished, and did what it set out to do.',\n  [FlowsActors_Status.FAILED]: 'Stopped because something went wrong.',\n  [FlowsActors_Status.CANCELLED]: 'Stopped because somebody asked it to stop.',\n  [FlowsActors_Status.ABORTED]: 'Stopped by the system rather than by a person — a shutdown, a timeout, a lost runner, or a run the system declined to start.',\n};\n\n/**\n * One `Values:` legend, in the shape the generated API reference already uses for a described enum,\n * so a NESTED field reads exactly like a top-level one rather than like a second convention.\n */\nexport function describeFlowsActorsStatus(lead: string): string {\n  const legend = Object.entries(FLOWS_ACTORS_STATUS_MEANINGS)\n    .map(([value, meaning]) => `- \\`${value}\\`: ${meaning}`)\n    .join('\\n');\n  return `${lead}\\n\\nValues:\\n${legend}`;\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//===============================================================\n/*\n * `FlowsActors_CircuitBreaker_Status` and the `circuitBreakerStatus` key every error-state object\n * carried were removed on 2026-09-20 (#1363): no writer, no reader, and the circuit-breaker\n * CONFIGURATION they would have reported on was removed in the same change for having no runtime.\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  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"]}
+{"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\n/**\n * Which door opened a conversational turn — persisted at turn start, because a decision raised later\n * in the turn is routed and re-authorized differently depending on it (#1594), and the door is not\n * recoverable from the row afterwards.\n */\nexport enum FlowsActors_InitiationKind {\n  /** A signed-in person over the application's WebSocket. */\n  WEBSOCKET_SESSION = 'websocket_session',\n  /** An A2A client — a machine principal, or a person through a client they delegated to. */\n  A2A_REQUEST = 'a2a_request',\n  /** Background work with nobody at the keyboard. Written only by #1611's autonomous entry point. */\n  AUTONOMOUS = 'autonomous',\n}\n\nexport enum FlowsActors_Status {\n  READY = \"ready\",\n  PENDING = \"pending\",\n  /**\n   * Work is running in some process right now, and only that process can settle it. True only while that\n   * process lives, so a conversational turn holds a liveness lease for exactly as long as its row says\n   * PROCESSING; a row left PROCESSING by a process that died is failed by the five-minutely\n   * `interrupted-turn-sweep` once its lease has lapsed (#1780), and an A2A task by the hourly\n   * `a2a-abandoned-task-sweep`.\n   */\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. A decision — approval OR denial — resumes it to PROCESSING\n   * (a denial resumes so the agent can answer the refusal; it is not a cancellation). A\n   * pause whose `expiresAt` passes unanswered becomes FAILED: refused at a late decision,\n   * or failed by the per-minute `approval-pause-expiry-sweep` (#484). 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   * ## The same status on the ACTOR-SYSTEM plane, where the decision is a `HumanDecision_Request` (#1360)\n   *\n   * An actor-system execution the engine's driver runs may also stop to ask a person — a mid-run\n   * clarification, a parked question — and it waits in THIS status, with the pending decision and the\n   * resume inputs on the row (`ActorSystem_Execution.suspension` / `.checkpoint`). It is one concept,\n   * not two: an approval is the special case of a human decision with no fields and approve/deny\n   * options (#1269), and A2A already projects this member to `input-required`, which is the general\n   * meaning. What differs by plane is the MECHANISM, not the state: the conversational plane resumes\n   * an agent stream from `pausedApproval` and sweeps lapsed windows every minute; the actor-system plane\n   * resumes a host executor from a checkpoint and is swept by nothing, because its decisions carry no\n   * window unless the request declares one. The member's NAME is narrower than its meaning.\n   */\n  AWAITING_APPROVAL = \"awaiting_approval\",\n  COMPLETED = \"completed\",\n  FAILED = \"failed\",\n  CANCELLED = \"cancelled\",\n  ABORTED = \"aborted\",\n}\n\n/**\n * What each run state MEANS to somebody watching a run — the words, made reachable.\n *\n * The members carry their meanings in JSDoc, which no runtime surface can read, so every surface\n * that had to SHOW one either invented words or printed a bare token. The published API reference\n * did the second: the top-level `status` field carries a description from its resource\n * specification, and the identical enum one level down in `statusChanges[]` carried nothing,\n * because field-doc injection reaches top-level properties only.\n *\n * Authored once here and rendered into every `.describe()` that needs it, so three schemas cannot\n * drift into three accounts of one vocabulary. Exhaustive by type: a tenth state does not compile\n * until it has been worded.\n */\nexport const FLOWS_ACTORS_STATUS_MEANINGS: Readonly<Record<FlowsActors_Status, string>> = {\n  [FlowsActors_Status.READY]: 'Created and ready to start; no work has been done yet.',\n  [FlowsActors_Status.PENDING]: 'Accepted and queued, waiting for a runner to pick it up.',\n  [FlowsActors_Status.PROCESSING]: 'Running now.',\n  [FlowsActors_Status.AWAITING_APPROVAL]: 'Paused on a person\\'s decision — the authorization of something it called, or an answer it asked for — and it resumes when that decision arrives. One that carries an approval window fails if nobody decides before it closes.',\n  [FlowsActors_Status.COMPLETED]: 'Finished, and did what it set out to do.',\n  [FlowsActors_Status.FAILED]: 'Stopped because something went wrong.',\n  [FlowsActors_Status.CANCELLED]: 'Stopped because somebody asked it to stop.',\n  [FlowsActors_Status.ABORTED]: 'Stopped by the system rather than by a person — a shutdown, a timeout, a lost runner, or a run the system declined to start.',\n};\n\n/**\n * One `Values:` legend, in the shape the generated API reference already uses for a described enum,\n * so a NESTED field reads exactly like a top-level one rather than like a second convention.\n */\nexport function describeFlowsActorsStatus(lead: string): string {\n  const legend = Object.entries(FLOWS_ACTORS_STATUS_MEANINGS)\n    .map(([value, meaning]) => `- \\`${value}\\`: ${meaning}`)\n    .join('\\n');\n  return `${lead}\\n\\nValues:\\n${legend}`;\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//===============================================================\n/*\n * `FlowsActors_CircuitBreaker_Status` and the `circuitBreakerStatus` key every error-state object\n * carried were removed on 2026-09-20 (#1363): no writer, no reader, and the circuit-breaker\n * CONFIGURATION they would have reported on was removed in the same change for having no runtime.\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  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\n/**\n * The stored agent instance of an AUTONOMOUS turn (#1611), opened by the autonomous entry point with no\n * transport at all. Part of every owner filter like the other sentinels, and unreachable by a declared\n * A2A instance ref (`^[a-z0-9][a-z0-9-]*$`), so no A2A read, continuation or cancel can ever match an\n * autonomous row: those rows are reached only through the decision verbs, which read by decision id.\n */\nexport const FLOWS_ACTORS_AUTONOMOUS_AGENT_INSTANCE = '*autonomous*';\n"]}

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

@@ -7,8 +7,6 @@ export declare const FlowsActors_AccessControlSchema: z.ZodObject<{
     applicationId: z.ZodOptional<z.ZodString>;
     userId: z.ZodOptional<z.ZodString>;
     roles: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<typeof import("..").CORE_APP_ROLES>, z.ZodEnum<typeof import("..").CORE_ORG_ROLES>, z.ZodString]>>>;
-    requiresApproval: z.ZodDefault<z.ZodBoolean>;
-    approverRoles: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<typeof import("..").CORE_APP_ROLES>, z.ZodEnum<typeof import("..").CORE_ORG_ROLES>, z.ZodString]>>>;
 }, z.core.$strip>;
 export type FlowsActors_AccessControl = z.infer<typeof FlowsActors_AccessControlSchema>;
 export declare const FlowsActors_LeafElements_Configuration_Schema: z.ZodObject<{
@@ -19,8 +17,6 @@ export declare const FlowsActors_LeafElements_Configuration_Schema: z.ZodObject<
         applicationId: z.ZodOptional<z.ZodString>;
         userId: z.ZodOptional<z.ZodString>;
         roles: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<typeof import("..").CORE_APP_ROLES>, z.ZodEnum<typeof import("..").CORE_ORG_ROLES>, z.ZodString]>>>;
-        requiresApproval: z.ZodDefault<z.ZodBoolean>;
-        approverRoles: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<typeof import("..").CORE_APP_ROLES>, z.ZodEnum<typeof import("..").CORE_ORG_ROLES>, z.ZodString]>>>;
     }, z.core.$strip>>;
     riskLevel: z.ZodEnum<typeof ResourceOperationRiskLevel>;
 }, z.core.$strip>;
@@ -33,8 +29,6 @@ export declare const FlowsActors_Configuration_Schema: z.ZodObject<{
         applicationId: z.ZodOptional<z.ZodString>;
         userId: z.ZodOptional<z.ZodString>;
         roles: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<typeof import("..").CORE_APP_ROLES>, z.ZodEnum<typeof import("..").CORE_ORG_ROLES>, z.ZodString]>>>;
-        requiresApproval: z.ZodDefault<z.ZodBoolean>;
-        approverRoles: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<typeof import("..").CORE_APP_ROLES>, z.ZodEnum<typeof import("..").CORE_ORG_ROLES>, z.ZodString]>>>;
     }, z.core.$strip>>;
     riskLevel: z.ZodEnum<typeof ResourceOperationRiskLevel>;
     dataClassification: z.ZodOptional<z.ZodEnum<typeof Compliance_DataClassification>>;
@@ -44,11 +38,6 @@ export declare const FlowsActors_Configuration_Schema: z.ZodObject<{
         redactionType: z.ZodEnum<typeof import("..").RedactionType>;
         forRoles: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<typeof import("..").CORE_APP_ROLES>, z.ZodEnum<typeof import("..").CORE_ORG_ROLES>, z.ZodString]>>>;
     }, z.core.$strip>>>;
-    retentionPolicy: z.ZodOptional<z.ZodObject<{
-        retentionDays: z.ZodNumber;
-        autoDelete: z.ZodDefault<z.ZodBoolean>;
-        archiveAfterDays: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type FlowsActors_Configuration = z.infer<typeof FlowsActors_Configuration_Schema>;
 //# sourceMappingURL=flows-actors.configuration.shared.schemas.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"flows-actors.configuration.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.configuration.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,6BAA6B,EAAE,MAAM,sEAAsE,CAAC;AAGrH,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AA0BzG,eAAO,MAAM,+BAA+B;;;;;;;;iBAQ1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAMxF,eAAO,MAAM,6CAA6C;;;;;;;;;;;;iBAIxD,CAAC;AACH,MAAM,MAAM,sCAAsC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6CAA6C,CAAC,CAAC;AAEnH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;iBAO3C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC"}
+{"version":3,"file":"flows-actors.configuration.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/flows-actors/flows-actors.configuration.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,6BAA6B,EAAE,MAAM,sEAAsE,CAAC;AAErH,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAgCzG,eAAO,MAAM,+BAA+B;;;;;;iBAW1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAMxF,eAAO,MAAM,6CAA6C;;;;;;;;;;iBAIxD,CAAC;AACH,MAAM,MAAM,sCAAsC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6CAA6C,CAAC,CAAC;AAEnH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;iBAM3C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC"}

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

@@ -1,13 +1,12 @@
 import { z } from "zod";
 import { Compliance_DataClassification } from "../compliance/data-classification/data-classification.shared.schemas.js";
-import { DataRetentionPolicySchema } from "../compliance/privacy/data-retention.shared.schemas.js";
 import { RedationRulesSchema } from "../compliance/privacy/redaction.shared.schemas.js";
 import { ResourceOperationRiskLevel, ResourcePrimaryScope } from "../resources/resources.shared.schemas.js";
 import { RolesSchema } from "../security/authorizations/roles.shared.schemas.js";
 //===============================================================
 // What a flow/actor system's `config` declares.
 // --------
-// EVERY key here has a reader. Three that did not were removed on 2026-09-20 (#1363):
+// EVERY key here has a reader. Three that did not were removed on 2026-09-20 (#1363), a fourth on 2026-09-25:
 //
 // - `resilience` (circuit breaker, rate limit, bulkhead) — a complete authoring surface with typed
 //   thresholds and event hooks, and no runtime that read any of it. An author who wrote
@@ -17,6 +16,12 @@ import { RolesSchema } from "../security/authorizations/roles.shared.schemas.js"
 //   badge on the system catalog, so the product told an operator a spend limit protected a system
 //   when nothing would ever stop it spending.
 //
+// - `retentionPolicy` (`retentionDays`, `autoDelete`, `archiveAfterDays`) — removed 2026-09-25 (#1613).
+//   Nothing authored it and nothing read it, and it was a FOURTH retention authority beside the
+//   application's `dataRetention` schedule, `auditTrail.archiveAfterDays` and
+//   `tenantTeardown.retentionWindowDays`. How long a system's records are kept is its resources'
+//   `retentionBinding` to a declared class.
+//
 // A setting that reads as a control and does nothing is a defect, not a roadmap. When a runtime
 // exists that enforces one of these, the setting arrives with it — declared, read and pinned in the
 // same change.
@@ -30,8 +35,11 @@ export const FlowsActors_AccessControlSchema = z.object({
     applicationId: z.string().optional(),
     userId: z.string().optional(),
     roles: z.array(RolesSchema).optional(),
-    requiresApproval: z.boolean().default(false),
-    approverRoles: z.array(RolesSchema).optional(),
+    // `requiresApproval` and `approverRoles` were here and were REMOVED by #1594. Both were displayed as
+    // controls in the system catalog and enforced by nothing, which fails open: a reader trusted a launch
+    // gate that did not exist. Who may approve an agent's action is declared on the gated TOOL
+    // (`FunctionTool.humanApproval`) and enforced by one predicate; a launch gate, if ever wanted, is a
+    // route declared the same way, never a flag here.
 });
 //===============================================================
 //  Configuration
@@ -47,6 +55,5 @@ export const FlowsActors_Configuration_Schema = z.object({
     riskLevel: z.enum(ResourceOperationRiskLevel),
     dataClassification: z.enum(Compliance_DataClassification).optional(),
     redactionRules: z.array(RedationRulesSchema).optional(),
-    retentionPolicy: DataRetentionPolicySchema.optional(),
 });
 //# sourceMappingURL=flows-actors.configuration.shared.schemas.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"flows-actors.configuration.shared.schemas.js","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.configuration.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,6BAA6B,EAAE,MAAM,sEAAsE,CAAC;AACrH,OAAO,EAAE,yBAAyB,EAAE,MAAM,qDAAqD,CAAC;AAChG,OAAO,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AACzG,OAAO,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAC;AAG9E,iEAAiE;AACjE,gDAAgD;AAChD,WAAW;AACX,sFAAsF;AACtF,EAAE;AACF,mGAAmG;AACnG,wFAAwF;AACxF,+DAA+D;AAC/D,kGAAkG;AAClG,gGAAgG;AAChG,kGAAkG;AAClG,8CAA8C;AAC9C,EAAE;AACF,gGAAgG;AAChG,oGAAoG;AACpG,eAAe;AACf,iEAAiE;AAEjE,iEAAiE;AACjE,kBAAkB;AAClB,iEAAiE;AAEjE,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;IAC1C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;IACtC,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAC5C,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;CAC/C,CAAC,CAAC;AAGH,iEAAiE;AACjE,iBAAiB;AACjB,iEAAiE;AAEjE,MAAM,CAAC,MAAM,6CAA6C,GAAG,CAAC,CAAC,MAAM,CAAC;IACpE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,aAAa,EAAW,CAAC,CAAC,KAAK,CAAC,+BAA+B,CAAC;IAChE,SAAS,EAAe,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC;CAC3D,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,OAAO,EAAiB,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7C,aAAa,EAAW,CAAC,CAAC,KAAK,CAAC,+BAA+B,CAAC;IAChE,SAAS,EAAe,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC;IAC1D,kBAAkB,EAAM,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,QAAQ,EAAE;IACxE,cAAc,EAAU,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,QAAQ,EAAE;IAC/D,eAAe,EAAS,yBAAyB,CAAC,QAAQ,EAAE;CAC7D,CAAC,CAAC","sourcesContent":["import { z } from \"zod\";\nimport { Compliance_DataClassification } from \"../compliance/data-classification/data-classification.shared.schemas\";\nimport { DataRetentionPolicySchema } from \"../compliance/privacy/data-retention.shared.schemas\";\nimport { RedationRulesSchema } from \"../compliance/privacy/redaction.shared.schemas\";\nimport { ResourceOperationRiskLevel, ResourcePrimaryScope } from \"../resources/resources.shared.schemas\";\nimport { RolesSchema } from \"../security/authorizations/roles.shared.schemas\";\n\n\n//===============================================================\n// What a flow/actor system's `config` declares.\n// --------\n// EVERY key here has a reader. Three that did not were removed on 2026-09-20 (#1363):\n//\n// - `resilience` (circuit breaker, rate limit, bulkhead) — a complete authoring surface with typed\n//   thresholds and event hooks, and no runtime that read any of it. An author who wrote\n//   `circuitBreaker: { enabled: true }` got nothing, silently.\n// - `executionRestrictions` (`maxConcurrentExecutions`, `maxExecutionDuration`, `budgetLimits`) —\n//   enforced nowhere, and WORSE than silent: `budgetLimits.maxCost` lit a \"Budget limits apply\"\n//   badge on the system catalog, so the product told an operator a spend limit protected a system\n//   when nothing would ever stop it spending.\n//\n// A setting that reads as a control and does nothing is a defect, not a roadmap. When a runtime\n// exists that enforces one of these, the setting arrives with it — declared, read and pinned in the\n// same change.\n//===============================================================\n\n//===============================================================\n//  Access Control\n//===============================================================\n\nexport const FlowsActors_AccessControlSchema = z.object({\n  primaryScope: z.enum(ResourcePrimaryScope),\n  organizationId: z.string().optional(),\n  applicationId: z.string().optional(),\n  userId: z.string().optional(),\n  roles: z.array(RolesSchema).optional(),\n  requiresApproval: z.boolean().default(false),\n  approverRoles: z.array(RolesSchema).optional(),\n});\nexport type FlowsActors_AccessControl = z.infer<typeof FlowsActors_AccessControlSchema>;\n\n//===============================================================\n//  Configuration\n//===============================================================\n\nexport const FlowsActors_LeafElements_Configuration_Schema = z.object({\n  timeout: z.number().optional(),\n  accessControl         : z.array(FlowsActors_AccessControlSchema),\n  riskLevel             : z.enum(ResourceOperationRiskLevel),\n});\nexport type FlowsActors_LeafElements_Configuration = z.infer<typeof FlowsActors_LeafElements_Configuration_Schema>;\n\nexport const FlowsActors_Configuration_Schema = z.object({\n  timeout               : z.number().optional(),\n  accessControl         : z.array(FlowsActors_AccessControlSchema),\n  riskLevel             : z.enum(ResourceOperationRiskLevel),\n  dataClassification    : z.enum(Compliance_DataClassification).optional(),\n  redactionRules        : z.array(RedationRulesSchema).optional(),\n  retentionPolicy       : DataRetentionPolicySchema.optional(),\n});\nexport type FlowsActors_Configuration = z.infer<typeof FlowsActors_Configuration_Schema>;\n"]}
+{"version":3,"file":"flows-actors.configuration.shared.schemas.js","sourceRoot":"","sources":["../../../src/flows-actors/flows-actors.configuration.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,6BAA6B,EAAE,MAAM,sEAAsE,CAAC;AACrH,OAAO,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AACzG,OAAO,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAC;AAG9E,iEAAiE;AACjE,gDAAgD;AAChD,WAAW;AACX,8GAA8G;AAC9G,EAAE;AACF,mGAAmG;AACnG,wFAAwF;AACxF,+DAA+D;AAC/D,kGAAkG;AAClG,gGAAgG;AAChG,kGAAkG;AAClG,8CAA8C;AAC9C,EAAE;AACF,wGAAwG;AACxG,gGAAgG;AAChG,8EAA8E;AAC9E,iGAAiG;AACjG,4CAA4C;AAC5C,EAAE;AACF,gGAAgG;AAChG,oGAAoG;AACpG,eAAe;AACf,iEAAiE;AAEjE,iEAAiE;AACjE,kBAAkB;AAClB,iEAAiE;AAEjE,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;IAC1C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;IACtC,qGAAqG;IACrG,sGAAsG;IACtG,2FAA2F;IAC3F,oGAAoG;IACpG,kDAAkD;CACnD,CAAC,CAAC;AAGH,iEAAiE;AACjE,iBAAiB;AACjB,iEAAiE;AAEjE,MAAM,CAAC,MAAM,6CAA6C,GAAG,CAAC,CAAC,MAAM,CAAC;IACpE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,aAAa,EAAW,CAAC,CAAC,KAAK,CAAC,+BAA+B,CAAC;IAChE,SAAS,EAAe,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC;CAC3D,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,OAAO,EAAiB,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7C,aAAa,EAAW,CAAC,CAAC,KAAK,CAAC,+BAA+B,CAAC;IAChE,SAAS,EAAe,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC;IAC1D,kBAAkB,EAAM,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,QAAQ,EAAE;IACxE,cAAc,EAAU,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,QAAQ,EAAE;CAChE,CAAC,CAAC","sourcesContent":["import { z } from \"zod\";\nimport { Compliance_DataClassification } from \"../compliance/data-classification/data-classification.shared.schemas\";\nimport { RedationRulesSchema } from \"../compliance/privacy/redaction.shared.schemas\";\nimport { ResourceOperationRiskLevel, ResourcePrimaryScope } from \"../resources/resources.shared.schemas\";\nimport { RolesSchema } from \"../security/authorizations/roles.shared.schemas\";\n\n\n//===============================================================\n// What a flow/actor system's `config` declares.\n// --------\n// EVERY key here has a reader. Three that did not were removed on 2026-09-20 (#1363), a fourth on 2026-09-25:\n//\n// - `resilience` (circuit breaker, rate limit, bulkhead) — a complete authoring surface with typed\n//   thresholds and event hooks, and no runtime that read any of it. An author who wrote\n//   `circuitBreaker: { enabled: true }` got nothing, silently.\n// - `executionRestrictions` (`maxConcurrentExecutions`, `maxExecutionDuration`, `budgetLimits`) —\n//   enforced nowhere, and WORSE than silent: `budgetLimits.maxCost` lit a \"Budget limits apply\"\n//   badge on the system catalog, so the product told an operator a spend limit protected a system\n//   when nothing would ever stop it spending.\n//\n// - `retentionPolicy` (`retentionDays`, `autoDelete`, `archiveAfterDays`) — removed 2026-09-25 (#1613).\n//   Nothing authored it and nothing read it, and it was a FOURTH retention authority beside the\n//   application's `dataRetention` schedule, `auditTrail.archiveAfterDays` and\n//   `tenantTeardown.retentionWindowDays`. How long a system's records are kept is its resources'\n//   `retentionBinding` to a declared class.\n//\n// A setting that reads as a control and does nothing is a defect, not a roadmap. When a runtime\n// exists that enforces one of these, the setting arrives with it — declared, read and pinned in the\n// same change.\n//===============================================================\n\n//===============================================================\n//  Access Control\n//===============================================================\n\nexport const FlowsActors_AccessControlSchema = z.object({\n  primaryScope: z.enum(ResourcePrimaryScope),\n  organizationId: z.string().optional(),\n  applicationId: z.string().optional(),\n  userId: z.string().optional(),\n  roles: z.array(RolesSchema).optional(),\n  // `requiresApproval` and `approverRoles` were here and were REMOVED by #1594. Both were displayed as\n  // controls in the system catalog and enforced by nothing, which fails open: a reader trusted a launch\n  // gate that did not exist. Who may approve an agent's action is declared on the gated TOOL\n  // (`FunctionTool.humanApproval`) and enforced by one predicate; a launch gate, if ever wanted, is a\n  // route declared the same way, never a flag here.\n});\nexport type FlowsActors_AccessControl = z.infer<typeof FlowsActors_AccessControlSchema>;\n\n//===============================================================\n//  Configuration\n//===============================================================\n\nexport const FlowsActors_LeafElements_Configuration_Schema = z.object({\n  timeout: z.number().optional(),\n  accessControl         : z.array(FlowsActors_AccessControlSchema),\n  riskLevel             : z.enum(ResourceOperationRiskLevel),\n});\nexport type FlowsActors_LeafElements_Configuration = z.infer<typeof FlowsActors_LeafElements_Configuration_Schema>;\n\nexport const FlowsActors_Configuration_Schema = z.object({\n  timeout               : z.number().optional(),\n  accessControl         : z.array(FlowsActors_AccessControlSchema),\n  riskLevel             : z.enum(ResourceOperationRiskLevel),\n  dataClassification    : z.enum(Compliance_DataClassification).optional(),\n  redactionRules        : z.array(RedationRulesSchema).optional(),\n});\nexport type FlowsActors_Configuration = z.infer<typeof FlowsActors_Configuration_Schema>;\n"]}

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

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { FlowsActors_Status } from './flows-actors.commons.shared.schemas';
 import { FlowActorSystem_Kind, FlowActorSystem_Status } from './flows-actors.system.shared.schemas';
 import { ResourcePrimaryScope, ResourceOperationRiskLevel } from '../resources/resources.shared.schemas';
 /**
@@ -7,8 +8,6 @@ import { ResourcePrimaryScope, ResourceOperationRiskLevel } from '../resources/r
  */
 export declare const FlowActorSystem_FrontendRelevantConfigSchema: z.ZodObject<{
     primaryScope: z.ZodEnum<typeof ResourcePrimaryScope>;
-    requiresApproval: z.ZodBoolean;
-    approverRoles: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<typeof import("..").CORE_APP_ROLES>, z.ZodEnum<typeof import("..").CORE_ORG_ROLES>, z.ZodString]>>>;
     riskLevel: z.ZodEnum<typeof ResourceOperationRiskLevel>;
 }, z.core.$strip>;
 export type FlowActorSystem_FrontendRelevantConfig = z.infer<typeof FlowActorSystem_FrontendRelevantConfigSchema>;
@@ -66,8 +65,6 @@ export declare const FlowActorSystem_FrontendInfoSchema: z.ZodObject<{
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     frontendRelevantConfig: z.ZodObject<{
         primaryScope: z.ZodEnum<typeof ResourcePrimaryScope>;
-        requiresApproval: z.ZodBoolean;
-        approverRoles: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<typeof import("..").CORE_APP_ROLES>, z.ZodEnum<typeof import("..").CORE_ORG_ROLES>, z.ZodString]>>>;
         riskLevel: z.ZodEnum<typeof ResourceOperationRiskLevel>;
     }, z.core.$strip>;
     graph: z.ZodOptional<z.ZodObject<{
@@ -88,6 +85,18 @@ export declare const FlowActorSystem_FrontendInfoSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type FlowActorSystem_FrontendInfo = z.infer<typeof FlowActorSystem_FrontendInfoSchema>;
+/**
+ * One autonomous agent the application DECLARES (#1611), as the frontend needs it: what an organization
+ * administrator binds a machine client to, and the actor system its turns converse with.
+ *
+ * Deliberately only the identity. The declaration's `instruction` is the agent's prompt and its schedule is
+ * backend operation detail; a picker needs neither, and `/frontend-info` answers every signed-in user.
+ */
+export declare const FlowsActors_AutonomousAgent_FrontendInfoSchema: z.ZodObject<{
+    ref: z.ZodString;
+    systemRef: z.ZodString;
+}, z.core.$strip>;
+export type FlowsActors_AutonomousAgent_FrontendInfo = z.infer<typeof FlowsActors_AutonomousAgent_FrontendInfoSchema>;
 /**
  * API Response schema for frontend info endpoint
  */
@@ -103,8 +112,6 @@ export declare const FlowsActors_FrontendInfoResponseSchema: z.ZodObject<{
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         frontendRelevantConfig: z.ZodObject<{
             primaryScope: z.ZodEnum<typeof ResourcePrimaryScope>;
-            requiresApproval: z.ZodBoolean;
-            approverRoles: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<typeof import("..").CORE_APP_ROLES>, z.ZodEnum<typeof import("..").CORE_ORG_ROLES>, z.ZodString]>>>;
             riskLevel: z.ZodEnum<typeof ResourceOperationRiskLevel>;
         }, z.core.$strip>;
         graph: z.ZodOptional<z.ZodObject<{
@@ -124,12 +131,30 @@ export declare const FlowsActors_FrontendInfoResponseSchema: z.ZodObject<{
             }, z.core.$strip>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
+    autonomousAgents: z.ZodArray<z.ZodObject<{
+        ref: z.ZodString;
+        systemRef: z.ZodString;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type FlowsActors_FrontendInfoResponse = z.infer<typeof FlowsActors_FrontendInfoResponseSchema>;
 export declare const FlowsActors_ConversationExecutionSchema: z.ZodObject<{
     executionId: z.ZodString;
     systemRef: z.ZodString;
     createdAt: z.ZodDate;
+    status: z.ZodEnum<typeof FlowsActors_Status>;
+    pendingApproval: z.ZodOptional<z.ZodObject<{
+        approvalRequested: z.ZodLiteral<true>;
+        approvalId: z.ZodString;
+        decisionRef: z.ZodOptional<z.ZodString>;
+        routeKind: z.ZodOptional<z.ZodEnum<typeof import("./human-decision.shared.schemas").HumanDecision_RouteKind>>;
+        toolName: z.ZodString;
+        toolArgs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        toolInputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        requestedAt: z.ZodString;
+        expiresAt: z.ZodOptional<z.ZodString>;
+        reasonCodes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        description: z.ZodString;
+    }, z.core.$strip>>;
     messages: z.ZodArray<z.ZodObject<{
         id: z.ZodUUID;
         role: z.ZodEnum<typeof import("./flows-actors-execution.shared.schemas").FlowsActors_ConversationRole>;
@@ -145,6 +170,20 @@ export declare const FlowsActors_ConversationHistoryResponseSchema: z.ZodObject<
         executionId: z.ZodString;
         systemRef: z.ZodString;
         createdAt: z.ZodDate;
+        status: z.ZodEnum<typeof FlowsActors_Status>;
+        pendingApproval: z.ZodOptional<z.ZodObject<{
+            approvalRequested: z.ZodLiteral<true>;
+            approvalId: z.ZodString;
+            decisionRef: z.ZodOptional<z.ZodString>;
+            routeKind: z.ZodOptional<z.ZodEnum<typeof import("./human-decision.shared.schemas").HumanDecision_RouteKind>>;
+            toolName: z.ZodString;
+            toolArgs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            toolInputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            requestedAt: z.ZodString;
+            expiresAt: z.ZodOptional<z.ZodString>;
+            reasonCodes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            description: z.ZodString;
+        }, z.core.$strip>>;
         messages: z.ZodArray<z.ZodObject<{
             id: z.ZodUUID;
             role: z.ZodEnum<typeof import("./flows-actors-execution.shared.schemas").FlowsActors_ConversationRole>;

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

@@ -1 +1 @@
-{"version":3,"file":"flows-actors.frontend.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.frontend.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AAazG;;;GAGG;AACH,eAAO,MAAM,4CAA4C;;;;;iBAcvD,CAAC;AACH,MAAM,MAAM,sCAAsC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4CAA4C,CAAC,CAAC;AAYlH,oBAAY,6BAA6B;IACvC,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,KAAK,UAAU;CAChB;AAED,eAAO,MAAM,+BAA+B;;;;;;;;;iBAc1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,+BAA+B;;;iBAG1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;iBAG9C,CAAC;AACH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG;;;GAGG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2B7C,CAAC;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F;;GAEG;AACH,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAEjD,CAAC;AACH,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AAUtG,eAAO,MAAM,uCAAuC;;;;;;;;;;;;iBAMlD,CAAC;AACH,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uCAAuC,CAAC,CAAC;AAExG,eAAO,MAAM,6CAA6C;;;;;;;;;;;;;;iBAExD,CAAC;AACH,MAAM,MAAM,uCAAuC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6CAA6C,CAAC,CAAC"}
+{"version":3,"file":"flows-actors.frontend.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/flows-actors/flows-actors.frontend.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAE3E,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AAYzG;;;GAGG;AACH,eAAO,MAAM,4CAA4C;;;iBAQvD,CAAC;AACH,MAAM,MAAM,sCAAsC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4CAA4C,CAAC,CAAC;AAYlH,oBAAY,6BAA6B;IACvC,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,KAAK,UAAU;CAChB;AAED,eAAO,MAAM,+BAA+B;;;;;;;;;iBAc1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,+BAA+B;;;iBAG1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;iBAG9C,CAAC;AACH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG;;;GAGG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2B7C,CAAC;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F;;;;;;GAMG;AACH,eAAO,MAAM,8CAA8C;;;iBAGzD,CAAC;AACH,MAAM,MAAM,wCAAwC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8CAA8C,CAAC,CAAC;AAEtH;;GAEG;AACH,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQjD,CAAC;AACH,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AAUtG,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkBlD,CAAC;AACH,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uCAAuC,CAAC,CAAC;AAExG,eAAO,MAAM,6CAA6C;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAExD,CAAC;AACH,MAAM,MAAM,uCAAuC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6CAA6C,CAAC,CAAC"}

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

@@ -1,8 +1,9 @@
 import { z } from 'zod';
 import { FlowActorExecution_MessageSchema } from './flows-actors-execution.shared.schemas.js';
+import { FlowsActors_Status } from './flows-actors.commons.shared.schemas.js';
+import { WS_FlowsActorsApprovalAnnouncementDataSchema } from '../requests/websocket.shared.schemas.js';
 import { FlowActorSystem_Kind, FlowActorSystem_Status } from './flows-actors.system.shared.schemas.js';
 import { ResourcePrimaryScope, ResourceOperationRiskLevel } from '../resources/resources.shared.schemas.js';
-import { RolesSchema } from '../security/authorizations/roles.shared.schemas.js';
 //===============================================================
 //  FlowActorSystem Frontend Schemas
 // --------
@@ -17,10 +18,6 @@ import { RolesSchema } from '../security/authorizations/roles.shared.schemas.js'
 export const FlowActorSystem_FrontendRelevantConfigSchema = z.object({
     /** Primary scope from accessControl - determines context requirements */
     primaryScope: z.enum(ResourcePrimaryScope),
-    /** Whether human approval is required (from accessControl) */
-    requiresApproval: z.boolean(),
-    /** Roles that can approve (from accessControl, if requiresApproval is true) */
-    approverRoles: z.array(RolesSchema).optional(),
     /** Risk level indicator */
     riskLevel: z.enum(ResourceOperationRiskLevel),
     /** Simple boolean - does this system have budget constraints? */
@@ -89,11 +86,28 @@ export const FlowActorSystem_FrontendInfoSchema = z.object({
      */
     graph: FlowActorSystem_FrontendGraphSchema.optional(),
 });
+/**
+ * One autonomous agent the application DECLARES (#1611), as the frontend needs it: what an organization
+ * administrator binds a machine client to, and the actor system its turns converse with.
+ *
+ * Deliberately only the identity. The declaration's `instruction` is the agent's prompt and its schedule is
+ * backend operation detail; a picker needs neither, and `/frontend-info` answers every signed-in user.
+ */
+export const FlowsActors_AutonomousAgent_FrontendInfoSchema = z.object({
+    ref: z.string(),
+    systemRef: z.string(),
+});
 /**
  * API Response schema for frontend info endpoint
  */
 export const FlowsActors_FrontendInfoResponseSchema = z.object({
     systems: z.array(FlowActorSystem_FrontendInfoSchema),
+    /**
+     * Every autonomous agent the application declares, in declaration order. It is the closed set an
+     * organization OAuth client's `autonomousAgentRefs` may name (the backend refuses any other ref), so the
+     * binding form offers exactly these instead of free text (#1812). Empty when the application declares none.
+     */
+    autonomousAgents: z.array(FlowsActors_AutonomousAgent_FrontendInfoSchema),
 });
 //===============================================================
 //  Conversation history (per-system, caller-owned)
@@ -106,6 +120,18 @@ export const FlowsActors_ConversationExecutionSchema = z.object({
     executionId: z.string(),
     systemRef: z.string(),
     createdAt: z.date(),
+    /**
+     * How the thread's latest turn stands (#1601). A thread whose last message is the person's and whose
+     * status is FAILED was interrupted — its host stopped mid-turn — and will not be answered unless the
+     * message is sent again. Without it a reloaded page could not tell that from a turn still working.
+     */
+    status: z.enum(FlowsActors_Status),
+    /**
+     * The decision a thread `awaiting_approval` is waiting on (#1601): the same announcement, and the
+     * same sentence, a page watching the turn received live when it paused. Without it a page loaded
+     * later could not show the decision, and the thread read as an unanswered message.
+     */
+    pendingApproval: WS_FlowsActorsApprovalAnnouncementDataSchema.extend({ description: z.string() }).optional(),
     /** The turns of this execution (user prompt + assistant reply), in order. */
     messages: z.array(FlowActorExecution_MessageSchema),
 });

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

@@ -1 +1 @@
-{"version":3,"file":"flows-actors.frontend.shared.schemas.js","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.frontend.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\nimport { FlowActorExecution_MessageSchema } from './flows-actors-execution.shared.schemas';\nimport { FlowActorSystem_Kind, FlowActorSystem_Status } from './flows-actors.system.shared.schemas';\nimport { ResourcePrimaryScope, ResourceOperationRiskLevel } from '../resources/resources.shared.schemas';\nimport { RolesSchema } from '../security/authorizations/roles.shared.schemas';\n\n//===============================================================\n//  FlowActorSystem Frontend Schemas\n// --------\n// These schemas define the frontend-relevant extraction of FlowActorSystem\n// configuration. The backend extracts and filters this information\n// from the full FlowActorSystem when sending to frontend.\n//===============================================================\n\n\n\n/**\n * Extracted frontend-relevant configuration from FlowActorSystem.config\n * This is NOT stored separately - it's derived at runtime when sending to frontend\n */\nexport const FlowActorSystem_FrontendRelevantConfigSchema = z.object({\n  /** Primary scope from accessControl - determines context requirements */\n  primaryScope: z.enum(ResourcePrimaryScope),\n\n  /** Whether human approval is required (from accessControl) */\n  requiresApproval: z.boolean(),\n\n  /** Roles that can approve (from accessControl, if requiresApproval is true) */\n  approverRoles: z.array(RolesSchema).optional(),\n\n  /** Risk level indicator */\n  riskLevel: z.enum(ResourceOperationRiskLevel),\n\n  /** Simple boolean - does this system have budget constraints? */\n});\nexport type FlowActorSystem_FrontendRelevantConfig = z.infer<typeof FlowActorSystem_FrontendRelevantConfigSchema>;\n\n//===============================================================\n//  Frontend graph (kind-agnostic node/edge projection)\n// --------\n// A NORMALIZED node+edge graph the frontend renders directly (ReactFlow-shaped),\n// projected from the system's structure. ACTOR systems contribute one node per\n// actor; FLOW systems contribute nodes for triggers/steps/finishes and edges\n// from the flow's `edges`. This keeps one render contract for both kinds — the\n// same `flowsActorsViews` host renders either (kind-agnostic invariant).\n//===============================================================\n\nexport enum FlowActorSystem_GraphNodeKind {\n  TRIGGER = 'trigger',\n  STEP = 'step',\n  FINISH = 'finish',\n  ACTOR = 'actor',\n}\n\nexport const FlowActorSystem_GraphNodeSchema = z.object({\n  /** Stable node id (an actor/trigger/step ref, or a synthesized finish id). */\n  id: z.string(),\n  nodeKind: z.enum(FlowActorSystem_GraphNodeKind),\n  label: z.string(),\n\n  // Actor-node attributes (present when nodeKind === ACTOR)\n  roleCategory: z.string().optional(),\n  executionMode: z.string().optional(),\n  agentRef: z.string().optional(),\n\n  // Flow-node attributes (present for TRIGGER / STEP nodes)\n  triggerType: z.string().optional(),\n  stepKind: z.string().optional(),\n});\nexport type FlowActorSystem_GraphNode = z.infer<typeof FlowActorSystem_GraphNodeSchema>;\n\nexport const FlowActorSystem_GraphEdgeSchema = z.object({\n  from: z.string(),\n  to: z.string(),\n});\nexport type FlowActorSystem_GraphEdge = z.infer<typeof FlowActorSystem_GraphEdgeSchema>;\n\nexport const FlowActorSystem_FrontendGraphSchema = z.object({\n  nodes: z.array(FlowActorSystem_GraphNodeSchema),\n  edges: z.array(FlowActorSystem_GraphEdgeSchema),\n});\nexport type FlowActorSystem_FrontendGraph = z.infer<typeof FlowActorSystem_FrontendGraphSchema>;\n\n/**\n * Frontend-only representation of a FlowActorSystem\n * This is what gets sent to the frontend via API\n */\nexport const FlowActorSystem_FrontendInfoSchema = z.object({\n  // Identity\n  ref: z.string(),\n  displayName: z.string(),\n  description: z.string(),\n\n  // Type & Status\n  kind: z.enum(FlowActorSystem_Kind),\n  status: z.enum(FlowActorSystem_Status),\n\n  // Categorization (for UI grouping/filtering)\n  category: z.string().optional(),\n  tags: z.array(z.string()).optional(),\n\n  // Custom metadata (can include icon ref, etc.)\n  metadata: z.record(z.string(), z.string()).optional(),\n\n  // Extracted config relevant to frontend\n  frontendRelevantConfig: FlowActorSystem_FrontendRelevantConfigSchema,\n\n  /**\n   * Renderable node/edge graph of the system (actors for ACTOR systems;\n   * triggers/steps/finishes + edges for FLOW systems). Optional: absent when a\n   * system exposes no structural graph. Lets the frontend hydrate the actor/flow\n   * visualization directly from `/frontend-info` without a second fetch.\n   */\n  graph: FlowActorSystem_FrontendGraphSchema.optional(),\n});\nexport type FlowActorSystem_FrontendInfo = z.infer<typeof FlowActorSystem_FrontendInfoSchema>;\n\n/**\n * API Response schema for frontend info endpoint\n */\nexport const FlowsActors_FrontendInfoResponseSchema = z.object({\n  systems: z.array(FlowActorSystem_FrontendInfoSchema),\n});\nexport type FlowsActors_FrontendInfoResponse = z.infer<typeof FlowsActors_FrontendInfoResponseSchema>;\n\n//===============================================================\n//  Conversation history (per-system, caller-owned)\n// --------\n// One past execution's conversational turns. The `/flows-actors/history`\n// endpoint returns the CALLER'S OWN executions for a system (USER_SELF\n// owner-filtered), most-recent last, so the view hydrates the transcript.\n//===============================================================\n\nexport const FlowsActors_ConversationExecutionSchema = z.object({\n  executionId: z.string(),\n  systemRef: z.string(),\n  createdAt: z.date(),\n  /** The turns of this execution (user prompt + assistant reply), in order. */\n  messages: z.array(FlowActorExecution_MessageSchema),\n});\nexport type FlowsActors_ConversationExecution = z.infer<typeof FlowsActors_ConversationExecutionSchema>;\n\nexport const FlowsActors_ConversationHistoryResponseSchema = z.object({\n  executions: z.array(FlowsActors_ConversationExecutionSchema),\n});\nexport type FlowsActors_ConversationHistoryResponse = z.infer<typeof FlowsActors_ConversationHistoryResponseSchema>;\n"]}
+{"version":3,"file":"flows-actors.frontend.shared.schemas.js","sourceRoot":"","sources":["../../../src/flows-actors/flows-actors.frontend.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\nimport { FlowActorExecution_MessageSchema } from './flows-actors-execution.shared.schemas';\nimport { FlowsActors_Status } from './flows-actors.commons.shared.schemas';\nimport { WS_FlowsActorsApprovalAnnouncementDataSchema } from '../requests/websocket.shared.schemas';\nimport { FlowActorSystem_Kind, FlowActorSystem_Status } from './flows-actors.system.shared.schemas';\nimport { ResourcePrimaryScope, ResourceOperationRiskLevel } from '../resources/resources.shared.schemas';\n\n//===============================================================\n//  FlowActorSystem Frontend Schemas\n// --------\n// These schemas define the frontend-relevant extraction of FlowActorSystem\n// configuration. The backend extracts and filters this information\n// from the full FlowActorSystem when sending to frontend.\n//===============================================================\n\n\n\n/**\n * Extracted frontend-relevant configuration from FlowActorSystem.config\n * This is NOT stored separately - it's derived at runtime when sending to frontend\n */\nexport const FlowActorSystem_FrontendRelevantConfigSchema = z.object({\n  /** Primary scope from accessControl - determines context requirements */\n  primaryScope: z.enum(ResourcePrimaryScope),\n\n  /** Risk level indicator */\n  riskLevel: z.enum(ResourceOperationRiskLevel),\n\n  /** Simple boolean - does this system have budget constraints? */\n});\nexport type FlowActorSystem_FrontendRelevantConfig = z.infer<typeof FlowActorSystem_FrontendRelevantConfigSchema>;\n\n//===============================================================\n//  Frontend graph (kind-agnostic node/edge projection)\n// --------\n// A NORMALIZED node+edge graph the frontend renders directly (ReactFlow-shaped),\n// projected from the system's structure. ACTOR systems contribute one node per\n// actor; FLOW systems contribute nodes for triggers/steps/finishes and edges\n// from the flow's `edges`. This keeps one render contract for both kinds — the\n// same `flowsActorsViews` host renders either (kind-agnostic invariant).\n//===============================================================\n\nexport enum FlowActorSystem_GraphNodeKind {\n  TRIGGER = 'trigger',\n  STEP = 'step',\n  FINISH = 'finish',\n  ACTOR = 'actor',\n}\n\nexport const FlowActorSystem_GraphNodeSchema = z.object({\n  /** Stable node id (an actor/trigger/step ref, or a synthesized finish id). */\n  id: z.string(),\n  nodeKind: z.enum(FlowActorSystem_GraphNodeKind),\n  label: z.string(),\n\n  // Actor-node attributes (present when nodeKind === ACTOR)\n  roleCategory: z.string().optional(),\n  executionMode: z.string().optional(),\n  agentRef: z.string().optional(),\n\n  // Flow-node attributes (present for TRIGGER / STEP nodes)\n  triggerType: z.string().optional(),\n  stepKind: z.string().optional(),\n});\nexport type FlowActorSystem_GraphNode = z.infer<typeof FlowActorSystem_GraphNodeSchema>;\n\nexport const FlowActorSystem_GraphEdgeSchema = z.object({\n  from: z.string(),\n  to: z.string(),\n});\nexport type FlowActorSystem_GraphEdge = z.infer<typeof FlowActorSystem_GraphEdgeSchema>;\n\nexport const FlowActorSystem_FrontendGraphSchema = z.object({\n  nodes: z.array(FlowActorSystem_GraphNodeSchema),\n  edges: z.array(FlowActorSystem_GraphEdgeSchema),\n});\nexport type FlowActorSystem_FrontendGraph = z.infer<typeof FlowActorSystem_FrontendGraphSchema>;\n\n/**\n * Frontend-only representation of a FlowActorSystem\n * This is what gets sent to the frontend via API\n */\nexport const FlowActorSystem_FrontendInfoSchema = z.object({\n  // Identity\n  ref: z.string(),\n  displayName: z.string(),\n  description: z.string(),\n\n  // Type & Status\n  kind: z.enum(FlowActorSystem_Kind),\n  status: z.enum(FlowActorSystem_Status),\n\n  // Categorization (for UI grouping/filtering)\n  category: z.string().optional(),\n  tags: z.array(z.string()).optional(),\n\n  // Custom metadata (can include icon ref, etc.)\n  metadata: z.record(z.string(), z.string()).optional(),\n\n  // Extracted config relevant to frontend\n  frontendRelevantConfig: FlowActorSystem_FrontendRelevantConfigSchema,\n\n  /**\n   * Renderable node/edge graph of the system (actors for ACTOR systems;\n   * triggers/steps/finishes + edges for FLOW systems). Optional: absent when a\n   * system exposes no structural graph. Lets the frontend hydrate the actor/flow\n   * visualization directly from `/frontend-info` without a second fetch.\n   */\n  graph: FlowActorSystem_FrontendGraphSchema.optional(),\n});\nexport type FlowActorSystem_FrontendInfo = z.infer<typeof FlowActorSystem_FrontendInfoSchema>;\n\n/**\n * One autonomous agent the application DECLARES (#1611), as the frontend needs it: what an organization\n * administrator binds a machine client to, and the actor system its turns converse with.\n *\n * Deliberately only the identity. The declaration's `instruction` is the agent's prompt and its schedule is\n * backend operation detail; a picker needs neither, and `/frontend-info` answers every signed-in user.\n */\nexport const FlowsActors_AutonomousAgent_FrontendInfoSchema = z.object({\n  ref: z.string(),\n  systemRef: z.string(),\n});\nexport type FlowsActors_AutonomousAgent_FrontendInfo = z.infer<typeof FlowsActors_AutonomousAgent_FrontendInfoSchema>;\n\n/**\n * API Response schema for frontend info endpoint\n */\nexport const FlowsActors_FrontendInfoResponseSchema = z.object({\n  systems: z.array(FlowActorSystem_FrontendInfoSchema),\n  /**\n   * Every autonomous agent the application declares, in declaration order. It is the closed set an\n   * organization OAuth client's `autonomousAgentRefs` may name (the backend refuses any other ref), so the\n   * binding form offers exactly these instead of free text (#1812). Empty when the application declares none.\n   */\n  autonomousAgents: z.array(FlowsActors_AutonomousAgent_FrontendInfoSchema),\n});\nexport type FlowsActors_FrontendInfoResponse = z.infer<typeof FlowsActors_FrontendInfoResponseSchema>;\n\n//===============================================================\n//  Conversation history (per-system, caller-owned)\n// --------\n// One past execution's conversational turns. The `/flows-actors/history`\n// endpoint returns the CALLER'S OWN executions for a system (USER_SELF\n// owner-filtered), most-recent last, so the view hydrates the transcript.\n//===============================================================\n\nexport const FlowsActors_ConversationExecutionSchema = z.object({\n  executionId: z.string(),\n  systemRef: z.string(),\n  createdAt: z.date(),\n  /**\n   * How the thread's latest turn stands (#1601). A thread whose last message is the person's and whose\n   * status is FAILED was interrupted — its host stopped mid-turn — and will not be answered unless the\n   * message is sent again. Without it a reloaded page could not tell that from a turn still working.\n   */\n  status: z.enum(FlowsActors_Status),\n  /**\n   * The decision a thread `awaiting_approval` is waiting on (#1601): the same announcement, and the\n   * same sentence, a page watching the turn received live when it paused. Without it a page loaded\n   * later could not show the decision, and the thread read as an unanswered message.\n   */\n  pendingApproval: WS_FlowsActorsApprovalAnnouncementDataSchema.extend({ description: z.string() }).optional(),\n  /** The turns of this execution (user prompt + assistant reply), in order. */\n  messages: z.array(FlowActorExecution_MessageSchema),\n});\nexport type FlowsActors_ConversationExecution = z.infer<typeof FlowsActors_ConversationExecutionSchema>;\n\nexport const FlowsActors_ConversationHistoryResponseSchema = z.object({\n  executions: z.array(FlowsActors_ConversationExecutionSchema),\n});\nexport type FlowsActors_ConversationHistoryResponse = z.infer<typeof FlowsActors_ConversationHistoryResponseSchema>;\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"flows-actors.io.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.io.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB;;;;;;;;;;;;;;;;GAgBG;AACH,oBAAY,uBAAuB;IACjC,IAAI,SAAS;IACb,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,yEAAyE;IACzE,KAAK,UAAU;IACf,0EAA0E;IAC1E,KAAK,UAAU;IACf,0EAA0E;IAC1E,KAAK,UAAU;CAChB;AAID,QAAA,MAAM,yBAAyB;;;;;;iBAM7B,CAAC;AAEH,eAAO,MAAM,wBAAwB,EAAE,OAAO,yBAAqD,CAAC;AACpG,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE3E,QAAA,MAAM,mCAAmC;;;;iBAIvC,CAAC;AAEH,eAAO,MAAM,kCAAkC,EAAE,OAAO,mCAAyE,CAAC;AAClI,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAE/F,QAAA,MAAM,4BAA4B;;;;;;;;;;;;;iBAgBhC,CAAC;AAEH,eAAO,MAAM,2BAA2B,EAAE,OAAO,4BAA2D,CAAC;AAC7G,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAGjF,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA0C3B,CAAC;AAEH,eAAO,MAAM,sBAAsB,EAAE,OAAO,uBAAiD,CAAC;AAC9F,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}
+{"version":3,"file":"flows-actors.io.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/flows-actors/flows-actors.io.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB;;;;;;;;;;;;;;;;GAgBG;AACH,oBAAY,uBAAuB;IACjC,IAAI,SAAS;IACb,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,yEAAyE;IACzE,KAAK,UAAU;IACf,0EAA0E;IAC1E,KAAK,UAAU;IACf,0EAA0E;IAC1E,KAAK,UAAU;CAChB;AAID,QAAA,MAAM,yBAAyB;;;;;;iBAM7B,CAAC;AAEH,eAAO,MAAM,wBAAwB,EAAE,OAAO,yBAAqD,CAAC;AACpG,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE3E,QAAA,MAAM,mCAAmC;;;;iBAIvC,CAAC;AAEH,eAAO,MAAM,kCAAkC,EAAE,OAAO,mCAAyE,CAAC;AAClI,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAE/F,QAAA,MAAM,4BAA4B;;;;;;;;;;;;;iBAgBhC,CAAC;AAEH,eAAO,MAAM,2BAA2B,EAAE,OAAO,4BAA2D,CAAC;AAC7G,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAGjF,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA0C3B,CAAC;AAEH,eAAO,MAAM,sBAAsB,EAAE,OAAO,uBAAiD,CAAC;AAC9F,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}