@wildo-ai/saas-models 1.0.1 → 1.1.0

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

@@ -1,30 +1,127 @@
-import { LLMProvider_OperationDefinitionBase, LLMProvider_OperationKey, LLMProvider_OperationModelConfiguration, LLMProvider_PromptFormat } from "@wildo-ai/external-connectors-models";
-import { FlowsActors_LeafElements_Configuration } from "./flows-actors.configuration.shared.schemas.js";
-import { FlowsActors_IO_PartKind } from "./flows-actors.io.shared.schemas.js";
-import { ExecutionContext_InitiatorIds } from "../runtime/execution-context.shared.schemas.js";
+import { CodingAgent_OperationDefinitionBase, CodingAgent_OperationKey, CodingAgent_OperationModelConfiguration, ImageProvider_OperationDefinitionBase, ImageProvider_OperationKey, ImageProvider_OperationModelConfiguration, LLMProvider_OperationDefinitionBase, LLMProvider_OperationKey, LLMProvider_OperationModelConfiguration, LLMProvider_PromptFormat } from "@wildo-ai/external-connectors-models";
+import { FlowsActors_LeafElements_Configuration } from "./flows-actors.configuration.shared.schemas";
+import { FlowsActors_IO_PartKind } from "./flows-actors.io.shared.schemas";
+import { ExecutionContext_InitiatorIds } from "../runtime/execution-context.shared.schemas";
 import z from "zod";
-import { FlowsActors_Relationship } from "./flows-actors.commons.shared.schemas.js";
-import { AppsBlueprint_FileFormat } from "./apps-blueprint/artifacts.apps-blueprint.shared.schemas.js";
-/**
+import { FlowsActors_Relationship } from "./flows-actors.commons.shared.schemas";
+import { AppsBlueprint_FileFormat } from "./apps-blueprint/artifacts.apps-blueprint.shared.schemas";
+/** @wildo_source:part:start saas.models.flows-actors.agent-configuration facet:kind:api facet:audience:app-developer
+ *
  * Agent execution settings that stay stable across transport changes.
  *
  * `providerRef` and `model` still come from the semantic LLM configuration,
  * while `executionProfileRef` selects one transport/runtime profile under the
- * provider's `CLI_RUNTIME` protocol when execution should not use the default
+ * provider's `AGENT_CLIENT_PROTOCOL` transport when execution should not use the default
  * API-backed path.
  */
 export type FlowsActors_Agent_ExecutionConfiguration = LLMProvider_OperationModelConfiguration & {
     executionProfileRef?: string;
+    /** Refuse provider fan-out when one budget reservation authorizes exactly one physical model call. */
+    structuredGenerationExecutionMode?: StructuredGenerationExecutionMode;
+    /**
+     * Immutable schema-shape ceiling used by both pre-admission planning and the physical structured-output executor.
+     * SINGLE_CALL_REQUIRED agents must declare this value so a provider configuration override cannot silently change
+     * the number of calls after one budget reservation has been admitted.
+     */
+    maximumStructuredOutputLeafFields?: number;
 };
