@askdkc/dsh-cli 0.11.3

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

@@ -0,0 +1,187 @@
+import { t } from '../../i18n.js';
+import { cleanRenderText } from '../sanitize.js';
+export const PERMISSION_PRESET_CUSTOM = 'custom';
+export const PERMISSION_PRESET_NAME_CELLS = 120;
+export const PERMISSION_PRESET_DESCRIPTION_CELLS = 400;
+export function isRecord(value) {
+    return value !== null && typeof value === 'object';
+}
+/** Narrow a raw service read to the structural registry surface. */
+export function permissionPresetRuntime(service) {
+    return isRecord(service) ? service : undefined;
+}
+/** Keep a permission roster read-only after it crosses the adapter boundary.
+ *  The registry may reuse and mutate its option objects between reads; callers
+ *  must observe one stable snapshot instead of a live view into that service. */
+export function freezePermissionPresetSnapshot(snapshot) {
+    const options = Object.freeze(snapshot.options.map(option => Object.freeze({ ...option })));
+    const current = snapshot.current === undefined ? undefined : Object.freeze({ ...snapshot.current });
+    return Object.freeze({
+        availability: snapshot.availability,
+        options,
+        ...(current === undefined ? {} : { current }),
+    });
+}
+export function legacyPermissionPresetOptions() {
+    return [
+        {
+            value: 'read-only',
+            name: t('permission-preset-readonly'),
+            description: t('permission-preset-readonly-desc'),
+        },
+        {
+            value: 'workspace-write',
+            name: t('permission-preset-workspace-write'),
+            description: t('permission-preset-workspace-write-desc'),
+        },
+        {
+            value: 'danger-full-access',
+            name: t('permission-preset-full-access'),
+            description: t('permission-preset-full-access-desc'),
+        },
+    ];
+}
+export function legacyPermissionPresetSnapshot(sandbox) {
+    const options = legacyPermissionPresetOptions();
+    const currentOption = sandbox === undefined ? undefined : options.find(option => option.value === sandbox);
+    return freezePermissionPresetSnapshot({
+        availability: 'legacy',
+        options,
+        ...(currentOption === undefined
+            ? {}
+            : { current: { ...currentOption, kind: 'preset' } }),
+    });
+}
+export function unavailablePermissionPresetSnapshot() {
+    return freezePermissionPresetSnapshot({ availability: 'unavailable', options: [] });
+}
+export function normalizePermissionPresetOption(value) {
+    if (!isRecord(value) || typeof value.value !== 'string' || typeof value.name !== 'string')
+        return undefined;
+    const name = cleanRenderText(value.name, PERMISSION_PRESET_NAME_CELLS);
+    if (name === '')
+        return undefined;
+    if (value.description !== undefined && typeof value.description !== 'string')
+        return undefined;
+    const description = value.description === undefined
+        ? undefined
+        : cleanRenderText(value.description, PERMISSION_PRESET_DESCRIPTION_CELLS);
+    if (value.description !== undefined && description === '')
+        return undefined;
+    return {
+        value: value.value,
+        name,
+        ...(description === undefined || description === '' ? {} : { description }),
+    };
+}
+/** Atom bundles the deployment's preset table resolves (value →
+ *  sandbox/approval). Empty when the service is absent or exposes no
+ *  `resolve` seam — canonical resolution then falls back to the stock
+ *  bundles (see `canonicalPresetFor`). */
+export function permissionBundlesFromService(service) {
+    const runtime = permissionPresetRuntime(service);
+    if (runtime === undefined || typeof runtime.resolve !== 'function')
+        return [];
+    const names = Array.isArray(runtime.names) ? runtime.names : [];
+    const bundles = [];
+    for (const name of names) {
+        if (typeof name !== 'string')
+            continue;
+        try {
+            // The registry resolves atoms on instance state; never detach `resolve`.
+            const spec = runtime.resolve(name);
+            if (!isRecord(spec))
+                continue;
+            const sandbox = spec.sandbox;
+            const approval = spec.approval;
+            if ((sandbox === 'read-only' || sandbox === 'workspace-write' || sandbox === 'danger-full-access')
+                && (approval === 'ask' || approval === 'never')) {
+                bundles.push({ value: name, sandbox, approval });
+            }
+        }
+        catch {
+            // Optional resolution; a broken entry just does not extend the table.
+        }
+    }
+    return bundles;
+}
+/** The registry's current readback for one subject. Real harness registries
+ *  resolve `current(session)` through their session-projections seam; earlier
+ *  contract versions folded a raw event log. Try the subject as given, then
+ *  the event-log shape it may carry. */
+export function permissionPresetSnapshotFromService(service, subject) {
+    const runtime = permissionPresetRuntime(service);
+    if (runtime === undefined)
+        return unavailablePermissionPresetSnapshot();
+    try {
+        const capturedNames = Array.isArray(runtime.names) ? runtime.names : [];
+        if (capturedNames.length === 0)
+            return unavailablePermissionPresetSnapshot();
+        if (typeof runtime.current !== 'function' || typeof runtime.optionOf !== 'function') {
+            return unavailablePermissionPresetSnapshot();
+        }
+        // Readback lives on the registry instance; bind so the calls below keep
+        // reaching it through the same object instead of a detached reference.
+        const current = runtime.current.bind(runtime);
+        const optionOf = runtime.optionOf.bind(runtime);
+        const names = [];
+        for (const name of capturedNames) {
+            if (typeof name !== 'string' || name.trim() === '' || name === PERMISSION_PRESET_CUSTOM || names.includes(name)) {
+                return unavailablePermissionPresetSnapshot();
+            }
+            names.push(name);
+        }
+        const seen = new Set(names);
+        const options = [];
+        for (const name of names) {
+            const option = normalizePermissionPresetOption(optionOf(name));
+            if (option === undefined || option.value !== name)
+                return unavailablePermissionPresetSnapshot();
+            options.push({ ...option });
+        }
+        let currentValue;
+        try {
+            currentValue = current(subject);
+        }
+        catch {
+            currentValue = undefined;
+        }
+        if (typeof currentValue !== 'string') {
+            // Second chance for the other contract shape: a subject that carries an
+            // event log, or a raw log handed in directly.
+            const fallback = subject?.events ?? subject;
+            try {
+                currentValue = current(fallback);
+            }
+            catch {
+                if (typeof currentValue !== 'string')
+                    return unavailablePermissionPresetSnapshot();
+            }
+        }
+        if (typeof currentValue !== 'string' || (currentValue !== PERMISSION_PRESET_CUSTOM && !seen.has(currentValue))) {
+            return unavailablePermissionPresetSnapshot();
+        }
+        const currentOption = normalizePermissionPresetOption(optionOf(currentValue));
+        if (currentOption === undefined || currentOption.value !== currentValue)
+            return unavailablePermissionPresetSnapshot();
+        if (currentValue !== PERMISSION_PRESET_CUSTOM) {
+            const rosterOption = options.find(option => option.value === currentValue);
+            if (rosterOption === undefined
+                || rosterOption.name !== currentOption.name
+                || rosterOption.description !== currentOption.description) {
+                return unavailablePermissionPresetSnapshot();
+            }
+        }
+        return freezePermissionPresetSnapshot({
+            availability: 'runtime',
+            options,
+            current: {
+                ...currentOption,
+                kind: currentValue === PERMISSION_PRESET_CUSTOM ? 'custom' : 'preset',
+            },
+        });
+    }
+    catch {
+        return unavailablePermissionPresetSnapshot();
+    }
+}

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

