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

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

@@ -0,0 +1,11 @@
+/**
+ * Channel state module (P4 channel split).
+ *
+ * Reads the live Channel's mutable reactive state and returns a frozen,
+ * JSON-ish state snapshot. This module only projects; it never mutates.
+ */
+import type { Channel } from '../../dsh-adapter/channel.js';
+import type { HostChannelStateSnapshot } from '../ports/channel.js';
+/** Project the live Channel state into a serializable host-internal snapshot. */
+export declare function projectChannelState(channel: Channel): HostChannelStateSnapshot;
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../src/adapter/channel/state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAA;AAgBnE,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,wBAAwB,CAgC9E"}

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

@@ -0,0 +1,55 @@
+/**
+ * Channel state module (P4 channel split).
+ *
+ * Reads the live Channel's mutable reactive state and returns a frozen,
+ * JSON-ish state snapshot. This module only projects; it never mutates.
+ */
+function asRecord(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    return Object.freeze({ ...value });
+}
+function asNumberRecord(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return Object.freeze({});
+    const out = {};
+    for (const [key, item] of Object.entries(value)) {
+        if (typeof item === 'number' && Number.isFinite(item))
+            out[key] = item;
+    }
+    return Object.freeze(out);
+}
+/** Project the live Channel state into a serializable host-internal snapshot. */
+export function projectChannelState(channel) {
+    return Object.freeze({
+        version: channel.version,
+        status: channel.status,
+        sessionTitle: channel.sessionTitle,
+        sessionColor: channel.sessionColor,
+        agentId: channel.agentId,
+        agentBindingGeneration: channel.agentBindingGeneration,
+        model: channel.model,
+        provider: channel.provider,
+        cwd: channel.cwd,
+        displayCwd: channel.displayCwd,
+        ...(channel.gitBranch === undefined ? {} : { gitBranch: channel.gitBranch }),
+        working: channel.working,
+        cancelPending: channel.cancelPending,
+        spinnerMode: channel.spinnerMode,
+        responseChars: channel.responseChars,
+        activeToolCount: channel.activeToolCount,
+        turnStart: channel.turnStart,
+        lastUserText: channel.lastUserText,
+        tokens: asNumberRecord(channel.tokens),
+        ...(channel.lastUsage === undefined ? {} : { lastUsage: asNumberRecord(channel.lastUsage) }),
+        ...(channel.workingActivity === undefined ? {} : { workingActivity: asRecord(channel.workingActivity) }),
+        ...(channel.activityFrames === undefined ? {} : { activityFrames: channel.activityFrames }),
+        ...(channel.goal === undefined ? {} : { goal: asRecord(channel.goal) }),
+        todos: Object.freeze(channel.todos.map(todo => Object.freeze({ ...todo }))),
+        ...(channel.loadedContext === undefined ? {} : { loadedContext: asRecord(channel.loadedContext) }),
+        pending: Object.freeze(channel.pending.map(pending => Object.freeze({ ...pending }))),
+        ...(channel.pluginScene === undefined ? {} : { pluginScene: asRecord(channel.pluginScene) }),
+        mode: asRecord(channel.mode) ?? Object.freeze({}),
+        ...(channel.agentPreset === undefined ? {} : { agentPreset: channel.agentPreset }),
+    });
+}

package/lib/types/adapter/channel/transcript.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Channel transcript module (P4 channel split).
+ *
+ * Provides the durable transcript/event access half of the live Channel:
+ * rendered rows plus the raw DSH session event log used by `/trace`.
+ *
+ * The internal `CHANNEL_SPLIT_TOKEN` is required so this split builder cannot
+ * be invoked outside the Kernel/driver path and bypass the HostFacade shadow
+ * gate.
+ */
+import type { Channel } from '../../dsh-adapter/channel.js';
+import type { HostChannelTranscriptPort } from '../ports/channel.js';
+/** Build the host-internal transcript surface over one live Channel. */
+export declare function createChannelTranscript(channel: Channel, token: symbol): HostChannelTranscriptPort;
+//# sourceMappingURL=transcript.d.ts.map

package/lib/types/adapter/channel/transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../../../src/adapter/channel/transcript.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAIpE,wEAAwE;AACxE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,yBAAyB,CAQlG"}

package/lib/types/adapter/channel/transcript.js

