@askdkc/dsh-cli 0.11.3

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

@@ -0,0 +1,306 @@
+import { toolResultPayload } from '../compat/messages.js';
+import { markChannelReadDirty } from '../../adapter/channel/read-view.js';
+export const ARGS_PREVIEW_LIMIT = 160;
+export const RESULT_PREVIEW_LIMIT = 240;
+/** Local `!`-command output cap (mirrors the result preview limit). */
+export const LOCAL_OUTPUT_LIMIT = 240;
+/**
+ * In-memory transcript window cap. Older rows beyond this count are FOLDED:
+ * their full-text fields (assistant/reasoning text, tool args/results) are
+ * dropped and only the preview/status metadata kept, so a long merge/deploy
+ * turn cannot grow the TUI's RAM without bound. The session log remains the
+ * complete source of truth (`/export` reads it, `/resume` replays it); the
+ * folded row keeps its kind/id so scrolling and selection stay stable.
+ */
+export const MAX_ROWS = 600;
+export function preview(text, limit) {
+    const flat = text.replace(/\s+/g, ' ').trim();
+    return flat.length <= limit ? flat : `${flat.slice(0, limit)}…`;
+}
+/**
+ * Fold the oldest rows beyond the transcript window cap: drop each row's
+ * full-text fields (assistant/reasoning text, tool args/results) and keep
+ * only its preview text, kind, id, and seq. Bounds the TUI's retained text
+ * without touching the session log (the source of truth for /export and
+ * loadOlder). Small local/notice/interrupt rows are left intact (they hold
+ * terminal-local text the log cannot restore). Restored rows are exempt so
+ * a loadOlder() restore is not instantly undone. Returns the number of rows
+ * folded.
+ */
+export function foldRows(rows, cap, cursor) {
+    const excess = rows.length - cap;
+    if (excess <= 0) {
+        if (cursor !== undefined)
+            cursor.index = 0;
+        return 0;
+    }
+    // Incremental pass: rows only ever append past the fold line and the
+    // folded/restored exemptions are permanent, so everything below a cursor
+    // over the SAME array identity needs no re-inspection. emit/emitStream
+    // fold on every frame during streaming — a full rescan of a long window
+    // there was the O(rows) per-frame term of long-session streaming.
+    const from = cursor === undefined ? 0 : cursor.rows === rows ? cursor.index : 0;
+    if (cursor !== undefined)
+        cursor.rows = rows;
+    if (excess <= from)
+        return 0;
+    let folded = 0;
+    for (const row of rows.slice(from, excess)) {
+        if (row.folded || row.restored)
+            continue;
+        if (row.kind !== 'user' && row.kind !== 'assistant' && row.kind !== 'reasoning' && row.kind !== 'tool')
+            continue;
+        row.folded = true;
+        folded += 1;
+        if (row.kind === 'tool' && row.tool) {
+            row.tool.argsFull = undefined;
+            row.tool.resultFull = undefined;
+            row.tool.errorText = undefined;
+            // Presentation views hold duplicated content strings (diff before/
+            // after images, terminal output); the session log re-derives them.
+            row.tool.callView = undefined;
+            row.tool.resultView = undefined;
+        }
+        else if (row.text.length > 0) {
+            // Keep a short preview so the transcript reads naturally; the full
+            // text lives in the session log and is restored by loadOlder().
+            row.text = preview(row.text, 200);
+        }
+        markChannelReadDirty(row);
+        markChannelReadDirty(rows);
+    }
+    if (cursor !== undefined)
+        cursor.index = excess;
+    return folded;
+}
+/**
+ * Restore folded rows from the session log, newest folded batch first.
+ * Rebuilds each folded row's full text from its source events and clears
+ * the folded mark, keeping row ids, scroll anchors, and selection stable.
+ * `views` re-derives the tool presentation views foldRows dropped (the
+ * presenters live on the host plane, so the channel passes them in).
+ * Returns the number of rows restored.
+ */
+export function foldBack(rows, events, views) {
+    const folded = rows.filter(row => row.folded);
+    if (folded.length === 0)
+        return 0;
+    const firstFoldedSeq = folded[0]?.seq ?? 0;
+    const restoreEvents = events.filter(event => event.seq >= firstFoldedSeq);
+    // tool results are matched by callId, not seq, because the result event
+    // seq differs from the call event seq that anchored the row.
+    const resultsByCall = new Map();
+    for (const event of restoreEvents) {
+        if (event.type === 'tool/result') {
+            resultsByCall.set(event.data.message.source.callId, event);
+        }
+    }
+    let restored = 0;
+    for (const row of folded) {
+        const rowSeq = row.seq;
+        if (rowSeq === undefined)
+            continue;
+        if (row.kind === 'tool' && row.tool !== undefined) {
+            // The tool row is anchored on its tool/call seq; its result text comes
+            // from the matching tool/result event.
+            const call = restoreEvents.find(event => event.seq === rowSeq && event.type === 'tool/call');
+            if (call === undefined || call.type !== 'tool/call')
+                continue;
+            restoreRowFromEvent(row, call);
+            const result = resultsByCall.get(row.tool.callId);
+            if (result !== undefined)
+                restoreToolResult(row, result);
+            row.tool.callView = views?.call(call.data.name, call.data.arguments);
+            row.tool.resultView = result !== undefined && row.tool.status === 'ok'
+                ? views?.result(call.data.name, call.data.arguments, result.data)
+                : undefined;
+            row.folded = false;
+            markChannelReadDirty(row);
+            markChannelReadDirty(rows);
+            restored += 1;
+            continue;
+        }
+        // Text rows are anchored on their first delta chunk; the settled
+        // assistant/message at or after that seq carries the full text.
+        const message = restoreEvents.find(event => event.seq >= rowSeq && event.type === 'assistant/message');
+        if (message === undefined)
+            continue;
+        restoreRowFromEvent(row, message);
+        row.folded = false;
+        markChannelReadDirty(row);
+        markChannelReadDirty(rows);
+        restored += 1;
+    }
+    return restored;
+}
+/** Rebuild a folded row's full text from its source session event. */
+export function restoreRowFromEvent(row, event) {
+    switch (row.kind) {
+        case 'user': {
+            if (event.type !== 'user/message')
+                break;
+            const text = event.data.content.map(block => block.type === 'text' ? block.text : '').join('').trim();
+            if (text)
+                row.text = text;
+            break;
+        }
+        case 'assistant': {
+            if (event.type !== 'assistant/message')
+                break;
+            const text = event.data.message.content.map(block => block.type === 'text' ? block.text : '').join('').trim();
+            if (text)
+                row.text = text;
+            break;
+        }
+        case 'reasoning': {
+            // Thinking text is carried by the assistant/message's reasoning
+            // blocks, not the (ephemeral) delta chunks, so the settled message
+            // restores it exactly.
+            if (event.type !== 'assistant/message')
+                break;
+            const text = event.data.message.content.map(block => block.type === 'reasoning' ? block.text : '').join('').trim();
+            if (text)
+                row.text = text;
+            break;
+        }
+        case 'tool': {
+            if (event.type !== 'tool/call' || row.tool === undefined)
+                break;
+            row.tool.argsFull = event.data.arguments;
+            break;
+        }
+        default:
+            break;
+    }
+}
+/** Render the durable tool-result payload, including provider error details. */
+export function toolResultText(event) {
+    return toolResultPayload(event.data.message).content.map(item => item.type === 'text' ? item.text : '').join('').trim();
+}
+/** Phase badge for the harness goal card — mirrors the panel's PhaseBadge. */
+export const GOAL_RESULT_BADGE = {
+    active: '● active',
+    paused: '⏸ paused',
+    blocked: '⛔ blocked',
+    complete: '✓ complete',
+};
+/**
+ * Summary cards for the harness's goal/todo tools. Their results are machine
+ * JSON (`{"goal":{…}}` / `{"todos":[…]}`) that would otherwise dump under the
+ * tool card as a raw `⎿ {"goal":…}` line. Matched by tool-name substring AND
+ * payload shape, so unrelated tools and plain-text results pass through to
+ * the registry/raw-text path untouched. Runs on the live stream and replay.
+ */
+export function harnessToolResultView(name, data) {
+    const lower = name.toLowerCase();
+    const isGoalTool = lower.includes('goal');
+    const isTodoTool = lower.includes('todo');
+    if (!isGoalTool && !isTodoTool)
+        return undefined;
+    const text = toolResultPayload(data.message).content.map(item => item.type === 'text' ? item.text : '').join('').trim();
+    if (text === '' || !text.startsWith('{'))
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        return undefined;
+    const record = parsed;
+    if (isGoalTool && typeof record.goal === 'object' && record.goal !== null) {
+        const goal = record.goal;
+        if (typeof goal.objective === 'string' && typeof goal.phase === 'string') {
+            const badge = GOAL_RESULT_BADGE[goal.phase] ?? goal.phase;
+            const rounds = typeof goal.roundsStarted === 'number' && typeof goal.maxGoalRounds === 'number'
+                ? ` · ${goal.roundsStarted}/${goal.maxGoalRounds}`
+                : '';
+            const activation = typeof record.activation === 'string' ? ` · ${record.activation}` : '';
+            const lines = [`🎯 ${goal.objective}`, `${badge}${rounds}${activation}`];
+            const blocked = goal.blockedReason?.message;
+            if (typeof blocked === 'string')
+                lines.push(`⛔ ${blocked}`);
+            return { card: 'generic', content: lines.map(line => ({ type: 'text', text: line })) };
+        }
+    }
+    if (isTodoTool && Array.isArray(record.todos)) {
+        const rows = record.todos;
+        const done = rows.filter(row => row.status === 'completed').length;
+        const lines = [`todos ✓ ${done}/${rows.length}`];
+        for (const row of rows) {
+            if (row.status !== 'in_progress' || typeof row.content !== 'string')
+                continue;
+            lines.push(`● ${row.content}`);
+            if (lines.length >= 4)
+                break;
+        }
+        return { card: 'generic', content: lines.map(line => ({ type: 'text', text: line })) };
+    }
+    return undefined;
+}
+export function toolErrorText(event) {
+    const failure = event.data.error;
+    if (failure === undefined)
+        return toolResultPayload(event.data.message).isError ? toolResultText(event) : '';
+    const identity = `${failure.name}: ${failure.code}`;
+    const detail = toolResultText(event);
+    return detail === '' || detail === identity ? identity : `${identity} — ${detail}`;
+}
+/** Restore a folded tool row's result text from its tool/result event. */
+export function restoreToolResult(row, event) {
+    if (row.tool === undefined)
+        return;
+    if (event.data.error !== undefined || toolResultPayload(event.data.message).isError) {
+        row.tool.status = 'error';
+        row.tool.errorText = toolErrorText(event);
+        return;
+    }
+    row.tool.status = 'ok';
+    const result = toolResultText(event);
+    row.tool.resultFull = result || undefined;
+}
+/**
+ * Prepare durable events for REPLAY (resume / rewind / model-switch fork):
+ * drop settled `assistant/chunk` stream deltas — the sealed
+ * `assistant/message` events carry the full text and reasoning blocks, so
+ * per-token chunks add nothing to the replayed transcript while costing a
+ * per-chunk renderEvent pass (a real 4.5MB session logs ~19k chunks against
+ * ~30 messages). The trailing chunk run AFTER the last message belongs to an
+ * unfinished step (crash-orphaned turn) and is kept, so a resumed session
+ * still shows its partial content. Storage-level packed rows
+ * (`text-chunks`/`reasoning-chunks`/`tool-call-chunks`) are dropped the
+ * same way — defensive: the jsonl reader expands them, but a future
+ * direct-pass path must not resurrect them. Replay-side tps sampling is
+ * lost with the chunks (a live metric; lastUsage comes from the message's
+ * own usage). Live events never go through this.
+ */
+export function prepareReplayEvents(events) {
+    let lastMessageSeq = -1;
+    for (const event of events) {
+        if (event.type === 'assistant/message')
+            lastMessageSeq = event.seq;
+    }
+    return events.filter(event => {
+        if (event.type === 'assistant/message')
+            return true;
+        // Pre-V3 chunk events and storage-level packed rows are not in the
+        // current SessionEvent union (0.1.5 embeds the stream inside
+        // `assistant/message`), so compare through a widened view — the filters
+        // below exist exactly for data the static type doesn't know.
+        const packedType = event.type;
+        if (packedType === 'assistant/chunk') {
+            // Keep only the in-flight tail (no message sealed after it).
+            return lastMessageSeq < 0 || event.seq > lastMessageSeq;
+        }
+        // Storage-level packed rows: the jsonl reader expands them, but a future
+        // direct-pass path must not resurrect them.
+        if (packedType === 'text-chunks' ||
+            packedType === 'reasoning-chunks' ||
+            packedType === 'tool-call-chunks') {
+            return false;
+        }
+        return true;
+    });
+}

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

@@ -0,0 +1,167 @@
+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, ChannelGoal, TodoPanelItem, LoadedContext, LoadedContextEntry, LoadedContextFile, LoadedContextSkill, LoadedContextTool, PendingMessage, SubagentControl, JobControl, StagedImageInput, StagedImageAdjustment, 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;
+        /** Per-side intrinsic pixel cap (mirrored from the upstream store's
+         *  ImageAttachmentLimits — used by the composer's ingress resample). */
+        readonly maxImageDimension: number;
+        /** Total-pixel cap ditto. */
+        readonly maxImagePixels: 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,23 @@
+import type { TuiWorkspaceEntry, 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[]>;
+    listWorkspaceRegistry: () => Promise<readonly TuiWorkspaceEntry[]>;
+    removeWorkspace: (path: string) => Promise<boolean>;
+    renameWorkspaceAt: (path: string, title: string) => Promise<boolean>;
+    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,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC/F,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;;iCAciC,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC;4BAElC,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;8BAgBvB,MAAM,SAAS,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;4BA5BhD,MAAM;8BAuCE,kBAAkB,KAAG,OAAO,CAAC,OAAO,CAAC;6BAsBtC,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;;gCAakJ,MAAM,SAAS,MAAM;EACvO"}