@amodalai/core 0.1.0

package/dist/src/tool-registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registration.js","sourceRoot":"","sources":["../../src/tool-registration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,kCAAkC,CAAC;AAE1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAAgB,EAChB,MAAc;IAEd,MAAM,QAAQ,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;IAC1C,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;IAE1C,+DAA+D;IAC/D,MAAM,cAAc,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC;IAC/C,MAAM,cAAc,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC;IAC/C,IAAI,cAAc,IAAI,cAAc,EAAE,CAAC;QACrC,QAAQ,CAAC,YAAY,CAAC,IAAI,oBAAoB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,+CAA+C;IAC/C,MAAM,KAAK,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,KAAK,CAAC,eAAe,EAAE,CAAC;IACxC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,QAAQ,CAAC,YAAY,CAAC,IAAI,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,2CAA2C;IAC3C,QAAQ,CAAC,YAAY,CAAC,IAAI,WAAW,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;IAExD,iDAAiD;IACjD,MAAM,WAAW,GAAG,GAAG,CAAC,cAAc,EAAE,CAAC;IACzC,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,QAAQ,CAAC,YAAY,CAAC,IAAI,WAAW,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED,qDAAqD;IACrD,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;IAC/B,MAAM,YAAY,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC;IAC3C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,YAAY,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,IAAI,SAAS,CAAC;QAChD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,QAAQ,CAAC,YAAY,CAAC,IAAI,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;QACvF,CAAC;QACD,QAAQ,CAAC,YAAY,CAAC,IAAI,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;IACxF,CAAC;AACH,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/src/tools/amodal-tool-errors.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Extended tool error types for amodal custom tools.
+ * These supplement the upstream ToolErrorType enum.
+ */
+export declare const AmodalToolErrorType: {
+    readonly HTTP_TOOL_INVALID_URL: "http_tool_invalid_url";
+    readonly HTTP_TOOL_PRIVATE_IP: "http_tool_private_ip";
+    readonly HTTP_TOOL_REQUEST_FAILED: "http_tool_request_failed";
+    readonly HTTP_TOOL_RESPONSE_ERROR: "http_tool_response_error";
+    readonly HTTP_TOOL_TEMPLATE_ERROR: "http_tool_template_error";
+    readonly CHAIN_TOOL_TIMEOUT: "chain_tool_timeout";
+    readonly CHAIN_TOOL_STEP_FAILED: "chain_tool_step_failed";
+    readonly CHAIN_TOOL_INVALID_URL: "chain_tool_invalid_url";
+    readonly CHAIN_TOOL_PRIVATE_IP: "chain_tool_private_ip";
+    readonly CHAIN_TOOL_MERGE_ERROR: "chain_tool_merge_error";
+    readonly CHAIN_TOOL_TEMPLATE_ERROR: "chain_tool_template_error";
+    readonly FUNCTION_TOOL_TIMEOUT: "function_tool_timeout";
+    readonly FUNCTION_TOOL_EXECUTION_ERROR: "function_tool_execution_error";
+};

package/dist/src/tools/amodal-tool-errors.js

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Extended tool error types for amodal custom tools.
+ * These supplement the upstream ToolErrorType enum.
+ */
+export const AmodalToolErrorType = {
+    // HTTP tool errors
+    HTTP_TOOL_INVALID_URL: 'http_tool_invalid_url',
+    HTTP_TOOL_PRIVATE_IP: 'http_tool_private_ip',
+    HTTP_TOOL_REQUEST_FAILED: 'http_tool_request_failed',
+    HTTP_TOOL_RESPONSE_ERROR: 'http_tool_response_error',
+    HTTP_TOOL_TEMPLATE_ERROR: 'http_tool_template_error',
+    // Chain tool errors
+    CHAIN_TOOL_TIMEOUT: 'chain_tool_timeout',
+    CHAIN_TOOL_STEP_FAILED: 'chain_tool_step_failed',
+    CHAIN_TOOL_INVALID_URL: 'chain_tool_invalid_url',
+    CHAIN_TOOL_PRIVATE_IP: 'chain_tool_private_ip',
+    CHAIN_TOOL_MERGE_ERROR: 'chain_tool_merge_error',
+    CHAIN_TOOL_TEMPLATE_ERROR: 'chain_tool_template_error',
+    // Function tool errors
+    FUNCTION_TOOL_TIMEOUT: 'function_tool_timeout',
+    FUNCTION_TOOL_EXECUTION_ERROR: 'function_tool_execution_error',
+};
+//# sourceMappingURL=amodal-tool-errors.js.map

