@xp266/dshtui 0.1.0

package/bin/dshtui.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+/**
+ * dshtui — standalone launcher. Boots the DeepSeek Harness profile that
+ * carries this TUI, equivalent to `dsh --profile <profile> [args...]`.
+ *
+ * The dsh CLI's subcommands are hardcoded upstream, so the command lives in
+ * this package's bin instead. The profile defaults to `dshtui` and can be
+ * overridden with DSH_TUI_PROFILE. On first run (profile directory absent)
+ * the profile is bootstrapped from the published package version, which is
+ * also the version the profile later upgrades through `dsh plugin add`.
+ *
+ * This file must stay free of lib/ imports so it works from a global
+ * install, a profile copy, and a dev checkout alike.
+ */
+import { spawn, spawnSync } from 'node:child_process'
+import { existsSync, readFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)))
+const manifest = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8'))
+const profile = process.env.DSH_TUI_PROFILE ?? 'dshtui'
+const dshHome = process.env.DSH_HOME ?? join(homedir(), '.dsh')
+const profileDir = join(dshHome, 'profiles', profile)
+
+function fail(message) {
+  console.error(`dshtui: ${message}`)
+  process.exit(1)
+}
+
+const dshProbe = spawnSync('dsh', ['--version'], { stdio: 'ignore', shell: process.platform === 'win32' })
+if (dshProbe.error !== undefined) {
+  fail('the dsh CLI was not found on PATH; install it with: npm install -g @deepseek-ai/dsh')
+}
+
+if (!existsSync(profileDir)) {
+  console.error(`dshtui: profile "${profile}" not found under ${join(dshHome, 'profiles')}; installing ${manifest.name}@${manifest.version} into it`)
+  const bootstrap = spawnSync(
+    'dsh',
+    ['plugin', '--profile', profile, 'add', `${manifest.name}@${manifest.version}`],
+    { stdio: 'inherit', shell: process.platform === 'win32' },
+  )
+  if (bootstrap.status !== 0) {
+    fail(`bootstrapping the profile failed; create it manually with: dsh plugin --profile ${profile} add ${manifest.name}`)
+  }
+}
+
+const argv = process.argv.slice(2)
+const child = spawn('dsh', ['--profile', profile, ...argv], {
+  stdio: 'inherit',
+  ...(process.platform === 'win32'
+    ? { shell: true, windowsVerbatimArguments: true }
+    : {}),
+})
+child.on('error', () => {
+  fail('the dsh CLI was not found on PATH; install it with: npm install -g @deepseek-ai/dsh')
+})
+child.on('close', (status, signal) => {
+  if (signal !== null) {
+    process.kill(process.pid, signal)
+    return
+  }
+  process.exit(status ?? 1)
+})

package/cordis.patch.yml

@@ -0,0 +1,81 @@
+- insert:
+    - id: storage
+      name: '@deepseek-ai/dsh-storage'
+    - id: storage-json
+      name: '@deepseek-ai/dsh-storage-json'
+      config:
+        root: !!js dshHomePath('storages')
+    - id: storage-domain
+      name: '@deepseek-ai/dsh-storage-domain'
+      config:
+        backend: json
+    # Persisted title/blank hints so the session picker lists cold sessions
+    # without reading their logs.
+    - id: session-projection-cache
+      name: '@deepseek-ai/dsh-session-projection-cache'
+      config:
+        writeEveryEvents: 200
+        writeIntervalMs: 5000
+    - id: workspace
+      name: '@deepseek-ai/dsh-workspace'
+    - id: agent-presets
+      name: '@deepseek-ai/dsh-agent-presets'
+      config:
+        default: standard
+    - id: cordis-host-runner
+      name: '@deepseek-ai/dsh-cordis-host-runner'
+    # Durable image storage comes from the dsh base bundle's attachment-local
+    # row; the TUI resolves ctx.attachments at send time and degrades to a
+    # plain text message when the service is absent.
+    - id: tui
+      name: '@xp266/dshtui'
+
+# The per-agent rows move behind agent presets: each preset owns its own tool
+# and prompt composition, so the process-level rows must not also register
+# (the agent would see every tool twice).
+- id: tool-bash
+  disabled: true
+- id: tool-pwsh
+  disabled: true
+- id: tool-jobs
+  disabled: true
+- id: tool-fs
+  disabled: true
+- id: tool-fs-search
+  disabled: true
+- id: tool-str-replace-editor
+  disabled: true
+- id: skill-filesystem
+  disabled: true
+- id: tool-skill
+  disabled: true
+- id: tool-goal
+  disabled: true
+- id: plan-mode
+  disabled: true
+- id: compaction-basic
+  disabled: true
+- id: command-compact
+  disabled: true
+- id: tool-result-pruner
+  disabled: true
+- id: tool-subagent-control
+  disabled: true
+- id: tool-subagent-list-agents
+  disabled: true
+- id: tool-subagent
+  disabled: true
+- id: tool-subagent-fork
+  disabled: true
+- id: workflow-worker-thread
+  disabled: true
+- id: tool-workflow
+  disabled: true
+- id: tool-ralph
+  disabled: true
+- id: agent-instructions
+  disabled: true
+- id: tool-todo
+  disabled: true
+- id: tool-web
+  disabled: true

