humanish 0.106.0 → 0.107.0

package/dist/deprecated.d.ts

@@ -1,90 +0,0 @@
-import { type CuaActorSessionOptions } from "./actors/computer-use/actor.js";
-import type { CuaLoopResult } from "./actors/computer-use/loop.js";
-import type { AutomaticAnalysisHooks as AnalysisHooks } from "./analysis/automatic-completion.js";
-import type { BrowserLabAdapterHooks as BrowserAdapterHooks } from "./lab/adapter-extension.js";
-import { type LabBackend as Backend } from "./lab/plan.js";
-import type { LabConfig } from "./lab/types.js";
-import type { CuaActorLabHooks as CuaHooks, CuaActorLabResult as CuaResult, RunCuaActorLabOptions as CuaOptions } from "./routes/computer-use/types.js";
-import type { RunScriptedBrowserLabOptions as ScriptedOptions, ScriptedBrowserLabHooks as ScriptedHooks, ScriptedBrowserLabResult as ScriptedResult } from "./routes/scripted/types.js";
-import type { ConcurrentSharedWorldLabResult as SharedWorldResult, RunConcurrentSharedWorldLabOptions as SharedWorldOptions, SharedWorldLabHooks as SharedWorldHooks } from "./routes/shared-world/types.js";
-import type { RunTerminalProductLabOptions as TerminalOptions, TerminalProductLabHooks as TerminalHooks, TerminalProductLabResult as TerminalResult } from "./routes/terminal/types.js";
-import type { RunOptions as PreviewOptions, RunResult as PreviewResult } from "./run/results.js";
-import type { SubjectPhaseEvent as PhaseEvent } from "./subject/steps.js";
-/**
- * @deprecated Use `runComputerUseLoop` with `createOpenAiResponsesProvider({ singleDispatch: true })`,
- * the strict-spend composition in docs/contracts/schemas.md.
- */
-export declare function runCuaActorSession(options: CuaActorSessionOptions): Promise<CuaLoopResult>;
-/** @deprecated Use `runLab(config, options)`; its result is `LabResult<"computer-use">`. */
-export declare function runCuaActorLab(options: CuaOptions): Promise<CuaResult>;
-/** @deprecated Use `runLab(config, options)`; its result is `LabResult<"scripted">`. */
-export declare function runScriptedBrowserLab(options: ScriptedOptions): Promise<ScriptedResult>;
-/** @deprecated Use `runLab(config, options)`; its result is `LabResult<"terminal">`. */
-export declare function runTerminalProductLab(options: TerminalOptions): Promise<TerminalResult>;
-/** @deprecated Use `runLab(config, options)`; its result is `LabResult<"shared-world">`. */
-export declare function runConcurrentSharedWorld(options: SharedWorldOptions): Promise<SharedWorldResult>;
-/** @deprecated Use `runLab(config, options)` on a `this-repo` lab; its result is `LabResult<"preview">`. */
-export declare function runDryRun(options: PreviewOptions): Promise<PreviewResult>;
-/** @deprecated Use `routeOf(config)` on the lab. This goes in the next minor. */
-export declare function actorResolvesToTerminal(type: string | undefined): boolean;
-/**
- * @deprecated Use the `plan` `LabEvent` from `RunLabOptions.onEvent`, which lists every
- * participant. This goes in the next minor.
- */
-export declare function cuaLaneCount(config: LabConfig): number;
-/**
- * @deprecated Use `parseLabConfig`, which refuses a seat entry that is not same-origin loopback.
- * This goes in the next minor.
- */
-export declare function resolveSeatUrl(serveUrl: string, entry: string | undefined): string | null;
-/** @deprecated Use `parseLabConfig`, which returns the same reason. This goes in the next minor. */
-export declare function cuaLaneValidationReason(config: LabConfig): string | null;
-/** @deprecated Use `parseLabConfig`, which returns the same reason. This goes in the next minor. */
-export declare function sharedWorldValidationReason(config: LabConfig): string | null;
-/** @deprecated Use `parseLabConfig`, which returns the same reason. This goes in the next minor. */
-export declare function concurrentSharedWorldValidationReason(config: LabConfig): string | null;
-/** @deprecated Use `parseLabConfig`, which returns the same reason. This goes in the next minor. */
-export declare function externalPublicSharedWorldValidationReason(config: LabConfig): string | null;
-/**
- * @deprecated Use `RunLabOptions.dryRun`; without it, `scenario.mode` decides. This goes in the
- * next minor.
- */
-export declare function resolveLabDryRun(config: LabConfig, override: boolean | undefined, fallback: boolean | undefined): boolean | undefined;
-/** @deprecated `parseLabConfig` refuses a roster larger than this. This goes in the next minor. */
-export declare const MAX_CUA_LANES = 16;
-/** @deprecated Use `LabRoute`. `LabOutcome.backend` and this type go in the next minor. */
-export type LabBackend = Backend;
-/** @deprecated Use `RunLabOptions` with `runLab`. */
-export type RunCuaActorLabOptions = CuaOptions;
-/** @deprecated Use `LabResult<"computer-use">`. */
-export type CuaActorLabResult = CuaResult;
-/** @deprecated Use `RunLabOptions` with `runLab`. */
-export type RunScriptedBrowserLabOptions = ScriptedOptions;
-/** @deprecated Use `LabResult<"scripted">`. */
-export type ScriptedBrowserLabResult = ScriptedResult;
-/** @deprecated Use `RunLabOptions` with `runLab`. */
-export type RunTerminalProductLabOptions = TerminalOptions;
-/** @deprecated Use `LabResult<"terminal">`. */
-export type TerminalProductLabResult = TerminalResult;
-/** @deprecated Use `RunLabOptions` with `runLab`. */
-export type RunConcurrentSharedWorldLabOptions = SharedWorldOptions;
-/** @deprecated Use `LabResult<"shared-world">`. */
-export type ConcurrentSharedWorldLabResult = SharedWorldResult;
-/** @deprecated Use `RunLabOptions` with `runLab`. */
-export type RunOptions = PreviewOptions;
-/** @deprecated Use `LabResult<"preview">`. */
-export type RunResult = PreviewResult;
-/** @deprecated Use the typed homes on `RunLabOptions` (`scorer`, `createProvider`, `inProcess`, `prepareDesktop`, `env`, `onEvent`, `onStream`). */
-export type CuaActorLabHooks = CuaHooks;
-/** @deprecated Use the typed homes on `RunLabOptions` (`prepareDesktop`, `env`). */
-export type ScriptedBrowserLabHooks = ScriptedHooks;
-/** @deprecated Use the typed homes on `RunLabOptions` (`scorer`, `env`). */
-export type TerminalProductLabHooks = TerminalHooks;
-/** @deprecated Use the typed homes on `RunLabOptions` (`scorer`, `prepareDesktop`, `env`, `onEvent`, `onStream`). */
-export type SharedWorldLabHooks = SharedWorldHooks;
-/** @deprecated Use `RunLabOptions.scorer`, an `AdapterScorerModule`. */
-export type BrowserLabAdapterHooks = BrowserAdapterHooks;
-/** @deprecated Use the `subject-phase` `LabEvent` through `RunLabOptions.onEvent`. */
-export type SubjectPhaseEvent = PhaseEvent;
-/** @deprecated Use `RunLabOptions.onEvent` (`analysis-started`, `analysis-finished`) and `analysisSignal`. */
-export type AutomaticAnalysisHooks = AnalysisHooks;

