@jianxx/dsh-cc-model-aliases 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

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/compat/cc-model-aliases/README.md
+README.md: 3b8fb6f22176a9e87eb137f9f3a2b5442f4917de
+README.zh.md: df9e7ff2eee16a757155c5eac994d50dc50a1854

package/README.md

@@ -0,0 +1,157 @@
+# @jianxx/dsh-cc-model-aliases
+
+English | [中文](README.zh.md)
+
+Claude Code-compatible model alias resolution for the DeepSeek Harness. It maps Claude Code
+frontmatter model aliases (`model: opus`, `model: sonnet`) onto dsh `{provider, model}`
+routes. The package now ships in two shapes:
+
+- a **`ccModelRoutes` host service** (the cordis plugin entry) that owns the `model-aliases`
+  settings namespace registration and exposes a spawn-time resolver, and
+- the **pure helpers** (`mergeAliasMaps` / `createModelResolver`) for embedding the same
+  resolution semantics without mounting the service.
+
+## Why
+
+Claude Code agent/CLAUDE.md frontmatter names models by alias. Without an alias
+layer, `model: opus` was passed through verbatim as a provider model id, so an
+adapter that does not know the id (e.g. `llm-pi-ai`) threw `UNKNOWN_MODEL`, and
+`model: inherit` — a valid CC sentinel meaning "use my parent's model" — was
+also handed to `prepareCall` as a literal id and errored.
+
+This package adds that layer: an alias resolves to a `{provider, model}` route,
+the unresolvable cases fall back to *inheriting the parent route* (no override),
+and literal ids like `deepseek-chat` keep passing through untouched.
+
+## The `ccModelRoutes` service
+
+The plugin entry (`name: 'cc-model-routes'`, `apply`) is what the CC preset mounts via the
+`cc-model-routes` row. It:
+
+- registers the `model-aliases` **settings namespace** — but **only when** a settings
+  provider (`ctx.get('settings')`) is mounted, so a settings-less host degrades to the config
+  defaults plus the builtin fallback (this namespace registration is the single owner of that
+  name; the harness throws on a duplicate registration, see `dsh-settings`);
+- registers the namespace with a **write-time `validate`** that rejects a half-written
+  `{provider, model}` route (a non-empty cross-field check the dict schema itself cannot
+  express);
+- and provides the spawn-time resolver as the **`ccModelRoutes`** value (`ctx.provide`) whose
+  `resolve(model)` reads the **live** settings scope on every invocation — a settings write
+  applies to the next spawn with no re-registration.
+
+Consumers `ctx.get('ccModelRoutes')` **lazily** on every spawn. Lazily means mount order does
+not matter: before the provider's fiber is active, `ctx.get` returns `undefined`, which
+resolves to "inherit the parent route" (the same no-override behavior as before).
+
+## How the cc-shell bundle wires it
+
+- `Config.modelAliases` provides **deployment defaults** (alias name → model id
+  or `{provider, model}`).
+- The `model-aliases` **settings namespace** registration now lives in the `ccModelRoutes`
+  service, layered exactly like every other settings section (user/project/local/flags).
+- cc-shell's `AgentProvider` gains its `resolveModel` as a **trampoline** over the service:
+  `(model) => ctx.get('ccModelRoutes')?.resolve(model)` — queried **lazily on every spawn**,
+  read fresh (no snapshot captured at apply time), and degrading to inherit when the service
+  is not mounted (`undefined` resolution = inherit the parent route, byte-compatible with the
+  old no-resolver fallback). cc-shell no longer registers the namespace itself.
+- The Task tool (`@jianxx/dsh-cc-subagent-task`) is the other consumer: it resolves a
+  subagent definition's frontmatter `model` through the same `ccModelRoutes` resolver at
+  spawn time.
+
+## Configuration
+
+```yaml
+# ccModelRoutes service config (the preset's cc-model-routes row)
+modelAliases:
+  sonnet: deepseek-v4-flash                      # string form: model only, provider inherits
+  opus:   { provider: deepseek-official, model: deepseek-v4-pro }  # explicit route
+```
+
+```jsonc
+// settings namespace "model-aliases"
+{
+  "fable":  { "provider": "anthropic", "model": "claude-fable-5" },
+  "sonnet": null     // null = delete the same-named config-default alias
+}
+```
+
+## Resolution semantics
+
+Lookup order for an alias: **settings overlay → config defaults → builtin
+fallback**. Alias key matching is **case-insensitive** (keys are folded to
+lowercase at merge and at lookup).
+
+| `model` frontmatter | Result |
+|---|---|
+| `undefined` / blank | no override — child inherits the parent route |
+| `inherit` (any case) | no override — child inherits the parent route (**fixes the old pass-through bug**) |
+| configured alias (string form) | `{ model: <target> }` |
+| configured alias (object form) | `{ provider: <p>, model: <m> }` |
+| builtin alias unconfigured (`fable`/`opus`/`sonnet`/`haiku`) | no override — child inherits the parent route ("current model") |
+| anything else | passed through **verbatim** as a literal model id; a bare-lowercase-word form (e.g. `turbo`) logs a warning that it looks like an unconfigured alias |
+
+### Null deletion
+
+Only the **settings** layer may set an entry to `null`; that deletes a
+same-named **config-default** entry (entry-shallow). Deleting a *builtin* alias
+still falls through to the builtin fallback — `null` cannot turn `sonnet` into an
+error, because the builtin fallback is **inherit the parent route**. Config may
+never hold `null` (rejected by the config schema).
+
+### Merge rules
+
+- **Config vs settings is entry-shallow**: a settings entry replaces the config
+  entry wholesale. It never field-merges `{provider, model}` objects — so
+  `config { provider: A, model: X }` + `settings { model: Y }` yields
+  `{ model: Y }`, never a blended `{ provider: A, model: Y }` that no single
+  layer declared.
+- **Within the settings 5-cascade the merge is recursively deep** (existing
+  cascade behavior). Consequently an object-form alias must be written **whole
+  or not at all** across settings layers, or the cascade will field-blend
+  `{provider, model}` just as described above — this is a cascade-level
+  behavior this package does not change. Prefer string-form aliases, or repeat
+  the full route on every layer that mentions the alias.
+
+### Builtin fallback
+
+Fresh installs with **zero configuration** still work: `model: sonnet` /
+`model: opus` agents resolve to *inherit the parent's current model* instead of
+erroring. Only the four builtin names get this fallback; a custom alias
+(`turbo`, `gpt`, …) that is unconfigured has **no** fallback and is passed
+through verbatim (with the warning above).
+
+## `inherit` fix note
+
+Prior to this package, `model: inherit` was forwarded as the literal model id
+all the way to `prepareCall`, where it failed. In CC mode the spawn-time resolver
+(from the `ccModelRoutes` service, consumed via the cc-shell trampoline and the
+Task tool) maps `inherit` to "no override", so the child inherits the parent
+route, matching CC semantics. When no resolver is mounted (non-cc consumers of
+`@jianxx/dsh-cc-plugin-loader` that do not set `resolveModel`), behavior stays
+byte-identical to before — including the old `inherit` pass-through — because the
+no-resolver fallback is preserved exactly. The CC preset unconditionally mounts
+cc-shell (and the routes service), so in CC mode the fix is always active.
+
+## API
+
+- `apply(ctx, config?)` / `name` — **cordis plugin entry** (plugin id `cc-model-routes`,
+  also re-exported as `applyRoutes` / `routesPluginName`). Mounts the service; config shape is
+  `{ modelAliases?: Record<string, AliasTarget> }` (deployment defaults).
+- `ModelRoutes` — the value type of `ctx.get('ccModelRoutes')` (`resolve(model):
+  { provider?, model? } | undefined`).
+- `mergeAliasMaps(config, settings)` — entry-shallow merge with `null` deletion
+  and case-insensitive key folding; returns an effective `ReadonlyMap` of only
+  the configured aliases.
+- `createModelResolver(getAliases, { warn })` — build a `resolveModel` closure.
+  `getAliases` is a thunk evaluated **per invocation** (liveness). Optional
+  `warn` replaces the default `console.warn` used for the unconfigured-custom-alias
+  warning.
+- `BUILTIN_ALIASES` — `['fable', 'opus', 'sonnet', 'haiku']`.
+- `ConfigAliasesSchema` / `SettingsAliasesSchema` (and their record forms) —
+  schemastery schemas for the config layer (no `null`) and settings layer
+  (`null` allowed), plus `AliasTarget` / `ResolvedRoute` types.
+
+## Non-goals (tracked in the parity matrix)
+
+`/model` interactive command, `ANTHROPIC_MODEL` / `ANTHROPIC_SMALL_FAST_MODEL`
+env vars, and aliasing the main session's default model remain follow-ups.

