@inhuman.tools/harness 0.0.0-stage → 0.2.0

package/dist/builtin-tools/shell/shell-tool.js

@@ -0,0 +1,200 @@
+/**
+ * Host-registered `shell` tool. Same catalog path as the FS tools; catalog
+ * class is `effect`. Permission is name-keyed — not workspace auto-classes.
+ *
+ * Runs `/bin/sh -c`. Spill the pipes to a temp file; keep a last-N tail
+ * for the model and the live peek. Do not keep a 256 KiB head.
+ */
+import { spawn } from "node:child_process";
+import { createWriteStream, mkdirSync } from "node:fs";
+import { stat } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { cancelOutcomeText, DEFAULT_SHELL_TAIL_BYTES, isTimeoutAbortReason, parseShellTailBytes, } from "@inhuman.tools/harness-model";
+import { optionalDescription } from "@inhuman.tools/harness-model/schemas";
+import { InhumanTool } from "@inhuman.tools/plugin-sdk";
+import { z } from "zod";
+import { toolResultSchema } from "../schemas/tool-result.js";
+import { resolveInRoot, ToolError } from "../toolkit/dist-tools.js";
+/** Wire name. Catalog class is `effect`. */
+const SHELL_TOOL_NAME = "shell";
+const DEFAULT_TIMEOUT_MS = 30_000;
+const MAX_TIMEOUT_MS = 600_000;
+function requireRoot(ctx) {
+    const root = ctx.root;
+    if (root == null || root === "")
+        throw new TypeError("ctx.root string required");
+    return root;
+}
+class TailBuffer {
+    max;
+    #chunks = [];
+    #size = 0;
+    total = 0;
+    constructor(max) {
+        this.max = max;
+    }
+    push(chunk) {
+        this.total += chunk.length;
+        if (this.max <= 0 || chunk.length === 0)
+            return;
+        this.#chunks.push(chunk);
+        this.#size += chunk.length;
+        while (this.#chunks.length > 1 && this.#size - (this.#chunks[0]?.length ?? 0) >= this.max) {
+            const dropped = this.#chunks.shift();
+            if (dropped !== undefined)
+                this.#size -= dropped.length;
+        }
+    }
+    text() {
+        if (this.max <= 0 || this.#size === 0)
+            return "";
+        const combined = Buffer.concat(this.#chunks);
+        const slice = combined.length <= this.max ? combined : combined.subarray(combined.length - this.max);
+        return slice.toString("utf8");
+    }
+}
+function tailComment(kept, total, extra) {
+    if (total <= kept && extra === undefined)
+        return undefined;
+    const cutoff = total > kept
+        ? `tailed last ${kept} of ${total} bytes; earlier output not in context`
+        : extra === undefined
+            ? undefined
+            : `${total} bytes`;
+    const bits = [extra, cutoff].filter((part) => part !== undefined && part !== "");
+    if (bits.length === 0)
+        return undefined;
+    return `…[${bits.join("; ")}]`;
+}
+function spillStream(sessionId, toolCallId) {
+    const session = sessionId !== undefined && sessionId !== "" ? sessionId : "anon";
+    const id = toolCallId !== undefined && toolCallId !== "" ? toolCallId : `${process.pid}-${Date.now()}`;
+    const file = path.join(tmpdir(), "harness-shell", session, `${id}.log`);
+    try {
+        mkdirSync(path.dirname(file), { recursive: true });
+        return createWriteStream(file, { flags: "a" });
+    }
+    catch {
+        return undefined;
+    }
+}
+function shellAbortText(reason, timeoutMs) {
+    const text = cancelOutcomeText(reason);
+    if (text === "cancelled")
+        return "cancelled";
+    if (isTimeoutAbortReason(reason) && (text === "timed out" || /TimeoutError/i.test(text))) {
+        return `timed out after ${timeoutMs}ms`;
+    }
+    return text;
+}
+async function runShell(input, ctx) {
+    const cwd = input.cwd === undefined ? ctx.root : await resolveInRoot(ctx.root, input.cwd);
+    const st = await stat(cwd).catch((error) => {
+        ToolError.invariant(error.code !== "ENOENT", `shell cwd does not exist: ${input.cwd ?? "."} — drop cwd or pass a directory that exists`);
+        throw error;
+    });
+    ToolError.invariant(st.isDirectory(), `shell cwd is not a directory: ${input.cwd ?? "."} — pass a directory, or drop cwd`);
+    const timeoutMs = Math.min(input.timeoutMs ?? DEFAULT_TIMEOUT_MS, MAX_TIMEOUT_MS);
+    const timeout = AbortSignal.timeout(timeoutMs);
+    const signal = ctx.signal === undefined ? timeout : AbortSignal.any([ctx.signal, timeout]);
+    const tailBytes = parseShellTailBytes(ctx.tailBytes ?? DEFAULT_SHELL_TAIL_BYTES);
+    const tail = new TailBuffer(tailBytes);
+    const spill = spillStream(ctx.sessionId, ctx.toolCallId);
+    const publish = () => {
+        ctx.onTail?.({ text: tail.text(), totalBytes: tail.total });
+    };
+    return await new Promise((resolve, reject) => {
+        const child = spawn("/bin/sh", ["-c", input.command], {
+            cwd,
+            stdio: ["ignore", "pipe", "pipe"],
+            signal,
+        });
+        let settled = false;
+        const finish = (exitCode) => {
+            if (settled)
+                return;
+            settled = true;
+            spill?.end();
+            publish();
+            const extra = signal.aborted ? shellAbortText(signal.reason, timeoutMs) : undefined;
+            const cancelled = extra === "cancelled";
+            const timedOut = extra !== undefined && extra !== "cancelled";
+            const text = tail.text();
+            const kept = Buffer.byteLength(text, "utf8");
+            const comment = tailComment(kept, tail.total, extra);
+            resolve({
+                ok: !signal.aborted && exitCode === 0,
+                ...(cancelled || timedOut ? { text: extra } : {}),
+                value: {
+                    exitCode: signal.aborted ? null : exitCode,
+                    stdout: comment === undefined ? text : text === "" ? comment : `${text}\n${comment}`,
+                    stderr: "",
+                    truncated: tail.total > kept,
+                    totalBytes: tail.total,
+                    ...(ctx.toolCallId !== undefined && ctx.toolCallId !== "" ? { job_id: ctx.toolCallId } : {}),
+                },
+            });
+        };
+        const ingest = (chunk) => {
+            tail.push(chunk);
+            spill?.write(chunk);
+            publish();
+        };
+        child.stdout?.on("data", ingest);
+        child.stderr?.on("data", ingest);
+        child.on("error", (error) => {
+            if (signal.aborted) {
+                child.kill("SIGKILL");
+                finish(null);
+                return;
+            }
+            reject(error);
+        });
+        child.on("close", (exitCode) => finish(exitCode));
+        signal.addEventListener("abort", () => {
+            child.kill("SIGKILL");
+        }, { once: true });
+    }).catch((error) => {
+        spill?.end();
+        const extra = signal.aborted ? shellAbortText(signal.reason, timeoutMs) : "";
+        ToolError.invariant(!signal.aborted, extra === "cancelled" ? "shell call cancelled" : `shell ${extra}`);
+        throw error;
+    });
+}
+function toolCallIdOf(ctx) {
+    const invocation = ctx.invocation;
+    if (invocation === null || typeof invocation !== "object")
+        return undefined;
+    const id = invocation.toolCallId;
+    return typeof id === "string" && id !== "" ? id : undefined;
+}
+export const shellTool = new InhumanTool({
+    name: SHELL_TOOL_NAME,
+    description: "Run a command through /bin/sh. Each call is a fresh shell — cwd and env do not persist. Prefer cwd over `cd dest && cmd`. Independent work: parallel shell calls. Sequential fail-fast: one call with &&. Requires confirmation, separately from file writes.",
+    class: "effect",
+    representation: "both",
+    input: z.object({
+        command: z.string().min(1).describe("The shell command to run."),
+        cwd: z
+            .preprocess((value) => (value === "" || value === null ? undefined : value), z.string().optional())
+            .describe("Working directory for this call. Relative to the project root (`./scripts`, `../bin`) or absolute (`/etc`). Prefer this over `cd dest &&`. Omitted or `.` is the project root."),
+        timeoutMs: z
+            .number()
+            .int()
+            .min(1)
+            .optional()
+            .describe("Optional per-call timeout in milliseconds. Defaults to 30000; capped at 600000."),
+        description: optionalDescription("command"),
+    }),
+    output: toolResultSchema,
+    run: (input, ctx) => runShell(input, {
+        root: requireRoot(ctx),
+        signal: ctx.signal,
+        sessionId: typeof ctx.sessionId === "string" ? ctx.sessionId : undefined,
+        toolCallId: toolCallIdOf(ctx),
+        tailBytes: typeof ctx.shellTailBytes === "number" ? ctx.shellTailBytes : undefined,
+        onTail: typeof ctx.onTail === "function" ? ctx.onTail : undefined,
+    }),
+});
+//# sourceMappingURL=shell-tool.js.map

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

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

package/dist/builtin-tools/toolkit/bounds.d.ts

@@ -0,0 +1,4 @@
+/** File I/O budgets in bytes. Observation squeeze is paint-time, not settlement. */
+export declare const MAX_FILE_READ_BYTES: number;
+export declare const MAX_FILE_WRITE_BYTES: number;
+//# sourceMappingURL=bounds.d.ts.map

package/dist/builtin-tools/toolkit/bounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.d.ts","sourceRoot":"","sources":["../../../src/builtin-tools/toolkit/bounds.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,eAAO,MAAM,mBAAmB,QAAkB,CAAC;AACnD,eAAO,MAAM,oBAAoB,QAAc,CAAC"}

package/dist/builtin-tools/toolkit/bounds.js

@@ -0,0 +1,4 @@
+/** File I/O budgets in bytes. Observation squeeze is paint-time, not settlement. */
+export const MAX_FILE_READ_BYTES = 4 * 1024 * 1024;
+export const MAX_FILE_WRITE_BYTES = 1024 * 1024;
+//# sourceMappingURL=bounds.js.map

package/dist/builtin-tools/toolkit/bounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.js","sourceRoot":"","sources":["../../../src/builtin-tools/toolkit/bounds.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AACnD,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAAC"}

package/dist/builtin-tools/toolkit/dist-tools.d.ts

@@ -0,0 +1,104 @@
+import { InhumanTool } from "@inhuman.tools/plugin-sdk";
+export { ToolError } from "@inhuman.tools/turn/tool-runtime";
+export interface ToolResult {
+    readonly ok: boolean;
+    /** Door / dist string payload. Structured results use `value`; paint is squeeze. */
+    readonly text?: string;
+    readonly value?: unknown;
+    /** Listing/search hit more results than it returned. Markers stay out of `value`. */
+    readonly truncated?: boolean;
+}
+export declare function asToolResult(out: unknown): ToolResult;
+/** Lexical `..` collapse + realpath re-check (symlink escape). Extra-root only when licensed. */
+export declare function resolveInRoot(root: string, candidate: string): Promise<string>;
+/**
+ * Write path resolve: climb to deepest existing ancestor, realpath that, re-join
+ * remainder (leaf may not exist yet — resolveInRoot ENOENT lexical path is unsafe for writes).
+ */
+export declare function resolveWriteTarget(root: string, candidate: string): Promise<{
+    target: string;
+    parent: string;
+}>;
+/** fff grep query. Directory prefixes get a trailing slash; file paths do not. */
+export declare function constrainQuery(pattern: string, pathRel: string | undefined, glob: string | undefined, directory?: boolean): string;
+export declare const readFile: InhumanTool<{
+    path: string;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}, ToolResult>;
+export declare const listDir: InhumanTool<{
+    path: string;
+    depth?: number | undefined;
+}, ToolResult>;
+export declare const grep: InhumanTool<{
+    pattern: string;
+    path?: string | undefined;
+    glob?: string | undefined;
+    mode?: string | undefined;
+    limit?: number | undefined;
+    before?: number | undefined;
+    after?: number | undefined;
+}, ToolResult>;
+export declare const glob: InhumanTool<{
+    pattern: string;
+    cwd?: string | undefined;
+    path?: string | undefined;
+    limit?: number | undefined;
+}, ToolResult>;
+export declare const fffSearch: InhumanTool<{
+    query: string;
+    cwd?: string | undefined;
+    path?: string | undefined;
+    limit?: number | undefined;
+}, ToolResult>;
+export declare const writeFile: InhumanTool<{
+    path: string;
+    content: string;
+    overwriteExisting?: boolean | undefined;
+    description?: string | undefined;
+}, ToolResult>;
+export declare const editFile: InhumanTool<{
+    path: string;
+    old_string: string;
+    new_string: string;
+    replace_all?: boolean | undefined;
+    description?: string | undefined;
+}, ToolResult>;
+export declare const DIST_TOOLS: readonly [InhumanTool<{
+    path: string;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}, ToolResult>, InhumanTool<{
+    path: string;
+    depth?: number | undefined;
+}, ToolResult>, InhumanTool<{
+    pattern: string;
+    path?: string | undefined;
+    glob?: string | undefined;
+    mode?: string | undefined;
+    limit?: number | undefined;
+    before?: number | undefined;
+    after?: number | undefined;
+}, ToolResult>, InhumanTool<{
+    pattern: string;
+    cwd?: string | undefined;
+    path?: string | undefined;
+    limit?: number | undefined;
+}, ToolResult>, InhumanTool<{
+    query: string;
+    cwd?: string | undefined;
+    path?: string | undefined;
+    limit?: number | undefined;
+}, ToolResult>, InhumanTool<{
+    path: string;
+    content: string;
+    overwriteExisting?: boolean | undefined;
+    description?: string | undefined;
+}, ToolResult>, InhumanTool<{
+    path: string;
+    old_string: string;
+    new_string: string;
+    replace_all?: boolean | undefined;
+    description?: string | undefined;
+}, ToolResult>];
+//# sourceMappingURL=dist-tools.d.ts.map

package/dist/builtin-tools/toolkit/dist-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dist-tools.d.ts","sourceRoot":"","sources":["../../../src/builtin-tools/toolkit/dist-tools.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAYxD,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAS7D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,oFAAoF;IACpF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,qFAAqF;IACrF,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CASrD;AA+GD,iGAAiG;AACjG,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBpF;AAYD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAyBrH;AAyHD,kFAAkF;AAClF,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,SAAS,UAAO,GACf,MAAM,CAQR;AAySD,eAAO,MAAM,QAAQ;;;;cAQnB,CAAC;AAEH,eAAO,MAAM,OAAO;;;cAQlB,CAAC;AAEH,eAAO,MAAM,IAAI;;;;;;;;cASf,CAAC;AAEH,eAAO,MAAM,IAAI;;;;;cASf,CAAC;AAEH,eAAO,MAAM,SAAS;;;;;cASpB,CAAC;AAOH,eAAO,MAAM,SAAS;;;;;cAcpB,CAAC;AAEH,eAAO,MAAM,QAAQ;;;;;;cAcnB,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAA2E,CAAC"}