@@ -0,0 +1,22 @@
+/**
+ * Channel transcript module (P4 channel split).
+ *
+ * Provides the durable transcript/event access half of the live Channel:
+ * rendered rows plus the raw DSH session event log used by `/trace`.
+ *
+ * The internal `CHANNEL_SPLIT_TOKEN` is required so this split builder cannot
+ * be invoked outside the Kernel/driver path and bypass the HostFacade shadow
+ * gate.
+ */
+import { projectChannelRows } from './projection.js';
+import { CHANNEL_SPLIT_TOKEN } from './internal-token.js';
+/** Build the host-internal transcript surface over one live Channel. */
+export function createChannelTranscript(channel, token) {
+    if (token !== CHANNEL_SPLIT_TOKEN) {
+        throw new Error('dsh-tui: Channel split transcript requires the internal host token');
+    }
+    return Object.freeze({
+        rows: () => projectChannelRows(channel.rows),
+        traceEvents: () => channel.traceEvents(),
+    });
+}

package/lib/types/adapter/channel/ui-policy.d.ts

@@ -0,0 +1,106 @@
+/** Explicit in-process UI method inventory; never a wire protocol.
+ * Queries that warm caches or publish notices remain effectful.
+ */
+import type { ChannelUi } from '../ports/channel-ui.js';
+export type { ChannelUi } from '../ports/channel-ui.js';
+export type ChannelPreferences = Pick<ChannelUi, 'setDiffLayout' | 'setThinkingFold' | 'setToolBackground' | 'setScrollGutter' | 'setPageMargin' | 'setFoldTerminalCommand' | 'setPromptSessionLabel' | 'setExpandEditor' | 'setSmoothStreaming' | 'setStatusBar' | 'setWhale' | 'setWhaleIdle' | 'setMinimal'>;
+export declare const CHANNEL_UI_EFFECTS: Readonly<{
+    setDiffLayout: "mutate";
+    setThinkingFold: "mutate";
+    setToolBackground: "mutate";
+    setScrollGutter: "mutate";
+    setPageMargin: "mutate";
+    setFoldTerminalCommand: "mutate";
+    setPromptSessionLabel: "mutate";
+    setExpandEditor: "mutate";
+    setSmoothStreaming: "mutate";
+    setStatusBar: "mutate";
+    setWhale: "mutate";
+    setWhaleIdle: "mutate";
+    setMinimal: "mutate";
+    commandCompletions: "mutate";
+    runExternalCommand: "mutate";
+    runExternalCommandOutcome: "mutate";
+    openPluginScene: "mutate";
+    closePluginScene: "mutate";
+    sideQuestion: "mutate";
+    stagedImageGeneration: "read-only";
+    stageImage: "mutate";
+    stageComposerImage: "mutate";
+    hasStagedImage: "read-only";
+    discardStagedImage: "mutate";
+    stagedImage: "read-only";
+    stagedImageLimits: "read-only";
+    submit: "mutate";
+    steer: "mutate";
+    removePending: "mutate";
+    cancel: "mutate";
+    interruptAndDeliver: "mutate";
+    rewindTo: "mutate";
+    promptRewind: "mutate";
+    buildSessionTree: "mutate";
+    rewindToNode: "mutate";
+    forkSession: "mutate";
+    resumeTo: "mutate";
+    newSession: "mutate";
+    listWorkspaces: "read-only";
+    resolveWorkspace: "mutate";
+    switchWorkspace: "mutate";
+    renameWorkspace: "mutate";
+    workspaceCommands: "read-only";
+    runWorkspaceCommand: "mutate";
+    switchModel: "mutate";
+    listEfforts: "mutate";
+    setEffort: "mutate";
+    setDefaultEffort: "mutate";
+    cycleMode: "mutate";
+    permissionPresets: "read-only";
+    runPermissionPreset: "mutate";
+    listPresets: "read-only";
+    switchPreset: "mutate";
+    clear: "mutate";
+    loadOlder: "mutate";
+    notify: "mutate";
+    setActivityFrames: "mutate";
+    listModels: "read-only";
+    listProviders: "read-only";
+    invalidateModelCompletion: "mutate";
+    listSkills: "read-only";
+    describeCredential: "read-only";
+    balanceInfo: "mutate";
+    providerSetup: "read-only";
+    oauthProviderStatuses: "read-only";
+    settingsHost: "read-only";
+    settingsSections: "read-only";
+    subscribeSettingsSections: "subscribe";
+    listFileCandidates: "read-only";
+    listFiles: "read-only";
+    listSessions: "read-only";
+    previewSession: "read-only";
+    setResumeTarget: "mutate";
+    renameSession: "mutate";
+    setSessionColor: "mutate";
+    recapRecent: "mutate";
+    deleteSession: "mutate";
+    renameSessionTo: "mutate";
+    compact: "mutate";
+    pushLocal: "mutate";
+    mcpStatus: "read-only";
+    exportSession: "mutate";
+    initWorkspace: "mutate";
+    doctorInfo: "read-only";
+    pluginsInfo: "mutate";
+    listSubagents: "read-only";
+    agentViewRows: "read-only";
+    subscribeAgentView: "subscribe";
+    dispatchBackgroundAgent: "mutate";
+    stopBackgroundAgent: "mutate";
+    attachToAgent: "mutate";
+    peekAgentSession: "read-only";
+    backgroundCurrent: "mutate";
+    replyToAgent: "mutate";
+    traceEvents: "read-only";
+    subscribe: "subscribe";
+}>;
+export declare const CHANNEL_UI_PROPERTIES: readonly ["version", "rows", "status", "sessionTitle", "sessionColor", "agentId", "agentBindingGeneration", "autoRecapOnOpen", "model", "provider", "configuredProvider", "configuredModel", "configuredPreset", "configuredActivityFrames", "configuredLang", "tokens", "cwd", "displayCwd", "gitBranch", "working", "cancelPending", "spinnerMode", "responseChars", "activeToolCount", "turnStart", "lastUserText", "notifications", "contextWindow", "reasoningEffort", "effortLevels", "lastUsage", "tps", "tpsSamples", "workingActivity", "activityFrames", "diffLayout", "thinkingFold", "toolBackground", "scrollGutter", "pageMargin", "foldTerminalCommand", "promptSessionLabel", "expandEditor", "smoothStreaming", "statusBar", "whale", "whaleIdle", "minimal", "activityEnabled", "contextBarEnabled", "goal", "todos", "loadedContext", "pending", "commandList", "pluginScene", "contextSegments", "subagents", "subagentControl", "backgroundJobs", "jobControl", "mode", "modeIndex", "agentPreset"];
+//# sourceMappingURL=ui-policy.d.ts.map

