humanish 0.104.3 → 0.106.0

package/dist/index.d.ts

@@ -1,83 +1,32 @@
-export { ANALYZE_RESULT_SCHEMA, analyzeStudy, showStudyAnalysis, correctStudyAnalysis } from "./study-analysis-service.js";
-export type { AnalyzeOptions, AnalyzeResult, AnalyzeDeps } from "./study-analysis-service.js";
-export { runAutomaticStudyAnalysis, readAutomaticStudyAnalysis, requestAutomaticStudyAnalysisCancellation } from "./automatic-study-analysis.js";
-export { resolveAutomaticAnalysis, automaticAnalysisBudget } from "./automatic-analysis-config.js";
-export type { LabAnalysis, AutomaticAnalysisBudget } from "./automatic-analysis-config.js";
-export type { AutomaticAnalysisHooks, AutomaticAnalysisResult } from "./automatic-analysis-completion.js";
-export type { AutomaticStudyAnalysisDeps, AutomaticStudyAnalysisOutcome, AutomaticStudyAnalysisView, AutomaticStudyAnalysisCancellation } from "./automatic-study-analysis.js";
-export { STUDY_ANALYSIS_SCHEMA, STUDY_ANALYSIS_CORRECTION_SCHEMA } from "./study-analysis.js";
-export type { StudyAnalysisConfig, OpenAIStudyAnalysisConfig, CodexStudyAnalysisConfig, CodexAnalysisIdentity, StudyAnalysisArtifact, StudyAnalysisResult, StudyAnalysisCorrection, AnalysisConcernReview, LoadedStudyAnalysis } from "./study-analysis.js";
-export { ACTOR_TRACE_SCHEMA, CODEX_APP_SERVER_CAPABILITIES, SCRIPTED_BROWSER_CAPABILITIES, TERMINAL_AGENT_CAPABILITIES, codexResultToActorTrace, codexStatusToCompletionReason } from "./actor-contract.js";
-export type { ActorCapabilities, ActorCompletionReason, ActorStopCause, ActorLane, ActorPersonaRef, ActorProtocol, ActorStatus, ActorTokenUsage, ActorTrace, ActorRuntimeProvenance, ActorTraceItem, ActorTraceItemKind, ParticipantClosingReport } from "./actor-contract.js";
-export { actorRegistry, getActor, isCuaActorDescriptor, isScriptedBrowserActorDescriptor, isTerminalActorDescriptor } from "./actor-registry.js";
-export type { ActorDescriptor, ActorId, CuaActorDescriptor, ScriptedBrowserActorDescriptor, TerminalActorDescriptor } from "./actor-registry.js";
-export { TERMINAL_AGENT_NOT_IMPLEMENTED_CODE, runTerminalAgentSession } from "./terminal-agent-actor.js";
-export type { TerminalAgentSessionOptions, TerminalAgentSessionResult } from "./terminal-agent-actor.js";
-export { describeCuaAction, runComputerUseLoop, stableProgressKey } from "./computer-use.js";
-export type { CuaAction, CuaExecutor, CuaLoopOptions, CuaLoopResult, CuaObservation, CuaProvider, CuaSafetyCheck, CuaTurn, CuaTurnRequest } from "./computer-use.js";
-export { runCuaActorSession } from "./computer-use-actor.js";
-export type { CuaActorSessionOptions } from "./computer-use-actor.js";
-export { createE2BDesktopExecutor } from "./e2b-desktop-executor.js";
-export type { E2BDesktopExecutorOptions, E2BDesktopLike } from "./e2b-desktop-executor.js";
-export { loadE2BDesktopModule } from "./e2b-desktop-launch.js";
-export type { E2BDesktopModule, E2BDesktopSandbox } from "./e2b-desktop-launch.js";
-export { DEFAULT_OPENAI_CU_MODEL, OPENAI_RESPONSES_CU_CAPABILITIES, createOpenAiResponsesProvider } from "./openai-responses-cu.js";
-export type { FetchLike, OpenAiResponsesProviderOptions } from "./openai-responses-cu.js";
-export { CuaAdmissionLimitError } from "./cua-admission-limit.js";
-export { adapterScoreFailureMessage, applyAdapterScoreFailureToReview, applyBrowserAdapterHooks } from "./adapter-extension.js";
-export type { BrowserAdapterBackend, BrowserLabAdapterHooks, BrowserLabScoringContext } from "./adapter-extension.js";
-export type { AdapterScorerModule, AdapterScoringContext } from "./adapter-scorer-loader.js";
-export type { RedactionHooks } from "./redaction.js";
-export type { CommsAddress, CommsChannel, CommsChannelKind, CommsMessage, InboundRaw, OutboundMessage } from "./comms-types.js";
-export { FakeInbox } from "./comms-fake-inbox.js";
-export type { FakeInboxOptions } from "./comms-fake-inbox.js";
-export { COMMS_THREAD_SCHEMA } from "./comms-evidence.js";
-export type { CommsThreadArtifact, CommsThreadEntry } from "./comms-evidence.js";
-export { COMMS_RECEIVING_SCHEMA } from "./comms-receiving-types.js";
-export type { CommsReceivingEvidence, ReceivingParticipantEvidence } from "./comms-receiving-types.js";
-export { DESKTOP_RATE, DESKTOP_RESOURCE_RATE, MODEL_RATES, PRICING_SCHEMA, estimateActorCost, estimateAllocatedDesktopCost, estimateDesktopCost } from "./pricing.js";
-export type { ActorEstimatedCost, DesktopCostEstimate, DesktopRate, DesktopResources, DesktopResourceRate, ModelRate } from "./pricing.js";
-export { normalizeCliArgv } from "./argv.js";
-export { CODEX_APP_SERVER_UI_SCHEMA, startCodexAppServerUi } from "./codex-app-server-ui.js";
-export type { CodexAppServerUiController, CodexAppServerUiOptions, CodexAppServerUiState } from "./codex-app-server-ui.js";
-export { CODEX_APP_SERVER_TRACE_SCHEMA, runCodexAppServerSession } from "./codex-app-server.js";
-export type { CodexAppServerRunOptions, CodexAppServerRunResult, CodexAppServerTrace } from "./codex-app-server.js";
-export { FEEDBACK_RESULT_SCHEMA, FEEDBACK_SCHEMA, draftFeedback, listFeedback, renderIssueMarkdown, renderIssueUrl, verifyFeedback } from "./feedback.js";
-export type { FeedbackDraft, FeedbackResult } from "./feedback.js";
-export { INIT_RESPONSE_SCHEMA, runInit } from "./init.js";
-export type { InitChange, InitMode, InitOptions, InitResult } from "./init.js";
-export { OBSERVER_DATA_SCHEMA, buildObserverData, stripAnsi } from "./observer-data.js";
-export type { ObserverData, ObserverStream } from "./observer-data.js";
-export { OBSERVER_SCHEMA, openTarget, renderObserver, serveObserver } from "./observer.js";
-export type { ObserverOptions, ObserverResult, ObserverServeOptions, ObserverServer } from "./observer.js";
-export { OBSERVER_STATIC_HOST, createObserverStaticHandler, observerStaticContentType, respondToObserverStaticRequest, serveObserverStatic } from "./observer-static.js";
-export type { ObserverStaticHandlerOptions, ObserverStaticServeOptions, ObserverStaticServer } from "./observer-static.js";
-export { DEFAULT_OSS_REPOS, OSS_LAB_SCHEMA, normalizeOssRepoSlugs, runOssLab, validateOssRepoSlug } from "./oss-lab.js";
-export type { OssLabOptions, OssLabRepoResult, OssLabResult, OssLabStep } from "./oss-lab.js";
-export { CLEANUP_SCHEMA, DOCTOR_SCHEMA, REVIEW_SCHEMA, RUNS_SCHEMA, RUN_BUNDLE_SCHEMA, VERIFY_SCHEMA, cleanupRun, doctor, extractLocalActorVerdict, listRuns, normalizeLocalActorTranscript, readReview, runDryRun, verifyRun } from "./run.js";
-export { SHARED_WORLD_SCHEMA } from "./run.js";
-export type { CleanupAdapterResult, CleanupResourceResult, CleanupResult, DoctorResult, ReviewSummary, RunAdapterArtifact, RunAdapterScore, RunAttributionClass, RunBundle, RunCostLine, RunCostSummary, RunDesktopGeometry, RunEvent, RunFeedbackCandidate, RunMeaningfulUseComponentId, RunMeaningfulUseScore, RunCleanupHooks, RunOptions, RunParticipantAssignment, RunProviderResource, RunResult, RunScorerProvenance, RunSimulation, RunStream, RunStreamKind, RunSubjectProvenance, RunSubjectStateStepRecord, RunsResult, SharedWorldCheckpoint, SharedWorldEvidence, SharedWorldLaneWindow, SharedWorldOutcome, SharedWorldPlane, SharedWorldSkippedTail, SharedWorldStateSnapshot, SharedWorldTimelineEntry, SharedWorldTurn, VerifyResult } from "./run.js";
-export { CUA_ACTOR_LAB_PROVIDER_METADATA, CUA_ACTOR_LAB_SCHEMA, CUA_FANOUT_STRATEGY, buildCuaBundle, buildCuaFanoutBundle, resolveCuaLanePlan, runCuaActorLab } from "./cua-actor-lab.js";
-export type { CuaActorLabErrorCode, CuaActorLabHooks, CuaActorLabResult, CuaLanePlan, CuaLanePlanEntry, CuaLaneResult, CuaLaneSummary, CuaSubjectProjection, RunCuaActorLabOptions, SubjectPhaseEvent } from "./cua-actor-lab.js";
-export { SCRIPTED_BROWSER_PROVIDER, runScriptedBrowserSession } from "./scripted-browser-actor.js";
-export type { BrowserPersonaJourney, BrowserSurface, ScriptedBrowserLaunchArgs, ScriptedBrowserLike, ScriptedBrowserSessionOptions, ScriptedBrowserSessionResult, ScriptedLocatorLike, ScriptedPageLike } from "./scripted-browser-actor.js";
-export { SCRIPTED_BROWSER_LAB_SCHEMA, buildScriptedLabBundle, runScriptedBrowserLab } from "./scripted-browser-lab.js";
-export type { RunScriptedBrowserLabOptions, ScriptedBrowserLabHooks, ScriptedBrowserLabResult, ScriptedBrowserLabSession } from "./scripted-browser-lab.js";
-export { TERMINAL_PRODUCT_LAB_SCHEMA, buildTerminalProductBundle, runTerminalProductLab } from "./e2b-terminal-lab.js";
-export type { CommandLogRecord, CostCategory, CostLine, InterventionRecord, LifecycleRecord, NoSpendProof, RunTerminalProductLabOptions, TerminalCostLedger, TerminalLedgers, TerminalProductLabHooks, TerminalProductLabResult, TerminalProductScoringContext } from "./e2b-terminal-lab.js";
-export { SHARED_WORLD_LAB_PROVIDER_METADATA, SHARED_WORLD_LAB_SCHEMA, buildSharedWorldBundle, runSharedWorldLab } from "./shared-world-lab.js";
-export type { RunSharedWorldLabOptions, SharedWorldLabErrorCode, SharedWorldLabHooks, SharedWorldLabResult, SharedWorldRoleResult } from "./shared-world-lab.js";
-export { CONCURRENT_ATTRIBUTION_LIMITS, CONCURRENT_SHARED_WORLD_LAB_SCHEMA, CONCURRENT_SHARED_WORLD_PROVIDER_METADATA, EXTERNAL_PUBLIC_ATTRIBUTION_LIMITS, LOBBY_CODE_PATTERN, buildConcurrentSharedWorldBundle, extractLobbyCode, runConcurrentSharedWorld } from "./concurrent-shared-world-lab.js";
-export type { ConcurrentSharedWorldLabErrorCode, ConcurrentSharedWorldLabResult, ConcurrentSharedWorldPlaneClass, ConcurrentSharedWorldRoleResult, RunConcurrentSharedWorldLabOptions } from "./concurrent-shared-world-lab.js";
-export { probeUrl, readDetachedLog, runDetachedStep, startDetachedProcess } from "./e2b-detached.js";
-export type { DetachedStepOptions, DetachedStepResult, DetachedTimers } from "./e2b-detached.js";
-export { DEFAULT_DEVICE_PRESET, DEVICE_PRESETS, DEVICE_PRESET_NAMES, isDevicePresetName, resolveDevicePreset } from "./device-presets.js";
-export type { DevicePreset, DevicePresetName } from "./device-presets.js";
-export { actorResolvesToTerminal, cuaLaneCount, cuaLaneValidationReason, isHttpUrl, isLoopbackUrl, LAB_CONFIG_SCHEMA, MAX_CUA_LANES, concurrentSharedWorldValidationReason, externalPublicSharedWorldValidationReason, parseLabConfig, resolveSeatUrl, routesToComputerUse, routesToConcurrentSharedWorld, routesToExternalPublicSharedWorld, routesToProvisionedSharedWorld, routesToScriptedBrowser, routesToSharedWorld, routesToTerminalProduct, sharedWorldValidationReason, subjectStateInvalidReason } from "./lab-config.js";
-export type { LabActor, LabActorLane, LabConfig, LabConfigParseResult, LabExecutionTerminal, LabRuntimeAuth, LabScenarioCaps, LabStateStepWhen, LabSubject, LabSubjectProduct, LabSubjectServe, LabSubjectSource, LabSubjectState, LabSubjectStateCheckpoint, LabSubjectStateStep, LabSubjectTopology, LabTerminalStdin, LabTerminalTransport } from "./lab-config.js";
-export { resolveLabDryRun, runLab, selectLabBackend } from "./lab-engine.js";
-export type { LabBackend, LabOutcome, RunLabOptions } from "./lab-engine.js";
-export { LAB_PREFLIGHT_SCHEMA, runLabPreflight } from "./lab-preflight.js";
-export type { LabPreflightCheck, LabPreflightReachabilityMode, LabPreflightResult, LabPreflightSandbox, LabPreflightSpend, LabPreflightTarget, RunLabPreflightOptions } from "./lab-preflight.js";
-export { CLI_RESPONSE_SCHEMA, createProgram } from "./program.js";
-export type { CliIo, UnexpectedErrorEnvelope } from "./program.js";
+export { runLab } from "./run-lab.js";
+export type { LabOutcome, LabResult, RunLabOptions } from "./run-lab.js";
+export type { LabEvent } from "./lab/run-lab-events.js";
+export type { ProviderContext } from "./lab/run-lab-options.js";
+export { routeOf } from "./lab/plan.js";
+export type { LabRoute } from "./lab/plan.js";
+export { parseLabConfig } from "./lab/config.js";
+export { LAB_CONFIG_SCHEMA } from "./lab/types.js";
+export type { LabConfig } from "./lab/types.js";
+export { verifyRun } from "./verify/verify.js";
+export type { VerifyResult } from "./verify/verify.js";
+export { renderObserver } from "./observer/render.js";
+export type { ObserverResult } from "./observer/render.js";
+export type { RunBundle, RunFeedbackCandidate } from "./run/bundle.js";
+export type { ActorTrace } from "./actors/contract.js";
+export { runComputerUseLoop, stableProgressKey } from "./actors/computer-use/loop.js";
+export type { CuaAction, CuaExecutor, CuaLoopOptions, CuaLoopResult, CuaObservation, CuaProvider, CuaSafetyCheck, CuaTurn, CuaTurnRequest, } from "./actors/computer-use/loop.js";
+export type { ActorCapabilities } from "./actors/contract.js";
+export { createOpenAiResponsesProvider } from "./actors/computer-use/openai-provider.js";
+export type { OpenAiResponsesProviderOptions } from "./actors/computer-use/openai-provider.js";
+export { CuaAdmissionLimitError } from "./actors/computer-use/admission-limit.js";
+export { defaultRedactionHooks } from "./evidence/redaction.js";
+export type { RedactionHooks } from "./evidence/redaction.js";
+export type { E2BDesktopSandbox } from "./substrates/e2b/sdk.js";
+export type { AdapterScorerModule, AdapterScoringContext } from "./lab/adapter-scorer-loader.js";
+export type { BrowserLabScoringContext } from "./lab/adapter-extension.js";
+export type { TerminalProductScoringContext } from "./routes/terminal/types.js";
+export type { RunAdapterArtifact, RunAdapterScore } from "./run/bundle.js";
+export { routesToComputerUse, routesToConcurrentSharedWorld, routesToExternalPublicSharedWorld, routesToProvisionedSharedWorld, routesToScriptedBrowser, routesToSharedWorld, routesToTerminalProduct, } from "./lab/routing.js";
+export { selectLabBackend } from "./lab/plan.js";
+export { actorResolvesToTerminal, concurrentSharedWorldValidationReason, cuaLaneCount, cuaLaneValidationReason, externalPublicSharedWorldValidationReason, MAX_CUA_LANES, resolveLabDryRun, resolveSeatUrl, runConcurrentSharedWorld, runCuaActorLab, runCuaActorSession, runDryRun, runScriptedBrowserLab, runTerminalProductLab, sharedWorldValidationReason, } from "./deprecated.js";
+export type { AutomaticAnalysisHooks, BrowserLabAdapterHooks, ConcurrentSharedWorldLabResult, CuaActorLabHooks, CuaActorLabResult, LabBackend, RunConcurrentSharedWorldLabOptions, RunCuaActorLabOptions, RunOptions, RunResult, RunScriptedBrowserLabOptions, RunTerminalProductLabOptions, ScriptedBrowserLabHooks, ScriptedBrowserLabResult, SharedWorldLabHooks, SubjectPhaseEvent, TerminalProductLabHooks, TerminalProductLabResult, } from "./deprecated.js";