package/dist/deprecated.js

@@ -1,106 +0,0 @@
-// The exports this minor deprecates and the next minor removes (docs/contracts/schemas.md,
-// "Library options"). Each function warns once per process and then runs unchanged. Each type is
-// an alias of the type it always was, and each constant has the value it always had. Internal code
-// calls the original functions, so only a package caller sees a warning.
-import { runCuaActorSession as cuaActorSession, } from "./actors/computer-use/actor.js";
-import { resolveLabDryRun as labDryRun } from "./lab/plan.js";
-import { actorResolvesToTerminal as resolvesToTerminal, cuaLaneCount as laneCount, MAX_CUA_LANES as laneCap, resolveSeatUrl as seatUrl, } from "./lab/routing.js";
-import { concurrentSharedWorldValidationReason as concurrentSharedWorldReason, cuaLaneValidationReason as laneRosterReason, externalPublicSharedWorldValidationReason as externalPublicSharedWorldReason, sharedWorldValidationReason as sharedWorldReason, } from "./lab/validation.js";
-import { runCuaActorLab as cuaActorLab } from "./routes/computer-use/route.js";
-import { runScriptedBrowserLab as scriptedBrowserLab } from "./routes/scripted/route.js";
-import { runConcurrentSharedWorld as concurrentSharedWorld } from "./routes/shared-world/route.js";
-import { runTerminalProductLab as terminalProductLab } from "./routes/terminal/route.js";
-import { runDryRun as dryRun } from "./run/dry-run.js";
-const warned = new Set();
-function deprecated(name, replacement) {
-    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: "HUMANISH_DEPRECATED_EXPORT" });
-}
-const RUN_LAB = "runLab(config, options); its result is LabResult<route>";
-/**
- * @deprecated Use `runComputerUseLoop` with `createOpenAiResponsesProvider({ singleDispatch: true })`,
- * the strict-spend composition in docs/contracts/schemas.md.
- */
-export function runCuaActorSession(options) {
-    deprecated("runCuaActorSession", "runComputerUseLoop with createOpenAiResponsesProvider({ singleDispatch: true }) (the strict-spend composition in docs/contracts/schemas.md)");
-    return cuaActorSession(options);
-}
-/** @deprecated Use `runLab(config, options)`; its result is `LabResult<"computer-use">`. */
-export function runCuaActorLab(options) {
-    deprecated("runCuaActorLab", RUN_LAB);
-    return cuaActorLab(options);
-}
-/** @deprecated Use `runLab(config, options)`; its result is `LabResult<"scripted">`. */
-export function runScriptedBrowserLab(options) {
-    deprecated("runScriptedBrowserLab", RUN_LAB);
-    return scriptedBrowserLab(options);
-}
-/** @deprecated Use `runLab(config, options)`; its result is `LabResult<"terminal">`. */
-export function runTerminalProductLab(options) {
-    deprecated("runTerminalProductLab", RUN_LAB);
-    return terminalProductLab(options);
-}
-/** @deprecated Use `runLab(config, options)`; its result is `LabResult<"shared-world">`. */
-export function runConcurrentSharedWorld(options) {
-    deprecated("runConcurrentSharedWorld", RUN_LAB);
-    return concurrentSharedWorld(options);
-}
-/** @deprecated Use `runLab(config, options)` on a `this-repo` lab; its result is `LabResult<"preview">`. */
-export function runDryRun(options) {
-    deprecated("runDryRun", RUN_LAB);
-    return dryRun(options);
-}
-const PARSE_REASON = "parseLabConfig, which returns the same reason";
-/** @deprecated Use `routeOf(config)` on the lab. This goes in the next minor. */
-export function actorResolvesToTerminal(type) {
-    deprecated("actorResolvesToTerminal", "routeOf(config) on the lab");
-    return resolvesToTerminal(type);
-}
-/**
- * @deprecated Use the `plan` `LabEvent` from `RunLabOptions.onEvent`, which lists every
- * participant. This goes in the next minor.
- */
-export function cuaLaneCount(config) {
-    deprecated("cuaLaneCount", "the plan LabEvent from RunLabOptions.onEvent, which lists every participant");
-    return laneCount(config);
-}
-/**
- * @deprecated Use `parseLabConfig`, which refuses a seat entry that is not same-origin loopback.
- * This goes in the next minor.
- */
-export function resolveSeatUrl(serveUrl, entry) {
-    deprecated("resolveSeatUrl", "parseLabConfig, which refuses a participant entry that is not same-origin loopback");
-    return seatUrl(serveUrl, entry);
-}
-/** @deprecated Use `parseLabConfig`, which returns the same reason. This goes in the next minor. */
-export function cuaLaneValidationReason(config) {
-    deprecated("cuaLaneValidationReason", PARSE_REASON);
-    return laneRosterReason(config);
-}
-/** @deprecated Use `parseLabConfig`, which returns the same reason. This goes in the next minor. */
-export function sharedWorldValidationReason(config) {
-    deprecated("sharedWorldValidationReason", PARSE_REASON);
-    return sharedWorldReason(config);
-}
-/** @deprecated Use `parseLabConfig`, which returns the same reason. This goes in the next minor. */
-export function concurrentSharedWorldValidationReason(config) {
-    deprecated("concurrentSharedWorldValidationReason", PARSE_REASON);
-    return concurrentSharedWorldReason(config);
-}
-/** @deprecated Use `parseLabConfig`, which returns the same reason. This goes in the next minor. */
-export function externalPublicSharedWorldValidationReason(config) {
-    deprecated("externalPublicSharedWorldValidationReason", PARSE_REASON);
-    return externalPublicSharedWorldReason(config);
-}
-/**
- * @deprecated Use `RunLabOptions.dryRun`; without it, `scenario.mode` decides. This goes in the
- * next minor.
- */
-export function resolveLabDryRun(config, override, fallback) {
-    deprecated("resolveLabDryRun", "RunLabOptions.dryRun; without it, scenario.mode decides");
-    return labDryRun(config, override, fallback);
-}
-/** @deprecated `parseLabConfig` refuses a roster larger than this. This goes in the next minor. */
-export const MAX_CUA_LANES = laneCap;

