@crazx/dsh-agent-default-model 0.1.0-rc.7.zw.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# side as of the last confirmed-consistent state. Both languages carry equal authority;
+# after editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write packages/core/agent-default-model/README.md
+README.md: b2f077fc82924b1f47ca6e202501fb81a0319af1
+README.zh.md: d6ab00a036fefcc9e8ffa6eab194f94da475938d

package/README.md

@@ -0,0 +1,30 @@
+# @deepseek-ai/dsh-agent-default-model
+
+English | [中文](README.zh.md)
+
+The deployment default used when an entry point creates an Agent that has no session-local model selection. `AgentDefaultModelConfig` provides `ctx.agentDefaultModel`; direct entry points such as `dsh --profile headless` and Host-backed entry points such as ApiProxy read the same service instead of owning parallel provider/model defaults.
+
+The plugin config requires `{ provider, model }`. That composition entry is the base of the `agent-default-model` Settings section; a mounted settings provider layers the user's choice over it and changes are visible on the next `currentSelection()` read. `reasoningEffort` belongs to the Settings section but deliberately not to plugin config: a complete saved selection can clear an effort when the next selected model has none, while a composition value would be inherited again.
+
+- `ctx.agentDefaultModel.currentSelection()` returns a detached `{ provider, model, reasoningEffort? }` selection for a newly created Agent.
+- `ctx.agentDefaultModel.saveSelection(selection)` saves the complete user selection. Without a settings provider it is a no-op and the composition entry remains current.
+- `ctx.agentDefaultModel.recallEffort(provider, model)` returns the reasoning effort the user last explicitly chose on that route, or `undefined`.
+- `ctx.agentDefaultModel.rememberEffort(provider, model, effort?)` records — or, when `effort` is `undefined`, clears — that route's remembered effort. Without a settings provider it is a no-op.
+
+The remembered efforts live in the separate `agent-model-efforts` Settings section (an entry list keyed by provider/model), so switching the default selection never overwrites them. The service stores what it is told; the consumer that consults a memory validates it against the live model capability, because a remembered level can outlive the declaration that offered it.
+
+The service does not validate catalog membership. A provider route may serve an unadvertised model, and the consumer that actually opens a model request owns availability diagnostics.
+
+## Model Experience
+
+Indirectly, through the provider/model selection supplied to an entry point; request assembly and adapters own the model-visible request.
+
+#### KV Cache effect
+
+Changing the default affects only Agents that subsequently resolve from it. An existing session whose request log already names a selection keeps that selection, so this service does not invalidate its established prefix.
+
+## Known Limitations and Deferred Work
+
+- The service owns one process-wide default; per-session selection remains the entry point's responsibility.
+- Without a settings provider, `saveSelection()` cannot retain a selection and `rememberEffort()` cannot retain a level for a later Agent.
+- The effort memory grows one entry per route the user has explicitly tuned; it is never pruned automatically (a stale entry is dropped at consult time instead).

package/README.zh.md

@@ -0,0 +1,30 @@
+# @deepseek-ai/dsh-agent-default-model
+
+[English](README.md) | 中文
+
+该部署默认值供入口在创建尚无会话级模型选择的 Agent 时使用。`AgentDefaultModelConfig` 提供 `ctx.agentDefaultModel`；`dsh --profile headless` 这类直接入口与 ApiProxy 这类由 Host 支撑的入口读取同一服务，而不是分别持有平行的提供方／模型默认值。
+
+插件配置必须提供 `{ provider, model }`。该组合配置项构成 Settings 中 `agent-default-model` 分节的基础层；挂载的设置提供方在其上叠加用户选择，更改会在下一次调用 `currentSelection()` 时可见。`reasoningEffort` 属于该 Settings 分节，但特意不属于插件配置：完整保存的选择必须能在下一个选定模型没有推理（reasoning）强度时清除旧值，而组合配置值会再次被继承。
+
+- `ctx.agentDefaultModel.currentSelection()` 返回一份独立的 `{ provider, model, reasoningEffort? }` 选择，供新创建的 Agent 使用。
+- `ctx.agentDefaultModel.saveSelection(selection)` 保存完整的用户选择。未挂载设置提供方时，此调用不执行任何操作，组合配置项仍为当前值。
+- `ctx.agentDefaultModel.recallEffort(provider, model)` 返回用户在该路由上最后一次显式选择的推理强度；没有记忆时返回 `undefined`。
+- `ctx.agentDefaultModel.rememberEffort(provider, model, effort?)` 记录——或在 `effort` 为 `undefined` 时清除——该路由的记忆强度。未挂载设置提供方时同样不执行任何操作。
+
+被记忆的强度存放在独立的 `agent-model-efforts` Settings 分节（以提供方／模型为键的条目列表），因此切换默认选择不会覆盖它们。该服务只保存被告知的值；咨询记忆的消费方会对照模型的实时能力校验，因为被记住的等级可能比当初提供它的声明活得更久。
+
+该服务不校验目录成员关系。提供方路由可以服务未在目录中公布的模型；实际发起模型请求的消费方负责可用性诊断。
+
+## 模型体验
+
+通过提供给入口的提供方／模型选择间接影响；模型可见请求由请求组装与适配器负责。
+
+#### KV Cache 影响
+
+更改默认值只影响之后从该默认值解析选择的 Agent。请求日志已经指明选择的现有会话仍沿用该选择，因此本服务不会使其已建立的前缀失效。
+
+## 已知限制与暂缓事项
+
+- 该服务只拥有一项进程级默认值；每个会话的选择仍由入口负责。
+- 未挂载设置提供方时，`saveSelection()` 无法保留选择，`rememberEffort()` 也无法为后续 Agent 保留等级。
+- 强度记忆按用户显式调过的路由各存一条，永不自动清理（陈旧条目在咨询时丢弃）。