package/lib/types/adapter/channel/ui-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-policy.d.ts","sourceRoot":"","sources":["../../../../src/adapter/channel/ui-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAIvD,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,SAAS,EAC3C,eAAe,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,iBAAiB,GAC7E,eAAe,GAAG,wBAAwB,GAAG,uBAAuB,GACpE,iBAAiB,GAAG,oBAAoB,GAAG,cAAc,GAAG,UAAU,GAAG,cAAc,GAAG,YAAY,CACzG,CAAA;AACD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiG4B,CAAA;AAE3D,eAAO,MAAM,qBAAqB,09BAiEe,CAAA"}

package/lib/types/adapter/channel/ui-policy.js

@@ -0,0 +1,166 @@
+export const CHANNEL_UI_EFFECTS = Object.freeze({
+    'setDiffLayout': 'mutate',
+    'setThinkingFold': 'mutate',
+    'setToolBackground': 'mutate',
+    'setScrollGutter': 'mutate',
+    'setPageMargin': 'mutate',
+    'setFoldTerminalCommand': 'mutate',
+    'setPromptSessionLabel': 'mutate',
+    'setExpandEditor': 'mutate',
+    'setSmoothStreaming': 'mutate',
+    'setStatusBar': 'mutate',
+    'setWhale': 'mutate',
+    'setWhaleIdle': 'mutate',
+    'setMinimal': 'mutate',
+    'commandCompletions': 'mutate',
+    'runExternalCommand': 'mutate',
+    'runExternalCommandOutcome': 'mutate',
+    'openPluginScene': 'mutate',
+    'closePluginScene': 'mutate',
+    'sideQuestion': 'mutate',
+    'stagedImageGeneration': 'read-only',
+    'stageImage': 'mutate',
+    'stageComposerImage': 'mutate',
+    'hasStagedImage': 'read-only',
+    'discardStagedImage': 'mutate',
+    'stagedImage': 'read-only',
+    'stagedImageLimits': 'read-only',
+    'submit': 'mutate',
+    'steer': 'mutate',
+    'removePending': 'mutate',
+    'cancel': 'mutate',
+    'interruptAndDeliver': 'mutate',
+    'rewindTo': 'mutate',
+    'promptRewind': 'mutate',
+    'buildSessionTree': 'mutate',
+    'rewindToNode': 'mutate',
+    'forkSession': 'mutate',
+    'resumeTo': 'mutate',
+    'newSession': 'mutate',
+    'listWorkspaces': 'read-only',
+    'resolveWorkspace': 'mutate',
+    'switchWorkspace': 'mutate',
+    'renameWorkspace': 'mutate',
+    'workspaceCommands': 'read-only',
+    'runWorkspaceCommand': 'mutate',
+    'switchModel': 'mutate',
+    'listEfforts': 'mutate',
+    'setEffort': 'mutate',
+    'setDefaultEffort': 'mutate',
+    'cycleMode': 'mutate',
+    'permissionPresets': 'read-only',
+    'runPermissionPreset': 'mutate',
+    'listPresets': 'read-only',
+    'switchPreset': 'mutate',
+    'clear': 'mutate',
+    'loadOlder': 'mutate',
+    'notify': 'mutate',
+    'setActivityFrames': 'mutate',
+    'listModels': 'read-only',
+    'listProviders': 'read-only',
+    'invalidateModelCompletion': 'mutate',
+    'listSkills': 'read-only',
+    'describeCredential': 'read-only',
+    'balanceInfo': 'mutate',
+    'providerSetup': 'read-only',
+    'oauthProviderStatuses': 'read-only',
+    'settingsHost': 'read-only',
+    'settingsSections': 'read-only',
+    'subscribeSettingsSections': 'subscribe',
+    'listFileCandidates': 'read-only',
+    'listFiles': 'read-only',
+    'listSessions': 'read-only',
+    'previewSession': 'read-only',
+    'setResumeTarget': 'mutate',
+    'renameSession': 'mutate',
+    'setSessionColor': 'mutate',
+    'recapRecent': 'mutate',
+    'deleteSession': 'mutate',
+    'renameSessionTo': 'mutate',
+    'compact': 'mutate',
+    'pushLocal': 'mutate',
+    'mcpStatus': 'read-only',
+    'exportSession': 'mutate',
+    'initWorkspace': 'mutate',
+    'doctorInfo': 'read-only',
+    'pluginsInfo': 'mutate',
+    'listSubagents': 'read-only',
+    'agentViewRows': 'read-only',
+    'subscribeAgentView': 'subscribe',
+    'dispatchBackgroundAgent': 'mutate',
+    'stopBackgroundAgent': 'mutate',
+    'attachToAgent': 'mutate',
+    'peekAgentSession': 'read-only',
+    'backgroundCurrent': 'mutate',
+    'replyToAgent': 'mutate',
+    'traceEvents': 'read-only',
+    'subscribe': 'subscribe'
+});
+export const CHANNEL_UI_PROPERTIES = [
+    'version',
+    'rows',
+    'status',
+    'sessionTitle',
+    'sessionColor',
+    'agentId',
+    'agentBindingGeneration',
+    'autoRecapOnOpen',
+    'model',
+    'provider',
+    'configuredProvider',
+    'configuredModel',
+    'configuredPreset',
+    'configuredActivityFrames',
+    'configuredLang',
+    'tokens',
+    'cwd',
+    'displayCwd',
+    'gitBranch',
+    'working',
+    'cancelPending',
+    'spinnerMode',
+    'responseChars',
+    'activeToolCount',
+    'turnStart',
+    'lastUserText',
+    'notifications',
+    'contextWindow',
+    'reasoningEffort',
+    'effortLevels',
+    'lastUsage',
+    'tps',
+    'tpsSamples',
+    'workingActivity',
+    'activityFrames',
+    'diffLayout',
+    'thinkingFold',
+    'toolBackground',
+    'scrollGutter',
+    'pageMargin',
+    'foldTerminalCommand',
+    'promptSessionLabel',
+    'expandEditor',
+    'smoothStreaming',
+    'statusBar',
+    'whale',
+    'whaleIdle',
+    'minimal',
+    'activityEnabled',
+    'contextBarEnabled',
+    'goal',
+    'todos',
+    'loadedContext',
+    'pending',
+    'commandList',
+    'pluginScene',
+    'contextSegments',
+    'subagents',
+    'subagentControl',
+    'backgroundJobs',
+    'jobControl',
+    'mode',
+    'modeIndex',
+    'agentPreset'
+];
+const allProperties = true;
+void allProperties;

