@agi-fans/dsh-tui 0.1.0

package/lib/copy-selector.js

@@ -0,0 +1,136 @@
+/**
+ * `/copy` picker overlay: OMP-style list of transcript copy targets.
+ * Pure — the provider owns the clipboard write.
+ * @module @agi-fans/dsh-tui
+ */
+import { SYMBOL } from "./theme.js";
+import { truncateToWidth, visibleWidth, wrapText } from "./width.js";
+/** Visible picker rows. */
+export const COPY_SELECTOR_MAX_VISIBLE = 8;
+/** Preview lines under the list. */
+export const COPY_SELECTOR_PREVIEW_LINES = 4;
+/** First overlay-local row that paints a target. */
+export const COPY_SELECTOR_ITEM_ROW = 3;
+/** Open the picker on the assembled targets. */
+export function createCopySelector(items, selected = 0) {
+    return { items, selected: Math.max(0, Math.min(selected, Math.max(0, items.length - 1))) };
+}
+/** Visible item-index window around `selected`. */
+export function copySelectorVisibleRange(count, selected, maxVisible = COPY_SELECTOR_MAX_VISIBLE) {
+    const max = Math.max(1, maxVisible);
+    const index = Math.max(0, Math.min(selected, Math.max(0, count - 1)));
+    const start = Math.max(0, Math.min(index - Math.floor(max / 2), Math.max(0, count - max)));
+    return { start, end: Math.min(count, start + max) };
+}
+/** Item index under an overlay-local row, or undefined on chrome. */
+export function hitTestCopySelector(count, selected, localRow, maxVisible = COPY_SELECTOR_MAX_VISIBLE) {
+    const { start, end } = copySelectorVisibleRange(count, selected, maxVisible);
+    const index = start + (localRow - COPY_SELECTOR_ITEM_ROW);
+    if (index < start || index >= end)
+        return undefined;
+    return index;
+}
+/** Move the highlight to `index` without copying. */
+export function selectCopyTarget(state, index) {
+    if (state.items.length === 0)
+        return state;
+    const selected = Math.max(0, Math.min(index, state.items.length - 1));
+    if (selected === state.selected)
+        return state;
+    return { ...state, selected };
+}
+function moveSelected(state, next) {
+    if (state.items.length === 0)
+        return state;
+    const n = state.items.length;
+    const selected = (next % n + n) % n;
+    if (selected === state.selected)
+        return state;
+    return { ...state, selected };
+}
+/** Apply one decoded event to the overlay. */
+export function applyCopySelectorEvent(state, event) {
+    if (event.type === 'text' && event.value === ' ') {
+        const item = state.items[state.selected];
+        return item === undefined ? { kind: 'ignore' } : { kind: 'pick', item };
+    }
+    if (event.type !== 'key')
+        return { kind: 'ignore' };
+    switch (event.id) {
+        case 'enter': {
+            const item = state.items[state.selected];
+            return item === undefined ? { kind: 'ignore' } : { kind: 'pick', item };
+        }
+        case 'escape':
+        case 'ctrl+c':
+            return { kind: 'close' };
+        case 'up':
+        case 'shift+tab':
+            return { kind: 'update', state: moveSelected(state, state.selected - 1) };
+        case 'down':
+        case 'tab':
+            return { kind: 'update', state: moveSelected(state, state.selected + 1) };
+        case 'pageUp':
+            return { kind: 'update', state: moveSelected(state, state.selected - COPY_SELECTOR_MAX_VISIBLE) };
+        case 'pageDown':
+            return { kind: 'update', state: moveSelected(state, state.selected + COPY_SELECTOR_MAX_VISIBLE) };
+        case 'home':
+            return { kind: 'update', state: moveSelected(state, 0) };
+        case 'end':
+            return { kind: 'update', state: moveSelected(state, state.items.length - 1) };
+        default:
+            return { kind: 'ignore' };
+    }
+}
+/** Overlay frame: title, windowed rows, preview, hints. */
+export function renderCopySelector(state, theme, width, maxVisible = COPY_SELECTOR_MAX_VISIBLE) {
+    const count = state.items.length;
+    const index = Math.max(0, Math.min(state.selected, Math.max(0, count - 1)));
+    const title = ' ' + theme.bold(theme.fg('accent', '⎘ Copy'));
+    const { start, end } = copySelectorVisibleRange(count, index, maxVisible);
+    const rows = [];
+    if (count === 0) {
+        rows.push('  ' + theme.fg('muted', SYMBOL.info + ' Nothing to copy.'));
+    }
+    else {
+        for (let i = start; i < end; i += 1) {
+            const item = state.items[i];
+            if (item === undefined)
+                continue;
+            rows.push(renderCopyRow(item, i === index, theme, width));
+        }
+        if (count > maxVisible) {
+            rows.push(theme.fg('dim', '  ' + String(index + 1) + '/' + String(count)));
+        }
+    }
+    const preview = renderCopyPreview(state.items[index], theme, width);
+    const hints = ' ' + theme.fg('dim', '↑↓ navigate') + theme.fg('dim', ' · ')
+        + theme.fg('dim', 'enter copy') + theme.fg('dim', ' · ')
+        + theme.fg('dim', 'esc close');
+    const lines = ['', title, '', ...rows, '', ...preview, '', hints];
+    return {
+        lines,
+        cursor: { row: COPY_SELECTOR_ITEM_ROW + (index - start), column: 2 },
+    };
+}
+function renderCopyRow(item, selected, theme, width) {
+    const cursor = selected ? theme.fg('accent', SYMBOL.cursor + ' ') : '  ';
+    const label = selected ? theme.bold(theme.fg('accent', item.label)) : item.label;
+    const hint = item.hint === '' ? '' : theme.fg('dim', item.hint);
+    const fill = Math.max(1, width - visibleWidth(cursor) - visibleWidth(label) - visibleWidth(hint));
+    return truncateToWidth(cursor + label + ' '.repeat(fill) + hint, width);
+}
+function renderCopyPreview(item, theme, width) {
+    const header = '  ' + theme.fg('dim', item === undefined ? 'Preview' : 'Preview · ' + item.hint);
+    if (item === undefined)
+        return [header];
+    const wrapped = wrapText(item.text.replace(/\t/g, '  '), Math.max(1, width - 2));
+    const cap = COPY_SELECTOR_PREVIEW_LINES;
+    const visible = wrapped.slice(0, cap);
+    const extra = wrapped.length > cap ? wrapped.length - cap : 0;
+    const body = visible.map((line) => truncateToWidth('  ' + theme.fg('muted', line), width));
+    if (extra > 0)
+        body.push(theme.fg('dim', '  … ' + String(extra) + ' more lines'));
+    return [header, ...body];
+}
+//# sourceMappingURL=copy-selector.js.map

