@askdkc/dsh-cli 0.11.3

package/lib/types/adapter/upstream/workspace-driver.js

@@ -0,0 +1,198 @@
+/**
+ * Upstream driver for the TUI workspace capability.
+ *
+ * This driver detects the `tuiWorkspaces` service and its host-only facade,
+ * performs real read-only enumeration/resolution probes in `verifyLive`, and
+ * mounts a thin Host Workspace Port over the same legacy host facade. It
+ * deliberately does not import Standard/Spec and does not define protocol
+ * semantics.
+ *
+ * Publication is feature-level: only the methods actually verified by a
+ * read-only/reversible probe are promoted to live. Mutating methods
+ * (rename/runCommand) and command-shell execution remain degraded in P3
+ * because they cannot be safely auto-reversed on a real host.
+ */
+import { lifecycleFromDetection } from '../kernel/lifecycle.js';
+import { getHostWorkspaceRuntime } from '../../dsh-adapter/workspaces.js';
+const CAPABILITY = 'host.workspaces';
+const WORKSPACE_FEATURES = Object.freeze([
+    'host.workspaces.list',
+    'host.workspaces.resolve',
+    'host.workspaces.describe',
+    'host.workspaces.commands',
+    'host.workspaces.commandShell',
+    'host.workspaces.rename',
+    'host.workspaces.remove',
+    'host.workspaces.runCommand',
+]);
+function serviceEvidence(id) {
+    return { kind: 'service', id };
+}
+function methodEvidence(service, method) {
+    return { kind: 'method', id: `${service}:${method}` };
+}
+function probeEvidence(id, detail) {
+    return { kind: 'probe', id, detail };
+}
+function errorText(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function workspaceHost(ctx) {
+    const service = ctx?.get?.('tuiWorkspaces');
+    if (service === undefined)
+        return undefined;
+    try {
+        return getHostWorkspaceRuntime(service);
+    }
+    catch {
+        return undefined;
+    }
+}
+function degradedFeature(capability, evidence, missing) {
+    return lifecycleFromDetection(capability, {
+        state: 'degraded',
+        missing: [missing],
+        evidence,
+    });
+}
+function liveFeature(capability, evidence) {
+    return lifecycleFromDetection(capability, {
+        state: 'supported',
+        evidence,
+    });
+}
+export function detectWorkspaceCapability(ctx) {
+    const service = ctx?.get?.('tuiWorkspaces');
+    if (service === undefined) {
+        return { state: 'unsupported', reason: 'tuiWorkspaces service is not mounted' };
+    }
+    const evidence = [serviceEvidence('tuiWorkspaces')];
+    const host = workspaceHost(ctx);
+    if (host === undefined) {
+        return { state: 'degraded', missing: ['tuiWorkspaces host facade'], evidence };
+    }
+    for (const method of ['list', 'resolve', 'describe', 'commands']) {
+        if (typeof host[method] === 'function') {
+            evidence.push(methodEvidence('tuiWorkspaces', method));
+        }
+        else {
+            return { state: 'degraded', missing: [`tuiWorkspaces.${method}()`], evidence };
+        }
+    }
+    return {
+        state: 'supported',
+        evidence: [...evidence, probeEvidence('tuiWorkspaces.host()', 'host workspace facade is present')],
+    };
+}
+async function verifyWorkspaceLive(ctx) {
+    const host = workspaceHost(ctx);
+    const baseEvidence = [serviceEvidence('tuiWorkspaces')];
+    if (host === undefined) {
+        return WORKSPACE_FEATURES.map(feature => degradedFeature(feature, baseEvidence, `${feature}.live-probe`));
+    }
+    const out = [];
+    const cwd = process.cwd();
+    const probeSignal = () => AbortSignal.timeout(2_000);
+    try {
+        const list = await host.list(cwd, probeSignal());
+        if (Array.isArray(list)) {
+            out.push(liveFeature('host.workspaces.list', [
+                serviceEvidence('tuiWorkspaces'),
+                methodEvidence('tuiWorkspaces', 'list'),
+                probeEvidence('tuiWorkspaces.list()', `enumerated ${list.length} workspace target(s)`),
+            ]));
+        }
+        else {
+            out.push(degradedFeature('host.workspaces.list', [serviceEvidence('tuiWorkspaces'), methodEvidence('tuiWorkspaces', 'list')], 'tuiWorkspaces.list() returned no array'));
+        }
+    }
+    catch (error) {
+        out.push(degradedFeature('host.workspaces.list', [serviceEvidence('tuiWorkspaces'), probeEvidence('tuiWorkspaces.list()', errorText(error))], 'tuiWorkspaces.list() live-probe'));
+    }
+    try {
+        const resolved = await host.resolve(cwd, cwd, probeSignal());
+        if (resolved !== undefined && typeof resolved.cwd === 'string') {
+            out.push(liveFeature('host.workspaces.resolve', [
+                serviceEvidence('tuiWorkspaces'),
+                methodEvidence('tuiWorkspaces', 'resolve'),
+                probeEvidence('tuiWorkspaces.resolve()', `resolved ${resolved.uri}`),
+            ]));
+        }
+        else {
+            out.push(degradedFeature('host.workspaces.resolve', [serviceEvidence('tuiWorkspaces'), methodEvidence('tuiWorkspaces', 'resolve')], 'tuiWorkspaces.resolve() returned no target'));
+        }
+    }
+    catch (error) {
+        out.push(degradedFeature('host.workspaces.resolve', [serviceEvidence('tuiWorkspaces'), probeEvidence('tuiWorkspaces.resolve()', errorText(error))], 'tuiWorkspaces.resolve() live-probe'));
+    }
+    try {
+        const describe = host.describe(cwd);
+        if (describe !== undefined && typeof describe.cwd === 'string') {
+            out.push(liveFeature('host.workspaces.describe', [
+                serviceEvidence('tuiWorkspaces'),
+                methodEvidence('tuiWorkspaces', 'describe'),
+                probeEvidence('tuiWorkspaces.describe()', `resolved current workspace ${describe.uri}`),
+            ]));
+        }
+        else {
+            out.push(degradedFeature('host.workspaces.describe', [serviceEvidence('tuiWorkspaces'), methodEvidence('tuiWorkspaces', 'describe')], 'tuiWorkspaces.describe()'));
+        }
+    }
+    catch (error) {
+        out.push(degradedFeature('host.workspaces.describe', [serviceEvidence('tuiWorkspaces'), probeEvidence('tuiWorkspaces.describe()', errorText(error))], 'tuiWorkspaces.describe() live-probe'));
+    }
+    try {
+        const commands = host.commands();
+        if (Array.isArray(commands)) {
+            out.push(liveFeature('host.workspaces.commands', [
+                serviceEvidence('tuiWorkspaces'),
+                methodEvidence('tuiWorkspaces', 'commands'),
+                probeEvidence('tuiWorkspaces.commands()', `enumerated ${commands.length} workspace command(s)`),
+            ]));
+        }
+        else {
+            out.push(degradedFeature('host.workspaces.commands', [serviceEvidence('tuiWorkspaces'), methodEvidence('tuiWorkspaces', 'commands')], 'tuiWorkspaces.commands()'));
+        }
+    }
+    catch (error) {
+        out.push(degradedFeature('host.workspaces.commands', [serviceEvidence('tuiWorkspaces'), probeEvidence('tuiWorkspaces.commands()', errorText(error))], 'tuiWorkspaces.commands() live-probe'));
+    }
+    // No safe auto-reversible P3 probe for command-shell execution, renaming,
+    // ledger registration/removal, or provider command execution: each mutates
+    // durable state a probe cannot undo. These stay feature-degraded.
+    for (const feature of [
+        'host.workspaces.commandShell',
+        'host.workspaces.rename',
+        'host.workspaces.remove',
+        'host.workspaces.runCommand',
+    ]) {
+        out.push(degradedFeature(feature, [serviceEvidence('tuiWorkspaces')], `${feature}.live-probe`));
+    }
+    return out;
+}
+/** Thin Host Workspace Port over the legacy host-only facade. */
+function createWorkspacePort(host) {
+    return Object.freeze({
+        list: (currentCwd, signal) => host.list(currentCwd, signal),
+        resolve: (reference, currentCwd, signal) => host.resolve(reference, currentCwd, signal),
+        describe: cwd => host.describe(cwd),
+        commandShell: cwd => host.commandShell(cwd),
+        rename: (cwd, title) => host.rename(cwd, title),
+        remove: cwd => host.remove(cwd),
+        commands: () => host.commands(),
+        runCommand: (name, input, cwd, signal) => host.runCommand(name, input, cwd, signal),
+    });
+}
+export const workspaceDriver = {
+    id: 'dsh-tui-workspace',
+    upstreamFamily: 'dsh-tui',
+    capability: 'host.workspaces',
+    mountEffectClass: 'mutate',
+    detect: detectWorkspaceCapability,
+    verifyLive: verifyWorkspaceLive,
+    async mount(context) {
+        const host = workspaceHost(context);
+        const ports = host === undefined ? undefined : { workspace: createWorkspacePort(host) };
+        return { disposer: () => undefined, ...(ports === undefined ? {} : { ports }) };
+    },
+};

package/lib/types/api.d.ts

@@ -0,0 +1,7 @@
+export type { TuiDecisionContext, TuiInputEvent, TuiInputDecision, TuiRewindPromptEvent, TuiRewindMode, TuiRewindPromptDecision, TuiRewindDoneEvent, TuiSessionSwitchEvent, TuiSessionSwitchDecision, TuiSessionSwitchedEvent, TuiCompactEvent, TuiCompactDecision, TuiDialogAnswer, TuiDialogBase, TuiDialogConfirmRequest, TuiDialogInputRequest, TuiDialogSelectOption, TuiDialogSelectRequest, TuiDialogSnapshot, TuiStatusEntry, TuiShortcutKey, TuiShortcutOptions, TuiEntryRenderer, TuiEntryRenderResult, TuiToastDelivery, TuiToastOptions, TuiToastSink, } from './extensions.js';
+export type { HostContract, HostDescriptor, ContractCoordinate, ContractRef, NegotiationDecision, PermissionEntry, PermissionRegistry, TuiPluginStorage, PluginStorageErrorCode, TuiPluginStorageRuntime, MessagesObserveContentBlock, MessagesObserveEnvelope, MessagesObserveListener, MessagesObservePayload, TuiMessageObserverRuntime, LedgerEntry, LedgerOperation, LedgerResult, TuiEffectLedgerRuntime, CommandErrorCode, CodedCommandError, } from './plugin-host.js';
+export type { TuiSceneProps, TuiSceneDescriptor } from './scenes.js';
+export type { TuiSettingsFieldKind, TuiSettingsFieldOption, TuiSettingsGroup, TuiSettingsFieldWrite, TuiSettingsField, TuiSettingsSection, } from './settings-sections.js';
+export type { TuiCommandTreeProvider } from './command-trees.js';
+export type { TuiWorkspaceKind, TuiWorkspaceTarget, TuiWorkspaceChoice, TuiWorkspaceCommandResult, TuiWorkspaceCommand, TuiCommandShell, TuiWorkspaceProvider, } from './workspaces.js';
+//# sourceMappingURL=api.d.ts.map

package/lib/types/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"AAsCA,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,YAAY,GACb,MAAM,iBAAiB,CAAA;AACxB,YAAY,EACV,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACpE,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAChE,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,oBAAoB,GACrB,MAAM,iBAAiB,CAAA"}