@@ -0,0 +1,3 @@
+import type { ChannelState } from '../channel/types.js';
+export declare function createPreferences(getState: () => Pick<ChannelState, 'diffLayout' | 'thinkingFold' | 'toolBackground' | 'scrollGutter' | 'pageMargin' | 'foldTerminalCommand' | 'promptSessionLabel' | 'expandEditor' | 'smoothStreaming' | 'statusBar' | 'whale' | 'whaleIdle' | 'minimal' | 'emit'>): Pick<ChannelState, 'setDiffLayout' | 'setThinkingFold' | 'setToolBackground' | 'setScrollGutter' | 'setPageMargin' | 'setFoldTerminalCommand' | 'setPromptSessionLabel' | 'setExpandEditor' | 'setSmoothStreaming' | 'setStatusBar' | 'setWhale' | 'setWhaleIdle' | 'setMinimal'>;
+//# sourceMappingURL=preferences.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/preferences.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,cAAc,GAAG,gBAAgB,GAAG,cAAc,GAAG,YAAY,GAAG,qBAAqB,GAAG,oBAAoB,GAAG,cAAc,GAAG,iBAAiB,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,eAAe,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,iBAAiB,GAAG,eAAe,GAAG,wBAAwB,GAAG,uBAAuB,GAAG,iBAAiB,GAAG,oBAAoB,GAAG,cAAc,GAAG,UAAU,GAAG,cAAc,GAAG,YAAY,CAAC,CAsGxjB"}

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

