humanish 0.108.0 → 0.109.0

package/dist/{lab → study}/validation.d.ts

@@ -1,56 +1,56 @@
-import type { LabConfig } from "./types.js";
+import type { StudyConfig } from "./types.js";
 /**
  * Cross-validate the computer-use fan-out declaration (`per-lane-worlds`). Returns the failure
- * message, or null when valid. The parser enforces it, and runLab checks it again for a config
+ * message, or null when valid. The parser enforces it, and runStudyWith checks it again for a config
  * that skipped the parser. It runs rosterStructuralValidationReason (id and device
  * validity, unique ids) first, then the route-scoped XOR, cap and policy checks.
  */
-export declare function computerUseValidationReason(config: LabConfig): string | null;
+export declare function computerUseValidationReason(config: StudyConfig): string | null;
 /**
  * Cross-validate a `topology: shared-world` declaration. Returns the failure message, or
  * null when the one shared-world route can run it: the external-public checks for an app-url
  * subject, the provisioned checks otherwise. Enforced at parse and again by the route, since
- * runLab takes a config that skipped the parser.
+ * runStudyWith takes a config that skipped the parser.
  */
-export declare function sharedWorldValidationReason(config: LabConfig): string | null;
+export declare function sharedWorldValidationReason(config: StudyConfig): string | null;
 /**
  * Declared capture devices must be implemented by the selected execution route.
  * Unsupported backends pass false when called directly, where the declared
  * topology may not identify the backend that is actually executing.
  */
-export declare function desktopMediaValidationReason(config: LabConfig, supportsMedia?: boolean): string | undefined;
+export declare function desktopMediaValidationReason(config: StudyConfig, supportsMedia?: boolean): string | undefined;
 /** Reused by direct library runners so unsupported receiving never becomes inert configuration. */
-export declare function receivingEmailValidationReason(config: LabConfig): string | undefined;
+export declare function receivingEmailValidationReason(config: StudyConfig): string | undefined;
 /** Refuse task declarations that the selected execution path would discard.
  * Direct runners pass their actual support rather than trusting the config's dispatch shape. */
-export declare function taskProtocolValidationReason(config: LabConfig, supportsTasks?: boolean): string | null;
+export declare function taskProtocolValidationReason(config: StudyConfig, supportsTasks?: boolean): string | null;
 /**
  * Refuse a clone subject whose target is not an explicit e2b-desktop. Every clone route clones and
- * serves the repo inside a hosted desktop sandbox, and routeOf sends every clone lab to
+ * serves the repo inside a hosted desktop sandbox, and routeOf sends every clone study to
  * one, so any other target, or none, would still run on an E2B desktop. Requiring it explicitly
  * also means the parser's clone checks, which run only on e2b-desktop, cannot be skipped. Enforced
  * at parse and again on the computer-use and scripted-browser routes for library callers.
  */
-export declare function cloneTargetValidationReason(config: LabConfig): string | null;
+export declare function cloneTargetValidationReason(config: StudyConfig): string | null;
 /**
- * Refuse a positive `scenario.caps.maxUsd` or `maxTotalUsd` on a computer-use lab.
+ * Refuse a positive `scenario.caps.maxUsd` or `maxTotalUsd` on a computer-use study.
  * `scenario.caps` belongs to the terminal route; the computer-use route stops on `execution.caps`,
- * so a dollar figure here would read as a cap while the lab ran uncapped. Zero spends nothing
+ * so a dollar figure here would read as a cap while the study ran uncapped. Zero spends nothing
  * either way and stays a warning. Enforced at parse and again on the computer-use routes for
  * library callers.
  */
-export declare function scenarioCapsValidationReason(config: LabConfig): string | null;
+export declare function scenarioCapsValidationReason(config: StudyConfig): string | null;
 /** Refuse a claimed output bound when the route cannot pass it to the first-party provider. */
-export declare function outputTokenLimitValidationReason(config: LabConfig): string | null;
+export declare function outputTokenLimitValidationReason(config: StudyConfig): string | null;
 /**
  * Cross-validate a concurrent shared-world declaration. Returns the failure message,
  * or null when valid. Includes the base shared-world checks plus the concurrent extras: a synthetic
  * subject attestation, a 0.0.0.0 serve bind (getHost only routes to a port bound on
  * all interfaces), and no `subject.clone.keep`/`subject.localTree.keep` (either would
- * orphan actor sandboxes). Enforced at parse and re-enforced in the engine (runLab
+ * orphan actor sandboxes). Enforced at parse and re-enforced in the engine (runStudyWith
  * takes a config that skipped the parser).
  */