package/lib/types/api.js

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

package/lib/types/bootstrap/state.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Interaction-time telemetry stubs used by the renderer's input and scroll
+ * paths. dsh-tui does not track interaction time, so these hooks are no-ops.
+ */
+/** No-op interaction-time flush stub; dsh-tui does not track interaction time. */
+export declare function flushInteractionTime(): void;
+/** No-op interaction-time update stub; dsh-tui does not track interaction time. */
+export declare function updateLastInteractionTime(): void;
+/** No-op scroll-activity stub; dsh-tui does not track interaction time. */
+export declare function markScrollActivity(): void;
+//# sourceMappingURL=state.d.ts.map

package/lib/types/bootstrap/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/bootstrap/state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,kFAAkF;AAClF,wBAAgB,oBAAoB,IAAI,IAAI,CAAG;AAE/C,mFAAmF;AACnF,wBAAgB,yBAAyB,IAAI,IAAI,CAAG;AAEpD,2EAA2E;AAC3E,wBAAgB,kBAAkB,IAAI,IAAI,CAAG"}

package/lib/types/bootstrap/state.js

@@ -0,0 +1,10 @@
+/**
+ * Interaction-time telemetry stubs used by the renderer's input and scroll
+ * paths. dsh-tui does not track interaction time, so these hooks are no-ops.
+ */
+/** No-op interaction-time flush stub; dsh-tui does not track interaction time. */
+export function flushInteractionTime() { }
+/** No-op interaction-time update stub; dsh-tui does not track interaction time. */
+export function updateLastInteractionTime() { }
+/** No-op scroll-activity stub; dsh-tui does not track interaction time. */
+export function markScrollActivity() { }

