maestro-agent-sdk 0.1.37 → 0.1.39

package/dist/memory/aux-model-map.js

@@ -1,104 +1,22 @@
-/**
- * Map a main model id to the cheapest sibling on the same provider for
- * background context compaction.
- *
- * Why this exists
- * ---------------
- * `compressIfNeeded` (memory/compressor.ts) reuses the agent's main model
- * for its summary call by default. That's fine when the main model is
- * already a cheap/fast tier (Haiku, deepseek-flash, gpt-5.4-mini), but
- * pathological for the heavy tiers:
- *
- *   - gpt-5.5: a 330K-token compaction call balloons the request body to
- *     ~1.3 MB and routinely hits undici's 5-minute headersTimeout. The
- *     v0.1.28 diagnostic logs caught this in production — both the main
- *     turn *and* the aux LLM compaction call timed out on the same
- *     response cycle, leaving the loop with a prune-only fallback.
- *   - claude-opus: each compaction costs 4-8× a Haiku call for the same
- *     summary quality.
- *   - deepseek-v4-pro: same shape as gpt-5.5 — the heavy reasoning model
- *     wasted on a structural summary pass.
- *
- * The fix is one indirection: pick the cheapest sibling on the *same
- * provider* (so we don't have to swap clients) and route compaction
- * through it. Cross-provider swaps (e.g. gpt-5.5 main + Haiku aux) would
- * require the host to wire a second provider client, so we stay
- * intra-provider here and let hosts override via `AIAgentConfig.auxModel`
- * if they want something fancier.
- *
- * Returns the input unchanged when the main model is already the cheapest
- * sibling on its provider, or when we don't recognize it (foreign slugs
- * pass through so a host's custom model id doesn't get silently rewritten).
- */
-import { MODEL_CODEX_GPT5_2, MODEL_CODEX_GPT5_3_CODEX, MODEL_CODEX_GPT5_4, MODEL_CODEX_GPT5_4_MINI, MODEL_CODEX_GPT5_5, MODEL_DEEPSEEK_V4_FLASH, MODEL_DEEPSEEK_V4_PRO, MODEL_OPUS, MODEL_SONNET, } from "../platform/config.js";
-const CLAUDE_HAIKU = "claude-haiku-4-5";
-/**
- * Per-family aux model. Pinned by family, not cheapest-strictly: the host
- * picks the model it considers the right balance of summary quality and
- * latency for each provider line.
- *
- *   - Claude family → sonnet. Haiku turned out too lossy for production
- *     summary work; sonnet is the chosen aux tier even when main is opus
- *     (compaction is bounded so the cost differential is small) or when
- *     main is haiku (the floor is sonnet either way).
- *   - DeepSeek family → flash.
- *   - Codex (gpt-5.x) family → gpt-5.4-mini.
- *
- * The function stays total — callers always get a usable model id back —
- * and the same Provider client handles both main and aux, so no extra
- * client wiring is required at the host layer.
- */
+import { MODEL_DEEPSEEK_V4_FLASH, MODEL_DEEPSEEK_V4_PRO, } from "../platform/config.js";
 const AUX_MODEL_BY_MAIN = {
-    // Anthropic (Claude). Sonnet on every tier — host preference, not
-    // strictly cheapest. Haiku is intentionally avoided as an aux target
-    // because the summaries it produces dropped too much structural info
-    // for downstream resume turns.
-    [MODEL_OPUS]: MODEL_SONNET,
-    [MODEL_SONNET]: MODEL_SONNET,
-    [CLAUDE_HAIKU]: MODEL_SONNET,
-    // DeepSeek V4
     [MODEL_DEEPSEEK_V4_PRO]: MODEL_DEEPSEEK_V4_FLASH,
     [MODEL_DEEPSEEK_V4_FLASH]: MODEL_DEEPSEEK_V4_FLASH,
-    // Codex (gpt-5.x). gpt-5.4-mini is the cheapest tier accepted by the
-    // Responses endpoint, so every heavier slug routes to it.
-    [MODEL_CODEX_GPT5_5]: MODEL_CODEX_GPT5_4_MINI,
-    [MODEL_CODEX_GPT5_4]: MODEL_CODEX_GPT5_4_MINI,
-    [MODEL_CODEX_GPT5_4_MINI]: MODEL_CODEX_GPT5_4_MINI,
-    [MODEL_CODEX_GPT5_3_CODEX]: MODEL_CODEX_GPT5_4_MINI,
-    [MODEL_CODEX_GPT5_2]: MODEL_CODEX_GPT5_4_MINI,
 };
 /**
  * Resolve the aux (compaction) model id for a given main model.
  *
- *   - Known main model with a cheaper sibling → that sibling.
- *   - Known main model that *is* the cheapest sibling → itself (no-op,
- *     callers can still route compaction through it without a second
- *     network identity).
- *   - Unknown slug → returns the input unchanged. Lets hosts pin custom
- *     model ids (proxies, alternate gateways) without us guessing wrong.
- *
- * Prefix fallbacks catch model ids that look like a known family but
- * differ in version suffix (e.g. `claude-sonnet-4-7`, `deepseek-v5-pro`).
- * They are conservative — only match when the slug clearly belongs to
- * one of the three supported providers.
+ * DeepSeek V4 heavy tiers → flash for compaction.
+ * Unknown slugs pass through unchanged.
  */
 export function resolveAuxModel(mainModel) {
     const exact = AUX_MODEL_BY_MAIN[mainModel];
     if (exact !== undefined)
         return exact;
-    // Prefix-based fallback for forward-compat with new minor versions.
-    // Any claude-* slug routes to sonnet (host preference); any heavy gpt-5.*
-    // routes to mini; any deepseek-pro variant routes to flash.
-    if (mainModel.startsWith("claude-")) {
-        return MODEL_SONNET;
-    }
     if (mainModel === "deepseek-pro" ||
         (mainModel.startsWith("deepseek-v") && mainModel.includes("pro"))) {
         return MODEL_DEEPSEEK_V4_FLASH;
     }
-    if (mainModel.startsWith("gpt-5") && !mainModel.includes("mini")) {
-        return MODEL_CODEX_GPT5_4_MINI;
-    }
     return mainModel;
 }
 //# sourceMappingURL=aux-model-map.js.map

