humanish 0.104.3 → 0.106.0

package/dist/terminal-runtime-auth.js

@@ -1,24 +0,0 @@
-export const OPENAI_EGRESS_HOST = "api.openai.com";
-/** E2B envd installs the sandbox-specific proxy CA into this system bundle before routing. */
-export const E2B_SYSTEM_CA_BUNDLE = "/etc/ssl/certs/ca-certificates.crt";
-/** An inert nonsecret value satisfies Codex exec's auth prerequisite. E2B replaces the header. */
-export const OPENAI_EGRESS_PLACEHOLDER = "humanish-egress-auth-placeholder";
-/**
- * Keep the runtime key in the host-side E2B request, outside sandbox env/files. The installed
- * E2B SDK declares that transform headers override existing request headers. This adds no routing
- * restrictions: every sandbox process can still spend via the provider proxy. Never log the
- * returned options. An adopter's existing exact-host rule must not be silently overwritten.
- */
-export function buildOpenAiEgressNetwork(keyValue, existing) {
-    if (Object.keys(existing?.rules ?? {}).some((host) => host.toLowerCase().replace(/\.$/, "") === OPENAI_EGRESS_HOST)) {
-        throw new Error("openai-egress conflicts with an existing api.openai.com network rule; refusing to overwrite it.");
-    }
-    return {
-        ...existing,
-        rules: {
-            ...existing?.rules,
-            [OPENAI_EGRESS_HOST]: [{ transform: { headers: { Authorization: `Bearer ${keyValue}` } } }]
-        }
-    };
-}
-//# sourceMappingURL=terminal-runtime-auth.js.map

package/dist/terminal-runtime-auth.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"terminal-runtime-auth.js","sourceRoot":"","sources":["../src/terminal-runtime-auth.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AACnD,8FAA8F;AAC9F,MAAM,CAAC,MAAM,oBAAoB,GAAG,oCAAoC,CAAC;AACzE,kGAAkG;AAClG,MAAM,CAAC,MAAM,yBAAyB,GAAG,kCAAkC,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAAgB,EAChB,QAA4B;IAE5B,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,kBAAkB,CAAC,EAAE,CAAC;QACpH,MAAM,IAAI,KAAK,CAAC,iGAAiG,CAAC,CAAC;IACrH,CAAC;IACD,OAAO;QACL,GAAG,QAAQ;QACX,KAAK,EAAE;YACL,GAAG,QAAQ,EAAE,KAAK;YAClB,CAAC,kBAAkB,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC;SAC5F;KACF,CAAC;AACJ,CAAC"}

package/dist/terminal-runtime.d.ts

@@ -1,16 +0,0 @@
-import type { ActorRuntimeProvenance } from "./actor-contract.js";
-import type { ReasoningEffort } from "./reasoning-effort.js";
-export declare const TERMINAL_RUNTIME_PACKAGE = "@openai/codex";
-export declare const TERMINAL_RUNTIME_VERSION_TIMEOUT_MS = 60000;
-/** Exact semver only: no registry tags, ranges, URLs, or shell syntax. */
-export declare function isExactRuntimeVersion(value: unknown): value is string;
-/** Captured Codex CLI output: `codex-cli 0.153.3\n`. Other shapes fail closed. */
-export declare function parseTerminalRuntimeVersion(stdout: string): string | undefined;
-export declare function shellQuote(value: string): string;
-export declare function buildRuntimeVersionCommand(requestedVersion?: string): string;
-export declare function buildRuntimeExecPrefix(version: string, model?: string, reasoningEffort?: ReasoningEffort): string;
-export declare function declaredRuntimeProvenance(args: {
-    version?: string;
-    model?: string;
-    reasoningEffort?: ReasoningEffort;
-}): ActorRuntimeProvenance;

package/dist/terminal-runtime.js

