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

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

@@ -0,0 +1,162 @@
+import type { ChannelUi } from '../../adapter/ports/channel-ui.js';
+import type { ChatRow, ToolCallView, ToolResultView, NotificationItem, TodoPanelItem, PendingMessage } from '../../adapter/ports/channel-view.js';
+export type { ChatRow, ToolRow, ToolCallView, ToolFileDiff, ToolResultView, SubagentRow, JobRow, TokenUsage, TokenBucket, NotificationItem, ActivityStatus, ChannelGoal, TodoPanelItem, LoadedContext, LoadedContextEntry, LoadedContextFile, LoadedContextSkill, LoadedContextTool, PendingMessage, SubagentControl, JobControl, StagedImageInput, StagedImageHandle, ComposerImageRef, ComposerSubmission, ExternalCommandOutcome, TranscriptImage, ResumeResult, EffortOption, PermissionPresetSnapshot, PermissionPresetAvailability, PermissionPresetOption, PermissionPresetCurrent, PresetOption, SkillInfo, CredentialStatus, AgentViewRow, AgentViewStatus, AgentViewDispatchResult, BackgroundResult } from '../../adapter/ports/channel-view.js';
+import { type ContentBlock, type StreamChunk } from '@deepseek-ai/dsh-llm';
+import { type SessionEvent } from '@deepseek-ai/dsh-session';
+import { type BackgroundJobState } from '../jobs.js';
+import { type TuiSceneDescriptor } from '../scenes.js';
+import { type SubagentState } from '../subagents.js';
+/** dsh-llm LlmRuntime as the side-question needs it: one streaming call. */
+export type SideQuestionLlm = {
+    stream(options: object): AsyncIterable<StreamChunk>;
+};
+export type PermissionPresetService = {
+    names?: unknown;
+    current?: (events: readonly SessionEvent[]) => unknown;
+    optionOf?: (name: string) => unknown;
+};
+export type ChannelImageBlock = Extract<ContentBlock, {
+    type: 'image';
+}>;
+export type ChannelImageMediaType = ChannelImageBlock['attachment']['mediaType'];
+/** The dsh-tools registry seam dsh-tui reads presentations through. The
+ *  registry lives on the host plane; `get` takes the live agent as the
+ *  scope so a preset's own tool definitions resolve (dsh-host-apiproxy's
+ *  presenter pattern). */
+export interface ToolsRegistryLike {
+    get(name: string, scope?: unknown): {
+        presentCall?(args: unknown): unknown;
+        presentResult?(args: unknown, result: unknown): unknown;
+    } | undefined;
+}
+/** Re-derives the presentation views foldRows dropped, threaded into
+ *  foldBack (module-level, no ctx access) by the channel. */
+export interface ToolViewPresenter {
+    call(name: string, rawArgs: string): ToolCallView | undefined;
+    result(name: string, rawArgs: string, data: SessionEvent<'tool/result'>['data']): ToolResultView | undefined;
+}
+/** Raw host implementation; the renderer receives ChannelUi instead. */
+export interface Channel extends Omit<ChannelUi, 'pluginScene' | 'traceEvents'> {
+    readonly pluginScene: TuiSceneDescriptor | undefined;
+    traceEvents(): readonly SessionEvent[];
+    releaseContributions(): void;
+}
+type MutableChannelView = {
+    -readonly [K in keyof ChannelUi]: ChannelUi[K];
+};
+/** Internal writable store; command signatures are owned once by ChannelUi. */
+export interface ChannelState extends Omit<MutableChannelView, 'rows' | 'notifications' | 'todos' | 'pending' | 'tpsSamples' | 'subagents' | 'backgroundJobs' | 'pluginScene' | 'traceEvents'> {
+    rows: ChatRow[];
+    notifications: NotificationItem[];
+    /** Per-turn tps samples (sparkline history), oldest first. */
+    tpsSamples: {
+        tps: number;
+        at: number;
+    }[];
+    /** Latest todo-list snapshot (see the public Channel type). */
+    todos: TodoPanelItem[];
+    /** Messages submitted while working, awaiting their turn/step boundary.
+     *  Driven by agent inbox events (inserted/claimed/discarded). */
+    pending: PendingMessage[];
+    /** Open plugin scene mirrored from the scenes runtime (see the public Channel type). */
+    pluginScene: TuiSceneDescriptor | undefined;
+    /** Active subagents roster (see the public Channel type). */
+    subagents: readonly SubagentState[];
+    /** Background jobs of the current session (see the public Channel type). */
+    backgroundJobs: readonly BackgroundJobState[];
+    /** @internal event bump (the public `notify(text)` posts a notification). */
+    emit(): void;
+    /** @internal frame-aligned emit for high-frequency streaming deltas:
+     *  version bumps synchronously but listeners fire at most once per 16ms
+     *  window (trailing edge). */
+    emitStream(): void;
+    /**
+     * Bind the plugin's approval store (post-construction): row derivation
+     * reads its parked ask ids for the "needs input" state, and its emits
+     * re-publish as agent-view changes.
+     */
+    bindApprovalStore(store: {
+        pendingAgentIds(): readonly string[];
+        pendingAgentDetail(agentId: string): {
+            toolName: string;
+            reason?: string;
+            command?: string;
+        } | undefined;
+        subscribe(listener: () => void): () => void;
+    }): void;
+    /** See {@link Channel.releaseContributions}. */
+    releaseContributions(): void;
+    /** Live session event log (see the public Channel type, `/trace`). */
+    traceEvents(): readonly SessionEvent[];
+}
+export type FileSuggestionFs = {
+    resolve(path: string): Promise<{
+        displayPath: string;
+    }>;
+    listDir(target: {
+        displayPath: string;
+    }): Promise<Array<{
+        name: string;
+        type: 'file' | 'directory' | 'other';
+        target?: {
+            displayPath: string;
+        };
+    }>>;
+};
+/** The fs-service surface `@`-mention expansion consumes (dsh-fs-local). */
+export interface MentionFs {
+    resolve(path: string): Promise<{
+        displayPath: string;
+    }>;
+    stat(target: {
+        displayPath: string;
+    }): Promise<{
+        type: 'file' | 'directory' | 'other';
+    } | undefined>;
+    readText(target: {
+        displayPath: string;
+    }): Promise<string>;
+    readBytes?(target: {
+        displayPath: string;
+    }, signal: AbortSignal | undefined, maxBytes: number): Promise<Uint8Array>;
+    listDir(target: {
+        displayPath: string;
+    }): Promise<Array<{
+        name: string;
+        type: 'file' | 'directory' | 'other';
+    }>>;
+}
+export type MentionImageBlock = ChannelImageBlock;
+export type MentionImageMediaType = ChannelImageMediaType;
+/** Attachment subset used to turn an image path into a durable user block. */
+export interface MentionAttachments {
+    readonly imageLimits: {
+        readonly maxImageBytes: number;
+        readonly maxImagesPerMessage: number;
+        readonly maxMessageImageBytes: number;
+        readonly mediaTypes: readonly MentionImageMediaType[];
+    };
+    saveImage(input: {
+        data: Uint8Array;
+        mediaType: MentionImageMediaType;
+        name?: string;
+    }): Promise<MentionImageBlock['attachment']>;
+}
+/** One mention target that resolved and stat'ed to something attachable. */
+export interface ResolvedMention {
+    target: {
+        displayPath: string;
+    };
+    info: {
+        type: 'file' | 'directory' | 'other';
+    };
+}
+export interface MentionExpansion {
+    /** Model-facing blocks: the typed text first, one block per attachment. */
+    blocks: ContentBlock[];
+    /** Paths that resolved and were attached (for the confirmation notice). */
+    attached: string[];
+    /** Mention tokens that failed to resolve (kept literal, warned about). */
+    missing: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,13 @@
+import { type StreamChunk } from '@deepseek-ai/dsh-llm';
+import type { TokenUsage } from './types.js';
+/** 全零 token 累计（新会话 / 复位用）。 */
+export declare function emptyTokenUsage(): TokenUsage;
+/** Context-bar token estimate (pi-nano-context: ~4 chars per token). */
+export declare function estimateTokens(text: string): number;
+/** Whether one stream chunk advances the first-token/decode boundary. */
+export declare function isTokenDelta(chunk: StreamChunk): boolean;
+/** Character payload of one token-bearing stream delta for the live fallback. */
+export declare function tokenDeltaChars(chunk: StreamChunk): number;
+/** Provider output count when usable; durable imports may predate strict validation. */
+export declare function usageOutputTokens(usage: unknown): number | undefined;
+//# sourceMappingURL=usage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,8BAA8B;AAC9B,wBAAgB,eAAe,IAAI,UAAU,CAS5C;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAUxD;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAU1D;AAED,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAMpE"}

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

@@ -0,0 +1,48 @@
+/** 全零 token 累计（新会话 / 复位用）。 */
+export function emptyTokenUsage() {
+    return {
+        input: 0,
+        output: 0,
+        cacheRead: 0,
+        cacheWrite: 0,
+        peak: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+        idle: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+    };
+}
+/** Context-bar token estimate (pi-nano-context: ~4 chars per token). */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/** Whether one stream chunk advances the first-token/decode boundary. */
+export function isTokenDelta(chunk) {
+    switch (chunk.type) {
+        case 'text-delta':
+        case 'reasoning-delta':
+            return chunk.text !== '';
+        case 'tool-call-delta':
+            return chunk.argumentsDelta !== '' || chunk.name !== undefined;
+        default:
+            return false;
+    }
+}
+/** Character payload of one token-bearing stream delta for the live fallback. */
+export function tokenDeltaChars(chunk) {
+    switch (chunk.type) {
+        case 'text-delta':
+        case 'reasoning-delta':
+            return chunk.text.length;
+        case 'tool-call-delta':
+            return (chunk.name?.length ?? 0) + chunk.argumentsDelta.length;
+        default:
+            return 0;
+    }
+}
+/** Provider output count when usable; durable imports may predate strict validation. */
+export function usageOutputTokens(usage) {
+    if (typeof usage !== 'object' || usage === null)
+        return undefined;
+    const value = usage.outputTokens;
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0
+        ? value
+        : undefined;
+}

package/lib/types/dsh-adapter/channel/workspace-actions.d.ts

@@ -0,0 +1,20 @@
+import type { TuiWorkspaceHost, TuiWorkspaceTarget } from '../workspaces.js';
+import type { ChannelOwner } from './owner.js';
+import type { NewSessionTarget } from './session-resume.js';
+import type { ChannelState } from './types.js';
+/** Workspace command/query surface. The selected cwd is published only by a successful session adoption. */
+export declare function createWorkspaceActions(state: Pick<ChannelState, 'cwd' | 'displayCwd' | 'working' | 'emit'>, deps: {
+    owner: Pick<ChannelOwner, 'assertActive'>;
+    service: TuiWorkspaceHost;
+    newSession(target?: NewSessionTarget): Promise<boolean>;
+    refreshGitBranch(): void;
+    notify: ChannelState['notify'];
+}): {
+    listWorkspaces: () => Promise<readonly TuiWorkspaceTarget[]>;
+    resolveWorkspace: (uri: string) => Promise<TuiWorkspaceTarget | undefined>;
+    switchWorkspace: (target: TuiWorkspaceTarget) => Promise<boolean>;
+    renameWorkspace: (title: string) => Promise<boolean>;
+    workspaceCommands: () => readonly Pick<import("../workspaces.js").TuiWorkspaceCommand, "name" | "description" | "aliases">[];
+    runWorkspaceCommand: (name: string, input: string) => Promise<import("../workspaces.js").TuiWorkspaceCommandResult | undefined>;
+};
+//# sourceMappingURL=workspace-actions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-actions.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/workspace-actions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,4GAA4G;AAC5G,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,KAAK,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC,EACpE,IAAI,EAAE;IACJ,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAA;IACzC,OAAO,EAAE,gBAAgB,CAAA;IACzB,UAAU,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACvD,gBAAgB,IAAI,IAAI,CAAA;IACxB,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;CAC/B;;4BAI8B,MAAM;8BACE,kBAAkB,KAAG,OAAO,CAAC,OAAO,CAAC;6BAsBtC,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;;gCAauF,MAAM,SAAS,MAAM;EAC5K"}

package/lib/types/dsh-adapter/channel/workspace-actions.js

@@ -0,0 +1,56 @@
+import { statSync } from 'node:fs';
+import { t } from '../../i18n.js';
+/** Workspace command/query surface. The selected cwd is published only by a successful session adoption. */
+export function createWorkspaceActions(state, deps) {
+    const { service, notify } = deps;
+    const listWorkspaces = () => service.list(state.cwd);
+    const resolveWorkspace = (uri) => service.resolve(uri, state.cwd);
+    const switchWorkspace = async (target) => {
+        deps.owner.assertActive();
+        if (state.working) {
+            notify(t('workspace-switch-working'), { color: 'warning' });
+            return false;
+        }
+        if (target.kind === 'local') {
+            try {
+                if (!statSync(target.cwd).isDirectory())
+                    throw new Error('not a directory');
+            }
+            catch {
+                notify(t('workspace-open-invalid', { target: target.label }), { color: 'error', timeoutMs: 8000 });
+                return false;
+            }
+        }
+        // Keep the target private to the guarded create/adopt transaction.  In
+        // particular, do not speculate into shared cwd/displayCwd and then try to
+        // roll it back: a slower failed request must never erase a newer success.
+        try {
+            const switched = await deps.newSession({ cwd: target.cwd, displayCwd: target.description ?? target.uri });
+            if (!switched)
+                return false;
+            deps.refreshGitBranch();
+            notify(t('workspace-switched', { target: target.label }));
+            state.emit();
+            return true;
+        }
+        catch (error) {
+            notify(t('workspace-command-failed', { err: error instanceof Error ? error.message : String(error) }), { color: 'error', timeoutMs: 8000 });
+            return false;
+        }
+    };
+    const renameWorkspace = async (title) => {
+        deps.owner.assertActive();
+        try {
+            const renamed = await service.rename(state.cwd, title);
+            state.displayCwd = renamed.description ?? renamed.uri;
+            notify(t('workspace-renamed', { title: renamed.label }));
+            state.emit();
+            return true;
+        }
+        catch (error) {
+            notify(t('workspace-rename-failed', { err: error instanceof Error ? error.message : String(error) }), { color: 'error', timeoutMs: 8000 });
+            return false;
+        }
+    };
+    return { listWorkspaces, resolveWorkspace, switchWorkspace, renameWorkspace, workspaceCommands: () => service.commands(), runWorkspaceCommand: (name, input) => service.runCommand(name, input, state.cwd) };
+}

package/lib/types/dsh-adapter/channel-facade-actions.d.ts

@@ -0,0 +1,25 @@
+/**
+ * T1 Channel-facade action helpers.
+ *
+ * These helpers route production Channel notifications/submits through the
+ * shadow-guarded `HostFacade.channel.actions` when available. In
+ * passive/replay shadow modes they never fall back to the native Channel:
+ * if the facade is missing or the shadow policy rejects the action, the call
+ * is dropped instead of bypassing the guard.
+ */
+import type { AdapterRuntimeOptions } from '../adapter/kernel/runtime.js';
+export interface ChannelFacadeNotifyOptions {
+    readonly color?: 'error' | 'warning' | 'success';
+    readonly timeoutMs?: number;
+}
+export type ChannelFacadeRuntime = AdapterRuntimeOptions;
+export type ChannelFacadeActionOutcome = 'facade' | 'native' | 'dropped';
+/** Route a notification through HostFacade.channel when safely possible. */
+export declare function notifyViaChannelFacade(pluginHost: unknown, nativeChannel: {
+    notify(text: string, options?: ChannelFacadeNotifyOptions): unknown;
+}, runtime: ChannelFacadeRuntime, text: string, options?: ChannelFacadeNotifyOptions): ChannelFacadeActionOutcome;
+/** Route a submit through HostFacade.channel when safely possible. */
+export declare function submitViaChannelFacade(pluginHost: unknown, nativeChannel: {
+    submit(text: string): void;
+}, runtime: ChannelFacadeRuntime, text: string): ChannelFacadeActionOutcome;
+//# sourceMappingURL=channel-facade-actions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel-facade-actions.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/channel-facade-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AAGzE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAA;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,CAAA;AAExD,MAAM,MAAM,0BAA0B,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;AAMxE,4EAA4E;AAC5E,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,OAAO,EACnB,aAAa,EAAE;IAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAA;CAAE,EACtF,OAAO,EAAE,oBAAoB,EAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,0BAA0B,GACnC,0BAA0B,CAiB5B;AAED,sEAAsE;AACtE,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,OAAO,EACnB,aAAa,EAAE;IAAE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAC7C,OAAO,EAAE,oBAAoB,EAC7B,IAAI,EAAE,MAAM,GACX,0BAA0B,CAe5B"}

package/lib/types/dsh-adapter/channel-facade-actions.js

@@ -0,0 +1,55 @@
+/**
+ * T1 Channel-facade action helpers.
+ *
+ * These helpers route production Channel notifications/submits through the
+ * shadow-guarded `HostFacade.channel.actions` when available. In
+ * passive/replay shadow modes they never fall back to the native Channel:
+ * if the facade is missing or the shadow policy rejects the action, the call
+ * is dropped instead of bypassing the guard.
+ */
+import { getHostFacade } from './plugin-host.js';
+function isShadowAdapterRuntime(runtime) {
+    return runtime.mode === 'passive-shadow' || runtime.mode === 'replay-shadow';
+}
+/** Route a notification through HostFacade.channel when safely possible. */
+export function notifyViaChannelFacade(pluginHost, nativeChannel, runtime, text, options) {
+    const facade = getHostFacade(pluginHost);
+    if (facade?.channel !== undefined) {
+        try {
+            facade.channel.actions.notify(text, options);
+            return 'facade';
+        }
+        catch (error) {
+            if (isShadowAdapterRuntime(runtime))
+                return 'dropped';
+            // Non-shadow: a facade that exists but throws is not a "not mounted"
+            // condition; surface it instead of silently falling back to native.
+            throw error;
+        }
+    }
+    else if (isShadowAdapterRuntime(runtime)) {
+        return 'dropped';
+    }
+    nativeChannel.notify(text, options);
+    return 'native';
+}
+/** Route a submit through HostFacade.channel when safely possible. */
+export function submitViaChannelFacade(pluginHost, nativeChannel, runtime, text) {
+    const facade = getHostFacade(pluginHost);
+    if (facade?.channel !== undefined) {
+        try {
+            facade.channel.actions.submit(text);
+            return 'facade';
+        }
+        catch (error) {
+            if (isShadowAdapterRuntime(runtime))
+                return 'dropped';
+            throw error;
+        }
+    }
+    else if (isShadowAdapterRuntime(runtime)) {
+        return 'dropped';
+    }
+    nativeChannel.submit(text);
+    return 'native';
+}

package/lib/types/dsh-adapter/channel-scene-outlet.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import type { ChannelUi } from '../adapter/ports/channel-ui.js';
+import type { TuiSceneDescriptor } from './scenes.js';
+/** Renderer-only outlet. Component identity stays in the existing scene registry. */
+export declare function createChannelSceneOutlet(current: () => TuiSceneDescriptor | undefined): (id: string, channel: ChannelUi) => React.ReactNode;
+//# sourceMappingURL=channel-scene-outlet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel-scene-outlet.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/channel-scene-outlet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,kBAAkB,GAAG,SAAS,IAC5E,IAAI,MAAM,EAAE,SAAS,SAAS,KAAG,KAAK,CAAC,SAAS,CAOzD"}

package/lib/types/dsh-adapter/channel-scene-outlet.js

@@ -0,0 +1,13 @@
+import React from 'react';
+import * as ui from '../ui.js';
+/** Renderer-only outlet. Component identity stays in the existing scene registry. */
+export function createChannelSceneOutlet(current) {
+    return (id, channel) => {
+        const scene = current();
+        if (scene?.id !== id)
+            throw new Error(`Scene unavailable: ${id}`);
+        return React.createElement(scene.component, {
+            React, ui, channel, close: () => channel.closePluginScene(),
+        });
+    };
+}

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

@@ -0,0 +1,9 @@
+/** Production assembly for the in-process Channel renderer capability. */
+import type { ChannelState } from './channel.js';
+import type { ChannelUi } from '../adapter/channel/ui-policy.js';
+import type { AdapterMode } from '../adapter/kernel/runtime.js';
+export declare function mountChannelUi(ctx: unknown, channel: ChannelState, pluginHost: unknown, mode: AdapterMode): {
+    channel: ChannelUi;
+    dispose(): void;
+};
+//# sourceMappingURL=channel-ui.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel-ui.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/channel-ui.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAGhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAY/D,wBAAgB,cAAc,CAC5B,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,WAAW,GAChB;IAAE,OAAO,EAAE,SAAS,CAAC;IAAC,OAAO,IAAI,IAAI,CAAA;CAAE,CAkGzC"}

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

@@ -0,0 +1,128 @@
+import { bindChannelOwner, disposeChannelOwner, onChannelOwnerDispose } from './channel/owner.js';
+import { createChannelUi, createChannelUiLease } from '../adapter/channel/ui.js';
+import { getHostFacade } from './plugin-host.js';
+import { getTuiChannelRegistration, onTuiChannelRegistration } from '../adapter/channel/host-registry.js';
+function throwCleanupFailures(failures, message) {
+    if (failures.length === 1)
+        throw failures[0];
+    if (failures.length > 1)
+        throw new AggregateError(failures, message);
+}
+/** Re-probe interval while the kernel's channel slice is still absent. */
+const FACADE_PROBE_MS = 250;
+export function mountChannelUi(ctx, channel, pluginHost, mode) {
+    // A registration, rather than Channel object equality, is the authority for
+    // this mount. Re-registering the same Channel revokes retained UI handles.
+    const registration = getTuiChannelRegistration(ctx);
+    let ownerActive = true;
+    const lease = createChannelUiLease(() => ownerActive && getTuiChannelRegistration(ctx) === registration);
+    const releaseOwnerLease = onChannelOwnerDispose(channel, () => {
+        ownerActive = false;
+        lease.dispose();
+    });
+    const unsubscribe = onTuiChannelRegistration(ctx, next => {
+        if (next === registration)
+            return;
+        // Even a throwing notification cleanup cannot skip owner teardown.
+        try {
+            lease.dispose();
+        }
+        finally {
+            // Same-object registration only revokes this capability, not its successor.
+            if (next?.channel !== channel)
+                disposeChannelOwner(channel);
+        }
+    });
+    const local = createChannelUi(channel, mode, {
+        own: lease.own,
+        assertActive() {
+            lease.assertActive();
+            const current = resolve();
+            if (current !== local)
+                void current.version;
+        },
+    });
+    // Before async kernel mount (or with the channel slice disabled), use
+    // the identical guarded local capability. Never downgrade after binding.
+    let mounted;
+    let mountedView;
+    // `getHostFacade()` builds a fresh facade graph on every call (KernelRuntime
+    // facade() allocates a new descriptor port + shadow-guarded wrapper), and
+    // `resolve()` runs on EVERY `channel.X` read — Chat reads ~70-90 properties
+    // per render, so re-resolving per read cost ~2.3us each (~0.2-0.4ms/frame)
+    // for a value that only ever changes when the kernel mounts the channel
+    // slice. Probe at most every FACADE_PROBE_MS while the slice is absent;
+    // once the facade exposes the channel UI, it stays that way for the
+    // kernel's lifetime (a re-registration disposes this mount's lease).
+    let facadeProbe;
+    let facadeProbeAt = 0;
+    let facadeProbeLocked = false;
+    const facadeNow = () => {
+        if (facadeProbeLocked)
+            return facadeProbe;
+        const now = Date.now();
+        if (facadeProbe !== undefined && now - facadeProbeAt < FACADE_PROBE_MS)
+            return facadeProbe;
+        facadeProbeAt = now;
+        facadeProbe = getHostFacade(pluginHost);
+        if (facadeProbe?.channel !== undefined)
+            facadeProbeLocked = true;
+        return facadeProbe;
+    };
+    const resolve = () => {
+        lease.assertActive();
+        const facade = facadeNow();
+        const ui = facade?.channel?.projection.ui;
+        if (ui === undefined) {
+            if (mounted !== undefined)
+                throw new Error('dsh-tui: mounted HostFacade lost Channel UI');
+            return local;
+        }
+        const next = ui();
+        if (next !== mounted) {
+            mounted = next;
+            mountedView = createChannelUi(next, mode, lease);
+        }
+        return mountedView;
+    };
+    // This external check does not resolve UI: owner.current() is called by
+    // leases, so resolving here would recurse through the owner guard.
+    bindChannelOwner(channel, () => ownerActive && getTuiChannelRegistration(ctx) === registration);
+    const view = Object.create(null);
+    for (const key of Object.keys(local)) {
+        Object.defineProperty(view, key, {
+            enumerable: true,
+            get() {
+                const value = resolve()[key];
+                if (typeof value !== 'function')
+                    return value;
+                return (...args) => {
+                    lease.assertActive();
+                    const current = resolve();
+                    return Reflect.apply(current[key], current, args);
+                };
+            },
+        });
+    }
+    return {
+        channel: Object.freeze(view),
+        dispose() {
+            const failures = [];
+            const releaseOwner = () => {
+                const current = getTuiChannelRegistration(ctx);
+                // An old mount's late cleanup must not dispose a newer mount of A.
+                if (current === registration || current?.channel !== channel)
+                    disposeChannelOwner(channel);
+            };
+            for (const cleanup of [unsubscribe, () => lease.dispose(), releaseOwnerLease, releaseOwner]) {
+                try {
+                    cleanup();
+                }
+                catch (error) {
+                    failures.push(error);
+                }
+            }
+            throwCleanupFailures(failures, 'dsh-tui: Channel UI cleanup failed');
+        },
+    };
+}