@toddzheng024/dscode-bundle 0.7.11 → 0.7.13

package/vendor/tui/types/render/status.d.ts

@@ -1,196 +0,0 @@
-/**
- * Status-bar composition for the TUI footer. Codex/Claude-Code-style split
- * line: identity facts and session figures flow from the left, while the
- * permission badge (the Codex "autonomous selection" anchor, with its
- * shift+tab cycle hint) pins to the right edge. Every segment carries a tone
- * the footer maps to a theme color, and layoutStatusBar degrades the line
- * item by item so it always fits one physical row — truncation with an
- * ellipsis happens only after every lesser group has already dropped out.
- *
- * @module @deepseek-ai/dsh-tui/render/status
- */
-import type { TranscriptStats } from './projection.ts';
-import { formatTokens } from './text.ts';
-export { formatTokens };
-/**
- * Compact duration: 45.2s under a minute, 2m42s from there on.
- * @param ms - duration in milliseconds.
- * @returns display string.
- */
-export declare function formatDuration(ms: number): string;
-/**
- * Cache-hit share of billed prompt-side input. The denominator is the same
- * billed total the /usage panel shows (uncached input plus both cache
- * buckets), so the two readouts can never disagree.
- * @param usage - cumulative token totals.
- * @returns percent rounded to one decimal place, or null when no input was billed.
- */
-export declare function cacheHitPercent(usage: TranscriptStats['usage']): number | null;
-/**
- * Presentation tones for status spans; the footer maps each to a theme color
- * (Codex status-line accents: model/path/branch/state/usage categories).
- */
-export type StatusTone = 'model' | 'live' | 'path' | 'branch' | 'value' | 'label' | 'meta' | 'accent' | 'success' | 'plan' | 'warn' | 'error' | 'ctxFill';
-/** One colored run inside the status bar. */
-export interface StatusSpan {
-    text: string;
-    tone: StatusTone;
-}
-/**
- * One pipe-separated cluster on the leading side of the bar. Spans are the
- * full visual sequence: junction separators ride along as their own dim
- * 'label'-tone spans, so joining is a flat concat with no implicit glue.
- */
-export interface StatusGroup {
-    spans: readonly StatusSpan[];
-}
-/** One physical row of the footer: leading clusters and trailing badges. */
-export interface StatusRow {
-    /** Leading clusters, pipe-separated in display order; index 0 is identity. */
-    left: readonly StatusGroup[];
-    /** Trailing spans pinned to the right edge, dot-separated in display order. */
-    right: readonly StatusSpan[];
-    /** Whether the shift+tab cycle hint rides after the permission badge. */
-    hint: boolean;
-}
-/**
- * The footer layout: two stacked physical rows. Row 1 keeps the primary
- * controls in model, cwd, mode, branch, context, permission order. Row 2
- * carries every secondary session/run figure and degrades independently.
- */
-export interface StatusLayout {
-    row1: StatusRow;
-    row2: StatusRow;
-}
-/** Separator between leading clusters. */
-export declare const STATUS_GROUP_SEPARATOR = " | ";
-/** Separator between trailing state spans. */
-export declare const STATUS_ITEM_SEPARATOR = " \u00B7 ";
-/** The Codex-style mode cycle hint appended to the permission badge. */
-/** English compatibility value for callers that only measure the default layout. */
-export declare const STATUS_CYCLE_HINT = " (shift+tab to cycle)";
-/** Localized mode-cycle hint used by the live layout. */
-export declare function statusCycleHint(): string;
-/**
- * Interior columns of the context bar. The layout starts every bar at this
- * width so the drop ladder can pre-measure the group, then degrades the
- * readout and shrinks the bar inside a tighter budget before dropping the
- * group (see CONTEXT_MIN_WIDTH) rather than asking the layout for more room.
- */
-export declare const CONTEXT_BAR_WIDTH = 24;
-/**
- * Render context occupancy as ONE stepless proportional bar: a solid
- * DeepSeek-blue fill run tracking the occupancy and a dim dotted free
- * track for the rest. Nothing else lives inside the bar — the usage
- * readout rides outside it (see contextGroupSpans) — so the geometry
- * always reads as the true remaining share. A given occupancy always
- * renders the identical bar.
- * @param usedTokens - reported used tokens.
- * @param contextWindow - route capacity.
- * @param width - total bar columns.
- * @returns tone-split spans for the footer to paint.
- */
-export declare function contextBar(usedTokens: number, contextWindow: number, width: number): readonly StatusSpan[];
-/** How much usage detail the context group's readout carries. */
-export type ContextReadoutMode = 'full' | 'percent' | 'none';
-/**
- * Compose the context group: the proportional bar plus the usage readout
- * OUTSIDE the bar, so the dotted track keeps its proportional meaning no
- * matter how wide the readout is. `full` reads `12.3K/1.0M 25%`; `percent`
- * drops the absolute pair; `none` is the bare bar. The readout turns amber
- * once occupancy reaches the warning threshold.
- */
-export declare function contextGroupSpans(usedTokens: number, contextWindow: number, barWidth: number, readout: ContextReadoutMode): readonly StatusSpan[];
-/**
- * One customizable status item (the Codex /statusline picker contract).
- * 'left' items render as pipe-separated clusters after the identity dot;
- * 'right' items pin to the right edge as dot-separated state badges.
- */
-export type StatusItemId = 'model' | 'cwd' | 'branch' | 'plan' | 'mode' | 'turns' | 'durations' | 'cache' | 'context' | 'tokens' | 'title' | 'goal' | 'sandbox' | 'permission';
-/** Picker-facing metadata for one customizable item. */
-export interface StatusItemInfo {
-    id: StatusItemId;
-    /** Short picker label. */
-    label: string;
-    /** One-line picker description of what the item shows. */
-    description: string;
-    /** Which side of the split row the item renders on. */
-    side: 'left' | 'right';
-}
-/** The full item catalog in canonical order (the /statusline default). */
-export declare const STATUS_ITEMS: readonly StatusItemInfo[];
-/**
- * Default order: the whole catalog (matches the pre-customization bar).
- * The busy dot is not an item — it always leads the identity cluster.
- */
-export declare const DEFAULT_STATUSLINE_ITEMS: readonly StatusItemId[];
-/**
- * Parse a persisted statusline item list. The stored value is the ordered
- * set of ENABLED items (the Codex /statusline contract): unknown ids and
- * duplicates drop out, and a non-array value (missing or corrupt file)
- * falls back to the full default set. An explicitly empty array is valid —
- * the bar degrades to its busy dot alone.
- * @param value - the raw parsed JSON value (expected string[]).
- * @returns the normalized ordered item list.
- */
-export declare function parseStatuslineItems(value: unknown): readonly StatusItemId[];
-/**
- * Extra left padding on the secondary row so its content aligns with the
- * model name's left edge on the primary row (padding 2 + busy dot 2). The
- * layout subtracts it from row 2's budget so the indent can never wrap it.
- */
-export declare const STATUS_ROW2_INDENT = 2;
-/** Identity facts the runner resolves once at mount; empty strings drop out. */
-export interface StatusFacts {
-    /** 'provider/model' selection serving this session. */
-    model: string;
-    /** Agent preset composing this session. */
-    mode?: string;
-    /** Working-directory basename the session serves. */
-    cwd: string;
-    /** Git branch name, empty outside a repository or on a detached HEAD file. */
-    branch: string;
-    /** Short session identifier (last dash-separated segment or tail). */
-    sessionId: string;
-    /** Latest session title (folded from 'session/title'); shown in place of the id. */
-    title: string;
-    /** Sandbox-mode override (folded from 'sandbox/mode'), empty when never switched. */
-    sandbox: string;
-    /** Live goal summary (folded from 'goal/change'), undefined when none. */
-    goal: {
-        phase: string;
-        rounds: number;
-        max: number;
-    } | undefined;
-    /** Whether plan mode is active (folded from 'plan/mode'). */
-    plan: boolean;
-    /** Active or pending permission preset; empty only when the service is unavailable. */
-    permission: string;
-}
-/**
- * Traffic-light tone for a permission preset: read-only stays success green,
- * full access reads error red, and every workspace-scoped middle ground
- * (including unknown presets) reads warning amber.
- * @param permission - active permission preset label.
- * @returns tone for the badge span.
- */
-export declare function permissionTone(permission: string): StatusTone;
-/**
- * Compose the two-row footer layout under a column budget. Row 1 keeps model,
- * cwd, mode, branch, context, then the right-pinned permission badge and cycle
- * hint. It drops hint, context, and permission before ellipsizing identity.
- * Row 2 fits all secondary figures and state within its own budget.
- * @param facts - identity facts resolved by the runner.
- * @param stats - session figures folded from the durable log.
- * @param columns - usable columns for each row (before their left padding).
- * @param options - 'busy' hides the cycle hint while a turn runs (Codex
- * keeps mode hints idle-only); 'items' is the ordered enabled-item config
- * from /statusline (defaults to the full catalog). Display order follows the
- * config per side while the drop ladder keeps its fixed ranks.
- * @returns the two rows to render; row1.left is never empty.
- */
-export declare function layoutStatusBar(facts: StatusFacts, stats: TranscriptStats, columns: number, options?: {
-    busy?: boolean;
-    items?: readonly string[];
-    contextWidth?: number;
-}): StatusLayout;

