@luckydraw/cumulus 0.27.40 → 0.28.0

package/dist/lib/tools/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Core tool implementations for the direct API agentic loop.
+ *
+ * Tools are classified as "eager" (included in every API call) or
+ * "deferred" (available via ToolSearch, schema fetched on demand).
+ */
+export { readTool } from './read.js';
+export { writeTool } from './write.js';
+export { editTool } from './edit.js';
+export { bashTool } from './bash.js';
+export { grepTool } from './grep.js';
+export { globTool } from './glob.js';
+export { toolSearchTool, setDeferredRegistry, getDeferredRegistry, buildDeferredToolList, } from './tool-search.js';
+export type { DeferredToolEntry } from './tool-search.js';
+export { webFetchTool } from './web-fetch.js';
+export { webSearchTool, setBraveSearchApiKey } from './web-search.js';
+export { askUserQuestionTool, ASK_USER_QUESTION_TOOL } from './ask-user-question.js';
+import type { ToolDefinition } from '../provider.js';
+export interface Tool {
+    definition: ToolDefinition;
+    execute: (input: Record<string, unknown>, cwd: string) => Promise<string>;
+}
+/** Eager tools — included in every API call (10 tools). */
+export declare function getEagerTools(): Tool[];
+/** All tools (eager + deferred). For backward compat. */
+export declare function getAllTools(): Tool[];
+export declare function getToolDefinitions(): ToolDefinition[];
+export declare function getToolByName(name: string): Tool | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAarD,MAAM,WAAW,IAAI;IACnB,UAAU,EAAE,cAAc,CAAC;IAC3B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3E;AAED,2DAA2D;AAC3D,wBAAgB,aAAa,IAAI,IAAI,EAAE,CAatC;AAED,yDAAyD;AACzD,wBAAgB,WAAW,IAAI,IAAI,EAAE,CAEpC;AAED,wBAAgB,kBAAkB,IAAI,cAAc,EAAE,CAErD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAE5D"}

package/dist/lib/tools/index.js

