opencode-swarm 7.166.4 → 7.167.1

package/dist/hooks/pr-workflow-gate.d.ts

@@ -6,6 +6,7 @@ import { type BackgroundDelegationRecord, type BackgroundDelegationResult, type
 import { PR_REVIEW_BASE_DIMENSION_IDS, type PrReviewLaneResultEnvelope, type PrReviewRiskImpact, type PrReviewRiskTag } from '../background/pr-review-contract.js';
 import { type PrReviewInlineTriggerRow } from '../background/pr-review-trigger-contract.js';
 import { type RevisionDigestResult, resolveCommitCountSince, resolveCommitCountSinceAsync, resolveCurrentGitHead, resolveCurrentGitHeadAsync, resolveCurrentLocalHeadRefAsync, resolveCurrentUpstreamPushTarget, resolveCurrentUpstreamPushTargetAsync, resolveCurrentUpstreamRemoteRef, resolveExactRemoteBranchHead, resolveExactRemoteBranchHeadAsync, resolveIsExactSingleChildCommit, resolveIsExactSingleChildCommitAsync, resolveIsWorkingTreeClean, resolveIsWorkingTreeCleanAsync, resolvePrReviewDiffStats, resolvePrReviewDiffStatsAsync, resolvePrWorkflowRevisionDigest, resolvePrWorkflowRevisionDigestDetailed, resolveRemoteRefsContainingHead, resolveRemoteRefsContainingHeadAsync, resolveRemoteUrlIdentity, resolveRemoteUrlIdentityAsync } from '../background/workspace-snapshot.js';
+import type { LaneLivenessWatchdogConfig } from '../config/schema.js';
 import { type PrReviewResilienceConfig } from '../config/schema.js';
 import { classifyPrWorkflowGitState, type PrWorkflowGitState } from '../git/pr-workflow-state.js';
 import { type PrReviewReentryAuthorizationRecord, type PrReviewReentryBindingContext, type PrReviewReentryRole } from '../pr-review/authorization.js';
@@ -13,6 +14,7 @@ import { classifyPrReviewCircuitSignal, type PrReviewCircuitLegacyRecord, type P
 import { type PrReviewDimensionCancellationRecord, type PrReviewPartialBaseCoverageRecord, type PrReviewReportVerdict, type PrReviewTerminalCoverageSettlement } from '../pr-review/completion.js';
 import { type PrReviewComposablePhase, type PrReviewPhaseComposition, parseCriticVerdict } from '../pr-review/legacy-transcript-adapter.js';
 import { withPrWorkflowCheckoutMutationLock, workflowCheckoutMutationLockRelativePath, workflowGateStateLockRelativePath, workflowGateStateRelativePath } from '../pr-review/persistence.js';
+import { classifyLaneLivenessCondition, type EffectivePrLaneHorizon, resolveEffectivePrLaneHorizonMs } from './lane-liveness-watchdog.js';
 export type { PrReviewDimensionCancellationRecord, PrReviewDimensionTerminalState, PrReviewPartialBaseCoverageRecord, PrReviewPartialBaseCoverageRecordV1, PrReviewPartialBaseCoverageRecordV2, PrReviewReportVerdict, PrReviewTerminalCoverageKind, PrReviewTerminalCoverageSettlement, PrReviewUnresolvedDimensionRecord, } from '../pr-review/completion.js';
 export { allowedPrReviewReportVerdicts, normalizePrReviewPartialBaseCoverageRecord, PR_REVIEW_REPORT_VERDICTS, readPrReviewTerminalCoverageForReport, rollbackPrReviewPartialBaseCoverageAdmission, } from '../pr-review/completion.js';
 export { ensurePrWorkflowSafeParentDirectory, PrWorkflowCheckoutMutationTimeoutError, prWorkflowSessionFileStem, withPrWorkflowCheckoutMutationLock, writePrWorkflowAtomicJson, } from '../pr-review/persistence.js';
@@ -650,9 +652,29 @@ interface PrWorkflowLaneLivenessSessionOps {
         }> | null;
         error?: unknown;
     }>;
+    /**
+     * Issue #2506: the watchdog's best-effort, one-attempt lane abort. The
+     * host session object exposes it; the seam type keeps it optional so the
+     * probe-only hosts of the #2251 era remain valid.
+     */
+    abort?: (args: unknown) => Promise<unknown>;
 }
 /** Why a probe produced no evidence of life. Absent means the probe ran. */
 export type PrWorkflowLaneProbeDegradedReason = 'probe-unavailable' | 'probe-error' | 'probe-timeout' | 'probe-no-data';