package/lib/contract/index.d.mts

@@ -0,0 +1,2 @@
+import { $ as ToolCallPresentation, A as MessageViewContribution, At as TuiToolsFace, B as PointerSession, Bt as MouseEventData, C as MarkdownBlockContext, Ct as TuiPaletteFace, D as MessageRendererContribution, Dt as TuiSessionSummary, E as MarkdownInlineContribution, Et as TuiServicesFace, F as PasteContext, Ft as WindowCommandSpec, G as SelectionExtractContext, H as PrismGrammarContribution, Ht as MessageKind, I as PasteHandlerContribution, It as WindowContribution, J as SpecialFieldCreateInput, K as SelectionTransformerContribution, L as PasteResult, Lt as WindowHandle, M as OverlayContribution, Mt as TuiWindowsFace, N as POINTER_PLUGIN_ORDER, Nt as WidgetDef, O as MessageRendererResult, Ot as TuiStartupFace, P as PaintArgs, Pt as WidgetKeyApi, Q as ThemePaletteContribution, R as PointerEventFrame, Rt as WindowProps, S as KeyBindingContribution, St as TuiMarkdownFace, T as MarkdownInlineContext, Tt as TuiSelectionFace, U as SelectionClipboardContribution, Ut as LineSelection, V as PointerUiContext, Vt as MouseEventType, W as SelectionDomainContribution, Wt as PendingImage, X as SpecialFieldStyle, Y as SpecialFieldFactory, Z as StatusLineContribution, _ as InputStatusContext, _t as TuiHomeLogoFace, a as CommandDef, at as ToolViewContribution, b as InteractionPanelComponentProps, bt as TuiKey, c as CustomMessageSeed, ct as TuiChatFace, d as DiffLine, dt as TuiCommandsFace, et as ToolReadLine, f as DiffLineKind, ft as TuiComposerFace, g as HomeLogoContribution, gt as TuiHintFace, h as HintMatcherContribution, ht as TuiFieldsFace, i as ClipboardBackendContribution, it as ToolViewCallContext, j as MessageViewRender, jt as TuiWidgetsFace, k as MessageViewContext, kt as TuiStartupSink, l as DialogItemKinds, lt as TuiChromeFace, m as HintEntry, mt as TuiExtensionPoint, n as ClickActions, nt as ToolResultPresentation, o as ComposerInsertSpec, ot as ToolViewDiff, p as HintArgsContribution, pt as TuiContentFace, q as SpecialFieldContribution, r as ClickHit, rt as ToolResultView, s as CustomMessage, st as ToolViewResultContext, t as ChatNodeDefinition, tt as ToolReadView, u as DiffHunk, ut as TuiClipboardFace, v as InputStatusContribution, vt as TuiInteractionPanelsFace, w as MarkdownBlockContribution, wt as TuiPointerFace, x as InteractionPanelContribution, xt as TuiKeymapFace, y as InputStatusPart, yt as TuiInteractionsFace, z as PointerHandlerContribution, zt as ScrollSnapshot } from "../index-DqnaSXqP.mjs";
+export { ChatNodeDefinition, ClickActions, ClickHit, ClipboardBackendContribution, CommandDef, ComposerInsertSpec, CustomMessage, CustomMessageSeed, DialogItemKinds, DiffHunk, DiffLine, DiffLineKind, HintArgsContribution, HintEntry, HintMatcherContribution, HomeLogoContribution, InputStatusContext, InputStatusContribution, InputStatusPart, InteractionPanelComponentProps, InteractionPanelContribution, KeyBindingContribution, type LineSelection, MarkdownBlockContext, MarkdownBlockContribution, MarkdownInlineContext, MarkdownInlineContribution, type MessageKind, MessageRendererContribution, MessageRendererResult, MessageViewContext, MessageViewContribution, MessageViewRender, type MouseEventData, type MouseEventType, OverlayContribution, POINTER_PLUGIN_ORDER, PaintArgs, PasteContext, PasteHandlerContribution, PasteResult, type PendingImage, PointerEventFrame, PointerHandlerContribution, PointerSession, PointerUiContext, PrismGrammarContribution, type ScrollSnapshot, SelectionClipboardContribution, SelectionDomainContribution, SelectionExtractContext, SelectionTransformerContribution, SpecialFieldContribution, SpecialFieldCreateInput, SpecialFieldFactory, SpecialFieldStyle, StatusLineContribution, ThemePaletteContribution, ToolCallPresentation, ToolReadLine, ToolReadView, ToolResultPresentation, ToolResultView, ToolViewCallContext, ToolViewContribution, ToolViewDiff, ToolViewResultContext, TuiChatFace, TuiChromeFace, TuiClipboardFace, TuiCommandsFace, TuiComposerFace, TuiContentFace, TuiExtensionPoint, TuiFieldsFace, TuiHintFace, TuiHomeLogoFace, TuiInteractionPanelsFace, TuiInteractionsFace, TuiKey, TuiKeymapFace, TuiMarkdownFace, TuiPaletteFace, TuiPointerFace, TuiSelectionFace, TuiServicesFace, TuiSessionSummary, TuiStartupFace, TuiStartupSink, TuiToolsFace, TuiWidgetsFace, TuiWindowsFace, WidgetDef, WidgetKeyApi, WindowCommandSpec, WindowContribution, WindowHandle, WindowProps };

