humanish 0.0.1 → 0.15.0

package/dist/claude-agent-sdk.js

@@ -0,0 +1,356 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { ACTOR_TRACE_SCHEMA, CLAUDE_AGENT_SDK_CAPABILITIES } from "./actor-contract.js";
+import { redactText } from "./redaction.js";
+// SDK result subtypes -> ActorStatus. error_max_turns / error_max_budget_usd are
+// the SDK's own configured resource limits (a harness ceiling), mapped to
+// timed_out. They are NOT the persona's "gave_up": that is reserved for
+// persona-judged abandonment in the live actor loop.
+export function claudeResultSubtypeToStatus(subtype) {
+    switch (subtype) {
+        case "success":
+            return "passed";
+        case "error_max_turns":
+        case "error_max_budget_usd":
+            return "timed_out";
+        case "error_during_execution":
+        case "error_max_structured_output_retries":
+            return "failed";
+    }
+}
+export function claudeStatusToCompletionReason(status) {
+    switch (status) {
+        case "passed":
+            return "turn_completed";
+        case "timed_out":
+            return "timed_out";
+        case "blocked":
+            return "blocked_approval";
+        case "failed":
+            return "actor_error";
+    }
+}
+function pickClaudeTokenUsage(usage, costUsd) {
+    const num = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
+    const input = num(usage?.input_tokens);
+    const output = num(usage?.output_tokens);
+    const total = input !== undefined && output !== undefined ? input + output : undefined;
+    const cost = num(costUsd);
+    const tokenUsage = {
+        ...(input === undefined ? {} : { input }),
+        ...(output === undefined ? {} : { output }),
+        ...(total === undefined ? {} : { total }),
+        ...(cost === undefined ? {} : { costUsd: cost })
+    };
+    return Object.keys(tokenUsage).length > 0 ? tokenUsage : undefined;
+}
+// String content is plain user input text (the Anthropic MessageParam only carries
+// tool_use/tool_result as block arrays, never strings), and user input is not
+// surfaced as trace items, so returning [] here is intentional, not data loss.
+function contentBlocks(message) {
+    return Array.isArray(message.content) ? message.content : [];
+}
+function elapsedMs(startedAt, completedAt) {
+    const start = Date.parse(startedAt);
+    const end = Date.parse(completedAt);
+    return Number.isFinite(start) && Number.isFinite(end) && end >= start ? end - start : 0;
+}
+// Project the Claude SDK message stream into provider-neutral items. assistant
+// content blocks (text/thinking/tool_use) and user tool_result blocks map to
+// message/reasoning/tool_call. Claude does not emit distinct plan/file_change/
+// screenshot/approval events in this slice, so none are fabricated. Tool inputs
+// are intentionally not surfaced (they can carry arbitrary text); only the tool
+// name is, redacted.
+function claudeMessagesToActorItems(messages) {
+    const items = [];
+    const toolNames = new Map();
+    let messageOrdinal = 0;
+    for (const message of messages) {
+        if (message.type === "assistant") {
+            for (const block of contentBlocks(message.message)) {
+                if (block.type === "text") {
+                    messageOrdinal += 1;
+                    const text = block.text.trim();
+                    items.push({
+                        id: `message-${messageOrdinal}`,
+                        kind: "message",
+                        lifecycle: "completed",
+                        title: "Assistant message",
+                        ...(text.length > 0 ? { text: redactText(text) } : {})
+                    });
+                }
+                else if (block.type === "thinking") {
+                    messageOrdinal += 1;
+                    const thinking = block.thinking.trim();
+                    items.push({
+                        id: `reasoning-${messageOrdinal}`,
+                        kind: "reasoning",
+                        lifecycle: "completed",
+                        title: "Reasoning",
+                        ...(thinking.length > 0 ? { text: redactText(thinking) } : {})
+                    });
+                }
+                else if (block.type === "tool_use") {
+                    const name = redactText(block.name);
+                    toolNames.set(block.id, name);
+                    items.push({
+                        id: block.id,
+                        kind: "tool_call",
+                        lifecycle: "started",
+                        title: name,
+                        tool: { name }
+                    });
+                }
+            }
+        }
+        else if (message.type === "user") {
+            for (const block of contentBlocks(message.message)) {
+                if (block.type === "tool_result") {
+                    const name = toolNames.get(block.tool_use_id) ?? "tool";
+                    items.push({
+                        id: `${block.tool_use_id}-result`,
+                        kind: "tool_call",
+                        lifecycle: "completed",
+                        ...(block.is_error ? { status: "error" } : {}),
+                        title: name,
+                        tool: { name }
+                    });
+                }
+            }
+        }
+    }
+    return items;
+}
+/**
+ * Map a Claude Agent SDK session into the provider-neutral ActorTrace. Pure and
+ * side-effect-free; mirrors codexResultToActorTrace / piSessionToActorTrace. The
+ * persona reference is supplied by the harness.
+ */
+export function claudeSessionToActorTrace(session, persona) {
+    const result = [...session.messages].reverse().find((message) => message.type === "result");
+    // Match the init message by subtype: the SDK emits other system messages
+    // (hook_started/hook_response) first, and only init carries model/session.
+    const init = session.messages.find((message) => message.type === "system" && message.subtype === "init");
+    const subtype = result?.type === "result" ? result.subtype : "error_during_execution";
+    const status = claudeResultSubtypeToStatus(subtype);
+    const sessionId = (result?.type === "result" ? result.session_id : undefined) ?? (init?.type === "system" ? init.session_id : undefined);
+    const model = init?.type === "system" ? init.model : undefined;
+    const durationMs = result?.type === "result" && typeof result.duration_ms === "number"
+        ? result.duration_ms
+        : elapsedMs(session.startedAt, session.completedAt);
+    const reason = result?.type === "result" ? result.result ?? `claude session ended: ${subtype}` : "claude session produced no result message";
+    const tokenUsage = result?.type === "result" ? pickClaudeTokenUsage(result.usage, result.total_cost_usd) : undefined;
+    const items = claudeMessagesToActorItems(session.messages);
+    return {
+        schema: ACTOR_TRACE_SCHEMA,
+        provider: "claude-agent-sdk",
+        ...(session.providerVersion === undefined ? {} : { providerVersion: session.providerVersion }),
+        protocol: "in-process-sdk",
+        lane: "code",
+        persona,
+        redaction: {
+            status: "passed",
+            screenshots: "n/a",
+            notes: "Claude Agent SDK message stream projected to actor trace; secret-like text is rejected by verify."
+        },
+        startedAt: session.startedAt,
+        completedAt: session.completedAt,
+        durationMs,
+        status,
+        completionReason: claudeStatusToCompletionReason(status),
+        reason: redactText(reason),
+        ids: {
+            ...(sessionId === undefined ? {} : { sessionId }),
+            ...(model === undefined ? {} : { model })
+        },
+        counts: {
+            messages: session.messages.length,
+            items: items.length
+        },
+        items,
+        ...(tokenUsage === undefined ? {} : { tokenUsage }),
+        capabilities: CLAUDE_AGENT_SDK_CAPABILITIES
+    };
+}
+function defaultClaudeSystemPrompt(persona) {
+    const traits = persona.traitsApplied.length > 0 ? persona.traitsApplied.join(", ") : "none";
+    return `You are simulating a software user persona for a public-safe UX test harness. Persona id: ${persona.id}. Applied traits: ${traits}. Stay in character, attempt the requested task, then stop; do not ask clarifying questions. Never print secrets, keys, or local file paths.`;
+}
+function isMissingClaudeAgentSdk(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        error.code === "ERR_MODULE_NOT_FOUND" &&
+        String(error.message ?? "").includes("@anthropic-ai/claude-agent-sdk"));
+}
+async function loadClaudeAgentSdkQuery() {
+    try {
+        const sdk = (await import("@anthropic-ai/claude-agent-sdk"));
+        return sdk.query;
+    }
+    catch (error) {
+        if (isMissingClaudeAgentSdk(error)) {
+            throw new Error("Live Claude Agent SDK runs require the optional peer dependency @anthropic-ai/claude-agent-sdk. Install it with `npm i -D @anthropic-ai/claude-agent-sdk`, or inject a queryFn for tests.");
+        }
+        throw error;
+    }
+}
+// Recursively redact every string in a value so the near-raw event log cannot
+// carry a secret or local path (the mapper only redacts the trace projection).
+function redactJsonDeep(value) {
+    if (typeof value === "string") {
+        return redactText(value);
+    }
+    if (Array.isArray(value)) {
+        return value.map((entry) => redactJsonDeep(entry));
+    }
+    if (value !== null && typeof value === "object") {
+        const out = {};
+        for (const [key, entry] of Object.entries(value)) {
+            out[key] = redactJsonDeep(entry);
+        }
+        return out;
+    }
+    return value;
+}
+function renderClaudeTranscript(trace) {
+    const lines = [];
+    for (const item of trace.items) {
+        if (item.kind === "message" && item.text) {
+            lines.push(`assistant: ${item.text}`);
+        }
+        else if (item.kind === "reasoning" && item.text) {
+            lines.push(`reasoning: ${item.text}`);
+        }
+        else if (item.kind === "tool_call") {
+            lines.push(`tool ${item.lifecycle}: ${item.tool?.name ?? item.title}`);
+        }
+    }
+    return lines.join("\n");
+}
+const CLAUDE_ARTIFACT_DIR = "claude-agent-sdk";
+// Map the session through the pure mapper and write the three evidence artifacts.
+// Shared by the normal path and the load-failure path so both always leave a bundle.
+async function finishClaudeSession(runRoot, persona, session, envelopeLines) {
+    const eventsPath = path.join(CLAUDE_ARTIFACT_DIR, "events.ndjson");
+    const tracePath = path.join(CLAUDE_ARTIFACT_DIR, "summary.json");
+    const transcriptPath = path.join(CLAUDE_ARTIFACT_DIR, "transcript.txt");
+    const trace = claudeSessionToActorTrace(session, persona);
+    const transcript = renderClaudeTranscript(trace);
+    await writeFile(path.join(runRoot, eventsPath), envelopeLines.length > 0 ? `${envelopeLines.join("\n")}\n` : "", "utf8");
+    await writeFile(path.join(runRoot, tracePath), `${JSON.stringify(trace, null, 2)}\n`, "utf8");
+    await writeFile(path.join(runRoot, transcriptPath), transcript.length > 0 ? transcript : "No Claude Agent SDK transcript output captured.\n", "utf8");
+    return {
+        status: trace.status,
+        reason: trace.reason,
+        durationMs: trace.durationMs,
+        trace,
+        session,
+        transcriptPath,
+        tracePath,
+        eventsPath,
+        tail: transcript.slice(-6000)
+    };
+}
+/**
+ * Drive a Claude Agent SDK session (or an injected fake) and write the three
+ * provider-neutral evidence artifacts, mirroring runCodexAppServerSession. The
+ * mapping is delegated to the pure claudeSessionToActorTrace. A load failure or
+ * timeout still produces a (failed/timed_out) bundle rather than throwing.
+ */
+export async function runClaudeAgentSession(options) {
+    await mkdir(path.join(options.runRoot, CLAUDE_ARTIFACT_DIR), { recursive: true });
+    const startedAt = new Date().toISOString();
+    const startedMs = Date.now();
+    // Resolve the query function. A failure to load the optional SDK is captured as
+    // a failed bundle (artifacts still written) rather than propagated.
+    let queryFn;
+    try {
+        queryFn = options.queryFn ?? (await (options.loadQueryFn ?? loadClaudeAgentSdkQuery)());
+    }
+    catch (error) {
+        const reason = redactText(error instanceof Error ? error.message : String(error));
+        const session = {
+            startedAt,
+            completedAt: new Date().toISOString(),
+            messages: [{ type: "result", subtype: "error_during_execution", is_error: true, duration_ms: Date.now() - startedMs, result: reason }]
+        };
+        return finishClaudeSession(options.runRoot, options.persona, session, [JSON.stringify({ at: startedAt, error: reason })]);
+    }
+    const queryOptions = {
+        systemPrompt: options.systemPrompt ?? defaultClaudeSystemPrompt(options.persona),
+        settingSources: [],
+        allowedTools: [],
+        disallowedTools: ["Bash", "Read", "Write", "Edit", "Glob", "Grep", "WebSearch", "WebFetch", "Task", "NotebookEdit"],
+        permissionMode: "default",
+        cwd: options.cwd,
+        maxTurns: options.maxTurns ?? 8,
+        includePartialMessages: false,
+        ...(options.model ? { model: options.model } : {})
+    };
+    const messages = [];
+    const envelopeLines = [];
+    let timedOut = false;
+    // Drive the iterator manually, racing each step against the deadline so a hung
+    // generator (or a non-cooperative one) cannot block past timeoutMs. abort() also
+    // signals the real SDK to stop its underlying request.
+    const abortController = new AbortController();
+    queryOptions.abortController = abortController;
+    const deadline = startedMs + options.timeoutMs;
+    const iterator = queryFn({ prompt: options.prompt, options: queryOptions })[Symbol.asyncIterator]();
+    try {
+        while (true) {
+            const remaining = deadline - Date.now();
+            if (remaining <= 0) {
+                timedOut = true;
+                abortController.abort();
+                break;
+            }
+            let timer;
+            const timeout = new Promise((resolve) => {
+                timer = setTimeout(() => resolve({ timedOut: true }), remaining);
+            });
+            let step;
+            try {
+                step = await Promise.race([iterator.next(), timeout]);
+            }
+            finally {
+                if (timer) {
+                    clearTimeout(timer);
+                }
+            }
+            if ("timedOut" in step) {
+                timedOut = true;
+                abortController.abort();
+                // Best-effort generator teardown; swallow rejection (the real SDK manages
+                // a subprocess that can reject on cleanup) to avoid an unhandled rejection.
+                const returned = iterator.return?.();
+                if (returned) {
+                    void returned.catch(() => undefined);
+                }
+                break;
+            }
+            if (step.done) {
+                break;
+            }
+            messages.push(step.value);
+            envelopeLines.push(JSON.stringify({ at: new Date().toISOString(), message: redactJsonDeep(step.value) }));
+        }
+    }
+    catch (error) {
+        envelopeLines.push(JSON.stringify({ at: new Date().toISOString(), error: redactText(error instanceof Error ? error.message : String(error)) }));
+    }
+    const completedAt = new Date().toISOString();
+    // Synthesize a terminal if the stream never produced a result message (timeout,
+    // abort, or a clean finish without one). The mapper maps these to timed_out/failed.
+    if (!messages.some((message) => message.type === "result")) {
+        messages.push({
+            type: "result",
+            subtype: timedOut ? "error_max_turns" : "error_during_execution",
+            is_error: true,
+            duration_ms: Date.now() - startedMs,
+            result: timedOut ? "Claude session timed out before completion." : "Claude session ended without a result message."
+        });
+    }
+    return finishClaudeSession(options.runRoot, options.persona, { messages, startedAt, completedAt }, envelopeLines);
+}
+//# sourceMappingURL=claude-agent-sdk.js.map

