@amodalai/runtime 0.1.26 → 0.2.1

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

@@ -0,0 +1,71 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Dispatch tool.
+ *
+ * Allows the model to delegate a sub-task to a child agent with a
+ * subset of tools. The EXECUTING state handler intercepts this tool
+ * by name and transitions to DISPATCHING — the execute() function
+ * here is a safety net that should never be reached.
+ *
+ * Circular dependency avoidance: this file does NOT import from
+ * the agent loop. The dispatch tool is just a schema definition.
+ * The actual child agent execution lives in states/dispatching.ts.
+ */
+import { z } from 'zod';
+import { ToolExecutionError } from '../errors.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export const DISPATCH_TOOL_NAME = 'dispatch_task';
+const DEFAULT_CHILD_MAX_TURNS = 10;
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+const DispatchParamsSchema = z.object({
+    /** Name for the child agent (used in SSE events and logging) */
+    agent_name: z.string().describe('A short descriptive name for the sub-agent (e.g. "data-fetcher", "entity-profiler")'),
+    /** Which tools the child agent can use (must be a subset of available tools) */
+    tools: z.array(z.string()).describe('List of tool names the child agent can use'),
+    /** The task prompt for the child agent */
+    prompt: z.string().describe('The task description for the child agent to complete'),
+    /** Max turns for the child agent (default: 10) */
+    max_turns: z.number().int().positive().optional().describe('Maximum number of LLM turns the child agent can take'),
+});
+// ---------------------------------------------------------------------------
+// Tool definition
+// ---------------------------------------------------------------------------
+/**
+ * Create the dispatch_task tool definition.
+ *
+ * The tool is intercepted by the EXECUTING state handler before execute()
+ * is called. The EXECUTING handler reads the args, strips dispatch_task
+ * from the child's tool list (preventing recursion), and transitions to
+ * DISPATCHING state.
+ */
+export function createDispatchTool() {
+    return {
+        description: `Delegate a sub-task to a child agent that runs independently with its own tool set. Use this when a task can be broken into parallel or sequential sub-tasks, each requiring specific tools. The child agent completes its task and returns a text summary.
+
+The child agent has access only to the tools you specify — choose the minimum set needed. The child cannot dispatch further sub-agents.
+
+Use dispatch_task when:
+- A task involves multiple independent data-gathering steps
+- You need to query different connections in parallel
+- A sub-task is self-contained and doesn't need conversation context`,
+        parameters: DispatchParamsSchema,
+        readOnly: false,
+        metadata: { category: 'system' },
+        async execute() {
+            // The EXECUTING state handler intercepts dispatch_task by name and
+            // transitions to DISPATCHING. If execute() is called directly, the
+            // interception was bypassed — this is a bug.
+            throw new ToolExecutionError('dispatch_task must be intercepted by the EXECUTING state handler — direct execution is not supported', { toolName: DISPATCH_TOOL_NAME, callId: 'unknown', context: {} });
+        },
+    };
+}
+export { DEFAULT_CHILD_MAX_TURNS };
+//# sourceMappingURL=dispatch-tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-tool.js","sourceRoot":"","sources":["../../../src/tools/dispatch-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;GAWG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,OAAO,EAAC,kBAAkB,EAAC,MAAM,cAAc,CAAC;AAEhD,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAElD,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAEnC,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,gEAAgE;IAChE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qFAAqF,CAAC;IACtH,gFAAgF;IAChF,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACjF,0CAA0C;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;IACnF,kDAAkD;IAClD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;CACnH,CAAC,CAAC;AAIH,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,WAAW,EAAE;;;;;;;qEAOoD;QAEjE,UAAU,EAAE,oBAAoB;QAEhC,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,EAAC,QAAQ,EAAE,QAAQ,EAAC;QAE9B,KAAK,CAAC,OAAO;YACX,mEAAmE;YACnE,mEAAmE;YACnE,6CAA6C;YAC7C,MAAM,IAAI,kBAAkB,CAC1B,sGAAsG,EACtG,EAAC,QAAQ,EAAE,kBAAkB,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAC,CAC/D,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,OAAO,EAAC,uBAAuB,EAAC,CAAC"}

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

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

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