package/lib/types/adapter/channel/ui.d.ts

@@ -0,0 +1,16 @@
+/** In-process renderer capability, deliberately separate from JSON snapshots.
+ * Every returned executable handle captures the same channel lifetime. No
+ * handle can resolve a later registration or bypass policy through a factory.
+ */
+import { type AdapterMode } from '../kernel/runtime.js';
+import { type ChannelUi } from './ui-policy.js';
+export interface ChannelUiLease {
+    assertActive(): void;
+    own(dispose: () => void): () => void;
+}
+export declare function createChannelUiLease(isCurrent: () => boolean): ChannelUiLease & {
+    dispose(): void;
+};
+/** The same factory is used by the kernel and bare production composition. */
+export declare function createChannelUi(channel: ChannelUi, mode: AdapterMode, lease: ChannelUiLease): ChannelUi;
+//# sourceMappingURL=ui.d.ts.map

package/lib/types/adapter/channel/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../../../src/adapter/channel/ui.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAG3E,OAAO,EAA6C,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1F,MAAM,WAAW,cAAc;IAC7B,YAAY,IAAI,IAAI,CAAA;IACpB,GAAG,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;CACrC;AAOD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,OAAO,GAAG,cAAc,GAAG;IAAE,OAAO,IAAI,IAAI,CAAA;CAAE,CA6BnG;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,GAAG,SAAS,CAsGvG"}

