dsh-connect-trae 1.0.1 → 1.1.0

package/CHANGELOG.md

@@ -1,6 +1,29 @@
 # Changelog
 
-## Unreleased
+## 1.1.0 (2026-08-30)
+
+### Fixes
+
+- 保持 `llm_utils_chat` / `solo_work_lite` 为模型调用主路径，继续保留 Trae 原生结构化 `tool_calls`，避免模型无法调用 DSH 本地 `read` / `write` / `bash` 工具。
+- 删除只提取最终文本、无法返回 DSH `tool_calls` 的 `TraeSoloRemoteBridge` 及 Remote 会话调用逻辑；保留独立、只读的 `TraeSoloRemoteCatalogClient` 用于刷新完整模型能力目录，类型上不提供聊天方法，防止再次误接为模型调用主路径。
+- 收紧 SOLO 请求为实证字段 allowlist，过滤会触发 `param is invalid` 的 OpenAI 可选字段；推理档位完成 DSH canonical → Trae wire 转换。
+- 修复 `get_detail_param` 解析器字段名：上下文窗口改读 `model_detail_list[].prompt_max_tokens`（回退 `context_window_tokens.dev`）、最大输出改读 `model_detail_list[].max_tokens`。原代码读不存在的 `max_input_tokens` / `max_output_tokens`，导致每个模型的 contextWindow / maxTokens 恒为 undefined。
+- 模型发现合并时剔除「Remote 目录有、但 `get_detail_param` 无对应 `config_name`」的不可调用模型（`Doubao-Seed-Code`、`glm-5.3` 均属此类，发往 `llm_utils_chat` 必返回 `4001 param is invalid`）；`FALLBACK_TRAE_MODELS` 移除已下线的 `Doubao-Seed-Code`。
+- 账号选择改为严格绑定用户显式选择：删除启动时按通用积分自动挑选账号的逻辑，未选号时仅用第一个发现的账号；账号失效时不再静默切换到其他账号，而是报「未登录」让用户重新选择，避免账单落到用户未选择的账号上。
+
+### Changes
+
+- 模型管理体验与 `dsh-connect-workbuddy` 对齐：一个上游模型只对应一个 DSH 模型 id，移除运行时 `@1m` 变体，改用逐模型 `contextBudgets` 在 Trae 公布的默认 / Max 窗口之间选择。
+- 未勾选任何模型时按完整目录提供模型，避免初次配置或旧设置迁移后 provider 目录为空；旧配置中的 `@1m` 行会被自动过滤。
+- 模型卡片改为右侧上下文预算单选或固定窗口值，并统一显示多模态标记与原始推理档位 `low / high / xhigh`。
+- 模型发现草稿补充与适配器目录一致的 `inputModalities`；当前 DSH 版本可能在核心规范化阶段丢弃该扩展字段，但正式 PiAiAdapter 模型元数据与图片请求链路保持完整。
+- Trae SOLO 请求改为按已验证字段构造 `llm_utils_chat` envelope，过滤 OpenAI 可选参数以避免 `param is invalid`；同时将 DSH 推理档位映射为模型声明的 Trae wire value，并继续规范化 `developer` 为 `system`。
+- 模型发现以 Remote `/models` 目录为骨架，用 `get_detail_param` 补充 `wireConfigName`（`llm_utils_chat` 真正接受的 `config_name`），按 `config_name == id` 优先、`display_name == name` 次之两级 join；join 不到 wire 行的 remote 模型（不可调用）会被剔除，修复 Seed-Code 等模型因展示名与 wire id 不一致导致的 `param is invalid`。
+
+### Docs
+
+- 更新 README 顶部插件卡片截图（账号选择、积分卡片与模型列表的当前界面）。
+- 移除仓库内开发期的一次性探测脚本（`scripts/probe-*.mjs`、`scripts/inspect-raw-chat-log.mjs`）及其只读脚本内容断言测试，保持仓库与发布包聚焦产品代码；`lib/`、`tests/` 与 `node_modules/` 依旧不进入发布包。
 
 ## 1.0.1 (2026-08-31)
 

package/lib/client.js

