opencode-swarm 7.144.3 → 7.144.4

package/dist/cli/{worktree-isolation-y2p93438.js → worktree-isolation-canf3rj8.js}

@@ -20,59 +20,59 @@ import {
   sanitizeWorktreeTaskId,
   standardWorktreeByCallID,
   standardWorktreeSerializationSessions
-} from "./index-247wf23m.js";
-import"./index-7554tecy.js";
-import"./index-2en8s72h.js";
-import"./index-satc0vs6.js";
+} from "./index-q4ed1jk7.js";
+import"./index-d12jd5mn.js";
+import"./index-h98t1m88.js";
+import"./index-az8etqpp.js";
 import"./index-134d35c1.js";
 import"./index-b6e016tv.js";
-import"./index-zwrqe065.js";
-import"./index-8214dd7j.js";
+import"./index-1csyxv0f.js";
+import"./index-fqcjragy.js";
 import"./index-y8552snf.js";
-import"./index-wck434f8.js";
+import"./index-nckg4gxb.js";
 import"./index-70ha9e09.js";
 import"./index-c8s9a3zh.js";
 import"./index-9ss2m4rs.js";
 import"./index-74hpm6sh.js";
-import"./index-584grrwn.js";
-import"./index-pag8nsb1.js";
-import"./index-eya357bk.js";
-import"./index-b227mpnk.js";
-import"./index-0fgwdtvp.js";
+import"./index-bt9aa01f.js";
+import"./index-zb0xcz9t.js";
+import"./index-x6tp0hfr.js";
+import"./index-yts89pqg.js";
+import"./index-dty5qgk2.js";
 import"./index-rtry5xyf.js";
 import"./index-zsrtt42s.js";
-import"./index-krxcxkdq.js";
+import"./index-jabkn643.js";
 import"./index-k3cxyk66.js";
-import"./index-x68tw7v3.js";
-import"./index-6s2q144w.js";
-import"./index-p7hbphaq.js";
-import"./index-j6mfyy0a.js";
+import"./index-cz25e8xp.js";
+import"./index-8j0va7jp.js";
+import"./index-pw83zgny.js";
+import"./index-z6v7kwpa.js";
 import"./index-556ja8an.js";
 import"./index-7sy3aa9m.js";
 import"./index-wx8zdh4a.js";
 import"./index-8fwhhayc.js";
 import"./index-q1exe2b3.js";
-import"./index-xwpmxpb7.js";
-import"./index-pr8vhj6j.js";
+import"./index-03pv47h2.js";
+import"./index-4w5qdbk7.js";
 import {
   resolveWorktreeIsolationConfig
-} from "./index-qj22wyw2.js";
+} from "./index-psvxq93b.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
 import"./index-rn0eq85g.js";
 import"./index-z6xqpmqg.js";
-import"./index-8hkjk37c.js";
-import"./index-1brb14xc.js";
+import"./index-9qq7c18c.js";
+import"./index-y8j8ehc8.js";
 import"./index-4rhhvd1a.js";
-import"./index-whezv7vc.js";
+import"./index-v3y3qg48.js";
 import"./index-zjygnfay.js";
 import"./index-ae75rja9.js";
-import"./index-dpfphnmy.js";
-import"./index-zswmbm15.js";
+import"./index-ywn7vtxp.js";
+import"./index-mazgg5s2.js";
 import"./index-ed5ykebp.js";
 import"./index-bk5tah7q.js";
-import"./index-wd24zn2e.js";
-import"./index-s2rcz51a.js";
+import"./index-f9vvg5xb.js";
+import"./index-1jsmmx7y.js";
 import"./index-7g4c7s5r.js";
 import"./index-bpmtbmy9.js";
 import"./index-4nt52yr9.js";

package/dist/commands/index.d.ts

@@ -46,6 +46,7 @@ export { handlePlanCommand } from './plan';
 export { handlePreflightCommand } from './preflight';
 export { handlePromoteCommand } from './promote';
 export { handleQaGatesCommand } from './qa-gates';
+export { handleRecoverCommand } from './recover';
 export { handleHelpCommand } from './registry';
 export type { CommandContext, CommandEntry, RegisteredCommand, } from './registry.js';
 export { COMMAND_REGISTRY, resolveCommand, VALID_COMMANDS, } from './registry.js';