package/lib/types/adapter/channel/ui.js

@@ -0,0 +1,168 @@
+/** In-process renderer capability, deliberately separate from JSON snapshots.
+ * Every returned executable handle captures the same channel lifetime. No
+ * handle can resolve a later registration or bypass policy through a factory.
+ */
+import { assertShadowPolicy } from '../kernel/runtime.js';
+import { completeCommands } from '../../commands.js';
+import { createChannelReadView } from './read-view.js';
+import { CHANNEL_UI_EFFECTS, CHANNEL_UI_PROPERTIES } from './ui-policy.js';
+function throwCleanupFailures(failures, message) {
+    if (failures.length === 1)
+        throw failures[0];
+    if (failures.length > 1)
+        throw new AggregateError(failures, message);
+}
+export function createChannelUiLease(isCurrent) {
+    let active = true;
+    const disposers = new Set();
+    return {
+        assertActive() {
+            if (!active || !isCurrent())
+                throw new Error('dsh-tui: Channel UI lifetime has ended');
+        },
+        own(dispose) {
+            let released = false;
+            const release = () => {
+                if (released)
+                    return;
+                released = true;
+                disposers.delete(release);
+                dispose();
+            };
+            if (!active || !isCurrent())
+                release();
+            else
+                disposers.add(release);
+            return release;
+        },
+        dispose() {
+            if (!active)
+                return;
+            active = false;
+            const failures = [];
+            for (const dispose of [...disposers]) {
+                try {
+                    dispose();
+                }
+                catch (error) {
+                    failures.push(error);
+                }
+            }
+            throwCleanupFailures(failures, 'dsh-tui: Channel UI cleanup failed');
+        },
+    };
+}
+/** The same factory is used by the kernel and bare production composition. */
+export function createChannelUi(channel, mode, lease) {
+    const check = (effect) => {
+        lease.assertActive();
+        assertShadowPolicy(effect, mode);
+    };
+    const read = createChannelReadView(mutation => check(mutation ? 'mutate' : 'read-only'));
+    const project = (value) => read(value, channel.version);
+    const query = (value) => createChannelReadView(mutation => check(mutation ? 'mutate' : 'read-only'))(value, 0);
+    const settle = (value) => {
+        if (value instanceof Promise)
+            return value.then(result => { check('read-only'); return query(result); });
+        return query(value);
+    };
+    function methods(target, effects) {
+        const result = {};
+        for (const key of Object.keys(effects)) {
+            const fn = target[key];
+            if (typeof fn !== 'function')
+                throw new Error(`dsh-tui: missing Channel handle method ${key}`);
+            result[key] = (...args) => {
+                check(effects[key]);
+                return settle(Reflect.apply(fn, target, args));
+            };
+        }
+        return Object.freeze(result);
+    }
+    const view = {};
+    for (const key of CHANNEL_UI_PROPERTIES) {
+        Object.defineProperty(view, key, {
+            enumerable: true,
+            get() {
+                check('read-only');
+                if (key === 'subagentControl')
+                    return methods(channel.subagentControl, { interrupt: 'mutate' });
+                if (key === 'jobControl')
+                    return channel.jobControl === undefined ? undefined : methods(channel.jobControl, { kill: 'mutate' });
+                if (key === 'autoRecapOnOpen' && (mode === 'passive-shadow' || mode === 'replay-shadow'))
+                    return false;
+                if (key === 'pluginScene') {
+                    const scene = channel.pluginScene;
+                    return scene === undefined ? undefined : project({ id: scene.id, title: scene.title });
+                }
+                return project(channel[key]);
+            },
+        });
+    }
+    for (const key of Object.keys(CHANNEL_UI_EFFECTS)) {
+        view[key] = (...args) => {
+            // Shadow probes may read the already-observed catalog/tier table, but
+            // must not warm service caches or emit query-error notifications.
+            if (mode === 'passive-shadow' || mode === 'replay-shadow') {
+                if (key === 'commandCompletions') {
+                    check('read-only');
+                    return completeCommands(String(args[0] ?? ''), channel.commandList);
+                }
+                if (key === 'listEfforts') {
+                    check('read-only');
+                    return Promise.resolve({ efforts: (channel.effortLevels ?? []).map(id => ({ id, name: id })), defaultEffort: undefined });
+                }
+            }
+            // A renderer observes the already-owned Channel emitter, never mounts
+            // upstream service listeners. Keep this local observation distinct from
+            // Host Port subscribe capabilities, whose shadow policy is unchanged.
+            const observation = key === 'subscribe' || key === 'subscribeAgentView' || key === 'subscribeSettingsSections';
+            check(observation ? 'read-only' : CHANNEL_UI_EFFECTS[key]);
+            const result = Reflect.apply(channel[key], channel, args);
+            if (key === 'notify') {
+                const timeout = args[1]?.timeoutMs ?? 4000;
+                let timer;
+                const release = lease.own(() => { if (timer !== undefined)
+                    clearTimeout(timer); result(); });
+                if (timeout > 0)
+                    timer = setTimeout(release, timeout);
+                return release;
+            }
+            if (observation)
+                return lease.own(result);
+            if (key === 'settingsHost' && result !== undefined) {
+                return methods(result, {
+                    listNamespaces: 'read-only', credentialConfigured: 'read-only', write: 'mutate', writeCredential: 'mutate',
+                });
+            }
+            if (key === 'providerSetup' && result !== undefined) {
+                const host = result;
+                const { oauth, ...base } = host;
+                return Object.freeze({
+                    ...methods(base, {
+                        listCatalogProviders: 'read-only', listConfiguredProviders: 'read-only', listRefUsers: 'read-only',
+                        routeExists: 'read-only', envShadows: 'read-only', envValue: 'mutate', readCredential: 'mutate',
+                        discoverModels: 'mutate', writeCredential: 'mutate', removeCredential: 'mutate',
+                        writeProfile: 'mutate', mutateProfile: 'mutate', removeProfile: 'mutate',
+                    }),
+                    ...(oauth === undefined ? {} : { oauth: methods(oauth, { providers: 'read-only', login: 'mutate', logout: 'mutate' }) }),
+                });
+            }
+            // The session event log is an append-only, JSON-safe read whose snapshot
+            // array is replaced by the session on every append. Running it through
+            // the detached read projection cost O(events) per call, and Chat folds
+            // the trajectory from it on EVERY render: a long session (hundreds of
+            // thousands of chunks) paid hundreds of milliseconds per frame while
+            // streaming or scrolling — measured 322us @2k events, 2.7ms @20k,
+            // 65ms @200k. The snapshot array is already frozen by the session, so
+            // hand it back as-is; the lease/shadow `check()` above still gates the
+            // call itself (same contract as before the Channel UI split).
+            if (key === 'traceEvents')
+                return result;
+            if (key === 'agentViewRows' || key === 'settingsSections')
+                return project(result);
+            return settle(result);
+        };
+    }
+    return Object.freeze(view);
+}