@@ -1,42 +0,0 @@
-export const TERMINAL_RUNTIME_PACKAGE = "@openai/codex";
-export const TERMINAL_RUNTIME_VERSION_TIMEOUT_MS = 60_000;
-/** Exact semver only: no registry tags, ranges, URLs, or shell syntax. */
-export function isExactRuntimeVersion(value) {
-    if (typeof value !== "string" || value.length > 120)
-        return false;
-    const match = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$/.exec(value);
-    return match !== null && (match[4]?.split(".").every((part) => !/^\d+$/.test(part) || part === "0" || !part.startsWith("0")) ?? true);
-}
-/** Captured Codex CLI output: `codex-cli 0.153.3\n`. Other shapes fail closed. */
-export function parseTerminalRuntimeVersion(stdout) {
-    const match = /^codex-cli ([^\s]+)$/.exec(stdout.trim());
-    return match && isExactRuntimeVersion(match[1]) ? match[1] : undefined;
-}
-export function shellQuote(value) {
-    return `'${value.replace(/'/g, "'\\''")}'`;
-}
-export function buildRuntimeVersionCommand(requestedVersion) {
-    if (requestedVersion !== undefined && !isExactRuntimeVersion(requestedVersion))
-        throw new Error("Invalid exact Codex runtime version.");
-    return `npm_config_update_notifier=false npx -y ${TERMINAL_RUNTIME_PACKAGE}@${requestedVersion ?? "latest"} --version`;
-}
-export function buildRuntimeExecPrefix(version, model, reasoningEffort) {
-    if (!isExactRuntimeVersion(version))
-        throw new Error("Codex execution requires a verified exact runtime version.");
-    return `npm_config_update_notifier=false npx -y ${TERMINAL_RUNTIME_PACKAGE}@${version} exec`
-        + (model === undefined ? "" : ` --model ${shellQuote(model)}`)
-        + (reasoningEffort === undefined ? "" : ` -c ${shellQuote(`model_reasoning_effort=${JSON.stringify(reasoningEffort)}`)}`);
-}
-export function declaredRuntimeProvenance(args) {
-    return {
-        schema: "humanish.actor-runtime.v1",
-        package: TERMINAL_RUNTIME_PACKAGE,
-        requestedVersion: args.version ?? "latest",
-        versionStatus: "unobserved",
-        ...(args.model === undefined ? {} : { requestedModel: args.model }),
-        modelStatus: args.model === undefined ? "runtime_default_unobserved" : "declared",
-        ...(args.reasoningEffort === undefined ? {} : { requestedReasoningEffort: args.reasoningEffort }),
-        usageGranularity: "runtime_turn"
-    };
-}
-//# sourceMappingURL=terminal-runtime.js.map

package/dist/terminal-runtime.js.map

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

package/dist/terminal-token-usage.d.ts

@@ -1,15 +0,0 @@
-import type { ActorTokenUsage } from "./actor-contract.js";
-/**
- * Accumulate runtime-turn usage from a captured `codex exec --json` stream. A Codex turn may
- * include multiple provider requests; these records cannot establish per-request pricing tiers.
- *
- * Returns undefined when the stream carried no usage record at all, which is the honest "no
- * signal" case and must stay distinguishable from a measured zero. Per-turn records are preserved
- * in `turns` because long-context pricing can only be computed from per-request sizes
- * (src/pricing.ts), and totals cannot say which requests crossed a threshold.
- */
-export declare function parseTerminalTokenUsage(transcript: string): ActorTokenUsage | undefined;
-/** Human-readable token statement for the cost ledger and the no-spend proof. Reports what was
- *  counted and says plainly that it is unpriced, so a reader never reads "no charge recorded" as
- *  "nothing was consumed". */
-export declare function describeTokenUsage(usage: ActorTokenUsage): string;

package/dist/terminal-token-usage.js

