opencode-swarm 7.187.2 → 7.188.0

package/dist/models/model-override-state.d.ts

@@ -42,6 +42,29 @@ export declare function normalizeModelChain(primaryModel: string | undefined, fa
 export declare function resolveScopedModelSelection(scope: ScopedModelOverrideKey, chain: NormalizedModelChain, now?: number): ScopedModelSelection;
 export declare function advanceScopedModelSelection(scope: ScopedModelOverrideKey, chain: NormalizedModelChain, expectedGeneration: number, now?: number): ScopedModelAdvanceResult;
 export declare function resetScopedModelSelection(scope: ScopedModelOverrideKey, expectedGeneration?: number): boolean;
-export declare function clearScopedModelSelectionsForSession(sessionID: string): void;
+/**
+ * Issue #2989: non-seeding read of a scoped selection for read-side
+ * consumers (the primary-session chat-boundary override).
+ *
+ * Unlike {@link resolveScopedModelSelection}, this NEVER creates or resets an
+ * entry: an absent key, an expired entry, or a stored signature that does not
+ * match the current chain all read as `undefined` (stale entries stay stale —
+ * the advance path owns reseeding). A PRESENT, signature-matching entry is
+ * touched (its `updatedAt` is refreshed), so an actively-used session's
+ * selection stays alive and an idle session's selection expires via the TTL.
+ */
+export declare function peekScopedModelSelection(scope: ScopedModelOverrideKey, chain: NormalizedModelChain, now?: number): ScopedModelSelection | undefined;
+export interface ClearScopedModelSelectionsOptions {
+    /**
+     * Issue #2989: when false, primary-session scopes (the sentinel
+     * empty-string `invocationID` used by the session-scoped fallback) are
+     * preserved. The per-invocation boundary clear
+     * (`clearPendingTaskModelRoutesForSession(..., 'invocation')`) uses this
+     * so a primary session's fallback selection stays sticky across turns;
+     * the session-end clear keeps the default (clear everything).
+     */
+    primaryScopes?: boolean;
+}
+export declare function clearScopedModelSelectionsForSession(sessionID: string, opts?: ClearScopedModelSelectionsOptions): void;
 export declare function getScopedModelSelectionSnapshot(): readonly ScopedModelSelectionSnapshotEntry[];
 export declare function resetScopedModelSelectionStateForTests(): void;

package/dist/models/task-model-routing.d.ts

@@ -61,7 +61,64 @@ export declare function registerPendingTaskModelRoute(input: PendingTaskModelRou
 export declare function bindPendingTaskModelRouteChild(input: BindTaskModelRouteChildInput, now?: number): PendingTaskModelRouteSnapshotEntry | undefined;
 export declare function advancePendingTaskModelRoute(input: AdvanceTaskModelRouteInput): TaskModelRouteAdvanceResult | undefined;
 export declare function resolveTaskChatModelOverride(input: ResolveTaskChatModelOverrideInput): Promise<TaskChatModelOverrideResolution>;
-export declare function clearPendingTaskModelRoutesForSession(sessionID: string): void;
+export interface AdvanceSessionFallbackSelectionInput {
+    sessionID: string;
+    role: string;
+    swarmID?: string;
+    primaryModel?: string;
+    fallbackModels?: Iterable<string | null | undefined>;
+    now?: number;
+}
+export interface SessionFallbackAdvanceResult {
+    accepted: boolean;
+    exhausted: boolean;
+    fallbackIndex: number;
+    modelString?: string;
+    scope: ScopedModelOverrideKey;
+}
+export interface ResolveSessionChatModelOverrideInput {
+    sessionID: string;
+    role: string;
+    swarmID?: string;
+    primaryModel?: string;
+    fallbackModels?: Iterable<string | null | undefined>;
+    now?: number;
+}
+export interface SessionChatModelOverrideResolution {
+    status: 'override' | 'primary' | 'exhausted' | 'missing';
+    model?: ModelOverrideParts;
+    modelString?: string;
+    fallbackIndex?: number;
+}
+/**
+ * Issue #2989: advance the primary-session (host-driven) fallback chain for
+ * a session with no Task route. Seed-then-advance mirrors
+ * {@link advancePendingTaskModelRoute}'s flow: `resolveScopedModelSelection`
+ * seeds a fresh entry at fallbackIndex 0, `advanceScopedModelSelection` moves
+ * it forward (clamped at chain end, where `exhausted` becomes true).
+ */
+export declare function advanceSessionFallbackSelection(input: AdvanceSessionFallbackSelectionInput): SessionFallbackAdvanceResult;
+/**
+ * Issue #2989: non-seeding read of the primary-session fallback selection
+ * for the chat-boundary override. `missing` covers no-selection/no-fallbacks
+ * (and stale-signature entries, which read as absent and are left alone);
+ * `exhausted` never throws here — a primary session's user message must
+ * never be blocked by the plugin.
+ */
+export declare function resolveSessionChatModelOverride(input: ResolveSessionChatModelOverrideInput): SessionChatModelOverrideResolution;
+/**
+ * Issue #2989 review (F-001): record the exact `input.agent` string at the
+ * chat boundary so the session.error no-route branch can resolve the same
+ * identity (the activeAgent pointer is reset by Task-tool completions).
+ */
+export declare function recordSessionChatAgent(sessionID: string, agentName: string): void;
+/**
+ * Issue #2989 review (F-001): the chat-boundary-recorded agent name for a
+ * session, or undefined when no chat.message has been seen for it in this
+ * process.
+ */
+export declare function resolveSessionChatAgent(sessionID: string): string | undefined;
+export declare function clearPendingTaskModelRoutesForSession(sessionID: string, mode?: 'session' | 'invocation'): void;
 export declare function getPendingTaskModelRouteSnapshot(): readonly PendingTaskModelRouteSnapshotEntry[];
 export declare function getTaskModelRoutingStateSnapshot(): {
     routes: readonly PendingTaskModelRouteSnapshotEntry[];

package/dist/observability/catalog.d.ts

@@ -1,8 +1,8 @@
 /**
  * The event catalog (issue #2029).
  *
- * Exactly 65 entries, matching the `TelemetryEvent` union at
- * `src/telemetry.ts:20-172`. Thirty-eight predate the #2029 contract; the 39th is
+ * Exactly 66 entries, matching the `TelemetryEvent` union at
+ * `src/telemetry.ts:27-210`. Thirty-eight predate the #2029 contract; the 39th is
  * `agent_conflict_detected` (previously emitted through a force-cast past the
  * type system), the 40th is `close_archive_result` (issue #2030 — the
  * structured close/archive result event), the 41st is the bounded diagnostic
@@ -89,7 +89,7 @@ export interface CatalogEntry {
     /**
      * Whether an event of this kind must carry `trace.parentSpanId`.
      *
-     * `false` for all 65 entries today, and that is a truthful statement about
+     * `false` for all 66 entries today, and that is a truthful statement about
      * the current system rather than a placeholder: no producer supplies a
      * parent span, so `createObservation` never sets one. Setting this to `true`
      * for a kind whose producer cannot supply a parent would make every

package/dist/telemetry.d.ts

@@ -41,7 +41,7 @@ export type TelemetryEvent = 'session_started' | 'session_ended' | 'agent_activa
  * `prm_hard_stop` TRIGGER emitted by `src/prm/escalation.ts`. A trigger with
  * no matching delivery means the containment never reached the agent.
  */
- | 'prm_hard_stop_delivered' | 'agent_conflict_detected' | 'close_archive_result' | 'knowledge_receipt_transition' | 'knowledge_maintenance' | 'residue_health' | 'context_telemetry_health' | 'skill_usage_health' | 'core_events_health' | 'shell_audit_health' | 'trajectory_health' | 'learning_health_alarm' | 'pr_subscription_health' | 'execution_attempt_recorded' | 'council_attempt' | 'council_round_transition' | 'council_attempt_unscoped' | 'context_source_attribution' | 'verdict_row_pipe_recovery' | 'training_vault_health';
+ | 'prm_hard_stop_delivered' | 'agent_conflict_detected' | 'close_archive_result' | 'knowledge_receipt_transition' | 'knowledge_maintenance' | 'residue_health' | 'context_telemetry_health' | 'skill_usage_health' | 'core_events_health' | 'shell_audit_health' | 'trajectory_health' | 'learning_health_alarm' | 'pr_subscription_health' | 'execution_attempt_recorded' | 'council_attempt' | 'council_round_transition' | 'council_attempt_unscoped' | 'context_source_attribution' | 'verdict_row_pipe_recovery' | 'training_vault_health' | 'plan_recovery_superseded';
 /** Stable classification for how a reviewer-gate decision was established. */
 export type ReviewerGateEvidenceKind = 'genuine' | 'fallback' | 'data_quality' | 'block';
 /**
@@ -527,6 +527,20 @@ export declare const telemetry: {
         token_budget_used: number;
         omitted_context_count: number;
     }): void;
+    /**
+     * Issue #2794 — plan-recovery supersession count, emitted exactly once per
+     * snapshot-coordination initialization attempt that settles superseded
+     * (settlement chokepoint in src/session/snapshot-coordination-init.ts).
+     * Counts ONLY — a within-process cumulative `count` and the closed
+     * two-value `trigger` vocabulary (`plan_recovery` = the typed
+     * PlanRecoverySupersededError path; `coordination_fence` = any
+     * generation-fence outcome) — no paths, no session or project identity,
+     * matching the observability contract's no-content-in-metrics rule.
+     */
+    planRecoverySuperseded(data: {
+        count: number;
+        trigger: "plan_recovery" | "coordination_fence";
+    }): void;
 };
 /**
  * Test-only dependency-injection seam. Production code calls

package/dist/tools/repo-map.d.ts

@@ -218,6 +218,10 @@ export declare const _internals: {
             token_budget_used: number;
             omitted_context_count: number;
         }): void;
+        planRecoverySuperseded(data: {
+            count: number;
+            trigger: "plan_recovery" | "coordination_fence";
+        }): void;
     };
 };
 export declare const repo_map: ReturnType<typeof createSwarmTool>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.187.2",
+	"version": "7.188.0",
 	"description": "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",