+/**
+ * Core session-status probe shared by the fail-open liveness probe below and
+ * the pending-lane liveness advisory (issue #2280 Part B). Same host call,
+ * deadline, and failure taxonomy as the probe; instead of collapsing each
+ * session to allowlist membership it records the status TYPE the host reported
+ * for every record that has one, so a caller can distinguish "live" from
+ * "affirmatively non-live" from "session absent". Failure modes return the
+ * empty map plus a `degradedReason` — a probe that did not fully read its
+ * response never yields a partial map.
+ */
+declare function probePrWorkflowLaneSessionStatusTypes(directory: string, records: readonly BackgroundDelegationRecord[], timeoutMs?: number): Promise<{
+    statuses: Map<string, string>;
+    degradedReason?: PrWorkflowLaneProbeDegradedReason;
+}>;
 /**
  * Probe which of `records` have a session the host affirmatively reports as
  * still running (issue #2251).
@@ -757,6 +779,14 @@ export interface PrWorkflowStaleLaneSettlement {
     freshOpenLanes: number;
     /** Lanes stale past the horizon, treated as settled with disclosure. */
     presumedStaleLaneIds: string[];
+    /**
+     * Present ONLY when the configured `hooks.background_pending_timeout_minutes`
+     * disagrees with the ONE effective horizon this settlement used (issue
+     * #2506 AC2). Fixed template, no second horizon is created — the field
+     * exists so the disagreement is observable on tool responses instead of
+     * being silently absorbed.
+     */
+    horizonConflictNote?: string;
     /**
      * Lanes past the horizon that the probe spared. Present only when non-empty.
      */
@@ -809,7 +839,33 @@ export interface PrWorkflowStaleLaneSettlement {
  * {@link probePrWorkflowLaneSessionStatusTypes} — so an unavailable, erroring
  * or empty probe leaves the age-only behaviour exactly as it was.
  */
-export declare function settlePresumedStalePrWorkflowLanes(directory: string, sessionID: string): Promise<PrWorkflowStaleLaneSettlement>;
+/**
+ * Issue #2506 (G2): optional lane-liveness watchdog options for the on-demand
+ * settlement entry points. The two-argument call shape every existing caller
+ * uses means "watchdog disabled" (the default-off config contract).
+ */
+export interface PrWorkflowLaneLivenessOptions {
+    laneLivenessWatchdog?: LaneLivenessWatchdogConfig;
+    backgroundPendingTimeoutMs?: number;
+}
+/**
+ * The #2506 stall-escalation evaluation for the lanes a settlement still
+ * considers open or probe-retained: escalate each lane whose session is
+ * busy/retry and whose observed activity in the last `stall_threshold_ms`
+ * missed BOTH the step and the estimated-token thresholds, deduped per lane
+ * against the last escalation event unless activity was observed since.
+ * Advisory by design: an escalated lane is never settled or aborted here —
+ * the operator response (inspect, or the human-only force abort) owns that.
+ */
+declare function evaluateLaneLivenessWatchdogEscalation(args: {
+    directory: string;
+    sessionID: string;
+    lanes: BackgroundDelegationRecord[];
+    sessionTypes: Map<string, string>;
+    watchdog: LaneLivenessWatchdogConfig;
+    horizon: EffectivePrLaneHorizon;
+}): Promise<void>;
+export declare function settlePresumedStalePrWorkflowLanes(directory: string, sessionID: string, options?: PrWorkflowLaneLivenessOptions): Promise<PrWorkflowStaleLaneSettlement>;
 /**
  * Abort an active PR workflow gate without reaching terminal completion.
  *
@@ -853,6 +909,8 @@ export declare function abortPrWorkflow(directory: string, sessionID: string, op
      * `recovery`/`force` aborts remain refused while armed.
      */
     cancelPublication?: boolean;
+    /** Issue #2506: lane-liveness watchdog config for this settlement. */
+    laneLiveness?: PrWorkflowLaneLivenessOptions;
 }): Promise<{
     mode: PrWorkflowMode;
     prHeadSha?: string;
@@ -914,6 +972,8 @@ export declare function recoverArmedPrWorkflow(directory: string, sessionID: str
     generation: number;
     workflowInstanceId?: string;
     reason: string;
+    /** Issue #2506: lane-liveness watchdog config for this settlement. */
+    laneLiveness?: PrWorkflowLaneLivenessOptions;
 }): Promise<{
     mode: PrWorkflowMode;
     prHeadSha: string;
@@ -1250,6 +1310,8 @@ export declare function transitionPrReviewToFeedback(directory: string, sessionI
     prUrl?: string;
     exactCommand?: string;
     confirmedByUser?: boolean;
+    /** Issue #2506 review round 2: watchdog policy for the readiness settle. */
+    laneLiveness?: PrWorkflowLaneLivenessOptions;
 }): Promise<PrWorkflowGateState>;
 export declare function declarePrFeedbackScope(directory: string, sessionID: string, taskId: string, files: string[]): Promise<PrWorkflowGateState>;
 export declare function resolvePrFeedbackScopeDeclaration(directory: string, sessionID: string, taskId: string): Promise<PrFeedbackScopeDeclarationRecord | null>;
