@vinhnt-sdk/tools 1.0.0

package/dist/web-search-tool.js

@@ -0,0 +1,134 @@
+import { z } from "zod";
+import { defineTool } from "./define-tool.js";
+const WebSearchSchema = z.object({
+    query: z.string().min(1),
+    numResults: z.number().int().positive().optional(),
+    searchDepth: z.enum(["basic", "advanced"]).optional(),
+    livecrawl: z.enum(["fallback", "preferred"]).optional(),
+    type: z.enum(["auto", "fast", "deep"]).optional(),
+    contextMaxCharacters: z.number().int().positive().optional(),
+});
+/**
+ * Default API URLs — exported for convenience.
+ * User override được qua baseUrl option.
+ */
+export const DEFAULT_TAVILY_URL = "https://api.tavily.com/search";
+export const DEFAULT_SERPER_URL = "https://google.serper.dev/search";
+/**
+ * Tavily search provider adapter — convenience only.
+ * User có thể tự implement provider khác: Serper, Bing, Google...
+ */
+export class TavilySearchProvider {
+    name = "tavily";
+    apiKey;
+    defaultNumResults;
+    baseUrl;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.defaultNumResults = config.defaultNumResults ?? 5;
+        this.baseUrl = config.baseUrl ?? DEFAULT_TAVILY_URL;
+    }
+    async search(query, options) {
+        const response = await fetch(this.baseUrl, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                api_key: this.apiKey,
+                query,
+                search_depth: options?.searchDepth ?? "basic",
+                max_results: options?.numResults ?? this.defaultNumResults,
+            }),
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => "");
+            throw new Error(`Tavily API error: HTTP ${response.status}${text ? ` — ${text}` : ""}`);
+        }
+        return response.json();
+    }
+}
+/**
+ * Serper (Google Search) provider adapter — convenience only.
+ */
+export class SerperSearchProvider {
+    name = "serper";
+    apiKey;
+    defaultNumResults;
+    baseUrl;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.defaultNumResults = config.defaultNumResults ?? 5;
+        this.baseUrl = config.baseUrl ?? DEFAULT_SERPER_URL;
+    }
+    async search(query, options) {
+        const response = await fetch(this.baseUrl, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "X-API-KEY": this.apiKey,
+            },
+            body: JSON.stringify({
+                q: query,
+                num: options?.numResults ?? this.defaultNumResults,
+            }),
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => "");
+            throw new Error(`Serper API error: HTTP ${response.status}${text ? ` — ${text}` : ""}`);
+        }
+        const data = (await response.json());
+        return {
+            results: (data.organic ?? []).map((r) => ({
+                title: r.title,
+                url: r.link,
+                content: r.snippet,
+                score: 1,
+            })),
+        };
+    }
+}
+export function createWebSearchTool(config) {
+    return defineTool({
+        name: "web_search",
+        description: `Search the web for information. Uses ${config.provider.name} search API. Returns a list of relevant results with titles, URLs, and content snippets.`,
+        risk: "read",
+        input: WebSearchSchema,
+        jsonSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "Search query" },
+                numResults: { type: "number", description: "Number of results to return (default: 5, max: 20)" },
+                searchDepth: { type: "string", enum: ["basic", "advanced"], description: "Search depth (default: basic)" },
+            },
+            required: ["query"],
+        },
+        async execute(v, _ctx) {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), config.timeout ?? 15000);
+            try {
+                const data = await config.provider.search(v.query, {
+                    numResults: v.numResults ?? config.defaultNumResults,
+                    searchDepth: v.searchDepth,
+                });
+                return {
+                    results: data.results.map((r) => ({
+                        title: r.title,
+                        url: r.url,
+                        content: r.content,
+                        score: r.score,
+                    })),
+                    answer: data.answer ?? undefined,
+                };
+            }
+            catch (error) {
+                return {
+                    results: [],
+                    error: `Web search failed: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+            finally {
+                clearTimeout(timeout);
+            }
+        },
+    }).toDefinition();
+}
+//# sourceMappingURL=web-search-tool.js.map

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

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

package/dist/web-tools.d.ts

@@ -0,0 +1,10 @@
+export interface WebFetchToolConfig {
+    /** Maximum response size in bytes (default: 524288) */
+    maxResponseSize?: number;
+}
+export declare function createWebFetchTool(config?: WebFetchToolConfig): import("./definitions.js").ToolDefinition<{
+    url: string;
+    format?: "markdown" | "text" | "html";
+    timeout?: number;
+}, string>;
+//# sourceMappingURL=web-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web-tools.d.ts","sourceRoot":"","sources":["../src/web-tools.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,kBAAkB;SACnC,MAAM;aAAW,UAAU,GAAG,MAAM,GAAG,MAAM;cAAY,MAAM;WAoCzF"}

package/dist/web-tools.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { defineTool } from "./define-tool.js";
+import { sanitizeForLLM } from "@vinhnt-sdk/security";
+const WebFetchSchema = z.object({
+    url: z.string().url().or(z.string().min(1)),
+    format: z.enum(["markdown", "text", "html"]).optional(),
+    timeout: z.number().positive().optional(),
+});
+export function createWebFetchTool(config) {
+    return defineTool({
+        name: "web_fetch",
+        description: "Fetch content from a URL and return it as text. Max 512KB.",
+        risk: "read",
+        input: WebFetchSchema,
+        jsonSchema: {
+            type: "object",
+            properties: {
+                url: { type: "string", description: "The URL to fetch" },
+                format: { type: "string", enum: ["text", "html"], description: "Response format (default: text)" },
+                timeout: { type: "number", description: "Timeout in ms (default: 15000)" },
+            },
+            required: ["url"],
+        },
+        async execute(v, _ctx) {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), v.timeout ?? 15000);
+            try {
+                const response = await fetch(v.url, {
+                    signal: controller.signal,
+                    headers: { "User-Agent": "VNT-Agent/0.1" },
+                });
+                if (!response.ok) {
+                    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+                }
+                const text = await response.text();
+                const maxSize = config?.maxResponseSize ?? 524_288;
+                const raw = text.length > maxSize
+                    ? text.slice(0, maxSize) + `\n\n[truncated: response exceeds ${maxSize} bytes]`
+                    : v.format === "html" ? text : stripHtml(text);
+                return sanitizeForLLM(raw, "web_fetch");
+            }
+            finally {
+                clearTimeout(timeout);
+            }
+        },
+    }).toDefinition();
+}
+function stripHtml(html) {
+    return html
+        .replace(/<script[^>]*>[\s\S]*?<\/script>/gi, "")
+        .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, "")
+        .replace(/<[^>]+>/g, "")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#x27;/g, "'")
+        .replace(/&#x2F;/g, "/")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+//# sourceMappingURL=web-tools.js.map

package/dist/web-tools.js.map

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

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@vinhnt-sdk/tools",
+  "version": "1.0.0",
+  "description": "Built-in tools for vinhnt-sdk — file, shell, git, web, search, image, and more",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nguyen-thanh-vinh/vinhnt-sdk.git",
+    "directory": "packages/tools"
+  },
+  "homepage": "https://github.com/nguyen-thanh-vinh/vinhnt-sdk/tree/main/packages/tools",
+  "bugs": {
+    "url": "https://github.com/nguyen-thanh-vinh/vinhnt-sdk/issues"
+  },
+  "keywords": [
+    "vnt",
+    "tools",
+    "file",
+    "shell",
+    "git",
+    "web",
+    "search"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "zod": "^4.4.3",
+    "@vinhnt-sdk/schema": "1.0.0",
+    "@vinhnt-sdk/security": "1.0.0"
+  },
+  "peerDependencies": {
+    "@vinhnt-sdk/core": "1.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc --noEmit",
+    "clean": "node -e \"try{require('fs').rmSync('dist',{recursive:true,force:true})}catch(e){}\" && node -e \"try{require('fs').rmSync('tsconfig.tsbuildinfo',{force:true})}catch(e){}\""
+  }
+}