dsh-code 0.9.1 → 1.0.0

package/src/attachments.ts

@@ -0,0 +1,44 @@
+/** Terminal image-file adapter over the Harness durable attachment service. */
+
+import { readFile } from 'node:fs/promises'
+import { basename } from 'node:path'
+import type { AttachmentStore, ImageMediaType, SaveImageAttachment } from '@deepseek-ai/dsh-attachment'
+import type { ImageBlock } from '@deepseek-ai/dsh-llm'
+
+/** Detect the supported encoded raster formats from bytes, never from a path suffix. */
+export function detectImageMediaType(data: Uint8Array): ImageMediaType | undefined {
+  if (data.length >= 8 && data[0] === 0x89 && data[1] === 0x50 && data[2] === 0x4e && data[3] === 0x47
+    && data[4] === 0x0d && data[5] === 0x0a && data[6] === 0x1a && data[7] === 0x0a) return 'image/png'
+  if (data.length >= 3 && data[0] === 0xff && data[1] === 0xd8 && data[2] === 0xff) return 'image/jpeg'
+  if (data.length >= 6) {
+    const signature = String.fromCharCode(...data.subarray(0, 6))
+    if (signature === 'GIF87a' || signature === 'GIF89a') return 'image/gif'
+  }
+  if (data.length >= 12
+    && String.fromCharCode(...data.subarray(0, 4)) === 'RIFF'
+    && String.fromCharCode(...data.subarray(8, 12)) === 'WEBP') return 'image/webp'
+  return undefined
+}
+
+/** Read, validate, and persist an ordered image path list as model content blocks. */
+export async function saveImagePaths(
+  paths: readonly string[],
+  attachments: AttachmentStore | undefined,
+): Promise<readonly ImageBlock[]> {
+  if (paths.length === 0) return []
+  if (attachments === undefined) throw new Error('image attachments are unavailable in this profile')
+  const inputs: SaveImageAttachment[] = []
+  for (const path of paths) {
+    let data: Uint8Array
+    try {
+      data = await readFile(path)
+    } catch (error: unknown) {
+      throw new Error(`cannot read image "${path}": ${error instanceof Error ? error.message : String(error)}`)
+    }
+    const mediaType = detectImageMediaType(data)
+    if (mediaType === undefined) throw new Error(`unsupported image file "${path}" (expected PNG, JPEG, WebP, or GIF)`)
+    inputs.push({ data, mediaType, name: basename(path) })
+  }
+  const refs = await attachments.saveImages(inputs)
+  return refs.map(attachment => ({ type: 'image', attachment }))
+}

package/src/editor.ts

@@ -0,0 +1,51 @@
+/** Host editor and clipboard adapters used by the terminal surface. */
+
+import { spawn } from 'node:child_process'
+import type { TranscriptView } from './render/projection.ts'
+
+function waitForProcess(command: string, args: readonly string[], input?: string): Promise<void> {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, [...args], {
+      stdio: input === undefined ? 'inherit' : ['pipe', 'ignore', 'pipe'],
+      windowsHide: true,
+    })
+    let stderr = ''
+    child.stderr?.on('data', chunk => { stderr += String(chunk) })
+    child.once('error', reject)
+    child.once('exit', code => {
+      if (code === 0) resolve()
+      else reject(new Error(`${command} exited with code ${String(code)}${stderr.trim() === '' ? '' : `: ${stderr.trim()}`}`))
+    })
+    if (input !== undefined) child.stdin?.end(input)
+  })
+}
+
+/** Copy UTF-8 text through the platform clipboard command. */
+export async function copyText(text: string): Promise<void> {
+  if (process.platform === 'win32') {
+    // Windows PowerShell 5 reads redirected stdin using the active console
+    // code page by default. Node writes UTF-8, so CJK copied through `$input`
+    // became mojibake. Set the pipe encoding before reading it.
+    await waitForProcess('powershell.exe', [
+      '-NoProfile',
+      '-NonInteractive',
+      '-Command',
+      '[Console]::InputEncoding = [System.Text.UTF8Encoding]::new($false); Set-Clipboard -Value ([Console]::In.ReadToEnd())',
+    ], text)
+    return
+  }
+  if (process.platform === 'darwin') {
+    await waitForProcess('pbcopy', [], text)
+    return
+  }
+  await waitForProcess('xclip', ['-selection', 'clipboard'], text)
+}
+
+/** Latest complete assistant text, excluding streaming and reasoning. */
+export function latestAssistantText(view: TranscriptView): string | undefined {
+  for (let index = view.entries.length - 1; index >= 0; index -= 1) {
+    const entry = view.entries[index]
+    if (entry?.kind === 'assistant' && entry.text !== '') return entry.text
+  }
+  return undefined
+}

package/src/fork.ts