package/dist/memory/aux-model-map.js.map

@@ -1 +1 @@
-{"version":3,"file":"aux-model-map.js","sourceRoot":"","sources":["../../src/memory/aux-model-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,UAAU,EACV,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,MAAM,YAAY,GAAG,kBAAkB,CAAC;AAExC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,iBAAiB,GAA2B;IAChD,kEAAkE;IAClE,qEAAqE;IACrE,qEAAqE;IACrE,+BAA+B;IAC/B,CAAC,UAAU,CAAC,EAAE,YAAY;IAC1B,CAAC,YAAY,CAAC,EAAE,YAAY;IAC5B,CAAC,YAAY,CAAC,EAAE,YAAY;IAE5B,cAAc;IACd,CAAC,qBAAqB,CAAC,EAAE,uBAAuB;IAChD,CAAC,uBAAuB,CAAC,EAAE,uBAAuB;IAElD,qEAAqE;IACrE,0DAA0D;IAC1D,CAAC,kBAAkB,CAAC,EAAE,uBAAuB;IAC7C,CAAC,kBAAkB,CAAC,EAAE,uBAAuB;IAC7C,CAAC,uBAAuB,CAAC,EAAE,uBAAuB;IAClD,CAAC,wBAAwB,CAAC,EAAE,uBAAuB;IACnD,CAAC,kBAAkB,CAAC,EAAE,uBAAuB;CAC9C,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,MAAM,KAAK,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAEtC,oEAAoE;IACpE,0EAA0E;IAC1E,4DAA4D;IAC5D,IAAI,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IACE,SAAS,KAAK,cAAc;QAC5B,CAAC,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EACjE,CAAC;QACD,OAAO,uBAAuB,CAAC;IACjC,CAAC;IACD,IAAI,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACjE,OAAO,uBAAuB,CAAC;IACjC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"aux-model-map.js","sourceRoot":"","sources":["../../src/memory/aux-model-map.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,iBAAiB,GAA2B;IAChD,CAAC,qBAAqB,CAAC,EAAE,uBAAuB;IAChD,CAAC,uBAAuB,CAAC,EAAE,uBAAuB;CACnD,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,MAAM,KAAK,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAEtC,IACE,SAAS,KAAK,cAAc;QAC5B,CAAC,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EACjE,CAAC;QACD,OAAO,uBAAuB,CAAC;IACjC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/platform/config.d.ts

@@ -1,13 +1,6 @@
 export declare const DATA_DIR: string;
-export declare const MODEL_SONNET: string;
-export declare const MODEL_OPUS: string;
 export declare const MODEL_DEEPSEEK_V4_PRO: string;
 export declare const MODEL_DEEPSEEK_V4_FLASH: string;
-export declare const MODEL_CODEX_GPT5_5: string;
-export declare const MODEL_CODEX_GPT5_4: string;
-export declare const MODEL_CODEX_GPT5_4_MINI: string;
-export declare const MODEL_CODEX_GPT5_3_CODEX: string;
-export declare const MODEL_CODEX_GPT5_2: string;
 export declare const FILE_TAG_REGEX: RegExp;
 /** Returns `process.env` without `CLAUDECODE` so spawned subprocesses don't
  *  inherit a nested-claude-code detection flag from a parent harness. */

package/dist/platform/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/platform/config.ts"],"names":[],"mappings":"AAwBA,eAAO,MAAM,QAAQ,EAAE,MAEM,CAAC;AAK9B,eAAO,MAAM,YAAY,EAAE,MAA4B,CAAC;AACxD,eAAO,MAAM,UAAU,EAAE,MAA0B,CAAC;AAGpD,eAAO,MAAM,qBAAqB,EAAE,MAA0B,CAAC;AAC/D,eAAO,MAAM,uBAAuB,EAAE,MAA4B,CAAC;AAMnE,eAAO,MAAM,kBAAkB,EAAE,MAAkB,CAAC;AACpD,eAAO,MAAM,kBAAkB,EAAE,MAAkB,CAAC;AACpD,eAAO,MAAM,uBAAuB,EAAE,MAAuB,CAAC;AAC9D,eAAO,MAAM,wBAAwB,EAAE,MAAwB,CAAC;AAChE,eAAO,MAAM,kBAAkB,EAAE,MAAkB,CAAC;AAEpD,eAAO,MAAM,cAAc,EAAE,MAAgC,CAAC;AAW9D;yEACyE;AACzE,wBAAgB,WAAW,IAAI,MAAM,CAAC,UAAU,CAI/C"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/platform/config.ts"],"names":[],"mappings":"AAwBA,eAAO,MAAM,QAAQ,EAAE,MAEM,CAAC;AAG9B,eAAO,MAAM,qBAAqB,EAAE,MAA0B,CAAC;AAC/D,eAAO,MAAM,uBAAuB,EAAE,MAA4B,CAAC;AAEnE,eAAO,MAAM,cAAc,EAAE,MAAgC,CAAC;AAW9D;yEACyE;AACzE,wBAAgB,WAAW,IAAI,MAAM,CAAC,UAAU,CAI/C"}