package/lib/copy-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-selector.js","sourceRoot":"","sources":["../src/copy-selector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,MAAM,EAAc,MAAM,YAAY,CAAA;AAC/C,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAEpE,2BAA2B;AAC3B,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAA;AAE1C,oCAAoC;AACpC,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAA;AAE5C,oDAAoD;AACpD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAA;AAevC,gDAAgD;AAChD,MAAM,UAAU,kBAAkB,CAAC,KAA0B,EAAE,QAAQ,GAAG,CAAC;IACzE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAC5F,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,wBAAwB,CACtC,KAAa,EACb,QAAgB,EAChB,UAAU,GAAG,yBAAyB;IAEtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAA;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACrE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;IAC1F,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,CAAC,EAAE,CAAA;AACrD,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,mBAAmB,CACjC,KAAa,EACb,QAAgB,EAChB,QAAgB,EAChB,UAAU,GAAG,yBAAyB;IAEtC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,wBAAwB,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAA;IAC5E,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,QAAQ,GAAG,sBAAsB,CAAC,CAAA;IACzD,IAAI,KAAK,GAAG,KAAK,IAAI,KAAK,IAAI,GAAG;QAAE,OAAO,SAAS,CAAA;IACnD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,gBAAgB,CAAC,KAAwB,EAAE,KAAa;IACtE,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAA;IACrE,IAAI,QAAQ,KAAK,KAAK,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC7C,OAAO,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,CAAA;AAC/B,CAAC;AAED,SAAS,YAAY,CAAC,KAAwB,EAAE,IAAY;IAC1D,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAC1C,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAA;IAC5B,MAAM,QAAQ,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;IACnC,IAAI,QAAQ,KAAK,KAAK,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC7C,OAAO,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,CAAA;AAC/B,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,sBAAsB,CAAC,KAAwB,EAAE,KAAe;IAC9E,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,KAAK,KAAK,GAAG,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QACxC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;IACzE,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;IACnD,QAAQ,KAAK,CAAC,EAAE,EAAE,CAAC;QACjB,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YACxC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;QACzE,CAAC;QACD,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ;YACX,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;QAC1B,KAAK,IAAI,CAAC;QACV,KAAK,WAAW;YACd,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAA;QAC3E,KAAK,MAAM,CAAC;QACZ,KAAK,KAAK;YACR,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAA;QAC3E,KAAK,QAAQ;YACX,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,GAAG,yBAAyB,CAAC,EAAE,CAAA;QACnG,KAAK,UAAU;YACb,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,GAAG,yBAAyB,CAAC,EAAE,CAAA;QACnG,KAAK,MAAM;YACT,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAA;QAC1D,KAAK,KAAK;YACR,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAA;QAC/E;YACE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;IAC7B,CAAC;AACH,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,kBAAkB,CAChC,KAAwB,EACxB,KAAY,EACZ,KAAa,EACb,UAAU,GAAG,yBAAyB;IAEtC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAA;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3E,MAAM,KAAK,GAAG,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAA;IAC5D,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,wBAAwB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAA;IACzE,MAAM,IAAI,GAAa,EAAE,CAAA;IACzB,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,GAAG,mBAAmB,CAAC,CAAC,CAAA;IACxE,CAAC;SAAM,CAAC;QACN,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YAC3B,IAAI,IAAI,KAAK,SAAS;gBAAE,SAAQ;YAChC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,KAAK,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAA;QAC3D,CAAC;QACD,IAAI,KAAK,GAAG,UAAU,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QAC5E,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;IACnE,MAAM,KAAK,GAAG,GAAG,GAAG,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;UACvE,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;UACtD,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;IAChC,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,CAAA;IACjE,OAAO;QACL,KAAK;QACL,MAAM,EAAE,EAAE,GAAG,EAAE,sBAAsB,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;KACrE,CAAA;AACH,CAAC;AAED,SAAS,aAAa,CAAC,IAAc,EAAE,QAAiB,EAAE,KAAY,EAAE,KAAa;IACnF,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACxE,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAA;IAChF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;IAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAA;IACjG,OAAO,eAAe,CAAC,MAAM,GAAG,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,CAAA;AACzE,CAAC;AAED,SAAS,iBAAiB,CAAC,IAA0B,EAAE,KAAY,EAAE,KAAa;IAChF,MAAM,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;IAChG,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IACvC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAA;IAChF,MAAM,GAAG,GAAG,2BAA2B,CAAA;IACvC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACrC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,CAAA;IAC1F,IAAI,KAAK,GAAG,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC,CAAC,CAAA;IACjF,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAA;AAC1B,CAAC"}

