skedyul 1.2.41 → 1.2.44

package/dist/schemas/agent-schema.d.ts

@@ -0,0 +1,1504 @@
+import { z } from 'zod/v4';
+/** Execution mode for tool calls - determines approval requirements */
+export type ToolExecutionMode = 'ALLOW_ALL' | 'REQUIRE_APPROVAL';
+/** Default timeout for tool call approval (1 day in milliseconds) */
+export declare const DEFAULT_APPROVAL_TIMEOUT_MS = 86400000;
+export type SystemToolBinding = {
+    kind: 'SYSTEM';
+    name: string;
+    handle?: string;
+    displayName?: string;
+    description?: string;
+    /** Execution mode: ALLOW_ALL (default) or REQUIRE_APPROVAL */
+    executionMode?: ToolExecutionMode;
+    /** Approval timeout in ms (default: 86400000 = 1 day) */
+    approvalTimeoutMs?: number;
+};
+export type AgentToolBinding = {
+    kind: 'AGENT';
+    name: string;
+    handle?: string;
+    displayName?: string;
+    description?: string;
+    /** Execution mode: ALLOW_ALL (default) or REQUIRE_APPROVAL */
+    executionMode?: ToolExecutionMode;
+    /** Approval timeout in ms (default: 86400000 = 1 day) */
+    approvalTimeoutMs?: number;
+};
+export type McpToolBinding = {
+    kind: 'MCP';
+    server: string;
+    tool: string;
+    handle?: string;
+    displayName?: string;
+    description?: string;
+    /** Execution mode: ALLOW_ALL (default) or REQUIRE_APPROVAL */
+    executionMode?: ToolExecutionMode;
+    /** Approval timeout in ms (default: 86400000 = 1 day) */
+    approvalTimeoutMs?: number;
+};
+export type ToolBinding = SystemToolBinding | AgentToolBinding | McpToolBinding;
+export interface ToolReferenceInput {
+    tool: string;
+    handle?: string;
+    name?: string;
+    description?: string;
+    /** Execution mode: ALLOW_ALL (default) or REQUIRE_APPROVAL */
+    executionMode?: ToolExecutionMode;
+    /** Approval timeout in ms (default: 86400000 = 1 day) */
+    approvalTimeoutMs?: number;
+}
+/**
+ * Parse a tool reference string into its components.
+ *
+ * Supported formats:
+ * - New colon-separated format:
+ *   - `system:crm:model:operation` → SYSTEM tool (e.g., system:crm:prospect:get)
+ *   - `system:crm:model:operation:field` → SYSTEM tool (e.g., system:crm:prospect:update:stage)
+ *   - `system:settings:key` → SYSTEM tool (e.g., system:settings:business_information)
+ *   - `system:thread:operation` → SYSTEM tool (e.g., system:thread:create)
+ *   - `system:threads:resource:operation` → SYSTEM tool (e.g., system:threads:message:create)
+ *   - `agent:handle` → AGENT tool (e.g., agent:sales-assistant)
+ *   - `app:server:tool` → MCP tool (e.g., app:hubspot:create_contact)
+ * - Legacy @-prefixed format:
+ *   - `@crm/model/operation` → SYSTEM tool with name "model_operation"
+ *   - `@agent/agent-handle` → AGENT tool with name "agent-handle"
+ *   - `@app/server/tool` → MCP tool with server and tool name
+ * - Plain string (legacy) → SYSTEM tool with name as-is
+ *
+ * @example
+ * parseToolReferenceString("system:crm:prospect:get")
+ * // → { kind: "SYSTEM", name: "system:crm:prospect:get" }
+ *
+ * parseToolReferenceString("system:threads:message:create")
+ * // → { kind: "SYSTEM", name: "system:threads:message:create" }
+ *
+ * parseToolReferenceString("agent:sales-assistant")
+ * // → { kind: "AGENT", name: "agent:sales-assistant" }
+ *
+ * parseToolReferenceString("app:hubspot:create_contact")
+ * // → { kind: "MCP", server: "hubspot", tool: "create_contact" }
+ */
+export declare function parseToolReferenceString(ref: string): {
+    kind: 'SYSTEM';
+    name: string;
+} | {
+    kind: 'AGENT';
+    name: string;
+} | {
+    kind: 'MCP';
+    server: string;
+    tool: string;
+};
+/**
+ * Parse a tool reference input (string or object) into a ToolBinding.
+ *
+ * Accepts:
+ * - String: "@crm/prospect/prospect_get" or "prospect_get"
+ * - Object: { tool: "@crm/prospect/prospect_get", handle: "custom", name: "Display Name", description: "..." }
+ *
+ * @example
+ * parseToolReference("@crm/prospect/prospect_get")
+ * // → { kind: "SYSTEM", name: "prospect_get" }
+ *
+ * parseToolReference({ tool: "@crm/prospect/prospect_update", handle: "capture_structured", name: "Capture Data", description: "..." })
+ * // → { kind: "SYSTEM", name: "prospect_update", handle: "capture_structured", displayName: "Capture Data", description: "..." }
+ */
+export declare function parseToolReference(input: string | ToolReferenceInput): ToolBinding;
+/**
+ * Parse an array of tool references into ToolBinding array.
+ * Handles mixed formats (strings and objects) in the same array.
+ */
+export declare function parseToolReferences(inputs: Array<string | ToolReferenceInput>): ToolBinding[];
+/**
+ * Tool stage - runs a system tool, MCP tool, or activity
+ * Replaces the old 'activity' type with a consistent shape
+ */
+declare const ToolStageZ: z.ZodObject<{
+    id: z.ZodString;
+    needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    if: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"tool">;
+    resource: z.ZodString;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    outputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Inline agent definition for agent stages.
+ * Contains all fields needed to configure the agent that runs in this stage.
+ */
+declare const StageAgentDefinitionZ: z.ZodObject<{
+    handle: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    system: z.ZodString;
+    personaName: z.ZodOptional<z.ZodString>;
+    persona: z.ZodOptional<z.ZodString>;
+    llmModelId: z.ZodOptional<z.ZodString>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        tool: z.ZodString;
+        handle: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            ALLOW_ALL: "ALLOW_ALL";
+            REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+        }>>;
+        approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"SYSTEM">;
+        name: z.ZodString;
+        handle: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            ALLOW_ALL: "ALLOW_ALL";
+            REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+        }>>;
+        approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"AGENT">;
+        name: z.ZodString;
+        handle: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            ALLOW_ALL: "ALLOW_ALL";
+            REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+        }>>;
+        approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"MCP">;
+        server: z.ZodString;
+        tool: z.ZodString;
+        handle: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            ALLOW_ALL: "ALLOW_ALL";
+            REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+        }>>;
+        approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>]>>>;
+    outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type StageAgentDefinition = z.infer<typeof StageAgentDefinitionZ>;
+/**
+ * Agent stage base schema (without refinement for use in discriminatedUnion)
+ */
+declare const AgentStageBaseZ: z.ZodObject<{
+    id: z.ZodString;
+    needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    if: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"agent">;
+    props: z.ZodOptional<z.ZodObject<{
+        handle: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        system: z.ZodString;
+        personaName: z.ZodOptional<z.ZodString>;
+        persona: z.ZodOptional<z.ZodString>;
+        llmModelId: z.ZodOptional<z.ZodString>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            tool: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
+            kind: z.ZodLiteral<"SYSTEM">;
+            name: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            displayName: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"AGENT">;
+            name: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            displayName: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"MCP">;
+            server: z.ZodString;
+            tool: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            displayName: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>]>]>>>;
+        outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    resource: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    outputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Agent stage - runs an agent with inline definition or external reference
+ *
+ * New format: Use `props` object with full agent definition inline
+ * Legacy format: Use `resource` string to reference an agent by handle
+ */
+declare const AgentStageZ: z.ZodObject<{
+    id: z.ZodString;
+    needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    if: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"agent">;
+    props: z.ZodOptional<z.ZodObject<{
+        handle: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        system: z.ZodString;
+        personaName: z.ZodOptional<z.ZodString>;
+        persona: z.ZodOptional<z.ZodString>;
+        llmModelId: z.ZodOptional<z.ZodString>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            tool: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
+            kind: z.ZodLiteral<"SYSTEM">;
+            name: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            displayName: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"AGENT">;
+            name: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            displayName: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"MCP">;
+            server: z.ZodString;
+            tool: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            displayName: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>]>]>>>;
+        outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    resource: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    outputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Transform stage - computes derived values without external calls
+ */
+declare const TransformStageZ: z.ZodObject<{
+    id: z.ZodString;
+    needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    if: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"transform">;
+    outputs: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Output stage - defines final output (terminal stage)
+ */
+declare const OutputStageZ: z.ZodObject<{
+    id: z.ZodString;
+    needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    if: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"output">;
+    outputs: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Union of all stage types (uses base schemas for discriminatedUnion compatibility)
+ */
+declare const StageZ: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    if: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"tool">;
+    resource: z.ZodString;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    outputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    if: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"agent">;
+    props: z.ZodOptional<z.ZodObject<{
+        handle: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        system: z.ZodString;
+        personaName: z.ZodOptional<z.ZodString>;
+        persona: z.ZodOptional<z.ZodString>;
+        llmModelId: z.ZodOptional<z.ZodString>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            tool: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
+            kind: z.ZodLiteral<"SYSTEM">;
+            name: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            displayName: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"AGENT">;
+            name: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            displayName: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"MCP">;
+            server: z.ZodString;
+            tool: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            displayName: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>]>]>>>;
+        outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    resource: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    outputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    if: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"transform">;
+    outputs: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    if: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"output">;
+    outputs: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>], "type">;
+export type ToolStage = z.infer<typeof ToolStageZ>;
+export type AgentStage = z.infer<typeof AgentStageZ>;
+export type AgentStageBase = z.infer<typeof AgentStageBaseZ>;
+export type TransformStage = z.infer<typeof TransformStageZ>;
+export type OutputStage = z.infer<typeof OutputStageZ>;
+export type Stage = z.infer<typeof StageZ>;
+export { StageAgentDefinitionZ, AgentStageBaseZ, ToolStageZ, TransformStageZ, OutputStageZ, StageZ };
+/**
+ * Legacy activity stage - use 'tool' type instead
+ * @deprecated Use ToolStageZ with type: 'tool' and resource: 'activity-name'
+ */
+declare const LegacyActivityStageZ: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"activity">;
+    activity: z.ZodString;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    outputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Legacy agent stage - use new AgentStageZ with 'resource' instead of 'agent'
+ * @deprecated Use AgentStageZ with resource: 'agent-handle'
+ */
+declare const LegacyAgentStageZ: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"agent">;
+    agent: z.ZodString;
+    prompt: z.ZodOptional<z.ZodString>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    outputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Legacy conditional stage - use 'if' on stages instead
+ * @deprecated Use 'if' property on individual stages
+ */
+declare const LegacyConditionalStageZ: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"conditional">;
+    condition: z.ZodString;
+    then: z.ZodString;
+    else: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Legacy transform stage - use new TransformStageZ with 'outputs' instead of 'set'
+ * @deprecated Use TransformStageZ with outputs: {...}
+ */
+declare const LegacyTransformStageZ: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"transform">;
+    set: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Legacy output stage - use new OutputStageZ with 'outputs' instead of 'value'
+ * @deprecated Use OutputStageZ with outputs: {...}
+ */
+declare const LegacyOutputStageZ: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"output">;
+    value: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Combined schema that accepts both new and legacy formats
+ * The runtime will normalize legacy formats to the new schema
+ */
+declare const StageWithLegacyZ: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    if: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"tool">;
+    resource: z.ZodString;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    outputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    if: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"agent">;
+    props: z.ZodOptional<z.ZodObject<{
+        handle: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        system: z.ZodString;
+        personaName: z.ZodOptional<z.ZodString>;
+        persona: z.ZodOptional<z.ZodString>;
+        llmModelId: z.ZodOptional<z.ZodString>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            tool: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
+            kind: z.ZodLiteral<"SYSTEM">;
+            name: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            displayName: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"AGENT">;
+            name: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            displayName: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"MCP">;
+            server: z.ZodString;
+            tool: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            displayName: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>]>]>>>;
+        outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    resource: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    outputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    if: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"transform">;
+    outputs: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    if: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"output">;
+    outputs: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>], "type">, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"activity">;
+    activity: z.ZodString;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    outputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"agent">;
+    agent: z.ZodString;
+    prompt: z.ZodOptional<z.ZodString>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    outputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"conditional">;
+    condition: z.ZodString;
+    then: z.ZodString;
+    else: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"transform">;
+    set: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"output">;
+    value: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>]>;
+export type LegacyActivityStage = z.infer<typeof LegacyActivityStageZ>;
+export type LegacyAgentStage = z.infer<typeof LegacyAgentStageZ>;
+export type LegacyConditionalStage = z.infer<typeof LegacyConditionalStageZ>;
+export type LegacyTransformStage = z.infer<typeof LegacyTransformStageZ>;
+export type LegacyOutputStage = z.infer<typeof LegacyOutputStageZ>;
+export type StageWithLegacy = z.infer<typeof StageWithLegacyZ>;
+/**
+ * Inline agent definition - full agent definition embedded in a multi-stage pipeline.
+ * Contains all fields needed to create/run the agent.
+ */
+declare const InlineAgentDefinitionZ: z.ZodObject<{
+    handle: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    system: z.ZodString;
+    personaName: z.ZodOptional<z.ZodString>;
+    persona: z.ZodOptional<z.ZodString>;
+    llmModelId: z.ZodOptional<z.ZodString>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        tool: z.ZodString;
+        handle: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            ALLOW_ALL: "ALLOW_ALL";
+            REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+        }>>;
+        approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"SYSTEM">;
+        name: z.ZodString;
+        handle: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            ALLOW_ALL: "ALLOW_ALL";
+            REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+        }>>;
+        approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"AGENT">;
+        name: z.ZodString;
+        handle: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            ALLOW_ALL: "ALLOW_ALL";
+            REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+        }>>;
+        approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"MCP">;
+        server: z.ZodString;
+        tool: z.ZodString;
+        handle: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            ALLOW_ALL: "ALLOW_ALL";
+            REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+        }>>;
+        approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>]>>>;
+    outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type InlineAgentDefinition = z.infer<typeof InlineAgentDefinitionZ>;
+/**
+ * Agent input option for select-type inputs.
+ */
+declare const AgentInputOptionZ: z.ZodObject<{
+    value: z.ZodString;
+    label: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Agent input field definition for UI collection.
+ * These inputs are collected from the user before the agent runs.
+ */
+declare const AgentInputFieldZ: z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodOptional<z.ZodEnum<{
+        number: "number";
+        text: "text";
+        textarea: "textarea";
+        select: "select";
+    }>>;
+    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>>>;
+    placeholder: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AgentInputOption = z.infer<typeof AgentInputOptionZ>;
+export type AgentInputField = z.infer<typeof AgentInputFieldZ>;
+/**
+ * Persona voice format configuration for message formatting rules.
+ */
+declare const PersonaVoiceFormatZ: z.ZodObject<{
+    maxChars: z.ZodOptional<z.ZodNumber>;
+    noEmojis: z.ZodOptional<z.ZodBoolean>;
+    noHyphens: z.ZodOptional<z.ZodBoolean>;
+    noBulletPoints: z.ZodOptional<z.ZodBoolean>;
+    maxQuestionsPerMessage: z.ZodOptional<z.ZodNumber>;
+    noSignOffs: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Persona voice configuration for agent message styling.
+ */
+declare const PersonaVoiceZ: z.ZodObject<{
+    style: z.ZodString;
+    format: z.ZodOptional<z.ZodObject<{
+        maxChars: z.ZodOptional<z.ZodNumber>;
+        noEmojis: z.ZodOptional<z.ZodBoolean>;
+        noHyphens: z.ZodOptional<z.ZodBoolean>;
+        noBulletPoints: z.ZodOptional<z.ZodBoolean>;
+        maxQuestionsPerMessage: z.ZodOptional<z.ZodNumber>;
+        noSignOffs: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Persona configuration for agent voice and formatting.
+ */
+declare const PersonaZ: z.ZodObject<{
+    name: z.ZodString;
+    voice: z.ZodObject<{
+        style: z.ZodString;
+        format: z.ZodOptional<z.ZodObject<{
+            maxChars: z.ZodOptional<z.ZodNumber>;
+            noEmojis: z.ZodOptional<z.ZodBoolean>;
+            noHyphens: z.ZodOptional<z.ZodBoolean>;
+            noBulletPoints: z.ZodOptional<z.ZodBoolean>;
+            maxQuestionsPerMessage: z.ZodOptional<z.ZodNumber>;
+            noSignOffs: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type PersonaVoiceFormat = z.infer<typeof PersonaVoiceFormatZ>;
+export type PersonaVoice = z.infer<typeof PersonaVoiceZ>;
+export type Persona = z.infer<typeof PersonaZ>;
+/**
+ * Respond block for explicit message output.
+ * Must have either `content` (direct message) or `instructions` (persona transformation).
+ */
+declare const RespondBlockZ: z.ZodObject<{
+    if: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+    instructions: z.ZodOptional<z.ZodString>;
+    requiresApproval: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type RespondBlock = z.infer<typeof RespondBlockZ>;
+/**
+ * Single-stage agent schema - traditional agent with system prompt and tools.
+ * This is the default agent type that runs the agentic loop.
+ */
+declare const SingleStageAgentZ: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodLiteral<"https://skedyul.com/schemas/agent/v1">>;
+    handle: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    isEnabled: z.ZodOptional<z.ZodBoolean>;
+    system: z.ZodString;
+    personaName: z.ZodOptional<z.ZodString>;
+    persona: z.ZodOptional<z.ZodString>;
+    llmModelId: z.ZodOptional<z.ZodString>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        tool: z.ZodString;
+        handle: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            ALLOW_ALL: "ALLOW_ALL";
+            REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+        }>>;
+        approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"SYSTEM">;
+        name: z.ZodString;
+        handle: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            ALLOW_ALL: "ALLOW_ALL";
+            REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+        }>>;
+        approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"AGENT">;
+        name: z.ZodString;
+        handle: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            ALLOW_ALL: "ALLOW_ALL";
+            REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+        }>>;
+        approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"MCP">;
+        server: z.ZodString;
+        tool: z.ZodString;
+        handle: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            ALLOW_ALL: "ALLOW_ALL";
+            REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+        }>>;
+        approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>]>>>;
+    inputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodOptional<z.ZodEnum<{
+            number: "number";
+            text: "text";
+            textarea: "textarea";
+            select: "select";
+        }>>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>>;
+        placeholder: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * Multi-stage agent schema - orchestrates stages with inline agent definitions.
+ *
+ * Each agent stage contains its own agent definition inline, eliminating the need
+ * for a separate agents[] array. This makes the configuration more self-contained
+ * and easier to version.
+ *
+ * Stages are executed based on their 'needs' dependencies (DAG execution).
+ * Stages with no dependencies run first, then stages whose dependencies are met
+ * run in parallel waves until all stages complete.
+ *
+ * Message output is handled via the `system:threads:message:create` tool,
+ * which the agent can call to send messages to the thread. This decouples
+ * agent reasoning from message creation, giving operators visibility into
+ * the reasoning before any message is sent.
+ */
+declare const MultiStageAgentZ: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodLiteral<"https://skedyul.com/schemas/agent/v1">>;
+    handle: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    isEnabled: z.ZodOptional<z.ZodBoolean>;
+    agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        handle: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        system: z.ZodString;
+        personaName: z.ZodOptional<z.ZodString>;
+        persona: z.ZodOptional<z.ZodString>;
+        llmModelId: z.ZodOptional<z.ZodString>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            tool: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
+            kind: z.ZodLiteral<"SYSTEM">;
+            name: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            displayName: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"AGENT">;
+            name: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            displayName: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"MCP">;
+            server: z.ZodString;
+            tool: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            displayName: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>]>]>>>;
+        outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+    stages: z.ZodArray<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodString;
+        needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        if: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"tool">;
+        resource: z.ZodString;
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        outputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        if: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"agent">;
+        props: z.ZodOptional<z.ZodObject<{
+            handle: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            system: z.ZodString;
+            personaName: z.ZodOptional<z.ZodString>;
+            persona: z.ZodOptional<z.ZodString>;
+            llmModelId: z.ZodOptional<z.ZodString>;
+            tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                tool: z.ZodString;
+                handle: z.ZodOptional<z.ZodString>;
+                name: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+                executionMode: z.ZodOptional<z.ZodEnum<{
+                    ALLOW_ALL: "ALLOW_ALL";
+                    REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+                }>>;
+                approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
+                kind: z.ZodLiteral<"SYSTEM">;
+                name: z.ZodString;
+                handle: z.ZodOptional<z.ZodString>;
+                displayName: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+                executionMode: z.ZodOptional<z.ZodEnum<{
+                    ALLOW_ALL: "ALLOW_ALL";
+                    REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+                }>>;
+                approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"AGENT">;
+                name: z.ZodString;
+                handle: z.ZodOptional<z.ZodString>;
+                displayName: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+                executionMode: z.ZodOptional<z.ZodEnum<{
+                    ALLOW_ALL: "ALLOW_ALL";
+                    REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+                }>>;
+                approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"MCP">;
+                server: z.ZodString;
+                tool: z.ZodString;
+                handle: z.ZodOptional<z.ZodString>;
+                displayName: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+                executionMode: z.ZodOptional<z.ZodEnum<{
+                    ALLOW_ALL: "ALLOW_ALL";
+                    REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+                }>>;
+                approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>]>]>>>;
+            outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+        resource: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodOptional<z.ZodString>;
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        outputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        if: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"transform">;
+        outputs: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        if: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"output">;
+        outputs: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>], "type">, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"activity">;
+        activity: z.ZodString;
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        outputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"agent">;
+        agent: z.ZodString;
+        prompt: z.ZodOptional<z.ZodString>;
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        outputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"conditional">;
+        condition: z.ZodString;
+        then: z.ZodString;
+        else: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"transform">;
+        set: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"output">;
+        value: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>]>>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            object: "object";
+            array: "array";
+        }>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    onError: z.ZodOptional<z.ZodEnum<{
+        retry: "retry";
+        fail: "fail";
+        skip: "skip";
+    }>>;
+    persona: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        voice: z.ZodObject<{
+            style: z.ZodString;
+            format: z.ZodOptional<z.ZodObject<{
+                maxChars: z.ZodOptional<z.ZodNumber>;
+                noEmojis: z.ZodOptional<z.ZodBoolean>;
+                noHyphens: z.ZodOptional<z.ZodBoolean>;
+                noBulletPoints: z.ZodOptional<z.ZodBoolean>;
+                maxQuestionsPerMessage: z.ZodOptional<z.ZodNumber>;
+                noSignOffs: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    respond: z.ZodOptional<z.ZodObject<{
+        if: z.ZodOptional<z.ZodString>;
+        content: z.ZodOptional<z.ZodString>;
+        instructions: z.ZodOptional<z.ZodString>;
+        requiresApproval: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Unified agent schema - supports both single-stage and multi-stage agents.
+ *
+ * Single-stage agents have: system, tools, persona, personaName, llmModelId
+ * Multi-stage agents have: stages, inputs, onError
+ *
+ * The presence of `stages` determines which type of agent this is.
+ */
+export declare const AgentSchemaZ: z.ZodUnion<readonly [z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodLiteral<"https://skedyul.com/schemas/agent/v1">>;
+    handle: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    isEnabled: z.ZodOptional<z.ZodBoolean>;
+    system: z.ZodString;
+    personaName: z.ZodOptional<z.ZodString>;
+    persona: z.ZodOptional<z.ZodString>;
+    llmModelId: z.ZodOptional<z.ZodString>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        tool: z.ZodString;
+        handle: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            ALLOW_ALL: "ALLOW_ALL";
+            REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+        }>>;
+        approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"SYSTEM">;
+        name: z.ZodString;
+        handle: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            ALLOW_ALL: "ALLOW_ALL";
+            REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+        }>>;
+        approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"AGENT">;
+        name: z.ZodString;
+        handle: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            ALLOW_ALL: "ALLOW_ALL";
+            REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+        }>>;
+        approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"MCP">;
+        server: z.ZodString;
+        tool: z.ZodString;
+        handle: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            ALLOW_ALL: "ALLOW_ALL";
+            REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+        }>>;
+        approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>]>>>;
+    inputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodOptional<z.ZodEnum<{
+            number: "number";
+            text: "text";
+            textarea: "textarea";
+            select: "select";
+        }>>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>>;
+        placeholder: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodLiteral<"https://skedyul.com/schemas/agent/v1">>;
+    handle: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    isEnabled: z.ZodOptional<z.ZodBoolean>;
+    agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        handle: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        system: z.ZodString;
+        personaName: z.ZodOptional<z.ZodString>;
+        persona: z.ZodOptional<z.ZodString>;
+        llmModelId: z.ZodOptional<z.ZodString>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            tool: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
+            kind: z.ZodLiteral<"SYSTEM">;
+            name: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            displayName: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"AGENT">;
+            name: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            displayName: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"MCP">;
+            server: z.ZodString;
+            tool: z.ZodString;
+            handle: z.ZodOptional<z.ZodString>;
+            displayName: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                ALLOW_ALL: "ALLOW_ALL";
+                REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+            }>>;
+            approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>]>]>>>;
+        outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+    stages: z.ZodArray<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodString;
+        needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        if: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"tool">;
+        resource: z.ZodString;
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        outputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        if: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"agent">;
+        props: z.ZodOptional<z.ZodObject<{
+            handle: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            system: z.ZodString;
+            personaName: z.ZodOptional<z.ZodString>;
+            persona: z.ZodOptional<z.ZodString>;
+            llmModelId: z.ZodOptional<z.ZodString>;
+            tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                tool: z.ZodString;
+                handle: z.ZodOptional<z.ZodString>;
+                name: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+                executionMode: z.ZodOptional<z.ZodEnum<{
+                    ALLOW_ALL: "ALLOW_ALL";
+                    REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+                }>>;
+                approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
+                kind: z.ZodLiteral<"SYSTEM">;
+                name: z.ZodString;
+                handle: z.ZodOptional<z.ZodString>;
+                displayName: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+                executionMode: z.ZodOptional<z.ZodEnum<{
+                    ALLOW_ALL: "ALLOW_ALL";
+                    REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+                }>>;
+                approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"AGENT">;
+                name: z.ZodString;
+                handle: z.ZodOptional<z.ZodString>;
+                displayName: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+                executionMode: z.ZodOptional<z.ZodEnum<{
+                    ALLOW_ALL: "ALLOW_ALL";
+                    REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+                }>>;
+                approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"MCP">;
+                server: z.ZodString;
+                tool: z.ZodString;
+                handle: z.ZodOptional<z.ZodString>;
+                displayName: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+                executionMode: z.ZodOptional<z.ZodEnum<{
+                    ALLOW_ALL: "ALLOW_ALL";
+                    REQUIRE_APPROVAL: "REQUIRE_APPROVAL";
+                }>>;
+                approvalTimeoutMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>]>]>>>;
+            outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+        resource: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodOptional<z.ZodString>;
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        outputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        if: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"transform">;
+        outputs: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        if: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"output">;
+        outputs: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>], "type">, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"activity">;
+        activity: z.ZodString;
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        outputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"agent">;
+        agent: z.ZodString;
+        prompt: z.ZodOptional<z.ZodString>;
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        outputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"conditional">;
+        condition: z.ZodString;
+        then: z.ZodString;
+        else: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"transform">;
+        set: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"output">;
+        value: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>]>>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            object: "object";
+            array: "array";
+        }>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    onError: z.ZodOptional<z.ZodEnum<{
+        retry: "retry";
+        fail: "fail";
+        skip: "skip";
+    }>>;
+    persona: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        voice: z.ZodObject<{
+            style: z.ZodString;
+            format: z.ZodOptional<z.ZodObject<{
+                maxChars: z.ZodOptional<z.ZodNumber>;
+                noEmojis: z.ZodOptional<z.ZodBoolean>;
+                noHyphens: z.ZodOptional<z.ZodBoolean>;
+                noBulletPoints: z.ZodOptional<z.ZodBoolean>;
+                maxQuestionsPerMessage: z.ZodOptional<z.ZodNumber>;
+                noSignOffs: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    respond: z.ZodOptional<z.ZodObject<{
+        if: z.ZodOptional<z.ZodString>;
+        content: z.ZodOptional<z.ZodString>;
+        instructions: z.ZodOptional<z.ZodString>;
+        requiresApproval: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>]>;
+export type SingleStageAgent = z.infer<typeof SingleStageAgentZ>;
+export type MultiStageAgent = z.infer<typeof MultiStageAgentZ>;
+export type AgentSchema = z.infer<typeof AgentSchemaZ>;
+/**
+ * Type guard to check if an agent is a multi-stage agent.
+ */
+export declare function isMultiStageAgent(agent: AgentSchema): agent is MultiStageAgent;
+/**
+ * Type guard to check if an agent is a single-stage agent.
+ */
+export declare function isSingleStageAgent(agent: AgentSchema): agent is SingleStageAgent;
+/**
+ * Define an agent with full type safety.
+ * Use this in .agent.ts files for type checking and autocomplete.
+ *
+ * @example
+ * ```typescript
+ * import { defineAgent } from 'skedyul'
+ *
+ * export default defineAgent({
+ *   handle: 'sales-assistant',
+ *   name: 'Sales Assistant',
+ *   description: 'Helps with sales inquiries and lead qualification',
+ *   system: `You are a helpful sales assistant...`,
+ *   personaName: 'Alex',
+ *   persona: `Casual and friendly tone. Short sentences. Ask one question at a time.`,
+ *   tools: ['crm_search', 'send_email'],
+ * })
+ * ```
+ */
+export declare function defineAgent(agent: AgentSchema): AgentSchema;
+export interface AgentSchemaValidationResult {
+    success: boolean;
+    data?: AgentSchema;
+    errors?: Array<{
+        path: string;
+        message: string;
+    }>;
+}
+/**
+ * Validate an agent schema and return detailed errors if invalid.
+ */
+export declare function validateAgentSchema(data: unknown): AgentSchemaValidationResult;
+/**
+ * Parse an agent schema, throwing an error if invalid.
+ */
+export declare function parseAgentSchema(data: unknown): AgentSchema;
+/**
+ * Safely parse an agent schema, returning null if invalid.
+ */
+export declare function safeParseAgentSchema(data: unknown): AgentSchema | null;
+/**
+ * Parse agent YAML content into an AgentSchema.
+ * Requires the `yaml` package to be installed.
+ */
+export declare function parseAgentYaml(yamlContent: string): Promise<AgentSchema>;
+/**
+ * Safely parse agent YAML content, returning null if invalid.
+ */
+export declare function safeParseAgentYaml(yamlContent: string): Promise<AgentSchema | null>;
+/**
+ * Serialize an AgentSchema to YAML format.
+ */
+export declare function serializeAgentToYaml(agent: AgentSchema): Promise<string>;
+/**
+ * Result of a stage execution
+ */
+export interface StageResult {
+    /** Execution status */
+    status: 'completed' | 'skipped' | 'failed';
+    /** Whether the stage was skipped due to 'if' condition being false */
+    skipped?: boolean;
+    /** Output values from the stage */
+    outputs: Record<string, unknown>;
+    /** Execution duration in milliseconds */
+    durationMs?: number;
+    /** Error message if status is 'failed' */
+    error?: string;
+}
+/**
+ * Context passed between stages in a multi-stage agent.
+ */
+export interface AgentContext {
+    /** Immutable inputs passed to the agent */
+    input: Record<string, unknown>;
+    /** Stage results indexed by stage ID */
+    stages: Record<string, StageResult>;
+}
+/**
+ * Normalize a stage from legacy format to the new unified schema.
+ * This allows gradual migration while maintaining backward compatibility.
+ */
+export declare function normalizeStage(stage: StageWithLegacy): Stage | LegacyConditionalStage;
+/**
+ * Normalize all stages in an array, converting legacy formats to new schema.
+ */
+export declare function normalizeStages(stages: StageWithLegacy[]): (Stage | LegacyConditionalStage)[];
+/**
+ * Parsed resource reference with optional version pinning.
+ *
+ * Supports formats:
+ * - `sales-clarifier` → latest version
+ * - `sales-clarifier@latest` → explicitly latest version
+ * - `sales-clarifier@v4` → pinned to version 4
+ */
+export interface ParsedResourceReference {
+    /** The agent handle without version suffix */
+    handle: string;
+    /** The pinned version number (undefined if using latest) */
+    version?: number;
+    /** Whether this reference uses the latest version */
+    isLatest: boolean;
+}
+/**
+ * Parse a resource reference string that may include version pinning.
+ *
+ * Supported formats:
+ * - `sales-clarifier` → { handle: "sales-clarifier", isLatest: true }
+ * - `sales-clarifier@latest` → { handle: "sales-clarifier", isLatest: true }
+ * - `sales-clarifier@v4` → { handle: "sales-clarifier", version: 4, isLatest: false }
+ *
+ * @example
+ * parseResourceReference("sales-clarifier")
+ * // → { handle: "sales-clarifier", isLatest: true }
+ *
+ * parseResourceReference("sales-clarifier@v4")
+ * // → { handle: "sales-clarifier", version: 4, isLatest: false }
+ *
+ * parseResourceReference("sales-clarifier@latest")
+ * // → { handle: "sales-clarifier", isLatest: true }
+ */
+export declare function parseResourceReference(resource: string): ParsedResourceReference;
+/**
+ * Format a resource reference with version pinning.
+ *
+ * @example
+ * formatResourceReference("sales-clarifier", 4)
+ * // → "sales-clarifier@v4"
+ *
+ * formatResourceReference("sales-clarifier")
+ * // → "sales-clarifier@latest"
+ */
+export declare function formatResourceReference(handle: string, version?: number): string;
+/**
+ * Pin all agent stage resources in a multi-stage agent config to specific versions.
+ * This is used during commit to lock versions for reproducibility.
+ *
+ * @param config - The agent config to update
+ * @param versionMap - Map of agent handle to version number
+ * @returns Updated config with pinned versions
+ */
+export declare function pinStageResourceVersions(config: AgentSchema, versionMap: Record<string, number>): AgentSchema;