package/lib/index.js

@@ -0,0 +1,123 @@
+import { Service } from "@deepseek-ai/cordis";
+import z from "@deepseek-ai/schemastery";
+import { ReasoningEffortId } from "@deepseek-ai/dsh-llm";
+import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
+//#region lib/types/index.js
+/**
+* Default model selection for an Agent without a session-specific selection,
+* plus the per-route reasoning-effort memory that restores the effort the user
+* last explicitly chose when a model is selected again.
+*
+* @module @deepseek-ai/dsh-agent-default-model
+*/
+/** Settings namespace carrying the default model selection for future Agents. */
+const AGENT_DEFAULT_MODEL_SETTINGS_NAMESPACE = settingsNamespace("agent-default-model");
+/** Settings namespace carrying the per-route reasoning-effort memory. */
+const AGENT_MODEL_EFFORTS_SETTINGS_NAMESPACE = settingsNamespace("agent-model-efforts");
+/** Schema of the default Agent model settings section. */
+const AGENT_DEFAULT_MODEL_SETTINGS_SCHEMA = z.object({
+	provider: z.string().required(),
+	model: z.string().required(),
+	reasoningEffort: z.string()
+});
+/** Schema of the per-route reasoning-effort memory section. */
+const AGENT_MODEL_EFFORTS_SETTINGS_SCHEMA = z.object({ entries: z.array(z.object({
+	provider: z.string().required(),
+	model: z.string().required(),
+	effort: z.string().required()
+})).default([]) });
+/** Project stored settings onto the Agent-facing selection type. */
+function selection(settings) {
+	return {
+		provider: settings.provider,
+		model: settings.model,
+		...settings.reasoningEffort === void 0 ? {} : { reasoningEffort: ReasoningEffortId(settings.reasoningEffort) }
+	};
+}
+/**
+* Owns the default model selection and the per-route reasoning-effort memory,
+* each independently of any Host or transport. The composition entries remain
+* usable without a settings provider; when one is mounted, the user layer of
+* each namespace is read live.
+*/
+var AgentDefaultModelConfig = class extends Service {
+	static Config = z.object({
+		provider: z.string().required(),
+		model: z.string().required()
+	});
+	source;
+	effortsSource;
+	constructor(ctx, config) {
+		super(ctx, "agentDefaultModel");
+		const entry = {
+			provider: config.provider,
+			model: config.model
+		};
+		this.source = () => entry;
+		installSettingsSection(ctx, AGENT_DEFAULT_MODEL_SETTINGS_NAMESPACE, AGENT_DEFAULT_MODEL_SETTINGS_SCHEMA, entry, {
+			setSource: (current) => {
+				this.source = current;
+			},
+			onChange: () => {}
+		});
+		const effortsEntry = { entries: [] };
+		this.effortsSource = () => effortsEntry;
+		installSettingsSection(ctx, AGENT_MODEL_EFFORTS_SETTINGS_NAMESPACE, AGENT_MODEL_EFFORTS_SETTINGS_SCHEMA, effortsEntry, {
+			setSource: (current) => {
+				this.effortsSource = current;
+			},
+			onChange: () => {}
+		});
+	}
+	/**
+	* Read the current default model selection.
+	* @returns a detached provider, model, and optional reasoning selection.
+	*/
+	currentSelection() {
+		return selection(this.source());
+	}
+	/**
+	* Save the complete default model selection. A deployment without a settings
+	* provider keeps its composition entry.
+	* @param next - resolved selection accepted by an entry point.
+	* @returns fulfillment after the optional settings write settles.
+	*/
+	async saveSelection(next) {
+		await this.ctx.get("settings")?.replace(AGENT_DEFAULT_MODEL_SETTINGS_NAMESPACE, {
+			provider: next.provider,
+			model: next.model,
+			...next.reasoningEffort === void 0 ? {} : { reasoningEffort: String(next.reasoningEffort) }
+		});
+	}
+	/**
+	* Recall the effort last explicitly chosen on one provider/model route.
+	* A hand-edited document may carry duplicate entries; the last match wins,
+	* matching the append order {@link rememberEffort} maintains.
+	* @param provider - registered provider route.
+	* @param model - provider-owned model id.
+	* @returns the remembered effort, or undefined when the route has none.
+	*/
+	recallEffort(provider, model) {
+		let found;
+		for (const entry of this.effortsSource().entries) if (entry.provider === provider && entry.model === model) found = entry.effort;
+		return found === void 0 ? void 0 : ReasoningEffortId(found);
+	}
+	/**
+	* Record the remembered effort for one route, or clear it when `effort` is
+	* undefined. A deployment without a settings provider keeps its composition
+	* entry, so the call fulfills with no stored effect.
+	* @param provider - registered provider route.
+	* @param model - provider-owned model id.
+	* @param effort - the explicitly chosen effort, or undefined to clear.
+	* @returns fulfillment after the optional settings write settles.
+	*/
+	async rememberEffort(provider, model, effort) {
+		await this.ctx.get("settings")?.replace(AGENT_MODEL_EFFORTS_SETTINGS_NAMESPACE, { entries: [...this.effortsSource().entries.filter((entry) => entry.provider !== provider || entry.model !== model), ...effort === void 0 ? [] : [{
+			provider,
+			model,
+			effort: String(effort)
+		}]] });
+	}
+};
+//#endregion
+export { AGENT_DEFAULT_MODEL_SETTINGS_NAMESPACE, AGENT_DEFAULT_MODEL_SETTINGS_SCHEMA, AGENT_MODEL_EFFORTS_SETTINGS_NAMESPACE, AGENT_MODEL_EFFORTS_SETTINGS_SCHEMA, AgentDefaultModelConfig, AgentDefaultModelConfig as default };

