@clemrig/factory 0.0.0-stage → 0.1.0

package/dist/system/runtimes/claude-code.js

@@ -0,0 +1,383 @@
+import { createHash } from "node:crypto";
+import { existsSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { z } from "zod";
+import { runtimeLabels } from "../../engine/profiles.js";
+import { parseEvent, } from "./adapter.js";
+import { agentSessionName } from "./protocol.js";
+const label = runtimeLabels["claude-code"];
+const anyEvent = z.looseObject({
+    type: z.string(),
+    subtype: z.unknown().optional(),
+});
+/** What the session holds. Capabilities are required: an unreported one could hide a tool. */
+const initEvent = z.looseObject({
+    session_id: z.string(),
+    tools: z.array(z.string()),
+    mcp_servers: z.array(z.looseObject({ name: z.string(), status: z.string() })),
+    plugins: z.array(z.looseObject({ name: z.string(), path: z.string() })),
+    skills: z.array(z.string()).optional(),
+    slash_commands: z.array(z.string()).optional(),
+    output_style: z.string().optional(),
+    memory_paths: z.unknown().optional(),
+});
+/** A content block; a tool use names its call and its tool, a tool result its call. */
+const contentBlock = z
+    .looseObject({
+    type: z.string(),
+    id: z.unknown().optional(),
+    name: z.unknown().optional(),
+    tool_use_id: z.unknown().optional(),
+    is_error: z.boolean().optional(),
+})
+    .superRefine((block, context) => {
+    const required = block.type === "tool_use"
+        ? ["id", "name"]
+        : block.type === "tool_result"
+            ? ["tool_use_id"]
+            : [];
+    for (const key of required)
+        if (typeof block[key] !== "string")
+            context.addIssue({
+                code: "custom",
+                path: [key],
+                message: "expected a string",
+            });
+});
+const messageEvent = z.looseObject({
+    /** Set on a subagent's messages. */
+    parent_tool_use_id: z.unknown().optional(),
+    message: z.looseObject({
+        id: z.unknown().optional(),
+        usage: z.unknown().optional(),
+        // Text content holds no tool call.
+        content: z.preprocess((content) => (typeof content === "string" ? [] : content), z.array(contentBlock)),
+    }),
+});
+/** `result`, `errors` and the subtype only explain a failure: their shape never hides it. */
+const resultEvent = z.looseObject({
+    subtype: z.unknown().optional(),
+    is_error: z.boolean(),
+    result: z.unknown().optional(),
+    stop_reason: z.string().nullable().optional(),
+    errors: z.unknown().optional(),
+    modelUsage: z.unknown().optional(),
+});
+const text = (value) => (typeof value === "string" ? value : "");
+/** Every model of the call, subagents and compactions included; measured on a best-effort basis. */
+const modelUsage = z
+    .record(z.string(), z.looseObject({
+    inputTokens: z.number().nonnegative(),
+    outputTokens: z.number().nonnegative(),
+    cacheReadInputTokens: z.number().nonnegative(),
+    cacheCreationInputTokens: z.number().nonnegative(),
+    costUSD: z.number().nonnegative(),
+}))
+    .refine((models) => Object.keys(models).length > 0);
+function usageOf(value) {
+    const parsed = modelUsage.safeParse(value);
+    if (!parsed.success)
+        return undefined;
+    const usage = {
+        input: 0,
+        output: 0,
+        cacheRead: 0,
+        cacheWrite: 0,
+        costUsd: 0,
+    };
+    for (const model of Object.values(parsed.data)) {
+        usage.input += model.inputTokens;
+        usage.output += model.outputTokens;
+        usage.cacheRead += model.cacheReadInputTokens;
+        usage.cacheWrite += model.cacheCreationInputTokens;
+        usage.costUsd += model.costUSD;
+    }
+    return usage;
+}
+/** A response's tokens on its assistant events; output tokens are provisional until the result. */
+const stepUsage = z.looseObject({
+    input_tokens: z.number().nonnegative(),
+    output_tokens: z.number().nonnegative(),
+    cache_read_input_tokens: z.number().nonnegative(),
+    cache_creation_input_tokens: z.number().nonnegative(),
+});
+/** Claude Code session IDs are UUIDs: a stable one per session name. */
+export function claudeCodeSessionId(name) {
+    const hex = createHash("sha256").update(name).digest("hex");
+    const variant = ((Number.parseInt(hex[16] ?? "0", 16) & 0x3) | 0x8).toString(16);
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-5${hex.slice(13, 16)}-${variant}${hex.slice(17, 20)}-${hex.slice(20, 32)}`;
+}
+const isMcpTool = (tool) => tool.startsWith("mcp__");
+function profileArgs(profile, systemPrompt) {
+    const servers = Object.keys(profile.mcpServers).length
+        ? ["--mcp-config", JSON.stringify({ mcpServers: profile.mcpServers })]
+        : [];
+    return [
+        "--model",
+        profile.model,
+        "--effort",
+        profile.thinking,
+        "--append-system-prompt",
+        systemPrompt,
+        // No settings file: no CLAUDE.md, installed plugins, hooks, permissions or output style
+        // from the operator's setup. `--safe-mode` would also drop the profile's MCP servers.
+        "--setting-sources",
+        "",
+        "--strict-mcp-config",
+        ...servers,
+        "--disable-slash-commands",
+        "--settings",
+        JSON.stringify({ outputStyle: "default", autoMemoryEnabled: false }),
+        // `--tools` bounds built-in tools only; the allowlist is what lets MCP tools run.
+        "--tools",
+        profile.tools.filter((tool) => !isMcpTool(tool)).join(","),
+        ...(profile.tools.length
+            ? ["--allowedTools", profile.tools.join(",")]
+            : []),
+        "--permission-mode",
+        "dontAsk",
+    ];
+}
+/**
+ * Checks the started session against the profile: what the agent can do must be
+ * exactly what the profile grants (failure); any other customization is a warning.
+ */
+function checkSession(profile, init) {
+    const declared = Object.keys(profile.mcpServers);
+    // A server that failed to start would otherwise surface as missing tools.
+    const unavailable = declared.flatMap((server) => {
+        const status = init.mcp_servers.find(({ name }) => name === server)?.status;
+        return status === "connected" ? [] : [`${server} (${status ?? "missing"})`];
+    });
+    if (unavailable.length)
+        return failure(`${label} MCP servers are not connected: ${unavailable.join(", ")}`);
+    // An unknown name would silently remove a tool the profile grants.
+    const missing = profile.tools.filter((tool) => !init.tools.includes(tool));
+    if (missing.length)
+        return failure(`${label} does not provide tools: ${missing.join(", ")}`);
+    const capabilities = [
+        [
+            "tools",
+            init.tools.filter((tool) => !profile.tools.includes(tool) &&
+                !declared.some((server) => tool.startsWith(`mcp__${server}__`))),
+        ],
+        [
+            "MCP servers",
+            init.mcp_servers
+                .map(({ name }) => name)
+                .filter((name) => !declared.includes(name)),
+        ],
+        [
+            "plugins",
+            init.plugins
+                .filter(({ path }) => path !== "builtin")
+                .map(({ name }) => name),
+        ],
+    ];
+    const extra = capabilities.flatMap(([field, names]) => names.length ? [`${field} ${names.join(", ")}`] : []);
+    if (extra.length)
+        return failure(`${label} session is not isolated: ${extra.join("; ")}`);
+    const customizations = [
+        ...[
+            ["skills", init.skills],
+            ["slash commands", init.slash_commands],
+        ].flatMap(([field, names]) => names === undefined
+            ? [`${field} unreported`]
+            : names.length
+                ? [`${field} ${names.join(", ")}`]
+                : []),
+        ...(init.memory_paths === undefined ? [] : ["auto memory"]),
+        ...(init.output_style === "default"
+            ? []
+            : [`output style ${init.output_style ?? "unreported"}`]),
+    ];
+    return customizations.length
+        ? [
+            {
+                type: "warning",
+                message: `${label} session is not fully isolated: ${customizations.join("; ")}`,
+            },
+        ]
+        : [];
+}
+/** `claude auth status --json`; it also names the account, which is never read. */
+const loginStatus = z.looseObject({
+    loggedIn: z.boolean(),
+    authMethod: z.string().optional(),
+    apiKeySource: z.string().optional(),
+});
+function readLogin(stdout) {
+    let status;
+    try {
+        status = loginStatus.parse(JSON.parse(stdout));
+    }
+    catch {
+        return {
+            connected: false,
+            detail: `${label} login status is unreadable`,
+        };
+    }
+    if (!status.loggedIn)
+        return { connected: false, detail: `${label} is not logged in` };
+    // An API key in the environment replaces the login.
+    return {
+        connected: true,
+        detail: status.authMethod === "claude.ai"
+            ? "claude.ai subscription"
+            : status.authMethod === "api_key"
+                ? `API key (${status.apiKeySource ?? "unknown source"})`
+                : `${status.authMethod ?? "unknown"} login`,
+    };
+}
+const failure = (message) => [
+    { type: "failure", message },
+];
+/**
+ * Claude Code in print mode, in a session that holds only the profile's tools and
+ * MCP servers. Its sessions need UUIDs: the run keeps a marker per session, so
+ * that the next call resumes it. At the end of each call, Claude Code announces
+ * its session's total, which is reported as it is.
+ */
+export const claudeCode = {
+    name: "claude-code",
+    label,
+    executable: "claude",
+    minimumVersion: "2.1.296",
+    connection: () => ({
+        args: ["auth", "status", "--json"],
+        read: readLogin,
+    }),
+    model: (profile) => profile.model,
+    async start({ profile, systemPrompt, session, sessions }) {
+        const name = agentSessionName(sessions.runId, session);
+        const sessionId = claudeCodeSessionId(name);
+        const marker = join(sessions.directory, name);
+        // `--session-id` refuses an existing session and `--resume` a missing one.
+        const created = existsSync(marker);
+        const tools = new Map();
+        const responses = new Set();
+        let initialized = false;
+        /** A main-loop response once, however many events carry it; unreadable tokens are not reported. */
+        const responseOf = (type, parent, message) => {
+            if (type !== "assistant" || parent || typeof message.id !== "string")
+                return [];
+            if (responses.has(message.id))
+                return [];
+            responses.add(message.id);
+            const usage = stepUsage.safeParse(message.usage);
+            return usage.success
+                ? [
+                    {
+                        type: "response",
+                        tokens: {
+                            input: usage.data.input_tokens,
+                            output: usage.data.output_tokens,
+                            cacheRead: usage.data.cache_read_input_tokens,
+                            cacheWrite: usage.data.cache_creation_input_tokens,
+                        },
+                    },
+                ]
+                : [];
+        };
+        return {
+            args: [
+                "--print",
+                "--output-format",
+                "stream-json",
+                "--verbose",
+                ...profileArgs(profile, systemPrompt),
+                created ? "--resume" : "--session-id",
+                sessionId,
+                "--name",
+                `${sessions.runId}:${session}`,
+            ],
+            read(raw) {
+                const event = parseEvent(label, anyEvent, raw);
+                if (event.type === "system" && event.subtype === "init") {
+                    const init = parseEvent(label, initEvent, raw);
+                    if (init.session_id !== sessionId)
+                        return failure(`${label} started session ${init.session_id} instead of ${sessionId}`);
+                    if (!created)
+                        writeFileSync(marker, `${JSON.stringify({ sessionId })}\n`, {
+                            mode: 0o600,
+                        });
+                    initialized = true;
+                    return checkSession(profile, init);
+                }
+                if (event.type === "assistant" || event.type === "user") {
+                    const { parent_tool_use_id: parent, message } = parseEvent(label, messageEvent, raw);
+                    return [
+                        ...responseOf(event.type, parent, message),
+                        ...message.content.flatMap((block) => {
+                            if (block.type === "tool_use") {
+                                tools.set(String(block.id), String(block.name));
+                                return [
+                                    {
+                                        type: "tool",
+                                        id: String(block.id),
+                                        name: String(block.name),
+                                        status: "started",
+                                    },
+                                ];
+                            }
+                            if (block.type !== "tool_result")
+                                return [];
+                            const id = String(block.tool_use_id);
+                            return [
+                                {
+                                    type: "tool",
+                                    id,
+                                    name: tools.get(id) ?? id,
+                                    status: block.is_error ? "failed" : "completed",
+                                },
+                            ];
+                        }),
+                    ];
+                }
+                if (event.type !== "result")
+                    return [];
+                const result = parseEvent(label, resultEvent, raw);
+                const total = usageOf(result.modelUsage);
+                // A crash result may announce zeroed figures (Claude Code's cost tracking docs):
+                // nothing is measured, so the session keeps its earlier total.
+                const crashed = result.is_error &&
+                    result.subtype === "error_during_execution" &&
+                    total !== undefined &&
+                    Object.values(total).every((value) => value === 0);
+                const usage = {
+                    type: "usage",
+                    scope: "session",
+                    usage: crashed ? undefined : total,
+                };
+                if (result.is_error) {
+                    const errors = Array.isArray(result.errors)
+                        ? result.errors.filter((error) => typeof error === "string")
+                        : [];
+                    return [
+                        usage,
+                        ...failure(`${label} ${text(result.subtype) || "error"}: ${text(result.result) || errors.join("; ") || "no detail provided"}`),
+                    ];
+                }
+                if (result.stop_reason && result.stop_reason !== "end_turn")
+                    return [
+                        usage,
+                        ...failure(`${label} final response ended with stop reason ${result.stop_reason}`),
+                    ];
+                // Without an init event, neither the session nor its isolation was checked.
+                if (!initialized)
+                    return [
+                        usage,
+                        ...failure(`${label} answered without reporting its session (init)`),
+                    ];
+                // A successful call's final text is what the stage receives.
+                if (typeof result.result !== "string")
+                    return [
+                        usage,
+                        ...failure(`${label} emitted an unexpected result event: result: expected a string`),
+                    ];
+                return [usage, { type: "result", text: result.result }];
+            },
+        };
+    },
+};
+//# sourceMappingURL=claude-code.js.map

package/dist/system/runtimes/claude-code.js.map

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

package/dist/system/runtimes/inspect.d.ts

@@ -0,0 +1,25 @@
+import type { Runtime } from "../../engine/profiles.js";
+import type { AgentStage } from "../../engine/types.js";
+export interface RuntimeStatus {
+    ok: boolean;
+    detail: string;
+}
+export interface AgentProblem {
+    /** The agent stage, as the caller names it. */
+    stage: string;
+    runtime: Runtime;
+    reason: string;
+}
+/** Node 24 or later runs the factory's TypeScript without a build step. */
+export declare function inspectNode(): RuntimeStatus;
+/**
+ * Inspects each runtime the agent stages use, without any provider request: the
+ * executable in the PATH, its version, then the connection each stage's profile
+ * would use. A missing prerequisite is reported for every stage it concerns.
+ */
+export declare function inspectRuntimes(agents: Record<string, Pick<AgentStage, "profile">>): Promise<{
+    runtimes: Partial<Record<Runtime, RuntimeStatus>>;
+    problems: AgentProblem[];
+    /** Each runtime found, by absolute path: a run launches exactly what was checked. */
+    executables: Partial<Record<Runtime, string>>;
+}>;

package/dist/system/runtimes/inspect.js

@@ -0,0 +1,129 @@
+import { constants } from "node:fs";
+import { access, stat } from "node:fs/promises";
+import { delimiter, isAbsolute, join } from "node:path";
+import { ProcessInterruptedError, runProcess } from "../process.js";
+import { runtimes } from "./registry.js";
+/** Only absolute PATH entries: an empty or relative one depends on the current directory. */
+async function findInPath(name) {
+    for (const dir of (process.env.PATH ?? "").split(delimiter)) {
+        if (!isAbsolute(dir))
+            continue;
+        const candidate = join(dir, name);
+        try {
+            await access(candidate, constants.X_OK);
+            if ((await stat(candidate)).isFile())
+                return candidate;
+        }
+        catch {
+            // Not in this directory.
+        }
+    }
+    return undefined;
+}
+/** Node 24 or later runs the factory's TypeScript without a build step. */
+export function inspectNode() {
+    const version = process.versions.node;
+    return Number(version.split(".")[0]) >= 24
+        ? { ok: true, detail: `Node ${version}` }
+        : { ok: false, detail: `Node 24+ required; found ${version}` };
+}
+/** Standard output of a quick local command; a runtime that cannot run is a finding, not an error. */
+async function output(executable, args) {
+    try {
+        return await runProcess([executable, ...args], process.cwd(), 10_000);
+    }
+    catch (error) {
+        if (error instanceof ProcessInterruptedError)
+            throw error;
+        return { error: error instanceof Error ? error.message : String(error) };
+    }
+}
+const older = (version, minimum) => {
+    const [a, b] = [version, minimum].map((value) => value.split(".").map(Number));
+    for (let i = 0; i < 3; i++)
+        if ((a?.[i] ?? 0) !== (b?.[i] ?? 0))
+            return (a?.[i] ?? 0) < (b?.[i] ?? 0);
+    return false;
+};
+/** The executable in the PATH and its version: where it is, or why it cannot be used. */
+async function inspectExecutable(adapter) {
+    const path = await findInPath(adapter.executable);
+    if (!path)
+        return { problem: `${adapter.executable} not found in PATH` };
+    const printed = await output(path, ["--version"]);
+    if ("error" in printed)
+        return { problem: `Cannot run ${adapter.label}: ${printed.error}` };
+    if (printed.exitCode !== 0)
+        return {
+            problem: `${adapter.label} --version exited with code ${printed.exitCode}`,
+        };
+    const version = /\d+\.\d+\.\d+/.exec(printed.stdout)?.[0];
+    if (!version)
+        return {
+            problem: `Cannot read the ${adapter.label} version: ${printed.stdout.trim() || printed.stderr.trim() || "no output"}`,
+        };
+    if (older(version, adapter.minimumVersion))
+        return {
+            problem: `${adapter.label} ${version} is older than ${adapter.minimumVersion}, the oldest version factory supports`,
+        };
+    return { path, version };
+}
+/** The connection a check reports, trusted only when the check succeeded; a refusal keeps its own reason. */
+function connectionOf(adapter, printed, read) {
+    if ("error" in printed)
+        return {
+            connected: false,
+            detail: `Cannot run ${adapter.label}: ${printed.error}`,
+        };
+    const reported = read(printed.stdout);
+    return reported.connected && printed.exitCode !== 0
+        ? {
+            connected: false,
+            detail: `${adapter.label} connection check exited with code ${printed.exitCode}`,
+        }
+        : reported;
+}
+/**
+ * Inspects each runtime the agent stages use, without any provider request: the
+ * executable in the PATH, its version, then the connection each stage's profile
+ * would use. A missing prerequisite is reported for every stage it concerns.
+ */
+export async function inspectRuntimes(agents) {
+    const statuses = {};
+    const executables = {};
+    const problems = [];
+    const stages = Object.entries(agents);
+    for (const runtime of new Set(stages.map(([, { profile }]) => profile.runtime))) {
+        const adapter = runtimes[runtime];
+        const using = stages.filter(([, { profile }]) => profile.runtime === runtime);
+        const executable = await inspectExecutable(adapter);
+        if ("problem" in executable) {
+            statuses[runtime] = { ok: false, detail: executable.problem };
+            for (const [stage] of using)
+                problems.push({ stage, runtime, reason: executable.problem });
+            continue;
+        }
+        executables[runtime] = executable.path;
+        // Stages whose profiles use the same connection share one check.
+        const checked = new Map();
+        for (const [stage, { profile }] of using) {
+            const { args, read } = adapter.connection(profile);
+            const key = args.join("\0");
+            let connection = checked.get(key);
+            if (!connection) {
+                const printed = await output(executable.path, args);
+                connection = connectionOf(adapter, printed, read);
+                checked.set(key, connection);
+            }
+            if (!connection.connected)
+                problems.push({ stage, runtime, reason: connection.detail });
+        }
+        const connections = [...checked.values()];
+        statuses[runtime] = {
+            ok: connections.every(({ connected }) => connected),
+            detail: `${adapter.label} ${executable.version} (${executable.path}): ${connections.map(({ detail }) => detail).join(", ")}`,
+        };
+    }
+    return { runtimes: statuses, problems, executables };
+}
+//# sourceMappingURL=inspect.js.map

package/dist/system/runtimes/inspect.js.map

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

package/dist/system/runtimes/pi.d.ts

@@ -0,0 +1,7 @@
+import { type RuntimeAdapter } from "./adapter.js";
+/**
+ * Pi in JSON mode (its documented event stream), its session named after the run.
+ * Every response is measured, retried ones included; the answer is the last
+ * response once Pi has settled, after its own retries.
+ */
+export declare const pi: RuntimeAdapter<"pi">;