npm - @wildo-ai/saas-models - Versions diffs - 1.1.2 → 1.1.3 - Mend

@wildo-ai/saas-models 1.1.2 → 1.1.3

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

Files changed (410) hide show

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

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

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

@@ -1,15 +1,20 @@
 import { z } from "zod";
 /**
- * The artifact MODALITY axis — the single vocabulary the actor-agent system
- * uses to describe what an operation consumes and produces. An agent's
- * `operationDefinition.outputModality` names its produced modality; the
- * executor resolves that modality to a provider protocol (TEXT/STRUCTURED →
- * `LLM_PROVIDER`, IMAGE → `IMAGE_PROVIDER`, CODING → `AGENT_CLIENT_PROTOCOL`, …).
+ * The artifact MODALITY axis: the single vocabulary the actor-agent system
+ * uses to DESCRIBE what an operation consumes and produces.
  *
- * IMAGE is wired (gpt-image logo generation). AUDIO and VIDEO are RESERVED —
- * the modality is declarable but no provider serves it and the executor
- * fail-closes (NOT_IMPLEMENTED) until an `AUDIO_PROVIDER` / `VIDEO_PROVIDER`
- * transport lands.
+ * It is descriptive, not a dispatch key. Which provider protocol an agent
+ * reaches is decided by the arm of its `config` discriminated union (an image
+ * configuration routes to `IMAGE_PROVIDER`, a coding-agent configuration to
+ * `AGENT_CLIENT_PROTOCOL`, anything else to the `LLM_PROVIDER` path). An
+ * agent's `outputModality` is not read on that path.
+ *
+ * IMAGE is wired (gpt-image logo generation). AUDIO and VIDEO are RESERVED and
+ * no provider serves either. Nothing refuses them by modality: the
+ * configuration union simply has no audio or video arm, so an agent that would
+ * produce one cannot be declared. Adding such an arm therefore means adding the
+ * `AUDIO_PROVIDER` / `VIDEO_PROVIDER` transport in the same change, or the new
+ * arm reaches the LLM path and is answered by the wrong protocol.
  */
 export declare enum FlowsActors_IO_PartKind {
     TEXT = "text",

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

	@@ -1 +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~~;;;;;;;;;;;GAWG~~;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"}
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"}

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

@@ -9,16 +9,21 @@ import { z } from "zod";
 // of generated content across workflow executions.
 //===============================================================
 /**
- * The artifact MODALITY axis — the single vocabulary the actor-agent system
- * uses to describe what an operation consumes and produces. An agent's
- * `operationDefinition.outputModality` names its produced modality; the
- * executor resolves that modality to a provider protocol (TEXT/STRUCTURED →
- * `LLM_PROVIDER`, IMAGE → `IMAGE_PROVIDER`, CODING → `AGENT_CLIENT_PROTOCOL`, …).
+ * The artifact MODALITY axis: the single vocabulary the actor-agent system
+ * uses to DESCRIBE what an operation consumes and produces.
  *
- * IMAGE is wired (gpt-image logo generation). AUDIO and VIDEO are RESERVED —
- * the modality is declarable but no provider serves it and the executor
- * fail-closes (NOT_IMPLEMENTED) until an `AUDIO_PROVIDER` / `VIDEO_PROVIDER`
- * transport lands.
+ * It is descriptive, not a dispatch key. Which provider protocol an agent
+ * reaches is decided by the arm of its `config` discriminated union (an image
+ * configuration routes to `IMAGE_PROVIDER`, a coding-agent configuration to
+ * `AGENT_CLIENT_PROTOCOL`, anything else to the `LLM_PROVIDER` path). An
+ * agent's `outputModality` is not read on that path.
+ *
+ * IMAGE is wired (gpt-image logo generation). AUDIO and VIDEO are RESERVED and
+ * no provider serves either. Nothing refuses them by modality: the
+ * configuration union simply has no audio or video arm, so an agent that would
+ * produce one cannot be declared. Adding such an arm therefore means adding the
+ * `AUDIO_PROVIDER` / `VIDEO_PROVIDER` transport in the same change, or the new
+ * arm reaches the LLM path and is answered by the wrong protocol.
  */
 export var FlowsActors_IO_PartKind;
 (function (FlowsActors_IO_PartKind) {

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

	@@ -1 +1 @@
1	- {"version":3,"file":"flows-actors.io.shared.schemas.js","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.io.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,iEAAiE;AACjE,YAAY;AACZ,WAAW;AACX,kEAAkE;AAClE,8DAA8D;AAC9D,sEAAsE;AACtE,gEAAgE;AAChE,mDAAmD;AACnD,iEAAiE;AAEjE~~;;;;;;;;;;;GAWG~~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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. ~~An agent's\~~n * ~~`operationDefinition~~.~~outputModality`~~ ~~names~~ ~~its~~ ~~produced~~ ~~modality;~~ ~~the~~\n * ~~executor~~ ~~resolves~~ ~~that~~ ~~modality~~ to a ~~provider~~ ~~protocol~~ (~~TEXT/STRUCTURED~~ →\n * ~~`LLM_PROVIDER`,~~ ~~IMAGE~~ → `IMAGE_PROVIDER`, ~~CODING~~ → `AGENT_CLIENT_PROTOCOL`, …).\n \n IMAGE is wired (gpt-image logo generation). AUDIO and VIDEO are RESERVED —\n * ~~the~~ modality is ~~declarable~~ ~~but~~ no ~~provider~~ ~~serves~~ it ~~and~~ ~~the~~ ~~executor~~\n * ~~fail-closes~~ ~~(NOT_IMPLEMENTED)~~ ~~until~~ an `AUDIO_PROVIDER` / `VIDEO_PROVIDER`\n * ~~transport~~ ~~lands~~.\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"]}
1	+ {"version":3,"file":"flows-actors.io.shared.schemas.js","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.io.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,iEAAiE;AACjE,YAAY;AACZ,WAAW;AACX,kEAAkE;AAClE,8DAA8D;AAC9D,sEAAsE;AACtE,gEAAgE;AAChE,mDAAmD;AACnD,iEAAiE;AAEjE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAN,IAAY,uBAWX;AAXD,WAAY,uBAAuB;IACjC,wCAAa,CAAA;IACb,wCAAa,CAAA;IACb,gDAAqB,CAAA;IACrB,oDAAyB,CAAA;IACzB,yEAAyE;IACzE,0CAAe,CAAA;IACf,0EAA0E;IAC1E,0CAAe,CAAA;IACf,0EAA0E;IAC1E,0CAAe,CAAA;AACjB,CAAC,EAXW,uBAAuB,KAAvB,uBAAuB,QAWlC;AAID,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC;IACrC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE;CACf,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAqC,yBAAyB,CAAC;AAGpG,MAAM,mCAAmC,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kCAAkC,GAA+C,mCAAmC,CAAC;AAGlI,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAG,CAAC,CAAC,MAAM,CAAC;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC9B,CAAC;IAGF,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE;IAEhB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACvD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAwC,4BAA4B,CAAC;AAI7G,MAAM,uBAAuB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC3D,4BAA4B,CAAC,MAAM,CAAC;QAClC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,IAAI,CAAC;QAC7C,OAAO,EAAE,mCAAmC,CAAC,MAAM,CAAC;YAClD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;SACjB,CAAC;KACH,CAAC;IACF,4BAA4B,CAAC,MAAM,CAAC;QAClC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,IAAI,CAAC;QAC7C,OAAO,EAAE,mCAAmC,CAAC,MAAM,CAAC;YAClD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;SAC5G,CAAC;KACH,CAAC;IACF,4BAA4B,CAAC,MAAM,CAAC;QAClC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,QAAQ,CAAC;QACjD,OAAO,EAAE,mCAAmC,CAAC,MAAM,CAAC;YAClD,2EAA2E;YAC3E,0EAA0E;YAC1E,yEAAyE;YACzE,0EAA0E;YAC1E,kCAAkC;YAClC,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE;SACd,CAAC;KACH,CAAC;IACF,4BAA4B,CAAC,MAAM,CAAC;QAClC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,UAAU,CAAC;QACnD,OAAO,EAAE,mCAAmC,CAAC,MAAM,CAAC;YAClD,wEAAwE;YACxE,yEAAyE;YACzE,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE;SACd,CAAC;KACH,CAAC;IACF,4BAA4B,CAAC,MAAM,CAAC;QAClC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,KAAK,CAAC;QAC9C,OAAO,EAAE,mCAAmC,CAAC,MAAM,CAAC;YAClD,iEAAiE;YACjE,sEAAsE;YACtE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;YAC3G,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;YAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;SAC/C,CAAC;KACH,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAmC,uBAAuB,CAAC","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"]}

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

	@@ -1 +1 @@
1	- {"version":3,"file":"flows-actors.system.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.system.shared.schemas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAiC,iCAAiC,EAAE,kBAAkB,~~EAAE~~,MAAM,uCAAuC,CAAC;~~AAyB7I~~,oBAAY,oBAAoB;IAC9B,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED,oBAAY,sBAAsB;IAChC,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,QAAQ,aAAa;CACtB;AAED,oBAAY,0BAA0B;IACpC,YAAY,iBAAiB;IAC7B,QAAQ,aAAa;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoBrC,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAQ9E,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAS7C,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE7F,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;~~iBAe1C~~,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC"}
1	+ {"version":3,"file":"flows-actors.system.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.system.shared.schemas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAiC,iCAAiC,EAAE,kBAAkB,EAA6B,MAAM,uCAAuC,CAAC;AAyBxK,oBAAY,oBAAoB;IAC9B,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED,oBAAY,sBAAsB;IAChC,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,QAAQ,aAAa;CACtB;AAED,oBAAY,0BAA0B;IACpC,YAAY,iBAAiB;IAC7B,QAAQ,aAAa;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoBrC,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAQ9E,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAS7C,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE7F,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;iBAgB1C,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC"}

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

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { FlowsActors_Configuration_Schema } from './flows-actors.configuration.shared.schemas.js';
-import { FlowsActors_Checkpoint_Schema, FlowsActors_CircuitBreaker_Status, FlowsActors_Status } from './flows-actors.commons.shared.schemas.js';
+import { FlowsActors_Checkpoint_Schema, FlowsActors_CircuitBreaker_Status, FlowsActors_Status, describeFlowsActorsStatus } from './flows-actors.commons.shared.schemas.js';
 import { WildoError_BackendSchema } from '../errors/errors.shared.schemas.js';
 import { ExecutionContext_InitiatorIdsSchema } from '../runtime/execution-context.shared.schemas.js';
 //===============================================================
@@ -93,7 +93,8 @@ export const FlowActorSystem_ExecutionSchema = z.object({
     status: z.enum(FlowsActors_Status),
     initiator: ExecutionContext_InitiatorIdsSchema.optional(),
     statusChanges: z.array(z.object({
-        status: z.enum(FlowsActors_Status),
+        status: z.enum(FlowsActors_Status)
+            .describe(describeFlowsActorsStatus("The state this run moved into at `timestamp`. The list is the run's history, oldest first.")),
         timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),
     })),
     createdAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),

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

	@@ -1 +1 @@
1	- {"version":3,"file":"flows-actors.system.shared.schemas.js","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.system.shared.schemas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gCAAgC,EAAE,MAAM,6CAA6C,CAAC;AAE/F,OAAO,EAAE,6BAA6B,EAAE,iCAAiC,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;~~AAC7I~~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~~QAClC~~,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;KACrG,CAAC,CAAC;IAEH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;IACpG,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;IACpG,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC,CAAC,QAAQ,EAAE;CACjH,CAAC,CAAC","sourcesContent":["\nimport { z } from 'zod';\n\nimport { FlowsActors_Configuration_Schema } from './flows-actors.configuration.shared.schemas';\nimport { ActorsSystem_ExecutionPlan_Schema } from './tasks.actors.shared.schemas';\nimport { FlowsActors_Checkpoint_Schema, FlowsActors_CircuitBreaker_Status, FlowsActors_Status } from './flows-actors.commons.shared.schemas';\nimport { WildoError_BackendSchema } from '../errors/errors.shared.schemas';\nimport { ExecutionContext_InitiatorIdsSchema } from '../runtime/execution-context.shared.schemas';\n\n\n//===============================================================\n// FlowActorSystem — BASE contract\n// --------\n// This module declares the fields EVERY flow-actor system carries,\n// whatever its `kind`. It is deliberately NOT a complete system.\n//\n// A system is always one of the two kind specializations, and each one\n// declares members this base cannot:\n// - `ActorSystem` (`actors.shared.schemas.ts`) adds `actors`\n// - `FlowSystem` (`flows.shared.schemas.ts`) adds `triggers`,\n// `steps`, `edges`, `finishes`\n//\n// The type meaning \"a system, of either kind\" is `FlowActorSystem`, the\n// discriminated union in `flows-actors.system.shared.definitions.ts`.\n// That is what every consumer signature (registry, factories, services)\n// should name. Naming the BASE there is what previously made\n// `system.actors` unreadable at every call site and forced a cast.\n//\n//===============================================================\n\nexport enum FlowActorSystem_Kind {\n FLOW = \"flow\",\n ACTOR = \"actor\",\n}\n\nexport enum FlowActorSystem_Status {\n DRAFT = \"draft\",\n ACTIVE = \"active\",\n INACTIVE = \"inactive\",\n DEPRECATED = \"deprecated\",\n ARCHIVED = \"archived\",\n}\n\nexport enum FlowActorSystem_Visibility {\n BACKEND_ONLY = \"backend_only\",\n FRONTEND = \"frontend\",\n}\n\n/*\n The base field set shared by every flow-actor system.\n \n Never parse a whole system with this schema. `z.object` strips undeclared\n * keys, so `FlowActorSystem_BaseSchema.parse(actorSystem)` returns a value with\n * the `actors` array silently removed. Nothing at the parse site reports it: the\n * call succeeds, and its result type is exactly the base, so the compiler has no\n * loss to complain about — the value only becomes wrong further downstream,\n * wherever the actor list was going to be read. Parse a system with the schema\n * of its kind (`ActorSystemSchema`) instead; this base exists to be\n * `.extend()`ed, not to validate.\n \n The name carries the `_Base` suffix precisely so that mistake is visible at\n * the call site rather than hidden behind the unqualified system name.\n /\nexport const FlowActorSystem_BaseSchema = z.object({\n ref : z.string().min(1),\n displayName : z.string().min(1),\n description : z.string(),\n kind : z.enum(FlowActorSystem_Kind),\n status : z.enum(FlowActorSystem_Status),\n visibility : z.enum(FlowActorSystem_Visibility).default(FlowActorSystem_Visibility.BACKEND_ONLY),\n\n config : FlowsActors_Configuration_Schema,\n\n version: z.string().optional(),\n createdAt: z.string().optional(),\n updatedAt: z.string().optional(),\n deletedAt: z.string().optional(),\n deprecatedAt: z.string().optional(),\n publishedAt: z.string().optional(),\n\n tags: z.array(z.string()).optional(),\n category: z.string().optional(),\n metadata: z.record(z.string(), z.string()).optional(),\n});\n\n/\n Base fields only — not a usable system on its own. Use `FlowActorSystem`\n * (the `ActorSystem \| FlowSystem` union) for \"a system of either kind\".\n */\nexport type FlowActorSystem_Base = z.infer<typeof FlowActorSystem_BaseSchema>;\n\n\n\n//===============================================================\n// FlowActorSystem Execution\n//===============================================================\n\nexport const FlowActorSystem_ErrorStates_Schema = z.object({\n circuitBreakerStatus: z.enum(FlowsActors_CircuitBreaker_Status).optional(),\n errorItems: WildoError_BackendSchema.extend({\n systemRef: z.string(),\n }).array().optional(),\n checkpointChecks: z.array(z.object({\n checkpoint: FlowsActors_Checkpoint_Schema,\n timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n })),\n});\n\nexport type FlowActorSystem_ErrorStates = z.infer<typeof FlowActorSystem_ErrorStates_Schema>;\n\nexport const FlowActorSystem_ExecutionSchema = z.object({\n _id: z.string().optional(),\n systemRef : z.string(),\n kind : z.enum(FlowActorSystem_Kind),\n status: z.enum(FlowsActors_Status),\n initiator: ExecutionContext_InitiatorIdsSchema.optional(),\n\n statusChanges: z.array(z.object({\n status: z.enum(FlowsActors_Status),\n timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n })),\n\n createdAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n updatedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n finishedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }).optional(),\n});\n\nexport type FlowActorSystem_Execution = z.infer<typeof FlowActorSystem_ExecutionSchema>;\n\n"]}
1	+ {"version":3,"file":"flows-actors.system.shared.schemas.js","sourceRoot":"","sources":["../../../../src/flows-actors/flows-actors.system.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["\nimport { z } from 'zod';\n\nimport { FlowsActors_Configuration_Schema } from './flows-actors.configuration.shared.schemas';\nimport { ActorsSystem_ExecutionPlan_Schema } from './tasks.actors.shared.schemas';\nimport { FlowsActors_Checkpoint_Schema, FlowsActors_CircuitBreaker_Status, FlowsActors_Status, describeFlowsActorsStatus } from './flows-actors.commons.shared.schemas';\nimport { WildoError_BackendSchema } from '../errors/errors.shared.schemas';\nimport { ExecutionContext_InitiatorIdsSchema } from '../runtime/execution-context.shared.schemas';\n\n\n//===============================================================\n// FlowActorSystem — BASE contract\n// --------\n// This module declares the fields EVERY flow-actor system carries,\n// whatever its `kind`. It is deliberately NOT a complete system.\n//\n// A system is always one of the two kind specializations, and each one\n// declares members this base cannot:\n// - `ActorSystem` (`actors.shared.schemas.ts`) adds `actors`\n// - `FlowSystem` (`flows.shared.schemas.ts`) adds `triggers`,\n// `steps`, `edges`, `finishes`\n//\n// The type meaning \"a system, of either kind\" is `FlowActorSystem`, the\n// discriminated union in `flows-actors.system.shared.definitions.ts`.\n// That is what every consumer signature (registry, factories, services)\n// should name. Naming the BASE there is what previously made\n// `system.actors` unreadable at every call site and forced a cast.\n//\n//===============================================================\n\nexport enum FlowActorSystem_Kind {\n FLOW = \"flow\",\n ACTOR = \"actor\",\n}\n\nexport enum FlowActorSystem_Status {\n DRAFT = \"draft\",\n ACTIVE = \"active\",\n INACTIVE = \"inactive\",\n DEPRECATED = \"deprecated\",\n ARCHIVED = \"archived\",\n}\n\nexport enum FlowActorSystem_Visibility {\n BACKEND_ONLY = \"backend_only\",\n FRONTEND = \"frontend\",\n}\n\n/*\n The base field set shared by every flow-actor system.\n \n Never parse a whole system with this schema. `z.object` strips undeclared\n * keys, so `FlowActorSystem_BaseSchema.parse(actorSystem)` returns a value with\n * the `actors` array silently removed. Nothing at the parse site reports it: the\n * call succeeds, and its result type is exactly the base, so the compiler has no\n * loss to complain about — the value only becomes wrong further downstream,\n * wherever the actor list was going to be read. Parse a system with the schema\n * of its kind (`ActorSystemSchema`) instead; this base exists to be\n * `.extend()`ed, not to validate.\n \n The name carries the `_Base` suffix precisely so that mistake is visible at\n * the call site rather than hidden behind the unqualified system name.\n /\nexport const FlowActorSystem_BaseSchema = z.object({\n ref : z.string().min(1),\n displayName : z.string().min(1),\n description : z.string(),\n kind : z.enum(FlowActorSystem_Kind),\n status : z.enum(FlowActorSystem_Status),\n visibility : z.enum(FlowActorSystem_Visibility).default(FlowActorSystem_Visibility.BACKEND_ONLY),\n\n config : FlowsActors_Configuration_Schema,\n\n version: z.string().optional(),\n createdAt: z.string().optional(),\n updatedAt: z.string().optional(),\n deletedAt: z.string().optional(),\n deprecatedAt: z.string().optional(),\n publishedAt: z.string().optional(),\n\n tags: z.array(z.string()).optional(),\n category: z.string().optional(),\n metadata: z.record(z.string(), z.string()).optional(),\n});\n\n/\n Base fields only — not a usable system on its own. Use `FlowActorSystem`\n * (the `ActorSystem \| FlowSystem` union) for \"a system of either kind\".\n */\nexport type FlowActorSystem_Base = z.infer<typeof FlowActorSystem_BaseSchema>;\n\n\n\n//===============================================================\n// FlowActorSystem Execution\n//===============================================================\n\nexport const FlowActorSystem_ErrorStates_Schema = z.object({\n circuitBreakerStatus: z.enum(FlowsActors_CircuitBreaker_Status).optional(),\n errorItems: WildoError_BackendSchema.extend({\n systemRef: z.string(),\n }).array().optional(),\n checkpointChecks: z.array(z.object({\n checkpoint: FlowsActors_Checkpoint_Schema,\n timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n })),\n});\n\nexport type FlowActorSystem_ErrorStates = z.infer<typeof FlowActorSystem_ErrorStates_Schema>;\n\nexport const FlowActorSystem_ExecutionSchema = z.object({\n _id: z.string().optional(),\n systemRef : z.string(),\n kind : z.enum(FlowActorSystem_Kind),\n status: z.enum(FlowsActors_Status),\n initiator: ExecutionContext_InitiatorIdsSchema.optional(),\n\n statusChanges: z.array(z.object({\n status: z.enum(FlowsActors_Status)\n .describe(describeFlowsActorsStatus(\"The state this run moved into at `timestamp`. The list is the run's history, oldest first.\")),\n timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n })),\n\n createdAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n updatedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),\n finishedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }).optional(),\n});\n\nexport type FlowActorSystem_Execution = z.infer<typeof FlowActorSystem_ExecutionSchema>;\n\n"]}

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

	@@ -1 +1 @@
1	- {"version":3,"file":"flows.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/flows.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,kBAAkB,~~EAAE~~,MAAM,uCAAuC,CAAC;~~AAC3E~~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~~iBAmBtC~~,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}
1	+ {"version":3,"file":"flows.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/flows.shared.schemas.ts"],"names":[],"mappings":"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"}

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

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { WildoError_BackendSchema } from "../errors/errors.shared.schemas.js";
-import { FlowsActors_Status } from "./flows-actors.commons.shared.schemas.js";
+import { FlowsActors_Status, describeFlowsActorsStatus } from "./flows-actors.commons.shared.schemas.js";
 import { FlowActorSystem_ErrorStates_Schema, FlowActorSystem_ExecutionSchema, FlowActorSystem_Kind } from "./flows-actors.system.shared.schemas.js";
 import { createSchemaFamily } from "../resources/utils/schema-family-builder.utils.js";
 export var Flow_Node_Type;
@@ -134,7 +134,8 @@ export const FlowSystem_Execution_Schema = FlowActorSystem_ExecutionSchema.exten
         status: z.enum(FlowsActors_Status),
         updatedAt: z.iso.datetime(),
         statusChanges: z.array(z.object({
-            status: z.enum(FlowsActors_Status),
+            status: z.enum(FlowsActors_Status)
+                .describe(describeFlowsActorsStatus("The state this run moved into at `timestamp`. The list is the run's history, oldest first.")),
             timestamp: z.iso.datetime(),
         })),
     }).array(),

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

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

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

@@ -0,0 +1,128 @@
+import { z } from 'zod';
+/**
+ * An MCP server an application permits its agents to reach.
+ *
+ * ## Why this exists (#491)
+ *
+ * `capabilities.tools.mcpRefs` was declared on the agent model, populated by a shipped catalog, and
+ * rendered on the agent card — while nothing resolved a ref into a callable tool. The refs in that
+ * catalog (`filesystem-mcp`, `git-mcp`, `browser-mcp`, `mongodb-mcp`, …) named no server anywhere;
+ * they were authored against a field nothing read, so an agent card told a person the agent had a
+ * reach it did not have.
+ *
+ * A ref must map to a transport, an endpoint and a credential. `functionRefs` have
+ * `getFunctionTool`; these had no equivalent, so there was nothing to resolve against. This is that
+ * equivalent, and it is what makes an `mcpRef` checkable.
+ *
+ * ## Why the APPLICATION declares it
+ *
+ * Decided 2026-09-09. An MCP tool call leaves the application's trust boundary and reaches a server
+ * whose authorization is its own, so which third parties an application's agents may reach is the
+ * application's decision — the same shape in which it already declares providers and capabilities.
+ * Rejected: sourcing servers from the vendor provider catalogue (it describes REST operations, not
+ * MCP endpoints, and would couple this to the provider architecture), and a platform-curated set an
+ * application opts into (it makes the framework the gatekeeper of every application's third-party
+ * reach, and needs a curation process that does not exist).
+ *
+ * This does not contradict the standing position that MCP is not an application's integration
+ * runtime: an application calls a third-party API DIRECTLY, with typed operations. MCP is for the
+ * case where an LLM agent sits between the application and the external system, which is exactly
+ * what an agent's tool call is.
+ */
+/**
+ * How the runtime reaches the server.
+ *
+ * A closed vocabulary rather than a free string: the transport decides the whole connection
+ * lifecycle — how a session opens, whether the server can push, how a stream ends — so a value
+ * nobody implemented must be unrepresentable rather than discovered at the first call.
+ *
+ * STDIO is deliberately ABSENT. It launches a local subprocess, which is the coding-agent lane's
+ * shape and not an application's: a generated application runs in a container it does not control,
+ * and "the agent may spawn a process" is a different security decision from "the agent may call an
+ * endpoint". Adding it later is a decision, not an omission.
+ */
+export declare enum FlowsActors_McpTransport {
+    /** Streamable HTTP — the current MCP transport for remote servers. */
+    HTTP_STREAM = "http_stream",
+    /** Server-sent events — the earlier remote transport, still widely deployed. */
+    SSE = "sse"
+}
+/**
+ * WHOSE credential the call carries.
+ *
+ * The distinction is not a preference. A tool call that reaches a third party on a user's behalf
+ * should be attributable to that user AT THE FAR END — that is what makes it revocable there and
+ * auditable by the party being called. An application-wide service identity loses that: every
+ * user's call looks identical to the server, and one leaked credential exposes every tenant.
+ */
+export declare enum FlowsActors_McpCredentialSubject {
+    /**
+     * The acting user's own delegated credential, falling back to the organization's connection when
+     * the user has none. The default, and the reason a fallback exists at all: an agent acting for a
+     * user who has never connected the server would otherwise have no path, which would make every
+     * unattended and batch turn impossible.
+     */
+    USER_THEN_ORGANIZATION = "user_then_organization",
+    /** The organization's connection only — for a server the tenant connects once on everyone's behalf. */
+    ORGANIZATION = "organization",
+    /** The acting user's own credential only. No fallback: a user who has not connected cannot call. */
+    USER = "user"
+}
+/**
+ * Which stored credential authorizes the call.
+ *
+ * `providerRef` names a provider the application has already connected, so the credential comes from
+ * `organizationProviderCredentials` / `userProviderCredentials` rather than from a store invented
+ * for MCP. Those exist, carry per-tenant isolation by construction, and already have the connect and
+ * consent flow in front of them — a second credential store for this one call shape would be a
+ * second thing to rotate, audit and leak.
+ */
+export declare const FlowsActors_McpServerCredentialSchema: z.ZodObject<{
+    providerRef: z.ZodString;
+    subject: z.ZodDefault<z.ZodEnum<typeof FlowsActors_McpCredentialSubject>>;
+}, z.core.$strip>;
+export type FlowsActors_McpServerCredential = z.infer<typeof FlowsActors_McpServerCredentialSchema>;
+/**
+ * Bounds on a call that leaves the trust boundary.
+ *
+ * Present with defaults rather than optional-and-unbounded, because an MCP call is a REMOTE call and
+ * the mistake this whole issue warns against is modelling it as a second kind of local function. A
+ * local function cannot hang; this can, and an unbounded tool call holds a model turn open for as
+ * long as somebody else's server feels like it.
+ */
+export declare const FlowsActors_McpServerTimeoutsSchema: z.ZodObject<{
+    discoveryMs: z.ZodDefault<z.ZodNumber>;
+    callMs: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type FlowsActors_McpServerTimeouts = z.infer<typeof FlowsActors_McpServerTimeoutsSchema>;
+export declare const FlowsActors_McpServerSchema: z.ZodObject<{
+    ref: z.ZodString;
+    displayName: z.ZodString;
+    transport: z.ZodEnum<typeof FlowsActors_McpTransport>;
+    url: z.ZodString;
+    credential: z.ZodObject<{
+        providerRef: z.ZodString;
+        subject: z.ZodDefault<z.ZodEnum<typeof FlowsActors_McpCredentialSubject>>;
+    }, z.core.$strip>;
+    timeouts: z.ZodDefault<z.ZodObject<{
+        discoveryMs: z.ZodDefault<z.ZodNumber>;
+        callMs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type FlowsActors_McpServer = z.infer<typeof FlowsActors_McpServerSchema>;
+/**
+ * Whether an MCP endpoint is reached over plaintext.
+ *
+ * Exported rather than inlined because two callers need the same answer — registration, which
+ * refuses, and the audit trail, which records what was refused — and a second spelling of "is this
+ * http" is how the two come to disagree. Mirrors the webhook lane's identical predicate.
+ */
+export declare function mcpServerTransportIsPlaintext(url: string): boolean;
+/**
+ * The server's host, for a log or an audit row that must NOT carry the full URL.
+ *
+ * An MCP endpoint routinely carries a tenant or session identifier in its path or query, so the host
+ * is the part that can be recorded freely.
+ */
+export declare function mcpServerDestinationHost(url: string): string;
+//# sourceMappingURL=mcp-servers.shared.schemas.d.ts.map

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

@@ -0,0 +1 @@

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