package/dist/commands/recover.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Handles the /swarm recover command (issue #2268).
+ *
+ * The user-facing invoker for coder-settlement recovery. The wedge class this
+ * exists for: a DISPATCHED settlement WAL whose completion (toolAfter) never
+ * arrived — every dispatch retry is refused with CODER_SETTLEMENT_IN_PROGRESS
+ * / CODER_DISPATCH_IN_PROGRESS and internal sinks (update_task_status, /swarm
+ * close) are paused too. Safe mode recovers settlements whose owning process
+ * is gone; --force additionally releases ownership keys still held by THIS
+ * process (an operator assertion that no dispatch is genuinely in flight —
+ * a still-running dispatch's late completion will then fail settlement with
+ * CODER_SETTLEMENT_IDEMPOTENCY_CONFLICT, which is safe to ignore).
+ *
+ * Human-only by policy: agents already self-heal dead-owner settlements via
+ * update_task_status, and --force must stay an operator decision.
+ */
+export declare function handleRecoverCommand(directory: string, args: string[]): Promise<string>;

package/dist/commands/registry.d.ts

@@ -825,11 +825,19 @@ export declare const COMMAND_REGISTRY: {
     readonly 'reset-session': {
         readonly handler: (ctx: CommandContext) => Promise<string>;
         readonly description: "Clear session state while preserving plan, evidence, and knowledge";
-        readonly details: "Deletes only .swarm/session/state.json and any other session files. Clears in-memory agent sessions, delegation chains, and active-agent mappings. Preserves plan, evidence, and knowledge for cross-session continuity. Before deleting, auto-backs up the session files it removes to .swarm/reset-backups/<timestamp>/ (newest 5 kept).";
+        readonly details: "Deletes only .swarm/session/state.json and any other session files. Clears in-memory agent sessions, delegation chains, and active-agent mappings. Preserves plan, evidence, and knowledge for cross-session continuity. Also recovers stale coder settlements, releasing in-flight ownership held by this process, so dispatches cannot stay wedged on CODER_DISPATCH_IN_PROGRESS (issue #2268). Before deleting, auto-backs up the session files it removes to .swarm/reset-backups/<timestamp>/ (newest 5 kept).";
         readonly args: "";
         readonly category: "utility";
         readonly toolPolicy: "restricted";
     };
+    readonly recover: {
+        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly description: "Recover wedged coder settlements [task_id] [--force]";
+        readonly details: "Settles stale coder-settlement WALs in .swarm/coder-settlements/ — the CODER_DISPATCH_IN_PROGRESS wedge where a dispatch's completion never fired (issue #2268). Safe mode recovers settlements whose owner process is gone. --force also releases ownership keys held by this process: use only when no dispatch is genuinely running (a late completion then reports CODER_SETTLEMENT_IDEMPOTENCY_CONFLICT, safe to ignore). Never interrupts another live OpenCode process. Human-only.";
+        readonly args: "[task_id] [--force]";
+        readonly category: "utility";
+        readonly toolPolicy: "human-only";
+    };
     readonly rollback: {
         readonly handler: (ctx: CommandContext) => Promise<string>;
         readonly description: "Restore swarm state or project files to a checkpoint";

package/dist/commands/reset-session.d.ts

@@ -1,3 +1,4 @@
+import { recoverStaleCoderSettlements } from '../workflow/coder-settlement.js';
 import { type OrphanCleanupResult } from '../worktree/merge';
 import { type ResetBackupResult } from './reset-backup';
 /**
@@ -9,6 +10,7 @@ import { type ResetBackupResult } from './reset-backup';
 export declare const _internals: {
     cleanupOrphanedBranches: (directory: string, activeSessionIds: string[]) => Promise<OrphanCleanupResult>;
     backupSwarmStateBeforeReset: (directory: string, kind: 'reset' | 'reset-session', relEntries: string[]) => ResetBackupResult;
+    recoverStaleCoderSettlements: typeof recoverStaleCoderSettlements;
 };
 /**
  * Handles the /swarm reset-session command.

package/dist/hooks/context-budget.d.ts

@@ -6,6 +6,7 @@
  * to provide proactive context management guidance to the architect agent.
  */
 import type { PluginConfig } from '../config';
+import { telemetry } from '../telemetry';
 interface MessageInfo {
     role: string;
     agent?: string;
@@ -31,6 +32,9 @@ interface MessageWithParts {
     info: MessageInfo;
     parts: MessagePart[];
 }
+export declare const _internals: {
+    telemetryContextPruned: typeof telemetry.contextPruned;
+};
 /**
  * Creates the experimental.chat.messages.transform hook for context budget tracking.
  * Injects warnings when context usage exceeds configured thresholds.

package/dist/hooks/context-usage.d.ts

@@ -0,0 +1,48 @@
+export interface ContextUsageMessageInfo {
+    role?: string;
+    tokens?: {
+        input?: unknown;
+        cache?: {
+            read?: unknown;
+            write?: unknown;
+        };
+    };
+    [key: string]: unknown;
+}
+export interface ContextUsageMessagePart {
+    type?: string;
+    text?: string;
+    state?: {
+        status?: string;
+        input?: unknown;
+        output?: string;
+        error?: string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export interface ContextUsageMessage {
+    info?: ContextUsageMessageInfo;
+    parts?: ContextUsageMessagePart[];
+}
+export type ContextUsageSource = 'provider' | 'estimated';
+export interface ContextUsageResult {
+    tokensUsed: number;
+    source: ContextUsageSource;
+    assistantAnchorIndex: number | null;
+}
+export declare function serializeToolInput(input: unknown): string;
+export declare function estimateToolInputTokens(input: unknown): number;
+export declare function getVisibleToolPartText(part: ContextUsageMessagePart): string;
+export declare function estimateVisibleToolPartTokens(part: ContextUsageMessagePart): number;
+export declare function estimateMessageTokens(message: ContextUsageMessage): number;
+export declare function readProviderPromptTokens(message: ContextUsageMessage | undefined): number | undefined;
+export declare function computeContextUsage(messages: ContextUsageMessage[] | undefined): ContextUsageResult;
+export declare const _test_exports: {
+    computeContextUsage: typeof computeContextUsage;
+    estimateToolInputTokens: typeof estimateToolInputTokens;
+    estimateVisibleToolPartTokens: typeof estimateVisibleToolPartTokens;
+    estimateMessageTokens: typeof estimateMessageTokens;
+    readProviderPromptTokens: typeof readProviderPromptTokens;
+    serializeToolInput: typeof serializeToolInput;
+};

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

@@ -2,7 +2,7 @@ import * as fsp from 'node:fs/promises';
 import { z } from 'zod';
 import { type CandidateSeverity, type RowFormatFamily } from '../background/candidate-contract.js';
 import { type LaneOutputArtifact } from '../background/lane-output-store.js';
-import { type BackgroundDelegationRecord, type BackgroundDelegationResult, findByBatchId, sweepStaleDelegations } from '../background/pending-delegations.js';
+import { type BackgroundDelegationRecord, type BackgroundDelegationResult, type BackgroundDelegationWorkflowLaneRecovery, findByBatchId, sweepStaleDelegations } from '../background/pending-delegations.js';
 import { type PrReviewInlineTriggerRow } from '../background/pr-review-trigger-contract.js';
 import { type RevisionDigestResult, resolveCommitCountSince, resolveCommitCountSinceAsync, resolveCurrentGitHead, resolveCurrentGitHeadAsync, resolveCurrentUpstreamPushTarget, resolveCurrentUpstreamPushTargetAsync, resolveCurrentUpstreamRemoteRef, resolveExactRemoteBranchHead, resolveExactRemoteBranchHeadAsync, resolveIsExactSingleChildCommit, resolveIsExactSingleChildCommitAsync, resolveIsWorkingTreeClean, resolveIsWorkingTreeCleanAsync, resolvePrReviewDiffStats, resolvePrReviewDiffStatsAsync, resolvePrWorkflowRevisionDigest, resolvePrWorkflowRevisionDigestDetailed, resolveRemoteRefsContainingHead, resolveRemoteRefsContainingHeadAsync } from '../background/workspace-snapshot.js';
 import { classifyPrWorkflowGitState, type PrWorkflowGitState } from '../git/pr-workflow-state.js';
@@ -10,7 +10,7 @@ export declare const PR_REVIEW_BASE_DIMENSION_IDS: readonly ["intent-architectur
 export declare const PR_REVIEW_REQUIRED_MICRO_LANE_IDS: ("auth-identity-secrets" | "untrusted-input-boundaries" | "subprocess-platform" | "concurrency-state" | "dependencies-build-release" | "api-schema-migrations" | "test-infrastructure" | "ui-accessibility-i18n" | "privacy-observability" | "generated-provenance" | "unclassified-risk")[];
 export type PrReviewBaseDimensionId = (typeof PR_REVIEW_BASE_DIMENSION_IDS)[number];
 export type PrWorkflowMode = 'PR_REVIEW' | 'PR_FEEDBACK';
-export type PrReviewLaneValidationPredicate = 'batch.validated_at' | 'batch.expected_lane_unique' | 'record.missing' | 'record.duplicate_lane' | 'record.subagent_session_id' | 'record.duplicate_subagent_session_id' | 'record.forbidden_subagent_session_id' | 'record.created_at' | 'record.workflow_lane' | 'record.owned_workflow_lanes' | 'record.mode' | 'record.pr_head_sha' | 'record.git_head' | 'record.status' | 'result.output_degraded' | 'result.transcript_incomplete' | 'result.truncated' | 'result.chars' | 'result.digest' | 'result.output_ref' | 'artifact.readable' | 'artifact.ref' | 'artifact.batch_id' | 'artifact.lane_id' | 'artifact.mode' | 'artifact.session_id' | 'artifact.parent_session_id' | 'artifact.agent' | 'artifact.role' | 'artifact.source' | 'artifact.workflow_lane_record' | 'artifact.workflow_lane_expected' | 'artifact.pr_head_sha' | 'artifact.git_head' | 'artifact.revision_digest' | 'record.scope' | 'artifact.scope' | 'artifact.digest' | 'artifact.chars' | 'discovery.header' | 'discovery.row' | 'discovery.coverage' | 'discovery.duplicate_evidence';
+export type PrReviewLaneValidationPredicate = 'batch.validated_at' | 'batch.expected_lane_unique' | 'record.missing' | 'record.duplicate_lane' | 'record.subagent_session_id' | 'record.duplicate_subagent_session_id' | 'record.forbidden_subagent_session_id' | 'record.created_at' | 'record.workflow_lane' | 'record.owned_workflow_lanes' | 'record.mode' | 'record.pr_head_sha' | 'record.git_head' | 'record.status' | 'result.output_degraded' | 'result.transcript_incomplete' | 'result.chars' | 'result.digest' | 'result.output_ref' | 'artifact.readable' | 'artifact.ref' | 'artifact.batch_id' | 'artifact.lane_id' | 'artifact.mode' | 'artifact.session_id' | 'artifact.parent_session_id' | 'artifact.agent' | 'artifact.role' | 'artifact.source' | 'artifact.workflow_lane_record' | 'artifact.workflow_lane_expected' | 'artifact.pr_head_sha' | 'artifact.git_head' | 'artifact.revision_digest' | 'record.scope' | 'artifact.scope' | 'artifact.digest' | 'artifact.chars' | 'discovery.header' | 'discovery.row' | 'discovery.coverage' | 'discovery.duplicate_evidence';
 export interface PrReviewLaneValidationFailure {
     predicate: PrReviewLaneValidationPredicate;
     expected: string;
@@ -25,6 +25,8 @@ export type PrReviewLaneValidationResult = {
      * distinguishable from a well-formed one.
      */
     salvaged?: readonly string[];
+    /** Typed recovery disclosures persisted to the durable delegation ledger. */
+    recoveries?: readonly BackgroundDelegationWorkflowLaneRecovery[];
 } | {
     ok: false;
     failure: PrReviewLaneValidationFailure;
@@ -44,6 +46,20 @@ export interface PrReviewDiscoveryLaneValidationInput {
         checkWorkflowLane?: boolean;
     };
 }
+export interface PrWorkflowTransportRecoveryValidationInput {
+    directory: string;
+    record: BackgroundDelegationRecord;
+    result: BackgroundDelegationResult;
+    artifact: LaneOutputArtifact | null;
+    revisionDigest: string;
+}
+export type PrWorkflowTransportRecoveryValidationResult = {
+    ok: true;
+    recoveries?: readonly BackgroundDelegationWorkflowLaneRecovery[];
+} | {
+    ok: false;
+    reason: string;
+};
 export interface PrWorkflowCheckoutRecoveryRecord {
     code: 'UNMERGED_INDEX' | 'GIT_OPERATION_IN_PROGRESS' | 'DIRTY_SUBMODULE' | 'SWARM_STATE_TRACKING_ERROR' | 'GIT_STATE_INDETERMINATE';
     retryable: false;
@@ -1047,6 +1063,17 @@ declare function analyzePrReviewBatchRecordIntegrity(args: {
  * accidentally accept stale terminal state or a different output reference.
  */
 export declare function validatePrReviewDiscoveryLaneCompletion(input: PrReviewDiscoveryLaneValidationInput): PrReviewLaneValidationResult;
+/**
+ * Collection-time proof for transport-recovered structured workflow lanes.
+ *
+ * Reviewer/critic/PR-feedback lanes normally settle later through the workflow
+ * gate, not in `collect_lane_results`, so a truncated inline preview used to
+ * pass through collection with no durable typed provenance. This helper proves
+ * the durable artifact still carries the exact rows the already-declared batch
+ * owns, allowing collection to persist the transport recovery immediately. Any
+ * unsupported or unprovable structured mode fails closed.
+ */
+export declare function validatePrWorkflowTransportRecovery(input: PrWorkflowTransportRecoveryValidationInput): Promise<PrWorkflowTransportRecoveryValidationResult>;
 /** Require at least one semantically valid discovery row or CLEAN attestation. */
 export declare function prReviewDiscoveryArtifactCoversLane(text: string, expectedWorkflowLane: string, ownedWorkflowLanes?: readonly string[], mode?: string): boolean;
 /**