@@ -0,0 +1,52 @@
+/**
+ * Core tool implementations for the direct API agentic loop.
+ *
+ * Tools are classified as "eager" (included in every API call) or
+ * "deferred" (available via ToolSearch, schema fetched on demand).
+ */
+export { readTool } from './read.js';
+export { writeTool } from './write.js';
+export { editTool } from './edit.js';
+export { bashTool } from './bash.js';
+export { grepTool } from './grep.js';
+export { globTool } from './glob.js';
+export { toolSearchTool, setDeferredRegistry, getDeferredRegistry, buildDeferredToolList, } from './tool-search.js';
+export { webFetchTool } from './web-fetch.js';
+export { webSearchTool, setBraveSearchApiKey } from './web-search.js';
+export { askUserQuestionTool, ASK_USER_QUESTION_TOOL } from './ask-user-question.js';
+import { askUserQuestionTool } from './ask-user-question.js';
+import { bashTool } from './bash.js';
+import { editTool } from './edit.js';
+import { globTool } from './glob.js';
+import { grepTool } from './grep.js';
+import { readTool } from './read.js';
+import { toolSearchTool } from './tool-search.js';
+import { webFetchTool } from './web-fetch.js';
+import { webSearchTool } from './web-search.js';
+import { writeTool } from './write.js';
+/** Eager tools — included in every API call (10 tools). */
+export function getEagerTools() {
+    return [
+        readTool,
+        writeTool,
+        editTool,
+        bashTool,
+        grepTool,
+        globTool,
+        toolSearchTool,
+        webFetchTool,
+        webSearchTool,
+        askUserQuestionTool,
+    ];
+}
+/** All tools (eager + deferred). For backward compat. */
+export function getAllTools() {
+    return getEagerTools();
+}
+export function getToolDefinitions() {
+    return getAllTools().map(t => t.definition);
+}
+export function getToolByName(name) {
+    return getAllTools().find(t => t.definition.name === name);
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAIrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAOvC,2DAA2D;AAC3D,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,QAAQ;QACR,SAAS;QACT,QAAQ;QACR,QAAQ;QACR,QAAQ;QACR,QAAQ;QACR,cAAc;QACd,YAAY;QACZ,aAAa;QACb,mBAAmB;KACpB,CAAC;AACJ,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,WAAW;IACzB,OAAO,aAAa,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC7D,CAAC"}

package/dist/lib/tools/read.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Read tool — read files with optional line range.
+ */
+import type { Tool } from './index.js';
+export declare const readTool: Tool;
+//# sourceMappingURL=read.d.ts.map

package/dist/lib/tools/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/read.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,eAAO,MAAM,QAAQ,EAAE,IAkEtB,CAAC"}

package/dist/lib/tools/read.js

@@ -0,0 +1,80 @@
+/**
+ * Read tool — read files with optional line range.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+export const readTool = {
+    definition: {
+        name: 'Read',
+        description: 'Read a file from the filesystem. Returns the file contents with line numbers. ' +
+            'Use offset and limit to read specific sections of large files.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                file_path: {
+                    type: 'string',
+                    description: 'Absolute path to the file to read',
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Line number to start reading from (1-based). Optional.',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of lines to read. Optional, defaults to 2000.',
+                },
+            },
+            required: ['file_path'],
+        },
+    },
+    async execute(input, cwd) {
+        const filePath = resolvePath(input.file_path, cwd);
+        const offset = input.offset || 1;
+        const limit = input.limit || 2000;
+        if (!fs.existsSync(filePath)) {
+            return `Error: File not found: ${filePath}`;
+        }
+        const stat = fs.statSync(filePath);
+        if (stat.isDirectory()) {
+            return `Error: ${filePath} is a directory, not a file. Use Bash with ls to list directory contents.`;
+        }
+        // Binary check (first 8KB)
+        const sample = Buffer.alloc(Math.min(8192, stat.size));
+        const fd = fs.openSync(filePath, 'r');
+        fs.readSync(fd, sample, 0, sample.length, 0);
+        fs.closeSync(fd);
+        if (isBinary(sample)) {
+            return `Error: ${filePath} appears to be a binary file (${stat.size} bytes)`;
+        }
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n');
+        const startIdx = Math.max(0, offset - 1);
+        const endIdx = Math.min(lines.length, startIdx + limit);
+        const selectedLines = lines.slice(startIdx, endIdx);
+        const numbered = selectedLines.map((line, i) => {
+            const lineNum = startIdx + i + 1;
+            return `${String(lineNum).padStart(6, ' ')}\t${line}`;
+        });
+        let result = numbered.join('\n');
+        if (endIdx < lines.length) {
+            result += `\n\n(${lines.length - endIdx} more lines not shown)`;
+        }
+        return result;
+    },
+};
+function resolvePath(filePath, cwd) {
+    if (path.isAbsolute(filePath))
+        return filePath;
+    return path.resolve(cwd, filePath);
+}
+function isBinary(buffer) {
+    for (let i = 0; i < buffer.length; i++) {
+        const b = buffer[i];
+        // NULL bytes or most control chars (except tab, newline, carriage return)
+        if (b === 0 || b < 8 || (b > 13 && b < 32 && b !== 27)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=read.js.map

package/dist/lib/tools/read.js.map

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

package/dist/lib/tools/tool-search.d.ts

@@ -0,0 +1,30 @@
+/**
+ * ToolSearch — deferred tool loading.
+ *
+ * Instead of sending all tool definitions every turn (~6k tokens),
+ * send only the 10 most-used eagerly. The rest are "deferred" —
+ * name + one-line description only. When the LLM needs one, it calls
+ * ToolSearch to get the full schema, then can call the tool on that turn.
+ *
+ * Supports two query modes:
+ *   - "select:tool1,tool2" — exact name lookup, returns full schemas
+ *   - "keyword search"     — fuzzy match on name + description
+ */
+import type { ToolDefinition } from '../provider.js';
+import type { Tool } from './index.js';
+export interface DeferredToolEntry {
+    name: string;
+    description: string;
+    definition: ToolDefinition;
+}
+/** Register tools that are available via ToolSearch (deferred tools). */
+export declare function setDeferredRegistry(entries: DeferredToolEntry[]): void;
+/** Get the current deferred registry (for introspection). */
+export declare function getDeferredRegistry(): DeferredToolEntry[];
+/**
+ * Build the deferred tool list string for the system prompt.
+ * Each entry is just name + description — no schema.
+ */
+export declare function buildDeferredToolList(): string;
+export declare const toolSearchTool: Tool;
+//# sourceMappingURL=tool-search.d.ts.map

package/dist/lib/tools/tool-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-search.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/tool-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,cAAc,CAAC;CAC5B;AAID,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAEtE;AAED,6DAA6D;AAC7D,wBAAgB,mBAAmB,IAAI,iBAAiB,EAAE,CAEzD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAI9C;AAED,eAAO,MAAM,cAAc,EAAE,IAkF5B,CAAC"}

package/dist/lib/tools/tool-search.js

@@ -0,0 +1,108 @@
+/**
+ * ToolSearch — deferred tool loading.
+ *
+ * Instead of sending all tool definitions every turn (~6k tokens),
+ * send only the 10 most-used eagerly. The rest are "deferred" —
+ * name + one-line description only. When the LLM needs one, it calls
+ * ToolSearch to get the full schema, then can call the tool on that turn.
+ *
+ * Supports two query modes:
+ *   - "select:tool1,tool2" — exact name lookup, returns full schemas
+ *   - "keyword search"     — fuzzy match on name + description
+ */
+let _registry = [];
+/** Register tools that are available via ToolSearch (deferred tools). */
+export function setDeferredRegistry(entries) {
+    _registry = entries;
+}
+/** Get the current deferred registry (for introspection). */
+export function getDeferredRegistry() {
+    return _registry;
+}
+/**
+ * Build the deferred tool list string for the system prompt.
+ * Each entry is just name + description — no schema.
+ */
+export function buildDeferredToolList() {
+    if (_registry.length === 0)
+        return '';
+    const lines = _registry.map(e => `- ${e.name}: ${e.description}`);
+    return 'The following deferred tools are available via ToolSearch:\n' + lines.join('\n');
+}
+export const toolSearchTool = {
+    definition: {
+        name: 'ToolSearch',
+        description: 'Fetch full schema definitions for deferred tools so they can be called. ' +
+            'Use "select:tool1,tool2" for exact name lookup, or keywords to search by name/description. ' +
+            'Returns matched tool schemas as JSON.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Query to find deferred tools. Use "select:<tool_name>,<tool_name>" for exact lookup, ' +
+                        'or keywords to search by name and description.',
+                },
+                max_results: {
+                    type: 'number',
+                    description: 'Maximum number of results to return (default: 5).',
+                },
+            },
+            required: ['query'],
+        },
+    },
+    async execute(input) {
+        const query = input.query || '';
+        const maxResults = input.max_results || 5;
+        if (_registry.length === 0) {
+            return 'No deferred tools registered.';
+        }
+        let matched;
+        if (query.startsWith('select:')) {
+            // Exact name lookup
+            const names = query
+                .slice(7)
+                .split(',')
+                .map(n => n.trim().toLowerCase());
+            matched = _registry.filter(e => names.includes(e.name.toLowerCase()));
+        }
+        else {
+            // Keyword search — score by term matches in name + description
+            const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
+            if (terms.length === 0) {
+                matched = _registry.slice(0, maxResults);
+            }
+            else {
+                const scored = _registry.map(e => {
+                    const haystack = `${e.name} ${e.description}`.toLowerCase();
+                    let score = 0;
+                    for (const term of terms) {
+                        if (haystack.includes(term))
+                            score++;
+                        // Bonus for name match
+                        if (e.name.toLowerCase().includes(term))
+                            score += 2;
+                    }
+                    return { entry: e, score };
+                });
+                scored.sort((a, b) => b.score - a.score);
+                matched = scored
+                    .filter(s => s.score > 0)
+                    .slice(0, maxResults)
+                    .map(s => s.entry);
+            }
+        }
+        if (matched.length === 0) {
+            return (`No tools matched query "${query}". Available deferred tools:\n` +
+                _registry.map(e => `- ${e.name}`).join('\n'));
+        }
+        // Return full schemas as JSON
+        const schemas = matched.map(e => ({
+            name: e.definition.name,
+            description: e.definition.description,
+            input_schema: e.definition.input_schema,
+        }));
+        return JSON.stringify(schemas, null, 2);
+    },
+};
+//# sourceMappingURL=tool-search.js.map

