@vybestack/llxprt-code-core 0.6.1 → 0.7.0-nightly.251206.43b97dbf4

package/dist/src/tools/ToolIdStrategy.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @plan PLAN-20251205-ISSUE712
+ * @description Tool ID strategy module for Kimi K2 and standard ID handling
+ *
+ * This module provides different strategies for resolving tool call IDs
+ * based on the tool format being used. Kimi K2 requires a specific ID format
+ * (functions.{name}:{index}) while most other providers use OpenAI-style
+ * call_xxx format.
+ */
+import type { IContent, ToolCallBlock, ToolResponseBlock } from '../services/history/IContent.js';
+import type { ToolFormat } from './IToolFormatter.js';
+/**
+ * Interface for mapping tool IDs to provider-specific formats
+ */
+export interface ToolIdMapper {
+    /**
+     * Resolves a tool call's internal ID to the provider-specific format
+     */
+    resolveToolCallId(tc: ToolCallBlock): string;
+    /**
+     * Resolves a tool response's callId to the provider-specific format
+     * that matches its corresponding tool call
+     */
+    resolveToolResponseId(tr: ToolResponseBlock): string;
+}
+/**
+ * Interface for creating tool ID mappers based on conversation contents
+ */
+export interface ToolIdStrategy {
+    /**
+     * Creates a mapper that can resolve tool IDs for the given conversation
+     */
+    createMapper(contents: IContent[]): ToolIdMapper;
+}
+/**
+ * Checks if a model name indicates a Kimi K2 model that requires
+ * the special functions.{name}:{index} ID format.
+ *
+ * Uses specific pattern matching to avoid false positives from models
+ * that happen to contain 'k2' as part of their name (e.g., "gptk2-turbo").
+ *
+ * @param model - The model name to check
+ * @returns true if this is a K2 model requiring special ID handling
+ */
+export declare function isKimiModel(model: string): boolean;
+/**
+ * Kimi K2 strategy: Generates IDs in the format functions.{toolName}:{globalIndex}
+ *
+ * K2 uses a specific ID format where each tool call gets a sequential index
+ * based on its position in the conversation. This strategy scans all tool calls
+ * and assigns indices, then uses those indices when resolving IDs.
+ */
+export declare const kimiStrategy: ToolIdStrategy;
+/**
+ * Standard strategy: Converts internal hist_tool_xxx format to OpenAI call_xxx format
+ *
+ * This is the default strategy used for most providers (OpenAI, Qwen, DeepSeek, etc.)
+ * It simply normalizes the internal ID format to the OpenAI format.
+ */
+export declare const standardStrategy: ToolIdStrategy;
+/**
+ * Gets the appropriate tool ID strategy for a given tool format
+ *
+ * @param format - The tool format being used
+ * @returns The strategy to use for ID resolution
+ */
+export declare function getToolIdStrategy(format: ToolFormat): ToolIdStrategy;

package/dist/src/tools/ToolIdStrategy.js