package/lib/types/command-trees.d.ts

@@ -0,0 +1,4 @@
+export { name, TuiCommandTreeRuntime } from './dsh-adapter/command-trees.js';
+export type { TuiCommandTreeProvider } from './dsh-adapter/command-trees.js';
+export { default } from './dsh-adapter/command-trees.js';
+//# sourceMappingURL=command-trees.d.ts.map

package/lib/types/command-trees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-trees.d.ts","sourceRoot":"","sources":["../../src/command-trees.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AAC5E,YAAY,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAA"}

package/lib/types/command-trees.js

@@ -0,0 +1,4 @@
+// Re-export shim: the Cordis-backed implementation lives behind the adapter
+// boundary so UI consumers never import official @deepseek-ai/* packages.
+export { name, TuiCommandTreeRuntime } from './dsh-adapter/command-trees.js';
+export { default } from './dsh-adapter/command-trees.js';

package/lib/types/commands.d.ts

@@ -0,0 +1,87 @@
+import type { LocalCommand, LocalizedDescriptions, CommandCompletion } from './adapter/ports/channel-catalog.js';
+export type { LocalCommand, LocalizedDescriptions, CommandCompletion } from './adapter/ports/channel-catalog.js';
+/** One child in a slash-command tree contributed by a local feature/plugin. */
+export interface CommandCompletionNode {
+    name: string;
+    aliases?: readonly string[];
+    description: string;
+    descriptions?: LocalizedDescriptions;
+    tag?: string;
+    /** Optional i18n key; plugin nodes normally rely on fallback text. */
+    descriptionKey?: string;
+}
+export type CommandChildren = (canonicalPath: readonly string[]) => readonly CommandCompletionNode[];
+/**
+ * Whether a value can occupy one command-completion token. Keep this aligned
+ * with the grammar accepted by {@link completeCommands}; callers that need an
+ * empty prefix handle that case separately.
+ */
+export declare function isCommandCompletionToken(value: string): boolean;
+/**
+ * The built-in slash commands (name + description pairs). Plugin-registered
+ * commands merge in at runtime; locals win on name collisions.
+ */
+export declare const LOCAL_COMMANDS: LocalCommand[];
+/**
+ * Hidden slash commands: intentionally not exposed in the `/` suggestion
+ * menu or Help, but still recognized as local commands when typed. They are
+ * kept out of `LOCAL_COMMANDS` so `filterCommands`/`completeCommands` never
+ * surface them; dispatch recognizes them via {@link HIDDEN_COMMAND_NAMES}.
+ */
+export declare const HIDDEN_COMMANDS: readonly LocalCommand[];
+/** Names of hidden commands, for fast dispatch/lookup. */
+export declare const HIDDEN_COMMAND_NAMES: ReadonlySet<string>;
+/**
+ * Whether the input names a hidden command (same slash-optional trimming
+ * rules as {@link isLocalCommandName}).
+ */
+export declare function isHiddenCommandName(input: string): boolean;
+/**
+ * Resolve a command's description in the active UI language. The en text in
+ * `LOCAL_COMMANDS` (and the registry's own text for external commands) is
+ * the fallback; zh translations live in the i18n dict under
+ * `cmd-desc-<name>`. Resolved at call time — components call this during
+ * render, so a `/lang` switch repaints descriptions immediately.
+ * @param command - The command whose description to localize.
+ */
+export declare function localizedDescription(command: LocalCommand & {
+    descriptionKey?: string;
+}): string;
+/**
+ * Parse a slash-command line into its name and the verbatim input following
+ * the name (separator whitespace included) — the same split the DSH command
+ * registry uses, so `/plan off` dispatches `plan` with ` off`.
+ *
+ * @param line - Complete candidate command line.
+ * @returns The parsed name and raw input, or `undefined` when the line is
+ *   not a command.
+ */
+export declare function parseCommandName(line: string): {
+    name: string;
+    rawInput: string;
+} | undefined;
+/**
+ * Whether the input names a local command. Local commands must never be sent
+ * to the model when typed alone; trailing whitespace is legal.
+ * @param input - Candidate command line (slash optional).
+ * @param list - Command list to match against; defaults to LOCAL_COMMANDS.
+ * @returns True when the trimmed input names a command in `list`.
+ */
+export declare function isLocalCommandName(input: string, list?: readonly LocalCommand[]): boolean;
+/**
+ * Filter commands by a `/…` input prefix.
+ * The prefix is the whole input after the slash, so `/plan off` matches
+ * nothing and the overlay stays closed — Enter still dispatches through
+ * `parseCommandName`.
+ * @param input - Slash-command input; the prefix is the whole text after the slash.
+ * @param list - Command list to filter; defaults to LOCAL_COMMANDS.
+ * @returns Commands whose name starts with the prefix, in list order.
+ */
+export declare function filterCommands(input: string, list?: readonly LocalCommand[]): LocalCommand[];
+/**
+ * Complete an arbitrary slash-command path. Root commands come from the
+ * ordinary DSH/TUI catalog; each resolved token asks the caller for its
+ * children, so PromptInput never needs feature- or plugin-specific cases.
+ */
+export declare function completeCommands(input: string, roots?: readonly LocalCommand[], children?: CommandChildren): CommandCompletion[];
+//# sourceMappingURL=commands.d.ts.map