@@ -1291,6 +1353,8 @@ export declare function reserveActivePrReviewReentryAuthorization(directory: str
 }): Promise<PrReviewReentryAuthorizationRecord | null>;
 export declare function completePrWorkflow(directory: string, sessionID: string, expectedMode: PrWorkflowMode, prHeadSha: string, options?: {
     reportVerdict?: PrReviewReportVerdict;
+    /** Issue #2506: lane-liveness watchdog config for this settlement. */
+    laneLiveness?: PrWorkflowLaneLivenessOptions;
 }): Promise<PrWorkflowCompletionStatus>;
 export declare const _test_exports: {
     classifyPrReviewCircuitSignal: typeof classifyPrReviewCircuitSignal;
@@ -1339,6 +1403,28 @@ export declare const _test_exports: {
     sweepStaleDelegationsAsync: typeof sweepStaleDelegations;
     /** The fail-open liveness probe (issue #2251). */
     probeLaneLivenessAsync: typeof probeAlivePrWorkflowLaneSessions;
+    /**
+     * The types-carrying variant of the liveness probe (issue #2506): one
+     * shared status call returning per-session status TYPES, so the watchdog
+     * can distinguish `retry` (provider latency) from `busy` (past-deadline
+     * execution) without a second host round-trip. Seam for the same
+     * order-independence reason as `probeLaneLivenessAsync`.
+     */
+    probeLaneSessionStatusTypesAsync: typeof probePrWorkflowLaneSessionStatusTypes;
+    /**
+     * The #2506 lane-liveness watchdog surface: the pure policy functions,
+     * the overridable transcript-activity reader, and the live budget
+     * counters (zeroed by `resetTrackedStateCache`).
+     */
+    laneLivenessWatchdog: {
+        resolveEffectivePrLaneHorizonMs: typeof resolveEffectivePrLaneHorizonMs;
+        classifyLaneLivenessCondition: typeof classifyLaneLivenessCondition;
+        evaluateLaneLivenessWatchdog: typeof evaluateLaneLivenessWatchdogEscalation;
+        readLaneActivity: import("./lane-liveness-watchdog.js").ReadLaneActivity;
+        hostStatusCalls: number;
+        hostAbortCalls: number;
+        evaluations: number;
+    };
     /**
      * Session handle for the liveness probe.
      *