@deepseek-harness-tui/dsh-tui 0.10.0 → 0.10.2

package/lib/types/dsh-adapter/status.js

@@ -14,6 +14,8 @@ import { Service } from '@deepseek-ai/cordis';
 import { cleanScalarText } from './sanitize.js';
 import { activationFiber, assertCallerContext, bindCallerEffect, compositionRoot, concreteService, requirePluginCaller } from './host-access.js';
 import { componentIdentityOf } from './component-identity.js';
+import { assertCapabilityShadowPolicy, } from '../adapter/kernel/runtime.js';
+import { adapterRuntimeFor } from '../adapter/kernel/runtime-context.js';
 // Colon-separated segments are the documented namespacing convention
 // (`plugin:sub-item`); each segment stays a lowercase slug.
 const KEY_PATTERN = /^[a-z][a-z0-9_-]*(:[a-z][a-z0-9_-]*)*$/u;
@@ -148,6 +150,7 @@ export class TuiStatusRuntime extends Service {
                 ctx.logger.warn(`dsh-tui: status view "${key}" crashed and was hidden: %o`, error);
             }),
             nextToken: 1,
+            runtime: adapterRuntimeFor(ctx),
         };
         hostStatusStores.set(this, state);
         ctx.effect(() => () => state.store.clear());
