humanish 0.108.0 → 0.109.1

package/examples/scorer/scorer.mjs

@@ -1,8 +1,8 @@
 // @ts-check
 // A scorer module: humanish calls `score` over the finished evidence of a computer-use,
 // shared-world or terminal run and stores the result, under your namespace, as
-// `bundle.adapterScore`. The same file works with `humanish lab run <lab> --scorer scorer.mjs` and,
-// from a library caller, as the scorer hooks passed to `runLab`.
+// `bundle.adapterScore`. The same file works with `humanish run <study> --scorer scorer.mjs` and,
+// from a library caller, as the scorer hooks passed to `runStudy`.
 
 /** @type {NonNullable<import("humanish").AdapterScorerModule["score"]>} */
 export function score(ctx) {
@@ -14,7 +14,7 @@ export function score(ctx) {
     // A dry run has no participant behavior to judge, so this rubric withholds a pass.
     status: dryRun ? "partial" : "pass",
     score: dryRun ? 50 : 100,
-    summary: `${participants} participant stream(s) in ${ctx.labId}${dryRun ? " (dry run)" : ""}.`,
+    summary: `${participants} participant stream(s) in ${ctx.studyId}${dryRun ? " (dry run)" : ""}.`,
     data: { participants, runId: ctx.runId },
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "humanish",
-  "version": "0.108.0",
+  "version": "0.109.1",
   "description": "Synthetic user research for apps, CLIs, and agent-facing product flows.",
   "keywords": [
     "cli",
@@ -91,6 +91,7 @@
     "prose:check": "node scripts/check-code-prose.mjs",
     "vocabulary:check": "tsx scripts/check-retired-words.ts",
     "site-css:check": "node scripts/check-site-css.mjs",
+    "site:tour": "tsx scripts/site-tour.ts",
     "site:hero:proof": "node scripts/site-hero-wrap-proof.mjs"
   },
   "dependencies": {

package/skills/humanish/SKILL.md

@@ -252,9 +252,11 @@ defaults:
 A study declares its `route` (`preview`, `computer-use`, `shared-world`, `terminal` or
 `scripted`) and composes `subject`, `actor`, `participants`, `caps`, `execution` and
 `policies` for it; a key the route does not read is a parse error that names the route.
-Run `npx humanish study show <study>` to see how a study file parses. A
-`humanish.lab.v2` file from 0.107 still runs with a warning; `npx humanish migrate`
-rewrites it as v3 under `studies/`.
+Run `npx humanish study show <study>` to see how a study file parses. humanish
+no longer runs a `humanish.lab.v2` file from 0.107: it fails with
+`HUMANISH_STUDY_V2_UNSUPPORTED`. `npx humanish migrate` rewrites every v2 file as v3
+under `studies/`, and `--dry-run` lists them first. A v3 file left in a `labs/` folder
+fails with `HUMANISH_STUDY_RETIRED_DIRECTORY`; move it to the matching `studies/` folder.
 
 ### Many actors at once (fan-out, shared worlds, concurrency)
 
@@ -403,7 +405,7 @@ still runs by default when `OPENAI_API_KEY` is set, with a $3 cap; keep
 `review.analysis: false` to skip it. Copy the shape of
 [`humanish/studies/scripted-demo.yaml`](https://github.com/danielgwilson/humanish/blob/main/humanish/studies/scripted-demo.yaml)
 or the example in the
-[lab manifest reference](https://humanish.dev/docs/lab-manifests#scripted-browser-scenarios):
+[study file reference](https://humanish.dev/docs/study-files#scripted-browser-scenarios):
 set `subject.appUrl` to the loopback URL, `scenario` to the scenario id,
 and `mode: live`. Without `mode: live` the study is a dry run that opens
 no browser.
@@ -417,8 +419,8 @@ npx humanish observe --run latest --open   # for a person; it serves until Ctrl-
 ```
 
 Do not use `humanish watch --count ...` as a substitute for a scripted-browser
-study. `watch` renders or follows Observer evidence; a live scripted-browser study
-captures desktop and mobile browser evidence against a running app.
+study. `watch` without a study starts a preview run for the Observer; a live scripted-browser
+study captures desktop and mobile browser evidence against a running app.
 
 ## Optional Live E2B Study
 

package/skills/humanish/agents/openai.yaml

@@ -1,7 +1,7 @@
 interface:
   display_name: "humanish CLI"
   short_description: "Set up public-safe persona simulation"
-  default_prompt: "Use $humanish to install humanish in this repo, scaffold synthetic personas and scenarios, run the safe Observer proof, and report the public-safe artifacts. If the app can run locally, start it on loopback and run a live scripted study (see https://humanish.dev/docs/lab-manifests#scripted-browser-scenarios; set `mode: live` and keep `review.analysis: false`) before opening the Observer with `humanish observe --run latest`; do not treat `watch --count` as app behavior proof."
+  default_prompt: "Use $humanish to install humanish in this repo, scaffold synthetic personas and scenarios, run the safe Observer proof, and report the public-safe artifacts. If the app can run locally, start it on loopback and run a live scripted study (see https://humanish.dev/docs/study-files#scripted-browser-scenarios; set `mode: live` and keep `review.analysis: false`) before opening the Observer with `humanish observe --run latest`; do not treat `watch --count` as app behavior proof."
 
 policy:
   allow_implicit_invocation: true

package/dist/cli/commands/lab-format.d.ts

@@ -1,9 +0,0 @@
-import type { HumanOutput } from "../io.js";
-import type { CuaActorLabResult } from "../../routes/computer-use/types.js";
-import type { ScriptedBrowserLabResult } from "../../routes/scripted/types.js";
-import type { TerminalProductLabResult } from "../../routes/terminal/types.js";
-import type { ConcurrentSharedWorldLabResult } from "../../routes/shared-world/types.js";
-export declare function formatConcurrentSharedWorldLabHuman(result: ConcurrentSharedWorldLabResult): HumanOutput;
-export declare function formatTerminalLabHuman(result: TerminalProductLabResult): HumanOutput;
-export declare function formatScriptedLabHuman(result: ScriptedBrowserLabResult): HumanOutput;
-export declare function formatCuaLabHuman(result: CuaActorLabResult): HumanOutput;

package/dist/cli/commands/lab-route-run.d.ts

@@ -1,19 +0,0 @@
-import { type InternalRunLabOptions, type LabOutcome } from "../../run-lab.js";
-import type { LabConfig } from "../../lab/types.js";
-import type { LoadedAdapterScorer } from "./lab-scorer.js";
-export interface RouteRun {
-    readonly options: InternalRunLabOptions;
-    present(outcome: LabOutcome): Promise<void>;
-    /** Handles an error runLab threw, and rethrows any it does not handle. */
-    onRunError?(error: unknown): Promise<void>;
-}
-/**
- * Plans the lab with a route's options, then presents the refusal or the run. `beforeRun` runs
- * only for a plan that will run: it loads the scorer, or writes its own refusal and returns
- * undefined, so a refused lab never imports the scorer's host code. `afterRun` runs once runLab
- * has returned or thrown, before presentation, which may hold its own signal handlers (watch's
- * Observer and tunnel).
- */
-export declare function runRoute(config: LabConfig, run: RouteRun, beforeRun?: () => Promise<{
-    scorer?: LoadedAdapterScorer;
-} | undefined>, afterRun?: () => void): Promise<void>;

package/dist/cli/commands/lab-route-scripted.d.ts

@@ -1,17 +0,0 @@
-import { Command } from "commander";
-import type { LabConfig } from "../../lab/types.js";
-import { type CliIo, type LabCommandOptions } from "../io.js";
-import type { RouteRun } from "./lab-route-run.js";
-interface ScriptedRouteArgs {
-    command: Command;
-    io: CliIo;
-    config: LabConfig;
-    mode: "run" | "watch";
-    options: LabCommandOptions;
-}
-/**
- * The scripted route's CLI setup: its open semantics and runLab options, and how it presents the
- * outcome. Undefined when watch-mode setup has already written its own result.
- */
-export declare function scriptedRouteRun(args: ScriptedRouteArgs): RouteRun | undefined;
-export {};

package/dist/cli/commands/lab-route-terminal.d.ts

@@ -1,17 +0,0 @@
-import { Command } from "commander";
-import type { LabConfig } from "../../lab/types.js";
-import { type CliIo, type LabCommandOptions } from "../io.js";
-import type { RouteRun } from "./lab-route-run.js";
-interface TerminalRouteArgs {
-    command: Command;
-    io: CliIo;
-    config: LabConfig;
-    mode: "run" | "watch";
-    options: LabCommandOptions;
-}
-/**
- * The terminal route's CLI setup: its open semantics and runLab options, and how it presents the
- * outcome. Undefined when watch-mode setup has already written its own result.
- */
-export declare function terminalRouteRun(args: TerminalRouteArgs): RouteRun | undefined;
-export {};

package/dist/cli/commands/lab-run.d.ts

@@ -1,9 +0,0 @@
-import { Command } from "commander";
-import { type CliIo, type LabCommandOptions } from "../io.js";
-export declare function runLabCommand(args: {
-    command: Command;
-    io: CliIo;
-    lab: string;
-    mode: "run" | "watch";
-    options: LabCommandOptions;
-}): Promise<void>;

package/dist/lab/composition-rules.d.ts

@@ -1,7 +0,0 @@
-import type { LabConfig } from "./types.js";
-/** The first composition rule a config breaks, in the parser's order, or null. */
-export declare function compositionReason(config: LabConfig): string | null;
-/** Why a this-repo lab cannot run live. The parser and the preview planner both refuse with it. */
-export declare const THIS_REPO_DRY_RUN_ONLY = "this-repo labs are dry-run only; use a clone or app-url subject for a live run.";
-/** A desktop-cli subject with no product to study. The computer-use planner checks this too. */
-export declare function desktopCliProductReason(config: LabConfig): string | null;

package/dist/lab/config.d.ts

@@ -1,7 +0,0 @@
-import { type LabConfigParseResult } from "./types.js";
-/**
- * Validate a parsed YAML object into a LabConfig. Pure: the caller owns file IO. Structural
- * validation only. Fields the engine does not yet consume are accepted but reported in
- * `warnings` so `lab inspect` never silently swallows a setting that does nothing.
- */
-export declare function parseLabConfig(raw: unknown): LabConfigParseResult;

package/dist/lab/deprecated-fields.d.ts

@@ -1,10 +0,0 @@
-/** One deprecated field: what to read instead, and how to compute the old value. */
-export interface DeprecatedField {
-    readonly replacement: string;
-    readonly read: () => unknown;
-}
-/** Adds `fields` to `value` as warning getters and returns `value`. */
-export declare function withDeprecatedFields<T extends object>(value: T, owner: {
-    readonly name: string;
-    readonly code: `HUMANISH_${string}`;
-}, fields: Readonly<Record<string, DeprecatedField>>): T;

package/dist/lab/deprecated-fields.js

@@ -1,24 +0,0 @@
-// Deprecated fields on a value humanish hands to a caller. Each is a getter that warns once per
-// process when read. The getters are not enumerable, so a spread, `Object.assign`,
-// `JSON.stringify` or `structuredClone` of the value skips them and warns about no field the
-// caller never named; `"name" in value` still finds them. Core never reads them.
-const warned = new Set();
-/** Adds `fields` to `value` as warning getters and returns `value`. */
-export function withDeprecatedFields(value, owner, fields) {
-    return Object.defineProperties(value, Object.fromEntries(Object.entries(fields).map(([field, { replacement, read }]) => [
-        field,
-        {
-            enumerable: false,
-            get: () => {
-                warnOnce(`${owner.name}.${field}`, replacement, owner.code);
-                return read();
-            },
-        },
-    ])));
-}
-function warnOnce(name, replacement, code) {
-    if (warned.has(name))
-        return;
-    warned.add(name);
-    process.emitWarning(`${name} is deprecated and is removed in the next minor. Use ${replacement}.`, { type: "DeprecationWarning", code });
-}

package/dist/lab/parse/comms.d.ts

@@ -1,12 +0,0 @@
-import type { LabComms, LabCommsEmail, LabCommsRecipient, LabConfigParseFailure } from "../types.js";
-export declare function parseComms(raw: unknown): {
-    ok: true;
-    value: LabComms | undefined;
-} | LabConfigParseFailure;
-/** The participant a declared inbox recipient belongs to. The manifest spells it `lane`. */
-export declare function recipientParticipantId(recipient: LabCommsRecipient): string;
-/** The declared recipients that name an address, in declaration order, by participant id. */
-export declare function addressedRecipients(email: Pick<LabCommsEmail, "recipients">): {
-    participantId: string;
-    address: string;
-}[];

package/dist/lab/parse/execution.d.ts

@@ -1,19 +0,0 @@
-import type { LabConfigParseFailure, LabDefaults, LabExecution, LabPolicies, LabReview, LabScenario } from "../types.js";
-export declare function parseExecution(raw: unknown): {
-    ok: true;
-    value: LabExecution | undefined;
-} | LabConfigParseFailure;
-export declare function parsePersonas(raw: unknown): Record<string, unknown>[] | undefined;
-export declare function parseScenario(raw: unknown): {
-    ok: true;
-    value: LabScenario | undefined;
-} | LabConfigParseFailure;
-export declare function parsePolicies(raw: unknown): {
-    ok: true;
-    value: LabPolicies | undefined;
-} | LabConfigParseFailure;
-export declare function parseReview(raw: unknown): {
-    ok: true;
-    value: LabReview | undefined;
-} | LabConfigParseFailure;
-export declare function parseDefaults(raw: unknown): LabDefaults | undefined;

package/dist/lab/plan.d.ts

@@ -1,13 +0,0 @@
-import type { InternalRunLabOptions } from "../run-lab.js";
-import type { LabDeps } from "./lab-deps.js";
-import type { PlanResult } from "./plan-types.js";
-import type { LabConfig } from "./types.js";
-export { routeOf, type LabRoute } from "./routing.js";
-/** Resolve dry-run: explicit override wins, else the scenario mode, else the given fallback. */
-export declare function resolveLabDryRun(config: LabConfig, override: boolean | undefined, fallback: boolean | undefined): boolean | undefined;
-/**
- * The plan a lab runs under, built without reading files, env or the network. Each route's planner
- * makes every refusal that route makes, in the route's order and with its codes and messages; the
- * route's exported runner calls the same planner.
- */
-export declare function planLab(config: LabConfig, options: InternalRunLabOptions, deps?: LabDeps): PlanResult;

package/dist/lab/preflight-probes.d.ts

@@ -1,3 +0,0 @@
-import type { LabPreflightResult, PreflightContext } from "./preflight.js";
-export declare function runPublicPreviewPreflight(ctx: PreflightContext): Promise<LabPreflightResult>;
-export declare function runSandboxLoopbackPreflight(ctx: PreflightContext): Promise<LabPreflightResult>;

package/dist/lab/preflight-result.d.ts

@@ -1,8 +0,0 @@
-import type { LabPreflightCheck, LabPreflightResult, PreflightContext } from "./preflight.js";
-/** The schema of `lab preflight` results: whether a study is ready to run on this machine. */
-export declare const STUDY_CHECK_SCHEMA = "humanish.study-check.v1";
-export declare function finalize(ctx: PreflightContext, args?: {
-    check?: LabPreflightCheck;
-}): LabPreflightResult;
-export declare function fail(ctx: PreflightContext, code: NonNullable<LabPreflightResult["error"]>["code"], message: string, checks: LabPreflightCheck[]): LabPreflightResult;
-export declare function digest(value: string): string;

package/dist/lab/route-inputs.d.ts

@@ -1,28 +0,0 @@
-import type { InternalRunLabOptions } from "../run-lab.js";
-import type { RunScorerProvenance } from "../run/bundle.js";
-import { type AdapterScorerModule } from "./adapter-scorer-loader.js";
-import type { LabDeps } from "./lab-deps.js";
-import type { LabEvent } from "./run-lab-events.js";
-import type { ComputerUseRunInput } from "../routes/computer-use/types.js";
-import type { ScriptedRunInput } from "../routes/scripted/types.js";
-import type { SharedWorldRunInput } from "../routes/shared-world/types.js";
-import type { TerminalRunInput } from "../routes/terminal/types.js";
-export declare function computerUseInput(options: InternalRunLabOptions, deps: LabDeps, emit: LabEmit | undefined): ComputerUseRunInput;
-export declare function scriptedInput(options: InternalRunLabOptions, deps: LabDeps, emit: LabEmit | undefined): ScriptedRunInput;
-export declare function terminalInput(options: InternalRunLabOptions, deps: LabDeps, emit: LabEmit | undefined): TerminalRunInput;
-export declare function sharedWorldInput(options: InternalRunLabOptions, deps: LabDeps, emit: LabEmit | undefined): SharedWorldRunInput;
-/** A scorer the CLI loads after the route's local checks, and the provenance it stamps on the run. */
-export type LateScorer = Pick<InternalRunLabOptions, "scorer" | "scorerProvenance">;
-/** Narrows RunLabOptions.scorer to the context the route passes (adapter-scorer-loader.ts). */
-type NarrowScorer<S> = (scorer: AdapterScorerModule) => S;
-/**
- * A route's input with a scorer loaded after admission, and the scorer's provenance, as if the
- * caller had passed them up front. The rest of the input is the one the route's checks admitted.
- */
-export declare function withLateScorer<S, I extends {
-    scorer?: S;
-    scorerProvenance?: RunScorerProvenance;
-}>(input: I, late: LateScorer | undefined, narrow: NarrowScorer<S>): I;
-/** Reports a LabEvent to onEvent without waiting (normalizeRunLabOptions builds it). */
-type LabEmit = (event: LabEvent) => void;
-export {};

package/dist/lab/run-lab-homes.js

@@ -1,7 +0,0 @@
-// The public RunLabOptions homes that every route reads: env, scorer, prepareDesktop, onEvent,
-// onStream and analysisSignal, and the brain and in-process driving computer use takes.
-import { withDeprecatedFields } from "./deprecated-fields.js";
-/** A stream event as the routes report it, with `simId` as a getter over `recordId`. */
-export function streamEvent(fields) {
-    return withDeprecatedFields({ ...fields }, { name: "StreamEvent", code: "HUMANISH_STREAM_EVENT_FIELD_DEPRECATED" }, { simId: { replacement: "recordId", read: () => fields.recordId } });
-}

package/dist/lab/run-lab-options.d.ts

@@ -1,28 +0,0 @@
-import type { InternalRunLabOptions, LabOutcome, RunLabOptions } from "../run-lab.js";
-import { type LabRoute } from "./plan.js";
-import type { LabConfig } from "./types.js";
-import { type LabEvent } from "./run-lab-events.js";
-type Refusal = {
-    ok: false;
-    code: "HUMANISH_STUDY_OPTION_UNSUPPORTED";
-    message: string;
-};
-type Normalized = {
-    ok: true;
-    /** The options the route reads: onEvent removed, env copied. */
-    options: InternalRunLabOptions;
-    /** Filled by onEvent failures while the run runs; runLab appends them to the result. */
-    warnings: string[];
-    /** Calls onEvent and never waits for it, or undefined without onEvent. The routes report through it. */
-    emit: ((event: LabEvent) => void) | undefined;
-};
-/** The refusal for a field a JavaScript caller passed that RunLabOptions no longer has. */
-export declare function removedOptionRefusal(options: RunLabOptions): Refusal | undefined;
-/**
- * Refuse what the route cannot honor, copy env, and build the emitter onEvent receives through.
- * Nothing here touches the filesystem, so a refusal leaves no run directory, receipt or sandbox.
- */
-export declare function normalizeRunLabOptions(config: LabConfig, route: LabRoute, options: InternalRunLabOptions): Normalized | Refusal;
-/** A refusal in the route's own result envelope, before any run exists. */
-export declare function optionRefusalOutcome(config: LabConfig, route: LabRoute, options: RunLabOptions, refusal: Refusal): LabOutcome;
-export {};

package/dist/library-aliases.d.ts

@@ -1,56 +0,0 @@
-import { CuaAdmissionLimitError as AdmissionLimitError } from "./actors/computer-use/admission-limit.js";
-import type { CuaAction as Action, CuaExecutor as Executor, CuaLoopOptions as LoopOptions, CuaLoopResult as LoopResult, CuaObservation as Observation, CuaProvider as Provider, CuaSafetyCheck as SafetyCheck, CuaTurn as Turn, CuaTurnRequest as TurnRequest } from "./actors/computer-use/loop.js";
-import type { BrowserLabScoringContext as BrowserScoringContext } from "./lab/adapter-extension.js";
-import { parseLabConfig as parseStudy } from "./lab/config.js";
-import type { LabRoute as StudyRoute } from "./lab/routing.js";
-import type { LabEvent as StudyEvent } from "./lab/run-lab-events.js";
-import { type LabConfig as StudyConfig } from "./lab/types.js";
-import { runPackageLab as runStudy, type LabOutcome as StudyOutcome, type LabResult as StudyResult, type RunLabOptions as RunStudyOptions } from "./run-lab.js";
-/** @deprecated Use `runStudy`, the same function. 0.109 removes `runLab`. */
-export declare const runLab: typeof runStudy;
-/** @deprecated Use `parseStudy`, the same function. 0.109 removes `parseLabConfig`. */
-export declare const parseLabConfig: typeof parseStudy;
-/**
- * The `humanish.lab.v2` schema id, which 0.109 stops parsing.
- * @deprecated Write `STUDY_SCHEMA` (`humanish.study.v3`) files. 0.109 removes `LAB_CONFIG_SCHEMA`.
- */
-export declare const LAB_CONFIG_SCHEMA = "humanish.lab.v2";
-/** @deprecated Use `StudyConfig`, the same type. 0.109 removes `LabConfig`. */
-export type LabConfig = StudyConfig;
-/** @deprecated Use `StudyEvent`, the same type. 0.109 removes `LabEvent`. */
-export type LabEvent = StudyEvent;
-/** @deprecated Use `StudyOutcome`, the same type. 0.109 removes `LabOutcome`. */
-export type LabOutcome = StudyOutcome;
-/** @deprecated Use `StudyResult`, the same type. 0.109 removes `LabResult`. */
-export type LabResult<R extends StudyRoute = StudyRoute> = StudyResult<R>;
-/** @deprecated Use `StudyRoute`, the same type. 0.109 removes `LabRoute`. */
-export type LabRoute = StudyRoute;
-/** @deprecated Use `RunStudyOptions`, the same type. 0.109 removes `RunLabOptions`. */
-export type RunLabOptions = RunStudyOptions;
-/** @deprecated Use `BrowserScoringContext`, the same type. 0.109 removes `BrowserLabScoringContext`. */
-export type BrowserLabScoringContext = BrowserScoringContext;
-/**
- * @deprecated Use `ComputerUseAdmissionLimitError`, the same class, so `instanceof` matches either
- * name. 0.109 removes `CuaAdmissionLimitError`.
- */
-export declare const CuaAdmissionLimitError: typeof AdmissionLimitError;
-/** @deprecated Use `ComputerUseAdmissionLimitError`. 0.109 removes `CuaAdmissionLimitError`. */
-export type CuaAdmissionLimitError = AdmissionLimitError;
-/** @deprecated Use `ComputerUseAction`, the same type. 0.109 removes `CuaAction`. */
-export type CuaAction = Action;
-/** @deprecated Use `ComputerUseExecutor`, the same type. 0.109 removes `CuaExecutor`. */
-export type CuaExecutor = Executor;
-/** @deprecated Use `ComputerUseLoopOptions`, the same type. 0.109 removes `CuaLoopOptions`. */
-export type CuaLoopOptions = LoopOptions;
-/** @deprecated Use `ComputerUseLoopResult`, the same type. 0.109 removes `CuaLoopResult`. */
-export type CuaLoopResult = LoopResult;
-/** @deprecated Use `ComputerUseObservation`, the same type. 0.109 removes `CuaObservation`. */
-export type CuaObservation = Observation;
-/** @deprecated Use `ComputerUseProvider`, the same type. 0.109 removes `CuaProvider`. */
-export type CuaProvider = Provider;
-/** @deprecated Use `ComputerUseSafetyCheck`, the same type. 0.109 removes `CuaSafetyCheck`. */
-export type CuaSafetyCheck = SafetyCheck;
-/** @deprecated Use `ComputerUseTurn`, the same type. 0.109 removes `CuaTurn`. */
-export type CuaTurn = Turn;
-/** @deprecated Use `ComputerUseTurnRequest`, the same type. 0.109 removes `CuaTurnRequest`. */
-export type CuaTurnRequest = TurnRequest;

package/dist/library-aliases.js

@@ -1,22 +0,0 @@
-// The names 0.107's library exported for running a lab and driving a computer-use participant.
-// Each is the same function, constant, class or type as the name that replaces it, so an existing
-// import, call or `instanceof` check keeps working, and editors mark it deprecated.
-// Removed in 0.109.0: this module and its exports in src/index.ts.
-import { CuaAdmissionLimitError as AdmissionLimitError } from "./actors/computer-use/admission-limit.js";
-import { parseLabConfig as parseStudy } from "./lab/config.js";
-import { LAB_CONFIG_SCHEMA as V2_SCHEMA } from "./lab/types.js";
-import { runPackageLab as runStudy, } from "./run-lab.js";
-/** @deprecated Use `runStudy`, the same function. 0.109 removes `runLab`. */
-export const runLab = runStudy;
-/** @deprecated Use `parseStudy`, the same function. 0.109 removes `parseLabConfig`. */
-export const parseLabConfig = parseStudy;
-/**
- * The `humanish.lab.v2` schema id, which 0.109 stops parsing.
- * @deprecated Write `STUDY_SCHEMA` (`humanish.study.v3`) files. 0.109 removes `LAB_CONFIG_SCHEMA`.
- */
-export const LAB_CONFIG_SCHEMA = V2_SCHEMA;
-/**
- * @deprecated Use `ComputerUseAdmissionLimitError`, the same class, so `instanceof` matches either
- * name. 0.109 removes `CuaAdmissionLimitError`.
- */
-export const CuaAdmissionLimitError = AdmissionLimitError;

package/dist/run-lab.d.ts

@@ -1,112 +0,0 @@
-import type { LocalVmInput } from "./routes/computer-use/types.js";
-import { type LateScorer } from "./lab/route-inputs.js";
-import { type LabRoute } from "./lab/plan.js";
-import type { LabDeps } from "./lab/lab-deps.js";
-import type { RunLabDriving, RunLabHomes } from "./lab/run-lab-homes.js";
-import { type LabConfig } from "./lab/types.js";
-import type { ObserverResult } from "./observer/render.js";
-import { type CuaActorLabResult } from "./routes/computer-use/types.js";
-import { type PreviewStudyResult } from "./routes/preview.js";
-import { type ScriptedBrowserLabResult } from "./routes/scripted/types.js";
-import { type ConcurrentSharedWorldLabResult } from "./routes/shared-world/types.js";
-import { type TerminalProductLabResult } from "./routes/terminal/types.js";
-import { type RunScorerProvenance } from "./run/bundle.js";
-import type { RunStudyProvenance } from "./run/study-provenance.js";
-/**
- * Runs a lab on its route. The options are checked against the route and mapped into the route's
- * hook bags before anything runs. Each route closes the run it started on every exit through its
- * own run scope (`src/run/run.ts`).
- */
-export declare function runLab(config: LabConfig, options: InternalRunLabOptions, deps?: LabDeps): Promise<LabOutcome>;
-/**
- * runLab as the package exports it (`src/index.ts`): the public options only. A JavaScript caller
- * that passes a field RunLabOptions no longer has is refused in the route's own result envelope
- * before anything runs.
- */
-export declare function runPackageLab(config: LabConfig, options: RunLabOptions): Promise<LabOutcome>;
-/** A lab planned once: the route's refusal, or the run of its plan. */
-export type PreparedLab = {
-    readonly ok: false;
-    readonly outcome: LabOutcome;
-} | {
-    readonly ok: true;
-    /** Runs the plan. A scorer loaded after planning joins the run's hooks; it changes no plan. */
-    run(scorer?: LateScorer): Promise<LabOutcome>;
-};
-/**
- * Normalizes the options and plans the lab once, so a caller can present a refusal before it loads
- * anything the run needs. A local browser study's provider is bound first, so the plan is made with
- * it, and its desktop goes to the computer-use run as `localVm`; with inProcess the caller drives
- * the app in process and needs no desktop.
- */
-export declare function prepareLab(config: LabConfig, options: InternalRunLabOptions, deps?: LabDeps): Promise<PreparedLab>;
-/**
- * What a package caller passes to runLab: the run's settings and the typed homes (`RunLabHomes`,
- * `RunLabDriving`). Each wins over the config when provided.
- */
-export type RunLabOptions = RunLabBase & RunLabHomes & RunLabDriving;
-interface RunLabBase {
-    cwd: string;
-    runId?: string;
-    dryRun?: boolean;
-    open?: boolean;
-    /** Participant count override: preview participants or computer-use desktops. */
-    count?: number;
-    /** CUA fan-out only: create a new run for failed/selected participants from a prior run. */
-    rerun?: {
-        sourceRunId: string;
-        participantIds?: string[];
-    };
-    onObserverReady?: (observer: ObserverResult & {
-        ok: true;
-    }) => Promise<void> | void;
-}
-/** runLab's options inside the package: the public ones plus what only the CLI and tests set. */
-export type InternalRunLabOptions = RunLabOptions & RunLabInternals;
-interface RunLabInternals {
-    /**
-     * Which manifest this run came from. planLab puts it on the plan, and the route reads
-     * plan.lab for the run's status record and bundle. Absent for a library caller that passes a
-     * LabConfig directly; that run records no lab.
-     */
-    lab?: RunStudyProvenance;
-    /**
-     * Config-declared scorer provenance, forwarded alongside the
-     * loaded scorer. Its presence is the "declared" marker the terminal route reads to flip a
-     * status:"fail" verdict; the browser routes stamp it as evidence (they already flip). Core-computed
-     * (path + digest), never adopter-supplied; absent for library callers.
-     */
-    scorerProvenance?: RunScorerProvenance;
-    /** The local VM study's desktop, analysis gate and signal, for a local browser lab. */
-    localVm?: LocalVmInput;
-}
-/** A run's result and the route it ran on. */
-interface RouteOutcome<R extends LabRoute, T> {
-    route: R;
-    result: T;
-}
-export type LabOutcome = RouteOutcome<"preview", PreviewStudyResult> | RouteOutcome<"computer-use", CuaActorLabResult> | RouteOutcome<"scripted", ScriptedBrowserLabResult> | RouteOutcome<"terminal", TerminalProductLabResult> | RouteOutcome<"shared-world", ConcurrentSharedWorldLabResult>;
-/**
- * A plan past its route's local checks that need no scorer: the refusal they returned, or the
- * route's run, which takes a scorer loaded after them.
- */
-export type AdmittedPlan<R extends LabRoute = LabRoute> = {
-    readonly ok: false;
-    readonly outcome: Extract<LabOutcome, {
-        route: R;
-    }>;
-} | {
-    readonly ok: true;
-    run(scorer?: LateScorer): Promise<Extract<LabOutcome, {
-        route: R;
-    }>>;
-};
-/** The result of a run on route `R`, the `result` of that route's `LabOutcome`. */
-export type LabResult<R extends LabRoute = LabRoute> = {
-    preview: PreviewStudyResult;
-    "computer-use": CuaActorLabResult;
-    scripted: ScriptedBrowserLabResult;
-    terminal: TerminalProductLabResult;
-    "shared-world": ConcurrentSharedWorldLabResult;
-}[R];
-export {};