humanish 0.108.0 → 0.109.0

package/dist/routes/shared-world/types.d.ts

@@ -1,12 +1,12 @@
-import type { LabDeps } from "../../lab/lab-deps.js";
-import type { LabEvent } from "../../lab/run-lab-events.js";
-import type { RunLabHomes } from "../../lab/run-lab-homes.js";
+import type { StudyDeps } from "../../study/study-deps.js";
+import type { StudyEvent } from "../../study/run-study-events.js";
+import type { RunStudyHomes } from "../../study/run-study-homes.js";
 import type { SharedWorldJudgment } from "../../run/judge.js";
-import type { BrowserScorer } from "../../lab/adapter-extension.js";
+import type { BrowserScorer } from "../../study/adapter-extension.js";
 import type { AutomaticAnalysisResult } from "../../analysis/automatic-completion.js";
 import type { CuaActorDescriptor } from "../../actors/registry.js";
 import type { CommsReceivingRun } from "../../comms/receiving.js";
-import type { LabCommsEmail, LabCommsExternal, LabConfig } from "../../lab/types.js";
+import type { StudyCommsEmail, StudyCommsExternal, StudyConfig } from "../../study/types.js";
 import type { DesktopResourceObservation } from "../../substrates/e2b/desktop-resources.js";
 import type { ObserverResult } from "../../observer/render.js";
 import type { ObserverRuntimeStreamUrl } from "../../observer/run-routes.js";
@@ -17,18 +17,18 @@ import type { LocalTreeArchive } from "../../subject/local-tree-archive.js";
 import type { LiveTraceFlush } from "../computer-use/live-flush.js";
 import type { CuaParticipantDeps, DesktopParticipantRun, CuaRunBudget, ParticipantRunOutcome } from "../computer-use/types.js";
 import type { ProvisionedPlaneSetup } from "./provisioned.js";
-import type { SharedWorldPlan } from "../../lab/plan-types.js";
+import type { SharedWorldPlan } from "../../study/plan-types.js";
 import { type StudyResultIdentity } from "../../run/study-result.js";
 export declare const CONCURRENT_SHARED_WORLD_PROVIDER_METADATA: {
     readonly mode: "concurrent-shared-world-lab";
     readonly tool: "humanish";
 };
 export declare const CONCURRENT_ATTRIBUTION_LIMITS: readonly ["concurrent", "best-effort-causal-attribution", "non-deterministic-shared-state", "window-and-snapshot-granularity", "contention-observed-not-proven-safe", "state-change-not-isolated-to-actors"];
