dsh-subagent-parent-message
Bidirectional messaging tools for delegated DSH subagents.
subagent_parent_message — child → direct parent. It reads the parent from the child's own Session header and delivers a durable peer-session message, so one-shot/workflow children can report without writing a file first.subagent_send_message — a namespaced alias for the core adjacent-agent channel (parent ↔ direct continuable child). Use it when the parent's send_message is shadowed by a team-scoped tool with a different schema.
中文说明
Why
DSH core send_message only authorizes a resident continuable child to message its direct parent, and the parent often sees a different send_message ({target, message} from the experimental team tool) instead of the core one ({agent_id, message}). In practice:
subagent / subagent_fork children can reach the parent, but the parent cannot reply when its send_message is team-scoped.workflow agent() / pipeline() children are one-shot; they have no continuation activation, so core send_message fails.- Nested children often only know a root/grandparent id; core only accepts the direct parent/child (
subagent "<id>" is unavailable).
- The old workaround was "write everything to disk so the parent can read it". It still works, but it is not a message.
These two namespaced tools cover both directions without adding another send_message collision.
Tools
subagent_parent_message — child → parent
subagent_parent_message({ "message": "self-contained progress or result" })
subagent_parent_message({ "message": "...", "mode": "steer" })
followup (default): queue a new parent turn; wakes an idle parent.steer: inject at the parent's next step while it is running.- Resolves the direct parent from
session.header.parentSession; no parent id required.
- Uses the live parent Agent or
sessionController.resolveAgent cold resume, then agent.followup/steer + ctx.sessions.flush.
- Works for one-shot/workflow children because it does not depend on a continuation activation.
- Refuses self-delivery and never accepts an arbitrary target.
subagent_send_message — parent ↔ direct continuable child
subagent_send_message({ "agent_id": "session-…", "message": "keep going" })
- Thin namespaced adapter over
ctx.subagents.sendMessage().
- The subagent service still enforces direct parent/child adjacency and continuation residency.
- Useful when the parent's
send_message is team-scoped (target schema), so the core channel is otherwise unreachable by name.
- It cannot wake a one-shot child; for a one-shot child's report use
subagent_parent_message in the child.
Delivery shape
[Subagent message from session-…]
This is a peer message from a delegated child, not the human user. Treat it as a task update.
---
<your message>
subagent_parent_message uses agent.followup(message) (or agent.steer) + ctx.sessions.flush(agent.session); subagent_send_message delegates to ctx.subagents.sendMessage().
Limits
subagent_parent_message: direct parent only, no attachments, no team mailbox; parent must be live or resumable.subagent_send_message: only direct parent/child with a resident continuable activation; it does not replace team send_message for teammates.- Neither tool waits for the other side's answer; one call is one message.
- For file attachments use
dsh-cross-session; for teammates use agent_teams_send_message.
Install
Requires DSH 0.2.x.
dsh plugin --profile <profile> add C:\path\to\dsh-subagent-parent-message-0.1.2.tgz
# or
dsh plugin --profile <profile> add https://codeload.github.com/zhyunran/dsh-subagent-parent-message/tar.gz/<40-char-commit>
Restart DSH once after install; both tools are global and visible to subagents.
Status
- 7 unit tests (
node --test test/*.test.mjs): live parent, cold resume, steer, missing parent, empty message, subagent_send_message delegation, missing service.
- Real
dsh-tools schema compile for both tools.
- Live verified:
subagent child → parent via core send_message; workflow one-shot child → parent via subagent_parent_message (followup and steer).
- No runtime dependencies; peer-depends only on
@deepseek-ai/dsh-tools.
License
MIT. See LICENSE.
Built for DeepSeek Harness.