package/vendor/tui/types/render/text.d.ts

@@ -1,64 +0,0 @@
-/**
- * Display-boundary sanitization for externally sourced text (model output,
- * tool payloads, skill descriptions). Control characters — including ANSI
- * CSI/OSC escape sequences — would otherwise pass through Ink into the
- * terminal, letting output rewrite the screen or inject prompts. Newlines
- * survive; everything else in C0/C1 plus DEL becomes a visible `\xNN`
- * escape, and bidi overrides / invisible format controls / Unicode line and
- * paragraph separators become a visible `\uXXXX` escape (terminal emulators
- * that render bidirectional text would otherwise reorder the displayed
- * glyphs and let a command read as something it is not).
- *
- * @module @deepseek-ai/dsh-code/render/text
- */
-/**
- * Compact token count: exact below 1K, then one-decimal-ish K/M.
- * @param n - token count.
- * @returns display string.
- */
-export declare function formatTokens(n: number): string;
-/**
- * Escape control and deceptive characters so externally sourced text cannot
- * drive the terminal. C0/C1/DEL render as a literal `\xNN` escape; bidi,
- * invisible-format, and separator controls render as a literal `\uXXXX`
- * escape. Newlines and tabs survive (budgeted callers normalize tabs).
- * @param text - raw text from a session event, tool payload, or catalog.
- * @returns display-safe text with every injectable character made visible.
- */
-export declare function displayText(text: string): string;
-/** Collapse external text to one terminal-safe logical row. */
-export declare function singleLineText(text: string): string;
-/**
- * Truncate one display-safe row without ever exceeding its physical-column
- * budget. The ellipsis is included inside the budget, matching Codex's popup
- * truncation contract; the cut walks grapheme clusters so emoji and
- * combining sequences never split mid-cluster.
- */
-export declare function truncateColumns(text: string, columns: number): string;
-/** A display-safe suffix bounded by terminal rows and columns. */
-export interface DisplayTail {
-    /** Sanitized suffix suitable for direct terminal rendering. */
-    text: string;
-    /** Whether content before the returned suffix was omitted. */
-    truncated: boolean;
-}
-/**
- * Keep the newest display-safe text that fits a terminal rectangle, wrapping
- * FORWARD from the start of the text and slicing the tail rows.
- *
- * Forward wrapping is what keeps a streaming tail calm: rows already produced
- * never re-wrap as tokens append (a backward scan recomputes every wrap point
- * per chunk and the whole visible block jumps), and the wrap rules match the
- * settled text's renderer so the flush at turn end does not reflow the block
- * a second time. CJK kinsoku applies at both edges: closing punctuation
- * overhangs up to two cells onto the filled row instead of starting the next
- * one (within the caret column the caller reserves), and opening punctuation
- * moves down instead of dangling at a row end. Tabs expand to two spaces so
- * terminal tab stops cannot inflate the physical row count; clusters carry
- * emoji presentation and combining marks whole.
- * @param text - raw externally sourced text.
- * @param columns - available terminal columns.
- * @param rows - available terminal rows.
- * @returns a sanitized bounded suffix and whether an earlier prefix was cut.
- */
-export declare function displayTail(text: string, columns: number, rows: number): DisplayTail;

