humanish 0.0.1 → 0.15.0

package/dist/actor-contract.d.ts

@@ -0,0 +1,107 @@
+import type { CodexAppServerRunResult, CodexAppServerStatus } from "./codex-app-server.js";
+export declare const ACTOR_TRACE_SCHEMA = "humanish.actor-trace.v1";
+export type ActorStatus = "passed" | "failed" | "blocked" | "timed_out";
+export type ActorCompletionReason = "goal_satisfied" | "turn_completed" | "gave_up" | "blocked_approval" | "timed_out" | "actor_error" | "step_failed" | "harness_error";
+export type ActorLane = "code" | "app" | "computer-use" | "scripted-browser" | "terminal";
+export type ActorProtocol = "json-rpc" | "json-stream" | "in-process-sdk" | "cua-loop" | "scripted-steps" | "terminal-exec";
+export type ActorTraceItemKind = "message" | "reasoning" | "tool_call" | "command" | "file_change" | "approval" | "screenshot" | "ui_action" | "plan" | "notice";
+export interface ActorTraceItem {
+    id: string;
+    kind: ActorTraceItemKind;
+    lifecycle: "started" | "completed";
+    status?: string;
+    title: string;
+    tool?: {
+        server?: string;
+        name?: string;
+    };
+    command?: {
+        text?: string;
+        cwd?: string;
+        exitCode?: number;
+        outputTail?: string;
+    };
+    screenshotRef?: {
+        path: string;
+        redaction: "blurred" | "ocr_scrubbed" | "none";
+    };
+    text?: string;
+}
+export interface ActorCapabilities {
+    headless: boolean;
+    structuredTrace: boolean;
+    lanes: ActorLane[];
+    producesScreenshots: boolean;
+    byoModel: boolean;
+    preGrantableApprovals: boolean;
+    inProcessTools: boolean;
+    license: "open" | "source-available" | "proprietary";
+    /**
+     * WHERE this actor's runtime key lives, per the placement rule (invariants-and-defaults.md):
+     * "keys live where the keyed process runs — and nowhere else." Registry metadata the engine
+     * enforces, NOT a code convention.
+     *   - "external" (the implicit default for every existing actor): the keyed process (e.g. a
+     *     computer-use provider loop) runs OUTSIDE any sandbox, so its key never enters one.
+     *   - "in-sandbox-command-scoped": the keyed process is an agent-harness-under-test that runs
+     *     INSIDE the sandbox; its runtime key is injected ONLY into the per-command `envs` of that
+     *     invocation (never `Sandbox.create({envs})`, which is sandbox-global), the key is presumed
+     *     exfiltratable, and the blast radius is bounded by key scoping + a spend budget.
+     * Absent === "external". This field is DECLARED metadata in SLICE 1 (the contract is honest
+     * about where the key would go); the ENGINE enforcement of command-scoped injection lands with
+     * the live backend in SLICE 2.
+     */
+    keyPlacement?: "external" | "in-sandbox-command-scoped";
+}
+export interface ActorPersonaRef {
+    id: string;
+    traitsApplied: string[];
+    promptDigest: string;
+}
+export interface ActorTokenUsage {
+    input?: number;
+    output?: number;
+    total?: number;
+    costUsd?: number;
+}
+export interface ActorTrace {
+    schema: typeof ACTOR_TRACE_SCHEMA;
+    provider: string;
+    providerVersion?: string;
+    protocol: ActorProtocol;
+    lane: ActorLane;
+    persona: ActorPersonaRef;
+    redaction: {
+        status: "passed";
+        screenshots: "n/a" | "raw" | "blurred" | "ocr_scrubbed";
+        notes: string;
+    };
+    startedAt: string;
+    completedAt: string;
+    durationMs: number;
+    status: ActorStatus;
+    completionReason: ActorCompletionReason;
+    reason: string;
+    ids: {
+        sessionId?: string;
+        threadId?: string;
+        turnId?: string;
+        model?: string;
+    };
+    counts: Record<string, number>;
+    items: ActorTraceItem[];
+    tokenUsage?: ActorTokenUsage;
+    capabilities: ActorCapabilities;
+}
+export declare const CODEX_APP_SERVER_CAPABILITIES: ActorCapabilities;
+export declare const PI_AGENT_CORE_CAPABILITIES: ActorCapabilities;
+export declare const CLAUDE_AGENT_SDK_CAPABILITIES: ActorCapabilities;
+export declare const SCRIPTED_BROWSER_CAPABILITIES: ActorCapabilities;
+export declare const TERMINAL_AGENT_CAPABILITIES: ActorCapabilities;
+export declare function codexStatusToCompletionReason(status: CodexAppServerStatus): ActorCompletionReason;
+/**
+ * Map a Codex app-server run result into the provider-neutral ActorTrace. Pure
+ * and side-effect-free. The persona reference is supplied by the harness; until
+ * personas are load-bearing it is a minimal stub ({ id, traitsApplied: [],
+ * promptDigest }).
+ */
+export declare function codexResultToActorTrace(result: CodexAppServerRunResult, persona: ActorPersonaRef): ActorTrace;