package/lib/types/adapter/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * TUI Adapter v2 incremental skeleton.
+ *
+ * Layering:
+ * - ports/     pure internal Host Ports (no @deepseek-ai, no dsh-std protocol)
+ * - kernel/    runtime/lifecycle/ownership/host-facade/diagnostics
+ * - upstream/  future-only home for @deepseek-ai/* drivers
+ * - standard/  canonical @dsh-std/* + TUI admission/descriptor/grants
+ * - spec/      thin dsh-ecosystem-spec / conformance loading layer
+ *
+ * Existing public subpaths and Cordis service names are unchanged during this
+ * incremental migration.
+ */
+export * from './ports/index.js';
+export * from './kernel/index.js';
+export * from './upstream/index.js';
+export * from './channel/index.js';
+export * from './standard/index.js';
+export * from './spec/index.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/types/adapter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapter/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA"}

package/lib/types/adapter/index.js

@@ -0,0 +1,19 @@
+/**
+ * TUI Adapter v2 incremental skeleton.
+ *
+ * Layering:
+ * - ports/     pure internal Host Ports (no @deepseek-ai, no dsh-std protocol)
+ * - kernel/    runtime/lifecycle/ownership/host-facade/diagnostics
+ * - upstream/  future-only home for @deepseek-ai/* drivers
+ * - standard/  canonical @dsh-std/* + TUI admission/descriptor/grants
+ * - spec/      thin dsh-ecosystem-spec / conformance loading layer
+ *
+ * Existing public subpaths and Cordis service names are unchanged during this
+ * incremental migration.
+ */
+export * from './ports/index.js';
+export * from './kernel/index.js';
+export * from './upstream/index.js';
+export * from './channel/index.js';
+export * from './standard/index.js';
+export * from './spec/index.js';