package/dist/lib/tools/tool-search.js.map

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

package/dist/lib/tools/web-fetch.d.ts

@@ -0,0 +1,9 @@
+/**
+ * WebFetch — HTTP GET/POST with response truncation.
+ *
+ * Fetches a URL and returns status, headers, and (truncated) body.
+ * Follows redirects. 30s timeout. Max 100k chars of response body.
+ */
+import type { Tool } from './index.js';
+export declare const webFetchTool: Tool;
+//# sourceMappingURL=web-fetch.d.ts.map

package/dist/lib/tools/web-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/web-fetch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAKvC,eAAO,MAAM,YAAY,EAAE,IAkH1B,CAAC"}

package/dist/lib/tools/web-fetch.js

@@ -0,0 +1,114 @@
+/**
+ * WebFetch — HTTP GET/POST with response truncation.
+ *
+ * Fetches a URL and returns status, headers, and (truncated) body.
+ * Follows redirects. 30s timeout. Max 100k chars of response body.
+ */
+const MAX_BODY_LENGTH = 100_000;
+const TIMEOUT_MS = 30_000;
+export const webFetchTool = {
+    definition: {
+        name: 'WebFetch',
+        description: 'Fetch a URL via HTTP. Returns status code, selected headers, and response body (truncated to 100k chars). ' +
+            'Supports GET and POST. Follows redirects.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                url: {
+                    type: 'string',
+                    description: 'The URL to fetch.',
+                },
+                method: {
+                    type: 'string',
+                    enum: ['GET', 'POST', 'PUT', 'DELETE', 'PATCH'],
+                    description: 'HTTP method. Default: GET.',
+                },
+                headers: {
+                    type: 'object',
+                    description: 'Optional HTTP headers as key-value pairs.',
+                    additionalProperties: { type: 'string' },
+                },
+                body: {
+                    type: 'string',
+                    description: 'Request body (for POST/PUT/PATCH).',
+                },
+            },
+            required: ['url'],
+        },
+    },
+    async execute(input) {
+        const url = input.url;
+        if (!url)
+            return 'Error: url is required.';
+        // Basic URL validation
+        try {
+            new URL(url);
+        }
+        catch {
+            return `Error: Invalid URL "${url}".`;
+        }
+        const method = input.method || 'GET';
+        const headers = input.headers || {};
+        const body = input.body;
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+            const fetchOpts = {
+                method,
+                headers,
+                signal: controller.signal,
+                redirect: 'follow',
+            };
+            if (body && ['POST', 'PUT', 'PATCH'].includes(method)) {
+                fetchOpts.body = body;
+                if (!headers['content-type'] && !headers['Content-Type']) {
+                    fetchOpts.headers['Content-Type'] = 'application/json';
+                }
+            }
+            const response = await fetch(url, fetchOpts);
+            clearTimeout(timer);
+            // Collect relevant headers
+            const relevantHeaders = {};
+            for (const key of ['content-type', 'content-length', 'location', 'x-ratelimit-remaining']) {
+                const val = response.headers.get(key);
+                if (val)
+                    relevantHeaders[key] = val;
+            }
+            // Read body
+            let responseBody;
+            const contentType = response.headers.get('content-type') || '';
+            if (contentType.includes('application/json') || contentType.includes('text/')) {
+                responseBody = await response.text();
+            }
+            else {
+                // Binary content — just report metadata
+                const contentLength = response.headers.get('content-length');
+                responseBody = `[Binary content: ${contentType}, ${contentLength || 'unknown'} bytes]`;
+            }
+            // Truncate
+            let truncated = false;
+            if (responseBody.length > MAX_BODY_LENGTH) {
+                responseBody = responseBody.slice(0, MAX_BODY_LENGTH);
+                truncated = true;
+            }
+            const parts = [
+                `Status: ${response.status} ${response.statusText}`,
+                `Headers: ${JSON.stringify(relevantHeaders)}`,
+                '',
+                responseBody,
+            ];
+            if (truncated) {
+                parts.push('', `[Response truncated at ${MAX_BODY_LENGTH} chars]`);
+            }
+            return parts.join('\n');
+        }
+        catch (err) {
+            const error = err;
+            if (error.name === 'AbortError') {
+                return `Error: Request timed out after ${TIMEOUT_MS / 1000}s.`;
+            }
+            return `Error: ${error.message}`;
+        }
+    },
+};
+//# sourceMappingURL=web-fetch.js.map

