@deepseek-harness-tui/dsh-tui 0.11.0 → 0.11.2

package/lib/types/dsh-adapter/activity-store.js

@@ -0,0 +1,359 @@
+/**
+ * Session-scoped activity snapshots for the working-status line.
+ *
+ * The line's *semantics* belong to the `dsh-working-activity` plugin: it folds
+ * durable session events and live model frames into a **session projection**
+ * (`workingActivity`) that any client can read — the browser reads it, and so
+ * does this TUI. Consuming the projection is what removes the second tracker
+ * this app used to run: one semantic owner, and a value that arrives already
+ * scoped to a session, so a background session can no longer overwrite the line
+ * of the session on screen.
+ *
+ * Two properties of the transport shape this module:
+ *
+ * 1. **It is event-driven.** A value changes when a committed event folds, never
+ *    on its own. `updatedAt` is the timestamp of the last folded event (session
+ *    time, so it survives a restart) and `live` says whether `line` counts
+ *    elapsed time. A renderer that wants the counter to move must derive it from
+ *    `turnStartedAt` / `phaseStartedAt` instead of re-rendering `line`.
+ * 2. **The value is host data, not plugin API.** The shape below is a local
+ *    structural copy of the plugin's wire value, the same discipline the channel
+ *    port already applies to the activity state: this app must not import the
+ *    plugin's internals to display a line.
+ * @module dsh-tui/dsh-adapter/activity-store
+ */
+import React from 'react';
+/** The projection key the activity plugin publishes. */
+export const ACTIVITY_PROJECTION_KEY = 'workingActivity';
+/**
+ * Narrow one projection value: anything that is not an activity view is
+ * dropped rather than rendered half-formed.
+ * @param value - Raw projection value.
+ * @returns the value as an activity view, or `undefined`.
+ */
+export function asActivityView(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    const record = value;
+    if (typeof record.phase !== 'string' || typeof record.line !== 'string')
+        return undefined;
+    if (!PHASES.has(record.phase))
+        return undefined;
+    return value;
+}
+const PHASES = new Set(['idle', 'waiting', 'thinking', 'tool', 'done']);
+/**
+ * The latest activity value for the session on screen, with a subscription
+ * for renderers.
+ *
+ * The store is effectively single-current: binding a session ({@link
+ * ActivityStore.seed}) names the session the UI is showing, and every other
+ * id is dropped — values, session objects and read-failure counts alike. A
+ * registry-less store (the UI's fallback, test rigs) has no current session
+ * and keeps today's accept-all behavior.
+ */
+export class ActivityStore {
+    values = new Map();
+    /** Session objects seen for each id, so a live value can be re-read. */
+    sessions = new Map();
+    /** Consecutive failed reads per session id; reset by a successful read. */
+    readFailures = new Map();
+    /** Sessions already warned about (see {@link noteReadFailure}): once each. */
+    warned = new Set();
+    listeners = new Set();
+    /** The session the UI is showing (the last {@link seed}); the only id kept. */
+    currentId;
+    /** Host registry, remembered so a bind can read a baseline on demand. */
+    registry;
+    /** Warn sink (see {@link noteReadFailure}); injected by the composition root. */
+    warn;
+    constructor(warn) {
+        this.warn = warn;
+    }
+    /** Remember the host registry (see {@link seed} and {@link refreshLive}). */
+    attachRegistry(registry) {
+        this.registry = registry;
+    }
+    /**
+     * Seed one session from the registry's current snapshot and make it the
+     * current one.
+     *
+     * A value only *arrives* when it changes, so a session opened after its last
+     * change — a resume, or a window reattached to a running agent — would show
+     * nothing until the next event without this read. The bind also defines the
+     * session on screen: every other id is pruned, so a later event — or the
+     * tick — for a session the user switched away from can no longer fill this
+     * store or keep a timer armed.
+     * @param session - Session being bound.
+     */
+    seed(session) {
+        if (session === null || session === undefined)
+            return;
+        this.currentId = String(session.id);
+        this.pruneToCurrent();
+        seedActivity(this.registry, this, session);
+    }
+    /**
+     * Note the session object behind an id, so a live value can be re-read.
+     * Dropped for any id other than the current one (see {@link seed}). */
+    remember(sessionId, session) {
+        if (this.currentId !== undefined && sessionId !== this.currentId)
+            return;
+        this.sessions.set(sessionId, session);
+    }
+    /**
+     * Re-read the current session's value while it is still counting time.
+     *
+     * The host renders the value when it is *read*, so this is what makes the
+     * elapsed seconds advance between committed events — with the host's own copy
+     * and language, since nothing is re-rendered here. A value that has settled
+     * (`live` false: idle, or a finished turn) is deliberately skipped: its text
+     * cannot change on its own. Only the current session can be live (see
+     * {@link seed}), so the tick never polls a session the user left.
+     */
+    refreshLive() {
+        const registry = this.registry;
+        if (registry === undefined)
+            return;
+        for (const [sessionId, value] of [...this.values]) {
+            if (!value.live)
+                continue;
+            const session = this.sessions.get(sessionId);
+            if (session === undefined)
+                continue;
+            seedActivity(registry, this, session);
+        }
+    }
+    /** Whether the current session's value is still counting time (see {@link refreshLive}). */
+    hasLive() {
+        for (const value of this.values.values())
+            if (value.live)
+                return true;
+        return false;
+    }
+    /** The current value for one session, stable between updates. */
+    get(sessionId) {
+        if (sessionId === undefined)
+            return undefined;
+        return this.values.get(sessionId);
+    }
+    /**
+     * Record one projection value. Dropped for any id other than the current
+     * one (see {@link seed}).
+     * @param sessionId - Session the value belongs to.
+     * @param view - The published value.
+     */
+    update(sessionId, view) {
+        if (this.currentId !== undefined && sessionId !== this.currentId)
+            return;
+        if (this.values.get(sessionId) === view)
+            return;
+        this.values.set(sessionId, view);
+        this.emit();
+    }
+    /** Forget one session (disposed, or left behind by a reset). */
+    clear(sessionId) {
+        this.sessions.delete(sessionId);
+        if (!this.values.delete(sessionId))
+            return;
+        this.emit();
+    }
+    /** A read succeeded: this session's consecutive-failure count restarts. */
+    noteReadSuccess(sessionId) {
+        this.readFailures.delete(sessionId);
+    }
+    /**
+     * A read failed. The failure is reported to the warn sink ONCE per session
+     * (the sink is the composition root's logger — this module stays free of
+     * cordis types), and after {@link MAX_READ_FAILURES} consecutive failures
+     * the value is cleared so the tick disarms instead of polling a registry
+     * that will never answer.
+     * @param sessionId - Session whose read failed.
+     * @param detail - What the failed read threw.
+     */
+    noteReadFailure(sessionId, detail) {
+        const failures = (this.readFailures.get(sessionId) ?? 0) + 1;
+        this.readFailures.set(sessionId, failures);
+        if (!this.warned.has(sessionId)) {
+            this.warned.add(sessionId);
+            this.warn?.(`dsh-tui: working-activity projection read failed for session ${sessionId}: ${detail}`);
+        }
+        if (failures >= MAX_READ_FAILURES)
+            this.clear(sessionId);
+    }
+    /** Drop every id that is not the current one; emit when a value went. */
+    pruneToCurrent() {
+        if (this.currentId === undefined)
+            return;
+        let removedValue = false;
+        for (const id of [...this.values.keys()]) {
+            if (id === this.currentId)
+                continue;
+            this.values.delete(id);
+            removedValue = true;
+            this.sessions.delete(id);
+            this.readFailures.delete(id);
+            this.warned.delete(id);
+        }
+        for (const id of [...this.sessions.keys()]) {
+            if (id === this.currentId)
+                continue;
+            this.sessions.delete(id);
+            this.readFailures.delete(id);
+            this.warned.delete(id);
+        }
+        if (removedValue)
+            this.emit();
+    }
+    /** Subscribe to value changes; returns the unsubscribe function. */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => { this.listeners.delete(listener); };
+    }
+    emit() {
+        for (const listener of [...this.listeners])
+            listener();
+    }
+}
+/**
+ * The change-feed listener for one store.
+ *
+ * Only this plugin's key is read, and only values that narrow to an activity
+ * view are accepted: the feed is host-wide, so every other unit's change and
+ * every malformed value must be dropped here rather than inside a renderer.
+ * @param store - Store to fill.
+ * @returns the listener to hand to `ProjectionRegistry.onChanged`.
+ */
+export function createActivityFeed(store) {
+    return (session, key, value) => {
+        if (key !== ACTIVITY_PROJECTION_KEY)
+            return;
+        const view = asActivityView(value);
+        if (view === undefined)
+            return;
+        const sessionId = String(session.id);
+        // Values for a session other than the current one are dropped inside
+        // remember/update, so the feed needs no filter of its own.
+        store.remember(sessionId, session);
+        store.update(sessionId, view);
+    };
+}
+/** How often a value that is still counting time is re-read from the host. */
+export const LIVE_TICK_MS = 500;
+/** Consecutive failed reads before a session's value is dropped (see {@link ActivityStore.noteReadFailure}). */
+const MAX_READ_FAILURES = 3;
+/**
+ * Wire one store to the host's projection registry.
+ *
+ * Registration is deferred through `inject` because the plugin that *publishes*
+ * the unit is mounted alongside this one: the registry may not exist yet, and
+ * the unit may not be registered until later still. Both absences are normal —
+ * a composition without the activity plugin simply never fills the store, and
+ * the line falls back to whatever else the UI has.
+ *
+ * The feed is event-driven, so a value only lands when a committed event folds;
+ * its elapsed text would therefore freeze for the length of a long tool. The
+ * host renders a value when it is READ, so a timer re-reads the live ones: the
+ * seconds advance, the copy and language stay the plugin's, and a settled value
+ * (idle, or a finished turn) stops the timer instead of being polled forever.
+ * @param ctx - Host context of the composition root.
+ * @param store - Store to fill.
+ */
+export function attachActivityProjection(ctx, store) {
+    ctx.inject(['sessionProjections'], ((projectionCtx) => {
+        const registry = projectionCtx.sessionProjections;
+        if (registry === undefined)
+            return;
+        store.attachRegistry(registry);
+        const offFeed = registry.onChanged(createActivityFeed(store));
+        let timer;
+        const stopTimer = () => {
+            if (timer === undefined)
+                return;
+            clearInterval(timer);
+            timer = undefined;
+        };
+        /** Arm while something is counting time, disarm the moment nothing is. */
+        const reconcileTimer = () => {
+            if (!store.hasLive()) {
+                stopTimer();
+                return;
+            }
+            if (timer !== undefined)
+                return;
+            timer = setInterval(() => {
+                store.refreshLive();
+            }, LIVE_TICK_MS);
+            timer.unref();
+        };
+        const offStore = store.subscribe(reconcileTimer);
+        reconcileTimer();
+        // The cleanup belongs to the injected fiber, not the outer ctx: a service
+        // re-provide re-runs the callback above, and registering on the outer ctx
+        // would stack feed listeners (the old listener's disposer would only run
+        // when the whole composition root goes down).
+        projectionCtx.effect(() => () => {
+            offStore();
+            stopTimer();
+            offFeed();
+        }, 'dsh-tui activity projection feed');
+    }));
+}
+/**
+ * Create the composition root's activity store and wire it to the host.
+ * @param ctx - Host context of the composition root.
+ * @param enabled - Whether the working line is shown at all (cordis.yml
+ *   `activity`; a static, config-time switch — the runtime `/activity` command
+ *   only changes the preset). With the line off, nothing attaches: no feed,
+ *   no registry, and therefore no 500ms tick for a line nobody renders.
+ * @returns the store the UI reads from.
+ */
+export function createActivityStore(ctx, enabled) {
+    const store = new ActivityStore(message => { ctx.logger.warn(message); });
+    if (enabled)
+        attachActivityProjection(ctx, store);
+    return store;
+}
+/**
+ * Read one session's activity value in a component.
+ * @param store - Store to read.
+ * @param sessionId - Session the UI is showing.
+ * @returns the current value, or `undefined` when there is none.
+ */
+export function useActivity(store, sessionId) {
+    const subscribe = React.useCallback((listener) => store.subscribe(listener), [store]);
+    const read = React.useCallback(() => store.get(sessionId), [store, sessionId]);
+    return React.useSyncExternalStore(subscribe, read);
+}
+/**
+ * Seed one session's value from the registry's current snapshot.
+ *
+ * A value only *arrives* when it changes, so a session opened after its last
+ * change — a resume, or a window reattached to a running agent — would show
+ * nothing until the next event without this read.
+ * @param registry - Host projection registry.
+ * @param store - Store to fill.
+ * @param session - Session to read.
+ */
+export function seedActivity(registry, store, session) {
+    if (registry === undefined || session === null || session === undefined)
+        return;
+    const id = String(session.id);
+    try {
+        const snapshot = registry.snapshot(session, [ACTIVITY_PROJECTION_KEY]);
+        const view = asActivityView(snapshot.values[ACTIVITY_PROJECTION_KEY]);
+        if (view === undefined)
+            store.clear(id);
+        else {
+            store.remember(id, session);
+            store.update(id, view);
+        }
+        store.noteReadSuccess(id);
+    }
+    catch (error) {
+        // An unreadable snapshot is still not worth failing a session bind over,
+        // but it is no longer silent either: warn once per session, and a read
+        // that keeps failing eventually drops the value so the tick disarms.
+        store.noteReadFailure(id, error instanceof Error ? error.message : String(error));
+    }
+}