@@ -1,94 +0,0 @@
-// Provider token accounting for the terminal lane (#531).
-//
-// THE GAP THIS CLOSES. A live terminal run reported `cost.lines.provider = null` with source
-// "unmeasured", and the no-spend proof then read `satisfied: true` for `maxUsd: 0` on a run that
-// had demonstrably consumed hundreds of thousands of provider tokens. The statement was honest
-// (it listed provider as unmeasured) but it conflated two very different states: having no signal
-// at all, and knowing exactly how many tokens were spent while lacking a rate to price them.
-//
-// The counts were already in the bundle. `codex exec --json` emits one usage record per turn:
-//   {"type":"turn.completed","usage":{"input_tokens":201536,"cached_input_tokens":170558,
-//    "cache_write_input_tokens":30951,"output_tokens":2283,"reasoning_output_tokens":902}}
-//
-// So the lane can record a MEASURED token fact even when it cannot record a priced one. Rates stay
-// out of this module deliberately: pricing lives in src/pricing.ts, and the terminal lane has no
-// real model id to price against (it records `model: "codex"`), so the honest output is
-// tokens-known-rate-unknown rather than a guessed dollar figure.
-// Bounded to a single line on purpose. `[^}]*` would run past a TRUNCATED record's missing brace
-// and swallow the next, valid record's body, silently dropping a real turn from the count.
-const USAGE_RE = /"type"\s*:\s*"turn\.completed"\s*,\s*"usage"\s*:\s*(\{[^}\n]*\})/g;
-function num(value) {
-    return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : undefined;
-}
-/**
- * Accumulate runtime-turn usage from a captured `codex exec --json` stream. A Codex turn may
- * include multiple provider requests; these records cannot establish per-request pricing tiers.
- *
- * Returns undefined when the stream carried no usage record at all, which is the honest "no
- * signal" case and must stay distinguishable from a measured zero. Per-turn records are preserved
- * in `turns` because long-context pricing can only be computed from per-request sizes
- * (src/pricing.ts), and totals cannot say which requests crossed a threshold.
- */
-export function parseTerminalTokenUsage(transcript) {
-    const turns = [];
-    for (const match of transcript.matchAll(USAGE_RE)) {
-        const body = match[1];
-        if (body === undefined)
-            continue;
-        let raw;
-        try {
-            raw = JSON.parse(body);
-        }
-        catch {
-            continue; // A truncated or interleaved record is skipped rather than guessed at.
-        }
-        const input = num(raw.input_tokens);
-        const output = num(raw.output_tokens);
-        const cachedInput = num(raw.cached_input_tokens);
-        const cacheWriteInput = num(raw.cache_write_input_tokens);
-        if (input === undefined && output === undefined)
-            continue;
-        turns.push({
-            ...(input === undefined ? {} : { input }),
-            ...(output === undefined ? {} : { output }),
-            ...(cachedInput === undefined ? {} : { cachedInput }),
-            ...(cacheWriteInput === undefined ? {} : { cacheWriteInput })
-        });
-    }
-    if (turns.length === 0)
-        return undefined;
-    const sum = (field) => {
-        const present = turns.filter((t) => t[field] !== undefined);
-        if (present.length === 0)
-            return undefined;
-        return present.reduce((acc, t) => acc + (t[field] ?? 0), 0);
-    };
-    const input = sum("input");
-    const output = sum("output");
-    const cachedInput = sum("cachedInput");
-    const cacheWriteInput = sum("cacheWriteInput");
-    return {
-        ...(input === undefined ? {} : { input }),
-        ...(output === undefined ? {} : { output }),
-        ...(cachedInput === undefined ? {} : { cachedInput }),
-        ...(cacheWriteInput === undefined ? {} : { cacheWriteInput }),
-        ...(input === undefined && output === undefined ? {} : { total: (input ?? 0) + (output ?? 0) }),
-        turns
-    };
-}
-/** Human-readable token statement for the cost ledger and the no-spend proof. Reports what was
- *  counted and says plainly that it is unpriced, so a reader never reads "no charge recorded" as
- *  "nothing was consumed". */
-export function describeTokenUsage(usage) {
-    const parts = [];
-    if (usage.input !== undefined)
-        parts.push(`${usage.input.toLocaleString("en-US")} input`);
-    if (usage.cachedInput !== undefined) {
-        parts.push(`${usage.cachedInput.toLocaleString("en-US")} of them cached`);
-    }
-    if (usage.output !== undefined)
-        parts.push(`${usage.output.toLocaleString("en-US")} output`);
-    const turns = usage.turns?.length ?? 0;
-    return `${parts.join(", ")} tokens over ${turns} Codex turn${turns === 1 ? "" : "s"}`;
-}
-//# sourceMappingURL=terminal-token-usage.js.map