package/dist/src/tools/amodal-tool-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"amodal-tool-errors.js","sourceRoot":"","sources":["../../../src/tools/amodal-tool-errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,mBAAmB;IACnB,qBAAqB,EAAE,uBAAuB;IAC9C,oBAAoB,EAAE,sBAAsB;IAC5C,wBAAwB,EAAE,0BAA0B;IACpD,wBAAwB,EAAE,0BAA0B;IACpD,wBAAwB,EAAE,0BAA0B;IAEpD,oBAAoB;IACpB,kBAAkB,EAAE,oBAAoB;IACxC,sBAAsB,EAAE,wBAAwB;IAChD,sBAAsB,EAAE,wBAAwB;IAChD,qBAAqB,EAAE,uBAAuB;IAC9C,sBAAsB,EAAE,wBAAwB;IAChD,yBAAyB,EAAE,2BAA2B;IAEtD,uBAAuB;IACvB,qBAAqB,EAAE,uBAAuB;IAC9C,6BAA6B,EAAE,+BAA+B;CACtD,CAAC"}

package/dist/src/tools/amodal-tool-names.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Tool name constants for amodal-specific tools.
+ * These tools are NOT part of upstream @google/gemini-cli-core.
+ */
+export declare const PROPOSE_KNOWLEDGE_TOOL_NAME = "propose_knowledge";
+export declare const LOAD_KNOWLEDGE_TOOL_NAME = "load_knowledge";
+export declare const PRESENT_TOOL_NAME = "present";
+export declare const REQUEST_TOOL_NAME = "request";
+export declare const DISPATCH_TOOL_NAME = "dispatch";

package/dist/src/tools/amodal-tool-names.js

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Tool name constants for amodal-specific tools.
+ * These tools are NOT part of upstream @google/gemini-cli-core.
+ */
+export const PROPOSE_KNOWLEDGE_TOOL_NAME = 'propose_knowledge';
+export const LOAD_KNOWLEDGE_TOOL_NAME = 'load_knowledge';
+export const PRESENT_TOOL_NAME = 'present';
+export const REQUEST_TOOL_NAME = 'request';
+export const DISPATCH_TOOL_NAME = 'dispatch';
+//# sourceMappingURL=amodal-tool-names.js.map

package/dist/src/tools/amodal-tool-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"amodal-tool-names.js","sourceRoot":"","sources":["../../../src/tools/amodal-tool-names.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,mBAAmB,CAAC;AAC/D,MAAM,CAAC,MAAM,wBAAwB,GAAG,gBAAgB,CAAC;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAC3C,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC"}

package/dist/src/tools/chain-tool-registry.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { ToolRegistry } from '@google/gemini-cli-core';
+import type { ConnectionsMap } from '../templates/connections.js';
+import type { MessageBus } from '@google/gemini-cli-core';
+export interface RegisterChainToolsResult {
+    registered: string[];
+    errors: Array<{
+        index: number;
+        error: string;
+    }>;
+}
+/**
+ * Validate and register chain tool configs into the tool registry.
+ * Invalid configs produce errors but don't block other registrations.
+ */
+export declare function registerChainTools(registry: ToolRegistry, configs: unknown[], connections: ConnectionsMap, messageBus: MessageBus): RegisterChainToolsResult;

package/dist/src/tools/chain-tool-registry.js

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { ChainToolConfigSchema } from './chain-tool-types.js';
+import { ChainTool } from './chain-tool.js';
+import { debugLogger } from '@google/gemini-cli-core';
+/**
+ * Validate and register chain tool configs into the tool registry.
+ * Invalid configs produce errors but don't block other registrations.
+ */
+export function registerChainTools(registry, configs, connections, messageBus) {
+    const registered = [];
+    const errors = [];
+    for (let i = 0; i < configs.length; i++) {
+        const raw = configs[i];
+        const parsed = ChainToolConfigSchema.safeParse(raw);
+        if (!parsed.success) {
+            const errorMsg = parsed.error.issues
+                .map((issue) => `${issue.path.join('.')}: ${issue.message}`)
+                .join('; ');
+            errors.push({ index: i, error: errorMsg });
+            debugLogger.log(`Chain tool config #${i} invalid: ${errorMsg}`);
+            continue;
+        }
+        const config = parsed.data;
+        // Validate unique step names
+        const stepNames = new Set();
+        let hasDuplicateSteps = false;
+        for (const step of config.steps) {
+            if (stepNames.has(step.name)) {
+                errors.push({ index: i, error: `Duplicate step name: "${step.name}"` });
+                debugLogger.log(`Chain tool config #${i} has duplicate step name: "${step.name}"`);
+                hasDuplicateSteps = true;
+                break;
+            }
+            stepNames.add(step.name);
+        }
+        if (hasDuplicateSteps) {
+            continue;
+        }
+        const tool = new ChainTool(config, connections, messageBus);
+        registry.registerTool(tool);
+        registered.push(config.name);
+    }
+    return { registered, errors };
+}
+//# sourceMappingURL=chain-tool-registry.js.map

