@dsh-cc/coordinator 0.5.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/subagent/coordinator/README.md
+README.md: bc1add74cb3269a3ca12fb644e78ab2ecb8e3f44
+README.zh.md: adff7bdffee7e3020ade7393b173e646d42fa530

package/README.md

@@ -0,0 +1,34 @@
+# @dsh-cc/coordinator
+
+English | [中文](README.zh.md)
+
+Coordinator mode is an agent-scoped orchestration role over continuable subagents: when active, the hosting agent stops editing the workspace directly and instead delegates work to named background workers and routes messages among them. Activation is a deployment flag — Config `enabled` or the `DSH_COORDINATOR_MODE` env — and it takes effect on the agent whose scope mounts this package, so a preset [composes it](../preset/agent-presets/README.md) into a session and the mode survives resume by being re-mounted from that pinned composition.
+
+## Activation and tool restriction
+
+`apply(ctx, config)` resolves `config.enabled ?? DSH_COORDINATOR_MODE`, and when inactive registers nothing — a preset may mount it unconditionally. When active it requires an agent-scoped context (it reads the mounted `agent`), because tool restriction is an agent-scoped operation; mounting it on a plain context fails loud rather than masking every agent. It then installs, all scoped to that agent:
+
+- a `coordinator:mode` system-prompt section (`installCoordinatorMode`'s `sectionOrder`, default prompt-order 110) stating the orchestration role, the delegation tool list, and the result-return protocol;
+- the scheduling tools `spawn_worker`, `send_to_worker`, `worker_broadcast`, and `worker_tasks`;
+- a scoped [tool restriction](../../core/tools/README.md) via `ctx.tools.restrict()`, defaulting to `{ deny: ['write', 'edit'] }` (Config `restrict` overrides, and may use an `allow` mask instead).
+
+Disposing the plugin fiber reverses every registration in one pass, so disabling coordinator mode restores the agent's full tool surface.
+
+## Delegation surface
+
+The scheduling tools are thin adapters over the subagent service, so residency, cold resume, and delivery authority remain the service's:
+
+- `spawn_worker(name, prompt)` calls `ctx.subagents.startContinuable()` and records the durable child id under the given name.
+- `send_to_worker(worker, message)` resolves a name (or durable id) and delivers one next-turn message through `ctx.subagents.followup()`, sourcing it `{ kind: 'coordinator', form: 'relay' }`.
+- `worker_broadcast(message)` follows up the same content with every registered worker.
+- `worker_tasks()` lists registered workers with a live status from the Agent registry.
+
+An unknown worker reference is an errored result; a scheduling tool invoked without a calling agent fails loud.
+
+## Result return and completion (reused protocols)
+
+Coordinator mode does not reinvent worker-to-coordinator reporting. A worker reports through the independently installed [`@deepseek-ai/dsh-tool-subagent-report`](../tool-subagent-report/README.md) `report` tool, and the subagent service delivers that as a parent message. When a worker settles, the subagent service's continuation settlement already injects its `subagent-settled` notice into the coordinator agent's session as a waking message ([`dsh-subagent` continuation settlement delivery](../subagent/README.md)) — the completion notification that wakes the coordinator's loop. This package documents that reuse rather than duplicating the wake; its tests assert the notice reaches the coordinator session.
+
+## Directory
+
+The `Section` texts and constants live in `src/section.ts`; the worker bookkeeping, scheduling tools, activation gate, and disposer live in `src/index.ts`.

package/README.zh.md

@@ -0,0 +1,34 @@
+# @dsh-cc/coordinator
+
+[English](README.md) | 中文
+
+协调模式是一种基于可继续子代理（continuable subagent）的、作用于单个 agent 作用域的编排角色：激活后，宿主 agent 不再直接修改工作区，而是把任务委派给有名字的后台 worker，并在它们之间路由消息。激活由部署开关控制——Config 的 `enabled` 或 `DSH_COORDINATOR_MODE` 环境变量——它作用于挂载本包的 agent 作用域，因此 preset 会[把该组合编排进会话](../preset/agent-presets/README.md)，并通过在 resume 时从固定的组合中重新挂载来保持该模式。
+
+## 激活与工具限制
+
+`apply(ctx, config)` 解析 `config.enabled ?? DSH_COORDINATOR_MODE`，未激活时不注册任何内容——preset 可以无条件挂载它。激活时需要 agent 作用域的上下文（它读取被挂载的 `agent`），因为工具限制是 agent 作用域操作；挂载到普通上下文会明确报错，而不是遮蔽所有 agent。随后它会安装以下内容（全部限定在该 agent 作用域）：
+
+- 一个 `coordinator:mode` system-prompt 区段（`installCoordinatorMode` 的 `sectionOrder`，默认 prompt-order 110），说明编排职责、委派工具清单以及结果回流协议；
+- 调度工具 `spawn_worker`、`send_to_worker`、`worker_broadcast` 和 `worker_tasks`；
+- 通过 `ctx.tools.restrict()` 施加的[作用域工具限制](../../core/tools/README.md)，默认为 `{ deny: ['write', 'edit'] }`（Config `restrict` 可覆盖，也可改用 `allow` 掩码）。
+
+释放插件 fiber 会一次性撤销全部注册，因此关闭协调模式即可恢复该 agent 的完整工具面。
+
+## 委派面
+
+调度工具是 subagent 服务之上的薄适配层，因此驻留、冷恢复和投递权限仍归服务所有：
+
+- `spawn_worker(name, prompt)` 调用 `ctx.subagents.startContinuable()`，并把持久子 id 记录在给定名称之下。
+- `send_to_worker(worker, message)` 解析名称（或持久 id），并通过 `ctx.subagents.followup()` 投递一条下一轮消息，其来源记为 `{ kind: 'coordinator', form: 'relay' }`。
+- `worker_broadcast(message)` 把相同内容发送给每个已注册 worker。
+- `worker_tasks()` 列出已注册 worker，并附带来自 Agent 注册表的实时状态。
+
+未知的 worker 引用会得到出错结果；在无调用 agent 的情况下调用调度工具会明确失败。
+
+## 结果回流与完成（复用既有协议）
+
+协调模式不会重新实现 worker 到协调者的结果回流。worker 通过独立安装的 [`@deepseek-ai/dsh-tool-subagent-report`](../tool-subagent-report/README.md) 的 `report` 工具上报，subagent 服务会将其作为一条父级消息投递。当某 worker 结束（settle）时，subagent 服务的 continuation 结算已把它的 `subagent-settled` 通知作为唤醒消息注入协调者 agent 的会话（参见 [`dsh-subagent` continuation 结算投递](../subagent/README.md)）——这正是唤醒协调者循环的完成通知。本包记录这一复用而不是重复实现唤醒；其测试断言该通知确实到达协调者会话。
+
+## 目录
+
+`src/section.ts` 中的 Section 文本与常量；worker 记账、调度工具、激活开关与释放器均位于 `src/index.ts`。

package/lib/index.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Coordinator mode: an agent-scoped orchestration role over continuable
+ * subagents. Activation (Config `enabled` or the `DSH_COORDINATOR_MODE` env)
+ * restricts the agent's correspondence to delegation and read-only tools,
+ * installs a coordinator prompt section, and brings up the model-facing
+ * scheduling tools ({@link spawn_worker}, {@link send_to_worker},
+ * {@link worker_broadcast}, {@link worker_tasks}).
+ *
+ * Result return and completion waking are NOT reimplemented here: a worker
+ * reports through the existing `report` tool (`tool-subagent-report`),
+ * and the subagent manager already injects its `subagent-settled` notice into
+ * this coordinator's inbox as a waking message when a worker settles
+ * (`@deepseek-ai/dsh-subagent`'s continuation settlement delivery). This
+ * package adds the coordinator role and its naming/messaging surface around
+ * those seams and documents the reuse.
+ * @module @dsh-cc/coordinator
+ */
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import { Context } from '@deepseek-ai/cordis';
+import { type ToolRestriction } from '@dsh-cc/tools';
+/** Default tool visibility mask: deny the two canonical code-editing tools. */
+export declare const DEFAULT_COORDINATOR_RESTRICT: ToolRestriction;
+/** Config governing one coordinator agent's mode activation. */
+export interface CoordinatorConfig {
+    /**
+     * Activate coordinator mode. Defaults to the `DSH_COORDINATOR_MODE` env flag
+     * (`1`, `true`, or `yes`), so a deployment toggles it without config edits.
+     */
+    readonly enabled?: boolean;
+    /**
+     * The tool visibility mask applied to the coordinator agent's scope on
+     * activation. Deployment-chosen write-tool names go in `deny`; a curated
+     * `allow` list narrows to a fixed set instead. Defaults to
+     * {@link DEFAULT_COORDINATOR_RESTRICT}.
+     */
+    readonly restrict?: ToolRestriction;
+    /** Prompt order of the coordinator section (default 110). */
+    readonly sectionOrder?: number;
+}
+/**
+ * Resolve whether coordinator mode is active for this configuration.
+ * @param config - resolved deployment config.
+ * @returns whether to activate coordinator mode on this agent's scope.
+ */
+export declare function isCoordinatorActive(config: CoordinatorConfig): boolean;
+/**
+ * The registrations installed when coordinator mode activates on one agent's
+ * scope. Each registration is scoped to that agent's context and owned by the
+ * returned disposer, so disabling the mode (fiber disposal) removes the prompt
+ * section, the scheduling tools, and the tool restriction together.
+ * @param agent - the coordinator agent whose scope receives the registrations.
+ * @param ctx - context carrying the tool registry and subagent service.
+ * @param config - resolved deployment config.
+ * @returns a disposer that restores the coordinator agent's full surface.
+ */
+export declare function installCoordinatorMode(agent: Agent, ctx: Context, config?: CoordinatorConfig): () => void;
+/**
+ * The coordinator-mode namespace plugin. Mount it in an agent's scope (as a
+ * preset composes into `agent.ctx`) to activate coordinator mode for that
+ * agent. When mode is inactive this is a no-op that registers nothing, so a
+ * preset may mount it unconditionally and Coordination engages only when
+ * enabled. Requires an agent scope when active, because tool restriction is an
+ * agent-scoped operation.
+ * @param ctx - context; must carry an `agent` when mode is active.
+ * @param config - deployment config, optionally overriding the env flag.
+ */
+export declare function apply(ctx: Context, config?: CoordinatorConfig): () => void;
+export declare const name = "coordinator";
+export declare const inject: string[];
+//# 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;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAI7C,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,eAAe,CAAA;AAWhE,+EAA+E;AAC/E,eAAO,MAAM,4BAA4B,EAAE,eAA6C,CAAA;AAExF,gEAAgE;AAChE,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAA;IACnC,6DAA6D;IAC7D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAOD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAKtE;AAuDD;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,OAAO,EACZ,MAAM,GAAE,iBAAsB,GAC7B,MAAM,IAAI,CAgNZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,iBAAsB,GAAG,MAAM,IAAI,CAS9E;AAED,eAAO,MAAM,IAAI,gBAAgB,CAAA;AACjC,eAAO,MAAM,MAAM,UAAmD,CAAA"}

package/lib/index.js

@@ -0,0 +1,308 @@
+/**
+ * Coordinator mode: an agent-scoped orchestration role over continuable
+ * subagents. Activation (Config `enabled` or the `DSH_COORDINATOR_MODE` env)
+ * restricts the agent's correspondence to delegation and read-only tools,
+ * installs a coordinator prompt section, and brings up the model-facing
+ * scheduling tools ({@link spawn_worker}, {@link send_to_worker},
+ * {@link worker_broadcast}, {@link worker_tasks}).
+ *
+ * Result return and completion waking are NOT reimplemented here: a worker
+ * reports through the existing `report` tool (`tool-subagent-report`),
+ * and the subagent manager already injects its `subagent-settled` notice into
+ * this coordinator's inbox as a waking message when a worker settles
+ * (`@deepseek-ai/dsh-subagent`'s continuation settlement delivery). This
+ * package adds the coordinator role and its naming/messaging surface around
+ * those seams and documents the reuse.
+ * @module @dsh-cc/coordinator
+ */
+import { defineTool } from '@dsh-cc/tools';
+import { COORDINATOR_SECTION_ORDER, COORDINATOR_SECTION_TEXT } from "./section.js";
+/** Default tool visibility mask: deny the two canonical code-editing tools. */
+export const DEFAULT_COORDINATOR_RESTRICT = { deny: ['write', 'edit'] };
+const SPAWN_WORKER = 'spawn_worker';
+const SEND_TO_WORKER = 'send_to_worker';
+const WORKER_BROADCAST = 'worker_broadcast';
+const WORKER_TASKS = 'worker_tasks';
+/**
+ * Resolve whether coordinator mode is active for this configuration.
+ * @param config - resolved deployment config.
+ * @returns whether to activate coordinator mode on this agent's scope.
+ */
+export function isCoordinatorActive(config) {
+    if (config.enabled !== undefined)
+        return config.enabled;
+    const env = process.env.DSH_COORDINATOR_MODE;
+    if (env === undefined)
+        return false;
+    return env === '1' || env === 'true' || env === 'yes';
+}
+/**
+ * The durable `name -> childId` and `childId -> name` worker bookkeeping for
+ * one coordinator agent. Owned solely by the installed mode; no worker outlives
+ * the containing CoordinatorInstall properly (each entry is disposable).
+ */
+class WorkerRegistry {
+    nameToId = new Map();
+    idToName = new Map();
+    /** The coordinator-scoped spawn provider name. */
+    provider;
+    constructor(provider) {
+        this.provider = provider;
+    }
+    /** Record one named worker after its durable child id is known. */
+    track(name, childId) {
+        this.nameToId.set(name, childId);
+        this.idToName.set(childId, name);
+    }
+    /** Resolve one name to its durable child id, or `undefined` when unknown. */
+    resolve(name) {
+        return this.nameToId.get(name);
+    }
+    /**
+     * Resolve a worker reference that is either a registered name or one of the
+     * tracked durable child ids, or `undefined` when it matches neither.
+     */
+    resolveAny(reference) {
+        const byName = this.nameToId.get(reference);
+        if (byName !== undefined)
+            return byName;
+        for (const childId of this.idToName.keys()) {
+            if (String(childId) === reference)
+                return childId;
+        }
+        return undefined;
+    }
+    /** Drop a worker from the registry without touching its session. */
+    untrack(name) {
+        const childId = this.nameToId.get(name);
+        this.nameToId.delete(name);
+        if (childId !== undefined)
+            this.idToName.delete(childId);
+    }
+    /** Snapshot of the registered named workers in insertion order. */
+    entries() {
+        return [...this.nameToId].map(([name, childId]) => ({ name, childId }));
+    }
+}
+/**
+ * The registrations installed when coordinator mode activates on one agent's
+ * scope. Each registration is scoped to that agent's context and owned by the
+ * returned disposer, so disabling the mode (fiber disposal) removes the prompt
+ * section, the scheduling tools, and the tool restriction together.
+ * @param agent - the coordinator agent whose scope receives the registrations.
+ * @param ctx - context carrying the tool registry and subagent service.
+ * @param config - resolved deployment config.
+ * @returns a disposer that restores the coordinator agent's full surface.
+ */
+export function installCoordinatorMode(agent, ctx, config = {}) {
+    const provider = ctx.subagents;
+    const registry = new WorkerRegistry('spawn');
+    const taskSource = (sendingId) => ({
+        kind: 'coordinator',
+        form: 'relay',
+        senderSessionId: sendingId,
+    });
+    // Scoped tool registration helper: each tool's execute resolves the live
+    // coordinator agent and its durable id for authority and attribution.
+    const disposals = [];
+    disposals.push(agent.ctx.systemPrompt.section({
+        name: 'coordinator:mode',
+        order: config.sectionOrder ?? COORDINATOR_SECTION_ORDER,
+        text: COORDINATOR_SECTION_TEXT,
+    }));
+    disposals.push(agent.ctx.tools.register(defineTool({
+        name: SPAWN_WORKER,
+        description: 'Start one named background worker to carry out a task in the shared workspace. '
+            + 'Name it for later send_to_worker and worker_tasks use. The worker reports its result through the '
+            + 'report tool, which arrives back here as a waking message; when it finishes you are told either way. '
+            + 'Delegation is the only way to change the workspace in coordinator mode.',
+        parameters: {
+            name: {
+                type: 'string',
+                required: true,
+                description: 'A stable name to address the worker by later; must be unique among your active workers.',
+            },
+            prompt: {
+                type: 'string',
+                required: true,
+                description: 'A self-contained task for the worker. It shares your workspace.',
+            },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    worker: { type: 'string', required: true },
+                    worker_id: { type: 'string', required: true },
+                },
+            },
+            render: (args, value) => [{
+                    type: 'text',
+                    text: `worker ${args.name} started as ${value.worker_id}`,
+                }],
+        },
+        async execute(args, exec) {
+            const started = await provider.startContinuable({
+                provider: registry.provider,
+                label: args.name,
+                request: {
+                    prompt: [{ type: 'text', text: args.prompt }],
+                    parent: agent,
+                },
+                signal: exec.signal,
+            });
+            registry.track(args.name, started.childId);
+            return { worker: args.name, worker_id: started.childId };
+        },
+    })));
+    disposals.push(agent.ctx.tools.register(defineTool({
+        name: SEND_TO_WORKER,
+        description: 'Send a message to one of your named workers, continuing its conversation on the same turn queue. '
+            + 'Use it to redirect, extend, or clarify work already delegated. Returns only delivery confirmation; '
+            + 'the worker answers with a later report or its finish notice.',
+        parameters: {
+            worker: {
+                type: 'string',
+                required: true,
+                description: 'The name the worker was started with, or its durable worker id.',
+            },
+            message: {
+                type: 'string',
+                required: true,
+                description: 'The message to deliver as the worker\'s next turn.',
+            },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    worker: { type: 'string', required: true },
+                    messageId: { type: 'string', required: true },
+                },
+            },
+            render: (args, value) => [{
+                    type: 'text',
+                    text: `message queued for worker ${args.worker} as message ${value.messageId}`,
+                }],
+        },
+        async execute(args, exec) {
+            const childId = registry.resolveAny(args.worker);
+            if (childId === undefined) {
+                throw new Error(`unknown worker "${args.worker}": start it with spawn_worker first`);
+            }
+            const messageId = await provider.followup(agent, childId, [{ type: 'text', text: args.message }], { source: taskSource(agent.id), signal: exec.signal });
+            return { worker: args.worker, messageId };
+        },
+    })));
+    disposals.push(agent.ctx.tools.register(defineTool({
+        name: WORKER_BROADCAST,
+        description: 'Send the same message to every one of your active named workers as their next turn. ',
+        parameters: {
+            message: {
+                type: 'string',
+                required: true,
+                description: 'The message to deliver to every active worker.',
+            },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    sent: { type: 'number', required: true },
+                },
+            },
+            render: (_args, value) => [{
+                    type: 'text',
+                    text: `broadcast delivered to ${value.sent} worker${value.sent === 1 ? '' : 's'}`,
+                }],
+        },
+        async execute(args, exec) {
+            const entries = registry.entries();
+            let sent = 0;
+            for (const entry of entries) {
+                await provider.followup(agent, entry.childId, [{ type: 'text', text: args.message }], { source: taskSource(agent.id), signal: exec.signal });
+                sent += 1;
+            }
+            return { sent };
+        },
+    })));
+    disposals.push(agent.ctx.tools.register(defineTool({
+        name: WORKER_TASKS,
+        description: 'List your active named workers and their durable ids, with a live status. '
+            + 'Use it to recall what you delegated, not to poll for results — you are told when one finishes. '
+            + 'One-shot children and workers you cannot read are omitted from the live view.',
+        parameters: {},
+        output: {
+            schema: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    additionalProperties: false,
+                    properties: {
+                        worker: { type: 'string', required: true },
+                        worker_id: { type: 'string', required: true },
+                        status: { type: 'string', required: true, enum: ['running', 'idle', 'ready'] },
+                    },
+                },
+            },
+            render: (_args, value) => value.length === 0
+                ? [{ type: 'text', text: '(no active workers)' }]
+                : [{
+                        type: 'text',
+                        text: value.map(row => `${row.worker} [${row.status}] — ${row.worker_id}`).join('\n'),
+                    }],
+        },
+        async execute(_args, _exec) {
+            const entries = registry.entries();
+            const rows = [];
+            for (const entry of entries) {
+                const live = ctx.agents.get(entry.childId);
+                const status = live === undefined ? 'ready' : (live.status === 'running' ? 'running' : 'idle');
+                rows.push({ worker: entry.name, worker_id: entry.childId, status });
+            }
+            return rows;
+        },
+    })));
+    disposals.push(agent.ctx.tools.restrict(config.restrict ?? DEFAULT_COORDINATOR_RESTRICT));
+    return () => {
+        const failures = [];
+        for (const dispose of disposals.splice(0).reverse()) {
+            try {
+                dispose();
+            }
+            catch (error) {
+                failures.push(error);
+            }
+        }
+        if (failures.length > 0) {
+            throw new AggregateError(failures, 'failed to revoke coordinator mode registrations');
+        }
+    };
+}
+/**
+ * The coordinator-mode namespace plugin. Mount it in an agent's scope (as a
+ * preset composes into `agent.ctx`) to activate coordinator mode for that
+ * agent. When mode is inactive this is a no-op that registers nothing, so a
+ * preset may mount it unconditionally and Coordination engages only when
+ * enabled. Requires an agent scope when active, because tool restriction is an
+ * agent-scoped operation.
+ * @param ctx - context; must carry an `agent` when mode is active.
+ * @param config - deployment config, optionally overriding the env flag.
+ */
+export function apply(ctx, config = {}) {
+    if (!isCoordinatorActive(config))
+        return () => { };
+    const agent = ctx.get('agent');
+    if (agent === undefined) {
+        // A coordinator masked across every agent would be a deployment mistake;
+        // refusing keeps the misconfiguration visible at load time.
+        throw new Error('dsh-coordinator requires an agent-scoped context (agent.ctx) when coordinator mode is active');
+    }
+    return installCoordinatorMode(agent, ctx, config);
+}
+export const name = 'coordinator';
+export const inject = ['tools', 'subagents', 'agents', 'systemPrompt'];
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/lib/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@dsh-cc/coordinator`.
+ * @module @dsh-cc/coordinator/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "coordinator-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/lib/invariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../src/invariant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,oCAAoC;AACpC,eAAO,MAAM,IAAI,0BAA0B,CAAA;AAC3C,2EAA2E;AAC3E,eAAO,MAAM,MAAM,UAAiB,CAAA;AASpC;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,KAAK,OAAO,KAAG,OAAO,CAAC,MAAM,IAAI,CACU,CAAA"}

package/lib/invariant.js

@@ -0,0 +1,23 @@
+/**
+ * Package-owned invariant companion for `@dsh-cc/coordinator`.
+ * @module @dsh-cc/coordinator/invariant
+ */
+const PACKAGE_NAME = '@dsh-cc/coordinator';
+/** Cordis companion plugin name. */
+export const name = 'coordinator-invariant';
+/** Service required before the companion can reserve package ownership. */
+export const inject = ['invariants'];
+/**
+ * No runtime invariant: this agent-scoped adapter has no independent lifecycle
+ * stream; restriction, prompt-section, and worker bookkeeping effects are
+ * owned by the subagent service it calls and are asserted directly by tests.
+ */
+const install = () => { };
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+/* jscpd:ignore-end */
+//# sourceMappingURL=invariant.js.map

package/lib/invariant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.js","sourceRoot":"","sources":["../src/invariant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,YAAY,GAAG,qBAAqB,CAAA;AAE1C,oCAAoC;AACpC,MAAM,CAAC,MAAM,IAAI,GAAG,uBAAuB,CAAA;AAC3C,2EAA2E;AAC3E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,YAAY,CAAC,CAAA;AAEpC;;;;GAIG;AACH,MAAM,OAAO,GAAuB,GAAG,EAAE,GAAE,CAAC,CAAA;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAY,EAAuB,EAAE,CACzD,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAA;AACjE,sBAAsB"}

package/lib/section.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The coordinator-mode system-prompt section: states the orchestration role, the
+ * available delegation tools, and the result-return protocol a coordinator agent
+ * runs under.
+ *
+ * @module @dsh-cc/coordinator/section
+ */
+/** Prompt order: within the tool-guidance band, before per-tool sections. */
+export declare const COORDINATOR_SECTION_ORDER = 110;
+/**
+ * The fixed orchestration guidance installed when coordinator mode is active.
+ * It names the delegation surface a coordinator acts through and pins the
+ * result-return protocol to the subagent report seam, so a coordinator never
+ * mistakes direct code-editing for its job and knows how worker results come
+ * back.
+ */
+export declare const COORDINATOR_SECTION_TEXT: string;
+//# sourceMappingURL=section.d.ts.map

package/lib/section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section.d.ts","sourceRoot":"","sources":["../src/section.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,QAO6B,CAAA"}

package/lib/section.js

@@ -0,0 +1,24 @@
+/**
+ * The coordinator-mode system-prompt section: states the orchestration role, the
+ * available delegation tools, and the result-return protocol a coordinator agent
+ * runs under.
+ *
+ * @module @dsh-cc/coordinator/section
+ */
+/** Prompt order: within the tool-guidance band, before per-tool sections. */
+export const COORDINATOR_SECTION_ORDER = 110;
+/**
+ * The fixed orchestration guidance installed when coordinator mode is active.
+ * It names the delegation surface a coordinator acts through and pins the
+ * result-return protocol to the subagent report seam, so a coordinator never
+ * mistakes direct code-editing for its job and knows how worker results come
+ * back.
+ */
+export const COORDINATOR_SECTION_TEXT = 'Coordinator mode: you orchestrate workers instead of doing the work yourself. '
+    + 'Delegate tasks with spawn_worker, redirect or extend one with send_to_worker, '
+    + 'reach all of them with worker_broadcast, and review them with worker_tasks. '
+    + 'Do not edit the workspace directly: assign that work to a worker. Each worker '
+    + 'reports its result through the report tool, which lands back in your conversation '
+    + 'as a waking message naming the worker; a worker that ends without reporting '
+    + 'still notifies you so you can decide whether to resume it.';
+//# sourceMappingURL=section.js.map

package/lib/section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"section.js","sourceRoot":"","sources":["../src/section.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,6EAA6E;AAC7E,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAA;AAE5C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACjC,gFAAgF;MAC9E,gFAAgF;MAChF,8EAA8E;MAC9E,gFAAgF;MAChF,oFAAoF;MACpF,8EAA8E;MAC9E,4DAA4D,CAAA"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@dsh-cc/coordinator",
+  "description": "Coordinator-mode orchestration over continuable subagents for the DeepSeek Harness",
+  "version": "0.5.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dsh-cc/dsh-cc.git",
+    "directory": "packages/subagent/coordinator"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib"
+  ],
+  "license": "Apache-2.0",
+  "peerDependencies": {
+    "@deepseek-ai/dsh-agent": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-invariants": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-llm": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-subagent": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-system-prompt": ">=0.1.1-rc.2",
+    "@deepseek-ai/cordis": ">=0.1.1-rc.2",
+    "@dsh-cc/tools": "^0.5.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-agent": "link:../../../../deepseek-harness/packages/core/agent",
+    "@deepseek-ai/dsh-agent-loop": "link:../../../../deepseek-harness/packages/core/agent-loop",
+    "@deepseek-ai/dsh-agent-loop-testkit": "link:../../../../deepseek-harness/packages/test-support/agent-loop-testkit",
+    "@deepseek-ai/dsh-invariants": "link:../../../../deepseek-harness/packages/runtime-diagnostics/invariants",
+    "@deepseek-ai/dsh-llm": "link:../../../../deepseek-harness/packages/llm/llm",
+    "@deepseek-ai/dsh-session": "link:../../../../deepseek-harness/packages/core/session",
+    "@deepseek-ai/dsh-session-persistence": "link:../../../../deepseek-harness/packages/session/session-persistence",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "link:../../../../deepseek-harness/packages/session/session-persistence-jsonl",
+    "@deepseek-ai/dsh-session-projection": "link:../../../../deepseek-harness/packages/session/session-projection",
+    "@deepseek-ai/dsh-subagent": "link:../../../../deepseek-harness/packages/subagent/subagent",
+    "@deepseek-ai/dsh-subagent-spawn-in-process": "link:../../../../deepseek-harness/packages/subagent/subagent-spawn-in-process",
+    "@deepseek-ai/dsh-system-prompt": "link:../../../../deepseek-harness/packages/core/system-prompt",
+    "@deepseek-ai/cordis": "link:../../../../deepseek-harness/vendor/cordis",
+    "@dsh-cc/tools": "^0.5.0",
+    "@dsh-cc/agent-loop-mock": "^0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}