package/dist/platform/config.js

@@ -22,23 +22,9 @@ const HOME = homedir();
 export const DATA_DIR = process.env.MAESTRO_DATA_DIR
     ? resolve(process.env.MAESTRO_DATA_DIR)
     : resolve(HOME, ".maestro");
-// Canonical model IDs used by the SDK's maestro registry. Hosts can pick a
-// different default per-query via `AgentQueryOptions.model`, so these are
-// just baseline references.
-export const MODEL_SONNET = "claude-sonnet-4-6";
-export const MODEL_OPUS = "claude-opus-4-7";
 // DeepSeek V4 (released 2026-04-24). OpenAI-compatible chat-completions API.
 export const MODEL_DEEPSEEK_V4_PRO = "deepseek-v4-pro";
 export const MODEL_DEEPSEEK_V4_FLASH = "deepseek-v4-flash";
-// Codex Responses API (ChatGPT-backed OAuth). The endpoint only accepts a
-// codex-issued whitelist of model slugs — these are the ones surfaced by the
-// `/codex/models` endpoint as of 2026-05-23. Adding a new one: list it here
-// AND in `MODEL_MAX_OUTPUT_TOKENS` / `ALIAS_MAP` if it deserves a short alias.
-export const MODEL_CODEX_GPT5_5 = "gpt-5.5";
-export const MODEL_CODEX_GPT5_4 = "gpt-5.4";
-export const MODEL_CODEX_GPT5_4_MINI = "gpt-5.4-mini";
-export const MODEL_CODEX_GPT5_3_CODEX = "gpt-5.3-codex";
-export const MODEL_CODEX_GPT5_2 = "gpt-5.2";
 export const FILE_TAG_REGEX = /\[FILE:(\/[^\]]+)\]/gi;
 // Make sure DATA_DIR exists before any tool/skill code tries to readdir into
 // it. Idempotent and best-effort — hosts that point this at a read-only

