codsh-cli 0.2.0 → 0.4.0

package/lib/types/theme.d.ts

@@ -1,75 +0,0 @@
-/**
- * Terminal styling and display metrics: SGR sequences that degrade to plain
- * text off a TTY, and the display-column width a rendered string occupies.
- * @module codsh-cli/src/theme
- */
-/** Style roles the renderer asks for, resolved to SGR codes by {@link createTheme}. */
-export interface Theme {
-    /** Whether this theme emits SGR sequences at all. */
-    readonly colored: boolean;
-    dim(text: string): string;
-    bold(text: string): string;
-    /** Failures, denied approvals, and removed diff lines. */
-    error(text: string): string;
-    /** Completed work and added diff lines. */
-    success(text: string): string;
-    /** Pending state and approval prompts. */
-    pending(text: string): string;
-    /** Tool names and card titles. */
-    tool(text: string): string;
-    /** File paths and locations. */
-    path(text: string): string;
-    /** The user's own echoed input. */
-    user(text: string): string;
-    /** Roles used inside a fenced code block. */
-    readonly syntax: SyntaxTheme;
-}
-/** Styling for the token classes a code block is coloured by. */
-export interface SyntaxTheme {
-    keyword(text: string): string;
-    string(text: string): string;
-    number(text: string): string;
-    comment(text: string): string;
-}
-/**
- * Build the theme for one surface.
- *
- * Color is suppressed off a TTY and whenever `NO_COLOR` is set to any value,
- * following the `no-color.org` convention: a redirected transcript stays
- * greppable, and a pipe never receives sequences a reader would have to strip.
- *
- * Secondary text uses a palette gray on a 256-color terminal rather than the
- * `dim` attribute: several terminals render `dim` at full brightness, and a
- * hierarchy nobody can see is no hierarchy — the placeholder, the menu details,
- * and the status row must sit visibly behind what the person typed.
- * @param isTty - whether the output stream is a terminal.
- * @param env - the environment to read `NO_COLOR` and the color depth from.
- * @returns the styling functions for this surface.
- */
-export declare function createTheme(isTty: boolean, env: Record<string, string | undefined>): Theme;
-/**
- * Display columns a string occupies once printed, ignoring styling sequences.
- *
- * Measured by `string-width` — the width authority cli-table3, ink, and every
- * maintained terminal renderer sit on — so East Asian Wide, emoji presentation
- * (`⚡` included), combining marks, and ZWJ sequences all match what a
- * terminal's cursor actually does. A hand-kept range table here mis-sized `⚡`
- * and sheared a real table's columns; widths are exactly the kind of data
- * nobody should maintain by hand.
- * @param text - the string to measure, possibly carrying SGR sequences.
- * @returns the number of display columns.
- */
-export declare function displayWidth(text: string): number;
-/**
- * Shorten a string to at most `columns` display columns, marking the cut with
- * an ellipsis when anything was dropped.
- *
- * Styling survives: sequences cost no columns and travel with the text they
- * style, and a cut that kept any styling closes it with a reset before the
- * ellipsis so nothing leaks onto the next row. A string that already fits is
- * returned exactly as it came — a fit is not a licence to restyle it.
- * @param text - the string to shorten, possibly carrying SGR sequences.
- * @param columns - the display-column budget; a budget under 2 yields the empty string.
- * @returns the string, unchanged when it already fits.
- */
-export declare function truncate(text: string, columns: number): string;

package/lib/types/transcript.d.ts