package/lib/copy-targets.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `/copy` targets from the live transcript: last assistant text, last fenced
+ * code block, or last bash command. Pure — the provider owns the clipboard.
+ * @module @agi-fans/dsh-tui
+ */
+import type { Block } from './event-views.ts';
+/** What `/copy` should pull from the transcript. */
+export type CopyKind = 'text' | 'code' | 'cmd';
+/** One clipboard payload plus the status label shown after a successful copy. */
+export interface CopyTarget {
+    text: string;
+    label: string;
+}
+/** Parse `/copy` arguments. Undefined when the token is not a known kind. */
+export declare function parseCopyKind(args: string): CopyKind | undefined;
+/** Fenced bodies in document order (`lang` is the info string). */
+export declare function extractCodeBlocks(text: string): {
+    lang: string;
+    code: string;
+}[];
+/** Cap on how many picker rows `/copy` lists (OMP recent-message window). */
+export declare const COPY_TARGET_LIMIT = 50;
+/** One row in the `/copy` picker (flat: messages, fences, bash commands). */
+export interface CopyPick {
+    id: string;
+    label: string;
+    hint: string;
+    text: string;
+    copyMessage: string;
+}
+/** Newest-first picker rows from the live transcript. */
+export declare function buildCopyTargets(blocks: readonly Block[], limit?: number): CopyPick[];
+/** Walk the transcript backwards for the requested copy target. */
+export declare function extractCopyTarget(blocks: readonly Block[], kind: CopyKind): CopyTarget | undefined;

