@deepseek-ai/dsh-llm 0.2.1-alpha.1 → 0.2.1-alpha.3

package/README.i18n.yaml

@@ -21,11 +21,11 @@
   en: c3ecb5a1421f27db
   zh: 4bbd3c0e513845e1
 /deepseek-ai-dsh-llm/use-this-package/minimal-composition:
-  en: 7550d716b90fcb09
-  zh: 77891a44ee623c7a
+  en: 9d481d19dc52e404
+  zh: aa09cf4462e93ba6
 /deepseek-ai-dsh-llm/use-this-package/what-you-can-do:
-  en: b45d7a414141734e
-  zh: a641c8ea3827cee6
+  en: dc61eb86585f6e0d
+  zh: 9c0d6b240dfd2cda
 /deepseek-ai-dsh-llm/use-this-package/failures-and-recovery:
   en: 311d8c92447b7094
   zh: 68cf5cb1c3853cc1
@@ -39,8 +39,8 @@
   en: ae1618577f4e8364
   zh: a6e8ab1563c08dfb
 /deepseek-ai-dsh-llm/understand-the-implementation/main-flow:
-  en: da12553c289e1705
-  zh: 28827a81cd63ff84
+  en: c95d4947745e39bb
+  zh: ec37b969f27629e2
 /deepseek-ai-dsh-llm/understand-the-implementation/invariants:
   en: 0163a050239248e5
   zh: 885c95bedcbe2ff4

package/README.md

@@ -60,11 +60,30 @@ After a successful mount, `ctx.llm.listProviders()` reports the registered route
 
 `GenerateOptions.messages` accepts durable `Message` values and request-only `RequestUserInput` values. Request-only inputs carry user-role content with no `id` or `source`; Session writes and Agent delivery still require durable messages. Callers keep auxiliary inputs unchanged until the stream settles. A caller that records its exact request, such as session-title generation, must use durable messages.
 
+`prepareCall(config, signal, configure?)` accepts concrete `LlmCallConfig` values. The optional synchronous, pure `ConfigureCall` function receives detached, deeply frozen `LlmCallControls` and model metadata from the captured adapter generation. Callers can compose ordinary functions to choose concrete controls; later writes replace earlier ones. Preparation retains the captured route, applies defaults to omitted controls, validates the result, and returns a frozen configuration for recording and dispatch. Callback failures or cancellation reject before dispatch. Preparation requires a registered adapter.
+
+Configuration functions select controls before adapter defaults are materialized. For example, combine least-effort selection with an explicit output cap, then pass `configure(maxTokens)` as the third argument:
+
+```ts
+import type { ConfigureCall } from '@deepseek-ai/dsh-llm'
+
+const leastReasoning: ConfigureCall = (controls, model) => {
+  const first = model.reasoning?.efforts[0]
+  return first === undefined ? controls : { ...controls, reasoningEffort: first.id }
+}
+
+const outputLimit = (maxTokens: number): ConfigureCall =>
+  controls => ({ ...controls, maxTokens })
+
+const configure = (maxTokens: number): ConfigureCall =>
+  (controls, model) => outputLimit(maxTokens)(leastReasoning(controls, model), model)
+```
+
 ### What you can do
 
 - **Stream one model call** — `ctx.llm.stream(options)` yields raw chunks (token-level deltas) for any registered provider and model; consumers assemble them with `BlockAssembler`.
 - **Register provider adapters** — an adapter owns one or more provider routes, and its registration captures that route's retry policy; registering the same route twice fails with `DUPLICATE_ADAPTER`.
-- **Expose and activate providers through configuration** — adapters declare configurable-provider routes plus a settings namespace, so configuration surfaces can activate dormant providers and edit connection facts without a restart. `LlmConfigurableProvider.error` reports a configuration diagnostic for repair; unaffected models can remain serviceable.
+- **Expose and activate providers through configuration** — adapters declare configurable-provider routes plus a settings namespace, so configuration surfaces can activate dormant providers and edit connection facts without a restart. `LlmConfigurableProvider.error` reports a configuration diagnostic for repair; unaffected models can remain serviceable. An entry can also carry `defaultBaseURL`, the endpoint the adapter uses when the profile sets none, and `nativeAuth`, the environment variables and OAuth sign-in that the adapter's authentication reads when the profile names no credential reference; `baseURLEnv` lists environment variables used to configure the endpoint. Configuration UIs read these fields from the directory without calling the adapter.
 - **Discover and resolve models** — List the models an adapter advertises, interrogate an endpoint for the models it serves (candidates carry optional `inputModalities`; absence means unknown), and resolve one exact model's context window, output default, reasoning efforts, input modalities, and system prompt update mode: `LlmResolvedModelInfo.systemPromptUpdate` is `'in-history'` when the model reads the latest `system` message at any position as the effective system prompt and absent when only a leading system message is read; `normalizeModelInfo` rejects any other value with `INVALID_MODEL_INFO`.
 - **Validate call config** — an explicit or configured reasoning effort is checked against the exact model before any provider I/O, and an adapter-configured output cap is materialized when the request omits one.
 - **Read an embedded Assistant stream without expanding it** — `assistantStreamFirstTokenTime` (first token), `assistantStreamHasVisibleContent` (any visible content), and `assistantStreamHasVisibleText` (any visible text) answer their questions from the compact records with early exit; `lastAssistantStreamChunk` scans backward to the last raw chunk of one type, `assistantStreamChunks` and `joinAssistantStreamText` scan the whole stream, and `assembleAssistantStream` feeds a `BlockAssembler` one joined delta per run with the same blocks, usage, and replay state as the per-member expansion. `runFirstTokenTime` and `runFirstVisibleTime` do the early-exit scan for one packed run, and `isTokenDelta`, `isVisibleChunk`, and `chunkHasVisibleText` define the token and visibility rules for a single chunk. `expandAssistantStream` remains the validating path for records read at a durable boundary; it is not memoized, because a retained expansion costs roughly ten times the compact stream for as long as the event lives.
@@ -105,7 +124,7 @@ The service is built on one separation: **the logical contract is provider-neutr
 
 ### Main flow
 
-A request is validated against its exact model's capability — context window, output default, reasoning efforts, input modalities, and `systemPromptUpdate` mode — and any adapter-configured defaults are materialized. The runtime preserves freezing for already-frozen input; hand-built callers own input immutability. `prepareCall()` binds those facts, detached context, and retry policy to the exact adapter generation that performs terminal dispatch, so HMR or dynamic settings cannot combine one generation's image capability with another generation's endpoint. An image-capable adapter projects durable references into route-specific request versions; `resolveImageAttachmentAccess()` separately maps an attachment provider's optional host object into the current tool execution world without changing the request image or its `variantId`. A text-only route receives deterministic per-image placeholders, including tool-role result images, without rewriting append-only session history. Durable `FileBlock` references never reach any adapter: request assembly replaces each one, including tool-role result occurrences, with deterministic handle text naming the file and its saved read-only path, resolved through the mounted attachment and filesystem providers. `ctx.llm.fileRequestText(ref)` exposes that exact synchronous projection to request measurement. An image occurrence derived with `offloaded: true` reaches every route as placeholder text through `projectOffloadedImages()`. An image-capable route whose retained occurrences exceed its `LlmImageRequestBudget` at their exact bytes fails with `IMAGE_OFFLOAD_REQUIRED` naming the additional oldest occurrences (`requiredImageOffload()`), never with an unlogged projection; `dsh-compaction-image-offload` logs the selected occurrences in one `image/offload` event and retries. Adapters that charge visual tokens declare per-route `imageRequestPricing`, which `ctx.llm.imageRequestPricing(provider, model)` resolves synchronously for the token meter. Dispatch goes through the `llm/stream` waterfall, then chunks return as token-level deltas and every adapter outcome reaches the consumer as one terminal `finish` chunk.
+A request is validated against its exact model's capability — context window, output default, reasoning efforts, input modalities, and `systemPromptUpdate` mode — and any adapter-configured defaults are materialized. The runtime preserves freezing for already-frozen input; hand-built callers own input immutability. `prepareCall()` binds those facts, detached context, and retry policy to the exact adapter generation that performs terminal dispatch, so HMR or dynamic settings cannot combine one generation's image capability with another generation's endpoint. An image-capable adapter projects durable references into route-specific request versions; `resolveImageAttachmentAccess()` separately maps an attachment provider's optional host object into the current tool execution world without changing the request image or its `variantId`. A text-only route receives deterministic per-image placeholders, including tool-role result images, without rewriting append-only session history. Durable `FileBlock` references never reach any adapter: request assembly replaces each one, including tool-role result occurrences, with deterministic handle text naming the file and its saved read-only path, resolved through the mounted attachment and filesystem providers. `ctx.llm.fileRequestText(ref)` exposes that exact synchronous projection to request measurement. An image occurrence derived with `offloaded: true` reaches every route as placeholder text through `projectOffloadedImages()`. An image-capable route whose retained occurrences exceed its `LlmImageRequestBudget` at their exact bytes fails with `IMAGE_OFFLOAD_REQUIRED` naming the additional oldest occurrences (`requiredImageOffload()`), never with an unlogged projection; `dsh-compaction-image-offload` logs the selected occurrences in one `image/offload` event and retries. Adapters that charge visual tokens declare per-route `imageRequestPricing`, which `ctx.llm.imageRequestPricing(provider, model)` resolves synchronously for the token meter. Dispatch goes through the `llm/stream` waterfall, then chunks return as token-level deltas and every adapter outcome reaches the consumer as one terminal `finish` chunk. `imageRequestTarget(provider, model, image)` exposes the same request-image dimensions and byte target to screenshot consumers; adapters without image resizing preserve the normalized source.
 
 File detection reads current content, including tool-role result content, on every request without caching message identities or freeze state. The [archived file-scan decision](../../../.agents/notes/archived/simplification/2026-09-07-file-content-scan.md) records the measured traversal cost.
 

package/README.zh.md