-export type FlowsActors_Agent_Configuration = FlowsActors_LeafElements_Configuration & FlowsActors_Agent_ExecutionConfiguration & {
+export declare enum StructuredGenerationExecutionMode {
+    CHUNKING_ALLOWED = "CHUNKING_ALLOWED",
+    SINGLE_CALL_REQUIRED = "SINGLE_CALL_REQUIRED"
+}
+/**
+ * The LLM/text execution arm of an agent config — the original shape,
+ * unchanged. Its `operationKey` is an `LLMProvider_OperationKey`, which is
+ * what discriminates this arm from the image arm below (the two operation-key
+ * enums are disjoint, so TypeScript narrows the union by `operationKey`).
+ * Produces the TEXT / STRUCTURED modality; the executor routes it to
+ * `LLM_PROVIDER`.
+ */
+export type FlowsActors_Agent_LLMConfiguration = FlowsActors_LeafElements_Configuration & FlowsActors_Agent_ExecutionConfiguration & {
     operationKey: LLMProvider_OperationKey;
     seed?: number;
 };
+/**
+ * The IMAGE execution arm of an agent config. Carries image-generation
+ * parameters (`size` / `quality` / `background` / …) instead of LLM sampling,
+ * and an `ImageProvider_OperationKey`. Produces the IMAGE modality; the
+ * executor routes it to `IMAGE_PROVIDER`. (AUDIO / VIDEO arms are reserved —
+ * their config types land when those transports are wired.)
+ */
+export type FlowsActors_Agent_ImageConfiguration = FlowsActors_LeafElements_Configuration & ImageProvider_OperationModelConfiguration & {
+    operationKey: ImageProvider_OperationKey;
+    executionProfileRef?: string;
+};
+/**
+ * The CODING execution arm of an agent config. Carries a workspace-mutating
+ * agent reached over the Agent Client Protocol, and a `CodingAgent_OperationKey`.
+ * Produces no artifact modality at all — its product is a CHANGED WORKSPACE,
+ * which is why it sits on this axis rather than beside TEXT and IMAGE as
+ * another thing to generate.
+ *
+ * `executionProfileRef` is REQUIRED here, unlike every other arm. A coding
+ * agent cannot fall back to a default API-backed path: there is no such path,
+ * and the profile is where the environment gate, the permission ceiling and the
+ * host-configuration posture live. An agent that could omit it would be an
+ * agent whose authority was unstated.
+ */
+export type FlowsActors_Agent_CodingConfiguration = FlowsActors_LeafElements_Configuration & CodingAgent_OperationModelConfiguration & {
+    operationKey: CodingAgent_OperationKey;
+    executionProfileRef: string;
+};
+/**
+ * Agent execution config, discriminated by `operationKey` along the artifact
+ * MODALITY axis. One agent concept; the arm selects the transport family.
+ * Narrow with {@link isImageAgentConfiguration} or
+ * {@link isCodingAgentConfiguration} before reading arm-specific fields.
+ */
+export type FlowsActors_Agent_Configuration = FlowsActors_Agent_LLMConfiguration | FlowsActors_Agent_ImageConfiguration | FlowsActors_Agent_CodingConfiguration;
+/**
+ * Narrows an agent config to its IMAGE arm. The two `operationKey` enums are
+ * disjoint, so membership in `ImageProvider_OperationKey` is a sound
+ * discriminant.
+ */
+export declare function isImageAgentConfiguration(config: FlowsActors_Agent_Configuration): config is FlowsActors_Agent_ImageConfiguration;
+/**
+ * Narrows an agent config to its LLM/text arm.
+ *
+ * Exists so consumers can narrow POSITIVELY. Writing `!isImageAgentConfiguration(config)`
+ * to mean "this is the LLM arm" was correct only while the union had exactly two
+ * members: the moment a third arm landed, that negation silently widened to
+ * include it and the compiler reported a missing property somewhere else
+ * entirely. A positive guard cannot absorb a future arm by accident.
+ */
+export declare function isLLMAgentConfiguration(config: FlowsActors_Agent_Configuration): config is FlowsActors_Agent_LLMConfiguration;
+/**
+ * Narrows an agent config to its CODING arm. The operation-key enums are
+ * pairwise disjoint, so membership in `CodingAgent_OperationKey` is a sound
+ * discriminant — the same argument the image guard rests on.
+ */
+export declare function isCodingAgentConfiguration(config: FlowsActors_Agent_Configuration): config is FlowsActors_Agent_CodingConfiguration;
+/** @wildo_source:part:end saas.models.flows-actors.agent-configuration */
+/** @wildo_source:part:start saas.models.flows-actors.agent-definition facet:kind:api facet:audience:app-developer
+ *
+ * Agent lifecycle status. Only `ACTIVE` agents are invocable — invoking an
+ * `INACTIVE` / `DEPRECATED` agent is refused at the call, not at registration,
+ * so this is the switch for retiring an agent without deleting its definition
+ * (and without breaking the refs that still name it).
+ */
 export declare enum FlowsActors_Agent_Status {
     ACTIVE = "active",
     INACTIVE = "inactive",
     DEPRECATED = "deprecated"
 }
+/** @wildo_source:part:end saas.models.flows-actors.agent-definition */
+/** @wildo_source:part:start saas.models.flows-actors.agent-prompt-spec facet:kind:api facet:audience:app-developer
+ *
+ * What KIND of work the agent does. The prompt compiler turns this into the
+ * agent's baseline behavioral instructions before your own `instructions[]` are
+ * appended — so it is a real behavioral input, not a label. Pick the one that
+ * matches the job: `GENERATION` (write something new), `ANALYSIS` (read and
+ * report), `TRANSFORMATION` (reshape given input), `DECISION` (choose/judge),
+ * `CHAT` (multi-turn conversation — see the chat-assistant skill), `CUSTOM`
+ * (none of the baselines fit).
+ */
 export declare enum FlowsActors_Agent_Skill_Type {
     GENERATION = "generation",
     ANALYSIS = "analysis",
@@ -33,6 +130,7 @@ export declare enum FlowsActors_Agent_Skill_Type {
     CHAT = "chat",
     CUSTOM = "custom"
 }
+/** @wildo_source:part:end saas.models.flows-actors.agent-prompt-spec */
 export declare enum FlowsActors_Agent_Verbosity {
     LOW = "low",
     MEDIUM = "medium",
@@ -60,7 +158,7 @@ export declare const FlowsActors_Agent_ConstraintSchema: z.ZodObject<{
         warn: "warn";
         log: "log";
     }>>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type FlowsActors_Agent_Constraint = z.infer<typeof FlowsActors_Agent_ConstraintSchema>;
 export declare const FlowsActors_Agent_OutputSpecSchema: z.ZodObject<{
     type: z.ZodOptional<z.ZodEnum<typeof FlowsActors_IO_PartKind>>;
@@ -68,7 +166,7 @@ export declare const FlowsActors_Agent_OutputSpecSchema: z.ZodObject<{
     lengthGuidance: z.ZodOptional<z.ZodEnum<typeof FlowsActors_Agent_Verbosity>>;
     includeReasoning: z.ZodOptional<z.ZodBoolean>;
     requiredSections: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type FlowsActors_Agent_OutputSpec = z.infer<typeof FlowsActors_Agent_OutputSpecSchema>;
 export declare enum FlowsActors_Agent_UncertaintyPolicy {
     ASK = "ask",// Ask for clarification
@@ -79,8 +177,21 @@ export declare enum FlowsActors_Agent_UncertaintyPolicy {
 export declare const FlowsActors_Agent_UncertaintySchema: z.ZodObject<{
     policy: z.ZodDefault<z.ZodEnum<typeof FlowsActors_Agent_UncertaintyPolicy>>;
     confidenceThreshold: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type FlowsActors_Agent_Uncertainty = z.infer<typeof FlowsActors_Agent_UncertaintySchema>;
+/** @wildo_source:part:start saas.models.flows-actors.agent-prompt-spec facet:kind:api facet:audience:app-developer
+ *
+ * The agent's prompt, authored as STRUCTURE rather than one prose blob. The
+ * prompt compiler renders these fields into the provider's preferred format
+ * (XML boundaries for Claude, message roles for OpenAI, …), so you never
+ * hand-format a system prompt or branch on the provider yourself.
+ *
+ * `role` + `skillType` are the only required fields — start there and add the
+ * rest as the behavior needs them. Precedence when the model must choose:
+ * `constraints` (prohibitions — highest) > `instructions` (hard rules) >
+ * `hints` (soft preferences). Keep the per-call task in the invocation's
+ * `input.prompt`; keep everything durable about the agent here.
+ */
 export declare const FlowsActors_Agent_PromptSpecSchema: z.ZodObject<{
     role: z.ZodString;
     persona: z.ZodOptional<z.ZodString>;
@@ -94,7 +205,7 @@ export declare const FlowsActors_Agent_PromptSpecSchema: z.ZodObject<{
             warn: "warn";
             log: "log";
         }>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>>;
+    }, z.core.$strip>>>;
     goal: z.ZodOptional<z.ZodString>;
     output: z.ZodOptional<z.ZodObject<{
         type: z.ZodOptional<z.ZodEnum<typeof FlowsActors_IO_PartKind>>;
@@ -102,37 +213,51 @@ export declare const FlowsActors_Agent_PromptSpecSchema: z.ZodObject<{
         lengthGuidance: z.ZodOptional<z.ZodEnum<typeof FlowsActors_Agent_Verbosity>>;
         includeReasoning: z.ZodOptional<z.ZodBoolean>;
         requiredSections: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
     instructions: z.ZodDefault<z.ZodArray<z.ZodString>>;
     hints: z.ZodOptional<z.ZodArray<z.ZodString>>;
     uncertainty: z.ZodOptional<z.ZodObject<{
         policy: z.ZodDefault<z.ZodEnum<typeof FlowsActors_Agent_UncertaintyPolicy>>;
         confidenceThreshold: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
     outOfScope: z.ZodOptional<z.ZodArray<z.ZodString>>;
     examples: z.ZodOptional<z.ZodArray<z.ZodObject<{
         input: z.ZodString;
         output: z.ZodString;
         explanation: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip, core.$ZodObjectExtra>>>;
+    }, z.core.$strip>>>;
     style: z.ZodOptional<z.ZodObject<{
         verbosity: z.ZodOptional<z.ZodEnum<typeof FlowsActors_Agent_Verbosity>>;
         tone: z.ZodOptional<z.ZodEnum<typeof FlowsActors_Agent_Tone>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
     curation: z.ZodOptional<z.ZodObject<{
         maxItems: z.ZodOptional<z.ZodNumber>;
         minRelevance: z.ZodOptional<z.ZodNumber>;
         maxTokens: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
     promptFormatOverride: z.ZodOptional<z.ZodEnum<typeof LLMProvider_PromptFormat>>;
     metadata: z.ZodOptional<z.ZodObject<{
         version: z.ZodOptional<z.ZodString>;
         lastModified: z.ZodOptional<z.ZodString>;
         author: z.ZodOptional<z.ZodString>;
         changelog: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export type FlowsActors_Agent_PromptSpec = z.infer<typeof FlowsActors_Agent_PromptSpecSchema>;
+/** @wildo_source:part:end saas.models.flows-actors.agent-prompt-spec */
+/** @wildo_source:part:start saas.models.flows-actors.agent-definition facet:kind:api facet:audience:app-developer
+ *
+ * A callable AI unit. This is the whole authoring surface for "give my app an
+ * LLM capability": author one of these, register it on your backend module's
+ * `flowsActors.agents`, then invoke it by `ref`.
+ *
+ * The definition is DECLARATIVE and durable — provider, model, operation, and
+ * prompt live here; the per-call task lives in the invocation. Nothing about
+ * transport, retries, rate limiting, usage accounting, or tracing is yours to
+ * write: the engine owns all of it once the agent is registered.
+ *
+ * Import path: `@wildo-ai/saas-models`.
+ */
 export type FlowsActors_Agent = {
     /** Unique agent reference for flow/actor calls */
     ref: string;
@@ -140,10 +265,18 @@ export type FlowsActors_Agent = {
     displayName: string;
     /** Agent lifecycle status */
     status: FlowsActors_Agent_Status;
-    /** LLM provider and model configuration */
+    /** Provider/model config, discriminated by modality (LLM/text | image | coding). */
     config: FlowsActors_Agent_Configuration;
-    /** Operation definition (input/output types, etc.) */
-    operationDefinition: LLMProvider_OperationDefinitionBase;
+    /** Operation definition (input/output schemas, etc.), per transport family. */
+    operationDefinition: LLMProvider_OperationDefinitionBase | ImageProvider_OperationDefinitionBase | CodingAgent_OperationDefinitionBase;
+    /**
+     * The modality this agent PRODUCES. Optional: when omitted the executor
+     * derives it from `config` (LLM keys → TEXT/STRUCTURED, image key → IMAGE).
+     * Set explicitly to make a multimodal agent's output self-describing.
+     */
+    outputModality?: FlowsActors_IO_PartKind;
+    /** The modalities this agent CONSUMES (e.g. `[TEXT]` for text-to-image). */
+    inputModalities?: FlowsActors_IO_PartKind[];
     /**
      * Complete prompt specification
      * Defines role, persona, constraints, instructions, output format, etc.
@@ -165,6 +298,29 @@ export type FlowsActors_Agent = {
     /** Last update timestamp (ISO 8601) */
     updatedAt?: string;
 };
+/** @wildo_source:part:end saas.models.flows-actors.agent-definition */
+/** @wildo_source:part:start saas.models.flows-actors.agent-invocation facet:kind:api facet:audience:app-developer
+ *
+ * One call to one agent — the envelope you build and hand to
+ * `AgentsBackendService.invokeAgent`, and the SAME shape you get back with
+ * `output` and `executionContext` filled in.
+ *
+ * What you supply:
+ * - `agentRef` — the `ref` of a registered agent (unknown ref throws).
+ * - `input` — the per-call task. `{ prompt }` for text; add `{ schema }` (a Zod
+ *   schema) for `GENERATE_STRUCTURED`, which REQUIRES it. Anything else you put
+ *   here is JSON-serialized into the user prompt.
+ * - `output` — an empty value of the expected shape (`{ text: '' }`,
+ *   `{ object: {} }`). It is a typing seed; the returned envelope replaces it.
+ * - `initiator` / `invocationContext` / `artifactBindings` — `{}` / `[]` / `[]`
+ *   when you have nothing to correlate.
+ *
+ * What comes back: `output` normalized to the operation's shape, and
+ * `executionContext` enriched with `executionTime`, `finishedAt`, and provider
+ * `usage` (tokens) when the transport reports it.
+ *
+ * Import path: `@wildo-ai/saas-models`.
+ */
 export type FlowsActors_Agent_Invocation<InputSchema extends z.ZodSchema<any> = z.ZodSchema<any>, OutputSchema extends z.ZodSchema<any> = z.ZodSchema<any>, ContextSchema extends z.ZodSchema<any> = z.ZodSchema<any>> = {
     _id?: string;
     agentRef: string;
@@ -178,4 +334,5 @@ export type FlowsActors_Agent_Invocation<InputSchema extends z.ZodSchema<any> =
         ref: string;
     }[];
 };
+/** @wildo_source:part:end saas.models.flows-actors.agent-invocation */
 //# sourceMappingURL=agents.shared.schemas.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"agents.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/flows-actors/agents.shared.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agents.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/agents.shared.schemas.ts"],"names":[],"mappings":"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"}

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

@@ -1,13 +1,65 @@
-import { LLMProvider_PromptFormat, } from "@wildo-ai/external-connectors-models";
+import { CodingAgent_OperationKey, ImageProvider_OperationKey, LLMProvider_OperationKey, LLMProvider_PromptFormat, } from "@wildo-ai/external-connectors-models";
 import { FlowsActors_IO_PartKind } from "./flows-actors.io.shared.schemas.js";
 import z from "zod";
 import { AppsBlueprint_FileFormat } from "./apps-blueprint/artifacts.apps-blueprint.shared.schemas.js";
+export var StructuredGenerationExecutionMode;
+(function (StructuredGenerationExecutionMode) {
+    StructuredGenerationExecutionMode["CHUNKING_ALLOWED"] = "CHUNKING_ALLOWED";
+    StructuredGenerationExecutionMode["SINGLE_CALL_REQUIRED"] = "SINGLE_CALL_REQUIRED";
+})(StructuredGenerationExecutionMode || (StructuredGenerationExecutionMode = {}));
+/**
+ * Narrows an agent config to its IMAGE arm. The two `operationKey` enums are
+ * disjoint, so membership in `ImageProvider_OperationKey` is a sound
+ * discriminant.
+ */
+export function isImageAgentConfiguration(config) {
+    return Object.values(ImageProvider_OperationKey).includes(config.operationKey);
+}
+/**
+ * Narrows an agent config to its LLM/text arm.
+ *
+ * Exists so consumers can narrow POSITIVELY. Writing `!isImageAgentConfiguration(config)`
+ * to mean "this is the LLM arm" was correct only while the union had exactly two
+ * members: the moment a third arm landed, that negation silently widened to
+ * include it and the compiler reported a missing property somewhere else
+ * entirely. A positive guard cannot absorb a future arm by accident.
+ */
+export function isLLMAgentConfiguration(config) {
+    return Object.values(LLMProvider_OperationKey).includes(config.operationKey);
+}
+/**
+ * Narrows an agent config to its CODING arm. The operation-key enums are
+ * pairwise disjoint, so membership in `CodingAgent_OperationKey` is a sound
+ * discriminant — the same argument the image guard rests on.
+ */
+export function isCodingAgentConfiguration(config) {
+    return Object.values(CodingAgent_OperationKey).includes(config.operationKey);
+}
+/** @wildo_source:part:end saas.models.flows-actors.agent-configuration */
+/** @wildo_source:part:start saas.models.flows-actors.agent-definition facet:kind:api facet:audience:app-developer
+ *
+ * Agent lifecycle status. Only `ACTIVE` agents are invocable — invoking an
+ * `INACTIVE` / `DEPRECATED` agent is refused at the call, not at registration,
+ * so this is the switch for retiring an agent without deleting its definition
+ * (and without breaking the refs that still name it).
+ */
 export var FlowsActors_Agent_Status;
 (function (FlowsActors_Agent_Status) {
     FlowsActors_Agent_Status["ACTIVE"] = "active";
     FlowsActors_Agent_Status["INACTIVE"] = "inactive";
     FlowsActors_Agent_Status["DEPRECATED"] = "deprecated";
 })(FlowsActors_Agent_Status || (FlowsActors_Agent_Status = {}));
+/** @wildo_source:part:end saas.models.flows-actors.agent-definition */
+/** @wildo_source:part:start saas.models.flows-actors.agent-prompt-spec facet:kind:api facet:audience:app-developer
+ *
+ * What KIND of work the agent does. The prompt compiler turns this into the
+ * agent's baseline behavioral instructions before your own `instructions[]` are
+ * appended — so it is a real behavioral input, not a label. Pick the one that
+ * matches the job: `GENERATION` (write something new), `ANALYSIS` (read and
+ * report), `TRANSFORMATION` (reshape given input), `DECISION` (choose/judge),
+ * `CHAT` (multi-turn conversation — see the chat-assistant skill), `CUSTOM`
+ * (none of the baselines fit).
+ */
 export var FlowsActors_Agent_Skill_Type;
 (function (FlowsActors_Agent_Skill_Type) {
     FlowsActors_Agent_Skill_Type["GENERATION"] = "generation";
@@ -17,6 +69,7 @@ export var FlowsActors_Agent_Skill_Type;
     FlowsActors_Agent_Skill_Type["CHAT"] = "chat";
     FlowsActors_Agent_Skill_Type["CUSTOM"] = "custom";
 })(FlowsActors_Agent_Skill_Type || (FlowsActors_Agent_Skill_Type = {}));
+/** @wildo_source:part:end saas.models.flows-actors.agent-prompt-spec */
 //===============================================================
 // FlowsActors_Agent Style Preferences
 //===============================================================
@@ -108,6 +161,19 @@ export const FlowsActors_Agent_UncertaintySchema = z.object({
 // Complete prompt specification - required on all agents
 // Replaces legacy skill.role/persona approach
 //===============================================================
+/** @wildo_source:part:start saas.models.flows-actors.agent-prompt-spec facet:kind:api facet:audience:app-developer
+ *
+ * The agent's prompt, authored as STRUCTURE rather than one prose blob. The
+ * prompt compiler renders these fields into the provider's preferred format
+ * (XML boundaries for Claude, message roles for OpenAI, …), so you never
+ * hand-format a system prompt or branch on the provider yourself.
+ *
+ * `role` + `skillType` are the only required fields — start there and add the
+ * rest as the behavior needs them. Precedence when the model must choose:
+ * `constraints` (prohibitions — highest) > `instructions` (hard rules) >
+ * `hints` (soft preferences). Keep the per-call task in the invocation's
+ * `input.prompt`; keep everything durable about the agent here.
+ */
 export const FlowsActors_Agent_PromptSpecSchema = z.object({
     //====================
     // IDENTITY (migrated from legacy skill)
@@ -223,4 +289,5 @@ export const FlowsActors_Agent_PromptSpecSchema = z.object({
         changelog: z.string().optional(),
     }).optional(),
 });
-//# sourceMappingURL=agents.shared.schemas.js.map
+/** @wildo_source:part:end saas.models.flows-actors.agent-invocation */
+//# sourceMappingURL=agents.shared.schemas.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"agents.shared.schemas.js","sourceRoot":"","sources":["../../../src/flows-actors/agents.shared.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agents.shared.schemas.js","sourceRoot":"","sources":["../../../../src/flows-actors/agents.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  CodingAgent_OperationDefinitionBase,\n  CodingAgent_OperationKey,\n  CodingAgent_OperationModelConfiguration,\n  ImageProvider_OperationDefinitionBase,\n  ImageProvider_OperationKey,\n  ImageProvider_OperationModelConfiguration,\n  LLMProvider_OperationDefinitionBase,\n  LLMProvider_OperationKey,\n  LLMProvider_OperationModelConfiguration,\n  LLMProvider_PromptFormat,\n} from \"@wildo-ai/external-connectors-models\";\nimport { FlowsActors_LeafElements_Configuration } from \"./flows-actors.configuration.shared.schemas\";\nimport { FlowsActors_IO_PartKind } from \"./flows-actors.io.shared.schemas\";\nimport { ExecutionContext_InitiatorIds } from \"../runtime/execution-context.shared.schemas\";\nimport { FlowActorSystem_Kind } from \"./flows-actors.system.shared.schemas\";\nimport z from \"zod\";\nimport { FlowsActors_Relationship } from \"./flows-actors.commons.shared.schemas\";\nimport { AppsBlueprint_FileFormat } from \"./apps-blueprint/artifacts.apps-blueprint.shared.schemas\";\n\n\n\n//===============================================================\n//  FlowsActors_Agent\n// --------\n// FlowsActors_Agents are AI-powered entities that execute agentic steps within\n// flows and actors. They encapsulate LLM configurations, skills,\n// and system prompts, enabling intelligent decision-making and\n// content generation. FlowsActors_Agents can be scoped to different levels\n// (platform, application, organization, user) for access control.\n//===============================================================\n\n\n//===============================================================\n// FlowsActors_Agent execution configuration\n// Keeps semantic LLM model config while allowing transport selection\n//===============================================================\n\n/** @wildo_source:part:start saas.models.flows-actors.agent-configuration facet:kind:api facet:audience:app-developer\n *\n * Agent execution settings that stay stable across transport changes.\n *\n * `providerRef` and `model` still come from the semantic LLM configuration,\n * while `executionProfileRef` selects one transport/runtime profile under the\n * provider's `AGENT_CLIENT_PROTOCOL` transport when execution should not use the default\n * API-backed path.\n */\nexport type FlowsActors_Agent_ExecutionConfiguration = LLMProvider_OperationModelConfiguration & {\n  executionProfileRef?: string;\n  /** Refuse provider fan-out when one budget reservation authorizes exactly one physical model call. */\n  structuredGenerationExecutionMode?: StructuredGenerationExecutionMode;\n  /**\n   * Immutable schema-shape ceiling used by both pre-admission planning and the physical structured-output executor.\n   * SINGLE_CALL_REQUIRED agents must declare this value so a provider configuration override cannot silently change\n   * the number of calls after one budget reservation has been admitted.\n   */\n  maximumStructuredOutputLeafFields?: number;\n};\n\nexport enum StructuredGenerationExecutionMode {\n  CHUNKING_ALLOWED = 'CHUNKING_ALLOWED',\n  SINGLE_CALL_REQUIRED = 'SINGLE_CALL_REQUIRED',\n}\n\n/**\n * The LLM/text execution arm of an agent config — the original shape,\n * unchanged. Its `operationKey` is an `LLMProvider_OperationKey`, which is\n * what discriminates this arm from the image arm below (the two operation-key\n * enums are disjoint, so TypeScript narrows the union by `operationKey`).\n * Produces the TEXT / STRUCTURED modality; the executor routes it to\n * `LLM_PROVIDER`.\n */\nexport type FlowsActors_Agent_LLMConfiguration = FlowsActors_LeafElements_Configuration & FlowsActors_Agent_ExecutionConfiguration & {\n  operationKey: LLMProvider_OperationKey,\n  seed?: number, // Random seed for deterministic output\n};\n\n/**\n * The IMAGE execution arm of an agent config. Carries image-generation\n * parameters (`size` / `quality` / `background` / …) instead of LLM sampling,\n * and an `ImageProvider_OperationKey`. Produces the IMAGE modality; the\n * executor routes it to `IMAGE_PROVIDER`. (AUDIO / VIDEO arms are reserved —\n * their config types land when those transports are wired.)\n */\nexport type FlowsActors_Agent_ImageConfiguration = FlowsActors_LeafElements_Configuration & ImageProvider_OperationModelConfiguration & {\n  operationKey: ImageProvider_OperationKey,\n  executionProfileRef?: string,\n};\n\n/**\n * The CODING execution arm of an agent config. Carries a workspace-mutating\n * agent reached over the Agent Client Protocol, and a `CodingAgent_OperationKey`.\n * Produces no artifact modality at all — its product is a CHANGED WORKSPACE,\n * which is why it sits on this axis rather than beside TEXT and IMAGE as\n * another thing to generate.\n *\n * `executionProfileRef` is REQUIRED here, unlike every other arm. A coding\n * agent cannot fall back to a default API-backed path: there is no such path,\n * and the profile is where the environment gate, the permission ceiling and the\n * host-configuration posture live. An agent that could omit it would be an\n * agent whose authority was unstated.\n */\nexport type FlowsActors_Agent_CodingConfiguration = FlowsActors_LeafElements_Configuration & CodingAgent_OperationModelConfiguration & {\n  operationKey: CodingAgent_OperationKey,\n  executionProfileRef: string,\n};\n\n/**\n * Agent execution config, discriminated by `operationKey` along the artifact\n * MODALITY axis. One agent concept; the arm selects the transport family.\n * Narrow with {@link isImageAgentConfiguration} or\n * {@link isCodingAgentConfiguration} before reading arm-specific fields.\n */\nexport type FlowsActors_Agent_Configuration =\n  | FlowsActors_Agent_LLMConfiguration\n  | FlowsActors_Agent_ImageConfiguration\n  | FlowsActors_Agent_CodingConfiguration;\n\n/**\n * Narrows an agent config to its IMAGE arm. The two `operationKey` enums are\n * disjoint, so membership in `ImageProvider_OperationKey` is a sound\n * discriminant.\n */\nexport function isImageAgentConfiguration(\n  config: FlowsActors_Agent_Configuration,\n): config is FlowsActors_Agent_ImageConfiguration {\n  return Object.values(ImageProvider_OperationKey).includes(config.operationKey as ImageProvider_OperationKey);\n}\n\n/**\n * Narrows an agent config to its LLM/text arm.\n *\n * Exists so consumers can narrow POSITIVELY. Writing `!isImageAgentConfiguration(config)`\n * to mean \"this is the LLM arm\" was correct only while the union had exactly two\n * members: the moment a third arm landed, that negation silently widened to\n * include it and the compiler reported a missing property somewhere else\n * entirely. A positive guard cannot absorb a future arm by accident.\n */\nexport function isLLMAgentConfiguration(\n  config: FlowsActors_Agent_Configuration,\n): config is FlowsActors_Agent_LLMConfiguration {\n  return Object.values(LLMProvider_OperationKey).includes(config.operationKey as LLMProvider_OperationKey);\n}\n\n/**\n * Narrows an agent config to its CODING arm. The operation-key enums are\n * pairwise disjoint, so membership in `CodingAgent_OperationKey` is a sound\n * discriminant — the same argument the image guard rests on.\n */\nexport function isCodingAgentConfiguration(\n  config: FlowsActors_Agent_Configuration,\n): config is FlowsActors_Agent_CodingConfiguration {\n  return Object.values(CodingAgent_OperationKey).includes(config.operationKey as CodingAgent_OperationKey);\n}\n/** @wildo_source:part:end saas.models.flows-actors.agent-configuration */\n\n\n\n\n/** @wildo_source:part:start saas.models.flows-actors.agent-definition facet:kind:api facet:audience:app-developer\n *\n * Agent lifecycle status. Only `ACTIVE` agents are invocable — invoking an\n * `INACTIVE` / `DEPRECATED` agent is refused at the call, not at registration,\n * so this is the switch for retiring an agent without deleting its definition\n * (and without breaking the refs that still name it).\n */\nexport enum FlowsActors_Agent_Status {\n  ACTIVE = \"active\",\n  INACTIVE = \"inactive\",\n  DEPRECATED = \"deprecated\",\n}\n/** @wildo_source:part:end saas.models.flows-actors.agent-definition */\n\n/** @wildo_source:part:start saas.models.flows-actors.agent-prompt-spec facet:kind:api facet:audience:app-developer\n *\n * What KIND of work the agent does. The prompt compiler turns this into the\n * agent's baseline behavioral instructions before your own `instructions[]` are\n * appended — so it is a real behavioral input, not a label. Pick the one that\n * matches the job: `GENERATION` (write something new), `ANALYSIS` (read and\n * report), `TRANSFORMATION` (reshape given input), `DECISION` (choose/judge),\n * `CHAT` (multi-turn conversation — see the chat-assistant skill), `CUSTOM`\n * (none of the baselines fit).\n */\nexport enum FlowsActors_Agent_Skill_Type {\n  GENERATION = \"generation\",\n  ANALYSIS = \"analysis\",\n  TRANSFORMATION = \"transformation\",\n  DECISION = \"decision\",\n  CHAT = \"chat\",\n  CUSTOM = \"custom\",\n}\n/** @wildo_source:part:end saas.models.flows-actors.agent-prompt-spec */\n\n\n\n\n//===============================================================\n// FlowsActors_Agent Style Preferences\n//===============================================================\n\nexport enum FlowsActors_Agent_Verbosity {\n  LOW = \"low\",\n  MEDIUM = \"medium\",\n  HIGH = \"high\",\n}\n\nexport enum FlowsActors_Agent_Tone {\n  NEUTRAL = \"neutral\",\n  CASUAL = \"casual\",\n  FORMAL = \"formal\",\n  TECHNICAL = \"technical\",\n}\n\n\n//===============================================================\n// FlowsActors_Agent Constraint Types (Task 1)\n// For prompt-level prohibitions with precedence + violation handling\n//===============================================================\n\nexport enum FlowsActors_Agent_ConstraintType {\n  SECURITY = \"security\",      // Never reveal API keys, never execute arbitrary code\n  SAFETY = \"safety\",          // Refuse harmful requests\n  PRIVACY = \"privacy\",        // Handle PII appropriately\n  SCOPE = \"scope\",            // Stay within task boundaries\n  COMPLIANCE = \"compliance\",  // Regulatory constraints\n}\n\n\n//===============================================================\n// FlowsActors_Agent Constraint Schema (Task 2)\n//===============================================================\n\nexport const FlowsActors_Agent_ConstraintSchema = z.object({\n  /** Unique constraint identifier */\n  id: z.string(),\n  /** The constraint text (prohibition) */\n  text: z.string(),\n  /** Constraint category */\n  type: z.enum(FlowsActors_Agent_ConstraintType),\n  /** Action on violation */\n  onViolation: z.enum([\"refuse\", \"warn\", \"log\"]).default(\"refuse\"),\n});\n\nexport type FlowsActors_Agent_Constraint = z.infer<typeof FlowsActors_Agent_ConstraintSchema>;\n\n\n//===============================================================\n// FlowsActors_Agent Output Specification Schema (Task 3)\n// REUSES: FlowsActors_IO_PartKind, AppsBlueprint_FileFormat, FlowsActors_Agent_Verbosity\n//===============================================================\n\nexport const FlowsActors_Agent_OutputSpecSchema = z.object({\n  /**\n   * Output type classification\n   * REUSES: FlowsActors_IO_PartKind (TEXT, FILE, RAW_DATA, STRUCTURED)\n   */\n  type: z.enum(FlowsActors_IO_PartKind).optional(),\n\n  /**\n   * File format hint (for FILE type or text formatting guidance)\n   * REUSES: AppsBlueprint_FileFormat (TEXT, TYPESCRIPT, MARKDOWN, JSON, YAML, etc.)\n   */\n  fileFormat: z.enum(AppsBlueprint_FileFormat).optional(),\n\n  /**\n   * Length guidance - overrides style.verbosity for output specifically\n   * REUSES: FlowsActors_Agent_Verbosity (LOW=concise, MEDIUM=moderate, HIGH=detailed)\n   */\n  lengthGuidance: z.enum(FlowsActors_Agent_Verbosity).optional(),\n\n  /** Include reasoning/explanation in output */\n  includeReasoning: z.boolean().optional(),\n\n  /** Required sections in output (e.g., [\"summary\", \"recommendations\"]) */\n  requiredSections: z.array(z.string()).optional(),\n});\n\nexport type FlowsActors_Agent_OutputSpec = z.infer<typeof FlowsActors_Agent_OutputSpecSchema>;\n\n\n//===============================================================\n// FlowsActors_Agent Uncertainty Policy (Task 4)\n// How to handle ambiguity in agent execution\n//===============================================================\n\nexport enum FlowsActors_Agent_UncertaintyPolicy {\n  ASK = \"ask\",                    // Ask for clarification\n  INFER = \"infer\",                // Make reasonable inferences\n  CONSERVATIVE = \"conservative\",  // Choose safest option\n  FAIL = \"fail\",                  // Return error on uncertainty\n}\n\n\n//===============================================================\n// FlowsActors_Agent Uncertainty Schema (Task 5)\n//===============================================================\n\nexport const FlowsActors_Agent_UncertaintySchema = z.object({\n  /** Policy when agent is uncertain */\n  policy: z.enum(FlowsActors_Agent_UncertaintyPolicy).default(FlowsActors_Agent_UncertaintyPolicy.ASK),\n  /** Confidence threshold (0-1) below which to apply policy */\n  confidenceThreshold: z.number().min(0).max(1).optional(),\n});\n\nexport type FlowsActors_Agent_Uncertainty = z.infer<typeof FlowsActors_Agent_UncertaintySchema>;\n\n\n//===============================================================\n// FlowsActors_Agent_PromptSpec (Clean Implementation)\n// Complete prompt specification - required on all agents\n// Replaces legacy skill.role/persona approach\n//===============================================================\n\n/** @wildo_source:part:start saas.models.flows-actors.agent-prompt-spec facet:kind:api facet:audience:app-developer\n *\n * The agent's prompt, authored as STRUCTURE rather than one prose blob. The\n * prompt compiler renders these fields into the provider's preferred format\n * (XML boundaries for Claude, message roles for OpenAI, …), so you never\n * hand-format a system prompt or branch on the provider yourself.\n *\n * `role` + `skillType` are the only required fields — start there and add the\n * rest as the behavior needs them. Precedence when the model must choose:\n * `constraints` (prohibitions — highest) > `instructions` (hard rules) >\n * `hints` (soft preferences). Keep the per-call task in the invocation's\n * `input.prompt`; keep everything durable about the agent here.\n */\nexport const FlowsActors_Agent_PromptSpecSchema = z.object({\n  //====================\n  // IDENTITY (migrated from legacy skill)\n  //====================\n\n  /**\n   * Agent's role description\n   * Explains what this agent does and its primary function\n   */\n  role: z.string(),\n\n  /**\n   * Agent's persona/character\n   * Defines the agent's personality, expertise, and communication approach\n   */\n  persona: z.string().optional(),\n\n  /**\n   * Agent skill type - determines baseline behavioral instructions\n   */\n  skillType: z.enum(FlowsActors_Agent_Skill_Type),\n\n  //====================\n  // CONSTRAINTS (highest precedence)\n  //====================\n\n  /**\n   * Constraints - HIGHEST precedence, never violate\n   * Different from instructions: constraints are prohibitions, instructions are rules\n   */\n  constraints: z.array(FlowsActors_Agent_ConstraintSchema).optional(),\n\n  //====================\n  // GOAL\n  //====================\n\n  /**\n   * Goal statement - what the agent aims to achieve\n   * Single sentence describing success criteria\n   */\n  goal: z.string().optional(),\n\n  //====================\n  // OUTPUT SPECIFICATION\n  //====================\n\n  /**\n   * Output specification - format and structure requirements\n   */\n  output: FlowsActors_Agent_OutputSpecSchema.optional(),\n\n  //====================\n  // INSTRUCTIONS & HINTS\n  //====================\n\n  /** Hard rules - behavioral instructions (in addition to skill type baseline) */\n  instructions: z.array(z.string()).default([]),\n\n  /** Soft hints - preferences, can be overridden by task constraints */\n  hints: z.array(z.string()).optional(),\n\n  //====================\n  // UNCERTAINTY HANDLING\n  //====================\n\n  /**\n   * Uncertainty handling policy\n   */\n  uncertainty: FlowsActors_Agent_UncertaintySchema.optional(),\n\n  //====================\n  // SCOPE BOUNDARIES\n  //====================\n\n  /**\n   * Scope boundaries - explicit \"don't do\" statements\n   * Helps prevent scope creep\n   */\n  outOfScope: z.array(z.string()).optional(),\n\n  //====================\n  // EXAMPLES (few-shot)\n  //====================\n\n  /**\n   * Examples - few-shot examples for better output quality\n   * Format: input/output pairs with optional explanation\n   */\n  examples: z.array(z.object({\n    input: z.string(),\n    output: z.string(),\n    explanation: z.string().optional(),\n  })).optional(),\n\n  //====================\n  // STYLE\n  //====================\n\n  /** Style preferences */\n  style: z.object({\n    verbosity: z.enum(FlowsActors_Agent_Verbosity).optional(),\n    tone: z.enum(FlowsActors_Agent_Tone).optional(),\n  }).optional(),\n\n  //====================\n  // CONTEXT CURATION\n  //====================\n\n  /** Context curation settings */\n  curation: z.object({\n    /** Maximum context items to include */\n    maxItems: z.number().min(1).max(100).optional(),\n    /** Minimum relevance score threshold (0-1) */\n    minRelevance: z.number().min(0).max(1).optional(),\n    /** Maximum total tokens for context */\n    maxTokens: z.number().optional(),\n  }).optional(),\n\n  //====================\n  // FORMAT & METADATA\n  //====================\n\n  /** Override provider's default prompt format */\n  promptFormatOverride: z.enum(LLMProvider_PromptFormat).optional(),\n\n  /**\n   * Prompt specification metadata for versioning and tracking\n   * Helps track prompt iterations and authorship for 200+ agents\n   */\n  metadata: z.object({\n    /** Semantic version of this prompt spec (e.g., \"1.2.0\") */\n    version: z.string().optional(),\n    /** Last modification date (ISO 8601) */\n    lastModified: z.string().optional(),\n    /** Author or team responsible */\n    author: z.string().optional(),\n    /** Brief changelog or reason for current version */\n    changelog: z.string().optional(),\n  }).optional(),\n});\n\nexport type FlowsActors_Agent_PromptSpec = z.infer<typeof FlowsActors_Agent_PromptSpecSchema>;\n/** @wildo_source:part:end saas.models.flows-actors.agent-prompt-spec */\n\n\n//===============================================================\n// FlowsActors_Agent Schema (Clean Implementation)\n// FlowsActors_Agents are AI-powered entities with specific roles and capabilities\n// They are called by Flow Steps (AGENT_CALL) and Actors (AGENTIC mode)\n//===============================================================\n\n/** @wildo_source:part:start saas.models.flows-actors.agent-definition facet:kind:api facet:audience:app-developer\n *\n * A callable AI unit. This is the whole authoring surface for \"give my app an\n * LLM capability\": author one of these, register it on your backend module's\n * `flowsActors.agents`, then invoke it by `ref`.\n *\n * The definition is DECLARATIVE and durable — provider, model, operation, and\n * prompt live here; the per-call task lives in the invocation. Nothing about\n * transport, retries, rate limiting, usage accounting, or tracing is yours to\n * write: the engine owns all of it once the agent is registered.\n *\n * Import path: `@wildo-ai/saas-models`.\n */\nexport type FlowsActors_Agent = {\n  //====================\n  // IDENTITY\n  //====================\n\n  /** Unique agent reference for flow/actor calls */\n  ref: string,\n\n  /** Human-readable display name */\n  displayName: string,\n\n  /** Agent lifecycle status */\n  status: FlowsActors_Agent_Status,\n\n  //====================\n  // EXECUTION CONFIGURATION (modality-discriminated)\n  //====================\n\n  /** Provider/model config, discriminated by modality (LLM/text | image | coding). */\n  config: FlowsActors_Agent_Configuration,\n\n  /** Operation definition (input/output schemas, etc.), per transport family. */\n  operationDefinition: LLMProvider_OperationDefinitionBase | ImageProvider_OperationDefinitionBase | CodingAgent_OperationDefinitionBase,\n\n  //====================\n  // ARTIFACT MODALITY (optional — explicit override; else derived from config)\n  //====================\n\n  /**\n   * The modality this agent PRODUCES. Optional: when omitted the executor\n   * derives it from `config` (LLM keys → TEXT/STRUCTURED, image key → IMAGE).\n   * Set explicitly to make a multimodal agent's output self-describing.\n   */\n  outputModality?: FlowsActors_IO_PartKind,\n\n  /** The modalities this agent CONSUMES (e.g. `[TEXT]` for text-to-image). */\n  inputModalities?: FlowsActors_IO_PartKind[],\n\n  //====================\n  // PROMPT SPECIFICATION (required)\n  //====================\n\n  /**\n   * Complete prompt specification\n   * Defines role, persona, constraints, instructions, output format, etc.\n   */\n  promptSpec: FlowsActors_Agent_PromptSpec,\n\n  //====================\n  // CAPABILITIES\n  //====================\n\n  /** Agent capabilities (tools, etc.) */\n  capabilities?: {\n    tools?: {\n      /** References to callable functions */\n      functionRefs: string[],\n      /** References to MCP servers */\n      mcpRefs: string[],\n    },\n  },\n\n  //====================\n  // VERSIONING\n  //====================\n\n  /** Agent definition version */\n  version?: string,\n\n  /** Creation timestamp (ISO 8601) */\n  createdAt: string,\n\n  /** Last update timestamp (ISO 8601) */\n  updatedAt?: string,\n};\n/** @wildo_source:part:end saas.models.flows-actors.agent-definition */\n\n\n/** @wildo_source:part:start saas.models.flows-actors.agent-invocation facet:kind:api facet:audience:app-developer\n *\n * One call to one agent — the envelope you build and hand to\n * `AgentsBackendService.invokeAgent`, and the SAME shape you get back with\n * `output` and `executionContext` filled in.\n *\n * What you supply:\n * - `agentRef` — the `ref` of a registered agent (unknown ref throws).\n * - `input` — the per-call task. `{ prompt }` for text; add `{ schema }` (a Zod\n *   schema) for `GENERATE_STRUCTURED`, which REQUIRES it. Anything else you put\n *   here is JSON-serialized into the user prompt.\n * - `output` — an empty value of the expected shape (`{ text: '' }`,\n *   `{ object: {} }`). It is a typing seed; the returned envelope replaces it.\n * - `initiator` / `invocationContext` / `artifactBindings` — `{}` / `[]` / `[]`\n *   when you have nothing to correlate.\n *\n * What comes back: `output` normalized to the operation's shape, and\n * `executionContext` enriched with `executionTime`, `finishedAt`, and provider\n * `usage` (tokens) when the transport reports it.\n *\n * Import path: `@wildo-ai/saas-models`.\n */\nexport type FlowsActors_Agent_Invocation<\n  InputSchema extends z.ZodSchema<any> = z.ZodSchema<any>,\n  OutputSchema extends z.ZodSchema<any> = z.ZodSchema<any>,\n  ContextSchema extends z.ZodSchema<any> = z.ZodSchema<any>,\n> = {\n  _id?: string,\n  agentRef: string,\n  initiator: ExecutionContext_InitiatorIds,\n  invocationContext : FlowsActors_Relationship[],\n\n  input: z.infer<InputSchema>,\n  output: z.infer<OutputSchema>,\n  executionContext: z.infer<ContextSchema>,\n  artifactBindings: {\n    kind: FlowsActors_IO_PartKind,\n    ref: string,\n  }[],\n\n};\n/** @wildo_source:part:end saas.models.flows-actors.agent-invocation */\n"]}

package/dist/esm/flows-actors/apps-blueprint/apps-blueprint-agent-personas.shared.enums.d.ts

@@ -0,0 +1,19 @@
+/** Closed actor-persona vocabulary shared by Apps Blueprint and playbook authoring. */
+export declare enum AppsBlueprint_AgentPersonas {
+    CUSTOM_CODE_EDITOR = "apps_blueprint.custom_code_editor",
+    CUSTOM_CODE_REVIEWER = "apps_blueprint.custom_code_reviewer",
+    RESOURCES_CODE_EDITOR = "apps_blueprint.resources_code_editor",
+    RESOURCES_CODE_REVIEWER = "apps_blueprint.resources_code_reviewer",
+    TASK_ENHANCER = "apps_blueprint.tasks_enhancer",
+    MARKETING_STRATEGIST = "apps_blueprint.marketing_strategist",
+    BRAINSTORMER = "apps_blueprint.brainstormer",
+    CONTENT_WRITER = "apps_blueprint.content_writer",
+    TASK_PLANNER = "apps_blueprint.task_planner",
+    APP_CONFIGURATOR = "apps_blueprint.app_configurator",
+    BILLING_STRATEGIST = "apps_blueprint.billing_strategist",
+    CODE_CHANGE_REACTOR = "apps_blueprint.actor.code_change_reactor",
+    VALIDATION_REACTOR = "apps_blueprint.actor.validation_reactor",
+    DEPENDENCY_ANALYZER = "apps_blueprint.actor.dependency_analyzer"
+}
+export declare const AppsBlueprintFlowAgentPersona_Descriptions: Record<AppsBlueprint_AgentPersonas, string>;
+//# sourceMappingURL=apps-blueprint-agent-personas.shared.enums.d.ts.map

package/dist/esm/flows-actors/apps-blueprint/apps-blueprint-agent-personas.shared.enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps-blueprint-agent-personas.shared.enums.d.ts","sourceRoot":"","sources":["../../../../../src/flows-actors/apps-blueprint/apps-blueprint-agent-personas.shared.enums.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,oBAAY,2BAA2B;IACrC,kBAAkB,sCAAsC;IACxD,oBAAoB,wCAAwC;IAC5D,qBAAqB,yCAAyC;IAC9D,uBAAuB,2CAA2C;IAClE,aAAa,kCAAkC;IAC/C,oBAAoB,wCAAwC;IAC5D,YAAY,gCAAgC;IAC5C,cAAc,kCAAkC;IAChD,YAAY,gCAAgC;IAC5C,gBAAgB,oCAAoC;IACpD,kBAAkB,sCAAsC;IACxD,mBAAmB,6CAA6C;IAChE,kBAAkB,4CAA4C;IAC9D,mBAAmB,6CAA6C;CACjE;AAED,eAAO,MAAM,0CAA0C,EAAE,MAAM,CAAC,2BAA2B,EAAE,MAAM,CAelG,CAAC"}

package/dist/esm/flows-actors/apps-blueprint/apps-blueprint-agent-personas.shared.enums.js

@@ -0,0 +1,35 @@
+/** Closed actor-persona vocabulary shared by Apps Blueprint and playbook authoring. */
+export var AppsBlueprint_AgentPersonas;
+(function (AppsBlueprint_AgentPersonas) {
+    AppsBlueprint_AgentPersonas["CUSTOM_CODE_EDITOR"] = "apps_blueprint.custom_code_editor";
+    AppsBlueprint_AgentPersonas["CUSTOM_CODE_REVIEWER"] = "apps_blueprint.custom_code_reviewer";
+    AppsBlueprint_AgentPersonas["RESOURCES_CODE_EDITOR"] = "apps_blueprint.resources_code_editor";
+    AppsBlueprint_AgentPersonas["RESOURCES_CODE_REVIEWER"] = "apps_blueprint.resources_code_reviewer";
+    AppsBlueprint_AgentPersonas["TASK_ENHANCER"] = "apps_blueprint.tasks_enhancer";
+    AppsBlueprint_AgentPersonas["MARKETING_STRATEGIST"] = "apps_blueprint.marketing_strategist";
+    AppsBlueprint_AgentPersonas["BRAINSTORMER"] = "apps_blueprint.brainstormer";
+    AppsBlueprint_AgentPersonas["CONTENT_WRITER"] = "apps_blueprint.content_writer";
+    AppsBlueprint_AgentPersonas["TASK_PLANNER"] = "apps_blueprint.task_planner";
+    AppsBlueprint_AgentPersonas["APP_CONFIGURATOR"] = "apps_blueprint.app_configurator";
+    AppsBlueprint_AgentPersonas["BILLING_STRATEGIST"] = "apps_blueprint.billing_strategist";
+    AppsBlueprint_AgentPersonas["CODE_CHANGE_REACTOR"] = "apps_blueprint.actor.code_change_reactor";
+    AppsBlueprint_AgentPersonas["VALIDATION_REACTOR"] = "apps_blueprint.actor.validation_reactor";
+    AppsBlueprint_AgentPersonas["DEPENDENCY_ANALYZER"] = "apps_blueprint.actor.dependency_analyzer";
+})(AppsBlueprint_AgentPersonas || (AppsBlueprint_AgentPersonas = {}));
+export const AppsBlueprintFlowAgentPersona_Descriptions = {
+    [AppsBlueprint_AgentPersonas.CUSTOM_CODE_EDITOR]: "Generates custom TypeScript/React code in orchestrated flows",
+    [AppsBlueprint_AgentPersonas.CUSTOM_CODE_REVIEWER]: "Reviews custom code in orchestrated flows",
+    [AppsBlueprint_AgentPersonas.RESOURCES_CODE_EDITOR]: "Generates resource configurations in orchestrated flows",
+    [AppsBlueprint_AgentPersonas.RESOURCES_CODE_REVIEWER]: "Reviews resource configurations in orchestrated flows",
+    [AppsBlueprint_AgentPersonas.TASK_ENHANCER]: "Enhances user requests in orchestrated flows",
+    [AppsBlueprint_AgentPersonas.MARKETING_STRATEGIST]: "Develops marketing strategies in orchestrated flows",
+    [AppsBlueprint_AgentPersonas.BRAINSTORMER]: "Brainstorms ideas in orchestrated flows",
+    [AppsBlueprint_AgentPersonas.CONTENT_WRITER]: "Writes content in orchestrated flows",
+    [AppsBlueprint_AgentPersonas.TASK_PLANNER]: "Plans tasks in orchestrated flows",
+    [AppsBlueprint_AgentPersonas.APP_CONFIGURATOR]: "Configures apps in orchestrated flows",
+    [AppsBlueprint_AgentPersonas.BILLING_STRATEGIST]: "Develops billing strategies in orchestrated flows",
+    [AppsBlueprint_AgentPersonas.CODE_CHANGE_REACTOR]: "Reacts to code changes and generates related updates",
+    [AppsBlueprint_AgentPersonas.VALIDATION_REACTOR]: "Reacts to code generation and validates output",
+    [AppsBlueprint_AgentPersonas.DEPENDENCY_ANALYZER]: "Reacts to resource changes and analyzes dependencies",
+};
+//# sourceMappingURL=apps-blueprint-agent-personas.shared.enums.js.map

package/dist/esm/flows-actors/apps-blueprint/apps-blueprint-agent-personas.shared.enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps-blueprint-agent-personas.shared.enums.js","sourceRoot":"","sources":["../../../../../src/flows-actors/apps-blueprint/apps-blueprint-agent-personas.shared.enums.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,CAAN,IAAY,2BAeX;AAfD,WAAY,2BAA2B;IACrC,uFAAwD,CAAA;IACxD,2FAA4D,CAAA;IAC5D,6FAA8D,CAAA;IAC9D,iGAAkE,CAAA;IAClE,8EAA+C,CAAA;IAC/C,2FAA4D,CAAA;IAC5D,2EAA4C,CAAA;IAC5C,+EAAgD,CAAA;IAChD,2EAA4C,CAAA;IAC5C,mFAAoD,CAAA;IACpD,uFAAwD,CAAA;IACxD,+FAAgE,CAAA;IAChE,6FAA8D,CAAA;IAC9D,+FAAgE,CAAA;AAClE,CAAC,EAfW,2BAA2B,KAA3B,2BAA2B,QAetC;AAED,MAAM,CAAC,MAAM,0CAA0C,GAAgD;IACrG,CAAC,2BAA2B,CAAC,kBAAkB,CAAC,EAAE,8DAA8D;IAChH,CAAC,2BAA2B,CAAC,oBAAoB,CAAC,EAAE,2CAA2C;IAC/F,CAAC,2BAA2B,CAAC,qBAAqB,CAAC,EAAE,yDAAyD;IAC9G,CAAC,2BAA2B,CAAC,uBAAuB,CAAC,EAAE,uDAAuD;IAC9G,CAAC,2BAA2B,CAAC,aAAa,CAAC,EAAE,8CAA8C;IAC3F,CAAC,2BAA2B,CAAC,oBAAoB,CAAC,EAAE,qDAAqD;IACzG,CAAC,2BAA2B,CAAC,YAAY,CAAC,EAAE,yCAAyC;IACrF,CAAC,2BAA2B,CAAC,cAAc,CAAC,EAAE,sCAAsC;IACpF,CAAC,2BAA2B,CAAC,YAAY,CAAC,EAAE,mCAAmC;IAC/E,CAAC,2BAA2B,CAAC,gBAAgB,CAAC,EAAE,uCAAuC;IACvF,CAAC,2BAA2B,CAAC,kBAAkB,CAAC,EAAE,mDAAmD;IACrG,CAAC,2BAA2B,CAAC,mBAAmB,CAAC,EAAE,sDAAsD;IACzG,CAAC,2BAA2B,CAAC,kBAAkB,CAAC,EAAE,gDAAgD;IAClG,CAAC,2BAA2B,CAAC,mBAAmB,CAAC,EAAE,sDAAsD;CAC1G,CAAC","sourcesContent":["/** Closed actor-persona vocabulary shared by Apps Blueprint and playbook authoring. */\nexport enum AppsBlueprint_AgentPersonas {\n  CUSTOM_CODE_EDITOR = \"apps_blueprint.custom_code_editor\",\n  CUSTOM_CODE_REVIEWER = \"apps_blueprint.custom_code_reviewer\",\n  RESOURCES_CODE_EDITOR = \"apps_blueprint.resources_code_editor\",\n  RESOURCES_CODE_REVIEWER = \"apps_blueprint.resources_code_reviewer\",\n  TASK_ENHANCER = \"apps_blueprint.tasks_enhancer\",\n  MARKETING_STRATEGIST = \"apps_blueprint.marketing_strategist\",\n  BRAINSTORMER = \"apps_blueprint.brainstormer\",\n  CONTENT_WRITER = \"apps_blueprint.content_writer\",\n  TASK_PLANNER = \"apps_blueprint.task_planner\",\n  APP_CONFIGURATOR = \"apps_blueprint.app_configurator\",\n  BILLING_STRATEGIST = \"apps_blueprint.billing_strategist\",\n  CODE_CHANGE_REACTOR = \"apps_blueprint.actor.code_change_reactor\",\n  VALIDATION_REACTOR = \"apps_blueprint.actor.validation_reactor\",\n  DEPENDENCY_ANALYZER = \"apps_blueprint.actor.dependency_analyzer\",\n}\n\nexport const AppsBlueprintFlowAgentPersona_Descriptions: Record<AppsBlueprint_AgentPersonas, string> = {\n  [AppsBlueprint_AgentPersonas.CUSTOM_CODE_EDITOR]: \"Generates custom TypeScript/React code in orchestrated flows\",\n  [AppsBlueprint_AgentPersonas.CUSTOM_CODE_REVIEWER]: \"Reviews custom code in orchestrated flows\",\n  [AppsBlueprint_AgentPersonas.RESOURCES_CODE_EDITOR]: \"Generates resource configurations in orchestrated flows\",\n  [AppsBlueprint_AgentPersonas.RESOURCES_CODE_REVIEWER]: \"Reviews resource configurations in orchestrated flows\",\n  [AppsBlueprint_AgentPersonas.TASK_ENHANCER]: \"Enhances user requests in orchestrated flows\",\n  [AppsBlueprint_AgentPersonas.MARKETING_STRATEGIST]: \"Develops marketing strategies in orchestrated flows\",\n  [AppsBlueprint_AgentPersonas.BRAINSTORMER]: \"Brainstorms ideas in orchestrated flows\",\n  [AppsBlueprint_AgentPersonas.CONTENT_WRITER]: \"Writes content in orchestrated flows\",\n  [AppsBlueprint_AgentPersonas.TASK_PLANNER]: \"Plans tasks in orchestrated flows\",\n  [AppsBlueprint_AgentPersonas.APP_CONFIGURATOR]: \"Configures apps in orchestrated flows\",\n  [AppsBlueprint_AgentPersonas.BILLING_STRATEGIST]: \"Develops billing strategies in orchestrated flows\",\n  [AppsBlueprint_AgentPersonas.CODE_CHANGE_REACTOR]: \"Reacts to code changes and generates related updates\",\n  [AppsBlueprint_AgentPersonas.VALIDATION_REACTOR]: \"Reacts to code generation and validates output\",\n  [AppsBlueprint_AgentPersonas.DEPENDENCY_ANALYZER]: \"Reacts to resource changes and analyzes dependencies\",\n};\n"]}