package/lib/contract/index.mjs

@@ -0,0 +1,5 @@
+//#region src/contract/index.ts
+/** Builtin gesture handlers live at order 100..190; see registerPointerHandler. */
+const POINTER_PLUGIN_ORDER = 300;
+//#endregion
+export { POINTER_PLUGIN_ORDER };

package/lib/dialog.d.mts

@@ -0,0 +1,156 @@
+import { Gt as Segment, Lt as WindowHandle, Nt as WidgetDef, l as DialogItemKinds } from "./index-DqnaSXqP.mjs";
+import { ReactNode, Ref } from "react";
+//#region src/ui/dialog/items.d.ts
+interface DialogRow {
+  items: DialogItem[];
+}
+type PluginDialogItem = DialogItemKinds[keyof DialogItemKinds];
+type DialogItem = {
+  type: 'input';
+  label: string;
+  value: string;
+  onChange: (value: string) => void;
+  onEnter?: () => void;
+} | {
+  type: 'select';
+  label: string;
+  value: string;
+  options: string[];
+  onChange: (value: string) => void;
+  onEnter?: () => void;
+  spaced?: boolean;
+} | {
+  type: 'search';
+  value: string;
+  onChange: (value: string) => void;
+} | {
+  type: 'button';
+  label: string;
+  right?: string;
+  rightColor?: string;
+  onPress: () => void;
+} | {
+  type: 'checkbox';
+  label: string;
+  checked: boolean;
+  onToggle: () => void;
+  onConfirm: () => void;
+} | {
+  type: 'header';
+  label: string;
+  leadingBlank?: boolean;
+} | {
+  type: 'static';
+  label: string;
+} | {
+  type: 'actions';
+  confirmLabel: string;
+  cancelLabel: string;
+  onConfirm: () => void;
+  onCancel: () => void;
+} | {
+  type: string;
+  data?: unknown;
+} | PluginDialogItem;
+interface DialogFocus {
+  row: number;
+  col: number;
+}
+type TextItem = Extract<DialogItem, {
+  type: 'input';
+}> | Extract<DialogItem, {
+  type: 'search';
+}>;
+declare function asTextItem(item: DialogItem): TextItem | null;
+//#endregion
+//#region src/ui/dialog/geometry.d.ts
+interface DialogFooterLine {
+  text: string;
+  color?: string;
+}
+interface FooterRenderLine {
+  text: string;
+  color?: string;
+}
+declare function wrapStatusLines(lines: DialogFooterLine[] | undefined, width: number): FooterRenderLine[];
+declare function rowHeight(row: DialogRow, width: number): number;
+//#endregion
+//#region src/ui/dialog/dialog.d.ts
+interface DialogProps {
+  width: number;
+  maxHeight: number;
+  title?: string;
+  rows: DialogRow[];
+  footer?: DialogFooterLine[];
+  errors?: DialogFooterLine[];
+  onClose: () => void;
+  search?: boolean;
+  searchRight?: boolean;
+  centerScroll?: boolean;
+  onCtrlA?(focused: DialogItem | undefined): boolean;
+  onCtrlD?(focused: DialogItem | undefined): boolean;
+  onCtrlE?(focused: DialogItem | undefined): boolean;
+  onActivity?(): void;
+  ref?: Ref<DialogHandle>;
+}
+type DialogHandle = WindowHandle;
+declare const CloseGuardContext: import("react").Context<boolean>;
+declare function Dialog({ width, maxHeight, title, rows, footer, errors, onClose, search, searchRight, centerScroll, onCtrlA, onCtrlD, onCtrlE, onActivity, ref }: DialogProps): import("react").JSX.Element;
+//#endregion
+//#region src/ui/widgets/registry.d.ts
+declare function registerWidget<I extends {
+  type: string;
+}>(type: I['type'], def: WidgetDef<I>, options?: {
+  order?: number;
+}): () => void;
+//#endregion
+//#region src/ui/panels/surface.d.ts
+interface PanelPointerHandle {
+  clickAt(y: number, x: number): void;
+  wheel(dir: -1 | 1): boolean;
+}
+interface PanelRow {
+  segments: Segment[];
+  /** Replaces the text row with an interactive node (e.g. a button row). */
+  content?: ReactNode;
+}
+interface PanelHint {
+  /** Key token, rendered with the key color (e.g. "enter", an arrow glyph). */
+  key: string;
+  /** Action word, rendered with the description color. */
+  description: string;
+}
+interface PanelLegendOptions {
+  /** Leading counter text (e.g. "1/2"), rendered with the description color. */
+  prefix?: string;
+  keyColor?: string;
+  descriptionColor?: string;
+}
+/**
+ * Build a key-hint row: keys in the panel key color, action words in the
+ * muted description color ("enter select  esc close").
+ */
+declare function panelLegend(hints: readonly PanelHint[], options?: PanelLegendOptions): Segment[];
+/**
+ * Shared panel chrome: a floating block anchored above the status line with
+ * half-block caps, the panel background, and per-row text or interactive
+ * content. Builtin panels and plugin panels built through dshtui/dialog
+ * share this shell so every interaction panel looks the same.
+ *
+ * Selection pieces span the row text only, never the pill padding, so
+ * dragging over blank panel area selects nothing (same rule as messages).
+ */
+declare function PanelSurface({ columns, rows, body, bodyStart, background, blockWidth }: {
+  columns: number;
+  rows: number;
+  body: PanelRow[];
+  bodyStart: number;
+  background: string;
+  blockWidth: number;
+}): import("react").JSX.Element;
+//#endregion
+//#region src/ui/layout-service.d.ts
+/** Anchor row where a panel of `bodyRows` lines must start to sit above the status line. */
+declare function panelAnchorRow(rows: number, bodyRows: number): number;
+//#endregion
+export { CloseGuardContext, Dialog, type DialogFocus, type DialogFooterLine, type DialogHandle, type DialogItem, type DialogProps, type DialogRow, type PanelHint, type PanelLegendOptions, type PanelPointerHandle, type PanelRow, PanelSurface, type TextItem, asTextItem, panelAnchorRow, panelLegend, registerWidget, rowHeight, wrapStatusLines };

package/lib/dialog.mjs

@@ -0,0 +1,3 @@
+import "./prod-react-Dzof4qJx.mjs";
+import { I as panelAnchorRow, c as asTextItem, i as Dialog, l as registerWidget, n as panelLegend, o as rowHeight, r as CloseGuardContext, s as wrapStatusLines, t as PanelSurface } from "./surface-DdxzIgIY.mjs";
+export { CloseGuardContext, Dialog, PanelSurface, asTextItem, panelAnchorRow, panelLegend, registerWidget, rowHeight, wrapStatusLines };