@pythonluvr/openwar 0.4.0

package/dist/tools/native/list_dir.js

@@ -0,0 +1,175 @@
+// list_dir native tool. Default-allowed (filesystem_read).
+// Lists entries with optional depth and glob filter. Skips noise dirs.
+import { readdir, stat, readFile } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { resolveAndRealpathInWorkdir, PathEscapeError } from "../../sandbox/workdir.js";
+const DEFAULT_SKIP_DIRS = new Set([
+    ".git",
+    "node_modules",
+    ".next",
+    "dist",
+    ".turbo",
+    ".cache",
+    "build",
+]);
+export const LIST_DIR_DEFINITION = {
+    name: "list_dir",
+    description: "List entries in a directory inside the workdir. Optional depth (default 1) and glob filter. " +
+        "Skips .git, node_modules, dist, and patterns in .openwarignore.",
+    input_schema: {
+        type: "object",
+        properties: {
+            path: { type: "string", description: "Directory path relative to workdir." },
+            depth: { type: "number", description: "Recursion depth. 1 = entries only. Pass a large number for full tree. Default 1." },
+            glob: { type: "string", description: "Optional simple glob (* and ?) applied to entry names." },
+        },
+        required: ["path"],
+    },
+    origin: "native",
+    authorization_categories: ["filesystem_read"],
+};
+function parseArgs(call) {
+    if (typeof call.arguments !== "object" || call.arguments === null) {
+        return { error: "arguments must be an object" };
+    }
+    const a = call.arguments;
+    if (typeof a.path !== "string")
+        return { error: "path must be a string" };
+    if (a.depth !== undefined && (typeof a.depth !== "number" || a.depth < 1)) {
+        return { error: "depth must be a positive number if provided" };
+    }
+    if (a.glob !== undefined && typeof a.glob !== "string") {
+        return { error: "glob must be a string if provided" };
+    }
+    return { path: a.path, depth: a.depth, glob: a.glob };
+}
+// Convert a simple glob (* matches any chars except separator, ? matches one) to RegExp.
+function globToRegExp(glob) {
+    let re = "^";
+    for (const ch of glob) {
+        if (ch === "*")
+            re += "[^/\\\\]*";
+        else if (ch === "?")
+            re += "[^/\\\\]";
+        else if (/[.+^${}()|[\]\\]/.test(ch))
+            re += "\\" + ch;
+        else
+            re += ch;
+    }
+    re += "$";
+    return new RegExp(re);
+}
+async function loadIgnore(workdir) {
+    try {
+        const txt = await readFile(join(workdir, ".openwarignore"), "utf8");
+        return txt
+            .split(/\r?\n/)
+            .map(s => s.trim())
+            .filter(s => s.length > 0 && !s.startsWith("#"));
+    }
+    catch {
+        return [];
+    }
+}
+function shouldSkip(name, ignore) {
+    if (DEFAULT_SKIP_DIRS.has(name))
+        return true;
+    for (const pat of ignore) {
+        if (pat === name)
+            return true;
+        if (pat.includes("*") || pat.includes("?")) {
+            if (globToRegExp(pat).test(name))
+                return true;
+        }
+    }
+    return false;
+}
+async function walk(rootAbs, currentAbs, depth, maxDepth, glob, ignore, out) {
+    let entries;
+    try {
+        entries = await readdir(currentAbs, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const e of entries) {
+        if (shouldSkip(e.name, ignore))
+            continue;
+        const abs = join(currentAbs, e.name);
+        const rel = relative(rootAbs, abs);
+        const displayName = rel === "" ? e.name : rel;
+        if (e.isDirectory()) {
+            if (!glob || glob.test(e.name)) {
+                out.push({ name: displayName, type: "directory" });
+            }
+            if (depth < maxDepth) {
+                await walk(rootAbs, abs, depth + 1, maxDepth, glob, ignore, out);
+            }
+        }
+        else if (e.isFile()) {
+            if (!glob || glob.test(e.name)) {
+                try {
+                    const st = await stat(abs);
+                    out.push({ name: displayName, type: "file", size: st.size });
+                }
+                catch {
+                    out.push({ name: displayName, type: "file" });
+                }
+            }
+        }
+    }
+}
+export const listDirExecutor = async (call, ctx) => {
+    const parsed = parseArgs(call);
+    if ("error" in parsed) {
+        return {
+            call_id: call.id,
+            success: false,
+            content: parsed.error,
+            error: { code: "INVALID_ARGS", message: parsed.error },
+        };
+    }
+    const start = Date.now();
+    try {
+        const resolved = await resolveAndRealpathInWorkdir(ctx.workdir, parsed.path);
+        const st = await stat(resolved);
+        if (!st.isDirectory()) {
+            return {
+                call_id: call.id,
+                success: false,
+                content: `${parsed.path} is not a directory`,
+                error: { code: "ENOTDIR", message: "path is not a directory" },
+            };
+        }
+        const maxDepth = parsed.depth ?? 1;
+        const glob = parsed.glob ? globToRegExp(parsed.glob) : null;
+        const ignore = await loadIgnore(ctx.workdir);
+        const out = [];
+        await walk(resolved, resolved, 1, maxDepth, glob, ignore, out);
+        return {
+            call_id: call.id,
+            success: true,
+            content: JSON.stringify(out, null, 2),
+            meta: { duration_ms: Date.now() - start, bytes: out.length },
+        };
+    }
+    catch (err) {
+        if (err instanceof PathEscapeError) {
+            return {
+                call_id: call.id,
+                success: false,
+                content: err.message,
+                error: { code: err.code, message: err.message },
+            };
+        }
+        const code = err.code ?? "UNKNOWN";
+        const message = err.message;
+        return {
+            call_id: call.id,
+            success: false,
+            content: `Failed to list ${parsed.path}: ${message}`,
+            error: { code, message },
+        };
+    }
+};
+//# sourceMappingURL=list_dir.js.map

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

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

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

@@ -0,0 +1,4 @@
+import type { ToolDefinition, ToolExecutor } from "../types.js";
+export declare const READ_FILE_DEFINITION: ToolDefinition;
+export declare const readFileExecutor: ToolExecutor;
+//# sourceMappingURL=read_file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read_file.d.ts","sourceRoot":"","sources":["../../../src/tools/native/read_file.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAA8C,YAAY,EAAE,MAAM,aAAa,CAAC;AAK5G,eAAO,MAAM,oBAAoB,EAAE,cAqBlC,CAAC;AAmBF,eAAO,MAAM,gBAAgB,EAAE,YAqD9B,CAAC"}

package/dist/tools/native/read_file.js

@@ -0,0 +1,91 @@
+// read_file native tool. Default-allowed (filesystem_read is in DEFAULT_ALLOWED).
+// Reads UTF-8 text inside the session workdir, capped at max_bytes.
+import { readFile, stat } from "node:fs/promises";
+import { resolveAndRealpathInWorkdir, PathEscapeError } from "../../sandbox/workdir.js";
+const DEFAULT_MAX_BYTES = 1_000_000;
+export const READ_FILE_DEFINITION = {
+    name: "read_file",
+    description: "Read a UTF-8 text file. Path is relative to the session workdir (or absolute inside it). " +
+        "Returns the file contents and a truncated flag when the file exceeded max_bytes.",
+    input_schema: {
+        type: "object",
+        properties: {
+            path: {
+                type: "string",
+                description: "File path relative to workdir, or absolute inside workdir.",
+            },
+            max_bytes: {
+                type: "number",
+                description: "Maximum bytes to read. Defaults to 1000000 (1 MB).",
+            },
+        },
+        required: ["path"],
+    },
+    origin: "native",
+    authorization_categories: ["filesystem_read"],
+};
+function parseArgs(call) {
+    if (typeof call.arguments !== "object" || call.arguments === null) {
+        return { error: "arguments must be an object" };
+    }
+    const a = call.arguments;
+    if (typeof a.path !== "string")
+        return { error: "path must be a string" };
+    if (a.max_bytes !== undefined && (typeof a.max_bytes !== "number" || a.max_bytes < 0)) {
+        return { error: "max_bytes must be a non-negative number" };
+    }
+    return { path: a.path, max_bytes: a.max_bytes };
+}
+export const readFileExecutor = async (call, ctx) => {
+    const parsed = parseArgs(call);
+    if ("error" in parsed) {
+        return {
+            call_id: call.id,
+            success: false,
+            content: parsed.error,
+            error: { code: "INVALID_ARGS", message: parsed.error },
+        };
+    }
+    const maxBytes = parsed.max_bytes ?? DEFAULT_MAX_BYTES;
+    const start = Date.now();
+    try {
+        const resolved = await resolveAndRealpathInWorkdir(ctx.workdir, parsed.path);
+        const st = await stat(resolved);
+        if (st.isDirectory()) {
+            return {
+                call_id: call.id,
+                success: false,
+                content: `${parsed.path} is a directory; use list_dir.`,
+                error: { code: "EISDIR", message: "path is a directory" },
+            };
+        }
+        const buf = await readFile(resolved);
+        const truncated = buf.length > maxBytes;
+        const content = truncated ? buf.subarray(0, maxBytes).toString("utf8") : buf.toString("utf8");
+        return {
+            call_id: call.id,
+            success: true,
+            content,
+            meta: { duration_ms: Date.now() - start, bytes: content.length, truncated },
+        };
+    }
+    catch (err) {
+        if (err instanceof PathEscapeError) {
+            return {
+                call_id: call.id,
+                success: false,
+                content: err.message,
+                error: { code: err.code, message: err.message },
+            };
+        }
+        const code = err.code ?? "UNKNOWN";
+        const message = err.message;
+        return {
+            call_id: call.id,
+            success: false,
+            content: `Failed to read ${parsed.path}: ${message}`,
+            error: { code, message },
+        };
+    }
+};
+//# sourceMappingURL=read_file.js.map

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

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

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

@@ -0,0 +1,4 @@
+import type { ToolDefinition, ToolExecutor } from "../types.js";
+export declare const SHELL_EXEC_DEFINITION: ToolDefinition;
+export declare const shellExecExecutor: ToolExecutor;
+//# sourceMappingURL=shell_exec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shell_exec.d.ts","sourceRoot":"","sources":["../../../src/tools/native/shell_exec.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAA8C,YAAY,EAAE,MAAM,aAAa,CAAC;AAQ5G,eAAO,MAAM,qBAAqB,EAAE,cAiBnC,CAAC;AAqDF,eAAO,MAAM,iBAAiB,EAAE,YAiH/B,CAAC"}

package/dist/tools/native/shell_exec.js

@@ -0,0 +1,180 @@
+// shell_exec native tool. Requires shell_exec category.
+// SIGTERM on timeout, SIGKILL after 2s if still alive. stdout/stderr capped.
+import { spawn } from "node:child_process";
+import { platform } from "node:os";
+import { resolvePathInWorkdir, PathEscapeError } from "../../sandbox/workdir.js";
+import { capStream } from "../../sandbox/output-cap.js";
+const DEFAULT_TIMEOUT_MS = 30_000;
+const MAX_TIMEOUT_MS = 300_000;
+const KILL_GRACE_MS = 2000;
+export const SHELL_EXEC_DEFINITION = {
+    name: "shell_exec",
+    description: "Execute a shell command in the workdir. Captures stdout, stderr, exit code. Killed on timeout via SIGTERM, then SIGKILL. " +
+        "Default timeout 30s, hard cap 300s. stdout and stderr capped at the session's output limit; truncated flag set when hit.",
+    input_schema: {
+        type: "object",
+        properties: {
+            cmd: { type: "string", description: "Command to run. Passed to the configured shell." },
+            cwd: { type: "string", description: "Working directory relative to workdir. Default: workdir root." },
+            timeout_ms: { type: "number", description: "Override timeout. Default 30000, max 300000." },
+            shell: { type: "string", description: "Override shell binary. Default: bash on unix, cmd.exe on Windows." },
+        },
+        required: ["cmd"],
+    },
+    origin: "native",
+    authorization_categories: ["shell_exec"],
+};
+function parseArgs(call) {
+    if (typeof call.arguments !== "object" || call.arguments === null) {
+        return { error: "arguments must be an object" };
+    }
+    const a = call.arguments;
+    if (typeof a.cmd !== "string" || a.cmd.length === 0)
+        return { error: "cmd must be a non-empty string" };
+    if (a.cwd !== undefined && typeof a.cwd !== "string")
+        return { error: "cwd must be a string if provided" };
+    if (a.timeout_ms !== undefined && (typeof a.timeout_ms !== "number" || a.timeout_ms <= 0)) {
+        return { error: "timeout_ms must be a positive number if provided" };
+    }
+    if (a.shell !== undefined && typeof a.shell !== "string")
+        return { error: "shell must be a string if provided" };
+    return {
+        cmd: a.cmd,
+        cwd: a.cwd,
+        timeout_ms: a.timeout_ms,
+        shell: a.shell,
+    };
+}
+function defaultShell() {
+    return platform() === "win32" ? "cmd.exe" : "bash";
+}
+function shellArgs(shell, cmd) {
+    // Windows cmd uses /c; bash/sh use -c.
+    if (shell.endsWith("cmd.exe") || shell === "cmd")
+        return ["/c", cmd];
+    return ["-c", cmd];
+}
+// Cross-platform kill. On Windows, child.kill targets only the shell process,
+// not grandchildren. Use taskkill /T /F to terminate the whole tree.
+function killChild(child, severity) {
+    if (platform() === "win32" && child.pid !== undefined) {
+        try {
+            const args = severity === "hard" ? ["/T", "/F", "/PID", String(child.pid)] : ["/T", "/PID", String(child.pid)];
+            spawn("taskkill", args, { stdio: "ignore" }).on("error", () => { });
+            return;
+        }
+        catch { /* fall through */ }
+    }
+    try {
+        child.kill(severity === "hard" ? "SIGKILL" : "SIGTERM");
+    }
+    catch { /* swallow */ }
+}
+export const shellExecExecutor = async (call, ctx) => {
+    if (!ctx.shellEnabled) {
+        return {
+            call_id: call.id,
+            success: false,
+            content: "Shell execution is disabled for this session (--no-shell).",
+            error: { code: "SHELL_DISABLED", message: "shell disabled" },
+        };
+    }
+    const parsed = parseArgs(call);
+    if ("error" in parsed) {
+        return {
+            call_id: call.id,
+            success: false,
+            content: parsed.error,
+            error: { code: "INVALID_ARGS", message: parsed.error },
+        };
+    }
+    const start = Date.now();
+    const timeoutMs = Math.min(parsed.timeout_ms ?? DEFAULT_TIMEOUT_MS, MAX_TIMEOUT_MS);
+    let cwd;
+    try {
+        cwd = parsed.cwd ? resolvePathInWorkdir(ctx.workdir, parsed.cwd) : ctx.workdir;
+    }
+    catch (err) {
+        if (err instanceof PathEscapeError) {
+            return {
+                call_id: call.id,
+                success: false,
+                content: err.message,
+                error: { code: err.code, message: err.message },
+            };
+        }
+        throw err;
+    }
+    const shell = parsed.shell ?? defaultShell();
+    const args = shellArgs(shell, parsed.cmd);
+    const maxOut = ctx.defaultMaxOutputBytes;
+    return new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn(shell, args, { cwd, stdio: ["ignore", "pipe", "pipe"] });
+        }
+        catch (err) {
+            resolve({
+                call_id: call.id,
+                success: false,
+                content: `Failed to spawn shell: ${err.message}`,
+                error: { code: "SPAWN_FAILED", message: err.message },
+            });
+            return;
+        }
+        let killed = false;
+        let killSignal;
+        const sigtermTimer = setTimeout(() => {
+            killed = true;
+            killSignal = "SIGTERM";
+            killChild(child, "soft");
+            setTimeout(() => {
+                if (child.exitCode === null && child.signalCode === null) {
+                    killSignal = "SIGKILL";
+                    killChild(child, "hard");
+                }
+            }, KILL_GRACE_MS);
+        }, timeoutMs);
+        const stdoutPromise = capStream(child.stdout, maxOut);
+        const stderrPromise = capStream(child.stderr, maxOut);
+        child.on("close", async (code, signal) => {
+            clearTimeout(sigtermTimer);
+            const [outRes, errRes] = await Promise.all([stdoutPromise, stderrPromise]);
+            const truncated = outRes.truncated || errRes.truncated;
+            const exitCode = code ?? -1;
+            const result = {
+                stdout: outRes.content.toString("utf8"),
+                stderr: errRes.content.toString("utf8"),
+                exit_code: exitCode,
+                signal: signal ?? killSignal,
+                truncated,
+            };
+            const summary = killed
+                ? `Killed after ${timeoutMs}ms timeout (${killSignal ?? "SIGTERM"}).`
+                : `Exited with code ${exitCode}${truncated ? " (output truncated)" : ""}.`;
+            resolve({
+                call_id: call.id,
+                success: !killed && exitCode === 0,
+                content: `${summary}\n\nstdout:\n${result.stdout}\n\nstderr:\n${result.stderr}`,
+                meta: {
+                    duration_ms: Date.now() - start,
+                    exit_code: result.exit_code,
+                    signal: result.signal ?? undefined,
+                    truncated,
+                    bytes: result.stdout.length + result.stderr.length,
+                },
+                ...(killed && { error: { code: "TIMEOUT", message: summary } }),
+            });
+        });
+        child.on("error", (err) => {
+            clearTimeout(sigtermTimer);
+            resolve({
+                call_id: call.id,
+                success: false,
+                content: `Shell error: ${err.message}`,
+                error: { code: "SHELL_ERROR", message: err.message },
+            });
+        });
+    });
+};
+//# sourceMappingURL=shell_exec.js.map

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

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

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

