anantham-v2 2.0.0-alpha.1

package/dist/tools/native/filesystem-tools.js

@@ -0,0 +1,141 @@
+import fs from "node:fs";
+import path from "node:path";
+import { resolveSafePath } from "./path-utils.js";
+export function createFilesystemTools(options = {}) {
+    const getRoot = () => options.projectRoot || process.cwd();
+    const maxFileSize = options.maxFileSize || 10 * 1024 * 1024; // 10MB
+    const readFileTool = {
+        definition: {
+            name: "read_file",
+            description: "Read text contents of a file within the project boundary.",
+            parametersSchema: {
+                type: "object",
+                properties: {
+                    path: { type: "string" },
+                    encoding: { type: "string" },
+                },
+                required: ["path"],
+            },
+            isIdempotent: true,
+            riskLevel: "low",
+        },
+        handler: async (args) => {
+            const safePath = resolveSafePath(getRoot(), args.path);
+            const stat = fs.statSync(safePath);
+            if (stat.size > maxFileSize) {
+                throw new Error(`File size ${stat.size} exceeds maximum allowable read limit of ${maxFileSize} bytes.`);
+            }
+            const content = fs.readFileSync(safePath, {
+                encoding: args.encoding || "utf8",
+            });
+            return { path: args.path, content, size: stat.size };
+        },
+    };
+    const writeFileTool = {
+        definition: {
+            name: "write_file",
+            description: "Write text contents to a file within the project boundary.",
+            parametersSchema: {
+                type: "object",
+                properties: {
+                    path: { type: "string" },
+                    content: { type: "string" },
+                    encoding: { type: "string" },
+                },
+                required: ["path", "content"],
+            },
+            isIdempotent: false,
+            riskLevel: "medium",
+        },
+        handler: async (args) => {
+            const safePath = resolveSafePath(getRoot(), args.path);
+            fs.mkdirSync(path.dirname(safePath), { recursive: true });
+            fs.writeFileSync(safePath, args.content, {
+                encoding: args.encoding || "utf8",
+            });
+            return { path: args.path, bytesWritten: Buffer.byteLength(args.content, args.encoding || "utf8") };
+        },
+    };
+    const listDirTool = {
+        definition: {
+            name: "list_dir",
+            description: "List entries in a directory within the project boundary.",
+            parametersSchema: {
+                type: "object",
+                properties: {
+                    path: { type: "string" },
+                    recursive: { type: "boolean" },
+                },
+            },
+            isIdempotent: true,
+            riskLevel: "low",
+        },
+        handler: async (args) => {
+            const targetDir = args.path ? resolveSafePath(getRoot(), args.path) : getRoot();
+            const entries = fs.readdirSync(targetDir, {
+                withFileTypes: true,
+                recursive: Boolean(args.recursive),
+            });
+            return {
+                path: args.path || ".",
+                entries: entries.map((entry) => ({
+                    name: entry.name,
+                    isDirectory: entry.isDirectory(),
+                    isFile: entry.isFile(),
+                })),
+            };
+        },
+    };
+    const fileStatTool = {
+        definition: {
+            name: "file_stat",
+            description: "Inspect file or directory metadata within the project boundary.",
+            parametersSchema: {
+                type: "object",
+                properties: {
+                    path: { type: "string" },
+                },
+                required: ["path"],
+            },
+            isIdempotent: true,
+            riskLevel: "low",
+        },
+        handler: async (args) => {
+            const safePath = resolveSafePath(getRoot(), args.path);
+            const stat = fs.statSync(safePath);
+            return {
+                path: args.path,
+                size: stat.size,
+                isDirectory: stat.isDirectory(),
+                isFile: stat.isFile(),
+                mtime: stat.mtime.toISOString(),
+            };
+        },
+    };
+    const deleteFileTool = {
+        definition: {
+            name: "delete_file",
+            description: "Delete a file or directory within the project boundary.",
+            parametersSchema: {
+                type: "object",
+                properties: {
+                    path: { type: "string" },
+                    recursive: { type: "boolean" },
+                },
+                required: ["path"],
+            },
+            isIdempotent: false,
+            riskLevel: "high",
+        },
+        handler: async (args) => {
+            const safePath = resolveSafePath(getRoot(), args.path);
+            if (!fs.existsSync(safePath)) {
+                return { path: args.path, deleted: false, reason: "File not found." };
+            }
+            fs.rmSync(safePath, { recursive: Boolean(args.recursive), force: true });
+            return { path: args.path, deleted: true };
+        },
+    };
+    return [readFileTool, writeFileTool, listDirTool, fileStatTool, deleteFileTool];
+}
+//# sourceMappingURL=filesystem-tools.js.map

