@agentskit/harness 0.9.0 → 0.11.0

package/dist/index.d.ts

@@ -734,6 +734,9 @@ declare const validateCapabilityManifest: (value: unknown) => CapabilityManifest
 interface DocBridgeContextProviderOptions {
     readonly root: string;
     readonly indexPath?: string;
+    /** Reject indexes older than this many hours; 0 or undefined disables the age guard. */
+    readonly maxAgeHours?: number;
+    readonly now?: () => number;
 }
 interface DocBridgeIndexInspection {
     readonly present: boolean;
@@ -745,7 +748,7 @@ interface DocBridgeIndexInspection {
 }
 /** Read-only inspection for doctor freshness checks (no network, no rebuild). */
 declare const inspectDocBridgeIndex: (root: string, indexPath?: string, now?: number) => DocBridgeIndexInspection;
-declare const createDocBridgeContextProvider: ({ root, indexPath }: DocBridgeContextProviderOptions) => ContextProvider;
+declare const createDocBridgeContextProvider: ({ root, indexPath, maxAgeHours, now }: DocBridgeContextProviderOptions) => ContextProvider;
 
 interface CommandResult {
     readonly code: number | null;
@@ -2232,6 +2235,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;
@@ -2640,6 +2664,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>>;
@@ -2725,6 +2754,7 @@ declare const LoopConfigSchema: z.ZodObject<{
                 "artificial-analysis": "artificial-analysis";
                 builtin: "builtin";
             }>>>;
+            cliCacheHours: z.ZodDefault<z.ZodNumber>;
             artificialAnalysis: z.ZodPrefault<z.ZodObject<{
                 enabled: z.ZodDefault<z.ZodBoolean>;
                 apiKeyEnv: z.ZodDefault<z.ZodString>;
@@ -2831,6 +2861,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>;
@@ -2854,12 +2885,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>;
@@ -2921,6 +2954,9 @@ 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>>;
@@ -2929,11 +2965,22 @@ declare const LoopConfigSchema: 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>;
@@ -3110,6 +3157,17 @@ declare const resolveAlias: (provider: string, modelId: string, aliases?: Readon
 /** Parse `grok models` human output into model ids. */
 declare const parseGrokModelsOutput: (stdout: string) => readonly string[];
 declare const listCliModels: (provider: string, bin: string, runner: CommandRunner, timeoutMs?: number) => Promise<readonly string[]>;
+declare const readCliModelsCache: (stateDir: string, provider: string) => {
+    readonly fetchedAt: string;
+    readonly ids: readonly string[];
+} | null;
+declare const writeCliModelsCache: (stateDir: string, provider: string, ids: readonly string[], now?: Date) => void;
+/**
+ * `listCliModels`, but cached for `cacheHours` (like `readAaCache`/`writeAaCache` below): a provider's CLI model
+ * list barely changes between releases, so spawning the CLI (e.g. `grok models`) on every tick/deliver run for
+ * every role that needs it is wasted subprocess time — cache once, reuse until stale.
+ */
+declare const listCliModelsCached: (provider: string, bin: string, runner: CommandRunner, stateDir: string, cacheHours: number, now?: () => Date) => Promise<readonly string[]>;
 interface ArtificialAnalysisModel {
     readonly slug: string;
     readonly name: string;
@@ -3209,7 +3267,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>;
 
@@ -3442,9 +3500,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;
@@ -3467,6 +3527,8 @@ 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"];
 /**
@@ -3516,6 +3578,8 @@ interface WorkerBriefInput {
     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;
@@ -3538,6 +3602,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;
@@ -3591,6 +3720,10 @@ interface DispatchRecordFile {
         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;
@@ -3635,8 +3768,9 @@ declare const dispatchRecordPath: (stateDir: string, identifier: string) => stri
 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, now?: () => Date) => void;
 interface LoopState {
+    readonly person: string;
     readonly providers: readonly ProviderAvailability[];
     readonly routing: Readonly<Record<string, RoutingDecision>>;
     readonly worktrees: readonly OrcaWorktree[];
@@ -3645,6 +3779,8 @@ interface LoopState {
     readonly leases: readonly DispatchLease[];
     readonly busy: ReadonlySet<string>;
     readonly candidates: readonly LoopIssue[];
+    /** Catalog-discovered candidates per role (`models.routing.mode: catalog`), already resolved for `routing` above — reused by `runTick` for `generateContract`'s candidate fallback so it isn't resolved twice per tick. */
+    readonly extrasByRole: Partial<Record<ModelRole, readonly ModelReference[]>>;
 }
 declare const gatherLoopState: (input: {
     readonly loaded: LoadedLoopConfig;
@@ -3790,7 +3926,7 @@ interface DeliverInput {
 }
 declare const deliveryStatePath: (stateDir: string, identifier: string) => string;
 declare const readDeliveryState: (stateDir: string, identifier: string) => DeliveryState;
-/** Every issue the loop dispatched and has not finished. */
+/** Every issue the loop ever dispatched (finished or not) — callers that only care about in-flight work must filter on `readDeliveryState(...).finishedAt` themselves. */
 declare const listDispatched: (stateDir: string) => readonly DispatchRecordFile[];
 declare const precheckDeliver: (stateDir: string) => {
     readonly work: boolean;
@@ -3867,6 +4003,26 @@ declare const parseAutomationRuns: (result: unknown) => readonly {
 }[];
 declare const loopStatus: (input: Pick<InstallInput, "configPath" | "loaded" | "runner">) => Promise<LoopStatusReport>;
 
+declare const rotationStatePath: (stateDir: string) => string;
+/**
+ * A lease protects the issue identity, but delivery work must not stop the
+ * queue from moving on to independent work. Only leases with no delivery
+ * state yet represent an implementation worker that should hold rotation.
+ * Missing or invalid state stays fail-closed and remains blocking.
+ */
+declare const countRotationBlockingLeases: (loaded: LoadedLoopConfig, leases: readonly DispatchLease[]) => number;
+/** 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 implementation 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>;
@@ -3973,6 +4129,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;
@@ -3998,6 +4167,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;
@@ -4028,56 +4199,6 @@ interface DebriefReport {
 declare const buildDebriefReport: (input: DebriefInput) => DebriefReport;
 declare const renderDebriefMarkdown: (report: DebriefReport) => string;
 
-type WatchEventKind = 'DONE' | 'FAILED' | 'ACTION_REQUIRED' | 'PROGRESS';
-interface WatchEvent {
-    readonly kind: WatchEventKind;
-    readonly issue: string;
-    readonly message: string;
-    readonly phase: string;
-    readonly pr: number | null;
-    readonly finalOutcome: DeliverOutcome | null;
-    readonly at: string;
-}
-interface WatchTargetSnapshot {
-    readonly issue: string;
-    readonly phase: string;
-    readonly signature: string;
-    readonly delivery: DeliveryState;
-    readonly dispatch: DispatchRecordFile | null;
-    readonly pr: PullRequestSnapshot | null;
-}
-interface WatchInput {
-    readonly configPath?: string;
-    readonly loaded?: LoadedLoopConfig;
-    readonly runner?: CommandRunner;
-    readonly issue?: string;
-    readonly intervalMs?: number;
-    readonly once?: boolean;
-    readonly timeoutMs?: number;
-    readonly livePr?: boolean;
-    readonly now?: () => Date;
-    readonly sleep?: (ms: number) => Promise<void>;
-    readonly onEvent?: (event: WatchEvent) => void;
-}
-declare const classifyWatchPhase: (delivery: DeliveryState, pr: PullRequestSnapshot | null) => string;
-declare const classifyWatchEvent: (phase: string, delivery: DeliveryState, pr: PullRequestSnapshot | null, at: string, issue: string) => WatchEvent;
-declare const snapshotWatchTargets: (input: {
-    readonly loaded: LoadedLoopConfig;
-    readonly runner?: CommandRunner;
-    readonly issue?: string;
-    readonly livePr?: boolean;
-    readonly now?: () => Date;
-}) => Promise<readonly WatchTargetSnapshot[]>;
-interface WatchReport {
-    readonly status: 'done' | 'failed' | 'waiting' | 'action-required';
-    readonly generatedAt: string;
-    readonly events: readonly WatchEvent[];
-    readonly targets: readonly WatchTargetSnapshot[];
-}
-/** Poll delivery state (and optionally live PRs). Emits DONE / FAILED / ACTION_REQUIRED / PROGRESS. Read-only. */
-declare const watchDeliveries: (input: WatchInput) => Promise<WatchReport>;
-declare const formatWatchEvent: (event: WatchEvent) => string;
-
 interface LoopEvent {
     readonly at: string;
     readonly type: string;
@@ -4172,7 +4293,11 @@ interface RetroReport {
     readonly suggestions: readonly RetroSuggestion[];
     readonly digest: string;
 }
-declare const readLoopEvents: (stateDir: string) => readonly LoopEvent[];
+/** `sinceMs`, when given, skips a rotated archive whose rotation time is older than the window — every event in
+ * that file was written before its own rotation, so if the rotation itself predates `sinceMs` nothing inside can
+ * be in range (see `appendLoopEvent` in tick.ts for the rotation side). Omit `sinceMs` to read everything, exactly
+ * as before archives existed. */
+declare const readLoopEvents: (stateDir: string, sinceMs?: number) => readonly LoopEvent[];
 declare const parseSince: (value: string | undefined, now: Date) => Date;
 /** Collapse an escalation reason to its head phrase so identical shapes group together. */
 declare const normalizeReason: (reason: string) => string;
@@ -4211,6 +4336,164 @@ declare const runRetroStage: (input: {
     readonly dryRun?: boolean;
 }) => Promise<RetroStageReport>;
 
+type ObservabilitySeverity = 'warning' | 'action_required';
+interface ObservabilityAnomaly {
+    readonly id: string;
+    readonly severity: ObservabilitySeverity;
+    readonly issue: string | null;
+    readonly message: string;
+    readonly evidence: Readonly<Record<string, unknown>>;
+}
+interface ObservabilityMetrics {
+    readonly queueReady: number;
+    readonly freeSlots: number;
+    readonly runningWorkers: number;
+    readonly maxAgents: number;
+    readonly activeClaims: number;
+    readonly inFlight: number;
+    readonly held: number;
+    readonly merged: number;
+    readonly blocked: number;
+    readonly fixRounds: number;
+    readonly reviewFindings: number;
+    readonly reviewIncomplete: number;
+    readonly medianLeadTimeMin: number | null;
+    readonly providerRemainingPercent: Readonly<Record<string, number | null>>;
+    readonly machine: {
+        readonly cpuCount: number;
+        readonly load1PerCpuPercent: number;
+        readonly memoryUsedPercent: number;
+        readonly freeRamGb: number;
+    };
+    readonly memory: {
+        readonly recalls: number;
+        readonly hits: number;
+        readonly approxCharsSaved: number;
+    };
+    readonly cache: {
+        readonly cachedContracts: number;
+    };
+    readonly tokens: {
+        readonly input: number;
+        readonly output: number;
+        readonly total: number;
+        readonly cacheRead: number;
+        readonly cacheWrite: number;
+    };
+    readonly events: Readonly<Record<string, number>>;
+}
+interface ObservabilityReport {
+    readonly status: 'healthy' | 'action_required';
+    readonly generatedAt: string;
+    readonly project: string;
+    readonly person: string;
+    readonly windowHours: number;
+    readonly anomalies: readonly ObservabilityAnomaly[];
+    readonly metrics: ObservabilityMetrics;
+}
+interface ObservabilityTerminal {
+    readonly handle: string;
+    readonly status: string;
+    readonly worktreeId: string | null;
+    readonly lastOutputAt: number | null;
+    readonly preview: string;
+}
+interface ObservabilitySnapshot {
+    readonly generatedAt: string;
+    readonly project: string;
+    readonly person: string;
+    readonly windowHours: number;
+    readonly workerIdleTimeoutMin: number;
+    readonly queueReady: number;
+    readonly freeSlots: number;
+    readonly runningWorkers: number;
+    readonly maxAgents: number;
+    readonly activeClaims: number;
+    readonly missingDeliveryIssues: readonly string[];
+    readonly terminals: readonly ObservabilityTerminal[];
+    readonly finalizedDirtyWorktrees: readonly {
+        readonly worktreeId: string;
+        readonly issue: string | null;
+        readonly files: number;
+    }[];
+    readonly issues: readonly Pick<DebriefIssueRow, 'issue' | 'phase' | 'ageMin' | 'heldFor'>[];
+    readonly events: readonly LoopEvent[];
+    readonly merged: number;
+    readonly blocked: number;
+    readonly fixRounds: number;
+    readonly reviewFindings: number;
+    readonly reviewIncomplete: number;
+    readonly medianLeadTimeMin: number | null;
+    readonly providerRemainingPercent: Readonly<Record<string, number | null>>;
+    readonly machine: ObservabilityMetrics['machine'];
+    readonly memory: ObservabilityMetrics['memory'];
+    readonly cache: ObservabilityMetrics['cache'];
+    readonly tokens: ObservabilityMetrics['tokens'];
+}
+/** Pure, deterministic anomaly assessment. No network calls or writes. */
+declare const assessObservability: (input: ObservabilitySnapshot) => ObservabilityReport;
+/** Collect current read-only state from the existing doctor, debrief and event log. */
+declare const runObservability: (input: {
+    readonly configPath?: string;
+    readonly loaded?: LoadedLoopConfig;
+    readonly runner: CommandRunner;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly platform?: NodeJS.Platform;
+    readonly since?: string;
+    readonly now?: () => Date;
+}) => Promise<ObservabilityReport>;
+declare const renderObservabilityMarkdown: (report: ObservabilityReport) => string;
+
+type WatchEventKind = 'DONE' | 'FAILED' | 'ACTION_REQUIRED' | 'PROGRESS';
+interface WatchEvent {
+    readonly kind: WatchEventKind;
+    readonly issue: string;
+    readonly message: string;
+    readonly phase: string;
+    readonly pr: number | null;
+    readonly finalOutcome: DeliverOutcome | null;
+    readonly at: string;
+}
+interface WatchTargetSnapshot {
+    readonly issue: string;
+    readonly phase: string;
+    readonly signature: string;
+    readonly delivery: DeliveryState;
+    readonly dispatch: DispatchRecordFile | null;
+    readonly pr: PullRequestSnapshot | null;
+}
+interface WatchInput {
+    readonly configPath?: string;
+    readonly loaded?: LoadedLoopConfig;
+    readonly runner?: CommandRunner;
+    readonly issue?: string;
+    readonly intervalMs?: number;
+    readonly once?: boolean;
+    readonly timeoutMs?: number;
+    readonly livePr?: boolean;
+    readonly now?: () => Date;
+    readonly sleep?: (ms: number) => Promise<void>;
+    readonly onEvent?: (event: WatchEvent) => void;
+}
+declare const classifyWatchPhase: (delivery: DeliveryState, pr: PullRequestSnapshot | null) => string;
+declare const classifyWatchEvent: (phase: string, delivery: DeliveryState, pr: PullRequestSnapshot | null, at: string, issue: string) => WatchEvent;
+declare const snapshotWatchTargets: (input: {
+    readonly loaded: LoadedLoopConfig;
+    readonly runner?: CommandRunner;
+    readonly issue?: string;
+    readonly livePr?: boolean;
+    readonly now?: () => Date;
+}) => Promise<readonly WatchTargetSnapshot[]>;
+interface WatchReport {
+    readonly status: 'done' | 'failed' | 'waiting' | 'action-required';
+    readonly generatedAt: string;
+    readonly events: readonly WatchEvent[];
+    readonly targets: readonly WatchTargetSnapshot[];
+}
+/** Poll delivery state (and optionally live PRs). Emits DONE / FAILED / ACTION_REQUIRED / PROGRESS. Read-only. */
+declare const watchDeliveries: (input: WatchInput) => Promise<WatchReport>;
+declare const formatWatchEvent: (event: WatchEvent) => string;
+
 /** One recorded failure for an issue, kept for diagnostics (`loop retro`, `loop status`). */
 interface IssueFailureRecord {
     readonly kind: string;
@@ -4293,4 +4576,4 @@ declare const discoverIntake: (runner: CommandRunner, input: {
     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 LoopIssue, 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, 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 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, 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, 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, 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, rankModels, readAaCache, readArtifactFile, readContextSnapshots, readCooldowns, readDeliveryState, readDispatchRecord, readEvidenceTrustStore, readIntake, readIssueFailures, readLearningsLedger, readLoopEvents, 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, routeAllRoles, runAdversarialReview, runAgentEval, runCodeReview, runDeliver, runEvalBattery, runGuidedInstall, runLoopDoctor, runRetroStage, runTick, runWithRecovery, runWorkflow, sampleMachine, 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 };
+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 ObservabilityAnomaly, type ObservabilityMetrics, type ObservabilityReport, type ObservabilitySeverity, type ObservabilitySnapshot, type ObservabilityTerminal, 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, assessObservability, 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, countRotationBlockingLeases, 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, listCliModelsCached, 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, readCliModelsCache, 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, renderObservabilityMarkdown, renderPinnedSkills, renderRetroMarkdown, renderTuiCommand, renderWorkerBrief, resolveAgentForRole, resolveAlias, resolveCatalogCandidates, resolveDocContext, resumeIssue, resumeStage, resumeStateFromArtifacts, retroLearnings, retryRun, rotationStatePath, routeAllRoles, runAdversarialReview, runAgentEval, runCodeReview, runDeliver, runEvalBattery, runGuidedInstall, runLoopDoctor, runObservability, 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, writeCliModelsCache, writeDispatchRecord, writeIdFor, writeLearningsLedger, writeLocalConfig, writeStoredContract };