@@ -101,10 +101,13 @@ window.__ModuleLoader__.load({
 .dsm-trae-model-copy{display:flex;align-items:baseline;gap:8px;min-width:0}
 .dsm-trae-model-name{display:inline-flex;align-items:baseline;gap:7px;color:var(--dsw-alias-label-primary,#e6e6e6);font-size:13px;font-weight:500;line-height:19px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .dsm-trae-model-name-rate{color:var(--dsw-alias-label-tertiary,#999);font-size:11px;font-weight:400;line-height:16px;flex:none}
-.dsm-trae-model-id{color:var(--dsw-alias-label-tertiary,#999);font-size:11px;line-height:16px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .dsm-trae-model-meta{display:flex;align-items:center;gap:7px 12px;flex-wrap:wrap;color:var(--dsw-alias-label-tertiary,#999);font-size:11px;line-height:16px}
-.dsm-trae-model-toggle{display:inline-flex;align-items:center;gap:5px;color:var(--dsw-alias-label-secondary,#b8b8b8);cursor:pointer;font-size:13px;line-height:19px;font-weight:500}
-.dsm-trae-model-toggle input{margin:0;accent-color:var(--dsw-alias-brand-primary,#5686fe)}
+.dsm-trae-model-options{display:flex;align-items:center;justify-content:flex-end;gap:12px;flex:none}
+.dsm-trae-model-image{display:inline-flex;align-items:center;gap:4px;color:var(--dsw-alias-label-secondary,#c6c9d0);font-size:11px;line-height:16px;cursor:pointer}
+.dsm-trae-model-image input{margin:0;accent-color:var(--dsw-alias-brand-primary,#5686fe)}
+.dsm-trae-context-budget{display:flex;align-items:center;justify-content:flex-end;gap:12px;flex:none;margin:0;padding:0;border:0;color:var(--dsw-alias-label-secondary,#c6c9d0);font-size:11px;line-height:16px}
+.dsm-trae-context-budget label{display:inline-flex;align-items:center;gap:4px;cursor:pointer}
+.dsm-trae-context-budget input{margin:0;accent-color:var(--dsw-alias-brand-primary,#5686fe)}
 .dsm-trae-model-capability-note{margin:0;color:var(--dsw-alias-label-tertiary,#999);font-size:12px;line-height:18px}
 .dsm-trae-model-actions{display:flex;align-items:center;justify-content:space-between;gap:12px;border-top:1px solid var(--dsw-alias-border-l2,#36373b);padding-top:12px}
 .dsm-trae-model-actions-buttons{display:flex;align-items:center;justify-content:flex-end;gap:8px}
@@ -137,7 +140,7 @@ window.__ModuleLoader__.load({
 		function formatNumber(value) {
 			return new Intl.NumberFormat(void 0, {
 				minimumFractionDigits: 0,
-				maximumFractionDigits: 2
+				maximumFractionDigits: 0
 			}).format(value);
 		}
 		function formatDateTime(value) {
@@ -155,11 +158,6 @@ window.__ModuleLoader__.load({
 			if (value >= 1e3 && value % 1e3 === 0) return `${value / 1e3}K`;
 			return formatNumber(value);
 		}
-		const EFFORT_LABELS = {
-			low: "轻",
-			high: "高",
-			xhigh: "极高"
-		};
 		function dotStyle(status) {
 			return { background: status === "signed-in" ? "var(--dsw-alias-state-success-primary, #22a06b)" : status === "error" ? "var(--dsw-alias-state-error-primary, #d92d20)" : "var(--dsw-alias-label-dimmed, #9aa0a6)" };
 		}
@@ -175,7 +173,8 @@ window.__ModuleLoader__.load({
 			const [settingsRevision, setSettingsRevision] = (0, react.useState)(0);
 			const [draftModels, setDraftModels] = (0, react.useState)(void 0);
 			const [draftEnabledIds, setDraftEnabledIds] = (0, react.useState)(void 0);
-			const [draft1mIds, setDraft1mIds] = (0, react.useState)(void 0);
+			const [draftImageIds, setDraftImageIds] = (0, react.useState)(void 0);
+			const [draftContextBudgets, setDraftContextBudgets] = (0, react.useState)(void 0);
 			const [saving, setSaving] = (0, react.useState)(false);
 			const [switchingAccount, setSwitchingAccount] = (0, react.useState)(false);
 			const mounted = (0, react.useRef)(true);
@@ -269,15 +268,22 @@ window.__ModuleLoader__.load({
 					});
 					const body = await response.json();
 					if (!response.ok || !Array.isArray(body.models)) throw new Error(`HTTP ${response.status}`);
-					const fresh = body.models.filter((model) => model.maxContext !== true);
-					const oldEnabled = status.status === "signed-in" ? new Set(status.enabledModelIds) : /* @__PURE__ */ new Set();
-					const old1m = status.status === "signed-in" ? new Set(status.enabled1mModelIds) : /* @__PURE__ */ new Set();
+					const fresh = body.models;
 					const freshIds = new Set(fresh.map((model) => model.id));
-					const stillEnabled = [...oldEnabled].filter((id) => freshIds.has(id));
-					const still1m = [...old1m].filter((id) => freshIds.has(id));
-					setDraftModels(fresh);
+					const stillEnabled = [...activeEnabledIds].filter((id) => freshIds.has(id));
+					const stillImages = [...activeImageIds].filter((id) => freshIds.has(id));
+					const stillBudgets = {};
+					for (const id of freshIds) {
+						const budget = activeContextBudgets[id];
+						if (typeof budget === "number") stillBudgets[id] = budget;
+					}
+					setDraftModels(fresh.map((model) => ({
+						...model,
+						input: ["text"]
+					})));
 					setDraftEnabledIds(new Set(stillEnabled));
-					setDraft1mIds(new Set(still1m));
+					setDraftImageIds(new Set(stillImages));
+					setDraftContextBudgets(stillBudgets);
 				} catch (error) {
 					if (mounted.current) setStatus({
 						status: "error",
@@ -288,37 +294,50 @@ window.__ModuleLoader__.load({
 				}
 			};
 			const settingsValue = settingsScope?.getSnapshot().value;
-			new Set(typeof settingsValue === "object" && settingsValue !== null && Array.isArray(settingsValue.enabled1mModels) ? settingsValue.enabled1mModels.filter((value) => typeof value === "string") : []);
+			const savedContextBudgets = typeof settingsValue === "object" && settingsValue !== null && typeof settingsValue.contextBudgets === "object" && settingsValue.contextBudgets !== null ? settingsValue.contextBudgets : {};
+			const savedImageIds = new Set(typeof settingsValue === "object" && settingsValue !== null && Array.isArray(settingsValue.imageModelIds) ? settingsValue.imageModelIds.filter((id) => typeof id === "string") : []);
 			const visibleModels = draftModels ?? (status.status === "signed-in" ? status.models : []);
 			const savedEnabledIds = status.status === "signed-in" ? new Set(status.enabledModelIds) : /* @__PURE__ */ new Set();
-			const saved1mIds = status.status === "signed-in" ? new Set(status.enabled1mModelIds) : /* @__PURE__ */ new Set();
 			const activeEnabledIds = draftEnabledIds ?? savedEnabledIds;
-			const active1mIds = draft1mIds ?? saved1mIds;
-			const dirty = draftModels !== void 0 || draftEnabledIds !== void 0 || draft1mIds !== void 0;
+			const activeImageIds = draftImageIds ?? savedImageIds;
+			const activeContextBudgets = draftContextBudgets ?? savedContextBudgets;
+			const dirty = draftModels !== void 0 || draftEnabledIds !== void 0 || draftImageIds !== void 0 || draftContextBudgets !== void 0;
 			const toggleModel = (modelId) => {
 				const next = new Set(activeEnabledIds);
 				if (!next.delete(modelId)) next.add(modelId);
 				setDraftEnabledIds(next);
 				setDraftModels([...visibleModels]);
 			};
-			const toggle1m = (modelId) => {
-				const next = new Set(active1mIds);
+			const toggleImage = (modelId) => {
+				const next = new Set(activeImageIds);
 				if (!next.delete(modelId)) next.add(modelId);
-				setDraft1mIds(next);
+				setDraftImageIds(next);
+				setDraftModels([...visibleModels]);
+			};
+			const setContextBudget = (modelId, budget) => {
+				const next = { ...activeContextBudgets };
+				if (budget === void 0) delete next[modelId];
+				else next[modelId] = budget;
+				setDraftContextBudgets(next);
 				setDraftModels([...visibleModels]);
 			};
 			const discardModels = () => {
 				setDraftModels(void 0);
 				setDraftEnabledIds(void 0);
-				setDraft1mIds(void 0);
+				setDraftImageIds(void 0);
+				setDraftContextBudgets(void 0);
 			};
 			const saveModels = async () => {
 				if (settingsScope === void 0) return;
 				setSaving(true);
 				try {
-					await settingsScope.set("lastCatalog", visibleModels.filter((model) => model.maxContext !== true));
+					await settingsScope.set("lastCatalog", visibleModels.map((model) => ({
+						...model,
+						input: ["text"]
+					})));
 					await settingsScope.set("enabledModelIds", [...activeEnabledIds]);
-					await settingsScope.set("enabled1mModels", [...active1mIds].filter((id) => activeEnabledIds.has(id)));
+					await settingsScope.set("imageModelIds", [...activeImageIds].filter((id) => activeEnabledIds.has(id)));
+					await settingsScope.set("contextBudgets", activeContextBudgets);
 					discardModels();
 					await refreshUsage();
 				} finally {
@@ -507,9 +526,9 @@ window.__ModuleLoader__.load({
 															onChange: () => {
 																toggleModel(model.id);
 															}
-														}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+														}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 															className: "dsm-trae-model-copy",
-															children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+															children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 																className: "dsm-trae-model-name",
 																children: [model.name, model.creditMultiplier === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 																	className: "dsm-trae-model-name-rate",
@@ -519,29 +538,48 @@ window.__ModuleLoader__.load({
 																		"x)"
 																	]
 																})]
-															}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-																className: "dsm-trae-model-id",
-																children: model.id
-															})]
+															})
+														})]
+													}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+														className: "dsm-trae-model-options",
+														children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+															className: "dsm-trae-model-image",
+															children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+																type: "checkbox",
+																checked: activeImageIds.has(model.id),
+																disabled: settingsScope?.getSnapshot().writable !== true || saving,
+																onChange: () => {
+																	toggleImage(model.id);
+																}
+															}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("row.modelImage") })]
+														}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("fieldset", {
+															className: "dsm-trae-context-budget",
+															"aria-label": t("row.contextBudget"),
+															children: [model.maxContextWindow !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+																type: "radio",
+																name: `context-${model.id}`,
+																checked: activeContextBudgets[model.id] !== model.maxContextWindow,
+																disabled: settingsScope?.getSnapshot().writable !== true || saving,
+																onChange: () => {
+																	setContextBudget(model.id, model.contextWindow);
+																}
+															}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: formatCapacity(model.contextWindow, t("row.modelUnknown")) })] }) : null, /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+																type: "radio",
+																name: `context-${model.id}`,
+																checked: model.maxContextWindow === void 0 || activeContextBudgets[model.id] === model.maxContextWindow,
+																disabled: model.maxContextWindow === void 0 || settingsScope?.getSnapshot().writable !== true || saving,
+																onChange: () => {
+																	setContextBudget(model.id, model.maxContextWindow);
+																}
+															}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: formatCapacity(model.maxContextWindow ?? model.contextWindow, t("row.modelUnknown")) })] })]
 														})]
-													}), model.maxContextWindow === void 0 || model.maxContext === true ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
-														className: "dsm-trae-model-toggle",
-														children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
-															type: "checkbox",
-															checked: active1mIds.has(model.id),
-															disabled: !activeEnabledIds.has(model.id) || settingsScope?.getSnapshot().writable !== true || busy || saving,
-															onChange: () => {
-																toggle1m(model.id);
-															}
-														}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("row.modelEnable1m") })]
 													})]
 												}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 													className: "dsm-trae-model-meta",
 													children: [
-														/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("row.modelContext", { context: formatCapacity(model.contextWindow, t("row.modelUnknown")) }) }),
+														/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("row.modelContext", { context: formatCapacity(model.maxContextWindow ?? model.contextWindow, t("row.modelUnknown")) }) }),
 														model.maxTokens === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("row.modelOutput", { output: formatCapacity(model.maxTokens, t("row.modelUnknown")) }) }),