package/dist/terminal-token-usage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"terminal-token-usage.js","sourceRoot":"","sources":["../src/terminal-token-usage.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,EAAE;AACF,6FAA6F;AAC7F,iGAAiG;AACjG,+FAA+F;AAC/F,kGAAkG;AAClG,6FAA6F;AAC7F,EAAE;AACF,8FAA8F;AAC9F,0FAA0F;AAC1F,2FAA2F;AAC3F,EAAE;AACF,mGAAmG;AACnG,iGAAiG;AACjG,wFAAwF;AACxF,iEAAiE;AAcjE,iGAAiG;AACjG,2FAA2F;AAC3F,MAAM,QAAQ,GAAG,mEAAmE,CAAC;AAErF,SAAS,GAAG,CAAC,KAAc;IACzB,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/F,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAAkB;IACxD,MAAM,KAAK,GAA0C,EAAE,CAAC;IACxD,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,IAAI,KAAK,SAAS;YAAE,SAAS;QACjC,IAAI,GAAkB,CAAC;QACvB,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,CAAC,uEAAuE;QACnF,CAAC;QACD,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACtC,MAAM,WAAW,GAAG,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QACjD,MAAM,eAAe,GAAG,GAAG,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QAC1D,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;YAAE,SAAS;QAC1D,KAAK,CAAC,IAAI,CAAC;YACT,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;YACzC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;YAC3C,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;YACrD,GAAG,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAEzC,MAAM,GAAG,GAAG,CAAC,KAA6D,EAAsB,EAAE;QAChG,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAAC;QAC5D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3C,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9D,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7B,MAAM,WAAW,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC;IACvC,MAAM,eAAe,GAAG,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC/C,OAAO;QACL,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;QACzC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3C,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;QACrD,GAAG,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC;QAC7D,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC;QAC/F,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;8BAE8B;AAC9B,MAAM,UAAU,kBAAkB,CAAC,KAAsB;IACvD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1F,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7F,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC;IACvC,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,KAAK,cAAc,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AACxF,CAAC"}

package/dist/tui-actions.d.ts

@@ -1,39 +0,0 @@
-import { openTarget } from "./observer.js";
-export declare const TUI_ACTION_SCHEMA = "humanish.tui-action.v1";
-export interface TuiActionResult {
-    schema: typeof TUI_ACTION_SCHEMA;
-    ok: boolean;
-    /** What to tell the operator. Always set: an action that appears to do nothing is a bug. */
-    message: string;
-}
-/** A TUI owns one evidence server, shared by its open browser tabs and closed when it exits. */
-export interface TuiObserverSession {
-    open(cwd: string, observerPath: string): Promise<TuiActionResult>;
-    close(): Promise<void>;
-}
-/**
- * The library server projects the latest contained bundle on each browser poll. It can follow
- * captures written by another process without starting a study or recovering desktop credentials.
- * Keeping it in this process avoids detached viewers accumulating each time Open Observer is used.
- */
-export declare function createTuiObserverSession(cwdInput: string, options?: {
-    openTarget?: typeof openTarget;
-}): TuiObserverSession;
-/**
- * Stop a run that is still going.
- *
- * The counterpart to starting one: a study that is going nowhere costs money every turn, and until
- * now the only way to end it was to find the pid yourself.
- *
- * It signals the PROCESS GROUP, not the process. A run is spawned detached — its own group — and it
- * has children: the CLI, and whatever it spawned to reach the sandbox. Signalling only the parent
- * leaves those orphaned and still working.
- *
- * SIGTERM, never SIGKILL: the run's own handlers get the chance to finalize its record and release
- * what it holds. A killed run leaves a `running` record to go stale, which reads as interrupted —
- * true, but strictly less informative than a run that was told to stop.
- *
- * This stops the PROCESS. Sandboxes it created are a separate resource with their own receipts, and
- * `Reclaim` is what stops those — the run screen offers it as soon as this succeeds.
- */
-export declare function stopRun(cwd: string, runId: string, intent?: "run" | "analysis"): Promise<TuiActionResult>;

package/dist/tui-actions.js