package/README.zh.md

@@ -0,0 +1,91 @@
+# @jianxx/dsh-cc-model-aliases
+
+[English](README.md) | 中文
+
+面向 DeepSeek Harness 的 Claude Code 兼容 model alias 解析。把 CC frontmatter 的 model alias(`model: opus`、`model: sonnet`)映射为 dsh 的 `{provider, model}` 路由。本 package 现在以两种形态提供:
+
+- **`ccModelRoutes` 宿主服务**(cordis 插件入口),拥有 `model-aliases` settings 命名空间的注册,并暴露派发时的解析器;
+- **纯 helper**(`mergeAliasMaps` / `createModelResolver`),在不挂载服务的情况下内嵌同样的解析语义。
+
+## 为什么
+
+Claude Code 的 agent/CLAUDE.md frontmatter 用 alias 命名模型。没有 alias 层时,`model: opus` 会被原样当作 provider model id 透传,因此不认识该 id 的 adapter(如 `llm-pi-ai`)抛 `UNKNOWN_MODEL`;而 `model: inherit`——CC 中意为「用父模型」的合法哨兵——也会被当作字面 id 交给 `prepareCall` 然后报错。
+
+本 package 补上这层:alias 解析为 `{provider, model}` 路由,不可解析的情形回退为*继承父路由*(不 override),而 `deepseek-chat` 之类的字面 id 原样透传不受影响。
+
+## `ccModelRoutes` 服务
+
+插件入口(`name: 'cc-model-routes'`、`apply`)即 CC preset 通过 `cc-model-routes` 行挂载的东西。它:
+
+- 注册 `model-aliases` **settings 命名空间**——但**仅当**存在 settings provider(`ctx.get('settings')`)时,因此无 settings 的宿主降级为 config 默认 + builtin fallback(该命名空间注册是此名的唯一属主;重复注册 harness 会 throw,见 `dsh-settings`);
+- 以**写时 `validate`** 注册该命名空间,拒绝半写的 `{provider, model}` 路由(dict schema 本身无法表达的非空跨字段校验);
+- 并把派发时解析器以 **`ccModelRoutes`** 值(`ctx.provide`)提供,其 `resolve(model)` 每次调用**现读** settings scope——settings 写回即在下次派发生效,无需重新注册。
+
+消费者在每次派发时**惰性** `ctx.get('ccModelRoutes')`。惰性意味着挂载顺序无关:provider fiber 激活之前,`ctx.get` 返回 `undefined`,解析为「继承父路由」(与之前的 no-override 行为相同)。
+
+## How the cc-shell bundle wires it(如何接线)
+
+- `Config.modelAliases` 提供**部署默认**(alias 名 → model id 或 `{provider, model}`)。
+- `model-aliases` **settings 命名空间**的注册现在住在 `ccModelRoutes` 服务里,与其它 settings section 一样分层(user/project/local/flags)。
+- cc-shell 的 `AgentProvider` 通过**trampoline** 获得 `resolveModel`:`(model) => ctx.get('ccModelRoutes')?.resolve(model)`——**每次派发惰性查询**、现读(apply 时不快照),服务未挂载时降级为继承(`undefined` 解析 = 继承父路由,与旧 no-resolver fallback 字节兼容)。cc-shell 自己不再注册该命名空间。
+- Task 工具(`@jianxx/dsh-cc-subagent-task`)是另一消费方:它在派发时以同一个 `ccModelRoutes` 解析器解析 subagent 定义 frontmatter 的 `model`。
+
+## 配置
+
+```yaml
+# ccModelRoutes 服务配置(预设的 cc-model-routes 行)
+modelAliases:
+  sonnet: deepseek-v4-flash                      # 字符串形式:仅 model,provider 继承
+  opus:   { provider: deepseek-official, model: deepseek-v4-pro }  # 显式路由
+```
+
+```jsonc
+// settings 命名空间 "model-aliases"
+{
+  "fable":  { "provider": "anthropic", "model": "claude-fable-5" },
+  "sonnet": null     // null = 删除同名的 config-default alias
+}
+```
+
+## 解析语义
+
+alias 的查找顺序:**settings overlay → config 默认 → builtin fallback**。alias key 匹配**大小写不敏感**(merge 与 lookup 时 key 折叠为小写)。
+
+| `model` frontmatter | 结果 |
+|---|---|
+| `undefined` / 空 | 无 override——child 继承父路由 |
+| `inherit`(任意大小写) | 无 override——child 继承父路由(**修复旧的透传 bug**) |
+| 已配置 alias(字符串形式) | `{ model: <target> }` |
+| 已配置 alias(对象形式) | `{ provider: <p>, model: <m> }` |
+| 未配置的 builtin alias(`fable`/`opus`/`sonnet`/`haiku`) | 无 override——child 继承父路由(「当前模型」) |
+| 其它 | **原样**作为字面 model id 透传;裸小写单词形式(如 `turbo`)记录一条「看起来像未配置 alias」的告警 |
+
+### 空删除
+
+只有 **settings** 层可把条目置为 `null`;这会**整条删除同名 config-default 条目**(entry-shallow)。删除 *builtin* alias 仍落到 builtin fallback——`null` 无法让 `sonnet` 变成错误,因为 builtin fallback 是**继承父路由**。config 层永不允许 `null`(被 config schema 拒绝)。
+
+### Merge 规则
+
+- **config vs settings 是 entry-shallow**:settings 条目整体替换 config 条目,绝不 field-merge `{provider, model}` 对象——因此 `config { provider: A, model: X }` + `settings { model: Y }` 得到 `{ model: Y }`,而不会是没有任何单层声明的混合 `{ provider: A, model: Y }`。
+- **settings 5 级 cascade 内是递归深 merge**(既有 cascade 行为)。因此对象形式 alias 跨 settings 层必须**整写或完全不写**,否则 cascade 会像上面描述的那样 field-blend `{provider, model}`——这是本 package 不改变的 cascade 层行为。优先用字符串形式 alias,或在提及该 alias 的每一层重复完整路由。
+
+### Builtin fallback
+
+**零配置**的全新安装也能工作:`model: sonnet` / `model: opus` 的 agent 解析为*继承父的当前模型*而非报错。只有四个 builtin 名享受该 fallback;未配置的自定义 alias(`turbo`、`gpt`、…)**没有** fallback,原样透传(带上面的告警)。
+
+## `inherit` 修复说明
+
+本 package 之前,`model: inherit` 会一路原样当作字面 model id 传给 `prepareCall` 然后失败。在 CC 模式下,派发时解析器(来自 `ccModelRoutes` 服务,经 cc-shell trampoline 与 Task 工具消费)把 `inherit` 映射为「无 override」,child 因此继承父路由,符合 CC 语义。未挂载任何解析器时(`@jianxx/dsh-cc-plugin-loader` 中不设置 `resolveModel` 的非 cc 消费者),行为与之前字节一致——包括旧的 `inherit` 透传——因为无解析器 fallback 被原样保留。CC preset 无条件挂载 cc-shell(以及 routes 服务),因此 CC 模式下该修复始终生效。
+
+## API
+
+- `apply(ctx, config?)` / `name` — **cordis 插件入口**(插件 id `cc-model-routes`,另以 `applyRoutes` / `routesPluginName` 再导出)。挂载服务;config 形状为 `{ modelAliases?: Record<string, AliasTarget> }`(部署默认)。
+- `ModelRoutes` — `ctx.get('ccModelRoutes')` 的值类型(`resolve(model): { provider?, model? } | undefined`)。
+- `mergeAliasMaps(config, settings)` — 带 `null` 删除与大小写不敏感 key 折叠的 entry-shallow merge;返回只含已配置 alias 的有效 `ReadonlyMap`。
+- `createModelResolver(getAliases, { warn })` — 构建 `resolveModel` 闭包。`getAliases` 是**每次调用**求值的 thunk(liveness)。可选 `warn` 替换默认的 `console.warn`(用于未配置自定义 alias 告警)。
+- `BUILTIN_ALIASES` — `['fable', 'opus', 'sonnet', 'haiku']`。
+- `ConfigAliasesSchema` / `SettingsAliasesSchema`(及其 record 形式)— config 层(无 `null`)与 settings 层(允许 `null`)的 schemastery schema,外加 `AliasTarget` / `ResolvedRoute` 类型。
+
+## 非目标(在 parity matrix 中跟踪)
+
+`/model` 交互命令、`ANTHROPIC_MODEL` / `ANTHROPIC_SMALL_FAST_MODEL` 环境变量、以及给主会话默认模型加 alias 仍是 follow-up。

