deepseek-harness/packages/ui/tui/src/components/content.ts

/**
 * Content-block primitives shared across the terminal front door: flattening
 * session content to display text and parsing tool-call arguments.
 * @module @deepseek-ai/dsh-tui/components/content
 */

import type { ContentBlock } from '@deepseek-ai/dsh-llm'

/**
 * Flatten content blocks into a single display string, recursing into
 * tool-result content and naming unknown block types.
 * @param content - Content blocks to flatten.
 * @returns The concatenated display text.
 */
export function contentText(content: readonly ContentBlock[]): string {
  const parts: string[] = []
  for (const block of content) {
    switch (block.type) {
      case 'text':
      case 'reasoning':
        parts.push(block.text)
        break
      case 'tool-call':
        parts.push(`${block.name}(${block.arguments})`)
        break
      case 'tool-result':
        parts.push(contentText(block.content))
        break
      default: {
        const rawType = (block as { type?: unknown }).type
        parts.push(`[${typeof rawType === 'string' ? rawType : 'content'}]`)
        break
      }
    }
  }
  return parts.join('')
}

/** A tool call's arguments parsed from their JSON source, with a validity flag. */
export interface ParsedArguments {
  value: unknown
  valid: boolean
}

/**
 * Parse tool-call arguments from their JSON source.
 * @param raw - Raw JSON arguments text.
 * @returns The parsed value, or the raw text with `valid: false` on parse failure.
 */
export function parseArguments(raw: string): ParsedArguments {
  try {
    return { value: JSON.parse(raw), valid: true }
  } catch {
    return { value: raw, valid: false }
  }
}