@@ -0,0 +1,103 @@
+import { setMinimalMode } from '../../minimalMode.js';
+import { normalizePageMargin, normalizeScrollGutter, normalizeStatusBar, normalizeToolBackground } from '../../tuiDisplayPrefs.js';
+export function createPreferences(getState) {
+    return {
+        setDiffLayout(layout) {
+            const state = getState();
+            if (layout === state.diffLayout)
+                return;
+            state.diffLayout = layout;
+            state.emit();
+        },
+        setThinkingFold(mode) {
+            const state = getState();
+            if (mode === state.thinkingFold)
+                return;
+            state.thinkingFold = mode;
+            state.emit();
+        },
+        setToolBackground(background) {
+            const state = getState();
+            const normalized = normalizeToolBackground(background);
+            if (normalized === state.toolBackground)
+                return;
+            state.toolBackground = normalized;
+            state.emit();
+        },
+        setScrollGutter(mode) {
+            const state = getState();
+            const normalized = normalizeScrollGutter(mode);
+            if (normalized === state.scrollGutter)
+                return;
+            state.scrollGutter = normalized;
+            state.emit();
+        },
+        setPageMargin(setting) {
+            const state = getState();
+            const normalized = normalizePageMargin(setting);
+            if (normalized === state.pageMargin)
+                return;
+            state.pageMargin = normalized;
+            state.emit();
+        },
+        setFoldTerminalCommand(enabled) {
+            const state = getState();
+            if (enabled === state.foldTerminalCommand)
+                return;
+            state.foldTerminalCommand = enabled;
+            state.emit();
+        },
+        setPromptSessionLabel(enabled) {
+            const state = getState();
+            if (enabled === state.promptSessionLabel)
+                return;
+            state.promptSessionLabel = enabled;
+            state.emit();
+        },
+        setExpandEditor(enabled) {
+            const state = getState();
+            if (enabled === state.expandEditor)
+                return;
+            state.expandEditor = enabled;
+            state.emit();
+        },
+        setSmoothStreaming(enabled) {
+            const state = getState();
+            if (enabled === state.smoothStreaming)
+                return;
+            state.smoothStreaming = enabled;
+            state.emit();
+        },
+        setStatusBar(config) {
+            const state = getState();
+            const next = normalizeStatusBar({ ...state.statusBar, ...config });
+            const changed = Object.keys(next).some(key => next[key] !== state.statusBar[key]);
+            if (!changed)
+                return;
+            state.statusBar = next;
+            state.emit();
+        },
+        setWhale(visible) {
+            const state = getState();
+            if (visible === state.whale)
+                return;
+            state.whale = visible;
+            state.emit();
+        },
+        setWhaleIdle(enabled) {
+            const state = getState();
+            if (enabled === state.whaleIdle)
+                return;
+            state.whaleIdle = enabled;
+            state.emit();
+        },
+        setMinimal(enabled) {
+            const state = getState();
+            setMinimalMode(enabled);
+            if (enabled === state.minimal)
+                return;
+            state.minimal = enabled;
+            state.emit();
+        }
+    };
+}

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