package/lib/types/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAA;AAChH,YAAY,EAAE,YAAY,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAA;AAWhH,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,KAAK,SAAS,qBAAqB,EAAE,CAAA;AAEpG;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,EAiExC,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAElD,CAAA;AAED,0DAA0D;AAC1D,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAEpD,CAAA;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAG1D;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAIhG;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAIhD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,SAAS,YAAY,EAAmB,GAC7C,OAAO,CAKT;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,SAAS,YAAY,EAAmB,GAC7C,YAAY,EAAE,CAKhB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,SAAS,YAAY,EAAmB,EAC/C,QAAQ,GAAE,eAA0B,GACnC,iBAAiB,EAAE,CAuCrB"}

package/lib/types/commands.js

@@ -0,0 +1,218 @@
+/**
+ * Local slash commands for dsh-tui, presented as `/name — description`.
+ * The built-in set is merged with plugin-registered
+ * commands (plan/goal/…) from the DSH command registry (`dsh-commands`) —
+ * `runCommand` in the Chat screen dispatches either kind, with the registry
+ * handler winning for names both sides declare.
+ */
+import { getLang, tOr } from './i18n.js';
+/**
+ * Whether a value can occupy one command-completion token. Keep this aligned
+ * with the grammar accepted by {@link completeCommands}; callers that need an
+ * empty prefix handle that case separately.
+ */
+export function isCommandCompletionToken(value) {
+    return /^[a-z0-9_.:\/-]+$/iu.test(value);
+}
+/**
+ * The built-in slash commands (name + description pairs). Plugin-registered
+ * commands merge in at runtime; locals win on name collisions.
+ */
+export const LOCAL_COMMANDS = [
+    // Conversation
+    { name: 'new', description: 'Start a new conversation' },
+    { name: 'clear', description: 'Clear the conversation' },
+    { name: 'compact', description: 'Summarize earlier turns to free context space' },
+    { name: 'resume', description: 'Continue a saved session' },
+    { name: 'rename', description: 'Rename the current session' },
+    { name: 'recap', description: 'Generate a recap of recent session activity' },
+    { name: 'rewind', description: 'Return the session to an earlier message' },
+    { name: 'tree', description: 'Browse the session family tree (rewind / fork / adopt)' },
+    { name: 'fork', description: 'Fork the current session into a resumable copy' },
+    { name: 'export', description: 'Save the session as a Markdown file' },
+    { name: 'btw', description: 'Ask a quick side question without interrupting the conversation' },
+    { name: 'trace', description: 'Show the session event trace timeline' },
+    { name: 'agentview', description: 'Open the agent view (all sessions)' },
+    { name: 'bg', description: 'Background this session and open agent view' },
+    { name: 'background', description: 'Background this session and open agent view', tag: 'alias of /bg' },
+    // Session / environment
+    { name: 'context', description: 'Show loaded context details' },
+    { name: 'status', description: 'Show session status' },
+    { name: 'cost', description: 'Show session token usage' },
+    { name: 'config', description: 'Show the dsh-tui configuration source' },
+    { name: 'reload', description: 'Reload preference files from disk and apply live' },
+    { name: 'settings', description: 'View and edit plugin settings' },
+    { name: 'doctor', description: 'Run environment checks' },
+    { name: 'migrate', description: 'Import conversations from other coding agents (claude-code / codex / omp / zcode / grok-build)' },
+    { name: 'init', description: 'Create AGENTS.md in the working directory' },
+    { name: 'agents', description: 'Show subagents of this session' },
+    { name: 'jobs', description: 'Show background jobs of this session' },
+    // Model / display
+    { name: 'activity', description: 'Switch the working-activity indicator preset' },
+    { name: 'preset', description: 'Switch the agent preset (including Liangshen mode)' },
+    { name: 'theme', description: 'Switch the color theme (auto, built-in or custom)' },
+    { name: 'color', description: 'Set the current session accent color' },
+    { name: 'lang', description: 'Switch the UI language (en / zh)' },
+    { name: 'model', description: 'Show the active model' },
+    { name: 'effort', description: 'Adjust the reasoning effort (slider)' },
+    { name: 'thinking', description: 'Toggle extended thinking display' },
+    { name: 'tokens', description: 'Show session token usage' },
+    // Account / policy
+    { name: 'balance', description: 'Show DeepSeek account balance' },
+    { name: 'provider', description: 'Add, edit or delete an LLM provider (catalog or custom API endpoint)' },
+    { name: 'login', description: 'Show API credential status' },
+    { name: 'logout', description: 'Clear the API credential' },
+    { name: 'add-dir', description: 'Show the filesystem policy scope' },
+    { name: 'hooks', description: 'Show hooks status' },
+    { name: 'mcp', description: 'Show MCP status' },
+    { name: 'skills', description: 'List available skills' },
+    { name: 'plugins', description: 'Show plugin contract, grant, and ledger diagnostics' },
+    { name: 'update', description: 'Update dsh-tui and restart' },
+    // Skills are discovered through the DSH registry and added at runtime.
+    // A local entry of the same name would win the collision filter.
+    // Misc / not applicable on this leaf
+    { name: 'vim', description: 'Turn Vim keybindings on or off' },
+    { name: 'terminal-setup', description: 'Show terminal setup instructions' },
+    { name: 'connect', description: 'Connect to a remote machine' },
+    { name: 'workspace', description: 'Resume, rename, or open a workspace' },
+    { name: 'home', description: 'Workspace home: manage workspaces and open their sessions' },
+    // Help / exit
+    { name: 'help', description: 'Show shortcuts and commands' },
+    { name: 'tips', description: 'Show usage tips and shortcuts' },
+    { name: 'restart', description: 'Restart dsh-tui and resume this session' },
+    { name: 'exit', description: 'Exit dsh-tui' },
+    { name: 'quit', description: 'Exit dsh-tui', tag: 'alias of /exit' },
+    { name: 'q', description: 'Exit dsh-tui', tag: 'alias of /exit' },
+];
+/**
+ * Hidden slash commands: intentionally not exposed in the `/` suggestion
+ * menu or Help, but still recognized as local commands when typed. They are
+ * kept out of `LOCAL_COMMANDS` so `filterCommands`/`completeCommands` never
+ * surface them; dispatch recognizes them via {@link HIDDEN_COMMAND_NAMES}.
+ */
+export const HIDDEN_COMMANDS = [
+    { name: 'deepseek', description: 'Hidden DeepSeek easter egg' },
+];
+/** Names of hidden commands, for fast dispatch/lookup. */
+export const HIDDEN_COMMAND_NAMES = new Set(HIDDEN_COMMANDS.map(command => command.name));
+/**
+ * Whether the input names a hidden command (same slash-optional trimming
+ * rules as {@link isLocalCommandName}).
+ */
+export function isHiddenCommandName(input) {
+    const name = input.replace(/^\//, '').trim();
+    return HIDDEN_COMMAND_NAMES.has(name);
+}
+/**
+ * Resolve a command's description in the active UI language. The en text in
+ * `LOCAL_COMMANDS` (and the registry's own text for external commands) is
+ * the fallback; zh translations live in the i18n dict under
+ * `cmd-desc-<name>`. Resolved at call time — components call this during
+ * render, so a `/lang` switch repaints descriptions immediately.
+ * @param command - The command whose description to localize.
+ */
+export function localizedDescription(command) {
+    const translated = command.descriptions?.[getLang()];
+    if (translated !== undefined)
+        return translated;
+    return tOr(command.descriptionKey ?? `cmd-desc-${command.name}`, command.description);
+}
+/**
+ * Parse a slash-command line into its name and the verbatim input following
+ * the name (separator whitespace included) — the same split the DSH command
+ * registry uses, so `/plan off` dispatches `plan` with ` off`.
+ *
+ * @param line - Complete candidate command line.
+ * @returns The parsed name and raw input, or `undefined` when the line is
+ *   not a command.
+ */
+export function parseCommandName(line) {
+    const match = /^\/([a-z][a-z0-9_-]*)(?=$|[\t\n\r ])/.exec(line);
+    if (match === null)
+        return undefined;
+    return { name: match[1], rawInput: line.slice(match[0].length) };
+}
+/**
+ * Whether the input names a local command. Local commands must never be sent
+ * to the model when typed alone; trailing whitespace is legal.
+ * @param input - Candidate command line (slash optional).
+ * @param list - Command list to match against; defaults to LOCAL_COMMANDS.
+ * @returns True when the trimmed input names a command in `list`.
+ */
+export function isLocalCommandName(input, list = LOCAL_COMMANDS) {
+    // Trailing whitespace is legal (Tab completion leaves a space after the
+    // name so the user can type arguments).
+    const name = input.replace(/^\//, '').trim();
+    return HIDDEN_COMMAND_NAMES.has(name) || list.some(command => command.name === name);
+}
+/**
+ * Filter commands by a `/…` input prefix.
+ * The prefix is the whole input after the slash, so `/plan off` matches
+ * nothing and the overlay stays closed — Enter still dispatches through
+ * `parseCommandName`.
+ * @param input - Slash-command input; the prefix is the whole text after the slash.
+ * @param list - Command list to filter; defaults to LOCAL_COMMANDS.
+ * @returns Commands whose name starts with the prefix, in list order.
+ */
+export function filterCommands(input, list = LOCAL_COMMANDS) {
+    const prefix = input.replace(/^\//, '').trim().toLowerCase();
+    return list.filter(command => command.name.toLowerCase().startsWith(prefix));
+}
+/**
+ * Complete an arbitrary slash-command path. Root commands come from the
+ * ordinary DSH/TUI catalog; each resolved token asks the caller for its
+ * children, so PromptInput never needs feature- or plugin-specific cases.
+ */
+export function completeCommands(input, roots = LOCAL_COMMANDS, children = () => []) {
+    if (!input.startsWith('/') || /[\r\n]/u.test(input))
+        return [];
+    const body = input.slice(1);
+    // Token charset includes `. : /` so provider/model specs (e.g.
+    // `deepseek/deepseek-flash`, `openai/gpt-4.1`) survive as ONE token —
+    // the /model completion matches its candidates against the whole spec.
+    if (!body.split(/[\t ]+/u).every(token => token === '' || isCommandCompletionToken(token)))
+        return [];
+    const trailingSeparator = /[\t ]$/u.test(body);
+    const tokens = body.split(/[\t ]+/u);
+    const prefix = trailingSeparator ? '' : (tokens.pop() ?? '');
+    if (trailingSeparator && tokens.at(-1) === '')
+        tokens.pop();
+    const canonicalPath = [];
+    let candidates = roots;
+    for (const token of tokens) {
+        const resolved = resolveCompletionNode(candidates, token);
+        if (resolved === undefined)
+            return [];
+        canonicalPath.push(resolved.name);
+        candidates = children(canonicalPath);
+    }
+    const normalizedPrefix = prefix.toLowerCase();
+    return candidates.flatMap(candidate => {
+        const completionToken = matchingCompletionToken(candidate, normalizedPrefix);
+        if (completionToken === undefined || !isCommandCompletionToken(completionToken))
+            return [];
+        const path = [...tokens, completionToken];
+        const commandLine = `/${path.join(' ')}`;
+        return [{
+                name: path.join(' '),
+                description: candidate.description,
+                ...(candidate.descriptions === undefined ? {} : { descriptions: candidate.descriptions }),
+                ...(candidate.descriptionKey === undefined ? {} : { descriptionKey: candidate.descriptionKey }),
+                ...(candidate.tag === undefined && candidate.aliases?.length
+                    ? { tag: `aliases: ${candidate.aliases.join(', ')}` }
+                    : candidate.tag === undefined ? {} : { tag: candidate.tag }),
+                replacement: `${commandLine} `,
+                commandLine,
+            }];
+    });
+}
+function resolveCompletionNode(candidates, token) {
+    const normalized = token.toLowerCase();
+    return candidates.find(candidate => candidate.name.toLowerCase() === normalized
+        || candidate.aliases?.some(alias => alias.toLowerCase() === normalized));
+}
+function matchingCompletionToken(candidate, prefix) {
+    if (candidate.name.toLowerCase().startsWith(prefix))
+        return candidate.name;
+    return candidate.aliases?.find(alias => alias.toLowerCase().startsWith(prefix));
+}

package/lib/types/components/ActivityLine.d.ts

@@ -0,0 +1,34 @@
+import React from 'react';
+import type { ActivityView } from '../dsh-adapter/activity-store.js';
+/**
+ * Context-pressure percentage (0–100) from the last usage snapshot, or
+ * undefined when unknown — shared by the spinner-line and status-line
+ * placements of the working-activity line (pi working-activity style:
+ * amber ≥ 80%, red ≥ 95%).
+ */
+export declare function contextPressurePct(usage: {
+    input: number;
+    cacheRead: number;
+    cacheWrite: number;
+} | undefined, contextWindow: number | undefined): number | undefined;
+/**
+ * The working-activity line, rendered either in the spinner slot (while a
+ * turn runs — alongside the random-verb spinner) or on the status bar
+ * (the turn-summary card once idle). pi working-activity style: an animated
+ * indicator frame, an ice-blue shimmer sweep over the line, an amber/red
+ * `⚠ ctx N%` pressure prefix, and a trailing token suffix for the spinner
+ * placement. Done summaries render statically in the brand mist blue.
+ */
+/** The fields the line renders, from the working-activity plugin's projection. */
+export interface ActivityLineValue {
+    readonly phase: ActivityView['phase'];
+    readonly line: string;
+}
+export declare function ActivityLine({ activity, activityFrames, warnPct, warnDanger, suffix, }: {
+    activity: ActivityLineValue;
+    activityFrames: string | undefined;
+    warnPct?: number;
+    warnDanger?: boolean;
+    suffix?: string;
+}): React.ReactNode;
+//# sourceMappingURL=ActivityLine.d.ts.map

package/lib/types/components/ActivityLine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityLine.d.ts","sourceRoot":"","sources":["../../../src/components/ActivityLine.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAQzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAEpE;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EAC3E,aAAa,EAAE,MAAM,GAAG,SAAS,GAChC,MAAM,GAAG,SAAS,CAMpB;AAED;;;;;;;GAOG;AACH,kFAAkF;AAClF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,cAAc,EACd,OAAO,EACP,UAAU,EACV,MAAM,GACP,EAAE;IACD,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,GAAG,KAAK,CAAC,SAAS,CAuClB"}

package/lib/types/components/ActivityLine.js

@@ -0,0 +1,39 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
+import { t } from '../i18n.js';
+import { Text, useAnimationFrame } from '../ui.js';
+import { resolvePreset } from './activityFrames.js';
+import { BRAND, FLASH, ICE, sweep } from './shimmer.js';
+import { getTheme } from '../theme.js';
+import { useTheme } from './design-system/ThemeProvider.js';
+import { parseRGB } from './Spinner/spinnerUtils.js';
+/**
+ * Context-pressure percentage (0–100) from the last usage snapshot, or
+ * undefined when unknown — shared by the spinner-line and status-line
+ * placements of the working-activity line (pi working-activity style:
+ * amber ≥ 80%, red ≥ 95%).
+ */
+export function contextPressurePct(usage, contextWindow) {
+    if (usage === undefined || contextWindow === undefined || contextWindow <= 0) {
+        return undefined;
+    }
+    const occupied = usage.input + usage.cacheRead + usage.cacheWrite;
+    return Math.round((occupied / contextWindow) * 100);
+}
+export function ActivityLine({ activity, activityFrames, warnPct, warnDanger, suffix, }) {
+    // 60ms frames: the shimmer sweep advances one column per frame (3.3× the
+    // ported 200ms cadence — the slow crawl read as lag).
+    const [, time] = useAnimationFrame(60);
+    const [themeName] = useTheme();
+    const theme = getTheme(themeName);
+    const preset = React.useMemo(() => resolvePreset(activityFrames), [activityFrames]);
+    const frameIndex = Math.floor(time / preset.intervalMs) % preset.frames.length;
+    const frame = preset.frames[frameIndex] ?? '·';
+    const color = activity.phase === 'done' || activity.phase === 'tool'
+        ? 'accent'
+        : 'activity';
+    const baseRGB = activity.phase === 'tool'
+        ? (parseRGB(theme.accent) ?? BRAND)
+        : (parseRGB(theme.activity) ?? ICE);
+    return (_jsxs(Text, { wrap: "truncate", children: [activity.phase !== 'done' && (_jsxs(Text, { color: color, children: [frame, " "] })), warnPct !== undefined && warnPct >= 80 && (_jsxs(Text, { color: warnDanger ? 'error' : 'warning', children: [t('activity-ctx-warn'), warnPct, "% \u00B7", ' '] })), activity.phase === 'done' ? (_jsx(Text, { color: color, children: activity.line })) : (_jsx(Text, { children: sweep(activity.line, time, baseRGB, FLASH, 60) })), suffix !== undefined && _jsx(Text, { dimColor: true, children: suffix })] }));
+}