humanish 0.108.0 → 0.109.0

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

@@ -1,6 +1,6 @@
 // Screen and browser-window geometry on a hosted E2B desktop, measured in the sandbox rather than
 // taken from the request.
-import {} from "../../lab/device-presets.js";
+import {} from "../../study/device-presets.js";
 import { failureTail, redactText, toErrorMessage } from "../../evidence/redaction.js";
 import {} from "../../run/streams.js";
 import { chromeCdpProbeCommand, parseChromeCdpProbeOutput, } from "./cdp-probe.js";

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

@@ -1,10 +1,10 @@
 import { startDesktopMedia } from "../../guest/desktop-media.js";
 import type { E2BDesktopSandbox } from "./sdk.js";
-import type { LabDesktopMedia } from "../../lab/types.js";
+import type { StudyDesktopMedia } from "../../study/types.js";
 /** The same worker and conversation contract, transported by the hosted SDK's stdin/stdout. */
 export declare function startE2BDesktopMedia(options: {
     desktop: E2BDesktopSandbox;
-    media: LabDesktopMedia;
+    media: StudyDesktopMedia;
     signal: AbortSignal;
     onTerminal(): void;
     requestTimeoutMs: number;
@@ -26,4 +26,4 @@ export interface DesktopMediaEvidence {
  * unreadable host file) is named before the browser launches, because a participant told it has
  * a camera and finds none reports the instrument's gap as the product's.
  */
-export declare function prepareDesktopMedia(desktop: E2BDesktopSandbox, media: LabDesktopMedia, permission: "prompt" | "granted", cwd: string, requestTimeoutMs: number, readHostFile?: (absolutePath: string) => Promise<Buffer>): Promise<DesktopMediaEvidence>;
+export declare function prepareDesktopMedia(desktop: E2BDesktopSandbox, media: StudyDesktopMedia, permission: "prompt" | "granted", cwd: string, requestTimeoutMs: number, readHostFile?: (absolutePath: string) => Promise<Buffer>): Promise<DesktopMediaEvidence>;

package/dist/substrates/e2b/lifetime.js

@@ -1,7 +1,7 @@
 // How long an E2B sandbox may live, and the budgets the desktop routes add to a participant's own
 // deadline when they set a sandbox's server-side timeout. A dead host process can never orphan a
 // sandbox past that timeout, so every route derives it from these values.
-import { readPositiveInt } from "../../lab/parse/values.js";
+import { readPositiveInt } from "../../study/parse/values.js";
 /**
  * E2B refuses a sandbox lifetime over one hour ("400: Timeout cannot be greater than 1 hours").
  * A derived deadline has to stay under it, and saying so at plan time beats discovering it from a

package/dist/substrates/e2b/sandbox.d.ts

@@ -1,6 +1,6 @@
 import type { PreparedOutputRoot } from "../../run/contained-output.js";
 import { type DesktopReleaseResult, type OwnedDesktopAllocation } from "../desktop-session.js";
-import type { LabConfig } from "../../lab/types.js";
+import type { StudyConfig } from "../../study/types.js";
 import { type E2BDesktopCreateOptions, type E2BDesktopModule, type E2BDesktopSandbox } from "./sdk.js";
 /** Where an allocation's receipt goes: the run's prepared root, under a public-safe participant
  *  label. The receipt line saves it as `laneId`. */
@@ -66,9 +66,9 @@ export declare function destroyE2BSandbox(module: E2BDesktopModule, sandboxId: s
 }): Promise<E2BSandboxDestroyOutcome>;
 /** Versioned public template built by runtime/browser-media/e2b-template.mjs. */
 export declare const E2B_SPEECH_TEMPLATE = "7409n13kr83f7g7abx5g";
-/** The desktop template a lab asks for; undefined selects the SDK default. */
+/** The desktop template a study asks for; undefined selects the SDK default. */
 export declare function e2bDesktopTemplate(config: {
-    readonly execution?: Pick<NonNullable<LabConfig["execution"]>, "target" | "desktop">;
+    readonly execution?: Pick<NonNullable<StudyConfig["execution"]>, "target" | "desktop">;
 }): string | undefined;
 /** How a caller hears about the one retry; `sleep` is injectable so tests never wait. */
 export interface TransientRetryHooks {

package/dist/substrates/e2b/sandbox.js

@@ -158,7 +158,7 @@ export async function destroyE2BSandbox(module, sandboxId, options) {
 }
 /** Versioned public template built by runtime/browser-media/e2b-template.mjs. */
 export const E2B_SPEECH_TEMPLATE = "7409n13kr83f7g7abx5g";
-/** The desktop template a lab asks for; undefined selects the SDK default. */
+/** The desktop template a study asks for; undefined selects the SDK default. */
 export function e2bDesktopTemplate(config) {
     if (config.execution?.target === "local")
         return undefined;

package/dist/substrates/e2b/sdk.d.ts

@@ -4,7 +4,7 @@ export interface E2BDesktopModule {
         create(options: E2BDesktopCreateOptions): Promise<E2BDesktopSandbox>;
         /**
          * Launch on a custom E2B desktop template (image) by name or ID: the SDK's
-         * `Sandbox.create(template, opts)` overload. Lets a lab run on an adopter-maintained image
+         * `Sandbox.create(template, opts)` overload. Lets a study run on an adopter-maintained image
          * with extra runtimes baked in (e.g. node/bun/a local Postgres the stock `desktop` template
          * lacks), instead of the stock template. The base @e2b/desktop SDK implements this; the
          * wrapper just exposes it. Threaded from `execution.desktop.template`.

package/dist/substrates/e2b/sdk.js

@@ -20,7 +20,7 @@ export async function loadE2BDesktopModule() {
                 : "Live E2B desktop launch requires the optional peer @e2b/desktop, and humanish is running from an " +
                     "npx cache. Node resolves the peer relative to humanish itself, so a copy installed in this project " +
                     "is not found. Install both into the project and run it from there: " +
-                    "`npm i -D humanish @e2b/desktop` then `npx humanish run <lab>`.");
+                    "`npm i -D humanish @e2b/desktop` then `npx humanish run <study>`.");
         }
         throw error;
     }

package/dist/substrates/local/runtime-config.d.ts

@@ -1,6 +1,6 @@
-import type { LabConfig } from "../../lab/types.js";
+import type { StudyConfig } from "../../study/types.js";
 export declare const LOCAL_BROWSER_LIFETIME_MS: number;
-export declare function isLocalBrowserLab(config: LabConfig): boolean;
+export declare function isLocalBrowserStudy(config: StudyConfig): boolean;
 /** Defaults for the explicitly selected local substrate; hosted configurations are untouched. */
-export declare function localBrowserDefaults(config: LabConfig): LabConfig;
-export declare function localBrowserUnsupportedReason(config: LabConfig): string | undefined;
+export declare function localBrowserDefaults(config: StudyConfig): StudyConfig;
+export declare function localBrowserUnsupportedReason(config: StudyConfig): string | undefined;

package/dist/substrates/local/runtime-config.js

@@ -1,15 +1,15 @@
-import { rosterOf } from "../../lab/parse/actors.js";
+import { rosterOf } from "../../study/parse/actors.js";
 // The runtime image enforces a 30-minute lifetime; reserve setup/teardown room.
 export const LOCAL_BROWSER_LIFETIME_MS = 30 * 60_000;
 const MAX_SESSION_MS = 20 * 60_000;
-export function isLocalBrowserLab(config) {
+export function isLocalBrowserStudy(config) {
     return (config.subject.source === "app-url" &&
         config.execution?.target === "local" &&
         ["local-agent", "openai-computer-use"].includes(config.actors[0]?.type ?? ""));
 }
 /** Defaults for the explicitly selected local substrate; hosted configurations are untouched. */
 export function localBrowserDefaults(config) {
-    if (!isLocalBrowserLab(config))
+    if (!isLocalBrowserStudy(config))
         return config;
     return {
         ...config,
@@ -40,7 +40,7 @@ export function localBrowserUnsupportedReason(config) {
     if (config.actors.length !== 1 ||
         !actor ||
         (actor.type === "local-agent" && actor.localAgent !== undefined && actor.localAgent !== "codex")) {
-        return "Local browser labs currently support Codex local-agent or openai-computer-use participants.";
+        return "Local browser studies support only Codex local-agent or openai-computer-use participants.";
     }
     if (desktop?.resolution?.[0] !== 960 ||
         desktop.resolution[1] !== 720 ||

package/dist/tui/contract.d.ts

@@ -1,5 +1,5 @@
-import type { LabListResult } from "../lab/discover.js";
-import type { LabSummary, ReadLabSummaryOptions } from "../lab/summary.js";
+import type { StudyListResult } from "../study/discover.js";
+import type { StudySummary, ReadStudySummaryOptions } from "../study/summary.js";
 import type { RunDetail } from "../run/detail.js";
 import type { ReclaimResult } from "../run/reclaim.js";
 import type { TuiActionResult } from "./actions.js";
@@ -25,11 +25,11 @@ export interface TuiCapabilities {
         read(): Promise<CommsSetupStatus>;
         save(): Promise<CommsSetupResult>;
         check?(): Promise<CommsCheckResult>;
-        labs?(): Promise<{
+        studies?(): Promise<{
             title: string;
             path: string;
         }[]>;
-        configure?(lab: string, apply: boolean, planToken?: string): Promise<CommsConfigureResult>;
+        configure?(study: string, apply: boolean, planToken?: string): Promise<CommsConfigureResult>;
         recovery?(): Promise<CommsRecoveryEntry[]>;
         recover?(runId: string, connectionName: string): Promise<{
             ok: boolean;
@@ -43,7 +43,7 @@ export interface TuiCapabilities {
      * the whole truth: a fresh project has manifests and no runs, and a long-lived one has runs from
      * manifests since renamed or deleted.
      */
-    listLabs(cwd: string): Promise<LabListResult>;
+    listStudies(cwd: string): Promise<StudyListResult>;
     /**
      * Start a run and return once it is running. The run is detached: it outlives this surface, so
      * quitting the TUI (or losing the connection it runs over) does not kill a study that costs
@@ -59,11 +59,11 @@ export interface TuiCapabilities {
      */
     readRunDetail(cwd: string, runId: string): Promise<RunDetail | null>;
     /**
-     * What a lab is: subject, participants, model, spend caps, and whether the keys a live run needs
-     * resolve right now. Read for the lab being looked at, because it is what someone reads before
+     * What a study is: subject, participants, model, spend caps, and whether the keys a live run needs
+     * resolve right now. Read for the study being looked at, because it is what someone reads before
      * deciding to spend money.
      */
-    readLabSummary(cwd: string, lab: string, options?: ReadLabSummaryOptions): Promise<LabSummary | null>;
+    readStudySummary(cwd: string, study: string, options?: ReadStudySummaryOptions): Promise<StudySummary | null>;
     /** Whether this directory is a humanish project: an empty project and a wrong directory are
      *  different problems and must not share a screen. */
     readProjectState(cwd: string): TuiProjectState;

package/dist/tui/contract.js

@@ -5,7 +5,7 @@
 // by the CLI, which imports it from the same modules every other command uses.
 //
 // The reason for the seam: a terminal UI that reads the filesystem itself would become a second
-// implementation of "what is a run, which lab does it belong to, is it alive", one that ships
+// implementation of "what is a run, which study does it belong to, is it alive", one that ships
 // minified, is invisible to the root test suite, and drifts from `humanish runs` the first time
 // either side changes. Injection keeps exactly one implementation, already unit-tested, and leaves
 // the bundle a view layer that can be reasoned about as one.
@@ -47,6 +47,6 @@ export function terminalSurfaceMessage(state) {
         return "`humanish tui` is not built in this checkout; run `pnpm build` (installed packages ship it prebuilt)";
     }
     return state.interactive
-        ? "`humanish tui` opens the interactive surface for browsing labs and runs"
+        ? "`humanish tui` opens the interactive surface for browsing studies and runs"
         : "`humanish tui` is the interactive screen a person uses to watch and start runs here. This shell is not a terminal, so pass it on to a person at one";
 }

package/dist/tui/launch.d.ts

@@ -1,10 +1,10 @@
 import { spawn } from "node:child_process";
-export declare function isSafeLabHandle(value: string): boolean;
+export declare function isSafeStudyHandle(value: string): boolean;
 export interface LaunchRunOptions {
     cwd: string;
     /** The manifest handle (filename stem), as `humanish run` takes it. */
-    lab: string;
-    /** Exact selected manifest, avoiding a same-name committed lab shadowing a local copy. */
+    study: string;
+    /** Exact selected manifest, avoiding a same-name committed study shadowing a local copy. */
     manifestPath?: string;
     mode: "dry-run" | "live";
     /** Injected in tests; defaults to the real spawn. */

package/dist/tui/launch.js

@@ -15,21 +15,21 @@ import { constants as fsConstants } from "node:fs";
 import { open } from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { resolveLabManifest } from "../lab/discover.js";
+import { resolveStudyManifest } from "../study/discover.js";
 import { prepareManagedHumanishOutputDirectory } from "../run/contained-output.js";
 /**
- * A lab handle is the manifest filename, which is what `humanish run` resolves. Restricted to
+ * A study handle is the manifest filename, which is what `humanish run` resolves. Restricted to
  * characters a manifest name can actually contain, and (the part that matters) never allowed to
- * begin with `-`, because argv is positional: a lab called `--json` would otherwise be handed to
+ * begin with `-`, because argv is positional: a study called `--json` would otherwise be handed to
  * the CLI as a flag. There is no shell involved, so this is the whole injection surface.
  *
  * A leading underscore is allowed: `_wip.yaml` is an ordinary way to name a work-in-progress
  * manifest, `humanish run _wip` resolves it, and refusing it here would leave the surface
- * listing a lab it will not start. A leading dot stays out: that names a hidden file, not a lab.
+ * listing a study it will not start. A leading dot stays out: that names a hidden file, not a study.
  */
-const SAFE_LAB_HANDLE = /^[A-Za-z0-9_][A-Za-z0-9._:-]*$/;
-export function isSafeLabHandle(value) {
-    return SAFE_LAB_HANDLE.test(value) && value.length <= 128;
+const SAFE_STUDY_HANDLE = /^[A-Za-z0-9_][A-Za-z0-9._:-]*$/;
+export function isSafeStudyHandle(value) {
+    return SAFE_STUDY_HANDLE.test(value) && value.length <= 128;
 }
 /** Where the CLI lives, relative to this compiled module. */
 function defaultCliPath() {
@@ -40,28 +40,34 @@ function defaultCliPath() {
  * result the surface can render, not an exception that would tear down the screen.
  */
 export async function launchRun(options) {
-    if (!isSafeLabHandle(options.lab)) {
+    if (!isSafeStudyHandle(options.study)) {
         return {
             ok: false,
             error: {
                 code: "HUMANISH_LAUNCH_INVALID_STUDY",
-                message: `"${options.lab}" is not a usable lab handle. Run it by path with \`humanish run <path>\` instead.`,
+                message: `"${options.study}" is not a usable study handle. Run it by path with \`humanish run <path>\` instead.`,
             },
         };
     }
     const cwd = path.resolve(options.cwd);
-    let selectedLab = options.lab;
+    let selectedStudy = options.study;
     if (options.manifestPath !== undefined) {
-        const resolved = await resolveLabManifest(cwd, options.manifestPath);
-        if (!resolved.ok)
+        const resolved = await resolveStudyManifest(cwd, options.manifestPath);
+        if (!resolved.ok) {
+            // A file humanish no longer reads gets discovery's message, which names the fix.
+            const named = resolved.error.code === "HUMANISH_STUDY_V2_UNSUPPORTED" ||
+                resolved.error.code === "HUMANISH_STUDY_RETIRED_DIRECTORY";
             return {
                 ok: false,
                 error: {
                     code: "HUMANISH_LAUNCH_INVALID_STUDY",
-                    message: "The selected study path could not be read safely. Refresh the study list.",
+                    message: named
+                        ? resolved.error.message
+                        : "The selected study path could not be read safely. Refresh the study list.",
                 },
             };
-        selectedLab = path.relative(cwd, path.resolve(cwd, resolved.path)).replace(/\\/g, "/");
+        }
+        selectedStudy = path.relative(cwd, path.resolve(cwd, resolved.path)).replace(/\\/g, "/");
     }
     const now = options.now ?? (() => new Date());
     const spawnFn = options.spawn ?? spawn;
@@ -73,7 +79,7 @@ export async function launchRun(options) {
         // symlinked directory cannot redirect the log somewhere outside the project.
         const logDir = await prepareManagedHumanishOutputDirectory(cwd, "launches");
         const stamp = launchedAt.replace(/[:.]/g, "-");
-        logPath = path.join(logDir.physicalPath, `${stamp}-${options.lab}.log`);
+        logPath = path.join(logDir.physicalPath, `${stamp}-${options.study}.log`);
         // O_NOFOLLOW so a symlink planted at this path cannot redirect a run's output (which may carry
         // provider error text) outside the project, and cannot defeat the 0600 mode by pointing at a
         // file that already exists with looser permissions. O_CREAT|O_APPEND keeps ordinary reuse
@@ -101,7 +107,7 @@ export async function launchRun(options) {
         ...(options.mode === "dry-run" ? ["--dry-run"] : []),
         // `--` ends option parsing, so the handle can only ever be read as the positional argument.
         "--",
-        selectedLab,
+        selectedStudy,
     ];
     const spawnOptions = {
         cwd,