@sparkelf/dsh-omitted 0.2.0-rc.18

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/plus/omitted/README.md
+README.md: e710be74bd50289824b03d4d2e3f4fe8227c6570
+README.zh.md: ce5bf948b7bef73ee7ac06a76a3dcc1137bd3313

package/README.md

@@ -0,0 +1,61 @@
+---
+description: "Placeholder package an omitted capability is overridden onto, so an installation never receives the real one."
+kind: "package-reference"
+---
+
+# @sparkelf/dsh-omitted
+
+English | [中文](README.zh.md)
+
+A placeholder a deployment points an `overrides` entry at when it must not install a capability.
+
+## Table of Contents
+
+- [Use this package](#use-this-package)
+- [Known Limitations and Deferred Work](#known-limitations-and-deferred-work)
+- [Dev Note](#dev-note)
+
+-----
+
+## Summary
+
+npm expresses package substitution through `overrides` and has no removal semantics: an override can only replace a package with another one, never delete it. A deployment that omits a capability therefore points its override at this package, and the substituted name never reaches the installation.
+
+The omission stays auditable for the same reason: a scan of the tree finds the placeholder rather than the capability it replaced.
+
+## Use this package
+
+```json
+{
+  "overrides": {
+    "@deepseek-ai/dsh-computer-use": "npm:@sparkelf/dsh-omitted@0.2.0-rc.17"
+  }
+}
+```
+
+## Dev Note
+
+The package exists for one reason, so it carries no dependency of its own beyond the Cordis peer every plugin in this repository declares.
+
+- No runtime invariant companion is published because the package exports nothing and holds no state; a substitution is observed by the installation tree that npm resolves, not by this module.
+
+## Model Experience
+
+### Omitted capability substitution
+
+#### What the model sees
+
+Nothing. `@sparkelf/dsh-omitted` registers no tool, prompt section, or Session event of its own, and the deployment that installs it omits the capability it stands in for.
+
+#### Token effect
+
+Zero. The package adds no model-request tokens.
+
+#### KV Cache effect
+
+None. It contributes no prompt content, so it cannot shift a cache prefix.
+
+## Known Limitations and Deferred Work
+
+- The module exports nothing. Loading it in place of a real plugin fails at the mount step with a missing-export error, which is intended: a deployment that omitted a capability must not silently mount a stub for it. A deployment must also not mount the substituted name as a bundle.
+- This package has no behaviour to configure and no commands.

package/README.zh.md

@@ -0,0 +1,65 @@
+---
+description: "被省略能力的 overrides 占位包，使安装结果中不会出现真实包。"
+kind: "package-reference"
+---
+
+# @sparkelf/dsh-omitted
+
+[English](README.md) | 中文
+
+当部署不允许安装某个能力时，把它指向的占位包。
+
+## 目录
+
+- [使用](#use-this-package)
+- [已知限制和延期工作](#known-limitations-and-deferred-work)
+- [开发备注](#dev-note)
+
+-----
+
+## 概述
+
+npm 通过 `overrides` 表达包替换，且没有删除语义：override 只能把包替换成另一个包，不能删除它。因此省略某能力的部署把 override 指向本包，被替换的名字就不会出现在安装结果里。
+
+省略也因此可审计：扫描依赖树会找到占位包，而不是被它替换的能力包。
+
+<a id="use-this-package"></a>
+## 使用
+
+```json
+{
+  "overrides": {
+    "@deepseek-ai/dsh-computer-use": "npm:@sparkelf/dsh-omitted@0.2.0-rc.17"
+  }
+}
+```
+
+<a id="dev-note"></a>
+## 开发备注
+
+本包只为一件事存在，因此除了本仓库每个插件都声明的 Cordis peer 之外没有自己的依赖。
+
+- 不发布运行时 invariant 伴随模块，因为本包不导出任何内容也不持有状态；替换由 npm 解析出的安装树观察，而不是由本模块观察。
+
+<a id="model-experience"></a>
+## 模型体验
+
+### Omitted capability substitution
+
+#### What the model sees
+
+什么都没有。`@sparkelf/dsh-omitted` 不注册自己的工具、提示词段落或 Session 事件，而安装它的部署省略了它所替代的能力。
+
+#### Token effect
+
+零。本包不增加任何模型请求 token。
+
+#### KV Cache effect
+
+无。它不贡献提示词内容，因此不会移动缓存前缀。
+
+<a id="known-limitations-and-deferred-work"></a>
+## 已知限制和延期工作
+
+- 本模块不导出任何内容。把它当作真实插件加载会在挂载步骤以缺失导出报错，这是有意为之：省略了某能力的部署不应静默挂载它的替身。该部署也不应把被替换的名字作为 bundle 挂载。
+- 本包无需配置的行为，也没有命令。

package/lib/index.js

@@ -0,0 +1 @@
+export {};

package/lib/types/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * A placeholder that stands in for a capability a deployment omits.
+ *
+ * npm expresses package substitution through \`overrides\` and has no removal
+ * semantics, so a deployment that must not install a capability points its override at
+ * this package instead. The substituted name never reaches the installation, which is
+ * what makes the omission auditable: a scan of the tree finds the placeholder rather
+ * than the capability.
+ *
+ * The module deliberately exports nothing. Loading it in place of a real plugin fails
+ * at the mount step with a missing-export error, which is the intended outcome: a
+ * deployment that omitted a capability must not silently mount a stub for it.
+ *
+ * @module @sparkelf/dsh-omitted
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/package.json

@@ -0,0 +1,38 @@
+{
+  "description": "Placeholder package an omitted capability is overridden onto, so an installation never receives the real one.",
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2"
+  },
+  "exports": {
+    ".": {
+      "default": "./lib/index.js",
+      "types": "./lib/types/index.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/**/*.js",
+    "lib/**/*.d.ts",
+    "README.md",
+    "README.zh.md",
+    "README.i18n.yaml"
+  ],
+  "license": "MIT",
+  "main": "lib/index.js",
+  "name": "@sparkelf/dsh-omitted",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.2"
+  },
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "directory": "packages/plus/omitted",
+    "type": "git",
+    "url": "git+https://github.com/SparkElf/deepseek-harness-plus.git"
+  },
+  "type": "module",
+  "types": "lib/types/index.d.ts",
+  "version": "0.2.0-rc.18"
+}