opencode-swarm 7.147.0 → 7.147.1

package/dist/learning/admission.d.ts

@@ -19,7 +19,7 @@
  * - only genuinely cancellable work (the optional LLM screening call) is
  *   bounded, via a manual `AbortController` + `setTimeout` (see
  *   `timeoutSignal` below) + `isAbortError`. This deliberately does NOT use
- *   `AbortSignal.timeout(...)` (unlike `micro-reflector.ts`): Bun on Windows
+ *   the host's built-in timeout signal: Bun on Windows
  *   has a native bug where that signal's `abort` event never fires when
  *   awaited by a plain JS Promise (oven-sh/bun#29546) — exactly the shape
  *   `screenCandidate`'s caller uses — which hung this file's own tests for

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

@@ -0,0 +1,47 @@
+export interface ModelOverrideParts {
+    providerID: string;
+    modelID: string;
+}
+export interface ScopedModelOverrideKey {
+    sessionID: string;
+    invocationID: string;
+    role: string;
+    swarmID?: string;
+}
+export interface NormalizedModelChain {
+    readonly primary?: {
+        modelString: string;
+        override: ModelOverrideParts;
+    };
+    readonly fallbacks: readonly {
+        modelString: string;
+        override: ModelOverrideParts;
+    }[];
+    readonly signature: string;
+    readonly totalModels: number;
+}
+export interface ScopedModelSelection {
+    readonly generation: number;
+    readonly fallbackIndex: number;
+    readonly modelString?: string;
+    readonly model?: ModelOverrideParts;
+    readonly exhausted: boolean;
+    readonly totalModels: number;
+}
+export interface ScopedModelAdvanceResult {
+    readonly accepted: boolean;
+    readonly selection: ScopedModelSelection;
+}
+export interface ScopedModelSelectionSnapshotEntry {
+    readonly key: ScopedModelOverrideKey;
+    readonly generation: number;
+    readonly fallbackIndex: number;
+    readonly updatedAt: number;
+}
+export declare function normalizeModelChain(primaryModel: string | undefined, fallbackModels: Iterable<string | null | undefined>): NormalizedModelChain;
+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;
+export declare function getScopedModelSelectionSnapshot(): readonly ScopedModelSelectionSnapshotEntry[];
+export declare function resetScopedModelSelectionStateForTests(): void;

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

@@ -0,0 +1,71 @@
+import { getScopedModelSelectionSnapshot, type ModelOverrideParts, type ScopedModelOverrideKey } from './model-override-state.js';
+export interface PendingTaskModelRouteInput {
+    parentSessionID: string;
+    invocationID: string;
+    callID: string;
+    role: string;
+    actionDigest: string;
+    swarmID?: string;
+}
+export interface BindTaskModelRouteChildInput {
+    parentSessionID: string;
+    callID: string;
+    childSessionID: string;
+}
+export interface AdvanceTaskModelRouteInput {
+    childSessionID: string;
+    role: string;
+    actionDigest: string;
+    primaryModel?: string;
+    fallbackModels?: Iterable<string | null | undefined>;
+    expectedGeneration?: number;
+    now?: number;
+}
+export interface ResolveTaskChatModelOverrideInput {
+    childSessionID: string;
+    role: string;
+    primaryModel?: string;
+    fallbackModels?: Iterable<string | null | undefined>;
+    actionDigest?: string;
+    lookupParentSessionID?: (childSessionID: string) => Promise<string | undefined>;
+    now?: number;
+}
+export interface TaskChatModelOverrideResolution {
+    status: 'override' | 'primary' | 'exhausted' | 'missing' | 'ambiguous' | 'mismatch';
+    model?: ModelOverrideParts;
+    modelString?: string;
+    fallbackIndex?: number;
+    generation?: number;
+    scope?: ScopedModelOverrideKey;
+    route?: PendingTaskModelRouteSnapshotEntry;
+}
+export interface TaskModelRouteAdvanceResult {
+    accepted: boolean;
+    exhausted: boolean;
+    fallbackIndex: number;
+    generation: number;
+    scope: ScopedModelOverrideKey;
+    route?: PendingTaskModelRouteSnapshotEntry;
+}
+export interface PendingTaskModelRouteSnapshotEntry {
+    parentSessionID: string;
+    invocationID: string;
+    callID: string;
+    role: string;
+    actionDigest: string;
+    swarmID?: string;
+    childSessionID?: string;
+    updatedAt: number;
+}
+export declare function registerPendingTaskModelRoute(input: PendingTaskModelRouteInput, now?: number): PendingTaskModelRouteSnapshotEntry;
+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 declare function getPendingTaskModelRouteSnapshot(): readonly PendingTaskModelRouteSnapshotEntry[];
+export declare function getTaskModelRoutingStateSnapshot(): {
+    routes: readonly PendingTaskModelRouteSnapshotEntry[];
+    scopedSelections: ReturnType<typeof getScopedModelSelectionSnapshot>;
+};
+export declare function clearAllTaskModelRoutingState(): void;
+export declare const resetTaskModelRoutingStateForTests: typeof clearAllTaskModelRoutingState;

package/dist/services/diagnose-service.d.ts

@@ -35,7 +35,7 @@ export declare function resolveGrammarDir(thisDir: string): string;
  * Get diagnose data from the swarm directory.
  * Returns structured health checks for GUI, background flows, or commands.
  */
-export declare function getDiagnoseData(directory: string): Promise<DiagnoseData>;
+export declare function getDiagnoseData(directory: string, sessionID?: string): Promise<DiagnoseData>;
 /**
  * Format diagnose data as markdown for command output.
  */
@@ -44,4 +44,4 @@ export declare function formatDiagnoseMarkdown(diagnose: DiagnoseData): string;
  * Handle diagnose command - delegates to service and formats output.
  * Kept for backward compatibility - thin adapter.
  */
-export declare function handleDiagnoseCommand(directory: string, _args: string[]): Promise<string>;
+export declare function handleDiagnoseCommand(directory: string, _args: string[], sessionID?: string): Promise<string>;

package/dist/tools/dispatch-lanes.d.ts

@@ -217,6 +217,10 @@ export interface SessionOps {
         };
         body: {
             agent: string;
+            model?: {
+                providerID: string;
+                modelID: string;
+            };
             tools: ReadOnlyToolPermissions;
             parts: Array<{
                 type: 'text';
@@ -242,6 +246,10 @@ export interface SessionOps {
         };
         body: {
             agent: string;
+            model?: {
+                providerID: string;
+                modelID: string;
+            };
             tools: ReadOnlyToolPermissions;
             parts: Array<{
                 type: 'text';

package/dist/utils/model-dispatch-fallback.d.ts

@@ -1,3 +1,4 @@
+import { type ScopedModelOverrideKey } from '../models/model-override-state.js';
 /**
  * Issue #1896 (sub-issue 3): shared model-fallback dispatch helper.
  *
@@ -10,14 +11,7 @@
  * All those stages dispatch via `client.session.prompt({ body: { agent, model }})`,
  * which accepts a per-call `model: {providerID, modelID}` override. This helper
  * wraps such a dispatch with (a) bounded, per-model transient retry and (b)
- * model-fallback advance — kept INDEPENDENT per AGENTS.md invariant #9. The
- * fallback index is owned LOCALLY here: every stage dispatches into an ephemeral
- * child session, so the only reachable `session.model_fallback_index` belongs to
- * the parent orchestrator (a different agent) and must not be reused.
- *
- * The helper does NOT import `src/agents/index.ts` (avoids a heavy import cycle);
- * the caller injects a `resolveFallback(index)` closure that wraps
- * `resolveFallbackModel(baseRole, index, getSwarmAgents(swarmId))`.
+ * model-fallback advance — kept INDEPENDENT per AGENTS.md invariant #9.
  */
 /** Per-call model override shape accepted by `client.session.prompt` body. */
 export interface ModelOverride {
@@ -41,19 +35,29 @@ export interface ModelFallbackResult<T> {
 }
 export interface DispatchWithModelFallbackOptions<T> {
     /** Dispatch using `model` (undefined = the agent's registered/primary model). */
-    dispatch: (model: ModelOverride | undefined) => Promise<T>;
+    dispatch: (model: ModelOverride | undefined, context: {
+        attemptNumber: number;
+        fallbackIndex: number;
+        modelString?: string;
+        remainingMs?: number;
+        generation?: number;
+    }) => Promise<T>;
     /**
      * Resolve the 1-based fallback model as a `provider/model` string, or null
      * when the fallback chain is exhausted. Typically wraps
      * `resolveFallbackModel(baseRole, index, getSwarmAgents(swarmId))`.
      */
-    resolveFallback: (fallbackIndex: number) => string | null;
+    resolveFallback?: (fallbackIndex: number) => string | null;
     /** Classify a dispatch error: 'transient' → retry/failover; 'permanent' → throw immediately. */
     classify: (error: unknown) => 'transient' | 'permanent';
     /** Bounded transient retries on the SAME model before advancing (invariant #9 — independent of fallback). Default 1. */
     maxTransientRetriesPerModel?: number;
     /** Backoff before a same-model retry (NOT before a fallback advance). Default 2**(n-1)*1000 ms. */
     backoffMs?: (retryAttempt: number) => number;
+    /** Absolute wall-clock deadline in Unix ms shared across dispatch, retry, and backoff. */
+    deadlineAtMs?: number;
+    /** Hard cap across all attempts, independent of retry/fallback structure. */
+    maxAttempts?: number;
     /** Notified when advancing to a fallback model (for advisory/telemetry). */
     onFallback?: (info: {
         toModel: string;
@@ -61,7 +65,24 @@ export interface DispatchWithModelFallbackOptions<T> {
     }) => void;
     /** DI for tests (avoid real waits). */
     sleep?: (ms: number) => Promise<void>;
+    /** Clock injection for deadline tests. */
+    now?: () => number;
+    /**
+     * Optional scoped override contract for direct role-bound dispatch paths.
+     * When supplied together with a primary model and fallback chain, model
+     * selection is keyed by session/invocation/swarm/role and reset on success.
+     */
+    scope?: ScopedModelOverrideKey;
+    primaryModel?: string;
+    fallbackModels?: Iterable<string | null | undefined>;
+}
+export declare class ModelDispatchTimeoutError extends Error {
+    constructor(message?: string);
 }
+export declare const _internals: {
+    setTimeout: typeof setTimeout;
+    clearTimeout: typeof clearTimeout;
+};
 /**
  * Try the primary model, then each configured fallback, retrying transient
  * failures a bounded number of times per model. A permanent failure throws

package/dist/utils/timeout.d.ts

@@ -1,10 +1,10 @@
 /**
  * Timeout primitives used by the plugin init path.
  *
- * Deadline timers must call `unref()` and every Promise.race must clear its
- * timer in `finally`, so timeouts never pin or leak a process handle. Awaited
- * cooperative-yield timers are deliberately ref'ed: unref'ing the only handle
- * can strand their caller before the awaited promise resolves.
+ * Every Promise.race clears its timer in `finally`, so completed operations do
+ * not leak a process handle. A timer that is itself required to settle an
+ * awaited promise remains ref'ed: Bun can strand that caller when its only
+ * settlement handle is unref'ed.
  */
 /**
  * Race a promise against a timeout. The timer is cleared in `finally` so the
@@ -17,6 +17,20 @@
  * @param timeoutError   Error thrown when the deadline elapses.
  */
 export declare function withTimeout<T>(promise: Promise<T>, ms: number, timeoutError: Error): Promise<T>;
+/**
+ * Race a cancellable operation against a timeout while also supplying an
+ * `AbortSignal` that is tripped when the deadline elapses.
+ *
+ * This is the shared helper for cross-platform request/LLM timeouts: callers
+ * get a real abort signal for cooperative cancellation, but the outer race
+ * still returns if the callee ignores that signal.
+ */
+export declare function withTimeoutSignal<T>(operation: (signal: AbortSignal) => Promise<T>, ms: number, timeoutError: Error): Promise<T>;
+/** Dependency-injection seam for deterministic timer-cleanup tests. */
+export declare const _internals: {
+    setTimeout: typeof setTimeout;
+    clearTimeout: typeof clearTimeout;
+};
 /**
  * Yield to the macrotask queue. Works under both Node and Bun runtimes,
  * unlike `setImmediate` which is Node-only. The timer intentionally remains

package/package.json

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

package/dist/cli/curator-llm-factory-7cm4494k.js

@@ -1,64 +0,0 @@
-// @bun
-import {
-  createCuratorLLMDelegate
-} from "./index-92r9z3yk.js";
-import"./index-hcb25p12.js";
-import"./index-b67y7an8.js";
-import"./index-yq1fxahj.js";
-import"./index-at1m1k5k.js";
-import"./index-p3k155dv.js";
-import"./index-134d35c1.js";
-import"./index-abtrcs16.js";
-import"./index-y8552snf.js";
-import"./index-6c17bqbj.js";
-import"./index-tya6ytex.js";
-import"./index-70ha9e09.js";
-import"./index-c8s9a3zh.js";
-import"./index-9ss2m4rs.js";
-import"./index-z9yhhk6q.js";
-import"./index-3p4wgm0d.js";
-import"./index-20ndbsmh.js";
-import"./index-bgefx261.js";
-import"./index-tp5ytzzg.js";
-import"./index-rtry5xyf.js";
-import"./index-zsrtt42s.js";
-import"./index-rpy0bent.js";
-import"./index-e1pxav9g.js";
-import"./index-argd4rp4.js";
-import"./index-k5ng170v.js";
-import"./index-ms46zgwb.js";
-import"./index-hmssmyvh.js";
-import"./index-556ja8an.js";
-import"./index-b43rt5ph.js";
-import"./index-wx8zdh4a.js";
-import"./index-3g0xk6tk.js";
-import"./index-85gkedsf.js";
-import"./index-er61pycf.js";
-import"./index-w4ybhzyg.js";
-import"./index-yjvtk1w2.js";
-import"./index-gprxjmm7.js";
-import"./index-n832052r.js";
-import"./index-mfmegbz2.js";
-import"./index-sh8xbyca.js";
-import"./index-cpg98bh1.js";
-import"./index-9e6fdz2h.js";
-import"./index-4rhhvd1a.js";
-import"./index-w8pgjr75.js";
-import"./index-z6xqpmqg.js";
-import"./index-zj6t9zgx.js";
-import"./index-zjygnfay.js";
-import"./index-ae75rja9.js";
-import"./index-f75qjtn5.js";
-import"./index-8py21zn6.js";
-import"./index-bk5tah7q.js";
-import"./index-hw1yghpg.js";
-import"./index-6q35swn2.js";
-import"./index-q81s0m8k.js";
-import"./index-7g4c7s5r.js";
-import"./index-bpmtbmy9.js";
-import"./index-ed5ykebp.js";
-import"./index-zgwm4ryv.js";
-import"./index-a76rekgs.js";
-export {
-  createCuratorLLMDelegate
-};

package/dist/cli/guardrail-explain-my9zj5pj.js

@@ -1,65 +0,0 @@
-// @bun
-import {
-  handleGuardrailExplain
-} from "./index-mdwvn7qe.js";
-import"./index-92r9z3yk.js";
-import"./index-hcb25p12.js";
-import"./index-b67y7an8.js";
-import"./index-yq1fxahj.js";
-import"./index-at1m1k5k.js";
-import"./index-p3k155dv.js";
-import"./index-134d35c1.js";
-import"./index-abtrcs16.js";
-import"./index-y8552snf.js";
-import"./index-6c17bqbj.js";
-import"./index-tya6ytex.js";
-import"./index-70ha9e09.js";
-import"./index-c8s9a3zh.js";
-import"./index-9ss2m4rs.js";
-import"./index-z9yhhk6q.js";
-import"./index-3p4wgm0d.js";
-import"./index-20ndbsmh.js";
-import"./index-bgefx261.js";
-import"./index-tp5ytzzg.js";
-import"./index-rtry5xyf.js";
-import"./index-zsrtt42s.js";
-import"./index-rpy0bent.js";
-import"./index-e1pxav9g.js";
-import"./index-argd4rp4.js";
-import"./index-k5ng170v.js";
-import"./index-ms46zgwb.js";
-import"./index-hmssmyvh.js";
-import"./index-556ja8an.js";
-import"./index-b43rt5ph.js";
-import"./index-wx8zdh4a.js";
-import"./index-3g0xk6tk.js";
-import"./index-85gkedsf.js";
-import"./index-er61pycf.js";
-import"./index-w4ybhzyg.js";
-import"./index-yjvtk1w2.js";
-import"./index-gprxjmm7.js";
-import"./index-n832052r.js";
-import"./index-mfmegbz2.js";
-import"./index-sh8xbyca.js";
-import"./index-cpg98bh1.js";
-import"./index-9e6fdz2h.js";
-import"./index-4rhhvd1a.js";
-import"./index-w8pgjr75.js";
-import"./index-z6xqpmqg.js";
-import"./index-zj6t9zgx.js";
-import"./index-zjygnfay.js";
-import"./index-ae75rja9.js";
-import"./index-f75qjtn5.js";
-import"./index-8py21zn6.js";
-import"./index-bk5tah7q.js";
-import"./index-hw1yghpg.js";
-import"./index-6q35swn2.js";
-import"./index-q81s0m8k.js";
-import"./index-7g4c7s5r.js";
-import"./index-bpmtbmy9.js";
-import"./index-ed5ykebp.js";
-import"./index-zgwm4ryv.js";
-import"./index-a76rekgs.js";
-export {
-  handleGuardrailExplain
-};

package/dist/cli/index-wx8zdh4a.js

@@ -1,24 +0,0 @@
-// @bun
-// src/utils/timeout.ts
-async function withTimeout(promise, ms, timeoutError) {
-  let timer;
-  const timeoutPromise = new Promise((_, reject) => {
-    timer = setTimeout(() => reject(timeoutError), ms);
-    if (typeof timer.unref === "function") {
-      timer.unref();
-    }
-  });
-  try {
-    return await Promise.race([promise, timeoutPromise]);
-  } finally {
-    if (timer !== undefined)
-      clearTimeout(timer);
-  }
-}
-function yieldToEventLoop() {
-  return new Promise((resolve) => {
-    setTimeout(resolve, 0);
-  });
-}
-
-export { withTimeout, yieldToEventLoop };