package/dist/lab/bag-overrides.d.ts

@@ -1,18 +0,0 @@
-/** The members each bag type declares, forwarded even when the bag does not enumerate them. */
-export declare const HOOK_MEMBERS: {
-    readonly cua: string[];
-    readonly sharedWorld: string[];
-    readonly terminal: string[];
-    readonly scripted: string[];
-    readonly analysis: string[];
-};
-/**
- * The bag with `overrides` in place of its own members. Every other member becomes an enumerable
- * accessor that reads the bag when it is read, so a getter runs only then and a spread of the
- * result keeps every member. The members are the bag's own and inherited keys (string or symbol)
- * plus `declared`, the members its type declares, which a proxy-backed bag may answer without
- * listing. A function is bound to the bag, so its private fields still work. The overrides are
- * ordinary data properties. Declared members always appear as own properties (undefined when
- * unset), so code reading a wrapped bag tests the value, never `in`.
- */
-export declare function withHookOverrides<T extends object>(bag: T | undefined, declared: readonly string[], overrides: Partial<T>): T;

package/dist/lab/bag-overrides.js

@@ -1,121 +0,0 @@
-// A caller's hook bag with some members replaced, without copying the bag's values. Spreading a
-// class instance keeps only its own properties, so a route that spreads a caller's bag loses the
-// class's methods; this builds a plain object that keeps them.
-// Every member each bag type declares. The record type makes the compiler reject a missing or
-// unknown name, so a member added to a bag type must be added here too.
-const cuaMembers = {
-    prepareDesktop: true,
-    onPreflight: true,
-    onPhase: true,
-    onRuntimeStreamReady: true,
-    onRuntimeStreamEnded: true,
-    loadDesktopModule: true,
-    runSession: true,
-    buildExecutor: true,
-    buildProvider: true,
-    createDesktopLane: true,
-    env: true,
-    renderObserverFn: true,
-    now: true,
-    detachedTimers: true,
-    packLocalTree: true,
-    score: true,
-    deriveFeedback: true,
-    deriveArtifacts: true,
-};
-const sharedWorldMembers = {
-    loadDesktopModule: true,
-    prepareDesktop: true,
-    onRuntimeStreamReady: true,
-    onRuntimeStreamEnded: true,
-    runSession: true,
-    env: true,
-    renderObserverFn: true,
-    detachedTimers: true,
-    onPhase: true,
-    now: true,
-    proberCadenceMs: true,
-    handoffDeadlineMs: true,
-    readLobbyCodeFromFrame: true,
-    packLocalTree: true,
-    score: true,
-    deriveFeedback: true,
-    deriveArtifacts: true,
-};
-const terminalMembers = {
-    loadModule: true,
-    env: true,
-    renderObserverFn: true,
-    now: true,
-    costProbe: true,
-    score: true,
-    deriveFeedback: true,
-};
-const scriptedMembers = {
-    runSession: true,
-    launchBrowser: true,
-    env: true,
-    loadDesktopModule: true,
-    prepareDesktop: true,
-    detachedTimers: true,
-    browserCommand: true,
-    renderObserverFn: true,
-    now: true,
-};
-const analysisMembers = {
-    deps: true,
-    onStart: true,
-    run: true,
-};
-/** The members each bag type declares, forwarded even when the bag does not enumerate them. */
-export const HOOK_MEMBERS = {
-    cua: Object.keys(cuaMembers),
-    sharedWorld: Object.keys(sharedWorldMembers),
-    terminal: Object.keys(terminalMembers),
-    scripted: Object.keys(scriptedMembers),
-    analysis: Object.keys(analysisMembers),
-};
-/**
- * The bag with `overrides` in place of its own members. Every other member becomes an enumerable
- * accessor that reads the bag when it is read, so a getter runs only then and a spread of the
- * result keeps every member. The members are the bag's own and inherited keys (string or symbol)
- * plus `declared`, the members its type declares, which a proxy-backed bag may answer without
- * listing. A function is bound to the bag, so its private fields still work. The overrides are
- * ordinary data properties. Declared members always appear as own properties (undefined when
- * unset), so code reading a wrapped bag tests the value, never `in`.
- */
-export function withHookOverrides(bag, declared, overrides) {
-    const forward = {};
-    const replaced = new Set(Reflect.ownKeys(overrides));
-    const forwardMember = (key) => {
-        if (key === "constructor" || replaced.has(key) || Object.hasOwn(forward, key))
-            return;
-        Object.defineProperty(forward, key, {
-            enumerable: true,
-            configurable: true,
-            get() {
-                const value = Reflect.get(bag, key, bag);
-                return typeof value === "function" ? value.bind(bag) : value;
-            },
-            set(value) {
-                Reflect.set(bag, key, value, bag);
-            },
-        });
-    };
-    if (bag !== undefined) {
-        for (let source = bag; source !== null && source !== Object.prototype; source = Object.getPrototypeOf(source))
-            for (const key of Reflect.ownKeys(source))
-                forwardMember(key);
-        for (const key of declared)
-            forwardMember(key);
-    }
-    for (const key of replaced) {
-        Object.defineProperty(forward, key, {
-            value: overrides[key],
-            enumerable: true,
-            configurable: true,
-            writable: true,
-        });
-    }
-    return forward;
-}