package/lib/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Claude Code-compatible model alias resolution for the DeepSeek Harness.
+ *
+ * Two consumption shapes:
+ * - **Service** (`ccModelRoutes`): the plugin entry (`apply`) owns the
+ *   `model-aliases` settings namespace registration and provides a spawn-time
+ *   resolver over it; consumers `ctx.get('ccModelRoutes')` lazily.
+ * - **Pure helpers**: `mergeAliasMaps` / `createModelResolver` for embedding
+ *   the resolution semantics without mounting the service.
+ *
+ * See the README for configuration, merge, and fallback semantics.
+ *
+ * @module @jianxx/dsh-cc-model-aliases
+ */
+export { BUILTIN_ALIASES, mergeAliasMaps, createModelResolver } from './resolver.ts';
+export { ConfigAliasSchema, ConfigAliasesSchema, SettingsAliasSchema, SettingsAliasesSchema, type ConfigAliasEntry, type SettingsAliasEntry, } from './schema.ts';
+export type { AliasTarget, ResolvedRoute } from './types.ts';
+export { apply as applyRoutes, name as routesPluginName, type ModelRoutes } from './service.ts';
+export { apply, name } from './service.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACpF,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,EAAE,KAAK,IAAI,WAAW,EAAE,IAAI,IAAI,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/F,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA"}

