humanish 0.104.3 → 0.106.0

package/dist/affordance.js

@@ -1,145 +0,0 @@
-// Affordance classification (#369): WHICH KIND of route an actor took to accomplish a step.
-//
-// Why this exists. A computer-use actor in a human-persona study typed a `javascript:` URL into
-// the address bar to get past a step, and the run finished green: the actor routed around the
-// friction the study existed to measure, and nothing in the evidence said so. Whether that is a
-// defect depends on a question the bundle never recorded — who is this study's user? For a human
-// population it invalidates the run; for an agent-facing product whose users ARE agents the same
-// act is faithful, and the fact the agent reached for it is itself a finding about how legible
-// the surface is. So the harness records the class and bakes NO verdict: the adopter's scorer
-// (review.scorer.ref) decides what it means, because that judgment is product semantics.
-//
-// Two design facts drive the shape:
-//
-//  1. The computer-use action space is mouse + keyboard only — there is no `goto` action. Typing a
-//     URL is a `type` action whose TEXT happens to be a URL, and typing script is a `type` action
-//     whose text happens to start with `javascript:`. Classification therefore has to look at the
-//     typed text, which exists only at dispatch time.
-//  2. Raw typed text is never persisted (describeCuaAction deliberately renders `type [N chars]`),
-//     so this module returns a CLASS and at most a scheme-shaped signal — never the text. The
-//     class is public-safe by construction.
-//
-// Direct URL navigation is deliberately its own class and NOT lumped with script execution:
-// `load(url)` appears in 99.4% of 2,337 real human web demonstrations (WebLINX), so address-bar
-// use is ordinary human behavior. The anomalous classes are script execution and developer
-// tooling. See docs/principles/actor-fidelity.md for the evidence and the scoping of the claim.
-export const AFFORDANCE_CLASS_SCHEMA = "humanish.affordance-use.v1";
-/** Classes that a person operating this product through its own surfaces could produce. */
-export const NATURALISTIC_AFFORDANCE_CLASSES = [
-    "pointer",
-    "keyboard",
-    "speech",
-    "url-navigation",
-    "observation"
-];
-/** Classes that reach past the rendered product surface. Recorded, never blocked. */
-export const SHORTCUT_AFFORDANCE_CLASSES = ["script-execution", "devtools", "browser-internal"];
-// A `javascript:` URL typed into the address bar. Tolerates leading whitespace and mixed case;
-// the scheme is what matters, not the payload (which is never recorded).
-const SCRIPT_URL = /^\s*(?:javascript|data):/i;
-// Browser-internal surfaces: not the product under study, and not something a study of the
-// product's UX can attribute to the product.
-const BROWSER_INTERNAL_URL = /^\s*(?:chrome|about|view-source|devtools|file|edge|brave):/i;
-// An http(s) URL, or a bare host-looking string a browser resolves as navigation.
-const HTTP_URL = /^\s*https?:\/\//i;
-const BARE_HOST = /^\s*(?:www\.)?[a-z0-9-]+(?:\.[a-z0-9-]+)+(?:[/:?#]\S*)?\s*$/i;
-// The common devtools chords across platforms.
-const DEVTOOLS_CHORDS = new Set([
-    "f12",
-    "ctrl+shift+i",
-    "ctrl+shift+j",
-    "ctrl+shift+c",
-    "cmd+alt+i",
-    "cmd+alt+j",
-    "cmd+alt+c",
-    "meta+alt+i",
-    "meta+alt+j",
-    "meta+alt+c"
-]);
-/**
- * Classify one computer-use action. PURE: same action in, same class out, no I/O, no clock. The
- * returned signal is public-safe (a scheme or a chord), never the action's text.
- */
-export function classifyCuaAction(action) {
-    switch (action.kind) {
-        case "click":
-        case "double_click":
-        case "drag":
-        case "scroll":
-            return { affordance: "pointer" };
-        case "wait":
-        case "screenshot":
-        // A bare pointer move actuates nothing on its own; it is the actor looking around.
-        case "move":
-            return { affordance: "observation" };
-        case "keypress": {
-            const chord = normalizeChord(action.keys);
-            if (DEVTOOLS_CHORDS.has(chord)) {
-                return { affordance: "devtools", signal: chord };
-            }
-            return { affordance: "keyboard" };
-        }
-        case "type": {
-            const text = action.text;
-            if (SCRIPT_URL.test(text)) {
-                // The payload after the scheme is deliberately dropped: it is arbitrary author text and
-                // could carry anything. The scheme alone is the finding. `data:` rides here with
-                // `javascript:` because a data URL can carry executable HTML.
-                return { affordance: "script-execution", signal: schemeOf(text) };
-            }
-            if (BROWSER_INTERNAL_URL.test(text)) {
-                return { affordance: "browser-internal", signal: schemeOf(text) };
-            }
-            if (HTTP_URL.test(text)) {
-                // Scheme only — a full URL can carry a session token or an identifying path.
-                return { affordance: "url-navigation", signal: schemeOf(text) };
-            }
-            if (BARE_HOST.test(text)) {
-                return { affordance: "url-navigation", signal: "bare-host" };
-            }
-            return { affordance: "keyboard" };
-        }
-        case "speak":
-            return { affordance: "speech" };
-        default:
-            // The wire->CuaAction mapper drops unrecognized action types before they reach here, so
-            // this is unreachable today; classify defensively rather than throwing inside a run.
-            return { affordance: "observation" };
-    }
-}
-/**
- * Normalize a key chord so the same physical shortcut matches however a provider spells it:
- * `Control`/`ctrl`, `Meta`/`Command`/`cmd`, `Option`/`alt` all collapse, and modifier ORDER is
- * normalized so ["Shift","Control","J"] and ["Control","Shift","J"] are one chord.
- */
-function normalizeChord(keys) {
-    const alias = {
-        control: "ctrl", ctl: "ctrl",
-        meta: "cmd", command: "cmd", super: "cmd", os: "cmd",
-        option: "alt", opt: "alt"
-    };
-    const parts = keys.map((key) => {
-        const lowered = key.trim().toLowerCase();
-        return alias[lowered] ?? lowered;
-    });
-    const order = ["ctrl", "cmd", "alt", "shift"];
-    const modifiers = parts.filter((part) => order.includes(part)).sort((a, b) => order.indexOf(a) - order.indexOf(b));
-    const rest = parts.filter((part) => !order.includes(part));
-    return [...modifiers, ...rest].join("+");
-}
-/** The scheme alone, lowercased — never the rest of a URL, which can carry a session token. */
-function schemeOf(text) {
-    const trimmed = text.trim();
-    const colon = trimmed.indexOf(":");
-    return colon === -1 ? "" : `${trimmed.slice(0, colon).toLowerCase()}:`;
-}
-/** Fold a sequence of observations into the per-run aggregate. */
-export function summarizeAffordanceUse(observations) {
-    const counts = {};
-    for (const observation of observations) {
-        counts[observation.affordance] = (counts[observation.affordance] ?? 0) + 1;
-    }
-    const shortcutTotal = SHORTCUT_AFFORDANCE_CLASSES.reduce((sum, klass) => sum + (counts[klass] ?? 0), 0);
-    return { schema: AFFORDANCE_CLASS_SCHEMA, counts, total: observations.length, shortcutTotal };
-}
-//# sourceMappingURL=affordance.js.map

package/dist/affordance.js.map

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

package/dist/agent-session.js

@@ -1,43 +0,0 @@
-// Is the terminal on the other end of this process a PERSON's, or an agent's?
-//
-// WHY THIS EXISTS: `humanish tui` refused a non-TTY, on the reasoning that an agent driving an
-// interactive surface has asked for something that cannot exist. A study of that refusal
-// (labs/handed-a-human-surface.yaml) found it never fires: `codex exec` allocates a PTY for the
-// commands it runs, so both streams ARE terminals. The TUI launched, the agent navigated the labs
-// list, opened one, and — its own words — "accidentally triggered a zero-cost dry run while
-// navigating". A stray Enter on a live row is the same two keystrokes as a deliberate one.
-//
-// So a TTY is a real answer to the wrong question. It says a terminal exists; it does not say
-// anyone is reading it. Agent runners announce themselves in the environment, which is the only
-// signal available before the first keystroke, and is what `is-in-ci` has always done for CI.
-//
-// EVERY MARKER BELOW WAS OBSERVED, not guessed. Two runtimes are covered because two are what we
-// could verify: Claude Code (read off a live session) and Codex (read off the study sandbox, by a
-// names-only `env | cut -d= -f1` probe that never touched a value). Others certainly exist — add
-// them the same way, from a real session, rather than from a plausible-looking guess. A marker
-// that is wrong refuses a person for no reason.
-const MARKERS = [
-    { marker: "CLAUDECODE", runner: "Claude Code" },
-    { marker: "CLAUDE_CODE_SESSION_ID", runner: "Claude Code" },
-    { marker: "CODEX_SESSION_ID", runner: "Codex" },
-    { marker: "CODEX_THREAD_ID", runner: "Codex" },
-    // Generic, and set alongside the Claude Code markers on the machine this was written on. Kept
-    // last so a named runner wins the attribution.
-    { marker: "AI_AGENT", runner: "an AI agent runner" }
-];
-/**
- * The agent runner driving this process, when one identifies itself. `undefined` means nothing
- * claimed to be an agent — which is NOT proof a person is there, only the absence of a claim.
- */
-export function detectAgentSession(env = process.env) {
-    for (const { marker, runner } of MARKERS) {
-        const value = env[marker];
-        // Presence is the signal, but an explicitly empty or "0" value is treated as absence: a
-        // wrapper that unsets a marker by blanking it means it.
-        if (value !== undefined && value.trim().length > 0 && value.trim() !== "0") {
-            return { runner, marker };
-        }
-    }
-    return undefined;
-}
-//# sourceMappingURL=agent-session.js.map

package/dist/agent-session.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-session.js","sourceRoot":"","sources":["../src/agent-session.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,EAAE;AACF,+FAA+F;AAC/F,yFAAyF;AACzF,gGAAgG;AAChG,kGAAkG;AAClG,4FAA4F;AAC5F,2FAA2F;AAC3F,EAAE;AACF,8FAA8F;AAC9F,gGAAgG;AAChG,8FAA8F;AAC9F,EAAE;AACF,iGAAiG;AACjG,kGAAkG;AAClG,iGAAiG;AACjG,+FAA+F;AAC/F,gDAAgD;AAShD,MAAM,OAAO,GAAsD;IACjE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE;IAC/C,EAAE,MAAM,EAAE,wBAAwB,EAAE,MAAM,EAAE,aAAa,EAAE;IAC3D,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,OAAO,EAAE;IAC/C,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,EAAE;IAC9C,8FAA8F;IAC9F,+CAA+C;IAC/C,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,oBAAoB,EAAE;CACrD,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACrE,KAAK,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1B,wFAAwF;QACxF,wDAAwD;QACxD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/argv.d.ts

@@ -1 +0,0 @@
-export declare function normalizeCliArgv(argv: string[]): string[];

package/dist/argv.js

@@ -1,8 +0,0 @@
-export function normalizeCliArgv(argv) {
-    const [runtime, entrypoint, separator, ...rest] = argv;
-    if (runtime && entrypoint && separator === "--") {
-        return [runtime, entrypoint, ...rest];
-    }
-    return argv;
-}
-//# sourceMappingURL=argv.js.map

package/dist/argv.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"argv.js","sourceRoot":"","sources":["../src/argv.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC7C,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAEvD,IAAI,OAAO,IAAI,UAAU,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/artifact-reference.d.ts

@@ -1,22 +0,0 @@
-/**
- * Decide whether to include a recorded artifact path in published evidence.
- *
- * Returns the path only when the producer confirms it actually wrote (or, for a
- * surface that attempts the write inline, attempted to write) the artifact. When
- * `wrote` is false the producer is declaring "I have no artifact here" and the
- * reference is dropped so the bundle never claims evidence that does not exist.
- *
- * This is intentionally producer-driven, not status-driven: a successful step that
- * failed to write its file should pass `wrote: true` (it believes it wrote one) so
- * the strict verifier still catches the broken producer. Only a step whose recorded
- * evidence IS the failure passes `wrote: false`.
- */
-export declare function artifactReferenceIfWritten(path: string | undefined, wrote: boolean): string | undefined;
-/**
- * True when a captured surface/step recorded a real screenshot artifact that the
- * producer wrote. A blocked capture/step whose evidence is the failure itself wrote
- * no screenshot, so it has no `screenshotPath` to reference.
- */
-export declare function hasWrittenScreenshot(capture: {
-    screenshotPath?: string;
-}): boolean;

package/dist/artifact-reference.js

@@ -1,47 +0,0 @@
-// Artifact-reference discipline: "never reference an artifact you did not write."
-//
-// `verifyRun` fails closed when a run bundle references a local evidence artifact
-// (a screenshot path, an embed URL, a `ui.screenshotUrl`) that does not exist on
-// disk or is zero-byte. That fail-closed behavior is correct and must NOT be
-// weakened. The honest fix lives on the PRODUCER side: a step or capture that did
-// not write an artifact must not claim one.
-//
-// A blocked/failed step where the failure itself is the recorded evidence wrote no
-// screenshot — so it must omit the reference, keeping its blocked status + reason
-// (the failure is the evidence). A step that claims SUCCESS but failed to write its
-// screenshot must STILL carry the reference so verify can catch the broken producer:
-// this guard never blanket-omits by status, it only lets a producer decline to
-// reference a path it knows it never wrote.
-//
-// The browser lane (src/run.ts + src/scripted-browser-actor.ts) imports this; the
-// terminal-product lane (src/e2b-terminal-lab.ts) inherits the same
-// discipline so neither path can reintroduce the missing-artifact verify failure.
-/**
- * Decide whether to include a recorded artifact path in published evidence.
- *
- * Returns the path only when the producer confirms it actually wrote (or, for a
- * surface that attempts the write inline, attempted to write) the artifact. When
- * `wrote` is false the producer is declaring "I have no artifact here" and the
- * reference is dropped so the bundle never claims evidence that does not exist.
- *
- * This is intentionally producer-driven, not status-driven: a successful step that
- * failed to write its file should pass `wrote: true` (it believes it wrote one) so
- * the strict verifier still catches the broken producer. Only a step whose recorded
- * evidence IS the failure passes `wrote: false`.
- */
-export function artifactReferenceIfWritten(path, wrote) {
-    if (!wrote) {
-        return undefined;
-    }
-    const trimmed = path?.trim();
-    return trimmed ? trimmed : undefined;
-}
-/**
- * True when a captured surface/step recorded a real screenshot artifact that the
- * producer wrote. A blocked capture/step whose evidence is the failure itself wrote
- * no screenshot, so it has no `screenshotPath` to reference.
- */
-export function hasWrittenScreenshot(capture) {
-    return Boolean(capture.screenshotPath?.trim());
-}
-//# sourceMappingURL=artifact-reference.js.map

package/dist/artifact-reference.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"artifact-reference.js","sourceRoot":"","sources":["../src/artifact-reference.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,EAAE;AACF,kFAAkF;AAClF,iFAAiF;AACjF,6EAA6E;AAC7E,kFAAkF;AAClF,4CAA4C;AAC5C,EAAE;AACF,mFAAmF;AACnF,kFAAkF;AAClF,oFAAoF;AACpF,qFAAqF;AACrF,+EAA+E;AAC/E,4CAA4C;AAC5C,EAAE;AACF,kFAAkF;AAClF,oEAAoE;AACpE,kFAAkF;AAElF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAwB,EAAE,KAAc;IACjF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAoC;IACvE,OAAO,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;AACjD,CAAC"}

package/dist/automatic-analysis-completion.d.ts

@@ -1,25 +0,0 @@
-import { type PreparedRunArtifactPaths } from "./run-paths.js";
-import type { StudyAnalysisConfig } from "./study-analysis.js";
-import { runAutomaticStudyAnalysis, type AutomaticStudyAnalysisDeps } from "./automatic-study-analysis.js";
-import type { AutomaticStudyAnalysisOutcome } from "./study-analysis-job.js";
-export interface AutomaticAnalysisHooks {
-    /** Provider/test dependencies apply only to analysis, never to the participant. */
-    deps?: AutomaticStudyAnalysisDeps;
-    /** Called after the source is finalized; the returned cleanup always runs. */
-    onStart?: () => void | (() => void);
-    run?: typeof runAutomaticStudyAnalysis;
-}
-export interface AutomaticAnalysisResult {
-    automaticAnalysis?: AutomaticStudyAnalysisOutcome;
-    /** Distinguishes the default missing-key skip from failure of an explicit request. */
-    automaticAnalysisTrigger?: "default" | "explicit";
-}
-/** Internal producer receipt: call only after final source publication, never for an early refusal. */
-export declare function markFinalizedStudyResult<T extends object>(result: T, prepared: PreparedRunArtifactPaths): T;
-/** One post-completion boundary shared by all live recording producers. */
-export declare function completeAutomaticAnalysis<T extends {
-    cwd: string;
-    runId: string;
-    dryRun: boolean;
-}>(result: T, config: StudyAnalysisConfig | undefined, hooks?: AutomaticAnalysisHooks, trigger?: "default" | "explicit", preferLargerOutput?: boolean): Promise<T & AutomaticAnalysisResult>;
-export declare function automaticAnalysisSucceeded(result: AutomaticAnalysisResult): boolean;

package/dist/automatic-analysis-completion.js

@@ -1,56 +0,0 @@
-import path from "node:path";
-import { validatePreparedRunRootIdentity } from "./run-paths.js";
-import { runAutomaticStudyAnalysis } from "./automatic-study-analysis.js";
-const finalizedResults = new WeakMap();
-/** Internal producer receipt: call only after final source publication, never for an early refusal. */
-export function markFinalizedStudyResult(result, prepared) {
-    finalizedResults.set(result, prepared);
-    return result;
-}
-/** One post-completion boundary shared by all live recording producers. */
-export async function completeAutomaticAnalysis(result, config, hooks, trigger = "explicit", preferLargerOutput = false) {
-    if (config === undefined)
-        return result;
-    const origin = trigger === "default" ? { automaticAnalysisTrigger: trigger } : {};
-    if (result.dryRun)
-        return { ...result, ...origin, automaticAnalysis: { state: "skipped", reason: "analysis_dry_run" } };
-    // An early refusal can echo a caller-supplied ID belonging to an older run.
-    // Require this invocation's internal final-publication receipt before reading that ID.
-    const prepared = finalizedResults.get(result);
-    if (!result.runId || result.runId === "not-created" || prepared === undefined) {
-        return { ...result, ...origin, automaticAnalysis: { state: "skipped", reason: "analysis_source_unavailable" } };
-    }
-    let cleanup = undefined;
-    try {
-        cleanup = hooks?.onStart?.();
-        try {
-            await validatePreparedRunRootIdentity(prepared);
-        }
-        catch {
-            return { ...result, ...origin, automaticAnalysis: { state: "failed", reason: "analysis_source_changed" } };
-        }
-        const sourceCwd = path.dirname(path.dirname(prepared.physicalRunsRoot));
-        const automaticAnalysis = await (hooks?.run ?? runAutomaticStudyAnalysis)(sourceCwd, result.runId, config, { ...hooks?.deps, preferLargerOutput, ...(trigger === "default" ? { defaultRequest: true } : {}), expectedRun: prepared });
-        return { ...result, ...origin, automaticAnalysis };
-    }
-    catch {
-        // Preserve the producer result. Never put a hook exception or provider response in the envelope.
-        return { ...result, ...origin, automaticAnalysis: { state: "failed", reason: "analysis_automatic_failed" } };
-    }
-    finally {
-        try {
-            cleanup?.();
-        }
-        catch { /* Cleanup cannot erase accounting or the completed recording. */ }
-    }
-}
-export function automaticAnalysisSucceeded(result) {
-    const value = result.automaticAnalysis;
-    if (value === undefined)
-        return true;
-    if (value.state === "skipped")
-        return value.reason === "analysis_dry_run"
-            || (result.automaticAnalysisTrigger === "default" && ["AUTOMATIC_ANALYSIS_KEY_MISSING", "AUTOMATIC_ANALYSIS_NO_PARTICIPANT_EVIDENCE"].includes(value.reason ?? ""));
-    return (value.state === "complete" || value.state === "partial") && value.result?.ok === true;
-}
-//# sourceMappingURL=automatic-analysis-completion.js.map

package/dist/automatic-analysis-completion.js.map

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

package/dist/automatic-analysis-config.d.ts

@@ -1,38 +0,0 @@
-import type { StudyAnalysisConfig } from "./study-analysis.js";
-export declare const DEFAULT_ANALYSIS_TIMEOUT_MS = 600000;
-export declare const DEFAULT_ANALYSIS_MAX_OUTPUT_TOKENS = 16384;
-/** An explicit provider selection for a separate review after a live participant study. */
-interface LabAnalysisSettings {
-    model?: string;
-    question?: string;
-    timeoutMs?: number;
-}
-export type LabAnalysis = LabAnalysisSettings & ({
-    provider?: "openai";
-    maxCostUsd: number;
-    maxOutputTokens?: number;
-} | {
-    provider: "codex";
-    maxCostUsd?: null;
-    maxOutputTokens?: null;
-});
-/** Called for parsed manifests AND direct library configs, before participant execution. */
-export declare function resolveAutomaticAnalysis(raw: unknown): {
-    ok: true;
-    config: StudyAnalysisConfig | undefined;
-    preferLargerOutput?: boolean;
-} | {
-    ok: false;
-    message: string;
-};
-export interface AutomaticAnalysisBudget {
-    provider?: "openai" | "codex";
-    billing?: "api-estimate" | "account-unknown";
-    model: string;
-    maxCostUsd: number | null;
-    trigger: "default" | "explicit";
-}
-/** Metadata only: resolving the future live-run budget never reads keys or dispatches. */
-export declare function automaticAnalysisBudget(raw: unknown, backend: string): AutomaticAnalysisBudget | undefined;
-export declare function formatAutomaticAnalysisBudget(budget: AutomaticAnalysisBudget): string;
-export {};

package/dist/automatic-analysis-config.js

@@ -1,68 +0,0 @@
-import { CODEX_ANALYSIS_MODEL, codexAnalysisIdentity } from "./study-analysis-codex-config.js";
-import { SUPPORTED_STUDY_ANALYSIS_MODELS } from "./study-analysis-engine.js";
-import { containsSensitive } from "./redaction.js";
-export const DEFAULT_ANALYSIS_TIMEOUT_MS = 600_000;
-export const DEFAULT_ANALYSIS_MAX_OUTPUT_TOKENS = 16_384;
-const MODELS = new Set(SUPPORTED_STUDY_ANALYSIS_MODELS);
-const FIELDS = new Set(["provider", "maxCostUsd", "model", "question", "timeoutMs", "maxOutputTokens"]);
-/** Called for parsed manifests AND direct library configs, before participant execution. */
-export function resolveAutomaticAnalysis(raw) {
-    if (raw === false)
-        return { ok: true, config: undefined };
-    if (raw === undefined)
-        raw = { maxCostUsd: 3 };
-    if (raw === null || typeof raw !== "object" || Array.isArray(raw)
-        || Object.keys(raw).some(key => !FIELDS.has(key))) {
-        return { ok: false, message: "review.analysis must be false or a mapping containing only provider, maxCostUsd, model, question, timeoutMs and maxOutputTokens." };
-    }
-    const value = raw;
-    if (value.provider !== undefined && value.provider !== "openai" && value.provider !== "codex") {
-        return { ok: false, message: "review.analysis.provider must be openai or codex." };
-    }
-    if (value.provider === "codex") {
-        const model = value.model === undefined ? CODEX_ANALYSIS_MODEL : value.model;
-        const timeoutMs = value.timeoutMs === undefined ? DEFAULT_ANALYSIS_TIMEOUT_MS : value.timeoutMs;
-        const question = value.question === undefined ? null : value.question;
-        if (model !== CODEX_ANALYSIS_MODEL || (value.maxCostUsd !== undefined && value.maxCostUsd !== null)
-            || (value.maxOutputTokens !== undefined && value.maxOutputTokens !== null)
-            || typeof timeoutMs !== "number" || !Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 600_000
-            || (value.question !== undefined && (typeof question !== "string" || question.length > 4000))) {
-            return { ok: false, message: "Codex analysis requires the qualified gpt-6-astra model and timeoutMs 1–600000. Dollar and output-token caps are unavailable; omit them. The optional question is limited to 4000 characters." };
-        }
-        if (question !== null && containsSensitive(question))
-            return { ok: false, message: "review.analysis.question contains sensitive text and cannot be sent for analysis." };
-        return { ok: true, config: { provider: "codex", model, question: question, timeoutMs,
-                maxCostUsd: null, maxOutputTokens: null, identity: codexAnalysisIdentity(model) } };
-    }
-    const { maxCostUsd } = value;
-    const model = value.model === undefined ? "gpt-6-astra" : value.model;
-    const question = value.question === undefined ? null : value.question;
-    const timeoutMs = value.timeoutMs === undefined ? DEFAULT_ANALYSIS_TIMEOUT_MS : value.timeoutMs;
-    const maxOutputTokens = value.maxOutputTokens === undefined ? DEFAULT_ANALYSIS_MAX_OUTPUT_TOKENS : value.maxOutputTokens;
-    if (typeof maxCostUsd !== "number" || !Number.isFinite(maxCostUsd) || maxCostUsd <= 0 || maxCostUsd > 1000
-        || typeof model !== "string" || !MODELS.has(model)
-        || typeof timeoutMs !== "number" || !Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 600_000
-        || typeof maxOutputTokens !== "number" || !Number.isSafeInteger(maxOutputTokens) || maxOutputTokens < 256 || maxOutputTokens > 32_768
-        || (value.question !== undefined && (typeof question !== "string" || question.length > 4000))) {
-        return { ok: false, message: "review.analysis requires a positive maxCostUsd up to 1000, a supported analysis model, timeoutMs 1–600000, maxOutputTokens 256–32768, and an optional question of at most 4000 characters." };
-    }
-    if (question !== null && containsSensitive(question)) {
-        return { ok: false, message: "review.analysis.question contains sensitive text and cannot be sent for analysis." };
-    }
-    return { ok: true, config: { ...(value.provider === undefined ? {} : { provider: "openai" }), model, maxCostUsd, timeoutMs, maxOutputTokens, question: question },
-        ...(value.maxOutputTokens === undefined ? { preferLargerOutput: true } : {}) };
-}
-/** Metadata only: resolving the future live-run budget never reads keys or dispatches. */
-export function automaticAnalysisBudget(raw, backend) {
-    if (!["cua", "scripted", "terminal", "shared-world", "concurrent-shared-world"].includes(backend))
-        return undefined;
-    const resolved = resolveAutomaticAnalysis(raw);
-    return resolved.ok && resolved.config ? { ...(resolved.config.provider === "codex" ? { provider: "codex", billing: "account-unknown" } : {}), model: resolved.config.model, maxCostUsd: resolved.config.maxCostUsd,
-        trigger: raw === undefined ? "default" : "explicit" } : undefined;
-}
-export function formatAutomaticAnalysisBudget(budget) {
-    if (budget.provider === "codex")
-        return `After live runs: Codex account analysis · ${budget.model} · separate restricted analyst with remote inference. Account limits apply; dollar cost and output-token ceiling are unknown. Set review.analysis: false to disable.`;
-    return `After live runs: ${budget.trigger} analysis · ${budget.model} · separate $${budget.maxCostUsd} admission estimate limit (not a provider billing cap). Set review.analysis: false to disable.`;
-}
-//# sourceMappingURL=automatic-analysis-config.js.map

package/dist/automatic-analysis-config.js.map

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

package/dist/automatic-study-analysis.d.ts

@@ -1,17 +0,0 @@
-import { type AnalyzeDeps } from "./study-analysis-service.js";
-import { type AutomaticStudyAnalysisView, type AutomaticStudyAnalysisOutcome, type AutomaticStudyAnalysisCancellation } from "./study-analysis-job.js";
-import type { StudyAnalysisConfig } from "./study-analysis.js";
-export type { AutomaticStudyAnalysisView, AutomaticStudyAnalysisOutcome, AutomaticStudyAnalysisCancellation } from "./study-analysis-job.js";
-export type AutomaticStudyAnalysisDeps = Omit<AnalyzeDeps, "analysisId" | "beforeDispatch"> & {
-    /** A missing default key records a skip before admission, preserving a successful recording. */
-    defaultRequest?: boolean;
-    /** Expand an omitted output limit only within the existing admission budget. */
-    preferLargerOutput?: boolean;
-};
-/** Small read-only TUI/CLI projection. Neither this nor Observer can resume a job. */
-export declare function readAutomaticStudyAnalysis(cwd: string, runId: string): Promise<AutomaticStudyAnalysisView | undefined>;
-export declare function requestAutomaticStudyAnalysisCancellation(cwd: string, runId: string): Promise<AutomaticStudyAnalysisCancellation>;
-/** One permanent claim per completed run, consumed even when preparation/cancellation fails.
- * Only the original producer calls this after all recording writes return.
- * No file reader, restart recovery, Observer poll or export calls this function. */
-export declare function runAutomaticStudyAnalysis(cwdInput: string, runId: string, configInput: StudyAnalysisConfig, deps?: AutomaticStudyAnalysisDeps): Promise<AutomaticStudyAnalysisOutcome>;