opencode-swarm 7.187.2 → 7.187.3

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/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.187.2",
+	"version": "7.187.3",
 	"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",