@deepseek-harness-tui/dsh-tui 0.13.0 → 0.14.0

package/lib/types/dsh-adapter/channel/state.d.ts

@@ -1,9 +1,18 @@
 import type { AgentHandle } from '@deepseek-ai/dsh-agent';
+import type { OpenTarget, SessionCatalog } from '../../agent/backend.js';
+import type { AgentEvent } from '../../agent/events.js';
+import type { AgentSession } from '../../agent/session.js';
+import type { PermissionStore } from '../../channel/permissions.js';
+import type { QuestionStoreLike } from '../../channel/questions.js';
 import type { ContextPressureSource } from '../context-occupancy.js';
+import type { ActivityView } from '../activity-store.js';
 import type { SessionModeSpec } from '../../sessionModes.js';
 import { type JobGroupFoldMode, type PageMarginSetting, type ScrollGutterMode, type StatusBarConfig, type ToolBackground } from '../../tuiDisplayPrefs.js';
 import { type SplashFontSetting } from '../../components/splashFonts.js';
+import { type BrandSetting } from '../../branding.js';
 import type { ChannelState } from './types.js';
+/** The DSH backend's user-facing name (capability snapshot default). */
+export declare const DSH_BACKEND_LABEL = "DSH";
 /** Launch configuration belongs to channel construction, not the composition root. */
 export interface ChannelLaunchOptions {
     model: string;
@@ -15,6 +24,15 @@ export interface ChannelLaunchOptions {
      *  projection value only arrives on change, so a resumed session needs this
      *  read to render its line before the next event lands. */
     seedActivity?: (session: unknown) => void;
+    /** Land one backend-authored working-activity value for the bound session
+     *  (the Claude backend's counterpart of the projection feed: the session's
+     *  `workingActivity` capability, wired per binding in
+     *  `channel/session-activity.ts`). Values are narrowed (`asActivityView`)
+     *  before this is called; absent → the capability is not consumed. */
+    publishActivity?: (sessionId: string, view: ActivityView) => void;
+    /** Drop the bound session's backend-authored working-activity value (its
+     *  session went away: the next binding, or the channel's release). */
+    clearActivity?: (sessionId: string) => void;
     /**
      * Official context-occupancy source (see `dsh-adapter/context-occupancy.ts`).
      *
@@ -43,6 +61,7 @@ export interface ChannelLaunchOptions {
     scrollGutter?: ScrollGutterMode;
     pageMargin?: PageMarginSetting;
     foldTerminalCommand?: boolean;
+    turnUsageRow?: boolean;
     promptSessionLabel?: boolean;
     expandEditor?: boolean;
     smoothStreaming?: boolean;
@@ -52,6 +71,9 @@ export interface ChannelLaunchOptions {
     /** Big-text face (settings `dsh-tui.splashFont`); absent → `daily`, the
      *  date rotation. Junk normalizes to `daily` (see `normalizeSplashFont`). */
     splashFont?: SplashFontSetting;
+    /** Brand look (settings `dsh-tui.brand`); absent → `auto` (follow the
+     *  active backend). Junk normalizes to `auto` (see `normalizeBrandSetting`). */
+    brand?: BrandSetting;
     /** Maid portrait for the header splash (settings `dsh-tui.whaleGirl`;
      * off by default). */
     whaleGirl?: boolean;
@@ -66,6 +88,55 @@ export interface ChannelLaunchOptions {
     configuredActivityFrames?: string;
     agentPreset?: string;
     modes?: readonly SessionModeSpec[];
+    /** User-facing name of the backend serving the session (capability
+     *  snapshot, `cmd-unavailable-backend`); absent → the DSH label. */
+    backendLabel?: string;
+    /**
+     * Open a session of the bound session's own backend: a fresh one (`/new`
+     * on a non-DSH session) or a persisted one (`/resume`, the session
+     * browser, a conversation rewind's fork). Absent → those are unavailable
+     * there. DSH sessions keep their own resume/new orchestration and ignore
+     * it.
+     */
+    openSession?: (target: Extract<OpenTarget, {
+        readonly kind: 'create' | 'resume';
+    }>) => Promise<AgentSession>;
+    /**
+     * The backend's offline session catalog: the session browser's
+     * listing, preview, rename and delete for a non-DSH session.
+     * With `openSession` it enables `/resume`. DSH sessions ignore it.
+     */
+    sessionCatalog?: SessionCatalog;
+    /**
+     * The backend's session preferences (TUI-side notes only, never the
+     * transcripts): the MRU note of each use, the launcher's
+     * last-session marker, and forgetting a deleted session.
+     */
+    sessionPrefs?: {
+        touch(sessionId: string): void;
+        setLastSession(sessionId: string): void;
+        forget(sessionId: string): void;
+    };
+    /** The startup session's durable history, read before construction so
+     *  the first bind paints it ahead of any live event. */
+    initialHistory?: readonly AgentEvent[];
+    /** How a user re-enters a session of this backend from a shell (the
+     *  `/fork` notice); absent → the in-TUI `/resume` hint. */
+    resumeCommand?: (sessionId: string) => string;
+    /**
+     * The stores a non-DSH session's prompts park in: its
+     * `permission.request` events go to `permissions` (the panel Chat renders
+     * for this channel), its `question.request` events to `questions`. Absent →
+     * such events are dropped (a backend that declares no prompt capability).
+     * DSH sessions answer through their own seams and ignore it.
+     */
+    interaction?: {
+        readonly permissions: PermissionStore;
+        readonly questions: QuestionStoreLike;
+    };
+    /** Lifetime handle of the agent when `createChannel` receives a raw DSH
+     *  agent (direct embedders, fixtures); a passed `AgentSession` carries its
+     *  own and this is ignored. */
     handle?: AgentHandle;
 }
 /**
@@ -78,5 +149,5 @@ export declare function createInitialChannelView(options: ChannelLaunchOptions,
     sessionId: string;
     mode: ChannelState['mode'];
     cwdDescription: string;
-}): Pick<ChannelState, 'effortLevels' | 'version' | 'rows' | 'status' | 'sessionTitle' | 'sessionColor' | 'agentId' | 'sessionId' | 'agentBindingGeneration' | 'model' | 'provider' | 'tokens' | 'cwd' | 'displayCwd' | 'gitBranch' | 'working' | 'compaction' | 'cancelPending' | 'spinnerMode' | 'responseChars' | 'activeToolCount' | 'turnStart' | 'lastUserText' | 'notifications' | 'contextWindow' | 'reasoningEffort' | 'mode' | 'modeIndex' | 'activityFrames' | 'configuredProvider' | 'configuredModel' | 'configuredPreset' | 'configuredActivityFrames' | 'configuredLang' | 'diffLayout' | 'thinkingFold' | 'jobGroupFold' | 'toolBackground' | 'scrollGutter' | 'pageMargin' | 'foldTerminalCommand' | 'promptSessionLabel' | 'expandEditor' | 'smoothStreaming' | 'statusBar' | 'whale' | 'whaleIdle' | 'splashFont' | 'minimalUi' | 'activityEnabled' | 'contextBarEnabled' | 'statusBar' | 'whale' | 'whaleIdle' | 'whaleGirl' | 'minimalUi' | 'activityEnabled' | 'contextBarEnabled' | 'agentPreset' | 'goal' | 'todos' | 'loadedContext' | 'pending' | 'commandList' | 'lastUsage' | 'tps' | 'tpsSamples' | 'contextSegments' | 'mainCost' | 'subagentCost' | 'subagents' | 'backgroundJobs' | 'selection'>;
+}): Pick<ChannelState, 'effortLevels' | 'version' | 'rows' | 'status' | 'sessionTitle' | 'sessionColor' | 'agentId' | 'sessionId' | 'agentBindingGeneration' | 'model' | 'modelDisplay' | 'provider' | 'tokens' | 'cwd' | 'displayCwd' | 'gitBranch' | 'working' | 'compaction' | 'cancelPending' | 'spinnerMode' | 'responseChars' | 'activeToolCount' | 'turnStart' | 'lastUserText' | 'notifications' | 'contextWindow' | 'reasoningEffort' | 'mode' | 'modeIndex' | 'activityFrames' | 'configuredProvider' | 'configuredModel' | 'configuredPreset' | 'configuredActivityFrames' | 'configuredLang' | 'diffLayout' | 'thinkingFold' | 'jobGroupFold' | 'toolBackground' | 'scrollGutter' | 'pageMargin' | 'foldTerminalCommand' | 'turnUsageRow' | 'promptSessionLabel' | 'expandEditor' | 'smoothStreaming' | 'statusBar' | 'whale' | 'whaleIdle' | 'splashFont' | 'brand' | 'minimalUi' | 'activityEnabled' | 'contextBarEnabled' | 'statusBar' | 'whale' | 'whaleIdle' | 'whaleGirl' | 'minimalUi' | 'activityEnabled' | 'contextBarEnabled' | 'agentPreset' | 'goal' | 'todos' | 'loadedContext' | 'pending' | 'commandList' | 'lastUsage' | 'turnUsage' | 'tps' | 'tpsSamples' | 'contextSegments' | 'mainCost' | 'subagentCost' | 'subagents' | 'backgroundJobs' | 'selection'>;
 //# sourceMappingURL=state.d.ts.map

package/lib/types/dsh-adapter/channel/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAkH,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAE1Q,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAC7F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,sFAAsF;AACtF,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;+DAE2D;IAC3D,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IACzC;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,qBAAqB,CAAA;IACvC;yDACqD;IACrD,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IACjD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;uEAImE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;IACzC,YAAY,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACjC,YAAY,CAAC,EAAE,gBAAgB,CAAA;IAC/B,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,YAAY,CAAC,EAAE,gBAAgB,CAAA;IAC/B,UAAU,CAAC,EAAE,iBAAiB,CAAA;IAC9B,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAA;IACpC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;iFAC6E;IAC7E,UAAU,CAAC,EAAE,iBAAiB,CAAA;IAC9B;0BACsB;IACtB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;6EACyE;IACzE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;IAClC,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,oBAAoB,EAC7B,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAChG,IAAI,CAAC,YAAY,EAClB,cAAc,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,cAAc,GAAG,cAAc,GAChF,SAAS,GAAG,WAAW,GAAG,wBAAwB,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,KAAK,GAC5F,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,eAAe,GAAG,aAAa,GACvF,eAAe,GAAG,iBAAiB,GAAG,WAAW,GAAG,cAAc,GAClE,eAAe,GAAG,eAAe,GAAG,iBAAiB,GAAG,MAAM,GAAG,WAAW,GAC5E,gBAAgB,GAAG,oBAAoB,GAAG,iBAAiB,GAC3D,kBAAkB,GAAG,0BAA0B,GAAG,gBAAgB,GAAG,YAAY,GACjF,cAAc,GAAG,cAAc,GAAG,gBAAgB,GAAG,cAAc,GAAG,YAAY,GAClF,qBAAqB,GAAG,oBAAoB,GAAG,cAAc,GAAG,iBAAiB,GACjF,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,iBAAiB,GAAG,mBAAmB,GAC1G,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,iBAAiB,GAAG,mBAAmB,GACzG,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,eAAe,GAAG,SAAS,GAAG,aAAa,GAC9E,WAAW,GAAG,KAAK,GAAG,YAAY,GAAG,iBAAiB,GAAG,UAAU,GAAG,cAAc,GAAG,WAAW,GAAG,gBAAgB,GAAG,WAAW,CACpI,CA4BA"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/state.ts"],"names":[],"mappings":"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"}

package/lib/types/dsh-adapter/channel/state.js

@@ -1,6 +1,9 @@
 import { normalizeJobGroupFold, normalizePageMargin, normalizeScrollGutter, normalizeStatusBar, normalizeToolBackground } from '../../tuiDisplayPrefs.js';
 import { normalizeActivityPreset } from '../../components/activityFrames.js';
 import { normalizeSplashFont } from '../../components/splashFonts.js';
+import { normalizeBrandSetting } from '../../branding.js';
+/** The DSH backend's user-facing name (capability snapshot default). */
+export const DSH_BACKEND_LABEL = 'DSH';
 /**
  * Neutral observable fields only. Behaviour is assembled explicitly by the
  * composition root after each specialist owner exists, so this factory cannot
@@ -9,7 +12,7 @@ import { normalizeSplashFont } from '../../components/splashFonts.js';
 export function createInitialChannelView(options, input) {
     return {
         effortLevels: undefined, version: 0, rows: [], selection: undefined, status: 'starting', sessionTitle: '', sessionColor: '',
-        agentId: input.agentId, sessionId: input.sessionId, agentBindingGeneration: 0, model: options.model, provider: options.provider,
+        agentId: input.agentId, sessionId: input.sessionId, agentBindingGeneration: 0, model: options.model, modelDisplay: undefined, provider: options.provider,
         tokens: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, peak: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, idle: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 } },
         cwd: options.cwd, displayCwd: input.cwdDescription, gitBranch: undefined, working: false,
         compaction: undefined,
@@ -23,11 +26,12 @@ export function createInitialChannelView(options, input) {
         jobGroupFold: normalizeJobGroupFold(options.jobGroupFold),
         toolBackground: normalizeToolBackground(options.toolBackground), scrollGutter: normalizeScrollGutter(options.scrollGutter),
         pageMargin: normalizePageMargin(options.pageMargin), foldTerminalCommand: options.foldTerminalCommand === true,
+        turnUsageRow: options.turnUsageRow === true,
         promptSessionLabel: options.promptSessionLabel === true, expandEditor: options.expandEditor !== false,
         smoothStreaming: options.smoothStreaming !== false, statusBar: normalizeStatusBar(options.statusBar),
-        whale: options.whale !== false, whaleIdle: options.whaleIdle !== false, whaleGirl: options.whaleGirl === true, splashFont: normalizeSplashFont(options.splashFont), minimalUi: options.minimalUi === true, activityEnabled: options.activity !== false,
+        whale: options.whale !== false, whaleIdle: options.whaleIdle !== false, whaleGirl: options.whaleGirl === true, splashFont: normalizeSplashFont(options.splashFont), brand: normalizeBrandSetting(options.brand), minimalUi: options.minimalUi === true, activityEnabled: options.activity !== false,
         contextBarEnabled: options.contextBar !== false, agentPreset: options.agentPreset, goal: undefined,
-        todos: [], loadedContext: undefined, pending: [], commandList: [], lastUsage: undefined,
+        todos: [], loadedContext: undefined, pending: [], commandList: [], lastUsage: undefined, turnUsage: undefined,
         tps: undefined, tpsSamples: [], contextSegments: { system: 0, prompt: 0, assistant: 0, thinking: 0, tools: 0 },
         // 费用估算输入：主会话按模型分桶 + 子代理快照。与 tokens 并行累计，
         // tokens 的既有语义/显示不变（DESIGN D2）。

package/lib/types/dsh-adapter/channel/subagent-projection.d.ts

@@ -1,15 +1,51 @@
 import type { Agent, AssistantStreamFrame } from '@deepseek-ai/dsh-agent';
 import { SubagentActivityStore } from '../subagents.js';
+import type { SubagentTranscriptPage, SubagentTranscriptWindow } from '../../agent/capabilities.js';
+import type { AgentIdentity, AgentMessageSubmitInput, AgentMessageSubmitResult, AgentMessageView } from '../../adapter/ports/channel-view.js';
 import type { ChannelState } from './types.js';
 type ProjectionState = Pick<ChannelState, 'rows' | 'subagents' | 'subagentCost' | 'emit' | 'emitStream'>;
+/**
+ * Structural view of the host `ctx.subagents` continuation service
+ * (@deepseek-ai/dsh-subagent's SubagentRuntime) as this projection uses it.
+ * Reached by an optional service lookup, so every member is optional and
+ * the capability is the method's presence. Nothing here bypasses the
+ * continuation manager: `prompt` goes through its exact-parent authority,
+ * cold resume and inbox admission, `interrupt` through its authority check.
+ */
+export interface SubagentsServiceView {
+    interrupt?(target: string, reason: unknown): void;
+    /** Browser-authored prompt to a direct continuable child: resolves with
+     *  the accepted message's inbox id. */
+    prompt?(request: {
+        readonly requestId: string;
+        readonly parentSessionId: string;
+        readonly childSessionId: string;
+        readonly mode: 'continuable';
+        readonly delivery: 'queue' | 'steer';
+        readonly content: readonly {
+            readonly type: 'text';
+            readonly text: string;
+        }[];
+    }, signal: AbortSignal): Promise<{
+        readonly messageId: string;
+    }>;
+    /** Durable direct-child catalog read; no Agent is loaded, so the rows
+     *  carry no liveness guarantee. */
+    listChildren?(parentSessionId: string, signal?: AbortSignal): Promise<readonly SubagentCatalogEntryView[]>;
+}
+/** One `listChildren` catalog row (SubagentCatalogEntry, structural). */
+export interface SubagentCatalogEntryView {
+    readonly id: string;
+    readonly createdAt: number;
+    readonly mode: 'one-shot' | 'continuable' | 'unknown';
+    readonly label?: string;
+}
 interface ProjectionDependencies {
     rowIds: {
         value: number;
     };
     agent(): Agent;
-    subagents(): {
-        interrupt?(target: string, reason: unknown): void;
-    } | undefined;
+    subagents(): SubagentsServiceView | undefined;
     /** Optional child metadata lookup; failures must not suppress spawning. */
     lookupChild(id: string): {
         status?: string;
@@ -19,6 +55,17 @@ interface ProjectionDependencies {
             model?: string;
         };
     } | undefined;
+    /** Aborted when the channel owner releases: cancels a prompt that has not
+     *  been accepted yet (an accepted child inbox belongs to the continuation
+     *  manager from then on). */
+    ownerSignal?: AbortSignal;
+    /** The DSH child transcript source (docs/dsh-child-transcript.md),
+     *  injected only when the host composition serves session persistence.
+     *  Its presence is the `SubagentControl.history` capability: the shared
+     *  transcript tab renders exactly when it exists, with no backend-specific
+     *  UI. The reader re-captures parent identity, binding generation and
+     *  child ownership on every call, so a plain pass-through is fence-safe. */
+    readChildTranscript?: (agentId: string, window?: SubagentTranscriptWindow) => Promise<SubagentTranscriptPage | null>;
 }
 /**
  * Keep each parked parent's reducer alive, including session links and the
@@ -29,6 +76,14 @@ export declare function createSubagentProjection(getState: () => ProjectionState
     readonly store: SubagentActivityStore;
     readonly pendingTaskDescriptions: string[];
     control: {
+        message: {
+            via: "direct-continuable";
+            steer: true;
+            listTargets: () => Promise<readonly AgentIdentity[]>;
+            submit: (input: AgentMessageSubmitInput) => Promise<AgentMessageSubmitResult>;
+            messages: () => AgentMessageView[];
+        };
+        history?: ((agentId: string, window?: SubagentTranscriptWindow) => Promise<SubagentTranscriptPage | null>) | undefined;
         interrupt: (id: string) => boolean;
     };
     onSessionEvent(session: unknown, event: {

package/lib/types/dsh-adapter/channel/subagent-projection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-projection.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/subagent-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAEzE,OAAO,EAAE,qBAAqB,EAAsB,MAAM,iBAAiB,CAAA;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAyC,MAAM,YAAY,CAAA;AAGrF,KAAK,eAAe,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,GAAG,cAAc,GAAG,MAAM,GAAG,YAAY,CAAC,CAAA;AACxG,UAAU,sBAAsB;IAC9B,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACzB,KAAK,IAAI,KAAK,CAAA;IACd,SAAS,IAAI;QAAE,SAAS,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,GAAG,SAAS,CAAA;IAC9E,2EAA2E;IAC3E,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAAG,SAAS,CAAA;CAC7H;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,eAAe,EAAE,IAAI,EAAE,sBAAsB;;;;wBAuDvE,MAAM;;4BACT,OAAO,SAAS;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;yBAe9C,OAAO,SAAS,oBAAoB,GAAG,OAAO;kBAIrD,UAAU,QA0OH;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,KAAG,IAAI,CA1O9C,CAAC,CAAC,CAAC,WAAW,MAAM,GAAG,IAAI;gBAC9D,UAAU,QA+PH;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,oBAAoB,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,KAAG,IAAI,CA/PnE,CAAC,CAAC,CAAC,WAAW,MAAM,GAAG,IAAI;2BAC/C,OAAO;6BACL,SAAS,OAAO,EAAE;;;;kBA5CxB,KAAK,KAAG,IAAI;qBAIT,KAAK,KAAG,IAAI;kBAkDpB,KAAK;;;EAItB"}
+{"version":3,"file":"subagent-projection.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/subagent-projection.ts"],"names":[],"mappings":"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"}

package/lib/types/dsh-adapter/channel/subagent-projection.js

@@ -1,4 +1,6 @@
+import { randomUUID } from 'node:crypto';
 import { markChannelReadDirty } from '../../adapter/channel/read-view.js';
+import { agentMessageFailureOf, agentMessageTextOf, agentRelaySourceOf, foldAgentMessage } from '../../agent/messages.js';
 import { SubagentActivityStore } from '../subagents.js';
 import { isSubagentToolName } from './projection-helpers.js';
 /**
@@ -44,6 +46,11 @@ export function createSubagentProjection(getState, deps) {
         // Transport passes null for an unkeyed event; never guess its ownership.
         return parent === undefined ? active : undefined;
     };
+    /** DSH Session id of a bus carrier session, when it carries one. */
+    const sessionIdOf = (session) => {
+        const id = session?.id;
+        return typeof id === 'string' ? id : undefined;
+    };
     const park = (agent) => {
         active.dropRows();
         parked.set(agent, active);
@@ -70,19 +77,58 @@ export function createSubagentProjection(getState, deps) {
                 active.store.patch(saved.agentId, { status: 'unknown' });
         }
     };
+    /**
+     * The addressable roster: the parent's durable direct-child catalog,
+     * filtered to continuable children only. One-shot, unknown-mode and
+     * diagnostic rows are not addressable (fail closed), and a missing
+     * continuation service rejects instead of answering an empty roster.
+     */
+    const listTargets = async () => {
+        const service = deps.subagents();
+        if (service?.listChildren === undefined)
+            throw new Error('dsh-tui: the subagents continuation service is unavailable');
+        const entries = await service.listChildren(String(deps.agent().session.id));
+        return entries
+            .filter(entry => entry.mode === 'continuable')
+            .map(entry => {
+            const status = active.store.get(entry.id)?.status;
+            return {
+                agentId: entry.id,
+                sessionId: entry.id,
+                ...(entry.label === undefined ? {} : { label: entry.label }),
+                mode: 'continuable',
+                ...(status === undefined ? {} : { status }),
+            };
+        });
+    };
     return {
         get store() { return active.store; },
         get pendingTaskDescriptions() { return active.pendingTaskDescriptions; },
-        control: { interrupt: (id) => active.control.interrupt(id) },
+        control: {
+            interrupt: (id) => active.control.interrupt(id),
+            // The shared transcript page source: the capability exists exactly
+            // when the injected reader does.
+            ...(deps.readChildTranscript === undefined ? {} : { history: deps.readChildTranscript }),
+            message: {
+                via: 'direct-continuable',
+                // The prompt control plane takes both deliveries natively; the
+                // composer shows steer for Ctrl+Enter only because this says so.
+                steer: true,
+                listTargets,
+                submit: input => active.submitPrompt(input),
+                messages: () => [...active.agentMessages],
+            },
+        },
         onSessionEvent(session, event) {
             let handled = false;
+            const parentId = sessionIdOf(session);
             if (session === activeParent.session) {
-                active.onParentEvent(event);
+                active.onParentEvent(event, false, parentId);
                 handled = true;
             }
             for (const [parent, projection] of parked) {
                 if (session === parent.session) {
-                    projection.onParentEvent(event);
+                    projection.onParentEvent(event, false, parentId);
                     handled = true;
                 }
                 if (projection.onSessionEvent(session, event))
@@ -103,7 +149,7 @@ export function createSubagentProjection(getState, deps) {
             // Live parked reducers already consumed this log. Re-folding historical
             // workflow edges would overwrite the current epoch and its settlement.
             if (!restored)
-                active.bootstrapFromLog(events);
+                active.bootstrapFromLog(events, sessionIdOf(activeParent.session));
             else
                 active.syncNow();
         },
@@ -137,6 +183,9 @@ export function createSubagentProjection(getState, deps) {
  * replayed transcript with cards that the durable log never contained. */
 function createSessionSubagentProjection(getState, deps) {
     const store = new SubagentActivityStore();
+    /** Observed agent↔agent relay facts and prompt receipts of this parent,
+     *  oldest first, folded by durable message id. */
+    const agentMessages = [];
     const rowsByAgentId = new Map();
     const pendingTaskDescriptions = [];
     /** Workflow member identity: `tool-workflow/agent-end` carries no childId,
@@ -190,12 +239,37 @@ function createSessionSubagentProjection(getState, deps) {
         syncNow();
         return true;
     };
+    /** A relay delivered into a tracked child: the durable
+     *  AgentMessageSource names the sending session, the receiving side is
+     *  this child. An admitted relay is 'queued', since nothing stronger is
+     *  provable from the log alone; a plain user/message (no relay source)
+     *  never becomes one. */
+    const noteChildRelay = (childId, event) => {
+        const data = event.data;
+        if (data === undefined || typeof data.id !== 'string' || data.id === '')
+            return;
+        const relay = agentRelaySourceOf(data.source);
+        if (relay === undefined)
+            return;
+        foldAgentMessage(agentMessages, {
+            messageId: data.id,
+            from: relay.senderSessionId,
+            to: childId,
+            via: 'agent-relay',
+            text: agentMessageTextOf(data.content),
+            state: 'queued',
+            ...(typeof event.seq === 'number' ? { sourceRef: `seq:${event.seq}` } : {}),
+            observedAt: eventTime(event) ?? Date.now(),
+        });
+    };
     const onSessionEvent = (session, event) => {
         let id = store.getSubagentIdBySession(session);
         if (id === undefined)
             id = backfillSessionLink(session);
         if (id === undefined)
             return false;
+        if (event.type === 'user/message')
+            noteChildRelay(id, event);
         store.onSessionEvent(id, event);
         if (event.type === 'assistant/chunk') {
             streamDirty = true;
@@ -293,12 +367,32 @@ function createSessionSubagentProjection(getState, deps) {
         return typeof time === 'number' ? time : undefined;
     };
     /** Parent-session durable discovery events, live or folded from the log. */
-    const onParentEvent = (event, historical = false) => {
+    const onParentEvent = (event, historical = false, parentSessionId) => {
         if (!event || typeof event !== 'object')
             return;
         const ev = event;
         const data = ev.data ?? {};
         const childId = typeof data.childId === 'string' ? data.childId : undefined;
+        if (ev.type === 'user/message') {
+            // A relay delivered into this parent: the durable AgentMessageSource
+            // names the sending session. Plain user text, injected context and
+            // settlement notices are not relays; they stay invisible here, just as
+            // the translator keeps them out of bubbles.
+            const relay = agentRelaySourceOf(data.source);
+            if (relay !== undefined && typeof data.id === 'string' && data.id !== '') {
+                foldAgentMessage(agentMessages, {
+                    messageId: data.id,
+                    from: relay.senderSessionId,
+                    ...(parentSessionId === undefined ? {} : { to: parentSessionId, parentSessionId }),
+                    via: 'agent-relay',
+                    text: agentMessageTextOf(data.content),
+                    state: 'queued',
+                    ...(typeof ev.seq === 'number' ? { sourceRef: `seq:${ev.seq}` } : {}),
+                    observedAt: eventTime(event) ?? Date.now(),
+                });
+            }
+            return;
+        }
         if (ev.type === 'tool/call') {
             if (!historical && typeof data.name === 'string' && isSubagentToolName(data.name) && typeof data.arguments === 'string') {
                 try {
@@ -360,12 +454,12 @@ function createSessionSubagentProjection(getState, deps) {
     /** Seed the dashboard from the durable parent log at bind/resume: catalog
      * children and workflow members survive a restart. Historical children the
      * registry no longer holds stay card-less (dashboard-only, `unknown`). */
-    const bootstrapFromLog = (events) => {
+    const bootstrapFromLog = (events, parentSessionId) => {
         if (!Array.isArray(events))
             return;
         try {
             for (const event of events)
-                onParentEvent(event, true);
+                onParentEvent(event, true, parentSessionId);
         }
         catch { /* bootstrap is best-effort discovery; live events remain authoritative */ }
         syncNow();
@@ -421,6 +515,56 @@ function createSessionSubagentProjection(getState, deps) {
         syncNow();
         getState().emit();
     };
+    /**
+     * The direct continuable prompt: one browser-authored message through
+     * the continuation manager, whose rules cover exact-parent authority,
+     * cold resume and inbox admission; this facade only shapes the request
+     * and folds the receipt. An accepted inbox is 'queued', never more; a
+     * failure maps to the stable vocabulary.
+     */
+    const submitPrompt = async (input) => {
+        const service = deps.subagents();
+        if (service?.prompt === undefined)
+            return { ok: false, reason: 'unavailable' };
+        const text = input.text.trim();
+        if (text === '')
+            return { ok: false, reason: 'failed', message: 'empty text' };
+        // Fail closed on a child this roster already knows cannot take a
+        // continuation; the service re-checks with full authority regardless.
+        if (store.get(input.targetId)?.mode === 'one-shot')
+            return { ok: false, reason: 'not-resumable' };
+        const parentSessionId = String(deps.agent().session.id);
+        const requestId = `tui-${randomUUID()}`;
+        const signals = [new AbortController().signal, deps.ownerSignal, input.signal].filter((signal) => signal !== undefined);
+        try {
+            const receipt = await service.prompt({
+                requestId,
+                parentSessionId,
+                childSessionId: input.targetId,
+                mode: 'continuable',
+                delivery: input.delivery,
+                content: [{ type: 'text', text }],
+            }, AbortSignal.any(signals));
+            foldAgentMessage(agentMessages, {
+                messageId: receipt.messageId,
+                intentId: requestId,
+                from: 'user',
+                to: input.targetId,
+                via: 'direct-continuable',
+                text,
+                state: 'queued',
+                sourceRef: receipt.messageId,
+                observedAt: Date.now(),
+                parentSessionId,
+            });
+            syncNow();
+            getState().emit();
+            return { ok: true, intentId: requestId, messageId: receipt.messageId, state: 'queued' };
+        }
+        catch (error) {
+            return agentMessageFailureOf(error);
+        }
+    };
     const control = {
         interrupt(agentId) {
             const child = store.get(agentId);
@@ -441,6 +585,6 @@ function createSessionSubagentProjection(getState, deps) {
         },
     };
     const dropRows = () => { streamDirty = false; rowsByAgentId.clear(); };
-    const reset = () => { dropRows(); cardedIds.clear(); workflowMembers.clear(); pendingTaskDescriptions.length = 0; store.reset(); getState().subagents = []; getState().subagentCost = []; };
-    return { store, control, pendingTaskDescriptions, onSessionEvent, onStreamFrame, onParentEvent, bootstrapFromLog, onStart, onEnd, syncNow, flush, dropRows, reset };
+    const reset = () => { dropRows(); cardedIds.clear(); workflowMembers.clear(); pendingTaskDescriptions.length = 0; agentMessages.length = 0; store.reset(); getState().subagents = []; getState().subagentCost = []; };
+    return { store, control, pendingTaskDescriptions, agentMessages, onSessionEvent, onStreamFrame, onParentEvent, bootstrapFromLog, onStart, onEnd, syncNow, flush, dropRows, reset, submitPrompt };
 }

package/lib/types/dsh-adapter/channel/subagent-transcript.d.ts

@@ -0,0 +1,114 @@
+/**
+ * DSH child transcript source (docs/dsh-child-transcript.md): the DSH
+ * implementation of the backend-neutral `SubagentControl.history` contract,
+ * next to Claude's on-disk child lane. Reads one direct child's own durable
+ * session log through the public persistence range API only
+ * (`ctx.sessionPersistence.open(id, 'read')` + `SessionHandle.read(offset,
+ * length)`) and translates the page through a throwaway DSH translator into
+ * the shared leaf vocabulary. The deprecated Session snapshot-events API and
+ * the raw session-log file readers are not used.
+ *
+ * Read shape (every step bounded and fenced):
+ *  1. ownership: the parent-owned `subagents.listChildren(parentId)` roster
+ *     must name the child; a UI-supplied id is never opened on its own;
+ *  2. durability: when the agents registry still holds the child's exact
+ *     live Session, the public `ctx.sessions.flush(session)` barrier runs
+ *     first (no whenIdle wait, no Agent create/resume); a failed or timed-out
+ *     flush falls back to whatever prefix is already persisted;
+ *  3. windows: the child's own events are `[inheritedEventCount, total)`;
+ *     the fork-inherited prefix is never paged (a seeded header without its
+ *     exact cut fails closed). `total` comes from `stat().eventCount` when
+ *     the host states it, else from bounded single-event tail probes of the
+ *     public range reader (never an unbounded whole-log read + slice);
+ *  4. translation: a fresh translator instance per call; only the leaf
+ *     kinds (`assistant.message` / `tool.call` / `tool.result`) survive,
+ *     each stamped with the child lane's `parentCallId`, so the shared
+ *     fold/page/merge pipeline consumes them exactly like Claude's;
+ *  5. fences: the binding capture (session + generation) is re-checked after
+ *     every await; a parent that moved on discards the page. The handle is
+ *     closed exactly once on every path.
+ */
+import { type SessionEvent } from '@deepseek-ai/dsh-session';
+import type { SubagentTranscriptPage, SubagentTranscriptWindow } from '../../agent/capabilities.js';
+import type { DshTranslator } from '../backend/translate.js';
+import type { SubagentsServiceView } from './subagent-projection.js';
+/**
+ * One page window in source events. Claude pages by 400 SDK messages
+ * (`SUBAGENT_TRANSCRIPT_PAGE`) and the shared "load older" chunk is
+ * `TRANSCRIPT_OLDER_CHUNK = 400`, so DSH pages by 400 SessionEvents and the
+ * neutral cursor stays one unit wide for both backends.
+ */
+export declare const CHILD_TRANSCRIPT_PAGE_EVENTS = 400;
+/** The binding identity one read captures and re-checks after every await. */
+export interface ChildTranscriptCapture {
+    readonly sessionId: string;
+    readonly generation: number;
+    /** The bound session object, opaque here; the `isCurrent` fence compares
+     *  identity (the caller's binding owns the real type). */
+    readonly session: object;
+}
+/** Structural slice of `ctx.sessionPersistence` the child transcript uses. */
+export interface ChildPersistenceSource {
+    /** Cheap metadata observation; `eventCount` optional by contract. */
+    stat?(id: string, options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<{
+        readonly eventCount?: unknown;
+    } | undefined>;
+    open(id: string, access: 'read', options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<ChildPersistenceHandle>;
+}
+/** The public read-only `SessionHandle` as this module reads it. */
+export interface ChildPersistenceHandle {
+    readonly id: unknown;
+    readonly header: {
+        readonly version?: unknown;
+        readonly id?: unknown;
+        readonly parentSession?: unknown;
+        readonly isSeeded?: unknown;
+    };
+    /** Exact fork-inherited prefix length stored with the log (0 unseeded). */
+    readonly inheritedEventCount?: unknown;
+    read(offset?: number, length?: number, options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<{
+        readonly events: readonly SessionEvent[];
+    }>;
+    close(): Promise<void>;
+}
+/** Structural slice of `ctx.sessions` (dsh-session SessionStore). */
+export interface ChildSessionsStore {
+    flush(session: object): Promise<unknown>;
+}
+export interface ChildTranscriptDeps {
+    /** Current binding identity; undefined when the DSH binding is gone. */
+    capture(): ChildTranscriptCapture | undefined;
+    /** False once the channel re/switched away from the captured binding. */
+    isCurrent(capture: ChildTranscriptCapture): boolean;
+    /** The continuation service (parent-owned child catalog). */
+    subagents(): SubagentsServiceView | undefined;
+    /** The persistence service, re-resolved per call (never cached stale). */
+    persistence(): ChildPersistenceSource | undefined;
+    /** The live sessions store for the pre-read flush barrier; optional. */
+    sessionsStore(): ChildSessionsStore | undefined;
+    /** Registry child lookup: the exact live Session when it is held. */
+    lookupChild(id: string): {
+        readonly session?: unknown;
+    } | undefined;
+    /** A throwaway translator per call: history must not touch the live
+     *  translator's frame fence or open-call ledger (backend/session.ts's
+     *  own `history()` rule). */
+    createTranslator(): DshTranslator;
+    /** Aborted when the channel owner releases; cancels a page read. */
+    readonly ownerSignal?: AbortSignal;
+}
+/**
+ * Read one child transcript page: the newest window, or the
+ * `window`-addressed older slice, of the child's own durable events. Null =
+ * the parent's catalog holds no such direct child; a rejection = the read
+ * failed (the transcript view shows "unavailable", never a fabricated empty
+ * page).
+ */
+export declare function readChildTranscriptPage(deps: ChildTranscriptDeps, agentId: string, window?: SubagentTranscriptWindow): Promise<SubagentTranscriptPage | null>;
+//# sourceMappingURL=subagent-transcript.d.ts.map

package/lib/types/dsh-adapter/channel/subagent-transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-transcript.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/subagent-transcript.ts"],"names":[],"mappings":"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"}