opencode-swarm 7.188.5 → 7.188.6

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

@@ -43,6 +43,14 @@ export interface TaskModelRouteAdvanceResult {
     accepted: boolean;
     exhausted: boolean;
     fallbackIndex: number;
+    /**
+     * The normalized chain's model string for the advanced entry (#3029 review
+     * F-003). `fallbackIndex` counts positions in `normalizeModelChain` output
+     * (deduped, parse-filtered), so indexing the RAW fallback list by it can
+     * mismap when a fallback duplicates the primary or fails to parse. Always
+     * apply `modelString` when present.
+     */
+    modelString?: string;
     generation: number;
     scope: ScopedModelOverrideKey;
     route?: PendingTaskModelRouteSnapshotEntry;

package/dist/services/model-preflight.d.ts

@@ -164,6 +164,30 @@ export declare function runModelPreflight(config: PluginConfig | undefined, clie
  * block on 'unresolved'.
  */
 export declare function checkSingleModelResolution(model: string, client: OpencodeClient | null): Promise<ModelResolutionStatus>;
+/**
+ * Verified keyless opencode zen roster (issue #3022, captured 2026-10-02 on a
+ * clean @opencode/cli 2.0.21 container via `opencode run -m opencode/<id>`).
+ * Cross-pinned against tests/fixtures/opencode-zen-keyless-roster.json by
+ * tests/unit/config/default-models-roster-guard.test.ts. REFRESH PROCEDURE:
+ * re-run the per-id probe matrix (failures print `Model unavailable: <id>`
+ * while exiting 0 — match text, not exit codes), update BOTH this list and the
+ * fixture, then rotate src/config/constants.ts; the guard test failing after a
+ * refresh is the mechanism working.
+ */
+export declare const VERIFIED_KEYLESS_MODEL_ROSTER: readonly string[];
+/**
+ * Issue #3022 (AC4): pure, clientless roster check. Given the configured agent
+ * models (a `string[]` of model ids or a DEFAULT_AGENT_CONFIGS-shaped record of
+ * `{model, fallback_models}` entries) and a roster of known-good ids, returns
+ * one bounded warning per configured id that is NOT in the roster (deduped),
+ * and NO warnings when every id resolves. No I/O, no network — safe to run on
+ * hosts without an OpencodeClient (OpenCode v2 startup) where the
+ * catalog-backed {@link runModelPreflight} degrades to all-`unknown`.
+ */
+export declare function collectModelRosterWarnings(models: readonly string[] | Record<string, {
+    model?: string;
+    fallback_models?: string[];
+}>, roster: readonly string[]): string[];
 export declare const _internals: {
     /** Injectable seam for the SDK catalog call (tests substitute this). */
     providerList: (client: OpencodeClient) => Promise<({

package/dist/utils/provider-error-classification.d.ts

@@ -23,12 +23,28 @@ export declare const TRANSIENT_STATUS_CODES: Set<number>;
 export declare function extractStatusCode(errorMsg: string): number | null;
 /**
  * v6.33: Regex for transient model/provider errors that should trigger bounded
- * retry (and, in the dispatch paths, model fallback). Content is UNCHANGED from
- * the historical duplicated definition — quota is intentionally NOT here (see the
- * module doc + {@link QUOTA_ERROR_PATTERN}), so tool-output classifiers that
- * import this keep byte-identical behavior.
+ * retry (and, in the dispatch paths, model fallback). Quota is intentionally
+ * NOT here (see the module doc + {@link QUOTA_ERROR_PATTERN}), so tool-output
+ * classifiers that import this keep byte-identical behavior for quota tokens.
+ *
+ * Issue #3022: `model.?unavailable` added — OpenCode v2 hosts report a
+ * retired/unknown model id as `Model unavailable: <id>` (error class
+ * `SessionRunnerModel.ModelUnavailableError`, provider code `provider.no-route`).
+ * `.?` is zero-width-compatible, so the bare class name `ModelUnavailableError`
+ * matches too. This cannot fire the guardrails tool-output advisory on plain
+ * tool text: `isTransientProviderFailureText` (messages-transform) gates on the
+ * `providerFailureMarker` pre-filter first, which carries no model vocabulary.
  */
 export declare const TRANSIENT_MODEL_ERROR_PATTERN: RegExp;
+/**
+ * Issue #3022: the requested model does not exist on the provider (retired
+ * default, typo, or gated tier). Retrying the SAME model can never succeed, so
+ * {@link classifyProviderFailure} routes this vocabulary to `retry_fallback`
+ * (advance to the next fallback_models entry) rather than the generic transient
+ * branch's `retry_same`. Same loose vocabulary as the transient pattern above
+ * so bare class-name signals ("Error: ModelUnavailableError") hit this branch.
+ */
+export declare const MODEL_UNAVAILABLE_PATTERN: RegExp;
 /**
  * Issue #1896: provider quota / usage-limit / billing exhaustion — a class
  * distinct from a transient blip. It is retryable after a wait AND fallback-
@@ -61,3 +77,13 @@ export declare function isTransientProviderError(signal: string): boolean;
  * vs a generic transient failure.
  */
 export declare function isQuotaError(signal: string): boolean;
+/**
+ * True when the error class warrants a STICKY host-global model rewrite on
+ * v2 hosts (#3029 review F-002): the applied model persists on the
+ * registered agent until restart, so it must fire only for the classes
+ * where permanently rerouting the agent matches the v1 sticky fallback
+ * semantics — the retired/unavailable-model scenario the fallback chain
+ * exists for, and quota exhaustion. A single transient timeout/5xx advances
+ * only the per-session fallback selection and must not rewrite the agent.
+ */
+export declare function isStickyModelError(signal: string): boolean;

package/package.json

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