humanish 0.125.0 → 0.127.0

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

@@ -101,6 +101,10 @@ function singleParticipantArgs(base, state) {
                 : "e2b-desktop",
         ...(outcome?.desktopGeometry === undefined ? {} : { desktopGeometry: outcome.desktopGeometry }),
         ...(outcome?.recording === undefined ? {} : { recording: outcome.recording }),
+        ...(outcome?.desktopFiles === undefined ? {} : { desktopFiles: outcome.desktopFiles }),
+        ...(spec.planned.limits.timeZone === undefined
+            ? {}
+            : { timeZone: spec.planned.limits.timeZone }),
         isMobile: spec.planned.device.preset.isMobile,
         screenshots: outcome?.screenshots ?? [],
         captureRedaction: base.redactScreenshots ? "blurred" : "raw",

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

@@ -3,7 +3,7 @@ import { type ActorCompletionReason, type ActorStatus, type ActorStopCause } fro
 declare const CUA_DIAGNOSTIC_CATEGORIES: readonly ["preview", "participant_outcome", "session_interrupted", "execution_error", "evidence_invalid", "mixed", "unknown"];
 export type CuaDiagnosticCategory = (typeof CUA_DIAGNOSTIC_CATEGORIES)[number];
 /** Closed at both projection and telemetry boundaries. No provider messages are classified. */
-declare const CUA_DIAGNOSTIC_STOP_CAUSES: readonly ["provider_output_limit", "provider_token_limit", "time_limit", "spend_limit", "study_spend_limit", "adapter_limit", "provider_incomplete", "provider_status", "provider_refused_prompt", "harness_aborted", "usage_unreported", "scheduled_end", "unspecified_limit", "mixed", "unknown"];
+declare const CUA_DIAGNOSTIC_STOP_CAUSES: readonly ["provider_output_limit", "provider_token_limit", "time_limit", "spend_limit", "study_spend_limit", "adapter_limit", "provider_incomplete", "provider_status", "provider_refused_prompt", "harness_aborted", "usage_unreported", "scheduled_end", "session_cap", "unspecified_limit", "mixed", "unknown"];
 export type CuaDiagnosticStopCause = (typeof CUA_DIAGNOSTIC_STOP_CAUSES)[number];
 export interface CuaDiagnostics {
     category: CuaDiagnosticCategory;

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

@@ -30,9 +30,9 @@ export function cuaParticipantDiagnostics(input) {
     const session = input.session;
     if (!session)
         return { category: "unknown" };
-    // A scheduled end is the participant's planned ending, so a run whose other participants ended
-    // themselves reads as one kind of ending.
-    if (session.stopCause === "scheduled_end")
+    // A scheduled end or a session cap is the participant's planned ending, so a run whose other
+    // participants ended themselves reads as one kind of ending.
+    if (session.stopCause === "scheduled_end" || session.stopCause === "session_cap")
         return { category: "participant_outcome" };
     if (session.stopCause !== undefined) {
         return {

package/dist/routes/computer-use/e2b-desktop/desktop.js

@@ -1,7 +1,7 @@
 import { createE2BDesktopExecutor } from "../../../substrates/e2b/desktop-executor.js";
 import { participantInbox, planParticipantComms } from "./comms.js";
 import { participantBrowserStateObserver } from "./fidelity.js";
-import { acquireParticipantDesktop, provisionParticipantSubject, verifyParticipantScreen, } from "./prepare.js";
+import { acquireParticipantDesktop, placeParticipantFiles, provisionParticipantSubject, verifyParticipantScreen, } from "./prepare.js";
 import { openParticipantSurface, startParticipantMedia, startParticipantStream } from "./start.js";
 import { desktopEvidenceOf, newParticipantState } from "./state.js";
 import { finishE2BDesktop } from "./teardown.js";
@@ -40,6 +40,7 @@ export function createE2BParticipantDesktop(spec, deps, warnings) {
         const desktop = await acquireParticipantDesktop(ctx, state);
         // The device claim is verified in the sandbox, and fails closed.
         await verifyParticipantScreen(ctx, state, desktop);
+        await placeParticipantFiles(ctx, state, desktop);
         await provisionParticipantSubject(ctx, state, desktop);
         await startParticipantMedia(ctx, state, desktop);
         await openParticipantSurface(ctx, state, desktop);

package/dist/routes/computer-use/e2b-desktop/prepare.d.ts

@@ -14,5 +14,11 @@ export declare function acquireParticipantDesktop(ctx: E2BParticipantContext, st
  * requested and verified geometry side by side.
  */
 export declare function verifyParticipantScreen(ctx: E2BParticipantContext, state: E2BParticipantState, desktop: E2BDesktopSandbox): Promise<void>;
+/**
+ * Copy the participant's files (participants[].files) into its home folder and confirm each one's
+ * size there, before the subject and the browser start. A file that does not land whole fails the
+ * participant before its first turn. The state records each confirmed file as it lands.
+ */
+export declare function placeParticipantFiles(ctx: E2BParticipantContext, state: E2BParticipantState, desktop: E2BDesktopSandbox): Promise<void>;
 /** Install a desktop CLI, or clone or unpack the subject and serve it, in the sandbox. */
 export declare function provisionParticipantSubject(ctx: E2BParticipantContext, state: E2BParticipantState, desktop: E2BDesktopSandbox): Promise<void>;

package/dist/routes/computer-use/e2b-desktop/prepare.js

@@ -8,11 +8,12 @@ import { provisionLocalTreeSubject } from "../../../subject/local-tree.js";
 import { SubjectBuildError } from "../../../subject/serve.js";
 import { inspectDesktopScreenGeometry } from "../../../substrates/e2b/desktop-geometry.js";
 import { observeDesktopResources } from "../../../substrates/e2b/desktop-resources.js";
-import { acquireE2BDesktopSandbox, e2bDesktopTemplate } from "../../../substrates/e2b/sandbox.js";
+import { acquireE2BDesktopSandbox, e2bDesktopTemplate, withOneRetryOnTransientE2BError, } from "../../../substrates/e2b/sandbox.js";
 import { loadE2BDesktopModule } from "../../../substrates/e2b/sdk.js";
 import { e2bShell } from "../../../substrates/e2b/shell.js";
 import { attachReceivingInbox, participantCommsEnv, startCommsCatch } from "./comms.js";
 import { participantSubjectEnv } from "../types.js";
+import { plural } from "../../../run/text.js";
 export const CUA_ACTOR_STUDY_PROVIDER_METADATA = {
     mode: "cua-actor-lab",
     tool: "humanish",
@@ -151,6 +152,51 @@ export async function verifyParticipantScreen(ctx, state, desktop) {
         };
     }
 }
+/**
+ * Copy the participant's files (participants[].files) into its home folder and confirm each one's
+ * size there, before the subject and the browser start. A file that does not land whole fails the
+ * participant before its first turn. The state records each confirmed file as it lands.
+ */
+export async function placeParticipantFiles(ctx, state, desktop) {
+    const { spec, deps } = ctx;
+    const files = deps.desktopFiles?.get(spec.planned.id) ?? [];
+    if (files.length === 0)
+        return;
+    const getInfo = desktop.files.getInfo?.bind(desktop.files);
+    if (getInfo === undefined)
+        throw new Error("The installed E2B SDK has no files.getInfo, so humanish cannot confirm that participants[].files landed. Update @e2b/desktop.");
+    const requestTimeoutMs = deps.requestTimeoutMs;
+    const startedAt = deps.now();
+    ctx.onSubjectPhase({
+        at: new Date(startedAt).toISOString(),
+        type: "cua-lab.desktop.files.started",
+        message: `copying ${plural(files.length, "file")} onto the desktop`,
+    });
+    const filesCompleted = (ok) => ctx.onSubjectPhase({
+        at: new Date(deps.now()).toISOString(),
+        type: "cua-lab.desktop.files.completed",
+        ok,
+        durationMs: Math.max(0, deps.now() - startedAt),
+        message: ok
+            ? `${plural(files.length, "file")} on the desktop`
+            : `copying files onto the desktop failed after ${plural(state.desktopFiles.length, "file")}`,
+    });
+    try {
+        for (const file of files) {
+            // A relative path lands under the sandbox user's home folder, and missing folders are made.
+            await withOneRetryOnTransientE2BError(() => desktop.files.write(file.as, file.data, { requestTimeoutMs, useOctetStream: true }));
+            const landed = await getInfo(file.as, { requestTimeoutMs });
+            if (landed.size !== file.size)
+                throw new Error(`participants[].files: ${file.as} measured ${landed.size} bytes on the desktop of participant ${spec.planned.id} after humanish copied ${file.size}, so the participant did not start.`);
+            state.desktopFiles.push({ as: file.as, size: file.size, sha256: file.sha256 });
+        }
+    }
+    catch (error) {
+        filesCompleted(false);
+        throw error;
+    }
+    filesCompleted(true);
+}
 /** Install a desktop CLI, or clone or unpack the subject and serve it, in the sandbox. */
 export async function provisionParticipantSubject(ctx, state, desktop) {
     const { deps } = ctx;

package/dist/routes/computer-use/e2b-desktop/start.d.ts

@@ -4,7 +4,8 @@ import type { E2BParticipantContext, E2BParticipantState } from "./state.js";
 export declare function startParticipantMedia(ctx: E2BParticipantContext, state: E2BParticipantState, desktop: E2BDesktopSandbox): Promise<void>;
 /**
  * Open what the participant sees: the browser at the target, with any declared camera and mobile
- * fidelity, or a terminal window on the desktop-cli route.
+ * fidelity, or a terminal window on the desktop-cli route. A participant with a time zone sees the
+ * desktop's panel clock in it; a clock that cannot be set is a warning, and it shows UTC.
  */
 export declare function openParticipantSurface(ctx: E2BParticipantContext, state: E2BParticipantState, desktop: E2BDesktopSandbox): Promise<void>;
 /**

package/dist/routes/computer-use/e2b-desktop/start.js

@@ -3,6 +3,7 @@
 // fills the participant's state.
 import { redactText, toErrorMessage } from "../../../evidence/redaction.js";
 import { CHROME_DEVTOOLS_PORT, DESKTOP_SETTLE_MS, openDesktopBrowserTarget, openDesktopTerminal, startDesktopStream, } from "../../../substrates/e2b/desktop-browser.js";
+import { setPanelClockZone } from "../../../substrates/e2b/desktop-clock.js";
 import { captureDesktopBrowserGeometry } from "../../../substrates/e2b/desktop-geometry.js";
 import { prepareDesktopMedia, startE2BDesktopMedia, } from "../../../substrates/e2b/desktop-media.js";
 import { startE2BDesktopRecording } from "../../../substrates/e2b/desktop-recording.js";
@@ -39,16 +40,23 @@ export async function startParticipantMedia(ctx, state, desktop) {
 }
 /**
  * Open what the participant sees: the browser at the target, with any declared camera and mobile
- * fidelity, or a terminal window on the desktop-cli route.
+ * fidelity, or a terminal window on the desktop-cli route. A participant with a time zone sees the
+ * desktop's panel clock in it; a clock that cannot be set is a warning, and it shows UTC.
  */
 export async function openParticipantSurface(ctx, state, desktop) {
     const { spec, deps, warnings, targetUrl } = ctx;
     const { residual, subject } = deps;
+    const { timeZone } = spec.planned.limits;
+    if (timeZone !== undefined) {
+        await setPanelClockZone(desktop, timeZone, deps.requestTimeoutMs).catch((error) => {
+            warnings.push(`The desktop's panel clock for participant ${spec.planned.id} could not be set to ${timeZone} and shows UTC: ${redactText(deps.scrubKnownValues(toErrorMessage(error)))}`);
+        });
+    }
     if (subject.kind === "desktop-cli") {
         // A terminal window, opened the way the browser is opened on every other route: the
         // participant arrives at a desktop with the thing they were asked to use already in front
         // of them. They can still open another from the dock; that is the point of a desktop.
-        await openDesktopTerminal(desktop, deps.requestTimeoutMs, subject.product.workdir);
+        await openDesktopTerminal(desktop, deps.requestTimeoutMs, subject.product.workdir, timeZone);
         await desktop.wait(DESKTOP_SETTLE_MS).catch(() => undefined);
         return;
     }
@@ -59,7 +67,11 @@ export async function openParticipantSurface(ctx, state, desktop) {
         ? undefined
         : await prepareDesktopMedia(desktop, requestedMedia, residual.policies?.mediaPermission ?? "prompt", deps.studyCwd, deps.requestTimeoutMs);
     const emulationFlags = mobileLaunchFlags(residual, spec);
-    const browserLaunch = await openDesktopBrowserTarget(desktop, targetUrl, deps.requestTimeoutMs, residual.execution?.desktop?.browser, [...emulationFlags, ...(mediaEvidence?.flags ?? [])], state.speech?.env ?? state.recording?.env);
+    // The participant's time zone is TZ on the launch: the browser process and every renderer it
+    // starts read it at startup, so every tab runs in the zone from the first page load. A CDP
+    // timezone override holds only on the one tab whose DevTools session sets it, from after its load.
+    const mediaEnv = state.speech?.env ?? state.recording?.env;
+    const browserLaunch = await openDesktopBrowserTarget(desktop, targetUrl, deps.requestTimeoutMs, residual.execution?.desktop?.browser, [...emulationFlags, ...(mediaEvidence?.flags ?? [])], timeZone === undefined ? mediaEnv : { ...mediaEnv, TZ: timeZone });
     state.desktopBrowser =
         mediaEvidence === undefined
             ? browserLaunch.evidence

package/dist/routes/computer-use/e2b-desktop/state.d.ts

@@ -1,6 +1,6 @@
 import type { RunDesktopRecording } from "../../../evidence/desktop-recording-types.js";
 import type { RunSubjectStateStepRecord } from "../../../run/bundle.js";
-import type { RunDesktopGeometry } from "../../../run/streams.js";
+import type { RunDesktopFile, RunDesktopGeometry } from "../../../run/streams.js";
 import type { SubjectPhaseEvent } from "../../../subject/steps.js";
 import type { OwnedDesktopAllocation } from "../../../substrates/desktop-session.js";
 import type { DesktopBrowserEvidence, DesktopBrowserFamily, DesktopBrowserLaunchIdentity } from "../../../substrates/e2b/desktop-browser.js";
@@ -45,6 +45,8 @@ export interface E2BParticipantState {
     readonly stateStepRecords: RunSubjectStateStepRecord[];
     /** Completed phases only (durationMs and ok are set on completed events); bundle.events keeps these. */
     readonly phaseRecords: SubjectPhaseEvent[];
+    /** participants[].files confirmed on the desktop, in the order they landed. */
+    readonly desktopFiles: RunDesktopFile[];
     subjectCommit: string | undefined;
     speech: Awaited<ReturnType<typeof startE2BDesktopMedia>> | undefined;
     recording: Awaited<ReturnType<typeof startE2BDesktopRecording>> | undefined;

package/dist/routes/computer-use/e2b-desktop/state.js

@@ -18,6 +18,7 @@ export function newParticipantState(spec) {
         receivingInboxUrl: undefined,
         stateStepRecords: [],
         phaseRecords: [],
+        desktopFiles: [],
         subjectCommit: undefined,
         speech: undefined,
         recording: undefined,
@@ -60,6 +61,7 @@ export function desktopEvidenceOf(state) {
         ...(state.subjectCommit === undefined ? {} : { subjectCommit: state.subjectCommit }),
         ...(state.desktopBrowser === undefined ? {} : { desktopBrowser: state.desktopBrowser }),
         ...(state.recordingEvidence === undefined ? {} : { recording: state.recordingEvidence }),
+        ...(state.desktopFiles.length === 0 ? {} : { desktopFiles: state.desktopFiles }),
         desktopGeometry: state.desktopGeometry,
         stateStepRecords: state.stateStepRecords,
         phaseRecords: state.phaseRecords,

package/dist/routes/computer-use/fanout-bundle.js

@@ -1,6 +1,7 @@
 import { e2bDesktopTemplate } from "../../substrates/e2b/sandbox.js";
 import { receivingPublication } from "../../comms/receiving-runtime.js";
 import { actorEnding } from "../../actors/stop-cause.js";
+import { cuaGoalSource } from "../../actors/goal-source.js";
 import { redactText } from "../../evidence/redaction.js";
 import { REVIEW_SCHEMA, bundleArtifacts, bundleHead, } from "../../run/bundle.js";
 import { aggregateTaskFunnels, formatParticipantOutcomes, formatRunTaskFunnel, gapsListClause, withCuaReviewProvenance, } from "../../run/outcomes.js";
@@ -86,9 +87,11 @@ function fanoutReview(args, streams, judgment) {
     const runTasks = args.inProgress === true ? undefined : aggregateTaskFunnels(participantFunnels);
     const participantEndings = terminalOutcomes.map((outcome) => {
         const ending = actorEnding(outcome.session.trace);
+        const goalSource = cuaGoalSource(outcome.session.trace);
         return {
             status: outcome.session.status,
             ...(ending === undefined ? {} : { label: ending.label }),
+            ...(goalSource === undefined ? {} : { goalSource }),
         };
     });
     const review = withCuaReviewProvenance({

package/dist/routes/computer-use/fanout-records.js

@@ -72,7 +72,7 @@ function fanoutParticipantRecord(args, spec, index, view) {
         updatedAt: args.run.createdAt,
         ...(args.participantPlan.schedule === undefined
             ? {}
-            : { arrival: arrivalRecord(spec.planned.startAfterMs, outcome?.arrival) }),
+            : { arrival: arrivalRecord(spec.planned.schedule.startAfterMs, outcome?.arrival) }),
     });
 }
 function fanoutParticipantStream(args, spec, view) {
@@ -120,6 +120,10 @@ function fanoutParticipantStream(args, spec, view) {
                 },
             }),
         desktopGeometry,
+        ...(outcome?.desktopFiles === undefined ? {} : { desktopFiles: outcome.desktopFiles }),
+        ...(spec.planned.limits.timeZone === undefined
+            ? {}
+            : { timeZone: spec.planned.limits.timeZone }),
         ...(outcome?.recording === undefined ? {} : { recording: outcome.recording }),
         ui: {
             route: publicTargetUrl,

package/dist/routes/computer-use/participant-deps.d.ts

@@ -36,7 +36,7 @@ interface DesktopRunFacts {
 }
 /** The fields one desktop route sets and the other does not. Undefined leaves a field out. */
 type DesktopRouteOverrides = {
-    [K in "createDesktop" | "createProvider" | "inProcessExecutor" | "localTreeArchiveBuffer" | "externalComms" | "receiving" | "screenMismatchPolicy"]?: CuaParticipantDeps[K] | undefined;
+    [K in "createDesktop" | "createProvider" | "inProcessExecutor" | "localTreeArchiveBuffer" | "desktopFiles" | "externalComms" | "receiving" | "screenMismatchPolicy"]?: CuaParticipantDeps[K] | undefined;
 };
 /**
  * One run's participant deps. Call it once per run: the run budget it creates is the one ledger

package/dist/routes/computer-use/participant-desktop.d.ts

@@ -22,7 +22,7 @@ export type ParticipantDesktopEvidence = {
      * who did not pass.
      */
     desktopFailure?: string;
-} & Pick<ParticipantRunOutcome, "sandboxId" | "sandboxRelease" | "desktopDurationMs" | "desktopResources" | "streamUrlPresent" | "subjectCommit" | "desktopBrowser" | "desktopGeometry" | "stateStepRecords" | "phaseRecords" | "failureCode" | "commsArtifactPath" | "recording">;
+} & Pick<ParticipantRunOutcome, "sandboxId" | "sandboxRelease" | "desktopDurationMs" | "desktopResources" | "streamUrlPresent" | "subjectCommit" | "desktopBrowser" | "desktopGeometry" | "stateStepRecords" | "phaseRecords" | "failureCode" | "commsArtifactPath" | "recording" | "desktopFiles">;
 /**
  * The desktop one participant runs on, owned from preparation through final evidence collection.
  * Call methods sequentially: prepare, openSession, then finalize in a finally block.

package/dist/routes/computer-use/participant-execution.js

@@ -4,7 +4,7 @@ import { createE2BParticipantDesktop } from "./e2b-desktop/desktop.js";
 import { createInProcessDesktop } from "./in-process-desktop.js";
 import path from "node:path";
 import { cuaParticipantDiagnostics } from "./diagnostics.js";
-import { runOnSchedule } from "../../study/arrivals.js";
+import { pastEndReason, runOnSchedule } from "../../study/arrivals.js";
 import { assertScreenshotEvidence, stripPngMetadataChunks } from "../../evidence/image.js";
 import { redactText, toErrorMessage } from "../../evidence/redaction.js";
 import { assertSafeOutputPathSegment, writeContainedOutputFile, } from "../../run/contained-output.js";
@@ -59,6 +59,10 @@ export async function runCuaParticipant(spec, deps) {
     if (crossed !== undefined) {
         return skippedOutcome(spec, `skipped: study budget reached before this participant started: ${crossed}; no desktop was created`);
     }
+    // One that waited for a slot until its scheduled end would only be asked for its closing report.
+    const pastEnd = pastEndReason(deps.end, deps.now());
+    if (pastEnd !== undefined)
+        return skippedOutcome(spec, pastEnd);
     let model = {};
     const warnings = [];
     const screenshots = [];
@@ -207,7 +211,7 @@ export async function runCuaParticipants(runs, deps, concurrency, runParticipant
     // An app-url subject is only opened, so one participant's start says nothing about another's.
     const gate = pipelineGate(deps.subject.kind === "app-url", () => stopping.abort());
     return runOnSchedule(runs, {
-        startAfterMs: (spec) => spec.planned.startAfterMs,
+        startAfterMs: (spec) => spec.planned.schedule.startAfterMs,
         slots: concurrency,
         now: deps.now,
         signal: stopping.signal,

package/dist/routes/computer-use/participant-facts.js

@@ -1,11 +1,13 @@
 // A participant run outcome's facts for the judge (src/run/judge.ts), and the pass check built on
 // them. The bundle builders, the result, the participant runner and shared-world all read these,
-// so they sit in a file that imports only the judge and the types.
+// so they sit in a file that imports only the judge, the clock-end rule and the types.
+import { ranUntilClockEnd } from "../../actors/goal-source.js";
 import { participantHarnessFailed, participantPassed, sandboxCleanupFailure, } from "../../run/judge.js";
 /** A participant outcome's facts for the judge. */
 export function participantFactsOf(outcome) {
     if (outcome === undefined)
         return { skipped: false, noEngagement: false, selfReportedBlocker: false };
+    const ranUntil = outcome.session === undefined ? undefined : ranUntilClockEnd(outcome.session.trace);
     return {
         id: outcome.spec.planned.id,
         ...(outcome.skippedReason === undefined ? {} : { skippedReason: outcome.skippedReason }),
@@ -21,6 +23,7 @@ export function participantFactsOf(outcome) {
         skipped: outcome.skippedReason !== undefined,
         noEngagement: outcome.noEngagement === true,
         selfReportedBlocker: outcome.selfReportedBlocker === true,
+        ...(ranUntil === undefined ? {} : { ranUntil }),
     };
 }
 /** Whether a participant passed. A dry-run participant passes as a contract. */

package/dist/routes/computer-use/participant-model.js

@@ -307,18 +307,28 @@ export function makeCuaRunBudget(maxTotalUsd) {
     };
 }
 /**
- * The participant's clock: its time zone, and its scheduled end on the run's clock. A participant
- * with an end runs its session on the run's clock, so the end and the schedule read one clock.
+ * The participant's clock: its time zone, and its end on the run's clock. A participant with an
+ * end runs its session on the run's clock, so the end and the schedule read one clock. A cap
+ * counts from here, where the session starts, so the desktop's setup does not use it.
  */
 function participantClock(timeZone, deps) {
-    const { scheduledEnd } = deps;
-    if (timeZone === undefined && scheduledEnd === undefined)
+    const declared = deps.end;
+    if (timeZone === undefined && declared === undefined)
         return {};
+    const end = declared === undefined
+        ? undefined
+        : declared.kind === "session_cap"
+            ? {
+                atMs: deps.now() + declared.afterMs,
+                windDownMs: declared.windDownMs,
+                kind: declared.kind,
+            }
+            : { atMs: declared.atMs, windDownMs: declared.windDownMs };
     return {
         clock: {
             ...(timeZone === undefined ? {} : { timeZone }),
-            ...(scheduledEnd === undefined ? {} : { end: scheduledEnd }),
+            ...(end === undefined ? {} : { end }),
         },
-        ...(scheduledEnd === undefined ? {} : { now: deps.now }),
+        ...(end === undefined ? {} : { now: deps.now }),
     };
 }

package/dist/routes/computer-use/participant-runs.d.ts

@@ -4,7 +4,7 @@ import { type ResolvedPersona } from "../../study/persona.js";
 import { type RunRerunLineage } from "../../run/bundle.js";
 import type { PreparedSelectedOutputDirectory } from "../../run/contained-output.js";
 import { type CuaActorStudyErrorCode, type CuaParticipantDeps, type CuaParticipantPlan, type CuaParticipantPlanEntry, type DesktopParticipantRun, type ParticipantRunsAndPlan } from "./types.js";
-import { type ParticipantWindow } from "../../study/arrivals.js";
+import { type ParticipantSchedule } from "../../study/arrivals.js";
 /**
  * The session budget of a study that declares no execution.timeoutMs. On a provisioned route it is
  * what the `ceilingMs` sandbox ceiling leaves after provisioning, seeding and the teardown buffer.
@@ -19,28 +19,29 @@ export declare function defaultSessionTimeoutMs(config: StudyConfig, ceilingMs:
 export declare function resolveParticipantSandboxMs(config: StudyConfig, ceilingMs: number): number;
 /**
  * The deps one participant runs with once its start comes: its own session budget and sandbox
- * deadline, and with a declared end, that end on the run's clock (`scheduledAt` is when it was
- * due, from runOnSchedule).
+ * deadline (participantSession), and with a declared end or cap, how its session ends
+ * (`scheduledAt` is when it was due, from runOnSchedule).
  */
-export declare function scheduledParticipantDeps(participant: ParticipantWindow, deps: {
+export declare function scheduledParticipantDeps(participant: {
+    readonly schedule: ParticipantSchedule;
+}, deps: {
     readonly timeoutMs: number;
     readonly sandboxMs: number;
-}, scheduledAt: number): Pick<CuaParticipantDeps, "timeoutMs" | "sandboxMs" | "scheduledEnd">;
+}, scheduledAt: number): Pick<CuaParticipantDeps, "timeoutMs" | "sandboxMs" | "end">;
 /**
  * The in-flight participant bound a study declares. Defaults to the participant count: every
  * declared participant runs at once, because a throttle nobody asked for silently turns "N actors
  * live" into waves; total session count and spend are the same either way, only wall-clock
  * and simultaneity differ. A declared execution.concurrency is a cap, clamped to [1, participants].
- * The planner records it; the route may only lower it from the environment.
+ * participantsAtOnce then lowers it to what the E2B plan and HUMANISH_CUA_MAX_CONCURRENCY allow.
  */
 export declare function boundedConcurrency(declared: number | undefined, participantCount: number): number;
 /**
  * Build the participant runs and the public plan from a computer-use plan (pure). The same plan
- * appears in dry-run and live, marked $0 for a dry run. `env` may lower the planned concurrency;
- * `personas` are the compiled committed personas the prompts carry.
+ * appears in dry-run and live, marked $0 for a dry run. `personas` are the compiled committed
+ * personas the prompts carry.
  */
 export declare function participantRunsAndPlan(plan: ComputerUsePlan, opts?: {
-    env?: Record<string, string | undefined>;
     personas?: Map<string, ResolvedPersona>;
 }): ParticipantRunsAndPlan;
 /** Print the participant plan to stderr before any sandbox/provider call (public-safe: ids, devices,
@@ -63,7 +64,6 @@ export declare function loadCuaParticipants(args: {
     plan: ComputerUsePlan;
     cwd: string;
     projectRoot: PreparedSelectedOutputDirectory;
-    env: Record<string, string | undefined>;
 }): Promise<{
     ok: true;
     participantRuns: DesktopParticipantRun[];