@wildo-ai/saas-models 1.1.4 → 1.1.6

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

@@ -1,20 +1,30 @@
 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";
-import { FlowsActors_Event_TemplateSchema } from "./flows-actors.commons.shared.schemas.js";
 //===============================================================
-// Resilience & FlowsActors_Checkpoint
+// What a flow/actor system's `config` declares.
 // --------
-// Resilience patterns for fault tolerance including circuit breakers,
-// rate limiting, and bulkheads. Prevents cascade failures and ensures
-// system stability under high load or partial failures.
-// --------
-// FlowsActors_Checkpoint system for durable execution enabling workflows to
-// survive failures and resume from last known good state. Supports
-// various storage backends and checkpointing strategies.
+// 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
+//   `circuitBreaker: { enabled: true }` got nothing, silently.
+// - `executionRestrictions` (`maxConcurrentExecutions`, `maxExecutionDuration`, `budgetLimits`) —
+//   enforced nowhere, and WORSE than silent: `budgetLimits.maxCost` lit a "Budget limits apply"
+//   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.
 //===============================================================
 //===============================================================
 //  Access Control
@@ -25,51 +35,15 @@ 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
 //===============================================================
-export const FlowsActors_CircuitBreaker_Configuration_Schema = z.object({
-    enabled: z.boolean(),
-    failureThreshold: z.number(),
-    timeout: z.number(), // time in open state before half-open
-    halfOpenRequests: z.number(),
-    errorFilter: z.array(z.string()).optional(), // which errors trigger circuit
-    onOpen: FlowsActors_Event_TemplateSchema.optional(), // emit event when circuit opens
-    onClose: FlowsActors_Event_TemplateSchema.optional(), // emit event when circuit closes
-    onHalfOpen: FlowsActors_Event_TemplateSchema.optional(), // emit event when circuit goes half-open
-});
-export const FlowsActors_RateLimit_Configuration_Schema = z.object({
-    enabled: z.boolean(),
-    requestsPerSecond: z.number(),
-    burstSize: z.number(),
-    strategy: z.enum(["token_bucket", "sliding_window", "fixed_window"]),
-    keyExtractor: z.string().optional(), // JSONPath to extract rate limit key from context
-    onLimit: FlowsActors_Event_TemplateSchema.optional(), // emit event when rate limited
-});
-export const FlowsActors_Bulkhead_Configuration_Schema = z.object({
-    enabled: z.boolean(),
-    maxConcurrent: z.number(),
-    maxQueued: z.number(),
-    queueTimeout: z.number().optional(),
-    onReject: FlowsActors_Event_TemplateSchema.optional(), // emit event when request rejected
-});
-export const FlowsActors_Resilience_Configuration_Schema = z.object({
-    circuitBreaker: FlowsActors_CircuitBreaker_Configuration_Schema.optional(),
-    rateLimit: FlowsActors_RateLimit_Configuration_Schema.optional(),
-    bulkhead: FlowsActors_Bulkhead_Configuration_Schema.optional(),
-});
-export const FlowActorSystem_ExecutionRestrictionsSchema = z.object({
-    maxConcurrentExecutions: z.number().positive().default(10),
-    maxExecutionDuration: z.number().positive(), // milliseconds
-    budgetLimits: z.object({
-        maxTokens: z.number().positive().optional(),
-        maxCost: z.number().positive().optional(),
-        costPerExecution: z.number().positive().optional(),
-    }).optional(),
-});
 export const FlowsActors_LeafElements_Configuration_Schema = z.object({
     timeout: z.number().optional(),
     accessControl: z.array(FlowsActors_AccessControlSchema),
@@ -79,10 +53,7 @@ export const FlowsActors_Configuration_Schema = z.object({
     timeout: z.number().optional(),
     accessControl: z.array(FlowsActors_AccessControlSchema),
     riskLevel: z.enum(ResourceOperationRiskLevel),
-    resilience: FlowsActors_Resilience_Configuration_Schema.optional(),
     dataClassification: z.enum(Compliance_DataClassification).optional(),
     redactionRules: z.array(RedationRulesSchema).optional(),
-    retentionPolicy: DataRetentionPolicySchema.optional(),
-    executionRestrictions: FlowActorSystem_ExecutionRestrictionsSchema.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":"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","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\";\nimport { FlowsActors_Event_TemplateSchema } from \"./flows-actors.commons.shared.schemas\";\n\n\n//===============================================================\n// Resilience & FlowsActors_Checkpoint\n// --------\n// Resilience patterns for fault tolerance including circuit breakers,\n// rate limiting, and bulkheads. Prevents cascade failures and ensures\n// system stability under high load or partial failures.\n// --------\n// FlowsActors_Checkpoint system for durable execution enabling workflows to\n// survive failures and resume from last known good state. Supports\n// various storage backends and checkpointing strategies.\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_CircuitBreaker_Configuration_Schema = z.object({\n  enabled: z.boolean(),\n  failureThreshold: z.number(),\n  timeout: z.number(), // time in open state before half-open\n  halfOpenRequests: z.number(),\n  errorFilter: z.array(z.string()).optional(), // which errors trigger circuit\n  onOpen: FlowsActors_Event_TemplateSchema.optional(), // emit event when circuit opens\n  onClose: FlowsActors_Event_TemplateSchema.optional(), // emit event when circuit closes\n  onHalfOpen: FlowsActors_Event_TemplateSchema.optional(), // emit event when circuit goes half-open\n});\nexport type FlowsActors_CircuitBreaker_Configuration = z.infer<typeof FlowsActors_CircuitBreaker_Configuration_Schema>;\n\nexport const FlowsActors_RateLimit_Configuration_Schema = z.object({\n  enabled: z.boolean(),\n  requestsPerSecond: z.number(),\n  burstSize: z.number(),\n  strategy: z.enum([\"token_bucket\", \"sliding_window\", \"fixed_window\"]),\n  keyExtractor: z.string().optional(), // JSONPath to extract rate limit key from context\n  onLimit: FlowsActors_Event_TemplateSchema.optional(), // emit event when rate limited\n});\nexport type FlowsActors_RateLimit_Configuration = z.infer<typeof FlowsActors_RateLimit_Configuration_Schema>;\n\nexport const FlowsActors_Bulkhead_Configuration_Schema = z.object({\n  enabled: z.boolean(),\n  maxConcurrent: z.number(),\n  maxQueued: z.number(),\n  queueTimeout: z.number().optional(),\n  onReject: FlowsActors_Event_TemplateSchema.optional(), // emit event when request rejected\n});\nexport type FlowsActors_Bulkhead_Configuration = z.infer<typeof FlowsActors_Bulkhead_Configuration_Schema>;\n\nexport const FlowsActors_Resilience_Configuration_Schema = z.object({\n  circuitBreaker: FlowsActors_CircuitBreaker_Configuration_Schema.optional(),\n  rateLimit: FlowsActors_RateLimit_Configuration_Schema.optional(),\n  bulkhead: FlowsActors_Bulkhead_Configuration_Schema.optional(),\n});\nexport type FlowsActors_Resilience_Configuration = z.infer<typeof FlowsActors_Resilience_Configuration_Schema>;\n\nexport const FlowActorSystem_ExecutionRestrictionsSchema = z.object({\n  maxConcurrentExecutions: z.number().positive().default(10),\n  maxExecutionDuration: z.number().positive(), // milliseconds\n  budgetLimits: z.object({\n    maxTokens: z.number().positive().optional(),\n    maxCost: z.number().positive().optional(),\n    costPerExecution: z.number().positive().optional(),\n  }).optional(),\n});\nexport type FlowActorSystem_ExecutionRestrictions = z.infer<typeof FlowActorSystem_ExecutionRestrictionsSchema>;\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  resilience            : FlowsActors_Resilience_Configuration_Schema.optional(),\n  dataClassification    : z.enum(Compliance_DataClassification).optional(),\n  redactionRules        : z.array(RedationRulesSchema).optional(),\n  retentionPolicy       : DataRetentionPolicySchema.optional(),\n  executionRestrictions : FlowActorSystem_ExecutionRestrictionsSchema.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,10 +8,7 @@ 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>;
-    hasBudgetLimits: z.ZodBoolean;
 }, z.core.$strip>;
 export type FlowActorSystem_FrontendRelevantConfig = z.infer<typeof FlowActorSystem_FrontendRelevantConfigSchema>;
 export declare enum FlowActorSystem_GraphNodeKind {
@@ -67,10 +65,7 @@ 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>;
-        hasBudgetLimits: z.ZodBoolean;
     }, z.core.$strip>;
     graph: z.ZodOptional<z.ZodObject<{
         nodes: z.ZodArray<z.ZodObject<{
@@ -90,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
  */
@@ -105,10 +112,7 @@ 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>;
-            hasBudgetLimits: z.ZodBoolean;
         }, z.core.$strip>;
         graph: z.ZodOptional<z.ZodObject<{
             nodes: z.ZodArray<z.ZodObject<{
@@ -127,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>;
@@ -148,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;;;;;;iBAevD,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,14 +18,9 @@ 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? */
-    hasBudgetLimits: z.boolean(),
 });
 //===============================================================
 //  Frontend graph (kind-agnostic node/edge projection)
@@ -90,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)
@@ -107,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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gCAAgC,EAAE,MAAM,yCAAyC,CAAC;AAC3F,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AACzG,OAAO,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAC;AAE9E,iEAAiE;AACjE,oCAAoC;AACpC,WAAW;AACX,2EAA2E;AAC3E,mEAAmE;AACnE,0DAA0D;AAC1D,iEAAiE;AAIjE;;;GAGG;AACH,MAAM,CAAC,MAAM,4CAA4C,GAAG,CAAC,CAAC,MAAM,CAAC;IACnE,yEAAyE;IACzE,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;IAE1C,8DAA8D;IAC9D,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE;IAE7B,+EAA+E;IAC/E,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;IAE9C,2BAA2B;IAC3B,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC;IAE7C,iEAAiE;IACjE,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE;CAC7B,CAAC,CAAC;AAGH,iEAAiE;AACjE,uDAAuD;AACvD,WAAW;AACX,iFAAiF;AACjF,+EAA+E;AAC/E,6EAA6E;AAC7E,+EAA+E;AAC/E,yEAAyE;AACzE,iEAAiE;AAEjE,MAAM,CAAN,IAAY,6BAKX;AALD,WAAY,6BAA6B;IACvC,oDAAmB,CAAA;IACnB,8CAAa,CAAA;IACb,kDAAiB,CAAA;IACjB,gDAAe,CAAA;AACjB,CAAC,EALW,6BAA6B,KAA7B,6BAA6B,QAKxC;AAED,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,8EAA8E;IAC9E,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IAEjB,0DAA0D;IAC1D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE/B,0DAA0D;IAC1D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;CACf,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1D,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,+BAA+B,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,+BAA+B,CAAC;CAChD,CAAC,CAAC;AAGH;;;GAGG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CAAC;IACzD,WAAW;IACX,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IAEvB,gBAAgB;IAChB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC;IAEtC,6CAA6C;IAC7C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAEpC,+CAA+C;IAC/C,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAErD,wCAAwC;IACxC,sBAAsB,EAAE,4CAA4C;IAEpE;;;;;OAKG;IACH,KAAK,EAAE,mCAAmC,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AAGH;;GAEG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7D,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,kCAAkC,CAAC;CACrD,CAAC,CAAC;AAGH,iEAAiE;AACjE,mDAAmD;AACnD,WAAW;AACX,yEAAyE;AACzE,uEAAuE;AACvE,0EAA0E;AAC1E,iEAAiE;AAEjE,MAAM,CAAC,MAAM,uCAAuC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE;IACnB,6EAA6E;IAC7E,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,gCAAgC,CAAC;CACpD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,6CAA6C,GAAG,CAAC,CAAC,MAAM,CAAC;IACpE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,uCAAuC,CAAC;CAC7D,CAAC,CAAC","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  hasBudgetLimits: z.boolean(),\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"}

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

@@ -47,67 +47,67 @@ const _ArtifactDefinitionSchema = z.object({
 });
 export const ArtifactDefinitionSchema = _ArtifactDefinitionSchema;
 const _ArtifactInstance_ContentBaseSchema = z.object({
-    mimeType: z.string().optional(),
-    size: z.number().optional(),
-    checksum: z.string().optional(),
+    mimeType: z.string().optional().describe("The content's media type, such as `text/plain` or `image/png`."),
+    size: z.number().optional().describe("The content's size in bytes."),
+    checksum: z.string().optional().describe("A checksum of the content, for detecting a changed or corrupted copy."),
 });
 export const ArtifactInstance_ContentBaseSchema = _ArtifactInstance_ContentBaseSchema;
 const _ArtifactInstance_BaseSchema = z.object({
-    ref: z.string(),
-    definitionRef: z.string().optional(),
-    type: z.enum(FlowsActors_IO_PartKind),
-    name: z.string(),
-    description: z.string().optional(),
+    ref: z.string().describe("The artifact's own identifier. Stable: it does not change when the task's artifact list is reordered."),
+    definitionRef: z.string().optional().describe("The declared artifact definition this artifact fulfils, when it was produced against one."),
+    type: z.enum(FlowsActors_IO_PartKind).describe("What kind of content the artifact holds; it decides the shape of `content`."),
+    name: z.string().describe("A human-readable name for the artifact."),
+    description: z.string().optional().describe("What the artifact contains, in words."),
     origin: z.object({
-        taskId: z.string().optional(),
-        stepId: z.string().optional(),
-    }),
+        taskId: z.string().optional().describe("The task that produced the artifact."),
+        stepId: z.string().optional().describe("The step of that task that produced it."),
+    }).describe("Where the artifact came from."),
     content: z.any(),
-    createdAt: z.string(),
-    metadata: z.record(z.string(), z.unknown()).optional(),
+    createdAt: z.string().describe("When the artifact was created (ISO 8601)."),
+    metadata: z.record(z.string(), z.unknown()).optional().describe("Additional details the producing step recorded about the artifact."),
 });
 export const ArtifactInstance_BaseSchema = _ArtifactInstance_BaseSchema;
 const _ArtifactInstanceSchema = z.discriminatedUnion("type", [
     _ArtifactInstance_BaseSchema.extend({
-        type: z.literal(FlowsActors_IO_PartKind.TEXT),
+        type: z.literal(FlowsActors_IO_PartKind.TEXT).describe("What kind of content the artifact holds; it decides the shape of `content`."),
         content: _ArtifactInstance_ContentBaseSchema.extend({
-            text: z.string()
-        })
+            text: z.string().describe("The text.")
+        }).describe("The artifact's content. Its shape depends on `type`.")
     }),
     _ArtifactInstance_BaseSchema.extend({
-        type: z.literal(FlowsActors_IO_PartKind.FILE),
+        type: z.literal(FlowsActors_IO_PartKind.FILE).describe("What kind of content the artifact holds; it decides the shape of `content`."),
         content: _ArtifactInstance_ContentBaseSchema.extend({
-            storage: z.object({ data: z.string().optional(), url: z.string().optional(), path: z.string().optional() })
-        })
+            storage: z.object({ data: z.string().optional().describe("The content itself, carried inline."), url: z.string().optional().describe("A URL the content can be fetched from."), path: z.string().optional().describe("Where the content is stored.") }).describe("Where the content is: inline, at a URL, or at a storage path.")
+        }).describe("The artifact's content. Its shape depends on `type`.")
     }),
     _ArtifactInstance_BaseSchema.extend({
-        type: z.literal(FlowsActors_IO_PartKind.RAW_DATA),
+        type: z.literal(FlowsActors_IO_PartKind.RAW_DATA).describe("What kind of content the artifact holds; it decides the shape of `content`."),
         content: _ArtifactInstance_ContentBaseSchema.extend({
             // Artifact instances are durable/client-visible values, so they carry only
             // the produced data. The executable Zod contract that validated the value
             // remains in the runtime invocation contract, identified there by schema
             // ref + digest; embedding a Zod instance here would neither serialize nor
             // have an OpenAPI representation.
-            data: z.any(),
-        })
+            data: z.any().describe("The data the step produced."),
+        }).describe("The artifact's content. Its shape depends on `type`.")
     }),
     _ArtifactInstance_BaseSchema.extend({
-        type: z.literal(FlowsActors_IO_PartKind.STRUCTURED),
+        type: z.literal(FlowsActors_IO_PartKind.STRUCTURED).describe("What kind of content the artifact holds; it decides the shape of `content`."),
         content: _ArtifactInstance_ContentBaseSchema.extend({
             // Keep this branch symmetrical with RAW_DATA: validation authority is a
             // runtime contract, while the persisted artifact is the validated value.
-            data: z.any(),
-        })
+            data: z.any().describe("The structured value the step produced, already validated against its contract."),
+        }).describe("The artifact's content. Its shape depends on `type`.")
     }),
     _ArtifactInstance_BaseSchema.extend({
-        type: z.literal(FlowsActors_IO_PartKind.IMAGE),
+        type: z.literal(FlowsActors_IO_PartKind.IMAGE).describe("What kind of content the artifact holds; it decides the shape of `content`."),
         content: _ArtifactInstance_ContentBaseSchema.extend({
             // Same storage triad as FILE — a generated image is a file whose
             // modality carries pixel dimensions worth surfacing without fetching.
-            storage: z.object({ data: z.string().optional(), url: z.string().optional(), path: z.string().optional() }),
-            width: z.number().int().positive().optional(),
-            height: z.number().int().positive().optional(),
-        })
+            storage: z.object({ data: z.string().optional().describe("The content itself, carried inline."), url: z.string().optional().describe("A URL the content can be fetched from."), path: z.string().optional().describe("Where the content is stored.") }).describe("Where the content is: inline, at a URL, or at a storage path."),
+            width: z.number().int().positive().optional().describe("The image's width in pixels."),
+            height: z.number().int().positive().optional().describe("The image's height in pixels."),
+        }).describe("The artifact's content. Its shape depends on `type`.")
     }),
 ]);
 export const ArtifactInstanceSchema = _ArtifactInstanceSchema;

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