@@ -0,0 +1,107 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { normalizeToOpenAIToolId } from '../providers/openai-vercel/toolIdUtils.js';
+/**
+ * Checks if a model name indicates a Kimi K2 model that requires
+ * the special functions.{name}:{index} ID format.
+ *
+ * Uses specific pattern matching to avoid false positives from models
+ * that happen to contain 'k2' as part of their name (e.g., "gptk2-turbo").
+ *
+ * @param model - The model name to check
+ * @returns true if this is a K2 model requiring special ID handling
+ */
+export function isKimiModel(model) {
+    const lowerModel = model.toLowerCase();
+    // Explicit kimi branding
+    if (lowerModel.includes('kimi')) {
+        return true;
+    }
+    // Check for k2 at word boundaries:
+    // - starts with k2 (e.g., "k2-0527-preview")
+    // - ends with k2 or -k2 (e.g., "model-k2")
+    // - has k2 surrounded by non-alphanumeric (e.g., "kimi-k2-chat")
+    const k2Pattern = /(?:^|[^a-z0-9])k2(?:[^a-z0-9]|$)/;
+    return k2Pattern.test(lowerModel);
+}
+/**
+ * Kimi K2 strategy: Generates IDs in the format functions.{toolName}:{globalIndex}
+ *
+ * K2 uses a specific ID format where each tool call gets a sequential index
+ * based on its position in the conversation. This strategy scans all tool calls
+ * and assigns indices, then uses those indices when resolving IDs.
+ */
+export const kimiStrategy = {
+    createMapper(contents) {
+        // Build a map of internal ID -> K2 format ID
+        const idToK2Id = new Map();
+        let globalIndex = 0;
+        // Scan all tool calls in the conversation
+        for (const content of contents) {
+            if (content.speaker !== 'ai')
+                continue;
+            for (const block of content.blocks) {
+                if (isToolCallBlock(block)) {
+                    const k2Id = `functions.${block.name}:${globalIndex}`;
+                    idToK2Id.set(block.id, k2Id);
+                    globalIndex++;
+                }
+            }
+        }
+        return {
+            resolveToolCallId(tc) {
+                return idToK2Id.get(tc.id) ?? `functions.${tc.name}:${globalIndex++}`;
+            },
+            resolveToolResponseId(tr) {
+                // Look up the corresponding tool call's K2 ID
+                const k2Id = idToK2Id.get(tr.callId);
+                if (k2Id) {
+                    return k2Id;
+                }
+                // Fallback: generate a new ID based on the tool name
+                // This handles orphan responses or responses to calls not yet seen
+                return `functions.${tr.toolName}:${globalIndex++}`;
+            },
+        };
+    },
+};
+/**
+ * Standard strategy: Converts internal hist_tool_xxx format to OpenAI call_xxx format
+ *
+ * This is the default strategy used for most providers (OpenAI, Qwen, DeepSeek, etc.)
+ * It simply normalizes the internal ID format to the OpenAI format.
+ */
+export const standardStrategy = {
+    createMapper(_contents) {
+        return {
+            resolveToolCallId(tc) {
+                return normalizeToOpenAIToolId(tc.id);
+            },
+            resolveToolResponseId(tr) {
+                return normalizeToOpenAIToolId(tr.callId);
+            },
+        };
+    },
+};
+/**
+ * Gets the appropriate tool ID strategy for a given tool format
+ *
+ * @param format - The tool format being used
+ * @returns The strategy to use for ID resolution
+ */
+export function getToolIdStrategy(format) {
+    if (format === 'kimi') {
+        return kimiStrategy;
+    }
+    return standardStrategy;
+}
+/**
+ * Type guard for ToolCallBlock
+ */
+function isToolCallBlock(block) {
+    return block.type === 'tool_call';
+}
+//# sourceMappingURL=ToolIdStrategy.js.map

package/dist/src/tools/ToolIdStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolIdStrategy.js","sourceRoot":"","sources":["../../../src/tools/ToolIdStrategy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AA4BpF;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAEvC,yBAAyB;IACzB,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mCAAmC;IACnC,6CAA6C;IAC7C,2CAA2C;IAC3C,iEAAiE;IACjE,MAAM,SAAS,GAAG,kCAAkC,CAAC;IACrD,OAAO,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAmB;IAC1C,YAAY,CAAC,QAAoB;QAC/B,6CAA6C;QAC7C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC3C,IAAI,WAAW,GAAG,CAAC,CAAC;QAEpB,0CAA0C;QAC1C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI;gBAAE,SAAS;YAEvC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnC,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC3B,MAAM,IAAI,GAAG,aAAa,KAAK,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC;oBACtD,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;oBAC7B,WAAW,EAAE,CAAC;gBAChB,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,iBAAiB,CAAC,EAAiB;gBACjC,OAAO,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,aAAa,EAAE,CAAC,IAAI,IAAI,WAAW,EAAE,EAAE,CAAC;YACxE,CAAC;YAED,qBAAqB,CAAC,EAAqB;gBACzC,8CAA8C;gBAC9C,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;gBACrC,IAAI,IAAI,EAAE,CAAC;oBACT,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,qDAAqD;gBACrD,mEAAmE;gBACnE,OAAO,aAAa,EAAE,CAAC,QAAQ,IAAI,WAAW,EAAE,EAAE,CAAC;YACrD,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,YAAY,CAAC,SAAqB;QAChC,OAAO;YACL,iBAAiB,CAAC,EAAiB;gBACjC,OAAO,uBAAuB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACxC,CAAC;YAED,qBAAqB,CAAC,EAAqB;gBACzC,OAAO,uBAAuB,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;YAC5C,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAkB;IAClD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,KAAmB;IAC1C,OAAO,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC;AACpC,CAAC"}

