@vinhnt-sdk/core 0.1.0

package/dist/tool/sandbox.js

@@ -0,0 +1,72 @@
+/** Create a minimal ToolContext from an AbortSignal (for backward compat) */
+export function signalToToolContext(signal) {
+    const ctrl = signal ? new AbortController() : new AbortController();
+    if (signal) {
+        signal.addEventListener("abort", () => ctrl.abort(signal.reason), { once: true });
+    }
+    return {
+        sessionId: "",
+        runId: "",
+        agentId: "",
+        agentName: "",
+        signal: ctrl.signal,
+        env: {},
+        ask: async () => "once",
+        metadata: () => { },
+        setCompensation: () => { },
+    };
+}
+export class ToolSandbox {
+    config;
+    constructor(config = { defaultTimeoutMs: 30_000 }) {
+        this.config = config;
+    }
+    async execute(tool, input, ctx) {
+        const timeout = new AbortController();
+        const timer = setTimeout(() => timeout.abort(), this.config.defaultTimeoutMs);
+        const combinedSignal = combineSignals(ctx.signal, timeout.signal);
+        const augmentedCtx = { ...ctx, signal: combinedSignal };
+        try {
+            const result = await raceAbort(tool.execute(input, augmentedCtx), combinedSignal);
+            return result;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+function raceAbort(promise, signal) {
+    if (signal.aborted) {
+        return Promise.reject(new DOMException(signal.reason ?? "Aborted", "AbortError"));
+    }
+    return new Promise((resolve, reject) => {
+        const onAbort = () => {
+            reject(new DOMException(signal.reason ?? "Timed out", "AbortError"));
+        };
+        signal.addEventListener("abort", onAbort, { once: true });
+        promise.then((val) => {
+            signal.removeEventListener("abort", onAbort);
+            resolve(val);
+        }, (err) => {
+            signal.removeEventListener("abort", onAbort);
+            reject(err);
+        });
+    });
+}
+function combineSignals(...signals) {
+    const valid = signals.filter((s) => s !== undefined);
+    if (valid.length === 0)
+        return new AbortController().signal;
+    if (valid.length === 1)
+        return valid[0];
+    const controller = new AbortController();
+    for (const s of valid) {
+        if (s.aborted) {
+            controller.abort(s.reason);
+            return controller.signal;
+        }
+        s.addEventListener("abort", () => controller.abort(s.reason), { once: true });
+    }
+    return controller.signal;
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/tool/sandbox.js.map

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

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

@@ -0,0 +1,6 @@
+import type { ToolDefinition } from "./definitions.js";
+type RootGetter = string | (() => string);
+export declare function createGlobFilesTool(workspaceRoot: RootGetter): ToolDefinition;
+export declare function createGrepFilesTool(workspaceRoot: RootGetter): ToolDefinition;
+export {};
+//# sourceMappingURL=search-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-tools.d.ts","sourceRoot":"","sources":["../../src/tool/search-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAcvD,KAAK,UAAU,GAAG,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;AAuB1C,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,UAAU,GAAG,cAAc,CAqB7E;AAED,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,UAAU,GAAG,cAAc,CA2D7E"}

package/dist/tool/search-tools.js

@@ -0,0 +1,118 @@
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { z } from "zod";
+import { defineTool } from "./define-tool.js";
+const GlobFilesSchema = z.object({
+    pattern: z.string().min(1),
+    maxResults: z.number().positive().optional(),
+});
+const GrepFilesSchema = z.object({
+    pattern: z.string().min(1),
+    include: z.string().optional(),
+    maxResults: z.number().positive().optional(),
+});
+function resolveRoot(r) {
+    return typeof r === "function" ? r() : r;
+}
+const IGNORE_DIRS = new Set(["node_modules", ".git", ".next", "dist", ".turbo", "coverage", ".vscode"]);
+async function globRecursive(dir, pattern, base, results) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (IGNORE_DIRS.has(entry.name))
+            continue;
+        const fullPath = join(dir, entry.name);
+        const relPath = relative(base, fullPath);
+        if (entry.name.includes(pattern) || relPath.includes(pattern)) {
+            results.push(relPath);
+        }
+        if (entry.isDirectory()) {
+            await globRecursive(fullPath, pattern, base, results);
+        }
+    }
+}
+export function createGlobFilesTool(workspaceRoot) {
+    return defineTool({
+        name: "glob_files",
+        description: "Recursively find files matching a pattern in the workspace.",
+        risk: "read",
+        input: GlobFilesSchema,
+        jsonSchema: {
+            type: "object",
+            properties: {
+                pattern: { type: "string", description: "File name or path fragment to match" },
+                maxResults: { type: "number", description: "Maximum results (default 50)", default: 50 },
+            },
+            required: ["pattern"],
+        },
+        async execute(v, _ctx) {
+            const root = resolveRoot(workspaceRoot);
+            const results = [];
+            await globRecursive(root, v.pattern, root, results);
+            return results.slice(0, v.maxResults ?? 50);
+        },
+    }).toDefinition();
+}
+export function createGrepFilesTool(workspaceRoot) {
+    return defineTool({
+        name: "grep_files",
+        description: "Search file contents for a regex pattern. Returns matches with line numbers.",
+        risk: "read",
+        input: GrepFilesSchema,
+        jsonSchema: {
+            type: "object",
+            properties: {
+                pattern: { type: "string", description: "Regex pattern to search" },
+                include: { type: "string", description: "File pattern filter (e.g. *.ts, *.md)" },
+                maxResults: { type: "number", description: "Maximum match lines (default 30)", default: 30 },
+            },
+            required: ["pattern"],
+        },
+        async execute(v, _ctx) {
+            const root = resolveRoot(workspaceRoot);
+            const maxResults = v.maxResults ?? 30;
+            const regex = new RegExp(v.pattern);
+            const matches = [];
+            async function searchDir(dir) {
+                if (matches.length >= maxResults)
+                    return;
+                const entries = await readdir(dir, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (matches.length >= maxResults)
+                        return;
+                    if (IGNORE_DIRS.has(entry.name))
+                        continue;
+                    const fullPath = join(dir, entry.name);
+                    if (entry.isDirectory()) {
+                        await searchDir(fullPath);
+                    }
+                    else if (!v.include || entry.name.endsWith(v.include.replace("*", ""))) {
+                        try {
+                            const st = await stat(fullPath);
+                            if (st.size > 100_000)
+                                continue;
+                            const content = await readFile(fullPath, "utf-8");
+                            const lines = content.split("\n");
+                            for (let i = 0; i < lines.length; i++) {
+                                if (regex.test(lines[i])) {
+                                    matches.push({
+                                        file: relative(root, fullPath),
+                                        line: i + 1,
+                                        content: lines[i].trim().slice(0, 200),
+                                    });
+                                    if (matches.length >= maxResults)
+                                        return;
+                                }
+                            }
+                        }
+                        catch {
+                            continue;
+                        }
+                    }
+                }
+            }
+            await searchDir(root);
+            return matches;
+        },
+    }).toDefinition();
+}
+//# sourceMappingURL=search-tools.js.map

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

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

package/dist/tool/shell-tool.d.ts

@@ -0,0 +1,19 @@
+export interface ShellToolConfig {
+    workspaceRoot: string | (() => string);
+    defaultTimeoutMs: number;
+    /** Hard cap on shell command timeout in ms (default: 300000) */
+    maxTimeoutMs?: number;
+    /** If true, prompts for permission before executing shell commands (default: true) */
+    askPermission?: boolean;
+}
+interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export declare function createShellTool(config: ShellToolConfig): import("./definitions.js").ToolDefinition<{
+    command: string;
+    timeoutMs?: number;
+}, ExecResult>;
+export {};
+//# sourceMappingURL=shell-tool.d.ts.map

package/dist/tool/shell-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-tool.d.ts","sourceRoot":"","sources":["../../src/tool/shell-tool.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAmFD,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe;aACxB,MAAM;gBAAc,MAAM;eAiCxD"}

package/dist/tool/shell-tool.js

@@ -0,0 +1,139 @@
+import { execFile } from "node:child_process";
+import { commandPattern } from "./arity.js";
+import { z } from "zod";
+import { defineTool } from "./define-tool.js";
+const ExecuteCommandSchema = z.object({
+    command: z.string().min(1),
+    timeoutMs: z.number().positive().optional(),
+});
+function execAsync(command, cwd, timeoutMs, signal, env) {
+    return new Promise((resolve, reject) => {
+        const parsed = parseCommand(command);
+        const child = execFile(parsed.file, parsed.args, {
+            cwd,
+            timeout: timeoutMs,
+            maxBuffer: 10 * 1024 * 1024,
+            encoding: "utf-8",
+            windowsHide: true,
+            env: env && Object.keys(env).length > 0
+                ? { ...process.env, ...env }
+                : undefined,
+        }, (err, stdout, stderr) => {
+            if (err) {
+                const exitCode = typeof err.code === "number" ? err.code : 1;
+                resolve({ stdout: stdout ?? "", stderr: stderr ?? "", exitCode });
+            }
+            else {
+                resolve({ stdout: stdout ?? "", stderr: stderr ?? "", exitCode: 0 });
+            }
+        });
+        if (signal) {
+            if (signal.aborted) {
+                child.kill();
+                reject(new DOMException(signal.reason ?? "Aborted", "AbortError"));
+                return;
+            }
+            signal.addEventListener("abort", () => {
+                child.kill();
+                reject(new DOMException(signal.reason ?? "Aborted", "AbortError"));
+            }, { once: true });
+        }
+    });
+}
+function parseCommand(cmd) {
+    const trimmed = cmd.trim();
+    if (!trimmed)
+        return { file: "", args: [] };
+    const tokens = [];
+    let i = 0;
+    let current = "";
+    let inSingle = false;
+    let inDouble = false;
+    while (i < trimmed.length) {
+        const ch = trimmed[i] ?? "";
+        if (inSingle) {
+            if (ch === "'") {
+                inSingle = false;
+            }
+            else {
+                current += ch;
+            }
+            i++;
+        }
+        else if (inDouble) {
+            if (ch === '"') {
+                inDouble = false;
+            }
+            else if (ch === "\\" && i + 1 < trimmed.length) {
+                current += trimmed[i + 1];
+                i += 2;
+            }
+            else {
+                current += ch;
+                i++;
+            }
+        }
+        else if (ch === "'") {
+            inSingle = true;
+            i++;
+        }
+        else if (ch === '"') {
+            inDouble = true;
+            i++;
+        }
+        else if (ch === "\\" && i + 1 < trimmed.length) {
+            current += trimmed[i + 1];
+            i += 2;
+        }
+        else if (/\s/.test(ch)) {
+            if (current) {
+                tokens.push(current);
+                current = "";
+            }
+            i++;
+        }
+        else {
+            current += ch;
+            i++;
+        }
+    }
+    if (current)
+        tokens.push(current);
+    if (tokens.length === 0)
+        return { file: "", args: [] };
+    return { file: tokens[0], args: tokens.slice(1) };
+}
+export function createShellTool(config) {
+    return defineTool({
+        name: "execute_command",
+        description: "Execute a shell command in the workspace directory. Returns stdout and stderr.",
+        risk: "write",
+        timeoutMs: 120_000,
+        input: ExecuteCommandSchema,
+        jsonSchema: {
+            type: "object",
+            properties: {
+                command: { type: "string", description: "Shell command to run" },
+                timeoutMs: { type: "number", description: "Timeout in ms (default 30_000)", default: 30_000 },
+            },
+            required: ["command"],
+        },
+        async execute(v, ctx) {
+            const root = typeof config.workspaceRoot === "function" ? config.workspaceRoot() : config.workspaceRoot;
+            const timeout = Math.min(v.timeoutMs ?? config.defaultTimeoutMs, config.maxTimeoutMs ?? 300_000);
+            if (config.askPermission !== false) {
+                const reply = await ctx.ask({
+                    permission: "shell",
+                    resource: v.command,
+                    reason: `Run shell command: ${v.command}`,
+                    savePatterns: [commandPattern(v.command)],
+                });
+                if (reply === "reject") {
+                    return { stdout: "", stderr: "", exitCode: 1 };
+                }
+            }
+            return execAsync(v.command, root, timeout, ctx.signal, ctx.env);
+        },
+    }).toDefinition();
+}
+//# sourceMappingURL=shell-tool.js.map

package/dist/tool/shell-tool.js.map

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

package/dist/tool/todo-tool.d.ts

@@ -0,0 +1,2 @@
+export declare function createTodoWriteTool(): import("./definitions.js").ToolDefinition<unknown, unknown>;
+//# sourceMappingURL=todo-tool.d.ts.map

package/dist/tool/todo-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-tool.d.ts","sourceRoot":"","sources":["../../src/tool/todo-tool.ts"],"names":[],"mappings":"AAeA,wBAAgB,mBAAmB,gEAmHlC"}

package/dist/tool/todo-tool.js

@@ -0,0 +1,121 @@
+import { z } from "zod";
+import { defineTool } from "./define-tool.js";
+const store = new Map();
+let nextId = 1;
+export function createTodoWriteTool() {
+    // The todo tool intentionally keeps loose runtime validation (returns
+    // `{ error }` results instead of throwing), so its schema is untyped and
+    // validation happens inside execute below.
+    return defineTool({
+        name: "todowrite",
+        description: "Manage a structured task list with priorities and status. Use this to track progress, organize multi-step work, and surface status to the user. Actions: create, list, update, complete, delete.",
+        risk: "read",
+        input: z.unknown(),
+        jsonSchema: {
+            type: "object",
+            properties: {
+                action: {
+                    type: "string",
+                    enum: ["create", "list", "update", "complete", "delete"],
+                    description: "Action to perform on the task list",
+                },
+                id: {
+                    type: "string",
+                    description: "Task ID (required for update, complete, delete)",
+                },
+                content: {
+                    type: "string",
+                    description: "Task description (required for create, optional for update)",
+                },
+                priority: {
+                    type: "string",
+                    enum: ["high", "medium", "low"],
+                    description: "Task priority (default: medium)",
+                },
+                status: {
+                    type: "string",
+                    enum: ["pending", "in_progress", "completed", "cancelled"],
+                    description: "Task status (used with update action)",
+                },
+            },
+            required: ["action"],
+        },
+        async execute(raw) {
+            const v = raw;
+            const action = v.action;
+            switch (action) {
+                case "create": {
+                    const content = v.content;
+                    if (!content || typeof content !== "string") {
+                        return { error: "content is required for create action" };
+                    }
+                    const id = String(nextId++);
+                    const item = {
+                        id,
+                        content,
+                        status: "pending",
+                        priority: v.priority ?? "medium",
+                        createdAt: Date.now(),
+                        updatedAt: Date.now(),
+                    };
+                    store.set(id, item);
+                    return { todo: item, message: `Task #${id} created` };
+                }
+                case "list": {
+                    const items = [...store.values()].sort((a, b) => b.createdAt - a.createdAt);
+                    return {
+                        todos: items,
+                        summary: {
+                            total: items.length,
+                            pending: items.filter((t) => t.status === "pending").length,
+                            inProgress: items.filter((t) => t.status === "in_progress").length,
+                            completed: items.filter((t) => t.status === "completed").length,
+                        },
+                    };
+                }
+                case "update": {
+                    const id = v.id;
+                    if (!id)
+                        return { error: "id is required for update action" };
+                    const item = store.get(id);
+                    if (!item)
+                        return { error: `Task #${id} not found` };
+                    if (v.content !== undefined && typeof v.content === "string") {
+                        item.content = v.content;
+                    }
+                    if (v.priority !== undefined && typeof v.priority === "string") {
+                        item.priority = v.priority;
+                    }
+                    if (v.status !== undefined && typeof v.status === "string") {
+                        item.status = v.status;
+                    }
+                    item.updatedAt = Date.now();
+                    return { todo: item, message: `Task #${id} updated` };
+                }
+                case "complete": {
+                    const id = v.id;
+                    if (!id)
+                        return { error: "id is required for complete action" };
+                    const item = store.get(id);
+                    if (!item)
+                        return { error: `Task #${id} not found` };
+                    item.status = "completed";
+                    item.updatedAt = Date.now();
+                    return { todo: item, message: `Task #${id} completed` };
+                }
+                case "delete": {
+                    const id = v.id;
+                    if (!id)
+                        return { error: "id is required for delete action" };
+                    if (!store.has(id))
+                        return { error: `Task #${id} not found` };
+                    store.delete(id);
+                    return { message: `Task #${id} deleted` };
+                }
+                default:
+                    return { error: `Unknown action: ${action}` };
+            }
+        },
+    }).toDefinition();
+}
+//# sourceMappingURL=todo-tool.js.map

package/dist/tool/todo-tool.js.map

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

package/dist/tool/tool-registry-types.d.ts

@@ -0,0 +1,14 @@
+import type { ToolDefinition, ToolRisk } from "./definitions.js";
+export type ToolFilter = {
+    risk?: ToolRisk;
+    ids?: string[];
+    pattern?: string;
+};
+export interface ToolRegistry {
+    register(tool: ToolDefinition): void;
+    unregister(id: string): boolean;
+    get(id: string): ToolDefinition | undefined;
+    list(filter?: ToolFilter): readonly ToolDefinition[];
+    count(): number;
+}
+//# sourceMappingURL=tool-registry-types.d.ts.map

package/dist/tool/tool-registry-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry-types.d.ts","sourceRoot":"","sources":["../../src/tool/tool-registry-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjE,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IACrC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IAC5C,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,cAAc,EAAE,CAAC;IACrD,KAAK,IAAI,MAAM,CAAC;CACjB"}

package/dist/tool/tool-registry-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-registry-types.js.map

package/dist/tool/tool-registry-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry-types.js","sourceRoot":"","sources":["../../src/tool/tool-registry-types.ts"],"names":[],"mappings":""}

package/dist/tool/validate.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import { VntError } from "@vinhnt-sdk/schema";
+export declare class ToolInputError extends VntError {
+    readonly toolId: string;
+    constructor(toolId: string, issues: z.ZodIssue[]);
+}
+export declare function validateInput<T>(toolId: string, schema: z.ZodSchema<T>, input: unknown): T;
+export declare function createValidator<T>(toolId: string, schema: z.ZodSchema<T>): (input: unknown) => T;
+//# sourceMappingURL=validate.d.ts.map

package/dist/tool/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/tool/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAY,MAAM,KAAK,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,qBAAa,cAAe,SAAQ,QAAQ;aAExB,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAC9B,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAMvB;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAS1F;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,CAEhG"}

package/dist/tool/validate.js

@@ -0,0 +1,26 @@
+import { ZodError } from "zod";
+import { VntError } from "@vinhnt-sdk/schema";
+export class ToolInputError extends VntError {
+    toolId;
+    constructor(toolId, issues) {
+        const details = issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ");
+        super(`Validation failed for tool "${toolId}": ${details}`);
+        this.toolId = toolId;
+        this.name = "ToolInputError";
+    }
+}
+export function validateInput(toolId, schema, input) {
+    try {
+        return schema.parse(input);
+    }
+    catch (err) {
+        if (err instanceof ZodError) {
+            throw new ToolInputError(toolId, err.issues);
+        }
+        throw err;
+    }
+}
+export function createValidator(toolId, schema) {
+    return (input) => validateInput(toolId, schema, input);
+}
+//# sourceMappingURL=validate.js.map

package/dist/tool/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/tool/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAExB;IADlB,YACkB,MAAc,EAC9B,MAAoB;QAEpB,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClF,KAAK,CAAC,+BAA+B,MAAM,MAAM,OAAO,EAAE,CAAC,CAAC;QAJ5C,WAAM,GAAN,MAAM,CAAQ;QAK9B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,UAAU,aAAa,CAAI,MAAc,EAAE,MAAsB,EAAE,KAAc;IACrF,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAI,MAAc,EAAE,MAAsB;IACvE,OAAO,CAAC,KAAc,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAClE,CAAC"}

package/dist/tool/web-search-tool.d.ts

@@ -0,0 +1,24 @@
+export interface WebSearchToolConfig {
+    apiKey: string | (() => string);
+    /** Default number of search results (default: 5) */
+    defaultNumResults?: number;
+    /** Search timeout in ms (default: 15000) */
+    timeout?: number;
+}
+interface TavilyResult {
+    title: string;
+    url: string;
+    content: string;
+    score: number;
+}
+export declare function createWebSearchTool(config: WebSearchToolConfig): import("./definitions.js").ToolDefinition<{
+    query: string;
+    numResults?: number;
+    searchDepth?: "basic" | "advanced";
+}, {
+    results: TavilyResult[];
+    answer?: string;
+    error?: string;
+}>;
+export {};
+//# sourceMappingURL=web-search-tool.d.ts.map

package/dist/tool/web-search-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search-tool.d.ts","sourceRoot":"","sources":["../../src/tool/web-search-tool.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IAChC,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAOD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB;WAClC,MAAM;iBAAe,MAAM;kBAAgB,OAAO,GAAG,UAAU;;aAC/E,YAAY,EAAE;aACd,MAAM;YACP,MAAM;GA2DjB"}