-export declare function concurrentSharedWorldValidationReason(config: LabConfig): string | null;
+export declare function concurrentSharedWorldValidationReason(config: StudyConfig): string | null;
 /**
  * Cross-validate the external-public shared-world declaration: a real public
  * deployment used directly as the shared plane (no getHost, no clone, no subject sandbox, no seed).
@@ -60,8 +60,8 @@ export declare function concurrentSharedWorldValidationReason(config: LabConfig)
  * non-loopback appUrl + allowPublicTargets + the operator-ownership attestation subject.publicTarget +
  * concurrency >= 2 + an actors[0].lanes roster of ≥2 with exactly one host participant. The getHost synthetic
  * gate is deliberately unreachable here (there is no internet-reachable harness-owned URL to attest).
- * Enforced at parse and re-enforced in the engine (runLab takes a config that skipped the parser).
+ * Enforced at parse and re-enforced in the engine (runStudyWith takes a config that skipped the parser).
  */
-export declare function externalPublicSharedWorldValidationReason(config: LabConfig): string | null;
+export declare function externalPublicSharedWorldValidationReason(config: StudyConfig): string | null;
 /** Analysis requires a live recording producer, including supported dry-run previews. */
-export declare function automaticAnalysisRouteReason(config: LabConfig): string | undefined;
+export declare function automaticAnalysisRouteReason(config: StudyConfig): string | undefined;

package/dist/{lab → study}/validation.js

@@ -5,7 +5,7 @@ import { declaredTargets } from "./plan-participants.js";
 import { actorResolvesToComputerUse, computerUseParticipantCount, MAX_COMPUTER_USE_PARTICIPANTS, registeredComputerUseActors, resolveEntryUrl, isComputerUseComposition, isScriptedBrowserComposition, isSharedWorldComposition, isTerminalProductComposition, } from "./routing.js";
 /**
  * Cross-validate the computer-use fan-out declaration (`per-lane-worlds`). Returns the failure
- * message, or null when valid. The parser enforces it, and runLab checks it again for a config
+ * message, or null when valid. The parser enforces it, and runStudyWith checks it again for a config
  * that skipped the parser. It runs rosterStructuralValidationReason (id and device
  * validity, unique ids) first, then the route-scoped XOR, cap and policy checks.
  */