@@ -1,178 +0,0 @@
-import { requestAutomaticStudyAnalysisCancellation } from "./automatic-study-analysis.js";
-// The two things a run card can DO (#455 rev 8).
-//
-// The mock's run screen is an outcome CARD with actions, not a field list, and an action that does
-// nothing is worse than no action — so this ships the two that are genuinely implementable today
-// and nothing else. `Share…` waits for the export contract (#471) rather than appearing as a
-// control that fails.
-import { readFile } from "node:fs/promises";
-import path from "node:path";
-import { RUN_STATUS_FILE, isRunStatusRecord } from "./run-status.js";
-import { resolveRunPath } from "./run.js";
-import { bindExistingRunArtifactPaths, isSafeRunIdSegment } from "./run-paths.js";
-import { openTarget } from "./observer.js";
-import { serveObserverLibrary } from "./observer-serve.js";
-export const TUI_ACTION_SCHEMA = "humanish.tui-action.v1";
-/**
- * The library server projects the latest contained bundle on each browser poll. It can follow
- * captures written by another process without starting a study or recovering desktop credentials.
- * Keeping it in this process avoids detached viewers accumulating each time Open Observer is used.
- */
-export function createTuiObserverSession(cwdInput, options = {}) {
-    const cwd = path.resolve(cwdInput);
-    const open = options.openTarget ?? openTarget;
-    let serverPromise;
-    let closed = false;
-    let closePromise;
-    const result = (ok, message) => ({ schema: TUI_ACTION_SCHEMA, ok, message });
-    return {
-        async open(targetCwd, observerPath) {
-            if (closed)
-                return result(false, "this terminal session has closed — reopen humanish tui to view the run");
-            if (path.resolve(targetCwd) !== cwd)
-                return result(false, "Observer can only open runs from this terminal session's project");
-            // The capability takes the run-card path, not an arbitrary file, URL, or second project.
-            // Validate the exact shape before using its id, then enforce the existing physical storage
-            // boundary (including descendant symlinks). An index.html need not exist during an active
-            // run: the HTTP server renders it from the contained run.json or observer-data.json.
-            const relative = path.relative(cwd, path.resolve(cwd, observerPath));
-            const segments = relative.split(path.sep);
-            const runId = segments[2];
-            if (segments.length !== 5 || segments[0] !== ".humanish" || segments[1] !== "runs"
-                || !runId || !isSafeRunIdSegment(runId) || segments[3] !== "observer" || segments[4] !== "index.html") {
-                return result(false, "Observer requires a run under this project's .humanish/runs directory");
-            }
-            try {
-                await bindExistingRunArtifactPaths(cwd, runId);
-            }
-            catch {
-                return result(false, "this run's evidence directory is missing or unsafe to open");
-            }
-            if (closed)
-                return result(false, "this terminal session has closed — reopen humanish tui to view the run");
-            try {
-                // Share the pending start too: two quick selections must not create two listeners.
-                serverPromise ??= serveObserverLibrary(cwd, {
-                    port: 0, safe: false, expose: false, edgeAuthed: false
-                }).then((started) => {
-                    if (!started.ok)
-                        throw new Error(started.error.message);
-                    return started.server;
-                }).catch((error) => {
-                    serverPromise = undefined;
-                    throw error;
-                });
-                const server = await serverPromise;
-                if (closed)
-                    return result(false, "this terminal session has closed — reopen humanish tui to view the run");
-                const url = new URL(`_humanish/runs/${encodeURIComponent(runId)}/observer/index.html`, server.url).href;
-                const opened = open(url);
-                return result(true, `${url} — follows saved captures; keep this TUI open.${opened.warning ? ` ${opened.warning}` : " If no browser appeared, open this URL on this machine or forward its port over SSH."}`);
-            }
-            catch {
-                return result(false, "Observer could not start — try humanish observe --run with this run's id in another terminal");
-            }
-        },
-        close() {
-            closed = true;
-            closePromise ??= (async () => {
-                // A close racing startup still awaits and releases the listener it owns.
-                const server = await serverPromise?.catch(() => undefined);
-                await server?.close();
-            })();
-            return closePromise;
-        }
-    };
-}
-/**
- * Stop a run that is still going.
- *
- * The counterpart to starting one: a study that is going nowhere costs money every turn, and until
- * now the only way to end it was to find the pid yourself.
- *
- * It signals the PROCESS GROUP, not the process. A run is spawned detached — its own group — and it
- * has children: the CLI, and whatever it spawned to reach the sandbox. Signalling only the parent
- * leaves those orphaned and still working.
- *
- * SIGTERM, never SIGKILL: the run's own handlers get the chance to finalize its record and release
- * what it holds. A killed run leaves a `running` record to go stale, which reads as interrupted —
- * true, but strictly less informative than a run that was told to stop.
- *
- * This stops the PROCESS. Sandboxes it created are a separate resource with their own receipts, and
- * `Reclaim` is what stops those — the run screen offers it as soon as this succeeds.
- */
-export async function stopRun(cwd, runId, intent = "run") {
-    // The selected action carries its authority. Never infer permission to signal a process from
-    // mutable status metadata after the operator asked only to cancel analysis.
-    if (intent === "analysis") {
-        const analysis = await requestAutomaticStudyAnalysisCancellation(cwd, runId);
-        return { schema: TUI_ACTION_SCHEMA, ok: analysis.requested, message: analysis.requested
-                ? "asked analysis to cancel; no participant process was signalled"
-                : "analysis is not available for cancellation; no participant process was signalled" };
-    }
-    if (intent !== "run")
-        return { schema: TUI_ACTION_SCHEMA, ok: false, message: "unknown stop action" };
-    const runPaths = await resolveRunPath(path.resolve(cwd), runId).catch(() => null);
-    if (runPaths === null) {
-        return { schema: TUI_ACTION_SCHEMA, ok: false, message: `no run directory for ${runId}` };
-    }
-    let record;
-    try {
-        record = JSON.parse(await readFile(path.join(runPaths.absoluteRunRoot, RUN_STATUS_FILE), "utf8"));
-    }
-    catch {
-        return {
-            schema: TUI_ACTION_SCHEMA,
-            ok: false,
-            message: "this run has no status record, so there is no pid to stop — it predates the contract or never started"
-        };
-    }
-    if (!isRunStatusRecord(record)) {
-        return { schema: TUI_ACTION_SCHEMA, ok: false, message: "this run's status record is unreadable" };
-    }
-    if (record.state === "finished") {
-        const analysis = await requestAutomaticStudyAnalysisCancellation(cwd, runId);
-        if (analysis.requested)
-            return { schema: TUI_ACTION_SCHEMA, ok: true, message: "asked analysis to cancel; the participant recording is already finished" };
-        return { schema: TUI_ACTION_SCHEMA, ok: false, message: "this run already finished" };
-    }
-    const pid = record.pid;
-    if (typeof pid !== "number" || !Number.isInteger(pid) || pid <= 1) {
-        // pid 1 and below are never a run of ours, and signalling them would be catastrophic.
-        return { schema: TUI_ACTION_SCHEMA, ok: false, message: "this run recorded no usable pid" };
-    }
-    // Is it actually still there? A pid whose process is already gone means the run died without
-    // finalizing — nothing to stop, and the record will read as interrupted on its own.
-    try {
-        process.kill(pid, 0);
-    }
-    catch {
-        return {
-            schema: TUI_ACTION_SCHEMA,
-            ok: false,
-            message: `nothing is running under pid ${pid} — it has already stopped, and its record will read as interrupted`
-        };
-    }
-    try {
-        // Negative pid = the whole process group, which is why the run was spawned detached.
-        process.kill(-pid, "SIGTERM");
-    }
-    catch {
-        try {
-            process.kill(pid, "SIGTERM");
-        }
-        catch (cause) {
-            return {
-                schema: TUI_ACTION_SCHEMA,
-                ok: false,
-                message: `could not stop it: ${cause instanceof Error ? cause.message : String(cause)}`
-            };
-        }
-    }
-    return {
-        schema: TUI_ACTION_SCHEMA,
-        ok: true,
-        message: "asked the run to stop — its sandboxes are separate, so Reclaim them once it reports interrupted"
-    };
-}
-//# sourceMappingURL=tui-actions.js.map