package/dist/index.js

@@ -1,42 +1,21 @@
-export { ANALYZE_RESULT_SCHEMA, analyzeStudy, showStudyAnalysis, correctStudyAnalysis } from "./study-analysis-service.js";
-export { runAutomaticStudyAnalysis, readAutomaticStudyAnalysis, requestAutomaticStudyAnalysisCancellation } from "./automatic-study-analysis.js";
-export { resolveAutomaticAnalysis, automaticAnalysisBudget } from "./automatic-analysis-config.js";
-export { STUDY_ANALYSIS_SCHEMA, STUDY_ANALYSIS_CORRECTION_SCHEMA } from "./study-analysis.js";
-export { ACTOR_TRACE_SCHEMA, CODEX_APP_SERVER_CAPABILITIES, SCRIPTED_BROWSER_CAPABILITIES, TERMINAL_AGENT_CAPABILITIES, codexResultToActorTrace, codexStatusToCompletionReason } from "./actor-contract.js";
-export { actorRegistry, getActor, isCuaActorDescriptor, isScriptedBrowserActorDescriptor, isTerminalActorDescriptor } from "./actor-registry.js";
-export { TERMINAL_AGENT_NOT_IMPLEMENTED_CODE, runTerminalAgentSession } from "./terminal-agent-actor.js";
-export { describeCuaAction, runComputerUseLoop, stableProgressKey } from "./computer-use.js";
-export { runCuaActorSession } from "./computer-use-actor.js";
-export { createE2BDesktopExecutor } from "./e2b-desktop-executor.js";
-export { loadE2BDesktopModule } from "./e2b-desktop-launch.js";
-export { DEFAULT_OPENAI_CU_MODEL, OPENAI_RESPONSES_CU_CAPABILITIES, createOpenAiResponsesProvider } from "./openai-responses-cu.js";
-export { CuaAdmissionLimitError } from "./cua-admission-limit.js";
-export { adapterScoreFailureMessage, applyAdapterScoreFailureToReview, applyBrowserAdapterHooks } from "./adapter-extension.js";
-export { FakeInbox } from "./comms-fake-inbox.js";
-export { COMMS_THREAD_SCHEMA } from "./comms-evidence.js";
-export { COMMS_RECEIVING_SCHEMA } from "./comms-receiving-types.js";
-export { DESKTOP_RATE, DESKTOP_RESOURCE_RATE, MODEL_RATES, PRICING_SCHEMA, estimateActorCost, estimateAllocatedDesktopCost, estimateDesktopCost } from "./pricing.js";
-export { normalizeCliArgv } from "./argv.js";
-export { CODEX_APP_SERVER_UI_SCHEMA, startCodexAppServerUi } from "./codex-app-server-ui.js";
-export { CODEX_APP_SERVER_TRACE_SCHEMA, runCodexAppServerSession } from "./codex-app-server.js";
-export { FEEDBACK_RESULT_SCHEMA, FEEDBACK_SCHEMA, draftFeedback, listFeedback, renderIssueMarkdown, renderIssueUrl, verifyFeedback } from "./feedback.js";
-export { INIT_RESPONSE_SCHEMA, runInit } from "./init.js";
-export { OBSERVER_DATA_SCHEMA, buildObserverData, stripAnsi } from "./observer-data.js";
-export { OBSERVER_SCHEMA, openTarget, renderObserver, serveObserver } from "./observer.js";
-export { OBSERVER_STATIC_HOST, createObserverStaticHandler, observerStaticContentType, respondToObserverStaticRequest, serveObserverStatic } from "./observer-static.js";
-export { DEFAULT_OSS_REPOS, OSS_LAB_SCHEMA, normalizeOssRepoSlugs, runOssLab, validateOssRepoSlug } from "./oss-lab.js";
-export { CLEANUP_SCHEMA, DOCTOR_SCHEMA, REVIEW_SCHEMA, RUNS_SCHEMA, RUN_BUNDLE_SCHEMA, VERIFY_SCHEMA, cleanupRun, doctor, extractLocalActorVerdict, listRuns, normalizeLocalActorTranscript, readReview, runDryRun, verifyRun } from "./run.js";
-export { SHARED_WORLD_SCHEMA } from "./run.js";
-export { CUA_ACTOR_LAB_PROVIDER_METADATA, CUA_ACTOR_LAB_SCHEMA, CUA_FANOUT_STRATEGY, buildCuaBundle, buildCuaFanoutBundle, resolveCuaLanePlan, runCuaActorLab } from "./cua-actor-lab.js";
-export { SCRIPTED_BROWSER_PROVIDER, runScriptedBrowserSession } from "./scripted-browser-actor.js";
-export { SCRIPTED_BROWSER_LAB_SCHEMA, buildScriptedLabBundle, runScriptedBrowserLab } from "./scripted-browser-lab.js";
-export { TERMINAL_PRODUCT_LAB_SCHEMA, buildTerminalProductBundle, runTerminalProductLab } from "./e2b-terminal-lab.js";
-export { SHARED_WORLD_LAB_PROVIDER_METADATA, SHARED_WORLD_LAB_SCHEMA, buildSharedWorldBundle, runSharedWorldLab } from "./shared-world-lab.js";
-export { CONCURRENT_ATTRIBUTION_LIMITS, CONCURRENT_SHARED_WORLD_LAB_SCHEMA, CONCURRENT_SHARED_WORLD_PROVIDER_METADATA, EXTERNAL_PUBLIC_ATTRIBUTION_LIMITS, LOBBY_CODE_PATTERN, buildConcurrentSharedWorldBundle, extractLobbyCode, runConcurrentSharedWorld } from "./concurrent-shared-world-lab.js";
-export { probeUrl, readDetachedLog, runDetachedStep, startDetachedProcess } from "./e2b-detached.js";
-export { DEFAULT_DEVICE_PRESET, DEVICE_PRESETS, DEVICE_PRESET_NAMES, isDevicePresetName, resolveDevicePreset } from "./device-presets.js";
-export { actorResolvesToTerminal, cuaLaneCount, cuaLaneValidationReason, isHttpUrl, isLoopbackUrl, LAB_CONFIG_SCHEMA, MAX_CUA_LANES, concurrentSharedWorldValidationReason, externalPublicSharedWorldValidationReason, parseLabConfig, resolveSeatUrl, routesToComputerUse, routesToConcurrentSharedWorld, routesToExternalPublicSharedWorld, routesToProvisionedSharedWorld, routesToScriptedBrowser, routesToSharedWorld, routesToTerminalProduct, sharedWorldValidationReason, subjectStateInvalidReason } from "./lab-config.js";
-export { resolveLabDryRun, runLab, selectLabBackend } from "./lab-engine.js";
-export { LAB_PREFLIGHT_SCHEMA, runLabPreflight } from "./lab-preflight.js";
-export { CLI_RESPONSE_SCHEMA, createProgram } from "./program.js";
-//# sourceMappingURL=index.js.map
+// The library surface: what an adopter needs to run a lab, read a run, bring a participant or
+// score a run. Everything else is internal and reached through the `humanish` bin. See
+// docs/contracts/schemas.md, "Library options", and the site's library page.
+// Run a lab.
+export { runLab } from "./run-lab.js";
+export { routeOf } from "./lab/plan.js";
+export { parseLabConfig } from "./lab/config.js";
+export { LAB_CONFIG_SCHEMA } from "./lab/types.js";
+// Read a run.
+export { verifyRun } from "./verify/verify.js";
+export { renderObserver } from "./observer/render.js";
+// Bring a participant.
+export { runComputerUseLoop, stableProgressKey } from "./actors/computer-use/loop.js";
+export { createOpenAiResponsesProvider } from "./actors/computer-use/openai-provider.js";
+export { CuaAdmissionLimitError } from "./actors/computer-use/admission-limit.js";
+export { defaultRedactionHooks } from "./evidence/redaction.js";
+// Routing: the planLab series deprecates these and removes them in the next minor.
+export { routesToComputerUse, routesToConcurrentSharedWorld, routesToExternalPublicSharedWorld, routesToProvisionedSharedWorld, routesToScriptedBrowser, routesToSharedWorld, routesToTerminalProduct, } from "./lab/routing.js";
+export { selectLabBackend } from "./lab/plan.js";
+// Deprecated this minor, removed in the next.
+export { actorResolvesToTerminal, concurrentSharedWorldValidationReason, cuaLaneCount, cuaLaneValidationReason, externalPublicSharedWorldValidationReason, MAX_CUA_LANES, resolveLabDryRun, resolveSeatUrl, runConcurrentSharedWorld, runCuaActorLab, runCuaActorSession, runDryRun, runScriptedBrowserLab, runTerminalProductLab, sharedWorldValidationReason, } from "./deprecated.js";