package/dist/routes/computer-use/legacy-lane-spec.d.ts

@@ -1,62 +0,0 @@
-import type { ActorPersonaRef } from "../../actors/contract.js";
-import type { ReasoningEffort } from "../../actors/reasoning-effort.js";
-import type { DwellWindow, StopWhen } from "../../actors/stop-conditions.js";
-import type { DevicePreset } from "../../lab/device-presets.js";
-import type { LabTask } from "../../lab/tasks.js";
-import type { RunStream } from "../../run/streams.js";
-import type { DesktopParticipantRun } from "./types.js";
-/**
- * A lane as the deprecated cuaHooks.buildProvider and cuaHooks.createDesktopLane receive it: a flat
- * copy of a DesktopParticipantRun.
- * @deprecated Use RunLabOptions.createProvider, which receives a ParticipantRef. Removed with the
- * compatibility section in the next minor.
- */
-export interface CuaLaneSpec {
-    laneId: string;
-    actorType?: string;
-    surface?: string;
-    caseGroup?: string;
-    /** 0-based. */
-    laneIndex: number;
-    simId: string;
-    streamId: string;
-    persona: ActorPersonaRef;
-    instructions: string;
-    /** Redacted original composed prompt for legacy study context; execution uses instructions. */
-    evidenceInstructions?: string;
-    /** Original declarative assignment, separate from runtime-composed instructions. */
-    assignment?: RunStream["assignment"];
-    /** App-url fan-out only: this lane's explicit browser target; absent falls back to deps.appUrl. */
-    targetUrl?: string;
-    /** Deterministic harness-owned completion guard. Lane-level override, else actor default. */
-    stopWhen?: StopWhen;
-    /** A declared observation window (#510). Lane-level override, else actor default. */
-    dwell?: DwellWindow;
-    /**
-     * How hard this lane's model is asked to think. Lane-level override, else the actor default,
-     * else absent — and absent means the provider's own default, which the trace records as the
-     * resolved value rather than as nothing (#497).
-     */
-    reasoningEffort?: ReasoningEffort;
-    maxOutputTokens?: number;
-    /** The lab's declared protocol (#414). Every lane runs the SAME protocol — that is what makes the
-     *  per-task rates comparable across participants. Goals are already composed into `instructions`;
-     *  this carries the full tasks so the loop can corroborate completion, and the criteria never
-     *  reach the prompt. */
-    tasks?: readonly LabTask[];
-    /** Per-lane override of the CUA idle backstop (consecutive screenshot/wait turns before gave_up).
-     *  Absent falls back to the loop default. Raised for a lane whose job includes a long LEGITIMATE
-     *  wait (e.g. a shared-world HOST idling in the waiting room while followers provision + join). */
-    idleSteps?: number;
-    /** Per-lane override of the non-idle no-progress backstop; see idleSteps. */
-    noProgressSteps?: number;
-    deviceName: string;
-    devicePreset: DevicePreset;
-    resolution: [number, number];
-    /** "" for N=1 (screenshots/<name>); the laneId for N>1 (screenshots/<laneId>/<name>). */
-    screenshotDir: string;
-    /** "actor.json" for N=1; "actors/<streamId>.json" for N>1. */
-    traceArtifactPath: string;
-}
-/** The flat hook view of one participant run. Called only where a caller's hook receives a lane. */
-export declare function legacyHookSpecOf(run: DesktopParticipantRun): CuaLaneSpec;

