@amodalai/core 0.1.0

package/dist/src/versions/version-bundle-types.d.ts

@@ -0,0 +1,1278 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { z } from 'zod';
+/**
+ * Automation trigger — cron schedule or webhook event.
+ */
+export declare const AutomationTriggerSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"cron">;
+    schedule: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "cron";
+    schedule: string;
+}, {
+    type: "cron";
+    schedule: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"webhook">;
+    /** Event source identifier */
+    source: z.ZodString;
+    /** Optional filter expression for the webhook payload */
+    filter: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "webhook";
+    source: string;
+    filter?: string | undefined;
+}, {
+    type: "webhook";
+    source: string;
+    filter?: string | undefined;
+}>]>;
+/**
+ * Automation output channel configuration.
+ */
+export declare const AutomationOutputSchema: z.ZodObject<{
+    /** Output channel type */
+    channel: z.ZodEnum<["slack", "webhook", "email"]>;
+    /** Channel-specific target (URL, email address, etc.) */
+    target: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    channel: "webhook" | "email" | "slack";
+    target: string;
+}, {
+    channel: "webhook" | "email" | "slack";
+    target: string;
+}>;
+/**
+ * Constraints applied to automation sessions.
+ */
+export declare const AutomationConstraintsSchema: z.ZodObject<{
+    /** Maximum number of tool calls per automation run */
+    max_tool_calls: z.ZodOptional<z.ZodNumber>;
+    /** Timeout in seconds for the entire automation run */
+    timeout_seconds: z.ZodOptional<z.ZodNumber>;
+    /** Maximum tokens for the LLM response */
+    max_tokens: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    max_tokens?: number | undefined;
+    max_tool_calls?: number | undefined;
+    timeout_seconds?: number | undefined;
+}, {
+    max_tokens?: number | undefined;
+    max_tool_calls?: number | undefined;
+    timeout_seconds?: number | undefined;
+}>;
+/**
+ * An automation definition — scheduled or event-triggered agent prompt.
+ */
+export declare const AutomationDefinitionSchema: z.ZodObject<{
+    /** Unique automation name */
+    name: z.ZodString;
+    /** How this automation is triggered */
+    trigger: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"cron">;
+        schedule: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "cron";
+        schedule: string;
+    }, {
+        type: "cron";
+        schedule: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"webhook">;
+        /** Event source identifier */
+        source: z.ZodString;
+        /** Optional filter expression for the webhook payload */
+        filter: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "webhook";
+        source: string;
+        filter?: string | undefined;
+    }, {
+        type: "webhook";
+        source: string;
+        filter?: string | undefined;
+    }>]>;
+    /** The prompt sent to the agent when triggered */
+    prompt: z.ZodString;
+    /** Tools available during this automation's session */
+    tools: z.ZodArray<z.ZodString, "many">;
+    /** Skills available during this automation's session */
+    skills: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Where to send the automation's output */
+    output: z.ZodObject<{
+        /** Output channel type */
+        channel: z.ZodEnum<["slack", "webhook", "email"]>;
+        /** Channel-specific target (URL, email address, etc.) */
+        target: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        channel: "webhook" | "email" | "slack";
+        target: string;
+    }, {
+        channel: "webhook" | "email" | "slack";
+        target: string;
+    }>;
+    /** Session constraints */
+    constraints: z.ZodOptional<z.ZodObject<{
+        /** Maximum number of tool calls per automation run */
+        max_tool_calls: z.ZodOptional<z.ZodNumber>;
+        /** Timeout in seconds for the entire automation run */
+        timeout_seconds: z.ZodOptional<z.ZodNumber>;
+        /** Maximum tokens for the LLM response */
+        max_tokens: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        max_tokens?: number | undefined;
+        max_tool_calls?: number | undefined;
+        timeout_seconds?: number | undefined;
+    }, {
+        max_tokens?: number | undefined;
+        max_tool_calls?: number | undefined;
+        timeout_seconds?: number | undefined;
+    }>>;
+    /** Whether write operations are allowed (default false — safety guardrail) */
+    allow_writes: z.ZodDefault<z.ZodBoolean>;
+    /** Session types where this automation is available. Empty/undefined = all. */
+    session_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    tools: string[];
+    output: {
+        channel: "webhook" | "email" | "slack";
+        target: string;
+    };
+    skills: string[];
+    trigger: {
+        type: "cron";
+        schedule: string;
+    } | {
+        type: "webhook";
+        source: string;
+        filter?: string | undefined;
+    };
+    prompt: string;
+    allow_writes: boolean;
+    constraints?: {
+        max_tokens?: number | undefined;
+        max_tool_calls?: number | undefined;
+        timeout_seconds?: number | undefined;
+    } | undefined;
+    session_types?: string[] | undefined;
+}, {
+    name: string;
+    tools: string[];
+    output: {
+        channel: "webhook" | "email" | "slack";
+        target: string;
+    };
+    trigger: {
+        type: "cron";
+        schedule: string;
+    } | {
+        type: "webhook";
+        source: string;
+        filter?: string | undefined;
+    };
+    prompt: string;
+    skills?: string[] | undefined;
+    constraints?: {
+        max_tokens?: number | undefined;
+        max_tool_calls?: number | undefined;
+        timeout_seconds?: number | undefined;
+    } | undefined;
+    allow_writes?: boolean | undefined;
+    session_types?: string[] | undefined;
+}>;
+/**
+ * A tool config in a version bundle — discriminated by `type`.
+ */
+export declare const BundleToolConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodString;
+    method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>;
+    urlTemplate: z.ZodString;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    bodyTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+    queryParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    responseShaping: z.ZodOptional<z.ZodObject<{
+        path: z.ZodOptional<z.ZodString>;
+        maxLength: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxLength: number;
+        path?: string | undefined;
+    }, {
+        path?: string | undefined;
+        maxLength?: number | undefined;
+    }>>;
+    parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    timeout: z.ZodDefault<z.ZodNumber>;
+} & {
+    type: z.ZodLiteral<"http">;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    session_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: "http";
+    method: "POST" | "GET" | "PUT" | "PATCH" | "DELETE";
+    name: string;
+    displayName: string;
+    description: string;
+    urlTemplate: string;
+    parameters: Record<string, unknown>;
+    timeout: number;
+    headers?: Record<string, string> | undefined;
+    bodyTemplate?: string | Record<string, unknown> | undefined;
+    queryParams?: Record<string, string> | undefined;
+    responseShaping?: {
+        maxLength: number;
+        path?: string | undefined;
+    } | undefined;
+    session_types?: string[] | undefined;
+    disabled?: boolean | undefined;
+}, {
+    type: "http";
+    method: "POST" | "GET" | "PUT" | "PATCH" | "DELETE";
+    name: string;
+    displayName: string;
+    description: string;
+    urlTemplate: string;
+    parameters: Record<string, unknown>;
+    headers?: Record<string, string> | undefined;
+    bodyTemplate?: string | Record<string, unknown> | undefined;
+    queryParams?: Record<string, string> | undefined;
+    responseShaping?: {
+        path?: string | undefined;
+        maxLength?: number | undefined;
+    } | undefined;
+    timeout?: number | undefined;
+    session_types?: string[] | undefined;
+    disabled?: boolean | undefined;
+}>, z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodString;
+    steps: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>;
+        urlTemplate: z.ZodString;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        bodyTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+        queryParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        timeout: z.ZodDefault<z.ZodNumber>;
+        responseShaping: z.ZodOptional<z.ZodObject<{
+            path: z.ZodOptional<z.ZodString>;
+            maxLength: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            maxLength: number;
+            path?: string | undefined;
+        }, {
+            path?: string | undefined;
+            maxLength?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        method: "POST" | "GET" | "PUT" | "PATCH" | "DELETE";
+        name: string;
+        urlTemplate: string;
+        timeout: number;
+        headers?: Record<string, string> | undefined;
+        bodyTemplate?: string | Record<string, unknown> | undefined;
+        queryParams?: Record<string, string> | undefined;
+        responseShaping?: {
+            maxLength: number;
+            path?: string | undefined;
+        } | undefined;
+    }, {
+        method: "POST" | "GET" | "PUT" | "PATCH" | "DELETE";
+        name: string;
+        urlTemplate: string;
+        headers?: Record<string, string> | undefined;
+        bodyTemplate?: string | Record<string, unknown> | undefined;
+        queryParams?: Record<string, string> | undefined;
+        responseShaping?: {
+            path?: string | undefined;
+            maxLength?: number | undefined;
+        } | undefined;
+        timeout?: number | undefined;
+    }>, "many">;
+    merge: z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
+    parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    responseShaping: z.ZodOptional<z.ZodObject<{
+        path: z.ZodOptional<z.ZodString>;
+        maxLength: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxLength: number;
+        path?: string | undefined;
+    }, {
+        path?: string | undefined;
+        maxLength?: number | undefined;
+    }>>;
+    timeout: z.ZodDefault<z.ZodNumber>;
+} & {
+    type: z.ZodLiteral<"chain">;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    session_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: "chain";
+    name: string;
+    displayName: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    timeout: number;
+    merge: string | Record<string, unknown>;
+    steps: {
+        method: "POST" | "GET" | "PUT" | "PATCH" | "DELETE";
+        name: string;
+        urlTemplate: string;
+        timeout: number;
+        headers?: Record<string, string> | undefined;
+        bodyTemplate?: string | Record<string, unknown> | undefined;
+        queryParams?: Record<string, string> | undefined;
+        responseShaping?: {
+            maxLength: number;
+            path?: string | undefined;
+        } | undefined;
+    }[];
+    responseShaping?: {
+        maxLength: number;
+        path?: string | undefined;
+    } | undefined;
+    session_types?: string[] | undefined;
+    disabled?: boolean | undefined;
+}, {
+    type: "chain";
+    name: string;
+    displayName: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    merge: string | Record<string, unknown>;
+    steps: {
+        method: "POST" | "GET" | "PUT" | "PATCH" | "DELETE";
+        name: string;
+        urlTemplate: string;
+        headers?: Record<string, string> | undefined;
+        bodyTemplate?: string | Record<string, unknown> | undefined;
+        queryParams?: Record<string, string> | undefined;
+        responseShaping?: {
+            path?: string | undefined;
+            maxLength?: number | undefined;
+        } | undefined;
+        timeout?: number | undefined;
+    }[];
+    responseShaping?: {
+        path?: string | undefined;
+        maxLength?: number | undefined;
+    } | undefined;
+    timeout?: number | undefined;
+    session_types?: string[] | undefined;
+    disabled?: boolean | undefined;
+}>, z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodString;
+    handler: z.ZodString;
+    parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    responseShaping: z.ZodOptional<z.ZodObject<{
+        path: z.ZodOptional<z.ZodString>;
+        maxLength: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxLength: number;
+        path?: string | undefined;
+    }, {
+        path?: string | undefined;
+        maxLength?: number | undefined;
+    }>>;
+    timeout: z.ZodDefault<z.ZodNumber>;
+} & {
+    type: z.ZodLiteral<"function">;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    session_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: "function";
+    name: string;
+    displayName: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    timeout: number;
+    handler: string;
+    responseShaping?: {
+        maxLength: number;
+        path?: string | undefined;
+    } | undefined;
+    session_types?: string[] | undefined;
+    disabled?: boolean | undefined;
+}, {
+    type: "function";
+    name: string;
+    displayName: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    handler: string;
+    responseShaping?: {
+        path?: string | undefined;
+        maxLength?: number | undefined;
+    } | undefined;
+    timeout?: number | undefined;
+    session_types?: string[] | undefined;
+    disabled?: boolean | undefined;
+}>]>;
+/**
+ * A handler definition — entry file plus all source files.
+ */
+export declare const BundleHandlerSchema: z.ZodObject<{
+    /** Entry point filename (e.g., "compute-risk.ts") */
+    entry: z.ZodString;
+    /** Map of filename → source code */
+    files: z.ZodRecord<z.ZodString, z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    entry: string;
+    files: Record<string, string>;
+}, {
+    entry: string;
+    files: Record<string, string>;
+}>;
+/**
+ * Dependencies required by the version bundle.
+ */
+export declare const BundleDependenciesSchema: z.ZodObject<{
+    /** npm packages: { name: version } */
+    npm: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /** pip packages: { name: version } */
+    pip: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /** System binaries that must be available (checked via `which`) */
+    system: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    system?: string[] | undefined;
+    npm?: Record<string, string> | undefined;
+    pip?: Record<string, string> | undefined;
+}, {
+    system?: string[] | undefined;
+    npm?: Record<string, string> | undefined;
+    pip?: Record<string, string> | undefined;
+}>;
+/**
+ * Knowledge base dependencies for a skill — tags and scope to auto-load.
+ */
+export declare const SkillKnowledgeDepsSchema: z.ZodObject<{
+    /** Docs matching any of these tags are auto-loaded on skill activation. */
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Restrict to a specific scope, or 'all' for both application and tenant. Default: 'all'. */
+    scope: z.ZodOptional<z.ZodEnum<["application", "tenant", "all"]>>;
+}, "strip", z.ZodTypeAny, {
+    scope?: "application" | "tenant" | "all" | undefined;
+    tags?: string[] | undefined;
+}, {
+    scope?: "application" | "tenant" | "all" | undefined;
+    tags?: string[] | undefined;
+}>;
+/**
+ * A skill definition in a version bundle.
+ */
+export declare const BundleSkillSchema: z.ZodObject<{
+    /** Skill name (used for activation) */
+    name: z.ZodString;
+    /** Short description (shown to LLM in system prompt) */
+    description: z.ZodString;
+    /** Full skill body (SKILL.md content, loaded on activation) */
+    body: z.ZodString;
+    /** Knowledge base documents to auto-load when this skill activates. */
+    knowledge: z.ZodOptional<z.ZodObject<{
+        /** Docs matching any of these tags are auto-loaded on skill activation. */
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Restrict to a specific scope, or 'all' for both application and tenant. Default: 'all'. */
+        scope: z.ZodOptional<z.ZodEnum<["application", "tenant", "all"]>>;
+    }, "strip", z.ZodTypeAny, {
+        scope?: "application" | "tenant" | "all" | undefined;
+        tags?: string[] | undefined;
+    }, {
+        scope?: "application" | "tenant" | "all" | undefined;
+        tags?: string[] | undefined;
+    }>>;
+    /** Session types where this skill is available. Empty/undefined = all. */
+    session_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    body: string;
+    name: string;
+    description: string;
+    session_types?: string[] | undefined;
+    knowledge?: {
+        scope?: "application" | "tenant" | "all" | undefined;
+        tags?: string[] | undefined;
+    } | undefined;
+}, {
+    body: string;
+    name: string;
+    description: string;
+    session_types?: string[] | undefined;
+    knowledge?: {
+        scope?: "application" | "tenant" | "all" | undefined;
+        tags?: string[] | undefined;
+    } | undefined;
+}>;
+/**
+ * A subagent (task agent) configuration in a version bundle.
+ */
+export declare const SubagentConfigSchema: z.ZodObject<{
+    /** Subagent name (used for dispatch) */
+    name: z.ZodString;
+    /** Display name shown in the admin UI */
+    displayName: z.ZodString;
+    /** Short description (visible to admins and injected into primary agent context) */
+    description: z.ZodString;
+    /** Prompt template with {{variable}} placeholders */
+    prompt: z.ZodString;
+    /** Tools this subagent can use */
+    tools: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Max dispatch depth (1 = no sub-agents, 2 = can dispatch sub-task agents) */
+    maxDepth: z.ZodDefault<z.ZodNumber>;
+    /** Max tool calls per execution */
+    maxToolCalls: z.ZodDefault<z.ZodNumber>;
+    /** Timeout in seconds */
+    timeout: z.ZodDefault<z.ZodNumber>;
+    /** Target output token range */
+    targetOutputMin: z.ZodDefault<z.ZodNumber>;
+    targetOutputMax: z.ZodDefault<z.ZodNumber>;
+    /** Model tier: 'simple' for data gathering, 'advanced' for complex reasoning, 'default' for standard */
+    modelTier: z.ZodOptional<z.ZodEnum<["default", "simple", "advanced"]>>;
+    /** Session types where this subagent is available. Empty/undefined = all. */
+    session_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    displayName: string;
+    description: string;
+    timeout: number;
+    tools: string[];
+    prompt: string;
+    maxDepth: number;
+    maxToolCalls: number;
+    targetOutputMin: number;
+    targetOutputMax: number;
+    session_types?: string[] | undefined;
+    modelTier?: "default" | "simple" | "advanced" | undefined;
+}, {
+    name: string;
+    displayName: string;
+    description: string;
+    prompt: string;
+    timeout?: number | undefined;
+    tools?: string[] | undefined;
+    session_types?: string[] | undefined;
+    maxDepth?: number | undefined;
+    maxToolCalls?: number | undefined;
+    targetOutputMin?: number | undefined;
+    targetOutputMax?: number | undefined;
+    modelTier?: "default" | "simple" | "advanced" | undefined;
+}>;
+/**
+ * A complete version bundle — the atomic unit of deployment.
+ */
+export declare const VersionBundleSchema: z.ZodObject<{
+    /** Semantic version string (e.g., "1.2.3") */
+    version: z.ZodString;
+    /** ISO 8601 timestamp when published */
+    published_at: z.ZodOptional<z.ZodString>;
+    /** Who published this version */
+    published_by: z.ZodOptional<z.ZodString>;
+    /** Tool configurations */
+    tools: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodString;
+        method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>;
+        urlTemplate: z.ZodString;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        bodyTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+        queryParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        responseShaping: z.ZodOptional<z.ZodObject<{
+            path: z.ZodOptional<z.ZodString>;
+            maxLength: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            maxLength: number;
+            path?: string | undefined;
+        }, {
+            path?: string | undefined;
+            maxLength?: number | undefined;
+        }>>;
+        parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        timeout: z.ZodDefault<z.ZodNumber>;
+    } & {
+        type: z.ZodLiteral<"http">;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        session_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        type: "http";
+        method: "POST" | "GET" | "PUT" | "PATCH" | "DELETE";
+        name: string;
+        displayName: string;
+        description: string;
+        urlTemplate: string;
+        parameters: Record<string, unknown>;
+        timeout: number;
+        headers?: Record<string, string> | undefined;
+        bodyTemplate?: string | Record<string, unknown> | undefined;
+        queryParams?: Record<string, string> | undefined;
+        responseShaping?: {
+            maxLength: number;
+            path?: string | undefined;
+        } | undefined;
+        session_types?: string[] | undefined;
+        disabled?: boolean | undefined;
+    }, {
+        type: "http";
+        method: "POST" | "GET" | "PUT" | "PATCH" | "DELETE";
+        name: string;
+        displayName: string;
+        description: string;
+        urlTemplate: string;
+        parameters: Record<string, unknown>;
+        headers?: Record<string, string> | undefined;
+        bodyTemplate?: string | Record<string, unknown> | undefined;
+        queryParams?: Record<string, string> | undefined;
+        responseShaping?: {
+            path?: string | undefined;
+            maxLength?: number | undefined;
+        } | undefined;
+        timeout?: number | undefined;
+        session_types?: string[] | undefined;
+        disabled?: boolean | undefined;
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodString;
+        steps: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>;
+            urlTemplate: z.ZodString;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            bodyTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+            queryParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            timeout: z.ZodDefault<z.ZodNumber>;
+            responseShaping: z.ZodOptional<z.ZodObject<{
+                path: z.ZodOptional<z.ZodString>;
+                maxLength: z.ZodDefault<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                maxLength: number;
+                path?: string | undefined;
+            }, {
+                path?: string | undefined;
+                maxLength?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            method: "POST" | "GET" | "PUT" | "PATCH" | "DELETE";
+            name: string;
+            urlTemplate: string;
+            timeout: number;
+            headers?: Record<string, string> | undefined;
+            bodyTemplate?: string | Record<string, unknown> | undefined;
+            queryParams?: Record<string, string> | undefined;
+            responseShaping?: {
+                maxLength: number;
+                path?: string | undefined;
+            } | undefined;
+        }, {
+            method: "POST" | "GET" | "PUT" | "PATCH" | "DELETE";
+            name: string;
+            urlTemplate: string;
+            headers?: Record<string, string> | undefined;
+            bodyTemplate?: string | Record<string, unknown> | undefined;
+            queryParams?: Record<string, string> | undefined;
+            responseShaping?: {
+                path?: string | undefined;
+                maxLength?: number | undefined;
+            } | undefined;
+            timeout?: number | undefined;
+        }>, "many">;
+        merge: z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
+        parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        responseShaping: z.ZodOptional<z.ZodObject<{
+            path: z.ZodOptional<z.ZodString>;
+            maxLength: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            maxLength: number;
+            path?: string | undefined;
+        }, {
+            path?: string | undefined;
+            maxLength?: number | undefined;
+        }>>;
+        timeout: z.ZodDefault<z.ZodNumber>;
+    } & {
+        type: z.ZodLiteral<"chain">;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        session_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        type: "chain";
+        name: string;
+        displayName: string;
+        description: string;
+        parameters: Record<string, unknown>;
+        timeout: number;
+        merge: string | Record<string, unknown>;
+        steps: {
+            method: "POST" | "GET" | "PUT" | "PATCH" | "DELETE";
+            name: string;
+            urlTemplate: string;
+            timeout: number;
+            headers?: Record<string, string> | undefined;
+            bodyTemplate?: string | Record<string, unknown> | undefined;
+            queryParams?: Record<string, string> | undefined;
+            responseShaping?: {
+                maxLength: number;
+                path?: string | undefined;
+            } | undefined;
+        }[];
+        responseShaping?: {
+            maxLength: number;
+            path?: string | undefined;
+        } | undefined;
+        session_types?: string[] | undefined;
+        disabled?: boolean | undefined;
+    }, {
+        type: "chain";
+        name: string;
+        displayName: string;
+        description: string;
+        parameters: Record<string, unknown>;
+        merge: string | Record<string, unknown>;
+        steps: {
+            method: "POST" | "GET" | "PUT" | "PATCH" | "DELETE";
+            name: string;
+            urlTemplate: string;
+            headers?: Record<string, string> | undefined;
+            bodyTemplate?: string | Record<string, unknown> | undefined;
+            queryParams?: Record<string, string> | undefined;
+            responseShaping?: {
+                path?: string | undefined;
+                maxLength?: number | undefined;
+            } | undefined;
+            timeout?: number | undefined;
+        }[];
+        responseShaping?: {
+            path?: string | undefined;
+            maxLength?: number | undefined;
+        } | undefined;
+        timeout?: number | undefined;
+        session_types?: string[] | undefined;
+        disabled?: boolean | undefined;
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodString;
+        handler: z.ZodString;
+        parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        responseShaping: z.ZodOptional<z.ZodObject<{
+            path: z.ZodOptional<z.ZodString>;
+            maxLength: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            maxLength: number;
+            path?: string | undefined;
+        }, {
+            path?: string | undefined;
+            maxLength?: number | undefined;
+        }>>;
+        timeout: z.ZodDefault<z.ZodNumber>;
+    } & {
+        type: z.ZodLiteral<"function">;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        session_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        type: "function";
+        name: string;
+        displayName: string;
+        description: string;
+        parameters: Record<string, unknown>;
+        timeout: number;
+        handler: string;
+        responseShaping?: {
+            maxLength: number;
+            path?: string | undefined;
+        } | undefined;
+        session_types?: string[] | undefined;
+        disabled?: boolean | undefined;
+    }, {
+        type: "function";
+        name: string;
+        displayName: string;
+        description: string;
+        parameters: Record<string, unknown>;
+        handler: string;
+        responseShaping?: {
+            path?: string | undefined;
+            maxLength?: number | undefined;
+        } | undefined;
+        timeout?: number | undefined;
+        session_types?: string[] | undefined;
+        disabled?: boolean | undefined;
+    }>]>, "many">>;
+    /** Skill definitions */
+    skills: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        /** Skill name (used for activation) */
+        name: z.ZodString;
+        /** Short description (shown to LLM in system prompt) */
+        description: z.ZodString;
+        /** Full skill body (SKILL.md content, loaded on activation) */
+        body: z.ZodString;
+        /** Knowledge base documents to auto-load when this skill activates. */
+        knowledge: z.ZodOptional<z.ZodObject<{
+            /** Docs matching any of these tags are auto-loaded on skill activation. */
+            tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /** Restrict to a specific scope, or 'all' for both application and tenant. Default: 'all'. */
+            scope: z.ZodOptional<z.ZodEnum<["application", "tenant", "all"]>>;
+        }, "strip", z.ZodTypeAny, {
+            scope?: "application" | "tenant" | "all" | undefined;
+            tags?: string[] | undefined;
+        }, {
+            scope?: "application" | "tenant" | "all" | undefined;
+            tags?: string[] | undefined;
+        }>>;
+        /** Session types where this skill is available. Empty/undefined = all. */
+        session_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        body: string;
+        name: string;
+        description: string;
+        session_types?: string[] | undefined;
+        knowledge?: {
+            scope?: "application" | "tenant" | "all" | undefined;
+            tags?: string[] | undefined;
+        } | undefined;
+    }, {
+        body: string;
+        name: string;
+        description: string;
+        session_types?: string[] | undefined;
+        knowledge?: {
+            scope?: "application" | "tenant" | "all" | undefined;
+            tags?: string[] | undefined;
+        } | undefined;
+    }>, "many">>;
+    /** Handler definitions keyed by handler name */
+    handlers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        /** Entry point filename (e.g., "compute-risk.ts") */
+        entry: z.ZodString;
+        /** Map of filename → source code */
+        files: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        entry: string;
+        files: Record<string, string>;
+    }, {
+        entry: string;
+        files: Record<string, string>;
+    }>>>;
+    /** External dependencies */
+    dependencies: z.ZodDefault<z.ZodObject<{
+        /** npm packages: { name: version } */
+        npm: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /** pip packages: { name: version } */
+        pip: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /** System binaries that must be available (checked via `which`) */
+        system: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        system?: string[] | undefined;
+        npm?: Record<string, string> | undefined;
+        pip?: Record<string, string> | undefined;
+    }, {
+        system?: string[] | undefined;
+        npm?: Record<string, string> | undefined;
+        pip?: Record<string, string> | undefined;
+    }>>;
+    /** Role definitions */
+    roles: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        tools: z.ZodArray<z.ZodString, "many">;
+        skills: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        automations: z.ZodDefault<z.ZodObject<{
+            can_view: z.ZodDefault<z.ZodBoolean>;
+            can_create: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            can_view: boolean;
+            can_create: boolean;
+        }, {
+            can_view?: boolean | undefined;
+            can_create?: boolean | undefined;
+        }>>;
+        constraints: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        tools: string[];
+        skills: string[];
+        automations: {
+            can_view: boolean;
+            can_create: boolean;
+        };
+        constraints: Record<string, unknown>;
+    }, {
+        name: string;
+        tools: string[];
+        skills?: string[] | undefined;
+        automations?: {
+            can_view?: boolean | undefined;
+            can_create?: boolean | undefined;
+        } | undefined;
+        constraints?: Record<string, unknown> | undefined;
+    }>, "many">>;
+    /** Automation definitions */
+    automations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        /** Unique automation name */
+        name: z.ZodString;
+        /** How this automation is triggered */
+        trigger: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"cron">;
+            schedule: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "cron";
+            schedule: string;
+        }, {
+            type: "cron";
+            schedule: string;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"webhook">;
+            /** Event source identifier */
+            source: z.ZodString;
+            /** Optional filter expression for the webhook payload */
+            filter: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "webhook";
+            source: string;
+            filter?: string | undefined;
+        }, {
+            type: "webhook";
+            source: string;
+            filter?: string | undefined;
+        }>]>;
+        /** The prompt sent to the agent when triggered */
+        prompt: z.ZodString;
+        /** Tools available during this automation's session */
+        tools: z.ZodArray<z.ZodString, "many">;
+        /** Skills available during this automation's session */
+        skills: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /** Where to send the automation's output */
+        output: z.ZodObject<{
+            /** Output channel type */
+            channel: z.ZodEnum<["slack", "webhook", "email"]>;
+            /** Channel-specific target (URL, email address, etc.) */
+            target: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            channel: "webhook" | "email" | "slack";
+            target: string;
+        }, {
+            channel: "webhook" | "email" | "slack";
+            target: string;
+        }>;
+        /** Session constraints */
+        constraints: z.ZodOptional<z.ZodObject<{
+            /** Maximum number of tool calls per automation run */
+            max_tool_calls: z.ZodOptional<z.ZodNumber>;
+            /** Timeout in seconds for the entire automation run */
+            timeout_seconds: z.ZodOptional<z.ZodNumber>;
+            /** Maximum tokens for the LLM response */
+            max_tokens: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            max_tokens?: number | undefined;
+            max_tool_calls?: number | undefined;
+            timeout_seconds?: number | undefined;
+        }, {
+            max_tokens?: number | undefined;
+            max_tool_calls?: number | undefined;
+            timeout_seconds?: number | undefined;
+        }>>;
+        /** Whether write operations are allowed (default false — safety guardrail) */
+        allow_writes: z.ZodDefault<z.ZodBoolean>;
+        /** Session types where this automation is available. Empty/undefined = all. */
+        session_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        tools: string[];
+        output: {
+            channel: "webhook" | "email" | "slack";
+            target: string;
+        };
+        skills: string[];
+        trigger: {
+            type: "cron";
+            schedule: string;
+        } | {
+            type: "webhook";
+            source: string;
+            filter?: string | undefined;
+        };
+        prompt: string;
+        allow_writes: boolean;
+        constraints?: {
+            max_tokens?: number | undefined;
+            max_tool_calls?: number | undefined;
+            timeout_seconds?: number | undefined;
+        } | undefined;
+        session_types?: string[] | undefined;
+    }, {
+        name: string;
+        tools: string[];
+        output: {
+            channel: "webhook" | "email" | "slack";
+            target: string;
+        };
+        trigger: {
+            type: "cron";
+            schedule: string;
+        } | {
+            type: "webhook";
+            source: string;
+            filter?: string | undefined;
+        };
+        prompt: string;
+        skills?: string[] | undefined;
+        constraints?: {
+            max_tokens?: number | undefined;
+            max_tool_calls?: number | undefined;
+            timeout_seconds?: number | undefined;
+        } | undefined;
+        allow_writes?: boolean | undefined;
+        session_types?: string[] | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    roles: {
+        name: string;
+        tools: string[];
+        skills: string[];
+        automations: {
+            can_view: boolean;
+            can_create: boolean;
+        };
+        constraints: Record<string, unknown>;
+    }[];
+    dependencies: {
+        system?: string[] | undefined;
+        npm?: Record<string, string> | undefined;
+        pip?: Record<string, string> | undefined;
+    };
+    tools: ({
+        type: "http";
+        method: "POST" | "GET" | "PUT" | "PATCH" | "DELETE";
+        name: string;
+        displayName: string;
+        description: string;
+        urlTemplate: string;
+        parameters: Record<string, unknown>;
+        timeout: number;
+        headers?: Record<string, string> | undefined;
+        bodyTemplate?: string | Record<string, unknown> | undefined;
+        queryParams?: Record<string, string> | undefined;
+        responseShaping?: {
+            maxLength: number;
+            path?: string | undefined;
+        } | undefined;
+        session_types?: string[] | undefined;
+        disabled?: boolean | undefined;
+    } | {
+        type: "chain";
+        name: string;
+        displayName: string;
+        description: string;
+        parameters: Record<string, unknown>;
+        timeout: number;
+        merge: string | Record<string, unknown>;
+        steps: {
+            method: "POST" | "GET" | "PUT" | "PATCH" | "DELETE";
+            name: string;
+            urlTemplate: string;
+            timeout: number;
+            headers?: Record<string, string> | undefined;
+            bodyTemplate?: string | Record<string, unknown> | undefined;
+            queryParams?: Record<string, string> | undefined;
+            responseShaping?: {
+                maxLength: number;
+                path?: string | undefined;
+            } | undefined;
+        }[];
+        responseShaping?: {
+            maxLength: number;
+            path?: string | undefined;
+        } | undefined;
+        session_types?: string[] | undefined;
+        disabled?: boolean | undefined;
+    } | {
+        type: "function";
+        name: string;
+        displayName: string;
+        description: string;
+        parameters: Record<string, unknown>;
+        timeout: number;
+        handler: string;
+        responseShaping?: {
+            maxLength: number;
+            path?: string | undefined;
+        } | undefined;
+        session_types?: string[] | undefined;
+        disabled?: boolean | undefined;
+    })[];
+    skills: {
+        body: string;
+        name: string;
+        description: string;
+        session_types?: string[] | undefined;
+        knowledge?: {
+            scope?: "application" | "tenant" | "all" | undefined;
+            tags?: string[] | undefined;
+        } | undefined;
+    }[];
+    automations: {
+        name: string;
+        tools: string[];
+        output: {
+            channel: "webhook" | "email" | "slack";
+            target: string;
+        };
+        skills: string[];
+        trigger: {
+            type: "cron";
+            schedule: string;
+        } | {
+            type: "webhook";
+            source: string;
+            filter?: string | undefined;
+        };
+        prompt: string;
+        allow_writes: boolean;
+        constraints?: {
+            max_tokens?: number | undefined;
+            max_tool_calls?: number | undefined;
+            timeout_seconds?: number | undefined;
+        } | undefined;
+        session_types?: string[] | undefined;
+    }[];
+    handlers: Record<string, {
+        entry: string;
+        files: Record<string, string>;
+    }>;
+    published_at?: string | undefined;
+    published_by?: string | undefined;
+}, {
+    version: string;
+    roles?: {
+        name: string;
+        tools: string[];
+        skills?: string[] | undefined;
+        automations?: {
+            can_view?: boolean | undefined;
+            can_create?: boolean | undefined;
+        } | undefined;
+        constraints?: Record<string, unknown> | undefined;
+    }[] | undefined;
+    dependencies?: {
+        system?: string[] | undefined;
+        npm?: Record<string, string> | undefined;
+        pip?: Record<string, string> | undefined;
+    } | undefined;
+    tools?: ({
+        type: "http";
+        method: "POST" | "GET" | "PUT" | "PATCH" | "DELETE";
+        name: string;
+        displayName: string;
+        description: string;
+        urlTemplate: string;
+        parameters: Record<string, unknown>;
+        headers?: Record<string, string> | undefined;
+        bodyTemplate?: string | Record<string, unknown> | undefined;
+        queryParams?: Record<string, string> | undefined;
+        responseShaping?: {
+            path?: string | undefined;
+            maxLength?: number | undefined;
+        } | undefined;
+        timeout?: number | undefined;
+        session_types?: string[] | undefined;
+        disabled?: boolean | undefined;
+    } | {
+        type: "chain";
+        name: string;
+        displayName: string;
+        description: string;
+        parameters: Record<string, unknown>;
+        merge: string | Record<string, unknown>;
+        steps: {
+            method: "POST" | "GET" | "PUT" | "PATCH" | "DELETE";
+            name: string;
+            urlTemplate: string;
+            headers?: Record<string, string> | undefined;
+            bodyTemplate?: string | Record<string, unknown> | undefined;
+            queryParams?: Record<string, string> | undefined;
+            responseShaping?: {
+                path?: string | undefined;
+                maxLength?: number | undefined;
+            } | undefined;
+            timeout?: number | undefined;
+        }[];
+        responseShaping?: {
+            path?: string | undefined;
+            maxLength?: number | undefined;
+        } | undefined;
+        timeout?: number | undefined;
+        session_types?: string[] | undefined;
+        disabled?: boolean | undefined;
+    } | {
+        type: "function";
+        name: string;
+        displayName: string;
+        description: string;
+        parameters: Record<string, unknown>;
+        handler: string;
+        responseShaping?: {
+            path?: string | undefined;
+            maxLength?: number | undefined;
+        } | undefined;
+        timeout?: number | undefined;
+        session_types?: string[] | undefined;
+        disabled?: boolean | undefined;
+    })[] | undefined;
+    skills?: {
+        body: string;
+        name: string;
+        description: string;
+        session_types?: string[] | undefined;
+        knowledge?: {
+            scope?: "application" | "tenant" | "all" | undefined;
+            tags?: string[] | undefined;
+        } | undefined;
+    }[] | undefined;
+    automations?: {
+        name: string;
+        tools: string[];
+        output: {
+            channel: "webhook" | "email" | "slack";
+            target: string;
+        };
+        trigger: {
+            type: "cron";
+            schedule: string;
+        } | {
+            type: "webhook";
+            source: string;
+            filter?: string | undefined;
+        };
+        prompt: string;
+        skills?: string[] | undefined;
+        constraints?: {
+            max_tokens?: number | undefined;
+            max_tool_calls?: number | undefined;
+            timeout_seconds?: number | undefined;
+        } | undefined;
+        allow_writes?: boolean | undefined;
+        session_types?: string[] | undefined;
+    }[] | undefined;
+    published_at?: string | undefined;
+    published_by?: string | undefined;
+    handlers?: Record<string, {
+        entry: string;
+        files: Record<string, string>;
+    }> | undefined;
+}>;
+export type AutomationTrigger = z.infer<typeof AutomationTriggerSchema>;
+export type AutomationOutput = z.infer<typeof AutomationOutputSchema>;
+export type AutomationConstraints = z.infer<typeof AutomationConstraintsSchema>;
+export type AutomationDefinition = z.infer<typeof AutomationDefinitionSchema>;
+export type BundleToolConfig = z.infer<typeof BundleToolConfigSchema>;
+export type BundleHandler = z.infer<typeof BundleHandlerSchema>;
+export type BundleDependencies = z.infer<typeof BundleDependenciesSchema>;
+export type BundleSkill = z.infer<typeof BundleSkillSchema>;
+export type SubagentConfig = z.infer<typeof SubagentConfigSchema>;
+export type VersionBundle = z.infer<typeof VersionBundleSchema>;