@amodalai/runtime 0.1.26 → 0.2.0

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

@@ -0,0 +1,190 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Connection request tool rewritten for the new ToolRegistry.
+ *
+ * Makes HTTP requests through configured connections with:
+ * - Permission checking via PermissionChecker interface
+ * - Field scrubbing on responses
+ * - Intent-based write confirmation flow
+ * - Auth header injection from connection config
+ * - Environment variable expansion in endpoints
+ */
+import { z } from 'zod';
+import { ConnectionError } from '../errors.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export const REQUEST_TOOL_NAME = 'request';
+const REQUEST_TIMEOUT_MS = 30_000;
+// ---------------------------------------------------------------------------
+// Params schema
+// ---------------------------------------------------------------------------
+const RequestParamsSchema = z.object({
+    connection: z.string().min(1),
+    method: z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']),
+    endpoint: z.string().min(1),
+    params: z.record(z.string()).optional(),
+    data: z.unknown().optional(),
+    headers: z.record(z.string()).optional(),
+    intent: z.enum(['read', 'write', 'confirmed_write']),
+});
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Resolve auth template variables: "Bearer {{API_KEY}}" → "Bearer token123"
+ */
+function resolveAuthTemplate(template, connectionConfig) {
+    return template.replace(/\{\{(\w+)\}\}/g, (_match, varName) => {
+        const value = connectionConfig[varName];
+        return value !== undefined ? String(value) : '';
+    });
+}
+/**
+ * Expand $ENV_VAR references in a string using session-scoped env.
+ * Uses replaceAll loop instead of regex to avoid greedy matching
+ * ($FOO would incorrectly match inside $FOOBAR with regex).
+ */
+function expandEnvVars(value, sessionEnv) {
+    let result = value;
+    for (const [key, val] of Object.entries(sessionEnv)) {
+        result = result.replaceAll(`$${key}`, val);
+    }
+    return result;
+}
+/**
+ * Build headers from connection config auth + defaults + user overrides.
+ */
+function buildHeaders(connectionConfig, requestConfig, extraHeaders) {
+    const headers = {};
+    // Default headers from connection config
+    if (requestConfig?.default_headers) {
+        Object.assign(headers, requestConfig.default_headers);
+    }
+    // Auth headers
+    if (requestConfig?.auth) {
+        for (const authEntry of requestConfig.auth) {
+            headers[authEntry.header] = resolveAuthTemplate(authEntry.value_template, connectionConfig);
+        }
+    }
+    // User-provided headers (override defaults)
+    if (extraHeaders) {
+        Object.assign(headers, extraHeaders);
+    }
+    return headers;
+}
+/**
+ * Create the connection request tool.
+ */
+export function createRequestTool(options) {
+    const { connectionsMap, permissionChecker, fieldScrubber, sessionEnv = {}, readOnly = false, planModeActive } = options;
+    return {
+        description: 'Make an HTTP request to a configured connection. Use intent "write" for mutating operations (POST, PUT, PATCH, DELETE) — a preview will be shown first. Then call again with intent "confirmed_write" to execute.',
+        parameters: RequestParamsSchema,
+        readOnly: false,
+        metadata: { category: 'connection' },
+        async execute(params, ctx) {
+            const { connection, method, endpoint, data, headers: extraHeaders, intent } = params;
+            // Resolve connection config
+            const connConfig = connectionsMap[connection];
+            if (!connConfig) {
+                throw new ConnectionError(`Connection "${connection}" not found`, {
+                    connection,
+                    action: `${method} ${endpoint}`,
+                });
+            }
+            const requestConfig = connConfig['_request_config'];
+            const baseUrl = connConfig['base_url'];
+            if (!baseUrl || typeof baseUrl !== 'string') {
+                throw new ConnectionError(`Connection "${connection}" has no base_url configured`, {
+                    connection,
+                    action: `${method} ${endpoint}`,
+                });
+            }
+            // Build endpoint path
+            const endpointPath = `${method.toUpperCase()} ${endpoint}`;
+            // Permission check
+            const permission = permissionChecker.check({
+                connection,
+                endpointPath,
+                intent,
+                method,
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- data validated as object above
+                params: typeof data === 'object' && data !== null ? data : undefined,
+                readOnly,
+                planModeActive: planModeActive?.() ?? false,
+            });
+            if (!permission.allowed) {
+                return { error: permission.reason };
+            }
+            // Write preview flow
+            if (permission.allowed && permission.requiresConfirmation && intent === 'write') {
+                return {
+                    preview: true,
+                    method: method.toUpperCase(),
+                    endpoint,
+                    connection,
+                    reason: permission.reason,
+                    instruction: 'Call this tool again with intent "confirmed_write" to execute.',
+                };
+            }
+            // Build URL
+            const expandedEndpoint = expandEnvVars(endpoint, sessionEnv);
+            // Strip trailing/leading slashes without regex (CodeQL flags /\/+$/ on library input)
+            let cleanBase = baseUrl;
+            while (cleanBase.endsWith('/'))
+                cleanBase = cleanBase.slice(0, -1);
+            let cleanEndpoint = expandedEndpoint;
+            while (cleanEndpoint.startsWith('/'))
+                cleanEndpoint = cleanEndpoint.slice(1);
+            let url = `${cleanBase}/${cleanEndpoint}`;
+            // Append query params
+            if (params.params) {
+                const searchParams = new URLSearchParams();
+                for (const [key, value] of Object.entries(params.params)) {
+                    searchParams.set(key, expandEnvVars(String(value), sessionEnv));
+                }
+                url += `?${searchParams.toString()}`;
+            }
+            // Build headers
+            const resolvedHeaders = buildHeaders(connConfig, requestConfig, extraHeaders);
+            // Execute HTTP request
+            const fetchOptions = {
+                method: method.toUpperCase(),
+                headers: resolvedHeaders,
+                signal: ctx.signal ?? AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+            };
+            if (data !== undefined && ['POST', 'PUT', 'PATCH'].includes(method.toUpperCase())) {
+                fetchOptions.body = JSON.stringify(data);
+                resolvedHeaders['Content-Type'] = resolvedHeaders['Content-Type'] ?? 'application/json';
+            }
+            const response = await fetch(url, fetchOptions);
+            const responseText = await response.text();
+            let responseData;
+            try {
+                responseData = JSON.parse(responseText);
+            }
+            catch {
+                responseData = responseText;
+            }
+            // Field scrubbing
+            if (fieldScrubber && typeof responseData === 'object' && responseData !== null) {
+                const scrubResult = fieldScrubber.scrub(responseData, connection, endpointPath);
+                return {
+                    status: response.status,
+                    data: scrubResult.data,
+                    ...(scrubResult.strippedCount > 0 ? { fields_stripped: scrubResult.strippedCount } : {}),
+                };
+            }
+            return {
+                status: response.status,
+                data: responseData,
+            };
+        },
+    };
+}
+//# sourceMappingURL=request-tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"request-tool.js","sourceRoot":"","sources":["../../../src/tools/request-tool.ts"],"names":[],"mappings":"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"}