package/dist/src/tools/codesearch.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Portions of this code are derived from opencode (https://github.com/sst/opencode)
+ * Copyright (c) 2025 opencode
+ * Licensed under the MIT License.
+ */
+import { BaseDeclarativeTool, ToolInvocation, ToolResult } from './tools.js';
+import { Config } from '../config/config.js';
+export interface CodeSearchToolParams {
+    query: string;
+    tokensNum?: number;
+}
+export declare class CodeSearchTool extends BaseDeclarativeTool<CodeSearchToolParams, ToolResult> {
+    private readonly config;
+    static readonly Name = "codesearch";
+    constructor(config: Config);
+    protected createInvocation(params: CodeSearchToolParams): ToolInvocation<CodeSearchToolParams, ToolResult>;
+}

package/dist/src/tools/codesearch.js

@@ -0,0 +1,145 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Portions of this code are derived from opencode (https://github.com/sst/opencode)
+ * Copyright (c) 2025 opencode
+ * Licensed under the MIT License.
+ */
+import { BaseDeclarativeTool, Kind, } from './tools.js';
+import { ToolErrorType } from './tool-error.js';
+import { BaseToolInvocation } from './tools.js';
+import fetch from 'node-fetch';
+const API_CONFIG = {
+    BASE_URL: 'https://mcp.exa.ai',
+    ENDPOINTS: {
+        CONTEXT: '/mcp',
+    },
+};
+export class CodeSearchTool extends BaseDeclarativeTool {
+    config;
+    static Name = 'codesearch';
+    constructor(config) {
+        super(CodeSearchTool.Name, 'CodeSearch', 'Search for relevant code snippets, APIs, Libraries, and SDKs documentation. Use this to find examples and usage patterns.', Kind.Search, {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: "Search query to find relevant context. For example, 'React useState hook examples', 'Python pandas dataframe filtering'.",
+                },
+                tokensNum: {
+                    type: 'number',
+                    description: 'Number of tokens to return (1000-50000). Default is 5000 tokens.',
+                    default: 5000,
+                    minimum: 1000,
+                    maximum: 50000,
+                },
+            },
+            required: ['query'],
+        });
+        this.config = config;
+    }
+    createInvocation(params) {
+        return new CodeSearchToolInvocation(this.config, params);
+    }
+}
+class CodeSearchToolInvocation extends BaseToolInvocation {
+    config;
+    constructor(config, params) {
+        super(params);
+        this.config = config;
+    }
+    getDescription() {
+        return `Search code for: ${this.params.query}`;
+    }
+    async execute(signal, _updateOutput) {
+        const codeRequest = {
+            jsonrpc: '2.0',
+            id: 1,
+            method: 'tools/call',
+            params: {
+                name: 'get_code_context_exa',
+                arguments: {
+                    query: this.params.query,
+                    tokensNum: this.getEffectiveTokensNum(),
+                },
+            },
+        };
+        try {
+            const headers = {
+                accept: 'application/json, text/event-stream',
+                'content-type': 'application/json',
+            };
+            const response = await fetch(`${API_CONFIG.BASE_URL}${API_CONFIG.ENDPOINTS.CONTEXT}`, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(codeRequest),
+                signal,
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Code search error (${response.status}): ${errorText}`);
+            }
+            const responseText = await response.text();
+            // Parse SSE response
+            // The response from mcp.exa.ai seems to be SSE format "data: {...}"
+            const lines = responseText.split('\n');
+            for (const line of lines) {
+                if (line.startsWith('data: ')) {
+                    try {
+                        const data = JSON.parse(line.substring(6));
+                        if (data.result &&
+                            data.result.content &&
+                            data.result.content.length > 0) {
+                            const content = data.result.content[0].text;
+                            return {
+                                llmContent: content,
+                                returnDisplay: content,
+                            };
+                        }
+                    }
+                    catch (_e) {
+                        // Ignore parse errors for intermediate lines
+                    }
+                }
+            }
+            return {
+                llmContent: 'No code snippets or documentation found. Please try a different query.',
+                returnDisplay: 'No results found.',
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                llmContent: `Error performing code search: ${errorMessage}`,
+                returnDisplay: `Error: ${errorMessage}`,
+                error: {
+                    message: errorMessage,
+                    type: ToolErrorType.SEARCH_ERROR,
+                },
+            };
+        }
+    }
+    getEffectiveTokensNum() {
+        // Limits from: https://github.com/exa-labs/exa-mcp-server/blob/1ec2078b59d5e4503696fecf9ce40701ccef85cc/src/tools/exaCode.ts#L14
+        const LIMITS = {
+            DEFAULT: 5000,
+            MIN: 1000,
+            MAX: 50000,
+        };
+        const settingMaxTokens = this.config
+            .getSettingsService()
+            .get('tool-output-max-tokens');
+        // 1. Determine requested tokens (Param > Default)
+        let tokens = this.params.tokensNum ?? LIMITS.DEFAULT;
+        // 2. Apply setting as a hard cap if present
+        if (settingMaxTokens !== undefined &&
+            typeof settingMaxTokens === 'number') {
+            tokens = Math.min(tokens, settingMaxTokens);
+        }
+        // 3. Clamp to absolute API limits
+        return Math.max(LIMITS.MIN, Math.min(tokens, LIMITS.MAX));
+    }
+}
+//# sourceMappingURL=codesearch.js.map

package/dist/src/tools/codesearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codesearch.js","sourceRoot":"","sources":["../../../src/tools/codesearch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,mBAAmB,EACnB,IAAI,GAGL,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,MAAM,YAAY,CAAC;AAE/B,MAAM,UAAU,GAAG;IACjB,QAAQ,EAAE,oBAAoB;IAC9B,SAAS,EAAE;QACT,OAAO,EAAE,MAAM;KAChB;CACO,CAAC;AA8BX,MAAM,OAAO,cAAe,SAAQ,mBAGnC;IAG8B;IAF7B,MAAM,CAAU,IAAI,GAAG,YAAY,CAAC;IAEpC,YAA6B,MAAc;QACzC,KAAK,CACH,cAAc,CAAC,IAAI,EACnB,YAAY,EACZ,2HAA2H,EAC3H,IAAI,CAAC,MAAM,EACX;YACE,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,0HAA0H;iBAC7H;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,kEAAkE;oBACpE,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,KAAK;iBACf;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB,CACF,CAAC;QAzByB,WAAM,GAAN,MAAM,CAAQ;IA0B3C,CAAC;IAES,gBAAgB,CACxB,MAA4B;QAE5B,OAAO,IAAI,wBAAwB,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3D,CAAC;;AAGH,MAAM,wBAAyB,SAAQ,kBAGtC;IAEoB;IADnB,YACmB,MAAc,EAC/B,MAA4B;QAE5B,KAAK,CAAC,MAAM,CAAC,CAAC;QAHG,WAAM,GAAN,MAAM,CAAQ;IAIjC,CAAC;IAED,cAAc;QACZ,OAAO,oBAAoB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,OAAO,CACX,MAAmB,EACnB,aAAwC;QAExC,MAAM,WAAW,GAAmB;YAClC,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,CAAC;YACL,MAAM,EAAE,YAAY;YACpB,MAAM,EAAE;gBACN,IAAI,EAAE,sBAAsB;gBAC5B,SAAS,EAAE;oBACT,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;oBACxB,SAAS,EAAE,IAAI,CAAC,qBAAqB,EAAE;iBACxC;aACF;SACF,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,OAAO,GAA2B;gBACtC,MAAM,EAAE,qCAAqC;gBAC7C,cAAc,EAAE,kBAAkB;aACnC,CAAC;YAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,UAAU,CAAC,QAAQ,GAAG,UAAU,CAAC,SAAS,CAAC,OAAO,EAAE,EACvD;gBACE,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;gBACjC,MAAM;aACP,CACF,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACxC,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,CAAC,MAAM,MAAM,SAAS,EAAE,CAAC,CAAC;YAC1E,CAAC;YAED,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAE3C,qBAAqB;YACrB,oEAAoE;YACpE,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC9B,IAAI,CAAC;wBACH,MAAM,IAAI,GAAoB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;wBAC5D,IACE,IAAI,CAAC,MAAM;4BACX,IAAI,CAAC,MAAM,CAAC,OAAO;4BACnB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAC9B,CAAC;4BACD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;4BAC5C,OAAO;gCACL,UAAU,EAAE,OAAO;gCACnB,aAAa,EAAE,OAAO;6BACvB,CAAC;wBACJ,CAAC;oBACH,CAAC;oBAAC,OAAO,EAAE,EAAE,CAAC;wBACZ,6CAA6C;oBAC/C,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO;gBACL,UAAU,EACR,wEAAwE;gBAC1E,aAAa,EAAE,mBAAmB;aACnC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzD,OAAO;gBACL,UAAU,EAAE,iCAAiC,YAAY,EAAE;gBAC3D,aAAa,EAAE,UAAU,YAAY,EAAE;gBACvC,KAAK,EAAE;oBACL,OAAO,EAAE,YAAY;oBACrB,IAAI,EAAE,aAAa,CAAC,YAAY;iBACjC;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,qBAAqB;QAC3B,iIAAiI;QACjI,MAAM,MAAM,GAAG;YACb,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,IAAI;YACT,GAAG,EAAE,KAAK;SACX,CAAC;QAEF,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM;aACjC,kBAAkB,EAAE;aACpB,GAAG,CAAC,wBAAwB,CAAuB,CAAC;QAEvD,kDAAkD;QAClD,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC;QAErD,4CAA4C;QAC5C,IACE,gBAAgB,KAAK,SAAS;YAC9B,OAAO,gBAAgB,KAAK,QAAQ,EACpC,CAAC;YACD,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;QAC9C,CAAC;QAED,kCAAkC;QAClC,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/dist/src/tools/direct-web-fetch.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Portions of this code are derived from opencode (https://github.com/sst/opencode)
+ * Copyright (c) 2025 opencode
+ * Licensed under the MIT License.
+ */
+import { BaseDeclarativeTool, ToolInvocation, ToolResult } from './tools.js';
+import { Config } from '../config/config.js';
+export interface DirectWebFetchToolParams {
+    url: string;
+    format: 'text' | 'markdown' | 'html';
+    timeout?: number;
+}
+export declare class DirectWebFetchTool extends BaseDeclarativeTool<DirectWebFetchToolParams, ToolResult> {
+    private readonly config;
+    static readonly Name = "direct_web_fetch";
+    constructor(config: Config);
+    protected createInvocation(params: DirectWebFetchToolParams): ToolInvocation<DirectWebFetchToolParams, ToolResult>;
+}

package/dist/src/tools/direct-web-fetch.js

@@ -0,0 +1,169 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Portions of this code are derived from opencode (https://github.com/sst/opencode)
+ * Copyright (c) 2025 opencode
+ * Licensed under the MIT License.
+ */
+import { BaseDeclarativeTool, Kind, } from './tools.js';
+import { ToolErrorType } from './tool-error.js';
+import { BaseToolInvocation } from './tools.js';
+import fetch from 'node-fetch';
+import TurndownService from 'turndown';
+import * as cheerio from 'cheerio';
+const MAX_RESPONSE_SIZE = 5 * 1024 * 1024; // 5MB
+const DEFAULT_TIMEOUT = 30 * 1000; // 30 seconds
+const MAX_TIMEOUT = 120 * 1000; // 2 minutes
+export class DirectWebFetchTool extends BaseDeclarativeTool {
+    config;
+    static Name = 'direct_web_fetch';
+    constructor(config) {
+        super(DirectWebFetchTool.Name, 'DirectWebFetch', 'Fetches content from a specified URL and converts it to the requested format (text, markdown, or html).', Kind.Search, {
+            type: 'object',
+            properties: {
+                url: {
+                    type: 'string',
+                    description: 'The URL to fetch content from',
+                },
+                format: {
+                    type: 'string',
+                    enum: ['text', 'markdown', 'html'],
+                    description: 'The format to return the content in (text, markdown, or html)',
+                },
+                timeout: {
+                    type: 'number',
+                    description: 'Optional timeout in seconds (max 120)',
+                },
+            },
+            required: ['url', 'format'],
+        });
+        this.config = config;
+    }
+    createInvocation(params) {
+        return new DirectWebFetchToolInvocation(this.config, params);
+    }
+}
+class DirectWebFetchToolInvocation extends BaseToolInvocation {
+    constructor(_config, params, messageBus) {
+        super(params, messageBus);
+    }
+    getDescription() {
+        return `Fetch content from ${this.params.url}`;
+    }
+    async execute(signal, _updateOutput) {
+        const { url, format, timeout: timeoutSec } = this.params;
+        if (!url.startsWith('http://') && !url.startsWith('https://')) {
+            return {
+                llmContent: 'URL must start with http:// or https://',
+                returnDisplay: 'Invalid URL',
+                error: {
+                    message: 'Invalid URL protocol',
+                    type: ToolErrorType.INVALID_ARGUMENT,
+                },
+            };
+        }
+        const timeout = Math.min((timeoutSec ?? DEFAULT_TIMEOUT / 1000) * 1000, MAX_TIMEOUT);
+        // Build Accept header
+        let acceptHeader = '*/*';
+        switch (format) {
+            case 'markdown':
+                acceptHeader =
+                    'text/markdown;q=1.0, text/x-markdown;q=0.9, text/plain;q=0.8, text/html;q=0.7, */*;q=0.1';
+                break;
+            case 'text':
+                acceptHeader =
+                    'text/plain;q=1.0, text/markdown;q=0.9, text/html;q=0.8, */*;q=0.1';
+                break;
+            case 'html':
+                acceptHeader =
+                    'text/html;q=1.0, application/xhtml+xml;q=0.9, text/plain;q=0.8, text/markdown;q=0.7, */*;q=0.1';
+                break;
+            default:
+                acceptHeader =
+                    'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8';
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        // If the parent signal aborts, we should also abort our controller
+        const onAbort = () => controller.abort();
+        signal.addEventListener('abort', onAbort);
+        try {
+            const response = await fetch(url, {
+                signal: controller.signal,
+                headers: {
+                    'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+                    Accept: acceptHeader,
+                    'Accept-Language': 'en-US,en;q=0.9',
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`Request failed with status code: ${response.status}`);
+            }
+            // Check content length
+            const contentLength = response.headers.get('content-length');
+            if (contentLength && parseInt(contentLength, 10) > MAX_RESPONSE_SIZE) {
+                throw new Error('Response too large (exceeds 5MB limit)');
+            }
+            const arrayBuffer = await response.arrayBuffer();
+            if (arrayBuffer.byteLength > MAX_RESPONSE_SIZE) {
+                throw new Error('Response too large (exceeds 5MB limit)');
+            }
+            const content = new TextDecoder().decode(arrayBuffer);
+            const contentType = response.headers.get('content-type') || '';
+            let output = content;
+            switch (format) {
+                case 'markdown':
+                    if (contentType.includes('text/html')) {
+                        output = this.convertHTMLToMarkdown(content);
+                    }
+                    break;
+                case 'text':
+                    if (contentType.includes('text/html')) {
+                        output = this.extractTextFromHTML(content);
+                    }
+                    break;
+                default:
+                    break;
+            }
+            return {
+                llmContent: output,
+                returnDisplay: `Fetched ${url} as ${format}`,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                llmContent: `Error fetching URL: ${errorMessage}`,
+                returnDisplay: `Error: ${errorMessage}`,
+                error: {
+                    message: errorMessage,
+                    type: ToolErrorType.FETCH_ERROR,
+                },
+            };
+        }
+        finally {
+            clearTimeout(timeoutId);
+            signal.removeEventListener('abort', onAbort);
+        }
+    }
+    extractTextFromHTML(html) {
+        const $ = cheerio.load(html);
+        // Remove scripts, styles, etc.
+        $('script, style, noscript, iframe, object, embed').remove();
+        return $.text().trim();
+    }
+    convertHTMLToMarkdown(html) {
+        const turndownService = new TurndownService({
+            headingStyle: 'atx',
+            hr: '---',
+            bulletListMarker: '-',
+            codeBlockStyle: 'fenced',
+            emDelimiter: '*',
+        });
+        turndownService.remove(['script', 'style', 'meta', 'link']);
+        return turndownService.turndown(html);
+    }
+}
+//# sourceMappingURL=direct-web-fetch.js.map

package/dist/src/tools/direct-web-fetch.js.map

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

package/dist/src/tools/exa-web-search.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Portions of this code are derived from opencode (https://github.com/sst/opencode)
+ * Copyright (c) 2025 opencode
+ * Licensed under the MIT License.
+ */
+import { BaseDeclarativeTool, ToolInvocation, ToolResult } from './tools.js';
+import { Config } from '../config/config.js';
+export interface ExaWebSearchToolParams {
+    query: string;
+    numResults?: number;
+    livecrawl?: 'fallback' | 'preferred';
+    type?: 'auto' | 'fast' | 'deep';
+    contextMaxCharacters?: number;
+}
+export declare class ExaWebSearchTool extends BaseDeclarativeTool<ExaWebSearchToolParams, ToolResult> {
+    private readonly config;
+    static readonly Name = "exa_web_search";
+    constructor(config: Config);
+    protected createInvocation(params: ExaWebSearchToolParams): ToolInvocation<ExaWebSearchToolParams, ToolResult>;
+}