@@ -1,129 +0,0 @@
-/**
- * Session log to terminal lines. One appended {@link SessionEvent} renders to
- * zero or more finished lines; the surface never rewrites a line it has
- * printed, so the transcript scrolls like a shell history.
- *
- * Tool cards come from the registered presenters rather than from tool names:
- * a tool declares its own render intent, and this module switches on the
- * resulting `card` tag.
- * @module codsh-cli/src/transcript
- */
-import type { SessionEvent } from '@deepseek-ai/dsh-session';
-import type { ToolCallView, ToolResult, ToolResultView } from '@deepseek-ai/dsh-tools';
-import type { Theme } from './theme.ts';
-/** The registered presenters, resolved against the agent's scope by the caller. */
-export interface ToolPresenters {
-    /**
-     * Render intent for a pending call.
-     * @param name - the tool the model called.
-     * @param args - the parsed call arguments.
-     * @returns the declared view, or undefined for the generic fallback.
-     */
-    call(name: string, args: unknown): ToolCallView | undefined;
-    /**
-     * Render intent for a completed call.
-     * @param name - the tool the model called.
-     * @param args - the parsed call arguments.
-     * @param result - the completed outcome.
-     * @returns the declared view, or undefined for the generic fallback.
-     */
-    result(name: string, args: unknown, result: ToolResult): ToolResultView | undefined;
-}
-/** What the renderer needs to know about the surface it writes to. */
-export interface TranscriptOptions {
-    theme: Theme;
-    /** Display columns available for one line. */
-    columns: number;
-    /** Session workspace, stripped from absolute paths so cards stay short. */
-    cwd: string;
-}
-/** Renders one session's appended events as terminal lines. */
-export declare class Transcript {
-    private readonly options;
-    private readonly presenters;
-    private readonly calls;
-    /** The full form of the event just rendered, when its body was collapsed. */
-    private fold;
-    constructor(options: TranscriptOptions, presenters: ToolPresenters);
-    /**
-     * Shorten an absolute path inside the workspace to a workspace-relative one.
-     * @param path - the model-facing path a card carries.
-     * @returns the display path.
-     */
-    private relative;
-    /**
-     * Shorten every workspace path a presenter embedded in free text.
-     *
-     * A title is prose the tool composed (`Write /abs/path`), so the path inside
-     * it needs the same shortening as a structured `locations` entry.
-     * @param text - the presenter-supplied line.
-     * @returns the line with workspace-rooted paths made relative.
-     */
-    private relativizeIn;
-    /**
-     * Paths worth appending to a title that may already name them.
-     * @param title - the presenter's title, already relativized.
-     * @param paths - the relativized paths the card covers.
-     * @returns the paths the title does not mention, joined for display.
-     */
-    private extraPaths;
-    /**
-     * Render one appended event.
-     * @param event - the event exactly as recorded.
-     * @returns the lines to append to the transcript, empty when the event shows nothing.
-     */
-    render(event: SessionEvent): string[];
-    /**
-     * Render a pending call as its declared card.
-     * @param callId - correlation id, remembered until the result pairs with it.
-     * @param name - the tool the model called.
-     * @param rawArguments - the unparsed arguments JSON the model produced.
-     * @returns the pending card's lines.
-     */
-    private renderCall;
-    /**
-     * Render a completed call, pairing it with the call this transcript recorded.
-     * @param data - the `tool/result` payload.
-     * @returns the completed card's lines.
-     */
-    private renderResult;
-    /**
-     * The expanded form of the lines {@link render} just returned, when that
-     * event's body was collapsed — the whole event re-rendered without its cap,
-     * because a fold swaps entire blocks, not just the clipped tail. The full
-     * body is kept from the render itself: what a tool truncated before
-     * returning is upstream of the log and unrecoverable everywhere.
-     * @returns the full lines, or undefined when nothing was collapsed.
-     */
-    takeFold(): string[] | undefined;
-    /**
-     * Render one completed call's status suffix and body from its declared view.
-     * @param view - the result view, absent when no presenter answered.
-     * @param block - the model-facing result block, used by the generic fallback.
-     * @returns the suffix, the (possibly capped) body, and — when the cap dropped
-     *   lines, or a bodiless card withheld content — the full body for Ctrl-O.
-     */
-    private outcome;
-    /**
-     * Flatten a result's content blocks to displayable text.
-     * @param content - the result content blocks.
-     * @returns the joined text.
-     */
-    private resultText;
-    /**
-     * Ask a call presenter for its view, absorbing a throwing presenter.
-     * @param name - the tool the model called.
-     * @param args - the parsed call arguments.
-     * @returns the view, or undefined to fall back to the generic line.
-     */
-    private safeCall;
-    /**
-     * Ask a result presenter for its view, absorbing a throwing presenter.
-     * @param pending - the recorded call this result pairs with.
-     * @param content - the model-facing result content.
-     * @param isError - whether the executor reported a failure.
-     * @param meta - the tool's private presentation payload, when it attached one.
-     * @returns the view, or undefined to fall back to the generic card.
-     */
-    private safeResult;
-}

package/lib/types/wrap.d.ts

@@ -1,27 +0,0 @@
-/**
- * Display-width wrapping for styled text.
- *
- * Inside the alternate screen the terminal no longer wraps for us: a transcript
- * line longer than the viewport must be broken into rows before it is painted,
- * or it would overwrite the row below. The lines being broken are already
- * styled, so a naive split would cut an escape sequence in half and leak
- * gibberish — and a continuation row would lose the colour its first half set.
- * @module codsh/src/wrap
- */
-/**
- * Break one styled line into rows no wider than `columns` display columns.
- *
- * Styles carry across the break: each continuation row re-opens whatever was
- * active where the cut fell, and every row that opened a style closes it.
- * @param text - the styled line, without a terminator.
- * @param columns - display columns available per row.
- * @returns the rows, at least one (an empty line yields one empty row).
- */
-export declare function wrapStyled(text: string, columns: number): string[];
-/**
- * Wrap many lines, keeping their order.
- * @param lines - styled lines.
- * @param columns - display columns per row.
- * @returns the physical rows they occupy.
- */
-export declare function wrapAll(lines: readonly string[], columns: number): string[];