package/dist/tools/native/filesystem-tools.js.map

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

package/dist/tools/native/git-tools.d.ts

@@ -0,0 +1,6 @@
+import { type ToolRegistration } from "../tool-registry.js";
+export interface GitToolsOptions {
+    projectRoot?: string;
+}
+export declare function createGitTools(options?: GitToolsOptions): ToolRegistration[];
+//# sourceMappingURL=git-tools.d.ts.map

package/dist/tools/native/git-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/native/git-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAK5D,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,eAAoB,GAAG,gBAAgB,EAAE,CA2JhF"}

package/dist/tools/native/git-tools.js

@@ -0,0 +1,153 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { resolveSafePath } from "./path-utils.js";
+const execAsync = promisify(exec);
+export function createGitTools(options = {}) {
+    const getRoot = () => options.projectRoot || process.cwd();
+    const gitStatusTool = {
+        definition: {
+            name: "git_status",
+            description: "Get Git working tree status for the project repository.",
+            parametersSchema: {
+                type: "object",
+                properties: { path: { type: "string" } },
+            },
+            isIdempotent: true,
+            riskLevel: "low",
+        },
+        handler: async (args) => {
+            const root = args.path ? resolveSafePath(getRoot(), args.path) : getRoot();
+            const { stdout } = await execAsync("git status --porcelain", { cwd: root });
+            return { status: stdout.trim(), clean: stdout.trim().length === 0 };
+        },
+    };
+    const gitDiffTool = {
+        definition: {
+            name: "git_diff",
+            description: "Get Git diff of working tree or staged changes.",
+            parametersSchema: {
+                type: "object",
+                properties: {
+                    path: { type: "string" },
+                    cached: { type: "boolean" },
+                },
+            },
+            isIdempotent: true,
+            riskLevel: "low",
+        },
+        handler: async (args) => {
+            const root = getRoot();
+            const flag = args.cached ? "--cached" : "";
+            const pathArg = args.path ? ` -- "${resolveSafePath(root, args.path)}"` : "";
+            const { stdout } = await execAsync(`git diff ${flag}${pathArg}`.trim(), { cwd: root });
+            return { diff: stdout.trim() };
+        },
+    };
+    const gitLogTool = {
+        definition: {
+            name: "git_log",
+            description: "View recent Git commit log for the project repository.",
+            parametersSchema: {
+                type: "object",
+                properties: { maxCount: { type: "number" } },
+            },
+            isIdempotent: true,
+            riskLevel: "low",
+        },
+        handler: async (args) => {
+            const count = args.maxCount || 10;
+            const { stdout } = await execAsync(`git log -n ${count} --oneline`, { cwd: getRoot() });
+            return { commits: stdout.trim().split("\n").filter(Boolean) };
+        },
+    };
+    const gitCommitTool = {
+        definition: {
+            name: "git_commit",
+            description: "Create a Git commit with a specified commit message.",
+            parametersSchema: {
+                type: "object",
+                properties: {
+                    message: { type: "string" },
+                    allowEmpty: { type: "boolean" },
+                },
+                required: ["message"],
+            },
+            isIdempotent: false,
+            riskLevel: "high",
+        },
+        handler: async (args) => {
+            const emptyFlag = args.allowEmpty ? "--allow-empty" : "";
+            const msg = JSON.stringify(args.message);
+            const { stdout } = await execAsync(`git commit ${emptyFlag} -m ${msg}`.trim(), {
+                cwd: getRoot(),
+            });
+            return { output: stdout.trim() };
+        },
+    };
+    const worktreeListTool = {
+        definition: {
+            name: "worktree_list",
+            description: "List active Git worktrees.",
+            parametersSchema: { type: "object", properties: {} },
+            isIdempotent: true,
+            riskLevel: "low",
+        },
+        handler: async () => {
+            const { stdout } = await execAsync("git worktree list", { cwd: getRoot() });
+            return { worktrees: stdout.trim().split("\n").filter(Boolean) };
+        },
+    };
+    const worktreeAddTool = {
+        definition: {
+            name: "worktree_add",
+            description: "Create an isolated Git worktree.",
+            parametersSchema: {
+                type: "object",
+                properties: {
+                    path: { type: "string" },
+                    branch: { type: "string" },
+                },
+                required: ["path", "branch"],
+            },
+            isIdempotent: false,
+            riskLevel: "high",
+        },
+        handler: async (args) => {
+            const safePath = resolveSafePath(getRoot(), args.path);
+            const { stdout } = await execAsync(`git worktree add "${safePath}" "${args.branch}"`, {
+                cwd: getRoot(),
+            });
+            return { path: args.path, output: stdout.trim() };
+        },
+    };
+    const worktreeRemoveTool = {
+        definition: {
+            name: "worktree_remove",
+            description: "Remove an isolated Git worktree.",
+            parametersSchema: {
+                type: "object",
+                properties: { path: { type: "string" } },
+                required: ["path"],
+            },
+            isIdempotent: false,
+            riskLevel: "high",
+        },
+        handler: async (args) => {
+            const safePath = resolveSafePath(getRoot(), args.path);
+            const { stdout } = await execAsync(`git worktree remove "${safePath}" --force`, {
+                cwd: getRoot(),
+            });
+            return { path: args.path, output: stdout.trim() };
+        },
+    };
+    return [
+        gitStatusTool,
+        gitDiffTool,
+        gitLogTool,
+        gitCommitTool,
+        worktreeListTool,
+        worktreeAddTool,
+        worktreeRemoveTool,
+    ];
+}
+//# sourceMappingURL=git-tools.js.map

