@sparkelf/dsh-plugin-subagent-settings 0.1.0-rc.10

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/subagent-settings/README.md
+README.md: 78d9fe4d7b2fdd60260e8f5a4edf047e7a375d83
+README.zh.md: e8ce8f9f092e6fc957f166a62ae88ff8f6ceaf51

package/README.md

@@ -0,0 +1,63 @@
+---
+description: "Settings-backed continuous and one-shot subagent modes with complete Host, startup, and Client ownership."
+kind: "package-reference"
+---
+
+# @sparkelf/dsh-plugin-subagent-settings
+
+English | [中文](README.zh.md)
+
+## Summary
+
+This complete Host and Client plugin owns the two settings-backed delegation modes in Plus. Its Host root registers model-facing delegation, `/startup` owns the `subagent` and `subagent-fork` Settings namespaces, and the Client presents both modes in one Subagents section. Fresh settings disable both modes with zero nesting; saved changes affect later child starts without rebuilding the Host.
+
+## Table of Contents
+
+- [Use this package](#use-this-package)
+- [Model Experience](#model-experience)
+- [Known Limitations and Deferred Work](#known-limitations-and-deferred-work)
+- [Dev Note](#dev-note)
+
+-----
+
+<a id="use-this-package"></a>
+## Use this package
+
+The Plus profile mounts two startup rows and redirects the built-in continuous and one-shot preset rows to this package. Continuous mode creates a fresh continuable child; one-shot mode forks completed parent context for one task. Each namespace independently controls enablement, model override, output-token cap, persona, tool visibility, and nesting depth.
+
+-----
+
+<a id="model-experience"></a>
+## Model Experience
+
+### Settings-backed delegation tools
+
+#### What the model sees
+
+A disabled mode contributes no schema or prompt section. Continuous mode adds the `subagent` tool and continuable guidance; one-shot mode adds `subagent_fork`. Saved settings affect later children and never rewrite an existing child.
+
+#### Token effect
+
+Enabling a mode adds its stable tool schema and guidance. Child model, persona, and tool choices affect only child requests; tool calls and results follow normal Session history costs.
+
+#### KV Cache effect
+
+Toggling a mode changes the later-request tool prefix. One-shot mode reuses inherited parent history until child-specific prompt and tools are appended.
+
+## Known Limitations and Deferred Work
+
+<a id="known-limitations-and-deferred-work"></a>
+
+- **Temporary preset redirection patch**: official preset documents and the legacy model-selection card expose no runtime replacement API, so a retireable data-only patch redirects two built-in rows and removes the legacy Plus registration.
+
+<a id="dev-note"></a>
+### Dev Note
+
+<details>
+<summary>Working context for maintainers, click to expand</summary>
+
+This Dev Note is working context for maintainers; shipped behavior, limits, and rationale live in the sections above, the package code, and the linked Agent Note.
+
+- Host behavior lives under `src`, and the Settings UI lives under `src/client`. The [distribution Agent Note](../../../.agents/notes/proposed/architecture/2026-08-29-ranged-plus-patchset-distribution.md) owns package and patch retirement boundaries.
+
+</details>

package/README.zh.md

@@ -0,0 +1,63 @@
+---
+description: "具有完整Host、startup及Client ownership的settings-backed continuous和one-shot subagent modes。"
+kind: "package-reference"
+---
+
+# @sparkelf/dsh-plugin-subagent-settings
+
+[English](README.md) | 中文
+
+## 概述
+
+该完整Host及Client plugin持有Plus中的两个settings-backed delegation modes。Host root注册model-facing delegation，`/startup`持有`subagent`及`subagent-fork` Settings namespaces，Client在一个Subagents section中展示两种mode。Fresh settings会以zero nesting禁用两种mode；saved change无需rebuild Host即可影响later child starts。
+
+## 目录
+
+- [使用此软件包](#use-this-package)
+- [模型体验](#model-experience)
+- [已知限制和延期工作](#known-limitations-and-deferred-work)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="use-this-package"></a>
+## 使用此软件包
+
+Plus profile会mount两个startup rows，并把built-in continuous及one-shot preset rows重定向到该package。Continuous mode创建fresh continuable child；one-shot mode为一个task fork completed parent context。每个namespace独立控制enablement、model override、output-token cap、persona、tool visibility及nesting depth。
+
+-----
+
+<a id="model-experience"></a>
+## 模型体验
+
+### Settings-backed delegation tools
+
+#### 模型看到什么
+
+disabled mode不贡献schema或prompt section。Continuous mode增加`subagent` tool及continuable guidance；one-shot mode增加`subagent_fork`。Saved settings影响later children，不会rewrite existing child。
+
+#### Token 影响
+
+启用mode会增加对应stable tool schema及guidance。Child model、persona及tool choices只影响child requests；tool calls及results遵循normal Session history costs。
+
+#### KV Cache 影响
+
+切换mode会改变later-request tool prefix。One-shot mode会复用inherited parent history，直到追加child-specific prompt及tools。
+
+## 已知限制和延期工作
+
+<a id="known-limitations-and-deferred-work"></a>
+
+- **Temporary preset redirection patch**：official preset documents及legacy model-selection card没有runtime replacement API，因此retireable data-only patch会redirect两个built-in rows并移除legacy Plus registration。
+
+<a id="dev-note"></a>
+### 开发备注
+
+<details>
+<summary>维护者工作上下文，点击展开</summary>
+
+该开发备注是maintainer working context；shipped behavior、limits及rationale以以上sections、package code及linked Agent Note为准。
+
+- Host behavior位于`src`，Settings UI位于`src/client`。[Distribution Agent Note](../../../.agents/notes/proposed/architecture/2026-08-29-ranged-plus-patchset-distribution.zh.md)持有package及patch retirement boundaries。
+
+</details>