@@ -1 +1 @@
-{"version":3,"file":"flows-actors.io.shared.schemas.js","sourceRoot":"","sources":["../../../src/flows-actors/flows-actors.io.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\n\n\n//===============================================================\n//  Artifact\n// --------\n// Artifacts are outputs generated by steps during task execution,\n// including text, files, structured data, and binary content.\n// They provide persistent storage for intermediate and final results,\n// enabling data flow between steps, audit trails, and retrieval\n// of generated content across workflow executions.\n//===============================================================\n\n/**\n * The artifact MODALITY axis: the single vocabulary the actor-agent system\n * uses to DESCRIBE what an operation consumes and produces.\n *\n * It is descriptive, not a dispatch key. Which provider protocol an agent\n * reaches is decided by the arm of its `config` discriminated union (an image\n * configuration routes to `IMAGE_PROVIDER`, a coding-agent configuration to\n * `AGENT_CLIENT_PROTOCOL`, anything else to the `LLM_PROVIDER` path). An\n * agent's `outputModality` is not read on that path.\n *\n * IMAGE is wired (gpt-image logo generation). AUDIO and VIDEO are RESERVED and\n * no provider serves either. Nothing refuses them by modality: the\n * configuration union simply has no audio or video arm, so an agent that would\n * produce one cannot be declared. Adding such an arm therefore means adding the\n * `AUDIO_PROVIDER` / `VIDEO_PROVIDER` transport in the same change, or the new\n * arm reaches the LLM path and is answered by the wrong protocol.\n */\nexport enum FlowsActors_IO_PartKind {\n  TEXT = \"text\",\n  FILE = \"file\",\n  RAW_DATA = \"raw_data\",\n  STRUCTURED = \"structured\",\n  /** Generated image bytes (text-to-image). Wired via `IMAGE_PROVIDER`. */\n  IMAGE = \"image\",\n  /** RESERVED — generated audio. No transport yet; executor fail-closes. */\n  AUDIO = \"audio\",\n  /** RESERVED — generated video. No transport yet; executor fail-closes. */\n  VIDEO = \"video\",\n}\n\n\n\nconst _ArtifactDefinitionSchema = z.object({\n  type: z.enum(FlowsActors_IO_PartKind),\n  ref: z.string(),\n  displayName: z.string(),\n  description: z.string().optional(),\n  specs: z.any()\n});\n\nexport const ArtifactDefinitionSchema: typeof _ArtifactDefinitionSchema = _ArtifactDefinitionSchema;\nexport type ArtifactDefinition = z.infer<typeof _ArtifactDefinitionSchema>;\n\nconst _ArtifactInstance_ContentBaseSchema = z.object({\n  mimeType: z.string().optional(),\n  size: z.number().optional(),\n  checksum: z.string().optional(),\n});\n\nexport const ArtifactInstance_ContentBaseSchema: typeof _ArtifactInstance_ContentBaseSchema = _ArtifactInstance_ContentBaseSchema;\nexport type ArtifactInstance_ContentBase = z.infer<typeof _ArtifactInstance_ContentBaseSchema>;\n\nconst _ArtifactInstance_BaseSchema = z.object({\n  ref: z.string(),\n  definitionRef: z.string().optional(),\n  type: z.enum(FlowsActors_IO_PartKind),\n  name: z.string(),\n  description: z.string().optional(),\n  origin : z.object({\n    taskId: z.string().optional(),\n    stepId: z.string().optional(),\n  }),\n  \n \n  content: z.any(),\n  \n  createdAt: z.string(),\n  metadata: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport const ArtifactInstance_BaseSchema: typeof _ArtifactInstance_BaseSchema = _ArtifactInstance_BaseSchema;\nexport type ArtifactInstance_Base = z.infer<typeof _ArtifactInstance_BaseSchema>;\n\n\nconst _ArtifactInstanceSchema = z.discriminatedUnion(\"type\", [\n  _ArtifactInstance_BaseSchema.extend({ \n    type: z.literal(FlowsActors_IO_PartKind.TEXT), \n    content: _ArtifactInstance_ContentBaseSchema.extend({ \n      text: z.string() \n    }) \n  }),\n  _ArtifactInstance_BaseSchema.extend({ \n    type: z.literal(FlowsActors_IO_PartKind.FILE), \n    content: _ArtifactInstance_ContentBaseSchema.extend({ \n      storage: z.object({ data: z.string().optional(), url: z.string().optional(), path: z.string().optional() }) \n    }) \n  }),\n  _ArtifactInstance_BaseSchema.extend({ \n    type: z.literal(FlowsActors_IO_PartKind.RAW_DATA), \n    content: _ArtifactInstance_ContentBaseSchema.extend({ \n      // Artifact instances are durable/client-visible values, so they carry only\n      // the produced data. The executable Zod contract that validated the value\n      // remains in the runtime invocation contract, identified there by schema\n      // ref + digest; embedding a Zod instance here would neither serialize nor\n      // have an OpenAPI representation.\n      data: z.any(),\n    }) \n  }),\n  _ArtifactInstance_BaseSchema.extend({\n    type: z.literal(FlowsActors_IO_PartKind.STRUCTURED),\n    content: _ArtifactInstance_ContentBaseSchema.extend({\n      // Keep this branch symmetrical with RAW_DATA: validation authority is a\n      // runtime contract, while the persisted artifact is the validated value.\n      data: z.any(),\n    })\n  }),\n  _ArtifactInstance_BaseSchema.extend({\n    type: z.literal(FlowsActors_IO_PartKind.IMAGE),\n    content: _ArtifactInstance_ContentBaseSchema.extend({\n      // Same storage triad as FILE — a generated image is a file whose\n      // modality carries pixel dimensions worth surfacing without fetching.\n      storage: z.object({ data: z.string().optional(), url: z.string().optional(), path: z.string().optional() }),\n      width: z.number().int().positive().optional(),\n      height: z.number().int().positive().optional(),\n    })\n  }),\n]);\n\nexport const ArtifactInstanceSchema: typeof _ArtifactInstanceSchema = _ArtifactInstanceSchema;\nexport type ArtifactInstance = z.infer<typeof _ArtifactInstanceSchema>;\n"]}
+{"version":3,"file":"flows-actors.io.shared.schemas.js","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.io.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\n\n\n//===============================================================\n//  Artifact\n// --------\n// Artifacts are outputs generated by steps during task execution,\n// including text, files, structured data, and binary content.\n// They provide persistent storage for intermediate and final results,\n// enabling data flow between steps, audit trails, and retrieval\n// of generated content across workflow executions.\n//===============================================================\n\n/**\n * The artifact MODALITY axis: the single vocabulary the actor-agent system\n * uses to DESCRIBE what an operation consumes and produces.\n *\n * It is descriptive, not a dispatch key. Which provider protocol an agent\n * reaches is decided by the arm of its `config` discriminated union (an image\n * configuration routes to `IMAGE_PROVIDER`, a coding-agent configuration to\n * `AGENT_CLIENT_PROTOCOL`, anything else to the `LLM_PROVIDER` path). An\n * agent's `outputModality` is not read on that path.\n *\n * IMAGE is wired (gpt-image logo generation). AUDIO and VIDEO are RESERVED and\n * no provider serves either. Nothing refuses them by modality: the\n * configuration union simply has no audio or video arm, so an agent that would\n * produce one cannot be declared. Adding such an arm therefore means adding the\n * `AUDIO_PROVIDER` / `VIDEO_PROVIDER` transport in the same change, or the new\n * arm reaches the LLM path and is answered by the wrong protocol.\n */\nexport enum FlowsActors_IO_PartKind {\n  TEXT = \"text\",\n  FILE = \"file\",\n  RAW_DATA = \"raw_data\",\n  STRUCTURED = \"structured\",\n  /** Generated image bytes (text-to-image). Wired via `IMAGE_PROVIDER`. */\n  IMAGE = \"image\",\n  /** RESERVED — generated audio. No transport yet; executor fail-closes. */\n  AUDIO = \"audio\",\n  /** RESERVED — generated video. No transport yet; executor fail-closes. */\n  VIDEO = \"video\",\n}\n\n\n\nconst _ArtifactDefinitionSchema = z.object({\n  type: z.enum(FlowsActors_IO_PartKind),\n  ref: z.string(),\n  displayName: z.string(),\n  description: z.string().optional(),\n  specs: z.any()\n});\n\nexport const ArtifactDefinitionSchema: typeof _ArtifactDefinitionSchema = _ArtifactDefinitionSchema;\nexport type ArtifactDefinition = z.infer<typeof _ArtifactDefinitionSchema>;\n\nconst _ArtifactInstance_ContentBaseSchema = z.object({\n  mimeType: z.string().optional().describe(\"The content's media type, such as `text/plain` or `image/png`.\"),\n  size: z.number().optional().describe(\"The content's size in bytes.\"),\n  checksum: z.string().optional().describe(\"A checksum of the content, for detecting a changed or corrupted copy.\"),\n});\n\nexport const ArtifactInstance_ContentBaseSchema: typeof _ArtifactInstance_ContentBaseSchema = _ArtifactInstance_ContentBaseSchema;\nexport type ArtifactInstance_ContentBase = z.infer<typeof _ArtifactInstance_ContentBaseSchema>;\n\nconst _ArtifactInstance_BaseSchema = z.object({\n  ref: z.string().describe(\"The artifact's own identifier. Stable: it does not change when the task's artifact list is reordered.\"),\n  definitionRef: z.string().optional().describe(\"The declared artifact definition this artifact fulfils, when it was produced against one.\"),\n  type: z.enum(FlowsActors_IO_PartKind).describe(\"What kind of content the artifact holds; it decides the shape of `content`.\"),\n  name: z.string().describe(\"A human-readable name for the artifact.\"),\n  description: z.string().optional().describe(\"What the artifact contains, in words.\"),\n  origin : z.object({\n    taskId: z.string().optional().describe(\"The task that produced the artifact.\"),\n    stepId: z.string().optional().describe(\"The step of that task that produced it.\"),\n  }).describe(\"Where the artifact came from.\"),\n  \n \n  content: z.any(),\n  \n  createdAt: z.string().describe(\"When the artifact was created (ISO 8601).\"),\n  metadata: z.record(z.string(), z.unknown()).optional().describe(\"Additional details the producing step recorded about the artifact.\"),\n});\n\nexport const ArtifactInstance_BaseSchema: typeof _ArtifactInstance_BaseSchema = _ArtifactInstance_BaseSchema;\nexport type ArtifactInstance_Base = z.infer<typeof _ArtifactInstance_BaseSchema>;\n\n\nconst _ArtifactInstanceSchema = z.discriminatedUnion(\"type\", [\n  _ArtifactInstance_BaseSchema.extend({ \n    type: z.literal(FlowsActors_IO_PartKind.TEXT).describe(\"What kind of content the artifact holds; it decides the shape of `content`.\"), \n    content: _ArtifactInstance_ContentBaseSchema.extend({ \n      text: z.string().describe(\"The text.\")\n    }).describe(\"The artifact's content. Its shape depends on `type`.\")\n  }),\n  _ArtifactInstance_BaseSchema.extend({ \n    type: z.literal(FlowsActors_IO_PartKind.FILE).describe(\"What kind of content the artifact holds; it decides the shape of `content`.\"), \n    content: _ArtifactInstance_ContentBaseSchema.extend({ \n      storage: z.object({ data: z.string().optional().describe(\"The content itself, carried inline.\"), url: z.string().optional().describe(\"A URL the content can be fetched from.\"), path: z.string().optional().describe(\"Where the content is stored.\") }).describe(\"Where the content is: inline, at a URL, or at a storage path.\")\n    }).describe(\"The artifact's content. Its shape depends on `type`.\")\n  }),\n  _ArtifactInstance_BaseSchema.extend({ \n    type: z.literal(FlowsActors_IO_PartKind.RAW_DATA).describe(\"What kind of content the artifact holds; it decides the shape of `content`.\"), \n    content: _ArtifactInstance_ContentBaseSchema.extend({ \n      // Artifact instances are durable/client-visible values, so they carry only\n      // the produced data. The executable Zod contract that validated the value\n      // remains in the runtime invocation contract, identified there by schema\n      // ref + digest; embedding a Zod instance here would neither serialize nor\n      // have an OpenAPI representation.\n      data: z.any().describe(\"The data the step produced.\"),\n    }).describe(\"The artifact's content. Its shape depends on `type`.\")\n  }),\n  _ArtifactInstance_BaseSchema.extend({\n    type: z.literal(FlowsActors_IO_PartKind.STRUCTURED).describe(\"What kind of content the artifact holds; it decides the shape of `content`.\"),\n    content: _ArtifactInstance_ContentBaseSchema.extend({\n      // Keep this branch symmetrical with RAW_DATA: validation authority is a\n      // runtime contract, while the persisted artifact is the validated value.\n      data: z.any().describe(\"The structured value the step produced, already validated against its contract.\"),\n    }).describe(\"The artifact's content. Its shape depends on `type`.\")\n  }),\n  _ArtifactInstance_BaseSchema.extend({\n    type: z.literal(FlowsActors_IO_PartKind.IMAGE).describe(\"What kind of content the artifact holds; it decides the shape of `content`.\"),\n    content: _ArtifactInstance_ContentBaseSchema.extend({\n      // Same storage triad as FILE — a generated image is a file whose\n      // modality carries pixel dimensions worth surfacing without fetching.\n      storage: z.object({ data: z.string().optional().describe(\"The content itself, carried inline.\"), url: z.string().optional().describe(\"A URL the content can be fetched from.\"), path: z.string().optional().describe(\"Where the content is stored.\") }).describe(\"Where the content is: inline, at a URL, or at a storage path.\"),\n      width: z.number().int().positive().optional().describe(\"The image's width in pixels.\"),\n      height: z.number().int().positive().optional().describe(\"The image's height in pixels.\"),\n    }).describe(\"The artifact's content. Its shape depends on `type`.\")\n  }),\n]);\n\nexport const ArtifactInstanceSchema: typeof _ArtifactInstanceSchema = _ArtifactInstanceSchema;\nexport type ArtifactInstance = z.infer<typeof _ArtifactInstanceSchema>;\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"flows-actors.system.shared.definitions.d.ts","sourceRoot":"","sources":["../../../src/flows-actors/flows-actors.system.shared.definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAgBzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,UAAU,CAAC"}
+{"version":3,"file":"flows-actors.system.shared.definitions.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.system.shared.definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAgBzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,UAAU,CAAC"}