package/lib/index.js

@@ -0,0 +1,19 @@
+/**
+ * Claude Code-compatible model alias resolution for the DeepSeek Harness.
+ *
+ * Two consumption shapes:
+ * - **Service** (`ccModelRoutes`): the plugin entry (`apply`) owns the
+ *   `model-aliases` settings namespace registration and provides a spawn-time
+ *   resolver over it; consumers `ctx.get('ccModelRoutes')` lazily.
+ * - **Pure helpers**: `mergeAliasMaps` / `createModelResolver` for embedding
+ *   the resolution semantics without mounting the service.
+ *
+ * See the README for configuration, merge, and fallback semantics.
+ *
+ * @module @jianxx/dsh-cc-model-aliases
+ */
+export { BUILTIN_ALIASES, mergeAliasMaps, createModelResolver } from "./resolver.js";
+export { ConfigAliasSchema, ConfigAliasesSchema, SettingsAliasSchema, SettingsAliasesSchema, } from "./schema.js";
+export { apply as applyRoutes, name as routesPluginName } from "./service.js";
+export { apply, name } from "./service.js";
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACpF,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GAGtB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,KAAK,IAAI,WAAW,EAAE,IAAI,IAAI,gBAAgB,EAAoB,MAAM,cAAc,CAAA;AAC/F,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA"}

package/lib/resolver.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Claude Code model-alias merge and resolution.
+ *
+ * `mergeAliasMaps` folds the deployment `config` defaults and the live
+ * `settings` overlay into one effective alias map — entry-shallow, so a
+ * settings value replaces a same-named config value wholesale rather than
+ * field-merging `{provider, model}` objects, with a settings `null` deleting
+ * the config entry. `createModelResolver` turns a per-invocation alias source
+ * into the `resolveModel` closure an agent provider calls at spawn time, so
+ * live settings edits take effect on the next spawn without re-registering
+ * anything.
+ *
+ * Only the four builtin alias names have a fallback when they are unconfigured
+ * — they resolve to "inherit the parent route" (`undefined`), matching the
+ * deployment decision that a zero-config `model: sonnet` agent silently uses
+ * the parent's current model. A custom (open-set) alias that is unconfigured
+ * has no fallback: it passes through verbatim as a literal model id, with a
+ * warning when it looks like an intended alias.
+ *
+ * @module @jianxx/dsh-cc-model-aliases/resolver
+ */
+import type { AliasTarget, ResolvedRoute } from './types.ts';
+/**
+ * The builtin alias names that fall back to "inherit the parent route" when
+ * unconfigured. Case-insensitive; a configured value still wins over this
+ * fallback.
+ */
+export declare const BUILTIN_ALIASES: readonly string[];
+/**
+ * Merge the deployment `config` defaults and the settings overlay into one
+ * effective alias map (aliases keyed by lowercased name). Entry-shallow:
+ * a settings value replaces a config value wholesale and never field-merges a
+ * `{provider, model}` object; a settings `null` deletes the config entry.
+ * @param config - deployment config `modelAliases` (values never `null` at the
+ *   schema level), or `undefined`.
+ * @param settings - live settings `model-aliases` section (values may be `null`
+ *   to delete), or `undefined`.
+ * @returns a fresh map of only the configured aliases, keyed lowercased.
+ */
+export declare function mergeAliasMaps(config: Readonly<Record<string, AliasTarget>> | undefined, settings: Readonly<Record<string, AliasTarget | null>> | undefined): ReadonlyMap<string, AliasTarget>;
+/**
+ * Build a `resolveModel` closure for an agent provider. The alias source is a
+ * thunk evaluated on every invocation, so the closure reads the live settings
+ * and merges fresh each spawn (see the plan's liveness requirement).
+ * @param getAliases - returns the effective alias map for this invocation (the
+ *   caller composes config + live settings via {@link mergeAliasMaps}).
+ * @param options - optional warning hook for unsigned custom aliases; the
+ *   message is emitted (defaulting to `console.warn`) when a model that is not
+ *   a configured alias and not a builtin looks like an intended alias (a bare
+ *   lowercase alphabetic word) and is passed through verbatim.
+ * @returns the resolution function mapping a frontmatter `model` to a route, or
+ *   `undefined` for no override.
+ */
+export declare function createModelResolver(getAliases: () => ReadonlyMap<string, AliasTarget>, options?: {
+    warn?: (message: string) => void;
+}): (model: string | undefined) => ResolvedRoute | undefined;
+//# sourceMappingURL=resolver.d.ts.map