package/dist/platform/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/platform/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;;;;;;;GAWG;AAEH,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;AAEvB,6EAA6E;AAC7E,0EAA0E;AAC1E,4EAA4E;AAC5E,uEAAuE;AACvE,4CAA4C;AAC5C,MAAM,CAAC,MAAM,QAAQ,GAAW,OAAO,CAAC,GAAG,CAAC,gBAAgB;IAC1D,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACvC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAE9B,2EAA2E;AAC3E,0EAA0E;AAC1E,4BAA4B;AAC5B,MAAM,CAAC,MAAM,YAAY,GAAW,mBAAmB,CAAC;AACxD,MAAM,CAAC,MAAM,UAAU,GAAW,iBAAiB,CAAC;AAEpD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,qBAAqB,GAAW,iBAAiB,CAAC;AAC/D,MAAM,CAAC,MAAM,uBAAuB,GAAW,mBAAmB,CAAC;AAEnE,0EAA0E;AAC1E,6EAA6E;AAC7E,4EAA4E;AAC5E,+EAA+E;AAC/E,MAAM,CAAC,MAAM,kBAAkB,GAAW,SAAS,CAAC;AACpD,MAAM,CAAC,MAAM,kBAAkB,GAAW,SAAS,CAAC;AACpD,MAAM,CAAC,MAAM,uBAAuB,GAAW,cAAc,CAAC;AAC9D,MAAM,CAAC,MAAM,wBAAwB,GAAW,eAAe,CAAC;AAChE,MAAM,CAAC,MAAM,kBAAkB,GAAW,SAAS,CAAC;AAEpD,MAAM,CAAC,MAAM,cAAc,GAAW,uBAAuB,CAAC;AAE9D,6EAA6E;AAC7E,wEAAwE;AACxE,wDAAwD;AACxD,IAAI,CAAC;IACH,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3C,CAAC;AAAC,MAAM,CAAC;IACP,yDAAyD;AAC3D,CAAC;AAED;yEACyE;AACzE,MAAM,UAAU,WAAW;IACzB,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/B,OAAO,GAAG,CAAC,UAAU,CAAC;IACtB,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/platform/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;;;;;;;GAWG;AAEH,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;AAEvB,6EAA6E;AAC7E,0EAA0E;AAC1E,4EAA4E;AAC5E,uEAAuE;AACvE,4CAA4C;AAC5C,MAAM,CAAC,MAAM,QAAQ,GAAW,OAAO,CAAC,GAAG,CAAC,gBAAgB;IAC1D,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACvC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAE9B,6EAA6E;AAC7E,MAAM,CAAC,MAAM,qBAAqB,GAAW,iBAAiB,CAAC;AAC/D,MAAM,CAAC,MAAM,uBAAuB,GAAW,mBAAmB,CAAC;AAEnE,MAAM,CAAC,MAAM,cAAc,GAAW,uBAAuB,CAAC;AAE9D,6EAA6E;AAC7E,wEAAwE;AACxE,wDAAwD;AACxD,IAAI,CAAC;IACH,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3C,CAAC;AAAC,MAAM,CAAC;IACP,yDAAyD;AAC3D,CAAC;AAED;yEACyE;AACzE,MAAM,UAAU,WAAW;IACzB,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/B,OAAO,GAAG,CAAC,UAAU,CAAC;IACtB,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/platform/version.d.ts

