laohuang 0.3.2 → 0.4.0

package/dist/tools.js

@@ -0,0 +1,444 @@
+/** Tool definitions and execution for the coding agent. */
+import { promises as fs } from "node:fs";
+import { realpathSync } from "node:fs";
+import path from "node:path";
+import { runBash as runBashCommand } from "./bash-runner.js";
+/** The fixed tool set, in the canonical prompt/schema order. */
+export const TOOL_SPECS = [
+    {
+        name: "read",
+        description: "Read a UTF-8 text file inside the project root.",
+        parameters: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "File path." },
+                offset: {
+                    type: "integer",
+                    description: "1-based line number to start reading from.",
+                    minimum: 1,
+                },
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of lines to return.",
+                    minimum: 1,
+                },
+            },
+            required: ["path"],
+            additionalProperties: false,
+        },
+        promptGuidelines: [
+            "Use read for ordinary file inspection rather than cat/sed.",
+            "Use offset/limit to page through large files.",
+            "Inspect an existing file before changing it.",
+        ],
+    },
+    {
+        name: "write",
+        description: "Create or fully overwrite a UTF-8 text file.",
+        parameters: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "File path." },
+                content: { type: "string", description: "Full file content." },
+            },
+            required: ["path", "content"],
+            additionalProperties: false,
+        },
+        promptGuidelines: [
+            "Use write only to create a file or replace all of one; use edit for local changes.",
+            "Confirm the path and the complete content before writing.",
+        ],
+    },
+    {
+        name: "edit",
+        description: "Apply a batch of exact, unique text replacements to a file atomically.",
+        parameters: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "File path." },
+                edits: {
+                    type: "array",
+                    description: "Non-empty list of exact replacements, matched against the original file content.",
+                    minItems: 1,
+                    items: {
+                        type: "object",
+                        properties: {
+                            old_text: {
+                                type: "string",
+                                description: "Exact text to replace; must appear exactly once in the original content.",
+                            },
+                            new_text: { type: "string", description: "Replacement text." },
+                        },
+                        required: ["old_text", "new_text"],
+                        additionalProperties: false,
+                    },
+                },
+            },
+            required: ["path", "edits"],
+            additionalProperties: false,
+        },
+        promptGuidelines: [
+            "Use edit for local changes; targets must exactly and uniquely match the original file.",
+            "Edits in one batch are matched against the original content and must not overlap.",
+            "Inspect the file first and verify the change when practical.",
+        ],
+    },
+    {
+        name: "bash",
+        description: "Run a Bash command inside the project root.",
+        parameters: {
+            type: "object",
+            properties: {
+                command: { type: "string", description: "Bash command." },
+                description: {
+                    type: "string",
+                    description: "Concise purpose of the command.",
+                },
+                workdir: {
+                    type: "string",
+                    description: "Working directory for the command; must resolve inside the project root. Defaults to the project root.",
+                },
+                timeoutMs: {
+                    type: "integer",
+                    description: "Timeout in milliseconds.",
+                    minimum: 1,
+                },
+            },
+            required: ["command", "description"],
+            additionalProperties: false,
+        },
+        promptGuidelines: [
+            "Supply a concise description of what the command does.",
+            "Use workdir instead of cd.",
+            "Each call runs in an independent shell; state does not persist between calls.",
+            "On a non-zero exit, inspect the output before retrying.",
+        ],
+    },
+];
+/**
+ * Internal side channel: the resolved absolute path touched by a successful
+ * first-party file tool (read/write/edit), attached non-enumerably so it
+ * never serializes into model-visible history. Consumed only by the agent
+ * layer for project-instruction discovery.
+ */
+export const TOUCHED_PATH = Symbol("laohuang.touchedPath");
+/** The resolved path a successful file tool touched, if recorded. */
+export function touchedPathOf(result) {
+    return result[TOUCHED_PATH];
+}
+/** Attach the touched path invisibly: JSON.stringify, spreads, and
+ * Object.entries all skip non-enumerable symbol properties. */
+function withTouchedPath(result, target) {
+    Object.defineProperty(result, TOUCHED_PATH, {
+        value: target,
+        enumerable: false,
+        configurable: true,
+    });
+    return result;
+}
+const DEFAULT_IO = {
+    readFile: (target) => fs.readFile(target, "utf8"),
+    writeFile: (target, content) => fs.writeFile(target, content, "utf8"),
+};
+const NOOP_CONTEXT = {
+    isCancelled: () => false,
+    cancellationReason: "cancelled",
+    publish: () => { },
+};
+async function defaultRunBash(command, options) {
+    // Only a context carrying the full publish() surface is safe to hand to
+    // bash-runner; anything else (e.g. a bare test stub) is replaced so the
+    // runner can fall back to its own default context.
+    const context = typeof options.context.publish === "function" ? options.context : null;
+    const result = await runBashCommand(command, {
+        cwd: options.cwd,
+        timeout: options.timeoutSeconds,
+        maxOutputChars: options.maxOutputChars,
+        context: context,
+        env: options.env,
+    });
+    return result.asDict();
+}
+// Serializes write/edit critical sections per resolved file path, mirroring
+// the Python module-level _MUTATION_LOCKS keyed by Path.
+const mutationLocks = new Map();
+async function withFileMutationLock(key, fn) {
+    const previous = mutationLocks.get(key) ?? Promise.resolve();
+    let release;
+    const current = new Promise((resolve) => {
+        release = resolve;
+    });
+    const tail = previous.then(() => current);
+    mutationLocks.set(key, tail);
+    await previous;
+    try {
+        return await fn();
+    }
+    finally {
+        release();
+        if (mutationLocks.get(key) === tail) {
+            mutationLocks.delete(key);
+        }
+    }
+}
+/** Non-strict realpath: resolves symlinks for the deepest existing ancestor
+ * and appends the not-yet-created remainder (Python Path.resolve semantics). */
+async function resolveNonStrict(pathname) {
+    const missing = [];
+    let current = pathname;
+    for (;;) {
+        try {
+            const real = await fs.realpath(current);
+            return missing.length === 0 ? real : path.join(real, ...missing.reverse());
+        }
+        catch (error) {
+            if (error.code !== "ENOENT") {
+                throw error;
+            }
+            const parent = path.dirname(current);
+            if (parent === current) {
+                throw error;
+            }
+            missing.push(path.basename(current));
+            current = parent;
+        }
+    }
+}
+function resolveNonStrictSync(pathname) {
+    const missing = [];
+    let current = pathname;
+    for (;;) {
+        try {
+            const real = realpathSync(current);
+            return missing.length === 0 ? real : path.join(real, ...missing.reverse());
+        }
+        catch (error) {
+            if (error.code !== "ENOENT") {
+                throw error;
+            }
+            const parent = path.dirname(current);
+            if (parent === current) {
+                throw error;
+            }
+            missing.push(path.basename(current));
+            current = parent;
+        }
+    }
+}
+/** Counts non-overlapping occurrences, matching Python str.count
+ * (including the empty-needle edge: len(text) + 1). */
+function countOccurrences(haystack, needle) {
+    if (needle === "") {
+        return haystack.length + 1;
+    }
+    let count = 0;
+    let index = 0;
+    while ((index = haystack.indexOf(needle, index)) !== -1) {
+        count += 1;
+        index += needle.length;
+    }
+    return count;
+}
+function stringArgument(args, key) {
+    const value = args[key];
+    if (typeof value !== "string") {
+        throw new Error(`Missing or invalid argument: ${key}`);
+    }
+    return value;
+}
+/** Optional positive-integer argument; undefined when absent. */
+function optionalPositiveInteger(args, key) {
+    const value = args[key];
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value !== "number" || !Number.isInteger(value) || value < 1) {
+        throw new Error(`Argument ${key} must be a positive integer`);
+    }
+    return value;
+}
+/** Validate the batched `edits` argument (non-empty array of pairs). */
+function editsArgument(args) {
+    const value = args["edits"];
+    if (!Array.isArray(value) || value.length === 0) {
+        throw new Error("Missing or invalid argument: edits");
+    }
+    return value.map((entry, index) => {
+        if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+            throw new Error(`edits[${index}] must be an object`);
+        }
+        const record = entry;
+        return {
+            oldText: stringArgument(record, "old_text"),
+            newText: stringArgument(record, "new_text"),
+        };
+    });
+}
+function cancelledResult(context) {
+    return {
+        ok: false,
+        status: "cancelled",
+        error: context.cancellationReason,
+    };
+}
+/** Execute the small set of tools exposed to the model. */
+export class ToolRegistry {
+    root;
+    bashTimeoutSeconds;
+    maxOutputChars;
+    executionModes;
+    runBash;
+    io;
+    constructor(root, options = {}) {
+        this.root = resolveNonStrictSync(path.resolve(root));
+        this.bashTimeoutSeconds = options.bashTimeoutSeconds ?? 120;
+        this.maxOutputChars = options.maxOutputChars ?? 20_000;
+        this.executionModes = { ...(options.executionModes ?? {}) };
+        this.runBash = options.runBash ?? defaultRunBash;
+        this.io = options.io ?? DEFAULT_IO;
+    }
+    get definitions() {
+        // promptGuidelines never leaks into the OpenAI tools payload.
+        return TOOL_SPECS.map((spec) => ({
+            type: "function",
+            function: {
+                name: spec.name,
+                description: spec.description,
+                parameters: spec.parameters,
+            },
+        }));
+    }
+    /** Ordered fixed specs, consumed by the System Prompt builder. */
+    get orderedSpecs() {
+        return TOOL_SPECS;
+    }
+    executionMode(name) {
+        return this.executionModes[name];
+    }
+    async execute(name, args, context) {
+        const execution = context ?? NOOP_CONTEXT;
+        try {
+            if (execution.isCancelled()) {
+                return cancelledResult(execution);
+            }
+            if (name === "read") {
+                const target = await this.resolvePath(stringArgument(args, "path"));
+                const offset = optionalPositiveInteger(args, "offset") ?? 1;
+                const limit = optionalPositiveInteger(args, "limit");
+                const content = await this.io.readFile(target);
+                if (execution.isCancelled()) {
+                    return cancelledResult(execution);
+                }
+                // Split after each newline so a window rejoins byte-identically.
+                const lines = content === "" ? [] : content.split(/(?<=\n)/);
+                const totalLines = lines.length;
+                if (offset > Math.max(totalLines, 1)) {
+                    throw new Error(`offset ${offset} is out of range; the file has ${totalLines} lines`);
+                }
+                const window = lines.slice(offset - 1, limit === undefined ? undefined : offset - 1 + limit);
+                return withTouchedPath({
+                    ok: true,
+                    content: this.truncate(window.join("")),
+                    offset,
+                    limit: limit ?? null,
+                    total_lines: totalLines,
+                    has_more: offset - 1 + window.length < totalLines,
+                }, target);
+            }
+            if (name === "write") {
+                const rawPath = stringArgument(args, "path");
+                const target = await this.resolvePath(rawPath);
+                return await withFileMutationLock(target, async () => {
+                    if (execution.isCancelled()) {
+                        return cancelledResult(execution);
+                    }
+                    await fs.mkdir(path.dirname(target), { recursive: true });
+                    await this.io.writeFile(target, stringArgument(args, "content"));
+                    return withTouchedPath({ ok: true, path: rawPath }, target);
+                });
+            }
+            if (name === "edit") {
+                const rawPath = stringArgument(args, "path");
+                const target = await this.resolvePath(rawPath);
+                const edits = editsArgument(args);
+                return await withFileMutationLock(target, async () => {
+                    if (execution.isCancelled()) {
+                        return cancelledResult(execution);
+                    }
+                    const content = await this.io.readFile(target);
+                    // Every edit matches against the pre-edit original content.
+                    const ranges = edits.map((edit, index) => {
+                        const matches = countOccurrences(content, edit.oldText);
+                        if (matches !== 1) {
+                            throw new Error(`edits[${index}]: old_text must appear exactly once; ` +
+                                `found ${matches} matches`);
+                        }
+                        const start = content.indexOf(edit.oldText);
+                        return { start, end: start + edit.oldText.length, index };
+                    });
+                    const ordered = [...ranges].sort((a, b) => a.start - b.start);
+                    for (let i = 1; i < ordered.length; i += 1) {
+                        const previous = ordered[i - 1];
+                        const current = ordered[i];
+                        if (current.start < previous.end) {
+                            throw new Error(`edits[${previous.index}] and edits[${current.index}] overlap`);
+                        }
+                    }
+                    let updated = "";
+                    let cursor = 0;
+                    for (const range of ordered) {
+                        updated += content.slice(cursor, range.start);
+                        updated += edits[range.index].newText;
+                        cursor = range.end;
+                    }
+                    updated += content.slice(cursor);
+                    if (execution.isCancelled()) {
+                        return cancelledResult(execution);
+                    }
+                    await this.io.writeFile(target, updated);
+                    return withTouchedPath({ ok: true, path: rawPath }, target);
+                });
+            }
+            if (name === "bash") {
+                const command = stringArgument(args, "command");
+                // Required by the schema; validated here too so direct execute()
+                // callers get the same enforcement.
+                stringArgument(args, "description");
+                const workdir = args["workdir"];
+                const cwd = workdir === undefined
+                    ? this.root
+                    : await this.resolvePath(stringArgument(args, "workdir"));
+                const timeoutMs = optionalPositiveInteger(args, "timeoutMs");
+                return await this.runBash(command, {
+                    cwd,
+                    timeoutSeconds: timeoutMs === undefined ? this.bashTimeoutSeconds : timeoutMs / 1000,
+                    maxOutputChars: this.maxOutputChars,
+                    context: execution,
+                    env: process.env,
+                });
+            }
+            throw new Error(`Unknown tool: ${name}`);
+        }
+        catch (error) {
+            return {
+                ok: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    async resolvePath(rawPath) {
+        const resolved = await resolveNonStrict(path.resolve(this.root, rawPath));
+        if (resolved !== this.root && !resolved.startsWith(this.root + path.sep)) {
+            throw new Error(`Path is outside the project root: ${rawPath}`);
+        }
+        return resolved;
+    }
+    truncate(text) {
+        if (text.length <= this.maxOutputChars) {
+            return text;
+        }
+        const omitted = text.length - this.maxOutputChars;
+        return `${text.slice(0, this.maxOutputChars)}\n...[truncated ${omitted} chars]`;
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/ui-state.d.ts

@@ -0,0 +1,51 @@
+/** Event-reduced terminal state, independent from the agent runtime. */
+export interface ActiveResponse {
+    requestId: string;
+    text: string;
+    status: string;
+}
+export interface ActiveTool {
+    toolCallId: string;
+    name: string;
+    subject: string;
+    stdout: string;
+    stderr: string;
+    status: string;
+}
+export interface UIState {
+    sessionState: string;
+    activeResponse: ActiveResponse | null;
+    activeTools: Map<string, ActiveTool>;
+    pendingCount: number;
+    heldCount: number;
+    provider: string;
+    model: string;
+    totalTokens: number;
+    inputTokens: number;
+    outputTokens: number;
+}
+export declare function createUIState(): UIState;
+export interface UIUpdate {
+    kind: string;
+    text: string;
+    correlationId: string;
+    stream: string;
+    payload: Record<string, unknown>;
+}
+/**
+ * Minimal structural view of a canonical event. The concrete envelope type
+ * is owned by events.ts; anything carrying these fields is accepted.
+ */
+export interface UIEventLike {
+    kind?: unknown;
+    type?: unknown;
+    payload?: unknown;
+    correlation_id?: unknown;
+}
+/** Turn canonical events or projected dictionaries into small UI updates. */
+export declare class UIEventReducer {
+    #private;
+    readonly state: UIState;
+    constructor(state?: UIState);
+    apply(event: UIEventLike): UIUpdate | null;
+}