package/dist/src/tools/request-tool.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export {};

package/dist/src/tools/request-tool.test.js

@@ -0,0 +1,254 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { describe, it, expect, vi, beforeAll, afterAll } from 'vitest';
+import { createServer } from 'node:http';
+import { createRequestTool, REQUEST_TOOL_NAME } from './request-tool.js';
+import { ConnectionError } from '../errors.js';
+// ---------------------------------------------------------------------------
+// Mock HTTP server
+// ---------------------------------------------------------------------------
+let server;
+let baseUrl;
+beforeAll(async () => {
+    server = createServer((req, res) => {
+        // Echo back request details
+        let body = '';
+        req.on('data', (chunk) => {
+            body += chunk.toString();
+        });
+        req.on('end', () => {
+            res.setHeader('Content-Type', 'application/json');
+            res.end(JSON.stringify({
+                method: req.method,
+                url: req.url,
+                headers: req.headers,
+                body: body || undefined,
+            }));
+        });
+    });
+    await new Promise((resolve) => {
+        server.listen(0, '127.0.0.1', () => resolve());
+    });
+    const addr = server.address();
+    if (typeof addr === 'object' && addr !== null) {
+        baseUrl = `http://127.0.0.1:${String(addr.port)}`;
+    }
+});
+afterAll(() => {
+    server.close();
+});
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const allowAllChecker = {
+    check: () => ({ allowed: true }),
+};
+const confirmChecker = {
+    check: () => ({ allowed: true, requiresConfirmation: true, reason: 'Needs confirmation' }),
+};
+const denyChecker = {
+    check: () => ({ allowed: false, reason: 'Operation blocked' }),
+};
+function makeConnectionsMap(overrides = {}) {
+    return {
+        'test-api': {
+            base_url: baseUrl,
+            API_KEY: 'test-token-123',
+            _request_config: {
+                base_url_field: 'base_url',
+                auth: [{ header: 'Authorization', value_template: 'Bearer {{API_KEY}}' }],
+                default_headers: { 'X-Source': 'amodal' },
+            },
+            ...overrides,
+        },
+    };
+}
+const mockCtx = {
+    request: vi.fn(),
+    store: vi.fn(),
+    env: vi.fn(),
+    log: vi.fn(),
+    user: { roles: ['admin'] },
+    signal: AbortSignal.timeout(5000),
+    sessionId: 'test-session',
+    tenantId: 'test-tenant',
+};
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('createRequestTool', () => {
+    it('has correct name and metadata', () => {
+        const tool = createRequestTool({
+            connectionsMap: makeConnectionsMap(),
+            permissionChecker: allowAllChecker,
+        });
+        expect(tool.readOnly).toBe(false);
+        expect(tool.metadata?.category).toBe('connection');
+        expect(REQUEST_TOOL_NAME).toBe('request');
+    });
+    it('makes a GET request with auth headers', async () => {
+        const tool = createRequestTool({
+            connectionsMap: makeConnectionsMap(),
+            permissionChecker: allowAllChecker,
+        });
+        const result = await tool.execute({
+            connection: 'test-api',
+            method: 'GET',
+            endpoint: '/users',
+            intent: 'read',
+        }, mockCtx);
+        expect(result['status']).toBe(200);
+        const data = result['data'];
+        expect(data['method']).toBe('GET');
+        const headers = data['headers'];
+        expect(headers['authorization']).toBe('Bearer test-token-123');
+        expect(headers['x-source']).toBe('amodal');
+    });
+    it('makes a POST request with body', async () => {
+        const tool = createRequestTool({
+            connectionsMap: makeConnectionsMap(),
+            permissionChecker: allowAllChecker,
+        });
+        const result = await tool.execute({
+            connection: 'test-api',
+            method: 'POST',
+            endpoint: '/articles',
+            intent: 'confirmed_write',
+            data: { title: 'Test Article' },
+        }, mockCtx);
+        expect(result['status']).toBe(200);
+        const data = result['data'];
+        expect(data['method']).toBe('POST');
+        expect(data['body']).toBe('{"title":"Test Article"}');
+    });
+    it('returns preview for write intent when confirmation required', async () => {
+        const tool = createRequestTool({
+            connectionsMap: makeConnectionsMap(),
+            permissionChecker: confirmChecker,
+        });
+        const result = await tool.execute({
+            connection: 'test-api',
+            method: 'POST',
+            endpoint: '/articles',
+            intent: 'write',
+            data: { title: 'Draft' },
+        }, mockCtx);
+        expect(result['preview']).toBe(true);
+        expect(result['method']).toBe('POST');
+        expect(result['instruction']).toContain('confirmed_write');
+    });
+    it('returns error when permission denied', async () => {
+        const tool = createRequestTool({
+            connectionsMap: makeConnectionsMap(),
+            permissionChecker: denyChecker,
+        });
+        const result = await tool.execute({
+            connection: 'test-api',
+            method: 'DELETE',
+            endpoint: '/articles/1',
+            intent: 'write',
+        }, mockCtx);
+        expect(result['error']).toBe('Operation blocked');
+    });
+    it('throws ConnectionError for unknown connection', async () => {
+        const tool = createRequestTool({
+            connectionsMap: makeConnectionsMap(),
+            permissionChecker: allowAllChecker,
+        });
+        await expect(tool.execute({
+            connection: 'nonexistent',
+            method: 'GET',
+            endpoint: '/test',
+            intent: 'read',
+        }, mockCtx)).rejects.toThrow(ConnectionError);
+    });
+    it('throws ConnectionError when no base_url', async () => {
+        const tool = createRequestTool({
+            connectionsMap: { 'no-url': {} },
+            permissionChecker: allowAllChecker,
+        });
+        await expect(tool.execute({
+            connection: 'no-url',
+            method: 'GET',
+            endpoint: '/test',
+            intent: 'read',
+        }, mockCtx)).rejects.toThrow(ConnectionError);
+    });
+    it('expands $ENV_VAR in endpoints', async () => {
+        const tool = createRequestTool({
+            connectionsMap: makeConnectionsMap(),
+            permissionChecker: allowAllChecker,
+            sessionEnv: { APP_ID: 'my-app' },
+        });
+        const result = await tool.execute({
+            connection: 'test-api',
+            method: 'GET',
+            endpoint: '/apps/$APP_ID/status',
+            intent: 'read',
+        }, mockCtx);
+        const data = result['data'];
+        expect(data['url']).toBe('/apps/my-app/status');
+    });
+    it('appends query params', async () => {
+        const tool = createRequestTool({
+            connectionsMap: makeConnectionsMap(),
+            permissionChecker: allowAllChecker,
+        });
+        const result = await tool.execute({
+            connection: 'test-api',
+            method: 'GET',
+            endpoint: '/search',
+            intent: 'read',
+            params: { q: 'test', limit: '10' },
+        }, mockCtx);
+        const data = result['data'];
+        const url = data['url'];
+        expect(url).toContain('q=test');
+        expect(url).toContain('limit=10');
+    });
+    it('handles non-string query param values without crashing (G7)', async () => {
+        const tool = createRequestTool({
+            connectionsMap: makeConnectionsMap(),
+            permissionChecker: allowAllChecker,
+        });
+        const result = await tool.execute({
+            connection: 'test-api',
+            method: 'GET',
+            endpoint: '/search',
+            intent: 'read',
+            params: { per_page: 30, tag: 'ai', active: true },
+        }, mockCtx);
+        const data = result['data'];
+        const url = data['url'];
+        expect(url).toContain('per_page=30');
+        expect(url).toContain('tag=ai');
+        expect(url).toContain('active=true');
+    });
+    it('passes permission checker the correct request shape', async () => {
+        const checkSpy = vi.fn().mockReturnValue({ allowed: true });
+        const spyChecker = { check: checkSpy };
+        const tool = createRequestTool({
+            connectionsMap: makeConnectionsMap(),
+            permissionChecker: spyChecker,
+            readOnly: true,
+            planModeActive: () => true,
+        });
+        await tool.execute({
+            connection: 'test-api',
+            method: 'GET',
+            endpoint: '/data',
+            intent: 'read',
+        }, mockCtx).catch(() => { });
+        expect(checkSpy).toHaveBeenCalledWith(expect.objectContaining({
+            connection: 'test-api',
+            method: 'GET',
+            intent: 'read',
+            readOnly: true,
+            planModeActive: true,
+        }));
+    });
+});
+//# sourceMappingURL=request-tool.test.js.map