package/lib/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE5D;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAAyC,CAAA;AAKtF;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,GAAG,SAAS,EACzD,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC,CAAC,GAAG,SAAS,GACjE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAalC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,EAClD,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GAC7C,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,aAAa,GAAG,SAAS,CAyB1D"}

package/lib/resolver.js

@@ -0,0 +1,107 @@
+/**
+ * Claude Code model-alias merge and resolution.
+ *
+ * `mergeAliasMaps` folds the deployment `config` defaults and the live
+ * `settings` overlay into one effective alias map — entry-shallow, so a
+ * settings value replaces a same-named config value wholesale rather than
+ * field-merging `{provider, model}` objects, with a settings `null` deleting
+ * the config entry. `createModelResolver` turns a per-invocation alias source
+ * into the `resolveModel` closure an agent provider calls at spawn time, so
+ * live settings edits take effect on the next spawn without re-registering
+ * anything.
+ *
+ * Only the four builtin alias names have a fallback when they are unconfigured
+ * — they resolve to "inherit the parent route" (`undefined`), matching the
+ * deployment decision that a zero-config `model: sonnet` agent silently uses
+ * the parent's current model. A custom (open-set) alias that is unconfigured
+ * has no fallback: it passes through verbatim as a literal model id, with a
+ * warning when it looks like an intended alias.
+ *
+ * @module @jianxx/dsh-cc-model-aliases/resolver
+ */
+/**
+ * The builtin alias names that fall back to "inherit the parent route" when
+ * unconfigured. Case-insensitive; a configured value still wins over this
+ * fallback.
+ */
+export const BUILTIN_ALIASES = ['fable', 'opus', 'sonnet', 'haiku'];
+/** The set of builtin names, lowercased, for O(1) membership checks. */
+const BUILTIN_SET = new Set(BUILTIN_ALIASES);
+/**
+ * Merge the deployment `config` defaults and the settings overlay into one
+ * effective alias map (aliases keyed by lowercased name). Entry-shallow:
+ * a settings value replaces a config value wholesale and never field-merges a
+ * `{provider, model}` object; a settings `null` deletes the config entry.
+ * @param config - deployment config `modelAliases` (values never `null` at the
+ *   schema level), or `undefined`.
+ * @param settings - live settings `model-aliases` section (values may be `null`
+ *   to delete), or `undefined`.
+ * @returns a fresh map of only the configured aliases, keyed lowercased.
+ */
+export function mergeAliasMaps(config, settings) {
+    const merged = new Map();
+    for (const [key, value] of foldKeys(config)) {
+        // Config never carries `null` at the schema level, but schemastery dicts are
+        // lenient about stored values; silently treat a stray config `null` as
+        // absent so it can never reach the resolver as a route.
+        if (value !== null)
+            merged.set(key, value);
+    }
+    for (const [key, value] of foldKeys(settings)) {
+        if (value === null)
+            merged.delete(key);
+        else
+            merged.set(key, value);
+    }
+    return merged;
+}
+/**
+ * Build a `resolveModel` closure for an agent provider. The alias source is a
+ * thunk evaluated on every invocation, so the closure reads the live settings
+ * and merges fresh each spawn (see the plan's liveness requirement).
+ * @param getAliases - returns the effective alias map for this invocation (the
+ *   caller composes config + live settings via {@link mergeAliasMaps}).
+ * @param options - optional warning hook for unsigned custom aliases; the
+ *   message is emitted (defaulting to `console.warn`) when a model that is not
+ *   a configured alias and not a builtin looks like an intended alias (a bare
+ *   lowercase alphabetic word) and is passed through verbatim.
+ * @returns the resolution function mapping a frontmatter `model` to a route, or
+ *   `undefined` for no override.
+ */
+export function createModelResolver(getAliases, options) {
+    const warn = options?.warn ?? ((message) => console.warn(message));
+    return (model) => {
+        if (model === undefined || model.trim().length === 0)
+            return undefined;
+        const trimmed = model.trim();
+        const folded = trimmed.toLowerCase();
+        if (folded === 'inherit')
+            return undefined;
+        const aliases = getAliases();
+        const hit = aliases.get(folded);
+        if (hit !== undefined && hit !== null) {
+            return typeof hit === 'string' ? { model: hit } : { provider: hit.provider, model: hit.model };
+        }
+        // Unconfigured builtin alias → inherit the parent route ("current model").
+        if (BUILTIN_SET.has(folded))
+            return undefined;
+        // Custom alias that is unconfigured: warn when it looks like an intended
+        // alias, then pass through verbatim as a literal model id (no regression
+        // for literal ids such as `deepseek-chat`).
+        if (/^[a-z]+$/.test(folded)) {
+            warn(`cc-model-aliases: model "${trimmed}" is not a configured alias and is not builtin; passing through verbatim as a literal model id`);
+        }
+        return { model: trimmed };
+    };
+}
+/** Compact-fill a record's own string keys, folding each to lowercase. */
+function foldKeys(record) {
+    const out = new Map();
+    if (record === undefined)
+        return out;
+    for (const [key, value] of Object.entries(record)) {
+        out.set(key.toLowerCase(), value);
+    }
+    return out;
+}
+//# sourceMappingURL=resolver.js.map

