humanish 0.108.0 → 0.109.0

package/dist/routes/computer-use/types.d.ts

@@ -10,21 +10,21 @@ import type { AutomaticAnalysisRefusal } from "../../analysis/job.js";
 import { type CuaDiagnostics } from "./diagnostics.js";
 import type { ActorCompletionReason, ActorStatus, ActorStopCause, ActorTokenUsage, ActorTraceItem } from "../../actors/contract.js";
 import { type CuaActorDescriptor } from "../../actors/registry.js";
-import type { LabDeps } from "../../lab/lab-deps.js";
-import type { LabEvent, ParticipantRef } from "../../lab/run-lab-events.js";
-import type { InProcessDriver, ProviderFactory, RunLabHomes } from "../../lab/run-lab-homes.js";
-import { type BrowserScorer } from "../../lab/adapter-extension.js";
+import type { StudyDeps } from "../../study/study-deps.js";
+import type { StudyEvent, ParticipantRef } from "../../study/run-study-events.js";
+import type { InProcessDriver, ProviderFactory, RunStudyHomes } from "../../study/run-study-homes.js";
+import { type BrowserScorer } from "../../study/adapter-extension.js";
 import type { CuaActorSessionOptions } from "../../actors/computer-use/actor.js";
 import { type E2BDesktopModule } from "../../substrates/e2b/sdk.js";
 import { type DesktopResourceObservation } from "../../substrates/e2b/desktop-resources.js";
 import { type DetachedTimers } from "../../substrates/detached.js";
-import type { Brain, ComputerUsePlan, ComputerUseRunner, ResidualConfig } from "../../lab/plan-types.js";
-import { type LabCommsEmail, type LabConfig } from "../../lab/types.js";
+import type { Brain, ComputerUsePlan, ComputerUseRunner, ResidualConfig } from "../../study/plan-types.js";
+import { type StudyCommsEmail, type StudyConfig } from "../../study/types.js";
 import { type ObserverResult } from "../../observer/render.js";
 import { type BundleRun, type RunBundle, type RunRerunLineage, type RunScorerProvenance, type RunSubjectProvenance, type RunSubjectStateStepRecord } from "../../run/bundle.js";
 import { type RunDesktopGeometry } from "../../run/streams.js";
 import { type PreparedOutputRoot } from "../../run/contained-output.js";
-import type { ComputerUseParticipant, SharedWorldParticipant } from "../../lab/plan-participants.js";
+import type { ComputerUseParticipant, SharedWorldParticipant } from "../../study/plan-participants.js";
 import type { ResolvedParticipant } from "../../run/participant.js";
 import { type StudyResultIdentity } from "../../run/study-result.js";
 export declare const CUA_FANOUT_STRATEGY: "per-lane-worlds";
@@ -35,9 +35,9 @@ export declare const MIN_DERIVED_SESSION_TIMEOUT_MS: number;
  * What a computer-use run takes besides its plan and config. The count override and rerun go to
  * participant building with the config.
  */
-export type ComputerUseRunInput = Omit<RunCuaActorLabOptions, "config" | "dryRun" | "lab">;
+export type ComputerUseRunInput = Omit<RunCuaActorStudyOptions, "config" | "dryRun">;
 /**
- * What runLab's local VM study gives a computer-use run: the desktop each participant runs on, the
+ * What runStudyWith's local VM study gives a computer-use run: the desktop each participant runs on, the
  * reason automatic analysis must not run (the study's cleanup is unconfirmed), and the signal its
  * sessions abort on.
  */
@@ -47,11 +47,11 @@ export interface LocalVmInput {
     readonly analysisRefusal: () => AutomaticAnalysisRefusal | undefined;
     readonly signal?: AbortSignal;
 }