@@ -0,0 +1,13 @@
+import type { TodoPanelItem } from './types.js';
+export declare function isSubagentToolName(name: string): boolean;
+/** Extract `job_id` from a job_output call's raw args (JSON), or undefined. */
+export declare function parseJobOutputId(argsFull: string | undefined): string | undefined;
+/** Extract the command that launched a background job from its tool args
+ *  (`command` for the shell tools, `text` for terminal_send). The registry
+ *  label is the friendly description; the command is the actual invocation. */
+export declare function toolCommandOf(argsFull: string | undefined): string | undefined;
+/** The ack a shell tool returns for `run_in_background: true`. */
+export declare const BACKGROUND_START_ACK: RegExp;
+/** Narrow an optional plugin event without importing its module augmentation. */
+export declare function todoPanelItems(data: unknown): TodoPanelItem[] | undefined;
+//# sourceMappingURL=projection-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projection-helpers.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/projection-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAY/C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAQjF;AAED;;+EAE+E;AAC/E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAa9E;AAED,kEAAkE;AAClE,eAAO,MAAM,oBAAoB,QAAkC,CAAA;AAEnE,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,EAAE,GAAG,SAAS,CAWzE"}

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

@@ -0,0 +1,63 @@
+/** Names the subagent delegation tools ship under (preset `toolName` values
+ *  plus the CLI default); each renders as a live subagent card, never a plain
+ *  tool card. */
+const SUBAGENT_TOOL_NAMES = new Set([
+    'task',
+    'subagent',
+    'subagent_fork',
+    'subagent_claude_code',
+    'subagent_codex',
+    'spawn_task',
+]);
+export function isSubagentToolName(name) {
+    return SUBAGENT_TOOL_NAMES.has(name.toLowerCase());
+}
+/** Extract `job_id` from a job_output call's raw args (JSON), or undefined. */
+export function parseJobOutputId(argsFull) {
+    if (argsFull === undefined || argsFull === '')
+        return undefined;
+    try {
+        const args = JSON.parse(argsFull);
+        return typeof args.job_id === 'string' && args.job_id !== '' ? args.job_id : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Extract the command that launched a background job from its tool args
+ *  (`command` for the shell tools, `text` for terminal_send). The registry
+ *  label is the friendly description; the command is the actual invocation. */
+export function toolCommandOf(argsFull) {
+    if (argsFull === undefined || argsFull === '')
+        return undefined;
+    try {
+        const args = JSON.parse(argsFull);
+        const candidate = typeof args.command === 'string' && args.command !== ''
+            ? args.command
+            : typeof args.text === 'string' && args.text !== ''
+                ? args.text
+                : undefined;
+        return candidate;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The ack a shell tool returns for `run_in_background: true`. */
+export const BACKGROUND_START_ACK = /^started background job (\S+)/;
+/** Narrow an optional plugin event without importing its module augmentation. */
+export function todoPanelItems(data) {
+    if (typeof data !== 'object' || data === null)
+        return undefined;
+    const todos = data.todos;
+    if (!Array.isArray(todos))
+        return undefined;
+    const valid = todos.every(item => {
+        if (typeof item !== 'object' || item === null)
+            return false;
+        const candidate = item;
+        return typeof candidate.content === 'string' &&
+            (candidate.status === 'pending' || candidate.status === 'in_progress' || candidate.status === 'completed');
+    });
+    return valid ? todos : undefined;
+}

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

@@ -0,0 +1,44 @@
+import type { Agent, AssistantStreamFrame } from '@deepseek-ai/dsh-agent';
+import type { SessionEvent } from '@deepseek-ai/dsh-session';
+import type { ContentBlock } from '@deepseek-ai/dsh-llm';
+import type { ChannelState, ToolCallView, ToolResultView, ToolsRegistryLike } from './types.js';
+import type { SelectionAttachment } from '../../adapter/ports/channel-view.js';
+import type { InputConvergence } from './input-actions.js';
+import type { BackgroundJobStore } from '../jobs.js';
+import type { TuiRendererHost } from '../renderers.js';
+type ProjectionState = Pick<ChannelState, 'rows' | 'thinkingFold' | 'activeToolCount' | 'spinnerMode' | 'goal' | 'contextSegments' | 'tokens' | 'lastUsage' | 'lastUserText' | 'responseChars' | 'tps' | 'cancelPending' | 'working' | 'turnStart' | 'tpsSamples' | 'contextWindow' | 'reasoningEffort' | 'sessionTitle' | 'todos' | 'agentPreset' | 'sessionColor' | 'status' | 'emit'>;
+interface ProjectionDependencies {
+    agent(): Agent;
+    rowIds: {
+        value: number;
+    };
+    resetContextWarning(): void;
+    pendingTaskDescriptions: string[];
+    jobs: Pick<BackgroundJobStore, 'onOutputSeen' | 'onStarted'>;
+    inputConvergence: Pick<InputConvergence, 'cancelInFlight'>;
+    checkContextWarning(): void;
+    notify: ChannelState['notify'];
+    tools?: ToolsRegistryLike;
+    renderer?: TuiRendererHost;
+    /** DSH attachment service, resolved at call time (a late-mounted provider
+     *  must still serve images for rows projected earlier). */
+    attachments(): unknown;
+    /** What a submitted message's IDE selection attached (keyed by the message
+     *  id the durable event carries), for the user row's indicator line. */
+    selectionAttached(messageId: string): SelectionAttachment | undefined;
+}
+/** One authoritative reducer for both durable replay and live session events. */
+export declare function createChannelProjection(state: ProjectionState, deps: ProjectionDependencies): {
+    reset: () => void;
+    replayEvents: (events: readonly SessionEvent[]) => void;
+    renderEvent: (event: SessionEvent) => void;
+    renderStreamFrame: (frame: AssistantStreamFrame) => void;
+    settleStreaming: () => void;
+    updateSpinnerMode: () => void;
+    presentCallView: (name: string, rawArgs: string) => ToolCallView | undefined;
+    presentResultView: (name: string, rawArgs: string, data: SessionEvent<"tool/result">["data"]) => ToolResultView | undefined;
+    textOf: (content: readonly ContentBlock[] | undefined) => string;
+    firstTextOf: (content: readonly ContentBlock[] | undefined) => string;
+};
+export {};
+//# sourceMappingURL=projection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,sBAAsB,CAAA;AACrE,OAAO,KAAK,EAAE,YAAY,EAAwB,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACrH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAA;AAE9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAatD,KAAK,eAAe,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,GAAG,iBAAiB,GAAG,aAAa,GAAG,MAAM,GAAG,iBAAiB,GAAG,QAAQ,GAAG,WAAW,GAAG,cAAc,GAAG,eAAe,GAAG,KAAK,GAAG,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,eAAe,GAAG,iBAAiB,GAAG,cAAc,GAAG,OAAO,GAAG,aAAa,GAAG,cAAc,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAA;AACxX,UAAU,sBAAsB;IAC/B,KAAK,IAAI,KAAK,CAAA;IACd,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACzB,mBAAmB,IAAI,IAAI,CAAA;IAC3B,uBAAuB,EAAE,MAAM,EAAE,CAAA;IACjC,IAAI,EAAE,IAAI,CAAC,kBAAkB,EAAE,cAAc,GAAG,WAAW,CAAC,CAAA;IAC5D,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAA;IAC1D,mBAAmB,IAAI,IAAI,CAAA;IAC3B,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;IAC9B,KAAK,CAAC,EAAE,iBAAiB,CAAA;IACzB,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B;+DAC2D;IAC3D,WAAW,IAAI,OAAO,CAAA;IACtB;4EACwE;IACxE,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAA;CACrE;AACD,iFAAiF;AACjF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,sBAAsB;iBAi/BxE,IAAI;2BAhqBQ,SAAS,YAAY,EAAE,KAAG,IAAI;yBAiGhC,YAAY,KAAG,IAAI;+BAxBb,oBAAoB,KAAG,IAAI;2BAtKjC,IAAI;6BAgBF,IAAI;4BA3IH,MAAM,WAAW,MAAM,KAAG,YAAY,GAAG,SAAS;8BAYhD,MAAM,WAAW,MAAM,QAAQ,YAAY,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,KAAG,cAAc,GAAG,SAAS;sBAoBvG,SAAS,YAAY,EAAE,GAAG,SAAS,KAAG,MAAM;2BASvC,SAAS,YAAY,EAAE,GAAG,SAAS,KAAG,MAAM;EAm2B3E"}