package/dist/tui-actions.js.map

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

package/dist/tui-contract.d.ts

@@ -1,141 +0,0 @@
-import type { LabListResult } from "./labs.js";
-import type { LabSummary, ReadLabSummaryOptions } from "./lab-summary.js";
-import type { RunDetail } from "./run-detail.js";
-import type { ReclaimResult } from "./reclaim.js";
-import type { TuiActionResult } from "./tui-actions.js";
-import type { TuiProjectState } from "./tui-project.js";
-import type { ReadRunIndexOptions, RunIndexResult } from "./run-index.js";
-import type { LaunchRunOptions, LaunchRunResult } from "./tui-launch.js";
-import type { CommsSetupResult, CommsSetupStatus } from "./comms-connections.js";
-import type { CommsCheckResult, CommsConfigureResult } from "./comms-setup.js";
-import type { CommsRecoveryEntry } from "./comms-receiving.js";
-/** The humanish version string shown in the frame, so a screenshot in a bug report is datable. */
-export interface TuiVersionInfo {
-    cli: string;
-}
-/**
- * What the surface may do to the project. Deliberately a small, explicit list rather than a handle
- * to the whole library: the set of verbs a stakeholder surface can perform should be readable in
- * one place, and anything absent here is something the TUI simply cannot do.
- */
-export interface TuiCapabilities {
-    /** Optional for older embedders. Credentials are never returned to the view. */
-    comms?: {
-        read(): Promise<CommsSetupStatus>;
-        save(): Promise<CommsSetupResult>;
-        check?(): Promise<CommsCheckResult>;
-        labs?(): Promise<{
-            title: string;
-            path: string;
-        }[]>;
-        configure?(lab: string, apply: boolean, planToken?: string): Promise<CommsConfigureResult>;
-        recovery?(): Promise<CommsRecoveryEntry[]>;
-        recover?(runId: string, connectionName: string): Promise<{
-            ok: boolean;
-            message: string;
-        }>;
-    };
-    /** Read every run in the project, cheapest source first. */
-    readRunIndex(cwd: string, options?: ReadRunIndexOptions): Promise<RunIndexResult>;
-    /**
-     * The labs DECLARED in this project. Listed separately from run history because neither side is
-     * the whole truth: a fresh project has manifests and no runs, and a long-lived one has runs from
-     * manifests since renamed or deleted.
-     */
-    listLabs(cwd: string): Promise<LabListResult>;
-    /**
-     * Start a run and return once it is running. The run is DETACHED: it outlives this surface, so
-     * quitting the TUI — or losing the connection it runs over — does not kill a study that costs
-     * real money. The surface then follows it through `status.json` like any other reader.
-     */
-    startRun(options: Omit<LaunchRunOptions, "spawn" | "cliPath" | "now">): Promise<LaunchRunResult>;
-    /** The tail of a launch log: the only account of a run that died before writing evidence. */
-    readLaunchLog(logPath: string): Promise<string>;
-    /**
-     * Who is in ONE run and what they are thinking. Opens that run's bundle, which the index
-     * deliberately does not — affordable because it is asked only for the run being watched.
-     * `null` when the run has not written a bundle yet.
-     */
-    readRunDetail(cwd: string, runId: string): Promise<RunDetail | null>;
-    /**
-     * What a lab IS — subject, participants, model, spend caps, and whether the keys a live run needs
-     * resolve right now. Read for the lab being looked at, because it is what someone reads before
-     * deciding to spend money.
-     */
-    readLabSummary(cwd: string, lab: string, options?: ReadLabSummaryOptions): Promise<LabSummary | null>;
-    /** Whether this directory is a humanish project — an empty project and a wrong directory are
-     *  different problems and must not share a screen. */
-    readProjectState(cwd: string): TuiProjectState;
-    /** Open the selected run in the session-owned local evidence server; closes when the TUI exits. */
-    openObserver(cwd: string, observerPath: string): Promise<TuiActionResult>;
-    /** Stop the sandboxes an interrupted run left behind, keeping its evidence. */
-    reclaimRun(cwd: string, runId: string): Promise<ReclaimResult>;
-    /** End a run that is still going. "analysis" is marker-only regardless of the current status;
-     * it MUST NOT probe or signal a process. The default "run" intent stops the participant process. */
-    stopRun(cwd: string, runId: string, intent?: "run" | "analysis"): Promise<TuiActionResult>;
-    /**
-     * Set this directory up as a humanish project. The surface's only WRITING action outside of
-     * starting runs — offered because "cd somewhere else and run init" is a dead end shown to
-     * exactly the person who has just arrived (#505).
-     */
-    initProject(cwd: string): Promise<TuiActionResult>;
-}
-export interface TuiOptions {
-    /** Return to setup after the host-owned hidden prompt has finished. */
-    initialScreen?: "connections";
-    connectionNotice?: string;
-    /** The project the surface is reading. Already resolved by the CLI. */
-    cwd: string;
-    version: TuiVersionInfo;
-    capabilities: TuiCapabilities;
-    /**
-     * Terminal streams, injected so a test can drive the surface without a real TTY. The CLI passes
-     * the real ones; both are known to be TTYs by the time this is called, because the command
-     * refuses to start otherwise.
-     */
-    stdin: NodeJS.ReadStream;
-    stdout: NodeJS.WriteStream;
-    /** Test seam: render one frame and resolve, instead of waiting for the operator to quit. */
-    exitAfterFirstFrame?: boolean;
-}
-/**
- * Start the surface. Resolves with the process exit code when the operator quits — the TUI owns the
- * screen until then, so the CLI must not write to stdout while this is pending.
- */
-export type TuiHandoff = {
-    action: "agentmail-key";
-};
-export type StartTui = (options: TuiOptions) => Promise<number | TuiHandoff>;
-/** The shape `dist/tui-app.js` exports. Asserted at the load boundary in program.ts. */
-export interface TuiModule {
-    startTui: StartTui;
-}
-/** Node version the Ink runtime requires (ink@7 declares `engines.node >= 22`). */
-export declare const TUI_MIN_NODE_MAJOR = 22;
-/**
- * Whether this runtime can host the surface. Kept here, beside the reason, so the CLI's refusal and
- * `doctor`'s readiness row can never disagree about the answer.
- */
-export declare function nodeSupportsTui(versionString?: string): boolean;
-/**
- * Where the bundle sits relative to the compiled CLI. Shared so the command that loads it and the
- * readiness row that reports it can never look in different places.
- */
-export declare function tuiBundleUrl(baseUrl: string): URL;
-/**
- * What `doctor` says about the stakeholder surface — a pure function of the machine's state and,
- * crucially, of WHO IS READING.
- *
- * A real first-contact study (labs/first-contact.yaml) is why the reader matters. An autonomous
- * agent evaluating humanish read "`humanish tui` is available in an interactive terminal",
- * correctly concluded it was not in one, and dropped it — then wrote a report FOR A HUMAN that
- * never mentioned the human surface at all. Discovery worked and handoff did not. A capability
- * described to a reader who cannot use it has to be phrased as something to PASS ON, or it reads
- * as "not for you" and dies in the transcript.
- */
-export declare function terminalSurfaceMessage(state: {
-    supported: boolean;
-    bundlePresent: boolean;
-    interactive: boolean;
-    nodeVersion: string;
-}): string;