package/vendor/tui/types/render/tool-detail.d.ts

@@ -1,94 +0,0 @@
-/**
- * Expansion payloads for tool cards (the Ctrl+O verbose transcript): the
- * TUI-side consumption of the harness presentation contract. Mutation and
- * read tools persist a structured `tool/result.meta` (`diffs`, read
- * windows, web sources) exactly so a capable UI can replay richer cards than
- * the model-facing text; this module narrows that opaque JSON defensively —
- * mirroring the upstream validators — and pre-formats bounded, render-ready
- * rows. Malformed or absent metadata always degrades to the bounded raw
- * result text, never throws during replay.
- *
- * @module @deepseek-ai/dsh-code/render/tool-detail
- */
-/** One rendered diff row: removed, added, or shared context. */
-export interface DiffLine {
-    /** '-' removed, '+' added, ' ' context. */
-    mark: '-' | '+' | ' ';
-    /** The line text, truncated to the column budget. */
-    text: string;
-}
-/** One file's bounded inline diff. */
-export interface ToolDiff {
-    /** File path the change belongs to. */
-    path: string;
-    /** Rendered rows in order; '-' block before the '+' block. */
-    lines: readonly DiffLine[];
-    /** True when the line budget cut the hunk. */
-    truncated: boolean;
-}
-/** One numbered line of a read window. */
-export interface ToolReadLine {
-    /** 1-based file line number. */
-    number: number;
-    /** The line text, truncated to the column budget. */
-    text: string;
-}
-/** One web-search source row. */
-export interface ToolWebSource {
-    /** Source URL. */
-    url: string;
-    /** Source title, when the provider returned one. */
-    title: string | undefined;
-    /** Short excerpt, truncated to the column budget. */
-    snippet: string;
-}
-/** The expansion payload a verbose tool card renders; a discriminated union. */
-export type ToolDetail = {
-    kind: 'diff';
-    diffs: readonly ToolDiff[];
-} | {
-    kind: 'read';
-    path: string;
-    offset: number;
-    lines: readonly ToolReadLine[];
-    totalLines: number;
-    truncated: boolean;
-} | {
-    kind: 'web-search';
-    sources: readonly ToolWebSource[];
-    truncated: boolean;
-} | {
-    kind: 'web-fetch';
-    url: string;
-    statusCode: number;
-} | {
-    kind: 'raw';
-    text: string;
-    truncated: boolean;
-};
-/**
- * Render one change as removed-then-added rows, hunked by common prefix and
- * suffix. A null before-image (file create) renders as pure additions. The
- * budget caps emitted rows and reports the cut, so a whole-file overwrite
- * never floods the transcript. Inputs are hard-capped before line splitting
- * and the row list is built incrementally up to the budget — a crafted or
- * replayed giant diff cannot force a full intermediate rows array.
- * @param oldText - prior content, or null for a create.
- * @param newText - content after the change.
- * @param budget - maximum rows to emit.
- * @returns the bounded rows and whether they were cut.
- */
-export declare function diffRows(oldText: string | null, newText: string, budget: number): {
-    lines: readonly DiffLine[];
-    truncated: boolean;
-};
-/**
- * Narrow the opaque `tool/result.meta` into one bounded expansion payload,
- * mirroring the upstream presenters' degradation ladder: diffs (write/edit),
- * read windows (read), sources (web_search), fetch summaries (web_fetch), and
- * the bounded raw result text as the universal fallback.
- * @param meta - the persisted presentation metadata, when the tool attached one.
- * @param rawText - the joined text blocks of the result message.
- * @returns the expansion payload, or undefined when nothing renderable exists.
- */
-export declare function toolResultDetail(meta: unknown, rawText: string): ToolDetail | undefined;

