@vinhnt-sdk/tools 0.1.1 → 0.1.3

package/dist/history-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history-hook.d.ts","sourceRoot":"","sources":["../src/history-hook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,QAAQ,CA+DxE"}
+{"version":3,"file":"history-hook.d.ts","sourceRoot":"","sources":["../src/history-hook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,sGAAsG;AACtG,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,QAAQ,CA+DxE"}

package/dist/history-hook.js

@@ -1,4 +1,5 @@
-import { readFileSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+/** Create a {@link ToolHook} that records write_file/edit_file changes into a {@link FileHistory}. */
 export function createFileHistoryHook(fileHistory) {
     const pending = new Map();
     return {
@@ -14,7 +15,7 @@ export function createFileHistoryHook(fileHistory) {
                 return null;
             let originalContent = "";
             try {
-                originalContent = readFileSync(filePath, "utf-8");
+                originalContent = await readFile(filePath, "utf-8");
             }
             catch {
                 originalContent = "";
@@ -40,7 +41,7 @@ export function createFileHistoryHook(fileHistory) {
             let originalContent = "";
             let newContent = "";
             try {
-                newContent = readFileSync(filePath, "utf-8");
+                newContent = await readFile(filePath, "utf-8");
             }
             catch { /* file may have been deleted */ }
             const p = pending.get(params.toolId);

package/dist/history-hook.js.map

@@ -1 +1 @@
-{"version":3,"file":"history-hook.js","sourceRoot":"","sources":["../src/history-hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAIvC,MAAM,UAAU,qBAAqB,CAAC,WAAwB;IAC5D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyD,CAAC;IAEjF,OAAO;QACL,EAAE,EAAE,cAAc;QAClB,KAAK,CAAC,GAAG,CAAC,MAAM;YACd,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,WAAW;gBAAE,OAAO,IAAI,CAAC;YACnF,MAAM,KAAK,GAAG,MAAM,CAAC,KAA4C,CAAC;YAClE,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;YAExB,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,CAAuB,CAAC;YACvF,IAAI,CAAC,QAAQ;gBAAE,OAAO,IAAI,CAAC;YAE3B,IAAI,eAAe,GAAG,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,eAAe,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACpD,CAAC;YAAC,MAAM,CAAC;gBACP,eAAe,GAAG,EAAE,CAAC;YACvB,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,MAAM;YACf,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBACvC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC9B,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,WAAW,EAAE,CAAC;gBACtE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC9B,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAA6C,CAAC;YAC3E,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,CAAuB,CAAC;YAC3E,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC9B,OAAO,IAAI,CAAC;YACd,CAAC;YAED,IAAI,eAAe,GAAG,EAAE,CAAC;YACzB,IAAI,UAAU,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,UAAU,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC/C,CAAC;YAAC,MAAM,CAAC,CAAC,gCAAgC,CAAC,CAAC;YAE5C,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,CAAC,EAAE,CAAC;gBACN,eAAe,GAAG,CAAC,CAAC,eAAe,CAAC;YACtC,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAE9B,MAAM,WAAW,CAAC,aAAa,CAAC;gBAC9B,QAAQ;gBACR,SAAS,EAAE,EAAE;gBACb,eAAe;gBACf,UAAU;gBACV,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE;aACzB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAEnB,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"history-hook.js","sourceRoot":"","sources":["../src/history-hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAI5C,sGAAsG;AACtG,MAAM,UAAU,qBAAqB,CAAC,WAAwB;IAC5D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyD,CAAC;IAEjF,OAAO;QACL,EAAE,EAAE,cAAc;QAClB,KAAK,CAAC,GAAG,CAAC,MAAM;YACd,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,WAAW;gBAAE,OAAO,IAAI,CAAC;YACnF,MAAM,KAAK,GAAG,MAAM,CAAC,KAA4C,CAAC;YAClE,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;YAExB,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,CAAuB,CAAC;YACvF,IAAI,CAAC,QAAQ;gBAAE,OAAO,IAAI,CAAC;YAE3B,IAAI,eAAe,GAAG,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,eAAe,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACtD,CAAC;YAAC,MAAM,CAAC;gBACP,eAAe,GAAG,EAAE,CAAC;YACvB,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,MAAM;YACf,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBACvC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC9B,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,WAAW,EAAE,CAAC;gBACtE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC9B,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAA6C,CAAC;YAC3E,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,CAAuB,CAAC;YAC3E,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC9B,OAAO,IAAI,CAAC;YACd,CAAC;YAED,IAAI,eAAe,GAAG,EAAE,CAAC;YACzB,IAAI,UAAU,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,UAAU,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACjD,CAAC;YAAC,MAAM,CAAC,CAAC,gCAAgC,CAAC,CAAC;YAE5C,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,CAAC,EAAE,CAAC;gBACN,eAAe,GAAG,CAAC,CAAC,eAAe,CAAC;YACtC,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAE9B,MAAM,WAAW,CAAC,aAAa,CAAC;gBAC9B,QAAQ;gBACR,SAAS,EAAE,EAAE;gBACb,eAAe;gBACf,UAAU;gBACV,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE;aACzB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAEnB,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/image-tools.d.ts

@@ -1,11 +1,21 @@
 import type { MessageContentPart } from "@vinhnt-sdk/schema";
-export declare function readImageToContentParts(filePath: string): Promise<MessageContentPart[]>;
-export declare function createReadImageTool(): import("./definitions.js").ToolDefinition<{
+import { isWithinWorkspace, type RootGetter } from "./file-tools.js";
+/**
+ * Read an image file into model message parts (`text` + base64 `image`),
+ * validating the file extension, magic bytes and workspace containment.
+ *
+ * When `workspaceRoot` is provided the path is checked against the workspace
+ * boundary (realpath-aware, symlink-safe) before reading.
+ */
+export declare function readImageToContentParts(filePath: string, workspaceRoot?: RootGetter, externalDirAccess?: boolean): Promise<MessageContentPart[]>;
+/** Create the `read_image` tool that returns image content for the model to analyze. */
+export declare function createReadImageTool(workspaceRoot: RootGetter, externalDirAccess?: boolean): import("@vinhnt-sdk/tools").ToolDefinition<{
     filePath: string;
 }, {
     filePath: string;
-    mimeType?: string;
+    mimeType?: string | undefined;
     size: number;
     message: string;
 }>;
+export { isWithinWorkspace };
 //# sourceMappingURL=image-tools.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"image-tools.d.ts","sourceRoot":"","sources":["../src/image-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAgB7D,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAEvF;AAkBD,wBAAgB,mBAAmB;cACH,MAAM;;cACxB,MAAM;eAAa,MAAM;UAAQ,MAAM;aAAW,MAAM;GAuBrE"}
+{"version":3,"file":"image-tools.d.ts","sourceRoot":"","sources":["../src/image-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAK7D,OAAO,EAAoB,iBAAiB,EAAe,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAoCpG;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,UAAU,EAAE,iBAAiB,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAEhJ;AA2BD,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,UAAU,EAAE,iBAAiB,CAAC,EAAE,OAAO;cAC1D,MAAM;;cACxB,MAAM;eAAa,MAAM,GAAG,SAAS;UAAQ,MAAM;aAAW,MAAM;GAgCjF;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/image-tools.js

@@ -1,7 +1,9 @@
 import { readFile } from "node:fs/promises";
-import { extname } from "node:path";
+import { extname, resolve } from "node:path";
+import { ValidationError } from "@vinhnt-sdk/schema";
 import { z } from "zod";
-import { defineTool } from "./define-tool.js";
+import { defineTool } from "@vinhnt-sdk/tools";
+import { ensurePathAccess, isWithinWorkspace, resolveRoot } from "./file-tools.js";
 const ReadImageSchema = z.object({
     filePath: z.string().min(1),
 });
@@ -12,44 +14,92 @@ const MIME_TYPES = {
     ".gif": "image/gif",
     ".webp": "image/webp",
 };
-export function readImageToContentParts(filePath) {
-    return readImageToContentPartsInner(filePath);
+const DEFAULT_MAX_IMAGE_SIZE = 8 * 1024 * 1024;
+/** Sniff the first bytes of a buffer to confirm it matches the claimed extension. */
+function sniffMagic(buffer, mimeType) {
+    switch (mimeType) {
+        case "image/png":
+            return buffer.length >= 8 && buffer.readUInt32BE(0) === 0x89504e47 && buffer.readUInt32BE(4) === 0x0d0a1a0a;
+        case "image/jpeg":
+            return buffer.length >= 3 && buffer[0] === 0xff && buffer[1] === 0xd8 && buffer[2] === 0xff;
+        case "image/gif":
+            return buffer.length >= 6 && buffer.subarray(0, 6).toString("ascii") === "GIF87a" || buffer.length >= 6 && buffer.subarray(0, 6).toString("ascii") === "GIF89a";
+        case "image/webp": {
+            if (buffer.length < 12)
+                return false;
+            const riff = buffer.subarray(0, 4).toString("ascii");
+            const webp = buffer.subarray(8, 12).toString("ascii");
+            return riff === "RIFF" && webp === "WEBP";
+        }
+        default:
+            return true;
+    }
+}
+/**
+ * Read an image file into model message parts (`text` + base64 `image`),
+ * validating the file extension, magic bytes and workspace containment.
+ *
+ * When `workspaceRoot` is provided the path is checked against the workspace
+ * boundary (realpath-aware, symlink-safe) before reading.
+ */
+export function readImageToContentParts(filePath, workspaceRoot, externalDirAccess) {
+    return readImageToContentPartsInner(filePath, workspaceRoot, externalDirAccess);
 }
-async function readImageToContentPartsInner(filePath) {
+async function readImageToContentPartsInner(filePath, workspaceRoot, externalDirAccess, ctx, maxSize) {
     const ext = extname(filePath).toLowerCase();
     const mimeType = MIME_TYPES[ext];
     if (!mimeType) {
-        throw new Error(`Unsupported image format: ${ext}. Supported: png, jpg, jpeg, gif, webp`);
+        throw new ValidationError(`Unsupported image format: ${ext}. Supported: png, jpg, jpeg, gif, webp`);
+    }
+    const target = workspaceRoot ? await ensurePathAccess(resolve(resolveRoot(workspaceRoot), filePath), resolveRoot(workspaceRoot), filePath, ctx ?? { ask: async () => "reject" }, externalDirAccess) : filePath;
+    const buffer = await readFile(target);
+    const cap = maxSize ?? DEFAULT_MAX_IMAGE_SIZE;
+    if (buffer.length > cap) {
+        throw new ValidationError(`Image too large (${buffer.length} bytes). Max: ${cap} bytes`);
+    }
+    if (!sniffMagic(buffer, mimeType)) {
+        throw new ValidationError(`File "${filePath}" does not match its extension (${ext}) — magic bytes mismatch`);
     }
-    const buffer = await readFile(filePath);
     const base64 = buffer.toString("base64");
     return [
         { type: "text", text: `[Image: ${filePath}]` },
         { type: "image", image: base64, mimeType },
     ];
 }
-export function createReadImageTool() {
+/** Create the `read_image` tool that returns image content for the model to analyze. */
+export function createReadImageTool(workspaceRoot, externalDirAccess) {
     return defineTool({
         name: "read_image",
         description: "Read an image file and return its content for the model to analyze",
         risk: "read",
         input: ReadImageSchema,
+        normalize: (input) => {
+            const v = input;
+            if (!v || typeof v !== "object")
+                return {};
+            if (!v.filePath && v.path && typeof v.path === "string") {
+                return { filePath: v.path };
+            }
+            return v;
+        },
         jsonSchema: {
             type: "object",
             properties: {
-                filePath: { type: "string", description: "Path to the image file" },
+                filePath: { type: "string", description: "Path relative to workspace root" },
+                path: { type: "string", description: "Alias for filePath" },
             },
-            required: ["filePath"],
         },
-        async execute(v) {
-            const parts = await readImageToContentParts(v.filePath);
+        async execute(v, ctx) {
+            const filePath = v.filePath;
+            const parts = await readImageToContentPartsInner(filePath, workspaceRoot, externalDirAccess, ctx);
             return {
-                filePath: v.filePath,
+                filePath,
                 mimeType: parts[1] && "mimeType" in parts[1] ? parts[1].mimeType : undefined,
                 size: parts[1] && "image" in parts[1] ? parts[1].image.length : 0,
-                message: `Image loaded: ${v.filePath}`,
+                message: `Image loaded: ${filePath}`,
             };
         },
     }).toDefinition();
 }
+export { isWithinWorkspace };
 //# sourceMappingURL=image-tools.js.map

package/dist/image-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"image-tools.js","sourceRoot":"","sources":["../src/image-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5B,CAAC,CAAC;AAEH,MAAM,UAAU,GAA2B;IACzC,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;CACtB,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,OAAO,4BAA4B,CAAC,QAAQ,CAAC,CAAC;AAChD,CAAC;AAED,KAAK,UAAU,4BAA4B,CAAC,QAAgB;IAC1D,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,wCAAwC,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEzC,OAAO;QACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,QAAQ,GAAG,EAAE;QAC9C,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE;KAC3C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,UAAU,CAEd;QACD,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,oEAAoE;QACjF,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,eAAe;QACtB,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;aACpE;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;QACD,KAAK,CAAC,OAAO,CAAC,CAAC;YACb,MAAM,KAAK,GAAG,MAAM,uBAAuB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACxD,OAAO;gBACL,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,CAAC,CAA2B,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;gBACvG,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,CAAC,CAAuB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACxF,OAAO,EAAE,iBAAiB,CAAC,CAAC,QAAQ,EAAE;aACvC,CAAC;QACJ,CAAC;KACF,CAAC,CAAC,YAAY,EAAE,CAAC;AACpB,CAAC"}
+{"version":3,"file":"image-tools.js","sourceRoot":"","sources":["../src/image-tools.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,57 +1,55 @@
-export type { ToolExecutionResult, ToolHook } from "./types.js";
-export { createReadFileTool } from "./file-tools.js";
-export { createWriteFileTool } from "./file-tools.js";
-export { createEditFileTool } from "./file-tools.js";
-export { createApplyPatchTool } from "./file-tools.js";
-export { createListDirectoryTool } from "./file-tools.js";
-export { createShellTool } from "./shell-tool.js";
-export type { ShellToolConfig } from "./shell-tool.js";
-export { createGitStatusTool } from "./git-tools.js";
-export { createGitDiffTool } from "./git-tools.js";
-export { createGitLogTool } from "./git-tools.js";
-export { createGitCommitTool } from "./git-tools.js";
-export { createGlobFilesTool } from "./search-tools.js";
-export { createGrepFilesTool } from "./search-tools.js";
-export { createWebFetchTool } from "./web-tools.js";
+/**
+ * @module tools
+ * Built-in tools for VNT Agent — file, shell, git, web, search, and more.
+ */
+export type { Tool, ToolConfig } from "./define-tool.js";
+export { defineTool, toolToDefinition, zodSchemaToNestedJsonSchema } from "./define-tool.js";
+export { commandPattern, prefix } from "./arity.js";
+export type { ToolDefinitionLike } from "@vinhnt-sdk/schema";
+export type { ToolDefinition, ToolRisk } from "./definitions.js";
+export type { ToolFilter, ToolPermissionRule, ToolMaterialization } from "./registry.js";
 export { ToolRegistry } from "./registry.js";
-export type { ToolPermissionRule, ToolMaterialization } from "./registry.js";
+export type { ToolContext, PermissionReply } from "./context.js";
+export type { ToolHook, ToolExecutionResult } from "./types.js";
+export type { JsonSchema7Object, JsonSchemaProperty } from "./json-schema.js";
+export { validateInput } from "./validate.js";
+export { ToolInputError } from "./validate.js";
+export { generateDiff } from "./diff.js";
+export type { UnifiedDiff } from "./diff.js";
 export { createCodingDomain } from "./domain.js";
 export type { DomainManifest } from "./domain.js";
-export { defineTool, toolToDefinition, zodSchemaToNestedJsonSchema } from "./define-tool.js";
-export type { Tool, ToolConfig } from "./define-tool.js";
 export { LazyToolRegistry } from "./lazy-registry.js";
 export type { LazyToolEntry } from "./lazy-registry.js";
+export { ToolProviderRegistry } from "./provider.js";
+export type { ToolProvider } from "./provider.js";
+export { ToolFileProvider, ToolFileLoader } from "./providers/index.js";
 export type { ApprovalHandler } from "./policy.js";
-export { ToolSandbox, signalToToolContext } from "./sandbox.js";
-export type { SandboxConfig } from "./sandbox.js";
+export { ToolSaga } from "./saga.js";
+export type { SagaEntry, CompensationAction } from "./saga.js";
+export { createReadFileTool, createWriteFileTool, createEditFileTool, createApplyPatchTool, createListDirectoryTool, ensurePathAccess, resolveRoot, DEFAULT_EXCLUDED_DIRS, } from "./file-tools.js";
+export type { RootGetter } from "./file-tools.js";
+export { createReadImageTool, readImageToContentParts } from "./image-tools.js";
 export { FileReadTracker } from "./read-tracker.js";
-export { generateDiff } from "./diff.js";
-export type { UnifiedDiff } from "./diff.js";
 export { InMemoryFileHistory } from "./file-history.js";
 export { createFileHistoryHook } from "./history-hook.js";
-export { readImageToContentParts, createReadImageTool } from "./image-tools.js";
+export type { FileHistory, FileVersion, UndoEntry } from "./file-history.js";
+export { createShellTool } from "./shell-tool.js";
+export type { ShellToolConfig } from "./shell-tool.js";
+export { ToolSandbox, signalToToolContext, createSandbox } from "./tool-sandbox.js";
+export { createGlobFilesTool, createGrepFilesTool, DEFAULT_IGNORED_DIRS } from "./search-tools.js";
+export { createToolSearchTool } from "./tool-search.js";
+export type { ToolSearchInput, ToolSearchResult } from "./tool-search.js";
+export { createWebFetchTool } from "./web-tools.js";
+export type { WebFetchToolConfig } from "./web-tools.js";
+export { createWebSearchTool, TavilySearchProvider, SerperSearchProvider } from "./web-search-tool.js";
+export type { WebSearchToolConfig, WebSearchProvider, WebSearchResponse, SearchResult } from "./web-search-tool.js";
+export { createGitStatusTool, createGitDiffTool, createGitLogTool, createGitCommitTool } from "./git-tools.js";
 export { createQuestionTool } from "./question-tool.js";
 export type { QuestionInput, QuestionHandler } from "./question-tool.js";
 export { createTodoWriteTool } from "./todo-tool.js";
-export { createWebSearchTool } from "./web-search-tool.js";
-export type { WebSearchToolConfig, WebSearchProvider } from "./web-search-tool.js";
-export { createToolSearchTool } from "./tool-search.js";
-export type { ToolSearchInput, ToolSearchResult } from "./tool-search.js";
-export { ToolProviderRegistry } from "./provider.js";
-export type { ToolProvider } from "./provider.js";
-export { BuiltinToolProvider, ToolFileProvider, ToolFileLoader, AgentToolProvider, SkillToolProvider } from "./providers/index.js";
-export type { BuiltinToolConfig } from "./providers/index.js";
-export { createToolProviderRegistry, createToolProvider } from "./provider-helpers.js";
-export type { ToolRisk, ToolDefinition } from "./definitions.js";
-export type { ToolDefinitionLike } from "@vinhnt-sdk/schema";
-export type { JsonSchema7Object, JsonSchemaProperty } from "./json-schema.js";
-export type { ToolFilter } from "./registry.js";
-export type { ToolContext, PermissionReply } from "./context.js";
-export type { SandboxScope, ProcessSandbox, SandboxResult } from "./sandbox.js";
-export type { FileHistory, FileVersion, UndoEntry } from "./file-history.js";
-export type { ToolDescriptionReport, ToolDescriptionIssue, DescriptionIssueCode } from "./description-lint.js";
+export { AgentToolProvider } from "./agent-provider.js";
+export type { KernelLike } from "./agent-provider.js";
+export { SkillToolProvider } from "./skill-provider.js";
+export { readImageToContentParts as readImageFromImageTools } from "./image-tools.js";
 export { lintToolDescription, lintToolDefinitions } from "./description-lint.js";
-export { validateInput, ToolInputError } from "./validate.js";
-export { createSandbox } from "./sandbox.js";
-export { commandPattern } from "./arity.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,36 +1,50 @@
-export { createReadFileTool } from "./file-tools.js";
-export { createWriteFileTool } from "./file-tools.js";
-export { createEditFileTool } from "./file-tools.js";
-export { createApplyPatchTool } from "./file-tools.js";
-export { createListDirectoryTool } from "./file-tools.js";
-export { createShellTool } from "./shell-tool.js";
-export { createGitStatusTool } from "./git-tools.js";
-export { createGitDiffTool } from "./git-tools.js";
-export { createGitLogTool } from "./git-tools.js";
-export { createGitCommitTool } from "./git-tools.js";
-export { createGlobFilesTool } from "./search-tools.js";
-export { createGrepFilesTool } from "./search-tools.js";
-export { createWebFetchTool } from "./web-tools.js";
+/**
+ * @module tools
+ * Built-in tools for VNT Agent — file, shell, git, web, search, and more.
+ */
+export { defineTool, toolToDefinition, zodSchemaToNestedJsonSchema } from "./define-tool.js";
+export { commandPattern, prefix } from "./arity.js";
 export { ToolRegistry } from "./registry.js";
+// === Validation ===
+export { validateInput } from "./validate.js";
+export { ToolInputError } from "./validate.js";
+// === Diff ===
+export { generateDiff } from "./diff.js";
+// === Domain ===
 export { createCodingDomain } from "./domain.js";
-export { defineTool, toolToDefinition, zodSchemaToNestedJsonSchema } from "./define-tool.js";
+// === Lazy registry ===
 export { LazyToolRegistry } from "./lazy-registry.js";
-export { ToolSandbox, signalToToolContext } from "./sandbox.js";
+// === Provider system ===
+export { ToolProviderRegistry } from "./provider.js";
+export { ToolFileProvider, ToolFileLoader } from "./providers/index.js";
+// === Saga ===
+export { ToolSaga } from "./saga.js";
+// === File tools ===
+export { createReadFileTool, createWriteFileTool, createEditFileTool, createApplyPatchTool, createListDirectoryTool, ensurePathAccess, resolveRoot, DEFAULT_EXCLUDED_DIRS, } from "./file-tools.js";
+// === Image tools ===
+export { createReadImageTool, readImageToContentParts } from "./image-tools.js";
+// === File history ===
 export { FileReadTracker } from "./read-tracker.js";
-export { generateDiff } from "./diff.js";
 export { InMemoryFileHistory } from "./file-history.js";
 export { createFileHistoryHook } from "./history-hook.js";
-export { readImageToContentParts, createReadImageTool } from "./image-tools.js";
+// === Shell tool ===
+export { createShellTool } from "./shell-tool.js";
+export { ToolSandbox, signalToToolContext, createSandbox } from "./tool-sandbox.js";
+// === Search tools ===
+export { createGlobFilesTool, createGrepFilesTool, DEFAULT_IGNORED_DIRS } from "./search-tools.js";
+export { createToolSearchTool } from "./tool-search.js";
+// === Web tools ===
+export { createWebFetchTool } from "./web-tools.js";
+export { createWebSearchTool, TavilySearchProvider, SerperSearchProvider } from "./web-search-tool.js";
+// === Git tools ===
+export { createGitStatusTool, createGitDiffTool, createGitLogTool, createGitCommitTool } from "./git-tools.js";
+// === Agent tools ===
 export { createQuestionTool } from "./question-tool.js";
 export { createTodoWriteTool } from "./todo-tool.js";
-export { createWebSearchTool } from "./web-search-tool.js";
-export { createToolSearchTool } from "./tool-search.js";
-// Provider system
-export { ToolProviderRegistry } from "./provider.js";
-export { BuiltinToolProvider, ToolFileProvider, ToolFileLoader, AgentToolProvider, SkillToolProvider } from "./providers/index.js";
-export { createToolProviderRegistry, createToolProvider } from "./provider-helpers.js";
+export { AgentToolProvider } from "./agent-provider.js";
+export { SkillToolProvider } from "./skill-provider.js";
+// === Image tools ===
+export { readImageToContentParts as readImageFromImageTools } from "./image-tools.js";
+// === Description lint ===
 export { lintToolDescription, lintToolDefinitions } from "./description-lint.js";
-export { validateInput, ToolInputError } from "./validate.js";
-export { createSandbox } from "./sandbox.js";
-export { commandPattern } from "./arity.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAE7F,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGxD,kBAAkB;AAClB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEnI,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAWvF,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAQpD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAW7C,qBAAqB;AAErB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,eAAe;AAEf,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGzC,iBAAiB;AAEjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjD,wBAAwB;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,0BAA0B;AAE1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAMxE,eAAe;AAEf,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC,qBAAqB;AAErB,OAAO,EACL,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAC3D,oBAAoB,EAAE,uBAAuB,EAC7C,gBAAgB,EAAE,WAAW,EAAE,qBAAqB,GACrD,MAAM,iBAAiB,CAAC;AAGzB,sBAAsB;AAEtB,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAEhF,uBAAuB;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,qBAAqB;AAErB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEpF,uBAAuB;AAEvB,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGxD,oBAAoB;AAEpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAGvG,oBAAoB;AAEpB,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE/G,sBAAsB;AAEtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,sBAAsB;AAEtB,OAAO,EAAE,uBAAuB,IAAI,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAEtF,2BAA2B;AAE3B,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/json-schema.d.ts

@@ -1,3 +1,4 @@
+/** Nested JSON Schema shape used to describe tool inputs. */
 export interface NestedJsonSchema {
     readonly type: "string" | "number" | "boolean" | "array" | "object";
     readonly description?: string;
@@ -7,6 +8,7 @@ export interface NestedJsonSchema {
     readonly items?: NestedJsonSchema;
     readonly required?: readonly string[];
 }
+/** A single property within a {@link JsonSchema7Object}. */
 export interface JsonSchemaProperty {
     readonly type: "string" | "number" | "boolean" | "array" | "object";
     readonly description?: string;
@@ -14,6 +16,7 @@ export interface JsonSchemaProperty {
     readonly default?: unknown;
     readonly items?: JsonSchemaProperty;
 }
+/** Minimal JSON Schema 7 object for tool input validation. */
 export interface JsonSchema7Object {
     readonly type: "object";
     readonly properties?: Record<string, JsonSchemaProperty>;

package/dist/json-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../src/json-schema.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC"}
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../src/json-schema.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;CACrC;AAED,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC"}

package/dist/kill-tree.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Tree-scoped process termination.
+ *
+ * `child.kill()` only terminates the direct child; grandchild processes keep
+ * running (orphaned). This module kills the whole process tree:
+ * - POSIX: child is spawned `detached` (own process group) → `kill(-pid)`
+ * - Windows: `taskkill /pid <pid> /T /F`
+ *
+ * Termination is idempotent: repeated kills for the same pid are no-ops.
+ *
+ * @module tool/kill-tree
+ * @packageDocumentation
+ */
+import { type ChildProcess } from "node:child_process";
+/** Clear the idempotency registry (used by tests). */
+export declare function resetKillTreeState(): void;
+/** True when the process (or its process group) is still alive. */
+export declare function isPidAlive(pid: number): boolean;
+/**
+ * Kill a child process and its whole subtree. Idempotent per pid.
+ *
+ * @param child - The spawned child process.
+ * @param signal - POSIX signal for the direct kill (default "SIGTERM").
+ *   Windows always uses `taskkill /T /F`.
+ * @returns `true` when the kill was issued (or already issued), `false` when
+ *   there is no pid yet (child not spawned).
+ */
+export declare function killProcessTree(child: ChildProcess, signal?: NodeJS.Signals): boolean;
+/**
+ * Cross-platform spawn option that makes `killProcessTree` reach the whole
+ * tree. On Windows no extra flag is needed (taskkill walks the tree).
+ */
+export declare function treeKillSpawnOptions(): {
+    detached: boolean;
+};
+//# sourceMappingURL=kill-tree.d.ts.map

package/dist/kill-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kill-tree.d.ts","sourceRoot":"","sources":["../src/kill-tree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAI9D,sDAAsD;AACtD,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQ/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,GAAE,MAAM,CAAC,OAAmB,GAAG,OAAO,CA6BhG;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAE5D"}

package/dist/kill-tree.js

@@ -0,0 +1,80 @@
+/**
+ * Tree-scoped process termination.
+ *
+ * `child.kill()` only terminates the direct child; grandchild processes keep
+ * running (orphaned). This module kills the whole process tree:
+ * - POSIX: child is spawned `detached` (own process group) → `kill(-pid)`
+ * - Windows: `taskkill /pid <pid> /T /F`
+ *
+ * Termination is idempotent: repeated kills for the same pid are no-ops.
+ *
+ * @module tool/kill-tree
+ * @packageDocumentation
+ */
+import { spawn } from "node:child_process";
+const terminatedPids = new Set();
+/** Clear the idempotency registry (used by tests). */
+export function resetKillTreeState() {
+    terminatedPids.clear();
+}
+/** True when the process (or its process group) is still alive. */
+export function isPidAlive(pid) {
+    if (!pid || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err.code !== "ESRCH";
+    }
+}
+/**
+ * Kill a child process and its whole subtree. Idempotent per pid.
+ *
+ * @param child - The spawned child process.
+ * @param signal - POSIX signal for the direct kill (default "SIGTERM").
+ *   Windows always uses `taskkill /T /F`.
+ * @returns `true` when the kill was issued (or already issued), `false` when
+ *   there is no pid yet (child not spawned).
+ */
+export function killProcessTree(child, signal = "SIGTERM") {
+    const pid = child.pid;
+    if (!pid || pid <= 0)
+        return false;
+    if (terminatedPids.has(pid))
+        return true;
+    terminatedPids.add(pid);
+    if (process.platform === "win32") {
+        spawn("taskkill", ["/pid", String(pid), "/T", "/F"], {
+            windowsHide: true,
+            stdio: "ignore",
+        }).unref();
+        return true;
+    }
+    // POSIX: the child was spawned detached → kill the whole process group.
+    try {
+        process.kill(-pid, signal);
+    }
+    catch (err) {
+        if (err.code === "ESRCH") {
+            // Already gone — group kill is best-effort.
+            return true;
+        }
+        try {
+            process.kill(pid, signal);
+        }
+        catch {
+            // Already gone.
+        }
+    }
+    return true;
+}
+/**
+ * Cross-platform spawn option that makes `killProcessTree` reach the whole
+ * tree. On Windows no extra flag is needed (taskkill walks the tree).
+ */
+export function treeKillSpawnOptions() {
+    return { detached: process.platform !== "win32" };
+}
+//# sourceMappingURL=kill-tree.js.map

package/dist/kill-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kill-tree.js","sourceRoot":"","sources":["../src/kill-tree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAE9D,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;AAEzC,sDAAsD;AACtD,MAAM,UAAU,kBAAkB;IAChC,cAAc,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAQ,GAA6B,CAAC,IAAI,KAAK,OAAO,CAAC;IACzD,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,KAAmB,EAAE,SAAyB,SAAS;IACrF,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;IACtB,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAExB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,KAAK,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;YACnD,WAAW,EAAE,IAAI;YACjB,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wEAAwE;IACxE,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACpD,4CAA4C;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;AACpD,CAAC"}

package/dist/lazy-registry.d.ts

@@ -1,11 +1,13 @@
-import type { ToolDefinition } from "./definitions.js";
+import type { ToolDefinition, ToolRisk } from "./definitions.js";
 import { ToolRegistry } from "./registry.js";
+/** A tool registered for lazy, on-demand construction. */
 export interface LazyToolEntry {
     id: string;
-    risk?: "low" | "medium" | "high";
+    risk?: ToolRisk;
     factory: () => Promise<ToolDefinition>;
     instance?: ToolDefinition;
 }
+/** A {@link ToolRegistry} that constructs tools lazily on first resolve. */
 export declare class LazyToolRegistry extends ToolRegistry {
     private entries;
     private loading;
@@ -13,7 +15,7 @@ export declare class LazyToolRegistry extends ToolRegistry {
     resolve(id: string): Promise<ToolDefinition | undefined>;
     register(tool: ToolDefinition): void;
     unregister(id: string): boolean;
-    list(): ToolDefinition[];
+    list(): readonly ToolDefinition[];
     listLazy(): LazyToolEntry[];
     count(): number;
     getOrThrow(id: string): ToolDefinition;

package/dist/lazy-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lazy-registry.d.ts","sourceRoot":"","sources":["../src/lazy-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACjC,OAAO,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,OAAO,CAA8C;IAE7D,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAIlC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAkBrD,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAKpC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B,IAAI,IAAI,cAAc,EAAE;IAMjC,QAAQ,IAAI,aAAa,EAAE;IAIlB,KAAK,IAAI,MAAM;IAIf,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc;IAM/C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIvB,UAAU,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;CAQ9C"}
+{"version":3,"file":"lazy-registry.d.ts","sourceRoot":"","sources":["../src/lazy-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,4EAA4E;AAC5E,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,OAAO,CAA8C;IAE7D,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAIlC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAkBrD,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAKpC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B,IAAI,IAAI,SAAS,cAAc,EAAE;IAM1C,QAAQ,IAAI,aAAa,EAAE;IAIlB,KAAK,IAAI,MAAM;IAIf,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc;IAM/C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIvB,UAAU,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;CAQ9C"}