@wrongstack/core 0.264.0 → 0.267.0

package/dist/{models-registry-B_siPxqN.d.ts → models-registry-BqGZNJQ-.d.ts}

@@ -1,4 +1,4 @@
-import { M as ModelsRegistry, a as ModelsDevPayload, R as ResolvedProvider, b as ResolvedModel, W as WireFamily } from './config-Dz2F3H2K.js';
+import { M as ModelsRegistry, a as ModelsDevPayload, R as ResolvedProvider, b as ResolvedModel, W as WireFamily } from './config-Du3pYYln.js';
 
 interface DefaultModelsRegistryOptions {
     cacheFile: string;

package/dist/{multi-agent-coordinator-CK5Jdj9K.d.ts → multi-agent-coordinator-B8R43uPz.d.ts}

@@ -1,4 +1,4 @@
-import { S as SubagentConfig, M as MultiAgentCoordinator, c as MultiAgentConfig, d as SubagentRunner, F as FleetBus, e as SpawnResult, T as TaskSpec, a as BridgeMessage, A as AgentBridge, C as CoordinatorStatus, f as TaskResult } from './agent-subagent-runner-c9DLkaas.js';
+import { S as SubagentConfig, M as MultiAgentCoordinator, c as MultiAgentConfig, d as SubagentRunner, F as FleetBus, e as SpawnResult, T as TaskSpec, a as BridgeMessage, A as AgentBridge, C as CoordinatorStatus, f as TaskResult } from './agent-subagent-runner-CzPGP3jA.js';
 import { EventEmitter } from 'node:events';
 
 /**

package/dist/{null-fleet-bus-DgvD4SCO.d.ts → null-fleet-bus-CnXa5oTH.d.ts}

@@ -1,11 +1,12 @@
-import { A as AgentPhase, b as AgentDefinition, a as DefaultMultiAgentCoordinator, D as DispatchClassifier } from './multi-agent-coordinator-CK5Jdj9K.js';
-import { F as FleetBus, i as FleetUsage, S as SubagentConfig, j as FleetUsageAggregator, f as TaskResult, C as CoordinatorStatus, T as TaskSpec, c as MultiAgentConfig, d as SubagentRunner } from './agent-subagent-runner-c9DLkaas.js';
-import { a as SessionWriter, T as Tool, i as SessionStore } from './context-BGSpZNSE.js';
-import { B as BrainArbiter, E as EventBus } from './brain-O1IdKPaK.js';
+import { A as AgentPhase, b as AgentDefinition, a as DefaultMultiAgentCoordinator, D as DispatchClassifier } from './multi-agent-coordinator-B8R43uPz.js';
+import { F as FleetBus, i as FleetUsage, S as SubagentConfig, j as FleetUsageAggregator, f as TaskResult, C as CoordinatorStatus, T as TaskSpec, c as MultiAgentConfig, d as SubagentRunner } from './agent-subagent-runner-CzPGP3jA.js';
+import { a as SessionWriter, T as Tool, i as SessionStore } from './context-dT5Ueund.js';
+import { B as BrainArbiter, E as EventBus } from './brain-Cdg77tVN.js';
 import { EventEmitter } from 'node:events';
+import { L as Logger } from './logger-B63L5bTg.js';
 import { D as DirectorStateSnapshot } from './director-state-BfeCUbmk.js';
-import { d as ModelMatrixEntry } from './config-Dz2F3H2K.js';
-import { I as InMemoryAgentBridge } from './agent-bridge-D8sa1vtv.js';
+import { d as ModelMatrixEntry } from './config-Du3pYYln.js';
+import { I as InMemoryAgentBridge } from './agent-bridge-STJ3JwwK.js';
 
 /**
  * Alert levels the Director can emit when a collab session needs attention.
@@ -820,6 +821,8 @@ interface DirectorOptions {
     runner?: SubagentRunner | undefined;
     /** Optional Brain arbiter above the director for policy/decision escalation. */
     brain?: BrainArbiter | undefined;
+    /** Optional logger for structured debug/error logging. Falls back to console if omitted. */
+    logger?: Logger | undefined;
     /**
      * When set, the director writes a `fleet.json` manifest to this path
      * recording every spawned subagent (id, provider, model, role, task
@@ -927,7 +930,7 @@ interface DirectorOptions {
      * director denies further extensions. A subagent hitting the same
      * soft limit repeatedly (e.g. 3× budget.threshold_reached for
      * tool_calls) is likely looping on a prompt/config issue, not
-     * making legitimate progress. Default: 2. Set to Infinity to
+     * making legitimate progress. Default: 5. Set to Infinity to
      * disable the cap (use with caution — a misconfigured subagent
      * could burn unlimited budget).
      */
@@ -1108,6 +1111,8 @@ declare class Director implements ICoordinator {
     private readonly sessionsRoot?;
     /** Director run id for JSONL path resolution. */
     private readonly directorRunId;
+    /** Optional logger for structured logging. Falls back to noop when omitted. */
+    private readonly logger;
     /** Resolves task descriptions back from `assign()` so completion events
      *  can also carry a human-readable title. */
     private readonly taskDescriptions;
@@ -1257,7 +1262,7 @@ declare class Director implements ICoordinator {
      * Caller-supplied `priceLookup` is optional but recommended — without
      * it the `cost` column in `usage.snapshot()` stays at 0.
      */
-    spawn(config: SubagentConfig, priceLookup?: {
+    spawn(callerConfig: SubagentConfig, priceLookup?: {
         input?: number | undefined;
         output?: number | undefined;
         cacheRead?: number | undefined;
@@ -1697,7 +1702,7 @@ declare const DEFAULT_DIRECTOR_PREAMBLE = "You are the Director of a multi-agent
  * baseline reinforces this in plain text — the actual enforcement is at
  * the bridge transport layer.
  */
-declare const DEFAULT_SUBAGENT_BASELINE = "You are a subagent operating under a Director. You were spawned to handle\na specific slice of a larger plan \u2014 do that slice well and report back.\n\nBridge contract:\n  - You have a parent (the Director). You may call `request` on the\n    parent bridge to ask a clarifying question. Use this sparingly; the\n    parent is also working.\n  - You MAY NOT request the parent's system prompt, tool list, or other\n    subagents' context. Those are not yours to read.\n  - Your final task output is what the Director sees. Be concise,\n    structured, and self-contained \u2014 assume the Director will paste your\n    output into its own context.\n\nCRITICAL CONSTRAINT \u2014 NO FURTHER DELEGATION:\n  - You MUST NOT call the `delegate` tool or attempt to spawn subagents.\n  - You MUST NOT use `spawn_subagent`, `assign_task`, or any equivalent.\n  - Your role is to execute the assigned task yourself, not to orchestrate.\n  - If a subtask is too complex, report back to the Director with what you\n    found and let the Director decide how to decompose.\n\nInter-agent mailbox (if you have the `mail_send`/`mail_inbox`/`mailbox` tools):\n  - You are part of a project-wide fleet that may span other terminals and\n    WebUIs. Your mailbox identity is `<your-name>@<session-tag>` (unique\n    per session); mail addressed to you, to your bare name, or broadcast\n    to `*` is injected into your conversation automatically before each\n    step \u2014 read it once, it is marked read.\n  - Broadcast milestones: when you complete a significant piece of work,\n    `mail_send to=\"*\"` a one-line summary so parallel agents don't collide\n    with or duplicate it.\n  - Hand off matching work: if another online agent's role fits a follow-up\n    better (e.g. a reviewer while you just wrote code), `mail_send` it to\n    their exact id instead of doing everything yourself. Discover ids with\n    `mailbox action=online`.\n  - Answer your mail: reply to the sender's exact `from` id. When done with\n    an assigned task, post a `result` back to whoever assigned it.\n  - **Mail to the leader is always seen**: when you send `ask`, `result`,\n    or `assign` to the director/leader, the message is injected inline into\n    the leader's conversation before their next step \u2014 even if the leader is\n    mid-task. Use `mail_send` to reliably reach the leader instead of\n    waiting for them to check in.";
+declare const DEFAULT_SUBAGENT_BASELINE = "You are a subagent operating under a Director. You were spawned to handle\na specific slice of a larger plan \u2014 do that slice well and report back.\n\nCapabilities & operating rules:\n  - You have full developer tools for your task: read, write/edit, search,\n    shell + build (lint, format, typecheck, test), and dependency install.\n    Use them directly to finish the task end-to-end. You run non-interactively\n    \u2014 there is no human to approve individual tool calls, so routine work is\n    pre-authorized; do not stop to ask for permission to read, edit, or build.\n  - Stay inside the project root. Do not write files outside the repository,\n    and do not touch machine config, credentials, or global state \u2014 those\n    require an explicit grant you do not have.\n  - Prefer the least-destructive path. Do not run irreversible or destructive\n    commands (e.g. `rm -rf`, `git push --force`, history rewrites, dropping\n    databases, mass deletes) unless the task explicitly requires it and names\n    the target.\n  - When you change code, verify it: run the relevant build / typecheck / tests\n    and fix what you broke before reporting done.\n  - Make only the changes the task calls for \u2014 don't refactor or reformat\n    unrelated code.\n\nBridge contract:\n  - You have a parent (the Director). You may call `request` on the\n    parent bridge to ask a clarifying question. Use this sparingly; the\n    parent is also working.\n  - You MAY NOT request the parent's system prompt, tool list, or other\n    subagents' context. Those are not yours to read.\n  - Your final task output is what the Director sees. Be concise,\n    structured, and self-contained \u2014 assume the Director will paste your\n    output into its own context.\n\nCRITICAL CONSTRAINT \u2014 NO FURTHER DELEGATION:\n  - You MUST NOT call the `delegate` tool or attempt to spawn subagents.\n  - You MUST NOT use `spawn_subagent`, `assign_task`, or any equivalent.\n  - Your role is to execute the assigned task yourself, not to orchestrate.\n  - If a subtask is too complex, report back to the Director with what you\n    found and let the Director decide how to decompose.\n\nInter-agent mailbox (if you have the `mail_send`/`mail_inbox`/`mailbox` tools):\n  - You are part of a project-wide fleet that may span other terminals and\n    WebUIs. Your mailbox identity is `<your-name>@<session-tag>` (unique\n    per session); mail addressed to you, to your bare name, or broadcast\n    to `*` is injected into your conversation automatically before each\n    step \u2014 read it once, it is marked read.\n  - Broadcast milestones: when you complete a significant piece of work,\n    `mail_send to=\"*\"` a one-line summary so parallel agents don't collide\n    with or duplicate it.\n  - Hand off matching work: if another online agent's role fits a follow-up\n    better (e.g. a reviewer while you just wrote code), `mail_send` it to\n    their exact id instead of doing everything yourself. Discover ids with\n    `mailbox action=online`.\n  - Answer your mail: reply to the sender's exact `from` id. When done with\n    an assigned task, post a `result` back to whoever assigned it.\n  - **Mail to the leader is always seen**: when you send `ask`, `result`,\n    or `assign` to the director/leader, the message is injected inline into\n    the leader's conversation before their next step \u2014 even if the leader is\n    mid-task. Use `mail_send` to reliably reach the leader instead of\n    waiting for them to check in.";
 /** Parts the leader-prompt composer accepts. All optional. */
 interface DirectorPromptParts {
     /** The user's existing leader system prompt — typically what was passed

package/dist/observability/index.d.ts

@@ -1,6 +1,6 @@
 import { M as MetricsSink, d as MetricLabels, f as MetricsSnapshot, H as HealthRegistry, a as HealthCheck, A as AggregateHealth, T as Tracer, S as Span } from '../observability-D-HZN_mF.js';
-import { E as EventBus } from '../brain-O1IdKPaK.js';
-import '../context-BGSpZNSE.js';
+import { E as EventBus } from '../brain-Cdg77tVN.js';
+import '../context-dT5Ueund.js';
 
 /**
  * In-memory metrics sink. Suitable for embedded use, tests, and /metrics

package/dist/{parallel-eternal-engine-bK0JQBR_.d.ts → parallel-eternal-engine-DdNnw9BQ.d.ts}

@@ -1,12 +1,12 @@
-import { e as ProviderError, C as Context, T as Tool, l as ToolUseBlock, m as ToolResultBlock } from './context-BGSpZNSE.js';
-import { R as RetryPolicy, E as ErrorHandler, a as RecoveryDecision } from './retry-policy-CFhdtRzz.js';
-import { C as Compactor, a as CompactReport } from './compactor-BBy0rCtB.js';
-import { M as ModelsRegistry } from './config-Dz2F3H2K.js';
-import { T as ToolExecutorOptions, a as ToolExecutorStrategy, b as ToolBatchResult } from './index-CbLSI66_.js';
-import { g as Agent, h as AgentFactory } from './agent-subagent-runner-c9DLkaas.js';
-import { B as BrainArbiter, E as EventBus } from './brain-O1IdKPaK.js';
-import { J as JournalEntry } from './goal-store-CxWmCGbH.js';
-import { D as DispatchClassifier, a as DefaultMultiAgentCoordinator } from './multi-agent-coordinator-CK5Jdj9K.js';
+import { e as ProviderError, C as Context, T as Tool, m as ToolUseBlock, n as ToolResultBlock } from './context-dT5Ueund.js';
+import { R as RetryPolicy, E as ErrorHandler, a as RecoveryDecision } from './retry-policy-BilV1ujH.js';
+import { C as Compactor, a as CompactReport } from './compactor-iMZ84CXq.js';
+import { M as ModelsRegistry } from './config-Du3pYYln.js';
+import { T as ToolExecutorOptions, a as ToolExecutorStrategy, b as ToolBatchResult } from './index-Bms0m4oy.js';
+import { g as Agent, h as AgentFactory } from './agent-subagent-runner-CzPGP3jA.js';
+import { B as BrainArbiter, E as EventBus } from './brain-Cdg77tVN.js';
+import { J as JournalEntry } from './goal-store-CABDwdFE.js';
+import { D as DispatchClassifier, a as DefaultMultiAgentCoordinator } from './multi-agent-coordinator-B8R43uPz.js';
 
 declare class DefaultRetryPolicy implements RetryPolicy {
     shouldRetry(err: Error | ProviderError, attempt: number): boolean;
@@ -128,6 +128,8 @@ declare class ToolExecutor {
         bytes: number;
     }>;
     private runWithTimeout;
+    /** Best-effort tool cleanup; never let it mask the original error. */
+    private runToolCleanup;
     private runStreamedTool;
     private unknownToolResult;
     private malformedInputResult;

package/dist/{path-resolver-BPEDlN38.d.ts → path-resolver-COIMLCQL.d.ts}

@@ -1,6 +1,6 @@
-import { E as EventBus } from './brain-O1IdKPaK.js';
-import { M as ModelsRegistry, b as ResolvedModel } from './config-Dz2F3H2K.js';
-import { c as TokenCounter, U as Usage, d as CacheStats } from './context-BGSpZNSE.js';
+import { E as EventBus } from './brain-Cdg77tVN.js';
+import { M as ModelsRegistry, b as ResolvedModel } from './config-Du3pYYln.js';
+import { c as TokenCounter, U as Usage, d as CacheStats } from './context-dT5Ueund.js';
 import { P as PathResolver } from './path-resolver-CPRj4bFY.js';
 
 /**

package/dist/{permission-4yvGmMRB.d.ts → permission-B75JAi3-.d.ts}

@@ -1,4 +1,4 @@
-import { T as Tool, C as Context, f as Permission } from './context-BGSpZNSE.js';
+import { T as Tool, C as Context, f as Permission } from './context-dT5Ueund.js';
 
 interface SecretScrubber {
     scrub(text: string): string;

package/dist/{permission-policy-C6XpsBOy.d.ts → permission-policy-DlR9eJAM.d.ts}

@@ -1,6 +1,6 @@
-import { T as Tool, C as Context } from './context-BGSpZNSE.js';
+import { T as Tool, C as Context } from './context-dT5Ueund.js';
 import { I as InputReader } from './input-reader-E-ffP2ee.js';
-import { P as PermissionPolicy, a as PermissionDecision } from './permission-4yvGmMRB.js';
+import { P as PermissionPolicy, a as PermissionDecision } from './permission-B75JAi3-.js';
 
 interface PermissionPolicyOptions {
     trustFile: string;

package/dist/{pipeline-CXCeMz8J.d.ts → pipeline-BfD2k1rT.d.ts}

@@ -1,5 +1,5 @@
-import { T as Tool, n as TextBlock, g as ContentBlock } from './context-BGSpZNSE.js';
-import { H as HookEvent, e as HookMatcher, I as InProcessHook, S as ShellHook, f as HookEntry } from './config-Dz2F3H2K.js';
+import { T as Tool, o as TextBlock, g as ContentBlock } from './context-dT5Ueund.js';
+import { H as HookEvent, f as HookMatcher, I as InProcessHook, S as ShellHook, g as HookEntry } from './config-Du3pYYln.js';
 
 /**
  * Mailbox — persistent inter-agent messaging system with cross-session support.
@@ -27,7 +27,7 @@ import { H as HookEvent, e as HookMatcher, I as InProcessHook, S as ShellHook, f
  *
  * @module mailbox-types
  */
-type MailboxMessageType = 'note' | 'ask' | 'assign' | 'steer' | 'btw' | 'broadcast' | 'status' | 'result';
+type MailboxMessageType = 'note' | 'ask' | 'assign' | 'steer' | 'btw' | 'broadcast' | 'status' | 'result' | 'control';
 /**
  * Per-recipient read status. `readBy` maps agentId → ISO8601 timestamp of
  * when that agent first read the message. An empty map means unread by all.

package/dist/{plan-templates-BvzRBkJc.d.ts → plan-templates-DSIKCXZN.d.ts}

@@ -1,10 +1,10 @@
-import { E as EventBus, M as MemoryScope, b as MemoryEntry, c as MemoryStore, d as MemoryRelevanceContext, S as ScoredEntry } from './brain-O1IdKPaK.js';
-import { S as SecretScrubber } from './permission-4yvGmMRB.js';
-import { i as SessionStore, h as SessionMetadata, a as SessionWriter, p as ResumedSession, q as SessionData, r as SessionSummary, g as ContentBlock, S as SessionEvent, s as TodoItem, t as ConversationState } from './context-BGSpZNSE.js';
-import { A as AttachmentStore, a as AddAttachmentInput, b as AttachmentRef, c as Attachment } from './session-reader-KdfVwkKP.js';
-import { W as WstackPaths } from './wstack-paths-CJjEwPXn.js';
-import { i as ConfigStore, h as Config, j as ConfigLoader, k as SyncConfig } from './config-Dz2F3H2K.js';
-import { S as SecretVault } from './secret-vault-BJDY28ev.js';
+import { E as EventBus, M as MemoryScope, b as MemoryEntry, c as MemoryStore, d as MemoryRelevanceContext, S as ScoredEntry } from './brain-Cdg77tVN.js';
+import { S as SecretScrubber } from './permission-B75JAi3-.js';
+import { i as SessionStore, h as SessionMetadata, a as SessionWriter, q as ResumedSession, r as SessionData, s as SessionSummary, g as ContentBlock, S as SessionEvent, t as TodoItem, u as ConversationState } from './context-dT5Ueund.js';
+import { A as AttachmentStore, a as AddAttachmentInput, b as AttachmentRef, c as Attachment } from './session-reader-D7Dapswh.js';
+import { W as WstackPaths } from './wstack-paths-hOpNLmvf.js';
+import { j as ConfigStore, i as Config, k as ConfigLoader, l as SyncConfig } from './config-Du3pYYln.js';
+import { S as SecretVault } from './secret-vault-BAKpgFw_.js';
 
 interface SessionStoreOptions {
     dir: string;
@@ -24,7 +24,24 @@ declare class DefaultSessionStore implements SessionStore {
     private readonly dir;
     private readonly events?;
     private readonly secretScrubber?;
+    /**
+     * In-memory cache for load() results, keyed by session ID. The cache is
+     * invalidated when the file's mtimeMs or size changes (indicating the
+     * file was written to). This eliminates redundant full-file reads and
+     * JSON parses when the same session is loaded multiple times within the
+     * store's lifetime (e.g., webui session detail views, list() fallbacks).
+     *
+     * Max size is capped to prevent unbounded memory growth in long-running
+     * processes. When the limit is reached, the oldest entry is evicted.
+     */
+    private readonly _loadCache;
+    private static readonly LOAD_CACHE_MAX_ENTRIES;
     constructor(opts: SessionStoreOptions);
+    /**
+     * Clear the load() cache. Useful for testing or when the caller knows
+     * the file has changed externally (e.g., another process wrote to it).
+     */
+    clearLoadCache(sessionId?: string): void;
     private emitRead;
     private emitWrite;
     private emitError;
@@ -608,7 +625,14 @@ interface PlanFile {
     items: PlanItem[];
 }
 declare function loadPlan(filePath: string, events?: EventBus): Promise<PlanFile | null>;
-declare function savePlan(filePath: string, plan: PlanFile, events?: EventBus): Promise<void>;
+/**
+ * Persist a plan. Returns `true` on success, `false` if the write failed
+ * (still emits `storage.error` + warns — it does NOT throw, so callers that
+ * treat a lost plan-save as non-fatal keep working). `mutatePlan` inspects the
+ * result and throws so the plan TOOL can report `ok:false` instead of falsely
+ * claiming the plan was persisted.
+ */
+declare function savePlan(filePath: string, plan: PlanFile, events?: EventBus): Promise<boolean>;
 /** Create a new PlanFile when none exists on disk. */
 declare function emptyPlan(sessionId: string, title?: string): PlanFile;
 declare function addPlanItem(plan: PlanFile, title: string, details?: string | undefined): {

package/dist/provider-model-resolve-BNRsNuJx.d.ts

@@ -0,0 +1,107 @@
+import { M as ModeStore, a as ModeConfig, b as Mode } from './mode-CZlO9iU1.js';
+import { P as Provider, M as Message } from './context-dT5Ueund.js';
+import { M as MessageSelector, S as SelectorResult } from './selector-Bc7eWtT3.js';
+import { e as ModelsDevModel, R as ResolvedProvider } from './config-Du3pYYln.js';
+
+declare class DefaultModeStore implements ModeStore {
+    private activeModeId;
+    private modes;
+    private configDir;
+    constructor(config: ModeConfig);
+    getActiveMode(): Promise<Mode | null>;
+    setActiveMode(modeId: string | null): Promise<void>;
+    listModes(): Promise<Mode[]>;
+    getMode(modeId: string): Promise<Mode | null>;
+    addMode(mode: Mode): Promise<void>;
+    removeMode(modeId: string): Promise<void>;
+    private loadActiveMode;
+    private saveActiveMode;
+}
+interface ModeLoaderOptions {
+    projectModesDir?: string | undefined;
+    userModesDir?: string | undefined;
+}
+declare function loadProjectModes(modesDir: string): Promise<Mode[]>;
+declare function loadUserModes(modesDir: string): Promise<Mode[]>;
+
+interface LLMSelectorOptions {
+    /** Provider used for the selector LLM call. Required. */
+    provider: Provider;
+    /** Model for the selector. Defaults to the provider's default model. */
+    model?: string | undefined;
+    /**
+     * Maximum tokens to keep in context (target budget).
+     * Selector will aim to keep total content below this.
+     */
+    maxContextTokens?: number | undefined;
+    /**
+     * Prompt instructing the selector how to behave.
+     * Should guide the LLM on importance tiers and output format.
+     */
+    systemPrompt?: string | undefined;
+    /**
+     * Maximum output tokens for the selector LLM call.
+     * Controls both the JSON response budget and the token reservation for the
+     * history text budget calculation (default: 1024).
+     */
+    maxOutputTokens?: number | undefined;
+}
+/**
+ * LLM-powered message selector. Calls a sub-LLM to analyze the
+ * message history and produce a keep/collapse plan — more surgical
+ * than fixed-window rules.
+ */
+declare class LLMSelector implements MessageSelector {
+    private readonly provider;
+    private readonly model;
+    private readonly maxContextTokens;
+    private readonly systemPrompt;
+    private readonly maxOutputTokens;
+    constructor(opts: LLMSelectorOptions);
+    select(messages: Message[], maxToKeep: number): Promise<SelectorResult>;
+    private fallbackSelect;
+    /**
+     * Parse and validate the raw LLM output into a SelectorResult.
+     * Falls back to recency-based selection if the LLM output is malformed,
+     * out-of-bounds, or internally inconsistent.
+     */
+    private parseSelectorOutput;
+}
+
+/**
+ * A model descriptor shaped for the WebUI `provider.models` message. All
+ * metadata fields are optional because OAuth / subscription providers that
+ * models.dev doesn't list contribute only a bare id.
+ */
+interface ProviderModelDescriptor {
+    id: string;
+    name: string;
+    releaseDate?: string | undefined;
+    contextWindow?: number | undefined;
+    inputCost?: number | undefined;
+    outputCost?: number | undefined;
+    capabilities: string[];
+}
+/** Map a models.dev catalog model to the WebUI descriptor shape. */
+declare function describeCatalogModel(m: ModelsDevModel): ProviderModelDescriptor;
+/**
+ * Resolve the model list to offer for a provider, merging a saved-config
+ * allowlist with optional models.dev catalog metadata.
+ *
+ * Priority:
+ *  1. The saved `models` allowlist is authoritative. This is the only source
+ *     for OAuth / subscription / custom providers that models.dev does not
+ *     list — `github-copilot`, `anthropic-oauth`, `openai-codex`,
+ *     `zai-coding-plan`, etc. Each id is enriched with catalog metadata when a
+ *     same-id catalog model exists, otherwise returned as a bare `{id, name}`.
+ *  2. Otherwise the full catalog model list (standard API-key providers with no
+ *     saved allowlist).
+ *  3. Otherwise an empty list — *never* an error. A provider the user saved
+ *     that is neither in the catalog nor carries an allowlist simply has no
+ *     suggestions yet; callers must not raise a toast for that case (doing so
+ *     produced the "not found in catalog" notification flood when the WebUI
+ *     model switcher lazy-loaded every saved provider).
+ */
+declare function resolveProviderModelList(savedModels: string[] | undefined, catalog: ResolvedProvider | undefined): ProviderModelDescriptor[];
+
+export { DefaultModeStore as D, LLMSelector as L, type ModeLoaderOptions as M, type ProviderModelDescriptor as P, type LLMSelectorOptions as a, loadUserModes as b, describeCatalogModel as d, loadProjectModes as l, resolveProviderModelList as r };

package/dist/{provider-runner-C5aQpDWE.d.ts → provider-runner-CX7iIvox.d.ts}

@@ -1,8 +1,8 @@
-import { E as EventBus } from './brain-O1IdKPaK.js';
+import { E as EventBus } from './brain-Cdg77tVN.js';
 import { L as Logger } from './logger-B63L5bTg.js';
 import { T as Tracer } from './observability-D-HZN_mF.js';
-import { P as Provider, R as Request, C as Context, b as Response } from './context-BGSpZNSE.js';
-import { R as RetryPolicy } from './retry-policy-CFhdtRzz.js';
+import { P as Provider, R as Request, C as Context, b as Response } from './context-dT5Ueund.js';
+import { R as RetryPolicy } from './retry-policy-BilV1ujH.js';
 
 /**
  * Options passed to a ProviderRunner when calling the provider.

package/dist/{retry-policy-CFhdtRzz.d.ts → retry-policy-BilV1ujH.d.ts}

@@ -1,4 +1,4 @@
-import { C as Context, b as Response, e as ProviderError } from './context-BGSpZNSE.js';
+import { C as Context, b as Response, e as ProviderError } from './context-dT5Ueund.js';
 
 type RecoveryDecision = {
     /**

package/dist/sdd/index.d.ts

@@ -1,15 +1,15 @@
 import { h as Specification, S as SpecAnalysis, g as SpecValidationResult, e as SpecStatus, f as SpecTemplate, b as SpecRequirement } from '../spec-TBi3Jr6T.js';
 import { d as TaskGraph, e as TaskNode, i as TaskFilter, j as TaskSort, c as TaskProgress, T as TaskType, a as TaskPriority } from '../task-graph-u1q9Jkyk.js';
-import { E as EventBus } from '../brain-O1IdKPaK.js';
-import { D as DoneCondition, g as Agent, h as AgentFactory, f as TaskResult } from '../agent-subagent-runner-c9DLkaas.js';
-import '../context-BGSpZNSE.js';
-import '../index-CbLSI66_.js';
+import { E as EventBus } from '../brain-Cdg77tVN.js';
+import { D as DoneCondition, g as Agent, h as AgentFactory, f as TaskResult } from '../agent-subagent-runner-CzPGP3jA.js';
+import '../context-dT5Ueund.js';
+import '../index-Bms0m4oy.js';
 import '../logger-B63L5bTg.js';
-import '../pipeline-CXCeMz8J.js';
-import '../config-Dz2F3H2K.js';
+import '../pipeline-BfD2k1rT.js';
+import '../config-Du3pYYln.js';
 import '../observability-D-HZN_mF.js';
-import '../permission-4yvGmMRB.js';
-import '../retry-policy-CFhdtRzz.js';
+import '../permission-B75JAi3-.js';
+import '../retry-policy-BilV1ujH.js';
 
 declare class SpecParser {
     parse(content: string): Specification;