humanish 0.108.0 → 0.109.0

package/dist/routes/terminal/live-sandbox.js

@@ -18,6 +18,7 @@ import { TERMINAL_RUNTIME_VERSION_TIMEOUT_MS, buildRuntimeExecPrefix, buildRunti
 import { runWithWallClock, teardownSandbox } from "./sandbox.js";
 import { DEFAULT_REQUEST_TIMEOUT_MS, PRODUCT_SETUP_TIMEOUT_MS, SANDBOX_WORKDIR, UPLOAD_MAX_BYTES, } from "./types.js";
 import { terminalSandboxTimeoutMs } from "./lifetime.js";
+import { plural } from "../../run/text.js";
 export class LiveTerminalSandbox {
     status = "failed";
     completionReason = "harness_error";
@@ -109,7 +110,7 @@ export class LiveTerminalSandbox {
         // able to reach, without the ledger carrying any secret.
         recordLifecycle("terminal-lab.egress.policy", egressAllow === undefined
             ? "Egress is unrestricted (no execution.egressAllow declared)."
-            : `Egress routing allowlist: ${egressAllow.length} declared host(s): ${egressAllow.join(", ")}; deny-all fallback. Domain routing is not strict destination isolation on shared infrastructure.`);
+            : `Egress routing allowlist: ${plural(egressAllow.length, "declared host")}: ${egressAllow.join(", ")}; deny-all fallback. Domain routing is not strict destination isolation on shared infrastructure.`);
         recordLifecycle("terminal-lab.runtime-auth", runtimeEnv.mode === "openai-egress"
             ? "Runtime auth openai-egress: raw key remains outside the sandbox in the api.openai.com HTTPS Authorization transform; Codex receives an inert CODEX_API_KEY placeholder and the default OpenAI endpoint. Every sandbox process, including bootstrap/setup, can spend via this proxy; no added routing restriction or provider spending limit."
             : `Runtime auth openai-env: raw key from ${runtimeEnv.keyName} is passed command-scoped to Codex and inherited by its child processes.`);
@@ -207,7 +208,7 @@ export class LiveTerminalSandbox {
         // Same channel and same guarantees as the runtime bootstrap above: no runtime key touches it,
         // and a failure fails the run closed rather than handing the agent a half-built world. It
         // exists so a study can put the participant in a prepared project: asking an agent what
-        // studies a project contains, in an empty directory, measures the lab and not the product
+        // studies a project contains, in an empty directory, measures the study and not the product
         // (learned the hard way on the desktop route, labs/tui-self-study.yaml).
         const install = plan.product.install;
         if (install === undefined)

package/dist/routes/terminal/participant-text.js

@@ -1,5 +1,6 @@
 import { normalizeLocalActorTranscript } from "../../run/terminal-contract.js";
 import { MESSAGE_CHARS, PENDING_LINE_CHARS, TEXT_ITEMS_BYTES, TEXT_ITEMS_MAX } from "./types.js";
+import { plural } from "../../run/text.js";
 const itemEvents = new Set(["item.started", "item.updated", "item.completed"]);
 const nonempty = (value) => typeof value === "string" && value.trim().length > 0;
 const object = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
@@ -148,7 +149,7 @@ export function createTerminalParticipantReader(sanitize) {
             if (droppedLines > 0)
                 notices.push([
                     "agent output lines skipped",
-                    `Skipped ${droppedLines} stdout line(s) that ran past ${PENDING_LINE_CHARS} characters without a newline. Items on those lines are not in this trace or its counts.`,
+                    `Skipped ${plural(droppedLines, "stdout line")} that ran past ${PENDING_LINE_CHARS} characters without a newline. Items on those lines are not in this trace or its counts.`,
                 ]);
             notices.forEach(([title, text], index) => items.push({
                 id: `notice-${String(index + 1).padStart(3, "0")}`,

package/dist/routes/terminal/persona.d.ts

@@ -1,6 +1,6 @@
 import type { ActorPersonaRef } from "../../actors/contract.js";
-import { type ResolvedPersona } from "../../lab/persona.js";
-import type { TerminalPlan } from "../../lab/plan-types.js";
+import { type ResolvedPersona } from "../../study/persona.js";
+import type { TerminalPlan } from "../../study/plan-types.js";
 /** A terminal run's persona, resolved against the project's committed persona files. */
 export interface TerminalPersona {
     personaId: string;

package/dist/routes/terminal/persona.js

@@ -3,8 +3,8 @@
 // record come from one place. Each path keeps its own prompt and its own set of scrubbed secrets.
 import { realpath } from "node:fs/promises";
 import path from "node:path";
-import { personaBrief, personaToDirectives, renderPersonaPromptSection, } from "../../lab/persona.js";
-import { resolveCommittedPersona } from "../../lab/persona-resolve.js";
+import { personaBrief, personaToDirectives, renderPersonaPromptSection, } from "../../study/persona.js";
+import { resolveCommittedPersona } from "../../study/persona-resolve.js";
 import { prepareSelectedOutputDirectory } from "../../run/contained-output.js";
 /** Resolves the plan's persona; the resolver's warnings go into `warnings`. */
 export async function resolveTerminalPersona(args) {

package/dist/routes/terminal/plan.d.ts

@@ -1,16 +1,16 @@
-import type { RoutePlanResult, RouteRefusal, TerminalPlan } from "../../lab/plan-types.js";
-import type { LabConfig } from "../../lab/types.js";
-import { type TerminalProductLabResult } from "./types.js";
-/** The error a terminal lab returns before a run starts. `actor` names the registered actor. */
-export interface TerminalRefusal extends RouteRefusal<"terminal", NonNullable<TerminalProductLabResult["error"]>["code"]> {
+import type { RoutePlanResult, RouteRefusal, TerminalPlan } from "../../study/plan-types.js";
+import type { StudyConfig } from "../../study/types.js";
+import { type TerminalProductStudyResult } from "./types.js";
+/** The error a terminal study returns before a run starts. `actor` names the registered actor. */
+export interface TerminalRefusal extends RouteRefusal<"terminal", NonNullable<TerminalProductStudyResult["error"]>["code"]> {
     readonly actor?: string;
 }
 export type TerminalPlanResult = RoutePlanResult<TerminalPlan, TerminalRefusal>;
 /**
- * Plan a terminal-product lab. It is called for any config handed to the terminal runner, not
+ * Plan a terminal-product study. It is called for any config handed to the terminal runner, not
  * only one routeOf sends here, so a config for another route gets this route's refusal.
  */
-export declare function planTerminalLab(config: LabConfig, input: {
+export declare function planTerminalStudy(config: StudyConfig, input: {
     readonly dryRun: boolean;
     /** A test's costProbe can measure spend lines, so a positive maxUsd can trip. */
     readonly hasCostProbe?: boolean;

package/dist/routes/terminal/plan.js

@@ -5,24 +5,24 @@ import { DEFAULT_OPENAI_CU_MODEL } from "../../actors/computer-use/openai-provid
 import { resolveAutomaticAnalysis } from "../../analysis/automatic-config.js";
 import { isReasoningEffort } from "../../actors/reasoning-effort.js";
 import { actorRegistry, isTerminalActorDescriptor } from "../../actors/registry.js";
-import { isNonEmpty, planBase } from "../../lab/plan-base.js";
-import { desktopMediaValidationReason, taskProtocolValidationReason, } from "../../lab/validation.js";
+import { isNonEmpty, planBase } from "../../study/plan-base.js";
+import { desktopMediaValidationReason, taskProtocolValidationReason, } from "../../study/validation.js";
 import { MAX_SANDBOX_MS } from "../../substrates/e2b/lifetime.js";
 import { NODE_BOOTSTRAP_TIMEOUT_MS } from "../../subject/node-bootstrap.js";
 import { terminalSandboxTimeoutMs } from "./lifetime.js";
 import { isExactRuntimeVersion, TERMINAL_RUNTIME_VERSION_TIMEOUT_MS } from "./runtime.js";
 import { PRODUCT_SETUP_TIMEOUT_MS, TERMINAL_SANDBOX_TIMEOUT_BUFFER_MS, } from "./types.js";
 /**
- * Plan a terminal-product lab. It is called for any config handed to the terminal runner, not
+ * Plan a terminal-product study. It is called for any config handed to the terminal runner, not
  * only one routeOf sends here, so a config for another route gets this route's refusal.
  */
-export function planTerminalLab(config, input) {
+export function planTerminalStudy(config, input) {
     const refuse = (code, message, actor) => ({
         ok: false,
         refusal: { route: "terminal", code, message, ...(actor === undefined ? {} : { actor }) },
     });
     if (String(config.comms?.email?.kind) === "real")
-        return refuse("HUMANISH_TERMINAL_SUBJECT_INVALID", "Real email receiving is unsupported on the terminal route. Use a supported hosted computer-use browser lab.");
+        return refuse("HUMANISH_TERMINAL_SUBJECT_INVALID", "Real email receiving is unsupported on the terminal route. Use a supported hosted computer-use browser study.");
     const mediaReason = desktopMediaValidationReason(config);
     if (mediaReason)
         return refuse("HUMANISH_TERMINAL_SUBJECT_INVALID", mediaReason);

package/dist/routes/terminal/result.d.ts

@@ -1,7 +1,7 @@
 import type { ObserverResult } from "../../observer/render.js";
 import type { ActorCompletionReason, ActorStatus, ActorTrace } from "../../actors/contract.js";
 import { type ExecutionFailure, type ExecutionOutcome, type Judgment, type ParticipantFacts } from "../../run/judge.js";
-import { type NoSpendProof, type TerminalCostLedger, type TerminalLedgers, type TerminalProductLabResult } from "./types.js";
+import { type NoSpendProof, type TerminalCostLedger, type TerminalLedgers, type TerminalProductStudyResult } from "./types.js";
 /**
  * What judge.ts reads from a finished terminal session, after a blown cap has overridden it. It has
  * no engagement or blocker rule: the agent's nonce-verified marker is its declared outcome.
@@ -20,10 +20,10 @@ export declare function terminalExecutionFailures(args: {
     cleanup: TerminalLedgers["cleanup"];
     observer: Pick<ObserverResult, "ok" | "error">;
 }): ExecutionFailure[];
-/** The terminal-product lab result for a live run, from its session, cleanup and cost ledger. */
-export declare function terminalLabResult(args: {
+/** The terminal-product study result for a live run, from its session, cleanup and cost ledger. */
+export declare function terminalStudyResult(args: {
     cwd: string;
-    labId: string;
+    studyId: string;
     actorId: string;
     productName: string;
     runId: string;
@@ -44,4 +44,4 @@ export declare function terminalLabResult(args: {
     execution: ExecutionOutcome;
     observer: ObserverResult;
     warnings: string[];
-}): TerminalProductLabResult;
+}): TerminalProductStudyResult;

package/dist/routes/terminal/result.js

@@ -39,17 +39,17 @@ export function terminalExecutionFailures(args) {
             : [
                 {
                     kind: "evidence",
-                    message: observer.error?.message ?? "Observer failed for the terminal-product lab run.",
+                    message: observer.error?.message ?? "Observer failed for the terminal-product run.",
                 },
             ]),
     ];
 }
-/** The terminal-product lab result for a live run, from its session, cleanup and cost ledger. */
-export function terminalLabResult(args) {
-    const { cwd, labId, actorId, productName, runId, sessionStatus, completionReason, sessionReason, sessionError, sandboxId, cleanup, cost, noSpendProof, capFailure, declaredScorerFailure, judgment, execution, observer, warnings, } = args;
-    // The lab's exit code: verified evidence, no harness error and proven cleanup. A blocked/
+/** The terminal-product study result for a live run, from its session, cleanup and cost ledger. */
+export function terminalStudyResult(args) {
+    const { cwd, studyId, actorId, productName, runId, sessionStatus, completionReason, sessionReason, sessionError, sandboxId, cleanup, cost, noSpendProof, capFailure, declaredScorerFailure, judgment, execution, observer, warnings, } = args;
+    // The run's exit code: verified evidence, no harness error and proven cleanup. A blocked/
     // timed-out agent run is still ok-as-evidence at the bundle level (the failure is the evidence),
-    // but the lab result surfaces ok:false on a harness error or unproven teardown (fail-closed).
+    // but the study result surfaces ok:false on a harness error or unproven teardown (fail-closed).
     // remaining===0 is the by-id-confirmed-reclaimed state; remaining===1 (still present) and
     // remaining===-1 (kill(id) itself failed) are both unproven by design.
     const cleanupProven = cleanup.killed && cleanup.remaining === 0;
@@ -63,7 +63,7 @@ export function terminalLabResult(args) {
         policy: OUTCOME_POLICIES.terminal,
     });
     return {
-        ...studyResultIdentity("terminal", labId),
+        ...studyResultIdentity("terminal", studyId),
         ok,
         cwd,
         actor: actorId,

package/dist/routes/terminal/route.d.ts

@@ -1,22 +1,22 @@
 import { type TerminalRefusal } from "./plan.js";
-import type { TerminalPlan } from "../../lab/plan-types.js";
-import type { AdmittedPlan } from "../../run-lab.js";
-import { type RunTerminalProductLabOptions, type TerminalProductLabResult, type TerminalRunInput } from "./types.js";
+import type { TerminalPlan } from "../../study/plan-types.js";
+import type { AdmittedPlan } from "../../run-study.js";
+import { type RunTerminalProductStudyOptions, type TerminalProductStudyResult, type TerminalRunInput } from "./types.js";
 /**
  * The config-taking entry point. It plans, returns a refusal with the same envelope and analysis
  * record the route has always returned, and otherwise runs the plan.
  */
-export declare function runTerminalProductLab(options: RunTerminalProductLabOptions): Promise<TerminalProductLabResult>;
-/** A refused terminal lab's result: the route's envelope, and the analysis record a refusal gets. */
-export declare function terminalLabRefusal(options: RunTerminalProductLabOptions, refusal: TerminalRefusal): Promise<TerminalProductLabResult>;
+export declare function runTerminalProductStudy(options: RunTerminalProductStudyOptions): Promise<TerminalProductStudyResult>;
+/** A refused terminal study's result: the route's envelope, and the analysis record a refusal gets. */
+export declare function terminalStudyRefusal(options: RunTerminalProductStudyOptions, refusal: TerminalRefusal): Promise<TerminalProductStudyResult>;
 /**
  * Run a terminal plan. The run scope gives a direct library caller the same run lifetime the CLI
- * gets: whichever of its fail-closed exits the lab takes, the run it started is closed, and only a
+ * gets: whichever of its fail-closed exits the run takes, the run it started is closed, and only a
  * run that published its final bundle reaches automatic analysis.
  */
-export declare function runTerminalPlan(plan: TerminalPlan, input: TerminalRunInput): Promise<TerminalProductLabResult>;
+export declare function runTerminalPlan(plan: TerminalPlan, input: TerminalRunInput): Promise<TerminalProductStudyResult>;
 /**
- * runLab's step for a terminal plan. It runs a live plan's local checks (checkLiveTerminalMachine)
+ * runStudyWith's step for a terminal plan. It runs a live plan's local checks (checkLiveTerminalMachine)
  * before any run scope opens, so the CLI can present their refusal before it loads a declared
  * scorer, and returns the run that continues from them with that scorer.
  */

package/dist/routes/terminal/route.js

@@ -1,6 +1,6 @@
 // The terminal-product route: a real autonomous agent (Codex) studies a CLI or product from its
 // public surfaces only, inside an E2B shell. The flow:
-//   1. admit: planTerminalLab refuses what the plan cannot hold, then a live plan's machine checks
+//   1. admit: planTerminalStudy refuses what the plan cannot hold, then a live plan's machine checks
 //      (checkLiveTerminalMachine) run before any run scope opens, so the CLI can refuse before it
 //      loads a declared scorer;
 //   2. open the run scope;
@@ -47,29 +47,29 @@ import { resolveAutomaticAnalysis } from "../../analysis/automatic-config.js";
 import { completeAutomaticAnalysis } from "../../analysis/automatic-completion.js";
 import path from "node:path";
 import { runScope } from "../../run/run.js";
-import { planTerminalLab } from "./plan.js";
-import { runDryTerminalLab } from "./dry-run.js";
+import { planTerminalStudy } from "./plan.js";
+import { runDryTerminalStudy } from "./dry-run.js";
 import { checkLiveTerminalMachine, runLiveTerminalSession } from "./session.js";
-import { terminalRouteScorer } from "../../lab/adapter-scorer-loader.js";
-import { withLateScorer } from "../../lab/route-inputs.js";
+import { terminalRouteScorer } from "../../study/adapter-scorer-loader.js";
+import { withLateScorer } from "../../study/route-inputs.js";
 import {} from "./types.js";
 import { studyResultIdentity } from "../../run/study-result.js";
 /**
  * The config-taking entry point. It plans, returns a refusal with the same envelope and analysis
  * record the route has always returned, and otherwise runs the plan.
  */
-export async function runTerminalProductLab(options) {
+export async function runTerminalProductStudy(options) {
     const { config, dryRun, ...input } = options;
-    const planned = planTerminalLab(config, {
+    const planned = planTerminalStudy(config, {
         dryRun,
         hasCostProbe: input.deps?.costProbe !== undefined,
     });
     if (planned.ok)
         return runTerminalPlan(planned.plan, input);
-    return terminalLabRefusal(options, planned.refusal);
+    return terminalStudyRefusal(options, planned.refusal);
 }
-/** A refused terminal lab's result: the route's envelope, and the analysis record a refusal gets. */
-export function terminalLabRefusal(options, refusal) {
+/** A refused terminal study's result: the route's envelope, and the analysis record a refusal gets. */
+export function terminalStudyRefusal(options, refusal) {
     const { config, dryRun } = options;
     const refused = {
         ...studyResultIdentity("terminal", config.id),
@@ -88,7 +88,7 @@ export function terminalLabRefusal(options, refusal) {
 }
 /**
  * Run a terminal plan. The run scope gives a direct library caller the same run lifetime the CLI
- * gets: whichever of its fail-closed exits the lab takes, the run it started is closed, and only a
+ * gets: whichever of its fail-closed exits the run takes, the run it started is closed, and only a
  * run that published its final bundle reaches automatic analysis.
  */
 export async function runTerminalPlan(plan, input) {
@@ -96,7 +96,7 @@ export async function runTerminalPlan(plan, input) {
     return admission.ok ? runAdmittedTerminalRun(admission.admitted, input) : admission.result;
 }
 /**
- * runLab's step for a terminal plan. It runs a live plan's local checks (checkLiveTerminalMachine)
+ * runStudyWith's step for a terminal plan. It runs a live plan's local checks (checkLiveTerminalMachine)
  * before any run scope opens, so the CLI can present their refusal before it loads a declared
  * scorer, and returns the run that continues from them with that scorer.
  */
@@ -141,7 +141,7 @@ function completeTerminalAnalysis(plan, input, result, finished) {
 function terminalFailure(plan, input, warnings) {
     const cwd = path.resolve(input.cwd);
     return (code, message) => ({
-        ...studyResultIdentity("terminal", plan.labId),
+        ...studyResultIdentity("terminal", plan.studyId),
         ok: false,
         cwd,
         actor: plan.actor,
@@ -165,5 +165,5 @@ async function runTerminalPlanInScope(admitted, input, scope) {
         const { plan, runtimeEnv } = admitted;
         return runLiveTerminalSession({ plan, input, cwd, warnings, failed, scope, runtimeEnv });
     }
-    return runDryTerminalLab({ plan: admitted.plan, input, cwd, warnings, failed, scope });
+    return runDryTerminalStudy({ plan: admitted.plan, input, cwd, warnings, failed, scope });
 }

package/dist/routes/terminal/session.d.ts

@@ -1,4 +1,4 @@
-import type { LiveTerminalAuth, LiveTerminalPlan, RunLiveTerminalSessionArgs, TerminalProductLabErrorCode, TerminalProductLabResult, TerminalRunInput } from "./types.js";
+import type { LiveTerminalAuth, LiveTerminalPlan, RunLiveTerminalSessionArgs, TerminalProductStudyErrorCode, TerminalProductStudyResult, TerminalRunInput } from "./types.js";
 /**
  * The checks of this machine a live run makes before its run starts: the runtime key and
  * E2B_API_KEY. They read only the plan and the environment, so the CLI makes them before it loads
@@ -9,17 +9,17 @@ export declare function checkLiveTerminalMachine(plan: LiveTerminalPlan, input:
     readonly runtimeEnv: LiveTerminalAuth;
 } | {
     readonly ok: false;
-    readonly code: TerminalProductLabErrorCode;
+    readonly code: TerminalProductStudyErrorCode;
     readonly message: string;
 };
 /**
- * The live in-sandbox agent session orchestrator (mirror of runCuaActorLab's E2B branch). Enforces
+ * The live in-sandbox agent session orchestrator (mirror of runCuaActorStudy's E2B branch). Enforces
  * the 8-point safety contract by construction; fails closed before any sandbox/key/spend on any
  * precondition miss. Persists the substrate-lifecycle/command-log/interventions/cleanup ledgers,
  * the redacted terminal event stream + normalized transcript, the agent report, and the
  * provider-neutral actor trace; tears the sandbox down in a finally and proves the teardown.
  */
-export declare function runLiveTerminalSession(args: RunLiveTerminalSessionArgs): Promise<TerminalProductLabResult>;
-/** The default mission when the lab omits one. Public-safe, product-neutral author text. */
+export declare function runLiveTerminalSession(args: RunLiveTerminalSessionArgs): Promise<TerminalProductStudyResult>;
+/** The default mission when the study omits one. Public-safe, product-neutral author text. */
 export declare function defaultMission(productName: string): string;
 export declare function makeTerminalRunId(): string;

package/dist/routes/terminal/session.js

@@ -1,5 +1,5 @@
 import { randomBytes, randomUUID } from "node:crypto";
-import { missingKeys } from "../../lab/requirements.js";
+import { missingKeys } from "../../study/requirements.js";
 import { declaredRuntimeProvenance } from "./runtime.js";
 import { digestText, redactText, scrubLiterals } from "../../evidence/redaction.js";
 import { describeMissingKeys } from "../../keys/key-resolution.js";
@@ -18,7 +18,7 @@ import { finishLiveTerminalSession } from "./live-finish.js";
 export function checkLiveTerminalMachine(plan, input, warnings) {
     const env = input.env ?? process.env;
     const { maxUsd } = plan.caps;
-    // planTerminalLab refuses a positive maxUsd without a costProbe, so one is present here.
+    // planTerminalStudy refuses a positive maxUsd without a costProbe, so one is present here.
     if (maxUsd > 0) {
         warnings.push(`scenario.caps.maxUsd=${maxUsd} is checked after the session against the lines the costProbe measures; lines it leaves null (unmeasured) never trip it. scenario.caps.maxMinutes bounds the run while it runs.`);
     }
@@ -32,13 +32,13 @@ export function checkLiveTerminalMachine(plan, input, warnings) {
         return {
             ok: false,
             code: "HUMANISH_TERMINAL_KEYS_MISSING",
-            message: `Live terminal-product labs need E2B_API_KEY in the environment (values are never persisted). ${describeMissingKeys(["E2B_API_KEY"], env)}`,
+            message: `Live terminal-product studies need E2B_API_KEY in the environment (values are never persisted). ${describeMissingKeys(["E2B_API_KEY"], env)}`,
         };
     }
     return { ok: true, runtimeEnv };
 }
 /**
- * The live in-sandbox agent session orchestrator (mirror of runCuaActorLab's E2B branch). Enforces
+ * The live in-sandbox agent session orchestrator (mirror of runCuaActorStudy's E2B branch). Enforces
  * the 8-point safety contract by construction; fails closed before any sandbox/key/spend on any
  * precondition miss. Persists the substrate-lifecycle/command-log/interventions/cleanup ledgers,
  * the redacted terminal event stream + normalized transcript, the agent report, and the
@@ -61,7 +61,7 @@ export async function runLiveTerminalSession(args) {
         mintRunId: makeTerminalRunId,
         // This entry point is the live terminal route; its dry-run sibling is a separate function.
         mode: "live",
-        lab: plan.lab,
+        study: plan.study,
         renderReview: renderTerminalReviewMarkdown,
         observer: { open: input.open === true, render: deps.renderObserver },
         now,
@@ -101,7 +101,7 @@ export async function runLiveTerminalSession(args) {
         maxMinutes,
         e2bApiKey,
         runPaths,
-        metadata: buildSandboxMetadata({ labId: plan.labId, recordId: "sim-001", runId }),
+        metadata: buildSandboxMetadata({ studyId: plan.studyId, recordId: "sim-001", runId }),
         warnings,
         recorder,
     });
@@ -192,7 +192,7 @@ function composeLivePrompt(args) {
         `When finished, print exactly one final machine-readable line in this format: HUMANISH_ACTOR_VERDICT=<status> HUMANISH_ACTOR_NONCE=${args.verdictNonce} where <status> is passed, blocked, or failed.`,
     ].join("\n");
 }
-/** The default mission when the lab omits one. Public-safe, product-neutral author text. */
+/** The default mission when the study omits one. Public-safe, product-neutral author text. */
 export function defaultMission(productName) {
     return `You are an autonomous agent. Discover ${productName} from its public surfaces and determine whether it can help with a durable real task. Stay within the declared no-spend caps. Leave feedback if the workflow is confusing.`;
 }

package/dist/routes/terminal/trace.d.ts

@@ -1,5 +1,5 @@
 import type { ActorCompletionReason, ActorPersonaRef, ActorRuntimeProvenance, ActorStatus, ActorTokenUsage, ActorTrace } from "../../actors/contract.js";
-import type { LabRuntimeAuth } from "../../lab/types.js";
+import type { StudyRuntimeAuth } from "../../study/types.js";
 import type { TerminalParticipantText } from "./participant-text.js";
 import { type CommandLogRecord, type TerminalEventRecord } from "./types.js";
 /**
@@ -27,7 +27,7 @@ export declare function buildTerminalActorTrace(args: {
     terminalEvents: TerminalEventRecord[];
     commandLog: CommandLogRecord[];
     transcriptTail: string;
-    runtimeAuth: LabRuntimeAuth;
+    runtimeAuth: StudyRuntimeAuth;
     runtime: ActorRuntimeProvenance;
     /** Runtime-turn aggregate usage parsed from the exec stream. Absent when the stream
      *  carried no usage record, which stays distinct from a measured zero. */

package/dist/routes/terminal/types.d.ts

@@ -1,17 +1,17 @@
-import type { LabEvent } from "../../lab/run-lab-events.js";
+import type { StudyEvent } from "../../study/run-study-events.js";
 import { type AutomaticAnalysisResult } from "../../analysis/automatic-completion.js";
 import type { ActorCompletionReason, ActorRuntimeProvenance, ActorStatus, ActorTrace } from "../../actors/contract.js";
 import type { CostCategory } from "../../run/terminal-contract.js";
 import type { RunScope } from "../../run/run.js";
 import type { buildRuntimeAuth } from "./credentials.js";
-import type { TerminalPlan } from "../../lab/plan-types.js";
-import type { LabDeps } from "../../lab/lab-deps.js";
-import type { LabConfig } from "../../lab/types.js";
+import type { TerminalPlan } from "../../study/plan-types.js";
+import type { StudyDeps } from "../../study/study-deps.js";
+import type { StudyConfig } from "../../study/types.js";
 import type { ObserverResult } from "../../observer/render.js";
 import { type RunAdapterScore, type RunBundle, type RunFeedbackCandidate, type RunScorerProvenance } from "../../run/bundle.js";
 import { type StudyResultIdentity } from "../../run/study-result.js";
-/** Provider-neutral metadata constant: the route's non-secret tag (mirrors CUA_ACTOR_LAB_PROVIDER_METADATA). */
-export declare const TERMINAL_PRODUCT_LAB_PROVIDER_METADATA: {
+/** Provider-neutral metadata constant: the route's non-secret tag (mirrors CUA_ACTOR_STUDY_PROVIDER_METADATA). */
+export declare const TERMINAL_PRODUCT_STUDY_PROVIDER_METADATA: {
     readonly mode: "terminal-product-lab";
     readonly tool: "humanish";
 };
@@ -61,20 +61,20 @@ export interface TerminalProductScoringContext {
     transcript: string;
     /** The studied product name (public-safe). */
     product: string;
-    /** The lab id (the run's scenario scope). */
-    labId: string;
+    /** The study id (the run's scenario scope). */
+    studyId: string;
     /** The run id (for building namespaced idempotency keys + evidence pointers). */
     runId: string;
 }
 /**
  * Known spend lines for the terminal cost ledger. Core has no product, media or payment spend
  * signal, so it fills only the provider line from trace tokenUsage when present. A test injects
- * known lines through `LabDeps.costProbe`; absent signals keep the null-discipline default.
+ * known lines through `StudyDeps.costProbe`; absent signals keep the null-discipline default.
  */
 export type TerminalCostProbe = (context: {
     tokenCostUsd?: number;
 }) => Partial<Record<"product" | "media" | "payment" | "provider", CostLine>> | undefined;
-/** The scorer functions a terminal run calls: `RunLabOptions.scorer` without `deriveArtifacts`. */
+/** The scorer functions a terminal run calls: `RunStudyOptions.scorer` without `deriveArtifacts`. */
 export interface TerminalScorer {
     /**
      * The adapter extension seam: product-adapter hooks without forking
@@ -97,13 +97,13 @@ export interface TerminalScorer {
      */
     deriveFeedback?: (ctx: TerminalProductScoringContext) => RunFeedbackCandidate[] | Promise<RunFeedbackCandidate[]>;
 }
-export interface RunTerminalProductLabOptions {
+export interface RunTerminalProductStudyOptions {
     /** Cancels post-run analysis only. */
     analysisSignal?: AbortSignal;
-    /** Reports the analysis window to onEvent; built by normalizeRunLabOptions. */
-    emit?: (event: LabEvent) => void;
+    /** Reports the analysis window to onEvent; built by normalizeRunStudyOptions. */
+    emit?: (event: StudyEvent) => void;
     cwd: string;
-    config: LabConfig;
+    config: StudyConfig;
     /** Resolved upstream (scenario.mode + CLI override); defaults safe (dry-run). */
     dryRun: boolean;
     open?: boolean;
@@ -117,7 +117,7 @@ export interface RunTerminalProductLabOptions {
     env?: Readonly<Record<string, string | undefined>>;
     scorer?: TerminalScorer;
     /** Test seams: the E2B module, the Observer renderer, the clock and the cost probe. */
-    deps?: LabDeps;
+    deps?: StudyDeps;
     /**
      * Present only when the scorer was config-declared and loaded by the CLI. Its presence
      * is the "declared" marker: a config-declared terminal scorer returning status:"fail" flips
@@ -127,10 +127,10 @@ export interface RunTerminalProductLabOptions {
      */
     scorerProvenance?: RunScorerProvenance;
 }
-export interface TerminalProductLabResult extends AutomaticAnalysisResult, StudyResultIdentity<"terminal"> {
+export interface TerminalProductStudyResult extends AutomaticAnalysisResult, StudyResultIdentity<"terminal"> {
     /** True when the bundle verified and (dry-run, or the live session reached a terminal verdict
      *  without a harness error + cleanup was proven). The agent's pass/fail is evidence, not the
-     *  lab's exit code. */
+     *  run's exit code. */
     ok: boolean;
     cwd: string;
     /** The registry-resolved actor id that ran (or would run) the session. */
@@ -171,7 +171,7 @@ export interface TerminalProductLabResult extends AutomaticAnalysisResult, Study
     observer?: ObserverResult;
     warnings: string[];
     error?: {
-        code: "HUMANISH_STUDY_ANALYSIS_INVALID" | "HUMANISH_STUDY_TASKS_UNSUPPORTED" | "HUMANISH_STUDY_OPTION_UNSUPPORTED" | "HUMANISH_TERMINAL_FAILED" | "HUMANISH_TERMINAL_ACTOR_UNSUPPORTED" | "HUMANISH_TERMINAL_SUBJECT_INVALID" | "HUMANISH_TERMINAL_KEYPLACEMENT_INVALID" | "HUMANISH_TERMINAL_RUNTIME_AUTH_MISSING" | "HUMANISH_TERMINAL_KEYS_MISSING" | "HUMANISH_TERMINAL_CAPS_MISSING" | "HUMANISH_TERMINAL_CAPS_INVALID" | "HUMANISH_TERMINAL_UNPRICED_CAP" | "HUMANISH_TERMINAL_CAPS_EXCEEDED" | "HUMANISH_TERMINAL_CREDENTIAL_DENIED" | "HUMANISH_TERMINAL_CLEANUP_UNPROVEN" | "HUMANISH_RUN_ID_IN_USE";
+        code: "HUMANISH_STUDY_ANALYSIS_INVALID" | "HUMANISH_STUDY_TASKS_UNSUPPORTED" | "HUMANISH_STUDY_OPTION_UNSUPPORTED" | "HUMANISH_STUDY_V2_UNSUPPORTED" | "HUMANISH_TERMINAL_FAILED" | "HUMANISH_TERMINAL_ACTOR_UNSUPPORTED" | "HUMANISH_TERMINAL_SUBJECT_INVALID" | "HUMANISH_TERMINAL_KEYPLACEMENT_INVALID" | "HUMANISH_TERMINAL_RUNTIME_AUTH_MISSING" | "HUMANISH_TERMINAL_KEYS_MISSING" | "HUMANISH_TERMINAL_CAPS_MISSING" | "HUMANISH_TERMINAL_CAPS_INVALID" | "HUMANISH_TERMINAL_UNPRICED_CAP" | "HUMANISH_TERMINAL_CAPS_EXCEEDED" | "HUMANISH_TERMINAL_CREDENTIAL_DENIED" | "HUMANISH_TERMINAL_CLEANUP_UNPROVEN" | "HUMANISH_RUN_ID_IN_USE";
         message: string;
     };
 }
@@ -309,13 +309,13 @@ export interface TerminalLedgers {
     /** The no-spend proof derived from `cost`. Never an independent assertion. */
     noSpendProof: NoSpendProof;
 }
-/** What a terminal run takes besides its plan. The plan carries the config, dry run and lab. */
-export type TerminalRunInput = Omit<RunTerminalProductLabOptions, "config" | "dryRun" | "lab">;
-/** A live terminal plan: its caps are the fail-closed ones planTerminalLab required. */
+/** What a terminal run takes besides its plan. The plan carries the config, dry run and study. */
+export type TerminalRunInput = Omit<RunTerminalProductStudyOptions, "config" | "dryRun">;
+/** A live terminal plan: its caps are the fail-closed ones planTerminalStudy required. */
 export type LiveTerminalPlan = Extract<TerminalPlan, {
     readonly dryRun: false;
 }>;
-export type TerminalProductLabErrorCode = NonNullable<TerminalProductLabResult["error"]>["code"];
+export type TerminalProductStudyErrorCode = NonNullable<TerminalProductStudyResult["error"]>["code"];
 /** The runtime key's command-scoped placement, built by a live run's checks of this machine. */
 export type LiveTerminalAuth = Extract<ReturnType<typeof buildRuntimeAuth>, {
     ok: true;
@@ -325,8 +325,8 @@ export interface RunLiveTerminalSessionArgs {
     input: TerminalRunInput;
     cwd: string;
     warnings: string[];
-    failed: (code: TerminalProductLabErrorCode, message: string) => TerminalProductLabResult;
-    /** The lab's run scope; the live session starts its run in it. */
+    failed: (code: TerminalProductStudyErrorCode, message: string) => TerminalProductStudyResult;
+    /** The study's run scope; the live session starts its run in it. */
     scope: RunScope;
     runtimeEnv: LiveTerminalAuth;
 }

package/dist/routes/terminal/types.js

@@ -1,8 +1,8 @@
 import {} from "../../analysis/automatic-completion.js";
 import {} from "../../run/bundle.js";
 import {} from "../../run/study-result.js";
-/** Provider-neutral metadata constant: the route's non-secret tag (mirrors CUA_ACTOR_LAB_PROVIDER_METADATA). */
-export const TERMINAL_PRODUCT_LAB_PROVIDER_METADATA = {
+/** Provider-neutral metadata constant: the route's non-secret tag (mirrors CUA_ACTOR_STUDY_PROVIDER_METADATA). */
+export const TERMINAL_PRODUCT_STUDY_PROVIDER_METADATA = {
     mode: "terminal-product-lab",
     tool: "humanish",
 };

package/dist/run/bundle.d.ts

@@ -89,7 +89,7 @@ export interface RunAdapterArtifact {
  * Provenance for a config-declared adopter scorer: the repo-relative entry path and a digest
  * of its entry-module bytes, recorded so a `review.scorer.ref`/`--scorer` run states which
  * out-of-tree judgment it attached. Core-computed (path + digest), never adopter-supplied. A library
- * caller (hooks passed directly through RunLabOptions) has implicit provenance, because its code is its
+ * caller (hooks passed directly through RunStudyOptions) has implicit provenance, because its code is its
  * provenance, so this block is absent there and every older bundle stays byte-stable + verifiable.
  *
  * The digest pins the entry file's identity only; modules it loads are outside it: a `export { score } from
@@ -135,7 +135,7 @@ export interface RunEvent {
  * One executed (or declared) subject-state seed step. Live records carry execution fields
  * (ok/exitCode/timedOut/durationMs); dry-run "declared, not run" records carry only the
  * declaration (name, phase, command digest). The command itself never persists; the digest
- * pins "same recipe" across bundles while the lab YAML in the consumer's repo stays the
+ * pins "same recipe" across bundles while the study YAML in the consumer's repo stays the
  * plaintext source of truth (publish-safe by construction).
  */
 export interface RunSubjectStateStepRecord {
@@ -336,7 +336,7 @@ export interface RunBundle {
      * `lab` and the source convention of older bundles, through studyProvenanceOf.
      */
     study?: RunStudyProvenance;
-    /** `study`'s value, written beside it until 0.109. */
+    /** `study`'s value, as runs saved by 0.108 and earlier wrote it. humanish no longer writes it. */
     lab?: RunStudyProvenance;
     /**
      * Optional, additive run-level cost estimate (humanish.run-cost-summary.v1): the sum of every
@@ -489,7 +489,7 @@ export interface ReviewSummary {
      */
     participants?: ParticipantOutcomes;
     /**
-     * The study's per-task completion rates, present only when the lab declared a protocol
+     * The study's per-task completion rates, present only when the study declared a protocol
      * and at least one session produced a funnel. Absent means no protocol was measured, never that
      * everyone finished.
      */
@@ -527,11 +527,11 @@ export interface BundleRun {
     readonly mode: RunBundle["mode"];
     readonly createdAt: string;
     /** The manifest the run came from, as the plan carried it to startRun. */
-    readonly lab?: RunStudyProvenance | undefined;
+    readonly study?: RunStudyProvenance | undefined;
 }
 /**
  * The fields every run bundle starts with, in the saved order. The run supplies its id, mode,
- * start time and lab; the route passes the participant count and source. The public target cwd
+ * start time and study; the route passes the participant count and source. The public target cwd
  * and the run's own artifact root are the defaults.
  */
 export declare function bundleHead(run: BundleRun, args: {
@@ -541,7 +541,7 @@ export declare function bundleHead(run: BundleRun, args: {
     cwd?: string;
     artifactRoot?: string;
     source: RunBundle["source"];
-}): Pick<RunBundle, "schema" | "publication" | "runId" | "mode" | "simCount" | "createdAt" | "cwd" | "artifactRoot" | "study" | "lab" | "source">;
+}): Pick<RunBundle, "schema" | "publication" | "runId" | "mode" | "simCount" | "createdAt" | "cwd" | "artifactRoot" | "study" | "source">;
 /** The files every run directory holds, as the bundle names them. */
 export declare function bundleArtifacts(): RunBundle["artifacts"];
 export declare function buildRunSource(args: {

package/dist/run/bundle.js

@@ -8,7 +8,7 @@ export const REVIEW_SCHEMA = "humanish.review.v1";
 export const PUBLIC_TARGET_CWD = "[target-cwd]";
 /**
  * The fields every run bundle starts with, in the saved order. The run supplies its id, mode,
- * start time and lab; the route passes the participant count and source. The public target cwd
+ * start time and study; the route passes the participant count and source. The public target cwd
  * and the run's own artifact root are the defaults.
  */
 export function bundleHead(run, args) {
@@ -21,7 +21,7 @@ export function bundleHead(run, args) {
         createdAt: run.createdAt,
         cwd: args.cwd ?? PUBLIC_TARGET_CWD,
         artifactRoot: args.artifactRoot ?? path.join(".humanish", "runs", run.runId),
-        ...studyFields(run.lab),
+        ...studyFields(run.study),
         source: args.source,
     };
 }