package/dist/tools/native/git-tools.js.map

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

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

@@ -0,0 +1,14 @@
+/**
+ * Anantham V2 — Native Tools Suite
+ * PRD Part 1 Section 83-90 & PRD Part 2 Section 41-48 / P4.3
+ */
+export * from "./path-utils.js";
+export * from "./filesystem-tools.js";
+export * from "./search-tools.js";
+export * from "./process-tools.js";
+export * from "./git-tools.js";
+export * from "./artifact-tools.js";
+export * from "./memory-tools.js";
+export * from "./network-tools.js";
+export * from "./register-native-tools.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/native/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC"}

package/dist/tools/native/index.js

@@ -0,0 +1,14 @@
+/**
+ * Anantham V2 — Native Tools Suite
+ * PRD Part 1 Section 83-90 & PRD Part 2 Section 41-48 / P4.3
+ */
+export * from "./path-utils.js";
+export * from "./filesystem-tools.js";
+export * from "./search-tools.js";
+export * from "./process-tools.js";
+export * from "./git-tools.js";
+export * from "./artifact-tools.js";
+export * from "./memory-tools.js";
+export * from "./network-tools.js";
+export * from "./register-native-tools.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/native/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC"}

package/dist/tools/native/memory-tools.d.ts

@@ -0,0 +1,7 @@
+import { type ToolRegistration } from "../tool-registry.js";
+import { type MemoryManager } from "../../memory/memory-manager.js";
+export interface MemoryToolsOptions {
+    memoryManager?: MemoryManager;
+}
+export declare function createMemoryTools(options?: MemoryToolsOptions): ToolRegistration[];
+//# sourceMappingURL=memory-tools.d.ts.map

package/dist/tools/native/memory-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/native/memory-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,gBAAgB,EAAE,CAqGtF"}

package/dist/tools/native/memory-tools.js

