@itookit/dsht 0.3.4 → 0.3.8

package/dist/ui/chat/history-view.js

@@ -12,6 +12,6 @@ import { useTheme } from "../theme/index.js";
  */
 export function HistoryViewport({ rows }) {
     const theme = useTheme();
-    return _jsx(Box, { flexDirection: "column", children: rows.map((row, index) => _jsx(Text, { color: theme.colors[row.kind], bold: row.bold, children: row.spans?.length ? row.spans.map((span, position) => _jsx(Text, { bold: span.bold, italic: span.italic, underline: span.underline, strikethrough: span.strikethrough, inverse: span.inverse, children: span.text }, position))
+    return _jsx(Box, { flexDirection: "column", children: rows.map((row, index) => _jsx(Text, { bold: row.bold, color: row.highlight ? theme.shell.foreground : theme.colors[row.kind], backgroundColor: row.highlight ? theme.shell.background : undefined, children: row.spans?.length ? row.spans.map((span, position) => _jsx(Text, { bold: span.bold, italic: span.italic, underline: span.underline, strikethrough: span.strikethrough, inverse: span.inverse, children: span.text }, position))
                 : row.text === '' ? ' ' : row.text }, index)) });
 }

package/dist/ui/chat/shell-view.d.ts

@@ -0,0 +1,34 @@
+import { type HistoryRow } from '../../session/history.ts';
+import type { ShellBlock } from '../../shell/index.ts';
+/** The part of a transcript layout this module needs to place a block. */
+export interface RowSource {
+    /** Number of host rows, live tail included. */
+    length: number;
+    /** Host rows in a range. */
+    viewport(start: number, end: number): HistoryRow[];
+    /** Projected messages in ascending sequence order. */
+    messages: readonly {
+        seq: number;
+    }[];
+    /** Row index where each visible message starts. */
+    offsets: ReadonlyMap<number, number>;
+}
+/** Rows for one run: the command bar, then its wrapped and indented output.
+ * @param run - Block from the shell controller.
+ * @param width - Available terminal columns.
+ * @returns Rows in display order.
+ */
+export declare function blockRows(run: ShellBlock, width: number): HistoryRow[];
+/** Splice every retained block into a transcript layout.
+ *
+ * Equal anchors keep creation order, and an anchor older than a block already placed is clamped to
+ * it, so the merged stream stays ordered even as history is paged in behind the reader.
+ * @param layout - Transcript layout to merge with.
+ * @param runs - Blocks from the shell controller, oldest first.
+ * @param width - Available terminal columns.
+ * @returns The merged row count and a reader over a merged range.
+ */
+export declare function mergeShellRuns(layout: RowSource, runs: readonly ShellBlock[], width: number): {
+    total: number;
+    viewport(start: number, end: number): HistoryRow[];
+};

package/dist/ui/chat/shell-view.js

@@ -0,0 +1,111 @@
+/** Local `!` blocks as transcript rows: a highlighted command bar, then its indented output.
+ *
+ * A block is spliced into the conversation where it happened — after the newest record the session
+ * had when the command started — so it scrolls away like any message instead of sitting pinned to
+ * the bottom of the screen.
+ */
+import stringWidth from 'string-width';
+import { plainRows } from "../../session/history.js";
+/** First output row's marker, so a block reads as the command's result. */
+const MARKER = '  ⎿  ';
+/** Rows after the first, aligned under the marker. */
+const GUTTER = '   ';
+/** Rows for one run: the command bar, then its wrapped and indented output.
+ * @param run - Block from the shell controller.
+ * @param width - Available terminal columns.
+ * @returns Rows in display order.
+ */
+export function blockRows(run, width) {
+    const reserve = Math.max(stringWidth(MARKER), stringWidth(GUTTER));
+    const rows = [{ text: `! ${run.command}`, kind: 'shell', bold: true, highlight: true }];
+    const body = [
+        ...(run.dropped > 0 ? [`… ${run.dropped} earlier lines dropped …`] : []),
+        ...run.lines,
+    ];
+    if (!body.length)
+        body.push(run.status === 'running' ? 'running…' : '(no output)');
+    body.forEach((line, index) => {
+        const wrapped = plainRows(line, Math.max(8, width - reserve), 'shell');
+        wrapped.forEach((row, position) => {
+            rows.push({ ...row, text: `${index === 0 && position === 0 ? MARKER : GUTTER}${row.text}` });
+        });
+    });
+    if (run.status === 'exited' && (run.signal != null || (run.code ?? 0) !== 0)) {
+        rows.push({ text: `${GUTTER}exit ${run.signal ?? run.code}`, kind: 'muted' });
+    }
+    return rows;
+}
+/** Host row index where a block anchored at `anchor` belongs.
+ *
+ * It goes after every row of the newest message it followed, which is the start of the next message,
+ * or the end of the layout when nothing newer is loaded.
+ * @param layout - Transcript layout to place into.
+ * @param anchor - Durable sequence the command followed.
+ * @returns Host row index.
+ */
+function rowAfter(layout, anchor) {
+    let low = 0, high = layout.messages.length;
+    while (low < high) {
+        const mid = (low + high) >> 1;
+        if (layout.messages[mid].seq <= anchor)
+            low = mid + 1;
+        else
+            high = mid;
+    }
+    if (low >= layout.messages.length)
+        return layout.length;
+    return layout.offsets.get(layout.messages[low].seq) ?? layout.length;
+}
+/** Splice every retained block into a transcript layout.
+ *
+ * Equal anchors keep creation order, and an anchor older than a block already placed is clamped to
+ * it, so the merged stream stays ordered even as history is paged in behind the reader.
+ * @param layout - Transcript layout to merge with.
+ * @param runs - Blocks from the shell controller, oldest first.
+ * @param width - Available terminal columns.
+ * @returns The merged row count and a reader over a merged range.
+ */
+export function mergeShellRuns(layout, runs, width) {
+    const placements = [];
+    let cursor = 0;
+    for (const run of runs) {
+        const at = Math.max(cursor, Math.min(layout.length, rowAfter(layout, run.anchor)));
+        placements.push({ at, rows: blockRows(run, width) });
+        cursor = at;
+    }
+    // Segments alternate host rows and block rows in merged index order.
+    const segments = [];
+    let merged = 0, host = 0;
+    for (const placement of placements) {
+        if (placement.at > host) {
+            segments.push({ from: merged, count: placement.at - host, host });
+            merged += placement.at - host;
+            host = placement.at;
+        }
+        segments.push({ from: merged, count: placement.rows.length, rows: placement.rows });
+        merged += placement.rows.length;
+    }
+    if (host < layout.length)
+        segments.push({ from: merged, count: layout.length - host, host });
+    const total = merged + Math.max(0, layout.length - host);
+    return {
+        total,
+        viewport(start, end) {
+            const rows = [];
+            for (const segment of segments) {
+                const segmentStart = segment.from, segmentEnd = segment.from + segment.count;
+                if (segmentEnd <= start || segmentStart >= end)
+                    continue;
+                const from = Math.max(0, start - segmentStart);
+                const to = Math.min(segment.count, end - segmentStart);
+                if (to <= from)
+                    continue;
+                if (segment.rows)
+                    rows.push(...segment.rows.slice(from, to));
+                else
+                    rows.push(...layout.viewport(segment.host + from, segment.host + to));
+            }
+            return rows;
+        },
+    };
+}

package/dist/ui/chat/status.js

@@ -236,7 +236,7 @@ export const StatusBar = memo(function StatusBar({ controller, expanded = false,
     const workspace = state.workspaces.find(item => item.workspaceId === state.workspaceId);
     const view = controller.telemetry.view(state.sessionId);
     const costs = controller.costs;
-    const sessionCost = costs?.hasSession(state.sessionId) ? costText(costs.total(state.sessionId)) : '?';
+    const sessionCost = controller.sessionCostText;
     const todayCost = costs ? costText(costs.today()) : '?';
     // `*` belongs to costText alone; incomplete coverage is a separate degradation, reported by `!`.
     const coverage = costs?.coverage ?? 'complete';
@@ -258,7 +258,7 @@ export const StatusBar = memo(function StatusBar({ controller, expanded = false,
         const billed = buckets[0] === undefined || buckets[2] === undefined ? undefined : buckets[0] + buckets[2] + (buckets[3] ?? 0);
         const hit = cacheHitText(buckets[2], billed);
         const compactCount = (value) => value === undefined ? '?' : compactNumber.format(value);
-        const phase = state.transcript.livePhase;
+        const phase = state.session.record.livePhase;
         const clock = running && since !== undefined ? ` ${clockText(now - since)}` : '';
         const phaseLabel = phase === undefined ? undefined
             : phase.kind === 'tool' ? `${phase.name ?? 'tool'} ${phaseText(now - phase.startedAt)}`
@@ -325,7 +325,7 @@ const StatusDetails = memo(function StatusDetails({ controller, theme, width, no
     const workspace = state.workspaces.find(item => item.workspaceId === state.workspaceId);
     const view = controller.telemetry.view(state.sessionId);
     const costs = controller.costs;
-    const sessionCost = costs?.hasSession(state.sessionId) ? costText(costs.total(state.sessionId)) : '?';
+    const sessionCost = controller.sessionCostText;
     const todayCost = costs ? costText(costs.today()) : '?';
     // `*` belongs to costText alone; incomplete coverage is a separate degradation, reported by `!`.
     const coverage = costs?.coverage ?? 'complete';
@@ -340,7 +340,7 @@ const StatusDetails = memo(function StatusDetails({ controller, theme, width, no
         { key: 'activity', color: state.pending.length > 0 ? theme.status.critical : running ? theme.colors.context : theme.colors.muted, text: state.pending.length > 0
                 ? '? Needs you · answer the request above to continue'
                 : running
-                    ? `◐ Working · ${duration}${state.transcript.activeTurnStartedAt === undefined ? ' (observed)' : ''} · Ctrl+C Stop`
+                    ? `◐ Working · ${duration}${state.session.record.activeTurnStartedAt === undefined ? ' (observed)' : ''} · Ctrl+C Stop`
                     : '● Ready · Ctrl+C exit' },
         { key: 'host', text: `${safeText(controller.base)} · ${safeText(state.status)}${!state.online ? ' · offline, last known status' : ''}` },
         ...state.sessionId

package/dist/ui/commands/parse.d.ts

@@ -56,6 +56,11 @@ export type Submission = {
 } | {
     kind: 'hostCommand';
     line: string;
+}
+/** A local `!` command, run on this machine rather than the host. */
+ | {
+    kind: 'shell';
+    command: string;
 } | {
     kind: 'export';
     destination?: string;

package/dist/ui/commands/parse.js

@@ -17,6 +17,15 @@ export function classifySubmission(raw, context) {
     const value = raw.trim();
     if (!value)
         return { kind: 'ignore' };
+    // `!` runs on the machine this client is on; it never reaches the host or the model.
+    if (value.startsWith('!')) {
+        const command = value.slice(1).trim();
+        if (!command)
+            return { kind: 'error', message: 'Type a command after !' };
+        if (context.screen !== 'chat')
+            return { kind: 'error', message: 'Select a session first' };
+        return { kind: 'shell', command };
+    }
     if (value === '/copy')
         return { kind: 'copy' };
     if (value === '/quit')

package/dist/ui/dialogs/index.d.ts

@@ -27,12 +27,9 @@ export declare function RemovalDialog({ removal, enabled, canSelect, onCancel, o
     onCancel(): void;
     onConfirm(): void;
 }): import("react").JSX.Element;
-/** Two-step model and reasoning-effort selector. */
-export interface ModelState {
-    catalog: ObjectValue;
-    provider?: string;
-    model?: ObjectValue;
-}
+import type { ModelState } from '../../session/index.ts';
+/** Two-step model and reasoning-effort selector; the state shape is shared with the session. */
+export type { ModelState };
 /** Model routes and adapter-owned reasoning efforts.
  * @param props - Catalog, current step and its selection actions.
  * @returns The model or effort picker.

package/dist/ui/theme/index.d.ts

@@ -3,6 +3,11 @@ import type { RowKind } from '../../session/history.ts';
 export interface Theme {
     name: string;
     colors: Record<RowKind, string>;
+    /** Bar drawn behind a local `!` command line, so it reads as this machine rather than the agent. */
+    shell: {
+        background: string;
+        foreground: string;
+    };
     status: Record<'working' | 'ready' | 'offline' | 'model' | 'cost' | 'context' | 'warning' | 'critical' | 'usage', string>;
     accent: string;
     border: string;

package/dist/ui/theme/index.js

@@ -4,7 +4,8 @@ import { createContext, useContext } from 'react';
 export const mocha = {
     name: 'Catppuccin Mocha',
     colors: { user: '#89b4fa', assistant: '#a6e3a1', context: '#f9e2af', text: '#cdd6f4',
-        reasoning: '#cba6f7', tool: '#89dceb', success: '#a6e3a1', error: '#f38ba8', muted: '#a6adc8' },
+        reasoning: '#cba6f7', tool: '#89dceb', success: '#a6e3a1', error: '#f38ba8', muted: '#a6adc8', shell: '#a6adc8' },
+    shell: { background: '#cdd6f4', foreground: '#1e1e2e' },
     status: { working: '#f9e2af', ready: '#a6e3a1', offline: '#f38ba8', model: '#cba6f7',
         cost: '#89dceb', context: '#a6e3a1', warning: '#f9e2af', critical: '#f38ba8', usage: '#a6adc8' },
     accent: '#cba6f7', border: '#6c7086',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itookit/dsht",
-  "version": "0.3.4",
+  "version": "0.3.8",
   "type": "module",
   "description": "Remote-first TUI for DeepSeek Harness with SSH-friendly mobile access and request-level cost tracking",
   "engines": {

package/dist/ui/input/history.d.ts

@@ -1,19 +0,0 @@
-/** Bounded, process-local recall history; never stores transcripts or writes prompt text to disk. */
-export declare class InputHistory {
-    private entries;
-    private bytes;
-    private position;
-    private draft;
-    /** Remember submitted input, coalescing consecutive duplicates and enforcing both budgets.
-     * @param value - Submitted command or prompt, excluding interaction answers.
-     */
-    record(value: string): void;
-    /** Leave recall navigation when the composer is edited or otherwise replaced. */
-    reset(): void;
-    /** Recall older/newer input, restoring the original unsent draft at the end.
-     * @param direction - Negative for older input, positive for newer input.
-     * @param current - Current composer content before beginning recall.
-     * @returns Recalled input, or the original draft when returning to the newest position.
-     */
-    move(direction: -1 | 1, current: string): string;
-}

package/dist/ui/input/history.js

@@ -1,43 +0,0 @@
-/** Bounded, process-local recall history; never stores transcripts or writes prompt text to disk. */
-export class InputHistory {
-    entries = [];
-    bytes = 0;
-    position;
-    draft = '';
-    /** Remember submitted input, coalescing consecutive duplicates and enforcing both budgets.
-     * @param value - Submitted command or prompt, excluding interaction answers.
-     */
-    record(value) {
-        this.reset();
-        if (!value || this.entries.at(-1) === value || value.length * 2 > 256 * 1024)
-            return;
-        this.entries.push(value);
-        this.bytes += value.length * 2;
-        while (this.entries.length > 200 || this.bytes > 256 * 1024)
-            this.bytes -= this.entries.shift().length * 2;
-    }
-    /** Leave recall navigation when the composer is edited or otherwise replaced. */
-    reset() { this.position = undefined; this.draft = ''; }
-    /** Recall older/newer input, restoring the original unsent draft at the end.
-     * @param direction - Negative for older input, positive for newer input.
-     * @param current - Current composer content before beginning recall.
-     * @returns Recalled input, or the original draft when returning to the newest position.
-     */
-    move(direction, current) {
-        if (!this.entries.length)
-            return current;
-        if (this.position === undefined) {
-            if (direction > 0)
-                return current;
-            this.position = this.entries.length;
-            this.draft = current;
-        }
-        this.position = Math.max(0, Math.min(this.entries.length, this.position + direction));
-        if (this.position === this.entries.length) {
-            const draft = this.draft;
-            this.reset();
-            return draft;
-        }
-        return this.entries[this.position];
-    }
-}