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()`.
37 lines
1.4 KiB
TypeScript
37 lines
1.4 KiB
TypeScript
/**
|
|
* Browser-safe background-task domain contract. The registry's live records
|
|
* never cross the wire; a view is the subset a human list needs, minted fresh
|
|
* per push.
|
|
*/
|
|
|
|
import type { TaskId } from '@deepseek-ai/dsh-tasks/brand'
|
|
|
|
/**
|
|
* One background task as the client sees it.
|
|
*
|
|
* Three registry fields are deliberately absent. `ownerSession` is redundant
|
|
* beside the frame's own `sessionId`; `reported` is an internal notice-delivery
|
|
* bit with no user meaning; `outputLimitBytes` is producer-owned model
|
|
* presentation policy that never reaches a human surface.
|
|
*/
|
|
export interface TaskView {
|
|
/** Registry-issued `<kind>-N` identity, stable for the task's whole life. */
|
|
id: TaskId
|
|
/**
|
|
* Producer kind (`bash`, `pwsh`, `pty-send`, `subagent`, …). Kept as a bare
|
|
* string because producer plugins extend the kind map by declaration merging,
|
|
* so no client build can enumerate the closed set.
|
|
*/
|
|
kind: string
|
|
/** Producer-supplied one-line label: the command, or the delegation description. */
|
|
label: string
|
|
/** Current lifecycle state. */
|
|
status: 'running' | 'stopping' | 'completed' | 'killed' | 'failed'
|
|
/** Kind-specific status detail ('exit code: 3'), present once the producer supplied one. */
|
|
detail?: string
|
|
/** Epoch ms when the task was registered. */
|
|
startedAt: number
|
|
/** Epoch ms when the task settled; absent while live. */
|
|
finishedAt?: number
|
|
}
|