package/dist/lib/tools/web-fetch.js.map

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

package/dist/lib/tools/web-search.d.ts

@@ -0,0 +1,12 @@
+/**
+ * WebSearch — web search via Brave Search API.
+ *
+ * Returns structured search results. Requires BRAVE_SEARCH_API_KEY
+ * environment variable or config. Falls back to a helpful error message
+ * suggesting WebFetch as alternative.
+ */
+import type { Tool } from './index.js';
+/** Set the Brave Search API key programmatically. */
+export declare function setBraveSearchApiKey(key: string): void;
+export declare const webSearchTool: Tool;
+//# sourceMappingURL=web-search.d.ts.map

package/dist/lib/tools/web-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/web-search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAQvC,qDAAqD;AACrD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEtD;AAMD,eAAO,MAAM,aAAa,EAAE,IA0F3B,CAAC"}

package/dist/lib/tools/web-search.js

@@ -0,0 +1,89 @@
+/**
+ * WebSearch — web search via Brave Search API.
+ *
+ * Returns structured search results. Requires BRAVE_SEARCH_API_KEY
+ * environment variable or config. Falls back to a helpful error message
+ * suggesting WebFetch as alternative.
+ */
+const BRAVE_API_URL = 'https://api.search.brave.com/res/v1/web/search';
+const TIMEOUT_MS = 15_000;
+const MAX_RESULTS = 10;
+let _braveApiKey = null;
+/** Set the Brave Search API key programmatically. */
+export function setBraveSearchApiKey(key) {
+    _braveApiKey = key;
+}
+function getApiKey() {
+    return _braveApiKey || process.env.BRAVE_SEARCH_API_KEY || null;
+}
+export const webSearchTool = {
+    definition: {
+        name: 'WebSearch',
+        description: 'Search the web using Brave Search. Returns titles, URLs, and snippets for the top results. ' +
+            'Use for finding documentation, current information, or discovering URLs to fetch with WebFetch.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'The search query.',
+                },
+                count: {
+                    type: 'number',
+                    description: `Number of results to return (default: 5, max: ${MAX_RESULTS}).`,
+                },
+            },
+            required: ['query'],
+        },
+    },
+    async execute(input) {
+        const query = input.query;
+        if (!query)
+            return 'Error: query is required.';
+        const apiKey = getApiKey();
+        if (!apiKey) {
+            return ('Error: No Brave Search API key configured. ' +
+                'Set BRAVE_SEARCH_API_KEY environment variable or configure via gateway config.\n\n' +
+                'Alternative: Use WebFetch to fetch a specific URL directly (e.g., a documentation page).');
+        }
+        const count = Math.min(input.count || 5, MAX_RESULTS);
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+            const params = new URLSearchParams({
+                q: query,
+                count: String(count),
+            });
+            const response = await fetch(`${BRAVE_API_URL}?${params}`, {
+                headers: {
+                    Accept: 'application/json',
+                    'Accept-Encoding': 'gzip',
+                    'X-Subscription-Token': apiKey,
+                },
+                signal: controller.signal,
+            });
+            clearTimeout(timer);
+            if (!response.ok) {
+                const text = await response.text();
+                return `Error: Brave Search returned ${response.status}: ${text.slice(0, 500)}`;
+            }
+            const data = (await response.json());
+            const results = data.web?.results || [];
+            if (results.length === 0) {
+                return `No results found for "${query}".`;
+            }
+            const formatted = results.map((r, i) => {
+                return `${i + 1}. **${r.title}**\n   ${r.url}\n   ${r.description}`;
+            });
+            return `Web search results for "${query}":\n\n${formatted.join('\n\n')}`;
+        }
+        catch (err) {
+            const error = err;
+            if (error.name === 'AbortError') {
+                return `Error: Search timed out after ${TIMEOUT_MS / 1000}s.`;
+            }
+            return `Error: ${error.message}`;
+        }
+    },
+};
+//# sourceMappingURL=web-search.js.map