package/dist/src/tools/request-tool.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-tool.test.js","sourceRoot":"","sources":["../../../src/tools/request-tool.test.ts"],"names":[],"mappings":"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"}

package/dist/src/tools/store-tools.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { LoadedStore, StoreBackend } from '@amodalai/types';
+import type { ToolDefinition } from './types.js';
+/**
+ * Convert a store name (kebab-case) to a tool name.
+ * Example: "active-alerts" → "store_active_alerts"
+ */
+export declare function storeToToolName(storeName: string): string;
+/**
+ * Create a store write ToolDefinition for a single store.
+ */
+export declare function createStoreWriteTool(store: LoadedStore, backend: StoreBackend, appId: string): ToolDefinition;
+/**
+ * Create a store batch write ToolDefinition for a single store.
+ */
+export declare function createStoreBatchTool(store: LoadedStore, backend: StoreBackend, appId: string): ToolDefinition;
+export declare const QUERY_STORE_TOOL_NAME = "query_store";
+/**
+ * Create a store query ToolDefinition that reads from any store.
+ */
+export declare function createStoreQueryTool(stores: LoadedStore[], backend: StoreBackend, appId: string): ToolDefinition;
+/**
+ * Register store tools on a ToolRegistry for all stores in a bundle.
+ */
+export declare function registerStoreTools(registry: import('./types.js').ToolRegistry, stores: LoadedStore[], backend: StoreBackend, appId: string): void;