@tiangong-ai/cli 0.0.18 → 0.0.20

package/dist/research/workspace/executor.js

@@ -0,0 +1,353 @@
+import { spawn } from "node:child_process";
+import { access, mkdir, realpath, writeFile } from "node:fs/promises";
+import { constants as fsConstants } from "node:fs";
+import { homedir, platform } from "node:os";
+import { isAbsolute, join } from "node:path";
+import { CliError } from "../../errors.js";
+const MAX_CAPTURE_BYTES = 5 * 1024 * 1024;
+const CREDENTIAL_ENV_NAME = /(^|[_-])(authorization|auth|cookie|credential|password|passwd|private[_-]?key|secret|token|access[_-]?key|api[_-]?key)([_-]|$)/i;
+export async function executeAgent(request) {
+    validateAgentBinary(request.route);
+    const temporaryDirectory = join(request.capsuleRoot, "tmp");
+    await mkdir(temporaryDirectory, { recursive: true, mode: 0o700 });
+    const secrets = configuredSecrets(request.environment);
+    const invocation = await buildInvocation(request.route, request.prompt, request.brokerUrl, request.capsuleRoot);
+    const sandboxed = await sandboxInvocation(invocation.binary, invocation.args, request.capsuleRoot, request.projectRoot, request.workspaceRoot);
+    const started = process.hrtime.bigint();
+    const completed = await spawnCaptured({
+        binary: sandboxed.binary,
+        args: sandboxed.args,
+        cwd: request.projectRoot,
+        env: sanitizedEnvironment(request.environment, temporaryDirectory),
+        timeoutMs: request.timeoutSeconds * 1000,
+    });
+    const wallSeconds = Number(process.hrtime.bigint() - started) / 1_000_000_000;
+    const parsed = parseAgentResult(request.route.agent, completed.stdout, completed.stderr);
+    const redacted = redactResult(parsed.stdout, parsed.stderr, secrets);
+    const exitCode = redacted.exposed
+        ? 86
+        : completed.exitCode !== 0
+            ? completed.exitCode
+            : parsed.parseFailed
+                ? 3
+                : 0;
+    return {
+        exitCode,
+        stdout: redacted.stdout,
+        stderr: redacted.stderr,
+        tokens: redacted.exposed ? 0 : parsed.tokens,
+        costUsd: redacted.exposed ? 0 : parsed.costUsd,
+        wallSeconds,
+    };
+}
+async function buildInvocation(route, prompt, brokerUrl, capsuleRoot) {
+    if (route.agent === "codex") {
+        const args = [
+            "exec",
+            "--ignore-user-config",
+            "--ignore-rules",
+            "--strict-config",
+            "--skip-git-repo-check",
+            "--ephemeral",
+            "--color",
+            "never",
+            "--sandbox",
+            "workspace-write",
+            "-c",
+            'web_search="disabled"',
+            "--json",
+        ];
+        if (brokerUrl) {
+            args.push("-c", `mcp_servers.research_broker.url=${JSON.stringify(brokerUrl)}`, "-c", "mcp_servers.research_broker.required=true", "-c", 'mcp_servers.research_broker.enabled_tools=["fetch_candidate_source"]');
+        }
+        if (route.model)
+            args.push("--model", route.model);
+        args.push(prompt);
+        return { binary: route.binary, args };
+    }
+    const args = [
+        "-p",
+        prompt,
+        "--output-format",
+        "json",
+        "--permission-mode",
+        "acceptEdits",
+        "--no-session-persistence",
+        "--setting-sources",
+        "",
+        "--no-chrome",
+        "--disable-slash-commands",
+        "--tools",
+        "Read,Write,Edit,Glob,Grep",
+    ];
+    const allowedTools = ["Read", "Write", "Edit", "Glob", "Grep"];
+    if (brokerUrl) {
+        const mcpConfigPath = join(capsuleRoot, "research-mcp.json");
+        await writeFile(mcpConfigPath, `${JSON.stringify({
+            mcpServers: {
+                research_broker: { type: "http", url: brokerUrl },
+            },
+        })}\n`, { encoding: "utf8", mode: 0o600 });
+        allowedTools.push("mcp__research_broker__fetch_candidate_source");
+        args.push("--strict-mcp-config", "--mcp-config", mcpConfigPath);
+    }
+    args.push("--allowedTools", allowedTools.join(","));
+    if (route.model)
+        args.push("--model", route.model);
+    return { binary: route.binary, args };
+}
+async function sandboxInvocation(binary, args, capsuleRoot, projectRoot, workspaceRoot) {
+    const configuredCredentialPath = join(workspaceRoot, ".tiangong-research", ".env");
+    const workspaceCredentialPath = await realpath(configuredCredentialPath).catch(() => configuredCredentialPath);
+    if (platform() === "darwin") {
+        const sandbox = "/usr/bin/sandbox-exec";
+        await requireExecutable(sandbox, "macOS sandbox-exec");
+        const profile = join(capsuleRoot, "execution.sb");
+        const policy = [
+            "(version 1)",
+            "(deny default)",
+            "(allow process*)",
+            "(allow network*)",
+            `(allow file-read* (require-not (literal ${sandboxString(workspaceCredentialPath)})))`,
+            "(allow sysctl-read)",
+            "(allow mach-lookup)",
+            "(allow ipc-posix*)",
+            `(allow file-write* (literal "/dev/null") (subpath ${sandboxString(capsuleRoot)}))`,
+            "",
+        ].join("\n");
+        await writeFile(profile, policy, { encoding: "utf8", mode: 0o600 });
+        return { binary: sandbox, args: ["-f", profile, binary, ...args] };
+    }
+    if (platform() === "linux") {
+        const bubblewrap = await firstExecutable([
+            "/usr/bin/bwrap",
+            "/usr/local/bin/bwrap",
+            "/bin/bwrap",
+        ]);
+        if (!bubblewrap) {
+            throw new CliError("Linux research execution requires Bubblewrap.", {
+                code: "RESEARCH_SANDBOX_UNAVAILABLE",
+                exitCode: 3,
+            });
+        }
+        const sandboxArgs = [
+            "--die-with-parent",
+            "--new-session",
+            "--ro-bind",
+            "/",
+            "/",
+            "--bind",
+            capsuleRoot,
+            capsuleRoot,
+            "--proc",
+            "/proc",
+            "--dev",
+            "/dev",
+            "--chdir",
+            projectRoot,
+        ];
+        if (await pathIsReadable(workspaceCredentialPath)) {
+            sandboxArgs.push("--ro-bind", "/dev/null", workspaceCredentialPath);
+        }
+        sandboxArgs.push(binary, ...args);
+        return {
+            binary: bubblewrap,
+            args: sandboxArgs,
+        };
+    }
+    throw new CliError(`Unsupported research execution platform: ${platform()}`, {
+        code: "RESEARCH_SANDBOX_UNAVAILABLE",
+        exitCode: 3,
+    });
+}
+async function pathIsReadable(path) {
+    try {
+        await access(path, fsConstants.R_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function spawnCaptured(input) {
+    return new Promise((resolvePromise, reject) => {
+        const child = spawn(input.binary, input.args, {
+            cwd: input.cwd,
+            env: input.env,
+            shell: false,
+            detached: platform() !== "win32",
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        const stdout = [];
+        const stderr = [];
+        let capturedBytes = 0;
+        let settled = false;
+        const terminate = () => {
+            if (!child.pid)
+                return;
+            try {
+                if (platform() === "win32")
+                    child.kill("SIGKILL");
+                else
+                    process.kill(-child.pid, "SIGKILL");
+            }
+            catch {
+                child.kill("SIGKILL");
+            }
+        };
+        const timer = setTimeout(() => terminate(), input.timeoutMs);
+        const capture = (target, chunk) => {
+            capturedBytes += chunk.length;
+            if (capturedBytes > MAX_CAPTURE_BYTES) {
+                terminate();
+                return;
+            }
+            target.push(chunk);
+        };
+        child.stdout.on("data", (chunk) => capture(stdout, chunk));
+        child.stderr.on("data", (chunk) => capture(stderr, chunk));
+        child.on("error", (error) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            reject(error);
+        });
+        child.on("close", (code, signal) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            const detail = signal ? `\nprocess terminated by ${signal}` : "";
+            resolvePromise({
+                exitCode: typeof code === "number" ? code : 70,
+                stdout: Buffer.concat(stdout).toString("utf8"),
+                stderr: `${Buffer.concat(stderr).toString("utf8")}${detail}`,
+            });
+        });
+    });
+}
+function parseAgentResult(agent, stdout, stderr) {
+    if (agent === "codex") {
+        let tokens = 0;
+        const messages = [];
+        let parsedEvents = 0;
+        for (const line of stdout.split(/\r?\n/)) {
+            if (!line.trim())
+                continue;
+            try {
+                const event = JSON.parse(line);
+                parsedEvents += 1;
+                if (event.type === "turn.completed" && isRecord(event.usage)) {
+                    tokens = numeric(event.usage.input_tokens) + numeric(event.usage.output_tokens);
+                }
+                if (event.type === "item.completed" && isRecord(event.item)) {
+                    if (event.item.type === "agent_message" && typeof event.item.text === "string") {
+                        messages.push(event.item.text);
+                    }
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return {
+            stdout: messages.length ? messages.join("\n") : stdout,
+            stderr,
+            tokens,
+            costUsd: 0,
+            parseFailed: parsedEvents === 0,
+        };
+    }
+    try {
+        const value = JSON.parse(stdout);
+        const usage = isRecord(value.usage) ? value.usage : {};
+        return {
+            stdout: typeof value.result === "string" ? value.result : stdout,
+            stderr,
+            tokens: numeric(usage.input_tokens) +
+                numeric(usage.output_tokens) +
+                numeric(usage.cache_creation_input_tokens) +
+                numeric(usage.cache_read_input_tokens),
+            costUsd: numeric(value.total_cost_usd),
+            parseFailed: false,
+        };
+    }
+    catch {
+        return { stdout, stderr, tokens: 0, costUsd: 0, parseFailed: true };
+    }
+}
+function sanitizedEnvironment(source, temporaryDirectory) {
+    const environment = {};
+    for (const [name, value] of Object.entries(source)) {
+        if (!value || CREDENTIAL_ENV_NAME.test(name))
+            continue;
+        environment[name] = value;
+    }
+    environment.HOME = homedir();
+    environment.NO_COLOR = "1";
+    environment.TMPDIR = temporaryDirectory;
+    environment.TMP = temporaryDirectory;
+    environment.TEMP = temporaryDirectory;
+    return environment;
+}
+function configuredSecrets(source) {
+    return [
+        ...new Set(Object.entries(source)
+            .filter(([name, value]) => CREDENTIAL_ENV_NAME.test(name) && typeof value === "string" && value.length >= 8)
+            .map(([, value]) => value)),
+    ].sort((left, right) => right.length - left.length);
+}
+function redactResult(stdout, stderr, secrets) {
+    let safeStdout = stdout;
+    let safeStderr = stderr;
+    let exposed = false;
+    for (const secret of secrets) {
+        if (safeStdout.includes(secret) || safeStderr.includes(secret))
+            exposed = true;
+        safeStdout = safeStdout.replaceAll(secret, "[REDACTED]");
+        safeStderr = safeStderr.replaceAll(secret, "[REDACTED]");
+    }
+    return { stdout: safeStdout, stderr: safeStderr, exposed };
+}
+function validateAgentBinary(route) {
+    if (!isAbsolute(route.binary) && route.binary !== route.agent) {
+        throw new CliError(`Configured ${route.agent} binary must be absolute or exactly '${route.agent}'.`, {
+            code: "RESEARCH_EXECUTOR_INVALID",
+            exitCode: 2,
+        });
+    }
+}
+async function requireExecutable(path, label) {
+    try {
+        await access(path, fsConstants.X_OK);
+    }
+    catch {
+        throw new CliError(`${label} is unavailable: ${path}`, {
+            code: "RESEARCH_SANDBOX_UNAVAILABLE",
+            exitCode: 3,
+        });
+    }
+}
+async function firstExecutable(candidates) {
+    for (const candidate of candidates) {
+        try {
+            await access(candidate, fsConstants.X_OK);
+            return candidate;
+        }
+        catch {
+            continue;
+        }
+    }
+    return undefined;
+}
+function sandboxString(value) {
+    return `"${value.replaceAll("\\", "\\\\").replaceAll('"', '\\"')}"`;
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function numeric(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
+//# sourceMappingURL=executor.js.map

package/dist/research/workspace/executor.js.map

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

package/dist/research/workspace/journal.d.ts

@@ -0,0 +1,7 @@
+import type { JournalEvent } from "./types.js";
+export declare function appendJournalEvent(journalPath: string, type: string, scope: string, payload: Record<string, unknown>): Promise<JournalEvent>;
+export declare function readJournal(journalPath: string): Promise<JournalEvent[]>;
+export declare function verifyJournal(journalPath: string): Promise<{
+    events: number;
+    head: string;
+}>;

package/dist/research/workspace/journal.js

@@ -0,0 +1,104 @@
+import { appendFile, readFile } from "node:fs/promises";
+import { CliError } from "../../errors.js";
+import { canonicalJson, pathExists, sha256Text } from "./storage.js";
+const GENESIS_HASH = "0".repeat(64);
+const journalQueues = new Map();
+export async function appendJournalEvent(journalPath, type, scope, payload) {
+    const previousWrite = journalQueues.get(journalPath) ?? Promise.resolve();
+    let releaseWrite = () => undefined;
+    const currentWrite = new Promise((resolvePromise) => {
+        releaseWrite = resolvePromise;
+    });
+    const queuedWrite = previousWrite.catch(() => undefined).then(() => currentWrite);
+    journalQueues.set(journalPath, queuedWrite);
+    await previousWrite.catch(() => undefined);
+    try {
+        return await appendJournalEventNow(journalPath, type, scope, payload);
+    }
+    finally {
+        releaseWrite();
+        if (journalQueues.get(journalPath) === queuedWrite)
+            journalQueues.delete(journalPath);
+    }
+}
+async function appendJournalEventNow(journalPath, type, scope, payload) {
+    const events = await readJournal(journalPath);
+    verifyJournalEvents(events);
+    const previous = events.at(-1);
+    const unsigned = {
+        schemaVersion: 1,
+        sequence: events.length + 1,
+        timestamp: new Date().toISOString(),
+        type,
+        scope,
+        payload,
+        previousHash: previous?.hash ?? GENESIS_HASH,
+    };
+    const event = { ...unsigned, hash: sha256Text(canonicalJson(unsigned)) };
+    await appendFile(journalPath, `${JSON.stringify(event)}\n`, { encoding: "utf8", mode: 0o600 });
+    return event;
+}
+export async function readJournal(journalPath) {
+    if (!(await pathExists(journalPath)))
+        return [];
+    const content = await readFile(journalPath, "utf8");
+    if (!content.trim())
+        return [];
+    return content
+        .split(/\r?\n/)
+        .filter((line) => line.trim())
+        .map((line, index) => {
+        try {
+            return JSON.parse(line);
+        }
+        catch (error) {
+            throw new CliError(`Research journal line ${index + 1} is invalid JSON.`, {
+                code: "RESEARCH_JOURNAL_INVALID",
+                exitCode: 2,
+                details: { error: String(error) },
+            });
+        }
+    });
+}
+export async function verifyJournal(journalPath) {
+    const events = await readJournal(journalPath);
+    verifyJournalEvents(events);
+    return { events: events.length, head: events.at(-1)?.hash ?? GENESIS_HASH };
+}
+function verifyJournalEvents(events) {
+    let previousHash = GENESIS_HASH;
+    for (const [index, event] of events.entries()) {
+        if (event.schemaVersion !== 1 ||
+            event.sequence !== index + 1 ||
+            event.previousHash !== previousHash ||
+            typeof event.timestamp !== "string" ||
+            typeof event.type !== "string" ||
+            typeof event.scope !== "string" ||
+            !event.payload ||
+            typeof event.payload !== "object" ||
+            Array.isArray(event.payload)) {
+            throw new CliError(`Research journal event ${index + 1} is malformed.`, {
+                code: "RESEARCH_JOURNAL_INVALID",
+                exitCode: 2,
+            });
+        }
+        const unsigned = {
+            schemaVersion: event.schemaVersion,
+            sequence: event.sequence,
+            timestamp: event.timestamp,
+            type: event.type,
+            scope: event.scope,
+            payload: event.payload,
+            previousHash: event.previousHash,
+        };
+        const expected = sha256Text(canonicalJson(unsigned));
+        if (event.hash !== expected) {
+            throw new CliError(`Research journal event ${event.sequence} failed its hash check.`, {
+                code: "RESEARCH_JOURNAL_TAMPERED",
+                exitCode: 2,
+            });
+        }
+        previousHash = event.hash;
+    }
+}
+//# sourceMappingURL=journal.js.map

package/dist/research/workspace/journal.js.map

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

package/dist/research/workspace/projects.d.ts

@@ -0,0 +1,9 @@
+import type { ProjectInput, ProjectState, WorkPackage } from "./types.js";
+export declare function initializeProject(root: string, projectId: string, question: string): Promise<ProjectState>;
+export declare function addProjectInput(root: string, projectId: string, inputPath: string, role: ProjectInput["role"]): Promise<ProjectInput>;
+export declare function loadProject(root: string, projectId: string): Promise<ProjectState>;
+export declare function listProjects(root: string): Promise<ProjectState[]>;
+export declare function saveProject(root: string, project: ProjectState): Promise<void>;
+export declare function refreshProject(project: ProjectState): ProjectState;
+export declare function nextReadyPackage(project: ProjectState): WorkPackage | undefined;
+export declare function packageById(project: ProjectState, packageId: string): WorkPackage;