-export interface RunCuaActorLabOptions {
+export interface RunCuaActorStudyOptions {
     /** 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;
@@ -67,23 +67,23 @@ export interface RunCuaActorLabOptions {
     /** Keys and subject env for the run. Defaults to process.env. */
     env?: Readonly<Record<string, string | undefined>>;
     /** E2B only. Runs on each participant's desktop after it exists and before provisioning. */
-    prepareDesktop?: NonNullable<RunLabHomes["prepareDesktop"]>;
-    /** runLab's local VM study, for an app-url lab on the local target. */
+    prepareDesktop?: NonNullable<RunStudyHomes["prepareDesktop"]>;
+    /** runStudyWith's local VM study, for an app-url study on the local target. */
     localVm?: LocalVmInput;
     onObserverReady?: (observer: ObserverResult & {
         ok: true;
     }) => Promise<void> | void;
     /** Awaited after a participant's live stream starts, and again after its sandbox is gone. */
-    onStream?: NonNullable<RunLabHomes["onStream"]>;
-    /** The caller's brain for each participant, in place of the lab's own. */
+    onStream?: NonNullable<RunStudyHomes["onStream"]>;
+    /** The caller's brain for each participant, in place of the study's own. */
     createProvider?: ProviderFactory;
     /** Drives an app-url or local-app subject in this process, with no desktop. Needs createProvider. */
     inProcess?: InProcessDriver;
-    /** Reports the plan and subject phases to onEvent; built by normalizeRunLabOptions. */
-    emit?: (event: LabEvent) => void;
+    /** Reports the plan and 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. */
@@ -103,7 +103,7 @@ export interface CuaParticipantPlanEntry {
     /** Requested E2B/X screen resolution. This is not the measured browser CSS viewport. */
     resolution: [number, number];
     instructionDigest: string;
-    /** The declared reasoning effort for this participant, when the lab declared one. The plan line is what
+    /** The declared reasoning effort for this participant, when the study declared one. The plan line is what
      *  you read before spending money, so a declared per-participant difference has to be visible there. */
     reasoningEffort?: string;
     maxOutputTokens?: number;
@@ -164,7 +164,7 @@ export interface CuaParticipantResult {
     /** Set when the participant was skipped (pinned reason string). */
     skippedReason?: string;
     error?: {
-        code: CuaActorLabErrorCode;
+        code: CuaActorStudyErrorCode;
         message: string;
     };
 }
@@ -183,7 +183,7 @@ export interface CuaParticipantSummary {
     concurrency: number;
     waves: number;
 }
-export type CuaActorLabErrorCode = "HUMANISH_STUDY_ANALYSIS_INVALID" | "HUMANISH_STUDY_TASKS_UNSUPPORTED" | "HUMANISH_STUDY_OPTION_UNSUPPORTED" | "HUMANISH_COMPUTER_USE_FAILED" | "HUMANISH_COMPUTER_USE_KEYS_MISSING" | "HUMANISH_COMPUTER_USE_AGENT_MISSING" | "HUMANISH_COMPUTER_USE_AGENT_SIGNIN_REQUIRED" | "HUMANISH_COMPUTER_USE_SUBJECT_ENV_MISSING" | "HUMANISH_COMPUTER_USE_ACTOR_UNSUPPORTED" | "HUMANISH_COMPUTER_USE_SUBJECT_INVALID" | "HUMANISH_COMPUTER_USE_SUBJECT_UNSAFE" | "HUMANISH_COMPUTER_USE_EXECUTOR_NO_PROVIDER" | "HUMANISH_COMPUTER_USE_LOCAL_APP_NO_EXECUTOR" | "HUMANISH_COMPUTER_USE_LOCAL_DESKTOP_MISSING" | "HUMANISH_COMPUTER_USE_FANOUT_INVALID" | "HUMANISH_COMPUTER_USE_RERUN_INVALID" | "HUMANISH_COMPUTER_USE_DEVICE_GEOMETRY" | "HUMANISH_RUN_ID_IN_USE" | "HUMANISH_COMPUTER_USE_UNPRICED_CAP" | "HUMANISH_COMPUTER_USE_COMMS_CATCH_UNREACHABLE" | "HUMANISH_COMPUTER_USE_COMMS_TOKEN_INVALID" | "HUMANISH_WATCH_ALLOW_REQUIRES_OAUTH" | "HUMANISH_WATCH_OAUTH_REQUIRES_TUNNEL" | "HUMANISH_WATCH_OPTION_CONFLICT" | "HUMANISH_WATCH_TUNNEL_REQUIRES_EXPOSE" | "HUMANISH_WATCH_EXPOSE_REQUIRES_EDGE_AUTH" | "HUMANISH_WATCH_EXPOSE_REQUIRES_LIVE_FOLLOW" | "HUMANISH_WATCH_SAFE_NOT_APPLICABLE" | "HUMANISH_SERVE_TUNNEL_NOT_FOUND" | "HUMANISH_SERVE_TUNNEL_START_FAILED";
+export type CuaActorStudyErrorCode = "HUMANISH_STUDY_ANALYSIS_INVALID" | "HUMANISH_STUDY_TASKS_UNSUPPORTED" | "HUMANISH_STUDY_OPTION_UNSUPPORTED" | "HUMANISH_STUDY_V2_UNSUPPORTED" | "HUMANISH_COMPUTER_USE_FAILED" | "HUMANISH_COMPUTER_USE_KEYS_MISSING" | "HUMANISH_COMPUTER_USE_AGENT_MISSING" | "HUMANISH_COMPUTER_USE_AGENT_SIGNIN_REQUIRED" | "HUMANISH_COMPUTER_USE_SUBJECT_ENV_MISSING" | "HUMANISH_COMPUTER_USE_ACTOR_UNSUPPORTED" | "HUMANISH_COMPUTER_USE_SUBJECT_INVALID" | "HUMANISH_COMPUTER_USE_SUBJECT_UNSAFE" | "HUMANISH_COMPUTER_USE_EXECUTOR_NO_PROVIDER" | "HUMANISH_COMPUTER_USE_LOCAL_APP_NO_EXECUTOR" | "HUMANISH_COMPUTER_USE_LOCAL_DESKTOP_MISSING" | "HUMANISH_COMPUTER_USE_FANOUT_INVALID" | "HUMANISH_COMPUTER_USE_RERUN_INVALID" | "HUMANISH_COMPUTER_USE_DEVICE_GEOMETRY" | "HUMANISH_RUN_ID_IN_USE" | "HUMANISH_COMPUTER_USE_UNPRICED_CAP" | "HUMANISH_COMPUTER_USE_COMMS_CATCH_UNREACHABLE" | "HUMANISH_COMPUTER_USE_COMMS_TOKEN_INVALID" | "HUMANISH_WATCH_ALLOW_REQUIRES_OAUTH" | "HUMANISH_WATCH_OAUTH_REQUIRES_TUNNEL" | "HUMANISH_WATCH_OPTION_CONFLICT" | "HUMANISH_WATCH_TUNNEL_REQUIRES_EXPOSE" | "HUMANISH_WATCH_EXPOSE_REQUIRES_EDGE_AUTH" | "HUMANISH_WATCH_EXPOSE_REQUIRES_LIVE_FOLLOW" | "HUMANISH_WATCH_SAFE_NOT_APPLICABLE" | "HUMANISH_SERVE_TUNNEL_NOT_FOUND" | "HUMANISH_SERVE_TUNNEL_START_FAILED";
 /** Subject provenance projection: what the actor actually drove. */
 export interface CuaSubjectProjection {
     source: "app-url" | "clone" | "local-tree";
@@ -221,7 +221,7 @@ export type CuaSubjectProvenanceArg = {
     envNames: string[];
     state: RunSubjectProvenance["state"];
 };
-export interface CuaActorLabResult extends AutomaticAnalysisResult, StudyResultIdentity<"computer-use"> {
+export interface CuaActorStudyResult extends AutomaticAnalysisResult, StudyResultIdentity<"computer-use"> {
     /** True when the Observer verified the bundle, all live participants passed credibility checks
      * (or this is a dry-run), and no declared adapter/scorer verdict failed. */
     ok: boolean;
@@ -261,7 +261,7 @@ export interface CuaActorLabResult extends AutomaticAnalysisResult, StudyResultI
     diagnostics?: CuaDiagnostics;
     warnings: string[];
     error?: {
-        code: CuaActorLabErrorCode;
+        code: CuaActorStudyErrorCode;
         message: string;
     };
 }
@@ -322,7 +322,7 @@ export declare function participantServeUrl(subject: ParticipantSubject): string
 export interface E2BDesktopDeps {
     /** The plan's residual config: comms, policies, the desktop and target, and subject leftovers. */
     residual: Readonly<ResidualConfig>;
-    labId: string;
+    studyId: string;
     appUrl: string;
     /** What the participant's desktop does with the subject before the participant starts. */
     subject: ParticipantSubject;
@@ -335,15 +335,15 @@ export interface E2BDesktopDeps {
     sandboxMs: number;
     participantCount: number;
     artifactRoot: PreparedOutputRoot;
-    /** The lab's resolution directory: relative paths in the config (a camera .y4m) resolve here. */
-    labCwd: string;
+    /** The study's resolution directory: relative paths in the config (a camera .y4m) resolve here. */
+    studyCwd: string;
     scrubKnownValues: (text: string) => string;
     receiving?: CommsReceivingRun;
     /** Adopter-hosted comms plane: present on the app-url route when comms.email.external is
      *  declared. Carries the parsed comms block (recipients drive the per-participant inbox instruction)
      *  and the inbox URL the persona opens. The drain runs once at run level, not per participant. */
     externalComms?: {
-        email: LabCommsEmail;
+        email: StudyCommsEmail;
         inboxUrl: string;
     };
     /** Injected clock (ms). It measures the host-side E2B desktop create->teardown span so the
@@ -352,11 +352,11 @@ export interface E2BDesktopDeps {
     /** Loads the E2B SDK for the participant's desktop. Defaults to loadE2BDesktopModule. */
     desktopModule?: () => Promise<E2BDesktopModule>;
     /** The caller's prepareDesktop, called with the participant as its target. */
-    prepareDesktop?: NonNullable<RunLabHomes["prepareDesktop"]>;
+    prepareDesktop?: NonNullable<RunStudyHomes["prepareDesktop"]>;
     /** Clock and sleep for detached provisioning steps. */
     detachedTimers?: DetachedTimers;
     /** Receives each live stream's ready and ended: the Observer's tracker, then the caller's onStream. */
-    onStream: NonNullable<RunLabHomes["onStream"]>;
+    onStream: NonNullable<RunStudyHomes["onStream"]>;
     /** Reports a subject phase to the phase sink (stderr by default) and to onEvent. */
     reportSubjectPhase: (event: SubjectPhaseEvent, participant: ParticipantRef) => void;
     /**
@@ -466,17 +466,17 @@ export interface ParticipantRunOutcome {
      *  external outcome constructors (shared-world, test fakes) stay valid; absent counts as false. */
     reportedFriction?: boolean;
     harnessError: boolean;
-    failureCode?: CuaActorLabErrorCode;
+    failureCode?: CuaActorStudyErrorCode;
     /** Relative run-dir path of the digest-only comms-thread evidence artifact this participant wrote
-     *  (humanish.comms-thread.v1), when a comms lab captured mail into its in-sandbox catch. Registered
-     *  in the participant's stream artifacts. Absent when no comms lab ran or nothing was captured. */
+     *  (humanish.comms-thread.v1), when a comms study captured mail into its in-sandbox catch. Registered
+     *  in the participant's stream artifacts. Absent when no comms study ran or nothing was captured. */
     commsArtifactPath?: string;
 }
 /** What buildCuaFanoutBundle projects into a fan-out run bundle. */
 export interface CuaFanoutBundleArgs {
     /** The run's verdict, from the judge. */
     verdict: Verdict;
-    /** 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;
     specs: DesktopParticipantRun[];
     outcomes?: ParticipantRunOutcome[];

package/dist/routes/computer-use/types.js

@@ -2,11 +2,11 @@ import {} from "./participant-desktop.js";
 import {} from "../../analysis/automatic-completion.js";
 import {} from "./diagnostics.js";
 import {} from "../../actors/registry.js";
-import {} from "../../lab/adapter-extension.js";
+import {} from "../../study/adapter-extension.js";
 import {} from "../../substrates/e2b/sdk.js";
 import {} from "../../substrates/e2b/desktop-resources.js";
 import {} from "../../substrates/detached.js";
-import {} from "../../lab/types.js";
+import {} from "../../study/types.js";
 import {} from "../../observer/render.js";
 import {} from "../../run/bundle.js";
 import {} from "../../run/streams.js";
@@ -28,7 +28,7 @@ export const CUA_MAX_CONCURRENCY_ENV = "HUMANISH_CUA_MAX_CONCURRENCY";
 // App-url and in-process routes default to 30 minutes. Provisioned routes (clone/local-tree)
 // default to whatever the 1-hour sandbox cap leaves after provisioning, declared state seeding,
 // and the teardown buffer (20 minutes on a stateless clone), floored at the old five minutes so
-// a state-heavy lab still gets a session at all. An explicit execution.timeoutMs is never
+// a state-heavy study still gets a session at all. An explicit execution.timeoutMs is never
 // adjusted: when it cannot be provisioned, the plan-time cap refusal shows the arithmetic.
 export const DEFAULT_APP_URL_SESSION_TIMEOUT_MS = 30 * 60_000;
 export const MIN_DERIVED_SESSION_TIMEOUT_MS = 5 * 60_000;

package/dist/routes/preview.d.ts

@@ -1,8 +1,8 @@
-import type { AdmittedPlan, RunLabOptions } from "../run-lab.js";
-import type { LabPlan, PlanRefusal } from "../lab/plan-types.js";
+import type { AdmittedPlan, RunStudyOptions } from "../run-study.js";
+import type { StudyPlan, PlanRefusal } from "../study/plan-types.js";
 import type { RunResult } from "../run/results.js";
 import { type StudyResultIdentity } from "../run/study-result.js";
-type PreviewPlan = Extract<LabPlan, {
+type PreviewPlan = Extract<StudyPlan, {
     readonly route: "preview";
 }>;
 /**
@@ -11,9 +11,9 @@ type PreviewPlan = Extract<LabPlan, {
  */
 export type PreviewStudyResult = Omit<RunResult, "schema"> & StudyResultIdentity<"preview">;
 /** A refused preview's result. */
-export declare function previewLabRefusal(cwd: string, studyId: string, refusal: Extract<PlanRefusal, {
+export declare function previewStudyRefusal(cwd: string, studyId: string, refusal: Extract<PlanRefusal, {
     readonly route: "preview";
 }>): PreviewStudyResult;
-/** runLab's step for a preview plan: it has no local checks and takes no scorer, so it returns its run. */
-export declare function admitPreviewPlan(plan: PreviewPlan, input: Pick<RunLabOptions, "cwd" | "runId" | "open">): AdmittedPlan<"preview">;
+/** runStudyWith's step for a preview plan: it has no local checks and takes no scorer, so it returns its run. */
+export declare function admitPreviewPlan(plan: PreviewPlan, input: Pick<RunStudyOptions, "cwd" | "runId" | "open">): AdmittedPlan<"preview">;
 export {};

package/dist/routes/preview.js

@@ -1,10 +1,10 @@
-// The preview route: a lab whose subject is this repo runs the synthetic dry run. planLab decides
+// The preview route: a study whose subject is this repo runs the synthetic dry run. planStudy decides
 // the sim count and refuses what a synthetic run would ignore; runPreviewPlan does the rest.
 import { studyResultIdentity } from "../run/study-result.js";
 import { runDryRun } from "../run/dry-run.js";
 import path from "node:path";
 /** A refused preview's result. */
-export function previewLabRefusal(cwd, studyId, refusal) {
+export function previewStudyRefusal(cwd, studyId, refusal) {
     return {
         ...studyResultIdentity("preview", studyId),
         ok: false,
@@ -13,7 +13,7 @@ export function previewLabRefusal(cwd, studyId, refusal) {
         error: { code: refusal.code, message: refusal.message },
     };
 }
-/** runLab's step for a preview plan: it has no local checks and takes no scorer, so it returns its run. */
+/** runStudyWith's step for a preview plan: it has no local checks and takes no scorer, so it returns its run. */
 export function admitPreviewPlan(plan, input) {
     return {
         ok: true,
@@ -21,7 +21,7 @@ export function admitPreviewPlan(plan, input) {
             route: "preview",
             result: {
                 ...(await runPreviewPlan(plan, input)),
-                ...studyResultIdentity("preview", plan.labId),
+                ...studyResultIdentity("preview", plan.studyId),
             },
         }),
     };
@@ -29,7 +29,7 @@ export function admitPreviewPlan(plan, input) {
 /** Run a preview plan: the synthetic dry run with the planned sim count. */
 function runPreviewPlan(plan, input) {
     return runDryRun({
-        ...(plan.lab === undefined ? {} : { lab: plan.lab }),
+        ...(plan.study === undefined ? {} : { study: plan.study }),
         cwd: input.cwd,
         dryRun: true,
         participantCount: plan.participantCount,

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

@@ -3,9 +3,9 @@ import type { ScriptedBrowserSessionResult } from "../../actors/scripted-browser
 import type { BrowserPersonaJourney, BrowserSurface } from "../../actors/scripted-browser/types.js";
 import type { DesktopResourceObservation } from "../../substrates/e2b/desktop-resources.js";
 import { type ReviewSummary, type RunBundle, type RunSubjectProvenance, type BundleRun } from "../../run/bundle.js";
-/** What the scripted lab's bundle is built from. */
+/** What the scripted study's bundle is built from. */
 interface ScriptedBundleArgs {
-    /** 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;
     appUrl: string;
@@ -13,8 +13,8 @@ interface ScriptedBundleArgs {
     dryRun: boolean;
     hostDigest?: string;
     journey: BrowserPersonaJourney;
-    labId: string;
-    labTitle?: string;
+    studyId: string;
+    studyTitle?: string;
     persona: ActorPersonaRef;
     scenarioSource: string;
     scenarioSourceDigest: string;
@@ -34,11 +34,11 @@ interface ScriptedBundleArgs {
     verdict: ReviewSummary["verdict"];
 }
 /**
- * Project the scripted lab run into a humanish.run-bundle.v1 (no schema change: a new
+ * Project the scripted run into a humanish.run-bundle.v1 (no schema change: a new
  * producer only). The key line is `stream.actor = result.trace`: the provider-neutral
  * ActorTrace seam the Observer renders and verifyRun's engagement check reads. Exported for
  * the bundle-builder tests.
  */
-export declare function buildScriptedLabBundle(args: ScriptedBundleArgs): RunBundle;
+export declare function buildScriptedStudyBundle(args: ScriptedBundleArgs): RunBundle;
 export declare function renderScriptedReviewMarkdown(bundle: RunBundle): string;
 export {};

package/dist/routes/scripted/bundle.js

@@ -1,4 +1,4 @@
-// Assemble the scripted-browser lab's run bundle from its sessions, and the review summary and
+// Assemble the scripted-browser study's run bundle from its sessions, and the review summary and
 // markdown that ship with it.
 import { verdictText } from "../../run/judge.js";
 import { redactText } from "../../evidence/redaction.js";
@@ -7,13 +7,14 @@ import { REVIEW_SCHEMA, bundleArtifacts, bundleHead, } from "../../run/bundle.js
 import {} from "../../run/streams.js";
 import { participantEvent, recordIdOf } from "../../run/participant-records.js";
 import { scriptedSurfaceIds, scriptedSurfaceRecords } from "./surface-records.js";
+import { plural } from "../../run/text.js";
 /**
- * Project the scripted lab run into a humanish.run-bundle.v1 (no schema change: a new
+ * Project the scripted run into a humanish.run-bundle.v1 (no schema change: a new
  * producer only). The key line is `stream.actor = result.trace`: the provider-neutral
  * ActorTrace seam the Observer renders and verifyRun's engagement check reads. Exported for
  * the bundle-builder tests.
  */
-export function buildScriptedLabBundle(args) {
+export function buildScriptedStudyBundle(args) {
     const resultBySurface = new Map(args.sessionResults.map((result) => [result.capture.surface.id, result]));
     // Each surface's records are stamped with the run's start.
     const context = { ...args, createdAt: args.run.createdAt };
@@ -27,7 +28,7 @@ export function buildScriptedLabBundle(args) {
         persona: {
             id: args.persona.id,
             name: `Scripted journey persona (${args.persona.id})`,
-            source: `study:${args.labId}`,
+            source: `study:${args.studyId}`,
             sourceDigest: args.persona.promptDigest,
         },
         scenario: {
@@ -41,7 +42,7 @@ export function buildScriptedLabBundle(args) {
             {
                 at: args.run.createdAt,
                 event: "scripted-lab.run.created",
-                message: `Created scripted-browser lab run with ${args.surfaces.length} surface${args.surfaces.length === 1 ? "" : "s"} (actor ${args.actorId}).`,
+                message: `Created a scripted-browser run with ${args.surfaces.length} surface${args.surfaces.length === 1 ? "" : "s"} (actor ${args.actorId}).`,
             },
         ],
         simulations: records.map((record) => record.simulation),
@@ -69,14 +70,14 @@ function scriptedEvents(args) {
             at: args.run.createdAt,
             level: "info",
             type: "scripted-lab.run.created",
-            message: `Created scripted-browser lab run for ${args.labId} (actor ${args.actorId}, ${args.surfaces.length} surface${args.surfaces.length === 1 ? "" : "s"}).`,
+            message: `Created a scripted-browser run for ${args.studyId} (actor ${args.actorId}, ${args.surfaces.length} surface${args.surfaces.length === 1 ? "" : "s"}).`,
         },
         {
             id: "event-001-subject",
             at: args.run.createdAt,
             level: "info",
             type: "scripted-lab.subject.declared",
-            // Provenance is recorded or its absence declared. The lab did not provision
+            // Provenance is recorded or its absence declared. humanish did not provision
             // this subject on app-url routes; clone routes carry structured subject provenance below.
             message: args.subject
                 ? `Provisioned synthetic subject: clone of ${args.subject.repo}${args.subject.commit ? `@${args.subject.commit}` : ""}, served + getHost-exposed in-sandbox; env names: ${args.subject.envNames?.join(", ") || "none"} (values never persisted); state provenance: ${args.subject.state.provenance}; evidence host digest: ${args.hostDigest ?? "dry-run"}.`
@@ -144,7 +145,7 @@ function buildScriptedReview(args) {
         return {
             schema: REVIEW_SCHEMA,
             verdict: args.verdict,
-            summary: `Scripted lab failed before a terminal session verdict: ${args.sessionError}`,
+            summary: `The scripted run failed before a terminal session verdict: ${args.sessionError}`,
             gaps: [],
         };
     }
@@ -182,7 +183,7 @@ export function renderScriptedReviewMarkdown(bundle) {
         `- scenario: ${bundle.scenario.id} @ ${bundle.scenario.sourceDigest} (${bundle.scenario.source})`,
         ...(subject ? [`- subject: ${subject.message}`] : []),
         ...(spend ? [`- spend: ${spend.message}`] : []),
-        ...traces.map(({ stream, trace }) => `- ${recordIdOf(stream)}: ${trace.provider} (${trace.lane}/${trace.protocol}) ${trace.status} (${trace.completionReason}); ${trace.counts.actions ?? 0} step action(s), ${trace.counts.screenshots ?? 0} raw screenshot(s)`),
+        ...traces.map(({ stream, trace }) => `- ${recordIdOf(stream)}: ${trace.provider} (${trace.lane}/${trace.protocol}) ${trace.status} (${trace.completionReason}); ${plural(trace.counts.actions ?? 0, "step action")}, ${plural(trace.counts.screenshots ?? 0, "raw screenshot")}`),
         ...(bundle.review.gaps.length > 0
             ? ["", "## Gaps", ...bundle.review.gaps.map((gap) => `- ${gap}`)]
             : []),

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

@@ -1,7 +1,7 @@
-import type { LabDeps } from "../../lab/lab-deps.js";
-import type { RoutePlanResult, RouteRefusal, ScriptedPlan } from "../../lab/plan-types.js";
-import type { LabConfig } from "../../lab/types.js";
-/** The error a scripted lab returns before a run starts. */
+import type { StudyDeps } from "../../study/study-deps.js";
+import type { RoutePlanResult, RouteRefusal, ScriptedPlan } from "../../study/plan-types.js";
+import type { StudyConfig } from "../../study/types.js";
+/** The error a scripted study returns before a run starts. */
 export interface ScriptedRefusal extends RouteRefusal<"scripted", "HUMANISH_STUDY_ANALYSIS_INVALID" | "HUMANISH_STUDY_TASKS_UNSUPPORTED" | "HUMANISH_SCRIPTED_ACTOR_UNSUPPORTED" | "HUMANISH_SCRIPTED_SCENARIO_INVALID" | "HUMANISH_SCRIPTED_SUBJECT_UNSAFE"> {
     /**
      * Set on the receiving, analysis and tasks refusals. The route returns those before it opens its
@@ -16,12 +16,12 @@ export type ScriptedPlanResult = RoutePlanResult<ScriptedPlan, ScriptedRefusal>;
 /** The app URL a run's evidence names: a provisioned subject's getHost URL is never persisted. */
 export declare function evidenceAppUrlOf(subject: ScriptedPlan["subject"]): string;
 /** Whether a test injected the browser, so a live run needs no host browser. */
-export declare function injectedBrowser(deps: LabDeps | undefined): boolean;
+export declare function injectedBrowser(deps: StudyDeps | undefined): boolean;
 /**
- * Plan a scripted-browser lab. It is called for any config handed to the scripted runner, not only
+ * Plan a scripted-browser study. It is called for any config handed to the scripted runner, not only
  * one routeOf sends here, so a config for another route gets this route's refusal.
  */
-export declare function planScriptedLab(config: LabConfig, input: {
+export declare function planScriptedStudy(config: StudyConfig, input: {
     readonly dryRun: boolean;
     /** A test's injected browser means a live run needs no host browser. */
     readonly injectedBrowser?: boolean;

package/dist/routes/scripted/plan.js

@@ -5,8 +5,8 @@ import { actorRegistry, isScriptedBrowserActorDescriptor } from "../../actors/re
 import { normalizeLocalAppUrl } from "../../actors/scripted-browser/steps.js";
 import { browserSurfaces } from "../../actors/scripted-browser/types.js";
 import { resolveAutomaticAnalysis } from "../../analysis/automatic-config.js";
-import { isNonEmpty, planBase, provisionedSubject } from "../../lab/plan-base.js";
-import { cloneTargetValidationReason, desktopMediaValidationReason, taskProtocolValidationReason, } from "../../lab/validation.js";
+import { isNonEmpty, planBase, provisionedSubject } from "../../study/plan-base.js";
+import { cloneTargetValidationReason, desktopMediaValidationReason, taskProtocolValidationReason, } from "../../study/validation.js";
 // Default surface roster is 1 (desktop only): the defaults-table single-participant row governs;
 // `count: 2` is the declared override that adds the mobile surface.
 const DEFAULT_SURFACE_COUNT = 1;
@@ -19,17 +19,17 @@ export function injectedBrowser(deps) {
     return Boolean(deps?.launchBrowser || deps?.browserCommand);
 }
 /**
- * Plan a scripted-browser lab. It is called for any config handed to the scripted runner, not only
+ * Plan a scripted-browser study. It is called for any config handed to the scripted runner, not only
  * one routeOf sends here, so a config for another route gets this route's refusal.
  */
-export function planScriptedLab(config, input) {
+export function planScriptedStudy(config, input) {
     const refuse = (code, message, extras = {}) => ({
         ok: false,
         refusal: { route: "scripted", code, message, ...extras },
     });
     const beforeScope = { beforeScope: true };
     if (String(config.comms?.email?.kind) === "real")
-        return refuse("HUMANISH_SCRIPTED_SCENARIO_INVALID", "Real email receiving is unsupported on the scripted route. Use a supported hosted computer-use browser lab.", beforeScope);
+        return refuse("HUMANISH_SCRIPTED_SCENARIO_INVALID", "Real email receiving is unsupported on the scripted route. Use a supported hosted computer-use browser study.", beforeScope);
     const analysis = resolveAutomaticAnalysis(config.review?.analysis);
     if (!analysis.ok)
         return refuse("HUMANISH_STUDY_ANALYSIS_INVALID", analysis.message, beforeScope);
@@ -53,7 +53,7 @@ export function planScriptedLab(config, input) {
     if (config.subject.source === "clone") {
         const provisioned = provisionedSubject(config);
         if (provisioned?.kind !== "clone" || !provisioned.repo)
-            return refuse("HUMANISH_SCRIPTED_SUBJECT_UNSAFE", "clone scripted-browser labs require one subject repo plus subject.serve; parseLabConfig should have rejected this config.", { actor, appUrl: "[provisioned-subject]" });
+            return refuse("HUMANISH_SCRIPTED_SUBJECT_UNSAFE", "clone scripted-browser studies require one subject repo plus subject.serve; parseStudy should have rejected this config.", { actor, appUrl: "[provisioned-subject]" });
         subject = provisioned;
     }
     else {

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

@@ -1,13 +1,13 @@
 import type { ActorPersonaRef } from "../../actors/contract.js";
 import type { ScriptedBrowserSessionResult } from "../../actors/scripted-browser/actor.js";
 import type { BrowserPersonaJourney } from "../../actors/scripted-browser/types.js";
-import type { ScriptedPlan } from "../../lab/plan-types.js";
+import type { ScriptedPlan } from "../../study/plan-types.js";
 import type { RunBundle } from "../../run/bundle.js";
 import type { RunScope } from "../../run/run.js";
 import { type ExecutionFailure } from "../../run/judge.js";
 import type { ObserverResult } from "../../observer/render.js";
 import type { ScriptedSubject } from "./subject.js";
-import { type ScriptedBrowserLabResult } from "./types.js";
+import { type ScriptedBrowserStudyResult } from "./types.js";
 /** What the finish reads from the run. */
 export interface ScriptedFinishInputs {
     plan: ScriptedPlan;
@@ -48,4 +48,4 @@ export declare function scriptedExecutionFailures(args: {
     subject: Pick<ScriptedSubject, "sandboxId" | "killed" | "releaseWarning"> | undefined;
     observer: Pick<ObserverResult, "ok" | "error">;
 }): ExecutionFailure[];
-export declare function finishScriptedRun(inputs: ScriptedFinishInputs): Promise<ScriptedBrowserLabResult>;
+export declare function finishScriptedRun(inputs: ScriptedFinishInputs): Promise<ScriptedBrowserStudyResult>;

package/dist/routes/scripted/result.js

@@ -1,7 +1,7 @@
 import { judgeExecution, sandboxCleanupFailure, judgeScripted, OUTCOME_POLICIES, resultOk, } from "../../run/judge.js";
 import { validatePreparedRunArtifactPaths } from "../../run/paths.js";
 import { resolveSubjectState } from "../computer-use/subject-projection.js";
-import { buildScriptedLabBundle } from "./bundle.js";
+import { buildScriptedStudyBundle } from "./bundle.js";
 import { existingScreenshots } from "./session-result.js";
 import {} from "./types.js";
 import { studyResultIdentity } from "../../run/study-result.js";
@@ -37,7 +37,7 @@ export function scriptedExecutionFailures(args) {
             ? [
                 {
                     kind: "harness",
-                    message: "Scripted lab did not produce terminal sessions for every surface.",
+                    message: "The scripted run did not produce terminal sessions for every surface.",
                 },
             ]
             : []),
@@ -49,7 +49,7 @@ export function scriptedExecutionFailures(args) {
             : [
                 {
                     kind: "evidence",
-                    message: observer.error?.message ?? "Observer failed for the scripted lab run.",
+                    message: observer.error?.message ?? "Observer failed for the scripted run.",
                 },
             ]),
     ];
@@ -90,14 +90,14 @@ export async function finishScriptedRun(inputs) {
         expected: surfaces.length,
         surfaces: sessionResults.map(scriptedSurfaceFacts),
     });
-    const bundle = buildScriptedLabBundle({
+    const bundle = buildScriptedStudyBundle({
         run,
         actorId: actor,
         appUrl: evidenceAppUrl,
         dryRun,
         journey,
-        labId: plan.labId,
-        ...(plan.title ? { labTitle: plan.title } : {}),
+        studyId: plan.studyId,
+        ...(plan.title ? { studyTitle: plan.title } : {}),
         persona,
         scenarioSource: scenario.source,
         scenarioSourceDigest: scenario.sourceDigest,
@@ -136,7 +136,7 @@ export async function finishScriptedRun(inputs) {
     await finished.recordOutcome({ ok, execution });
     const harnessErrorSession = sessionResults.find((result) => result.completionReason === "harness_error");
     return {
-        ...studyResultIdentity("scripted", plan.labId),
+        ...studyResultIdentity("scripted", plan.studyId),
         ok,
         cwd,
         actor,
@@ -172,8 +172,8 @@ export async function finishScriptedRun(inputs) {
                         (observer.ok
                             ? harnessErrorSession
                                 ? `Scripted session ended with a harness error: ${harnessErrorSession.reason}`
-                                : "Scripted lab did not produce terminal sessions for every surface."
-                            : (observer.error?.message ?? "Observer failed for the scripted lab run.")),
+                                : "The scripted run did not produce terminal sessions for every surface."
+                            : (observer.error?.message ?? "Observer failed for the scripted run.")),
                 },
             }),
     };

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

@@ -1,28 +1,28 @@
-import type { ScriptedPlan } from "../../lab/plan-types.js";
-import type { AdmittedPlan } from "../../run-lab.js";
+import type { ScriptedPlan } from "../../study/plan-types.js";
+import type { AdmittedPlan } from "../../run-study.js";
 import { type ScriptedRefusal } from "./plan.js";
-import { type RunScriptedBrowserLabOptions, type ScriptedBrowserLabResult, type ScriptedRunInput } from "./types.js";
+import { type RunScriptedBrowserStudyOptions, type ScriptedBrowserStudyResult, type ScriptedRunInput } from "./types.js";
 /**
  * The config-taking entry point. It plans, returns a refusal with the envelope the route has always
  * returned at that refusal's stage, and otherwise runs the plan.
  */
-export declare function runScriptedBrowserLab(options: RunScriptedBrowserLabOptions): Promise<ScriptedBrowserLabResult>;
+export declare function runScriptedBrowserStudy(options: RunScriptedBrowserStudyOptions): Promise<ScriptedBrowserStudyResult>;
 /**
- * A refused scripted lab's result, at the refusal's stage: a before-scope refusal has its own field
+ * A refused scripted study's result, at the refusal's stage: a before-scope refusal has its own field
  * order and no analysis record; the others come after the output directory checks.
  */
-export declare function scriptedLabRefusal(options: RunScriptedBrowserLabOptions, refusal: ScriptedRefusal): Promise<ScriptedBrowserLabResult>;
+export declare function scriptedStudyRefusal(options: RunScriptedBrowserStudyOptions, refusal: ScriptedRefusal): Promise<ScriptedBrowserStudyResult>;
 /**
- * runLab's step for a scripted plan. It takes no scorer, and its local checks (keys, a browser)
+ * runStudyWith's step for a scripted plan. It takes no scorer, and its local checks (keys, a browser)
  * run inside the run, so it returns the run.
  */
 export declare function admitScriptedPlan(plan: ScriptedPlan, input: ScriptedRunInput): AdmittedPlan<"scripted">;
 /**
  * Run a scripted plan. The run scope gives a direct library caller the same status-record lifetime
  * the CLI gets: returning from this function finalizes any record the run opened, whichever of its
- * fail-closed exits it took. Each route opens its own scope; `runLab` opens none. Without this a
+ * fail-closed exits it took. Each route opens its own scope; `runStudyWith` opens none. Without this a
  * test or an adopter calling the route directly leaves
  * the 5s cadence ticking into a directory something else is deleting, which surfaces as an
  * unrelated ENOTEMPTY.
  */
-export declare function runScriptedPlan(plan: ScriptedPlan, input: ScriptedRunInput): Promise<ScriptedBrowserLabResult>;
+export declare function runScriptedPlan(plan: ScriptedPlan, input: ScriptedRunInput): Promise<ScriptedBrowserStudyResult>;