Yichen Jiang
eab0aeb9db
The task registry has run every background bash, pwsh, pty-send, and one-shot subagent since it landed, but only the model could read it: a human at the Web client could not see that a build was running, tell a finished task from a stuck one, or find its outcome anywhere but the `run_in_background` tool card that printed an id and never updated. Task state now reaches the browser as one whole-snapshot `session/tasks` mux frame per session, pushed at every registry commit that changes what that session can see. `TaskService` gains `onTasksChanged`, which is owner-granular because owner-disposal removal is a change no per-task record can express. The carrier reads the exact owner the listener hands it, so a push stays correct while that scope tears down, and reads the baseline through the non-resuming `ctx.agents.get` so listing never revives a cold session. The client keeps a last-wins mirror on `SessionListState`, and a new `dsh-client-ui-task` package renders it beside the subagent catalog — rendering nothing at all until the session has a task, so an ordinary conversation grows no new chrome. Streamed per-task output and human-initiated cancellation are separate phases; the note records why neither has to undo this channel, and why no Web path may call the consuming `ctx.tasks.read()`.
3.1 KiB
@deepseek-ai/dsh-client-ui-task
English | 中文
Web 后台任务特性的归属方：向 conversation.session.header.actions 贡献一个条目，列出当前会话可见的 ctx.tasks 记录。数据完全来自 dsh-client-runtime 从 session/tasks 帧折叠出的 tasksBySession 列表镜像，因此本包不发任何 RPC，除弹层开合外不持有任何状态。
只有当会话至少有一个任务时才渲染触发器，普通对话不会因为一项未被使用的能力而长出控件。角标计数为 running 加 stopping，为零时省略，这样只剩已完成任务的会话保留一个安静的历史入口，而不是宣告一个「零」。弹层是一个扁平列表：活跃行在前按 startedAt 升序，随后终态行按 finishedAt 降序；毫秒相同的并列按启动顺序打破，宿主的 map 迭代顺序永远不参与决定。一行显示生产者 kind、label、状态标记、生产者一旦给出 detail 就取代通用状态词的那段文字，以及已耗时。该耗时在活跃时每秒推进，并在 finishedAt 冻结；只有当打开的列表里确实有会动的东西时时钟才运行。缺少 finishedAt 的终态行读作零而不是负数，超过一小时的耗时停留在小时单位，不会长出任何生产者目前都到不了的「天」词汇。
终态行保持可见并弱化，直到注册表在 owner 销毁时把它们丢掉。它们本就在快照里，失败任务的 detail 是其失败唯一可读之处，在这里过滤掉它们是输出与中断两期要推翻的工作。因此一个运行中的一次性后台 subagent 会同时出现在这里和 subagent 目录里：目录负责进入子会话的 transcript，而这个列表是将来中断能力唯一可能附着的句柄。
Escape 关闭列表并把焦点交还触发器，在其外部按下指针同理。最后一个任务消失时先关闭列表再卸载控件，焦点因此不会从一个被移除的节点上凭空消失。样式只用 token；文案走本包自己的 task locale 命名空间。行为由 Web 后台任务展示 Agent Note 规定。
Model Experience
无，因为本包为人类渲染宿主计算出的注册表状态，不触及 prompt、消息、schema、流或工具结果。模型对同一批任务的视角仍属于 dsh-tool-tasks。
KV Cache effect
无；本包从不组装或发送 provider 请求。
Known Limitations and Deferred Work
- 行是只读的 —— 任务的流式输出与人类发起的中断是各自独立的阶段。中断还额外欠一个 seam 目前没有回答的、面向模型的决策：
kill()会把终态投递标为已上报，所以照当前契约写出来的中断会让模型一直以为它的任务还在跑。 - 列表不等于注册表自己的集合 —— 它展示的是拥有它的会话通过线路视图能看到的东西，因此一个无主任务（在没有活体
Agent时启动的任务）在这里不可见，而task_list仍会把它报告给模型。