package/lib/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;AAEtF,wEAAwE;AACxE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,CAAA;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAyD,EACzD,QAAkE;IAElE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAA;IAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,6EAA6E;QAC7E,uEAAuE;QACvE,wDAAwD;QACxD,IAAI,KAAK,KAAK,IAAI;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAC5C,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9C,IAAI,KAAK,KAAK,IAAI;YAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;;YACjC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAC7B,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAAkD,EAClD,OAA8C;IAE9C,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,CAAC,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;IAC1E,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAA;QACtE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;QAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAA;QACpC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,SAAS,CAAA;QAE1C,MAAM,OAAO,GAAG,UAAU,EAAE,CAAA;QAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAC/B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACtC,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAA;QAChG,CAAC;QAED,2EAA2E;QAC3E,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,OAAO,SAAS,CAAA;QAE7C,yEAAyE;QACzE,yEAAyE;QACzE,4CAA4C;QAC5C,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,4BAA4B,OAAO,gGAAgG,CAAC,CAAA;QAC3I,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;IAC3B,CAAC,CAAA;AACH,CAAC;AAED,0EAA0E;AAC1E,SAAS,QAAQ,CAAC,MAAgE;IAChF,MAAM,GAAG,GAAG,IAAI,GAAG,EAA8B,CAAA;IACjD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,GAAG,CAAA;IACpC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAA;IACnC,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/lib/schema.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Configuration schemas for the CC model-alias layer.
+ *
+ * Two schemas exist because the two configuration layers differ in what they
+ * may express. The deployment `config` layer (cc-shell `modelAliases`) cannot
+ * delete an alias — values are a model id or an explicit `{provider, model}`
+ * route. The settings overlay (`model-aliases` namespace) may additionally be
+ * `null` for a key, which deletes a same-named config-default entry during
+ * merge. Object-form targets require a non-empty `provider` and `model` so a
+ * half-written route is rejected at schema-validation time rather than
+ * surfacing as an empty-field override at spawn.
+ *
+ * The settings overlay is a shallow record keyed by alias name; the 5-cascade
+ * layer merge inside settings is recursively deep (existing cascade
+ * behaviour), so an object-form alias must be written whole or not at all
+ * across layers to avoid `{provider, model}` field blending — see the package
+ * README.
+ *
+ * @module @jianxx/dsh-cc-model-aliases/schema
+ */
+import z from '@deepseek-ai/schemastery';
+import type { AliasTarget } from './types.ts';
+/**
+ * Schema for a deployment `config` alias value: a model id or an explicit
+ * route, but never `null` (config cannot delete an alias; only the settings
+ * overlay can).
+ */
+export declare const ConfigAliasSchema: z<string | ({
+    provider?: string | null;
+    model?: string | null;
+} & import("@deepseek-ai/cosmokit").Dict), string | Schemastery.ObjectT<{
+    provider: z<string, string>;
+    model: z<string, string>;
+}>>;
+/**
+ * Schema for a settings `model-aliases` value: a model id, an explicit route,
+ * or `null` meaning "delete a same-named config-default entry".
+ */
+export declare const SettingsAliasSchema: z<string | ({
+    provider?: string | null;
+    model?: string | null;
+} & import("@deepseek-ai/cosmokit").Dict) | null, string | Schemastery.ObjectT<{
+    provider: z<string, string>;
+    model: z<string, string>;
+}> | null>;
+/**
+ * Schema for the whole config `modelAliases` record.
+ */
+export declare const ConfigAliasesSchema: z<import("@deepseek-ai/cosmokit").Dict<string | ({
+    provider?: string | null;
+    model?: string | null;
+} & import("@deepseek-ai/cosmokit").Dict), string>, import("@deepseek-ai/cosmokit").Dict<string | Schemastery.ObjectT<{
+    provider: z<string, string>;
+    model: z<string, string>;
+}>, string>>;
+/**
+ * Schema for the whole settings `model-aliases` section.
+ */
+export declare const SettingsAliasesSchema: z<import("@deepseek-ai/cosmokit").Dict<string | ({
+    provider?: string | null;
+    model?: string | null;
+} & import("@deepseek-ai/cosmokit").Dict) | null, string>, import("@deepseek-ai/cosmokit").Dict<string | Schemastery.ObjectT<{
+    provider: z<string, string>;
+    model: z<string, string>;
+}> | null, string>>;
+/** The validated shape of one config entry (modelled on the schema). */
+export type ConfigAliasEntry = Exclude<AliasTarget, null>;
+/** The validated shape of one settings entry (may be `null` to delete). */
+export type SettingsAliasEntry = AliasTarget;
+//# sourceMappingURL=schema.d.ts.map

package/lib/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAW7C;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;;GAAwC,CAAA;AAEtE;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;UAAuD,CAAA;AAEvF;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;YAA4B,CAAA;AAE5D;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;mBAA8B,CAAA;AAEhE,wEAAwE;AACxE,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;AACzD,2EAA2E;AAC3E,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAA"}

package/lib/schema.js

@@ -0,0 +1,48 @@
+/**
+ * Configuration schemas for the CC model-alias layer.
+ *
+ * Two schemas exist because the two configuration layers differ in what they
+ * may express. The deployment `config` layer (cc-shell `modelAliases`) cannot
+ * delete an alias — values are a model id or an explicit `{provider, model}`
+ * route. The settings overlay (`model-aliases` namespace) may additionally be
+ * `null` for a key, which deletes a same-named config-default entry during
+ * merge. Object-form targets require a non-empty `provider` and `model` so a
+ * half-written route is rejected at schema-validation time rather than
+ * surfacing as an empty-field override at spawn.
+ *
+ * The settings overlay is a shallow record keyed by alias name; the 5-cascade
+ * layer merge inside settings is recursively deep (existing cascade
+ * behaviour), so an object-form alias must be written whole or not at all
+ * across layers to avoid `{provider, model}` field blending — see the package
+ * README.
+ *
+ * @module @jianxx/dsh-cc-model-aliases/schema
+ */
+import z from '@deepseek-ai/schemastery';
+/** A target that only names a model id (provider inherits the parent route). */
+const MODEL_ONLY = z.string().min(1);
+/** A target that pins an explicit `{provider, model}` route. */
+const EXPLICIT_ROUTE = z.object({
+    provider: z.string().min(1),
+    model: z.string().min(1),
+});
+/**
+ * Schema for a deployment `config` alias value: a model id or an explicit
+ * route, but never `null` (config cannot delete an alias; only the settings
+ * overlay can).
+ */
+export const ConfigAliasSchema = z.union([MODEL_ONLY, EXPLICIT_ROUTE]);
+/**
+ * Schema for a settings `model-aliases` value: a model id, an explicit route,
+ * or `null` meaning "delete a same-named config-default entry".
+ */
+export const SettingsAliasSchema = z.union([MODEL_ONLY, EXPLICIT_ROUTE, z.const(null)]);
+/**
+ * Schema for the whole config `modelAliases` record.
+ */
+export const ConfigAliasesSchema = z.dict(ConfigAliasSchema);
+/**
+ * Schema for the whole settings `model-aliases` section.
+ */
+export const SettingsAliasesSchema = z.dict(SettingsAliasSchema);
+//# sourceMappingURL=schema.js.map