package/dist/keys/env-file.d.ts

@@ -0,0 +1,15 @@
+declare const ENV_FILE_RESULT_SCHEMA = "humanish.env-file-result.v1";
+export interface EnvFileLoadResult {
+    schema: typeof ENV_FILE_RESULT_SCHEMA;
+    ok: boolean;
+    cwd: string;
+    envFile: string;
+    loaded: string[];
+    skipped: string[];
+    error?: {
+        code: "HUMANISH_ENV_FILE_NOT_FOUND" | "HUMANISH_ENV_FILE_INVALID";
+        message: string;
+    };
+}
+export declare function loadEnvFile(cwd: string, envFile: string, env?: NodeJS.ProcessEnv): Promise<EnvFileLoadResult>;
+export {};

package/dist/keys/env-file.js

@@ -0,0 +1,109 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+const ENV_FILE_RESULT_SCHEMA = "humanish.env-file-result.v1";
+const envNamePattern = /^[A-Za-z_][A-Za-z0-9_]*$/;
+export async function loadEnvFile(cwd, envFile, env = process.env) {
+    const resolvedCwd = path.resolve(cwd);
+    const envPath = path.resolve(resolvedCwd, envFile);
+    const loaded = [];
+    const skipped = [];
+    let text;
+    try {
+        text = await readFile(envPath, "utf8");
+    }
+    catch {
+        return {
+            schema: ENV_FILE_RESULT_SCHEMA,
+            ok: false,
+            cwd: resolvedCwd,
+            envFile,
+            loaded,
+            skipped,
+            error: {
+                code: "HUMANISH_ENV_FILE_NOT_FOUND",
+                message: `Env file was not readable: ${envFile}`,
+            },
+        };
+    }
+    const lines = text.split(/\r?\n/);
+    for (let index = 0; index < lines.length; index += 1) {
+        const parsed = parseEnvLine(lines[index] ?? "");
+        if (parsed === null) {
+            continue;
+        }
+        if (!parsed.ok) {
+            return {
+                schema: ENV_FILE_RESULT_SCHEMA,
+                ok: false,
+                cwd: resolvedCwd,
+                envFile,
+                loaded,
+                skipped,
+                error: {
+                    code: "HUMANISH_ENV_FILE_INVALID",
+                    message: `Invalid env assignment on line ${index + 1}.`,
+                },
+            };
+        }
+        if (env[parsed.name] !== undefined) {
+            skipped.push(parsed.name);
+            continue;
+        }
+        env[parsed.name] = parsed.value;
+        loaded.push(parsed.name);
+    }
+    return {
+        schema: ENV_FILE_RESULT_SCHEMA,
+        ok: true,
+        cwd: resolvedCwd,
+        envFile,
+        loaded,
+        skipped,
+    };
+}
+function parseEnvLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) {
+        return null;
+    }
+    const assignment = trimmed.startsWith("export ")
+        ? trimmed.slice("export ".length).trim()
+        : trimmed;
+    const separator = assignment.indexOf("=");
+    if (separator <= 0) {
+        return { ok: false };
+    }
+    const name = assignment.slice(0, separator).trim();
+    if (!envNamePattern.test(name)) {
+        return { ok: false };
+    }
+    const rawValue = assignment.slice(separator + 1).trim();
+    const value = unquoteEnvValue(rawValue);
+    if (value === null) {
+        return { ok: false };
+    }
+    return { ok: true, name, value };
+}
+function unquoteEnvValue(value) {
+    if (!value) {
+        return "";
+    }
+    const first = value[0];
+    const last = value[value.length - 1];
+    if ((first === '"' || first === "'") && last !== first) {
+        return null;
+    }
+    if (first === '"' && last === '"') {
+        return value
+            .slice(1, -1)
+            .replace(/\\n/g, "\n")
+            .replace(/\\r/g, "\r")
+            .replace(/\\t/g, "\t")
+            .replace(/\\"/g, '"')
+            .replace(/\\\\/g, "\\");
+    }
+    if (first === "'" && last === "'") {
+        return value.slice(1, -1);
+    }
+    return value.replace(/\s+#.*$/, "");
+}

package/dist/keys/key-resolution.d.ts

@@ -0,0 +1,58 @@
+export interface ResolvedKeyFill {
+    name: string;
+    /** Human-readable source label (a path or command name) — never a value. */
+    source: string;
+}
+export interface KeyResolutionDeps {
+    /** Injectable for tests: run `gh auth token`-style probes. Resolves to trimmed single-line
+     *  stdout, or null on any failure (missing binary, non-zero exit, empty/multi-line output). */
+    execText?: (command: string, args: string[], timeoutMs: number, env?: NodeJS.ProcessEnv) => Promise<string | null>;
+    homeDir?: string;
+}
+export declare function userKeyStorePath(env: NodeJS.ProcessEnv, deps?: KeyResolutionDeps): string;
+/**
+ * Fill missing provider keys into `env` from the discovery chain, announcing each fill as
+ * `NAME from SOURCE`. Returns the fills. Opt-out: HUMANISH_STRICT_KEYS=1 returns [] untouched.
+ */
+export declare function discoverProviderKeys(args: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    announce: (line: string) => void;
+    deps?: KeyResolutionDeps;
+}): Promise<ResolvedKeyFill[]>;
+export interface KeySourceProbe {
+    name: string;
+    /** The source that supplies the key right now, or null when missing everywhere. */
+    source: string | null;
+    /** The command/path that would fill it when missing. */
+    hint: string;
+}
+/** The nearest fill instruction for a missing key — used by doctor rows and appended to
+ *  *_KEYS_MISSING errors so the failure names the fix, not just the absence (#436). */
+export declare function missingKeyHint(name: string): string;
+/** One shared suffix for *_KEYS_MISSING messages: where discovery looked, and what fills each
+ *  missing key. Pure text; never values. */
+export declare function describeMissingKeys(names: string[], env: NodeJS.ProcessEnv): string;
+/**
+ * Non-mutating probe for doctor: report, per key, the source that currently supplies it.
+ * Runs the same chain against a scratch copy of env so nothing observable changes.
+ */
+export declare function probeKeySources(names: readonly string[], args: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    deps?: KeyResolutionDeps;
+}): Promise<KeySourceProbe[]>;
+/** Resolve a `humanish keys set` target: a vendor alias or a raw env name. Null = invalid. */
+export declare function resolveKeyName(vendorOrName: string): string | null;
+/** Write one key into the user store (0700 dir, 0600 file). Only allowlisted provider names
+ *  are storable (the store feeds implicit discovery — an arbitrary-name store would be an env
+ *  injection vector with extra steps). The value must be a single non-empty line that
+ *  round-trips the store's own parser byte-identically, and the write refuses symlinks at the
+ *  file AND its parent directory (red-team findings). */
+export declare function setUserKey(name: string, value: string, env: NodeJS.ProcessEnv, deps?: KeyResolutionDeps): {
+    path: string;
+};
+/** Remove one key from the user store. Returns whether it was present. */
+export declare function unsetUserKey(name: string, env: NodeJS.ProcessEnv, deps?: KeyResolutionDeps): boolean;
+/** The names (never values) currently in the user store. */
+export declare function listUserKeys(env: NodeJS.ProcessEnv, deps?: KeyResolutionDeps): string[];