@agentskit/harness 0.8.0 → 0.10.0

package/dist/index.d.ts

@@ -2232,6 +2232,27 @@ interface ModelPolicy {
 declare const createModelPolicy: (bindings: readonly ModelBinding[]) => ModelPolicy;
 declare const modelFor: (policy: ModelPolicy, role: ModelRole) => ModelBinding;
 
+/**
+ * Deterministic pattern scanner for text that is about to be embedded in a prompt or echoed back into a public
+ * PR/issue comment — a segment lifted from an issue description or a code-review finding can carry a secret that
+ * was never meant to leave the private context it came from. Pure and kernel-safe: no adapters, no network, no
+ * state. Pattern-based, not a claim of completeness — it catches the shapes that show up in practice (emails,
+ * common provider API-key prefixes, phone numbers, card-number-shaped digit runs), not every possible secret.
+ */
+type PiiKind = 'email' | 'api-key' | 'phone' | 'credit-card';
+interface PiiMatch {
+    readonly kind: PiiKind;
+    readonly index: number;
+    readonly length: number;
+}
+interface PiiScanResult {
+    readonly matches: readonly PiiMatch[];
+    /** `text` with every match replaced by `[REDACTED:<kind>]`. Equal to `text` when `matches` is empty. */
+    readonly redacted: string;
+}
+/** Scan `text` for every configured pattern kind and return both the matches (positions into the *original* text) and a redacted copy. */
+declare const scanForPii: (text: string) => PiiScanResult;
+
 interface OrcaDispatchInput {
     readonly repository: string;
     readonly worktree: string;
@@ -2607,6 +2628,12 @@ declare const LOOP_CONFIG_FILE = "loop.config.yaml";
 /** Optional, gitignored per-machine overlay merged over the versioned config (e.g. `linear.person`, `machine.minFreeRamGb`). */
 declare const LOOP_LOCAL_CONFIG_FILE = "loop.config.local.yaml";
 declare const LOOP_CONFIG_SCHEMA_VERSION = 1;
+declare const effortLevel: z.ZodEnum<{
+    low: "low";
+    medium: "medium";
+    high: "high";
+    xhigh: "xhigh";
+}>;
 declare const LoopConfigSchema: z.ZodObject<{
     schemaVersion: z.ZodDefault<z.ZodLiteral<1>>;
     project: z.ZodObject<{
@@ -2615,6 +2642,11 @@ declare const LoopConfigSchema: z.ZodObject<{
         baseBranch: z.ZodDefault<z.ZodString>;
         root: z.ZodDefault<z.ZodString>;
         stateDir: z.ZodDefault<z.ZodString>;
+        setup: z.ZodPrefault<z.ZodObject<{
+            command: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            timeoutSec: z.ZodDefault<z.ZodNumber>;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
     orca: z.ZodPrefault<z.ZodObject<{
         bin: z.ZodDefault<z.ZodString>;
@@ -2629,6 +2661,11 @@ declare const LoopConfigSchema: z.ZodObject<{
         teamKey: z.ZodString;
         person: z.ZodString;
         people: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        rotation: z.ZodPrefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            owners: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            advanceWhenEmpty: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
         states: z.ZodDefault<z.ZodArray<z.ZodString>>;
         excludeLabels: z.ZodDefault<z.ZodArray<z.ZodString>>;
         requireLabels: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -2741,6 +2778,33 @@ declare const LoopConfigSchema: z.ZodObject<{
             probe: z.ZodOptional<z.ZodArray<z.ZodString>>;
             headless: z.ZodOptional<z.ZodArray<z.ZodString>>;
             reviewProvider: z.ZodOptional<z.ZodString>;
+            effortFlag: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        effort: z.ZodPrefault<z.ZodObject<{
+            orchestrator: z.ZodDefault<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+                xhigh: "xhigh";
+            }>>;
+            reviewer: z.ZodDefault<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+                xhigh: "xhigh";
+            }>>;
+            builder: z.ZodDefault<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+                xhigh: "xhigh";
+            }>>;
+            watcher: z.ZodDefault<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+                xhigh: "xhigh";
+            }>>;
         }, z.core.$strip>>;
     }, z.core.$strip>;
     machine: z.ZodPrefault<z.ZodObject<{
@@ -2773,9 +2837,9 @@ declare const LoopConfigSchema: z.ZodObject<{
             concurrency: z.ZodDefault<z.ZodNumber>;
             minSeverity: z.ZodDefault<z.ZodEnum<{
                 blocker: "blocker";
+                high: "high";
                 nit: "nit";
                 med: "med";
-                high: "high";
             }>>;
             deadlineMs: z.ZodDefault<z.ZodNumber>;
             maxCalls: z.ZodDefault<z.ZodNumber>;
@@ -2793,6 +2857,7 @@ declare const LoopConfigSchema: z.ZodObject<{
                 rebase: "rebase";
             }>>;
             requireChecks: z.ZodDefault<z.ZodBoolean>;
+            requireHumanApproval: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strip>>;
         smoke: z.ZodPrefault<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
@@ -2816,12 +2881,14 @@ declare const LoopConfigSchema: z.ZodObject<{
         }, z.core.$strip>>;
         maxFixRounds: z.ZodDefault<z.ZodNumber>;
         workerIdleTimeoutMin: z.ZodDefault<z.ZodNumber>;
+        maxDispatchMinutes: z.ZodOptional<z.ZodNumber>;
         handoff: z.ZodPrefault<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             maxHandoffs: z.ZodDefault<z.ZodNumber>;
             onlyWhenProviderUnavailable: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strip>>;
         selfEditPaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        secretFilePatterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
         ignoreChecks: z.ZodDefault<z.ZodArray<z.ZodString>>;
         requiredChecks: z.ZodDefault<z.ZodArray<z.ZodString>>;
         cleanupWorktree: z.ZodDefault<z.ZodBoolean>;
@@ -2883,6 +2950,33 @@ declare const LoopConfigSchema: z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         allowTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
+    plugins: z.ZodPrefault<z.ZodObject<{
+        modules: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    github: z.ZodPrefault<z.ZodObject<{
+        intakeLabel: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        reviewOnly: z.ZodDefault<z.ZodLiteral<true>>;
+    }, z.core.$strip>>;
+    resilience: z.ZodPrefault<z.ZodObject<{
+        maxConsecutiveFailures: z.ZodDefault<z.ZodNumber>;
+        pausedLabel: z.ZodDefault<z.ZodString>;
+        stagePauseAfterRuns: z.ZodDefault<z.ZodNumber>;
+        maxUsageDeltaPercent: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    brief: z.ZodPrefault<z.ZodObject<{
+        skills: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        maxSkillChars: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    security: z.ZodPrefault<z.ZodObject<{
+        pii: z.ZodPrefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            action: z.ZodDefault<z.ZodEnum<{
+                block: "block";
+                redact: "redact";
+                warn: "warn";
+            }>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
     schedule: z.ZodPrefault<z.ZodObject<{
         tick: z.ZodDefault<z.ZodString>;
         deliver: z.ZodDefault<z.ZodString>;
@@ -2929,9 +3023,10 @@ declare const providerIdentity: (config: LoopConfig, provider: string) => {
     readonly orcaUsageKey: string;
     readonly settings: LoopProviderConfig;
 };
-declare const renderTuiCommand: (settings: LoopProviderConfig, model: string) => string;
+type EffortLevel = z.infer<typeof effortLevel>;
+declare const renderTuiCommand: (settings: LoopProviderConfig, model: string, effort?: EffortLevel) => string;
 /** Substitute `{model}` / `{prompt}` inside each headless argv element; the prompt stays one argv element, never shell-joined. */
-declare const renderHeadlessArgv: (settings: LoopProviderConfig, model: string, prompt: string) => readonly string[] | null;
+declare const renderHeadlessArgv: (settings: LoopProviderConfig, model: string, prompt: string, effort?: EffortLevel) => readonly string[] | null;
 
 declare const AGENT_REGISTRY_SCHEMA_VERSION: 1;
 declare const AgentRegistryEntrySchema: z.ZodObject<{
@@ -3020,6 +3115,8 @@ interface RankedModel extends ModelReference {
     readonly remainingPercent: number | null;
     readonly reason: string;
     readonly preferenceIndex: number;
+    /** Reasoning effort requested for this role (`models.effort.<role>`); only takes effect on providers with `effortFlag` set. */
+    readonly effort: EffortLevel;
 }
 interface RoutingDecision {
     readonly role: ModelRole;
@@ -3155,7 +3252,7 @@ interface LoopDoctorInput {
     readonly queueTop?: number;
 }
 declare const providerSpecs: (config: LoopConfig) => readonly ProviderSpec[];
-/** Count worktrees the loop treats as live workers: not archived, not the main checkout, with a live terminal or a linked Linear issue. */
+/** Count worktrees still doing implementation work. Review/completed worktrees keep their lease for delivery, but must not consume a builder slot. */
 declare const countRunningWorkers: (worktrees: readonly OrcaWorktree[]) => number;
 declare const runLoopDoctor: (input: LoopDoctorInput) => Promise<LoopDoctorReport>;
 
@@ -3214,7 +3311,14 @@ declare const githubPullRequestsForBranch: (runner: CommandRunner, input: {
 declare const githubOpenPullRequests: (runner: CommandRunner, input: {
     readonly repo: string;
     readonly limit?: number;
+    readonly label?: string;
 }, options?: GitHubCliOptions) => Promise<readonly PullRequestSnapshot[]>;
+/** Remove a label from a PR (best-effort — `gh` succeeds even if the label was already gone). */
+declare const githubLabelRemove: (runner: CommandRunner, input: {
+    readonly repo: string;
+    readonly number: number;
+    readonly label: string;
+}, options?: GitHubCliOptions) => Promise<void>;
 /** Squash/merge via REST with optimistic concurrency on the reviewed head SHA; GitHub refuses when the head moved. */
 declare const githubMergeArgv: (input: {
     readonly repo: string;
@@ -3381,9 +3485,11 @@ declare const renderContractPrompt: (input: {
     readonly references: readonly ContextReference[];
     readonly memoryBlock?: string;
     readonly maxIssueChars?: number;
+    /** Called (once, if `security.pii.enabled`) with the matches found in the issue text, before redaction. */
+    readonly onPiiDetected?: (matches: readonly PiiMatch[]) => void;
 }) => string;
 declare const parseContractOutput: (stdout: string) => TaskContract;
-declare const resolveDocContext: (root: string, query: string, max: number, scopes?: readonly string[]) => Promise<readonly ContextReference[]>;
+declare const resolveDocContext: (root: string, query: string, max: number, scopes?: readonly string[], maxAgeHours?: number) => Promise<readonly ContextReference[]>;
 interface ProviderFailure {
     readonly provider: string;
     readonly model: string;
@@ -3406,10 +3512,43 @@ interface GenerateContractInput {
     readonly onProviderFailure?: (failure: ProviderFailure) => void;
     /** Observability for memory/doc-bridge char budgets. */
     readonly onMemoryPlan?: (plan: MemoryContextPlan) => void;
+    /** Called (once, if `security.pii.enabled`) with the matches found in the issue text, before redaction. */
+    readonly onPiiDetected?: (matches: readonly PiiMatch[]) => void;
 }
 declare const classifyProviderFailure: (detail: string, timedOut?: boolean) => ProviderFailure["kind"];
+/**
+ * Best-effort extraction of a reset instant from a CLI's own usage-limit message, e.g.
+ * "resets 10:40pm (America/Sao_Paulo)" or "resets in 3h". Returns null when nothing parses;
+ * callers fall back to the configured exponential cooldown.
+ */
+declare const extractResetsAt: (detail: string, now?: Date) => string | null;
 declare const generateContract: (input: GenerateContractInput) => Promise<StoredContract>;
 
+interface PinnedSkill {
+    /** As configured in `brief.skills` — a path relative to the project root. */
+    readonly path: string;
+    /** sha256 of the content actually embedded (post-truncation), so the digest matches what the worker saw. */
+    readonly digest: string;
+    readonly content: string;
+    readonly truncated: boolean;
+}
+interface PinnedSkillRef {
+    readonly path: string;
+    readonly digest: string;
+}
+declare const skillDigest: (content: string) => string;
+/**
+ * Read every configured skill file relative to `root`, hash and truncate each (with a visible note) to `maxChars`
+ * so one large file cannot blow the whole brief's budget. A file listed in `brief.skills` is a promise to the
+ * worker that specific guidance is present — missing or unreadable files fail the dispatch outright (fail-closed)
+ * rather than silently sending a worker without conventions it was told it would have.
+ */
+declare const loadPinnedSkills: (root: string, paths: readonly string[], maxChars: number) => readonly PinnedSkill[];
+/** Rendered once per dispatch and embedded in the worker brief; the digest lets a human or `loop retro` prove which exact revision a given run saw. */
+declare const renderPinnedSkills: (skills: readonly PinnedSkill[]) => string;
+/** The `{path, digest}` list persisted in `dispatch.json` — the full content lives only in the brief file, not duplicated per issue. */
+declare const skillRefs: (skills: readonly PinnedSkill[]) => readonly PinnedSkillRef[];
+
 interface WorkerBriefInput {
     readonly issue: LinearIssueDetail;
     readonly contract: StoredContract;
@@ -3422,6 +3561,10 @@ interface WorkerBriefInput {
     readonly memoryBlock?: string;
     /** Doc Bridge playbook/for-agents refs (titles/paths only). */
     readonly guidanceRefs?: readonly ContextReference[];
+    /** Full content of `brief.skills` files, read and digested once at dispatch time (`loadPinnedSkills`). */
+    readonly skills?: readonly PinnedSkill[];
+    /** Called (once, if `security.pii.enabled`) with the matches found in the issue text, before redaction. */
+    readonly onPiiDetected?: (matches: readonly PiiMatch[]) => void;
 }
 interface HandoffBriefInput {
     readonly issue: string;
@@ -3444,6 +3587,71 @@ declare const renderHandoffBrief: (input: HandoffBriefInput) => string;
 /** The prompt a worker receives in its Orca terminal. Issue text is data; the contract and the rules are the instructions. */
 declare const renderWorkerBrief: (input: WorkerBriefInput) => string;
 
+/**
+ * A local, in-process pub/sub bus over the loop's own event vocabulary (the same free-form `type` strings
+ * `appendLoopEvent` writes to `<stateDir>/events.ndjson`: `contract.failed`, `worker.dispatched`, `pr.reviewed`,
+ * `provider.cooldown`, `issue.paused`, etc.). It exists so a project can react to loop activity in real time
+ * (tick/deliver run) instead of only reading the ndjson after the fact — the ndjson stays the durable log; this is
+ * only a live fan-out on top of it, scoped to the current process.
+ *
+ * Deliberately not `kernel/plugins.ts`: that registry ties into `HARNESS_EVENT_TYPES` (the harness's own
+ * lifecycle events) and requires plugin ids/versions/dependency ordering. The loop's event vocabulary is an open
+ * set of strings owned by composition, not the kernel, so this is a plain listener map with the same "who's
+ * listening" ergonomics, not a copy of the kernel's contract.
+ */
+type LoopEventPayload = Readonly<Record<string, unknown>> & {
+    readonly type: string;
+};
+type LoopEventListener = (event: LoopEventPayload) => void;
+/**
+ * Fired around a loop-orchestration decision (not a model/tool call inside the worker's own CLI session — that
+ * loop is opaque to us). A `before*` hook can return `{ block: true, reason }` to stop the action outright; any
+ * other return value (including a thrown error, which is treated as `{ block: true }`) does not block.
+ */
+type LoopHookName = 'beforeDispatch' | 'afterDispatch' | 'beforeReview' | 'afterReview' | 'beforeMerge' | 'afterMerge' | 'onPause' | 'onEscalate';
+type LoopHookPayload = Readonly<Record<string, unknown>>;
+type LoopHookResult = void | {
+    readonly block: true;
+    readonly reason: string;
+};
+type LoopHookListener = (payload: LoopHookPayload) => LoopHookResult | Promise<LoopHookResult>;
+interface LoopEventBus {
+    /** Emit a loop event to every subscriber of its `type`. Never throws: a listener error is swallowed (composition must not fail because a plugin misbehaves). */
+    emit(event: LoopEventPayload): void;
+    /** Subscribe to one event type (or `'*'` for every event). Returns an unsubscribe function. */
+    on(type: string | '*', listener: LoopEventListener): () => void;
+    /** Register a lifecycle hook. Multiple listeners on the same hook all run; the first `{ block: true }` wins. */
+    hook(name: LoopHookName, listener: LoopHookListener): () => void;
+    /**
+     * Run every listener registered for `name` in registration order and return the first block decision, or
+     * `{ block: false }` when none blocked. A listener that throws is treated as a non-blocking no-op (a broken
+     * plugin must not take down the loop) and its error is appended to `errors`.
+     */
+    runHook(name: LoopHookName, payload: LoopHookPayload): Promise<{
+        readonly block: boolean;
+        readonly reason?: string;
+        readonly errors: readonly string[];
+    }>;
+}
+declare const createLoopEventBus: () => LoopEventBus;
+/**
+ * Load `plugins.modules` (local `.mjs` files, the same trust level as `agents.registry.yaml`: files the project
+ * owner put in their own repo, never fetched over the network) and give each one the bus to subscribe to. A
+ * module that fails to load or whose `apply` throws is reported, not fatal — one broken plugin must not stop tick
+ * or deliver from running.
+ */
+interface LoopPluginModule {
+    readonly id: string;
+    readonly apply: (bus: LoopEventBus) => void | Promise<void>;
+}
+declare const loadLoopPlugins: (root: string, modulePaths: readonly string[], bus: LoopEventBus) => Promise<{
+    readonly loaded: readonly string[];
+    readonly errors: readonly {
+        readonly path: string;
+        readonly error: string;
+    }[];
+}>;
+
 type TickOutcome = 'dispatched' | 'dry-run' | 'skipped' | 'escalated' | 'failed';
 interface TickCandidateResult {
     readonly issue: string;
@@ -3488,6 +3696,19 @@ interface DispatchRecordFile {
     readonly leaseId: string;
     readonly dispatchedAt: string;
     readonly url: string;
+    readonly briefDigest: string;
+    readonly skills: readonly PinnedSkillRef[];
+    readonly setup: {
+        readonly command: readonly string[];
+        readonly exitCode: number | null;
+        readonly durationMs: number;
+        readonly timedOut: boolean;
+    } | null;
+    readonly effort: EffortLevel;
+    /** Builder provider's remaining Orca usage percent at dispatch time (`resilience.maxUsageDeltaPercent` cost guard); `null` when usage was unknown. */
+    readonly initialRemainingPercent: number | null;
+    /** Absolute path to the Orca worktree, so `loop status`/`debrief`/`watch` can best-effort read `progress.json` from it. */
+    readonly worktreePath: string;
 }
 interface TickInput {
     readonly configPath?: string;
@@ -3529,10 +3750,12 @@ declare const branchFor: (issue: Pick<LoopIssue, "identifier" | "branchName">, p
 /** Issues the loop must not touch: active leases, worktrees already linked to the issue, or a worktree sitting on the issue's branch. */
 declare const busyIssues: (queue: readonly LoopIssue[], leases: readonly DispatchLease[], worktrees: readonly OrcaWorktree[], person: string) => ReadonlySet<string>;
 declare const dispatchRecordPath: (stateDir: string, identifier: string) => string;
+declare const briefPath: (stateDir: string, identifier: string) => string;
 declare const readDispatchRecord: (stateDir: string, identifier: string) => DispatchRecordFile | null;
 declare const writeDispatchRecord: (stateDir: string, record: DispatchRecordFile) => string;
-declare const appendLoopEvent: (stateDir: string, event: Record<string, unknown>) => void;
+declare const appendLoopEvent: (stateDir: string, event: Record<string, unknown>, bus?: LoopEventBus) => void;
 interface LoopState {
+    readonly person: string;
     readonly providers: readonly ProviderAvailability[];
     readonly routing: Readonly<Record<string, RoutingDecision>>;
     readonly worktrees: readonly OrcaWorktree[];
@@ -3582,6 +3805,8 @@ interface CodeReviewOutcome {
     readonly provider: string;
     readonly model: string | null;
     readonly resultParsed: boolean;
+    /** Last 800 chars of combined stderr+stdout, for callers that need to classify *why* a review was incomplete (auth/quota/timeout) beyond the truncated `summary`. */
+    readonly rawTail: string;
 }
 interface CodeReviewInput {
     readonly cli: string;
@@ -3761,6 +3986,19 @@ declare const parseAutomationRuns: (result: unknown) => readonly {
 }[];
 declare const loopStatus: (input: Pick<InstallInput, "configPath" | "loaded" | "runner">) => Promise<LoopStatusReport>;
 
+declare const rotationStatePath: (stateDir: string) => string;
+/** Effective owner for this machine; without rotation the versioned config remains authoritative. */
+declare const queueOwner: (loaded: LoadedLoopConfig) => string;
+/** Advance once, only after the current owner has no dispatchable work and no active lease. */
+declare const advanceQueueOwner: (loaded: LoadedLoopConfig, input: {
+    readonly queueEmpty: boolean;
+    readonly activeLeases: number;
+    readonly now?: Date;
+}) => {
+    readonly owner: string;
+    readonly advanced: boolean;
+};
+
 interface GuidedInstallIO {
     /** Ask a yes/no question; `fallback` is used when the answer is empty. */
     readonly confirm: (question: string, fallback: boolean) => Promise<boolean>;
@@ -3867,6 +4105,19 @@ declare const promptLocalConfig: (runner: CommandRunner, loaded: LoadedLoopConfi
     readonly currentUserHint?: string;
 }) => Promise<LocalConfigAnswers | null>;
 
+/** One outcome id (from the frozen contract) mapped to how far the worker has gotten on it. */
+type OutcomeProgressStatus = 'in-progress' | 'done';
+type OutcomeProgress = Readonly<Record<string, OutcomeProgressStatus>>;
+/**
+ * The worker cannot be asked "what have you done so far" — it is an opaque CLI session, and the contract's
+ * outcome list (`brief.ts`) is a static plan frozen before dispatch, not a live todo list. The brief documents a
+ * lightweight convention instead: the worker writes `progress.json` at its worktree root, one entry per outcome id
+ * it has started or finished, and we read it back best-effort. A missing, unreadable or malformed file is not an
+ * error — it just means no progress has been reported yet — because nothing enforces that a worker keeps it
+ * current, and older dispatches never wrote one at all.
+ */
+declare const readOutcomeProgress: (worktreePath: string | null | undefined) => OutcomeProgress | null;
+
 interface DebriefInput {
     readonly configPath?: string;
     readonly loaded?: LoadedLoopConfig;
@@ -3892,6 +4143,8 @@ interface DebriefIssueRow {
     readonly heldFor: string | null;
     readonly finalOutcome: string | null;
     readonly contractIntent: string | null;
+    /** Best-effort read of `progress.json` from the worktree, keyed by outcome id (see brief.ts rule 10); `null` when the worker hasn't written one. */
+    readonly progress: OutcomeProgress | null;
 }
 interface DebriefReport {
     readonly generatedAt: string;
@@ -4105,4 +4358,86 @@ declare const runRetroStage: (input: {
     readonly dryRun?: boolean;
 }) => Promise<RetroStageReport>;
 
-export { AGENT_REGISTRY_SCHEMA_VERSION, ARTIFACT_SCHEMA_VERSION, ARTIFACT_TYPES, ASSURANCE_LEVELS, type AdapterMetadata, type AdapterTelemetry, type AdversarialReviewResult, type AgentAdapter, type AgentEvalCase, type AgentEvalReport, type AgentEvalSuite, type AgentMemoryAdapter, type AgentMemoryHit, type AgentMemoryKvStore, type AgentMemoryRecord, type AgentRegistry, type AgentRegistryEntry, AgentRegistryEntrySchema, AgentRegistrySchema, type AgentSessionOptions, type AgentUsage, type ApprovedAssumption, type ArgvRagContextProviderOptions, type ArtifactBinding, type ArtifactEnvelope, type ArtifactEnvelopeInput, type ArtifactType, type ArtificialAnalysisModel, type AssuranceLevel, type AutomationStatus, type AutonomyMode, BENCHMARK_SCHEMA_VERSION, BLOCK_STATUSES, type BenchmarkBinding, type BenchmarkComparison, type BenchmarkImprovementDirection, type BenchmarkManifest, type BenchmarkObservation, type BenchmarkObservationEvidence, type BenchmarkObservationInput, type BenchmarkObservationStatus, type BenchmarkReport, type BenchmarkRun, type BenchmarkSummary, type BenchmarkTask, type BlockAssessment, type BlockManifest, type BlockStatus, CAPABILITY_KINDS, CAPABILITY_MANIFEST_SCHEMA_VERSION, CHECK_CATEGORIES, COMPATIBILITY_COMPONENTS, COMPATIBILITY_SCHEMA_VERSION, CONTEXT_PROVIDER_SLOT, CONTRACT_CLOSE, CONTRACT_OPEN, CONTRACT_SCHEMA_VERSION, type CacheUsage, type CapabilityDescriptor, type CapabilityKind, type CapabilityManifest, type CapabilityManifestInput, type CatalogModel, type ChangedFile, type CheckCategory, type CheckOutcome, type CheckResult, type ChecksAssessment, type ClaimResult, type CodeReviewInput, type CodeReviewOutcome, type CodingAgentAdapter, type CodingAgentHandlerResult, type CodingAgentRequest, type CodingAgentResult, type CommandResult, type CommandRunOptions, type CommandRunner, type CompatibilityComponent, type CompatibilityComponentId, type CompatibilityManifest, type CompatibilityObservation, type CompatibilityReport, type CompatibilityStatus, type ContextProvider, type ContextQuery, type ContextReference, type ContextSnapshot, type ContractAssessment, type ContractOutcome, ContractOutcomeSchema, type ContractScope, type CooldownEntry, type CooldownState, type CoordinationIdentity, type CriterionStatus, type CycleIterationMetrics, type CycleMatrixRow, type CycleStepResult, type CycleStepStatus, type DebriefInput, type DebriefIssueRow, type DebriefReport, type DecisionPacket, type DeliverInput, type DeliverOutcome, type DeliverReport, type DeliverResult, type DeliveryState, type DetectProvidersInput, type DiscoveryAmbiguity, type DiscoveryCurrentInput, type DiscoveryCurrentResult, type DiscoveryDecisionLogEntry, type DiscoveryInput, type DiscoveryOption, type DiscoveryResult, type DispatchLease, type DispatchLedger, type DispatchRecord, type DispatchRecordFile, type Disposer, type DocBridgeIndexInspection, type DockerMount, type DockerRuntimeEvidence, type DockerToolDefinition, type DoctorCheck, type DoctorCheckStatus, EVAL_COMPONENTS, EVAL_LAYERS, EVAL_MANIFEST_SCHEMA_VERSION, EVENT_LOG_GENESIS, EVIDENCE_BUNDLE_SCHEMA_VERSION, type EvalBatteryReport, type EvalCaseDefinition, type EvalCaseReport, type EvalComponent, type EvalExpectation, type EvalLayer, type EvalManifest, type EvalObservation, type EvalObservationStatus, type EventLogLock, type EventLogLockRecovery, type EventLogLockStatus, type EventLogVerification, type EventStore, type EvidenceArtifact, type EvidenceBundle, type EvidenceBundleFile, type EvidenceBundleSignature, type EvidenceBundleVerification, type EvidenceReference, type ExecutePhaseProfileOptions, type FailureClass, type FailureClassification, type FetchQueueInput, FileArtifactStore, FileEventStore, type FilePreflightPlan, type GateAssessment, type GateBinding, type GateCriterion, type GenerateContractInput, type GitHubCliOptions, type GuidedInstallIO, type GuidedInstallInput, type GuidedInstallReport, HARNESS_ERROR_CATALOG, HARNESS_ERROR_CODES, HARNESS_EVENT_ENVELOPE_SCHEMA_VERSION, HARNESS_EVENT_SCHEMA_VERSION, HARNESS_EVENT_TYPES, HARNESS_PLUGIN_API_VERSION, HARNESS_REPO_URL, type HandoffBriefInput, HarnessError, type HarnessErrorClassification, type HarnessErrorDisposition, type HarnessEvent, type HarnessEventContext, type HarnessEventEnvelope, type HarnessEventEnvelopeInput, type HarnessEventInput, type HarnessEventListener, type HarnessEventPayloads, type HarnessEventProvenance, type HarnessEventType, type HarnessPlugin, type HarnessPluginContext, IMPROVEMENT_CYCLE_STEPS, type ImprovementCycleAssessment, type ImprovementCycleInput, type ImprovementCycleIteration, type ImprovementCycleStep, type InstallAction, type InstallInput, type InstallReport, LEARNING_STATUSES, LEGAL_TRANSITIONS, LOOP_CONFIG_FILE, LOOP_CONFIG_SCHEMA_VERSION, LOOP_LOCAL_CONFIG_FILE, LOOP_STAGES, type LearningRecord, type LearningStatus, type LearningsLedger, type LinearIssueDetail, type LinearListInput, type LinearQueueFilter, type LinearWriteOptions, type LlmCache, type LlmCacheKeyInput, type LlmCacheStats, type LoadedConfig, type LoadedLoopConfig, type LocalConfigAnswers, type LocalConfigPrompter, type LoopConfig, type LoopConfigInput, LoopConfigSchema, type LoopDoctorInput, type LoopDoctorReport, type LoopEvent, type LoopIssue, type LoopProviderConfig, type LoopStage, type LoopState, type LoopStatusReport, MEMORY_SCOPES, MODEL_ROLES, type MachineMetrics, type MachineSample, type MachineThresholds, type McpPolicy, type McpToolBridge, type McpToolBridgeOptions, type McpToolCallInput, type McpToolCallResult, type MemoryContextPlan, type MemoryPromptSelection, type MemoryScope, type MemoryUsage, type MetricStatus, type ModelBinding, type ModelPolicy, type ModelQuality, type ModelReference, type ModelRole, type NormalizedPhaseProfile, type OptimizationComparison, type OptimizationObservation, type OrcaAgentHookState, type OrcaAutomation, type OrcaAutomationSpec, type OrcaCliOptions, type OrcaCreatedWorktree, type OrcaDispatchInput, type OrcaDispatchPlan, type OrcaLeaseState, type OrcaLifecycleInput, type OrcaLifecycleProjection, type OrcaStatus as OrcaRuntimeStatus, type OrcaSendReceipt, type OrcaTerminal, type OrcaWorktree, PHASE_DECISIONS, PHASE_EFFECTS, PHASE_EFFECT_ACTIONS, PHASE_MODES, PR_FIELDS, type ParallelismUsage, type PhaseAmbiguity, type PhaseContext, type PhaseDecision, type PhaseDecisionPacket, type PhaseDefinition, type PhaseEffect, type PhaseEffectAction, type PhaseEffectPolicy, type PhaseExecution, type PhaseExecutionReport, type PhaseGateEvaluator, type PhaseGateResult, type PhaseHandler, type PhaseHandlerResult, type PhaseMachineMetrics, type PhaseMode, type PhasePreflight, type PhasePreflightResult, type PhaseProfile, type PhaseResumeState, type PhaseRetryPolicy, type PhaseRoutePlan, type PhaseTelemetry, type PhaseTokenMetrics, type PilotAssessment, type PilotEntry, type PilotManifest, type PluginContribution, type PluginRegistry, type PluginSlot, type PolicyDecision, type PolicyGate, type PolicyRequest, type PolicyRule, type ProcessToolDefinition, type ProductionEvidence, type ProviderAuthStatus, type ProviderAvailability, type ProviderCatalog, type ProviderFailure, type ProviderSpec, type ProviderUsage, type PullRequestApproval, type PullRequestCheck, type PullRequestDraft, type PullRequestSnapshot, QUALITY_DIMENSIONS, type QaTransitionAssessment, type QualityDimension, type QualityDimensionScore, type QualityMatrix, REVIEW_SEVERITIES, RUN_STATES, type RagContextProviderOptions, type RagQueryResult, type RankedModel, type RecoveryObservation, type RecoveryPolicy, type RecoveryResult, type RepositoryProfile, type ResolvedAgent, type RetroInput, type RetroIssueRow, type RetroReport, type RetroStageReport, type RetroSuggestion, type RetroTarget, type RetroWindow, type ReviewFinding, type ReviewLens, type ReviewSeverity, type ReviewVerdict, type RichIO, type RoutingDecision, type RoutingSkip, type RunOutcome, type RunReconciliation, type RunState, type RuntimeConfig, type RuntimeExperimentCandidate, type RuntimeExperimentResult, STATES, SURFACE_NAMES, type SessionRecorder, type SlotAssessment, type SlotInput, type SourceSnapshot, type StateTransition, type StatusBlock, type StatusSnapshot, type StoredContract, type StructuredEvidence, type SurfaceName, type SurfaceRequirement, type TaskContract, TaskContractSchema, type TeamMember, type TickCandidateResult, type TickInput, type TickOutcome, type TickReport, type TokenUsage, type ToolDefinition, type ToolExecutionRequest, type ToolExecutionResult, type ToolRuntime, type TrackingAdapter, type TrackingConfig, type TrackingTransition, type TrustedEvidenceKey, type UsageMetric, type UsageWindow, type VerificationCheck, type VerificationConfig, type VerificationRun, WIP_STATES, type WatchEvent, type WatchEventKind, type WatchInput, type WatchReport, type WatchTargetSnapshot, type WatchdogBlocker, type WatchdogBudget, type WatchdogResult, type WipAssessment, type WipAssessmentInput, type WipEntry, type WipState, type WorkerBriefInput, type WorkflowNode, type WorkflowResult, activeCooldowns, adaptiveConcurrency, appendLoopEvent, approveRun, approvedDecision, artifactDigest, artifactFilePath, artifactIsFresh, artifactMarkdownPath, assertHuman, assessAcceptance, assessAgentEval, assessBlock, assessChecks, assessCompatibility, assessContract, assessDiscovery, assessImprovementCycle, assessIntegration, assessPilot, assessPreflight, assessProduction, assessQaTransition, assessSlots, assessWip, assessWorktreeCleanup, atLeast, authStatusFor, authorizeRun, automationName, automationPrompt, automationSpecs, availableMemoryBytes, benchmarkRuns, branchFor, buildDebriefReport, buildListIssuesArgv, buildRetroReport, buildReviewArgv, buildSuggestions, busyIssues, cancelRun, classifyFailure, classifyHarnessError, classifyProviderFailure, classifyWatchEvent, classifyWatchPhase, cleanTaskArtifacts, clearProviderCooldown, compareOptimization, compareVersions, composePullRequest, contractIsFresh, contractPath, cooldownPath, cooldownUntil, countRunningWorkers, createArgvRagContextProvider, createArtifactEnvelope, createCapabilityManifest, createCodingAgentAdapter, createCompatibilityManifest, createConfiguredToolRuntime, createDispatchLedger, createDocBridgeContextProvider, createDockerToolRuntime, createEvalManifest, createFileMemoryAdapter, createFileMemoryKvStore, createHarnessEventEnvelope, createInMemoryMemoryAdapter, createKvMemoryAdapter, createLinearTrackingAdapter, createLlmCache, createLlmCacheKey, createMachineMonitor, createMcpToolBridge, createModelPolicy, createOrcaDispatchPlan, createOrcaLifecycleProjection, createPhaseArtifact, createPhaseProfile, createPluginRegistry, createPluginSlot, createPolicyGate, createProcessRunner, createProcessToolRuntime, createPullRequestApproval, createQualityMatrix, createRagContextProvider, createRichIO, createSessionRecorder, createStatusSnapshot, createToolRuntime, createTrackingAdapter, createTrackingTransition, deliveryStatePath, detectProviders, dispatchRecordPath, evaluateWatchdog, executePhaseProfile, exportEvidenceBundle, fetchArtificialAnalysisModels, fetchLinearIssue, fetchLinearQueue, fetchTeamMembers, filterAndOrderQueue, findExecutable, formatWatchEvent, gatherLoopState, generateContract, githubComment, githubCommentArgv, githubCommentExists, githubMerge, githubMergeArgv, githubOpenPullRequests, githubPullRequest, githubPullRequestsForBranch, hasLocalConfig, hashContextSnapshot, hashContextSnapshots, hashMcpArgs, inspectDocBridgeIndex, inspectEventLogLock, installLoopAutomations, installPreflight, isDiscoveryCurrent, isWsl, launchWorkerTerminal, learningToMemoryRecord, learningsPath, linearAttach, linearAttachArgv, linearCommentAdd, linearCommentAddArgv, linearLabelAdd, linearLabelArgv, linearLabelRemove, linearStatusSet, linearStatusSetArgv, listCliModels, listDispatched, loadAgentRegistry, loadAliases, loadBenchmarkManifest, loadBuiltinCatalog, loadConfig, loadLatestRun, loadLoopConfig, localConfigPath, loopStatus, markProviderExhausted, memoryDigestOf, mergeLoopConfig, modelFor, normalizeReason, openLoopMemory, orcaAccountList, orcaAgentHooks, orcaAutomationCreateArgv, orcaAutomationEditArgv, orcaAutomationRemove, orcaAutomationRun, orcaAutomationRuns, orcaAutomationsList, orcaJson, orcaStatus, orcaTerminalCreate, orcaTerminalList, orcaTerminalScreen, orcaTerminalSend, orcaTerminalWait, orcaVersion, orcaWorktreeCreate, orcaWorktreeRemove, orcaWorktreeSet, orcaWorktreeSetArgv, orcaWorktrees, parseAgentRegistryText, parseArtificialAnalysisPayload, parseAutomationRuns, parseContractOutput, parseGrokModelsOutput, parseJsonEnvelope, parseLinearIssueDetail, parseLinearIssues, parseLoopConfigText, parseMemInfo, parseModelRef, parseOrcaAgentHooks, parseOrcaAutomations, parseOrcaSendReceipt, parseOrcaStatus, parseOrcaTerminals, parseOrcaVersion, parseOrcaWorktreeCreate, parseOrcaWorktrees, parseProviderUsage, parsePullRequest, parseRagQueryOutput, parseRetro, parseReviewResult, parseSince, parseTeamMembers, parseUsageWindows, parseVmStat, planFilePreflight, planMemoryContext, planPhaseProfile, planRun, precheckCommand, precheckDeliver, precheckTick, preferMemoryOverDocBridge, promoteLearnings, promoteLearningsToMemory, promptLocalConfig, providerIdentity, providerSpecs, rankModels, readAaCache, readArtifactFile, readContextSnapshots, readCooldowns, readDeliveryState, readDispatchRecord, readEvidenceTrustStore, readLearningsLedger, readLoopEvents, readStoredContract, reconcileRun, recordBenchmarkObservation, recoverEventLogLock, recoveryDelayMs, remainingUsagePercent, renderArtifactMarkdown, renderContractPrompt, renderDebriefMarkdown, renderFindingsForWorker, renderHandoffBrief, renderHeadlessArgv, renderLocalConfig, renderRetroMarkdown, renderTuiCommand, renderWorkerBrief, resolveAgentForRole, resolveAlias, resolveCatalogCandidates, resolveDocContext, resumeStateFromArtifacts, retroLearnings, retryRun, routeAllRoles, runAdversarialReview, runAgentEval, runCodeReview, runDeliver, runEvalBattery, runGuidedInstall, runLoopDoctor, runRetroStage, runTick, runWithRecovery, runWorkflow, sampleMachine, selectMemoryForPrompt, selectModel, selectRuntime, severityRank, shellQuote, snapshotWatchTargets, startRun, summarizeMachine, tiersFor, touchesProtectedPaths, transition, undeclaredOrcaProviders, uninstallLoopAutomations, unknownTelemetry, untrusted, upsertProposedLearnings, usageRankTuple, validateAdapterMetadata, validateArtifactEnvelope, validateBenchmarkManifest, validateBlockManifest, validateCacheableOperation, validateCapabilityManifest, validateCompatibilityManifest, validateConfig, validateContextSnapshot, validateContextSnapshots, validateEvalManifest, validateHarnessErrorClassification, validateHarnessEventEnvelope, validateLoopConfig, validateMemoryRecord, validateOptimizationObservation, validatePhaseTelemetry, validateSafeCommand, validateStatusSnapshot, verifyEvidenceBundle, verifyPullRequestApproval, verifyRun, watchDeliveries, worktreeNameFor, writeAaCache, writeDispatchRecord, writeIdFor, writeLearningsLedger, writeLocalConfig, writeStoredContract };
+/** One recorded failure for an issue, kept for diagnostics (`loop retro`, `loop status`). */
+interface IssueFailureRecord {
+    readonly kind: string;
+    readonly at: string;
+    readonly reason: string;
+}
+interface IssueFailureState {
+    readonly issue: string;
+    /** Consecutive failures since the last success (dispatch, clean/findings review, merge). Resets to 0 on any of those. */
+    readonly consecutive: number;
+    /** Most recent failures first, capped at 10 — enough for a human to see the pattern without the file growing unbounded. */
+    readonly history: readonly IssueFailureRecord[];
+    readonly pausedAt: string | null;
+    readonly pausedReason: string | null;
+}
+declare const issueFailurePath: (stateDir: string, issue: string) => string;
+declare const readIssueFailures: (stateDir: string, issue: string) => IssueFailureState;
+/**
+ * Record one failure for an issue and return the updated state. Callers decide, from `consecutive`, whether the
+ * `maxConsecutiveFailures` threshold was just crossed and the issue should be paused (see `pauseIssue`).
+ */
+declare const recordIssueFailure: (stateDir: string, issue: string, kind: string, reason: string, now?: Date) => IssueFailureState;
+/** Clear the consecutive-failure counter (and any pause) after progress: a successful dispatch, a clean/findings review, or a merge. */
+declare const clearIssueFailures: (stateDir: string, issue: string) => void;
+declare const pauseIssue: (stateDir: string, issue: string, reason: string, now?: Date) => IssueFailureState;
+/** Manual or label-driven resume: clears the pause and the counter so the issue gets a clean slate; history is kept. */
+declare const resumeIssue: (stateDir: string, issue: string) => IssueFailureState;
+declare const isIssuePaused: (stateDir: string, issue: string) => boolean;
+/** All paused issues under `<stateDir>/issues/*\/failures.json`, for `loop status`/`loop retro`. */
+declare const listPausedIssues: (stateDir: string) => readonly IssueFailureState[];
+type LoopStageName = 'tick' | 'deliver';
+interface StagePauseEntry {
+    readonly consecutiveFailures: number;
+    readonly lastFailureAt: string | null;
+    readonly lastReason: string | null;
+    readonly pausedAt: string | null;
+    readonly pausedReason: string | null;
+}
+type StagePauseState = Partial<Record<LoopStageName, StagePauseEntry>>;
+declare const stagePausePath: (stateDir: string) => string;
+declare const readStagePause: (stateDir: string) => StagePauseState;
+declare const stageEntry: (stateDir: string, stage: LoopStageName) => StagePauseEntry;
+declare const isStagePaused: (stateDir: string, stage: LoopStageName) => boolean;
+/**
+ * Record the outcome of one `loop stage` run. A thrown exception is a failure; anything that returns a report
+ * (including an idle/no-op tick) is a success and clears both the counter and any existing pause. Crossing
+ * `threshold` consecutive failures pauses the stage; the caller (`loop stage`) checks `isStagePaused` up front and
+ * skips the actual run while paused, so a crash loop cannot spend budget or provider usage.
+ */
+declare const recordStageRunResult: (stateDir: string, stage: LoopStageName, outcome: {
+    readonly succeeded: true;
+} | {
+    readonly succeeded: false;
+    readonly reason: string;
+}, threshold: number, now?: Date) => StagePauseEntry;
+declare const resumeStage: (stateDir: string, stage: LoopStageName) => void;
+
+/** A GitHub PR the loop never dispatched, picked up only because it carries `github.intakeLabel`. */
+interface IntakeRecord {
+    readonly pr: number;
+    readonly headRef: string;
+    readonly source: 'github-label';
+    readonly addedAt: string;
+}
+/** The synthetic "issue" identifier intake state is filed under (`<stateDir>/issues/pr-<n>/…`) — there is no Linear issue for these. */
+declare const intakeIssueId: (pr: number) => string;
+declare const intakePath: (stateDir: string, pr: number) => string;
+declare const readIntake: (stateDir: string, pr: number) => IntakeRecord | null;
+/** Every PR currently tracked as intake (label may since have been removed on GitHub — `runDeliver` notices that separately). */
+declare const listIntake: (stateDir: string) => readonly IntakeRecord[];
+/**
+ * List every open PR carrying `github.intakeLabel` and start tracking the ones not seen before. Idempotent: a PR
+ * already tracked (or already a normal loop dispatch — same repo, so `pr-<n>` cannot collide with a Linear
+ * identifier) is left alone; `runDeliver` handles it from state on every later call, not from this discovery.
+ */
+declare const discoverIntake: (runner: CommandRunner, input: {
+    readonly repo: string;
+    readonly label: string;
+    readonly stateDir: string;
+    readonly now: () => Date;
+}, options?: GitHubCliOptions) => Promise<readonly IntakeRecord[]>;
+
+export { AGENT_REGISTRY_SCHEMA_VERSION, ARTIFACT_SCHEMA_VERSION, ARTIFACT_TYPES, ASSURANCE_LEVELS, type AdapterMetadata, type AdapterTelemetry, type AdversarialReviewResult, type AgentAdapter, type AgentEvalCase, type AgentEvalReport, type AgentEvalSuite, type AgentMemoryAdapter, type AgentMemoryHit, type AgentMemoryKvStore, type AgentMemoryRecord, type AgentRegistry, type AgentRegistryEntry, AgentRegistryEntrySchema, AgentRegistrySchema, type AgentSessionOptions, type AgentUsage, type ApprovedAssumption, type ArgvRagContextProviderOptions, type ArtifactBinding, type ArtifactEnvelope, type ArtifactEnvelopeInput, type ArtifactType, type ArtificialAnalysisModel, type AssuranceLevel, type AutomationStatus, type AutonomyMode, BENCHMARK_SCHEMA_VERSION, BLOCK_STATUSES, type BenchmarkBinding, type BenchmarkComparison, type BenchmarkImprovementDirection, type BenchmarkManifest, type BenchmarkObservation, type BenchmarkObservationEvidence, type BenchmarkObservationInput, type BenchmarkObservationStatus, type BenchmarkReport, type BenchmarkRun, type BenchmarkSummary, type BenchmarkTask, type BlockAssessment, type BlockManifest, type BlockStatus, CAPABILITY_KINDS, CAPABILITY_MANIFEST_SCHEMA_VERSION, CHECK_CATEGORIES, COMPATIBILITY_COMPONENTS, COMPATIBILITY_SCHEMA_VERSION, CONTEXT_PROVIDER_SLOT, CONTRACT_CLOSE, CONTRACT_OPEN, CONTRACT_SCHEMA_VERSION, type CacheUsage, type CapabilityDescriptor, type CapabilityKind, type CapabilityManifest, type CapabilityManifestInput, type CatalogModel, type ChangedFile, type CheckCategory, type CheckOutcome, type CheckResult, type ChecksAssessment, type ClaimResult, type CodeReviewInput, type CodeReviewOutcome, type CodingAgentAdapter, type CodingAgentHandlerResult, type CodingAgentRequest, type CodingAgentResult, type CommandResult, type CommandRunOptions, type CommandRunner, type CompatibilityComponent, type CompatibilityComponentId, type CompatibilityManifest, type CompatibilityObservation, type CompatibilityReport, type CompatibilityStatus, type ContextProvider, type ContextQuery, type ContextReference, type ContextSnapshot, type ContractAssessment, type ContractOutcome, ContractOutcomeSchema, type ContractScope, type CooldownEntry, type CooldownState, type CoordinationIdentity, type CriterionStatus, type CycleIterationMetrics, type CycleMatrixRow, type CycleStepResult, type CycleStepStatus, type DebriefInput, type DebriefIssueRow, type DebriefReport, type DecisionPacket, type DeliverInput, type DeliverOutcome, type DeliverReport, type DeliverResult, type DeliveryState, type DetectProvidersInput, type DiscoveryAmbiguity, type DiscoveryCurrentInput, type DiscoveryCurrentResult, type DiscoveryDecisionLogEntry, type DiscoveryInput, type DiscoveryOption, type DiscoveryResult, type DispatchLease, type DispatchLedger, type DispatchRecord, type DispatchRecordFile, type Disposer, type DocBridgeIndexInspection, type DockerMount, type DockerRuntimeEvidence, type DockerToolDefinition, type DoctorCheck, type DoctorCheckStatus, EVAL_COMPONENTS, EVAL_LAYERS, EVAL_MANIFEST_SCHEMA_VERSION, EVENT_LOG_GENESIS, EVIDENCE_BUNDLE_SCHEMA_VERSION, type EffortLevel, type EvalBatteryReport, type EvalCaseDefinition, type EvalCaseReport, type EvalComponent, type EvalExpectation, type EvalLayer, type EvalManifest, type EvalObservation, type EvalObservationStatus, type EventLogLock, type EventLogLockRecovery, type EventLogLockStatus, type EventLogVerification, type EventStore, type EvidenceArtifact, type EvidenceBundle, type EvidenceBundleFile, type EvidenceBundleSignature, type EvidenceBundleVerification, type EvidenceReference, type ExecutePhaseProfileOptions, type FailureClass, type FailureClassification, type FetchQueueInput, FileArtifactStore, FileEventStore, type FilePreflightPlan, type GateAssessment, type GateBinding, type GateCriterion, type GenerateContractInput, type GitHubCliOptions, type GuidedInstallIO, type GuidedInstallInput, type GuidedInstallReport, HARNESS_ERROR_CATALOG, HARNESS_ERROR_CODES, HARNESS_EVENT_ENVELOPE_SCHEMA_VERSION, HARNESS_EVENT_SCHEMA_VERSION, HARNESS_EVENT_TYPES, HARNESS_PLUGIN_API_VERSION, HARNESS_REPO_URL, type HandoffBriefInput, HarnessError, type HarnessErrorClassification, type HarnessErrorDisposition, type HarnessEvent, type HarnessEventContext, type HarnessEventEnvelope, type HarnessEventEnvelopeInput, type HarnessEventInput, type HarnessEventListener, type HarnessEventPayloads, type HarnessEventProvenance, type HarnessEventType, type HarnessPlugin, type HarnessPluginContext, IMPROVEMENT_CYCLE_STEPS, type ImprovementCycleAssessment, type ImprovementCycleInput, type ImprovementCycleIteration, type ImprovementCycleStep, type InstallAction, type InstallInput, type InstallReport, type IntakeRecord, type IssueFailureRecord, type IssueFailureState, LEARNING_STATUSES, LEGAL_TRANSITIONS, LOOP_CONFIG_FILE, LOOP_CONFIG_SCHEMA_VERSION, LOOP_LOCAL_CONFIG_FILE, LOOP_STAGES, type LearningRecord, type LearningStatus, type LearningsLedger, type LinearIssueDetail, type LinearListInput, type LinearQueueFilter, type LinearWriteOptions, type LlmCache, type LlmCacheKeyInput, type LlmCacheStats, type LoadedConfig, type LoadedLoopConfig, type LocalConfigAnswers, type LocalConfigPrompter, type LoopConfig, type LoopConfigInput, LoopConfigSchema, type LoopDoctorInput, type LoopDoctorReport, type LoopEvent, type LoopEventBus, type LoopEventListener, type LoopEventPayload, type LoopHookListener, type LoopHookName, type LoopHookPayload, type LoopHookResult, type LoopIssue, type LoopPluginModule, type LoopProviderConfig, type LoopStage, type LoopStageName, type LoopState, type LoopStatusReport, MEMORY_SCOPES, MODEL_ROLES, type MachineMetrics, type MachineSample, type MachineThresholds, type McpPolicy, type McpToolBridge, type McpToolBridgeOptions, type McpToolCallInput, type McpToolCallResult, type MemoryContextPlan, type MemoryPromptSelection, type MemoryScope, type MemoryUsage, type MetricStatus, type ModelBinding, type ModelPolicy, type ModelQuality, type ModelReference, type ModelRole, type NormalizedPhaseProfile, type OptimizationComparison, type OptimizationObservation, type OrcaAgentHookState, type OrcaAutomation, type OrcaAutomationSpec, type OrcaCliOptions, type OrcaCreatedWorktree, type OrcaDispatchInput, type OrcaDispatchPlan, type OrcaLeaseState, type OrcaLifecycleInput, type OrcaLifecycleProjection, type OrcaStatus as OrcaRuntimeStatus, type OrcaSendReceipt, type OrcaTerminal, type OrcaWorktree, type OutcomeProgress, type OutcomeProgressStatus, PHASE_DECISIONS, PHASE_EFFECTS, PHASE_EFFECT_ACTIONS, PHASE_MODES, PR_FIELDS, type ParallelismUsage, type PhaseAmbiguity, type PhaseContext, type PhaseDecision, type PhaseDecisionPacket, type PhaseDefinition, type PhaseEffect, type PhaseEffectAction, type PhaseEffectPolicy, type PhaseExecution, type PhaseExecutionReport, type PhaseGateEvaluator, type PhaseGateResult, type PhaseHandler, type PhaseHandlerResult, type PhaseMachineMetrics, type PhaseMode, type PhasePreflight, type PhasePreflightResult, type PhaseProfile, type PhaseResumeState, type PhaseRetryPolicy, type PhaseRoutePlan, type PhaseTelemetry, type PhaseTokenMetrics, type PiiKind, type PiiMatch, type PiiScanResult, type PilotAssessment, type PilotEntry, type PilotManifest, type PinnedSkill, type PinnedSkillRef, type PluginContribution, type PluginRegistry, type PluginSlot, type PolicyDecision, type PolicyGate, type PolicyRequest, type PolicyRule, type ProcessToolDefinition, type ProductionEvidence, type ProviderAuthStatus, type ProviderAvailability, type ProviderCatalog, type ProviderFailure, type ProviderSpec, type ProviderUsage, type PullRequestApproval, type PullRequestCheck, type PullRequestDraft, type PullRequestSnapshot, QUALITY_DIMENSIONS, type QaTransitionAssessment, type QualityDimension, type QualityDimensionScore, type QualityMatrix, REVIEW_SEVERITIES, RUN_STATES, type RagContextProviderOptions, type RagQueryResult, type RankedModel, type RecoveryObservation, type RecoveryPolicy, type RecoveryResult, type RepositoryProfile, type ResolvedAgent, type RetroInput, type RetroIssueRow, type RetroReport, type RetroStageReport, type RetroSuggestion, type RetroTarget, type RetroWindow, type ReviewFinding, type ReviewLens, type ReviewSeverity, type ReviewVerdict, type RichIO, type RoutingDecision, type RoutingSkip, type RunOutcome, type RunReconciliation, type RunState, type RuntimeConfig, type RuntimeExperimentCandidate, type RuntimeExperimentResult, STATES, SURFACE_NAMES, type SessionRecorder, type SlotAssessment, type SlotInput, type SourceSnapshot, type StagePauseEntry, type StagePauseState, type StateTransition, type StatusBlock, type StatusSnapshot, type StoredContract, type StructuredEvidence, type SurfaceName, type SurfaceRequirement, type TaskContract, TaskContractSchema, type TeamMember, type TickCandidateResult, type TickInput, type TickOutcome, type TickReport, type TokenUsage, type ToolDefinition, type ToolExecutionRequest, type ToolExecutionResult, type ToolRuntime, type TrackingAdapter, type TrackingConfig, type TrackingTransition, type TrustedEvidenceKey, type UsageMetric, type UsageWindow, type VerificationCheck, type VerificationConfig, type VerificationRun, WIP_STATES, type WatchEvent, type WatchEventKind, type WatchInput, type WatchReport, type WatchTargetSnapshot, type WatchdogBlocker, type WatchdogBudget, type WatchdogResult, type WipAssessment, type WipAssessmentInput, type WipEntry, type WipState, type WorkerBriefInput, type WorkflowNode, type WorkflowResult, activeCooldowns, adaptiveConcurrency, advanceQueueOwner, appendLoopEvent, approveRun, approvedDecision, artifactDigest, artifactFilePath, artifactIsFresh, artifactMarkdownPath, assertHuman, assessAcceptance, assessAgentEval, assessBlock, assessChecks, assessCompatibility, assessContract, assessDiscovery, assessImprovementCycle, assessIntegration, assessPilot, assessPreflight, assessProduction, assessQaTransition, assessSlots, assessWip, assessWorktreeCleanup, atLeast, authStatusFor, authorizeRun, automationName, automationPrompt, automationSpecs, availableMemoryBytes, benchmarkRuns, branchFor, briefPath, buildDebriefReport, buildListIssuesArgv, buildRetroReport, buildReviewArgv, buildSuggestions, busyIssues, cancelRun, classifyFailure, classifyHarnessError, classifyProviderFailure, classifyWatchEvent, classifyWatchPhase, cleanTaskArtifacts, clearIssueFailures, clearProviderCooldown, compareOptimization, compareVersions, composePullRequest, contractIsFresh, contractPath, cooldownPath, cooldownUntil, countRunningWorkers, createArgvRagContextProvider, createArtifactEnvelope, createCapabilityManifest, createCodingAgentAdapter, createCompatibilityManifest, createConfiguredToolRuntime, createDispatchLedger, createDocBridgeContextProvider, createDockerToolRuntime, createEvalManifest, createFileMemoryAdapter, createFileMemoryKvStore, createHarnessEventEnvelope, createInMemoryMemoryAdapter, createKvMemoryAdapter, createLinearTrackingAdapter, createLlmCache, createLlmCacheKey, createLoopEventBus, createMachineMonitor, createMcpToolBridge, createModelPolicy, createOrcaDispatchPlan, createOrcaLifecycleProjection, createPhaseArtifact, createPhaseProfile, createPluginRegistry, createPluginSlot, createPolicyGate, createProcessRunner, createProcessToolRuntime, createPullRequestApproval, createQualityMatrix, createRagContextProvider, createRichIO, createSessionRecorder, createStatusSnapshot, createToolRuntime, createTrackingAdapter, createTrackingTransition, deliveryStatePath, detectProviders, discoverIntake, dispatchRecordPath, evaluateWatchdog, executePhaseProfile, exportEvidenceBundle, extractResetsAt, fetchArtificialAnalysisModels, fetchLinearIssue, fetchLinearQueue, fetchTeamMembers, filterAndOrderQueue, findExecutable, formatWatchEvent, gatherLoopState, generateContract, githubComment, githubCommentArgv, githubCommentExists, githubLabelRemove, githubMerge, githubMergeArgv, githubOpenPullRequests, githubPullRequest, githubPullRequestsForBranch, hasLocalConfig, hashContextSnapshot, hashContextSnapshots, hashMcpArgs, inspectDocBridgeIndex, inspectEventLogLock, installLoopAutomations, installPreflight, intakeIssueId, intakePath, isDiscoveryCurrent, isIssuePaused, isStagePaused, isWsl, issueFailurePath, launchWorkerTerminal, learningToMemoryRecord, learningsPath, linearAttach, linearAttachArgv, linearCommentAdd, linearCommentAddArgv, linearLabelAdd, linearLabelArgv, linearLabelRemove, linearStatusSet, linearStatusSetArgv, listCliModels, listDispatched, listIntake, listPausedIssues, loadAgentRegistry, loadAliases, loadBenchmarkManifest, loadBuiltinCatalog, loadConfig, loadLatestRun, loadLoopConfig, loadLoopPlugins, loadPinnedSkills, localConfigPath, loopStatus, markProviderExhausted, memoryDigestOf, mergeLoopConfig, modelFor, normalizeReason, openLoopMemory, orcaAccountList, orcaAgentHooks, orcaAutomationCreateArgv, orcaAutomationEditArgv, orcaAutomationRemove, orcaAutomationRun, orcaAutomationRuns, orcaAutomationsList, orcaJson, orcaStatus, orcaTerminalCreate, orcaTerminalList, orcaTerminalScreen, orcaTerminalSend, orcaTerminalWait, orcaVersion, orcaWorktreeCreate, orcaWorktreeRemove, orcaWorktreeSet, orcaWorktreeSetArgv, orcaWorktrees, parseAgentRegistryText, parseArtificialAnalysisPayload, parseAutomationRuns, parseContractOutput, parseGrokModelsOutput, parseJsonEnvelope, parseLinearIssueDetail, parseLinearIssues, parseLoopConfigText, parseMemInfo, parseModelRef, parseOrcaAgentHooks, parseOrcaAutomations, parseOrcaSendReceipt, parseOrcaStatus, parseOrcaTerminals, parseOrcaVersion, parseOrcaWorktreeCreate, parseOrcaWorktrees, parseProviderUsage, parsePullRequest, parseRagQueryOutput, parseRetro, parseReviewResult, parseSince, parseTeamMembers, parseUsageWindows, parseVmStat, pauseIssue, planFilePreflight, planMemoryContext, planPhaseProfile, planRun, precheckCommand, precheckDeliver, precheckTick, preferMemoryOverDocBridge, promoteLearnings, promoteLearningsToMemory, promptLocalConfig, providerIdentity, providerSpecs, queueOwner, rankModels, readAaCache, readArtifactFile, readContextSnapshots, readCooldowns, readDeliveryState, readDispatchRecord, readEvidenceTrustStore, readIntake, readIssueFailures, readLearningsLedger, readLoopEvents, readOutcomeProgress, readStagePause, readStoredContract, reconcileRun, recordBenchmarkObservation, recordIssueFailure, recordStageRunResult, recoverEventLogLock, recoveryDelayMs, remainingUsagePercent, renderArtifactMarkdown, renderContractPrompt, renderDebriefMarkdown, renderFindingsForWorker, renderHandoffBrief, renderHeadlessArgv, renderLocalConfig, renderPinnedSkills, renderRetroMarkdown, renderTuiCommand, renderWorkerBrief, resolveAgentForRole, resolveAlias, resolveCatalogCandidates, resolveDocContext, resumeIssue, resumeStage, resumeStateFromArtifacts, retroLearnings, retryRun, rotationStatePath, routeAllRoles, runAdversarialReview, runAgentEval, runCodeReview, runDeliver, runEvalBattery, runGuidedInstall, runLoopDoctor, runRetroStage, runTick, runWithRecovery, runWorkflow, sampleMachine, scanForPii, selectMemoryForPrompt, selectModel, selectRuntime, severityRank, shellQuote, skillDigest, skillRefs, snapshotWatchTargets, stageEntry, stagePausePath, startRun, summarizeMachine, tiersFor, touchesProtectedPaths, transition, undeclaredOrcaProviders, uninstallLoopAutomations, unknownTelemetry, untrusted, upsertProposedLearnings, usageRankTuple, validateAdapterMetadata, validateArtifactEnvelope, validateBenchmarkManifest, validateBlockManifest, validateCacheableOperation, validateCapabilityManifest, validateCompatibilityManifest, validateConfig, validateContextSnapshot, validateContextSnapshots, validateEvalManifest, validateHarnessErrorClassification, validateHarnessEventEnvelope, validateLoopConfig, validateMemoryRecord, validateOptimizationObservation, validatePhaseTelemetry, validateSafeCommand, validateStatusSnapshot, verifyEvidenceBundle, verifyPullRequestApproval, verifyRun, watchDeliveries, worktreeNameFor, writeAaCache, writeDispatchRecord, writeIdFor, writeLearningsLedger, writeLocalConfig, writeStoredContract };