@askdkc/dsh-cli 0.11.3

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

@@ -0,0 +1,96 @@
+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);
+    /**
+     * The workspace home screen's sidebar: the durable ledger's own listing.
+     *
+     * `listWorkspaces()` cannot serve this — it merges provider targets, drops
+     * entries with no sessions, and appends the live cwd, so a registered-but-
+     * empty workspace would not be listed at all. This reads the registry
+     * directly and only adds what the ledger does not know: whether the
+     * directory still exists.
+     */
+    const listWorkspaceRegistry = () => service.listRegistry();
+    /** Forget a registration. Sessions are untouched; removing the live workspace is refused. */
+    const removeWorkspace = async (path) => {
+        deps.owner.assertActive();
+        try {
+            const removed = await service.remove(path);
+            if (!removed) {
+                notify(t('workspace-remove-unknown', { target: path }), { color: 'warning', timeoutMs: 8000 });
+                return false;
+            }
+            notify(t('workspace-removed', { target: path }));
+            return true;
+        }
+        catch (error) {
+            notify(t('workspace-remove-failed', { err: error instanceof Error ? error.message : String(error) }), { color: 'error', timeoutMs: 8000 });
+            return false;
+        }
+    };
+    /** Rename the workspace at `path` (not necessarily the live one). */
+    const renameWorkspaceAt = async (path, title) => {
+        deps.owner.assertActive();
+        try {
+            const renamed = await service.rename(path, title);
+            notify(t('workspace-renamed', { title: renamed.label }));
+            return true;
+        }
+        catch (error) {
+            notify(t('workspace-rename-failed', { err: error instanceof Error ? error.message : String(error) }), { color: 'error', timeoutMs: 8000 });
+            return false;
+        }
+    };
+    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, listWorkspaceRegistry, removeWorkspace, renameWorkspaceAt, 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');
+        },
+    };
+}

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

@@ -0,0 +1,23 @@
+import { type ChannelLaunchOptions } from './channel/state.js';
+import type { Context } from '@deepseek-ai/cordis';
+import { type Agent } from '@deepseek-ai/dsh-agent';
+import type { ChannelState } from './channel/types.js';
+export type { SubagentState } from './subagents.js';
+/**
+ * Create the live channel state for one agent session: replay the durable
+ * transcript, subscribe to the agent's events, and expose every TUI action.
+ * @internal
+ * @param ctx - The plugin context; optional services are resolved via ctx.get.
+ * @param initialAgent - The agent whose session the channel renders; rewinds,
+ *   resumes, and model switches replace it.
+ * @param options - Boot options: model route, cwd, provider, and the
+ *   reasoning-effort / working-activity / agent-handle preferences.
+ * @returns The live channel state, subscribed and ready to render.
+ */
+export declare function createChannel(ctx: Context, initialAgent: Agent, options: ChannelLaunchOptions): ChannelState;
+export type { ChannelLaunchOptions } from './channel/state.js';
+export { expandMentions } from './channel/mentions.js';
+export { sessionCwdMatches } from './channel/paths.js';
+export type { AgentViewDispatchResult, AgentViewRow, AgentViewStatus, BackgroundResult, Channel, ChannelGoal, ChannelState, ChatRow, ComposerImageRef, ComposerSubmission, CredentialStatus, EffortOption, ExternalCommandOutcome, JobControl, JobRow, LoadedContext, LoadedContextEntry, LoadedContextFile, LoadedContextSkill, LoadedContextTool, MentionAttachments, MentionExpansion, MentionFs, NotificationItem, PendingMessage, PermissionPresetAvailability, PermissionPresetCurrent, PermissionPresetOption, PermissionPresetSnapshot, PresetOption, ResumeResult, SkillInfo, StagedImageHandle, StagedImageInput, SubagentControl, SubagentRow, TodoPanelItem, TokenBucket, TokenUsage, ToolCallView, ToolFileDiff, ToolResultView, ToolRow, ToolViewPresenter, TranscriptImage } from './channel/types.js';
+export { emptyTokenUsage } from './channel/usage.js';
+//# sourceMappingURL=channel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/channel.ts"],"names":[],"mappings":"AASA,OAAO,EAA4B,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AA4BxF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,KAAK,KAAK,EAAqE,MAAM,wBAAwB,CAAA;AAyCtH,OAAO,KAAK,EAAyD,YAAY,EAA8T,MAAM,oBAAoB,CAAA;AAgCza,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAkBnD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,OAAO,EACZ,YAAY,EAAE,KAAK,EACnB,OAAO,EAAE,oBAAoB,GAC5B,YAAY,CAUd;AA46BD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,YAAY,EAAE,uBAAuB,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,YAAY,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACrxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA"}