@nicomatt69/streamdown-tty 2.1.0

package/dist/core/protocol.d.ts

@@ -0,0 +1,319 @@
+/**
+ * Standard Stream Protocol for CLI Agents
+ *
+ * A universal protocol for streaming markdown content from AI models
+ * to terminal interfaces. Compatible with:
+ * - Anthropic Claude API
+ * - OpenAI API
+ * - Vercel AI SDK
+ * - Custom AI implementations
+ *
+ * Features:
+ * - Unified event system
+ * - Tool call handling
+ * - Thinking/reasoning blocks
+ * - Progress tracking
+ * - Error handling
+ * - Backpressure support
+ *
+ * @module protocol
+ */
+/**
+ * Stream event types
+ */
+export type StreamEventType = 'start' | 'text' | 'tool_start' | 'tool_input' | 'tool_end' | 'thinking_start' | 'thinking' | 'thinking_end' | 'code_start' | 'code' | 'code_end' | 'error' | 'complete' | 'abort' | 'progress' | 'metadata';
+/**
+ * Base stream event
+ */
+export interface StreamEvent {
+    type: StreamEventType;
+    timestamp: number;
+    id?: string;
+}
+/**
+ * Start event - marks beginning of stream
+ */
+export interface StartEvent extends StreamEvent {
+    type: 'start';
+    model?: string;
+    conversationId?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Text delta event - streaming text content
+ */
+export interface TextEvent extends StreamEvent {
+    type: 'text';
+    content: string;
+    /** Whether this is markdown content */
+    markdown?: boolean;
+}
+/**
+ * Tool call start event
+ */
+export interface ToolStartEvent extends StreamEvent {
+    type: 'tool_start';
+    toolId: string;
+    toolName: string;
+}
+/**
+ * Tool call input streaming event
+ */
+export interface ToolInputEvent extends StreamEvent {
+    type: 'tool_input';
+    toolId: string;
+    input: string;
+    /** Accumulated input so far */
+    accumulated?: string;
+}
+/**
+ * Tool call end event
+ */
+export interface ToolEndEvent extends StreamEvent {
+    type: 'tool_end';
+    toolId: string;
+    result?: unknown;
+    error?: string;
+    durationMs?: number;
+}
+/**
+ * Thinking/reasoning start event
+ */
+export interface ThinkingStartEvent extends StreamEvent {
+    type: 'thinking_start';
+    thinkingId?: string;
+}
+/**
+ * Thinking content event
+ */
+export interface ThinkingEvent extends StreamEvent {
+    type: 'thinking';
+    content: string;
+}
+/**
+ * Thinking end event
+ */
+export interface ThinkingEndEvent extends StreamEvent {
+    type: 'thinking_end';
+    thinkingId?: string;
+    durationMs?: number;
+}
+/**
+ * Code streaming start event
+ */
+export interface CodeStartEvent extends StreamEvent {
+    type: 'code_start';
+    language?: string;
+    filename?: string;
+}
+/**
+ * Code content event
+ */
+export interface CodeEvent extends StreamEvent {
+    type: 'code';
+    content: string;
+}
+/**
+ * Code end event
+ */
+export interface CodeEndEvent extends StreamEvent {
+    type: 'code_end';
+}
+/**
+ * Error event
+ */
+export interface ErrorEvent extends StreamEvent {
+    type: 'error';
+    error: Error | string;
+    code?: string;
+    recoverable?: boolean;
+}
+/**
+ * Stream complete event
+ */
+export interface CompleteEvent extends StreamEvent {
+    type: 'complete';
+    stats?: StreamStats;
+    usage?: TokenUsage;
+}
+/**
+ * Stream abort event
+ */
+export interface AbortEvent extends StreamEvent {
+    type: 'abort';
+    reason?: string;
+}
+/**
+ * Progress event
+ */
+export interface ProgressEvent extends StreamEvent {
+    type: 'progress';
+    current: number;
+    total?: number;
+    message?: string;
+}
+/**
+ * Metadata event
+ */
+export interface MetadataEvent extends StreamEvent {
+    type: 'metadata';
+    key: string;
+    value: unknown;
+}
+/**
+ * Union type for all events
+ */
+export type AnyStreamEvent = StartEvent | TextEvent | ToolStartEvent | ToolInputEvent | ToolEndEvent | ThinkingStartEvent | ThinkingEvent | ThinkingEndEvent | CodeStartEvent | CodeEvent | CodeEndEvent | ErrorEvent | CompleteEvent | AbortEvent | ProgressEvent | MetadataEvent;
+/**
+ * Stream statistics
+ */
+export interface StreamStats {
+    startTime: number;
+    endTime: number;
+    durationMs: number;
+    bytesReceived: number;
+    chunksReceived: number;
+    tokensGenerated?: number;
+    toolCalls?: number;
+}
+/**
+ * Token usage information
+ */
+export interface TokenUsage {
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens?: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+}
+/**
+ * Event handler type
+ */
+export type StreamEventHandler<T extends AnyStreamEvent = AnyStreamEvent> = (event: T) => void | Promise<void>;
+/**
+ * Stream protocol options
+ */
+export interface StreamProtocolOptions {
+    /** Handler for all events */
+    onEvent?: StreamEventHandler;
+    /** Handler for text events only */
+    onText?: StreamEventHandler<TextEvent>;
+    /** Handler for tool events */
+    onTool?: StreamEventHandler<ToolStartEvent | ToolInputEvent | ToolEndEvent>;
+    /** Handler for thinking events */
+    onThinking?: StreamEventHandler<ThinkingStartEvent | ThinkingEvent | ThinkingEndEvent>;
+    /** Handler for errors */
+    onError?: StreamEventHandler<ErrorEvent>;
+    /** Handler for completion */
+    onComplete?: StreamEventHandler<CompleteEvent>;
+    /** Buffer size for backpressure */
+    bufferSize?: number;
+    /** Debounce interval in ms */
+    debounceMs?: number;
+}
+/**
+ * Stream Protocol Handler
+ *
+ * Central event bus for managing stream events
+ */
+export declare class StreamProtocol {
+    private options;
+    private handlers;
+    private eventBuffer;
+    private stats;
+    private isComplete;
+    private abortController;
+    constructor(options?: StreamProtocolOptions);
+    /**
+     * Register event handler
+     */
+    on<T extends StreamEventType>(type: T | 'all', handler: StreamEventHandler): () => void;
+    /**
+     * Remove event handler
+     */
+    off(type: StreamEventType | 'all', handler: StreamEventHandler): void;
+    /**
+     * Emit an event
+     */
+    emit(event: AnyStreamEvent): Promise<void>;
+    /**
+     * Start the stream
+     */
+    start(metadata?: Record<string, unknown>): Promise<void>;
+    /**
+     * Emit text content
+     */
+    text(content: string, markdown?: boolean): Promise<void>;
+    /**
+     * Start a tool call
+     */
+    toolStart(toolName: string, toolId?: string): Promise<string>;
+    /**
+     * Stream tool input
+     */
+    toolInput(toolId: string, input: string, accumulated?: string): Promise<void>;
+    /**
+     * End a tool call
+     */
+    toolEnd(toolId: string, result?: unknown, error?: string): Promise<void>;
+    /**
+     * Start thinking/reasoning
+     */
+    thinkingStart(thinkingId?: string): Promise<string>;
+    /**
+     * Stream thinking content
+     */
+    thinking(content: string): Promise<void>;
+    /**
+     * End thinking
+     */
+    thinkingEnd(thinkingId?: string): Promise<void>;
+    /**
+     * Emit error
+     */
+    error(error: Error | string, code?: string, recoverable?: boolean): Promise<void>;
+    /**
+     * Complete the stream
+     */
+    complete(usage?: TokenUsage): Promise<void>;
+    /**
+     * Abort the stream
+     */
+    abort(reason?: string): Promise<void>;
+    /**
+     * Get abort signal
+     */
+    get signal(): AbortSignal | undefined;
+    /**
+     * Get current stats
+     */
+    getStats(): StreamStats;
+    /**
+     * Get event buffer
+     */
+    getBuffer(): AnyStreamEvent[];
+    /**
+     * Check if stream is complete
+     */
+    get completed(): boolean;
+    /**
+     * Clear handlers and reset state
+     */
+    reset(): void;
+}
+/**
+ * Create stream protocol with async iterator support
+ */
+export declare function createStreamProtocol(options?: StreamProtocolOptions): StreamProtocol;
+/**
+ * Convert async iterable to stream protocol events
+ */
+export declare function streamToProtocol(stream: AsyncIterable<string>, protocol: StreamProtocol): AsyncGenerator<string>;
+/**
+ * Create event emitter from stream
+ */
+export declare function createEventEmitter(stream: AsyncIterable<AnyStreamEvent>): {
+    subscribe: (handler: StreamEventHandler) => () => void;
+    start: () => Promise<void>;
+};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/core/protocol.d.ts.map

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

package/dist/core/remend-tty.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Remend-TTY - Self-healing Markdown for Terminal Streaming
+ *
+ * A zero-dependency implementation inspired by Vercel's remend package,
+ * optimized for TTY/ANSI terminal output.
+ *
+ * Features:
+ * - Auto-closes incomplete markdown syntax during streaming
+ * - Context-aware (respects code blocks, math blocks, nested formatting)
+ * - Performance-first (no regex allocations, string pooling)
+ * - Zero dependencies
+ *
+ * @module remend-tty
+ * @author Streamdown-TTY
+ * @license MIT
+ */
+export interface RemendOptions {
+    /** Enable code block context awareness */
+    respectCodeBlocks?: boolean;
+    /** Enable math block context awareness */
+    respectMathBlocks?: boolean;
+    /** Enable thinking block context awareness */
+    respectThinkingBlocks?: boolean;
+    /** Custom incomplete link placeholder */
+    incompleteLinkPlaceholder?: string;
+    /** Custom incomplete image placeholder */
+    incompleteImagePlaceholder?: string;
+    /** Maximum input length (DoS protection) */
+    maxLength?: number;
+}
+export interface RemendResult {
+    /** The healed markdown string */
+    output: string;
+    /** Whether any healing was applied */
+    wasHealed: boolean;
+    /** List of applied fixes */
+    fixes: RemendFix[];
+    /** Processing time in ms */
+    processingTimeMs: number;
+}
+export interface RemendFix {
+    type: RemendFixType;
+    position: number;
+    original: string;
+    fixed: string;
+}
+export type RemendFixType = 'bold' | 'italic' | 'bold-italic' | 'code-inline' | 'code-block' | 'link' | 'image' | 'strikethrough' | 'math-inline' | 'math-block' | 'heading' | 'blockquote' | 'thinking';
+/**
+ * Main healing function - auto-closes incomplete markdown syntax
+ */
+export declare function remendTTY(input: string, options?: RemendOptions): string;
+/**
+ * Detailed healing function with diagnostics
+ */
+export declare function remendTTYDetailed(input: string, options?: RemendOptions): RemendResult;
+/**
+ * Clear the healing cache
+ */
+export declare function clearRemendCache(): void;
+/**
+ * Get cache statistics
+ */
+export declare function getRemendCacheStats(): {
+    size: number;
+    maxSize: number;
+};
+export default remendTTY;
+//# sourceMappingURL=remend-tty.d.ts.map

package/dist/core/remend-tty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remend-tty.d.ts","sourceRoot":"","sources":["../../src/core/remend-tty.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,8CAA8C;IAC9C,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,yCAAyC;IACzC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,0CAA0C;IAC1C,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,4BAA4B;IAC5B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,4BAA4B;IAC5B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,QAAQ,GACR,aAAa,GACb,aAAa,GACb,YAAY,GACZ,MAAM,GACN,OAAO,GACP,eAAe,GACf,aAAa,GACb,YAAY,GACZ,SAAS,GACT,YAAY,GACZ,UAAU,CAAC;AAyBf;;GAEG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,YAAY,CAoId;AAyaD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAKvE;AAGD,eAAe,SAAS,CAAC"}

package/dist/core/renderer.d.ts

@@ -0,0 +1,286 @@
+/**
+ * Zero-Dependency ANSI Renderer for TTY
+ *
+ * A universal terminal renderer that outputs pure ANSI escape sequences.
+ * Compatible with all terminal emulators and TTY devices.
+ *
+ * Features:
+ * - Zero dependencies
+ * - Pure ANSI escape codes
+ * - Cross-platform (Node, Bun, Deno, Browser terminals)
+ * - Object pooling for performance
+ * - Customizable themes
+ * - Memoized rendering
+ *
+ * @module renderer
+ */
+import type { Token } from './parser.js';
+/**
+ * ANSI escape codes
+ */
+export declare const ANSI: {
+    readonly reset: "\u001B[0m";
+    readonly bold: "\u001B[1m";
+    readonly dim: "\u001B[2m";
+    readonly italic: "\u001B[3m";
+    readonly underline: "\u001B[4m";
+    readonly blink: "\u001B[5m";
+    readonly inverse: "\u001B[7m";
+    readonly hidden: "\u001B[8m";
+    readonly strikethrough: "\u001B[9m";
+    readonly black: "\u001B[30m";
+    readonly red: "\u001B[31m";
+    readonly green: "\u001B[32m";
+    readonly yellow: "\u001B[33m";
+    readonly blue: "\u001B[34m";
+    readonly magenta: "\u001B[35m";
+    readonly cyan: "\u001B[36m";
+    readonly white: "\u001B[37m";
+    readonly default: "\u001B[39m";
+    readonly brightBlack: "\u001B[90m";
+    readonly brightRed: "\u001B[91m";
+    readonly brightGreen: "\u001B[92m";
+    readonly brightYellow: "\u001B[93m";
+    readonly brightBlue: "\u001B[94m";
+    readonly brightMagenta: "\u001B[95m";
+    readonly brightCyan: "\u001B[96m";
+    readonly brightWhite: "\u001B[97m";
+    readonly bgBlack: "\u001B[40m";
+    readonly bgRed: "\u001B[41m";
+    readonly bgGreen: "\u001B[42m";
+    readonly bgYellow: "\u001B[43m";
+    readonly bgBlue: "\u001B[44m";
+    readonly bgMagenta: "\u001B[45m";
+    readonly bgCyan: "\u001B[46m";
+    readonly bgWhite: "\u001B[47m";
+    readonly bgDefault: "\u001B[49m";
+    readonly bgBrightBlack: "\u001B[100m";
+    readonly bgBrightRed: "\u001B[101m";
+    readonly bgBrightGreen: "\u001B[102m";
+    readonly bgBrightYellow: "\u001B[103m";
+    readonly bgBrightBlue: "\u001B[104m";
+    readonly bgBrightMagenta: "\u001B[105m";
+    readonly bgBrightCyan: "\u001B[106m";
+    readonly bgBrightWhite: "\u001B[107m";
+    readonly cursorUp: (n?: number) => string;
+    readonly cursorDown: (n?: number) => string;
+    readonly cursorForward: (n?: number) => string;
+    readonly cursorBack: (n?: number) => string;
+    readonly cursorPosition: (row: number, col: number) => string;
+    readonly cursorHome: "\u001B[H";
+    readonly cursorSave: "\u001B[s";
+    readonly cursorRestore: "\u001B[u";
+    readonly cursorHide: "\u001B[?25l";
+    readonly cursorShow: "\u001B[?25h";
+    readonly eraseScreen: "\u001B[2J";
+    readonly eraseScreenEnd: "\u001B[0J";
+    readonly eraseScreenStart: "\u001B[1J";
+    readonly eraseLine: "\u001B[2K";
+    readonly eraseLineEnd: "\u001B[0K";
+    readonly eraseLineStart: "\u001B[1K";
+    readonly fg256: (code: number) => string;
+    readonly bg256: (code: number) => string;
+    readonly fgRgb: (r: number, g: number, b: number) => string;
+    readonly bgRgb: (r: number, g: number, b: number) => string;
+};
+/**
+ * Style definition
+ */
+export interface ANSIStyle {
+    fg?: keyof typeof FG_COLORS | string;
+    bg?: keyof typeof BG_COLORS | string;
+    bold?: boolean;
+    dim?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    strikethrough?: boolean;
+    inverse?: boolean;
+}
+declare const FG_COLORS: Record<string, string>;
+declare const BG_COLORS: Record<string, string>;
+/**
+ * Theme definition
+ */
+export interface Theme {
+    name: string;
+    heading1: ANSIStyle;
+    heading2: ANSIStyle;
+    heading3: ANSIStyle;
+    heading4: ANSIStyle;
+    heading5: ANSIStyle;
+    heading6: ANSIStyle;
+    paragraph: ANSIStyle;
+    strong: ANSIStyle;
+    em: ANSIStyle;
+    code: ANSIStyle;
+    codeBlock: ANSIStyle;
+    codeBlockBorder: ANSIStyle;
+    codeBlockLang: ANSIStyle;
+    blockquote: ANSIStyle;
+    blockquoteBorder: ANSIStyle;
+    link: ANSIStyle;
+    image: ANSIStyle;
+    list: ANSIStyle;
+    listBullet: ANSIStyle;
+    task: ANSIStyle;
+    taskChecked: ANSIStyle;
+    taskUnchecked: ANSIStyle;
+    table: ANSIStyle;
+    tableHeader: ANSIStyle;
+    tableBorder: ANSIStyle;
+    hr: ANSIStyle;
+    del: ANSIStyle;
+    mathInline: ANSIStyle;
+    mathBlock: ANSIStyle;
+    thinking: ANSIStyle;
+    thinkingBorder: ANSIStyle;
+    mermaid: ANSIStyle;
+    incomplete: ANSIStyle;
+}
+/**
+ * Default dark theme
+ */
+export declare const darkTheme: Theme;
+/**
+ * Light theme
+ */
+export declare const lightTheme: Theme;
+/**
+ * Renderer options
+ */
+export interface RendererOptions {
+    /** Theme to use */
+    theme?: Theme | 'dark' | 'light';
+    /** Maximum width for wrapping */
+    maxWidth?: number;
+    /** Show line numbers in code blocks */
+    lineNumbers?: boolean;
+    /** Custom code highlighter */
+    highlighter?: (code: string, lang: string) => string;
+    /** Custom math renderer */
+    mathRenderer?: (math: string, block: boolean) => string;
+    /** Custom mermaid renderer */
+    mermaidRenderer?: (code: string) => string | Promise<string>;
+    /** Word wrap long lines */
+    wordWrap?: boolean;
+    /** Indent size for nested elements */
+    indentSize?: number;
+}
+/**
+ * Apply style to text
+ */
+export declare function applyStyle(text: string, style: ANSIStyle): string;
+/**
+ * Strip ANSI codes from text
+ */
+export declare function stripAnsi(text: string): string;
+/**
+ * Get visible length (excluding ANSI codes)
+ */
+export declare function visibleLength(text: string): number;
+/**
+ * Word wrap text
+ */
+export declare function wordWrap(text: string, maxWidth: number): string[];
+/**
+ * Zero-dependency ANSI renderer
+ */
+export declare class ANSIRenderer {
+    private options;
+    private theme;
+    constructor(options?: RendererOptions);
+    /**
+     * Render tokens to ANSI string
+     */
+    render(tokens: Token[]): string;
+    /**
+     * Render tokens to output stream
+     */
+    renderToStream(tokens: Token[], stream: NodeJS.WritableStream): void;
+    /**
+     * Render a single token
+     */
+    private renderToken;
+    /**
+     * Render heading
+     */
+    private renderHeading;
+    /**
+     * Render paragraph
+     */
+    private renderParagraph;
+    /**
+     * Render text
+     */
+    private renderText;
+    /**
+     * Render code block
+     */
+    private renderCodeBlock;
+    /**
+     * Render blockquote
+     */
+    private renderBlockquote;
+    /**
+     * Render list
+     */
+    private renderList;
+    /**
+     * Render list item
+     */
+    private renderListItem;
+    /**
+     * Render task list item
+     */
+    private renderTask;
+    /**
+     * Render link
+     */
+    private renderLink;
+    /**
+     * Render image
+     */
+    private renderImage;
+    /**
+     * Render table
+     */
+    private renderTable;
+    /**
+     * Pad cell content for alignment
+     */
+    private padCell;
+    /**
+     * Render horizontal rule
+     */
+    private renderHorizontalRule;
+    /**
+     * Render math block
+     */
+    private renderMathBlock;
+    /**
+     * Render mermaid diagram
+     */
+    private renderMermaid;
+    /**
+     * Render thinking block
+     */
+    private renderThinking;
+    /**
+     * Default code highlighter (basic keyword highlighting)
+     */
+    private defaultHighlighter;
+    /**
+     * Default math renderer (passthrough)
+     */
+    private defaultMathRenderer;
+    /**
+     * Default mermaid renderer (ASCII representation)
+     */
+    private defaultMermaidRenderer;
+    /**
+     * Clear render cache
+     */
+    static clearCache(): void;
+}
+export default ANSIRenderer;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/core/renderer.d.ts.map

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