@@ -60,11 +60,30 @@ for await (const chunk of ctx.llm.stream({
 
 `GenerateOptions.messages` 接受持久 `Message` 值和仅供请求使用的 `RequestUserInput` 值。仅供请求使用的输入包含 user-role 内容，不含 `id` 或 `source`；Session 写入和 Agent 投递仍然要求持久消息。调用方必须在流结束前保持辅助输入不变。会记录完整请求的调用方（例如会话标题生成）必须使用持久消息。
 
+`prepareCall(config, signal, configure?)` 接受具体的 `LlmCallConfig` 值。可选的同步纯函数 `ConfigureCall` 接收已分离且深度冻结的 `LlmCallControls`，以及捕获的适配器代次所提供的模型元数据。调用方可组合普通函数来选择具体控制项；后执行的写入替换先前的值。准备操作保留捕获的路由，为省略的控制项应用默认值，校验结果，再返回用于记录与分发的冻结配置。回调失败或取消会在分发前拒绝。准备操作要求注册适配器。
+
+配置函数在适配器默认值物化之前选择控制项。例如，将最低强度选择与显式输出上限组合，再将 `configure(maxTokens)` 作为第三个参数传入：
+
+```ts
+import type { ConfigureCall } from '@deepseek-ai/dsh-llm'
+
+const leastReasoning: ConfigureCall = (controls, model) => {
+  const first = model.reasoning?.efforts[0]
+  return first === undefined ? controls : { ...controls, reasoningEffort: first.id }
+}
+
+const outputLimit = (maxTokens: number): ConfigureCall =>
+  controls => ({ ...controls, maxTokens })
+
+const configure = (maxTokens: number): ConfigureCall =>
+  (controls, model) => outputLimit(maxTokens)(leastReasoning(controls, model), model)
+```
+
 ### 你可以做什么
 
 - **流式发起一次模型调用**——`ctx.llm.stream(options)` 为任何已注册提供方与模型产出原始分片（token 级增量）；消费方用 `BlockAssembler` 组装。
 - **注册提供方适配器**——一个适配器拥有一个或多个提供方路由，其注册会捕获该路由的重试策略；重复注册同一路由会以 `DUPLICATE_ADAPTER` 失败。
-- **通过配置暴露并激活提供方**——适配器声明可配置提供方路由与 settings namespace，配置界面因此可以激活休眠提供方并编辑连接信息，无需重启。`LlmConfigurableProvider.error` 报告供修复的配置诊断；未受影响的模型仍可提供服务。
+- **通过配置暴露并激活提供方**——适配器声明可配置提供方路由与 settings namespace，配置界面因此可以激活休眠提供方并编辑连接信息，无需重启。`LlmConfigurableProvider.error` 报告供修复的配置诊断；未受影响的模型仍可提供服务。条目还可携带 `defaultBaseURL`，即配置未设置端点时适配器使用的端点；以及 `nativeAuth`，即配置未指定凭据引用时适配器认证读取的环境变量与 OAuth 登录；`baseURLEnv` 列出配置端点所用的环境变量。配置界面直接从目录读取这些字段，无需调用适配器。
 - **发现与解析模型**——列出适配器公布的模型、询问端点它提供哪些模型（候选携带可选的 `inputModalities`；缺省表示未知），并解析某个精确模型的上下文窗口、输出默认值、推理（reasoning）强度、输入模态与系统提示词更新模式：当模型把任意位置最新的 `system` 消息读作有效系统提示词时，`LlmResolvedModelInfo.systemPromptUpdate` 为 `'in-history'`；只读取开头 system 消息时该字段缺失；`normalizeModelInfo` 以 `INVALID_MODEL_INFO` 拒绝任何其他值。
 - **校验调用配置**——显式或配置的推理强度会在任何提供方 I/O 之前对照精确模型校验；请求省略输出上限时，会填入适配器配置的输出上限。
 - **不展开即读取内嵌 Assistant 流**——`assistantStreamFirstTokenTime`（首 token）、`assistantStreamHasVisibleContent`（任一可见内容）与 `assistantStreamHasVisibleText`（任一可见文本）通过可提前退出的扫描直接从紧凑记录得出结果；`lastAssistantStreamChunk` 反向扫描到某一类型的最后一个原始 chunk，`assistantStreamChunks` 与 `joinAssistantStreamText` 扫描整个流，`assembleAssistantStream` 向 `BlockAssembler` 每个 run 喂一段拼接 delta，blocks／usage／replayState 与逐成员展开相同。`runFirstTokenTime` 与 `runFirstVisibleTime` 对单个打包 run 做提前退出扫描，`isTokenDelta`、`isVisibleChunk` 与 `chunkHasVisibleText` 定义单个 chunk 的 token 与可见性规则。`expandAssistantStream` 仍是持久边界读取记录的校验路径；它不被记忆化，因为保留的展开在事件生命周期内约花费紧凑流的十倍内存。
@@ -105,7 +124,7 @@ for await (const chunk of ctx.llm.stream({
 
 ### 主流程
 
-请求会对照其精确模型的能力校验，包括上下文窗口、输出默认值、推理强度、输入模态与 `systemPromptUpdate` 模式，并填入任何适配器配置的默认值。运行时保留已冻结输入的冻结状态；手动构建请求的调用方负责保证输入不可变。`prepareCall()` 把这些事实、分离的上下文与重试策略绑定到执行最终分发的精确适配器代次，因此 HMR（热模块替换）或动态设置无法把一个代次的图片能力与另一代次的端点混用。支持图片的适配器把持久引用投影为路由专用请求版本；`resolveImageAttachmentAccess()` 会单独把附件提供方的可选宿主对象映射进当前工具执行世界，而不改变请求图片或其 `variantId`。纯文本路由接收确定性的逐图片占位符，包括 tool-role 结果图片，而不会改写仅追加会话历史。持久 `FileBlock` 引用永远不会到达任何适配器：请求组装把每个引用（包括 tool-role 结果中的出现）替换为确定性句柄文本，指出文件与其只读保存路径，路径经由挂载的附件与文件系统提供方解析。`ctx.llm.fileRequestText(ref)` 向请求计量公开相同的同步投影。派生后带有 `offloaded: true` 的图片出现位置，经 `projectOffloadedImages()` 以占位文本到达每条路由。支持图片的路由在保留的出现位置按精确字节超过其 `LlmImageRequestBudget` 时，以 `IMAGE_OFFLOAD_REQUIRED` 失败并说明还需省略多少最老的出现位置（`requiredImageOffload()`），绝不发送未记录的投影；`dsh-compaction-image-offload` 用一条 `image/offload` 事件记录所选位置并重试。对视觉 token 收费的适配器声明按路由的 `imageRequestPricing`，`ctx.llm.imageRequestPricing(provider, model)` 为 token meter 同步解析它。分发经过 `llm/stream` waterfall（瀑布式事件），随后分片以 token 级增量返回，每个适配器结果都以唯一一个终止 `finish` 分片到达消费方。
+请求会对照其精确模型的能力校验，包括上下文窗口、输出默认值、推理强度、输入模态与 `systemPromptUpdate` 模式，并填入任何适配器配置的默认值。运行时保留已冻结输入的冻结状态；手动构建请求的调用方负责保证输入不可变。`prepareCall()` 把这些事实、分离的上下文与重试策略绑定到执行最终分发的精确适配器代次，因此 HMR（热模块替换）或动态设置无法把一个代次的图片能力与另一代次的端点混用。支持图片的适配器把持久引用投影为路由专用请求版本；`resolveImageAttachmentAccess()` 会单独把附件提供方的可选宿主对象映射进当前工具执行世界，而不改变请求图片或其 `variantId`。纯文本路由接收确定性的逐图片占位符，包括 tool-role 结果图片，而不会改写仅追加会话历史。持久 `FileBlock` 引用永远不会到达任何适配器：请求组装把每个引用（包括 tool-role 结果中的出现）替换为确定性句柄文本，指出文件与其只读保存路径，路径经由挂载的附件与文件系统提供方解析。`ctx.llm.fileRequestText(ref)` 向请求计量公开相同的同步投影。派生后带有 `offloaded: true` 的图片出现位置，经 `projectOffloadedImages()` 以占位文本到达每条路由。支持图片的路由在保留的出现位置按精确字节超过其 `LlmImageRequestBudget` 时，以 `IMAGE_OFFLOAD_REQUIRED` 失败并说明还需省略多少最老的出现位置（`requiredImageOffload()`），绝不发送未记录的投影；`dsh-compaction-image-offload` 用一条 `image/offload` 事件记录所选位置并重试。对视觉 token 收费的适配器声明按路由的 `imageRequestPricing`，`ctx.llm.imageRequestPricing(provider, model)` 为 token meter 同步解析它。分发经过 `llm/stream` waterfall（瀑布式事件），随后分片以 token 级增量返回，每个适配器结果都以唯一一个终止 `finish` 分片到达消费方。 `imageRequestTarget(provider, model, image)` 向截图调用方提供与模型请求一致的图片尺寸和字节目标；不缩放图片的适配器保留归一化后的原图。
 
 文件检测在每次请求时读取当前内容，包括 tool-role 结果内容，不缓存消息身份或冻结状态。[已归档的文件扫描决策](../../../.agents/notes/archived/simplification/2026-09-07-file-content-scan.md)记录了实测遍历成本。
 

package/lib/index.js

@@ -1696,6 +1696,21 @@ var LlmAdapter = class {
 	*/
 	imageRequestPricing(_provider, _model) {}
 	/**
+	* Resolve the image dimensions and byte target this adapter sends to the model.
+	* The default preserves normalized images; adapters that resize must override it.
+	* @param _provider - registered provider route.
+	* @param _model - exact model id.
+	* @param image - normalized image whose request projection is being resolved.
+	* @returns the same target used by request serialization, before provider-internal processing.
+	*/
+	imageRequestTarget(_provider, _model, image) {
+		return {
+			width: image.width,
+			height: image.height,
+			maxBytes: image.bytes
+		};
+	}
+	/**
 	* List models this adapter can currently advertise for one owned provider.
 	* Core routing accepts unlisted model ids; catalog-driven entry points such
 	* as the GUI may require membership. Adapters used there must advertise
@@ -1918,10 +1933,7 @@ let LlmRuntime = (() => {
 					if (entry.provider.length === 0 || entry.displayName.length === 0 || entry.settingsNs.length === 0) throw new LlmError("configurable providers need a non-empty provider, displayName, and settingsNs", "INVALID_DIRECTORY");
 					if (entry.settingsPath.some((segment) => segment.length === 0)) throw new LlmError(`configurable provider "${entry.provider}" has an empty settingsPath segment`, "INVALID_DIRECTORY");
 					if (this.directory.has(entry.provider) && !own.has(entry.provider) || detached.some((seen) => seen.provider === entry.provider)) throw new LlmError(`configurable provider "${entry.provider}" is already declared`, "DUPLICATE_DIRECTORY");
-					detached.push({
-						...entry,
-						settingsPath: [...entry.settingsPath]
-					});
+					detached.push(detachDirectoryEntry(entry));
 				}
 				for (const entry of held) this.directory.delete(entry.provider);
 				for (const entry of detached) this.directory.set(entry.provider, entry);
@@ -1950,10 +1962,7 @@ let LlmRuntime = (() => {
 		* @returns detached directory entries in declaration order.
 		*/
 		listConfigurableProviders() {
-			return [...this.directory.values()].map((entry) => ({
-				...entry,
-				settingsPath: [...entry.settingsPath]
-			}));
+			return [...this.directory.values()].map(detachDirectoryEntry);
 		}
 		/**
 		* Offer to interrogate provider endpoints on behalf of the settings
@@ -2045,6 +2054,16 @@ let LlmRuntime = (() => {
 			return this.adapters.get(provider)?.adapter.imageRequestPricing(provider, model);
 		}
 		/**
+		* Resolve the image projection for an exact registered model route.
+		* @param provider - registered provider route.
+		* @param model - exact model id.
+		* @param image - normalized image reference.
+		* @returns dimensions and byte target used by the adapter's request serializer.
+		*/
+		imageRequestTarget(provider, model, image) {
+			return this.registration(provider).adapter.imageRequestTarget(provider, model, image);
+		}
+		/**
 		* Resolve the exact text one durable file occurrence contributes to every
 		* provider request in the current execution environment.
 		* @param ref - durable verbatim file reference from model history.
@@ -2190,20 +2209,33 @@ let LlmRuntime = (() => {
 		* Resolve one call under its current adapter registration. The returned
 		* one-shot handle keeps that registration across header logging and dispatch,
 		* so HMR cannot combine one adapter's capability result with another adapter.
-		* @param config - provider/model route and optional request controls.
+		* An optional synchronous callback selects concrete controls using captured
+		* model metadata. Defaults and validation apply to its result. Callback
+		* failures and cancellation reject preparation before dispatch.
+		* @param config - provider/model route and optional concrete request controls.
 		* @param signal - optional cancellation for adapter-owned capability lookup.
+		* @param configure - pure control selection, called once before defaults and validation.
 		* @returns a prepared config and its registration-bound stream entry point.
 		*/
-		async prepareCall(config, signal) {
-			const registration = this.registration(config.provider);
-			const adapterCall = await registration.adapter.prepareCall(config.provider, config.model, signal);
-			const modelInfo = this.normalizeModelInfo(registration, config.model, adapterCall.model);
-			const resolved = this.resolveCallWithInfo(config, modelInfo);
+		async prepareCall(config, signal, configure) {
+			signal?.throwIfAborted();
+			const { provider, model, ...controls } = config;
+			const registration = this.registration(provider);
+			const adapterCall = await registration.adapter.prepareCall(provider, model, signal);
+			signal?.throwIfAborted();
+			const modelInfo = this.normalizeModelInfo(registration, model, adapterCall.model);
+			const proposed = configure === void 0 ? config : {
+				...configure(deepFreeze(structuredClone(controls)), deepFreeze(modelInfo)),
+				provider,
+				model
+			};
+			signal?.throwIfAborted();
+			const resolved = this.resolveCallWithInfo(proposed, modelInfo);
 			const resolvedConfig = deepFreeze(structuredClone(resolved.config));
 			const context = resolved.context === void 0 ? void 0 : deepFreeze(structuredClone(resolved.context));
 			const adapterDefaults = deepFreeze({
-				...config.reasoningEffort === void 0 && resolvedConfig.reasoningEffort !== void 0 ? { reasoningEffort: true } : {},
-				...config.maxTokens === void 0 && resolvedConfig.maxTokens !== void 0 ? { maxTokens: true } : {}
+				...proposed.reasoningEffort === void 0 && resolvedConfig.reasoningEffort !== void 0 ? { reasoningEffort: true } : {},
+				...proposed.maxTokens === void 0 && resolvedConfig.maxTokens !== void 0 ? { maxTokens: true } : {}
 			});
 			let dispatched = false;
 			return Object.freeze({
@@ -2380,5 +2412,18 @@ function adapterFailureChunk(error, signal) {
 		}
 	};
 }
+/** Copy a directory entry, including its arrays, so neither side can mutate the other's copy. */
+function detachDirectoryEntry(entry) {
+	const { nativeAuth } = entry;
+	return {
+		...entry,
+		settingsPath: [...entry.settingsPath],
+		...entry.baseURLEnv === void 0 ? {} : { baseURLEnv: [...entry.baseURLEnv] },
+		...nativeAuth === void 0 ? {} : { nativeAuth: {
+			...nativeAuth,
+			env: [...nativeAuth.env]
+		} }
+	};
+}
 //#endregion
 export { ACCOUNT_QUOTA_EXCEEDED_CODE, APP_IDENTITY, AssistantStreamAccumulator, BlockAssembler, CONTEXT_SUMMARY_MAX_CHARS, CONTEXT_WINDOW_EXCEEDED_CODE, EMPTY_RESPONSE_CODE, HarnessError, IMAGE_OFFLOAD_REQUIRED_CODE, INVALID_CREDENTIAL_CODE, LlmAdapter, LlmAttemptId, LlmError, LlmRuntime, LlmRuntime as default, MessageId, ProviderRequestId, QUOTA_EXCEEDED_CODE, ReasoningEffortId, RetryPolicySchema, ToolCallId, assembleAssistantStream, assertUsableApiKey, assistantStreamChunks, assistantStreamFirstTokenTime, assistantStreamHasVisibleContent, assistantStreamHasVisibleText, attributionHeaders, boundContextSummary, callConfigEquals, chunkHasVisibleText, contentHasFile, contentHasImage, createAssistantMessage, createDeveloperMessage, createMessage, createSystemMessage, createToolResultMessage, createUserMessage, errorChain, expandAssistantStream, fileHandleText, freezeMessage, isAgentLoopRequest, isContextWindowExceededError, isHarnessError, isQuotaExceededError, isTokenDelta, isVisibleChunk, joinAssistantStreamText, lastAssistantStreamChunk, markAgentLoopRequest, normalizeApiKey, offloadedImageText, projectFilesToText, projectImagesForTextModel, projectOffloadedImages, projectToolUpdates, requestImageHandleText, requiredImageOffload, resolveImageAttachmentAccess, resolveRetryPolicy, runFirstTokenTime, runFirstVisibleTime, textOnlyImageText, userAgent };

package/lib/typert.host.js

@@ -1,70 +1,96 @@
 /* Generated by @deepseek-ai/dsh-typert-generator from FaceModel — do not edit. */
 import { z } from 'zod'
 
+import { createTypertRemoteInfo } from '@deepseek-ai/dsh-typert-protocol/remote-info'
+
 let _deepseek_ai_dsh_llm_llm_discoverModels_parameter_0$schema$value
 const _deepseek_ai_dsh_llm_llm_discoverModels_parameter_0$schema = () => (_deepseek_ai_dsh_llm_llm_discoverModels_parameter_0$schema$value ??= z.string())
 let _deepseek_ai_dsh_llm_llm_discoverModels_parameter_1$schema$value
 const _deepseek_ai_dsh_llm_llm_discoverModels_parameter_1$schema = () => (_deepseek_ai_dsh_llm_llm_discoverModels_parameter_1$schema$value ??= z.object({
-  'provider': z.string().optional(),
-  'baseURL': z.string().optional(),
-  'api': z.string().optional(),
-  'apiKey': z.string().optional(),
+  'provider': z.string().optional().describe('Route the draft is editing, when it edits an existing one. A route whose adapter already knows its models answers from that knowledge instead of asking the endpoint — the adapter\'s own registry is the better answer, and it costs no network call.'),
+  'baseURL': z.string().optional().describe('Endpoint to interrogate. Optional because a route the adapter already describes needs none; a route it does not must supply one.'),
+  'api': z.string().optional().describe('Wire protocol the endpoint speaks, when the draft names one.'),
+  'apiKey': z.string().optional().describe('Credential for this interrogation alone; the harness never stores it.'),
 }))
 let _deepseek_ai_dsh_llm_llm_discoverModels_result$schema$value
 const _deepseek_ai_dsh_llm_llm_discoverModels_result$schema = () => (_deepseek_ai_dsh_llm_llm_discoverModels_result$schema$value ??= z.array(z.object({
-  'id': z.string(),
-  'name': z.string().optional(),
-  'contextWindow': z.number().optional(),
-  'maxTokens': z.number().optional(),
-  'inputModalities': z.array(z.union([z.literal("text"), z.literal("image")])).optional(),
+  'id': z.string().describe('Model id the endpoint accepts.'),
+  'name': z.string().optional().describe('Human-readable name when the endpoint supplies one.'),
+  'contextWindow': z.number().optional().describe('Maximum combined request and response context, when disclosed.'),
+  'maxTokens': z.number().optional().describe('Maximum output tokens, when disclosed.'),
+  'inputModalities': z.array(z.union([z.literal("text"), z.literal("image")])).optional().describe('Accepted input types when disclosed by the catalog or endpoint; absent means unknown.'),
 })))
 let _deepseek_ai_dsh_llm_llm_listConfigurableProviders_result$schema$value
 const _deepseek_ai_dsh_llm_llm_listConfigurableProviders_result$schema = () => (_deepseek_ai_dsh_llm_llm_listConfigurableProviders_result$schema$value ??= z.array(z.object({
-  'provider': z.string(),
-  'displayName': z.string(),
-  'settingsNs': z.string(),
-  'settingsPath': z.array(z.string()),
-  'declared': z.boolean().optional(),
-  'error': z.string().optional(),
+  'provider': z.string().describe('Provider route key this entry activates when configured.'),
+  'displayName': z.string().describe('Human-readable provider name for configuration surfaces.'),
+  'settingsNs': z.string().describe('User-settings namespace whose section configures this provider.'),
+  'settingsPath': z.array(z.string()).describe('Path from that namespace\'s section root to this provider\'s profile object; empty when the whole section is the profile.'),
+  'declared': z.boolean().optional().describe('Whether the owning adapter knows this route only because configuration declared it — a gateway or self-hosted server it ships nothing about. Absent means the adapter draws no such distinction; false means it does and this route is one of its own. Only the adapter can answer: a stored profile is how a user-added route AND a corrected shipped one both look from outside.'),
+  'defaultBaseURL': z.string().optional().describe('Route endpoint the adapter uses when the profile sets no `baseURL`; the adapter may still send an individual model to that model\'s own endpoint. Absent when the route has no fixed endpoint.'),
+  'baseURLEnv': z.array(z.string()).optional().describe('Environment variables used to construct a provider endpoint; absent when none are reported.'),
+  'nativeAuth': z.object({
+  'env': z.array(z.string()).describe('Environment variables the route\'s authentication reads, in lookup order; empty when it reads none.'),
+  'oauth': z.boolean().describe('Whether a stored OAuth sign-in can authenticate the route.'),
+}).optional().describe('Authentication the adapter performs when the profile names no credential reference; absent when it reports none.'),
+  'error': z.string().optional().describe('Configuration diagnostic for repair; unaffected models may remain serviceable.'),
 })))
 let _deepseek_ai_dsh_llm_llm_listProviders_result$schema$value
 const _deepseek_ai_dsh_llm_llm_listProviders_result$schema = () => (_deepseek_ai_dsh_llm_llm_listProviders_result$schema$value ??= z.array(z.object({
-  'id': z.string(),
-  'name': z.string(),
+  'id': z.string().describe('Provider route key used by {@link GenerateOptions.provider}.'),
+  'name': z.string().describe('Human-readable provider name for selectors and diagnostics.'),
 })))
+let _deepseek_ai_dsh_llm_llm_discoverModels_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_llm_llm_discoverModels_parameter_0_strict$schema = () => (_deepseek_ai_dsh_llm_llm_discoverModels_parameter_0_strict$schema$value ??= z.string())
+let _deepseek_ai_dsh_llm_llm_discoverModels_parameter_1_strict$schema$value
+const _deepseek_ai_dsh_llm_llm_discoverModels_parameter_1_strict$schema = () => (_deepseek_ai_dsh_llm_llm_discoverModels_parameter_1_strict$schema$value ??= z.strictObject({
+  'provider': z.string().optional().describe('Route the draft is editing, when it edits an existing one. A route whose adapter already knows its models answers from that knowledge instead of asking the endpoint — the adapter\'s own registry is the better answer, and it costs no network call.'),
+  'baseURL': z.string().optional().describe('Endpoint to interrogate. Optional because a route the adapter already describes needs none; a route it does not must supply one.'),
+  'api': z.string().optional().describe('Wire protocol the endpoint speaks, when the draft names one.'),
+  'apiKey': z.string().optional().describe('Credential for this interrogation alone; the harness never stores it.'),
+}))
 
-export const TYPERT = {
+const $remote = createTypertRemoteInfo({
   package: '@deepseek-ai/dsh-llm',
-  face: 'host',
-  schemas: [
-  ],
-  invocations: [
-    {
-      id: '@deepseek-ai/dsh-llm#llm/discoverModels',
+  methods: {
+    'llm/discoverModels': {
       service: 'llm',
-      namespace: 'llm',
-      method: 'discoverModels',
+      description: 'Remote adapter for one draft provider interrogation.',
       implementation: 'remoteDiscoverModels',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'settingsNs',
-          wire: 'settingsNs',
+          description: 'namespace whose registered discovery serves this draft.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-llm#llm/discoverModels:settingsNs',
             create: _deepseek_ai_dsh_llm_llm_discoverModels_parameter_0$schema,
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-llm#llm/discoverModels:settingsNs',
+            create: _deepseek_ai_dsh_llm_llm_discoverModels_parameter_0_strict$schema,
+            jsonSchema: {"type":"string"},
           },
         },
         {
           name: 'request',
-          wire: 'request',
+          description: 'endpoint, protocol, and one-shot credential to use.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-llm/types#LlmModelDiscoveryRequest',
             create: _deepseek_ai_dsh_llm_llm_discoverModels_parameter_1$schema,
+            jsonSchema: {"type":"object","properties":{"provider":{"type":"string","description":"Route the draft is editing, when it edits an existing one. A route whose adapter already knows its models answers from that knowledge instead of asking the endpoint — the adapter's own registry is the better answer, and it costs no network call."},"baseURL":{"type":"string","description":"Endpoint to interrogate. Optional because a route the adapter already describes needs none; a route it does not must supply one."},"api":{"type":"string","description":"Wire protocol the endpoint speaks, when the draft names one."},"apiKey":{"type":"string","description":"Credential for this interrogation alone; the harness never stores it."}},"required":[],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-llm/types#LlmModelDiscoveryRequest',
+            create: _deepseek_ai_dsh_llm_llm_discoverModels_parameter_1_strict$schema,
+            jsonSchema: {"type":"object","properties":{"provider":{"type":"string","description":"Route the draft is editing, when it edits an existing one. A route whose adapter already knows its models answers from that knowledge instead of asking the endpoint — the adapter's own registry is the better answer, and it costs no network call."},"baseURL":{"type":"string","description":"Endpoint to interrogate. Optional because a route the adapter already describes needs none; a route it does not must supply one."},"api":{"type":"string","description":"Wire protocol the endpoint speaks, when the draft names one."},"apiKey":{"type":"string","description":"Credential for this interrogation alone; the harness never stores it."}},"required":[],"additionalProperties":false},
           },
         },
       ],
@@ -73,14 +99,14 @@ export const TYPERT = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-llm#llm/discoverModels:result',
         create: _deepseek_ai_dsh_llm_llm_discoverModels_result$schema,
+        description: 'advertised models in endpoint order.',
+        jsonSchema: {"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Model id the endpoint accepts."},"name":{"type":"string","description":"Human-readable name when the endpoint supplies one."},"contextWindow":{"type":"number","description":"Maximum combined request and response context, when disclosed."},"maxTokens":{"type":"number","description":"Maximum output tokens, when disclosed."},"inputModalities":{"type":"array","items":{"type":"string","enum":["text","image"]},"description":"Accepted input types when disclosed by the catalog or endpoint; absent means unknown."}},"required":["id"],"additionalProperties":true}},
       },
-      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":631,"column":9},
+      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":643,"column":9},
     },
-    {
-      id: '@deepseek-ai/dsh-llm#llm/listConfigurableProviders',
+    'llm/listConfigurableProviders': {
       service: 'llm',
-      namespace: 'llm',
-      method: 'listConfigurableProviders',
+      description: 'List every declared configurable provider, registered or dormant.',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -88,14 +114,14 @@ export const TYPERT = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-llm#llm/listConfigurableProviders:result',
         create: _deepseek_ai_dsh_llm_llm_listConfigurableProviders_result$schema,
+        description: 'detached directory entries in declaration order.',
+        jsonSchema: {"type":"array","items":{"type":"object","properties":{"provider":{"type":"string","description":"Provider route key this entry activates when configured."},"displayName":{"type":"string","description":"Human-readable provider name for configuration surfaces."},"settingsNs":{"type":"string","description":"User-settings namespace whose section configures this provider."},"settingsPath":{"type":"array","items":{"type":"string"},"description":"Path from that namespace's section root to this provider's profile object; empty when the whole section is the profile."},"declared":{"type":"boolean","description":"Whether the owning adapter knows this route only because configuration declared it — a gateway or self-hosted server it ships nothing about. Absent means the adapter draws no such distinction; false means it does and this route is one of its own. Only the adapter can answer: a stored profile is how a user-added route AND a corrected shipped one both look from outside."},"defaultBaseURL":{"type":"string","description":"Route endpoint the adapter uses when the profile sets no `baseURL`; the adapter may still send an individual model to that model's own endpoint. Absent when the route has no fixed endpoint."},"baseURLEnv":{"type":"array","items":{"type":"string"},"description":"Environment variables used to construct a provider endpoint; absent when none are reported."},"nativeAuth":{"type":"object","properties":{"env":{"type":"array","items":{"type":"string"},"description":"Environment variables the route's authentication reads, in lookup order; empty when it reads none."},"oauth":{"type":"boolean","description":"Whether a stored OAuth sign-in can authenticate the route."}},"required":["env","oauth"],"additionalProperties":true,"description":"Authentication the adapter performs when the profile names no credential reference; absent when it reports none."},"error":{"type":"string","description":"Configuration diagnostic for repair; unaffected models may remain serviceable."}},"required":["provider","displayName","settingsNs","settingsPath"],"additionalProperties":true}},
       },
-      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":543,"column":3},
+      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":555,"column":3},
     },
-    {
-      id: '@deepseek-ai/dsh-llm#llm/listProviders',
+    'llm/listProviders': {
       service: 'llm',
-      namespace: 'llm',
-      method: 'listProviders',
+      description: 'Describe provider routes with a registered adapter.',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -103,10 +129,20 @@ export const TYPERT = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-llm#llm/listProviders:result',
         create: _deepseek_ai_dsh_llm_llm_listProviders_result$schema,
+        description: 'detached provider metadata in registration order.',
+        jsonSchema: {"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Provider route key used by {@link GenerateOptions.provider}."},"name":{"type":"string","description":"Human-readable provider name for selectors and diagnostics."}},"required":["id","name"],"additionalProperties":true}},
       },
-      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":471,"column":3},
+      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":483,"column":3},
     },
+  },
+}, z)
+
+export const TYPERT = {
+  package: '@deepseek-ai/dsh-llm',
+  face: 'host',
+  schemas: [
   ],
+  get invocations() { return $remote.descriptors },
   model: {
     "services": [
       {
@@ -180,6 +216,13 @@ export const TYPERT = {
             "summary": "Resolve provider-side request-image pricing for one exact route, or `undefined` when the provider is unregistered or declares none.",
             "jsDoc": "/**\n * Resolve provider-side request-image pricing for one exact route, or\n * `undefined` when the provider is unregistered or declares none. Unknown\n * providers degrade to `undefined` rather than throwing because callers\n * price durable history whose route may no longer be mounted.\n * @param provider - provider route named by a request header.\n * @param model - exact model id named by the same header.\n * @returns the owning adapter's image pricing for the route, when declared.\n */"
           },
+          {
+            "kind": "method",
+            "name": "imageRequestTarget",
+            "signature": "imageRequestTarget(provider: string, model: string, image: ImageAttachmentRef): ImageRequestTarget",
+            "summary": "Resolve the image projection for an exact registered model route.",
+            "jsDoc": "/**\n * Resolve the image projection for an exact registered model route.\n * @param provider - registered provider route.\n * @param model - exact model id.\n * @param image - normalized image reference.\n * @returns dimensions and byte target used by the adapter's request serializer.\n */"
+          },
           {
             "kind": "method",
             "name": "fileRequestText",
@@ -211,9 +254,9 @@ export const TYPERT = {
           {
             "kind": "method",
             "name": "prepareCall",
-            "signature": "async prepareCall(config: LlmCallConfig, signal?: AbortSignal): Promise<PreparedLlmCall>",
+            "signature": "async prepareCall( config: LlmCallConfig, signal?: AbortSignal, configure?: ConfigureCall, ): Promise<PreparedLlmCall>",
             "summary": "Resolve one call under its current adapter registration.",
-            "jsDoc": "/**\n * Resolve one call under its current adapter registration. The returned\n * one-shot handle keeps that registration across header logging and dispatch,\n * so HMR cannot combine one adapter's capability result with another adapter.\n * @param config - provider/model route and optional request controls.\n * @param signal - optional cancellation for adapter-owned capability lookup.\n * @returns a prepared config and its registration-bound stream entry point.\n */"
+            "jsDoc": "/**\n * Resolve one call under its current adapter registration. The returned\n * one-shot handle keeps that registration across header logging and dispatch,\n * so HMR cannot combine one adapter's capability result with another adapter.\n * An optional synchronous callback selects concrete controls using captured\n * model metadata. Defaults and validation apply to its result. Callback\n * failures and cancellation reject preparation before dispatch.\n * @param config - provider/model route and optional concrete request controls.\n * @param signal - optional cancellation for adapter-owned capability lookup.\n * @param configure - pure control selection, called once before defaults and validation.\n * @returns a prepared config and its registration-bound stream entry point.\n */"
           },
           {
             "kind": "method",
@@ -264,6 +307,10 @@ export const TYPERT = {
             "name": "CompactionId",
             "declaration": "export type CompactionId = Branded<'CompactionId'>;"
           },
+          {
+            "name": "ConfigureCall",
+            "declaration": "export type ConfigureCall = (controls: Readonly<LlmCallControls>, model: Readonly<LlmResolvedModelInfo>) => LlmCallControls;"
+          },
           {
             "name": "ContentBlock",
             "declaration": "export type ContentBlock = ContentBlockMap[ContentBlockType];"
@@ -332,21 +379,29 @@ export const TYPERT = {
             "name": "ImageMediaType",
             "declaration": "export type ImageMediaType = 'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif';"
           },
+          {
+            "name": "ImageRequestTarget",
+            "declaration": "export interface ImageRequestTarget {\n    width: number;\n    height: number;\n    maxBytes: number;\n}"
+          },
           {
             "name": "LlmAdapter",
-            "declaration": "export abstract class LlmAdapter {\n    providerInfo(provider: string): LlmProviderInfo;\n    providerRetryPolicy(_provider: string): ResolvedRetryPolicy | undefined;\n    imageRequestPricing(_provider: string, _model: string): LlmImageRequestPricing | undefined;\n    listModels(_provider: string): Promise<readonly LlmModelInfo[]>;\n    resolveModel(provider: string, model: string, _signal?: AbortSignal): Promise<LlmResolvedModelInfo>;\n    prepareCall(provider: string, model: string, signal?: AbortSignal): Promise<PreparedAdapterCall>;\n    abstract stream(options: GenerateOptions): AsyncIterable<StreamChunk>;\n}"
+            "declaration": "export abstract class LlmAdapter {\n    providerInfo(provider: string): LlmProviderInfo;\n    providerRetryPolicy(_provider: string): ResolvedRetryPolicy | undefined;\n    imageRequestPricing(_provider: string, _model: string): LlmImageRequestPricing | undefined;\n    imageRequestTarget(_provider: string, _model: string, image: ImageAttachmentRef): ImageRequestTarget;\n    listModels(_provider: string): Promise<readonly LlmModelInfo[]>;\n    resolveModel(provider: string, model: string, _signal?: AbortSignal): Promise<LlmResolvedModelInfo>;\n    prepareCall(provider: string, model: string, signal?: AbortSignal): Promise<PreparedAdapterCall>;\n    abstract stream(options: GenerateOptions): AsyncIterable<StreamChunk>;\n}"
           },
           {
             "name": "LlmCallConfig",
-            "declaration": "export interface LlmCallConfig {\n    provider: string;\n    model: string;\n    reasoningEffort?: ReasoningEffortId;\n    temperature?: number;\n    maxTokens?: number;\n    stop?: string[];\n}"
+            "declaration": "export interface LlmCallConfig extends LlmCallControls {\n    provider: string;\n    model: string;\n}"
           },
           {
             "name": "LlmCallConfigAdapterDefaults",
             "declaration": "export interface LlmCallConfigAdapterDefaults {\n    reasoningEffort?: true;\n    maxTokens?: true;\n}"
           },
+          {
+            "name": "LlmCallControls",
+            "declaration": "export interface LlmCallControls {\n    reasoningEffort?: ReasoningEffortId;\n    temperature?: number;\n    maxTokens?: number;\n    stop?: string[];\n}"
+          },
           {
             "name": "LlmConfigurableProvider",
-            "declaration": "export interface LlmConfigurableProvider {\n    provider: string;\n    displayName: string;\n    settingsNs: string;\n    settingsPath: readonly string[];\n    declared?: boolean;\n    error?: string;\n}"
+            "declaration": "export interface LlmConfigurableProvider {\n    provider: string;\n    displayName: string;\n    settingsNs: string;\n    settingsPath: readonly string[];\n    declared?: boolean;\n    defaultBaseURL?: string;\n    baseURLEnv?: readonly string[];\n    nativeAuth?: LlmNativeAuth;\n    error?: string;\n}"
           },
           {
             "name": "LlmDiscoveredModel",
@@ -380,6 +435,10 @@ export const TYPERT = {
             "name": "LlmModelReasoningInfo",
             "declaration": "export interface LlmModelReasoningInfo {\n    efforts: readonly LlmReasoningEffortInfo[];\n    defaultEffort?: ReasoningEffortId;\n}"
           },
+          {
+            "name": "LlmNativeAuth",
+            "declaration": "export interface LlmNativeAuth {\n    env: readonly string[];\n    oauth: boolean;\n}"
+          },
           {
             "name": "LlmProviderInfo",
             "declaration": "export interface LlmProviderInfo {\n    id: string;\n    name: string;\n}"
@@ -414,7 +473,7 @@ export const TYPERT = {
           },
           {
             "name": "MessageSourceMap",
-            "declaration": "export interface MessageSourceMap {\n    user: { kind: 'user'; };\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n    'system-prompt': SystemPromptMessageSource;\n    'model-selection': { kind: 'model-selection'; } & ContextFormed;\n    'user-approval': { kind: 'user-approval'; } & ContextFormed;\n    'ptc-mode': { kind: 'ptc-mode'; };\n    'tool-registry': { kind: 'tool-registry'; };\n    'user-rpc': { kind: 'user'; rpcId: SessionRequestId; clientTimeZone?: string; };\n    'agent-message': AgentMessageSource;\n    'subagent-settled': SubagentSettledMessageSource;\n    'skill-invocation': SkillInvocationSource;\n    'cordis-host-runner': { kind: 'cordis-host-runner'; };\n    'compact-checkpoint': CompactionCheckpointSource;\n    'user-question-reply': { kind: 'user-question-reply'; callId: ToolCallId; outcome: 'answered'; };\n    goal: GoalMessageSource;\n    schedule: { kind: 'schedule'; } & ContextFormed;\n    'session-reference': SessionReferenceSource;\n}"
+            "declaration": "export interface MessageSourceMap {\n    user: { kind: 'user'; };\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n    'system-prompt': SystemPromptMessageSource;\n    'model-selection': { kind: 'model-selection'; } & ContextFormed;\n    'runtime-context': { kind: 'runtime-context'; } & ContextFormed;\n    'working-directory': { kind: 'working-directory'; };\n    'user-approval': { kind: 'user-approval'; } & ContextFormed;\n    'ptc-mode': { kind: 'ptc-mode'; };\n    'tool-registry': { kind: 'tool-registry'; };\n    'user-rpc': { kind: 'user'; rpcId: SessionRequestId; clientTimeZone?: string; principal?: Principal; };\n    'agent-message': AgentMessageSource;\n    'subagent-settled': SubagentSettledMessageSource;\n    'skill-invocation': SkillInvocationSource;\n    'compact-checkpoint': CompactionCheckpointSource;\n    'cordis-host-runner': { kind: 'cordis-host-runner'; };\n    'team-message': TeamMessageSource;\n    'user-question-reply': { kind: 'user-question-reply'; callId: ToolCallId; outcome: 'answered'; };\n    goal: GoalMessageSource;\n    'plan-mode': { kind: 'plan-mode'; } & ContextFormed;\n    schedule: { kind: 'schedule'; } & ContextFormed;\n    'session-reference': SessionReferenceSource;\n    webhook: { readonly kind: 'webhook'; readonly provider: string; readonly source: WebhookSourceId; readonly deliveryId: WebhookDeliveryId; readonly ruleId: WebhookRuleId; readonly form: 'notice'; readonly summary: string; };\n}"
           },
           {
             "name": "ModelMessageSource",
@@ -440,6 +499,14 @@ export const TYPERT = {
             "name": "PreparedLlmCall",
             "declaration": "export interface PreparedLlmCall {\n    readonly config: LlmCallConfig;\n    readonly retryPolicy: ResolvedRetryPolicy;\n    readonly context?: LlmModelContext;\n    readonly inputModalities?: readonly ModelModality[];\n    readonly systemPromptUpdate?: SystemPromptUpdate;\n    readonly toolUpdate?: ToolUpdate;\n    readonly adapterDefaults: LlmCallConfigAdapterDefaults;\n    stream(options: GenerateOptions): AsyncIterable<StreamChunk>;\n}"
           },
+          {
+            "name": "Principal",
+            "declaration": "export type Principal = PrincipalMap[keyof PrincipalMap];"
+          },
+          {
+            "name": "PrincipalMap",
+            "declaration": "export interface PrincipalMap {\n    owner: { readonly kind: 'owner'; };\n}"
+          },
           {
             "name": "ProviderRequestId",
             "declaration": "export type ProviderRequestId = Branded<'ProviderRequestId'>;"
@@ -520,6 +587,18 @@ export const TYPERT = {
             "name": "SystemPromptUpdate",
             "declaration": "export type SystemPromptUpdate = 'in-history';"
           },
+          {
+            "name": "TeamId",
+            "declaration": "export type TeamId = Branded<'TeamId'>;"
+          },
+          {
+            "name": "TeamMessageId",
+            "declaration": "export type TeamMessageId = Branded<'TeamMessageId'>;"
+          },
+          {
+            "name": "TeamMessageSource",
+            "declaration": "export interface TeamMessageSource {\n    readonly kind: 'team-message';\n    readonly teamId: TeamId;\n    readonly messageId: TeamMessageId;\n    readonly senderId: SessionId;\n    readonly senderName: string;\n}"
+          },
           {
             "name": "TextBlock",
             "declaration": "export interface TextBlock {\n    type: 'text';\n    text: string;\n}"
@@ -567,6 +646,18 @@ export const TYPERT = {
           {
             "name": "UserMessage",
             "declaration": "export interface UserMessage extends MessageBase {\n    readonly role: 'user';\n}"
+          },
+          {
+            "name": "WebhookDeliveryId",
+            "declaration": "export type WebhookDeliveryId = Branded<'WebhookDeliveryId'>;"
+          },
+          {
+            "name": "WebhookRuleId",
+            "declaration": "export type WebhookRuleId = Branded<'WebhookRuleId'>;"
+          },
+          {
+            "name": "WebhookSourceId",
+            "declaration": "export type WebhookSourceId = Branded<'WebhookSourceId'>;"
           }
         ]
       }

package/lib/typert.remote-client.d.ts

@@ -1,7 +1,8 @@
 /* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
 import type {
   RemoteResult,
-  TypertRemoteContribution,
+  TypertRemoteInfo,
+  TypertRemoteMethod,
 } from '@deepseek-ai/dsh-typert-protocol'
 import type { LlmConfigurableProvider, LlmDiscoveredModel, LlmModelDiscoveryRequest, LlmProviderInfo } from '@deepseek-ai/dsh-llm/types'
 
@@ -21,6 +22,10 @@ declare module '@deepseek-ai/dsh-typert-protocol' {
   }
 }
 
-export declare const TYPERT_REMOTE: TypertRemoteContribution
+export declare const TYPERT_REMOTE: TypertRemoteInfo<{
+  readonly 'llm/discoverModels': TypertRemoteMethod<{ readonly 'settingsNs': string; readonly 'request': LlmModelDiscoveryRequest }, LlmDiscoveredModel[]>
+  readonly 'llm/listConfigurableProviders': TypertRemoteMethod<{  }, LlmConfigurableProvider[]>
+  readonly 'llm/listProviders': TypertRemoteMethod<{  }, LlmProviderInfo[]>
+}>
 export default TYPERT_REMOTE
 //# sourceMappingURL=typert.remote-client.d.ts.map

package/lib/typert.remote-client.js

@@ -1,67 +1,96 @@
 /* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
 import { z } from 'zod'
 
+import { createTypertRemoteInfo } from '@deepseek-ai/dsh-typert-protocol/remote-info'
+
 let _deepseek_ai_dsh_llm_llm_discoverModels_parameter_0$schema$value
 const _deepseek_ai_dsh_llm_llm_discoverModels_parameter_0$schema = () => (_deepseek_ai_dsh_llm_llm_discoverModels_parameter_0$schema$value ??= z.string())
 let _deepseek_ai_dsh_llm_llm_discoverModels_parameter_1$schema$value
 const _deepseek_ai_dsh_llm_llm_discoverModels_parameter_1$schema = () => (_deepseek_ai_dsh_llm_llm_discoverModels_parameter_1$schema$value ??= z.object({
-  'provider': z.string().optional(),
-  'baseURL': z.string().optional(),
-  'api': z.string().optional(),
-  'apiKey': z.string().optional(),
+  'provider': z.string().optional().describe('Route the draft is editing, when it edits an existing one. A route whose adapter already knows its models answers from that knowledge instead of asking the endpoint — the adapter\'s own registry is the better answer, and it costs no network call.'),
+  'baseURL': z.string().optional().describe('Endpoint to interrogate. Optional because a route the adapter already describes needs none; a route it does not must supply one.'),
+  'api': z.string().optional().describe('Wire protocol the endpoint speaks, when the draft names one.'),
+  'apiKey': z.string().optional().describe('Credential for this interrogation alone; the harness never stores it.'),
 }))
 let _deepseek_ai_dsh_llm_llm_discoverModels_result$schema$value
 const _deepseek_ai_dsh_llm_llm_discoverModels_result$schema = () => (_deepseek_ai_dsh_llm_llm_discoverModels_result$schema$value ??= z.array(z.object({
-  'id': z.string(),
-  'name': z.string().optional(),
-  'contextWindow': z.number().optional(),
-  'maxTokens': z.number().optional(),
-  'inputModalities': z.array(z.union([z.literal("text"), z.literal("image")])).optional(),
+  'id': z.string().describe('Model id the endpoint accepts.'),
+  'name': z.string().optional().describe('Human-readable name when the endpoint supplies one.'),
+  'contextWindow': z.number().optional().describe('Maximum combined request and response context, when disclosed.'),
+  'maxTokens': z.number().optional().describe('Maximum output tokens, when disclosed.'),
+  'inputModalities': z.array(z.union([z.literal("text"), z.literal("image")])).optional().describe('Accepted input types when disclosed by the catalog or endpoint; absent means unknown.'),
 })))
 let _deepseek_ai_dsh_llm_llm_listConfigurableProviders_result$schema$value
 const _deepseek_ai_dsh_llm_llm_listConfigurableProviders_result$schema = () => (_deepseek_ai_dsh_llm_llm_listConfigurableProviders_result$schema$value ??= z.array(z.object({
-  'provider': z.string(),
-  'displayName': z.string(),
-  'settingsNs': z.string(),
-  'settingsPath': z.array(z.string()),
-  'declared': z.boolean().optional(),
-  'error': z.string().optional(),
+  'provider': z.string().describe('Provider route key this entry activates when configured.'),
+  'displayName': z.string().describe('Human-readable provider name for configuration surfaces.'),
+  'settingsNs': z.string().describe('User-settings namespace whose section configures this provider.'),
+  'settingsPath': z.array(z.string()).describe('Path from that namespace\'s section root to this provider\'s profile object; empty when the whole section is the profile.'),
+  'declared': z.boolean().optional().describe('Whether the owning adapter knows this route only because configuration declared it — a gateway or self-hosted server it ships nothing about. Absent means the adapter draws no such distinction; false means it does and this route is one of its own. Only the adapter can answer: a stored profile is how a user-added route AND a corrected shipped one both look from outside.'),
+  'defaultBaseURL': z.string().optional().describe('Route endpoint the adapter uses when the profile sets no `baseURL`; the adapter may still send an individual model to that model\'s own endpoint. Absent when the route has no fixed endpoint.'),
+  'baseURLEnv': z.array(z.string()).optional().describe('Environment variables used to construct a provider endpoint; absent when none are reported.'),
+  'nativeAuth': z.object({
+  'env': z.array(z.string()).describe('Environment variables the route\'s authentication reads, in lookup order; empty when it reads none.'),
+  'oauth': z.boolean().describe('Whether a stored OAuth sign-in can authenticate the route.'),
+}).optional().describe('Authentication the adapter performs when the profile names no credential reference; absent when it reports none.'),
+  'error': z.string().optional().describe('Configuration diagnostic for repair; unaffected models may remain serviceable.'),
 })))
 let _deepseek_ai_dsh_llm_llm_listProviders_result$schema$value
 const _deepseek_ai_dsh_llm_llm_listProviders_result$schema = () => (_deepseek_ai_dsh_llm_llm_listProviders_result$schema$value ??= z.array(z.object({
-  'id': z.string(),
-  'name': z.string(),
+  'id': z.string().describe('Provider route key used by {@link GenerateOptions.provider}.'),
+  'name': z.string().describe('Human-readable provider name for selectors and diagnostics.'),
 })))
+let _deepseek_ai_dsh_llm_llm_discoverModels_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_llm_llm_discoverModels_parameter_0_strict$schema = () => (_deepseek_ai_dsh_llm_llm_discoverModels_parameter_0_strict$schema$value ??= z.string())
+let _deepseek_ai_dsh_llm_llm_discoverModels_parameter_1_strict$schema$value
+const _deepseek_ai_dsh_llm_llm_discoverModels_parameter_1_strict$schema = () => (_deepseek_ai_dsh_llm_llm_discoverModels_parameter_1_strict$schema$value ??= z.strictObject({
+  'provider': z.string().optional().describe('Route the draft is editing, when it edits an existing one. A route whose adapter already knows its models answers from that knowledge instead of asking the endpoint — the adapter\'s own registry is the better answer, and it costs no network call.'),
+  'baseURL': z.string().optional().describe('Endpoint to interrogate. Optional because a route the adapter already describes needs none; a route it does not must supply one.'),
+  'api': z.string().optional().describe('Wire protocol the endpoint speaks, when the draft names one.'),
+  'apiKey': z.string().optional().describe('Credential for this interrogation alone; the harness never stores it.'),
+}))
 
-export const TYPERT_REMOTE = {
+export const TYPERT_REMOTE = createTypertRemoteInfo({
   package: '@deepseek-ai/dsh-llm',
-  descriptors: [
-    {
-      id: '@deepseek-ai/dsh-llm#llm/discoverModels',
+  methods: {
+    'llm/discoverModels': {
       service: 'llm',
-      namespace: 'llm',
-      method: 'discoverModels',
+      description: 'Remote adapter for one draft provider interrogation.',
       implementation: 'remoteDiscoverModels',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'settingsNs',
-          wire: 'settingsNs',
+          description: 'namespace whose registered discovery serves this draft.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-llm#llm/discoverModels:settingsNs',
             create: _deepseek_ai_dsh_llm_llm_discoverModels_parameter_0$schema,
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-llm#llm/discoverModels:settingsNs',
+            create: _deepseek_ai_dsh_llm_llm_discoverModels_parameter_0_strict$schema,
+            jsonSchema: {"type":"string"},
           },
         },
         {
           name: 'request',
-          wire: 'request',
+          description: 'endpoint, protocol, and one-shot credential to use.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-llm/types#LlmModelDiscoveryRequest',
             create: _deepseek_ai_dsh_llm_llm_discoverModels_parameter_1$schema,
+            jsonSchema: {"type":"object","properties":{"provider":{"type":"string","description":"Route the draft is editing, when it edits an existing one. A route whose adapter already knows its models answers from that knowledge instead of asking the endpoint — the adapter's own registry is the better answer, and it costs no network call."},"baseURL":{"type":"string","description":"Endpoint to interrogate. Optional because a route the adapter already describes needs none; a route it does not must supply one."},"api":{"type":"string","description":"Wire protocol the endpoint speaks, when the draft names one."},"apiKey":{"type":"string","description":"Credential for this interrogation alone; the harness never stores it."}},"required":[],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-llm/types#LlmModelDiscoveryRequest',
+            create: _deepseek_ai_dsh_llm_llm_discoverModels_parameter_1_strict$schema,
+            jsonSchema: {"type":"object","properties":{"provider":{"type":"string","description":"Route the draft is editing, when it edits an existing one. A route whose adapter already knows its models answers from that knowledge instead of asking the endpoint — the adapter's own registry is the better answer, and it costs no network call."},"baseURL":{"type":"string","description":"Endpoint to interrogate. Optional because a route the adapter already describes needs none; a route it does not must supply one."},"api":{"type":"string","description":"Wire protocol the endpoint speaks, when the draft names one."},"apiKey":{"type":"string","description":"Credential for this interrogation alone; the harness never stores it."}},"required":[],"additionalProperties":false},
           },
         },
       ],
@@ -70,14 +99,14 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-llm#llm/discoverModels:result',
         create: _deepseek_ai_dsh_llm_llm_discoverModels_result$schema,
+        description: 'advertised models in endpoint order.',
+        jsonSchema: {"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Model id the endpoint accepts."},"name":{"type":"string","description":"Human-readable name when the endpoint supplies one."},"contextWindow":{"type":"number","description":"Maximum combined request and response context, when disclosed."},"maxTokens":{"type":"number","description":"Maximum output tokens, when disclosed."},"inputModalities":{"type":"array","items":{"type":"string","enum":["text","image"]},"description":"Accepted input types when disclosed by the catalog or endpoint; absent means unknown."}},"required":["id"],"additionalProperties":true}},
       },
-      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":631,"column":9},
+      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":643,"column":9},
     },
-    {
-      id: '@deepseek-ai/dsh-llm#llm/listConfigurableProviders',
+    'llm/listConfigurableProviders': {
       service: 'llm',
-      namespace: 'llm',
-      method: 'listConfigurableProviders',
+      description: 'List every declared configurable provider, registered or dormant.',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -85,14 +114,14 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-llm#llm/listConfigurableProviders:result',
         create: _deepseek_ai_dsh_llm_llm_listConfigurableProviders_result$schema,
+        description: 'detached directory entries in declaration order.',
+        jsonSchema: {"type":"array","items":{"type":"object","properties":{"provider":{"type":"string","description":"Provider route key this entry activates when configured."},"displayName":{"type":"string","description":"Human-readable provider name for configuration surfaces."},"settingsNs":{"type":"string","description":"User-settings namespace whose section configures this provider."},"settingsPath":{"type":"array","items":{"type":"string"},"description":"Path from that namespace's section root to this provider's profile object; empty when the whole section is the profile."},"declared":{"type":"boolean","description":"Whether the owning adapter knows this route only because configuration declared it — a gateway or self-hosted server it ships nothing about. Absent means the adapter draws no such distinction; false means it does and this route is one of its own. Only the adapter can answer: a stored profile is how a user-added route AND a corrected shipped one both look from outside."},"defaultBaseURL":{"type":"string","description":"Route endpoint the adapter uses when the profile sets no `baseURL`; the adapter may still send an individual model to that model's own endpoint. Absent when the route has no fixed endpoint."},"baseURLEnv":{"type":"array","items":{"type":"string"},"description":"Environment variables used to construct a provider endpoint; absent when none are reported."},"nativeAuth":{"type":"object","properties":{"env":{"type":"array","items":{"type":"string"},"description":"Environment variables the route's authentication reads, in lookup order; empty when it reads none."},"oauth":{"type":"boolean","description":"Whether a stored OAuth sign-in can authenticate the route."}},"required":["env","oauth"],"additionalProperties":true,"description":"Authentication the adapter performs when the profile names no credential reference; absent when it reports none."},"error":{"type":"string","description":"Configuration diagnostic for repair; unaffected models may remain serviceable."}},"required":["provider","displayName","settingsNs","settingsPath"],"additionalProperties":true}},
       },
-      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":543,"column":3},
+      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":555,"column":3},
     },
-    {
-      id: '@deepseek-ai/dsh-llm#llm/listProviders',
+    'llm/listProviders': {
       service: 'llm',
-      namespace: 'llm',
-      method: 'listProviders',
+      description: 'Describe provider routes with a registered adapter.',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -100,10 +129,12 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-llm#llm/listProviders:result',
         create: _deepseek_ai_dsh_llm_llm_listProviders_result$schema,
+        description: 'detached provider metadata in registration order.',
+        jsonSchema: {"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Provider route key used by {@link GenerateOptions.provider}."},"name":{"type":"string","description":"Human-readable provider name for selectors and diagnostics."}},"required":["id","name"],"additionalProperties":true}},
       },
-      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":471,"column":3},
+      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":483,"column":3},
     },
-  ],
-}
+  },
+}, z)
 
 export default TYPERT_REMOTE

package/lib/types/call-config.d.ts

@@ -5,22 +5,35 @@
  * changed snapshots instead of allowing silent per-call drift.
  * @module dsh-llm/call-config
  */
-import type { GenerateOptions } from './types.ts';
+import type { GenerateOptions, LlmResolvedModelInfo } from './types.ts';
 import type { ReasoningEffortId } from './brand.ts';
+/** Concrete generation settings; omitted controls use the selected route's defaults. */
+export interface LlmCallControls {
+    reasoningEffort?: ReasoningEffortId;
+    temperature?: number;
+    maxTokens?: number;
+    stop?: string[];
+}
 /**
  * Provider, model, reasoning effort, and sampling scalars of one conversation's
  * requests. Every field maps 1:1 onto the same-named `GenerateOptions` field;
  * the loop builds requests from the logged header rather than accepting these
  * per call.
  */
-export interface LlmCallConfig {
+export interface LlmCallConfig extends LlmCallControls {
     provider: string;
     model: string;
-    reasoningEffort?: ReasoningEffortId;
-    temperature?: number;
-    maxTokens?: number;
-    stop?: string[];
 }
+/**
+ * Synchronous, pure configuration of one call before defaults and validation.
+ * Compose functions in the desired order; later writes replace earlier ones.
+ * The returned controls cannot change the captured route. Errors reject
+ * preparation before dispatch; only the resolved configuration is recordable.
+ * @param controls - detached, deeply frozen proposed controls, without defaults.
+ * @param model - detached, deeply frozen metadata from the captured adapter generation.
+ * @returns concrete controls; omitted fields receive the route's defaults.
+ */
+export type ConfigureCall = (controls: Readonly<LlmCallControls>, model: Readonly<LlmResolvedModelInfo>) => LlmCallControls;
 /**
  * Effective config fields supplied by exact-model adapter resolution rather
  * than by the caller's request proposal.

package/lib/types/index.d.ts

@@ -10,9 +10,9 @@ import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
 import type { GenerateOptions, LlmConfigurableProvider, LlmDiscoveredModel, LlmFailure, LlmImageRequestPricing, LlmModelContext, LlmModelDiscoveryRequest, LlmModelInfo, LlmResolvedModelInfo, LlmProviderInfo, ModelModality, StreamChunk, SystemPromptUpdate, ToolUpdate } from './types.ts';
 import type { ResolvedRetryPolicy } from './retry-policy.ts';
 import type { ProviderRequestId } from './brand.ts';
-import type { LlmCallConfig, LlmCallConfigAdapterDefaults } from './call-config.ts';
+import type { ConfigureCall, LlmCallConfig, LlmCallConfigAdapterDefaults } from './call-config.ts';
 import { HarnessError } from './error.ts';
-import type { FileAttachmentRef } from '@deepseek-ai/dsh-attachment';
+import type { FileAttachmentRef, ImageAttachmentRef, ImageRequestTarget } from '@deepseek-ai/dsh-attachment';
 export * from './attribution.ts';
 export * from './brand.ts';
 export * from './error.ts';
@@ -24,7 +24,7 @@ export * from './message.ts';
 export * from './retry-policy.ts';
 export { BlockAssembler } from './assembler.ts';
 export { callConfigEquals, isAgentLoopRequest, markAgentLoopRequest } from './call-config.ts';
-export type { LlmCallConfig, LlmCallConfigAdapterDefaults } from './call-config.ts';
+export type { ConfigureCall, LlmCallConfig, LlmCallConfigAdapterDefaults, LlmCallControls } from './call-config.ts';
 declare module '@deepseek-ai/cordis' {
     interface Context {
         llm: LlmRuntime;
@@ -150,6 +150,15 @@ export declare abstract class LlmAdapter {
      * @returns route-owned image pricing, or `undefined` when the route declares none.
      */
     imageRequestPricing(_provider: string, _model: string): LlmImageRequestPricing | undefined;
+    /**
+     * Resolve the image dimensions and byte target this adapter sends to the model.
+     * The default preserves normalized images; adapters that resize must override it.
+     * @param _provider - registered provider route.
+     * @param _model - exact model id.
+     * @param image - normalized image whose request projection is being resolved.
+     * @returns the same target used by request serialization, before provider-internal processing.
+     */
+    imageRequestTarget(_provider: string, _model: string, image: ImageAttachmentRef): ImageRequestTarget;
     /**
      * List models this adapter can currently advertise for one owned provider.
      * Core routing accepts unlisted model ids; catalog-driven entry points such
@@ -331,6 +340,14 @@ export declare class LlmRuntime extends TypertRemoteService {
      * @returns the owning adapter's image pricing for the route, when declared.
      */
     imageRequestPricing(provider: string, model: string): LlmImageRequestPricing | undefined;
+    /**
+     * Resolve the image projection for an exact registered model route.
+     * @param provider - registered provider route.
+     * @param model - exact model id.
+     * @param image - normalized image reference.
+     * @returns dimensions and byte target used by the adapter's request serializer.
+     */
+    imageRequestTarget(provider: string, model: string, image: ImageAttachmentRef): ImageRequestTarget;
     /**
      * Resolve the exact text one durable file occurrence contributes to every
      * provider request in the current execution environment.
@@ -379,11 +396,15 @@ export declare class LlmRuntime extends TypertRemoteService {
      * Resolve one call under its current adapter registration. The returned
      * one-shot handle keeps that registration across header logging and dispatch,
      * so HMR cannot combine one adapter's capability result with another adapter.
-     * @param config - provider/model route and optional request controls.
+     * An optional synchronous callback selects concrete controls using captured
+     * model metadata. Defaults and validation apply to its result. Callback
+     * failures and cancellation reject preparation before dispatch.
+     * @param config - provider/model route and optional concrete request controls.
      * @param signal - optional cancellation for adapter-owned capability lookup.
+     * @param configure - pure control selection, called once before defaults and validation.
      * @returns a prepared config and its registration-bound stream entry point.
      */
-    prepareCall(config: LlmCallConfig, signal?: AbortSignal): Promise<PreparedLlmCall>;
+    prepareCall(config: LlmCallConfig, signal?: AbortSignal, configure?: ConfigureCall): Promise<PreparedLlmCall>;
     private registration;
     /** Remove replay state whose historical route is owned by another adapter. */
     private forAdapter;

package/lib/types/index.js

@@ -167,6 +167,17 @@ export class LlmAdapter {
     imageRequestPricing(_provider, _model) {
         return undefined;
     }
+    /**
+     * Resolve the image dimensions and byte target this adapter sends to the model.
+     * The default preserves normalized images; adapters that resize must override it.
+     * @param _provider - registered provider route.
+     * @param _model - exact model id.
+     * @param image - normalized image whose request projection is being resolved.
+     * @returns the same target used by request serialization, before provider-internal processing.
+     */
+    imageRequestTarget(_provider, _model, image) {
+        return { width: image.width, height: image.height, maxBytes: image.bytes };
+    }
     /**
      * List models this adapter can currently advertise for one owned provider.
      * Core routing accepts unlisted model ids; catalog-driven entry points such
@@ -384,7 +395,7 @@ let LlmRuntime = (() => {
                         || detached.some(seen => seen.provider === entry.provider)) {
                         throw new LlmError(`configurable provider "${entry.provider}" is already declared`, 'DUPLICATE_DIRECTORY');
                     }
-                    detached.push({ ...entry, settingsPath: [...entry.settingsPath] });
+                    detached.push(detachDirectoryEntry(entry));
                 }
                 for (const entry of held)
                     this.directory.delete(entry.provider);
@@ -420,7 +431,7 @@ let LlmRuntime = (() => {
          * @returns detached directory entries in declaration order.
          */
         listConfigurableProviders() {
-            return [...this.directory.values()].map(entry => ({ ...entry, settingsPath: [...entry.settingsPath] }));
+            return [...this.directory.values()].map(detachDirectoryEntry);
         }
         /**
          * Offer to interrogate provider endpoints on behalf of the settings
@@ -525,6 +536,16 @@ let LlmRuntime = (() => {
         imageRequestPricing(provider, model) {
             return this.adapters.get(provider)?.adapter.imageRequestPricing(provider, model);
         }
+        /**
+         * Resolve the image projection for an exact registered model route.
+         * @param provider - registered provider route.
+         * @param model - exact model id.
+         * @param image - normalized image reference.
+         * @returns dimensions and byte target used by the adapter's request serializer.
+         */
+        imageRequestTarget(provider, model, image) {
+            return this.registration(provider).adapter.imageRequestTarget(provider, model, image);
+        }
         /**
          * Resolve the exact text one durable file occurrence contributes to every
          * provider request in the current execution environment.
@@ -716,24 +737,35 @@ let LlmRuntime = (() => {
          * Resolve one call under its current adapter registration. The returned
          * one-shot handle keeps that registration across header logging and dispatch,
          * so HMR cannot combine one adapter's capability result with another adapter.
-         * @param config - provider/model route and optional request controls.
+         * An optional synchronous callback selects concrete controls using captured
+         * model metadata. Defaults and validation apply to its result. Callback
+         * failures and cancellation reject preparation before dispatch.
+         * @param config - provider/model route and optional concrete request controls.
          * @param signal - optional cancellation for adapter-owned capability lookup.
+         * @param configure - pure control selection, called once before defaults and validation.
          * @returns a prepared config and its registration-bound stream entry point.
          */
-        async prepareCall(config, signal) {
-            const registration = this.registration(config.provider);
-            const adapterCall = await registration.adapter.prepareCall(config.provider, config.model, signal);
-            const modelInfo = this.normalizeModelInfo(registration, config.model, adapterCall.model);
-            const resolved = this.resolveCallWithInfo(config, modelInfo);
+        async prepareCall(config, signal, configure) {
+            signal?.throwIfAborted();
+            const { provider, model, ...controls } = config;
+            const registration = this.registration(provider);
+            const adapterCall = await registration.adapter.prepareCall(provider, model, signal);
+            signal?.throwIfAborted();
+            const modelInfo = this.normalizeModelInfo(registration, model, adapterCall.model);
+            const proposed = configure === undefined
+                ? config
+                : { ...configure(deepFreeze(structuredClone(controls)), deepFreeze(modelInfo)), provider, model };
+            signal?.throwIfAborted();
+            const resolved = this.resolveCallWithInfo(proposed, modelInfo);
             const resolvedConfig = deepFreeze(structuredClone(resolved.config));
             const context = resolved.context === undefined
                 ? undefined
                 : deepFreeze(structuredClone(resolved.context));
             const adapterDefaults = deepFreeze({
-                ...config.reasoningEffort === undefined && resolvedConfig.reasoningEffort !== undefined
+                ...proposed.reasoningEffort === undefined && resolvedConfig.reasoningEffort !== undefined
                     ? { reasoningEffort: true }
                     : {},
-                ...config.maxTokens === undefined && resolvedConfig.maxTokens !== undefined
+                ...proposed.maxTokens === undefined && resolvedConfig.maxTokens !== undefined
                     ? { maxTokens: true }
                     : {},
             });
@@ -936,5 +968,15 @@ function adapterFailureChunk(error, signal) {
             : { kind: 'error', failure },
     };
 }
+/** Copy a directory entry, including its arrays, so neither side can mutate the other's copy. */
+function detachDirectoryEntry(entry) {
+    const { nativeAuth } = entry;
+    return {
+        ...entry,
+        settingsPath: [...entry.settingsPath],
+        ...entry.baseURLEnv === undefined ? {} : { baseURLEnv: [...entry.baseURLEnv] },
+        ...(nativeAuth === undefined ? {} : { nativeAuth: { ...nativeAuth, env: [...nativeAuth.env] } }),
+    };
+}
 export default LlmRuntime;
 //# sourceMappingURL=index.js.map

package/lib/types/types.d.ts

@@ -242,9 +242,26 @@ export interface LlmConfigurableProvider {
      * from outside.
      */
     declared?: boolean;
+    /**
+     * Route endpoint the adapter uses when the profile sets no `baseURL`; the
+     * adapter may still send an individual model to that model's own endpoint.
+     * Absent when the route has no fixed endpoint.
+     */
+    defaultBaseURL?: string;
+    /** Environment variables used to construct a provider endpoint; absent when none are reported. */
+    baseURLEnv?: readonly string[];
+    /** Authentication the adapter performs when the profile names no credential reference; absent when it reports none. */
+    nativeAuth?: LlmNativeAuth;
     /** Configuration diagnostic for repair; unaffected models may remain serviceable. */
     error?: string;
 }
+/** Authentication a provider route performs without a credential reference in its profile. */
+export interface LlmNativeAuth {
+    /** Environment variables the route's authentication reads, in lookup order; empty when it reads none. */
+    env: readonly string[];
+    /** Whether a stored OAuth sign-in can authenticate the route. */
+    oauth: boolean;
+}
 /**
  * One interrogation of a provider endpoint that configuration has not stored
  * yet. Configuration surfaces send the draft a user is still editing, so the
@@ -348,7 +365,7 @@ export interface LlmReasoningEffortInfo {
 }
 /** Selectable reasoning efforts for one exact provider/model route. */
 export interface LlmModelReasoningInfo {
-    /** Supported efforts in adapter-preferred display order. */
+    /** Supported efforts from least to greatest selectable reasoning effort, not predicted token use or latency. */
     efforts: readonly LlmReasoningEffortInfo[];
     /**
      * Adapter-configured default materialized into requests when callers omit
@@ -524,8 +541,8 @@ export interface GenerateOptions {
     sessionId?: Branded<'SessionId'>;
     /**
      * Provider-neutral classification for an auxiliary model call. Adapters may
-     * map the purpose to model-hidden transport metadata or purpose-specific
-     * generation policy. Ordinary conversation requests leave it unset.
+     * map the purpose to model-hidden transport metadata. Ordinary conversation
+     * requests leave it unset.
      */
     purpose?: 'compaction' | 'session-title';
 }

package/locale/en.json

@@ -0,0 +1,5 @@
+{
+  "meta": {
+    "title": "llm"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "模型调用服务",
+    "description": "为不同模型提供统一的调用接口。"
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-llm",
   "description": "Provider-neutral LLM service interface for the DeepSeek Harness",
-  "version": "0.2.1-alpha.1",
+  "version": "0.2.1-alpha.3",
   "publishConfig": {
     "access": "public"
   },
@@ -43,9 +43,11 @@
       "default": "./lib/typert.remote-client.js"
     },
     "./src/*": "./src/*",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
   },
   "files": [
+    "locale/*.json",
     "lib/index.js",
     "lib/types/**/*.js",
     "lib/types/**/*.d.ts",
@@ -56,19 +58,19 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2"
   },
   "dependencies": {
-    "zod": "^4.4.3",
-    "@deepseek-ai/dsh-util-crypto": "0.2.1-alpha.1",
-    "@deepseek-ai/schemastery": "~3.18.5-alpha.1",
-    "@deepseek-ai/dsh-timeout": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-brand": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-typert-protocol": "0.2.1-alpha.1"
+    "@deepseek-ai/dsh-util-crypto": "0.2.1-alpha.3",
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.2",
+    "zod": "4.4.3",
+    "@deepseek-ai/dsh-timeout": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-brand": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.1-alpha.3"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-attachment": "0.2.1-alpha.1",
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1"
+    "@deepseek-ai/dsh-attachment": "0.2.1-alpha.3",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2"
   }
 }