@@ -172,6 +175,7 @@ export class TuiStatusRuntime extends Service {
      * guess (C-060 honest identity).
      */
     set(key, text, identity) {
+        assertCapabilityShadowPolicy('host.status.set', statusStateFor(this).runtime.mode, statusStateFor(this).runtime.slices);
         const noop = () => { };
         let caller;
         try {
@@ -289,6 +293,7 @@ export class TuiStatusRuntime extends Service {
      * same attribution-only meaning as `set()`.
      */
     registerView(descriptor, identity) {
+        assertCapabilityShadowPolicy('host.status.register-view', statusStateFor(this).runtime.mode, statusStateFor(this).runtime.slices);
         let caller;
         try {
             caller = requirePluginCaller(this.ctx, 'tuiStatus.registerView', this);
@@ -385,6 +390,30 @@ export class TuiStatusRuntime extends Service {
         ledgerApplied = true;
         return dispose;
     }
+    /**
+     * Subscribe to status-line changes. Kept on the plugin-visible service so
+     * the shadow-policy gate covers this subscription effect too.
+     */
+    subscribe(listener) {
+        assertCapabilityShadowPolicy('host.status.subscribe', statusStateFor(this).runtime.mode, statusStateFor(this).runtime.slices);
+        const caller = requirePluginCaller(this.ctx, 'tuiStatus.subscribe', this);
+        const owner = activationFiber(caller);
+        if (owner === undefined)
+            return () => { };
+        if (typeof listener !== 'function')
+            return () => { };
+        const wrapped = () => {
+            try {
+                listener();
+            }
+            catch (error) {
+                caller.logger.warn(`dsh-tui: tuiStatus listener failed: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        };
+        const dispose = statusStateFor(this).store.subscribe(wrapped);
+        bindCallerEffect(caller, dispose);
+        return dispose;
+    }
 }
 const hostStatusStores = new WeakMap();
 function statusStateFor(runtime) {

package/lib/types/dsh-adapter/subagents.d.ts

@@ -1,56 +1,11 @@
-/** Unified subagent activity domain model used by the adapter and every view. */
-export type SubagentStatus = 'starting' | 'running' | 'completed' | 'failed' | 'cancelled' | 'unknown';
-export type SubagentOutputKind = 'text' | 'thinking' | 'tool' | 'error' | 'system';
-export interface SubagentOutputLine {
-    kind: SubagentOutputKind;
-    text: string;
-    at: number;
-    /** False while the line is still absorbing streaming deltas. */
-    settled?: boolean;
-}
-export interface SubagentToolCall {
-    id?: string;
-    name: string;
-    status: 'running' | 'completed' | 'failed';
-    startedAt: number;
-    endedAt?: number;
-    argsPreview?: string;
-    resultPreview?: string;
-    error?: string;
-}
-export interface SubagentTokenUsage {
-    input?: number;
-    output?: number;
-    total?: number;
-    context?: number;
-}
-export interface SubagentState {
-    agentId: string;
-    runId?: string;
-    description: string;
-    provider?: string;
-    model?: string;
-    effort?: string;
-    status: SubagentStatus;
-    startedAt: number;
-    completedAt?: number;
-    endedAt?: number;
-    local?: boolean;
-    parentSessionId?: string;
-    sessionId?: string;
-    stopReason?: string;
-    error?: string;
-    /** Compatibility projection for older consumers. */
-    output: string[];
-    outputEvents: SubagentOutputLine[];
-    toolCalls: SubagentToolCall[];
-    tokens?: SubagentTokenUsage;
-    summary?: string;
-}
+import type { AssistantStreamFrame } from '@deepseek-ai/dsh-agent';
+import type { SubagentState, SubagentOutputKind, SubagentToolCall } from '../adapter/ports/channel-view.js';
+export type { SubagentState, SubagentStatus, SubagentOutputLine, SubagentOutputKind, SubagentToolCall, SubagentTokenUsage } from '../adapter/ports/channel-view.js';
 export declare class SubagentActivityStore {
     private states;
     private sessionToAgent;
     private listeners;
+    private streams;
     private commitLine;
     private pushLine;
     onSpawned(agentId: string, provider?: string, model?: string, info?: Partial<SubagentState>): void;
@@ -59,6 +14,11 @@ export declare class SubagentActivityStore {
     appendOutput(agentId: string, text: string, kind?: SubagentOutputKind): void;
     /** Mark the streaming tail line complete (run settlement). */
     flushOutput(agentId: string): void;
+    /** 0.1.5 live stream: transient attempt frames replace `assistant/chunk`
+     *  session events (the durable settlement keeps flowing as session events). */
+    onStreamFrame(agentId: string, frame: AssistantStreamFrame): void;
+    private restoreAttempt;
+    private settleAssistant;
     onSessionEvent(agentId: string, event: unknown): void;
     /** Merge partial updates (model discovery, session id) into one subagent. */
     patch(agentId: string, partial: Partial<SubagentState>): void;

package/lib/types/dsh-adapter/subagents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagents.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/subagents.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"subagents.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/subagents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,KAAK,EAAE,aAAa,EAAsC,kBAAkB,EAAE,gBAAgB,EAAsB,MAAM,kCAAkC,CAAA;AACnK,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AAiBnK,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,OAAO,CAA2C;IAE1D,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,QAAQ;IAOhB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAa,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,IAAI;IA0B1G,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAMpD,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS;IAE5D,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,kBAA2B,GAAG,IAAI;IA0BpF,8DAA8D;IAC9D,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IASlC;mFAC+E;IAC/E,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,IAAI;IA+BjE,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,eAAe;IAyBvB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAoDrD,6EAA6E;IAC7E,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAO7D,2EAA2E;IAC3E,OAAO,CAAC,SAAS;IAUjB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IASvF,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAU3J,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,SAAc,GAAG,IAAI;IAC9E,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAC9C,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAc,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAE1E,OAAO,CAAC,MAAM;IAcd;;sEAEkE;IAClE,KAAK,IAAI,IAAI;IAOb,QAAQ,IAAI,aAAa,EAAE;IAC3B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAC/C,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAC3C,OAAO,CAAC,MAAM;CACf"}

package/lib/types/dsh-adapter/subagents.js

@@ -1,10 +1,10 @@
-/** Unified subagent activity domain model used by the adapter and every view. */
 const MAX_OUTPUT_EVENTS = 160;
 const MAX_OUTPUT_LINES = 160;
 export class SubagentActivityStore {
     states = new Map();
     sessionToAgent = new Map();
     listeners = new Set();
+    streams = new Map();
     commitLine(agentId, kind, text) {
         const state = this.states.get(agentId);
         if (!state)
@@ -91,6 +91,83 @@ export class SubagentActivityStore {
             this.notify();
         }
     }
+    /** 0.1.5 live stream: transient attempt frames replace `assistant/chunk`
+     *  session events (the durable settlement keeps flowing as session events). */
+    onStreamFrame(agentId, frame) {
+        const state = this.states.get(agentId);
+        if (!state || (state.status !== 'running' && state.status !== 'starting'))
+            return;
+        let stream = this.streams.get(agentId);
+        if (stream === undefined) {
+            stream = { revision: -1 };
+            this.streams.set(agentId, stream);
+        }
+        if (frame.revision <= stream.revision)
+            return;
+        stream.revision = frame.revision;
+        if (frame.type === 'end') {
+            if (stream.attempt?.id === frame.attemptId)
+                this.restoreAttempt(agentId, stream);
+            return;
+        }
+        if (frame.type === 'start' || stream.attempt === undefined) {
+            this.restoreAttempt(agentId, stream);
+            this.flushOutput(agentId);
+            // Retain at most the existing 160-line window, never the chunk history.
+            stream.attempt = {
+                id: frame.attemptId,
+                ...(frame.type === 'start' ? { turn: frame.turn, step: frame.step } : {}),
+                before: state.outputEvents.map(line => ({ ...line })),
+            };
+        }
+        if (frame.type === 'start' || stream.attempt?.id !== frame.attemptId)
+            return;
+        const chunk = frame.chunk;
+        if (chunk.type === 'text-delta' && chunk.text)
+            this.appendOutput(agentId, chunk.text, 'text');
+        else if (chunk.type === 'reasoning-delta' && chunk.text)
+            this.appendOutput(agentId, chunk.text, 'thinking');
+        else if (chunk.type === 'usage' && chunk.usage)
+            this.setTokens(agentId, chunk.usage);
+    }
+    restoreAttempt(agentId, stream) {
+        const state = this.states.get(agentId);
+        if (!state || stream.attempt === undefined)
+            return;
+        state.outputEvents = stream.attempt.before;
+        state.output = state.outputEvents.map(line => line.text);
+        stream.attempt = undefined;
+        this.notify();
+    }
+    settleAssistant(agentId, content, turn, step, seq) {
+        if (!this.states.has(agentId) || !Array.isArray(content))
+            return;
+        let stream = this.streams.get(agentId);
+        if (stream === undefined) {
+            stream = { revision: -1 };
+            this.streams.set(agentId, stream);
+        }
+        if (typeof seq === 'number') {
+            if (stream.settledSeq !== undefined && seq <= stream.settledSeq)
+                return;
+            stream.settledSeq = seq;
+        }
+        const attempt = stream.attempt;
+        if (attempt !== undefined && (attempt.turn === undefined || (attempt.turn === turn && attempt.step === step))) {
+            this.restoreAttempt(agentId, stream);
+        }
+        for (const block of content) {
+            if (block === null || typeof block !== 'object')
+                continue;
+            const value = block;
+            if ((value.type !== 'text' && value.type !== 'reasoning') || typeof value.text !== 'string' || value.text === '')
+                continue;
+            const kind = value.type === 'text' ? 'text' : 'thinking';
+            for (const line of value.text.split('\n').slice(-MAX_OUTPUT_EVENTS))
+                this.commitLine(agentId, kind, line);
+        }
+        this.notify();
+    }
     onSessionEvent(agentId, event) {
         if (!event || typeof event !== 'object')
             return;
@@ -108,10 +185,20 @@ export class SubagentActivityStore {
                 break;
             }
             case 'assistant/message': {
+                if (Array.isArray(data.stream))
+                    this.settleAssistant(agentId, data.message?.content, data.turn, data.step, ev.seq);
                 if (data.usage)
                     this.setTokens(agentId, data.usage);
                 break;
             }
+            case 'assistant/attempt': {
+                const stream = this.streams.get(agentId);
+                const attempt = stream?.attempt;
+                if (stream !== undefined && attempt !== undefined && (attempt.turn === undefined || (attempt.turn === data.turn && attempt.step === data.step))) {
+                    this.restoreAttempt(agentId, stream);
+                }
+                break;
+            }
             case 'tool/call': {
                 this.recordTool(agentId, { id: data.callId, name: data.name, status: 'running', startedAt: Date.now(), argsPreview: data.arguments });
                 break;
@@ -186,6 +273,9 @@ export class SubagentActivityStore {
         const state = this.states.get(agentId);
         if (!state || (state.status !== 'running' && state.status !== 'starting'))
             return;
+        const stream = this.streams.get(agentId);
+        if (stream !== undefined)
+            this.restoreAttempt(agentId, stream);
         state.status = status;
         state.completedAt = Date.now();
         state.endedAt = state.completedAt;
@@ -202,6 +292,7 @@ export class SubagentActivityStore {
     reset() {
         this.states.clear();
         this.sessionToAgent.clear();
+        this.streams.clear();
         this.notify();
     }
     snapshot() { return Array.from(this.states.values()).map(state => ({ ...state, output: [...state.output], outputEvents: [...state.outputEvents], toolCalls: state.toolCalls.map(tool => ({ ...tool })), tokens: state.tokens ? { ...state.tokens } : undefined })); }

package/lib/types/dsh-adapter/themes.d.ts

@@ -26,6 +26,7 @@ export interface TuiThemeRegistration {
 }
 /** Host-only read surface for runtime themes. */
 export interface TuiThemeHost {
+    register(descriptor: TuiThemeDescriptor): () => void;
     getSnapshot(): readonly TuiThemeRegistration[];
     resolve(name: string): Theme | undefined;
     subscribe(listener: () => void): () => void;

package/lib/types/dsh-adapter/themes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"themes.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/themes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAWtD,OAAO,EAOL,KAAK,aAAa,EAClB,KAAK,KAAK,EACX,MAAM,aAAa,CAAA;AAEpB,qDAAqD;AACrD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,CAAA;AAEzD,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;CACnE;AAED,6EAA6E;AAC7E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;CAC1C;AAED,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,WAAW,IAAI,SAAS,oBAAoB,EAAE,CAAA;IAC9C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAA;IACxC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;CAC5C;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,SAAS,EAAE,eAAe,CAAA;KAC3B;CACF;AAqKD,uDAAuD;AACvD,qBAAa,eAAgB,SAAQ,OAAO;gBAC9B,GAAG,EAAE,OAAO;IAoCxB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,kBAAkB,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,IAAI;CAmFzE;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAO5F;AAED,eAAe,eAAe,CAAA"}
+{"version":3,"file":"themes.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/themes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAgBtD,OAAO,EAOL,KAAK,aAAa,EAClB,KAAK,KAAK,EACX,MAAM,aAAa,CAAA;AAEpB,qDAAqD;AACrD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,CAAA;AAEzD,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;CACnE;AAED,6EAA6E;AAC7E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;CAC1C;AAED,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,IAAI,CAAA;IACpD,WAAW,IAAI,SAAS,oBAAoB,EAAE,CAAA;IAC9C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAA;IACxC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;CAC5C;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,SAAS,EAAE,eAAe,CAAA;KAC3B;CACF;AAuKD,uDAAuD;AACvD,qBAAa,eAAgB,SAAQ,OAAO;gBAC9B,GAAG,EAAE,OAAO;IA2DxB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,kBAAkB,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,IAAI;CAoFzE;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAO5F;AAED,eAAe,eAAe,CAAA"}

package/lib/types/dsh-adapter/themes.js

@@ -10,6 +10,8 @@ import { Service } from '@deepseek-ai/cordis';
 import { cleanRenderText } from './sanitize.js';
 import { activationFiber, assertCallerContext, bindCallerEffect, compositionRoot, concreteService, requirePluginCaller, } from './host-access.js';
 import { isThemeBase, isValidThemeColor } from '../customTheme.js';
+import { assertCapabilityShadowPolicy, } from '../adapter/kernel/runtime.js';
+import { adapterRuntimeFor } from '../adapter/kernel/runtime-context.js';
 import { AUTO_THEME_NAME, getTheme, normalizeThemeKey, isRetiredThemeKey, registerRuntimeThemeResolver, THEME_NAMES, } from '../theme.js';
 const NAME_PATTERN = /^[a-z][a-z0-9_-]*(?::[a-z][a-z0-9_-]*)?$/u;
 const MAX_NAME_LENGTH = 128;
@@ -111,6 +113,7 @@ function emit(state) {
     }
 }
 function resolveRuntimeTheme(runtime, name) {
+    assertCapabilityShadowPolicy('host.themes.resolver', themeStateFor(runtime).runtime.mode, themeStateFor(runtime).runtime.slices);
     let normalized;
     try {
         normalized = normalizeRuntimeName(name);
@@ -157,9 +160,34 @@ export class TuiThemeRuntime extends Service {
             host: undefined,
             resolverCleanup: undefined,
             disposed: false,
+            runtime: adapterRuntimeFor(ctx),
         };
         hostThemes.set(this, state);
+        const hostThemeOwner = Object.freeze({ kind: 'host-theme-owner' });
         state.host = Object.freeze({
+            register: (descriptor) => {
+                const state = themeStateFor(runtime);
+                if (state.disposed)
+                    return NOOP;
+                const validated = validateDescriptor(descriptor);
+                if (validated === undefined || state.entries.has(validated.name) || state.entries.size >= MAX_RUNTIME_THEMES) {
+                    return NOOP;
+                }
+                const entry = Object.freeze({
+                    ...validated,
+                    owner: hostThemeOwner,
+                    theme: Object.freeze({ ...getTheme(validated.base), ...validated.colors }),
+                });
+                state.entries.set(entry.name, entry);
+                emit(state);
+                return () => {
+                    const current = state.entries.get(entry.name);
+                    if (current !== entry || current.owner !== hostThemeOwner)
+                        return;
+                    state.entries.delete(entry.name);
+                    emit(state);
+                };
+            },
             getSnapshot: () => themeStateFor(runtime).snapshot,
             resolve: (name) => resolveRuntimeTheme(runtime, name),
             subscribe: (listener) => subscribeRuntimeTheme(runtime, listener),
@@ -186,6 +214,7 @@ export class TuiThemeRuntime extends Service {
      * the caller's Cordis activation and disappear with that activation.
      */
     register(descriptor, identity) {
+        assertCapabilityShadowPolicy('host.themes.register', themeStateFor(this).runtime.mode, themeStateFor(this).runtime.slices);
         try {
             const caller = requirePluginCaller(this.ctx, 'tuiThemes.register', this);
             const state = themeStateFor(this);

package/lib/types/dsh-adapter/toast.d.ts

@@ -33,7 +33,20 @@ export interface TuiToastOptions {
  * deliveries before/after a sink exists are dropped (returned as false). */
 export declare class TuiToastStore {
     private sink;
+    private readonly probeSinks;
     setSink(sink: TuiToastSink | undefined): void;
+    /** Whether a real production sink (the host's channel.notify bridge) is
+     * present. Used by the toast live probe to distinguish “host store exists”
+     * from “real production delivery path is actually wired”. */
+    hasSink(): boolean;
+    /** Host-only probe sink registration. Probe sinks are independent of the
+     * production sink, so a live probe never replaces or swallows production
+     * toast delivery. */
+    addProbeSink(sink: TuiToastSink): () => void;
+    /** Deliver only to host-only probe sinks, leaving the production sink
+     * completely untouched. Returns true when at least one probe sink received
+     * the delivery. */
+    deliverProbe(delivery: TuiToastDelivery): boolean;
     deliver(delivery: TuiToastDelivery): boolean;
 }
 declare module '@deepseek-ai/cordis' {

package/lib/types/dsh-adapter/toast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/toast.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAItD,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,+EAA+E;AAC/E,MAAM,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAA;AAE/D,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;IAChD;;2EAEuE;IACvE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAYD;4EAC4E;AAC5E,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAA0B;IAEtC,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI;IAI7C,OAAO,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO;CAK7C;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,QAAQ,EAAE,eAAe,CAAA;KAC1B;CACF;AAYD;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,OAAO;gBAC9B,GAAG,EAAE,OAAO;IAOxB;;;;;;;;;;OAUG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO;CAwD9E;AAQD,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAOjG;AAED,eAAe,eAAe,CAAA"}
+{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/toast.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAStD,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,+EAA+E;AAC/E,MAAM,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAA;AAE/D,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;IAChD;;2EAEuE;IACvE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAYD;4EAC4E;AAC5E,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAA0B;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0B;IAErD,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI;IAI7C;;iEAE6D;IAC7D,OAAO,IAAI,OAAO;IAIlB;;yBAEqB;IACrB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,IAAI;IAO5C;;uBAEmB;IACnB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO;IASjD,OAAO,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO;CAK7C;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,QAAQ,EAAE,eAAe,CAAA;KAC1B;CACF;AAaD;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,OAAO;gBAC9B,GAAG,EAAE,OAAO;IAOxB;;;;;;;;;;OAUG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO;CAyD9E;AAQD,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAOjG;AAED,eAAe,eAAe,CAAA"}

package/lib/types/dsh-adapter/toast.js

@@ -14,6 +14,8 @@
 import { Service } from '@deepseek-ai/cordis';
 import { cleanScalarText } from './sanitize.js';
 import { activationFiber, compositionRoot, concreteService, requirePluginCaller } from './host-access.js';
+import { assertCapabilityShadowPolicy, } from '../adapter/kernel/runtime.js';
+import { adapterRuntimeFor } from '../adapter/kernel/runtime-context.js';
 // Same caps as the channel's own toast-bound plugin text (NOTICE_CELLS).
 const TEXT_CELLS = 200;
 const TIMEOUT_DEFAULT_MS = 4000;
@@ -27,9 +29,36 @@ const COLORS = new Set(['success', 'warning', 'error']);
  * deliveries before/after a sink exists are dropped (returned as false). */
 export class TuiToastStore {
     sink;
+    probeSinks = new Set();
     setSink(sink) {
         this.sink = sink;
     }
+    /** Whether a real production sink (the host's channel.notify bridge) is
+     * present. Used by the toast live probe to distinguish “host store exists”
+     * from “real production delivery path is actually wired”. */
+    hasSink() {
+        return this.sink !== undefined;
+    }
+    /** Host-only probe sink registration. Probe sinks are independent of the
+     * production sink, so a live probe never replaces or swallows production
+     * toast delivery. */
+    addProbeSink(sink) {
+        this.probeSinks.add(sink);
+        return () => {
+            this.probeSinks.delete(sink);
+        };
+    }
+    /** Deliver only to host-only probe sinks, leaving the production sink
+     * completely untouched. Returns true when at least one probe sink received
+     * the delivery. */
+    deliverProbe(delivery) {
+        let delivered = false;
+        for (const sink of this.probeSinks) {
+            sink(delivery);
+            delivered = true;
+        }
+        return delivered;
+    }
     deliver(delivery) {
         if (this.sink === undefined)
             return false;
@@ -47,7 +76,7 @@ export class TuiToastRuntime extends Service {
     constructor(ctx) {
         super(ctx, 'tuiToast');
         compositionRoot(ctx);
-        const state = { store: new TuiToastStore(), windows: new Map(), warned: new Set() };
+        const state = { store: new TuiToastStore(), windows: new Map(), warned: new Set(), runtime: adapterRuntimeFor(ctx) };
         hostToastStores.set(this, state);
     }
     /**
@@ -62,6 +91,7 @@ export class TuiToastRuntime extends Service {
      * minute; the first drop logs a sticky warning per activation).
      */
     show(text, options = {}) {
+        assertCapabilityShadowPolicy('host.toast.show', toastStateFor(this).runtime.mode, toastStateFor(this).runtime.slices);
         let caller;
         try {
             caller = requirePluginCaller(this.ctx, 'tuiToast.show', this);

package/lib/types/dsh-adapter/trajectory/aggregate.d.ts

@@ -11,7 +11,8 @@
  *
  * - **Own duration only.** A turn's cost is its own bracket, never the sum of
  *   its children — summing both would double-count every tool inside it.
- * - **No fabricated spans.** A step that produced no `assistant/chunk` (the
+ * - **No fabricated spans.** A step that produced no stream output (no
+ *   `assistant/chunk` pre-0.1.5, no embedded settlement stream since — the
  *   request failed, or the log predates chunk capture) contributes no TTFT and
  *   no decode sample rather than a zero that would drag the average down.
  * - **Bursts expand.** A folded run is one ledger row but N calls; the counts

package/lib/types/dsh-adapter/trajectory/aggregate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/trajectory/aggregate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAA0B,MAAM,YAAY,CAAA;AAC1G,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAK5D;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,KAAK,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,GACnD,IAAI,CASN;AAqCD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,EAAE,CAIrF;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,GAAE,WAAwB,GAAG,aAAa,CAuGzF"}
+{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/trajectory/aggregate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAA0B,MAAM,YAAY,CAAA;AAC1G,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAK5D;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,KAAK,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,GACnD,IAAI,CASN;AAqCD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,EAAE,CAIrF;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,GAAE,WAAwB,GAAG,aAAa,CAuGzF"}

package/lib/types/dsh-adapter/trajectory/aggregate.js

@@ -11,7 +11,8 @@
  *
  * - **Own duration only.** A turn's cost is its own bracket, never the sum of
  *   its children — summing both would double-count every tool inside it.
- * - **No fabricated spans.** A step that produced no `assistant/chunk` (the
+ * - **No fabricated spans.** A step that produced no stream output (no
+ *   `assistant/chunk` pre-0.1.5, no embedded settlement stream since — the
  *   request failed, or the log predates chunk capture) contributes no TTFT and
  *   no decode sample rather than a zero that would drag the average down.
  * - **Bursts expand.** A folded run is one ledger row but N calls; the counts

package/lib/types/dsh-adapter/trajectory/guards.d.ts

@@ -3,11 +3,12 @@
  *
  * ## Why guards instead of the declared types
  *
- * `SessionEventMap` declares twelve core event types. Everything else in the
- * 44-name `KNOWN_SESSION_EVENT_TYPES` vocabulary arrives through *module
+ * `SessionEventMap` declares a dozen-odd core event types. Everything else in
+ * the `KNOWN_SESSION_EVENT_TYPES` vocabulary arrives through *module
  * augmentation* from the plugin that owns it — `llm/retry` from the LLM
- * layer, `hook/*` from the hook runner, `tool/code-dispatch*` from the code
- * runtime. Those declaration packages are not all in this bundle's dependency
+ * layer, `hook/*` from the hook runner, `tool/code-dispatch*` (pre-0.1.5) /
+ * `tool/ptc-dispatch*` (0.1.5) from the code/PTC runtime. Those declaration
+ * packages are not all in this bundle's dependency
  * graph, so `event.type === 'llm/retry'` does not even type-check here: the
  * literal is not a member of the union TypeScript can see.
  *
@@ -26,18 +27,14 @@
  * shape. Where a field was absent from every observed sample it is optional
  * here, so a future harness that starts emitting it is picked up for free.
  */
-import type { SessionEvent } from '@deepseek-ai/dsh-session';
+import type { TimedStreamChunk } from '@deepseek-ai/dsh-llm';
+import type { RawTrajEvent } from '../../adapter/ports/channel-view.js';
+export type { RawTrajEvent } from '../../adapter/ports/channel-view.js';
 /**
  * A session event reduced to the envelope the projection relies on. Only
  * `type`, `seq` and `time` are contractual across every event; `data` is
  * deliberately `unknown` so nothing downstream can read it without a guard.
  */
-export interface RawTrajEvent {
-    readonly type: string;
-    readonly seq: number;
-    readonly time: number;
-    readonly data: unknown;
-}
 /**
  * The single widening point for the whole trajectory feature.
  *
@@ -51,7 +48,7 @@ export interface RawTrajEvent {
  * @param events - The session's immutable event snapshot.
  * @returns The same array, typed for guard-mediated access.
  */
-export declare function asRawEvents(events: readonly SessionEvent[]): readonly RawTrajEvent[];
+export declare function asRawEvents(events: readonly RawTrajEvent[]): readonly RawTrajEvent[];
 /**
  * An `llm/retry` payload.
  *
@@ -78,12 +75,18 @@ export declare function readRetry(data: unknown): RetryPayload | undefined;
 /** The `retryId` of an `llm/retry-started`, used to close the retry bracket. */
 export declare function readRetryStarted(data: unknown): string | undefined;
 /**
- * A `tool/code-dispatch*` payload — the code runner's nested tool calls, and
- * the only source of SUBTOOL rows.
+ * A `tool/code-dispatch*` / `tool/ptc-dispatch*` payload — the code runner's
+ * nested tool calls, and the only source of SUBTOOL rows.
  *
- * `tool/code-dispatch-start` opens and `tool/code-dispatch` closes, paired by
- * `subCallId`; `rootCallId`/`parentCallId` give the enclosing model-issued
- * call. `arguments` is a structured value here (unlike `tool/call`, whose
+ * The dispatch bracket was renamed with the runtime: pre-0.1.5 logs carry
+ * `tool/code-dispatch-start` ↔ `tool/code-dispatch`, 0.1.5 logs carry
+ * `tool/ptc-dispatch-start` ↔ `tool/ptc-dispatch`, paired by `subCallId` in
+ * both generations; `rootCallId`/`parentCallId` give the enclosing
+ * model-issued call. The payload shape is identical across the rename, so
+ * this one guard serves both. `subCallId` is treated as an OPAQUE pairing
+ * key: the fold never parses the `<parent>:code:<n>` / `<parent>:ptc:<n>`
+ * infix, so a renamed (or future) id scheme cannot break pairing.
+ * `arguments` is a structured value here (unlike `tool/call`, whose
  * `arguments` is the model's raw JSON string), so it is stringified for the
  * preview at guard time — the payload object is small and already
  * materialized by the log reader.
@@ -96,8 +99,24 @@ export interface DispatchPayload {
     readonly args?: string;
     readonly isError?: boolean;
 }
-/** Narrow a `tool/code-dispatch*` payload. */
+/** Narrow a `tool/code-dispatch*` / `tool/ptc-dispatch*` payload. */
 export declare function readDispatch(data: unknown): DispatchPayload | undefined;
+/**
+ * Expand the compact `stream` of a V3 `assistant/message` / `assistant/attempt`
+ * into timed chunks, or `undefined` when the event carries no usable stream.
+ *
+ * V3 logs replace per-token `assistant/chunk` events with one compact
+ * `AssistantStreamRecord[]` embedded in the settlement event. Upstream's
+ * `expandAssistantStream` is the validating read path for that record list —
+ * and it landed with the record type itself (0.1.5), so the binding is
+ * feature-detected through the namespace rather than named-imported: a
+ * pre-0.1.5 host lacks the export, and a named import would fail the whole
+ * module at link time instead of degrading this one read. The same
+ * never-throw contract as every guard here applies on both axes: a missing
+ * expander or a malformed record (the expander throws `TypeError`) yields
+ * `undefined`, and the fold simply contributes no stream timing.
+ */
+export declare function readAssistantStream(data: unknown): readonly TimedStreamChunk[] | undefined;
 /**
  * A `request/header` payload, reduced to the route facts the trajectory
  * shows: which model actually served this request, at which effort. The full

package/lib/types/dsh-adapter/trajectory/guards.d.ts.map

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