package/dist/tui-contract.js

@@ -1,54 +0,0 @@
-// The boundary between the CLI and the terminal UI (#455).
-//
-// `humanish tui` loads a PRE-BUILT bundle (dist/tui-app.js) that contains Ink, React and the
-// screens — and nothing else. Everything the surface needs to KNOW is passed across this interface
-// by the CLI, which imports it from the same modules every other command uses.
-//
-// The reason for the seam: a terminal UI that reads the filesystem itself would become a second
-// implementation of "what is a run, which lab does it belong to, is it alive" — one that ships
-// minified, is invisible to the root test suite, and drifts from `humanish runs` the first time
-// either side changes. Injection keeps exactly one implementation, already unit-tested, and leaves
-// the bundle a view layer that can be reasoned about as one.
-//
-// It also makes the UI testable without a terminal: a test hands `startTui` a fake index and reads
-// the frames back.
-/** Node version the Ink runtime requires (ink@7 declares `engines.node >= 22`). */
-export const TUI_MIN_NODE_MAJOR = 22;
-/**
- * Whether this runtime can host the surface. Kept here, beside the reason, so the CLI's refusal and
- * `doctor`'s readiness row can never disagree about the answer.
- */
-export function nodeSupportsTui(versionString = process.version) {
-    const major = Number.parseInt(versionString.replace(/^v/, "").split(".")[0] ?? "", 10);
-    return Number.isFinite(major) && major >= TUI_MIN_NODE_MAJOR;
-}
-/**
- * Where the bundle sits relative to the compiled CLI. Shared so the command that loads it and the
- * readiness row that reports it can never look in different places.
- */
-export function tuiBundleUrl(baseUrl) {
-    return new URL("./tui-app.js", baseUrl);
-}
-/**
- * What `doctor` says about the stakeholder surface — a pure function of the machine's state and,
- * crucially, of WHO IS READING.
- *
- * A real first-contact study (labs/first-contact.yaml) is why the reader matters. An autonomous
- * agent evaluating humanish read "`humanish tui` is available in an interactive terminal",
- * correctly concluded it was not in one, and dropped it — then wrote a report FOR A HUMAN that
- * never mentioned the human surface at all. Discovery worked and handoff did not. A capability
- * described to a reader who cannot use it has to be phrased as something to PASS ON, or it reads
- * as "not for you" and dies in the transcript.
- */
-export function terminalSurfaceMessage(state) {
-    if (!state.supported) {
-        return `\`humanish tui\` needs Node ${TUI_MIN_NODE_MAJOR}+ (this is ${state.nodeVersion}); every other command works here`;
-    }
-    if (!state.bundlePresent) {
-        return "`humanish tui` bundle is not built in this checkout — run `pnpm build` (installed packages ship it prebuilt)";
-    }
-    return state.interactive
-        ? "`humanish tui` opens the interactive surface for browsing labs and runs"
-        : "`humanish tui` is the interactive surface a PERSON uses to watch and start runs here — this shell is not a terminal, so pass it on to whoever is";
-}
-//# sourceMappingURL=tui-contract.js.map