@@ -0,0 +1,31 @@
+/** Pure session-fork boundary policy shared by the TUI command and tests. */
+
+import type { SessionEvent } from '@deepseek-ai/dsh-session'
+
+export interface ForkSeed {
+  readonly boundarySeq: number
+  readonly events: readonly SessionEvent[]
+}
+
+/** Select a completed turn and trailing between-turn metadata. */
+export function selectForkSeed(events: readonly SessionEvent[], atSeq?: number): ForkSeed {
+  if (atSeq !== undefined && (!Number.isSafeInteger(atSeq) || atSeq < 0)) {
+    throw new Error('fork event sequence must be a non-negative integer')
+  }
+  const lastSeq = events.at(-1)?.seq ?? -1
+  const anchored = atSeq === undefined
+    ? undefined
+    : events.find(event => event.type === 'turn/end' && event.seq >= atSeq)
+  const boundary = anchored
+    ?? (atSeq === undefined || atSeq > lastSeq
+      ? events.findLast(event => event.type === 'turn/end')
+      : undefined)
+  if (boundary === undefined) {
+    throw new Error(atSeq !== undefined && atSeq <= lastSeq
+      ? `the turn containing event ${atSeq} has not completed`
+      : 'this session has no completed turn to fork from')
+  }
+  let cut = events.indexOf(boundary) + 1
+  while (cut < events.length && events[cut]?.type !== 'turn/start') cut += 1
+  return { boundarySeq: boundary.seq, events: events.slice(0, cut) }
+}

package/src/git-workflow.ts

@@ -0,0 +1,87 @@
+/** Read-only Git inspection used by /diff and /review. */
+
+import { execFile } from 'node:child_process'
+
+export interface GitDiffSpec {
+  readonly label: string
+  readonly args: readonly string[]
+}
+
+/** One file section from a unified diff, retained in source order. */
+export interface GitDiffFile {
+  readonly path: string
+  readonly lines: readonly string[]
+}
+
+/** A parsed diff ready for a file-oriented terminal viewport. */
+export interface GitDiffView {
+  readonly title: string
+  readonly files: readonly GitDiffFile[]
+}
+
+/** Split Git's stable `diff --git` framing without interpreting patch content. */
+export function parseGitDiffFiles(text: string): readonly GitDiffFile[] {
+  if (text === '') return []
+  const chunks = text.split(/(?=^diff --git )/mu).filter(chunk => chunk !== '')
+  return chunks.map((chunk, index) => {
+    const lines = chunk.replace(/\n$/u, '').split('\n')
+    const plus = lines.find(line => line.startsWith('+++ b/'))
+    const minus = lines.find(line => line.startsWith('--- a/'))
+    const header = /^diff --git a\/(.+) b\/(.+)$/u.exec(lines[0] ?? '')
+    const path = plus?.slice(6) || minus?.slice(6) || header?.[2] || header?.[1] || `file ${index + 1}`
+    return { path, lines }
+  })
+}
+
+/** Parse the intentionally small, option-safe /diff argument vocabulary. */
+export function parseGitDiffSpec(argument: string): GitDiffSpec {
+  const value = argument.trim()
+  if (value === '') return { label: 'working tree vs HEAD', args: ['diff', '--no-ext-diff', '--unified=3', 'HEAD', '--'] }
+  if (value === '--staged' || value === '--cached') {
+    return { label: 'staged changes', args: ['diff', '--no-ext-diff', '--unified=3', '--cached', '--'] }
+  }
+  if (value.startsWith('-') || /\s/u.test(value)) throw new Error('usage: /diff [--staged|git-ref]')
+  return { label: `changes since ${value}`, args: ['diff', '--no-ext-diff', '--unified=3', value, '--'] }
+}
+
+function executeGit(cwd: string, args: readonly string[]): Promise<string> {
+  return new Promise((resolve, reject) => {
+    execFile('git', [...args], { cwd, encoding: 'utf8', maxBuffer: 16 * 1024 * 1024, windowsHide: true }, (error, stdout, stderr) => {
+      if (error !== null) {
+        reject(new Error(stderr.trim() || error.message))
+        return
+      }
+      resolve(stdout.replace(/\r\n/gu, '\n'))
+    })
+  })
+}
+
+/** Load one complete textual diff without invoking external diff drivers. */
+export async function loadGitDiff(cwd: string, argument: string): Promise<GitDiffView> {
+  const spec = parseGitDiffSpec(argument)
+  try {
+    const text = await executeGit(cwd, spec.args)
+    return { title: `git diff - ${spec.label}`, files: parseGitDiffFiles(text) }
+  } catch (error: unknown) {
+    // An unborn repository has no HEAD. Preserve useful unstaged output for
+    // the default form while still surfacing all other Git failures.
+    if (argument.trim() !== '') throw error
+    const text = await executeGit(cwd, ['diff', '--no-ext-diff', '--unified=3', '--'])
+    return { title: 'git diff - working tree', files: parseGitDiffFiles(text) }
+  }
+}
+
+/** Review prompt capped before it reaches a provider context window. */
+export function buildReviewPrompt(diff: string, label: string, maxChars = 200_000): string {
+  const truncated = diff.length > maxChars
+  const body = truncated ? diff.slice(0, maxChars) : diff
+  return [
+    'Review the following Git changes. Do not modify files or run write operations.',
+    'Lead with concrete bugs, regressions, security risks, and missing tests, ordered by severity.',
+    `Scope: ${label}${truncated ? ' (diff truncated by CLI)' : ''}`,
+    '',
+    '```diff',
+    body,
+    '```',
+  ].join('\n')
+}