package/vendor/tui/types/render/tool-preview.d.ts

@@ -1,28 +0,0 @@
-/**
- * Bounded preview line for a tool invocation's raw JSON arguments: the first
- * human-meaningful string among the well-known keys (command, path, query, …)
- * with a fallback to the bounded raw JSON. Shared by the tool card in the
- * transcript and the approval bar's command preview. Arguments longer than
- * {@link MAX_PARSE_CHARS} are never parsed: the preview is a display concern,
- * and a synchronous `JSON.parse` plus string copies of an unbounded model
- * payload must not run on the approval or projection paths.
- *
- * @module @deepseek-ai/dsh-code/render/tool-preview
- */
-/**
- * Resolve one bounded preview for raw tool arguments.
- * @param args - raw JSON arguments string as the model produced it.
- * @param toolName - the tool the arguments belong to (fallback label).
- * @returns the preview line; empty when nothing useful resolves.
- */
-export declare function toolArgumentsPreview(args: string, toolName: string): string;
-/**
- * Bounded prompt preview for delegation-style tools (`subagent`): the
- * `prompt` argument rendered as the card's second row, so the transcript
- * shows what the child agent was asked — not just its description label —
- * while it runs (Codex's SpawnAgent card preview). Anything else returns ''.
- * @param toolName - the tool the arguments belong to.
- * @param args - raw JSON arguments string as the model produced it.
- * @returns the one-line prompt preview, or '' when none applies.
- */
-export declare function toolPromptPreview(toolName: string, args: string): string;