package/lib/types/dsh-adapter/channel/action-readiness.d.ts

@@ -4,7 +4,7 @@ import type { ChannelState } from './types.js';
  * specialist has been constructed.  Construction-time callers fail closed
  * rather than receiving a plausible no-op while the Channel is incomplete.
  */
-export type ChannelActionDelegates = Pick<ChannelState, 'commandCompletions' | 'loadOlder' | 'rewindTo' | 'rewindToNode' | 'forkSession' | 'resumeTo' | 'newSession' | 'listWorkspaces' | 'listWorkspaceRegistry' | 'removeWorkspace' | 'renameWorkspaceAt' | 'resolveWorkspace' | 'switchWorkspace' | 'renameWorkspace' | 'workspaceCommands' | 'runWorkspaceCommand' | 'switchModel' | 'listEfforts' | 'setEffort' | 'setDefaultEffort' | 'cycleMode' | 'runPermissionPreset' | 'clear' | 'setActivityFrames' | 'listPresets' | 'switchPreset' | 'listModels' | 'listProviders' | 'invalidateModelCompletion' | 'listSkills' | 'describeCredential' | 'balanceInfo' | 'sideQuestion' | 'listFileCandidates' | 'listFiles' | 'listSessions' | 'previewSession' | 'bindApprovalStore' | 'agentViewRows' | 'subscribeAgentView' | 'dispatchBackgroundAgent' | 'stopBackgroundAgent' | 'attachToAgent' | 'peekAgentSession' | 'replyToAgent' | 'backgroundCurrent' | 'setResumeTarget' | 'renameSession' | 'setSessionColor' | 'recapRecent' | 'deleteSession' | 'renameSessionTo' | 'compact' | 'runExternalCommand' | 'runExternalCommandOutcome' | 'pushLocal' | 'mcpStatus' | 'exportSession' | 'initWorkspace' | 'doctorInfo' | 'pluginsInfo' | 'listSubagents'> & {
+export type ChannelActionDelegates = Pick<ChannelState, 'commandCompletions' | 'loadOlder' | 'rewindTo' | 'rewindToNode' | 'forkSession' | 'resumeTo' | 'newSession' | 'listWorkspaces' | 'listWorkspaceRegistry' | 'removeWorkspace' | 'renameWorkspaceAt' | 'resolveWorkspace' | 'switchWorkspace' | 'renameWorkspace' | 'workspaceCommands' | 'runWorkspaceCommand' | 'switchModel' | 'listEfforts' | 'setEffort' | 'setDefaultEffort' | 'cycleMode' | 'runPermissionPreset' | 'clear' | 'setActivityFrames' | 'listPresets' | 'switchPreset' | 'listModels' | 'listProviders' | 'invalidateModelCompletion' | 'listSkills' | 'describeCredential' | 'balanceInfo' | 'sideQuestion' | 'listFileCandidates' | 'listFiles' | 'cachedSessions' | 'listSessions' | 'previewSession' | 'listForeignSources' | 'listForeignSessions' | 'importForeignSession' | 'bindApprovalStore' | 'agentViewRows' | 'subscribeAgentView' | 'dispatchBackgroundAgent' | 'stopBackgroundAgent' | 'attachToAgent' | 'peekAgentSession' | 'replyToAgent' | 'backgroundCurrent' | 'setResumeTarget' | 'renameSession' | 'setSessionColor' | 'recapRecent' | 'deleteSession' | 'renameSessionTo' | 'compact' | 'cancelCompact' | 'runExternalCommand' | 'runExternalCommandOutcome' | 'pushLocal' | 'mcpStatus' | 'exportSession' | 'initWorkspace' | 'doctorInfo' | 'pluginsInfo' | 'listSubagents'> & {
     runLocalCommand(command: string, includeInContext: boolean): Promise<void>;
 };
 type ChannelActionMethodName = Exclude<keyof ChannelActionDelegates, 'runLocalCommand'>;

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

@@ -1 +1 @@
-{"version":3,"file":"action-readiness.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/action-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,YAAY,EAClD,oBAAoB,GACpB,WAAW,GACX,UAAU,GACV,cAAc,GACd,aAAa,GACb,UAAU,GACV,YAAY,GACZ,gBAAgB,GAChB,uBAAuB,GACvB,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,GACnB,qBAAqB,GACrB,aAAa,GACb,aAAa,GACb,WAAW,GACX,kBAAkB,GAClB,WAAW,GACX,qBAAqB,GACrB,OAAO,GACP,mBAAmB,GACnB,aAAa,GACb,cAAc,GACd,YAAY,GACZ,eAAe,GACf,2BAA2B,GAC3B,YAAY,GACZ,oBAAoB,GACpB,aAAa,GACb,cAAc,GACd,oBAAoB,GACpB,WAAW,GACX,cAAc,GACd,gBAAgB,GAChB,mBAAmB,GACnB,eAAe,GACf,oBAAoB,GACpB,yBAAyB,GACzB,qBAAqB,GACrB,eAAe,GACf,kBAAkB,GAClB,cAAc,GACd,mBAAmB,GACnB,iBAAiB,GACjB,eAAe,GACf,iBAAiB,GACjB,aAAa,GACb,eAAe,GACf,iBAAiB,GACjB,SAAS,GACT,oBAAoB,GACpB,2BAA2B,GAC3B,WAAW,GACX,WAAW,GACX,eAAe,GACf,eAAe,GACf,YAAY,GACZ,aAAa,GACb,eAAe,CAClB,GAAG;IACF,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3E,CAAA;AAED,KAAK,uBAAuB,GAAG,OAAO,CAAC,MAAM,sBAAsB,EAAE,iBAAiB,CAAC,CAAA;AACvF,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAA;AAE9E;4EAC4E;AAC5E,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,MAAM,sBAAsB,GAC5C,oBAAoB,CAoEtB;AAED,wBAAgB,4BAA4B;kBAG1B,sBAAsB,GAAG,IAAI;uBAIxB,sBAAsB;EAK5C"}
+{"version":3,"file":"action-readiness.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/action-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,YAAY,EAClD,oBAAoB,GACpB,WAAW,GACX,UAAU,GACV,cAAc,GACd,aAAa,GACb,UAAU,GACV,YAAY,GACZ,gBAAgB,GAChB,uBAAuB,GACvB,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,GACnB,qBAAqB,GACrB,aAAa,GACb,aAAa,GACb,WAAW,GACX,kBAAkB,GAClB,WAAW,GACX,qBAAqB,GACrB,OAAO,GACP,mBAAmB,GACnB,aAAa,GACb,cAAc,GACd,YAAY,GACZ,eAAe,GACf,2BAA2B,GAC3B,YAAY,GACZ,oBAAoB,GACpB,aAAa,GACb,cAAc,GACd,oBAAoB,GACpB,WAAW,GACX,gBAAgB,GAChB,cAAc,GACd,gBAAgB,GAChB,oBAAoB,GACpB,qBAAqB,GACrB,sBAAsB,GACtB,mBAAmB,GACnB,eAAe,GACf,oBAAoB,GACpB,yBAAyB,GACzB,qBAAqB,GACrB,eAAe,GACf,kBAAkB,GAClB,cAAc,GACd,mBAAmB,GACnB,iBAAiB,GACjB,eAAe,GACf,iBAAiB,GACjB,aAAa,GACb,eAAe,GACf,iBAAiB,GACjB,SAAS,GACT,eAAe,GACf,oBAAoB,GACpB,2BAA2B,GAC3B,WAAW,GACX,WAAW,GACX,eAAe,GACf,eAAe,GACf,YAAY,GACZ,aAAa,GACb,eAAe,CAClB,GAAG;IACF,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3E,CAAA;AAED,KAAK,uBAAuB,GAAG,OAAO,CAAC,MAAM,sBAAsB,EAAE,iBAAiB,CAAC,CAAA;AACvF,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAA;AAE9E;4EAC4E;AAC5E,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,MAAM,sBAAsB,GAC5C,oBAAoB,CAyEtB;AAED,wBAAgB,4BAA4B;kBAG1B,sBAAsB,GAAG,IAAI;uBAIxB,sBAAsB;EAK5C"}

package/lib/types/dsh-adapter/channel/action-readiness.js

@@ -40,8 +40,12 @@ export function createChannelActionMethods(getReadyActions) {
         sideQuestion: (question, options) => getReadyActions().sideQuestion(question, options),
         listFileCandidates: (query, options) => getReadyActions().listFileCandidates(query, options),
         listFiles: () => getReadyActions().listFiles(),
-        listSessions: () => getReadyActions().listSessions(),
+        cachedSessions: () => getReadyActions().cachedSessions(),
+        listSessions: (onEnriched, onPartial) => getReadyActions().listSessions(onEnriched, onPartial),
         previewSession: sessionId => getReadyActions().previewSession(sessionId),
+        listForeignSources: () => getReadyActions().listForeignSources(),
+        listForeignSessions: (agentId, onRow) => getReadyActions().listForeignSessions(agentId, onRow),
+        importForeignSession: (agentId, key) => getReadyActions().importForeignSession(agentId, key),
         bindApprovalStore: store => getReadyActions().bindApprovalStore(store),
         agentViewRows: () => getReadyActions().agentViewRows(),
         subscribeAgentView: listener => getReadyActions().subscribeAgentView(listener),
@@ -58,6 +62,7 @@ export function createChannelActionMethods(getReadyActions) {
         deleteSession: sessionId => getReadyActions().deleteSession(sessionId),
         renameSessionTo: (sessionId, title) => getReadyActions().renameSessionTo(sessionId, title),
         compact: () => getReadyActions().compact(),
+        cancelCompact: () => getReadyActions().cancelCompact(),
         runExternalCommand: (name, rawInput) => getReadyActions().runExternalCommand(name, rawInput),
         runExternalCommandOutcome: (name, rawInput, images) => getReadyActions().runExternalCommandOutcome(name, rawInput, images),
         pushLocal: (title, lines) => getReadyActions().pushLocal(title, lines),

package/lib/types/dsh-adapter/channel/background-action.d.ts

@@ -7,7 +7,7 @@ import type { BackgroundResult, ChannelState } from './types.js';
 type Binding = ReturnType<typeof createChannelBinding>;
 /** `/bg` foreground handoff. The binding remains the sole identity writer;
  * this action only parks the exact previous handle passed by its transaction. */
-export declare function createBackgroundCurrentAction(ctx: Context, state: Pick<ChannelState, 'cwd' | 'status' | 'agentId' | 'loadedContext' | 'contextWindow' | 'effortLevels' | 'reasoningEffort' | 'emit' | 'notify'> & Parameters<typeof resetSessionProjection>[0], options: {
+export declare function createBackgroundCurrentAction(ctx: Context, state: Pick<ChannelState, 'cwd' | 'status' | 'agentId' | 'sessionId' | 'loadedContext' | 'contextWindow' | 'effortLevels' | 'reasoningEffort' | 'emit' | 'notify'> & Parameters<typeof resetSessionProjection>[0], options: {
     configuredPreset?: string;
     configuredProvider?: string;
     configuredModel?: string;
@@ -22,6 +22,7 @@ export declare function createBackgroundCurrentAction(ctx: Context, state: Pick<
     };
     resetProjector(): void;
     resetSubagents(): void;
+    parkSubagents(agent: AgentHandle['agent']): void;
     resetJobs(): void;
     refreshEffortLevels(): void;
     bindAgent(): void;

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

@@ -1 +1 @@
-{"version":3,"file":"background-action.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/background-action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAsB,MAAM,wBAAwB,CAAA;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAYlD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEhE,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEtD;iFACiF;AACjF,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,IAAI,CAAC,YAAY,EACtB,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,eAAe,GAAG,eAAe,GAChE,cAAc,GAAG,iBAAiB,GAAG,MAAM,GAAG,QAAQ,CAAC,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,EACxG,OAAO,EAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAC9H,IAAI,EAAE;IACJ,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAA;IACpC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,CAAA;IACjF,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IAC3C,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACzB,cAAc,IAAI,IAAI,CAAA;IACtB,cAAc,IAAI,IAAI,CAAA;IACtB,SAAS,IAAI,IAAI,CAAA;IACjB,mBAAmB,IAAI,IAAI,CAAA;IAC3B,SAAS,IAAI,IAAI,CAAA;IACjB,eAAe,IAAI,IAAI,CAAA;IACvB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,iBAAiB,IAAI,IAAI,CAAA;IACzB,qBAAqB,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7F,4EAA4E;IAC5E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAA;IAC5F,eAAe,IAAI,IAAI,CAAA;CACxB,GACA,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAwFjC"}
+{"version":3,"file":"background-action.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/background-action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAsB,MAAM,wBAAwB,CAAA;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAYlD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEhE,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEtD;iFACiF;AACjF,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,IAAI,CAAC,YAAY,EACtB,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,eAAe,GAAG,eAAe,GAC9E,cAAc,GAAG,iBAAiB,GAAG,MAAM,GAAG,QAAQ,CAAC,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,EACxG,OAAO,EAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAC9H,IAAI,EAAE;IACJ,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAA;IACpC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,CAAA;IACjF,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IAC3C,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACzB,cAAc,IAAI,IAAI,CAAA;IACtB,cAAc,IAAI,IAAI,CAAA;IACtB,aAAa,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;IAChD,SAAS,IAAI,IAAI,CAAA;IACjB,mBAAmB,IAAI,IAAI,CAAA;IAC3B,SAAS,IAAI,IAAI,CAAA;IACjB,eAAe,IAAI,IAAI,CAAA;IACvB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,iBAAiB,IAAI,IAAI,CAAA;IACzB,qBAAqB,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7F,4EAA4E;IAC5E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAA;IAC5F,eAAe,IAAI,IAAI,CAAA;CACxB,GACA,MAAM,OAAO,CAAC,gBAAgB,CAAC,CA0FjC"}

package/lib/types/dsh-adapter/channel/background-action.js

@@ -62,6 +62,7 @@ export function createBackgroundCurrentAction(ctx, state, options, deps) {
             try {
                 const result = deps.binding.adopt(handle, adoption, (previous, disposePrevious) => {
                     const previousSessionId = String(previous.agent.session.id);
+                    deps.parkSubagents(previous.agent);
                     if (previous.handle !== undefined) {
                         deps.backgroundHandles.set(previousSessionId, previous.handle);
                         disposePrevious('park');
@@ -69,6 +70,7 @@ export function createBackgroundCurrentAction(ctx, state, options, deps) {
                     resetSessionProjection(state, deps.rowIds, deps.resetProjector, deps.resetSubagents, deps.resetJobs);
                     state.status = handle.agent.status;
                     state.agentId = handle.agent.id;
+                    state.sessionId = handle.agent.session.id;
                     state.loadedContext = undefined;
                     state.contextWindow = undefined;
                     state.effortLevels = undefined;

package/lib/types/dsh-adapter/channel/binding-events.d.ts

@@ -1,4 +1,4 @@
-import type { AssistantStreamFrame, ModelSelectionRef } from '@deepseek-ai/dsh-agent';
+import type { Agent, AssistantStreamFrame, ModelSelectionRef } from '@deepseek-ai/dsh-agent';
 import type { Context } from '@deepseek-ai/cordis';
 import type { InputConvergence } from './input-actions.js';
 import type { ChannelBinding } from './binding.js';
@@ -6,22 +6,21 @@ import type { ChannelOwner } from './owner.js';
 import { type createChannelProjection } from './projection.js';
 import type { ChannelState } from './types.js';
 /**
- * The binding event router is the sole subscriber for a foreground Agent.
- * It captures the binding generation at every listener entry; teardown is
- * incremental and retained callbacks check that captured Agent/session pair
- * before touching state. Transcript presentation remains exclusively owned by
- * ChannelProjection.
+ * Foreground transcript listeners capture a binding generation. Child event
+ * listeners instead span the Channel owner, keeping parked reducers current
+ * across rebinds. Both paths own registrations incrementally and fence retained
+ * callbacks; only ChannelProjection presents the foreground transcript.
  */
 export declare function createBindingEvents(ctx: Context, deps: {
     owner: ChannelOwner;
     binding: ChannelBinding;
     state: ChannelState;
-    activity: {
-        start(agent: ChannelBinding['agent']): void;
-        stop(): void;
-        onAgentStatus(status: ChannelBinding['agent']['status']): unknown;
-        onSessionEvent(event: unknown): unknown;
-    };
+    /** Read the activity projection's current value for a freshly bound session.
+     *  A projection value only arrives when it changes, so a resumed or
+     *  reattached session needs this read to show its line before the next event.
+     *  The line's semantics live in the working-activity plugin: this app folds
+     *  nothing itself and forwards no events. */
+    seedActivity?(session: unknown): void;
     inputConvergence: InputConvergence;
     selection: ModelSelectionRef;
     modelActions: {
@@ -41,12 +40,14 @@ export declare function createBindingEvents(ctx: Context, deps: {
             runId?: string;
             provider: string;
             local?: boolean;
-        }): void;
+        }, parent: object | null): void;
         onEnd(info: {
             id: string;
+            runId?: string;
             stopReason: string;
             lastAssistantMessage?: unknown[];
-        }): void;
+        }, parent: object | null): void;
+        forget?(agent: Agent): void;
     };
     agentView: {
         schedule(): void;

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

@@ -1 +1 @@
-{"version":3,"file":"binding-events.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/binding-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AACrF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE;IACtD,KAAK,EAAE,YAAY,CAAA;IACnB,OAAO,EAAE,cAAc,CAAA;IACvB,KAAK,EAAE,YAAY,CAAA;IACnB,QAAQ,EAAE;QACR,KAAK,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;QAC3C,IAAI,IAAI,IAAI,CAAA;QACZ,aAAa,CAAC,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAA;QACjE,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAA;KACxC,CAAA;IACD,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,SAAS,EAAE,iBAAiB,CAAA;IAC5B,YAAY,EAAE;QAAE,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,SAAS,EAAE,iBAAiB,CAAA;KAAE,CAAA;IACrF,WAAW,EAAE;QAAE,WAAW,IAAI,IAAI,CAAC;QAAC,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAA;IAC5F,SAAS,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAA;IACrD,SAAS,EAAE;QAAE,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;QAAC,aAAa,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC;QAAC,OAAO,CAAC,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,oBAAoB,CAAC,EAAE,OAAO,EAAE,CAAA;SAAE,GAAG,IAAI,CAAA;KAAE,CAAA;IAC/T,SAAS,EAAE;QAAE,QAAQ,IAAI,IAAI,CAAA;KAAE,CAAA;IAC/B,eAAe,CAAC,EAAE;QAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAA;IACrE;;;sCAGkC;IAClC,gBAAgB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3C;gBAYkB,IAAI;EAgItB"}
+{"version":3,"file":"binding-events.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/binding-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC5F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE;IACtD,KAAK,EAAE,YAAY,CAAA;IACnB,OAAO,EAAE,cAAc,CAAA;IACvB,KAAK,EAAE,YAAY,CAAA;IACnB;;;;iDAI6C;IAC7C,YAAY,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACrC,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,SAAS,EAAE,iBAAiB,CAAA;IAC5B,YAAY,EAAE;QAAE,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,SAAS,EAAE,iBAAiB,CAAA;KAAE,CAAA;IACrF,WAAW,EAAE;QAAE,WAAW,IAAI,IAAI,CAAC;QAAC,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAA;IAC5F,SAAS,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAA;IACrD,SAAS,EAAE;QACT,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAA;QACzD,aAAa,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAA;QACpE,OAAO,CAAC,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;QAC7G,KAAK,CAAC,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,oBAAoB,CAAC,EAAE,OAAO,EAAE,CAAA;SAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;QAC9H,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;KAC5B,CAAA;IACD,SAAS,EAAE;QAAE,QAAQ,IAAI,IAAI,CAAA;KAAE,CAAA;IAC/B,eAAe,CAAC,EAAE;QAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAA;IACrE;;;sCAGkC;IAClC,gBAAgB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3C;gBAqCkB,IAAI;EAiJtB"}