@amodalai/core 0.1.0

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

@@ -0,0 +1,76 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { z } from 'zod';
+import type { ConnectionsMap } from '../templates/connections.js';
+/**
+ * Context passed to function tool handlers.
+ */
+export interface FunctionToolContext {
+    /** The global fetch function for making HTTP requests */
+    fetch: typeof globalThis.fetch;
+    /** Connection configs (API keys, base URLs) */
+    connections: ConnectionsMap;
+}
+/**
+ * A function tool handler — custom code that executes when the tool is called.
+ */
+export type FunctionToolHandler = (params: Record<string, unknown>, context: FunctionToolContext) => Promise<unknown>;
+/**
+ * Map of handler names to handler functions.
+ * Populated from version bundle in Step 8; passed in directly for now.
+ */
+export type FunctionHandlerMap = Map<string, FunctionToolHandler>;
+/**
+ * Schema for a function tool configuration.
+ */
+export declare const FunctionToolConfigSchema: z.ZodObject<{
+    /** Internal tool name */
+    name: z.ZodString;
+    /** User-facing display name */
+    displayName: z.ZodString;
+    /** Description shown to the LLM */
+    description: z.ZodString;
+    /** Handler name — must match a key in the FunctionHandlerMap */
+    handler: z.ZodString;
+    /** JSON Schema describing parameters the LLM should provide */
+    parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /** Response shaping for the handler 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;
+    }>>;
+    /** Execution timeout in milliseconds */
+    timeout: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    displayName: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    timeout: number;
+    handler: string;
+    responseShaping?: {
+        maxLength: number;
+        path?: string | undefined;
+    } | undefined;
+}, {
+    name: string;
+    displayName: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    handler: string;
+    responseShaping?: {
+        path?: string | undefined;
+        maxLength?: number | undefined;
+    } | undefined;
+    timeout?: number | undefined;
+}>;
+export type FunctionToolConfig = z.infer<typeof FunctionToolConfigSchema>;

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

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { z } from 'zod';
+import { ResponseShapingSchema } from './http-tool-types.js';
+/**
+ * Schema for a function tool configuration.
+ */
+export const FunctionToolConfigSchema = 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),
+    /** Handler name — must match a key in the FunctionHandlerMap */
+    handler: z.string().min(1),
+    /** JSON Schema describing parameters the LLM should provide */
+    parameters: z.record(z.unknown()),
+    /** Response shaping for the handler result */
+    responseShaping: ResponseShapingSchema.optional(),
+    /** Execution timeout in milliseconds */
+    timeout: z.number().int().positive().default(30000),
+});
+//# sourceMappingURL=function-tool-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"function-tool-types.js","sourceRoot":"","sources":["../../../src/tools/function-tool-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AA2B7D;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,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,gEAAgE;IAChE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,+DAA+D;IAC/D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjC,8CAA8C;IAC9C,eAAe,EAAE,qBAAqB,CAAC,QAAQ,EAAE;IACjD,wCAAwC;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACpD,CAAC,CAAC"}

package/dist/src/tools/function-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 { FunctionToolConfig, FunctionToolHandler } from './function-tool-types.js';
+import type { ConnectionsMap } from '../templates/connections.js';
+import type { MessageBus } from '@google/gemini-cli-core';
+type FunctionToolParams = Record<string, unknown>;
+/**
+ * Invocation for a function tool call — executes a custom handler.
+ */
+export declare class FunctionToolInvocation extends BaseToolInvocation<FunctionToolParams, ToolResult> {
+    private readonly config;
+    private readonly handler;
+    private readonly connections;
+    constructor(params: FunctionToolParams, messageBus: MessageBus, toolName: string, toolDisplayName: string, config: FunctionToolConfig, handler: FunctionToolHandler, connections: ConnectionsMap);
+    getDescription(): string;
+    execute(signal: AbortSignal): Promise<ToolResult>;
+    private errorResult;
+}
+/**
+ * A function tool — executes a custom handler from the version bundle.
+ * Uses Kind.Execute which triggers confirmation via MUTATOR_KINDS.
+ */
+export declare class FunctionTool extends BaseDeclarativeTool<FunctionToolParams, ToolResult> {
+    private readonly functionConfig;
+    private readonly handler;
+    private readonly connections;
+    constructor(functionConfig: FunctionToolConfig, handler: FunctionToolHandler, connections: ConnectionsMap, messageBus: MessageBus);
+    protected createInvocation(params: FunctionToolParams, messageBus: MessageBus, toolName?: string, toolDisplayName?: string): ToolInvocation<FunctionToolParams, ToolResult>;
+}
+export {};

