@klarkxy/dsh-delegation 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,42 @@
+            The Star And Thank Author License (SATA)
+                  Version 2.1, September 2026
+
+Copyright © 2026 Klarkxy(278370456@qq.com)
+
+Project Url: https://github.com/klarkxy/dsh-editor
+             https://github.com/klarkxy/sata-license
+             https://github.com/klarkxy/dsh-plugins
+
+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.
+
+And wait, one more thing — an invitation, not a condition: it would be best if
+you star/+1/like the project(s) in the project url section above, and thank the
+author(s) in the Copyright section. You may, and arguably you should — but the
+permissions above hold either way, star or no star.
+
+Here are some suggested ways:
+
+ - Email the authors a thank-you letter, and make friends with him/her/them.
+ - Report bugs or issues.
+ - Tell friends what a wonderful project this is.
+ - And, sure, you can just express thanks in your mind without telling the world.
+
+Contributors of this project by forking have the option to add his/her name and
+forked project url at copyright and project url sections, but shall not delete
+or modify anything else in these two sections.
+
+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

@@ -1,3 +1,33 @@
-# Temporary Holding Version
+# Delegation Mode
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<!-- release-state-note -->
+
+[简体中文](docs/README.zh-CN.md)
+
+A per-session switch that has the main agent plan, delegate to subagents, and review results while subagents carry out the work. When on, the main agent acts as a coordinator — breaking the request into tasks, handing them to subagents, and checking their reports — while subagent sessions receive matching guidance to complete the assigned work.
+
+## Install
+
+```bash
+dsh plugin --profile web add @klarkxy/dsh-delegation
+```
+
+Enable the plugin in your profile, then reload the page or restart the profile as the manager requires.
+
+## Use
+
+- On the new-session page, use the switch on the same row as the workspace and preset selectors before sending the first message: **Default** is gray; **Delegate** uses the theme color. The choice locks once the session starts, including after reopening it. The switch applies to the session's main agent, and its subagents automatically receive matching execution guidance.
+- In **Plugins → Delegation Mode**, **Enable Delegation Mode for new sessions** sets the initial state for sessions created later.
+- Simple tasks can be completed directly. For larger tasks, the main agent assigns scoped work to subagents, coordinates shared interfaces, and checks their results before reporting completion.
+
+## Limits
+
+- Presets that expose subagent tools — Standard and PTC — support delegation; presets without subagent tools (such as Minimal and other complete-persona presets) keep the switch disabled.
+- The switch updates prompt guidance only; tool access and permissions remain unchanged, and delegation is guided rather than strictly enforced.
+- Delegation Mode stays fixed once a session starts, keeping the session's prompt cache stable.
+- Changing the default applies to sessions created afterwards; existing sessions keep their current state.
+- The added prompt section may reduce provider prompt-cache hits.
+
+## License
+
+[SATA License 2.1](LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# Enabled when installed. Adds a conversation-header delegation switch.
+- insert:
+    - id: delegation
+      name: '@klarkxy/dsh-delegation'
+      disabled: false

package/docs/README.zh-CN.md

@@ -0,0 +1,33 @@
+# 委派模式
+
+<!-- release-state-note -->
+
+[English](../README.md)
+
+按会话开启的委派开关：主代理负责拆解、委派和验收，具体工作交给子代理。开启后，主代理作为协调者把请求拆成任务、交给子代理执行并验收结果；子代理会话会同步获得对应的执行指引。
+
+## 安装
+
+```bash
+dsh plugin --profile web add @klarkxy/dsh-delegation
+```
+
+在 profile 中启用插件，然后按插件管理器要求刷新页面或重启 profile。
+
+## 使用
+
+- 在创建会话页，发送第一条消息前，使用工作区、预设选择器同一行的切换开关：「默认」显示灰色，「委派」显示主题色。选择在会话开始后锁定，重新打开也保持不变。开关作用于该会话的主代理，它的子代理会自动获得对应的执行指引。
+- 在「插件 → 委派模式」中，「新会话默认启用委派」决定之后新建会话的初始状态。
+- 简单任务可以直接完成；较大任务由主代理先分派具体工作，再协调共同接口、检查子代理结果，最后汇报完成情况。
+
+## 限制
+
+- 带子代理工具的预设（Standard 与 PTC）可使用委派；无子代理工具的预设（如 Minimal 及其他完整人设预设）显示开关为禁用状态。
+- 开关仅调整提示词引导，保持原有的工具与权限设置，通过提示引导模型委派。
+- 委派模式在会话开始后保持固定，以维持提示词缓存稳定。
+- 修改默认值仅影响之后新建的会话，已有会话保持原状态。
+- 新增的提示词小节可能降低模型供应商的提示词缓存命中率。
+
+## 许可证
+
+[SATA License 2.1](../LICENSE)

package/icon.svg

@@ -0,0 +1,15 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="36" height="36" viewBox="0 0 36 36" fill="none">
+  <defs>
+    <linearGradient id="dlg-node" x1="8" y1="6" x2="28" y2="30" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#4D75F5"/>
+      <stop offset="1" stop-color="#8EB6FF"/>
+    </linearGradient>
+  </defs>
+  <g transform="translate(3.6 3.6) scale(.8)">
+  <circle cx="18" cy="9" r="3.6" fill="url(#dlg-node)"/>
+  <path d="M18 12.8V17M18 17L9 25M18 17L27 25" stroke="#6392FF" stroke-width="2.8" stroke-linecap="round" stroke-linejoin="round"/>
+  <circle cx="9" cy="28" r="3.2" fill="#39ABA9"/>
+  <circle cx="27" cy="28" r="3.2" fill="#39ABA9"/>
+  <path d="M7.8 28L8.7 28.9L10.4 27.2M25.8 28L26.7 28.9L28.4 27.2" stroke="#E0FBF6" stroke-width="1.4" stroke-linecap="round" stroke-linejoin="round"/>
+  </g>
+</svg>