@@ -0,0 +1,4 @@
+import type { ToolDefinition, ToolExecutor } from "../types.js";
+export declare const WRITE_FILE_DEFINITION: ToolDefinition;
+export declare const writeFileExecutor: ToolExecutor;
+//# sourceMappingURL=write_file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write_file.d.ts","sourceRoot":"","sources":["../../../src/tools/native/write_file.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAA8C,YAAY,EAAE,MAAM,aAAa,CAAC;AAG5G,eAAO,MAAM,qBAAqB,EAAE,cAgBnC,CAAC;AAsCF,eAAO,MAAM,iBAAiB,EAAE,YA+C/B,CAAC"}

package/dist/tools/native/write_file.js

@@ -0,0 +1,101 @@
+// write_file native tool. Requires filesystem_write.
+// Atomic via tmp + rename for overwrite; append uses appendFile.
+// Creates parent directories if missing.
+import { writeFile, appendFile, rename, mkdir, stat } from "node:fs/promises";
+import { dirname, basename } from "node:path";
+import { randomBytes } from "node:crypto";
+import { resolvePathInWorkdir, PathEscapeError } from "../../sandbox/workdir.js";
+export const WRITE_FILE_DEFINITION = {
+    name: "write_file",
+    description: "Write UTF-8 content to a file inside the workdir. Overwrites by default; pass append=true to append. " +
+        "Atomic via tmp+rename for overwrite. Creates parent directories if missing.",
+    input_schema: {
+        type: "object",
+        properties: {
+            path: { type: "string", description: "File path relative to workdir." },
+            content: { type: "string", description: "UTF-8 content to write." },
+            append: { type: "boolean", description: "Append instead of overwrite. Default false." },
+        },
+        required: ["path", "content"],
+    },
+    origin: "native",
+    authorization_categories: ["filesystem_write"],
+};
+function parseArgs(call) {
+    if (typeof call.arguments !== "object" || call.arguments === null) {
+        return { error: "arguments must be an object" };
+    }
+    const a = call.arguments;
+    if (typeof a.path !== "string")
+        return { error: "path must be a string" };
+    if (typeof a.content !== "string")
+        return { error: "content must be a string" };
+    if (a.append !== undefined && typeof a.append !== "boolean") {
+        return { error: "append must be a boolean if provided" };
+    }
+    return { path: a.path, content: a.content, append: a.append };
+}
+async function ensureParents(path) {
+    const parent = dirname(path);
+    try {
+        await stat(parent);
+        return false; // already exists
+    }
+    catch {
+        await mkdir(parent, { recursive: true });
+        return true;
+    }
+}
+async function atomicWrite(path, content) {
+    const tmp = `${path}.openwar-tmp-${randomBytes(6).toString("hex")}`;
+    await writeFile(tmp, content, "utf8");
+    await rename(tmp, path);
+}
+export const writeFileExecutor = async (call, ctx) => {
+    const parsed = parseArgs(call);
+    if ("error" in parsed) {
+        return {
+            call_id: call.id,
+            success: false,
+            content: parsed.error,
+            error: { code: "INVALID_ARGS", message: parsed.error },
+        };
+    }
+    const start = Date.now();
+    try {
+        const resolved = resolvePathInWorkdir(ctx.workdir, parsed.path);
+        const createdParents = await ensureParents(resolved);
+        if (parsed.append) {
+            await appendFile(resolved, parsed.content, "utf8");
+        }
+        else {
+            await atomicWrite(resolved, parsed.content);
+        }
+        const bytes = Buffer.byteLength(parsed.content, "utf8");
+        return {
+            call_id: call.id,
+            success: true,
+            content: `Wrote ${bytes} bytes to ${basename(resolved)}${createdParents ? " (created parent dirs)" : ""}.`,
+            meta: { duration_ms: Date.now() - start, bytes },
+        };
+    }
+    catch (err) {
+        if (err instanceof PathEscapeError) {
+            return {
+                call_id: call.id,
+                success: false,
+                content: err.message,
+                error: { code: err.code, message: err.message },
+            };
+        }
+        const code = err.code ?? "UNKNOWN";
+        const message = err.message;
+        return {
+            call_id: call.id,
+            success: false,
+            content: `Failed to write ${parsed.path}: ${message}`,
+            error: { code, message },
+        };
+    }
+};
+//# sourceMappingURL=write_file.js.map

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

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