@@ -0,0 +1,75 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { describe, it, expect } from 'vitest';
+import { createDispatchTool, DISPATCH_TOOL_NAME, DEFAULT_CHILD_MAX_TURNS } from './dispatch-tool.js';
+import { ToolExecutionError } from '../errors.js';
+describe('dispatch-tool', () => {
+    it('has the correct tool name constant', () => {
+        expect(DISPATCH_TOOL_NAME).toBe('dispatch_task');
+    });
+    it('has a sensible default child max turns', () => {
+        expect(DEFAULT_CHILD_MAX_TURNS).toBe(10);
+    });
+    it('creates a tool definition with Zod schema', () => {
+        const tool = createDispatchTool();
+        expect(tool.description).toContain('child agent');
+        expect(tool.readOnly).toBe(false);
+        expect(tool.metadata?.category).toBe('system');
+        // Zod schema should have safeParse
+        expect('safeParse' in tool.parameters).toBe(true);
+    });
+    it('validates correct parameters', () => {
+        const tool = createDispatchTool();
+        const schema = tool.parameters;
+        if ('safeParse' in schema) {
+            const result = schema.safeParse({
+                agent_name: 'data-fetcher',
+                tools: ['request', 'query_store'],
+                prompt: 'Fetch the latest metrics',
+            });
+            expect(result.success).toBe(true);
+        }
+    });
+    it('validates parameters with optional max_turns', () => {
+        const tool = createDispatchTool();
+        const schema = tool.parameters;
+        if ('safeParse' in schema) {
+            const result = schema.safeParse({
+                agent_name: 'profiler',
+                tools: ['request'],
+                prompt: 'Profile the entity',
+                max_turns: 5,
+            });
+            expect(result.success).toBe(true);
+        }
+    });
+    it('rejects missing required fields', () => {
+        const tool = createDispatchTool();
+        const schema = tool.parameters;
+        if ('safeParse' in schema) {
+            const result = schema.safeParse({ agent_name: 'test' });
+            expect(result.success).toBe(false);
+        }
+    });
+    it('rejects invalid max_turns', () => {
+        const tool = createDispatchTool();
+        const schema = tool.parameters;
+        if ('safeParse' in schema) {
+            const result = schema.safeParse({
+                agent_name: 'test',
+                tools: [],
+                prompt: 'do thing',
+                max_turns: -1,
+            });
+            expect(result.success).toBe(false);
+        }
+    });
+    it('execute throws ToolExecutionError (should never be called directly)', async () => {
+        const tool = createDispatchTool();
+        await expect(tool.execute({}, {})).rejects.toThrow(ToolExecutionError);
+    });
+});
+//# sourceMappingURL=dispatch-tool.test.js.map

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

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

package/dist/src/tools/fetch-url-tool.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { z } from 'zod';
+import { FETCH_URL_TOOL_NAME } from '@amodalai/core';
+import type { ToolDefinition } from './types.js';
+export { FETCH_URL_TOOL_NAME };
+declare const FetchUrlParamsSchema: z.ZodObject<{
+    url: z.ZodString;
+    prompt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    prompt?: string | undefined;
+}, {
+    url: string;
+    prompt?: string | undefined;
+}>;
+type FetchUrlParams = z.infer<typeof FetchUrlParamsSchema>;
+/** Reset rate-limit state (test helper). */
+export declare function resetRateLimitForTesting(): void;
+export declare function createFetchUrlTool(): ToolDefinition<FetchUrlParams>;

package/dist/src/tools/fetch-url-tool.js

