@ailu-ai/contracts 2.0.0

package/dist/node-metadata.d.ts

@@ -0,0 +1,3096 @@
+import { z } from "zod";
+/**
+ * The SHARED CARRIER for catalog-backed graph nodes.
+ *
+ * A graph node that is a catalog COMPONENT carries `node.metadata.component =
+ * { kind, params }`; a catalog AGENT node carries `node.metadata.agent =
+ * { provider?, model?, tier?, system?, toolNames?, maxIterations?,
+ *   suspendForApproval?, approvalToolNames?, outputChannel?, outputStyle?,
+ *   contextBudget?, todosChannel?, enableFs?, resolvedMiddleware? }`.
+ *
+ * The graph editor EMITS these into `node.metadata`; the API run path READS
+ * `node.metadata` to assemble `EngineSpec.componentNodes` (kind + params) and
+ * `EngineSpec.agents` (the agent spec). Typing the carrier here keeps it
+ * end-to-end typed across the API ↔ Studio boundary even though the underlying
+ * `NodeDefinitionDto.metadata` stays an open `Record<string, unknown>`.
+ */
+/** A catalog COMPONENT carrier: a `kind` plus its parameter bag. */
+export declare const ComponentNodeMetadataSchema: z.ZodObject<{
+    /** One of `ComponentRegistry::kinds()` (e.g. "promptBuilder") or an integration name. */
+    kind: z.ZodString;
+    /** The component's parameter bag; validated by the native factory at assemble time. */
+    params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    params: Record<string, unknown>;
+    kind: string;
+}, {
+    params: Record<string, unknown>;
+    kind: string;
+}>;
+/** A catalog AGENT carrier: mirrors the engine `AgentSpec` (all fields optional in the editor). */
+export declare const AgentNodeMetadataSchema: z.ZodObject<{
+    provider: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    tier: z.ZodOptional<z.ZodEnum<["frontier", "balanced", "fast", "creative"]>>;
+    /** A custom OpenAI-compatible endpoint (`model.openaiCompatible`) and the env var naming its key. */
+    baseURL: z.ZodOptional<z.ZodString>;
+    apiKeyEnv: z.ZodOptional<z.ZodString>;
+    system: z.ZodOptional<z.ZodString>;
+    toolNames: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Each tool's description and input JSON Schema, as the LLM sees them. */
+    toolSpecs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        jsonSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description?: string | undefined;
+        jsonSchema?: Record<string, unknown> | undefined;
+    }, {
+        name: string;
+        description?: string | undefined;
+        jsonSchema?: Record<string, unknown> | undefined;
+    }>, "many">>;
+    maxIterations: z.ZodOptional<z.ZodNumber>;
+    suspendForApproval: z.ZodOptional<z.ZodBoolean>;
+    approvalToolNames: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    outputChannel: z.ZodOptional<z.ZodString>;
+    /** ADR 0014 — terse output directive on the system prompt. */
+    outputStyle: z.ZodOptional<z.ZodLiteral<"terse">>;
+    /** ADR 0014 — cap (chars) on the agent's seed message (the injected `Input`/`State` dump). */
+    contextBudget: z.ZodOptional<z.ZodNumber>;
+    /** ADR 0022/0023 — durable channel the agent's `writeTodos` list is persisted into. */
+    todosChannel: z.ZodOptional<z.ZodString>;
+    /** ADR 0030 phase 9e — channel carrying the run's multimodal input blocks. */
+    inputBlocksChannel: z.ZodOptional<z.ZodString>;
+    /** The only channels the agent is shown in its seed state (context isolation). */
+    visibleChannels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** ADR 0026 phase 11 — governed long-term memory overlay (namespace tenant-scoped). */
+    memory: z.ZodOptional<z.ZodObject<{
+        namespace: z.ZodString;
+        topK: z.ZodOptional<z.ZodNumber>;
+        recall: z.ZodOptional<z.ZodEnum<["vector", "graph", "both"]>>;
+    }, "strip", z.ZodTypeAny, {
+        namespace: string;
+        topK?: number | undefined;
+        recall?: "vector" | "graph" | "both" | undefined;
+    }, {
+        namespace: string;
+        topK?: number | undefined;
+        recall?: "vector" | "graph" | "both" | undefined;
+    }>>;
+    /** ADR 0035 phase 12 — governed skills overlay (progressive disclosure; namespace tenant-scoped). */
+    skills: z.ZodOptional<z.ZodObject<{
+        namespace: z.ZodString;
+        /** Explicit `name@version` pins — the must-apply playbooks. */
+        required: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Cap on advisory (vector-selected) skills. */
+        advisoryK: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        namespace: string;
+        required?: string[] | undefined;
+        advisoryK?: number | undefined;
+    }, {
+        namespace: string;
+        required?: string[] | undefined;
+        advisoryK?: number | undefined;
+    }>>;
+    /** ADR 0024 phase 2c/2d — opt this agent into the governed virtual filesystem tools. */
+    enableFs: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * ADR 0075 (issue #566 G3) — attach an external MCP server's tools to this agent, mid-run. The
+     * value references a tenant-owned `connector_connections` row (`provider: "mcp"`), resolved and
+     * connected at run start; every discovered tool is unconditionally `requiresApproval` (an MCP
+     * server is code Ailu does not control and cannot statically vet). Distinct from `toolNames`/
+     * `approvalToolNames` above — those are re-derived at run start to include the tools this
+     * connection discovers, since the tool set isn't known until the server is actually queried.
+     */
+    mcpConnectionId: z.ZodOptional<z.ZodString>;
+    /**
+     * Issue #566 G19 — attach one or more governed action-tool connectors to this agent, mid-run.
+     * Keyed by provider id (e.g. `"slack"`), value is a tenant-owned `connector_connections` row id.
+     * Same resolution shape as `mcpConnectionId` (control plane resolves the connection, discovers
+     * that provider's action tools, merges them into `toolNames`/`approvalToolNames` before the run
+     * reaches this carrier — the Rust engine never resolves a connection itself), generalized to a
+     * map so adding the NEXT provider (Linear, Salesforce, ...) never needs another engine field/
+     * release — only a new product-side adapter keyed into the same map.
+     */
+    actionConnections: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /**
+     * ADR 0025 phase 3d — the resolved EFFICIENCY middleware list. A discriminated union of
+     * efficiency-only kinds (compress / terse / contextBudget): a GOVERNANCE kind (redact /
+     * approvalGate / fsPolicy) fails this schema BY CONSTRUCTION, so any consumer that runs it
+     * (e.g. `readAgentMetadata`) drops the malformed agent. This is a **type-level + validation
+     * guarantee** for callers that opt to validate; it is NOT auto-applied on the persisted
+     * catalog run path today (that path reads an unvalidated carrier — the RUNTIME enforcer
+     * there is the Rust bridge, whose match only honours efficiency kinds and ignores governance
+     * kinds). The SDK's `toRustAgentConfig` throw-gate covers the in-process builder path.
+     */
+    resolvedMiddleware: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"compress">;
+    }, "strip", z.ZodTypeAny, {
+        kind: "compress";
+    }, {
+        kind: "compress";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"terse">;
+    }, "strip", z.ZodTypeAny, {
+        kind: "terse";
+    }, {
+        kind: "terse";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"contextBudget">;
+        params: z.ZodObject<{
+            chars: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            chars: number;
+        }, {
+            chars: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        params: {
+            chars: number;
+        };
+        kind: "contextBudget";
+    }, {
+        params: {
+            chars: number;
+        };
+        kind: "contextBudget";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"reflection">;
+        params: z.ZodOptional<z.ZodObject<{
+            threshold: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            threshold?: number | undefined;
+        }, {
+            threshold?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "reflection";
+        params?: {
+            threshold?: number | undefined;
+        } | undefined;
+    }, {
+        kind: "reflection";
+        params?: {
+            threshold?: number | undefined;
+        } | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"structuredOutput">;
+        params: z.ZodObject<{
+            schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            name: z.ZodOptional<z.ZodString>;
+            strict: z.ZodOptional<z.ZodBoolean>;
+            mode: z.ZodOptional<z.ZodEnum<["required", "lenient"]>>;
+            retryCap: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            schema: Record<string, unknown>;
+            strict?: boolean | undefined;
+            name?: string | undefined;
+            mode?: "required" | "lenient" | undefined;
+            retryCap?: number | undefined;
+        }, {
+            schema: Record<string, unknown>;
+            strict?: boolean | undefined;
+            name?: string | undefined;
+            mode?: "required" | "lenient" | undefined;
+            retryCap?: number | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        params: {
+            schema: Record<string, unknown>;
+            strict?: boolean | undefined;
+            name?: string | undefined;
+            mode?: "required" | "lenient" | undefined;
+            retryCap?: number | undefined;
+        };
+        kind: "structuredOutput";
+    }, {
+        params: {
+            schema: Record<string, unknown>;
+            strict?: boolean | undefined;
+            name?: string | undefined;
+            mode?: "required" | "lenient" | undefined;
+            retryCap?: number | undefined;
+        };
+        kind: "structuredOutput";
+    }>]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    provider?: string | undefined;
+    tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+    suspendForApproval?: boolean | undefined;
+    outputChannel?: string | undefined;
+    model?: string | undefined;
+    baseURL?: string | undefined;
+    apiKeyEnv?: string | undefined;
+    system?: string | undefined;
+    toolNames?: string[] | undefined;
+    toolSpecs?: {
+        name: string;
+        description?: string | undefined;
+        jsonSchema?: Record<string, unknown> | undefined;
+    }[] | undefined;
+    maxIterations?: number | undefined;
+    approvalToolNames?: string[] | undefined;
+    outputStyle?: "terse" | undefined;
+    contextBudget?: number | undefined;
+    todosChannel?: string | undefined;
+    inputBlocksChannel?: string | undefined;
+    visibleChannels?: string[] | undefined;
+    memory?: {
+        namespace: string;
+        topK?: number | undefined;
+        recall?: "vector" | "graph" | "both" | undefined;
+    } | undefined;
+    skills?: {
+        namespace: string;
+        required?: string[] | undefined;
+        advisoryK?: number | undefined;
+    } | undefined;
+    enableFs?: boolean | undefined;
+    mcpConnectionId?: string | undefined;
+    actionConnections?: Record<string, string> | undefined;
+    resolvedMiddleware?: ({
+        kind: "compress";
+    } | {
+        kind: "terse";
+    } | {
+        params: {
+            chars: number;
+        };
+        kind: "contextBudget";
+    } | {
+        kind: "reflection";
+        params?: {
+            threshold?: number | undefined;
+        } | undefined;
+    } | {
+        params: {
+            schema: Record<string, unknown>;
+            strict?: boolean | undefined;
+            name?: string | undefined;
+            mode?: "required" | "lenient" | undefined;
+            retryCap?: number | undefined;
+        };
+        kind: "structuredOutput";
+    })[] | undefined;
+}, {
+    provider?: string | undefined;
+    tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+    suspendForApproval?: boolean | undefined;
+    outputChannel?: string | undefined;
+    model?: string | undefined;
+    baseURL?: string | undefined;
+    apiKeyEnv?: string | undefined;
+    system?: string | undefined;
+    toolNames?: string[] | undefined;
+    toolSpecs?: {
+        name: string;
+        description?: string | undefined;
+        jsonSchema?: Record<string, unknown> | undefined;
+    }[] | undefined;
+    maxIterations?: number | undefined;
+    approvalToolNames?: string[] | undefined;
+    outputStyle?: "terse" | undefined;
+    contextBudget?: number | undefined;
+    todosChannel?: string | undefined;
+    inputBlocksChannel?: string | undefined;
+    visibleChannels?: string[] | undefined;
+    memory?: {
+        namespace: string;
+        topK?: number | undefined;
+        recall?: "vector" | "graph" | "both" | undefined;
+    } | undefined;
+    skills?: {
+        namespace: string;
+        required?: string[] | undefined;
+        advisoryK?: number | undefined;
+    } | undefined;
+    enableFs?: boolean | undefined;
+    mcpConnectionId?: string | undefined;
+    actionConnections?: Record<string, string> | undefined;
+    resolvedMiddleware?: ({
+        kind: "compress";
+    } | {
+        kind: "terse";
+    } | {
+        params: {
+            chars: number;
+        };
+        kind: "contextBudget";
+    } | {
+        kind: "reflection";
+        params?: {
+            threshold?: number | undefined;
+        } | undefined;
+    } | {
+        params: {
+            schema: Record<string, unknown>;
+            strict?: boolean | undefined;
+            name?: string | undefined;
+            mode?: "required" | "lenient" | undefined;
+            retryCap?: number | undefined;
+        };
+        kind: "structuredOutput";
+    })[] | undefined;
+}>;
+/**
+ * A catalog MAP-AGENTS carrier (ADR 0027 phase 4b — dynamic fan-out): run `subAgent` once per item
+ * in the `overChannel` array and collect the per-item results (in input order) into `joinAt`. The
+ * sub-agent is itself an agent carrier (same shape as a plain agent node → deepagents parity: skills,
+ * memory, fs, planning all apply to each spawn). Mirrors the engine `MapAgentSpec`.
+ */
+export declare const MapAgentNodeMetadataSchema: z.ZodObject<{
+    /** Channel holding the array of items to fan the sub-agent out over. */
+    overChannel: z.ZodString;
+    /** Channel the array of per-item results lands in (one entry per item, in input order). */
+    joinAt: z.ZodString;
+    /** The sub-agent run per item — a full agent carrier. */
+    subAgent: z.ZodObject<{
+        provider: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        tier: z.ZodOptional<z.ZodEnum<["frontier", "balanced", "fast", "creative"]>>;
+        /** A custom OpenAI-compatible endpoint (`model.openaiCompatible`) and the env var naming its key. */
+        baseURL: z.ZodOptional<z.ZodString>;
+        apiKeyEnv: z.ZodOptional<z.ZodString>;
+        system: z.ZodOptional<z.ZodString>;
+        toolNames: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Each tool's description and input JSON Schema, as the LLM sees them. */
+        toolSpecs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            jsonSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            description?: string | undefined;
+            jsonSchema?: Record<string, unknown> | undefined;
+        }, {
+            name: string;
+            description?: string | undefined;
+            jsonSchema?: Record<string, unknown> | undefined;
+        }>, "many">>;
+        maxIterations: z.ZodOptional<z.ZodNumber>;
+        suspendForApproval: z.ZodOptional<z.ZodBoolean>;
+        approvalToolNames: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        outputChannel: z.ZodOptional<z.ZodString>;
+        /** ADR 0014 — terse output directive on the system prompt. */
+        outputStyle: z.ZodOptional<z.ZodLiteral<"terse">>;
+        /** ADR 0014 — cap (chars) on the agent's seed message (the injected `Input`/`State` dump). */
+        contextBudget: z.ZodOptional<z.ZodNumber>;
+        /** ADR 0022/0023 — durable channel the agent's `writeTodos` list is persisted into. */
+        todosChannel: z.ZodOptional<z.ZodString>;
+        /** ADR 0030 phase 9e — channel carrying the run's multimodal input blocks. */
+        inputBlocksChannel: z.ZodOptional<z.ZodString>;
+        /** The only channels the agent is shown in its seed state (context isolation). */
+        visibleChannels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** ADR 0026 phase 11 — governed long-term memory overlay (namespace tenant-scoped). */
+        memory: z.ZodOptional<z.ZodObject<{
+            namespace: z.ZodString;
+            topK: z.ZodOptional<z.ZodNumber>;
+            recall: z.ZodOptional<z.ZodEnum<["vector", "graph", "both"]>>;
+        }, "strip", z.ZodTypeAny, {
+            namespace: string;
+            topK?: number | undefined;
+            recall?: "vector" | "graph" | "both" | undefined;
+        }, {
+            namespace: string;
+            topK?: number | undefined;
+            recall?: "vector" | "graph" | "both" | undefined;
+        }>>;
+        /** ADR 0035 phase 12 — governed skills overlay (progressive disclosure; namespace tenant-scoped). */
+        skills: z.ZodOptional<z.ZodObject<{
+            namespace: z.ZodString;
+            /** Explicit `name@version` pins — the must-apply playbooks. */
+            required: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /** Cap on advisory (vector-selected) skills. */
+            advisoryK: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            namespace: string;
+            required?: string[] | undefined;
+            advisoryK?: number | undefined;
+        }, {
+            namespace: string;
+            required?: string[] | undefined;
+            advisoryK?: number | undefined;
+        }>>;
+        /** ADR 0024 phase 2c/2d — opt this agent into the governed virtual filesystem tools. */
+        enableFs: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * ADR 0075 (issue #566 G3) — attach an external MCP server's tools to this agent, mid-run. The
+         * value references a tenant-owned `connector_connections` row (`provider: "mcp"`), resolved and
+         * connected at run start; every discovered tool is unconditionally `requiresApproval` (an MCP
+         * server is code Ailu does not control and cannot statically vet). Distinct from `toolNames`/
+         * `approvalToolNames` above — those are re-derived at run start to include the tools this
+         * connection discovers, since the tool set isn't known until the server is actually queried.
+         */
+        mcpConnectionId: z.ZodOptional<z.ZodString>;
+        /**
+         * Issue #566 G19 — attach one or more governed action-tool connectors to this agent, mid-run.
+         * Keyed by provider id (e.g. `"slack"`), value is a tenant-owned `connector_connections` row id.
+         * Same resolution shape as `mcpConnectionId` (control plane resolves the connection, discovers
+         * that provider's action tools, merges them into `toolNames`/`approvalToolNames` before the run
+         * reaches this carrier — the Rust engine never resolves a connection itself), generalized to a
+         * map so adding the NEXT provider (Linear, Salesforce, ...) never needs another engine field/
+         * release — only a new product-side adapter keyed into the same map.
+         */
+        actionConnections: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /**
+         * ADR 0025 phase 3d — the resolved EFFICIENCY middleware list. A discriminated union of
+         * efficiency-only kinds (compress / terse / contextBudget): a GOVERNANCE kind (redact /
+         * approvalGate / fsPolicy) fails this schema BY CONSTRUCTION, so any consumer that runs it
+         * (e.g. `readAgentMetadata`) drops the malformed agent. This is a **type-level + validation
+         * guarantee** for callers that opt to validate; it is NOT auto-applied on the persisted
+         * catalog run path today (that path reads an unvalidated carrier — the RUNTIME enforcer
+         * there is the Rust bridge, whose match only honours efficiency kinds and ignores governance
+         * kinds). The SDK's `toRustAgentConfig` throw-gate covers the in-process builder path.
+         */
+        resolvedMiddleware: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"compress">;
+        }, "strip", z.ZodTypeAny, {
+            kind: "compress";
+        }, {
+            kind: "compress";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"terse">;
+        }, "strip", z.ZodTypeAny, {
+            kind: "terse";
+        }, {
+            kind: "terse";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"contextBudget">;
+            params: z.ZodObject<{
+                chars: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                chars: number;
+            }, {
+                chars: number;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            params: {
+                chars: number;
+            };
+            kind: "contextBudget";
+        }, {
+            params: {
+                chars: number;
+            };
+            kind: "contextBudget";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"reflection">;
+            params: z.ZodOptional<z.ZodObject<{
+                threshold: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                threshold?: number | undefined;
+            }, {
+                threshold?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "reflection";
+            params?: {
+                threshold?: number | undefined;
+            } | undefined;
+        }, {
+            kind: "reflection";
+            params?: {
+                threshold?: number | undefined;
+            } | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"structuredOutput">;
+            params: z.ZodObject<{
+                schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                name: z.ZodOptional<z.ZodString>;
+                strict: z.ZodOptional<z.ZodBoolean>;
+                mode: z.ZodOptional<z.ZodEnum<["required", "lenient"]>>;
+                retryCap: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            }, {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            params: {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            };
+            kind: "structuredOutput";
+        }, {
+            params: {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            };
+            kind: "structuredOutput";
+        }>]>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        provider?: string | undefined;
+        tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+        suspendForApproval?: boolean | undefined;
+        outputChannel?: string | undefined;
+        model?: string | undefined;
+        baseURL?: string | undefined;
+        apiKeyEnv?: string | undefined;
+        system?: string | undefined;
+        toolNames?: string[] | undefined;
+        toolSpecs?: {
+            name: string;
+            description?: string | undefined;
+            jsonSchema?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        maxIterations?: number | undefined;
+        approvalToolNames?: string[] | undefined;
+        outputStyle?: "terse" | undefined;
+        contextBudget?: number | undefined;
+        todosChannel?: string | undefined;
+        inputBlocksChannel?: string | undefined;
+        visibleChannels?: string[] | undefined;
+        memory?: {
+            namespace: string;
+            topK?: number | undefined;
+            recall?: "vector" | "graph" | "both" | undefined;
+        } | undefined;
+        skills?: {
+            namespace: string;
+            required?: string[] | undefined;
+            advisoryK?: number | undefined;
+        } | undefined;
+        enableFs?: boolean | undefined;
+        mcpConnectionId?: string | undefined;
+        actionConnections?: Record<string, string> | undefined;
+        resolvedMiddleware?: ({
+            kind: "compress";
+        } | {
+            kind: "terse";
+        } | {
+            params: {
+                chars: number;
+            };
+            kind: "contextBudget";
+        } | {
+            kind: "reflection";
+            params?: {
+                threshold?: number | undefined;
+            } | undefined;
+        } | {
+            params: {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            };
+            kind: "structuredOutput";
+        })[] | undefined;
+    }, {
+        provider?: string | undefined;
+        tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+        suspendForApproval?: boolean | undefined;
+        outputChannel?: string | undefined;
+        model?: string | undefined;
+        baseURL?: string | undefined;
+        apiKeyEnv?: string | undefined;
+        system?: string | undefined;
+        toolNames?: string[] | undefined;
+        toolSpecs?: {
+            name: string;
+            description?: string | undefined;
+            jsonSchema?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        maxIterations?: number | undefined;
+        approvalToolNames?: string[] | undefined;
+        outputStyle?: "terse" | undefined;
+        contextBudget?: number | undefined;
+        todosChannel?: string | undefined;
+        inputBlocksChannel?: string | undefined;
+        visibleChannels?: string[] | undefined;
+        memory?: {
+            namespace: string;
+            topK?: number | undefined;
+            recall?: "vector" | "graph" | "both" | undefined;
+        } | undefined;
+        skills?: {
+            namespace: string;
+            required?: string[] | undefined;
+            advisoryK?: number | undefined;
+        } | undefined;
+        enableFs?: boolean | undefined;
+        mcpConnectionId?: string | undefined;
+        actionConnections?: Record<string, string> | undefined;
+        resolvedMiddleware?: ({
+            kind: "compress";
+        } | {
+            kind: "terse";
+        } | {
+            params: {
+                chars: number;
+            };
+            kind: "contextBudget";
+        } | {
+            kind: "reflection";
+            params?: {
+                threshold?: number | undefined;
+            } | undefined;
+        } | {
+            params: {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            };
+            kind: "structuredOutput";
+        })[] | undefined;
+    }>;
+    /** When true, a spawn that needs approval suspends the whole map (default false). */
+    suspendForApproval: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    joinAt: string;
+    overChannel: string;
+    subAgent: {
+        provider?: string | undefined;
+        tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+        suspendForApproval?: boolean | undefined;
+        outputChannel?: string | undefined;
+        model?: string | undefined;
+        baseURL?: string | undefined;
+        apiKeyEnv?: string | undefined;
+        system?: string | undefined;
+        toolNames?: string[] | undefined;
+        toolSpecs?: {
+            name: string;
+            description?: string | undefined;
+            jsonSchema?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        maxIterations?: number | undefined;
+        approvalToolNames?: string[] | undefined;
+        outputStyle?: "terse" | undefined;
+        contextBudget?: number | undefined;
+        todosChannel?: string | undefined;
+        inputBlocksChannel?: string | undefined;
+        visibleChannels?: string[] | undefined;
+        memory?: {
+            namespace: string;
+            topK?: number | undefined;
+            recall?: "vector" | "graph" | "both" | undefined;
+        } | undefined;
+        skills?: {
+            namespace: string;
+            required?: string[] | undefined;
+            advisoryK?: number | undefined;
+        } | undefined;
+        enableFs?: boolean | undefined;
+        mcpConnectionId?: string | undefined;
+        actionConnections?: Record<string, string> | undefined;
+        resolvedMiddleware?: ({
+            kind: "compress";
+        } | {
+            kind: "terse";
+        } | {
+            params: {
+                chars: number;
+            };
+            kind: "contextBudget";
+        } | {
+            kind: "reflection";
+            params?: {
+                threshold?: number | undefined;
+            } | undefined;
+        } | {
+            params: {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            };
+            kind: "structuredOutput";
+        })[] | undefined;
+    };
+    suspendForApproval?: boolean | undefined;
+}, {
+    joinAt: string;
+    overChannel: string;
+    subAgent: {
+        provider?: string | undefined;
+        tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+        suspendForApproval?: boolean | undefined;
+        outputChannel?: string | undefined;
+        model?: string | undefined;
+        baseURL?: string | undefined;
+        apiKeyEnv?: string | undefined;
+        system?: string | undefined;
+        toolNames?: string[] | undefined;
+        toolSpecs?: {
+            name: string;
+            description?: string | undefined;
+            jsonSchema?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        maxIterations?: number | undefined;
+        approvalToolNames?: string[] | undefined;
+        outputStyle?: "terse" | undefined;
+        contextBudget?: number | undefined;
+        todosChannel?: string | undefined;
+        inputBlocksChannel?: string | undefined;
+        visibleChannels?: string[] | undefined;
+        memory?: {
+            namespace: string;
+            topK?: number | undefined;
+            recall?: "vector" | "graph" | "both" | undefined;
+        } | undefined;
+        skills?: {
+            namespace: string;
+            required?: string[] | undefined;
+            advisoryK?: number | undefined;
+        } | undefined;
+        enableFs?: boolean | undefined;
+        mcpConnectionId?: string | undefined;
+        actionConnections?: Record<string, string> | undefined;
+        resolvedMiddleware?: ({
+            kind: "compress";
+        } | {
+            kind: "terse";
+        } | {
+            params: {
+                chars: number;
+            };
+            kind: "contextBudget";
+        } | {
+            kind: "reflection";
+            params?: {
+                threshold?: number | undefined;
+            } | undefined;
+        } | {
+            params: {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            };
+            kind: "structuredOutput";
+        })[] | undefined;
+    };
+    suspendForApproval?: boolean | undefined;
+}>;
+/**
+ * The slice of `node.metadata` the catalog carrier owns. All keys are optional;
+ * a node carries at most one (a component OR an agent OR a mapAgents fan-out).
+ * Other metadata keys are untouched.
+ */
+export declare const CatalogNodeMetadataSchema: z.ZodObject<{
+    component: z.ZodOptional<z.ZodObject<{
+        /** One of `ComponentRegistry::kinds()` (e.g. "promptBuilder") or an integration name. */
+        kind: z.ZodString;
+        /** The component's parameter bag; validated by the native factory at assemble time. */
+        params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        params: Record<string, unknown>;
+        kind: string;
+    }, {
+        params: Record<string, unknown>;
+        kind: string;
+    }>>;
+    agent: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        tier: z.ZodOptional<z.ZodEnum<["frontier", "balanced", "fast", "creative"]>>;
+        /** A custom OpenAI-compatible endpoint (`model.openaiCompatible`) and the env var naming its key. */
+        baseURL: z.ZodOptional<z.ZodString>;
+        apiKeyEnv: z.ZodOptional<z.ZodString>;
+        system: z.ZodOptional<z.ZodString>;
+        toolNames: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Each tool's description and input JSON Schema, as the LLM sees them. */
+        toolSpecs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            jsonSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            description?: string | undefined;
+            jsonSchema?: Record<string, unknown> | undefined;
+        }, {
+            name: string;
+            description?: string | undefined;
+            jsonSchema?: Record<string, unknown> | undefined;
+        }>, "many">>;
+        maxIterations: z.ZodOptional<z.ZodNumber>;
+        suspendForApproval: z.ZodOptional<z.ZodBoolean>;
+        approvalToolNames: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        outputChannel: z.ZodOptional<z.ZodString>;
+        /** ADR 0014 — terse output directive on the system prompt. */
+        outputStyle: z.ZodOptional<z.ZodLiteral<"terse">>;
+        /** ADR 0014 — cap (chars) on the agent's seed message (the injected `Input`/`State` dump). */
+        contextBudget: z.ZodOptional<z.ZodNumber>;
+        /** ADR 0022/0023 — durable channel the agent's `writeTodos` list is persisted into. */
+        todosChannel: z.ZodOptional<z.ZodString>;
+        /** ADR 0030 phase 9e — channel carrying the run's multimodal input blocks. */
+        inputBlocksChannel: z.ZodOptional<z.ZodString>;
+        /** The only channels the agent is shown in its seed state (context isolation). */
+        visibleChannels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** ADR 0026 phase 11 — governed long-term memory overlay (namespace tenant-scoped). */
+        memory: z.ZodOptional<z.ZodObject<{
+            namespace: z.ZodString;
+            topK: z.ZodOptional<z.ZodNumber>;
+            recall: z.ZodOptional<z.ZodEnum<["vector", "graph", "both"]>>;
+        }, "strip", z.ZodTypeAny, {
+            namespace: string;
+            topK?: number | undefined;
+            recall?: "vector" | "graph" | "both" | undefined;
+        }, {
+            namespace: string;
+            topK?: number | undefined;
+            recall?: "vector" | "graph" | "both" | undefined;
+        }>>;
+        /** ADR 0035 phase 12 — governed skills overlay (progressive disclosure; namespace tenant-scoped). */
+        skills: z.ZodOptional<z.ZodObject<{
+            namespace: z.ZodString;
+            /** Explicit `name@version` pins — the must-apply playbooks. */
+            required: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /** Cap on advisory (vector-selected) skills. */
+            advisoryK: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            namespace: string;
+            required?: string[] | undefined;
+            advisoryK?: number | undefined;
+        }, {
+            namespace: string;
+            required?: string[] | undefined;
+            advisoryK?: number | undefined;
+        }>>;
+        /** ADR 0024 phase 2c/2d — opt this agent into the governed virtual filesystem tools. */
+        enableFs: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * ADR 0075 (issue #566 G3) — attach an external MCP server's tools to this agent, mid-run. The
+         * value references a tenant-owned `connector_connections` row (`provider: "mcp"`), resolved and
+         * connected at run start; every discovered tool is unconditionally `requiresApproval` (an MCP
+         * server is code Ailu does not control and cannot statically vet). Distinct from `toolNames`/
+         * `approvalToolNames` above — those are re-derived at run start to include the tools this
+         * connection discovers, since the tool set isn't known until the server is actually queried.
+         */
+        mcpConnectionId: z.ZodOptional<z.ZodString>;
+        /**
+         * Issue #566 G19 — attach one or more governed action-tool connectors to this agent, mid-run.
+         * Keyed by provider id (e.g. `"slack"`), value is a tenant-owned `connector_connections` row id.
+         * Same resolution shape as `mcpConnectionId` (control plane resolves the connection, discovers
+         * that provider's action tools, merges them into `toolNames`/`approvalToolNames` before the run
+         * reaches this carrier — the Rust engine never resolves a connection itself), generalized to a
+         * map so adding the NEXT provider (Linear, Salesforce, ...) never needs another engine field/
+         * release — only a new product-side adapter keyed into the same map.
+         */
+        actionConnections: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /**
+         * ADR 0025 phase 3d — the resolved EFFICIENCY middleware list. A discriminated union of
+         * efficiency-only kinds (compress / terse / contextBudget): a GOVERNANCE kind (redact /
+         * approvalGate / fsPolicy) fails this schema BY CONSTRUCTION, so any consumer that runs it
+         * (e.g. `readAgentMetadata`) drops the malformed agent. This is a **type-level + validation
+         * guarantee** for callers that opt to validate; it is NOT auto-applied on the persisted
+         * catalog run path today (that path reads an unvalidated carrier — the RUNTIME enforcer
+         * there is the Rust bridge, whose match only honours efficiency kinds and ignores governance
+         * kinds). The SDK's `toRustAgentConfig` throw-gate covers the in-process builder path.
+         */
+        resolvedMiddleware: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"compress">;
+        }, "strip", z.ZodTypeAny, {
+            kind: "compress";
+        }, {
+            kind: "compress";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"terse">;
+        }, "strip", z.ZodTypeAny, {
+            kind: "terse";
+        }, {
+            kind: "terse";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"contextBudget">;
+            params: z.ZodObject<{
+                chars: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                chars: number;
+            }, {
+                chars: number;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            params: {
+                chars: number;
+            };
+            kind: "contextBudget";
+        }, {
+            params: {
+                chars: number;
+            };
+            kind: "contextBudget";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"reflection">;
+            params: z.ZodOptional<z.ZodObject<{
+                threshold: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                threshold?: number | undefined;
+            }, {
+                threshold?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "reflection";
+            params?: {
+                threshold?: number | undefined;
+            } | undefined;
+        }, {
+            kind: "reflection";
+            params?: {
+                threshold?: number | undefined;
+            } | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"structuredOutput">;
+            params: z.ZodObject<{
+                schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                name: z.ZodOptional<z.ZodString>;
+                strict: z.ZodOptional<z.ZodBoolean>;
+                mode: z.ZodOptional<z.ZodEnum<["required", "lenient"]>>;
+                retryCap: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            }, {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            params: {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            };
+            kind: "structuredOutput";
+        }, {
+            params: {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            };
+            kind: "structuredOutput";
+        }>]>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        provider?: string | undefined;
+        tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+        suspendForApproval?: boolean | undefined;
+        outputChannel?: string | undefined;
+        model?: string | undefined;
+        baseURL?: string | undefined;
+        apiKeyEnv?: string | undefined;
+        system?: string | undefined;
+        toolNames?: string[] | undefined;
+        toolSpecs?: {
+            name: string;
+            description?: string | undefined;
+            jsonSchema?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        maxIterations?: number | undefined;
+        approvalToolNames?: string[] | undefined;
+        outputStyle?: "terse" | undefined;
+        contextBudget?: number | undefined;
+        todosChannel?: string | undefined;
+        inputBlocksChannel?: string | undefined;
+        visibleChannels?: string[] | undefined;
+        memory?: {
+            namespace: string;
+            topK?: number | undefined;
+            recall?: "vector" | "graph" | "both" | undefined;
+        } | undefined;
+        skills?: {
+            namespace: string;
+            required?: string[] | undefined;
+            advisoryK?: number | undefined;
+        } | undefined;
+        enableFs?: boolean | undefined;
+        mcpConnectionId?: string | undefined;
+        actionConnections?: Record<string, string> | undefined;
+        resolvedMiddleware?: ({
+            kind: "compress";
+        } | {
+            kind: "terse";
+        } | {
+            params: {
+                chars: number;
+            };
+            kind: "contextBudget";
+        } | {
+            kind: "reflection";
+            params?: {
+                threshold?: number | undefined;
+            } | undefined;
+        } | {
+            params: {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            };
+            kind: "structuredOutput";
+        })[] | undefined;
+    }, {
+        provider?: string | undefined;
+        tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+        suspendForApproval?: boolean | undefined;
+        outputChannel?: string | undefined;
+        model?: string | undefined;
+        baseURL?: string | undefined;
+        apiKeyEnv?: string | undefined;
+        system?: string | undefined;
+        toolNames?: string[] | undefined;
+        toolSpecs?: {
+            name: string;
+            description?: string | undefined;
+            jsonSchema?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        maxIterations?: number | undefined;
+        approvalToolNames?: string[] | undefined;
+        outputStyle?: "terse" | undefined;
+        contextBudget?: number | undefined;
+        todosChannel?: string | undefined;
+        inputBlocksChannel?: string | undefined;
+        visibleChannels?: string[] | undefined;
+        memory?: {
+            namespace: string;
+            topK?: number | undefined;
+            recall?: "vector" | "graph" | "both" | undefined;
+        } | undefined;
+        skills?: {
+            namespace: string;
+            required?: string[] | undefined;
+            advisoryK?: number | undefined;
+        } | undefined;
+        enableFs?: boolean | undefined;
+        mcpConnectionId?: string | undefined;
+        actionConnections?: Record<string, string> | undefined;
+        resolvedMiddleware?: ({
+            kind: "compress";
+        } | {
+            kind: "terse";
+        } | {
+            params: {
+                chars: number;
+            };
+            kind: "contextBudget";
+        } | {
+            kind: "reflection";
+            params?: {
+                threshold?: number | undefined;
+            } | undefined;
+        } | {
+            params: {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            };
+            kind: "structuredOutput";
+        })[] | undefined;
+    }>>;
+    mapAgents: z.ZodOptional<z.ZodObject<{
+        /** Channel holding the array of items to fan the sub-agent out over. */
+        overChannel: z.ZodString;
+        /** Channel the array of per-item results lands in (one entry per item, in input order). */
+        joinAt: z.ZodString;
+        /** The sub-agent run per item — a full agent carrier. */
+        subAgent: z.ZodObject<{
+            provider: z.ZodOptional<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            tier: z.ZodOptional<z.ZodEnum<["frontier", "balanced", "fast", "creative"]>>;
+            /** A custom OpenAI-compatible endpoint (`model.openaiCompatible`) and the env var naming its key. */
+            baseURL: z.ZodOptional<z.ZodString>;
+            apiKeyEnv: z.ZodOptional<z.ZodString>;
+            system: z.ZodOptional<z.ZodString>;
+            toolNames: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /** Each tool's description and input JSON Schema, as the LLM sees them. */
+            toolSpecs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                jsonSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                description?: string | undefined;
+                jsonSchema?: Record<string, unknown> | undefined;
+            }, {
+                name: string;
+                description?: string | undefined;
+                jsonSchema?: Record<string, unknown> | undefined;
+            }>, "many">>;
+            maxIterations: z.ZodOptional<z.ZodNumber>;
+            suspendForApproval: z.ZodOptional<z.ZodBoolean>;
+            approvalToolNames: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            outputChannel: z.ZodOptional<z.ZodString>;
+            /** ADR 0014 — terse output directive on the system prompt. */
+            outputStyle: z.ZodOptional<z.ZodLiteral<"terse">>;
+            /** ADR 0014 — cap (chars) on the agent's seed message (the injected `Input`/`State` dump). */
+            contextBudget: z.ZodOptional<z.ZodNumber>;
+            /** ADR 0022/0023 — durable channel the agent's `writeTodos` list is persisted into. */
+            todosChannel: z.ZodOptional<z.ZodString>;
+            /** ADR 0030 phase 9e — channel carrying the run's multimodal input blocks. */
+            inputBlocksChannel: z.ZodOptional<z.ZodString>;
+            /** The only channels the agent is shown in its seed state (context isolation). */
+            visibleChannels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /** ADR 0026 phase 11 — governed long-term memory overlay (namespace tenant-scoped). */
+            memory: z.ZodOptional<z.ZodObject<{
+                namespace: z.ZodString;
+                topK: z.ZodOptional<z.ZodNumber>;
+                recall: z.ZodOptional<z.ZodEnum<["vector", "graph", "both"]>>;
+            }, "strip", z.ZodTypeAny, {
+                namespace: string;
+                topK?: number | undefined;
+                recall?: "vector" | "graph" | "both" | undefined;
+            }, {
+                namespace: string;
+                topK?: number | undefined;
+                recall?: "vector" | "graph" | "both" | undefined;
+            }>>;
+            /** ADR 0035 phase 12 — governed skills overlay (progressive disclosure; namespace tenant-scoped). */
+            skills: z.ZodOptional<z.ZodObject<{
+                namespace: z.ZodString;
+                /** Explicit `name@version` pins — the must-apply playbooks. */
+                required: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                /** Cap on advisory (vector-selected) skills. */
+                advisoryK: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                namespace: string;
+                required?: string[] | undefined;
+                advisoryK?: number | undefined;
+            }, {
+                namespace: string;
+                required?: string[] | undefined;
+                advisoryK?: number | undefined;
+            }>>;
+            /** ADR 0024 phase 2c/2d — opt this agent into the governed virtual filesystem tools. */
+            enableFs: z.ZodOptional<z.ZodBoolean>;
+            /**
+             * ADR 0075 (issue #566 G3) — attach an external MCP server's tools to this agent, mid-run. The
+             * value references a tenant-owned `connector_connections` row (`provider: "mcp"`), resolved and
+             * connected at run start; every discovered tool is unconditionally `requiresApproval` (an MCP
+             * server is code Ailu does not control and cannot statically vet). Distinct from `toolNames`/
+             * `approvalToolNames` above — those are re-derived at run start to include the tools this
+             * connection discovers, since the tool set isn't known until the server is actually queried.
+             */
+            mcpConnectionId: z.ZodOptional<z.ZodString>;
+            /**
+             * Issue #566 G19 — attach one or more governed action-tool connectors to this agent, mid-run.
+             * Keyed by provider id (e.g. `"slack"`), value is a tenant-owned `connector_connections` row id.
+             * Same resolution shape as `mcpConnectionId` (control plane resolves the connection, discovers
+             * that provider's action tools, merges them into `toolNames`/`approvalToolNames` before the run
+             * reaches this carrier — the Rust engine never resolves a connection itself), generalized to a
+             * map so adding the NEXT provider (Linear, Salesforce, ...) never needs another engine field/
+             * release — only a new product-side adapter keyed into the same map.
+             */
+            actionConnections: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            /**
+             * ADR 0025 phase 3d — the resolved EFFICIENCY middleware list. A discriminated union of
+             * efficiency-only kinds (compress / terse / contextBudget): a GOVERNANCE kind (redact /
+             * approvalGate / fsPolicy) fails this schema BY CONSTRUCTION, so any consumer that runs it
+             * (e.g. `readAgentMetadata`) drops the malformed agent. This is a **type-level + validation
+             * guarantee** for callers that opt to validate; it is NOT auto-applied on the persisted
+             * catalog run path today (that path reads an unvalidated carrier — the RUNTIME enforcer
+             * there is the Rust bridge, whose match only honours efficiency kinds and ignores governance
+             * kinds). The SDK's `toRustAgentConfig` throw-gate covers the in-process builder path.
+             */
+            resolvedMiddleware: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"compress">;
+            }, "strip", z.ZodTypeAny, {
+                kind: "compress";
+            }, {
+                kind: "compress";
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"terse">;
+            }, "strip", z.ZodTypeAny, {
+                kind: "terse";
+            }, {
+                kind: "terse";
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"contextBudget">;
+                params: z.ZodObject<{
+                    chars: z.ZodNumber;
+                }, "strip", z.ZodTypeAny, {
+                    chars: number;
+                }, {
+                    chars: number;
+                }>;
+            }, "strip", z.ZodTypeAny, {
+                params: {
+                    chars: number;
+                };
+                kind: "contextBudget";
+            }, {
+                params: {
+                    chars: number;
+                };
+                kind: "contextBudget";
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"reflection">;
+                params: z.ZodOptional<z.ZodObject<{
+                    threshold: z.ZodOptional<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    threshold?: number | undefined;
+                }, {
+                    threshold?: number | undefined;
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "reflection";
+                params?: {
+                    threshold?: number | undefined;
+                } | undefined;
+            }, {
+                kind: "reflection";
+                params?: {
+                    threshold?: number | undefined;
+                } | undefined;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"structuredOutput">;
+                params: z.ZodObject<{
+                    schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                    name: z.ZodOptional<z.ZodString>;
+                    strict: z.ZodOptional<z.ZodBoolean>;
+                    mode: z.ZodOptional<z.ZodEnum<["required", "lenient"]>>;
+                    retryCap: z.ZodOptional<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                }, {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                }>;
+            }, "strip", z.ZodTypeAny, {
+                params: {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                };
+                kind: "structuredOutput";
+            }, {
+                params: {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                };
+                kind: "structuredOutput";
+            }>]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            provider?: string | undefined;
+            tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+            suspendForApproval?: boolean | undefined;
+            outputChannel?: string | undefined;
+            model?: string | undefined;
+            baseURL?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            system?: string | undefined;
+            toolNames?: string[] | undefined;
+            toolSpecs?: {
+                name: string;
+                description?: string | undefined;
+                jsonSchema?: Record<string, unknown> | undefined;
+            }[] | undefined;
+            maxIterations?: number | undefined;
+            approvalToolNames?: string[] | undefined;
+            outputStyle?: "terse" | undefined;
+            contextBudget?: number | undefined;
+            todosChannel?: string | undefined;
+            inputBlocksChannel?: string | undefined;
+            visibleChannels?: string[] | undefined;
+            memory?: {
+                namespace: string;
+                topK?: number | undefined;
+                recall?: "vector" | "graph" | "both" | undefined;
+            } | undefined;
+            skills?: {
+                namespace: string;
+                required?: string[] | undefined;
+                advisoryK?: number | undefined;
+            } | undefined;
+            enableFs?: boolean | undefined;
+            mcpConnectionId?: string | undefined;
+            actionConnections?: Record<string, string> | undefined;
+            resolvedMiddleware?: ({
+                kind: "compress";
+            } | {
+                kind: "terse";
+            } | {
+                params: {
+                    chars: number;
+                };
+                kind: "contextBudget";
+            } | {
+                kind: "reflection";
+                params?: {
+                    threshold?: number | undefined;
+                } | undefined;
+            } | {
+                params: {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                };
+                kind: "structuredOutput";
+            })[] | undefined;
+        }, {
+            provider?: string | undefined;
+            tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+            suspendForApproval?: boolean | undefined;
+            outputChannel?: string | undefined;
+            model?: string | undefined;
+            baseURL?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            system?: string | undefined;
+            toolNames?: string[] | undefined;
+            toolSpecs?: {
+                name: string;
+                description?: string | undefined;
+                jsonSchema?: Record<string, unknown> | undefined;
+            }[] | undefined;
+            maxIterations?: number | undefined;
+            approvalToolNames?: string[] | undefined;
+            outputStyle?: "terse" | undefined;
+            contextBudget?: number | undefined;
+            todosChannel?: string | undefined;
+            inputBlocksChannel?: string | undefined;
+            visibleChannels?: string[] | undefined;
+            memory?: {
+                namespace: string;
+                topK?: number | undefined;
+                recall?: "vector" | "graph" | "both" | undefined;
+            } | undefined;
+            skills?: {
+                namespace: string;
+                required?: string[] | undefined;
+                advisoryK?: number | undefined;
+            } | undefined;
+            enableFs?: boolean | undefined;
+            mcpConnectionId?: string | undefined;
+            actionConnections?: Record<string, string> | undefined;
+            resolvedMiddleware?: ({
+                kind: "compress";
+            } | {
+                kind: "terse";
+            } | {
+                params: {
+                    chars: number;
+                };
+                kind: "contextBudget";
+            } | {
+                kind: "reflection";
+                params?: {
+                    threshold?: number | undefined;
+                } | undefined;
+            } | {
+                params: {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                };
+                kind: "structuredOutput";
+            })[] | undefined;
+        }>;
+        /** When true, a spawn that needs approval suspends the whole map (default false). */
+        suspendForApproval: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        joinAt: string;
+        overChannel: string;
+        subAgent: {
+            provider?: string | undefined;
+            tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+            suspendForApproval?: boolean | undefined;
+            outputChannel?: string | undefined;
+            model?: string | undefined;
+            baseURL?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            system?: string | undefined;
+            toolNames?: string[] | undefined;
+            toolSpecs?: {
+                name: string;
+                description?: string | undefined;
+                jsonSchema?: Record<string, unknown> | undefined;
+            }[] | undefined;
+            maxIterations?: number | undefined;
+            approvalToolNames?: string[] | undefined;
+            outputStyle?: "terse" | undefined;
+            contextBudget?: number | undefined;
+            todosChannel?: string | undefined;
+            inputBlocksChannel?: string | undefined;
+            visibleChannels?: string[] | undefined;
+            memory?: {
+                namespace: string;
+                topK?: number | undefined;
+                recall?: "vector" | "graph" | "both" | undefined;
+            } | undefined;
+            skills?: {
+                namespace: string;
+                required?: string[] | undefined;
+                advisoryK?: number | undefined;
+            } | undefined;
+            enableFs?: boolean | undefined;
+            mcpConnectionId?: string | undefined;
+            actionConnections?: Record<string, string> | undefined;
+            resolvedMiddleware?: ({
+                kind: "compress";
+            } | {
+                kind: "terse";
+            } | {
+                params: {
+                    chars: number;
+                };
+                kind: "contextBudget";
+            } | {
+                kind: "reflection";
+                params?: {
+                    threshold?: number | undefined;
+                } | undefined;
+            } | {
+                params: {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                };
+                kind: "structuredOutput";
+            })[] | undefined;
+        };
+        suspendForApproval?: boolean | undefined;
+    }, {
+        joinAt: string;
+        overChannel: string;
+        subAgent: {
+            provider?: string | undefined;
+            tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+            suspendForApproval?: boolean | undefined;
+            outputChannel?: string | undefined;
+            model?: string | undefined;
+            baseURL?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            system?: string | undefined;
+            toolNames?: string[] | undefined;
+            toolSpecs?: {
+                name: string;
+                description?: string | undefined;
+                jsonSchema?: Record<string, unknown> | undefined;
+            }[] | undefined;
+            maxIterations?: number | undefined;
+            approvalToolNames?: string[] | undefined;
+            outputStyle?: "terse" | undefined;
+            contextBudget?: number | undefined;
+            todosChannel?: string | undefined;
+            inputBlocksChannel?: string | undefined;
+            visibleChannels?: string[] | undefined;
+            memory?: {
+                namespace: string;
+                topK?: number | undefined;
+                recall?: "vector" | "graph" | "both" | undefined;
+            } | undefined;
+            skills?: {
+                namespace: string;
+                required?: string[] | undefined;
+                advisoryK?: number | undefined;
+            } | undefined;
+            enableFs?: boolean | undefined;
+            mcpConnectionId?: string | undefined;
+            actionConnections?: Record<string, string> | undefined;
+            resolvedMiddleware?: ({
+                kind: "compress";
+            } | {
+                kind: "terse";
+            } | {
+                params: {
+                    chars: number;
+                };
+                kind: "contextBudget";
+            } | {
+                kind: "reflection";
+                params?: {
+                    threshold?: number | undefined;
+                } | undefined;
+            } | {
+                params: {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                };
+                kind: "structuredOutput";
+            })[] | undefined;
+        };
+        suspendForApproval?: boolean | undefined;
+    }>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    component: z.ZodOptional<z.ZodObject<{
+        /** One of `ComponentRegistry::kinds()` (e.g. "promptBuilder") or an integration name. */
+        kind: z.ZodString;
+        /** The component's parameter bag; validated by the native factory at assemble time. */
+        params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        params: Record<string, unknown>;
+        kind: string;
+    }, {
+        params: Record<string, unknown>;
+        kind: string;
+    }>>;
+    agent: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        tier: z.ZodOptional<z.ZodEnum<["frontier", "balanced", "fast", "creative"]>>;
+        /** A custom OpenAI-compatible endpoint (`model.openaiCompatible`) and the env var naming its key. */
+        baseURL: z.ZodOptional<z.ZodString>;
+        apiKeyEnv: z.ZodOptional<z.ZodString>;
+        system: z.ZodOptional<z.ZodString>;
+        toolNames: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Each tool's description and input JSON Schema, as the LLM sees them. */
+        toolSpecs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            jsonSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            description?: string | undefined;
+            jsonSchema?: Record<string, unknown> | undefined;
+        }, {
+            name: string;
+            description?: string | undefined;
+            jsonSchema?: Record<string, unknown> | undefined;
+        }>, "many">>;
+        maxIterations: z.ZodOptional<z.ZodNumber>;
+        suspendForApproval: z.ZodOptional<z.ZodBoolean>;
+        approvalToolNames: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        outputChannel: z.ZodOptional<z.ZodString>;
+        /** ADR 0014 — terse output directive on the system prompt. */
+        outputStyle: z.ZodOptional<z.ZodLiteral<"terse">>;
+        /** ADR 0014 — cap (chars) on the agent's seed message (the injected `Input`/`State` dump). */
+        contextBudget: z.ZodOptional<z.ZodNumber>;
+        /** ADR 0022/0023 — durable channel the agent's `writeTodos` list is persisted into. */
+        todosChannel: z.ZodOptional<z.ZodString>;
+        /** ADR 0030 phase 9e — channel carrying the run's multimodal input blocks. */
+        inputBlocksChannel: z.ZodOptional<z.ZodString>;
+        /** The only channels the agent is shown in its seed state (context isolation). */
+        visibleChannels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** ADR 0026 phase 11 — governed long-term memory overlay (namespace tenant-scoped). */
+        memory: z.ZodOptional<z.ZodObject<{
+            namespace: z.ZodString;
+            topK: z.ZodOptional<z.ZodNumber>;
+            recall: z.ZodOptional<z.ZodEnum<["vector", "graph", "both"]>>;
+        }, "strip", z.ZodTypeAny, {
+            namespace: string;
+            topK?: number | undefined;
+            recall?: "vector" | "graph" | "both" | undefined;
+        }, {
+            namespace: string;
+            topK?: number | undefined;
+            recall?: "vector" | "graph" | "both" | undefined;
+        }>>;
+        /** ADR 0035 phase 12 — governed skills overlay (progressive disclosure; namespace tenant-scoped). */
+        skills: z.ZodOptional<z.ZodObject<{
+            namespace: z.ZodString;
+            /** Explicit `name@version` pins — the must-apply playbooks. */
+            required: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /** Cap on advisory (vector-selected) skills. */
+            advisoryK: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            namespace: string;
+            required?: string[] | undefined;
+            advisoryK?: number | undefined;
+        }, {
+            namespace: string;
+            required?: string[] | undefined;
+            advisoryK?: number | undefined;
+        }>>;
+        /** ADR 0024 phase 2c/2d — opt this agent into the governed virtual filesystem tools. */
+        enableFs: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * ADR 0075 (issue #566 G3) — attach an external MCP server's tools to this agent, mid-run. The
+         * value references a tenant-owned `connector_connections` row (`provider: "mcp"`), resolved and
+         * connected at run start; every discovered tool is unconditionally `requiresApproval` (an MCP
+         * server is code Ailu does not control and cannot statically vet). Distinct from `toolNames`/
+         * `approvalToolNames` above — those are re-derived at run start to include the tools this
+         * connection discovers, since the tool set isn't known until the server is actually queried.
+         */
+        mcpConnectionId: z.ZodOptional<z.ZodString>;
+        /**
+         * Issue #566 G19 — attach one or more governed action-tool connectors to this agent, mid-run.
+         * Keyed by provider id (e.g. `"slack"`), value is a tenant-owned `connector_connections` row id.
+         * Same resolution shape as `mcpConnectionId` (control plane resolves the connection, discovers
+         * that provider's action tools, merges them into `toolNames`/`approvalToolNames` before the run
+         * reaches this carrier — the Rust engine never resolves a connection itself), generalized to a
+         * map so adding the NEXT provider (Linear, Salesforce, ...) never needs another engine field/
+         * release — only a new product-side adapter keyed into the same map.
+         */
+        actionConnections: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /**
+         * ADR 0025 phase 3d — the resolved EFFICIENCY middleware list. A discriminated union of
+         * efficiency-only kinds (compress / terse / contextBudget): a GOVERNANCE kind (redact /
+         * approvalGate / fsPolicy) fails this schema BY CONSTRUCTION, so any consumer that runs it
+         * (e.g. `readAgentMetadata`) drops the malformed agent. This is a **type-level + validation
+         * guarantee** for callers that opt to validate; it is NOT auto-applied on the persisted
+         * catalog run path today (that path reads an unvalidated carrier — the RUNTIME enforcer
+         * there is the Rust bridge, whose match only honours efficiency kinds and ignores governance
+         * kinds). The SDK's `toRustAgentConfig` throw-gate covers the in-process builder path.
+         */
+        resolvedMiddleware: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"compress">;
+        }, "strip", z.ZodTypeAny, {
+            kind: "compress";
+        }, {
+            kind: "compress";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"terse">;
+        }, "strip", z.ZodTypeAny, {
+            kind: "terse";
+        }, {
+            kind: "terse";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"contextBudget">;
+            params: z.ZodObject<{
+                chars: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                chars: number;
+            }, {
+                chars: number;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            params: {
+                chars: number;
+            };
+            kind: "contextBudget";
+        }, {
+            params: {
+                chars: number;
+            };
+            kind: "contextBudget";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"reflection">;
+            params: z.ZodOptional<z.ZodObject<{
+                threshold: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                threshold?: number | undefined;
+            }, {
+                threshold?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "reflection";
+            params?: {
+                threshold?: number | undefined;
+            } | undefined;
+        }, {
+            kind: "reflection";
+            params?: {
+                threshold?: number | undefined;
+            } | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"structuredOutput">;
+            params: z.ZodObject<{
+                schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                name: z.ZodOptional<z.ZodString>;
+                strict: z.ZodOptional<z.ZodBoolean>;
+                mode: z.ZodOptional<z.ZodEnum<["required", "lenient"]>>;
+                retryCap: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            }, {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            params: {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            };
+            kind: "structuredOutput";
+        }, {
+            params: {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            };
+            kind: "structuredOutput";
+        }>]>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        provider?: string | undefined;
+        tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+        suspendForApproval?: boolean | undefined;
+        outputChannel?: string | undefined;
+        model?: string | undefined;
+        baseURL?: string | undefined;
+        apiKeyEnv?: string | undefined;
+        system?: string | undefined;
+        toolNames?: string[] | undefined;
+        toolSpecs?: {
+            name: string;
+            description?: string | undefined;
+            jsonSchema?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        maxIterations?: number | undefined;
+        approvalToolNames?: string[] | undefined;
+        outputStyle?: "terse" | undefined;
+        contextBudget?: number | undefined;
+        todosChannel?: string | undefined;
+        inputBlocksChannel?: string | undefined;
+        visibleChannels?: string[] | undefined;
+        memory?: {
+            namespace: string;
+            topK?: number | undefined;
+            recall?: "vector" | "graph" | "both" | undefined;
+        } | undefined;
+        skills?: {
+            namespace: string;
+            required?: string[] | undefined;
+            advisoryK?: number | undefined;
+        } | undefined;
+        enableFs?: boolean | undefined;
+        mcpConnectionId?: string | undefined;
+        actionConnections?: Record<string, string> | undefined;
+        resolvedMiddleware?: ({
+            kind: "compress";
+        } | {
+            kind: "terse";
+        } | {
+            params: {
+                chars: number;
+            };
+            kind: "contextBudget";
+        } | {
+            kind: "reflection";
+            params?: {
+                threshold?: number | undefined;
+            } | undefined;
+        } | {
+            params: {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            };
+            kind: "structuredOutput";
+        })[] | undefined;
+    }, {
+        provider?: string | undefined;
+        tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+        suspendForApproval?: boolean | undefined;
+        outputChannel?: string | undefined;
+        model?: string | undefined;
+        baseURL?: string | undefined;
+        apiKeyEnv?: string | undefined;
+        system?: string | undefined;
+        toolNames?: string[] | undefined;
+        toolSpecs?: {
+            name: string;
+            description?: string | undefined;
+            jsonSchema?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        maxIterations?: number | undefined;
+        approvalToolNames?: string[] | undefined;
+        outputStyle?: "terse" | undefined;
+        contextBudget?: number | undefined;
+        todosChannel?: string | undefined;
+        inputBlocksChannel?: string | undefined;
+        visibleChannels?: string[] | undefined;
+        memory?: {
+            namespace: string;
+            topK?: number | undefined;
+            recall?: "vector" | "graph" | "both" | undefined;
+        } | undefined;
+        skills?: {
+            namespace: string;
+            required?: string[] | undefined;
+            advisoryK?: number | undefined;
+        } | undefined;
+        enableFs?: boolean | undefined;
+        mcpConnectionId?: string | undefined;
+        actionConnections?: Record<string, string> | undefined;
+        resolvedMiddleware?: ({
+            kind: "compress";
+        } | {
+            kind: "terse";
+        } | {
+            params: {
+                chars: number;
+            };
+            kind: "contextBudget";
+        } | {
+            kind: "reflection";
+            params?: {
+                threshold?: number | undefined;
+            } | undefined;
+        } | {
+            params: {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            };
+            kind: "structuredOutput";
+        })[] | undefined;
+    }>>;
+    mapAgents: z.ZodOptional<z.ZodObject<{
+        /** Channel holding the array of items to fan the sub-agent out over. */
+        overChannel: z.ZodString;
+        /** Channel the array of per-item results lands in (one entry per item, in input order). */
+        joinAt: z.ZodString;
+        /** The sub-agent run per item — a full agent carrier. */
+        subAgent: z.ZodObject<{
+            provider: z.ZodOptional<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            tier: z.ZodOptional<z.ZodEnum<["frontier", "balanced", "fast", "creative"]>>;
+            /** A custom OpenAI-compatible endpoint (`model.openaiCompatible`) and the env var naming its key. */
+            baseURL: z.ZodOptional<z.ZodString>;
+            apiKeyEnv: z.ZodOptional<z.ZodString>;
+            system: z.ZodOptional<z.ZodString>;
+            toolNames: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /** Each tool's description and input JSON Schema, as the LLM sees them. */
+            toolSpecs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                jsonSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                description?: string | undefined;
+                jsonSchema?: Record<string, unknown> | undefined;
+            }, {
+                name: string;
+                description?: string | undefined;
+                jsonSchema?: Record<string, unknown> | undefined;
+            }>, "many">>;
+            maxIterations: z.ZodOptional<z.ZodNumber>;
+            suspendForApproval: z.ZodOptional<z.ZodBoolean>;
+            approvalToolNames: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            outputChannel: z.ZodOptional<z.ZodString>;
+            /** ADR 0014 — terse output directive on the system prompt. */
+            outputStyle: z.ZodOptional<z.ZodLiteral<"terse">>;
+            /** ADR 0014 — cap (chars) on the agent's seed message (the injected `Input`/`State` dump). */
+            contextBudget: z.ZodOptional<z.ZodNumber>;
+            /** ADR 0022/0023 — durable channel the agent's `writeTodos` list is persisted into. */
+            todosChannel: z.ZodOptional<z.ZodString>;
+            /** ADR 0030 phase 9e — channel carrying the run's multimodal input blocks. */
+            inputBlocksChannel: z.ZodOptional<z.ZodString>;
+            /** The only channels the agent is shown in its seed state (context isolation). */
+            visibleChannels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /** ADR 0026 phase 11 — governed long-term memory overlay (namespace tenant-scoped). */
+            memory: z.ZodOptional<z.ZodObject<{
+                namespace: z.ZodString;
+                topK: z.ZodOptional<z.ZodNumber>;
+                recall: z.ZodOptional<z.ZodEnum<["vector", "graph", "both"]>>;
+            }, "strip", z.ZodTypeAny, {
+                namespace: string;
+                topK?: number | undefined;
+                recall?: "vector" | "graph" | "both" | undefined;
+            }, {
+                namespace: string;
+                topK?: number | undefined;
+                recall?: "vector" | "graph" | "both" | undefined;
+            }>>;
+            /** ADR 0035 phase 12 — governed skills overlay (progressive disclosure; namespace tenant-scoped). */
+            skills: z.ZodOptional<z.ZodObject<{
+                namespace: z.ZodString;
+                /** Explicit `name@version` pins — the must-apply playbooks. */
+                required: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                /** Cap on advisory (vector-selected) skills. */
+                advisoryK: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                namespace: string;
+                required?: string[] | undefined;
+                advisoryK?: number | undefined;
+            }, {
+                namespace: string;
+                required?: string[] | undefined;
+                advisoryK?: number | undefined;
+            }>>;
+            /** ADR 0024 phase 2c/2d — opt this agent into the governed virtual filesystem tools. */
+            enableFs: z.ZodOptional<z.ZodBoolean>;
+            /**
+             * ADR 0075 (issue #566 G3) — attach an external MCP server's tools to this agent, mid-run. The
+             * value references a tenant-owned `connector_connections` row (`provider: "mcp"`), resolved and
+             * connected at run start; every discovered tool is unconditionally `requiresApproval` (an MCP
+             * server is code Ailu does not control and cannot statically vet). Distinct from `toolNames`/
+             * `approvalToolNames` above — those are re-derived at run start to include the tools this
+             * connection discovers, since the tool set isn't known until the server is actually queried.
+             */
+            mcpConnectionId: z.ZodOptional<z.ZodString>;
+            /**
+             * Issue #566 G19 — attach one or more governed action-tool connectors to this agent, mid-run.
+             * Keyed by provider id (e.g. `"slack"`), value is a tenant-owned `connector_connections` row id.
+             * Same resolution shape as `mcpConnectionId` (control plane resolves the connection, discovers
+             * that provider's action tools, merges them into `toolNames`/`approvalToolNames` before the run
+             * reaches this carrier — the Rust engine never resolves a connection itself), generalized to a
+             * map so adding the NEXT provider (Linear, Salesforce, ...) never needs another engine field/
+             * release — only a new product-side adapter keyed into the same map.
+             */
+            actionConnections: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            /**
+             * ADR 0025 phase 3d — the resolved EFFICIENCY middleware list. A discriminated union of
+             * efficiency-only kinds (compress / terse / contextBudget): a GOVERNANCE kind (redact /
+             * approvalGate / fsPolicy) fails this schema BY CONSTRUCTION, so any consumer that runs it
+             * (e.g. `readAgentMetadata`) drops the malformed agent. This is a **type-level + validation
+             * guarantee** for callers that opt to validate; it is NOT auto-applied on the persisted
+             * catalog run path today (that path reads an unvalidated carrier — the RUNTIME enforcer
+             * there is the Rust bridge, whose match only honours efficiency kinds and ignores governance
+             * kinds). The SDK's `toRustAgentConfig` throw-gate covers the in-process builder path.
+             */
+            resolvedMiddleware: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"compress">;
+            }, "strip", z.ZodTypeAny, {
+                kind: "compress";
+            }, {
+                kind: "compress";
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"terse">;
+            }, "strip", z.ZodTypeAny, {
+                kind: "terse";
+            }, {
+                kind: "terse";
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"contextBudget">;
+                params: z.ZodObject<{
+                    chars: z.ZodNumber;
+                }, "strip", z.ZodTypeAny, {
+                    chars: number;
+                }, {
+                    chars: number;
+                }>;
+            }, "strip", z.ZodTypeAny, {
+                params: {
+                    chars: number;
+                };
+                kind: "contextBudget";
+            }, {
+                params: {
+                    chars: number;
+                };
+                kind: "contextBudget";
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"reflection">;
+                params: z.ZodOptional<z.ZodObject<{
+                    threshold: z.ZodOptional<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    threshold?: number | undefined;
+                }, {
+                    threshold?: number | undefined;
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "reflection";
+                params?: {
+                    threshold?: number | undefined;
+                } | undefined;
+            }, {
+                kind: "reflection";
+                params?: {
+                    threshold?: number | undefined;
+                } | undefined;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"structuredOutput">;
+                params: z.ZodObject<{
+                    schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                    name: z.ZodOptional<z.ZodString>;
+                    strict: z.ZodOptional<z.ZodBoolean>;
+                    mode: z.ZodOptional<z.ZodEnum<["required", "lenient"]>>;
+                    retryCap: z.ZodOptional<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                }, {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                }>;
+            }, "strip", z.ZodTypeAny, {
+                params: {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                };
+                kind: "structuredOutput";
+            }, {
+                params: {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                };
+                kind: "structuredOutput";
+            }>]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            provider?: string | undefined;
+            tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+            suspendForApproval?: boolean | undefined;
+            outputChannel?: string | undefined;
+            model?: string | undefined;
+            baseURL?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            system?: string | undefined;
+            toolNames?: string[] | undefined;
+            toolSpecs?: {
+                name: string;
+                description?: string | undefined;
+                jsonSchema?: Record<string, unknown> | undefined;
+            }[] | undefined;
+            maxIterations?: number | undefined;
+            approvalToolNames?: string[] | undefined;
+            outputStyle?: "terse" | undefined;
+            contextBudget?: number | undefined;
+            todosChannel?: string | undefined;
+            inputBlocksChannel?: string | undefined;
+            visibleChannels?: string[] | undefined;
+            memory?: {
+                namespace: string;
+                topK?: number | undefined;
+                recall?: "vector" | "graph" | "both" | undefined;
+            } | undefined;
+            skills?: {
+                namespace: string;
+                required?: string[] | undefined;
+                advisoryK?: number | undefined;
+            } | undefined;
+            enableFs?: boolean | undefined;
+            mcpConnectionId?: string | undefined;
+            actionConnections?: Record<string, string> | undefined;
+            resolvedMiddleware?: ({
+                kind: "compress";
+            } | {
+                kind: "terse";
+            } | {
+                params: {
+                    chars: number;
+                };
+                kind: "contextBudget";
+            } | {
+                kind: "reflection";
+                params?: {
+                    threshold?: number | undefined;
+                } | undefined;
+            } | {
+                params: {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                };
+                kind: "structuredOutput";
+            })[] | undefined;
+        }, {
+            provider?: string | undefined;
+            tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+            suspendForApproval?: boolean | undefined;
+            outputChannel?: string | undefined;
+            model?: string | undefined;
+            baseURL?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            system?: string | undefined;
+            toolNames?: string[] | undefined;
+            toolSpecs?: {
+                name: string;
+                description?: string | undefined;
+                jsonSchema?: Record<string, unknown> | undefined;
+            }[] | undefined;
+            maxIterations?: number | undefined;
+            approvalToolNames?: string[] | undefined;
+            outputStyle?: "terse" | undefined;
+            contextBudget?: number | undefined;
+            todosChannel?: string | undefined;
+            inputBlocksChannel?: string | undefined;
+            visibleChannels?: string[] | undefined;
+            memory?: {
+                namespace: string;
+                topK?: number | undefined;
+                recall?: "vector" | "graph" | "both" | undefined;
+            } | undefined;
+            skills?: {
+                namespace: string;
+                required?: string[] | undefined;
+                advisoryK?: number | undefined;
+            } | undefined;
+            enableFs?: boolean | undefined;
+            mcpConnectionId?: string | undefined;
+            actionConnections?: Record<string, string> | undefined;
+            resolvedMiddleware?: ({
+                kind: "compress";
+            } | {
+                kind: "terse";
+            } | {
+                params: {
+                    chars: number;
+                };
+                kind: "contextBudget";
+            } | {
+                kind: "reflection";
+                params?: {
+                    threshold?: number | undefined;
+                } | undefined;
+            } | {
+                params: {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                };
+                kind: "structuredOutput";
+            })[] | undefined;
+        }>;
+        /** When true, a spawn that needs approval suspends the whole map (default false). */
+        suspendForApproval: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        joinAt: string;
+        overChannel: string;
+        subAgent: {
+            provider?: string | undefined;
+            tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+            suspendForApproval?: boolean | undefined;
+            outputChannel?: string | undefined;
+            model?: string | undefined;
+            baseURL?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            system?: string | undefined;
+            toolNames?: string[] | undefined;
+            toolSpecs?: {
+                name: string;
+                description?: string | undefined;
+                jsonSchema?: Record<string, unknown> | undefined;
+            }[] | undefined;
+            maxIterations?: number | undefined;
+            approvalToolNames?: string[] | undefined;
+            outputStyle?: "terse" | undefined;
+            contextBudget?: number | undefined;
+            todosChannel?: string | undefined;
+            inputBlocksChannel?: string | undefined;
+            visibleChannels?: string[] | undefined;
+            memory?: {
+                namespace: string;
+                topK?: number | undefined;
+                recall?: "vector" | "graph" | "both" | undefined;
+            } | undefined;
+            skills?: {
+                namespace: string;
+                required?: string[] | undefined;
+                advisoryK?: number | undefined;
+            } | undefined;
+            enableFs?: boolean | undefined;
+            mcpConnectionId?: string | undefined;
+            actionConnections?: Record<string, string> | undefined;
+            resolvedMiddleware?: ({
+                kind: "compress";
+            } | {
+                kind: "terse";
+            } | {
+                params: {
+                    chars: number;
+                };
+                kind: "contextBudget";
+            } | {
+                kind: "reflection";
+                params?: {
+                    threshold?: number | undefined;
+                } | undefined;
+            } | {
+                params: {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                };
+                kind: "structuredOutput";
+            })[] | undefined;
+        };
+        suspendForApproval?: boolean | undefined;
+    }, {
+        joinAt: string;
+        overChannel: string;
+        subAgent: {
+            provider?: string | undefined;
+            tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+            suspendForApproval?: boolean | undefined;
+            outputChannel?: string | undefined;
+            model?: string | undefined;
+            baseURL?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            system?: string | undefined;
+            toolNames?: string[] | undefined;
+            toolSpecs?: {
+                name: string;
+                description?: string | undefined;
+                jsonSchema?: Record<string, unknown> | undefined;
+            }[] | undefined;
+            maxIterations?: number | undefined;
+            approvalToolNames?: string[] | undefined;
+            outputStyle?: "terse" | undefined;
+            contextBudget?: number | undefined;
+            todosChannel?: string | undefined;
+            inputBlocksChannel?: string | undefined;
+            visibleChannels?: string[] | undefined;
+            memory?: {
+                namespace: string;
+                topK?: number | undefined;
+                recall?: "vector" | "graph" | "both" | undefined;
+            } | undefined;
+            skills?: {
+                namespace: string;
+                required?: string[] | undefined;
+                advisoryK?: number | undefined;
+            } | undefined;
+            enableFs?: boolean | undefined;
+            mcpConnectionId?: string | undefined;
+            actionConnections?: Record<string, string> | undefined;
+            resolvedMiddleware?: ({
+                kind: "compress";
+            } | {
+                kind: "terse";
+            } | {
+                params: {
+                    chars: number;
+                };
+                kind: "contextBudget";
+            } | {
+                kind: "reflection";
+                params?: {
+                    threshold?: number | undefined;
+                } | undefined;
+            } | {
+                params: {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                };
+                kind: "structuredOutput";
+            })[] | undefined;
+        };
+        suspendForApproval?: boolean | undefined;
+    }>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    component: z.ZodOptional<z.ZodObject<{
+        /** One of `ComponentRegistry::kinds()` (e.g. "promptBuilder") or an integration name. */
+        kind: z.ZodString;
+        /** The component's parameter bag; validated by the native factory at assemble time. */
+        params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        params: Record<string, unknown>;
+        kind: string;
+    }, {
+        params: Record<string, unknown>;
+        kind: string;
+    }>>;
+    agent: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        tier: z.ZodOptional<z.ZodEnum<["frontier", "balanced", "fast", "creative"]>>;
+        /** A custom OpenAI-compatible endpoint (`model.openaiCompatible`) and the env var naming its key. */
+        baseURL: z.ZodOptional<z.ZodString>;
+        apiKeyEnv: z.ZodOptional<z.ZodString>;
+        system: z.ZodOptional<z.ZodString>;
+        toolNames: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Each tool's description and input JSON Schema, as the LLM sees them. */
+        toolSpecs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            jsonSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            description?: string | undefined;
+            jsonSchema?: Record<string, unknown> | undefined;
+        }, {
+            name: string;
+            description?: string | undefined;
+            jsonSchema?: Record<string, unknown> | undefined;
+        }>, "many">>;
+        maxIterations: z.ZodOptional<z.ZodNumber>;
+        suspendForApproval: z.ZodOptional<z.ZodBoolean>;
+        approvalToolNames: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        outputChannel: z.ZodOptional<z.ZodString>;
+        /** ADR 0014 — terse output directive on the system prompt. */
+        outputStyle: z.ZodOptional<z.ZodLiteral<"terse">>;
+        /** ADR 0014 — cap (chars) on the agent's seed message (the injected `Input`/`State` dump). */
+        contextBudget: z.ZodOptional<z.ZodNumber>;
+        /** ADR 0022/0023 — durable channel the agent's `writeTodos` list is persisted into. */
+        todosChannel: z.ZodOptional<z.ZodString>;
+        /** ADR 0030 phase 9e — channel carrying the run's multimodal input blocks. */
+        inputBlocksChannel: z.ZodOptional<z.ZodString>;
+        /** The only channels the agent is shown in its seed state (context isolation). */
+        visibleChannels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** ADR 0026 phase 11 — governed long-term memory overlay (namespace tenant-scoped). */
+        memory: z.ZodOptional<z.ZodObject<{
+            namespace: z.ZodString;
+            topK: z.ZodOptional<z.ZodNumber>;
+            recall: z.ZodOptional<z.ZodEnum<["vector", "graph", "both"]>>;
+        }, "strip", z.ZodTypeAny, {
+            namespace: string;
+            topK?: number | undefined;
+            recall?: "vector" | "graph" | "both" | undefined;
+        }, {
+            namespace: string;
+            topK?: number | undefined;
+            recall?: "vector" | "graph" | "both" | undefined;
+        }>>;
+        /** ADR 0035 phase 12 — governed skills overlay (progressive disclosure; namespace tenant-scoped). */
+        skills: z.ZodOptional<z.ZodObject<{
+            namespace: z.ZodString;
+            /** Explicit `name@version` pins — the must-apply playbooks. */
+            required: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /** Cap on advisory (vector-selected) skills. */
+            advisoryK: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            namespace: string;
+            required?: string[] | undefined;
+            advisoryK?: number | undefined;
+        }, {
+            namespace: string;
+            required?: string[] | undefined;
+            advisoryK?: number | undefined;
+        }>>;
+        /** ADR 0024 phase 2c/2d — opt this agent into the governed virtual filesystem tools. */
+        enableFs: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * ADR 0075 (issue #566 G3) — attach an external MCP server's tools to this agent, mid-run. The
+         * value references a tenant-owned `connector_connections` row (`provider: "mcp"`), resolved and
+         * connected at run start; every discovered tool is unconditionally `requiresApproval` (an MCP
+         * server is code Ailu does not control and cannot statically vet). Distinct from `toolNames`/
+         * `approvalToolNames` above — those are re-derived at run start to include the tools this
+         * connection discovers, since the tool set isn't known until the server is actually queried.
+         */
+        mcpConnectionId: z.ZodOptional<z.ZodString>;
+        /**
+         * Issue #566 G19 — attach one or more governed action-tool connectors to this agent, mid-run.
+         * Keyed by provider id (e.g. `"slack"`), value is a tenant-owned `connector_connections` row id.
+         * Same resolution shape as `mcpConnectionId` (control plane resolves the connection, discovers
+         * that provider's action tools, merges them into `toolNames`/`approvalToolNames` before the run
+         * reaches this carrier — the Rust engine never resolves a connection itself), generalized to a
+         * map so adding the NEXT provider (Linear, Salesforce, ...) never needs another engine field/
+         * release — only a new product-side adapter keyed into the same map.
+         */
+        actionConnections: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /**
+         * ADR 0025 phase 3d — the resolved EFFICIENCY middleware list. A discriminated union of
+         * efficiency-only kinds (compress / terse / contextBudget): a GOVERNANCE kind (redact /
+         * approvalGate / fsPolicy) fails this schema BY CONSTRUCTION, so any consumer that runs it
+         * (e.g. `readAgentMetadata`) drops the malformed agent. This is a **type-level + validation
+         * guarantee** for callers that opt to validate; it is NOT auto-applied on the persisted
+         * catalog run path today (that path reads an unvalidated carrier — the RUNTIME enforcer
+         * there is the Rust bridge, whose match only honours efficiency kinds and ignores governance
+         * kinds). The SDK's `toRustAgentConfig` throw-gate covers the in-process builder path.
+         */
+        resolvedMiddleware: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"compress">;
+        }, "strip", z.ZodTypeAny, {
+            kind: "compress";
+        }, {
+            kind: "compress";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"terse">;
+        }, "strip", z.ZodTypeAny, {
+            kind: "terse";
+        }, {
+            kind: "terse";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"contextBudget">;
+            params: z.ZodObject<{
+                chars: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                chars: number;
+            }, {
+                chars: number;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            params: {
+                chars: number;
+            };
+            kind: "contextBudget";
+        }, {
+            params: {
+                chars: number;
+            };
+            kind: "contextBudget";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"reflection">;
+            params: z.ZodOptional<z.ZodObject<{
+                threshold: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                threshold?: number | undefined;
+            }, {
+                threshold?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "reflection";
+            params?: {
+                threshold?: number | undefined;
+            } | undefined;
+        }, {
+            kind: "reflection";
+            params?: {
+                threshold?: number | undefined;
+            } | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"structuredOutput">;
+            params: z.ZodObject<{
+                schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                name: z.ZodOptional<z.ZodString>;
+                strict: z.ZodOptional<z.ZodBoolean>;
+                mode: z.ZodOptional<z.ZodEnum<["required", "lenient"]>>;
+                retryCap: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            }, {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            params: {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            };
+            kind: "structuredOutput";
+        }, {
+            params: {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            };
+            kind: "structuredOutput";
+        }>]>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        provider?: string | undefined;
+        tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+        suspendForApproval?: boolean | undefined;
+        outputChannel?: string | undefined;
+        model?: string | undefined;
+        baseURL?: string | undefined;
+        apiKeyEnv?: string | undefined;
+        system?: string | undefined;
+        toolNames?: string[] | undefined;
+        toolSpecs?: {
+            name: string;
+            description?: string | undefined;
+            jsonSchema?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        maxIterations?: number | undefined;
+        approvalToolNames?: string[] | undefined;
+        outputStyle?: "terse" | undefined;
+        contextBudget?: number | undefined;
+        todosChannel?: string | undefined;
+        inputBlocksChannel?: string | undefined;
+        visibleChannels?: string[] | undefined;
+        memory?: {
+            namespace: string;
+            topK?: number | undefined;
+            recall?: "vector" | "graph" | "both" | undefined;
+        } | undefined;
+        skills?: {
+            namespace: string;
+            required?: string[] | undefined;
+            advisoryK?: number | undefined;
+        } | undefined;
+        enableFs?: boolean | undefined;
+        mcpConnectionId?: string | undefined;
+        actionConnections?: Record<string, string> | undefined;
+        resolvedMiddleware?: ({
+            kind: "compress";
+        } | {
+            kind: "terse";
+        } | {
+            params: {
+                chars: number;
+            };
+            kind: "contextBudget";
+        } | {
+            kind: "reflection";
+            params?: {
+                threshold?: number | undefined;
+            } | undefined;
+        } | {
+            params: {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            };
+            kind: "structuredOutput";
+        })[] | undefined;
+    }, {
+        provider?: string | undefined;
+        tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+        suspendForApproval?: boolean | undefined;
+        outputChannel?: string | undefined;
+        model?: string | undefined;
+        baseURL?: string | undefined;
+        apiKeyEnv?: string | undefined;
+        system?: string | undefined;
+        toolNames?: string[] | undefined;
+        toolSpecs?: {
+            name: string;
+            description?: string | undefined;
+            jsonSchema?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        maxIterations?: number | undefined;
+        approvalToolNames?: string[] | undefined;
+        outputStyle?: "terse" | undefined;
+        contextBudget?: number | undefined;
+        todosChannel?: string | undefined;
+        inputBlocksChannel?: string | undefined;
+        visibleChannels?: string[] | undefined;
+        memory?: {
+            namespace: string;
+            topK?: number | undefined;
+            recall?: "vector" | "graph" | "both" | undefined;
+        } | undefined;
+        skills?: {
+            namespace: string;
+            required?: string[] | undefined;
+            advisoryK?: number | undefined;
+        } | undefined;
+        enableFs?: boolean | undefined;
+        mcpConnectionId?: string | undefined;
+        actionConnections?: Record<string, string> | undefined;
+        resolvedMiddleware?: ({
+            kind: "compress";
+        } | {
+            kind: "terse";
+        } | {
+            params: {
+                chars: number;
+            };
+            kind: "contextBudget";
+        } | {
+            kind: "reflection";
+            params?: {
+                threshold?: number | undefined;
+            } | undefined;
+        } | {
+            params: {
+                schema: Record<string, unknown>;
+                strict?: boolean | undefined;
+                name?: string | undefined;
+                mode?: "required" | "lenient" | undefined;
+                retryCap?: number | undefined;
+            };
+            kind: "structuredOutput";
+        })[] | undefined;
+    }>>;
+    mapAgents: z.ZodOptional<z.ZodObject<{
+        /** Channel holding the array of items to fan the sub-agent out over. */
+        overChannel: z.ZodString;
+        /** Channel the array of per-item results lands in (one entry per item, in input order). */
+        joinAt: z.ZodString;
+        /** The sub-agent run per item — a full agent carrier. */
+        subAgent: z.ZodObject<{
+            provider: z.ZodOptional<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            tier: z.ZodOptional<z.ZodEnum<["frontier", "balanced", "fast", "creative"]>>;
+            /** A custom OpenAI-compatible endpoint (`model.openaiCompatible`) and the env var naming its key. */
+            baseURL: z.ZodOptional<z.ZodString>;
+            apiKeyEnv: z.ZodOptional<z.ZodString>;
+            system: z.ZodOptional<z.ZodString>;
+            toolNames: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /** Each tool's description and input JSON Schema, as the LLM sees them. */
+            toolSpecs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                jsonSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                description?: string | undefined;
+                jsonSchema?: Record<string, unknown> | undefined;
+            }, {
+                name: string;
+                description?: string | undefined;
+                jsonSchema?: Record<string, unknown> | undefined;
+            }>, "many">>;
+            maxIterations: z.ZodOptional<z.ZodNumber>;
+            suspendForApproval: z.ZodOptional<z.ZodBoolean>;
+            approvalToolNames: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            outputChannel: z.ZodOptional<z.ZodString>;
+            /** ADR 0014 — terse output directive on the system prompt. */
+            outputStyle: z.ZodOptional<z.ZodLiteral<"terse">>;
+            /** ADR 0014 — cap (chars) on the agent's seed message (the injected `Input`/`State` dump). */
+            contextBudget: z.ZodOptional<z.ZodNumber>;
+            /** ADR 0022/0023 — durable channel the agent's `writeTodos` list is persisted into. */
+            todosChannel: z.ZodOptional<z.ZodString>;
+            /** ADR 0030 phase 9e — channel carrying the run's multimodal input blocks. */
+            inputBlocksChannel: z.ZodOptional<z.ZodString>;
+            /** The only channels the agent is shown in its seed state (context isolation). */
+            visibleChannels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /** ADR 0026 phase 11 — governed long-term memory overlay (namespace tenant-scoped). */
+            memory: z.ZodOptional<z.ZodObject<{
+                namespace: z.ZodString;
+                topK: z.ZodOptional<z.ZodNumber>;
+                recall: z.ZodOptional<z.ZodEnum<["vector", "graph", "both"]>>;
+            }, "strip", z.ZodTypeAny, {
+                namespace: string;
+                topK?: number | undefined;
+                recall?: "vector" | "graph" | "both" | undefined;
+            }, {
+                namespace: string;
+                topK?: number | undefined;
+                recall?: "vector" | "graph" | "both" | undefined;
+            }>>;
+            /** ADR 0035 phase 12 — governed skills overlay (progressive disclosure; namespace tenant-scoped). */
+            skills: z.ZodOptional<z.ZodObject<{
+                namespace: z.ZodString;
+                /** Explicit `name@version` pins — the must-apply playbooks. */
+                required: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                /** Cap on advisory (vector-selected) skills. */
+                advisoryK: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                namespace: string;
+                required?: string[] | undefined;
+                advisoryK?: number | undefined;
+            }, {
+                namespace: string;
+                required?: string[] | undefined;
+                advisoryK?: number | undefined;
+            }>>;
+            /** ADR 0024 phase 2c/2d — opt this agent into the governed virtual filesystem tools. */
+            enableFs: z.ZodOptional<z.ZodBoolean>;
+            /**
+             * ADR 0075 (issue #566 G3) — attach an external MCP server's tools to this agent, mid-run. The
+             * value references a tenant-owned `connector_connections` row (`provider: "mcp"`), resolved and
+             * connected at run start; every discovered tool is unconditionally `requiresApproval` (an MCP
+             * server is code Ailu does not control and cannot statically vet). Distinct from `toolNames`/
+             * `approvalToolNames` above — those are re-derived at run start to include the tools this
+             * connection discovers, since the tool set isn't known until the server is actually queried.
+             */
+            mcpConnectionId: z.ZodOptional<z.ZodString>;
+            /**
+             * Issue #566 G19 — attach one or more governed action-tool connectors to this agent, mid-run.
+             * Keyed by provider id (e.g. `"slack"`), value is a tenant-owned `connector_connections` row id.
+             * Same resolution shape as `mcpConnectionId` (control plane resolves the connection, discovers
+             * that provider's action tools, merges them into `toolNames`/`approvalToolNames` before the run
+             * reaches this carrier — the Rust engine never resolves a connection itself), generalized to a
+             * map so adding the NEXT provider (Linear, Salesforce, ...) never needs another engine field/
+             * release — only a new product-side adapter keyed into the same map.
+             */
+            actionConnections: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            /**
+             * ADR 0025 phase 3d — the resolved EFFICIENCY middleware list. A discriminated union of
+             * efficiency-only kinds (compress / terse / contextBudget): a GOVERNANCE kind (redact /
+             * approvalGate / fsPolicy) fails this schema BY CONSTRUCTION, so any consumer that runs it
+             * (e.g. `readAgentMetadata`) drops the malformed agent. This is a **type-level + validation
+             * guarantee** for callers that opt to validate; it is NOT auto-applied on the persisted
+             * catalog run path today (that path reads an unvalidated carrier — the RUNTIME enforcer
+             * there is the Rust bridge, whose match only honours efficiency kinds and ignores governance
+             * kinds). The SDK's `toRustAgentConfig` throw-gate covers the in-process builder path.
+             */
+            resolvedMiddleware: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"compress">;
+            }, "strip", z.ZodTypeAny, {
+                kind: "compress";
+            }, {
+                kind: "compress";
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"terse">;
+            }, "strip", z.ZodTypeAny, {
+                kind: "terse";
+            }, {
+                kind: "terse";
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"contextBudget">;
+                params: z.ZodObject<{
+                    chars: z.ZodNumber;
+                }, "strip", z.ZodTypeAny, {
+                    chars: number;
+                }, {
+                    chars: number;
+                }>;
+            }, "strip", z.ZodTypeAny, {
+                params: {
+                    chars: number;
+                };
+                kind: "contextBudget";
+            }, {
+                params: {
+                    chars: number;
+                };
+                kind: "contextBudget";
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"reflection">;
+                params: z.ZodOptional<z.ZodObject<{
+                    threshold: z.ZodOptional<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    threshold?: number | undefined;
+                }, {
+                    threshold?: number | undefined;
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "reflection";
+                params?: {
+                    threshold?: number | undefined;
+                } | undefined;
+            }, {
+                kind: "reflection";
+                params?: {
+                    threshold?: number | undefined;
+                } | undefined;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"structuredOutput">;
+                params: z.ZodObject<{
+                    schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                    name: z.ZodOptional<z.ZodString>;
+                    strict: z.ZodOptional<z.ZodBoolean>;
+                    mode: z.ZodOptional<z.ZodEnum<["required", "lenient"]>>;
+                    retryCap: z.ZodOptional<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                }, {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                }>;
+            }, "strip", z.ZodTypeAny, {
+                params: {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                };
+                kind: "structuredOutput";
+            }, {
+                params: {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                };
+                kind: "structuredOutput";
+            }>]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            provider?: string | undefined;
+            tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+            suspendForApproval?: boolean | undefined;
+            outputChannel?: string | undefined;
+            model?: string | undefined;
+            baseURL?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            system?: string | undefined;
+            toolNames?: string[] | undefined;
+            toolSpecs?: {
+                name: string;
+                description?: string | undefined;
+                jsonSchema?: Record<string, unknown> | undefined;
+            }[] | undefined;
+            maxIterations?: number | undefined;
+            approvalToolNames?: string[] | undefined;
+            outputStyle?: "terse" | undefined;
+            contextBudget?: number | undefined;
+            todosChannel?: string | undefined;
+            inputBlocksChannel?: string | undefined;
+            visibleChannels?: string[] | undefined;
+            memory?: {
+                namespace: string;
+                topK?: number | undefined;
+                recall?: "vector" | "graph" | "both" | undefined;
+            } | undefined;
+            skills?: {
+                namespace: string;
+                required?: string[] | undefined;
+                advisoryK?: number | undefined;
+            } | undefined;
+            enableFs?: boolean | undefined;
+            mcpConnectionId?: string | undefined;
+            actionConnections?: Record<string, string> | undefined;
+            resolvedMiddleware?: ({
+                kind: "compress";
+            } | {
+                kind: "terse";
+            } | {
+                params: {
+                    chars: number;
+                };
+                kind: "contextBudget";
+            } | {
+                kind: "reflection";
+                params?: {
+                    threshold?: number | undefined;
+                } | undefined;
+            } | {
+                params: {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                };
+                kind: "structuredOutput";
+            })[] | undefined;
+        }, {
+            provider?: string | undefined;
+            tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+            suspendForApproval?: boolean | undefined;
+            outputChannel?: string | undefined;
+            model?: string | undefined;
+            baseURL?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            system?: string | undefined;
+            toolNames?: string[] | undefined;
+            toolSpecs?: {
+                name: string;
+                description?: string | undefined;
+                jsonSchema?: Record<string, unknown> | undefined;
+            }[] | undefined;
+            maxIterations?: number | undefined;
+            approvalToolNames?: string[] | undefined;
+            outputStyle?: "terse" | undefined;
+            contextBudget?: number | undefined;
+            todosChannel?: string | undefined;
+            inputBlocksChannel?: string | undefined;
+            visibleChannels?: string[] | undefined;
+            memory?: {
+                namespace: string;
+                topK?: number | undefined;
+                recall?: "vector" | "graph" | "both" | undefined;
+            } | undefined;
+            skills?: {
+                namespace: string;
+                required?: string[] | undefined;
+                advisoryK?: number | undefined;
+            } | undefined;
+            enableFs?: boolean | undefined;
+            mcpConnectionId?: string | undefined;
+            actionConnections?: Record<string, string> | undefined;
+            resolvedMiddleware?: ({
+                kind: "compress";
+            } | {
+                kind: "terse";
+            } | {
+                params: {
+                    chars: number;
+                };
+                kind: "contextBudget";
+            } | {
+                kind: "reflection";
+                params?: {
+                    threshold?: number | undefined;
+                } | undefined;
+            } | {
+                params: {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                };
+                kind: "structuredOutput";
+            })[] | undefined;
+        }>;
+        /** When true, a spawn that needs approval suspends the whole map (default false). */
+        suspendForApproval: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        joinAt: string;
+        overChannel: string;
+        subAgent: {
+            provider?: string | undefined;
+            tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+            suspendForApproval?: boolean | undefined;
+            outputChannel?: string | undefined;
+            model?: string | undefined;
+            baseURL?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            system?: string | undefined;
+            toolNames?: string[] | undefined;
+            toolSpecs?: {
+                name: string;
+                description?: string | undefined;
+                jsonSchema?: Record<string, unknown> | undefined;
+            }[] | undefined;
+            maxIterations?: number | undefined;
+            approvalToolNames?: string[] | undefined;
+            outputStyle?: "terse" | undefined;
+            contextBudget?: number | undefined;
+            todosChannel?: string | undefined;
+            inputBlocksChannel?: string | undefined;
+            visibleChannels?: string[] | undefined;
+            memory?: {
+                namespace: string;
+                topK?: number | undefined;
+                recall?: "vector" | "graph" | "both" | undefined;
+            } | undefined;
+            skills?: {
+                namespace: string;
+                required?: string[] | undefined;
+                advisoryK?: number | undefined;
+            } | undefined;
+            enableFs?: boolean | undefined;
+            mcpConnectionId?: string | undefined;
+            actionConnections?: Record<string, string> | undefined;
+            resolvedMiddleware?: ({
+                kind: "compress";
+            } | {
+                kind: "terse";
+            } | {
+                params: {
+                    chars: number;
+                };
+                kind: "contextBudget";
+            } | {
+                kind: "reflection";
+                params?: {
+                    threshold?: number | undefined;
+                } | undefined;
+            } | {
+                params: {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                };
+                kind: "structuredOutput";
+            })[] | undefined;
+        };
+        suspendForApproval?: boolean | undefined;
+    }, {
+        joinAt: string;
+        overChannel: string;
+        subAgent: {
+            provider?: string | undefined;
+            tier?: "frontier" | "balanced" | "fast" | "creative" | undefined;
+            suspendForApproval?: boolean | undefined;
+            outputChannel?: string | undefined;
+            model?: string | undefined;
+            baseURL?: string | undefined;
+            apiKeyEnv?: string | undefined;
+            system?: string | undefined;
+            toolNames?: string[] | undefined;
+            toolSpecs?: {
+                name: string;
+                description?: string | undefined;
+                jsonSchema?: Record<string, unknown> | undefined;
+            }[] | undefined;
+            maxIterations?: number | undefined;
+            approvalToolNames?: string[] | undefined;
+            outputStyle?: "terse" | undefined;
+            contextBudget?: number | undefined;
+            todosChannel?: string | undefined;
+            inputBlocksChannel?: string | undefined;
+            visibleChannels?: string[] | undefined;
+            memory?: {
+                namespace: string;
+                topK?: number | undefined;
+                recall?: "vector" | "graph" | "both" | undefined;
+            } | undefined;
+            skills?: {
+                namespace: string;
+                required?: string[] | undefined;
+                advisoryK?: number | undefined;
+            } | undefined;
+            enableFs?: boolean | undefined;
+            mcpConnectionId?: string | undefined;
+            actionConnections?: Record<string, string> | undefined;
+            resolvedMiddleware?: ({
+                kind: "compress";
+            } | {
+                kind: "terse";
+            } | {
+                params: {
+                    chars: number;
+                };
+                kind: "contextBudget";
+            } | {
+                kind: "reflection";
+                params?: {
+                    threshold?: number | undefined;
+                } | undefined;
+            } | {
+                params: {
+                    schema: Record<string, unknown>;
+                    strict?: boolean | undefined;
+                    name?: string | undefined;
+                    mode?: "required" | "lenient" | undefined;
+                    retryCap?: number | undefined;
+                };
+                kind: "structuredOutput";
+            })[] | undefined;
+        };
+        suspendForApproval?: boolean | undefined;
+    }>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type ComponentNodeMetadata = z.infer<typeof ComponentNodeMetadataSchema>;
+export type AgentNodeMetadata = z.infer<typeof AgentNodeMetadataSchema>;
+export type MapAgentNodeMetadata = z.infer<typeof MapAgentNodeMetadataSchema>;
+export type CatalogNodeMetadata = z.infer<typeof CatalogNodeMetadataSchema>;
+/** Narrow an open metadata bag to its component carrier, if present and valid. */
+export declare const readComponentMetadata: (metadata: Record<string, unknown> | undefined) => ComponentNodeMetadata | undefined;
+/** Narrow an open metadata bag to its agent carrier, if present and valid. */
+export declare const readAgentMetadata: (metadata: Record<string, unknown> | undefined) => AgentNodeMetadata | undefined;
+/** Narrow an open metadata bag to its mapAgents (dynamic fan-out) carrier, if present and valid. */
+export declare const readMapAgentMetadata: (metadata: Record<string, unknown> | undefined) => MapAgentNodeMetadata | undefined;
+//# sourceMappingURL=node-metadata.d.ts.map