package/dist/routes/computer-use/legacy-lane-spec.js

@@ -1,39 +0,0 @@
-// Translation module: legacy lane spellings stay only in modules like this one, so the rest of the
-// route reads participants. CuaActorLabHooks is public API in the deprecated compatibility section, and two of its hooks,
-// buildProvider and createDesktopLane, receive a lane. They keep receiving this flat record until
-// the next minor removes the section. Internally a lane is a DesktopParticipantRun.
-/** The flat hook view of one participant run. Called only where a caller's hook receives a lane. */
-export function legacyHookSpecOf(run) {
-    const { planned } = run;
-    const { labels, limits, device } = planned;
-    return {
-        laneId: planned.id,
-        ...(labels.actorType === undefined ? {} : { actorType: labels.actorType }),
-        ...(labels.surface === undefined ? {} : { surface: labels.surface }),
-        ...(labels.caseGroup === undefined ? {} : { caseGroup: labels.caseGroup }),
-        laneIndex: planned.index,
-        simId: run.recordId,
-        streamId: run.streamId,
-        persona: run.persona,
-        instructions: run.instructions,
-        ...(run.evidenceInstructions === undefined
-            ? {}
-            : { evidenceInstructions: run.evidenceInstructions }),
-        ...(run.evidenceAssignment === undefined ? {} : { assignment: run.evidenceAssignment }),
-        ...(planned.targetUrl === undefined ? {} : { targetUrl: planned.targetUrl }),
-        ...(limits.stopWhen === undefined ? {} : { stopWhen: limits.stopWhen }),
-        ...(limits.dwell === undefined ? {} : { dwell: limits.dwell }),
-        ...(limits.reasoningEffort === undefined ? {} : { reasoningEffort: limits.reasoningEffort }),
-        ...(limits.maxOutputTokens === undefined ? {} : { maxOutputTokens: limits.maxOutputTokens }),
-        ...(planned.tasks === undefined ? {} : { tasks: planned.tasks }),
-        ...(run.backstop?.idleSteps === undefined ? {} : { idleSteps: run.backstop.idleSteps }),
-        ...(run.backstop?.noProgressSteps === undefined
-            ? {}
-            : { noProgressSteps: run.backstop.noProgressSteps }),
-        deviceName: device.name,
-        devicePreset: device.preset,
-        resolution: device.resolution,
-        screenshotDir: run.screenshotDir,
-        traceArtifactPath: run.traceArtifactPath,
-    };
-}