@@ -9,5 +9,5 @@
  *
  * Bump in lock-step with `package.json#version` on every release.
  */
-export declare const MAESTRO_SDK_VERSION: "0.1.37";
+export declare const MAESTRO_SDK_VERSION: "0.1.39";
 //# sourceMappingURL=version.d.ts.map

package/dist/platform/version.js

@@ -9,5 +9,5 @@
  *
  * Bump in lock-step with `package.json#version` on every release.
  */
-export const MAESTRO_SDK_VERSION = "0.1.37";
+export const MAESTRO_SDK_VERSION = "0.1.39";
 //# sourceMappingURL=version.js.map

package/dist/provider.d.ts

@@ -7,9 +7,7 @@ import type { AgentQueryOptions, UnifiedEvent } from "./types.js";
  * Multi-turn resume: when `opts.sessionId` is set we hydrate prior messages
  * from `~/.maestro/sessions/<id>.jsonl` (written by the previous turn's
  * persistence path or by a cross-agent rollout). Otherwise we mint a fresh
- * UUIDv4 — matching the contract claude/codex providers expose, so the
- * router stays agent-agnostic and `{type:"session", sessionId}` always comes
- * back on the first iteration.
+ * UUIDv4 and start with empty history.
  *
  * After the loop drains we write the updated history back to disk so a
  * subsequent call resumes correctly. Failures here are logged but never
@@ -18,17 +16,10 @@ import type { AgentQueryOptions, UnifiedEvent } from "./types.js";
  *
  * MCP integration: every server in `getMcpServersForQuery(opts)` is leased
  * from the process-wide cache (`mcp/pool-cache.ts`) and its tools are
- * registered under `mcp__<server>__<tool>` — the same name convention Claude
- * SDK uses, so the model sees consistent tool names across providers in the
- * same topic. Unlike claudeProvider / codexProvider — which hand `mcpServers`
- * to a vendor SDK that owns MCP lifecycle internally — Maestro hits Anthropic's
- * Messages API via raw fetch, so we own startup + dispatch + cleanup here.
- * Cache key includes (userId, session, groupId) so two users never share an
- * MCP client; the cache evicts idle clients via TTL + LRU cap so stale slots
- * don't accumulate.
- *
- * Snapshot pinned to upstream Maestro v0.13.0 (MIT, Nous Research). See
- * docs/maestro-integration.md for the porting roadmap.
+ * registered under `mcp__<server>__<tool>`. Maestro owns MCP startup +
+ * dispatch + cleanup directly. Cache key includes (userId, session, groupId)
+ * so two users never share an MCP client; the cache evicts idle clients via
+ * TTL + LRU cap so stale slots don't accumulate.
  */
 /**
  * Default tool-iteration cap when the caller doesn't supply
@@ -128,49 +119,15 @@ export declare function iterationBudgetLine(remaining: number, max: number): str
  * from prose.
  */
 export declare function wrapUpOverlayLine(remaining: number, max: number): string | null;