-export interface RunConcurrentSharedWorldLabOptions {
+export interface RunConcurrentSharedWorldStudyOptions {
     /** Cancels post-run analysis only. */
     analysisSignal?: AbortSignal;
     cwd: string;
-    config: LabConfig;
+    config: StudyConfig;
     /** Resolved upstream (scenario.mode + CLI override); defaults safe (dry-run). */
     dryRun: boolean;
     open?: boolean;
@@ -43,22 +43,22 @@ export interface RunConcurrentSharedWorldLabOptions {
      * subject sandbox, then each participant's desktop. The external-public plane has participants
      * only.
      */
-    prepareDesktop?: NonNullable<RunLabHomes["prepareDesktop"]>;
+    prepareDesktop?: NonNullable<RunStudyHomes["prepareDesktop"]>;
     /** Awaited after a participant's live stream starts, and again after its sandbox is gone. */
-    onStream?: NonNullable<RunLabHomes["onStream"]>;
-    /** Reports subject phases to onEvent; built by normalizeRunLabOptions. */
-    emit?: (event: LabEvent) => void;
+    onStream?: NonNullable<RunStudyHomes["onStream"]>;
+    /** Reports subject phases to onEvent; built by normalizeRunStudyOptions. */
+    emit?: (event: StudyEvent) => void;
     /** Test seams. */
-    deps?: LabDeps;
-    /** Scores the assembled evidence: `RunLabOptions.scorer`, or the scorer the CLI loads. */
+    deps?: StudyDeps;
+    /** Scores the assembled evidence: `RunStudyOptions.scorer`, or the scorer the CLI loads. */
     scorer?: BrowserScorer;
     /** Present only when the scorer was config-declared and loaded by the CLI;
      *  core-stamped onto the bundle as evidence. Absent for library callers. */
     scorerProvenance?: RunScorerProvenance;
 }
-/** What a shared-world run takes besides its plan. The plan carries the config, dry run and lab. */
-export type SharedWorldRunInput = Omit<RunConcurrentSharedWorldLabOptions, "config" | "dryRun" | "lab">;
-export type ConcurrentSharedWorldLabErrorCode = "HUMANISH_STUDY_ANALYSIS_INVALID" | "HUMANISH_STUDY_TASKS_UNSUPPORTED" | "HUMANISH_STUDY_OPTION_UNSUPPORTED" | "HUMANISH_SHARED_WORLD_FAILED" | "HUMANISH_SHARED_WORLD_ACTOR_UNSUPPORTED" | "HUMANISH_SHARED_WORLD_INVALID" | "HUMANISH_SHARED_WORLD_KEYS_MISSING"
+/** What a shared-world run takes besides its plan. The plan carries the config, dry run and study. */
+export type SharedWorldRunInput = Omit<RunConcurrentSharedWorldStudyOptions, "config" | "dryRun">;
+export type ConcurrentSharedWorldStudyErrorCode = "HUMANISH_STUDY_ANALYSIS_INVALID" | "HUMANISH_STUDY_TASKS_UNSUPPORTED" | "HUMANISH_STUDY_OPTION_UNSUPPORTED" | "HUMANISH_STUDY_V2_UNSUPPORTED" | "HUMANISH_SHARED_WORLD_FAILED" | "HUMANISH_SHARED_WORLD_ACTOR_UNSUPPORTED" | "HUMANISH_SHARED_WORLD_INVALID" | "HUMANISH_SHARED_WORLD_KEYS_MISSING"
 /** A local-agent brain's CLI is not on `PATH`. */
  | "HUMANISH_SHARED_WORLD_AGENT_MISSING"
 /** A local-agent brain's CLI is signed out, or could not report its sign-in status. */
@@ -98,11 +98,11 @@ export interface ConcurrentSharedWorldParticipantResult {
         killed: boolean;
     };
     error?: {
-        code: ConcurrentSharedWorldLabErrorCode;
+        code: ConcurrentSharedWorldStudyErrorCode;
         message: string;
     };
 }
-export interface ConcurrentSharedWorldLabResult extends AutomaticAnalysisResult, StudyResultIdentity<"shared-world"> {
+export interface ConcurrentSharedWorldStudyResult extends AutomaticAnalysisResult, StudyResultIdentity<"shared-world"> {
     ok: boolean;
     cwd: string;
     actor: string;
@@ -132,7 +132,7 @@ export interface ConcurrentSharedWorldLabResult extends AutomaticAnalysisResult,
     observer?: ObserverResult;
     warnings: string[];
     error?: {
-        code: ConcurrentSharedWorldLabErrorCode;
+        code: ConcurrentSharedWorldStudyErrorCode;
         message: string;
     };
 }
@@ -159,10 +159,10 @@ export interface PlaneContext {
     input: SharedWorldRunInput;
     /** Read for the subject's serve URL, which each participant's subject names. Participants, their
      *  count and their host and entry come from the plan's participants. */
-    config: LabConfig;
+    config: StudyConfig;
     descriptor: CuaActorDescriptor;
     /** The run's test seams; empty outside tests. */
-    deps: LabDeps;
+    deps: StudyDeps;
     env: Record<string, string | undefined>;
     concurrency: number;
     runBudget: CuaRunBudget | undefined;
@@ -204,15 +204,15 @@ export interface LiveParticipants {
 }
 /** An adopter-hosted comms catch and the inbox its personas open. */
 export interface ExternalCommsWiring {
-    external: LabCommsExternal;
-    email: LabCommsEmail;
+    external: StudyCommsExternal;
+    email: StudyCommsEmail;
     inboxUrl: string;
 }
 /** What buildConcurrentSharedWorldBundle projects into a run bundle. */
 export interface ConcurrentBundleArgs {
     /** The run's judgment (judgeSharedWorldRun over the other fields). */
     judgment: SharedWorldJudgment;
-    /** The run this bundle belongs to; the bundle head reads its id, mode, start and lab. */
+    /** The run this bundle belongs to; the bundle head reads its id, mode, start and study. */
     run: BundleRun;
     plan: SharedWorldPlan;
     descriptor: CuaActorDescriptor;
@@ -226,7 +226,7 @@ export interface ConcurrentBundleArgs {
     seedDigest: string;
     subjectCommit?: string;
     hostDigest?: string;
-    /** Run-level digest-only comms-thread evidence path (humanish.comms-thread.v1), when a comms lab
+    /** Run-level digest-only comms-thread evidence path (humanish.comms-thread.v1), when a comms study
      *  captured mail into the subject sandbox's catch. Registered on the first persona stream (it is a
      *  property of the one shared app, and belongs to no single persona). */
     commsArtifactPath?: string;
@@ -265,7 +265,7 @@ export interface PlaneResults {
 /** Which plane runs, and the setup it needs beyond the plane context. */
 export interface PlaneSelection {
     planeClass: ConcurrentSharedWorldPlaneClass;
-    /** Undefined when the lab declares no `subject.serve`. */
+    /** Undefined when the study declares no `subject.serve`. */
     provisioned: ProvisionedPlaneSetup | undefined;
     externalWiring: ExternalCommsWiring | undefined;
 }

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

@@ -1,6 +1,6 @@
 import type { ActorTrace } from "../../actors/contract.js";
 import { type RunBundle, type RunScorerProvenance } from "../../run/bundle.js";
-import { type ScorerOutcome } from "../../lab/adapter-extension.js";
+import { type ScorerOutcome } from "../../study/adapter-extension.js";
 import type { TerminalLedgers, TerminalScorer } from "./types.js";
 /**
  * Run the product-adapter extension seam over the assembled
@@ -27,7 +27,7 @@ export declare function applyAdapterExtensionSeam(args: {
     ledgers: TerminalLedgers;
     transcript: string;
     product: string;
-    labId: string;
+    studyId: string;
     runId: string;
     sanitize: (text: string) => string;
     warnings: string[];

package/dist/routes/terminal/adapter.js

@@ -1,6 +1,6 @@
 import {} from "../../run/bundle.js";
 import { isRunAdapterScore } from "../../run/bundle-shape.js";
-import { adapterScoreFailureMessage, declaredScorerThrew, DECLARED_SCORER_MALFORMED, frozenBundleView, isAdapterFeedbackCandidate, } from "../../lab/adapter-extension.js";
+import { adapterScoreFailureMessage, declaredScorerThrew, DECLARED_SCORER_MALFORMED, frozenBundleView, isAdapterFeedbackCandidate, } from "../../study/adapter-extension.js";
 /**
  * Run the product-adapter extension seam over the assembled
  * evidence and attach its results to the bundle in place, without core knowing any product noun.
@@ -20,7 +20,7 @@ import { adapterScoreFailureMessage, declaredScorerThrew, DECLARED_SCORER_MALFOR
  * re-checks the surviving shapes downstream, so the seam stays fail-closed end to end.
  */
 export async function applyAdapterExtensionSeam(args) {
-    const { scorer, bundle, trace, ledgers, transcript, product, labId, runId, sanitize, warnings, scorerProvenance, } = args;
+    const { scorer, bundle, trace, ledgers, transcript, product, studyId, runId, sanitize, warnings, scorerProvenance, } = args;
     if (!scorer?.score && !scorer?.deriveFeedback)
         return { failures: [] };
     const declared = scorerProvenance !== undefined;
@@ -38,7 +38,7 @@ export async function applyAdapterExtensionSeam(args) {
         ledgers,
         transcript,
         product,
-        labId,
+        studyId,
         runId,
     };
     // Best-effort re-scrub of the adapter payload: round-trip the whole JSON through the run's denylist
@@ -46,7 +46,7 @@ export async function applyAdapterExtensionSeam(args) {
     // local paths, and misses encoded/split/custom secrets, DB passwords, PII, or abs paths outside
     // the denylist. A
     // payload from config-declared code is acceptable only because the trust boundary (the party who
-    // declares the scorer runs the lab) already permits direct exfiltration; the re-scrub is
+    // declares the scorer runs the study) already permits direct exfiltration; the re-scrub is
     // defense-in-depth, not a wall.
     const scrubValue = (value) => JSON.parse(sanitize(JSON.stringify(value)));
     // Set for a declared scorer that fails to render a pass verdict (status:"fail", malformed, or throw).

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

@@ -1,27 +1,27 @@
 import type { ActorPersonaRef, ActorTrace } from "../../actors/contract.js";
-import type { LabScenarioCaps, LabRuntimeAuth } from "../../lab/types.js";
+import type { StudyScenarioCaps, StudyRuntimeAuth } from "../../study/types.js";
 import { type RunBundle, type RunCostSummary, type BundleRun } from "../../run/bundle.js";
 import { type Verdict } from "../../run/judge.js";
 import type { TerminalLedgers } from "./types.js";
 /**
- * Project the terminal-product lab run into a humanish.run-bundle.v1 (no schema change: a new
+ * Project the terminal-product run into a humanish.run-bundle.v1 (no schema change: a new
  * producer only). Dry run: a contract bundle. The terminal stream is a contract placeholder
  * (stdin disabled, no captured tail, because nothing ran), the subject is declared unpinned, and
  * the caps/policies/runtime-auth declarations are recorded without pretending that live ledgers
  * exist. The shipped live builder fills the same evidence contract. Exported for tests.
  */
 export declare function buildTerminalProductBundle(args: {
-    /** The run this bundle belongs to; the bundle head reads its id, mode, start and lab. */
+    /** The run this bundle belongs to; the bundle head reads its id, mode, start and study. */
     run: BundleRun;
     actorId: string;
     dryRun: boolean;
-    labId: string;
-    labTitle?: string;
+    studyId: string;
+    studyTitle?: string;
     mission: string;
     persona: ActorPersonaRef;
     productName: string;
     publicSurfaces: string[];
-    caps?: LabScenarioCaps;
+    caps?: StudyScenarioCaps;
     runtimeAuth?: string;
     stdin: "disabled" | "planned" | "sent";
     policies: {
@@ -42,18 +42,18 @@ export declare function buildTerminalProductBundle(args: {
  * mode==="live") enforces the ledgers + proven cleanup + interventions-present over this bundle.
  */
 export declare function buildLiveTerminalProductBundle(args: {
-    /** The run this bundle belongs to; the bundle head reads its id, mode, start and lab. */
+    /** The run this bundle belongs to; the bundle head reads its id, mode, start and study. */
     run: BundleRun;
     actorId: string;
-    labId: string;
-    labTitle?: string;
+    studyId: string;
+    studyTitle?: string;
     mission: string;
     persona: ActorPersonaRef;
     productName: string;
     publicSurfaces: string[];
-    caps?: LabScenarioCaps;
+    caps?: StudyScenarioCaps;
     runtimeAuthKeyName: string;
-    runtimeAuth?: LabRuntimeAuth;
+    runtimeAuth?: StudyRuntimeAuth;
     policies: {
         allowPrivateRepoAccess: boolean;
         allowProviderCredentials: boolean;

package/dist/routes/terminal/bundle.js

@@ -1,5 +1,5 @@
 import { redactText } from "../../evidence/redaction.js";
-import { participantAssignment } from "../../lab/participant-assignment.js";
+import { participantAssignment } from "../../study/participant-assignment.js";
 import { REVIEW_SCHEMA, bundleArtifacts, bundleHead, } from "../../run/bundle.js";
 import { verdictText } from "../../run/judge.js";
 import {} from "../../run/streams.js";
@@ -7,7 +7,7 @@ import { participantEvent, participantIds, participantRecord, participantStream,
 import { TERMINAL_EVENTS_ARTIFACT, TERMINAL_LEDGERS_ARTIFACT, TERMINAL_TRANSCRIPT_ARTIFACT, } from "../../run/terminal-contract.js";
 import { describeMeasuredSpend, noSpendLineMeasured, noSpendNotEstablished } from "./ledger.js";
 /**
- * Project the terminal-product lab run into a humanish.run-bundle.v1 (no schema change: a new
+ * Project the terminal-product run into a humanish.run-bundle.v1 (no schema change: a new
  * producer only). Dry run: a contract bundle. The terminal stream is a contract placeholder
  * (stdin disabled, no captured tail, because nothing ran), the subject is declared unpinned, and
  * the caps/policies/runtime-auth declarations are recorded without pretending that live ledgers
@@ -39,7 +39,7 @@ export function buildTerminalProductBundle(args) {
             at: args.run.createdAt,
             level: "info",
             type: "terminal-lab.run.created",
-            message: `Created terminal-product lab run for ${args.labId} (actor ${args.actorId}, product ${args.productName}).`,
+            message: `Created a terminal-product run for ${args.studyId} (actor ${args.actorId}, product ${args.productName}).`,
         },
         participantEvent(TERMINAL_IDS, {
             id: "event-001-subject",
@@ -89,13 +89,13 @@ export function buildTerminalProductBundle(args) {
             {
                 at: args.run.createdAt,
                 event: "terminal-lab.run.created",
-                message: `Created terminal-product lab run with one in-sandbox agent participant (actor ${args.actorId}, product ${args.productName}).`,
+                message: `Created a terminal-product run with one in-sandbox agent participant (actor ${args.actorId}, product ${args.productName}).`,
             },
         ],
         simulation,
         stream,
         events,
-        redactionNotes: "Dry-run bundle: no sandbox ran, no key was injected, no exec output was captured. The author mission is public-safe committed lab text (redacted defensively); the composed prompt is bound by digest. The shipped live path applies scrubKnownValues then redactText at the capture source before persistence.",
+        redactionNotes: "Dry-run bundle: no sandbox ran, no key was injected, no exec output was captured. The author mission is public-safe committed study text (redacted defensively); the composed prompt is bound by digest. The shipped live path applies scrubKnownValues then redactText at the capture source before persistence.",
         review,
     });
 }
@@ -197,7 +197,7 @@ const TERMINAL_IDS = participantIds(0);
 function terminalParticipant(args, session) {
     const simulation = participantRecord(TERMINAL_IDS, 1, {
         personaId: args.persona.id,
-        scenarioId: `terminal-${args.labId}`,
+        scenarioId: `terminal-${args.studyId}`,
         status: session.status,
         streamKind: "terminal",
         mode: "cli-sim",
@@ -210,7 +210,7 @@ function terminalParticipant(args, session) {
     const stream = participantStream(TERMINAL_IDS, {
         assignment: participantAssignment({ mission: args.mission }),
         kind: "terminal",
-        label: `Terminal agent · ${args.labId}`,
+        label: `Terminal agent · ${args.studyId}`,
         status: session.status,
         transport: "snapshot",
         updatedAt: session.updatedAt,
@@ -237,17 +237,17 @@ function terminalRunBundle(args, parts) {
         persona: {
             id: args.persona.id,
             name: `Autonomous terminal agent (${args.persona.id})`,
-            source: `study:${args.labId}`,
+            source: `study:${args.studyId}`,
             sourceDigest: args.persona.promptDigest,
         },
         scenario: {
-            id: `terminal-${args.labId}`,
-            title: args.labTitle ?? `Terminal-product lab: ${args.labId}`,
-            // The author mission is public-safe committed lab text. It is recorded plaintext as the goal,
+            id: `terminal-${args.studyId}`,
+            title: args.studyTitle ?? `Terminal-product run: ${args.studyId}`,
+            // The author mission is public-safe committed study text. It is recorded plaintext as the goal,
             // redacted defensively before persisting (it never carries a secret, but the harness never
             // trusts that). The full composed prompt is bound by digest, not text.
             goal: redactText(args.mission),
-            source: `study:${args.labId}`,
+            source: `study:${args.studyId}`,
             sourceDigest: args.persona.promptDigest,
         },
         lifecycle: parts.lifecycle,

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

@@ -1,4 +1,4 @@
-import type { LabRuntimeAuth } from "../../lab/types.js";
+import type { StudyRuntimeAuth } from "../../study/types.js";
 /**
  * Resolve the runtime key on the host. Legacy openai-env passes it command-scoped; openai-egress
  * returns an inert command env while retaining the actual value for the external transform and
@@ -7,12 +7,12 @@ import type { LabRuntimeAuth } from "../../lab/types.js";
  */
 export declare function buildRuntimeAuth(args: {
     /** Undefined retains the historical openai-env default. */
-    runtimeAuth: LabRuntimeAuth | undefined;
+    runtimeAuth: StudyRuntimeAuth | undefined;
     /** The operator environment the key value is read from (process.env or a test fake). */
     env: Record<string, string | undefined>;
 }): {
     ok: true;
-    mode: LabRuntimeAuth;
+    mode: StudyRuntimeAuth;
     envs: Record<string, string>;
     keyName: string;
     keyValue: string;
@@ -28,7 +28,7 @@ export declare function buildRuntimeAuth(args: {
  * prompt/token/secret shapes; this builder makes that true by construction.
  */
 export declare function buildSandboxMetadata(allowlist: {
-    labId: string;
+    studyId: string;
     recordId: string;
     runId: string;
 }): Record<string, string>;

package/dist/routes/terminal/credentials.js

@@ -1,5 +1,5 @@
 import { E2B_SYSTEM_CA_BUNDLE, OPENAI_EGRESS_PLACEHOLDER } from "./runtime-auth.js";
-import { TERMINAL_PRODUCT_LAB_PROVIDER_METADATA } from "./types.js";
+import { TERMINAL_PRODUCT_STUDY_PROVIDER_METADATA } from "./types.js";
 /**
  * Resolve the runtime key on the host. Legacy openai-env passes it command-scoped; openai-egress
  * returns an inert command env while retaining the actual value for the external transform and
@@ -38,7 +38,7 @@ export function buildRuntimeAuth(args) {
         return {
             ok: false,
             code: "HUMANISH_TERMINAL_RUNTIME_AUTH_MISSING",
-            message: `Live terminal-product labs declare runtimeAuth "${String(args.runtimeAuth)}" and need ${ALLOWED_RUNTIME_KEY_NAMES.join(" or ")} in the environment (pass via --env-file; the selected auth mode places the value in command-scoped env or an external E2B header transform; the value is never persisted).`,
+            message: `Live terminal-product studies declare runtimeAuth "${String(args.runtimeAuth)}" and need ${ALLOWED_RUNTIME_KEY_NAMES.join(" or ")} in the environment (pass via --env-file; the selected auth mode places the value in command-scoped env or an external E2B header transform; the value is never persisted).`,
         };
     }
     const keyValue = args.env[keyName];
@@ -91,10 +91,10 @@ function isNonRuntimeCredentialName(name) {
  */
 export function buildSandboxMetadata(allowlist) {
     return {
-        mode: TERMINAL_PRODUCT_LAB_PROVIDER_METADATA.mode,
-        tool: TERMINAL_PRODUCT_LAB_PROVIDER_METADATA.tool,
+        mode: TERMINAL_PRODUCT_STUDY_PROVIDER_METADATA.mode,
+        tool: TERMINAL_PRODUCT_STUDY_PROVIDER_METADATA.tool,
         provider: "codex",
-        labId: allowlist.labId,
+        labId: allowlist.studyId,
         recordId: allowlist.recordId,
         // The run id is a harness-minted token (terminal-<ts>-<hex>), not user data.
         runId: allowlist.runId,

package/dist/routes/terminal/dry-run.d.ts

@@ -1,11 +1,11 @@
-import type { TerminalPlan } from "../../lab/plan-types.js";
+import type { TerminalPlan } from "../../study/plan-types.js";
 import type { RunScope } from "../../run/run.js";
-import { type RunLiveTerminalSessionArgs, type TerminalProductLabResult, type TerminalRunInput } from "./types.js";
+import { type RunLiveTerminalSessionArgs, type TerminalProductStudyResult, type TerminalRunInput } from "./types.js";
 /**
  * The dry-run path: a contract bundle with the persona and prompt digest bound, published through
  * the run scope with no sandbox, key or spend.
  */
-export declare function runDryTerminalLab(args: {
+export declare function runDryTerminalStudy(args: {
     plan: Extract<TerminalPlan, {
         readonly dryRun: true;
     }>;
@@ -14,7 +14,7 @@ export declare function runDryTerminalLab(args: {
     warnings: string[];
     failed: RunLiveTerminalSessionArgs["failed"];
     scope: RunScope;
-}): Promise<TerminalProductLabResult>;
+}): Promise<TerminalProductStudyResult>;
 /** Compose the full prompt the agent would run. Bound to evidence by digest only. */
 export declare function composePrompt(args: {
     mission: string;

package/dist/routes/terminal/dry-run.js

@@ -1,7 +1,7 @@
 // The terminal route's dry run: a contract-only bundle with the persona and prompt digest bound,
 // published through the run scope with no sandbox, key or spend. session.ts holds the live path.
 import { digestText, redactText, scrubLiterals } from "../../evidence/redaction.js";
-import { participantAssignment } from "../../lab/participant-assignment.js";
+import { participantAssignment } from "../../study/participant-assignment.js";
 import { buildRunSource } from "../../run/bundle.js";
 import { judgeExecution, judgeTerminal, OUTCOME_POLICIES, resultOk } from "../../run/judge.js";
 import { validatePreparedRunArtifactPaths } from "../../run/paths.js";
@@ -15,7 +15,7 @@ import { studyResultIdentity } from "../../run/study-result.js";
  * The dry-run path: a contract bundle with the persona and prompt digest bound, published through
  * the run scope with no sandbox, key or spend.
  */
-export async function runDryTerminalLab(args) {
+export async function runDryTerminalStudy(args) {
     const { plan, input, cwd, warnings, failed, scope } = args;
     const { product } = plan;
     const { evidenceMission, physicalCwd, persona } = await prepareDryPersona({
@@ -29,7 +29,7 @@ export async function runDryTerminalLab(args) {
         runId: input.runId,
         mintRunId: makeTerminalRunId,
         mode: "dry-run",
-        lab: plan.lab,
+        study: plan.study,
         renderReview: renderTerminalReviewMarkdown,
         observer: { open: input.open === true, render: input.deps?.renderObserver },
     });
@@ -49,8 +49,8 @@ export async function runDryTerminalLab(args) {
         run,
         actorId: plan.actor,
         dryRun: true,
-        labId: plan.labId,
-        ...(plan.title ? { labTitle: plan.title } : {}),
+        studyId: plan.studyId,
+        ...(plan.title ? { studyTitle: plan.title } : {}),
         mission: evidenceMission,
         persona,
         productName: product.name,
@@ -77,13 +77,13 @@ export async function runDryTerminalLab(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.",
             },
         ], policy);
     const ok = resultOk({ judgment, execution, scorerFailures: [], policy });
     await finished.recordOutcome({ ok, execution });
     return {
-        ...studyResultIdentity("terminal", plan.labId),
+        ...studyResultIdentity("terminal", plan.studyId),
         ok,
         cwd,
         actor: plan.actor,
@@ -97,7 +97,7 @@ export async function runDryTerminalLab(args) {
             : {
                 error: {
                     code: "HUMANISH_TERMINAL_FAILED",
-                    message: observer.error?.message ?? "Observer failed for the terminal-product lab run.",
+                    message: observer.error?.message ?? "Observer failed for the terminal-product run.",
                 },
             }),
     };
@@ -116,7 +116,7 @@ async function prepareDryPersona(args) {
     const evidenceMission = participantAssignment({ mission }, scrubLiterals(knownSecretValues)).mission;
     const terminalPersona = await resolveTerminalPersona({ plan, cwd, warnings });
     // The composed prompt = mission + persona + public-surface manifest. Only the author mission
-    // goes plaintext into evidence (it is public-safe committed lab text); the full composed prompt
+    // goes plaintext into evidence (it is public-safe committed study text); the full composed prompt
     // is recorded as a digest (the safety contract's mission ruling).
     const composedPrompt = composePrompt({
         mission,

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

@@ -1,5 +1,5 @@
 import type { ActorTokenUsage } from "../../actors/contract.js";
-import type { LabScenarioCaps } from "../../lab/types.js";
+import type { StudyScenarioCaps } from "../../study/types.js";
 import { type CostCategory } from "../../run/terminal-contract.js";
 import type { CostLine, NoSpendProof, TerminalCostLedger } from "./types.js";
 /**
@@ -41,7 +41,7 @@ export declare function buildNoSpendProof(ledger: TerminalCostLedger, maxUsd: nu
  * grant a green pass: the no-spend proof reports them as unmeasured. maxMinutes is wall-clock and is
  * enforced separately (runWithWallClock); it is not a ledger-derived cap.
  */
-export declare function evaluateCapsAgainstLedger(ledger: TerminalCostLedger, caps: LabScenarioCaps): {
+export declare function evaluateCapsAgainstLedger(ledger: TerminalCostLedger, caps: StudyScenarioCaps): {
     ok: true;
 } | {
     ok: false;

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

@@ -1,6 +1,6 @@
 /**
  * The most the sandbox runs before the codex command starts: the Node bootstrap, the runtime
- * version check and, when the lab declares `subject.product.install`, the product setup.
+ * version check and, when the study declares `subject.product.install`, the product setup.
  */
 export declare function terminalPreExecBudgetMs(productInstall: boolean): number;
 /** The terminal sandbox's server-side timeout for a codex command bounded at `maxMinutes`. */

package/dist/routes/terminal/lifetime.js

@@ -7,7 +7,7 @@ import { TERMINAL_RUNTIME_VERSION_TIMEOUT_MS } from "./runtime.js";
 import { PRODUCT_SETUP_TIMEOUT_MS, TERMINAL_SANDBOX_TIMEOUT_BUFFER_MS } from "./types.js";
 /**
  * The most the sandbox runs before the codex command starts: the Node bootstrap, the runtime
- * version check and, when the lab declares `subject.product.install`, the product setup.
+ * version check and, when the study declares `subject.product.install`, the product setup.
  */
 export function terminalPreExecBudgetMs(productInstall) {
     return (NODE_BOOTSTRAP_TIMEOUT_MS +

package/dist/routes/terminal/live-finish.d.ts

@@ -2,7 +2,7 @@ import type { ActorPersonaRef } from "../../actors/contract.js";
 import type { RunBundle } from "../../run/bundle.js";
 import type { RunScope } from "../../run/run.js";
 import type { LiveSandboxInputs, LiveTerminalSandbox } from "./live-sandbox.js";
-import type { RunLiveTerminalSessionArgs, TerminalProductLabResult } from "./types.js";
+import type { RunLiveTerminalSessionArgs, TerminalProductStudyResult } from "./types.js";
 type StartedRun = Extract<Awaited<ReturnType<RunScope["startRun"]>>, {
     ok: true;
 }>["run"];
@@ -26,5 +26,5 @@ export interface LiveFinishInputs {
     /** The session's outcome; a blown cap overrides it. */
     session: LiveTerminalSandbox;
 }
-export declare function finishLiveTerminalSession(inputs: LiveFinishInputs): Promise<TerminalProductLabResult>;
+export declare function finishLiveTerminalSession(inputs: LiveFinishInputs): Promise<TerminalProductStudyResult>;
 export {};

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

@@ -1,5 +1,5 @@
 // Finishing a live terminal session: the actor trace from the captured stream, the spend ledger
-// and its caps check, the evidence files, the bundle, and the lab result.
+// and its caps check, the evidence files, the bundle, and the study result.
 import { buildRunCostSummary } from "../../run/cost-summary.js";
 import { writeContainedOutputFile } from "../../run/contained-output.js";
 import { validatePreparedRunArtifactPaths, } from "../../run/paths.js";
@@ -9,7 +9,7 @@ import { applyAdapterExtensionSeam } from "./adapter.js";
 import { buildLiveTerminalProductBundle } from "./bundle.js";
 import { buildCostLedger, buildNoSpendProof, describeMeasuredSpend, evaluateCapsAgainstLedger, noSpendLineMeasured, noSpendNotEstablished, } from "./ledger.js";
 import { foldScorerFailures, judgeExecution, judgeTerminal, OUTCOME_POLICIES, } from "../../run/judge.js";
-import { terminalExecutionFailures, terminalLabResult, terminalParticipantFacts, } from "./result.js";
+import { terminalExecutionFailures, terminalStudyResult, terminalParticipantFacts, } from "./result.js";
 import { parseTerminalTokenUsage } from "./token-usage.js";
 import { buildTerminalActorTrace, scrubSplitKnownValues, tailOf } from "./trace.js";
 function buildLiveTrace(inputs) {
@@ -125,8 +125,8 @@ export async function finishLiveTerminalSession(inputs) {
     const bundle = buildLiveTerminalProductBundle({
         run,
         actorId: plan.actor,
-        labId: plan.labId,
-        ...(plan.title ? { labTitle: plan.title } : {}),
+        studyId: plan.studyId,
+        ...(plan.title ? { studyTitle: plan.title } : {}),
         mission: sanitize(mission),
         persona,
         productName: product.name,
@@ -161,7 +161,7 @@ export async function finishLiveTerminalSession(inputs) {
         ledgers,
         transcript: normalizedTranscript,
         product: product.name,
-        labId: plan.labId,
+        studyId: plan.studyId,
         runId,
         sanitize,
         warnings,
@@ -182,9 +182,9 @@ export async function finishLiveTerminalSession(inputs) {
         cleanup: session.cleanup,
         observer,
     }), OUTCOME_POLICIES.terminal);
-    const result = terminalLabResult({
+    const result = terminalStudyResult({
         cwd,
-        labId: plan.labId,
+        studyId: plan.studyId,
         actorId: plan.actor,
         productName: product.name,
         runId,

package/dist/routes/terminal/live-sandbox.d.ts

@@ -5,7 +5,7 @@ import type { buildRuntimeAuth, buildSandboxMetadata } from "./credentials.js";
 import type { createTerminalRecorder } from "./recorder.js";
 import { type declaredRuntimeProvenance } from "./runtime.js";
 import { type LiveTerminalPlan, type TerminalLedgers } from "./types.js";
-import type { LabDeps } from "../../lab/lab-deps.js";
+import type { StudyDeps } from "../../study/study-deps.js";
 type StartedRun = Extract<Awaited<ReturnType<RunScope["startRun"]>>, {
     ok: true;
 }>["run"];
@@ -13,7 +13,7 @@ type StartedRun = Extract<Awaited<ReturnType<RunScope["startRun"]>>, {
 export interface LiveSandboxInputs {
     plan: LiveTerminalPlan;
     cwd: string;
-    deps: LabDeps;
+    deps: StudyDeps;
     now: () => number;
     nowIso: () => string;
     sanitize: (text: string) => string;