@@ -66,7 +66,7 @@ export function computerUseValidationReason(config) {
 }
 /**
  * Engine-level path-token validation for configs supplied directly through the
- * public TypeScript/JavaScript API instead of parseLabConfig.
+ * public TypeScript/JavaScript API instead of parseStudy.
  */
 function rosterStructuralValidationReason(config) {
     const roster = rosterOf(config.actors[0]);
@@ -100,7 +100,7 @@ function rosterStructuralValidationReason(config) {
  * Cross-validate a `topology: shared-world` declaration. Returns the failure message, or
  * null when the one shared-world route can run it: the external-public checks for an app-url
  * subject, the provisioned checks otherwise. Enforced at parse and again by the route, since
- * runLab takes a config that skipped the parser.
+ * runStudyWith takes a config that skipped the parser.
  */
 export function sharedWorldValidationReason(config) {
     return config.subject.source === "app-url"
@@ -192,7 +192,7 @@ export function receivingEmailValidationReason(config) {
         return undefined;
     if (!isComputerUseComposition(config) ||
         !["app-url", "clone", "local-tree"].includes(config.subject.source)) {
-        return "Real email receiving requires a hosted computer-use browser lab with an app-url, clone, or local-tree subject. Scripted, terminal, desktop-cli and local-app routes are unsupported.";
+        return "Real email receiving requires a hosted computer-use browser study with an app-url, clone, or local-tree subject. Scripted, terminal, desktop-cli and local-app routes are unsupported.";
     }
     if (config.actors.some((actor) => actor.type === "local-agent")) {
         return "Real email receiving is unavailable for local-agent: its host process does not isolate the inbox management credential. Use a hosted first-party computer-use actor.";
@@ -216,7 +216,7 @@ export function taskProtocolValidationReason(config, supportsTasks = isComputerU
 }
 /**
  * Refuse a clone subject whose target is not an explicit e2b-desktop. Every clone route clones and
- * serves the repo inside a hosted desktop sandbox, and routeOf sends every clone lab to
+ * serves the repo inside a hosted desktop sandbox, and routeOf sends every clone study to
  * one, so any other target, or none, would still run on an E2B desktop. Requiring it explicitly
  * also means the parser's clone checks, which run only on e2b-desktop, cannot be skipped. Enforced
  * at parse and again on the computer-use and scripted-browser routes for library callers.
@@ -226,12 +226,12 @@ export function cloneTargetValidationReason(config) {
     if (config.subject.source !== "clone" || target === "e2b-desktop")
         return null;
     const got = target === undefined ? "it is absent" : `got "${target}"`;
-    return `clone subjects require \`execution.target: e2b-desktop\` (${got}): the lab clones and serves the repo inside a hosted desktop sandbox. \`execution.target: local\` applies to app-url and local-app subjects.`;
+    return `clone subjects require \`execution.target: e2b-desktop\` (${got}): humanish clones and serves the repo inside a hosted desktop sandbox. \`execution.target: local\` applies to app-url and local-app subjects.`;
 }
 /**
- * Refuse a positive `scenario.caps.maxUsd` or `maxTotalUsd` on a computer-use lab.
+ * Refuse a positive `scenario.caps.maxUsd` or `maxTotalUsd` on a computer-use study.
  * `scenario.caps` belongs to the terminal route; the computer-use route stops on `execution.caps`,
- * so a dollar figure here would read as a cap while the lab ran uncapped. Zero spends nothing
+ * so a dollar figure here would read as a cap while the study ran uncapped. Zero spends nothing
  * either way and stays a warning. Enforced at parse and again on the computer-use routes for
  * library callers.
  */
@@ -242,7 +242,7 @@ export function scenarioCapsValidationReason(config) {
         const value = config.scenario?.caps?.[key];
         if (value === undefined || value <= 0)
             continue;
-        return `scenario.caps.${key} (${value}) does not cap a computer-use lab: this route stops on execution.caps.${key}. Move the value to execution.caps.${key}; scenario.caps applies only to terminal-product labs.`;
+        return `scenario.caps.${key} (${value}) does not cap a computer-use study: this route stops on execution.caps.${key}. Move the value to execution.caps.${key}; scenario.caps applies only to terminal-product studies.`;
     }
     return null;
 }
@@ -274,14 +274,14 @@ function sharedWorldConcurrencyReason(config) {
     const concurrency = config.execution?.concurrency ?? participants;
     if (concurrency >= 2)
         return null;
-    return `shared-world labs need \`execution.concurrency\` of at least 2 (got ${concurrency}). Sequential shared-world turns (concurrency 1) were removed in 0.106.0: omit execution.concurrency to run every participant at once, or set it to 2 or more. A provisioned subject also needs \`subject.exposure: synthetic\` and a \`serve.start\` that binds 0.0.0.0.`;
+    return `shared-world studies need \`execution.concurrency\` of at least 2 (got ${concurrency}). Sequential shared-world turns (concurrency 1) were removed in 0.106.0: omit execution.concurrency to run every participant at once, or set it to 2 or more. A provisioned subject also needs \`subject.exposure: synthetic\` and a \`serve.start\` that binds 0.0.0.0.`;
 }
 /**
  * Cross-validate a concurrent shared-world declaration. Returns the failure message,
  * or null when valid. Includes the base shared-world checks plus the concurrent extras: a synthetic
  * subject attestation, a 0.0.0.0 serve bind (getHost only routes to a port bound on
  * all interfaces), and no `subject.clone.keep`/`subject.localTree.keep` (either would
- * orphan actor sandboxes). Enforced at parse and re-enforced in the engine (runLab
+ * orphan actor sandboxes). Enforced at parse and re-enforced in the engine (runStudyWith
  * takes a config that skipped the parser).
  */
 export function concurrentSharedWorldValidationReason(config) {
@@ -314,7 +314,7 @@ export function concurrentSharedWorldValidationReason(config) {
  * non-loopback appUrl + allowPublicTargets + the operator-ownership attestation subject.publicTarget +
  * concurrency >= 2 + an actors[0].lanes roster of ≥2 with exactly one host participant. The getHost synthetic
  * gate is deliberately unreachable here (there is no internet-reachable harness-owned URL to attest).
- * Enforced at parse and re-enforced in the engine (runLab takes a config that skipped the parser).
+ * Enforced at parse and re-enforced in the engine (runStudyWith takes a config that skipped the parser).
  */
 export function externalPublicSharedWorldValidationReason(config) {
     const structuralReason = rosterStructuralValidationReason(config);
@@ -385,5 +385,5 @@ export function automaticAnalysisRouteReason(config) {
         isSharedWorldComposition(config) ||
         ["app-url", "local-app", "local-tree", "desktop-cli", "terminal-product"].includes(config.subject.source))
         return undefined;
-    return "review.analysis requires a computer-use, scripted-browser, terminal-product or shared-world lab; this lab's route does not produce an eligible live recording.";
+    return "review.analysis requires a computer-use, scripted-browser, terminal-product or shared-world study; this study's route does not produce an eligible live recording.";
 }

package/dist/{lab → study}/warnings.d.ts

@@ -1,12 +1,12 @@
-import type { LabConfig } from "./types.js";
+import type { StudyConfig } from "./types.js";
 /**
  * The fields a config sets that its route does not read, each as `field` or `field (reason)`. A v2
  * file gets them as one warning; a v3 study is refused for any of them.
  */
-export declare function inertFieldLabels(config: LabConfig): string[];
+export declare function inertFieldLabels(config: StudyConfig): string[];
 /**
  * The same fields as `inertFieldLabels`, as paths without their reasons, such as
  * `actors[0].lanes[].entry` or `execution.timeoutMs`. `humanish migrate` drops each one.
  */
-export declare function inertFieldPaths(config: LabConfig): string[];
-export declare function forwardDeclaredWarnings(config: LabConfig): string[];
+export declare function inertFieldPaths(config: StudyConfig): string[];
+export declare function forwardDeclaredWarnings(config: StudyConfig): string[];

package/dist/{lab → study}/warnings.js

@@ -136,7 +136,7 @@ const CONFIG_ROWS = [
     // declared external one would silently collect nothing.
     {
         field: "comms.email.external",
-        reason: "this subject is harness-provisioned, so humanish hosts the catch itself and injects its URL; an adopter-hosted catch would receive nothing. Drop `external` here, or move the lab to an app-url/operator-provisioned subject",
+        reason: "this subject is harness-provisioned, so humanish hosts the catch itself and injects its URL; an adopter-hosted catch would receive nothing. Drop `external` here, or move the study to an app-url or operator-provisioned subject",
         applies: (config) => Boolean(config.comms?.email?.external) &&
             (config.subject.source === "clone" || config.subject.source === "local-tree"),
     },

package/dist/subject/clone.d.ts

@@ -1,15 +1,15 @@
-import type { LabSubjectServe, LabSubjectState } from "../lab/types.js";
+import type { StudySubjectServe, StudySubjectState } from "../study/types.js";
 import type { RunSubjectStateStepRecord } from "../run/bundle.js";
 import { type DetachedTimers } from "../substrates/detached.js";
 import { type Shell } from "../substrates/shell.js";
 import { type SubjectPhaseEvent } from "./steps.js";
-/** The longest provisionCloneSubject can take with the lab's budgets: the clone, then serving. */
-export declare function cloneProvisioningBudgetMs(serve: LabSubjectServe, state: LabSubjectState | undefined): number;
+/** The longest provisionCloneSubject can take with the study's budgets: the clone, then serving. */
+export declare function cloneProvisioningBudgetMs(serve: StudySubjectServe, state: StudySubjectState | undefined): number;
 /**
  * Provision a clone subject inside the sandbox: clone, then the shared serve pipeline (install,
  * state before-build, build, state before-start, start, readiness probe, state after-ready).
  * Returns the latest subject HEAD after successful provisioning. Throws (with a capped log tail
- * for the caller to redact) on any failing step; the lab persists that as a failed-evidence
+ * for the caller to redact) on any failing step; the route persists that as a failed-evidence
  * bundle.
  *
  * Auth: when GITHUB_TOKEN is among the declared subject env names, the clone authenticates via an
@@ -20,9 +20,9 @@ export declare function cloneProvisioningBudgetMs(serve: LabSubjectServe, state:
 export declare function provisionCloneSubject(shell: Shell, args: {
     repo: string;
     depth: number;
-    serve: LabSubjectServe;
+    serve: StudySubjectServe;
     /** Declared subject state (seed steps; external declaration is provenance-only). */
-    state?: LabSubjectState;
+    state?: StudySubjectState;
     hasGithubToken: boolean;
     requestTimeoutMs: number;
     /** Literal scrubber for known provisioned values, applied to log tails pre-truncation. */

package/dist/subject/clone.js

@@ -3,7 +3,7 @@ import { detachedTimersOf, runDetachedStep } from "../substrates/detached.js";
 import { runOrThrow } from "../substrates/shell.js";
 import { runSubjectServePipeline, serveProvisioningBudgetMs } from "./serve.js";
 import { SOURCE_TIMEOUT_MS, emitPhaseCompleted, emitPhaseStarted, SUBJECT_DIR, } from "./steps.js";
-/** The longest provisionCloneSubject can take with the lab's budgets: the clone, then serving. */
+/** The longest provisionCloneSubject can take with the study's budgets: the clone, then serving. */
 export function cloneProvisioningBudgetMs(serve, state) {
     return SOURCE_TIMEOUT_MS + serveProvisioningBudgetMs(serve, state);
 }
@@ -11,7 +11,7 @@ export function cloneProvisioningBudgetMs(serve, state) {
  * Provision a clone subject inside the sandbox: clone, then the shared serve pipeline (install,
  * state before-build, build, state before-start, start, readiness probe, state after-ready).
  * Returns the latest subject HEAD after successful provisioning. Throws (with a capped log tail
- * for the caller to redact) on any failing step; the lab persists that as a failed-evidence
+ * for the caller to redact) on any failing step; the route persists that as a failed-evidence
  * bundle.
  *
  * Auth: when GITHUB_TOKEN is among the declared subject env names, the clone authenticates via an

package/dist/subject/local-tree-archive.d.ts

@@ -76,7 +76,7 @@ export declare function createLocalTreeArchive(root: string, options?: CreateLoc
  * produces (no leading "./", no trailing "/"). Absolute paths and glob syntax
  * are rejected instead of silently ignored: an exclude the author believed in but
  * that never matches anything is a leak vector, so unusable shapes fail
- * closed at the packing boundary (and, for lab manifests, already at parse
- * time in src/lab/parse/subject.ts).
+ * closed at the packing boundary (and, for study manifests, already at parse
+ * time in src/study/parse/subject.ts).
  */
 export declare function normalizeExtraExcludeEntry(entry: string): string;

package/dist/subject/local-tree-archive.js

@@ -111,7 +111,7 @@ export function createLocalTreeArchive(root, options = {}) {
     if (entries.length === 0) {
         throw new Error(`Local tree root "${path.basename(resolvedRoot)}" produced zero packable entries after the always-on denylist` +
             (extraExclude.length > 0 ? " and extraExclude" : "") +
-            "; local-tree packing requires at least one non-denylisted file or symlink. (Paths in this message are basenames only; the packed root is the lab resolution cwd.)");
+            "; local-tree packing requires at least one non-denylisted file or symlink. (Paths in this message are basenames only; the packed root is the study's working directory.)");
     }
     // Check the cap from enumerated sizes before reading/hashing file bytes, so
     // an oversized tree fails closed without the cost of hashing all of it.
@@ -292,8 +292,8 @@ function isDenylistedSegment(relPath) {
  * produces (no leading "./", no trailing "/"). Absolute paths and glob syntax
  * are rejected instead of silently ignored: an exclude the author believed in but
  * that never matches anything is a leak vector, so unusable shapes fail
- * closed at the packing boundary (and, for lab manifests, already at parse
- * time in src/lab/parse/subject.ts).
+ * closed at the packing boundary (and, for study manifests, already at parse
+ * time in src/study/parse/subject.ts).
  */
 export function normalizeExtraExcludeEntry(entry) {
     const trimmed = entry.trim();

package/dist/subject/local-tree.d.ts

@@ -1,4 +1,4 @@
-import type { LabSubjectServe, LabSubjectState } from "../lab/types.js";
+import type { StudySubjectServe, StudySubjectState } from "../study/types.js";
 import type { RunSubjectStateStepRecord } from "../run/bundle.js";
 import { type DetachedTimers } from "../substrates/detached.js";
 import type { Shell } from "../substrates/shell.js";
@@ -14,9 +14,9 @@ import { type SubjectPhaseEvent } from "./steps.js";
 export declare function provisionLocalTreeSubject(shell: Shell, args: {
     /** The once-per-run packed archive bytes (shared byte-identically across every participant). */
     archiveBuffer: ArrayBuffer;
-    serve: LabSubjectServe;
+    serve: StudySubjectServe;
     /** Declared subject state (seed steps; external declaration is provenance-only). */
-    state?: LabSubjectState;
+    state?: StudySubjectState;
     requestTimeoutMs: number;
     /** Literal scrubber for known provisioned values, applied to log tails pre-truncation. */
     scrub: (text: string) => string;

package/dist/subject/runtime.js

@@ -5,11 +5,11 @@
 // Node for the computer-use clone/local-tree route. Without it, any study whose `serve.install`
 // runs npm or pnpm dies with `pnpm: command not found` after its sandbox is created and paid for.
 //
-// That failure is invisible up front: `lab inspect` is clean, the plan prints normally, the sandbox
+// That failure is invisible up front: `study show` is clean, the plan prints normally, the sandbox
 // provisions, and the first signal is a shell exit code attributed to "subject install failed".
 // Nobody can debug that from the outside.
 //
-// The harness provides the runtime instead of warning about it. An adopter writing a lab for a Node app should not have to
+// The harness provides the runtime instead of warning about it. An adopter writing a study for a Node app should not have to
 // know which binaries the template happens to carry. That is the harness's job, and the terminal
 // route already treats it that way. Detection is conservative and the bootstrap is skipped whenever
 // a runtime is already present, so a custom template that ships Node pays nothing.

package/dist/subject/serve.d.ts

@@ -1,4 +1,4 @@
-import type { LabSubjectServe, LabSubjectState } from "../lab/types.js";
+import type { StudySubjectServe, StudySubjectState } from "../study/types.js";
 import type { RunSubjectStateStepRecord } from "../run/bundle.js";
 import { type DetachedTimers } from "../substrates/detached.js";
 import type { Shell } from "../substrates/shell.js";
@@ -8,7 +8,7 @@ import { type SubjectPhaseEvent } from "./steps.js";
  * with their one retry, the package-manager step, every seed step, the build and the readiness
  * wait. Detached-step polling adds seconds on top.
  */
-export declare function serveProvisioningBudgetMs(serve: LabSubjectServe, state: LabSubjectState | undefined): number;
+export declare function serveProvisioningBudgetMs(serve: StudySubjectServe, state: StudySubjectState | undefined): number;
 /**
  * The provisioning pipeline the clone and local-tree routes share once SUBJECT_DIR is populated
  * (by git clone, or by upload and extract): install, state before-build, build, state
@@ -21,9 +21,9 @@ export declare function serveProvisioningBudgetMs(serve: LabSubjectServe, state:
  * eats the session budget.
  */
 export declare function runSubjectServePipeline(shell: Shell, args: {
-    serve: LabSubjectServe;
+    serve: StudySubjectServe;
     /** Declared subject state (seed steps; external declaration is provenance-only). */
-    state?: LabSubjectState;
+    state?: StudySubjectState;
     requestTimeoutMs: number;
     /** Literal scrubber for known provisioned values, applied to log tails pre-truncation. */
     scrub: (text: string) => string;

package/dist/subject/state.d.ts

@@ -1,4 +1,4 @@
-import type { LabStateStepWhen, LabSubjectState } from "../lab/types.js";
+import type { StudyStateStepWhen, StudySubjectState } from "../study/types.js";
 import type { RunSubjectStateStepRecord } from "../run/bundle.js";
 import { type DetachedTimers } from "../substrates/detached.js";
 import type { Shell } from "../substrates/shell.js";
@@ -11,8 +11,8 @@ export declare function commandDigestOf(command: string): string;
  * `subject-state-<name>` so a step can never collide with a serve step. Each step's record goes
  * to `onStateStep` as it finishes; the first failure throws with its scrubbed log tail.
  */
-export declare function runStateSteps(shell: Shell, when: LabStateStepWhen, args: {
-    state?: LabSubjectState;
+export declare function runStateSteps(shell: Shell, when: StudyStateStepWhen, args: {
+    state?: StudySubjectState;
     requestTimeoutMs: number;
     /** Literal scrubber for known provisioned values, applied to log tails pre-truncation. */
     scrub: (text: string) => string;

package/dist/subject/state.js

@@ -39,7 +39,7 @@ export async function runStateSteps(shell, when, args) {
         args.onStateStep?.({
             name: step.name,
             when,
-            // Digest only (sha256-16): the command text never persists: the lab YAML in the
+            // Digest only (sha256-16): the command text never persists: the study YAML in the
             // consumer's repo is the plaintext source of truth.
             commandDigest: commandDigestOf(step.command),
             ok: result.ok,

package/dist/subject/steps.d.ts

@@ -27,7 +27,7 @@ export declare function emitPhaseCompleted(onPhase: ((event: SubjectPhaseEvent)
 /** Default phase-boundary sink (stderr): one line per event, prefixed with the participant id
  *  only when the run has more than one participant. A single participant still gets every line:
  *  a silent clone, install, build and ready boot is the bug this event stream exists to close.
- *  Overridable via LabDeps.subjectPhaseSink so deterministic tests capture instead of writing to
+ *  Overridable via StudyDeps.subjectPhaseSink so deterministic tests capture instead of writing to
  *  the real stderr. */
 export declare function defaultSubjectPhaseSink(event: SubjectPhaseEvent, participant: {
     readonly id: string;

package/dist/subject/steps.js

@@ -25,7 +25,7 @@ export function emitPhaseCompleted(onPhase, now, startedAt, phase, ok, message)
 /** Default phase-boundary sink (stderr): one line per event, prefixed with the participant id
  *  only when the run has more than one participant. A single participant still gets every line:
  *  a silent clone, install, build and ready boot is the bug this event stream exists to close.
- *  Overridable via LabDeps.subjectPhaseSink so deterministic tests capture instead of writing to
+ *  Overridable via StudyDeps.subjectPhaseSink so deterministic tests capture instead of writing to
  *  the real stderr. */
 export function defaultSubjectPhaseSink(event, participant) {
     const durationSuffix = event.durationMs === undefined ? "" : ` (${event.durationMs}ms)`;

package/dist/substrates/desktop-session.js

@@ -1,4 +1,4 @@
-import { CuaExecutorError } from "../actors/computer-use/executor-error.js";
+import { ComputerUseExecutorError } from "../actors/computer-use/executor-error.js";
 /**
  * Wrap an already-acquired resource. The adapter supplies release authority as a closure;
  * this layer never reconstructs it from a saved ID or enumerates provider resources.
@@ -12,7 +12,7 @@ export function ownDesktopAllocation(options) {
     let closing;
     const assertOpen = () => {
         if (closing !== undefined)
-            throw new CuaExecutorError("executor_closed", "not_dispatched");
+            throw new ComputerUseExecutorError("executor_closed", "not_dispatched");
     };
     const close = (policy = {}) => {
         // Install the promise before invoking release: concurrent/reentrant callers share it.

package/dist/substrates/detached.d.ts

@@ -10,7 +10,7 @@ export declare function detachedTimersOf(options: DetachedTimers): DetachedTimer
 export interface DetachedStepOptions extends DetachedTimers {
     /** Short [a-z0-9-] label; names the script/status/log files under /tmp. */
     name: string;
-    /** The shell command to run (the lab author's own command: package.json-script trust). */
+    /** The shell command to run (the study author's own command: package.json-script trust). */
     command: string;
     cwd?: string;
     /** Wall-clock budget for the step. */

package/dist/substrates/e2b/desktop-browser.d.ts

@@ -1,4 +1,4 @@
-import type { LabDesktopBrowser } from "../../lab/types.js";
+import type { StudyDesktopBrowser } from "../../study/types.js";
 import type { E2BDesktopSandbox } from "./sdk.js";
 import type { DesktopMediaEvidence } from "./desktop-media.js";
 export declare const DESKTOP_SETTLE_MS = 8000;
@@ -27,7 +27,7 @@ export type ChromeDevToolsReadiness = {
 /** Reads the readiness markers from a launch command's stdout. */
 export declare function parseChromeDevToolsReadiness(stdout: string): ChromeDevToolsReadiness | undefined;
 export interface DesktopBrowserEvidence {
-    requested: LabDesktopBrowser;
+    requested: StudyDesktopBrowser;
     resolved?: string;
     /** Synthetic media devices the browser was launched with, and how permission is answered. */
     media?: DesktopMediaEvidence;
@@ -42,7 +42,7 @@ export interface DesktopBrowserLaunchIdentity {
 }
 /**
  * Runtime-only launch result. `evidence` is what the bundle records: the requested browser and the
- * one that launched, and only when the lab declared a browser.
+ * one that launched, and only when the study declared a browser.
  */
 export interface DesktopBrowserLaunchResult {
     family: DesktopBrowserFamily;
@@ -65,7 +65,7 @@ export declare function buildFillDesktopWindowCommand(windowId: string, width: n
  * below checks for clipping and refuses an uncorrectable window before the actor runs.
  */
 export declare function fillDesktopBrowserWindow(desktop: E2BDesktopSandbox, windowId: string, resolution: readonly [number, number], requestTimeoutMs: number): Promise<void>;
-export declare function openDesktopBrowserTarget(desktop: E2BDesktopSandbox, targetUrl: string, requestTimeoutMs: number, browserPreference: LabDesktopBrowser | undefined, 
+export declare function openDesktopBrowserTarget(desktop: E2BDesktopSandbox, targetUrl: string, requestTimeoutMs: number, browserPreference: StudyDesktopBrowser | undefined, 
 /** Launch-time flags that make mobile fidelity hold across every tab: the user agent and
  *  touch events are browser-wide here, where the CDP holder covers only the launch page. */
 extraChromiumFlags?: readonly string[], environment?: Readonly<Record<string, string>>): Promise<DesktopBrowserLaunchResult>;

package/dist/substrates/e2b/desktop-browser.js

@@ -2,7 +2,7 @@
 // window a desktop-CLI study starts in.
 import { CHROMIUM_EVIDENCE_HYGIENE_FLAGS, chromiumEvidenceProfilePreferencesJson, } from "../../evidence/browser-hygiene.js";
 import { failureTail } from "../../evidence/redaction.js";
-import { isHttpUrl } from "../../lab/parse/subject.js";
+import { isHttpUrl } from "../../study/parse/subject.js";
 import { runDetachedStep } from "../detached.js";
 import { shellQuote } from "../shell.js";
 import { e2bShell } from "./shell.js";

package/dist/substrates/e2b/desktop-cdp.d.ts

@@ -59,7 +59,7 @@ export declare function makeChromeBrowserStateObserver(desktop: E2BDesktopSandbo
     text?: string;
     scrollY?: number;
 }>;
-/** The user agent a mobile-emulated participant presents unless the lab sets its own. */
+/** The user agent a mobile-emulated participant presents unless the study sets its own. */
 export declare const DEFAULT_MOBILE_USER_AGENT = "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1";
 /**
  * Apply mobile emulation to the participant's launch page and read back what the page reports.

package/dist/substrates/e2b/desktop-cdp.js

@@ -97,7 +97,7 @@ export function makeChromeBrowserStateObserver(desktop, requestTimeoutMs, endpoi
         };
     };
 }
-/** The user agent a mobile-emulated participant presents unless the lab sets its own. */
+/** The user agent a mobile-emulated participant presents unless the study sets its own. */
 export const DEFAULT_MOBILE_USER_AGENT = "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1";
 /**
  * Apply mobile emulation to the participant's launch page and read back what the page reports.

package/dist/substrates/e2b/desktop-executor.d.ts

@@ -77,7 +77,7 @@ export type CuaTypePhase = "desktop-write" | "text-tempfile" | "text-command";
  * password), so the message names the phase and, for xdotool, its exit code only: no text, no
  * temp-file path, no substrate output. The loop records `.name` + `.message` into the actor trace.
  */
-export declare class CuaTypeError extends Error {
+export declare class ComputerUseTypeError extends Error {
     readonly phase: CuaTypePhase;
     readonly exitCode?: number;
     constructor(phase: CuaTypePhase, exitCode?: number);

package/dist/substrates/e2b/desktop-executor.js

@@ -1,7 +1,7 @@
 import { shellQuote } from "../shell.js";
 import { perceptualSignature } from "../../evidence/frame-signature.js";
 import { commandFailureInfo } from "../command-failure.js";
-import { CuaExecutorError } from "../../actors/computer-use/executor-error.js";
+import { ComputerUseExecutorError } from "../../actors/computer-use/executor-error.js";
 import { xdotoolHeldModifiers } from "../../guest/desktop-keys.js";
 const DEFAULT_WAIT_MS = 500;
 const DEFAULT_SCROLL_AMOUNT_PER_TICK = 100;
@@ -72,12 +72,12 @@ function toBuffer(bytes) {
  * password), so the message names the phase and, for xdotool, its exit code only: no text, no
  * temp-file path, no substrate output. The loop records `.name` + `.message` into the actor trace.
  */
-export class CuaTypeError extends Error {
+export class ComputerUseTypeError extends Error {
     phase;
     exitCode;
     constructor(phase, exitCode) {
         super(`type failed at ${phase}${exitCode === undefined ? "" : ` (exit ${exitCode})`}`);
-        this.name = "CuaTypeError";
+        this.name = "ComputerUseTypeError";
         this.phase = phase;
         if (exitCode !== undefined)
             this.exitCode = exitCode;
@@ -107,17 +107,17 @@ async function typeText(desktop, text) {
         directory = made.stdout?.trim();
     }
     catch {
-        throw new CuaTypeError("text-tempfile");
+        throw new ComputerUseTypeError("text-tempfile");
     }
     if (directory === undefined || !TYPE_DIRECTORY.test(directory))
-        throw new CuaTypeError("text-tempfile");
+        throw new ComputerUseTypeError("text-tempfile");
     const file = `${directory}/text`;
     try {
         try {
             await files.write(file, text, { requestTimeoutMs: TYPE_COMMAND_TIMEOUT_MS });
         }
         catch {
-            throw new CuaTypeError("text-tempfile");
+            throw new ComputerUseTypeError("text-tempfile");
         }
         // xdotool waits the delay after every character, so a long text needs a longer budget.
         const timeoutMs = TYPE_COMMAND_TIMEOUT_MS + [...text].length * XDOTOOL_TYPE_DELAY_MS;
@@ -127,11 +127,11 @@ async function typeText(desktop, text) {
         }
         catch (error) {
             // The SDK throws on a non-zero exit; only its exit code is kept.
-            throw new CuaTypeError("text-command", commandFailureInfo(error).exitCode);
+            throw new ComputerUseTypeError("text-command", commandFailureInfo(error).exitCode);
         }
         // A structural fake may return a non-zero exit instead of throwing, as the SDK does.
         if (result?.exitCode !== undefined && result.exitCode !== 0)
-            throw new CuaTypeError("text-command", result.exitCode);
+            throw new ComputerUseTypeError("text-command", result.exitCode);
     }
     finally {
         await commands.run(`rm -rf -- ${shellQuote(directory)}`, quick).catch(() => undefined);
@@ -230,7 +230,7 @@ export function createE2BDesktopExecutor(desktop, options = {}) {
                     await desktop.write(action.text);
                 }
                 catch {
-                    throw new CuaTypeError("desktop-write");
+                    throw new ComputerUseTypeError("desktop-write");
                 }
                 return;
             }
@@ -261,7 +261,7 @@ export function createE2BDesktopExecutor(desktop, options = {}) {
                 // capturing here would double-capture. Leave the desktop untouched.
                 return;
             case "speak":
-                throw new CuaExecutorError("action_rejected", "not_dispatched");
+                throw new ComputerUseExecutorError("action_rejected", "not_dispatched");
         }
     }
 }
@@ -278,7 +278,7 @@ function sendsNoInput(action) {
 async function withHeldModifiers(desktop, chord, run) {
     const commands = desktop.commands;
     if (!commands)
-        throw new CuaExecutorError("action_rejected", "not_dispatched");
+        throw new ComputerUseExecutorError("action_rejected", "not_dispatched");
     const options = { requestTimeoutMs: HELD_KEYS_TIMEOUT_MS, timeoutMs: HELD_KEYS_TIMEOUT_MS };
     let failed = false;
     let failure;
@@ -295,7 +295,7 @@ async function withHeldModifiers(desktop, chord, run) {
         await commands.run(`xdotool keyup ${chord}`, options);
     }
     catch {
-        throw new CuaExecutorError("execution_failed", "outcome_uncertain");
+        throw new ComputerUseExecutorError("execution_failed", "outcome_uncertain");
     }
     if (failed)
         throw failure;

package/dist/substrates/e2b/desktop-geometry.d.ts

@@ -1,4 +1,4 @@
-import { type DevicePreset } from "../../lab/device-presets.js";
+import { type DevicePreset } from "../../study/device-presets.js";
 import { type RunDesktopGeometry } from "../../run/streams.js";
 import { type ChromeCdpPagePreference } from "./cdp-probe.js";
 import { type DesktopBrowserFamily, type DesktopBrowserLaunchIdentity } from "./desktop-browser.js";