+export declare function providerForModel(_resolvedModel: string): Provider;
 /**
- * Pick the right provider adapter for a resolved model id.
- *
- * Dispatch table:
- *   - `gpt-5.*` / `gpt-4.*` / `o3` / `o4`  → CodexResponsesProvider
- *     (ChatGPT-OAuth-backed Responses API at
- *     chatgpt.com/backend-api/codex; reads ~/.codex/auth.json).
- *     When `DEEPSEEK_API_KEY` is present, the codex provider is wrapped in a
- *     `FallbackProvider` that retries against DeepSeek (`deepseek-v4-pro`) if
- *     codex fails before producing any output (OAuth dead, HTTP 4xx/5xx,
- *     connect/TTFB timeout). Auto-on — no flag — because the only cost when
- *     codex is healthy is one cheap wrapper object; the fallback provider is
- *     lazily constructed and never touched unless codex actually fails.
- *   - `deepseek-*`                          → DeepseekProvider
- *     (DEEPSEEK_API_KEY env).
- *   - everything else (claude-*, custom full ids)
- *                                           → AnthropicProvider
- *     (ANTHROPIC_API_KEY env).
- *
- * Exported so tests / hosts can lock the dispatch shape independently of
- * `maestroProvider`'s I/O. The codex match is prefix-based so hosts can ship
- * new codex slugs (gpt-5.6, future tiers) without a dispatcher change — only
- * the registry alias map needs updating.
+ * DeepSeek cannot currently consume Maestro image blocks natively in this
+ * adapter, so when a Gemini API key is configured we expose a narrow vision
+ * fallback tool only for DeepSeek models. Other providers keep their existing
+ * tool menu and avoid unnecessary third-party image upload/cost.
  */
-export declare function providerForModel(resolvedModel: string): Provider;
-/**
- * Combine two optional thinking budgets — keyword-derived and effort-derived
- * — by picking the higher non-undefined value. Used by `maestroProvider` so
- * an explicit keyword in the prompt can escalate past the caller's static
- * effort config, but neither path silently downgrades the other.
- *
- * Truth table:
- *   keyword=undef, effort=undef  → undef        (no thinking)
- *   keyword=4096,  effort=undef  → 4096         (keyword only)
- *   keyword=undef, effort=10000  → 10000        (effort only)
- *   keyword=4096,  effort=10000  → 10000        (effort higher)
- *   keyword=31999, effort=4096   → 31999        (keyword higher — user
- *                                                 intent in prompt wins)
- *
- * Kept as a tiny helper rather than inlining so tests can exercise the
- * priority rule without spinning up the full maestroProvider pipeline.
- */
-export declare function pickHigherBudget(a: number | undefined, b: number | undefined): number | undefined;
+export declare function shouldRegisterGeminiImageQATool(resolvedModel: string, env?: NodeJS.ProcessEnv): boolean;
+export declare function deepseekImageHandlingPrompt(resolvedModel: string, geminiImageQaAvailable: boolean): string | undefined;
 /**
  * Recognize the multiple shapes Node + WHATWG fetch use when a request is
  * cancelled via `AbortController`:

package/dist/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAuBrE,OAAO,KAAK,EAAE,QAAQ,EAAyC,MAAM,kBAAkB,CAAC;AAsCxF,OAAO,KAAK,EAAE,iBAAiB,EAAc,YAAY,EAAE,MAAM,SAAS,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,sBAAsB,QAA2B,CAAC;AAE/D,wBAAuB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,cAAc,CAAC,YAAY,CAAC,CA6gB5F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAa1E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI/E;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ,CAehE;AAwBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAIjG;AAED;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAiBrE,OAAO,KAAK,EAAE,QAAQ,EAAyC,MAAM,kBAAkB,CAAC;AAqCxF,OAAO,KAAK,EAAE,iBAAiB,EAAc,YAAY,EAAE,MAAM,SAAS,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,sBAAsB,QAA2B,CAAC;AAyD/D,wBAAuB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,cAAc,CAAC,YAAY,CAAC,CAke5F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAa1E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI/E;AAED,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAEjE;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,aAAa,EAAE,MAAM,EACrB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAGT;AAED,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,MAAM,EACrB,sBAAsB,EAAE,OAAO,GAC9B,MAAM,GAAG,SAAS,CAWpB;AAED;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC"}