package/lib/copy-targets.js

@@ -0,0 +1,170 @@
+/**
+ * `/copy` targets from the live transcript: last assistant text, last fenced
+ * code block, or last bash command. Pure — the provider owns the clipboard.
+ * @module @agi-fans/dsh-tui
+ */
+const FENCE = /^```([^\n]*)$/;
+/** Parse `/copy` arguments. Undefined when the token is not a known kind. */
+export function parseCopyKind(args) {
+    const token = args.trim().toLowerCase();
+    if (token === '' || token === 'text')
+        return 'text';
+    if (token === 'code')
+        return 'code';
+    if (token === 'cmd' || token === 'command')
+        return 'cmd';
+    return undefined;
+}
+/** Fenced bodies in document order (`lang` is the info string). */
+export function extractCodeBlocks(text) {
+    const lines = text.split('\n');
+    const blocks = [];
+    for (let i = 0; i < lines.length; i += 1) {
+        const open = FENCE.exec(lines[i] ?? '');
+        if (open === null)
+            continue;
+        let close = -1;
+        for (let k = i + 1; k < lines.length; k += 1) {
+            if ((lines[k] ?? '').startsWith('```')) {
+                close = k;
+                break;
+            }
+        }
+        if (close === -1)
+            continue;
+        blocks.push({ lang: (open[1] ?? '').trim(), code: lines.slice(i + 1, close).join('\n') });
+        i = close;
+    }
+    return blocks;
+}
+/** Cap on how many picker rows `/copy` lists (OMP recent-message window). */
+export const COPY_TARGET_LIMIT = 50;
+function firstLine(text) {
+    for (const line of text.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed !== '')
+            return trimmed.replace(/\s+/g, ' ');
+    }
+    return text.trim().replace(/\s+/g, ' ');
+}
+function pluralLines(text) {
+    const count = text.length === 0 ? 0 : text.split('\n').length;
+    return String(count) + ' line' + (count === 1 ? '' : 's');
+}
+function codeHint(lang, code) {
+    return lang === '' ? pluralLines(code) : lang + ' · ' + pluralLines(code);
+}
+function codeLabel(lang, code) {
+    const line = firstLine(code);
+    if (line !== '')
+        return line;
+    return lang === '' ? 'code block' : lang + ' block';
+}
+function pushCodePicks(items, source, nextId) {
+    for (const fence of extractCodeBlocks(source)) {
+        items.push({
+            id: nextId(),
+            label: codeLabel(fence.lang, fence.code),
+            hint: codeHint(fence.lang, fence.code),
+            text: fence.code,
+            copyMessage: fence.lang === '' ? 'code block' : fence.lang + ' block',
+        });
+    }
+}
+/** Newest-first picker rows from the live transcript. */
+export function buildCopyTargets(blocks, limit = COPY_TARGET_LIMIT) {
+    const items = [];
+    let messages = 0;
+    let codes = 0;
+    let commands = 0;
+    const cap = Math.max(0, limit);
+    for (let i = blocks.length - 1; i >= 0 && items.length < cap; i -= 1) {
+        const block = blocks[i];
+        if (block === undefined)
+            continue;
+        if (block.kind === 'assistant' && block.text.trim() !== '') {
+            messages += 1;
+            items.push({
+                id: 'msg:' + String(messages),
+                label: firstLine(block.text),
+                hint: pluralLines(block.text),
+                text: block.text,
+                copyMessage: messages === 1 ? 'last message' : 'assistant text',
+            });
+            if (items.length >= cap)
+                break;
+            pushCodePicks(items, block.text, () => {
+                codes += 1;
+                return 'code:' + String(codes);
+            });
+            continue;
+        }
+        if (block.kind !== 'tool')
+            continue;
+        if (block.output.trim() !== '') {
+            pushCodePicks(items, block.output, () => {
+                codes += 1;
+                return 'code:' + String(codes);
+            });
+        }
+        if (items.length >= cap)
+            break;
+        if (block.name !== 'bash')
+            continue;
+        const command = bashCommand(block.args);
+        if (command === undefined)
+            continue;
+        commands += 1;
+        items.push({
+            id: 'cmd:' + String(commands),
+            label: firstLine(command),
+            hint: 'bash · ' + pluralLines(command),
+            text: command,
+            copyMessage: 'bash command',
+        });
+    }
+    return items.slice(0, cap);
+}
+function bashCommand(args) {
+    try {
+        const parsed = JSON.parse(args);
+        if (typeof parsed === 'object' && parsed !== null && 'command' in parsed) {
+            const command = parsed.command;
+            if (typeof command === 'string' && command !== '')
+                return command;
+        }
+    }
+    catch {
+        /* not JSON */
+    }
+    return undefined;
+}
+/** Walk the transcript backwards for the requested copy target. */
+export function extractCopyTarget(blocks, kind) {
+    for (let i = blocks.length - 1; i >= 0; i -= 1) {
+        const block = blocks[i];
+        if (block === undefined)
+            continue;
+        if (kind === 'text' && block.kind === 'assistant' && block.text.trim() !== '') {
+            return { text: block.text, label: 'assistant text' };
+        }
+        if (kind === 'code') {
+            const source = block.kind === 'assistant'
+                ? block.text
+                : block.kind === 'tool' ? block.output : '';
+            const fences = extractCodeBlocks(source);
+            const last = fences[fences.length - 1];
+            if (last !== undefined) {
+                const lang = last.lang === '' ? 'code block' : last.lang + ' block';
+                return { text: last.code, label: lang };
+            }
+        }
+        if (kind === 'cmd' && block.kind === 'tool' && block.name === 'bash') {
+            const command = bashCommand(block.args);
+            if (command !== undefined)
+                return { text: command, label: 'bash command' };
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=copy-targets.js.map

package/lib/copy-targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-targets.js","sourceRoot":"","sources":["../src/copy-targets.ts"],"names":[],"mappings":"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"}

package/lib/definition.d.ts

@@ -0,0 +1,171 @@
+/**
+ * TUI capability seam — Service Definition.
+
+ * The tui service is the presentation role of the omdsh capability seam:
+ * the provider (./provider-local.ts) owns the terminal and the renderer,
+ * and consumers (./runner.ts) forward session events and read user input
+ * through this protocol. The vocabulary mirrors the SDK wire surface
+ * (session.event / session.status), so a future remote UI can reuse the
+ * definition unchanged.
+ * @module @agi-fans/dsh-tui
+ */
+import type { SessionEvent } from '@deepseek-ai/dsh-session';
+import type { ImageMediaType } from '@deepseek-ai/dsh-attachment';
+import type { TuiToolPresentation } from './tool-renderers.ts';
+/** Context service name providers publish under. */
+export declare const TUI_SERVICE = "tui";
+/** Whole-agent liveness, mirroring the SDK session.status vocabulary. */
+export type TuiStatus = 'idle' | 'running';
+/** Command metadata contributed by the active agent's plugin scope. */
+export interface TuiCommand {
+    name: string;
+    description: string;
+    inputHint?: string;
+}
+/** One terminal-owned human prompt used by approval and question adapters. */
+export interface TuiPrompt {
+    title: string;
+    question: string;
+    detail?: string;
+    options?: readonly {
+        /** Human-facing option name. */
+        label: string;
+        /** Answer returned to the caller; defaults to {@link label}. */
+        value?: string;
+        /** Secondary content preview shown above metadata in spacious lists. */
+        preview?: string;
+        description?: string;
+        /** Optional semantic badge painted after the description. */
+        badge?: {
+            label: string;
+            tone: 'success' | 'warning' | 'error' | 'muted';
+        };
+    }[];
+    multiSelect?: boolean;
+    allowCustom?: boolean;
+    /** Option value selected when a fixed-choice prompt opens. */
+    initialValue?: string;
+    /** Full-height searchable list instead of the default prompt card. */
+    presentation?: 'fullscreen-list' | 'plan-review';
+    /** Choice that approves a dedicated review; other choices may collect feedback. */
+    approveValue?: string;
+    /** Let typed text filter the available options. */
+    filterable?: boolean;
+    /** Verb shown after Enter in selector navigation, such as "run". */
+    submitLabel?: string;
+    signal?: AbortSignal;
+}
+/** Durable, Harness-owned session controls projected into terminal chrome. */
+export interface TuiSessionControls {
+    /** Logged Plan Mode state, including a selection awaiting the next step boundary. */
+    plan?: {
+        active: boolean;
+        pending: boolean;
+    };
+    /** Effective permission preset, such as workspace-write or danger-full-access. */
+    permission?: string;
+}
+/** Lightweight durable session row used by the welcome card and resume UI. */
+export interface TuiRecentSession {
+    id: string;
+    title: string;
+    preview?: string;
+    createdAt: number;
+    updatedAt?: number;
+    eventCount?: number;
+    status?: 'done' | 'interrupted' | 'blocked' | 'failed';
+}
+/** Optional whole-session figures shown below the editor. */
+export interface TuiSessionStats {
+    turns: number;
+    steps: number;
+    /** Summed model wall time over completed assistant messages. */
+    llmMs: number;
+    /** Summed matched tool-call wall time. */
+    toolMs: number;
+    /** Summed first-token latency over {@link ttftSteps}. */
+    ttftMs: number;
+    /** Number of steps carrying a recorded first-token latency. */
+    ttftSteps: number;
+    /** Summed decode wall time over usage-reporting steps. */
+    decodeMs: number;
+    /** Output tokens covered by {@link decodeMs}. */
+    decodeTokens: number;
+    /** All disjoint prompt-side billing buckets combined. */
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    contextTokens?: number;
+    contextWindow?: number;
+    elapsedMs?: number;
+}
+/** One unsent image draft owned by the terminal until submission succeeds. */
+export interface TuiInputImage {
+    data: Uint8Array;
+    mediaType: ImageMediaType;
+    name?: string;
+    width?: number;
+    height?: number;
+}
+/** Atomic composer submission: visible text plus its client-owned image drafts. */
+export interface TuiSubmission {
+    text: string;
+    images: readonly TuiInputImage[];
+}
+/**
+ * Terminal presentation service.
+ * Implementations must be single-consumer: one runner owns readInput().
+ */
+export interface TuiService {
+    /** Render one session-log event (streamed as recorded). */
+    event(event: SessionEvent, presentation?: TuiToolPresentation): void;
+    /** Update the status line liveness. */
+    setStatus(status: TuiStatus): void;
+    /** Update the model and effective reasoning effort shown in the composer. */
+    setModel(model: string, reasoningEffort?: string): void;
+    /** Replace the tool list shown by `/tools`. */
+    setTools(tools: readonly {
+        name: string;
+        description: string;
+    }[]): void;
+    /** Replace commands contributed by the active agent's Harness scope. */
+    setCommands(commands: readonly TuiCommand[]): void;
+    /** Append a direct UI/command result without fabricating a session event. */
+    notice(text: string, level?: 'info' | 'error'): void;
+    /** Append one successful plugin command result using the command-output surface. */
+    commandOutput(command: string, text: string): void;
+    /** Temporarily own the composer and collect one human answer. */
+    prompt(request: TuiPrompt): Promise<string | null>;
+    /** Replace the transcript when a new or resumed session becomes active. */
+    replaceSession(events: readonly SessionEvent[], presentations?: ReadonlyMap<number, TuiToolPresentation>): void;
+    /** Update session identity, recent rows, projected controls, and aggregate figures. */
+    setSession(info: {
+        id: string;
+        recent: readonly TuiRecentSession[];
+        stats?: TuiSessionStats;
+        controls?: TuiSessionControls;
+    }): void;
+    /**
+     * Read the next submitted composer value. Resolves null when the user quits
+     * (Ctrl-D on empty input, or stdin EOF in non-tty mode). One in-flight
+     * call at a time.
+     */
+    readInput(): Promise<TuiSubmission | null>;
+    /** Restore an accepted draft when persistence or dispatch fails. */
+    restoreInput(submission: TuiSubmission): void;
+    /**
+     * Subscribe to Ctrl-C. The listener fires when the user presses Ctrl-C
+     * while a turn is running; an idle Ctrl-C clears the input line instead.
+     * @returns disposer removing the listener.
+     */
+    onInterrupt(listener: () => void): () => void;
+    /** Restore terminal state and settle a pending input read with null. */
+    dispose(): void;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        /** The omdsh terminal presentation service. */
+        tui: TuiService;
+    }
+}

package/lib/definition.js

@@ -0,0 +1,14 @@
+/**
+ * TUI capability seam — Service Definition.
+
+ * The tui service is the presentation role of the omdsh capability seam:
+ * the provider (./provider-local.ts) owns the terminal and the renderer,
+ * and consumers (./runner.ts) forward session events and read user input
+ * through this protocol. The vocabulary mirrors the SDK wire surface
+ * (session.event / session.status), so a future remote UI can reuse the
+ * definition unchanged.
+ * @module @agi-fans/dsh-tui
+ */
+/** Context service name providers publish under. */
+export const TUI_SERVICE = 'tui';
+//# sourceMappingURL=definition.js.map

package/lib/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../src/definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,oDAAoD;AACpD,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAA"}

package/lib/editor.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Input-editor state machine: OMP readline/emacs bindings over a single
+ * buffer that may contain newlines. Pure — the provider owns history,
+ * interrupt, and process lifetime.
+ * @module @agi-fans/dsh-tui
+ */
+import type { KeyEvent } from './keys.ts';
+/** What the provider should do after a key is applied. */
+export type EditorCommand = {
+    kind: 'changed';
+    edited?: boolean;
+} | {
+    kind: 'submit';
+    text: string;
+} | {
+    kind: 'historyPrev';
+} | {
+    kind: 'historyNext';
+} | {
+    kind: 'interrupt';
+} | {
+    kind: 'clear';
+} | {
+    kind: 'quit';
+} | {
+    kind: 'suspend';
+} | {
+    kind: 'resetDisplay';
+} | {
+    kind: 'ignored';
+};
+/** Emacs-style kill ring (consecutive kills accumulate). */
+export declare class KillRing {
+    #private;
+    push(text: string, opts: {
+        prepend: boolean;
+        accumulate: boolean;
+    }): void;
+    peek(): string | undefined;
+    rotate(): void;
+    get length(): number;
+}
+/** Start index of the line containing `cursor`. */
+export declare function lineStart(text: string, cursor: number): number;
+/** End index (before newline, or length) of the line containing `cursor`. */
+export declare function lineEnd(text: string, cursor: number): number;
+/** Word-left: skip trailing whitespace, then the previous word. */
+export declare function moveWordLeft(text: string, cursor: number): number;
+/** Word-right: skip the current word, then following whitespace. */
+export declare function moveWordRight(text: string, cursor: number): number;
+/**
+ * Multiline input buffer with OMP editor bindings.
+ */
+export declare class InputEditor {
+    #private;
+    get text(): string;
+    get cursor(): number;
+    /** Replace the buffer (history recall). Clears undo. */
+    setText(text: string, cursor?: number): void;
+    /** Move the caret without changing text or undo. */
+    setCursor(cursor: number): void;
+    /** Empty the buffer, keeping undo of the previous contents. */
+    clear(): void;
+    /** Apply one decoded event. */
+    handle(event: KeyEvent): EditorCommand;
+}