package/dist/actor-contract.js

@@ -0,0 +1,286 @@
+import { redactText } from "./redaction.js";
+// The provider-neutral evidence schema. Codex item/* events, Claude
+// ToolUse/ToolResult blocks, pi tool_execution_* events, and computer-use
+// cycles all map onto this one ActorTrace. See docs/architecture/actor-contract.md.
+//
+// This PR ships the evidence schema + the first provider mapping (Codex) + the
+// registry. The full Actor.run(input: ActorRunInput) interface, RedactionHooks
+// injection, ApprovalPolicy, and ResolvedPersona are specified in the design doc
+// and land with the load-bearing-personas and adapter PRs; they are intentionally
+// not declared here yet to avoid unimplemented placeholder types.
+export const ACTOR_TRACE_SCHEMA = "humanish.actor-trace.v1";
+export const CODEX_APP_SERVER_CAPABILITIES = {
+    headless: true,
+    structuredTrace: true,
+    lanes: ["code"],
+    producesScreenshots: false,
+    byoModel: false,
+    preGrantableApprovals: true,
+    inProcessTools: false,
+    license: "open"
+};
+// pi-agent-core (@earendil-works/pi-agent-core): an embeddable, provider-agnostic
+// agent loop (MIT). byoModel: 15+ providers incl. local. No confirmed pre-grant
+// approval hook today, so preGrantableApprovals is false until verified.
+export const PI_AGENT_CORE_CAPABILITIES = {
+    headless: true,
+    structuredTrace: true,
+    lanes: ["code", "app"],
+    producesScreenshots: false,
+    byoModel: true,
+    preGrantableApprovals: false,
+    inProcessTools: true,
+    license: "open"
+};
+// Claude Agent SDK (@anthropic-ai/claude-agent-sdk): in-process query() stream
+// with typed SDK messages. Pre-grant approvals via permissionMode/allowedTools.
+// Anthropic-centric models (others via a proxy), so byoModel is false.
+export const CLAUDE_AGENT_SDK_CAPABILITIES = {
+    headless: true,
+    structuredTrace: true,
+    lanes: ["code", "app"],
+    producesScreenshots: false,
+    byoModel: false,
+    preGrantableApprovals: true,
+    inProcessTools: true,
+    license: "open"
+};
+// Scripted browser driver (src/scripted-browser-actor.ts): deterministic Playwright step
+// replay against a loopback app. byoModel is false because there is NO model — the committed
+// scenario steps are the whole behavior; tokenUsage on its traces records zeros by mechanism.
+export const SCRIPTED_BROWSER_CAPABILITIES = {
+    headless: true,
+    structuredTrace: true,
+    lanes: ["scripted-browser"],
+    producesScreenshots: true,
+    byoModel: false,
+    preGrantableApprovals: false,
+    inProcessTools: false,
+    license: "open" // playwright-core (Apache-2.0), already a lazy-imported production dependency
+};
+// Terminal agent (src/e2b-terminal-lab.ts): a real autonomous coding agent (Codex) discovering
+// and using a CLI/product from inside an E2B shell, capturing its non-interactive exec output as
+// a redacted event stream + normalized transcript. The "terminal" lane is the autonomous-agent
+// study lane (distinct from "code", the operator-machine Codex lanes). byoModel is false: the
+// agent runs its own model via the command-scoped runtime auth, not a humanish-supplied provider.
+// keyPlacement is "in-sandbox-command-scoped" — the load-bearing inversion of every existing
+// E2B route's external-key default (the agent is the keyed process and it runs INSIDE). DECLARED
+// here this slice; the engine enforcement of the command-scoped boundary lands in SLICE 2.
+export const TERMINAL_AGENT_CAPABILITIES = {
+    headless: true,
+    structuredTrace: true,
+    lanes: ["terminal"],
+    producesScreenshots: false,
+    byoModel: false,
+    preGrantableApprovals: false,
+    inProcessTools: false,
+    license: "open", // the Codex CLI is invoked as a subprocess inside the sandbox; no peer dep here
+    keyPlacement: "in-sandbox-command-scoped"
+};
+// Codex app-server reports four terminal statuses but no explicit completion
+// reason enum, so map status -> reason. App-server "blocked" is approval-driven
+// (an action was declined and the turn could not proceed). "goal_satisfied" and
+// "gave_up" are not reachable from Codex today; they arrive with persona-driven
+// scenario predicates and harness-enforced turn budgets in a later PR.
+export function codexStatusToCompletionReason(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 codexItemKind(type) {
+    switch (type) {
+        case "commandExecution":
+            return "command";
+        case "fileChange":
+            return "file_change";
+        case "mcpToolCall":
+        case "dynamicToolCall":
+            return "tool_call";
+        case "agentMessage":
+            return "message";
+        case "reasoning":
+            return "reasoning";
+        default: {
+            const lowered = type.toLowerCase();
+            if (lowered.includes("message"))
+                return "message";
+            if (lowered.includes("reason"))
+                return "reasoning";
+            if (lowered.includes("command"))
+                return "command";
+            if (lowered.includes("file"))
+                return "file_change";
+            if (lowered.includes("tool"))
+                return "tool_call";
+            if (lowered.includes("plan"))
+                return "plan";
+            return "notice";
+        }
+    }
+}
+function pickTokenUsage(raw) {
+    if (raw === undefined || raw === null || typeof raw !== "object") {
+        return undefined;
+    }
+    const record = raw;
+    const numberFrom = (keys) => {
+        for (const key of keys) {
+            const value = record[key];
+            if (typeof value === "number" && Number.isFinite(value)) {
+                return value;
+            }
+        }
+        return undefined;
+    };
+    const input = numberFrom(["input", "input_tokens", "inputTokens", "prompt_tokens"]);
+    const output = numberFrom(["output", "output_tokens", "outputTokens", "completion_tokens"]);
+    const total = numberFrom(["total", "total_tokens", "totalTokens"]);
+    const costUsd = numberFrom(["costUsd", "cost_usd", "cost"]);
+    const usage = {
+        ...(input === undefined ? {} : { input }),
+        ...(output === undefined ? {} : { output }),
+        ...(total === undefined ? {} : { total }),
+        ...(costUsd === undefined ? {} : { costUsd })
+    };
+    return Object.keys(usage).length > 0 ? usage : undefined;
+}
+// Flatten the Codex trace into provider-neutral items. The lifecycle rows in
+// trace.items only cover message/reasoning/command/file/tool; approvals, plans,
+// warnings, and errors live only in sibling arrays and are synthesized here so
+// no evidence is silently dropped.
+function codexTraceToActorItems(trace) {
+    const commandByItem = new Map(trace.commands.map((command) => [command.itemId, command]));
+    const toolByItem = new Map(trace.tools.map((tool) => [tool.itemId, tool]));
+    const messageByItem = new Map(trace.messages.map((message) => [message.itemId, message]));
+    const reasoningByItem = new Map(trace.reasoning.map((entry) => [entry.itemId, entry]));
+    const fileChangeByItem = new Map(trace.fileChanges.map((change) => [change.itemId, change]));
+    const items = trace.items.map((item) => {
+        const kind = codexItemKind(item.type);
+        const base = {
+            id: item.id,
+            kind,
+            lifecycle: item.lifecycle,
+            title: item.title,
+            ...(item.status === undefined ? {} : { status: item.status })
+        };
+        if (kind === "command") {
+            const command = commandByItem.get(item.id);
+            if (command) {
+                return {
+                    ...base,
+                    command: {
+                        ...(command.command === undefined ? {} : { text: command.command }),
+                        ...(command.cwd === undefined ? {} : { cwd: command.cwd }),
+                        ...(command.exitCode === undefined ? {} : { exitCode: command.exitCode }),
+                        ...(command.outputTail === undefined ? {} : { outputTail: command.outputTail })
+                    }
+                };
+            }
+        }
+        if (kind === "tool_call") {
+            const tool = toolByItem.get(item.id);
+            if (tool) {
+                return {
+                    ...base,
+                    tool: {
+                        ...(tool.server === undefined ? {} : { server: tool.server }),
+                        ...(tool.tool === undefined ? {} : { name: tool.tool })
+                    }
+                };
+            }
+        }
+        if (kind === "message") {
+            const message = messageByItem.get(item.id);
+            if (message) {
+                return { ...base, text: message.text };
+            }
+        }
+        if (kind === "reasoning") {
+            const reasoning = reasoningByItem.get(item.id);
+            if (reasoning) {
+                return { ...base, text: reasoning.text };
+            }
+        }
+        if (kind === "file_change") {
+            const change = fileChangeByItem.get(item.id);
+            if (change?.outputTail !== undefined) {
+                return { ...base, text: change.outputTail };
+            }
+        }
+        return base;
+    });
+    for (const approval of trace.approvals) {
+        items.push({
+            id: `approval-${String(approval.id)}`,
+            kind: "approval",
+            lifecycle: "completed",
+            status: approval.decision,
+            title: `${approval.method} (${approval.decision})`,
+            ...(approval.reason ? { text: approval.reason } : {})
+        });
+    }
+    trace.plans.forEach((plan, index) => {
+        items.push({
+            id: `plan-${index + 1}`,
+            kind: "plan",
+            lifecycle: "completed",
+            title: plan.explanation ?? "Plan update",
+            ...(plan.steps.length > 0 ? { text: plan.steps.join("\n") } : {})
+        });
+    });
+    [...trace.warnings, ...trace.errors].forEach((notice, index) => {
+        items.push({
+            id: `notice-${index + 1}`,
+            kind: "notice",
+            lifecycle: "completed",
+            title: notice.method,
+            ...(notice.message ? { text: notice.message } : {})
+        });
+    });
+    return items;
+}
+/**
+ * Map a Codex app-server run result into the provider-neutral ActorTrace. Pure
+ * and side-effect-free. The persona reference is supplied by the harness; until
+ * personas are load-bearing it is a minimal stub ({ id, traitsApplied: [],
+ * promptDigest }).
+ */
+export function codexResultToActorTrace(result, persona) {
+    const trace = result.trace;
+    const tokenUsage = pickTokenUsage(trace.tokenUsage);
+    return {
+        schema: ACTOR_TRACE_SCHEMA,
+        provider: "codex-app-server",
+        ...(trace.server.codexCliVersion === undefined ? {} : { providerVersion: trace.server.codexCliVersion }),
+        protocol: "json-rpc",
+        lane: "code",
+        persona,
+        redaction: { status: "passed", screenshots: "n/a", notes: trace.redaction.notes },
+        startedAt: trace.startedAt,
+        completedAt: trace.completedAt,
+        durationMs: trace.durationMs,
+        status: trace.status,
+        completionReason: codexStatusToCompletionReason(trace.status),
+        // result.reason is the raw reason; the codex trace redacts its own reason, so
+        // redact here too to keep the actor projection consistent (defense in depth).
+        reason: redactText(result.reason),
+        ids: {
+            ...(result.sessionId === undefined ? {} : { sessionId: result.sessionId }),
+            ...(result.threadId === undefined ? {} : { threadId: result.threadId }),
+            ...(result.turnId === undefined ? {} : { turnId: result.turnId }),
+            ...(result.model === undefined ? {} : { model: result.model })
+        },
+        counts: { ...trace.counts },
+        items: codexTraceToActorItems(trace),
+        ...(tokenUsage === undefined ? {} : { tokenUsage }),
+        capabilities: CODEX_APP_SERVER_CAPABILITIES
+    };
+}
+//# sourceMappingURL=actor-contract.js.map

package/dist/actor-contract.js.map

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

package/dist/actor-registry.d.ts

@@ -0,0 +1,73 @@
+import { type CodexAppServerRunOptions, type CodexAppServerRunResult } from "./codex-app-server.js";
+import { type ActorCapabilities, type ActorPersonaRef, type ActorTrace } from "./actor-contract.js";
+import { type TerminalAgentSessionOptions, type TerminalAgentSessionResult } from "./terminal-agent-actor.js";
+import { type PiSessionResult } from "./pi-agent-core.js";
+import { type ClaudeAgentSessionOptions, type ClaudeAgentSessionResult, type ClaudeSessionResult } from "./claude-agent-sdk.js";
+import { type CuaActorSessionOptions } from "./computer-use-actor.js";
+import type { CuaLoopResult } from "./computer-use.js";
+import { type ScriptedBrowserSessionOptions, type ScriptedBrowserSessionResult } from "./scripted-browser-actor.js";
+export type ActorId = "codex-app-server" | "pi-agent-core" | "claude-agent-sdk" | "openai-computer-use" | "scripted-browser" | "codex-exec";
+interface ActorDescriptorBase {
+    id: ActorId;
+    label: string;
+    capabilities: ActorCapabilities;
+}
+export interface CodexActorDescriptor extends ActorDescriptorBase {
+    id: "codex-app-server";
+    runSession(options: CodexAppServerRunOptions): Promise<CodexAppServerRunResult>;
+    toActorTrace(result: CodexAppServerRunResult, persona: ActorPersonaRef): ActorTrace;
+}
+export interface PiActorDescriptor extends ActorDescriptorBase {
+    id: "pi-agent-core";
+    toActorTrace(session: PiSessionResult, persona: ActorPersonaRef): ActorTrace;
+}
+export interface ClaudeActorDescriptor extends ActorDescriptorBase {
+    id: "claude-agent-sdk";
+    runSession(options: ClaudeAgentSessionOptions): Promise<ClaudeAgentSessionResult>;
+    toActorTrace(session: ClaudeSessionResult, persona: ActorPersonaRef): ActorTrace;
+}
+export interface CuaActorDescriptor extends ActorDescriptorBase {
+    id: "openai-computer-use";
+    runSession(options: CuaActorSessionOptions): Promise<CuaLoopResult>;
+}
+export interface ScriptedBrowserActorDescriptor extends ActorDescriptorBase {
+    id: "scripted-browser";
+    runSession(options: ScriptedBrowserSessionOptions): Promise<ScriptedBrowserSessionResult>;
+}
+export interface TerminalActorDescriptor extends ActorDescriptorBase {
+    id: "codex-exec";
+    runSession(options: TerminalAgentSessionOptions): Promise<TerminalAgentSessionResult>;
+}
+export type ActorDescriptor = CodexActorDescriptor | PiActorDescriptor | ClaudeActorDescriptor | CuaActorDescriptor | ScriptedBrowserActorDescriptor | TerminalActorDescriptor;
+/**
+ * REGISTRY CONTRACT: an actor whose capabilities include the "computer-use" lane is a
+ * CuaActorDescriptor — its runSession takes CuaActorSessionOptions and returns a CuaLoopResult.
+ * Any future computer-use provider (e.g. stagehand-cua) must keep that session signature; this
+ * guard is what lets the lab dispatch on capabilities rather than on hardcoded actor ids.
+ */
+export declare function isCuaActorDescriptor(descriptor: ActorDescriptor): descriptor is CuaActorDescriptor;
+/**
+ * REGISTRY CONTRACT (mirror of isCuaActorDescriptor): an actor whose capabilities include the
+ * "scripted-browser" lane IS a ScriptedBrowserActorDescriptor — runSession takes
+ * ScriptedBrowserSessionOptions and returns ScriptedBrowserSessionResult (trace fully formed,
+ * like the CUA shape — no separate toActorTrace). Any future scripted driver (e.g. a HAR
+ * replayer) must keep this signature; it is what lets the lab dispatch on capabilities, not ids.
+ */
+export declare function isScriptedBrowserActorDescriptor(descriptor: ActorDescriptor): descriptor is ScriptedBrowserActorDescriptor;
+/**
+ * REGISTRY CONTRACT (mirror of isCuaActorDescriptor / isScriptedBrowserActorDescriptor): an actor
+ * whose capabilities include the "terminal" lane IS a TerminalActorDescriptor — runSession takes
+ * TerminalAgentSessionOptions and returns TerminalAgentSessionResult (trace fully formed). This is
+ * the guard the terminal-product lab dispatches on (capabilities, not ids). Any future terminal
+ * agent (a non-Codex coding agent) must keep this signature AND declare keyPlacement honestly.
+ */
+export declare function isTerminalActorDescriptor(descriptor: ActorDescriptor): descriptor is TerminalActorDescriptor;
+export declare const actorRegistry: Record<ActorId, ActorDescriptor>;
+export declare function getActor(id: "codex-app-server"): CodexActorDescriptor;
+export declare function getActor(id: "pi-agent-core"): PiActorDescriptor;
+export declare function getActor(id: "claude-agent-sdk"): ClaudeActorDescriptor;
+export declare function getActor(id: "openai-computer-use"): CuaActorDescriptor;
+export declare function getActor(id: "scripted-browser"): ScriptedBrowserActorDescriptor;
+export declare function getActor(id: "codex-exec"): TerminalActorDescriptor;
+export declare function getActor(id: ActorId): ActorDescriptor;
+export {};

package/dist/actor-registry.js

@@ -0,0 +1,93 @@
+import { runCodexAppServerSession } from "./codex-app-server.js";
+import { CLAUDE_AGENT_SDK_CAPABILITIES, CODEX_APP_SERVER_CAPABILITIES, PI_AGENT_CORE_CAPABILITIES, SCRIPTED_BROWSER_CAPABILITIES, TERMINAL_AGENT_CAPABILITIES, codexResultToActorTrace } from "./actor-contract.js";
+import { runTerminalAgentSession } from "./terminal-agent-actor.js";
+import { piSessionToActorTrace } from "./pi-agent-core.js";
+import { claudeSessionToActorTrace, runClaudeAgentSession } from "./claude-agent-sdk.js";
+import { runCuaActorSession } from "./computer-use-actor.js";
+import { OPENAI_RESPONSES_CU_CAPABILITIES } from "./openai-responses-cu.js";
+import { runScriptedBrowserSession } from "./scripted-browser-actor.js";
+/**
+ * REGISTRY CONTRACT: an actor whose capabilities include the "computer-use" lane is a
+ * CuaActorDescriptor — its runSession takes CuaActorSessionOptions and returns a CuaLoopResult.
+ * Any future computer-use provider (e.g. stagehand-cua) must keep that session signature; this
+ * guard is what lets the lab dispatch on capabilities rather than on hardcoded actor ids.
+ */
+export function isCuaActorDescriptor(descriptor) {
+    return descriptor.capabilities.lanes.includes("computer-use");
+}
+/**
+ * REGISTRY CONTRACT (mirror of isCuaActorDescriptor): an actor whose capabilities include the
+ * "scripted-browser" lane IS a ScriptedBrowserActorDescriptor — runSession takes
+ * ScriptedBrowserSessionOptions and returns ScriptedBrowserSessionResult (trace fully formed,
+ * like the CUA shape — no separate toActorTrace). Any future scripted driver (e.g. a HAR
+ * replayer) must keep this signature; it is what lets the lab dispatch on capabilities, not ids.
+ */
+export function isScriptedBrowserActorDescriptor(descriptor) {
+    return descriptor.capabilities.lanes.includes("scripted-browser");
+}
+/**
+ * REGISTRY CONTRACT (mirror of isCuaActorDescriptor / isScriptedBrowserActorDescriptor): an actor
+ * whose capabilities include the "terminal" lane IS a TerminalActorDescriptor — runSession takes
+ * TerminalAgentSessionOptions and returns TerminalAgentSessionResult (trace fully formed). This is
+ * the guard the terminal-product lab dispatches on (capabilities, not ids). Any future terminal
+ * agent (a non-Codex coding agent) must keep this signature AND declare keyPlacement honestly.
+ */
+export function isTerminalActorDescriptor(descriptor) {
+    return descriptor.capabilities.lanes.includes("terminal");
+}
+export const actorRegistry = {
+    "codex-app-server": {
+        id: "codex-app-server",
+        label: "Codex App-Server",
+        capabilities: CODEX_APP_SERVER_CAPABILITIES,
+        runSession: runCodexAppServerSession,
+        toActorTrace: codexResultToActorTrace
+    },
+    "pi-agent-core": {
+        id: "pi-agent-core",
+        label: "pi Agent Core",
+        capabilities: PI_AGENT_CORE_CAPABILITIES,
+        toActorTrace: piSessionToActorTrace
+    },
+    "claude-agent-sdk": {
+        id: "claude-agent-sdk",
+        label: "Claude Agent SDK",
+        capabilities: CLAUDE_AGENT_SDK_CAPABILITIES,
+        runSession: runClaudeAgentSession,
+        toActorTrace: claudeSessionToActorTrace
+    },
+    // The ActorId names the actor slot (keeps the lane open for a future stagehand-cua provider);
+    // the trace's `provider` string stays "openai-responses-cu" (the concrete model adapter).
+    "openai-computer-use": {
+        id: "openai-computer-use",
+        label: "OpenAI Computer Use",
+        capabilities: OPENAI_RESPONSES_CU_CAPABILITIES,
+        runSession: runCuaActorSession
+    },
+    // Same naming convention: the ActorId names the slot; the trace's `provider` stays the
+    // concrete driver name "browser-persona" (matching the native
+    // humanish.browser-persona-trace.v1 evidence it already emits).
+    "scripted-browser": {
+        id: "scripted-browser",
+        label: "Scripted Browser (deterministic Playwright steps)",
+        capabilities: SCRIPTED_BROWSER_CAPABILITIES,
+        runSession: runScriptedBrowserSession
+    },
+    // The ActorId names the dispatch slot #154 asks for; the trace's `provider` stays the concrete
+    // agent name ("codex") in SLICE 2. keyPlacement "in-sandbox-command-scoped" rides on the
+    // capabilities const — the registry-declared placement the engine enforces in SLICE 2.
+    "codex-exec": {
+        id: "codex-exec",
+        label: "Codex Exec (autonomous terminal agent, in-sandbox)",
+        capabilities: TERMINAL_AGENT_CAPABILITIES,
+        runSession: runTerminalAgentSession
+    }
+};
+export function getActor(id) {
+    const actor = actorRegistry[id];
+    if (!actor) {
+        throw new Error(`Unknown actor: ${String(id)}`);
+    }
+    return actor;
+}
+//# sourceMappingURL=actor-registry.js.map

package/dist/actor-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor-registry.js","sourceRoot":"","sources":["../src/actor-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EAGzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC7B,0BAA0B,EAC1B,6BAA6B,EAC7B,2BAA2B,EAC3B,uBAAuB,EAIxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,uBAAuB,EAGxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAwB,MAAM,oBAAoB,CAAC;AACjF,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EAItB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAA+B,MAAM,yBAAyB,CAAC;AAE1F,OAAO,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EACL,yBAAyB,EAG1B,MAAM,6BAA6B,CAAC;AAqErC;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAA2B;IAC9D,OAAO,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC,CAAC,UAA2B;IAC1E,OAAO,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,UAA2B;IACnE,OAAO,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAqC;IAC7D,kBAAkB,EAAE;QAClB,EAAE,EAAE,kBAAkB;QACtB,KAAK,EAAE,kBAAkB;QACzB,YAAY,EAAE,6BAA6B;QAC3C,UAAU,EAAE,wBAAwB;QACpC,YAAY,EAAE,uBAAuB;KACtC;IACD,eAAe,EAAE;QACf,EAAE,EAAE,eAAe;QACnB,KAAK,EAAE,eAAe;QACtB,YAAY,EAAE,0BAA0B;QACxC,YAAY,EAAE,qBAAqB;KACpC;IACD,kBAAkB,EAAE;QAClB,EAAE,EAAE,kBAAkB;QACtB,KAAK,EAAE,kBAAkB;QACzB,YAAY,EAAE,6BAA6B;QAC3C,UAAU,EAAE,qBAAqB;QACjC,YAAY,EAAE,yBAAyB;KACxC;IACD,8FAA8F;IAC9F,0FAA0F;IAC1F,qBAAqB,EAAE;QACrB,EAAE,EAAE,qBAAqB;QACzB,KAAK,EAAE,qBAAqB;QAC5B,YAAY,EAAE,gCAAgC;QAC9C,UAAU,EAAE,kBAAkB;KAC/B;IACD,uFAAuF;IACvF,8DAA8D;IAC9D,gEAAgE;IAChE,kBAAkB,EAAE;QAClB,EAAE,EAAE,kBAAkB;QACtB,KAAK,EAAE,mDAAmD;QAC1D,YAAY,EAAE,6BAA6B;QAC3C,UAAU,EAAE,yBAAyB;KACtC;IACD,+FAA+F;IAC/F,yFAAyF;IACzF,uFAAuF;IACvF,YAAY,EAAE;QACZ,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,oDAAoD;QAC3D,YAAY,EAAE,2BAA2B;QACzC,UAAU,EAAE,uBAAuB;KACpC;CACF,CAAC;AAWF,MAAM,UAAU,QAAQ,CAAC,EAAW;IAClC,MAAM,KAAK,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,kBAAkB,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/adapter-extension.d.ts

@@ -0,0 +1,54 @@
+import type { RunAdapterArtifact, RunAdapterScore, RunBundle, RunFeedbackCandidate } from "./run.js";
+export type BrowserAdapterBackend = "cua" | "shared-world" | "concurrent-shared-world";
+/**
+ * Product-agnostic scoring context for browser/computer-use lanes. Product-specific
+ * evidence/rubrics stay in the adopter's repo; core provides the assembled bundle
+ * plus stable run identifiers and never learns product nouns.
+ */
+export interface BrowserLabScoringContext {
+    bundle: RunBundle;
+    /**
+     * Absolute path to the ignored run directory. Adapter hooks may write their
+     * own product/state proof files here, then return relative references through
+     * `deriveArtifacts`. This path is runtime-only and must never be persisted.
+     */
+    runDir: string;
+    labId: string;
+    runId: string;
+    actor: string;
+    backend: BrowserAdapterBackend;
+    dryRun: boolean;
+    laneCount: number;
+}
+export interface BrowserLabAdapterHooks {
+    /**
+     * Browser-route extension seam (#165): a thin adapter may score the assembled
+     * browser/shared-world evidence without forking core. The score is stored as
+     * namespaced `bundle.adapterScore`; product-specific component detail belongs
+     * in `data`, not in core enums or review text.
+     */
+    score?: (ctx: BrowserLabScoringContext) => RunAdapterScore | Promise<RunAdapterScore>;
+    /**
+     * Companion seam for public-safe, adapter-namespaced feedback candidates.
+     * Malformed candidates are dropped before bundle persistence so core remains
+     * verifiable even when an adapter misbehaves.
+     */
+    deriveFeedback?: (ctx: BrowserLabScoringContext) => RunFeedbackCandidate[] | Promise<RunFeedbackCandidate[]>;
+    /**
+     * Optional product/state proof artifact references. The adapter writes files
+     * under `ctx.runDir` and returns local relative paths. Core stores only the
+     * namespaced references and `verify` fails closed if referenced files are
+     * missing or nonlocal.
+     */
+    deriveArtifacts?: (ctx: BrowserLabScoringContext) => RunAdapterArtifact[] | Promise<RunAdapterArtifact[]>;
+}
+export declare function applyBrowserAdapterHooks(args: {
+    hooks: BrowserLabAdapterHooks | undefined;
+    context: BrowserLabScoringContext;
+    bundle: RunBundle;
+    sanitize: (text: string) => string;
+    warnings: string[];
+    hookLabel: string;
+}): Promise<void>;
+export declare function adapterScoreFailureMessage(bundle: RunBundle): string | undefined;
+export declare function applyAdapterScoreFailureToReview(bundle: RunBundle): string | undefined;