package/dist/src/tools/function-tool.js

@@ -0,0 +1,97 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, } from '@google/gemini-cli-core';
+import { ToolErrorType } from '@google/gemini-cli-core';
+import { shapeResponse } from './tool-utils.js';
+/**
+ * Invocation for a function tool call — executes a custom handler.
+ */
+export class FunctionToolInvocation extends BaseToolInvocation {
+    config;
+    handler;
+    connections;
+    constructor(params, messageBus, toolName, toolDisplayName, config, handler, connections) {
+        super(params, messageBus, toolName, toolDisplayName);
+        this.config = config;
+        this.handler = handler;
+        this.connections = connections;
+    }
+    getDescription() {
+        return `Function: ${this.config.handler}`;
+    }
+    async execute(signal) {
+        const context = {
+            fetch: globalThis.fetch.bind(globalThis),
+            connections: this.connections,
+        };
+        // Execute with timeout
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        // Forward external abort
+        if (signal.aborted) {
+            clearTimeout(timeoutId);
+            return this.errorResult(ToolErrorType.EXECUTION_FAILED, 'Function aborted before execution');
+        }
+        signal.addEventListener('abort', () => controller.abort(), { once: true });
+        try {
+            const resultPromise = this.handler(this.params, context);
+            // Race against timeout
+            const result = await Promise.race([
+                resultPromise,
+                new Promise((_resolve, reject) => {
+                    controller.signal.addEventListener('abort', () => {
+                        reject(new Error(`Function handler timed out after ${this.config.timeout}ms`));
+                    }, { once: true });
+                }),
+            ]);
+            // Shape response
+            const shaped = shapeResponse(result, this.config.responseShaping);
+            return {
+                llmContent: shaped,
+                returnDisplay: shaped,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (message.includes('timed out')) {
+                return this.errorResult(ToolErrorType.EXECUTION_FAILED, message);
+            }
+            return this.errorResult(ToolErrorType.EXECUTION_FAILED, `Function handler "${this.config.handler}" failed: ${message}`);
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    errorResult(type, message) {
+        return {
+            llmContent: `Error: ${message}`,
+            returnDisplay: message,
+            error: { message, type },
+        };
+    }
+}
+/**
+ * A function tool — executes a custom handler from the version bundle.
+ * Uses Kind.Execute which triggers confirmation via MUTATOR_KINDS.
+ */
+export class FunctionTool extends BaseDeclarativeTool {
+    functionConfig;
+    handler;
+    connections;
+    constructor(functionConfig, handler, connections, messageBus) {
+        super(functionConfig.name, functionConfig.displayName, functionConfig.description, Kind.Execute, functionConfig.parameters, messageBus, false, // isOutputMarkdown
+        false, // canUpdateOutput
+        undefined, // extensionName
+        undefined);
+        this.functionConfig = functionConfig;
+        this.handler = handler;
+        this.connections = connections;
+    }
+    createInvocation(params, messageBus, toolName, toolDisplayName) {
+        return new FunctionToolInvocation(params, messageBus, toolName ?? this.name, toolDisplayName ?? this.displayName, this.functionConfig, this.handler, this.connections);
+    }
+}
+//# sourceMappingURL=function-tool.js.map

package/dist/src/tools/function-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-tool.js","sourceRoot":"","sources":["../../../src/tools/function-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,IAAI,GAGL,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAQxD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIhD;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,kBAG3C;IAMoB;IACA;IACA;IAPnB,YACE,MAA0B,EAC1B,UAAsB,EACtB,QAAgB,EAChB,eAAuB,EACN,MAA0B,EAC1B,OAA4B,EAC5B,WAA2B;QAE5C,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;QAJpC,WAAM,GAAN,MAAM,CAAoB;QAC1B,YAAO,GAAP,OAAO,CAAqB;QAC5B,gBAAW,GAAX,WAAW,CAAgB;IAG9C,CAAC;IAED,cAAc;QACZ,OAAO,aAAa,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAmB;QAC/B,MAAM,OAAO,GAAwB;YACnC,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;YACxC,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;QAEF,uBAAuB;QACvB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE5E,yBAAyB;QACzB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,OAAO,IAAI,CAAC,WAAW,CACrB,aAAa,CAAC,gBAAgB,EAC9B,mCAAmC,CACpC,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAE3E,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAEzD,uBAAuB;YACvB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;gBAChC,aAAa;gBACb,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;oBACtC,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;wBAC/C,MAAM,CAAC,IAAI,KAAK,CAAC,oCAAoC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;oBACjF,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBACrB,CAAC,CAAC;aACH,CAAC,CAAC;YAEH,iBAAiB;YACjB,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;YAElE,OAAO;gBACL,UAAU,EAAE,MAAM;gBAClB,aAAa,EAAE,MAAM;aACtB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClC,OAAO,IAAI,CAAC,WAAW,CACrB,aAAa,CAAC,gBAAgB,EAC9B,OAAO,CACR,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,CAAC,WAAW,CACrB,aAAa,CAAC,gBAAgB,EAC9B,qBAAqB,IAAI,CAAC,MAAM,CAAC,OAAO,aAAa,OAAO,EAAE,CAC/D,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,IAAmB,EAAE,OAAe;QACtD,OAAO;YACL,UAAU,EAAE,UAAU,OAAO,EAAE;YAC/B,aAAa,EAAE,OAAO;YACtB,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;SACzB,CAAC;IACJ,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,mBAAmD;IAEhE;IACA;IACA;IAHnB,YACmB,cAAkC,EAClC,OAA4B,EAC5B,WAA2B,EAC5C,UAAsB;QAEtB,KAAK,CACH,cAAc,CAAC,IAAI,EACnB,cAAc,CAAC,WAAW,EAC1B,cAAc,CAAC,WAAW,EAC1B,IAAI,CAAC,OAAO,EACZ,cAAc,CAAC,UAAU,EACzB,UAAU,EACV,KAAK,EAAE,mBAAmB;QAC1B,KAAK,EAAE,kBAAkB;QACzB,SAAS,EAAE,gBAAgB;QAC3B,SAAS,CACV,CAAC;QAhBe,mBAAc,GAAd,cAAc,CAAoB;QAClC,YAAO,GAAP,OAAO,CAAqB;QAC5B,gBAAW,GAAX,WAAW,CAAgB;IAe9C,CAAC;IAES,gBAAgB,CACxB,MAA0B,EAC1B,UAAsB,EACtB,QAAiB,EACjB,eAAwB;QAExB,OAAO,IAAI,sBAAsB,CAC/B,MAAM,EACN,UAAU,EACV,QAAQ,IAAI,IAAI,CAAC,IAAI,EACrB,eAAe,IAAI,IAAI,CAAC,WAAW,EACnC,IAAI,CAAC,cAAc,EACnB,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,WAAW,CACjB,CAAC;IACJ,CAAC;CACF"}

package/dist/src/tools/http-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 RegisterHttpToolsResult {
+    registered: string[];
+    errors: Array<{
+        index: number;
+        error: string;
+    }>;
+}
+/**
+ * Validate and register HTTP tool configs into the tool registry.
+ * Invalid configs produce errors but don't block other registrations.
+ */
+export declare function registerHttpTools(registry: ToolRegistry, configs: unknown[], connections: ConnectionsMap, messageBus: MessageBus): RegisterHttpToolsResult;

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

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { HttpToolConfigSchema } from './http-tool-types.js';
+import { HttpTool } from './http-tool.js';
+import { debugLogger } from '@google/gemini-cli-core';
+/**
+ * Validate and register HTTP tool configs into the tool registry.
+ * Invalid configs produce errors but don't block other registrations.
+ */
+export function registerHttpTools(registry, configs, connections, messageBus) {
+    const registered = [];
+    const errors = [];
+    for (let i = 0; i < configs.length; i++) {
+        const raw = configs[i];
+        const parsed = HttpToolConfigSchema.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(`HTTP tool config #${i} invalid: ${errorMsg}`);
+            continue;
+        }
+        const config = parsed.data;
+        const tool = new HttpTool(config, connections, messageBus);
+        registry.registerTool(tool);
+        registered.push(config.name);
+    }
+    return { registered, errors };
+}
+//# sourceMappingURL=http-tool-registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http-tool-registry.js","sourceRoot":"","sources":["../../../src/tools/http-tool-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAuB,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI1C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAOtD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,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,oBAAoB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACnD,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,qBAAqB,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC;YAC/D,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAmB,MAAM,CAAC,IAAI,CAAC;QAC3C,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QAC3D,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/http-tool-types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { z } from 'zod';
+/**
+ * Schema for response shaping configuration.
+ * Allows extracting a specific path from the response and truncating.
+ */
+export declare const ResponseShapingSchema: z.ZodObject<{
+    /** Dot-separated path to extract from JSON response (e.g., "data.items") */
+    path: z.ZodOptional<z.ZodString>;
+    /** Maximum length of the response string returned to the LLM */
+    maxLength: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    maxLength: number;
+    path?: string | undefined;
+}, {
+    path?: string | undefined;
+    maxLength?: number | undefined;
+}>;
+/**
+ * Schema for a single HTTP tool configuration.
+ */
+export declare const HttpToolConfigSchema: z.ZodObject<{
+    /** Internal tool name (used in API calls) */
+    name: z.ZodString;
+    /** User-facing display name */
+    displayName: z.ZodString;
+    /** Description of what the tool does (shown to the LLM) */
+    description: 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 (values may contain {{}} expressions) */
+    queryParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /** Response shaping configuration */
+    responseShaping: z.ZodOptional<z.ZodObject<{
+        /** Dot-separated path to extract from JSON response (e.g., "data.items") */
+        path: z.ZodOptional<z.ZodString>;
+        /** Maximum length of the response string returned to the LLM */
+        maxLength: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxLength: number;
+        path?: string | undefined;
+    }, {
+        path?: string | undefined;
+        maxLength?: number | undefined;
+    }>>;
+    /** JSON Schema describing parameters the LLM should provide */
+    parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /** Request timeout in milliseconds */
+    timeout: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    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;
+}, {
+    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;
+}>;
+export type HttpToolConfig = z.infer<typeof HttpToolConfigSchema>;
+export type ResponseShaping = z.infer<typeof ResponseShapingSchema>;

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

@@ -0,0 +1,44 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { z } from 'zod';
+/**
+ * Schema for response shaping configuration.
+ * Allows extracting a specific path from the response and truncating.
+ */
+export const ResponseShapingSchema = z.object({
+    /** Dot-separated path to extract from JSON response (e.g., "data.items") */
+    path: z.string().optional(),
+    /** Maximum length of the response string returned to the LLM */
+    maxLength: z.number().int().positive().default(50000),
+});
+/**
+ * Schema for a single HTTP tool configuration.
+ */
+export const HttpToolConfigSchema = z.object({
+    /** Internal tool name (used in API calls) */
+    name: z.string().min(1),
+    /** User-facing display name */
+    displayName: z.string().min(1),
+    /** Description of what the tool does (shown to the LLM) */
+    description: 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 (values may contain {{}} expressions) */
+    queryParams: z.record(z.string()).optional(),
+    /** Response shaping configuration */
+    responseShaping: ResponseShapingSchema.optional(),
+    /** JSON Schema describing parameters the LLM should provide */
+    parameters: z.record(z.unknown()),
+    /** Request timeout in milliseconds */
+    timeout: z.number().int().positive().default(30000),
+});
+//# sourceMappingURL=http-tool-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http-tool-types.js","sourceRoot":"","sources":["../../../src/tools/http-tool-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,4EAA4E;IAC5E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,gEAAgE;IAChE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACtD,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,6CAA6C;IAC7C,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,2DAA2D;IAC3D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,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,sEAAsE;IACtE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,qCAAqC;IACrC,eAAe,EAAE,qBAAqB,CAAC,QAAQ,EAAE;IACjD,+DAA+D;IAC/D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjC,sCAAsC;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACpD,CAAC,CAAC"}

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

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, type ToolResult, type ToolInvocation } from '@google/gemini-cli-core';
+import type { HttpToolConfig } from './http-tool-types.js';
+import type { ConnectionsMap } from '../templates/connections.js';
+import type { MessageBus } from '@google/gemini-cli-core';
+type HttpToolParams = Record<string, unknown>;
+/**
+ * Invocation for an HTTP tool call.
+ */
+export declare class HttpToolInvocation extends BaseToolInvocation<HttpToolParams, ToolResult> {
+    private readonly config;
+    private readonly connections;
+    constructor(params: HttpToolParams, messageBus: MessageBus, toolName: string, toolDisplayName: string, config: HttpToolConfig, connections: ConnectionsMap);
+    getDescription(): string;
+    execute(signal: AbortSignal): Promise<ToolResult>;
+    private templateError;
+    private errorResult;
+}
+/**
+ * A declarative HTTP tool — configured via JSON, no custom code.
+ */
+export declare class HttpTool extends BaseDeclarativeTool<HttpToolParams, ToolResult> {
+    private readonly httpConfig;
+    private readonly connections;
+    constructor(httpConfig: HttpToolConfig, connections: ConnectionsMap, messageBus: MessageBus);
+    protected createInvocation(params: HttpToolParams, messageBus: MessageBus, toolName?: string, toolDisplayName?: string): ToolInvocation<HttpToolParams, ToolResult>;
+}
+export {};

package/dist/src/tools/http-tool.js

@@ -0,0 +1,176 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, } from '@google/gemini-cli-core';
+import { ToolErrorType } from '@google/gemini-cli-core';
+import { resolveTemplate, resolveTemplateObject, } from '../templates/template-resolver.js';
+import { isPrivateIp } from '@google/gemini-cli-core';
+import { httpFetch, shapeResponse, formatTemplateErrors } from './tool-utils.js';
+/**
+ * Invocation for an HTTP tool call.
+ */
+export class HttpToolInvocation extends BaseToolInvocation {
+    config;
+    connections;
+    constructor(params, messageBus, toolName, toolDisplayName, config, connections) {
+        super(params, messageBus, toolName, toolDisplayName);
+        this.config = config;
+        this.connections = connections;
+    }
+    getDescription() {
+        return `${this.config.method} ${this.config.urlTemplate}`;
+    }
+    async execute(signal) {
+        const context = {
+            connections: this.connections,
+            params: this.params,
+        };
+        // 1. Resolve URL template
+        const urlResult = resolveTemplate(this.config.urlTemplate, context);
+        if (urlResult.errors.length > 0) {
+            return this.templateError('URL', urlResult.errors);
+        }
+        // 2. Resolve query params and append to URL
+        let fullUrl = urlResult.value;
+        if (this.config.queryParams) {
+            const qpResult = resolveTemplateObject(this.config.queryParams, context);
+            if (qpResult.errors.length > 0) {
+                return this.templateError('query params', qpResult.errors);
+            }
+            const searchParams = new URLSearchParams();
+            for (const [key, val] of Object.entries(qpResult.value)) {
+                searchParams.append(key, String(val));
+            }
+            const sep = fullUrl.includes('?') ? '&' : '?';
+            fullUrl = `${fullUrl}${sep}${searchParams.toString()}`;
+        }
+        // 3. Validate URL
+        let parsedUrl;
+        try {
+            parsedUrl = new URL(fullUrl);
+        }
+        catch {
+            return this.errorResult(ToolErrorType.EXECUTION_FAILED, `Invalid URL: ${fullUrl}`);
+        }
+        if (!['http:', 'https:'].includes(parsedUrl.protocol)) {
+            return this.errorResult(ToolErrorType.EXECUTION_FAILED, `Unsupported protocol: ${parsedUrl.protocol}. Only http and https are allowed.`);
+        }
+        // 4. Private IP check
+        if (isPrivateIp(fullUrl)) {
+            return this.errorResult(ToolErrorType.EXECUTION_FAILED, `Request to private IP address blocked: ${parsedUrl.hostname}`);
+        }
+        // 5. Resolve headers
+        const baseHeaders = {
+            'Content-Type': 'application/json',
+        };
+        let resolvedHeaders = baseHeaders;
+        if (this.config.headers) {
+            const headersResult = resolveTemplateObject(this.config.headers, context);
+            if (headersResult.errors.length > 0) {
+                return this.templateError('headers', headersResult.errors);
+            }
+            resolvedHeaders = { ...baseHeaders, ...headersResult.value };
+        }
+        // 6. Resolve body for POST/PUT/PATCH
+        let body;
+        const methodsWithBody = ['POST', 'PUT', 'PATCH'];
+        if (methodsWithBody.includes(this.config.method) && this.config.bodyTemplate !== undefined) {
+            if (typeof this.config.bodyTemplate === 'string') {
+                const bodyResult = resolveTemplate(this.config.bodyTemplate, context);
+                if (bodyResult.errors.length > 0) {
+                    return this.templateError('body', bodyResult.errors);
+                }
+                body = bodyResult.value;
+            }
+            else {
+                const bodyResult = resolveTemplateObject(this.config.bodyTemplate, context);
+                if (bodyResult.errors.length > 0) {
+                    return this.templateError('body', bodyResult.errors);
+                }
+                body = JSON.stringify(bodyResult.value);
+            }
+        }
+        // 7. Make the HTTP request
+        let response;
+        try {
+            response = await httpFetch(fullUrl, {
+                method: this.config.method,
+                headers: resolvedHeaders,
+                body,
+                timeout: this.config.timeout,
+                signal,
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (message.includes('abort')) {
+                return this.errorResult(ToolErrorType.EXECUTION_FAILED, `Request timed out after ${this.config.timeout}ms`);
+            }
+            return this.errorResult(ToolErrorType.EXECUTION_FAILED, `HTTP request failed: ${message}`);
+        }
+        // 8. Handle HTTP errors
+        if (!response.ok) {
+            let errorBody;
+            try {
+                errorBody = await response.text();
+            }
+            catch {
+                errorBody = '';
+            }
+            const truncatedBody = errorBody.length > 500 ? errorBody.slice(0, 500) + '...' : errorBody;
+            return this.errorResult(ToolErrorType.EXECUTION_FAILED, `HTTP ${response.status} ${response.statusText}: ${truncatedBody}`);
+        }
+        // 9. Parse response
+        let responseData;
+        const contentType = response.headers.get('content-type') ?? '';
+        if (contentType.includes('application/json')) {
+            try {
+                responseData = await response.json();
+            }
+            catch {
+                responseData = await response.text();
+            }
+        }
+        else {
+            responseData = await response.text();
+        }
+        // 10. Shape response
+        const shaped = shapeResponse(responseData, this.config.responseShaping);
+        return {
+            llmContent: shaped,
+            returnDisplay: shaped,
+        };
+    }
+    templateError(location, errors) {
+        const msg = `Template resolution failed in ${location}:\n${formatTemplateErrors(errors)}`;
+        return this.errorResult(ToolErrorType.EXECUTION_FAILED, msg);
+    }
+    errorResult(type, message) {
+        return {
+            llmContent: `Error: ${message}`,
+            returnDisplay: message,
+            error: { message, type },
+        };
+    }
+}
+/**
+ * A declarative HTTP tool — configured via JSON, no custom code.
+ */
+export class HttpTool extends BaseDeclarativeTool {
+    httpConfig;
+    connections;
+    constructor(httpConfig, connections, messageBus) {
+        super(httpConfig.name, httpConfig.displayName, httpConfig.description, Kind.Fetch, httpConfig.parameters, messageBus, false, // isOutputMarkdown
+        false, // canUpdateOutput
+        undefined, // extensionName
+        undefined);
+        this.httpConfig = httpConfig;
+        this.connections = connections;
+    }
+    createInvocation(params, messageBus, toolName, toolDisplayName) {
+        return new HttpToolInvocation(params, messageBus, toolName ?? this.name, toolDisplayName ?? this.displayName, this.httpConfig, this.connections);
+    }
+}
+//# sourceMappingURL=http-tool.js.map