package/dist/claude-agent-sdk.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { normalizeCliArgv } from "./argv.js";
+import { createProgram } from "./program.js";
+await createProgram().parseAsync(normalizeCliArgv(process.argv));
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,aAAa,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC"}

package/dist/codex-app-server-ui.d.ts

@@ -0,0 +1,39 @@
+import { type CodexAppServerRunOptions, type CodexAppServerRunResult, type CodexAppServerStatus } from "./codex-app-server.js";
+export declare const CODEX_APP_SERVER_UI_SCHEMA = "humanish.codex-app-server-ui.v1";
+type CodexAppServerUiStatus = "starting" | "running" | CodexAppServerStatus;
+export interface CodexAppServerUiOptions {
+    actorCommand?: string;
+    cwd: string;
+    keepOpen?: boolean;
+    model?: string;
+    port?: number;
+    prompt: string;
+    runRoot: string;
+    sandbox?: CodexAppServerRunOptions["sandbox"];
+    serviceName?: string;
+    stateFile?: string;
+    timeoutMs: number;
+}
+export interface CodexAppServerUiState {
+    schema: typeof CODEX_APP_SERVER_UI_SCHEMA;
+    artifactRoot: string;
+    cwd: string;
+    promptDigest: string;
+    reason: string;
+    result?: CodexAppServerRunResult;
+    runRoot: string;
+    startedAt: string;
+    status: CodexAppServerUiStatus;
+    stateFile: string;
+    updatedAt: string;
+    url?: string;
+}
+export interface CodexAppServerUiController {
+    close(): Promise<void>;
+    completion: Promise<CodexAppServerUiState>;
+    initialState: CodexAppServerUiState;
+    stateFile: string;
+    url: string;
+}
+export declare function startCodexAppServerUi(options: CodexAppServerUiOptions): Promise<CodexAppServerUiController>;
+export {};