@@ -0,0 +1,92 @@
+export function createMemoryTools(options = {}) {
+    // In-memory fallback if no MemoryManager injected
+    const memoryFallback = new Map();
+    const storeMemoryTool = {
+        definition: {
+            name: "store_memory",
+            description: "Store a scoped memory entry within the project memory namespace.",
+            parametersSchema: {
+                type: "object",
+                properties: {
+                    namespace: { type: "string" },
+                    key: { type: "string" },
+                    content: { type: "string" },
+                    tags: { type: "array" },
+                },
+                required: ["namespace", "key", "content"],
+            },
+            isIdempotent: false,
+            riskLevel: "medium",
+        },
+        handler: async (args, context) => {
+            const memoryKey = `${context.project.id}::${args.namespace}::${args.key}`;
+            if (options.memoryManager) {
+                const item = await options.memoryManager.saveMemory({
+                    id: `mem_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+                    projectId: context.project.id,
+                    scope: "project",
+                    type: args.namespace,
+                    content: args.content,
+                    confidence: 1.0,
+                    priority: "NORMAL",
+                    sensitivity: "normal",
+                    sourceEventIds: [],
+                    createdAt: new Date().toISOString(),
+                    tags: args.tags || [],
+                    metadata: { key: args.key },
+                });
+                return {
+                    id: item.id,
+                    namespace: item.type,
+                    key: args.key,
+                    stored: true,
+                };
+            }
+            memoryFallback.set(memoryKey, {
+                namespace: args.namespace,
+                key: args.key,
+                content: args.content,
+                tags: args.tags || [],
+            });
+            return {
+                id: `mem_${Date.now()}`,
+                namespace: args.namespace,
+                key: args.key,
+                stored: true,
+            };
+        },
+    };
+    const retrieveMemoryTool = {
+        definition: {
+            name: "retrieve_memory",
+            description: "Query and retrieve scoped memories matching keywords or namespace.",
+            parametersSchema: {
+                type: "object",
+                properties: {
+                    namespace: { type: "string" },
+                    query: { type: "string" },
+                    limit: { type: "number" },
+                },
+                required: ["namespace", "query"],
+            },
+            isIdempotent: true,
+            riskLevel: "low",
+        },
+        handler: async (args) => {
+            const limit = args.limit || 10;
+            const results = Array.from(memoryFallback.values())
+                .filter((m) => m.namespace === args.namespace &&
+                (m.key.toLowerCase().includes(String(args.query).toLowerCase()) ||
+                    m.content.toLowerCase().includes(String(args.query).toLowerCase())))
+                .slice(0, limit);
+            return {
+                namespace: args.namespace,
+                query: args.query,
+                count: results.length,
+                memories: results,
+            };
+        },
+    };
+    return [storeMemoryTool, retrieveMemoryTool];
+}
+//# sourceMappingURL=memory-tools.js.map

package/dist/tools/native/memory-tools.js.map

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

package/dist/tools/native/network-tools.d.ts

@@ -0,0 +1,8 @@
+import { type ToolRegistration } from "../tool-registry.js";
+export interface NetworkToolsOptions {
+    allowLocalhost?: boolean;
+    defaultTimeoutMs?: number;
+    maxResponseBytes?: number;
+}
+export declare function createNetworkTools(options?: NetworkToolsOptions): ToolRegistration[];
+//# sourceMappingURL=network-tools.d.ts.map

package/dist/tools/native/network-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/native/network-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,gBAAgB,EAAE,CA4FxF"}

package/dist/tools/native/network-tools.js

@@ -0,0 +1,83 @@
+export function createNetworkTools(options = {}) {
+    const defaultTimeoutMs = options.defaultTimeoutMs || 15000;
+    const maxResponseBytes = options.maxResponseBytes || 5 * 1024 * 1024; // 5MB
+    const fetchUrlTool = {
+        definition: {
+            name: "fetch_url",
+            description: "Perform an HTTP request to an external URL with SSRF boundary protection.",
+            parametersSchema: {
+                type: "object",
+                properties: {
+                    url: { type: "string" },
+                    method: { type: "string" },
+                    headers: { type: "object" },
+                    timeoutMs: { type: "number" },
+                },
+                required: ["url"],
+            },
+            isIdempotent: false,
+            riskLevel: "high",
+        },
+        handler: async (args, context) => {
+            let parsedUrl;
+            try {
+                parsedUrl = new URL(args.url);
+            }
+            catch {
+                throw new Error(`Invalid URL provided: "${args.url}".`);
+            }
+            if (parsedUrl.protocol !== "http:" && parsedUrl.protocol !== "https:") {
+                throw new Error(`Security violation: Unsupported protocol "${parsedUrl.protocol}". Only HTTP/HTTPS allowed.`);
+            }
+            // SSRF Boundary Check
+            const hostname = parsedUrl.hostname.toLowerCase();
+            if (!options.allowLocalhost) {
+                if (hostname === "localhost" ||
+                    hostname === "127.0.0.1" ||
+                    hostname === "::1" ||
+                    hostname === "169.254.169.254" ||
+                    hostname.startsWith("192.168.") ||
+                    hostname.startsWith("10.") ||
+                    hostname.endsWith(".internal") ||
+                    hostname.endsWith(".local")) {
+                    throw new Error(`Security violation: Request to internal/private network target "${hostname}" blocked by SSRF policy.`);
+                }
+            }
+            const controller = new AbortController();
+            const timeout = args.timeoutMs || defaultTimeoutMs;
+            const timeoutId = setTimeout(() => controller.abort(), timeout);
+            if (context.signal) {
+                context.signal.addEventListener("abort", () => controller.abort());
+            }
+            try {
+                const response = await fetch(parsedUrl.toString(), {
+                    method: args.method || "GET",
+                    headers: args.headers || {},
+                    signal: controller.signal,
+                });
+                const text = await response.text();
+                clearTimeout(timeoutId);
+                if (Buffer.byteLength(text) > maxResponseBytes) {
+                    throw new Error(`Response size exceeds limit of ${maxResponseBytes} bytes.`);
+                }
+                // Secret scrubbing in response
+                const cleanBody = text.replace(/sk-[a-zA-Z0-9_-]{10,}/g, "[REDACTED_SECRET]");
+                return {
+                    status: response.status,
+                    statusText: response.statusText,
+                    headers: Object.fromEntries(response.headers.entries()),
+                    body: cleanBody,
+                };
+            }
+            catch (err) {
+                clearTimeout(timeoutId);
+                if (err.name === "AbortError") {
+                    throw new Error(`Request timed out after ${timeout}ms.`);
+                }
+                throw err;
+            }
+        },
+    };
+    return [fetchUrlTool];
+}
+//# sourceMappingURL=network-tools.js.map

package/dist/tools/native/network-tools.js.map

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

package/dist/tools/native/path-utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Safely resolves and canonicalizes a path within the specified project root boundary.
+ * Throws a SecurityError if traversal or escape is detected.
+ */
+export declare function resolveSafePath(projectRoot: string, targetPath: string): string;
+//# sourceMappingURL=path-utils.d.ts.map

package/dist/tools/native/path-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../../../src/tools/native/path-utils.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CA0B/E"}

package/dist/tools/native/path-utils.js

@@ -0,0 +1,26 @@
+import path from "node:path";
+/**
+ * Safely resolves and canonicalizes a path within the specified project root boundary.
+ * Throws a SecurityError if traversal or escape is detected.
+ */
+export function resolveSafePath(projectRoot, targetPath) {
+    if (!targetPath || typeof targetPath !== "string") {
+        throw new Error("Target path must be a valid non-empty string.");
+    }
+    // Null byte injection check
+    if (targetPath.includes("\0")) {
+        throw new Error("Security violation: Null byte detected in path.");
+    }
+    // URL encoded traversal check
+    if (targetPath.includes("%2e%2e") || targetPath.includes("%2E%2E")) {
+        throw new Error("Security violation: Encoded traversal sequence detected.");
+    }
+    const normalizedRoot = path.resolve(projectRoot);
+    const resolved = path.resolve(normalizedRoot, targetPath);
+    // Containment check
+    if (!resolved.startsWith(normalizedRoot)) {
+        throw new Error(`Security violation: Path "${targetPath}" attempts to escape project boundary "${projectRoot}".`);
+    }
+    return resolved;
+}
+//# sourceMappingURL=path-utils.js.map

package/dist/tools/native/path-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.js","sourceRoot":"","sources":["../../../src/tools/native/path-utils.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,UAAkB;IACrE,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,4BAA4B;IAC5B,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,8BAA8B;IAC9B,IAAI,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;IAE1D,oBAAoB;IACpB,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,6BAA6B,UAAU,0CAA0C,WAAW,IAAI,CACjG,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/tools/native/process-tools.d.ts

@@ -0,0 +1,10 @@
+import { type ToolRegistration } from "../tool-registry.js";
+import { LocalExecutor } from "../../execution/local-executor.js";
+export interface ProcessToolsOptions {
+    projectRoot?: string;
+    defaultTimeoutMs?: number;
+    maxOutputBytes?: number;
+    executor?: LocalExecutor;
+}
+export declare function createProcessTools(options?: ProcessToolsOptions): ToolRegistration[];
+//# sourceMappingURL=process-tools.d.ts.map

package/dist/tools/native/process-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/native/process-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,gBAAgB,EAAE,CA8CxF"}