package/dist/src/tools/chain-tool-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-tool-registry.js","sourceRoot":"","sources":["../../../src/tools/chain-tool-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAwB,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAOtD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAsB,EACtB,OAAkB,EAClB,WAA2B,EAC3B,UAAsB;IAEtB,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,MAAM,GAA4C,EAAE,CAAC;IAE3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;iBACjC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;iBAC3D,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC3C,WAAW,CAAC,GAAG,CAAC,sBAAsB,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC;YAChE,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAoB,MAAM,CAAC,IAAI,CAAC;QAE5C,6BAA6B;QAC7B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QACpC,IAAI,iBAAiB,GAAG,KAAK,CAAC;QAC9B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,yBAAyB,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;gBACxE,WAAW,CAAC,GAAG,CAAC,sBAAsB,CAAC,8BAA8B,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;gBACnF,iBAAiB,GAAG,IAAI,CAAC;gBACzB,MAAM;YACR,CAAC;YACD,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,iBAAiB,EAAE,CAAC;YACtB,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QAC5D,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5B,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AAChC,CAAC"}

package/dist/src/tools/chain-tool-types.d.ts

@@ -0,0 +1,190 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { z } from 'zod';
+/**
+ * Schema for a single step in a chain tool.
+ */
+export declare const ChainStepSchema: z.ZodObject<{
+    /** Unique name for this step (used in merge template references) */
+    name: z.ZodString;
+    /** HTTP method */
+    method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>;
+    /** URL template with {{connections.x}} and {{params.x}} placeholders */
+    urlTemplate: z.ZodString;
+    /** Header templates (values may contain {{}} expressions) */
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /** Body template for POST/PUT/PATCH — string or object (values resolved) */
+    bodyTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+    /** Query parameter templates */
+    queryParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /** Per-step timeout in milliseconds */
+    timeout: z.ZodDefault<z.ZodNumber>;
+    /** Response shaping for this step's result before merging */
+    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;
+}>;
+/**
+ * Schema for a chain tool configuration.
+ */
+export declare const ChainToolConfigSchema: z.ZodObject<{
+    /** Internal tool name */
+    name: z.ZodString;
+    /** User-facing display name */
+    displayName: z.ZodString;
+    /** Description shown to the LLM */
+    description: z.ZodString;
+    /** Ordered list of steps to execute in parallel */
+    steps: z.ZodArray<z.ZodObject<{
+        /** Unique name for this step (used in merge template references) */
+        name: z.ZodString;
+        /** HTTP method */
+        method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>;
+        /** URL template with {{connections.x}} and {{params.x}} placeholders */
+        urlTemplate: z.ZodString;
+        /** Header templates (values may contain {{}} expressions) */
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /** Body template for POST/PUT/PATCH — string or object (values resolved) */
+        bodyTemplate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+        /** Query parameter templates */
+        queryParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /** Per-step timeout in milliseconds */
+        timeout: z.ZodDefault<z.ZodNumber>;
+        /** Response shaping for this step's result before merging */
+        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 template combining step results. String or object with {{steps.NAME.path}} */
+    merge: z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
+    /** JSON Schema describing parameters the LLM should provide */
+    parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /** Response shaping for the final merged result */
+    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;
+    }>>;
+    /** Aggregate timeout for all steps in milliseconds */
+    timeout: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    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;
+}, {
+    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;
+}>;
+export type ChainStep = z.infer<typeof ChainStepSchema>;
+export type ChainToolConfig = z.infer<typeof ChainToolConfigSchema>;

package/dist/src/tools/chain-tool-types.js