package/vendor/tui/types/render/usage.d.ts

@@ -1,113 +0,0 @@
-/**
- * Session usage for the /usage panel: the provider-reported token totals, the
- * context pressure and composition, and the exact per-turn accounting, folded
- * into the styled rows the panel draws.
- *
- * Every figure comes from the harness token meter. The four token buckets are
- * disjoint, so the prompt side is never double counted; the composition block
- * is a density estimate and is labelled as one.
- *
- * @module @deepseek-ai/dsh-tui/render/usage
- */
-import type { SessionEvent } from '@deepseek-ai/dsh-session';
-import type { TokenUsageProjection, TurnTokenUsage } from '@deepseek-ai/dsh-token-meter/client';
-import { type StyledLine } from './lines.ts';
-/** One completed turn's exact provider-reported accounting. */
-export interface UsageTurn {
-    /** Durable turn number (`turn/start`). */
-    readonly turn: number;
-    readonly usage: TurnTokenUsage;
-    /**
-     * The model that billed this turn, or '' when nothing in the log names one.
-     * The meter's own `routes` is preferred; it is absent whenever ONE attempt
-     * went unattributed, so the turn's own assistant messages answer instead.
-     */
-    readonly model: string;
-}
-/**
- * Everything the panel reads. The totals come from the mounted projection and
- * the per-turn rows from the meter's own fold; a missing projection renders as
- * explicitly unavailable rather than as zeros, because an unmounted deployment
- * and a session with no traffic are different facts.
- */
-export interface UsageView {
-    /** Provider-reported usage over the whole durable log. */
-    readonly totals?: TokenUsageProjection;
-    /** Completed turns, oldest first. */
-    readonly turns: readonly UsageTurn[];
-}
-/** Prompt-side tokens the provider billed: uncached input plus both cache buckets. */
-export declare function billedInputTokens(totals: TokenUsageProjection): number;
-/** Prompt plus completion tokens over the whole log. */
-export declare function usageTotalTokens(totals: TokenUsageProjection): number;
-/**
- * Cache-hit share of billed prompt-side input.
- * @param totals - cumulative provider-reported buckets.
- * @returns percent rounded to one decimal place, or null when nothing was billed.
- */
-export declare function usageCacheHitPercent(totals: TokenUsageProjection): number | null;
-/** One complete turn's durable events, in log order. */
-export interface TurnSlice {
-    readonly turn: number;
-    readonly events: readonly SessionEvent[];
-}
-/**
- * Split a durable log into COMPLETE turns. A turn still running has no
- * `turn/end` yet, and an unfinished attempt has no exact accounting, so the
- * trailing slice is dropped rather than guessed at.
- * @param events - the whole durable log, in log order.
- * @returns one slice per `turn/start`…`turn/end` span, oldest first.
- */
-export declare function completedTurns(events: readonly SessionEvent[]): readonly TurnSlice[];
-/**
- * Exact usage for every completed turn that can be proven.
- * @param events - the whole durable log, in log order.
- * @param derive - the meter's per-turn fold, injected so this module stays pure.
- * @returns one row per provable turn, oldest first; turns whose attempts did
- *   not all report usage are omitted rather than estimated, and so is a turn
- *   that billed nothing at all — an empty row is noise in a usage table.
- */
-export declare function turnUsages(events: readonly SessionEvent[], derive: (events: readonly SessionEvent[]) => TurnTokenUsage | undefined): readonly UsageTurn[];
-/** A bucket some turn of a group did not report, leaving the group sum a floor. */
-export type PartialBucket = 'cacheReadTokens' | 'cacheWriteTokens' | 'reasoningTokens';
-/** One model's merged totals across every turn it billed. */
-export interface ModelUsage {
-    /** Model names joined with ` + ` (a turn that switched models lists both). */
-    readonly model: string;
-    /** Turns attributed to this model. */
-    readonly turns: number;
-    readonly uncachedInputTokens: number;
-    readonly outputTokens: number;
-    readonly totalTokens: number;
-    /** Summed over the turns that reported it; absent when none did. */
-    readonly cacheReadTokens?: number;
-    /** Summed over the turns that reported it; absent when none did. */
-    readonly cacheWriteTokens?: number;
-    /** Summed over the turns that reported it; absent when none did. */
-    readonly reasoningTokens?: number;
-    /**
-     * Buckets some turn of the group left unreported. The corresponding sum (and
-     * the hit share derived from it) counts only what WAS reported, so the
-     * display marks it as a floor rather than hiding the group's known traffic.
-     */
-    readonly partial: readonly PartialBucket[];
-}
-/**
- * Merge the per-turn rows by the model that billed them, biggest spender
- * first. A turn lands in exactly one group — the group named by every model it
- * used — so the sums stay additive and a mid-turn model switch never counts
- * the same tokens twice. Each bucket is merged over the turns that reported
- * it, and {@link ModelUsage.partial} records the ones that stayed silent.
- * @param turns - provable per-turn rows, oldest first.
- * @returns one row per model group.
- */
-export declare function modelTotals(turns: readonly UsageTurn[]): readonly ModelUsage[];
-/** The model attribution for one turn: the meter's routes, else its messages. */
-export declare function turnModel(slice: TurnSlice, usage: TurnTokenUsage): string;
-/**
- * Render the panel body.
- * @param view - the projection totals plus the derived per-turn rows.
- * @param columns - usable content columns inside the panel border.
- * @returns bounded, styled rows ready to draw.
- */
-export declare function usageLines(view: UsageView, columns: number): readonly StyledLine[];