@@ -0,0 +1,333 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * fetch_url tool — grounded URL fetch via Gemini urlContext, with a local
+ * fetch + Readability fallback for internal URLs or Gemini failures.
+ *
+ * Flow:
+ *   1. If the URL targets a private network (localhost / RFC1918 / .local)
+ *      OR `ctx.searchProvider` is unavailable, run the local fallback.
+ *   2. Otherwise try Gemini urlContext first. If that fails or returns
+ *      empty content, fall through to the local fallback.
+ *   3. Local fallback uses linkedom + Mozilla Readability to extract the
+ *      main content, then returns it as text/markdown.
+ *
+ * Per-hostname rate limiting: 10 requests / 60 seconds, in-memory.
+ */
+import { Readability } from '@mozilla/readability';
+import { parseHTML } from 'linkedom';
+import { z } from 'zod';
+import { FETCH_URL_TOOL_NAME } from '@amodalai/core';
+import { log } from '../logger.js';
+import { ToolExecutionError } from '../errors.js';
+import { truncateToTokens, MAX_WEB_TOOL_RESULT_TOKENS } from './web-tools-shared.js';
+export { FETCH_URL_TOOL_NAME };
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Timeout for the local fetch fallback (ms). */
+const LOCAL_FETCH_TIMEOUT_MS = 10_000;
+/** Max response body size for the local fetch fallback (bytes). */
+const LOCAL_FETCH_MAX_BYTES = 1_000_000;
+/** Rate-limit window size (ms). */
+const RATE_LIMIT_WINDOW_MS = 60_000;
+/** Max requests per hostname per window. */
+const RATE_LIMIT_MAX_REQUESTS = 10;
+// ---------------------------------------------------------------------------
+// Internal error type for the local fetch path
+// ---------------------------------------------------------------------------
+/**
+ * Internal signaling error thrown by `fetchLocally()`. Always caught and
+ * re-wrapped in `ToolExecutionError` at the tool boundary — it never escapes
+ * the module. Carrying the hostname/status/size on the error lets the
+ * wrapping layer include that context in the structured error response.
+ */
+class LocalFetchError extends Error {
+    context;
+    constructor(message, context) {
+        super(message);
+        this.name = 'LocalFetchError';
+        this.context = context;
+    }
+}
+// ---------------------------------------------------------------------------
+// Params schema
+// ---------------------------------------------------------------------------
+const FetchUrlParamsSchema = z.object({
+    url: z
+        .string()
+        .url()
+        .describe('Absolute URL to fetch. Must be http:// or https://.'),
+    prompt: z
+        .string()
+        .optional()
+        .describe('Optional extraction prompt: what specifically to pull from the page. When omitted, the full page is rendered as markdown.'),
+});
+// ---------------------------------------------------------------------------
+// Rate limiter (per-hostname sliding window)
+// ---------------------------------------------------------------------------
+const hostRequestTimestamps = new Map();
+function checkRateLimit(hostname) {
+    const now = Date.now();
+    const cutoff = now - RATE_LIMIT_WINDOW_MS;
+    const timestamps = (hostRequestTimestamps.get(hostname) ?? []).filter((t) => t > cutoff);
+    if (timestamps.length >= RATE_LIMIT_MAX_REQUESTS) {
+        const oldest = timestamps[0] ?? now;
+        return { ok: false, retryAtMs: oldest + RATE_LIMIT_WINDOW_MS };
+    }
+    timestamps.push(now);
+    hostRequestTimestamps.set(hostname, timestamps);
+    return { ok: true };
+}
+/** Reset rate-limit state (test helper). */
+export function resetRateLimitForTesting() {
+    hostRequestTimestamps.clear();
+}
+// ---------------------------------------------------------------------------
+// Private network detection
+// ---------------------------------------------------------------------------
+const PRIVATE_IPV4_PREFIXES = ['10.', '192.168.'];
+function isPrivateNetworkHost(hostname) {
+    const lower = hostname.toLowerCase();
+    if (lower === 'localhost' || lower.endsWith('.local') || lower.endsWith('.localhost')) {
+        return true;
+    }
+    if (lower === '127.0.0.1' || lower === '::1' || lower === '[::1]') {
+        return true;
+    }
+    if (lower.startsWith('127.'))
+        return true;
+    for (const prefix of PRIVATE_IPV4_PREFIXES) {
+        if (lower.startsWith(prefix))
+            return true;
+    }
+    // 172.16.0.0 – 172.31.255.255
+    if (lower.startsWith('172.')) {
+        const parts = lower.split('.');
+        const second = parts[1];
+        if (second !== undefined) {
+            const n = Number(second);
+            if (Number.isInteger(n) && n >= 16 && n <= 31)
+                return true;
+        }
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Local fetch + Readability fallback
+// ---------------------------------------------------------------------------
+async function fetchLocally(url, signal) {
+    const combinedSignal = AbortSignal.any([signal, AbortSignal.timeout(LOCAL_FETCH_TIMEOUT_MS)]);
+    const response = await fetch(url, {
+        signal: combinedSignal,
+        headers: {
+            'User-Agent': 'Amodal/fetch_url',
+            'Accept': 'text/html,application/xhtml+xml,text/plain;q=0.9,*/*;q=0.5',
+        },
+        redirect: 'follow',
+    });
+    if (!response.ok) {
+        throw new LocalFetchError(`HTTP ${String(response.status)} ${response.statusText}`, {
+            url,
+            status: response.status,
+            statusText: response.statusText,
+        });
+    }
+    // Enforce size limit while reading. `content-length` can be absent
+    // (chunked responses), so we also stream-check via the returned bytes.
+    const contentLength = response.headers.get('content-length');
+    if (contentLength !== null) {
+        const declared = Number(contentLength);
+        if (Number.isFinite(declared) && declared > LOCAL_FETCH_MAX_BYTES) {
+            throw new LocalFetchError(`Response too large: ${String(declared)} bytes (limit ${String(LOCAL_FETCH_MAX_BYTES)})`, { url, declaredBytes: declared, limit: LOCAL_FETCH_MAX_BYTES });
+        }
+    }
+    const buffer = await response.arrayBuffer();
+    if (buffer.byteLength > LOCAL_FETCH_MAX_BYTES) {
+        throw new LocalFetchError(`Response too large: ${String(buffer.byteLength)} bytes (limit ${String(LOCAL_FETCH_MAX_BYTES)})`, { url, actualBytes: buffer.byteLength, limit: LOCAL_FETCH_MAX_BYTES });
+    }
+    const html = new TextDecoder('utf-8', { fatal: false }).decode(buffer);
+    return extractWithReadability(html, url);
+}
+function extractWithReadability(html, url) {
+    const { document } = parseHTML(html);
+    // linkedom returns a linkedom-typed `Document`; Readability declares the
+    // DOM-lib `Document` type. They are structurally compatible at runtime.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- linkedom→DOM boundary for Readability
+    const article = new Readability(document).parse();
+    if (article?.textContent && article.textContent.trim().length > 0) {
+        const title = article.title ? `# ${article.title}\n\n` : '';
+        return `${title}${article.textContent.trim()}\n\n_Source: ${url}_`;
+    }
+    // Readability couldn't extract — fall back to walking the parsed DOM.
+    // We use the DOM's own structure (via linkedom) instead of regex-based
+    // tag stripping, which is both safer and simpler: scripts/styles are
+    // removed structurally, entities are already decoded by the parser, and
+    // there is no risk of partial-match reinjection. This path runs only
+    // when Readability returns nothing useful.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- linkedom's Document types are loose
+    const doc = document;
+    // Remove non-content elements whose textContent would otherwise be
+    // concatenated into the output (scripts, styles, embedded templates).
+    const nonContent = doc.querySelectorAll('script, style, noscript, template');
+    for (const el of nonContent) {
+        el.remove();
+    }
+    const rawText = doc.body?.textContent ?? doc.textContent ?? '';
+    const text = rawText.replace(/\s+/g, ' ').trim();
+    return `${text}\n\n_Source: ${url}_`;
+}
+function parseAndClassify(rawUrl) {
+    // URL constructor throws on malformed input — validated upstream by Zod,
+    // but we re-parse here to extract hostname.
+    const parsed = new URL(rawUrl);
+    return {
+        hostname: parsed.hostname,
+        isPrivate: isPrivateNetworkHost(parsed.hostname),
+    };
+}
+// ---------------------------------------------------------------------------
+// Primary path (Gemini urlContext)
+// ---------------------------------------------------------------------------
+async function fetchViaSearchProvider(provider, url, userPrompt, signal) {
+    const result = await provider.fetchUrl(url, {
+        ...(userPrompt ? { prompt: userPrompt } : {}),
+        signal,
+    });
+    return result.text;
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+export function createFetchUrlTool() {
+    return {
+        description: `Fetch the content of a specific URL. Returns the page content as markdown. Use when you need the actual content of a web page, documentation, or API response you already know the URL for.
+
+When to use:
+- You have a specific URL the user referenced or web_search surfaced
+- You need the full content of a documentation page or article
+- Retrieving a raw text or JSON resource
+
+When NOT to use:
+- Searching — use web_search
+- Hitting a configured API connection — use the request tool
+- The URL is a user-protected resource (auth/cookies required)`,
+        parameters: FetchUrlParamsSchema,
+        readOnly: true,
+        metadata: { category: 'system' },
+        async execute(params, ctx) {
+            const started = Date.now();
+            const { url, prompt } = params;
+            let parsed;
+            try {
+                parsed = parseAndClassify(url);
+            }
+            catch (err) {
+                return {
+                    status: 'error',
+                    content: `Invalid URL: ${err instanceof Error ? err.message : 'parse failed'}`,
+                };
+            }
+            const protocol = new URL(url).protocol;
+            if (protocol !== 'http:' && protocol !== 'https:') {
+                return {
+                    status: 'error',
+                    content: `Only http:// and https:// URLs are supported (got ${protocol}).`,
+                };
+            }
+            // Rate limit check
+            const limitCheck = checkRateLimit(parsed.hostname);
+            if (!limitCheck.ok) {
+                const retryInSec = Math.max(1, Math.ceil(((limitCheck.retryAtMs ?? Date.now()) - Date.now()) / 1000));
+                log.warn('fetch_url_rate_limited', {
+                    session: ctx.sessionId,
+                    hostname: parsed.hostname,
+                    retry_in_sec: retryInSec,
+                });
+                return {
+                    status: 'error',
+                    content: `Rate limited for ${parsed.hostname}. Try again in ${String(retryInSec)}s.`,
+                };
+            }
+            // Decide path. The condition narrows `ctx.searchProvider` inside the
+            // primary branch so we can use it without a non-null assertion.
+            let usedFallback = false;
+            let text;
+            if (!parsed.isPrivate && ctx.searchProvider) {
+                const provider = ctx.searchProvider;
+                try {
+                    text = await fetchViaSearchProvider(provider, url, prompt, ctx.signal);
+                    // Empty response from Gemini → try local
+                    if (!text || text.trim().length === 0) {
+                        text = await fetchLocally(url, ctx.signal);
+                        usedFallback = true;
+                    }
+                }
+                catch (primaryErr) {
+                    log.warn('fetch_url_primary_failed', {
+                        session: ctx.sessionId,
+                        hostname: parsed.hostname,
+                        error: primaryErr instanceof Error ? primaryErr.message : String(primaryErr),
+                    });
+                    try {
+                        text = await fetchLocally(url, ctx.signal);
+                        usedFallback = true;
+                    }
+                    catch (fallbackErr) {
+                        log.error('fetch_url_failed', {
+                            session: ctx.sessionId,
+                            hostname: parsed.hostname,
+                            duration_ms: Date.now() - started,
+                            path: 'fallback',
+                            error: fallbackErr instanceof Error ? fallbackErr.message : String(fallbackErr),
+                        });
+                        throw new ToolExecutionError('fetch_url failed (primary + fallback)', {
+                            toolName: FETCH_URL_TOOL_NAME,
+                            callId: ctx.sessionId,
+                            cause: fallbackErr,
+                            context: { primaryError: primaryErr instanceof Error ? primaryErr.message : String(primaryErr) },
+                        });
+                    }
+                }
+            }
+            else {
+                // Private network or no searchProvider configured — local only.
+                try {
+                    text = await fetchLocally(url, ctx.signal);
+                    usedFallback = true;
+                }
+                catch (err) {
+                    log.error('fetch_url_failed', {
+                        session: ctx.sessionId,
+                        hostname: parsed.hostname,
+                        duration_ms: Date.now() - started,
+                        path: 'local',
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                    throw new ToolExecutionError('fetch_url failed (local fetch)', {
+                        toolName: FETCH_URL_TOOL_NAME,
+                        callId: ctx.sessionId,
+                        cause: err,
+                    });
+                }
+            }
+            const content = truncateToTokens(text, MAX_WEB_TOOL_RESULT_TOKENS);
+            log.info('fetch_url', {
+                session: ctx.sessionId,
+                hostname: parsed.hostname,
+                duration_ms: Date.now() - started,
+                bytes: text.length,
+                used_fallback: usedFallback,
+            });
+            return {
+                status: 'ok',
+                content,
+                used_fallback: usedFallback,
+            };
+        },
+    };
+}
+//# sourceMappingURL=fetch-url-tool.js.map

package/dist/src/tools/fetch-url-tool.js.map

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

package/dist/src/tools/fetch-url-tool.test.d.ts

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