team-task — long-horizon multi-agent tasks for DeepSeek Harness
  !DeepSeek Harness plugin
A DeepSeek Harness (dsh) plugin: a lead session plans a reviewed DAG, durable members execute its nodes, and a resident reconciler keeps the task moving — across model failures, interrupted turns, and harness restarts.
Built for goals that take hours, not turns.
Why
Team plugins optimized for short bursts fail on long tasks in predictable ways. team-task's answers, in one table:
| Long-task failure | team-task answer |
|---|---|
| A member finishes but never calls the completion tool | Runtime-owned settlement: the run settles at its idle edge regardless; tools accelerate, never gate |
| The lead session goes offline mid-task | Resident reconciler re-kicks every task on a timer; work resumes the moment the lead returns |
| An early hallucination poisons downstream work | Review gate: only lead approve unlocks dependents; rework sends feedback back to the same node, attempts are first-class history |
| A reassigned worker writes a late result | Fence tokens on an append-only event log; stale fences are rejected at the log, not by etiquette |
| Crashed process, lost wake-ups, stranded messages | The event log is the only truth; delivery is the scheduler's job and is retried at every kick |
| Protocol prompt tax in every request | Progressive playbooks: ~8-line resident trigger; lead/member protocols load on demand via team_task_playbook |
Full rationale, axioms, state machine, and the event-log-native board design: [docs/design.md](docs/design.md).
Quick start
Prerequisites: Node ^22.19 || >=24 (Node 23 fails to boot dsh).
1. Install dsh (skip if you have it):
npm i -g @deepseek-ai/dsh2. Add the plugin — pick one:
# npm (recommended)
dsh plugin --profile web add @ready22race/dsh-team-task
# straight from GitHub (the repo ships its build output — no build step)
dsh plugin --profile web add github:Ready22Race/dsh-team-task
# from source (contributors; installs as a link to your checkout)
git clone https://github.com/Ready22Race/dsh-team-task.git
cd dsh-team-task && pnpm install && pnpm build
dsh plugin --profile web add .3. Verify the composition (expect an id: team-task row):
dsh --profile web --dump-config4. Start dsh (a restart is required after plugin add — the bundle list is cached in-process):
dsh web5. First run — open http://127.0.0.1:3080, set a model key (Settings → Models) and pick a workspace, then send:
> 用 team-task 跑一个长任务：先加载 lead playbook，规划一张带依赖和 > 预指派（assignee）的节点图，逐节点评审，最后合并交付。
You should see: a task card in the conversation, the board floater on the right (segments / filters / node cards / inspector), and <workspace>/.team-task/tasks/<id>/log.jsonl on disk. Pre-assigned nodes auto-flow when their dependencies approve; everything else waits for your explicit dispatch or review.
Tools
| Tool | Who | What |
|---|---|---|
team_task_playbook | anyone | Load the lead / member / recovery protocol on demand |
team_task_create | lead | Create the task (+ optional initial plan DAG) |
team_task_add_member | lead | Spawn a durable member with a role profile (provider/model/effort/playbook; omitted fields inherit the lead's route) |
team_task_plan | lead | Add / update / cancel plan nodes |
team_task_dispatch | lead | Dispatch a node (fence++), to a member, the shared pool, or the lead itself |
team_task_await | lead | Block until review work exists or all nodes settle — instead of polling |
team_task_complete | assignee | Claim completion with the current fence + a self-contained output |
team_task_review | lead | approve (unlocks dependents) or rework (feedback required, carried into the next attempt) |
team_task_send | anyone | Durable message to lead or teammate; scheduler delivers |
team_task_status | anyone | Snapshot: nodes, runs, fences, member activity, attention list, your inbox |
team_task_finish | lead | Close and archive (full event history and every run retained) |
Storage
<workspace>/.team-task/
└── tasks/ # the task list, chronologically sorted
└── 20260816-2145-竞品分析示例任务/ # id = created-at stamp + name slug (CJK kept)
├── log.jsonl # append-only event log — the ONLY truth
├── snapshot.json # latest projection (team situation + nodes + seq); derived
└── inbox/
├── lead.jsonl # per-recipient mailbox mirror; derived, human-readable
└── <member>.jsonllog.jsonl is the single source of truth; every surface (tools, board routes, offline verify) folds the same events, and any historical "team situation at time T" is a replay of the log prefix. snapshot.json and inbox/ are write-through derived views for humans — safe to read, never written by hand, and never read back by the code.
Configuration
- id: team-task
config:
stateDir: .team-task
memberProvider: spawn # subagent runtime backend, not an LLM provider
memberMaxDepth: 1
maxMembers: 8
reconcileIntervalMs: 30000Development
pnpm install
pnpm build
pnpm verify # offline: fences, review gate, rework, settlement, replay determinismReleasing (maintainers)
The repo commits lib/ so github: installs need no build step — always publish from a clean pnpm build (the css-module hashes are repo-relative, so the output is machine-independent).
npm login # account must own the @ready22race scope
npm publish --otp=<2FA code> # prepublishOnly runs build + verify firstWith 2FA enabled, npm publish alone returns 403 — pass --otp, or create a granular access token with "bypass 2FA" scoped to this package and put it in ~/.npmrc for tokenized publishes. After publishing, tag the release:
gh release create vX.Y.Z --title "dsh-team-task X.Y.Z" --generate-notesStatus & roadmap
- M1 (this release) — host plugin end-to-end: tools, event log, fences,
scheduler + reconciler, runtime settlement, review/rework, playbooks, board data routes (/plugins/team-task/state, /plugins/team-task/log).
- M2 — the event-log-native board UI (kanban lanes + DAG overlay +
attention strip + per-node run timeline + replay slider; design.md §6).
- M3 — consumption-acked delivery and parentless member wake (needs
upstream seams; tracked in design.md §7), npm publish, per-run cost accounting.
Known limits (v0.1): member wake-ups still require the live lead Agent (an upstream followup constraint — the reconciler resumes work when the lead returns); message_delivered marks inbox acceptance, not turn consumption.
中文速览
team-task 是面向长任务的 dsh 多智能体插件：lead 规划一张需评审的 DAG，durable member 执行节点，常驻 reconciler 保证崩溃/重启后任务继续。
核心主张（详见 [docs/design.md](docs/design.md)）：
1. 事件日志是唯一真相 —— 状态是 log.jsonl 的纯投影，看板/工具/验证 折叠同一份事件，重放即历史。 2. 进度归运行时，表达归模型 —— 成员不调完成工具也会在 idle 边被结算； 工具只是加速，不是闸门。 3. fence 即运行权 —— 每次派发递增 fence，旧 fence 的迟到写入在日志层 被拒；停止 = 撤销 fence，不是发消息。 4. 投递归调度器 —— 消息先落日志（立即安全），调度器在 idle 边 / 定时 sweep 时投递；没有"队长在线才能通信"。 5. 评审是默认闸门 —— 只有 lead approve 才解锁下游；rework 必须带 反馈，原节点重派、attempt 历史完整保留；机械节点可声明 auto_approve 走快速档。 6. 渐进式 playbook —— 常驻 prompt 只有 ~8 行触发器，完整协议按角色 （lead / member / recovery）用 team_task_playbook 按需加载。
License
[MIT](LICENSE)