@yadsh/dsh-sleev 0.0.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 dsh-sleev contributors
+
+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.md

@@ -0,0 +1,129 @@
+# dsh-sleev
+
+[![CI](https://github.com/xarleyn/dsh-plugins/actions/workflows/ci.yml/badge.svg)](https://github.com/xarleyn/dsh-plugins/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/%40yadsh%2Fdsh-sleev.svg)](https://www.npmjs.com/package/@yadsh/dsh-sleev)
+[![npm downloads](https://img.shields.io/npm/dm/%40yadsh%2Fdsh-sleev.svg)](https://www.npmjs.com/package/@yadsh/dsh-sleev)
+[![Node.js](https://img.shields.io/node/v/%40yadsh%2Fdsh-sleev.svg)](package.json)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+Sleev routing observability for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness).
+
+`dsh-sleev` observes provider routes that pass through the external Sleev context-optimization gateway. The current observer does not rewrite prompts, implement compaction, or route traffic itself: routing remains a normal `@deepseek-ai/dsh-llm-pi-ai` provider configuration.
+
+[简体中文](README.zh-CN.md) · [Specification](dsh-sleev-spec-v0.1.md) · [Development guide](docs/development.md) · [Compatibility notes](docs/compatibility.md)
+
+## Installation
+
+Install the published npm package by name:
+
+```bash
+dsh plugin --profile web add @yadsh/dsh-sleev
+```
+
+To remove the plugin:
+
+```bash
+dsh plugin --profile web remove @yadsh/dsh-sleev
+```
+
+Restart the DeepSeek Harness host if bundle hot reload does not pick up the newly installed plugin or browser client.
+
+## What works now
+
+- exact route and prefix matching, with `sleev-` as the default prefix;
+- classification of agent, compaction, session-title, and one-shot calls;
+- pass-through streaming that yields every chunk unchanged;
+- provider usage and effective input-token accounting;
+- bounded, secret-free in-memory call history;
+- one structured completion record per observed call;
+- live observer matching, retention, and logging settings in the Web UI.
+
+The observer never stores prompts, request headers, credentials, or secret values. Direct routes that do not match the configured Sleev aliases remain unobserved.
+
+## Settings UI
+
+Open **Settings → Plugins → Plugin Configuration → Sleev** to edit:
+
+- exact observed provider aliases;
+- observed provider-name prefixes;
+- the recent-call history limit;
+- structured telemetry logging at `off`, `info`, or `debug`.
+
+Edits are staged until **Save**. The card marks unsaved changes and lets each overridden field be reset to its composition default. Saved values apply to the next matching call without a host restart.
+
+These settings decide what the plugin observes. Model endpoints and Sleev routing headers still belong under `llm-pi-ai.providers` in DSH model settings.
+
+## Configure a Sleev route
+
+Merge a provider route into `$DSH_HOME/settings.yaml` under `llm-pi-ai.providers`. DSH resolves the credential reference; never place a literal API key in the route configuration.
+
+```yaml
+llm-pi-ai:
+  providers:
+    sleev-neuraldeep:
+      displayName: Sleev / neuraldeep
+      apiKeyEnv: NEURALDEEP_API_KEY
+      api: openai-completions
+      baseURL: http://127.0.0.1:17321/v1
+      headers:
+        sleev-base-url: https://api.neuraldeep.ru/v1
+        sleev-harness: pi
+      models:
+        - id: gpt-oss-20b
+          name: GPT OSS 20B via Sleev
+```
+
+Use `sleev-provider` instead of `sleev-base-url` for a provider known to Sleev; do not combine the two headers on one route. The [sample settings](docs/sample-settings.yml) show both forms.
+
+Sleev does not currently document a native DeepSeek Harness identifier. The sample's `sleev-harness: pi` is an explicit experimental compatibility choice, not a promise of first-party support.
+
+## Compatibility
+
+The complete DSH → llm-pi-ai → Sleev → NeuralDeep streaming path has passed ordinary completion, usage, tool-call, and tool-result checks with DeepSeek Harness `0.1.1-rc.2`, Sleev `1.7.7`, and NeuralDeep `gpt-oss-20b`.
+
+This establishes transport compatibility, not token savings. The small validation prompt exposed Sleev's fixed instruction overhead; a long, tool-heavy session is still required for a meaningful compression benchmark. See the [compatibility notes](docs/compatibility.md) for the exact evidence.
+
+## Requirements
+
+- Node.js `^22.19.0` or `>=24.0.0`
+- pnpm 10.4.1 for development
+- DeepSeek Harness `>=0.1.1-rc.2 <0.2.0`
+- Cordis `^4.0.1`
+- a configured and running Sleev gateway for routed model calls
+
+## Development
+
+From the monorepo root:
+
+```bash
+pnpm install --frozen-lockfile
+pnpm --filter @yadsh/dsh-sleev check
+```
+
+Build and link the checkout into a Web profile:
+
+```bash
+pnpm --filter @yadsh/dsh-sleev build
+dsh plugin --profile web add ./plugins/dsh-sleev
+dsh --profile web --dump-config
+```
+
+Run the account-backed NeuralDeep smoke separately when credentials and the local gateway are available:
+
+```bash
+pnpm --filter @yadsh/dsh-sleev smoke:neuraldeep
+```
+
+The live provider smoke is intentionally excluded from required CI because it depends on credentials, a local gateway, and an external provider.
+
+## Releases
+
+This package uses independent Nx Version Plans from the monorepo. Add a plan with `pnpm release:plan`; maintainers publish verified tarballs through the shared [release workflow](../../docs/RELEASING.md).
+
+## Contributing
+
+Issues and focused pull requests are welcome. Read the monorepo [contribution guide](../../CONTRIBUTING.md) and run the package check before submitting a change.
+
+## License
+
+[MIT](LICENSE). This is an independent community project and is not affiliated with or endorsed by DeepSeek.

package/README.zh-CN.md

@@ -0,0 +1,129 @@
+# dsh-sleev
+
+[![CI](https://github.com/xarleyn/dsh-plugins/actions/workflows/ci.yml/badge.svg)](https://github.com/xarleyn/dsh-plugins/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/%40yadsh%2Fdsh-sleev.svg)](https://www.npmjs.com/package/@yadsh/dsh-sleev)
+[![npm downloads](https://img.shields.io/npm/dm/%40yadsh%2Fdsh-sleev.svg)](https://www.npmjs.com/package/@yadsh/dsh-sleev)
+[![Node.js](https://img.shields.io/node/v/%40yadsh%2Fdsh-sleev.svg)](package.json)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 提供 Sleev 路由可观测能力。
+
+`dsh-sleev` 用于观测经由外部 Sleev 上下文优化网关的提供商路由。当前观测器不会改写提示词、实现压缩或自行路由流量；路由仍由普通的 `@deepseek-ai/dsh-llm-pi-ai` 提供商配置负责。
+
+[English](README.md) · [规范](dsh-sleev-spec-v0.1.md) · [开发指南](docs/development.md) · [兼容性说明](docs/compatibility.md)
+
+## 安装
+
+按名称安装已发布的 npm 包：
+
+```bash
+dsh plugin --profile web add @yadsh/dsh-sleev
+```
+
+卸载插件：
+
+```bash
+dsh plugin --profile web remove @yadsh/dsh-sleev
+```
+
+如果 bundle 热更新没有加载新安装的插件或 browser client，请重启 DeepSeek Harness Host。
+
+## 当前功能
+
+- 精确匹配路由及路由前缀，默认前缀为 `sleev-`；
+- 区分 agent、压缩、会话标题和一次性调用；
+- 原样转发每一个流式数据块；
+- 记录提供商 usage 和有效输入 token 数量；
+- 在内存中保留有界且不含敏感信息的调用历史；
+- 为每次完成的观测调用输出一条结构化记录；
+- 在 Web UI 中实时配置匹配、保留数量和日志级别。
+
+观测器不会存储提示词、请求 header、凭据或密钥。未匹配已配置 Sleev 别名的直连路由不会被观测。
+
+## 设置界面
+
+打开 **设置 → 插件 → 插件配置 → Sleev**，可以编辑：
+
+- 精确观测的提供商别名；
+- 观测的提供商名称前缀；
+- 最近调用历史的数量上限；
+- `off`、`info` 或 `debug` 级别的结构化遥测日志。
+
+修改会暂存到点击**保存**时才写入。卡片会标记未保存的修改，并允许每个已覆盖字段单独恢复 composition 默认值。保存后的值从下一次匹配调用开始生效，无需重启 Host。
+
+这些设置只决定插件观测哪些请求。模型 endpoint 和 Sleev routing header 仍在 DSH model settings 的 `llm-pi-ai.providers` 下配置。
+
+## 配置 Sleev 路由
+
+将提供商配置合并到 `$DSH_HOME/settings.yaml` 的 `llm-pi-ai.providers` 下。凭据引用由 DSH 解析；不要在路由配置中直接填写 API key。
+
+```yaml
+llm-pi-ai:
+  providers:
+    sleev-neuraldeep:
+      displayName: Sleev / neuraldeep
+      apiKeyEnv: NEURALDEEP_API_KEY
+      api: openai-completions
+      baseURL: http://127.0.0.1:17321/v1
+      headers:
+        sleev-base-url: https://api.neuraldeep.ru/v1
+        sleev-harness: pi
+      models:
+        - id: gpt-oss-20b
+          name: GPT OSS 20B via Sleev
+```
+
+对于 Sleev 已知的提供商，可使用 `sleev-provider` 代替 `sleev-base-url`；同一路由中不要同时设置两者。[示例设置](docs/sample-settings.yml)展示了这两种形式。
+
+Sleev 目前没有记录原生 DeepSeek Harness 标识符。示例中的 `sleev-harness: pi` 是明确的实验性兼容选择，并不代表官方一等支持。
+
+## 兼容性
+
+完整的 DSH → llm-pi-ai → Sleev → NeuralDeep 流式链路已使用 DeepSeek Harness `0.1.1-rc.2`、Sleev `1.7.7` 和 NeuralDeep `gpt-oss-20b` 通过普通 completion、usage、工具调用和工具结果检查。
+
+这证明了传输兼容性，而不是 token 节省效果。小型验证提示词会暴露 Sleev 的固定指令开销；要得到有意义的压缩基准，仍需使用较长且工具密集型的会话。确切证据见[兼容性说明](docs/compatibility.md)。
+
+## 要求
+
+- Node.js `^22.19.0` 或 `>=24.0.0`
+- pnpm 10.4.1（开发环境）
+- DeepSeek Harness `>=0.1.1-rc.2 <0.2.0`
+- Cordis `^4.0.1`
+- 进行路由模型调用时，需要已配置并运行的 Sleev 网关
+
+## 开发
+
+在 monorepo 根目录运行：
+
+```bash
+pnpm install --frozen-lockfile
+pnpm --filter @yadsh/dsh-sleev check
+```
+
+构建并将 checkout 链接到 Web profile：
+
+```bash
+pnpm --filter @yadsh/dsh-sleev build
+dsh plugin --profile web add ./plugins/dsh-sleev
+dsh --profile web --dump-config
+```
+
+当凭据和本地网关可用时，可以单独运行需要账户的 NeuralDeep smoke：
+
+```bash
+pnpm --filter @yadsh/dsh-sleev smoke:neuraldeep
+```
+
+真实 provider smoke 依赖凭据、本地网关和外部提供商，因此不会作为必需 CI 检查运行。
+
+## 发布
+
+该包使用 monorepo 的独立 Nx Version Plans。通过 `pnpm release:plan` 添加计划；维护者通过共享的[发布流程](../../docs/RELEASING.md)发布已验证的 tarball。
+
+## 贡献
+
+欢迎提交 issue 和范围明确的 pull request。提交前请阅读 monorepo 的[贡献指南](../../CONTRIBUTING.md)并运行 package check。
+
+## 许可证
+
+[MIT](LICENSE)。这是一个独立的社区项目，与 DeepSeek 无隶属关系，也未获得其官方认可。

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# The DSH plugin manager discovers this bundle through package.json.
+- insert:
+    - id: dsh-sleev
+      name: "@yadsh/dsh-sleev"

package/docs/compatibility.md

@@ -0,0 +1,49 @@
+# Compatibility matrix
+
+Last verified: 2026-08-27.
+
+| Component           | Version / route                         | Result                                      |
+| ------------------- | --------------------------------------- | ------------------------------------------- |
+| DeepSeek Harness    | `0.1.1-rc.2`                            | supported                                   |
+| Cordis              | `4.0.1`                                 | supported                                   |
+| Sleev CLI + gateway | `1.7.7`                                 | healthy                                     |
+| DSH adapter         | `@deepseek-ai/dsh-llm-pi-ai@0.1.1-rc.2` | supported                                   |
+| Web settings        | DSH plugin configuration surface        | client bundle and `sleev` namespace served  |
+| Sleev harness id    | `pi`                                    | works; still not a documented native DSH id |
+| Upstream            | NeuralDeep / `gpt-oss-20b`              | compatibility smoke passed                  |
+
+## Verified wire behavior
+
+The reproducible `pnpm smoke:neuraldeep` test passed through the complete path:
+
+```text
+DSH LlmRuntime
+  -> llm-pi-ai (openai-completions)
+  -> Sleev 127.0.0.1:17321
+  -> https://api.neuraldeep.ru/v1
+  -> streamed DSH chunks
+```
+
+Verified on the route `sleev-neuraldeep`:
+
+- ordinary text streaming completed;
+- provider usage survived the gateway;
+- a streamed tool call retained its name and JSON arguments;
+- a follow-up containing the assistant tool call and user tool result completed;
+- the observer recorded each gateway attempt independently;
+- a direct NeuralDeep route coexisted with the Sleev alias.
+
+The final successful A/B run reported 65 effective provider-input tokens for
+the direct short prompt and 1,400 for the same prompt through Sleev. The Sleev
+tool call used 1,431 and its tool-result continuation used 1,546. This is
+expected to be an unfavorable comparison for a tiny prompt: it exposes the
+gateway's fixed optimization instructions before there is stale history to
+reclaim. It is transport evidence, not a savings benchmark.
+
+An earlier tool-result attempt failed transiently at NeuralDeep and the next
+attempt completed; the observer retained both attempts. The final A/B run then
+completed without a retry and recorded exactly the three Sleev calls, excluding
+the direct control request.
+
+These short prompts establish transport compatibility, not context reduction.
+A long tool-heavy session is still required to measure Sleev compression.

package/docs/development.md

@@ -0,0 +1,76 @@
+# Development and local smoke testing
+
+## Prerequisites
+
+- Node.js 22.19+ or 24+
+- pnpm 11
+- DeepSeek Harness 0.1.1-rc.2
+- Sleev CLI 1.7.7 for a real gateway test
+
+Install and verify Sleev without starting an account flow:
+
+```powershell
+npm install --global sleev@1.7.7
+sleev --version
+sleev gateway status
+```
+
+Account and machine setup are interactive and deliberately remain a user
+action:
+
+```powershell
+sleev auth login
+sleev setup
+sleev gateway status
+```
+
+The default local gateway address is `http://127.0.0.1:17321`; an
+OpenAI-compatible DSH route uses `http://127.0.0.1:17321/v1` as its base URL.
+
+## DSH profile
+
+Build before adding or restarting the profile:
+
+```powershell
+pnpm check
+dsh plugin --profile web add /absolute/path/to/dsh-sleev
+```
+
+The current DSH web bundle disables shared-module HMR. Changes to this package
+therefore require a host restart, especially after adding or changing the
+package's `dsh.client` manifest. Changes under the `llm-pi-ai` section of
+`$DSH_HOME/settings.yaml` are independently hot-reloaded by DSH settings.
+
+After restarting, open **Settings → Plugins → Plugin configuration → Sleev**.
+The card edits the `sleev` namespace in `$DSH_HOME/settings.yaml`: exact routes,
+route prefixes, recent-call retention, and logging level. Values are staged
+until Save and then read through by the Host on the next matching request. The
+card does not edit `llm-pi-ai` provider endpoints or Sleev routing headers.
+
+## Compatibility caveat
+
+Sleev currently documents harness ids for several first-party integrations but
+not DeepSeek Harness. The sample uses `sleev-harness: pi` because the supported
+DSH adapter is `llm-pi-ai`; treat it as an experimental compatibility value.
+Keep it easy to override, and verify tools, streaming, and usage on every Sleev
+upgrade until Sleev publishes a native DSH identifier.
+
+Only record a version pair as compatible after a configured account passes a
+real request with tools and a provider `usage` chunk; the matrix records the
+first version pair that met that bar.
+
+## NeuralDeep compatibility smoke
+
+With `NEURALDEEP_API_KEY` available in the environment, run:
+
+```powershell
+pnpm smoke:neuraldeep
+```
+
+The script compares a direct and Sleev-routed short prompt, then performs a
+tool-call and tool-result continuation through Sleev. It requires provider
+usage on every successful call and exits non-zero if stream/tool semantics are
+lost. Normalized provider errors are retried up to three times because the free
+NeuralDeep route can be transiently unavailable.
+
+The first verified run is recorded in [compatibility.md](compatibility.md).

package/docs/sample-settings.yml

@@ -0,0 +1,34 @@
+# Merge one of these profiles into $DSH_HOME/settings.yaml under llm-pi-ai.
+# The credential reference is resolved by DSH; never put the literal key here.
+llm-pi-ai:
+  providers:
+    # A provider recognized by Sleev.
+    sleev-openai:
+      displayName: Sleev / OpenAI
+      apiKeyEnv: OPENAI_API_KEY
+      api: openai-completions
+      baseURL: http://127.0.0.1:17321/v1
+      headers:
+        sleev-provider: openai
+        # Experimental: Sleev has no documented DeepSeek Harness id yet.
+        # DSH currently sends this route through llm-pi-ai.
+        sleev-harness: pi
+      models:
+        - id: replace-with-upstream-model-id
+          name: Replace with upstream model
+          contextWindow: 128000
+          maxTokens: 16384
+
+    # Verified custom OpenAI-compatible upstream. Do not combine
+    # sleev-provider and sleev-base-url on the same route.
+    sleev-neuraldeep:
+      displayName: Sleev / neuraldeep
+      apiKeyEnv: NEURALDEEP_API_KEY
+      api: openai-completions
+      baseURL: http://127.0.0.1:17321/v1
+      headers:
+        sleev-base-url: https://api.neuraldeep.ru/v1
+        sleev-harness: pi
+      models:
+        - id: gpt-oss-20b
+          name: GPT OSS 20B via Sleev