package/lib/types/adapter/kernel/contract-catalog.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Kernel-facing view of the spec-derived host contract catalog.
+ *
+ * Upstream drivers receive the concrete contract/event catalog through this
+ * Kernel module rather than importing Standard/Spec implementation files. The
+ * values are still derived once in `src/adapter/spec/protocol-constants.ts`;
+ * this module only re-exports them for the driver boundary.
+ */
+import { HOST_SUPPORTED_CONTRACTS, TUI_DECISION_EVENT_NAMES } from '../spec/protocol-constants.js';
+export { HOST_SUPPORTED_CONTRACTS as KERNEL_HOST_SUPPORTED_CONTRACTS };
+export { TUI_DECISION_EVENT_NAMES as KERNEL_TUI_DECISION_EVENT_NAMES };
+//# sourceMappingURL=contract-catalog.d.ts.map

package/lib/types/adapter/kernel/contract-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-catalog.d.ts","sourceRoot":"","sources":["../../../../src/adapter/kernel/contract-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AAElG,OAAO,EAAE,wBAAwB,IAAI,+BAA+B,EAAE,CAAA;AACtE,OAAO,EAAE,wBAAwB,IAAI,+BAA+B,EAAE,CAAA"}

package/lib/types/adapter/kernel/contract-catalog.js

@@ -0,0 +1,11 @@
+/**
+ * Kernel-facing view of the spec-derived host contract catalog.
+ *
+ * Upstream drivers receive the concrete contract/event catalog through this
+ * Kernel module rather than importing Standard/Spec implementation files. The
+ * values are still derived once in `src/adapter/spec/protocol-constants.ts`;
+ * this module only re-exports them for the driver boundary.
+ */
+import { HOST_SUPPORTED_CONTRACTS, TUI_DECISION_EVENT_NAMES } from '../spec/protocol-constants.js';
+export { HOST_SUPPORTED_CONTRACTS as KERNEL_HOST_SUPPORTED_CONTRACTS };
+export { TUI_DECISION_EVENT_NAMES as KERNEL_TUI_DECISION_EVENT_NAMES };