package/lib/invariant.js

@@ -0,0 +1,25 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for the default Agent model selection.
+*
+* The service owns no independent event relationship: settings registration
+* already validates every mutable value before `currentSelection()` can observe it.
+* The empty installer keeps that absence explicit in composed invariant sets.
+*
+* @module @deepseek-ai/dsh-agent-default-model/invariant
+*/
+const PACKAGE_NAME = "@deepseek-ai/dsh-agent-default-model";
+/** Cordis companion plugin name. */
+const name = "agent-default-model-invariant";
+/** Services required before the companion can register. */
+const inject = ["invariants"];
+/** No runtime invariant: settings validation owns the only mutable-value relationship. */
+const install = () => {};
+/**
+* Register the intentionally empty invariant contribution.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

package/lib/types/index.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Default model selection for an Agent without a session-specific selection,
+ * plus the per-route reasoning-effort memory that restores the effort the user
+ * last explicitly chose when a model is selected again.
+ *
+ * @module @deepseek-ai/dsh-agent-default-model
+ */
+import { Context, Service } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import type { ModelSelection } from '@deepseek-ai/dsh-agent';
+import { ReasoningEffortId } from '@deepseek-ai/dsh-llm';
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        /**
+         * Default model selection for Agents created without an explicit model,
+         * plus the per-route reasoning-effort memory for model switches.
+         */
+        agentDefaultModel: AgentDefaultModelConfig;
+    }
+}
+/** Settings namespace carrying the default model selection for future Agents. */
+export declare const AGENT_DEFAULT_MODEL_SETTINGS_NAMESPACE: import("@deepseek-ai/dsh-settings").SettingsNamespace;
+/** Settings namespace carrying the per-route reasoning-effort memory. */
+export declare const AGENT_MODEL_EFFORTS_SETTINGS_NAMESPACE: import("@deepseek-ai/dsh-settings").SettingsNamespace;
+/** Stored and composed default model selection. */
+export interface AgentDefaultModelSettings {
+    /** Registered provider route. */
+    provider: string;
+    /** Provider-owned model id. */
+    model: string;
+    /** Adapter-owned reasoning effort, or provider/default behavior when absent. */
+    reasoningEffort?: string;
+}
+/** Schema of the default Agent model settings section. */
+export declare const AGENT_DEFAULT_MODEL_SETTINGS_SCHEMA: z<AgentDefaultModelSettings>;
+/** One remembered per-route effort: the level the user last explicitly chose. */
+export interface AgentModelEffortEntry {
+    /** Registered provider route. */
+    provider: string;
+    /** Provider-owned model id. */
+    model: string;
+    /** Adapter-owned effort id as it was when the choice was made. */
+    effort: string;
+}
+/** Stored per-route reasoning-effort memory; the service is its only writer. */
+export interface AgentModelEffortsSettings {
+    /** Remembered choices; at most one entry per provider/model route. */
+    entries: AgentModelEffortEntry[];
+}
+/** Schema of the per-route reasoning-effort memory section. */
+export declare const AGENT_MODEL_EFFORTS_SETTINGS_SCHEMA: z<AgentModelEffortsSettings>;
+/** Composition entry for the default model selection. */
+export interface Config {
+    /** Registered provider route. */
+    provider: string;
+    /** Provider-owned model id. */
+    model: string;
+}
+/**
+ * Owns the default model selection and the per-route reasoning-effort memory,
+ * each independently of any Host or transport. The composition entries remain
+ * usable without a settings provider; when one is mounted, the user layer of
+ * each namespace is read live.
+ */
+export declare class AgentDefaultModelConfig extends Service {
+    static Config: z<Config>;
+    private source;
+    private effortsSource;
+    constructor(ctx: Context, config: Config);
+    /**
+     * Read the current default model selection.
+     * @returns a detached provider, model, and optional reasoning selection.
+     */
+    currentSelection(): ModelSelection;
+    /**
+     * Save the complete default model selection. A deployment without a settings
+     * provider keeps its composition entry.
+     * @param next - resolved selection accepted by an entry point.
+     * @returns fulfillment after the optional settings write settles.
+     */
+    saveSelection(next: ModelSelection): Promise<void>;
+    /**
+     * Recall the effort last explicitly chosen on one provider/model route.
+     * A hand-edited document may carry duplicate entries; the last match wins,
+     * matching the append order {@link rememberEffort} maintains.
+     * @param provider - registered provider route.
+     * @param model - provider-owned model id.
+     * @returns the remembered effort, or undefined when the route has none.
+     */
+    recallEffort(provider: string, model: string): ReasoningEffortId | undefined;
+    /**
+     * Record the remembered effort for one route, or clear it when `effort` is
+     * undefined. A deployment without a settings provider keeps its composition
+     * entry, so the call fulfills with no stored effect.
+     * @param provider - registered provider route.
+     * @param model - provider-owned model id.
+     * @param effort - the explicitly chosen effort, or undefined to clear.
+     * @returns fulfillment after the optional settings write settles.
+     */
+    rememberEffort(provider: string, model: string, effort: ReasoningEffortId | undefined): Promise<void>;
+}
+export default AgentDefaultModelConfig;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Package-owned invariant companion for the default Agent model selection.
+ *
+ * The service owns no independent event relationship: settings registration
+ * already validates every mutable value before `currentSelection()` can observe it.
+ * The empty installer keeps that absence explicit in composed invariant sets.
+ *
+ * @module @deepseek-ai/dsh-agent-default-model/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "agent-default-model-invariant";
+/** Services required before the companion can register. */
+export declare const inject: string[];
+/**
+ * Register the intentionally empty invariant contribution.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@crazx/dsh-agent-default-model",
+  "description": "Default model selection shared by Agent entry points",
+  "version": "0.1.0-rc.7.zw.2",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aka-danielZhang/deepseek-harness.git",
+    "directory": "packages/core/agent-default-model"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^0.1.0-rc.7"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-agent": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.7",
+    "@deepseek-ai/cordis": "^0.1.0-rc.7"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-agent": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.7",
+    "@deepseek-ai/cordis": "^0.1.0-rc.7"
+  }
+}