-														model.maxContext === true ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("row.modelMaxContext") }) : null,
-														model.reasoning === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("row.modelReasoning", { efforts: model.reasoning.supported.map((effort) => EFFORT_LABELS[effort] ?? effort).join(" / ") }) })
+														model.reasoning === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("row.modelReasoning", { efforts: model.reasoning.supported.join(" / ") }) })
 													]
 												})]
 											}, model.id))
@@ -640,15 +678,15 @@ window.__ModuleLoader__.load({
 			"row.discard": "Discard changes",
 			"row.save": "Save",
 			"row.saving": "Saving…",
-			"row.modelContext": "Context {context}",
+			"row.modelContext": "Max context {context}",
+			"row.contextBudget": "DSH context budget",
 			"row.modelOutput": "Output {output}",
+			"row.modelImage": "Image",
 			"row.modelRate": "{rate}x credits",
 			"row.modelReasoning": "Reasoning: {efforts}",
 			"row.modelReasoningSupported": "Reasoning: supported",
 			"row.modelUnknown": "Unknown",
-			"row.modelMaxContext": "1M variant",
-			"row.modelEnable1m": "Enable 1M model",
-			"row.modelCapabilityPending": "Only capabilities advertised by Trae are shown.",
+			"row.modelCapabilityPending": "Image input is enabled only for models you select.",
 			"row.cheer": "Star on GitHub"
 		};
 		const zh = {
@@ -687,15 +725,15 @@ window.__ModuleLoader__.load({
 			"row.discard": "放弃修改",
 			"row.save": "保存",
 			"row.saving": "保存中…",
-			"row.modelContext": "上下文 {context}",
+			"row.modelContext": "最大上下文 {context}",
+			"row.contextBudget": "DSH 上下文预算",
 			"row.modelOutput": "最大输出 {output}",
+			"row.modelImage": "图片",
 			"row.modelRate": "积分 {rate}x",
 			"row.modelReasoning": "推理强度：{efforts}",
 			"row.modelReasoningSupported": "推理：支持",
 			"row.modelUnknown": "未知",
-			"row.modelMaxContext": "1M 变体",
-			"row.modelEnable1m": "启用 1M 模型",
-			"row.modelCapabilityPending": "仅展示 Trae 接口明确公布的模型能力。",
+			"row.modelCapabilityPending": "仅对你手动勾选的模型启用图片输入。",
 			"row.cheer": "鼓励一下"
 		};
 		//#endregion

package/lib/index.d.ts

@@ -34,24 +34,88 @@ interface TraeDiscoveredModel {
 declare function parseTraeRemoteModel(value: unknown): TraeDiscoveredModel | undefined;
 //#endregion
 //#region src/catalog.d.ts
+type TraeInputModality = 'text' | 'image';
+/**
+ * One model the adapter exposes. `contextWindow` is the effective DSH context
+ * after the user's budget; `maxContextWindow` is the native Max window Trae
+ * advertises (capability display only — never a second model entry).
+ */
 interface TraeModelInfo {
   id: string;
   name: string;
   contextWindow?: number;
   maxTokens?: number;
-  input?: ('text' | 'image')[];
+  input?: TraeInputModality[];
   creditMultiplier?: number;
   reasoningSupported?: boolean;
   reasoning?: TraeDiscoveredReasoning;
   reasoningEfforts?: Partial<Record<TraeReasoningEffort, string | null>>;
-  baseModelId?: string;
-  maxContext?: boolean;
   maxContextWindow?: number;
+  /** The `config_name` `llm_utils_chat` accepts; absent means `id` is already the wire id. */
+  wireConfigName?: string;
 }
 /** Bootstrap catalog: identity only where current Trae metadata has not been fetched yet. */
 declare const FALLBACK_TRAE_MODELS: readonly TraeModelInfo[];
-/** Convert verified Trae API metadata into normal models and optional 1M variants. */
-declare function discoveredCatalog(models: readonly TraeDiscoveredModel[], enabled1m?: ReadonlySet<string>): TraeModelInfo[];
+/** Exact DSH modalities for one catalog entry; absent metadata is text-only. */
+declare function traeInputModalities(model: Pick<TraeModelInfo, 'input'>): TraeInputModality[];
+/** Apply the user's explicit image opt-ins; upstream and saved row hints are ignored. */
+declare function applyImageSelection(models: readonly TraeModelInfo[], selected: ReadonlySet<string>): TraeModelInfo[];
+/** One row from `get_detail_param`: the authoritative llm_utils_chat wire id + display name. */
+interface TraeWireModel {
+  id: string;
+  name: string;
+  contextWindow?: number;
+  maxTokens?: number;
+  reasoning?: TraeReasoningCapability;
+}
+/**
+ * Merge the two Trae model sources into one authoritative catalog.
+ *
+ * `remote` (the solo.trae.cn `/models` directory) is the authoritative model
+ * skeleton: it supplies the display id, display name, context windows, credit
+ * multiplier, reasoning and multimodal flags. `wire` (from `get_detail_param`)
+ * supplies the real `llm_utils_chat` `config_name` — the only id the chat
+ * endpoint actually accepts. A remote row is only callable when it maps to a
+ * wire `config_name`, so a remote row with no wire match is DROPPED (it would
+ * otherwise be sent as an invalid `config_name` and rejected with 4001
+ * "param is invalid"). Verified 2026-08-30: the Remote directory advertises
+ * `Doubao-Seed-Code` and `glm-5.3`, neither of which is a current `config_name`;
+ * both fail every request, so they must not be exposed.
+ *
+ * Joining is two-tier, in priority order:
+ *  1. `wire.id` (the `config_name`) equals the remote id — the model's display
+ *     id is already its wire id (the common case: glm-5.2, DeepSeek-V4-Flash,
+ *     kimi-k3, …).
+ *  2. `wire.name` (the `display_name`) equals the remote display name — for
+ *     models whose display id differs from the wire id across Trae versions.
+ * When the matched wire `config_name` differs from the remote id it is recorded
+ * as `wireConfigName`; otherwise it is left undefined (id is already the wire id).
+ */
+declare function mergeTraeModelSources(remote: readonly TraeDiscoveredModel[], wire: readonly TraeWireModel[]): TraeModelInfo[];
+/** Local DSH context budget per model; a value may only select an advertised window. */
+type TraeContextBudget = number;
+/**
+ * Apply the saved local budget. Trae advertises two windows per model (dev and
+ * Max), so the budget may only switch a model to its own advertised Max value —
+ * never to a fabricated number. Everything else keeps the dev window.
+ */
+declare function applyContextBudgets(catalog: readonly TraeModelInfo[], budgets?: Readonly<Record<string, TraeContextBudget | undefined>>): TraeModelInfo[];
+/** Convert Trae metadata into text-only model rows; image support is user-owned configuration. */
+declare function discoveredCatalog(models: readonly TraeDiscoveredModel[]): TraeModelInfo[];
+/**
+ * Drop rows saved by older releases that generated `@1m` variant models, so a
+ * stale configuration cannot resurrect a variant the runtime no longer builds.
+ */
+declare function sanitizeCatalog(catalog: readonly TraeModelInfo[]): TraeModelInfo[];
+/**
+ * Derive the runtime catalog from the last refreshed Trae directory plus the
+ * user's explicit selection and context budgets. An empty selection falls back
+ * to the whole directory: a plugin that has never been configured must still
+ * serve models rather than nothing. This is the single source of truth for
+ * what DSH actually exposes, so saving only the selection and budgets is
+ * enough to rebuild it after a restart.
+ */
+declare function deriveCatalog(catalog: readonly TraeModelInfo[], enabled: ReadonlySet<string>, budgets?: Readonly<Record<string, TraeContextBudget | undefined>>): TraeModelInfo[];
 declare class TraeCatalog {
   private models;
   current(): readonly TraeModelInfo[];
@@ -161,7 +225,6 @@ declare class TraeCredentialStore {
   private storagePathOverride;
   private edition;
   private accountId;
-  private preferIds;
   private readonly ownPath;
   private readonly refresh;
   private readonly refreshMarginMs;
@@ -169,15 +232,13 @@ declare class TraeCredentialStore {
   constructor(options: TraeCredentialStoreOptions);
   setSource(storagePath: string | undefined, edition?: TraeEdition | 'auto', accountId?: string): void;
   selectAccount(accountId: string | undefined): void;
+  candidates(): TraeStorageCandidate[];
   /**
-   * Preferred account ordering used when no account is explicitly selected.
-   * The connector can only bill the `llm_utils_chat` channel against general
-   * credits, so accounts with zero general credits should not become the
-   * default or they fail with 4008 / empty responses.
+   * Deterministic default when no account is explicitly selected: the first
+   * discovered account. This is NOT credit-seeking — it never reorders accounts
+   * to find one with general credits. The plugin bills exactly the account the
+   * user selected, or the first account when nothing has been selected yet.
    */
-  setPreferAccountIds(ids: readonly string[]): void;
-  candidates(): TraeStorageCandidate[];
-  /** First credential matching the preferred ordering, else the first live one. */
   private preferred;
   accounts(): Promise<TraeAccountChoice[]>;
   current(): Promise<TraeCredential | undefined>;
@@ -611,7 +672,7 @@ interface TraeFallbackUpstreamOptions {
   }>) => void;
 }
 /**
- * Raw Chat first, SOLO Remote second. Fallback is intentionally narrow:
+ * Optional primary route first, native SOLO tool-call route second. Fallback is intentionally narrow:
  * only definitive pre-stream schema/route incompatibilities may retry the same
  * user request. Authentication, credit, rate, cancellation, transport/server
  * failures, and every successful Response are never replayed.
@@ -706,6 +767,7 @@ interface TraeSoloClientOptions {
   identity(): Promise<TraeIdentity>;
   baseUrl?: string;
   fetchImpl?: typeof fetch;
+  log?: (message: string, detail?: unknown) => void;
 }
 declare class TraeSoloUpstreamClient {
   private readonly options;
@@ -718,58 +780,39 @@ declare class TraeSoloUpstreamClient {
 //#region src/solo-bridge.d.ts
 /** Convert Trae's named SSE events into OpenAI chat-completion SSE chunks. */
 declare function bridgeTraeSoloStream(response: Response, model: string): Response;
+/** Resolves a display model id to the real llm_utils_chat config_name. */
+type TraeWireResolver = (displayId: string) => string | undefined;
 /** Native SOLO client wrapper used by the loopback OpenAI adapter. */
 declare class TraeSoloBridge implements TraeUpstreamClient {
   private readonly upstream;
-  constructor(upstream: TraeUpstreamClient);
+  private readonly catalog?;
+  private readonly wireResolver?;
+  constructor(upstream: TraeUpstreamClient, catalog?: Pick<TraeCatalog, "current"> | undefined, wireResolver?: TraeWireResolver | undefined);
   chatStream(bodyJson: string, signal?: AbortSignal): Promise<TraeChatResult>;
 }
 //#endregion
 //#region src/solo-remote.d.ts
 declare const TRAE_SOLO_REMOTE_BASE = "https://solo.trae.cn/api/remote/v1";
-declare const TRAE_SOLO_REMOTE_MODELS: readonly {
-  name: string;
-  displayName: string;
-  multimodal: boolean;
-}[];
-interface TraeSoloRemoteOptions {
+interface TraeSoloRemoteCatalogOptions {
   credential(): Promise<TraeCredential>;
   fetchImpl?: typeof fetch;
   baseUrl?: string;
-  pollIntervalMs?: number;
-  timeoutMs?: number;
-}
-interface TraeRemoteInputMessage {
-  role: string;
-  content: string;
 }
-declare class TraeSoloRemoteClient {
+/**
+ * Read-only model catalog client for the SOLO Web API.
+ *
+ * This deliberately has no chat/session method: the Remote session protocol
+ * only exposes a final answer and cannot preserve DSH's structured tool loop.
+ */
+declare class TraeSoloRemoteCatalogClient {
   private readonly options;
   private readonly fetchImpl;
   private readonly baseUrl;
-  private readonly pollIntervalMs;
-  private readonly timeoutMs;
-  constructor(options: TraeSoloRemoteOptions);
+  constructor(options: TraeSoloRemoteCatalogOptions);
   private headers;
-  chat(messages: readonly TraeRemoteInputMessage[], model: string, signal?: AbortSignal): Promise<{
-    content: string;
-    sessionId: string;
-  }>;
   fetchModels(signal?: AbortSignal): Promise<TraeDiscoveredModel[]>;
 }
 //#endregion
-//#region src/solo-remote-bridge.d.ts
-/**
- * Bridges the SOLO remote polling-based API into the shim's stream interface.
- * The remote API uses create-session + poll-messages rather than raw SSE,
- * so this bridge converts the final result into a synthetic OpenAI SSE stream.
- */
-declare class TraeSoloRemoteBridge implements TraeUpstreamClient {
-  private readonly remote;
-  constructor(remote: TraeSoloRemoteClient);
-  chatStream(bodyJson: string, signal?: AbortSignal): Promise<TraeChatResult>;
-}
-//#endregion
 //#region src/delegating-upstream.d.ts
 /** Stable shim dependency whose delegate can be replaced after async setup. */
 declare class TraeDelegatingUpstreamClient implements TraeUpstreamClient {
@@ -897,10 +940,7 @@ interface TraeWebModel {
     supported: string[];
     defaultEffort?: string;
   };
-  baseModelId?: string;
-  maxContext?: boolean;
   maxContextWindow?: number;
-  maxContextEnabled?: boolean;
 }
 /** Daily check-in status rendered by the card. */
 interface TraeWebCheckin {
@@ -935,7 +975,6 @@ type TraeWebUsage = {
   accounts: readonly TraeWebAccount[];
   models: readonly TraeWebModel[];
   enabledModelIds: readonly string[];
-  enabled1mModelIds: readonly string[];
   rawChat?: {
     state: 'disabled' | 'unchecked' | 'available' | 'protocol-gated' | 'authentication' | 'credit' | 'rate' | 'transport' | 'server';
     checkedAtMs?: number;
@@ -953,12 +992,10 @@ type TraeWebUsage = {
 interface TraeUsageRouteOptions {
   store: TraeCredentialStore;
   client: TraeUsageClient;
-  /** The last-refreshed Trae raw directory (no generated @1m variants) for card display. */
+  /** The last-refreshed Trae raw directory (one entry per upstream model) for card display. */
   displayModels(): readonly TraeModelInfo[];
-  /** The user's ordinary-model selection stored as model id (= Trae name). */
+  /** The user's model selection stored as model id (= Trae name). */
   enabledModelIds(): readonly string[];
-  /** The user's 1M selection stored as base-model id. */
-  enabled1mModelIds(): readonly string[];
   discoverModels?(signal?: AbortSignal): Promise<readonly TraeModelInfo[]>;
   rawDiagnostic?(): TraeRawDiagnostic;
 }
@@ -984,12 +1021,14 @@ interface Config {
   lastCatalog?: TraeModelInfo[];
   /** The user's ordinary-model selection, as model id (= Trae name). */
   enabledModelIds?: string[];
-  /** The user's 1M selection, as base-model id. */
-  enabled1mModels?: string[];
+  /** Local DSH context budget per model; a value may only select an advertised window. */
+  contextBudgets?: Record<string, number>;
+  /** Models the user explicitly enabled for image input; text is always enabled. */
+  imageModelIds?: string[];
   /** Legacy generated runtime catalog; kept for backwards compatibility. */
   models?: TraeModelInfo[];
 }
 declare const Config: z<Config>;
 declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export { Config, FALLBACK_TRAE_MODELS, type RawChatDelta, type RawChatMessage, type RawChatTool, SseDecoder, type SseEvent, TRAE_CN_AGENT_TASK_PATH, TRAE_CN_TITLE_PATH, TRAE_MODEL_DETAIL_FUNCTIONS, TRAE_MODEL_DETAIL_PATH, TRAE_PAY_BASE, TRAE_PROVIDER, TRAE_RAW_CHAT_V1_PATH, TRAE_RAW_CHAT_V2_PATH, TRAE_REASONING_EFFORTS, TRAE_SETTINGS_NS, TRAE_SOLO_CHAT_PATH, TRAE_SOLO_FUNCTION, TRAE_SOLO_MODELS_PATH, TRAE_SOLO_REMOTE_BASE, TRAE_SOLO_REMOTE_MODELS, TRAE_STREAM_IDLE_TIMEOUT_MS, TRAE_USAGE_PATH, TRAE_VERSION_CODE_FALLBACK, type TraeActivityRule, type TraeCachedModelConfig, TraeCatalog, type TraeChatResult, type TraeCheckinStatus, type TraeCredential, TraeCredentialStore, TraeDelegatingUpstreamClient, type TraeDiscoveredModel, type TraeDiscoveredReasoning, type TraeEdition, TraeFallbackUpstreamClient, type TraeFallbackUpstreamOptions, type TraeFusionRawChatEnvelope, TraeGatedUpstreamClient, type TraeGatedUpstreamOptions, type TraeIdentity, type TraeModelDetailRequest, type TraeModelInfo, type TraeObservedModelConfig, TraeRawCapabilityController, type TraeRawCapabilityControllerOptions, type TraeRawCapabilitySnapshot, TraeRawCapabilityState, type TraeRawChatBehaviorConfig, type TraeRawChatCapability, type TraeRawChatClientOptions, type TraeRawChatConfig, type TraeRawChatFailureReason, type TraeRawChatRuntimeConfig, TraeRawChatUpstreamClient, type TraeRawDiagnostic, type TraeRawDiagnosticState, type TraeRawGateway, type TraeRawGatewayOptions, type TraeRawResolverResult, type TraeReasoningCapability, type TraeReasoningEffort, type TraeShim, TraeSoloBridge, type TraeSoloClientOptions, TraeSoloRemoteBridge, TraeSoloRemoteClient, type TraeSoloRemoteOptions, TraeSoloUpstreamClient, type TraeStorageCandidate, type TraeStreamEvent, type TraeUpstreamClient, TraeUsageClient, type TraeUsageOptions, type TraeUsagePack, type TraeUsageRouteOptions, type TraeUsageSnapshot, type TraeUsageSummary, type TraeUsageView, type TraeWebActivity, type TraeWebCheckin, type TraeWebCredits, type TraeWebUsage, UnconfiguredTraeUpstreamClient, apply, applyReasoningEffort, bridgeTraeSoloStream, buildTraeAgentTaskBody, buildTraeCnHeaders, buildTraeFusionRawChatEnvelope, buildTraeModelDetailRequest, buildTraeRawChatDraft, buildTraeRawChatRuntimeConfig, classifyTraeRawChatFailure, createTraeAdapter, createTraeRawGateway, createTraeShim, decodeRawChatChunk, decodeTraeEvent, decryptTraeStorageValue, discoveredCatalog, hashTraeRawChatArg, identityHeaders, inject, name, normalizeTraeCredential, normalizeTraeVersionCode, parseObservedModelConfig, parseReasoningCapability, parseTraeAuthValue, parseTraeCachedModel, parseTraeModelExtraConfigLogLine, parseTraeRawChatBehaviorConfig, parseTraeRemoteModel, parseTraeStorageDocument, prepareSoloBody, probeTraeRawChatCapability, rawCapabilityDiagnostic, rawCapabilityFingerprint, readTraeCachedModel, readTraeIdentity, refreshTraeCredential, registerTraeUsageRoute, resolveTraeRawRuntime, traeEndpoint, traeOwnAuthPath, traeRawChatExtraInfo, traeStorageCandidates, traeWebUsage };
+export { Config, FALLBACK_TRAE_MODELS, type RawChatDelta, type RawChatMessage, type RawChatTool, SseDecoder, type SseEvent, TRAE_CN_AGENT_TASK_PATH, TRAE_CN_TITLE_PATH, TRAE_MODEL_DETAIL_FUNCTIONS, TRAE_MODEL_DETAIL_PATH, TRAE_PAY_BASE, TRAE_PROVIDER, TRAE_RAW_CHAT_V1_PATH, TRAE_RAW_CHAT_V2_PATH, TRAE_REASONING_EFFORTS, TRAE_SETTINGS_NS, TRAE_SOLO_CHAT_PATH, TRAE_SOLO_FUNCTION, TRAE_SOLO_MODELS_PATH, TRAE_SOLO_REMOTE_BASE, TRAE_STREAM_IDLE_TIMEOUT_MS, TRAE_USAGE_PATH, TRAE_VERSION_CODE_FALLBACK, type TraeActivityRule, type TraeCachedModelConfig, TraeCatalog, type TraeChatResult, type TraeCheckinStatus, type TraeContextBudget, type TraeCredential, TraeCredentialStore, TraeDelegatingUpstreamClient, type TraeDiscoveredModel, type TraeDiscoveredReasoning, type TraeEdition, TraeFallbackUpstreamClient, type TraeFallbackUpstreamOptions, type TraeFusionRawChatEnvelope, TraeGatedUpstreamClient, type TraeGatedUpstreamOptions, type TraeIdentity, type TraeInputModality, type TraeModelDetailRequest, type TraeModelInfo, type TraeObservedModelConfig, TraeRawCapabilityController, type TraeRawCapabilityControllerOptions, type TraeRawCapabilitySnapshot, TraeRawCapabilityState, type TraeRawChatBehaviorConfig, type TraeRawChatCapability, type TraeRawChatClientOptions, type TraeRawChatConfig, type TraeRawChatFailureReason, type TraeRawChatRuntimeConfig, TraeRawChatUpstreamClient, type TraeRawDiagnostic, type TraeRawDiagnosticState, type TraeRawGateway, type TraeRawGatewayOptions, type TraeRawResolverResult, type TraeReasoningCapability, type TraeReasoningEffort, type TraeShim, TraeSoloBridge, type TraeSoloClientOptions, TraeSoloRemoteCatalogClient, type TraeSoloRemoteCatalogOptions, TraeSoloUpstreamClient, type TraeStorageCandidate, type TraeStreamEvent, type TraeUpstreamClient, TraeUsageClient, type TraeUsageOptions, type TraeUsagePack, type TraeUsageRouteOptions, type TraeUsageSnapshot, type TraeUsageSummary, type TraeUsageView, type TraeWebActivity, type TraeWebCheckin, type TraeWebCredits, type TraeWebUsage, type TraeWireModel, UnconfiguredTraeUpstreamClient, apply, applyContextBudgets, applyImageSelection, applyReasoningEffort, bridgeTraeSoloStream, buildTraeAgentTaskBody, buildTraeCnHeaders, buildTraeFusionRawChatEnvelope, buildTraeModelDetailRequest, buildTraeRawChatDraft, buildTraeRawChatRuntimeConfig, classifyTraeRawChatFailure, createTraeAdapter, createTraeRawGateway, createTraeShim, decodeRawChatChunk, decodeTraeEvent, decryptTraeStorageValue, deriveCatalog, discoveredCatalog, hashTraeRawChatArg, identityHeaders, inject, mergeTraeModelSources, name, normalizeTraeCredential, normalizeTraeVersionCode, parseObservedModelConfig, parseReasoningCapability, parseTraeAuthValue, parseTraeCachedModel, parseTraeModelExtraConfigLogLine, parseTraeRawChatBehaviorConfig, parseTraeRemoteModel, parseTraeStorageDocument, prepareSoloBody, probeTraeRawChatCapability, rawCapabilityDiagnostic, rawCapabilityFingerprint, readTraeCachedModel, readTraeIdentity, refreshTraeCredential, registerTraeUsageRoute, resolveTraeRawRuntime, sanitizeCatalog, traeEndpoint, traeInputModalities, traeOwnAuthPath, traeRawChatExtraInfo, traeStorageCandidates, traeWebUsage };