humanish 0.48.0 → 0.50.0

package/dist/key-resolution.js

@@ -0,0 +1,373 @@
+// Provider-key discovery (#436): resolve the keys a live run needs through each vendor's
+// native chain instead of demanding a per-repo --env-file that operators hand-copy keys into.
+//
+// The chain, per key, FILL-ONLY (a rung never overrides anything already present):
+//   1. process env — including whatever --env-file just loaded (explicit always wins);
+//   2. `.humanish/local/provider.env` — the project-local overlay this CLI's own --help
+//      examples document;
+//   3. the OWNING vendor's native store, where one exists:
+//        E2B_API_KEY  <- ~/.e2b/config.json (written by `e2b auth login`);
+//        GH_TOKEN     <- `gh auth token` (the gh CLI's credential chain);
+//   4. the humanish user-level store `$XDG_CONFIG_HOME/humanish/keys.env`, written only by
+//      `humanish keys set` (0600, prompted or --stdin) — the fallback for vendors that ship
+//      no machine chain of their own (OpenAI, Anthropic).
+//
+// Every fill is ANNOUNCED by key name + source, never by value. The subject app's own
+// `.env`/`.env.local` are NEVER read — those hold product credentials, a different class
+// (#11); this module only reads humanish-owned files and vendor-owned stores.
+// `HUMANISH_STRICT_KEYS=1` disables every rung below process env (the pre-#436 behavior).
+import { spawn } from "node:child_process";
+import { chmodSync, closeSync, constants as fsConstants, existsSync, ftruncateSync, lstatSync, mkdirSync, openSync, readFileSync, writeSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+import { loadEnvFile } from "./env-file.js";
+export const KEY_RESOLUTION_SCHEMA = "humanish.key-resolution.v1";
+/** The ONLY names implicit discovery may fill (and `humanish keys set` may store). Everything
+ *  else in an overlay/store file is ignored-and-named: a repo-planted NODE_OPTIONS/LD_PRELOAD
+ *  must never enter process env off a file the operator did not explicitly pass (an explicit
+ *  --env-file remains the operator's own full-file load). Red-team finding, #436. */
+export const KNOWN_PROVIDER_KEYS = [
+    "OPENAI_API_KEY",
+    "ANTHROPIC_API_KEY",
+    "E2B_API_KEY",
+    "GH_TOKEN",
+    "GITHUB_TOKEN",
+    "CODEX_API_KEY"
+];
+const PROVIDER_KEY_SET = new Set(KNOWN_PROVIDER_KEYS);
+/** `humanish keys set <vendor>` aliases; a raw ENV_NAME is also accepted. */
+export const KEY_VENDOR_ALIASES = {
+    openai: "OPENAI_API_KEY",
+    e2b: "E2B_API_KEY",
+    anthropic: "ANTHROPIC_API_KEY",
+    github: "GH_TOKEN"
+};
+export const PROJECT_OVERLAY_RELATIVE = path.join(".humanish", "local", "provider.env");
+export function userKeyStorePath(env, deps = {}) {
+    const home = deps.homeDir ?? homedir();
+    const declared = env.XDG_CONFIG_HOME?.trim();
+    // The XDG spec: a relative XDG_CONFIG_HOME MUST be ignored. Honoring one would make the
+    // key store cwd-relative — `humanish keys set` would write a secret into the current repo.
+    const configHome = declared !== undefined && declared !== "" && path.isAbsolute(declared) ? declared : path.join(home, ".config");
+    return path.join(configHome, "humanish", "keys.env");
+}
+function e2bConfigPath(deps) {
+    return path.join(deps.homeDir ?? homedir(), ".e2b", "config.json");
+}
+/** Default exec: bounded, quiet, stdin closed; null on ANY failure. Never throws. */
+function defaultExecText(command, args, timeoutMs) {
+    return new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn(command, args, { stdio: ["ignore", "pipe", "ignore"] });
+        }
+        catch {
+            resolve(null);
+            return;
+        }
+        let out = "";
+        let settled = false;
+        const settle = (value) => {
+            if (!settled) {
+                settled = true;
+                resolve(value);
+            }
+        };
+        const timer = setTimeout(() => {
+            try {
+                child.kill();
+            }
+            catch {
+                // best effort
+            }
+            settle(null);
+        }, timeoutMs);
+        timer.unref?.();
+        child.stdout?.on("data", (chunk) => {
+            out += chunk.toString("utf8");
+        });
+        child.on("error", () => settle(null));
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            if (code !== 0) {
+                settle(null);
+                return;
+            }
+            const trimmed = out.trim();
+            settle(trimmed.length > 0 && !trimmed.includes("\n") ? trimmed : null);
+        });
+    });
+}
+/** Read the E2B team key from the e2b CLI's own config. Defensive on shape: accept the
+ *  documented `teamApiKey`, fall back to `apiKey`; anything else is a miss, never an error. */
+function readE2bConfigKey(deps) {
+    try {
+        const raw = readFileSync(e2bConfigPath(deps), "utf8");
+        const parsed = JSON.parse(raw);
+        if (parsed === null || typeof parsed !== "object")
+            return null;
+        const record = parsed;
+        for (const field of ["teamApiKey", "apiKey"]) {
+            const value = record[field];
+            if (typeof value === "string" && value.trim().length > 0)
+                return value.trim();
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Refuse to READ a store through a symlink: a repo-local overlay that is secretly a link to
+ *  an unrelated file is exactly the retargeting shape the artifact paths refuse elsewhere. */
+function isRegularFile(filePath) {
+    try {
+        return lstatSync(filePath).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Fill missing provider keys into `env` from the discovery chain, announcing each fill as
+ * `NAME from SOURCE`. Returns the fills. Opt-out: HUMANISH_STRICT_KEYS=1 returns [] untouched.
+ */
+export async function discoverProviderKeys(args) {
+    const { cwd, env, announce } = args;
+    const deps = args.deps ?? {};
+    if (env.HUMANISH_STRICT_KEYS?.trim() === "1")
+        return [];
+    const fills = [];
+    const ignored = [];
+    // Fill-only means PRESENCE wins, including an explicitly-set empty value: an operator who
+    // exported OPENAI_API_KEY="" said "off", and a rung that "fixes" that has overridden them
+    // (red-team finding). Only a truly-unset name is fillable.
+    const fillable = (name) => env[name] === undefined;
+    const fill = (name, value, source) => {
+        env[name] = value;
+        fills.push({ name, source });
+    };
+    // Rung 2: the documented project-local overlay. Parsed ATOMICALLY against a scratch env so a
+    // file loadEnvFile rejects can never half-apply (red-team finding: earlier lines used to land
+    // in env unannounced before the parse error aborted). Only allowlisted provider names cross
+    // from the file into the real env.
+    const overlayPath = path.resolve(cwd, PROJECT_OVERLAY_RELATIVE);
+    if (isRegularFile(overlayPath) && !dirIsSymlink(overlayPath)) {
+        const scratch = {};
+        const overlay = await loadEnvFile(cwd, PROJECT_OVERLAY_RELATIVE, scratch);
+        if (overlay.ok) {
+            for (const name of overlay.loaded) {
+                const value = scratch[name];
+                if (value === undefined || !fillable(name))
+                    continue;
+                if (!PROVIDER_KEY_SET.has(name)) {
+                    ignored.push(`${name} (${PROJECT_OVERLAY_RELATIVE})`);
+                    continue;
+                }
+                fill(name, value, PROJECT_OVERLAY_RELATIVE);
+            }
+        }
+    }
+    // Rung 3a: the e2b CLI's own login store.
+    if (fillable("E2B_API_KEY")) {
+        const teamKey = readE2bConfigKey(deps);
+        if (teamKey !== null)
+            fill("E2B_API_KEY", teamKey, "~/.e2b/config.json (e2b auth login)");
+    }
+    // Rung 3b: the gh CLI's credential chain. Only consulted when NEITHER GitHub env name is
+    // present; fills GH_TOKEN (the name humanish reads first).
+    if (fillable("GH_TOKEN") && fillable("GITHUB_TOKEN")) {
+        const exec = deps.execText ?? defaultExecText;
+        const token = await exec("gh", ["auth", "token"], 3_000);
+        if (token !== null)
+            fill("GH_TOKEN", token, "gh auth token");
+    }
+    // Rung 4: the humanish user-level store — read with the SAME lenient parser `keys set`/`list`
+    // use, so one hand-mangled line degrades to that line alone instead of silently voiding the
+    // whole store (red-team finding: the strict parser disagreed with the store's own reader).
+    const storePath = userKeyStorePath(env, deps);
+    if (isRegularFile(storePath) && !dirIsSymlink(storePath)) {
+        for (const [name, value] of readStoreEntries(storePath)) {
+            if (!fillable(name))
+                continue;
+            if (!PROVIDER_KEY_SET.has(name)) {
+                ignored.push(`${name} (${storeLabel(env, deps)})`);
+                continue;
+            }
+            fill(name, value, storeLabel(env, deps));
+        }
+    }
+    for (const fill_ of fills)
+        announce(`humanish keys: ${fill_.name} from ${fill_.source}`);
+    for (const name of ignored)
+        announce(`humanish keys: ignored non-provider name ${name} — implicit discovery fills provider keys only; pass the file via --env-file to load everything in it`);
+    return fills;
+}
+/** True when the file's PARENT directory is (or traverses) a symlink at its last component —
+ *  the dir-level retarget that defeats a file-level lstat check (red-team finding). */
+function dirIsSymlink(filePath) {
+    try {
+        return lstatSync(path.dirname(filePath)).isSymbolicLink();
+    }
+    catch {
+        return false;
+    }
+}
+function storeLabel(env, deps) {
+    const home = deps.homeDir ?? homedir();
+    return userKeyStorePath(env, deps).replace(home, "~");
+}
+/** The nearest fill instruction for a missing key — used by doctor rows and appended to
+ *  *_KEYS_MISSING errors so the failure names the fix, not just the absence (#436). */
+export function missingKeyHint(name) {
+    switch (name) {
+        case "E2B_API_KEY":
+            return "run `e2b auth login`, or `humanish keys set e2b`";
+        case "GH_TOKEN":
+        case "GITHUB_TOKEN":
+            return "run `gh auth login`, or `humanish keys set github`";
+        case "OPENAI_API_KEY":
+            return "run `humanish keys set openai`";
+        case "ANTHROPIC_API_KEY":
+            return "run `humanish keys set anthropic`";
+        default:
+            return `run \`humanish keys set ${name}\``;
+    }
+}
+/** One shared suffix for *_KEYS_MISSING messages: where discovery looked, and what fills each
+ *  missing key. Pure text; never values. */
+export function describeMissingKeys(names, env) {
+    const hints = names.map((name) => `${name}: ${missingKeyHint(name)}`).join("; ");
+    const strict = env.HUMANISH_STRICT_KEYS?.trim() === "1";
+    const chain = strict
+        ? "key discovery is disabled (HUMANISH_STRICT_KEYS=1); only process env and --env-file are read"
+        : `also checked ${PROJECT_OVERLAY_RELATIVE}, ~/.e2b/config.json, gh auth token, and ${path.join("~", ".config", "humanish", "keys.env")}`;
+    return `${chain}. Fill: ${hints}.`;
+}
+/**
+ * Non-mutating probe for doctor: report, per key, the source that currently supplies it.
+ * Runs the same chain against a scratch copy of env so nothing observable changes.
+ */
+export async function probeKeySources(names, args) {
+    const scratch = { ...args.env };
+    const fills = await discoverProviderKeys({
+        cwd: args.cwd,
+        env: scratch,
+        announce: () => { },
+        ...(args.deps === undefined ? {} : { deps: args.deps })
+    });
+    const bySource = new Map(fills.map((fill) => [fill.name, fill.source]));
+    return names.map((name) => {
+        const inEnv = args.env[name] !== undefined && args.env[name]?.trim() !== "";
+        // GH_TOKEN and GITHUB_TOKEN are one credential with two spellings; a doctor row that says
+        // "missing" while GITHUB_TOKEN sits in the env would be wrong (red-team nit).
+        const aliasInEnv = name === "GH_TOKEN" && args.env.GITHUB_TOKEN !== undefined && args.env.GITHUB_TOKEN.trim() !== "";
+        const source = inEnv ? "process env" : aliasInEnv ? "process env (GITHUB_TOKEN)" : (bySource.get(name) ?? null);
+        return { name, source, hint: missingKeyHint(name) };
+    });
+}
+const ENV_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/** Resolve a `humanish keys set` target: a vendor alias or a raw env name. Null = invalid. */
+export function resolveKeyName(vendorOrName) {
+    const alias = KEY_VENDOR_ALIASES[vendorOrName.toLowerCase()];
+    if (alias !== undefined)
+        return alias;
+    return ENV_NAME.test(vendorOrName) ? vendorOrName : null;
+}
+/** Write one key into the user store (0700 dir, 0600 file). Only allowlisted provider names
+ *  are storable (the store feeds implicit discovery — an arbitrary-name store would be an env
+ *  injection vector with extra steps). The value must be a single non-empty line that
+ *  round-trips the store's own parser byte-identically, and the write refuses symlinks at the
+ *  file AND its parent directory (red-team findings). */
+export function setUserKey(name, value, env, deps = {}) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0 || /\r|\n/.test(trimmed)) {
+        throw new Error("The key value must be a single non-empty line.");
+    }
+    if (!ENV_NAME.test(name)) {
+        throw new Error(`Not a valid env name: ${name}`);
+    }
+    if (!PROVIDER_KEY_SET.has(name)) {
+        throw new Error(`The store holds provider keys only (${[...PROVIDER_KEY_SET].join(", ")}). For anything else, use an explicit --env-file.`);
+    }
+    const storePath = userKeyStorePath(env, deps);
+    const dir = path.dirname(storePath);
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+    if (lstatSync(dir).isSymbolicLink()) {
+        throw new Error(`Refusing to write through a symlinked store directory: ${dir}`);
+    }
+    if (existsSync(storePath) && !lstatSync(storePath).isFile()) {
+        throw new Error(`Refusing to write the store: ${storePath} is not a regular file.`);
+    }
+    const entries = readStoreEntries(storePath);
+    entries.set(name, trimmed);
+    // The written line must read back byte-identically through the store's own parser: a value
+    // that parses differently (an embedded '#', a leading quote the env parser would strip)
+    // would silently resolve to a DIFFERENT secret on the next run.
+    const roundTrip = parseStoreLine(`${name}=${trimmed}`);
+    if (roundTrip === null || roundTrip[0] !== name || roundTrip[1] !== trimmed) {
+        throw new Error("The value does not round-trip the store format (avoid leading quotes and '#'); pass it via --env-file instead.");
+    }
+    writeStore(storePath, entries);
+    return { path: storePath };
+}
+/** Remove one key from the user store. Returns whether it was present. */
+export function unsetUserKey(name, env, deps = {}) {
+    const storePath = userKeyStorePath(env, deps);
+    if (!isRegularFile(storePath) || dirIsSymlink(storePath))
+        return false;
+    const entries = readStoreEntries(storePath);
+    const had = entries.delete(name);
+    if (had)
+        writeStore(storePath, entries);
+    return had;
+}
+/** The names (never values) currently in the user store. */
+export function listUserKeys(env, deps = {}) {
+    const storePath = userKeyStorePath(env, deps);
+    if (!isRegularFile(storePath) || dirIsSymlink(storePath))
+        return [];
+    return [...readStoreEntries(storePath).keys()];
+}
+function readStoreEntries(storePath) {
+    const entries = new Map();
+    if (!existsSync(storePath))
+        return entries;
+    const text = readFileSync(storePath, "utf8");
+    for (const line of text.split(/\r?\n/)) {
+        const parsed = parseStoreLine(line);
+        if (parsed !== null)
+            entries.set(parsed[0], parsed[1]);
+    }
+    return entries;
+}
+function writeStore(storePath, entries) {
+    const body = [...entries.entries()].map(([name, value]) => `${name}=${value}`).join("\n");
+    const text = body.length > 0 ? `${body}\n` : "";
+    // O_NOFOLLOW: a symlinked keys.env must never carry the write to its target (red-team
+    // reproduced writing a secret through the link into an attacker-chosen file).
+    const fd = openSync(storePath, fsConstants.O_WRONLY | fsConstants.O_CREAT | fsConstants.O_NOFOLLOW, 0o600);
+    try {
+        ftruncateSync(fd, 0);
+        writeSync(fd, text, 0, "utf8");
+    }
+    finally {
+        closeSync(fd);
+    }
+    // mkdir/open modes are masked by umask; enforce the final bits explicitly.
+    chmodSync(storePath, 0o600);
+}
+/** The store's line grammar, shared by read and the set-time round-trip check. */
+function parseStoreLine(line) {
+    const trimmed = line.trim();
+    if (trimmed === "" || trimmed.startsWith("#"))
+        return null;
+    const separator = trimmed.indexOf("=");
+    if (separator <= 0)
+        return null;
+    const name = trimmed.slice(0, separator).trim();
+    if (!ENV_NAME.test(name))
+        return null;
+    return [name, trimmed.slice(separator + 1).trim()];
+}
+//# sourceMappingURL=key-resolution.js.map

package/dist/key-resolution.js.map

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

package/dist/lab-engine.d.ts

@@ -5,6 +5,7 @@ import { type SharedWorldLabHooks, type SharedWorldLabResult } from "./shared-wo
 import { type ConcurrentSharedWorldLabResult } from "./concurrent-shared-world-lab.js";
 import { type OssLabResult } from "./oss-lab.js";
 import { type OssMetaLabResult } from "./oss-meta-lab.js";
+import { type RunLabProvenance } from "./run-status.js";
 import type { ObserverResult } from "./observer.js";
 import { type RunResult, type RunScorerProvenance } from "./run.js";
 import { type LabConfig } from "./lab-config.js";
@@ -13,6 +14,10 @@ export type LabBackend = "synthetic" | "smoke" | "meta" | "cua" | "scripted" | "
 export interface RunLabOptions {
     cwd: string;
     runId?: string;
+    /** Which manifest this run came from (#455): threaded to the backend so the run's own
+     *  status record and bundle can say which lab produced it. Absent for library callers who
+     *  hand a LabConfig directly — the run is then honestly lab-less rather than guessed. */
+    lab?: RunLabProvenance;
     dryRun?: boolean;
     open?: boolean;
     /** Lane override: synthetic sims, smoke repo limit, or meta desktop count. */
@@ -81,4 +86,10 @@ export type LabOutcome = {
 export declare function selectLabBackend(config: LabConfig): LabBackend;
 /** Resolve dry-run: explicit override wins, else the scenario mode, else the given fallback. */
 export declare function resolveLabDryRun(config: LabConfig, override: boolean | undefined, fallback: boolean | undefined): boolean | undefined;
+/**
+ * The one seam every lab backend is dispatched through. The body runs inside a status scope so a
+ * backend that fails closed and RETURNS an error result — 18 such exits across the backends — can
+ * never leave its liveness record ticking as though the run were still going. See
+ * `withRunStatusScope`.
+ */
 export declare function runLab(config: LabConfig, options: RunLabOptions): Promise<LabOutcome>;

package/dist/lab-engine.js

@@ -13,6 +13,7 @@ import { runSharedWorldLab } from "./shared-world-lab.js";
 import { runConcurrentSharedWorld } from "./concurrent-shared-world-lab.js";
 import { DEFAULT_OSS_REPOS, runOssLab } from "./oss-lab.js";
 import { runOssMetaLab } from "./oss-meta-lab.js";
+import { withRunStatusScope } from "./run-status.js";
 import { runDryRun } from "./run.js";
 import { routesToComputerUse, routesToConcurrentSharedWorld, routesToScriptedBrowser, routesToSharedWorld, routesToTerminalProduct } from "./lab-config.js";
 /**
@@ -84,12 +85,22 @@ export function resolveLabDryRun(config, override, fallback) {
     }
     return fallback;
 }
+/**
+ * The one seam every lab backend is dispatched through. The body runs inside a status scope so a
+ * backend that fails closed and RETURNS an error result — 18 such exits across the backends — can
+ * never leave its liveness record ticking as though the run were still going. See
+ * `withRunStatusScope`.
+ */
 export async function runLab(config, options) {
+    return withRunStatusScope(() => runLabInScope(config, options));
+}
+async function runLabInScope(config, options) {
     const backend = selectLabBackend(config);
     const fanout = config.subject.clone?.fanout ?? config.subject.repos?.length ?? DEFAULT_OSS_REPOS.length;
     switch (backend) {
         case "synthetic": {
             const result = await runDryRun({
+                ...(options.lab === undefined ? {} : { lab: options.lab }),
                 cwd: options.cwd,
                 dryRun: resolveLabDryRun(config, options.dryRun, true) ?? true,
                 simCount: options.count ?? actorLaneCount(config) ?? 4,
@@ -101,6 +112,7 @@ export async function runLab(config, options) {
             const keep = options.keep ?? config.subject.clone?.keep;
             const repos = options.repos ?? config.subject.repos;
             const result = await runOssLab({
+                ...(options.lab === undefined ? {} : { lab: options.lab }),
                 cwd: options.cwd,
                 limit: options.count ?? fanout,
                 ...(repos === undefined ? {} : { repos }),
@@ -115,6 +127,7 @@ export async function runLab(config, options) {
             const codexAppServer = options.codexAppServer ?? config.execution?.desktop?.codexAppServer;
             const metaRepos = options.repos ?? config.subject.repos;
             const result = await runOssMetaLab({
+                ...(options.lab === undefined ? {} : { lab: options.lab }),
                 cwd: options.cwd,
                 count: options.count ?? fanout,
                 ...(metaRepos === undefined ? {} : { repos: metaRepos }),
@@ -132,6 +145,7 @@ export async function runLab(config, options) {
             // Spend-safe default: a computer-use lab only goes live when the config (or CLI) says so.
             const dryRun = resolveLabDryRun(config, options.dryRun, true) ?? true;
             const result = await runCuaActorLab({
+                ...(options.lab === undefined ? {} : { lab: options.lab }),
                 cwd: options.cwd,
                 config,
                 dryRun,
@@ -155,6 +169,7 @@ export async function runLab(config, options) {
             // spend. This differs deliberately from `run --app-url`, which actuates on invocation.
             const dryRun = resolveLabDryRun(config, options.dryRun, true) ?? true;
             const result = await runScriptedBrowserLab({
+                ...(options.lab === undefined ? {} : { lab: options.lab }),
                 cwd: options.cwd,
                 config,
                 dryRun,
@@ -170,6 +185,7 @@ export async function runLab(config, options) {
             // emits contract evidence without creating a sandbox, reading a key, or spending.
             const dryRun = resolveLabDryRun(config, options.dryRun, true) ?? true;
             const result = await runTerminalProductLab({
+                ...(options.lab === undefined ? {} : { lab: options.lab }),
                 cwd: options.cwd,
                 config,
                 dryRun,
@@ -186,6 +202,7 @@ export async function runLab(config, options) {
             // proof is fully $0 via the sharedWorldHooks DI seam.
             const dryRun = resolveLabDryRun(config, options.dryRun, true) ?? true;
             const result = await runSharedWorldLab({
+                ...(options.lab === undefined ? {} : { lab: options.lab }),
                 cwd: options.cwd,
                 config,
                 dryRun,
@@ -202,6 +219,7 @@ export async function runLab(config, options) {
             // The deterministic PoC proof is fully $0 via the sharedWorldHooks DI seam.
             const dryRun = resolveLabDryRun(config, options.dryRun, true) ?? true;
             const result = await runConcurrentSharedWorld({
+                ...(options.lab === undefined ? {} : { lab: options.lab }),
                 cwd: options.cwd,
                 config,
                 dryRun,

package/dist/lab-engine.js.map

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

package/dist/openai-responses-cu.d.ts

@@ -1,7 +1,7 @@
 import type { ActorCapabilities } from "./actor-contract.js";
 import type { CuaAction, CuaProvider, CuaSafetyCheck, CuaTurn } from "./computer-use.js";
 export declare const OPENAI_RESPONSES_CU_CAPABILITIES: ActorCapabilities;
-export declare const DEFAULT_OPENAI_CU_MODEL = "gpt-5.5";
+export declare const DEFAULT_OPENAI_CU_MODEL = "gpt-5.6-sol";
 /**
  * Map an OpenAI computer action object to a provider-neutral CuaAction, or null
  * for an unknown type. Every coordinate and field is read defensively so a

package/dist/openai-responses-cu.js

@@ -49,7 +49,10 @@ export const OPENAI_RESPONSES_CU_CAPABILITIES = {
     inProcessTools: false,
     license: "proprietary"
 };
-export const DEFAULT_OPENAI_CU_MODEL = "gpt-5.5";
+// The flagship 5.6-generation tier ("gpt-5.6" is OpenAI's alias for this exact id; the
+// computer-use guide's own examples run on it). Explicit tier id so trace provenance and the
+// rate-table key stay stable if OpenAI repoints the alias (#334).
+export const DEFAULT_OPENAI_CU_MODEL = "gpt-5.6-sol";
 // ---------------------------------------------------------------------------
 // Defensive readers. The Responses wire shape is loosely typed (unknown), so we
 // read every field defensively: a non-object is treated as empty, a non-number
@@ -230,12 +233,15 @@ export function parseOpenAiResponse(raw) {
     // a long session is a cache hit billed at a fraction of the full rate. Not reading it made every
     // cost line materially overstate the bill (#391).
     const usageCachedInput = optionalNumber(asRecord(usageRecord.input_tokens_details).cached_tokens);
+    // GPT-5.6+ bills cache WRITES (1.25x input) and reports them here; older models omit the field.
+    const usageCacheWriteInput = optionalNumber(asRecord(usageRecord.input_tokens_details).cache_write_tokens);
     const usage = usageInput === undefined && usageOutput === undefined
         ? undefined
         : {
             ...(usageInput === undefined ? {} : { input: usageInput }),
             ...(usageOutput === undefined ? {} : { output: usageOutput }),
-            ...(usageCachedInput === undefined ? {} : { cachedInput: usageCachedInput })
+            ...(usageCachedInput === undefined ? {} : { cachedInput: usageCachedInput }),
+            ...(usageCacheWriteInput === undefined ? {} : { cacheWriteInput: usageCacheWriteInput })
         };
     const turn = {
         actions,