package/lib/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAGxC,gFAAgF;AAChF,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;AAEpC,gEAAgE;AAChE,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACzB,CAAC,CAAA;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAA;AAEtE;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AAEvF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;AAE5D;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA"}

package/lib/service.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The `ccModelRoutes` host service: the single owner of the `model-aliases`
+ * settings namespace registration.
+ *
+ * CC frontmatter names models by alias (`model: opus`); this package maps an
+ * alias to a dsh `{provider, model}` route. Consumers (the cc-shell glue's
+ * `AgentProvider` and the Task tool) `ctx.get('ccModelRoutes')` lazily on
+ * every spawn — the resolver re-reads the live settings scope each call, so a
+ * settings write applies to the next spawn without re-registration.
+ *
+ * When no settings provider is mounted the resolver degrades to the config
+ * defaults plus the builtin fallback (an unconfigured builtin alias inherits
+ * the parent route), so a settings-less host still resolves.
+ *
+ * @module @jianxx/dsh-cc-model-aliases/service
+ */
+import z from '@deepseek-ai/schemastery';
+import type { Context } from '@deepseek-ai/cordis';
+import type { AliasTarget, ResolvedRoute } from './types.ts';
+/** Plugin configuration: deployment-default alias map. */
+export interface Config {
+    /** Deployment defaults (alias name → model id or `{provider, model}` route). */
+    modelAliases?: Record<string, Exclude<AliasTarget, null>>;
+}
+/** Runtime config schema (config-layer aliases never hold null). */
+export declare const Config: z<Config>;
+/** The shape consumers resolve through. */
+export interface ModelRoutes {
+    /** Resolve one frontmatter `model` to a dsh route, or undefined to inherit. */
+    resolve(model: string | undefined): ResolvedRoute | undefined;
+}
+/** Cordis plugin id. */
+export declare const name = "cc-model-routes";
+/**
+ * Register the `model-aliases` settings namespace (when a settings provider is
+ * mounted) and expose the spawn-time resolver as the `ccModelRoutes` value.
+ * @param ctx - the plug context.
+ * @param config - deployment defaults.
+ */
+export declare function apply(ctx: Context, config?: Config): void;
+//# sourceMappingURL=service.d.ts.map

package/lib/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AACxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE5D,0DAA0D;AAC1D,MAAM,WAAW,MAAM;IACrB,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAA;CAC1D;AAED,oEAAoE;AACpE,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAAmD,CAAA;AAKhF,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAAA;CAC9D;AAED,wBAAwB;AACxB,eAAO,MAAM,IAAI,oBAAoB,CAAA;AAErC;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,MAAW,GAAG,IAAI,CAuB7D"}

package/lib/service.js

@@ -0,0 +1,51 @@
+/**
+ * The `ccModelRoutes` host service: the single owner of the `model-aliases`
+ * settings namespace registration.
+ *
+ * CC frontmatter names models by alias (`model: opus`); this package maps an
+ * alias to a dsh `{provider, model}` route. Consumers (the cc-shell glue's
+ * `AgentProvider` and the Task tool) `ctx.get('ccModelRoutes')` lazily on
+ * every spawn — the resolver re-reads the live settings scope each call, so a
+ * settings write applies to the next spawn without re-registration.
+ *
+ * When no settings provider is mounted the resolver degrades to the config
+ * defaults plus the builtin fallback (an unconfigured builtin alias inherits
+ * the parent route), so a settings-less host still resolves.
+ *
+ * @module @jianxx/dsh-cc-model-aliases/service
+ */
+import z from '@deepseek-ai/schemastery';
+import { settingsNamespace } from '@deepseek-ai/dsh-settings';
+import { ConfigAliasesSchema, SettingsAliasesSchema } from "./schema.js";
+import { createModelResolver, mergeAliasMaps } from "./resolver.js";
+/** Runtime config schema (config-layer aliases never hold null). */
+export const Config = z.object({ modelAliases: ConfigAliasesSchema });
+/** The settings namespace carrying the live `model-aliases` overlay. */
+const MODEL_ALIASES_NAMESPACE = settingsNamespace('model-aliases');
+/** Cordis plugin id. */
+export const name = 'cc-model-routes';
+/**
+ * Register the `model-aliases` settings namespace (when a settings provider is
+ * mounted) and expose the spawn-time resolver as the `ccModelRoutes` value.
+ * @param ctx - the plug context.
+ * @param config - deployment defaults.
+ */
+export function apply(ctx, config = {}) {
+    const settings = ctx.get('settings');
+    const scope = settings?.register(MODEL_ALIASES_NAMESPACE, SettingsAliasesSchema, {
+        // Reject a half-written object route at write time (the dict schema cannot
+        // express a non-empty cross-field check).
+        validate: (value) => {
+            for (const [alias, target] of Object.entries(value)) {
+                if (target !== null && typeof target === 'object') {
+                    if (target.provider.trim().length === 0 || target.model.trim().length === 0) {
+                        throw new Error(`cc-model-aliases: model alias "${alias}" must specify a non-empty provider and model`);
+                    }
+                }
+            }
+        },
+    });
+    const resolve = createModelResolver(() => mergeAliasMaps(config.modelAliases, scope?.get?.()), { warn: message => ctx.logger.warn(message) });
+    ctx.provide('ccModelRoutes', { resolve });
+}
+//# sourceMappingURL=service.js.map