@@ -0,0 +1,50 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { z } from 'zod';
+import { ResponseShapingSchema } from './http-tool-types.js';
+/**
+ * Schema for a single step in a chain tool.
+ */
+export const ChainStepSchema = z.object({
+    /** Unique name for this step (used in merge template references) */
+    name: z.string().min(1),
+    /** HTTP method */
+    method: z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']),
+    /** URL template with {{connections.x}} and {{params.x}} placeholders */
+    urlTemplate: z.string().min(1),
+    /** Header templates (values may contain {{}} expressions) */
+    headers: z.record(z.string()).optional(),
+    /** Body template for POST/PUT/PATCH — string or object (values resolved) */
+    bodyTemplate: z.union([z.string(), z.record(z.unknown())]).optional(),
+    /** Query parameter templates */
+    queryParams: z.record(z.string()).optional(),
+    /** Per-step timeout in milliseconds */
+    timeout: z.number().int().positive().default(30000),
+    /** Response shaping for this step's result before merging */
+    responseShaping: ResponseShapingSchema.optional(),
+});
+/**
+ * Schema for a chain tool configuration.
+ */
+export const ChainToolConfigSchema = z.object({
+    /** Internal tool name */
+    name: z.string().min(1),
+    /** User-facing display name */
+    displayName: z.string().min(1),
+    /** Description shown to the LLM */
+    description: z.string().min(1),
+    /** Ordered list of steps to execute in parallel */
+    steps: z.array(ChainStepSchema).min(1),
+    /** Merge template combining step results. String or object with {{steps.NAME.path}} */
+    merge: z.union([z.string(), z.record(z.unknown())]),
+    /** JSON Schema describing parameters the LLM should provide */
+    parameters: z.record(z.unknown()),
+    /** Response shaping for the final merged result */
+    responseShaping: ResponseShapingSchema.optional(),
+    /** Aggregate timeout for all steps in milliseconds */
+    timeout: z.number().int().positive().default(60000),
+});
+//# sourceMappingURL=chain-tool-types.js.map

package/dist/src/tools/chain-tool-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-tool-types.js","sourceRoot":"","sources":["../../../src/tools/chain-tool-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,oEAAoE;IACpE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,kBAAkB;IAClB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACzD,wEAAwE;IACxE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,6DAA6D;IAC7D,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,4EAA4E;IAC5E,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACrE,gCAAgC;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,uCAAuC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACnD,6DAA6D;IAC7D,eAAe,EAAE,qBAAqB,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,yBAAyB;IACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,+BAA+B;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,mCAAmC;IACnC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,mDAAmD;IACnD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,uFAAuF;IACvF,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACnD,+DAA+D;IAC/D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjC,mDAAmD;IACnD,eAAe,EAAE,qBAAqB,CAAC,QAAQ,EAAE;IACjD,sDAAsD;IACtD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACpD,CAAC,CAAC"}

package/dist/src/tools/chain-tool.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, type ToolResult, type ToolInvocation } from '@google/gemini-cli-core';
+import type { ChainToolConfig } from './chain-tool-types.js';
+import type { ConnectionsMap } from '../templates/connections.js';
+import type { MessageBus } from '@google/gemini-cli-core';
+type ChainToolParams = Record<string, unknown>;
+/**
+ * Invocation for a chain tool call — parallel HTTP steps merged into one result.
+ */
+export declare class ChainToolInvocation extends BaseToolInvocation<ChainToolParams, ToolResult> {
+    private readonly config;
+    private readonly connections;
+    constructor(params: ChainToolParams, messageBus: MessageBus, toolName: string, toolDisplayName: string, config: ChainToolConfig, connections: ConnectionsMap);
+    getDescription(): string;
+    execute(signal: AbortSignal): Promise<ToolResult>;
+    private executeStep;
+    private applyMerge;
+    private stepTemplateError;
+    private errorResult;
+}
+/**
+ * A declarative chain tool — parallel API calls merged into one response.
+ */
+export declare class ChainTool extends BaseDeclarativeTool<ChainToolParams, ToolResult> {
+    private readonly chainConfig;
+    private readonly connections;
+    constructor(chainConfig: ChainToolConfig, connections: ConnectionsMap, messageBus: MessageBus);
+    protected createInvocation(params: ChainToolParams, messageBus: MessageBus, toolName?: string, toolDisplayName?: string): ToolInvocation<ChainToolParams, ToolResult>;
+}
+export {};