package/vendor/tui/types/render/width.d.ts

@@ -1,29 +0,0 @@
-/**
- * Precise terminal-cell width measurement — the single authority every
- * budget, wrap, and truncation path shares. The previous heuristic
- * (`codePoint > 0x2e7f ? 2 : 1)) mis-sized Hangul Jamo (narrow), high
- * non-CJK code points (wide), and emoji: text-default glyphs like ✳ ⚠ ❤
- * counted 2 while terminals draw 1, and VS16 sequences counted 1 while
- * terminals draw 2 — the exact drift class the community dsh-TUI string
- * engine documents (a spinner glyph drifting one column per frame). This
- * module adapts that engine's rules without its Ink-fork renderer: an ASCII
- * fast path, grapheme-cluster iteration via Intl.Segmenter (code-point
- * fallback), a merged East-Asian-Wide/Fullwidth + Emoji_Presentation range
- * table, text-default emoji = 1, VS16 = 2, marks/selectors/ZWJ = 0.
- * @module @deepseek-ai/dsh-code/render/width
- */
-/** Split text into grapheme clusters (code points when Segmenter is absent). */
-export declare function splitGraphemes(text: string): string[];
-/** Terminal-cell width of one grapheme cluster. */
-export declare function graphemeWidth(cluster: string): number;
-/** Terminal-cell width of one code point (surrogate pairs must stay paired). */
-export declare function codePointWidth(char: string): number;
-/**
- * Terminal-cell width of a string: an ASCII fast path avoids the segmenter
- * for the overwhelmingly common case; everything else sums grapheme clusters.
- * Control characters occupy no cells (display sanitization makes them
- * visible escapes before they ever reach a budget).
- * @param text - display-safe or raw text to measure.
- * @returns the column count the terminal will draw.
- */
-export declare function stringWidth(text: string): number;