package/dist/lib/tools/web-search.js.map

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

package/dist/lib/tools/write.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Write tool — create or overwrite files.
+ */
+import type { Tool } from './index.js';
+export declare const writeTool: Tool;
+//# sourceMappingURL=write.d.ts.map

package/dist/lib/tools/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/write.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,eAAO,MAAM,SAAS,EAAE,IAqCvB,CAAC"}

package/dist/lib/tools/write.js

@@ -0,0 +1,44 @@
+/**
+ * Write tool — create or overwrite files.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+export const writeTool = {
+    definition: {
+        name: 'Write',
+        description: 'Write content to a file. Creates the file if it does not exist, ' +
+            'or overwrites it if it does. Creates parent directories as needed.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                file_path: {
+                    type: 'string',
+                    description: 'Absolute path to the file to write',
+                },
+                content: {
+                    type: 'string',
+                    description: 'The content to write to the file',
+                },
+            },
+            required: ['file_path', 'content'],
+        },
+    },
+    async execute(input, cwd) {
+        const filePath = resolvePath(input.file_path, cwd);
+        const content = input.content;
+        // Create parent directories
+        const dir = path.dirname(filePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(filePath, content, 'utf-8');
+        const lines = content.split('\n').length;
+        return `File written: ${filePath} (${lines} lines, ${content.length} bytes)`;
+    },
+};
+function resolvePath(filePath, cwd) {
+    if (path.isAbsolute(filePath))
+        return filePath;
+    return path.resolve(cwd, filePath);
+}
+//# sourceMappingURL=write.js.map