package/lib/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAGxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACxE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AASnE,oEAAoE;AACpE,MAAM,CAAC,MAAM,MAAM,GAAc,CAAC,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,mBAAmB,EAAE,CAAC,CAAA;AAEhF,wEAAwE;AACxE,MAAM,uBAAuB,GAAG,iBAAiB,CAAC,eAAe,CAAC,CAAA;AAQlE,wBAAwB;AACxB,MAAM,CAAC,MAAM,IAAI,GAAG,iBAAiB,CAAA;AAErC;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,GAAY,EAAE,SAAiB,EAAE;IACrD,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,UAAU,CAAiC,CAAA;IACpE,MAAM,KAAK,GAAG,QAAQ,EAAE,QAAQ,CAAC,uBAAuB,EAAE,qBAAqB,EAAE;QAC/E,2EAA2E;QAC3E,0CAA0C;QAC1C,QAAQ,EAAE,CAAC,KAAyC,EAAE,EAAE;YACtD,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpD,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;oBAClD,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBAC5E,MAAM,IAAI,KAAK,CAAC,kCAAkC,KAAK,+CAA+C,CAAC,CAAA;oBACzG,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC,CAAA;IACF,MAAM,OAAO,GAAG,mBAAmB,CACjC,GAAG,EAAE,CAAC,cAAc,CAClB,MAAM,CAAC,YAAY,EACnB,KAAK,EAAE,GAAG,EAAE,EAAoD,CACjE,EACD,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAC9C,CAAA;IACD,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;AAC3C,CAAC"}

package/lib/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Shared vocabulary for Claude Code-compatible model alias resolution.
+ *
+ * Claude Code frontmatter (`model: opus`, `model: sonnet`) names aliases rather
+ * than literal provider model IDs. This package layers those aliases onto the
+ * harness: it maps an alias to a dsh `{provider, model}` route, or leaves the
+ * frontmatter untouched so the child inherits its parent's route. The types
+ * here are the pure record shapes the resolution functions consume and emit;
+ * the merge and lookup semantics live in `resolver.ts` and the configuration
+ * schemas in `schema.ts`.
+ *
+ * @module @jianxx/dsh-cc-model-aliases/types
+ */
+/**
+ * A resolved dsh model route for one spawn.
+ *
+ * When `start()` passes this on as `agentOptions`, only the fields that are
+ * present (`provider` and/or `model`) override the delegation; a route omitting
+ * `provider` inherits the parent's provider, and one omitting `model` inherits
+ * the parent's model. `undefined` means "no override" — the child inherits the
+ * parent route wholesale (the `inherit` sentinel and the builtin fallback both
+ * resolve to this).
+ */
+export interface ResolvedRoute {
+    /** The provider to route to; omit to inherit the parent's provider. */
+    readonly provider?: string | undefined;
+    /** The model id (or resolved alias model) to use; omit to inherit. */
+    readonly model?: string | undefined;
+}
+/**
+ * One alias target as authored in config or settings.
+ *
+ * A string form names only a model id (`sonnet: deepseek-chat`); the provider
+ * inherits the parent route. An object form additionally pins a provider
+ * (`opus: { provider: ..., model: ... }`), breaking the current frontmatter
+ * limitation of never being able to override the provider. In the settings
+ * layer a configured entry may instead be `null`, which deletes a same-named
+ * config-default entry (see {@link mergeAliasMaps}).
+ */
+export type AliasTarget = string | {
+    readonly provider: string;
+    readonly model: string;
+} | null;
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,sEAAsE;IACtE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACpC;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAA"}

package/lib/types.js

@@ -0,0 +1,15 @@
+/**
+ * Shared vocabulary for Claude Code-compatible model alias resolution.
+ *
+ * Claude Code frontmatter (`model: opus`, `model: sonnet`) names aliases rather
+ * than literal provider model IDs. This package layers those aliases onto the
+ * harness: it maps an alias to a dsh `{provider, model}` route, or leaves the
+ * frontmatter untouched so the child inherits its parent's route. The types
+ * here are the pure record shapes the resolution functions consume and emit;
+ * the merge and lookup semantics live in `resolver.ts` and the configuration
+ * schemas in `schema.ts`.
+ *
+ * @module @jianxx/dsh-cc-model-aliases/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@jianxx/dsh-cc-model-aliases",
+  "description": "Claude Code-compatible model alias resolution for the DeepSeek Harness",
+  "version": "0.1.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jianxx/dsh-cc-plugins.git",
+    "directory": "packages/compat/cc-model-aliases"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./types": {
+      "types": "./lib/types.d.ts",
+      "default": "./lib/types.js"
+    },
+    "./schema": {
+      "types": "./lib/schema.d.ts",
+      "default": "./lib/schema.js"
+    },
+    "./resolver": {
+      "types": "./lib/resolver.d.ts",
+      "default": "./lib/resolver.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib"
+  ],
+  "license": "Apache-2.0",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-settings": ">=0.1.1-rc.2",
+    "@deepseek-ai/schemastery": "^3.18.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/schemastery": "link:../../../../deepseek-harness/vendor/schemastery",
+    "@deepseek-ai/cordis": "link:../../../../deepseek-harness/vendor/cordis",
+    "@deepseek-ai/dsh-settings": "link:../../../../deepseek-harness/packages/settings/settings"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}