@stackstackstack/dsh-agent-default-model 0.1.5

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: 4bce6380876ec88f7a5a961da7eef7d38918727f
+README.zh.md: 7f8681643c92130ac4358c86c32e52e457b685d6

package/README.md

@@ -0,0 +1,25 @@
+# @stackstackstack/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.
+
+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 for a later Agent.

package/README.zh.md

@@ -0,0 +1,25 @@
+# @stackstackstack/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)` 保存完整的用户选择。未挂载设置提供方时，此调用不执行任何操作，组合配置项仍为当前值。
+
+该服务不校验目录成员关系。提供方路由可以服务未在目录中公布的模型；实际发起模型请求的消费方负责可用性诊断。
+
+## 模型体验
+
+通过提供给入口的提供方／模型选择间接影响；模型可见请求由请求组装与适配器负责。
+
+#### KV Cache 影响
+
+更改默认值只影响之后从该默认值解析选择的 Agent。请求日志已经指明选择的现有会话仍沿用该选择，因此本服务不会使其已建立的前缀失效。
+
+## 已知限制与暂缓事项
+
+- 该服务只拥有一项进程级默认值；每个会话的选择仍由入口负责。
+- 未挂载设置提供方时，`saveSelection()` 无法保留选择供后续 Agent 使用。

package/lib/index.js

@@ -0,0 +1,74 @@
+import { Service } from "@deepseek-ai/cordis";
+import z from "@deepseek-ai/schemastery";
+import { ReasoningEffortId } from "@stackstackstack/dsh-llm";
+import { installSettingsSection, settingsNamespace } from "@stackstackstack/dsh-settings";
+//#region lib/types/index.js
+/**
+* Default model selection for an Agent without a session-specific selection.
+*
+* @module @stackstackstack/dsh-agent-default-model
+*/
+/** Settings namespace carrying the default model selection for future Agents. */
+const AGENT_DEFAULT_MODEL_SETTINGS_NAMESPACE = settingsNamespace("agent-default-model");
+/** 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()
+});
+/** 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 independently of any Host or transport.
+* The composition entry remains usable without a settings provider; when one
+* is mounted, its user layer is read live.
+*/
+var AgentDefaultModelConfig = class extends Service {
+	static Config = z.object({
+		provider: z.string().required(),
+		model: z.string().required()
+	});
+	source;
+	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: () => {}
+		});
+	}
+	/**
+	* 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) }
+		});
+	}
+};
+//#endregion
+export { AGENT_DEFAULT_MODEL_SETTINGS_NAMESPACE, AGENT_DEFAULT_MODEL_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 @stackstackstack/dsh-agent-default-model/invariant
+*/
+const PACKAGE_NAME = "@stackstackstack/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,58 @@
+/**
+ * Default model selection for an Agent without a session-specific selection.
+ *
+ * @module @stackstackstack/dsh-agent-default-model
+ */
+import { Context, Service } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import type { ModelSelection } from '@stackstackstack/dsh-agent';
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        /** Default model selection for Agents created without an explicit model. */
+        agentDefaultModel: AgentDefaultModelConfig;
+    }
+}
+/** Settings namespace carrying the default model selection for future Agents. */
+export declare const AGENT_DEFAULT_MODEL_SETTINGS_NAMESPACE: import("@stackstackstack/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>;
+/** 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 independently of any Host or transport.
+ * The composition entry remains usable without a settings provider; when one
+ * is mounted, its user layer is read live.
+ */
+export declare class AgentDefaultModelConfig extends Service {
+    static Config: z<Config>;
+    private source;
+    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>;
+}
+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 @stackstackstack/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": "@stackstackstack/dsh-agent-default-model",
+  "description": "Default model selection shared by Agent entry points",
+  "version": "0.1.5",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/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": "^3.18.1"
+  },
+  "peerDependencies": {
+    "@stackstackstack/dsh-agent": "^0.1.5",
+    "@stackstackstack/dsh-invariants": "^0.1.5",
+    "@stackstackstack/dsh-settings": "^0.1.5",
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@stackstackstack/dsh-llm": "^0.1.5"
+  },
+  "devDependencies": {
+    "@stackstackstack/dsh-agent": "^0.1.5",
+    "@stackstackstack/dsh-invariants": "^0.1.5",
+    "@stackstackstack/dsh-llm": "^0.1.5",
+    "@stackstackstack/dsh-settings": "^0.1.5",
+    "@deepseek-ai/cordis": "^4.0.1"
+  }
+}