zcode-acp-server 0.11.8 → 0.14.1

package/dist/repl/model.d.ts

@@ -0,0 +1,275 @@
+/**
+ * Pure REPL turn state machine: folds ACP SessionUpdate notifications for one
+ * prompt turn into renderable entries. No React, no I/O — exported for unit
+ * tests.
+ *
+ * Chunk ordering follows what the bridge emits per turn: thought chunks and
+ * message chunks arrive interleaved as streams (buffered until the stream
+ * switches), tool calls arrive as discrete events keyed by toolCallId, and a
+ * tool_call_update may later change only the status of an existing row.
+ */
+import type { SessionConfigOption, SessionUpdate } from "@agentclientprotocol/sdk";
+import type { QuotaResult } from "../quota/types.js";
+/** Alias so tests can build fixtures without importing SDK types directly. */
+export type SessionUpdateLike = SessionUpdate;
+/**
+ * Compact plan-quota summary for the prompt line's status row, e.g.
+ * `"5h 34% · wk 8%"`. Token windows only (5h / weekly — all GLM exposes);
+ * MCP detail lives in the full `/quota` card, not a one-line indicator, and
+ * unknown future windows are skipped rather than mislabeled. Returns null
+ * when there is nothing worth showing (fetch failed / auth expired /
+ * transient busy) so the row degrades to its previous form instead of
+ * nagging.
+ */
+export declare function formatQuotaLine(result: QuotaResult | null): string | null;
+/**
+ * Estimated rendered line count of `text` when wrapped at `width` display
+ * columns (CJK-aware via string-width). Word-wrap vs hard-cut can differ by a
+ * line on pathological words — close enough for viewport slicing.
+ */
+export declare function estimateLines(text: string, width: number): number;
+/**
+ * One visual row of the wrapped input line: the code-point slice [start, next)
+ * of the editor text, hard-cut at `width` display columns (terminal-style soft
+ * wrap — same convention estimateLines assumes) with "\n" forcing a break.
+ */
+export interface EditorRow {
+    text: string;
+    /** Code-point offset of this row's first character within the editor text. */
+    start: number;
+}
+export interface CaretPosition {
+    row: number;
+    /** Display column of the caret within its row. */
+    col: number;
+    /** Code-point offset of the caret relative to its row's start. */
+    rowOffset: number;
+    totalRows: number;
+}
+/**
+ * Hard-wrap the (logically single-line, "\n"-tolerant) editor text into visual
+ * rows of at most `width` display columns. CJK-aware via string-width; a
+ * character wider than a whole row still occupies its own row.
+ */
+export declare function wrapEditorLine(text: string, width: number): EditorRow[];
+/** Locate the caret within wrapEditorLine's layout. O(caret), fine for prompts. */
+export declare function locateCaret(text: string, caret: number, width: number): CaretPosition;
+/** Visual text rows of the input editor at terminal width `cols`. */
+export declare function editorTextRows(text: string, cols: number): number;
+/**
+ * Rows the whole bordered input box occupies: 2 border + status row + text.
+ * Used by both the layout fold (App) and as InputLine's own height — keep in
+ * one place so they can never drift apart.
+ */
+export declare function inputBoxRows(editorText: string, cols: number): number;
+/**
+ * Sliding viewport over a picker's full item list: pinned to the head while
+ * the selection fits in the first window, then the selection rides the
+ * window's bottom edge one row per step until the list tail clamps it.
+ * Pickers stay short no matter how many sessions/options exist — rendering
+ * the full list would blow up the dynamic footer and jolt the scrollback.
+ */
+export declare function pickerWindow<T>(items: T[], index: number, max?: number): {
+    slice: T[];
+    start: number;
+};
+export interface WelcomeInfo {
+    version: string;
+    cwd: string;
+    /** Display labels of the seeded config selects ("" when not advertised). */
+    model: string;
+    mode: string;
+    thought: string;
+}
+/** One rendered line (or block) in the transcript. */
+export type ReplEntry = {
+    kind: "user";
+    text: string;
+} | {
+    kind: "thinking";
+    text: string;
+} | {
+    kind: "assistant";
+    text: string;
+} | {
+    kind: "tool";
+    id?: string;
+    title: string;
+    status: string;
+} | {
+    kind: "note";
+    text: string;
+} | {
+    kind: "welcome";
+    info: WelcomeInfo;
+};
+/** Live snapshot of a turn in progress (null textBuf/thinkBuf = not streaming). */
+export interface TurnState {
+    entries: ReplEntry[];
+    textBuf: string;
+    thinkBuf: string;
+}
+export declare function createTurnState(): TurnState;
+/**
+ * Apply one update to the live turn state. Returns a NEW state object (safe
+ * for React-style always-replace updates). Unknown update kinds are ignored.
+ */
+export declare function applyUpdate(state: TurnState, update: SessionUpdate): TurnState;
+/**
+ * Close out a turn: flush any pending thought/text buffers as final entries
+ * and append the stop-reason note. Returns only the finished entries — the
+ * turn state is discarded afterwards.
+ */
+export declare function finishTurn(state: TurnState, stopReason?: string): ReplEntry[];
+/** REPL meta-commands. Everything else is a prompt. */
+export type ReplCommand = "exit" | "sessions" | "new" | null;
+export declare function parseCommand(text: string): ReplCommand;
+/**
+ * One resumable session as shown by the interactive `/sessions` picker.
+ * Mirrors the ACP `session/list` entry shape without importing SDK types.
+ */
+export interface SessionSummary {
+    sessionId: string;
+    cwd: string;
+    title?: string | null;
+    updatedAt?: string | null;
+}
+/**
+ * Compact relative age for a session's `updatedAt` ("just now", "5m ago",
+ * "2h ago", "3d ago", else the ISO date). Empty for absent/unparsable input.
+ */
+export declare function relativeTime(iso: string | null | undefined): string;
+/**
+ * A slash command advertised by the bridge (`available_commands_update`).
+ */
+export interface CommandInfo {
+    name: string;
+    description: string;
+}
+/** One select config (model / mode / thought) with its current value. */
+export interface ConfigSelect {
+    current: string;
+    options: Array<{
+        value: string;
+        name: string;
+    }>;
+}
+/**
+ * Session-level status surface: the command menu plus the three config
+ * selects, all pushed by the bridge outside the turn stream.
+ */
+export interface ReplStatus {
+    commands: CommandInfo[];
+    model: ConfigSelect | null;
+    mode: ConfigSelect | null;
+    thought: ConfigSelect | null;
+}
+export declare function createReplStatus(): ReplStatus;
+/** Commands shown before the bridge's first `available_commands_update`. */
+export declare const FALLBACK_COMMANDS: CommandInfo[];
+/**
+ * The command menu: bridge-advertised commands (or the fallback list before
+ * the first push) with the REPL-local entries merged in front — without the
+ * merge, /help and /exit vanish from completion and /help output as soon as
+ * the bridge's own list lands (the bridge only advertises ITS commands).
+ */
+export declare function commandMenu(status: ReplStatus): CommandInfo[];
+/**
+ * Fold a status-relevant session update into the status. Called for EVERY
+ * update (idle and in-turn): the config/command pushes that follow a switch
+ * slash-command arrive while that turn is still active. Unknown kinds return
+ * the SAME object reference so callers can skip the rerender.
+ */
+export declare function applyStatusUpdate(status: ReplStatus, update: SessionUpdate): ReplStatus;
+/** Display label for a select's current value (name over raw value). */
+export declare function selectLabel(select: ConfigSelect | null): string;
+/**
+ * Seed the status from the session/new RESPONSE: the bridge ships the initial
+ * model/mode/thought selects in the response body, not as a follow-up
+ * notification (later changes do push config_option_update notifications).
+ */
+export declare function seedStatusFromNewSession(status: ReplStatus, response: {
+    configOptions?: SessionConfigOption[] | null;
+}): ReplStatus;
+/**
+ * Render a config select as note lines: one per option, current marked with a
+ * bullet. The raw `value` is what the user types after /model etc., so it is
+ * shown whenever it differs from the display name (third-party models).
+ */
+export declare function formatConfigList(title: string, select: ConfigSelect | null): string[];
+/**
+ * REPL-local commands that never reach the bridge: `/help`, and the arg-less
+ * listing form of `/model` `/mode` `/thought` (the bridge rejects those with
+ * -32602). Everything else — including the switch forms with an argument —
+ * returns null and is sent as a prompt (the bridge's slash interception is
+ * the battle-tested path editors use).
+ */
+export declare function handleLocalCommand(text: string, status: ReplStatus): ReplEntry[] | null;
+/** One entry of the completion menu below/above the input line. */
+export interface CompletionItem {
+    /** Text inserted into the line when chosen (command with "/", or option value). */
+    value: string;
+    /** Display label shown in the menu. */
+    label: string;
+    /** Secondary text (command description, or the raw value when it differs). */
+    description?: string;
+    /** True when this option is the select's current value (● marker). */
+    current?: boolean;
+}
+/**
+ * Max rows the menu renders — longer lists narrow with the typed prefix.
+ * Also the FIXED slot count of the rendered menu block (blanks beyond the
+ * candidate count): constant height keeps ink's frame updates equal-size,
+ * which is what keeps the top highlight visible (see App.tsx menu block).
+ */
+export declare const COMPLETION_LIMIT = 8;
+/** Whether `cmd` (bare name, no slash) takes a completable config argument. */
+export declare function isConfigCommand(cmd: string): boolean;
+/**
+ * True when the line sits in a config command's argument menu ("/model v…").
+ * There the highlighted option IS the decision — enter executes the switch
+ * directly. Every other completion context (command names, skill commands,
+ * plugins) only FILLS the line; sending stays the user's explicit choice.
+ * Only meaningful when a completion menu is open (line starts with "/").
+ */
+export declare function isConfigArgumentMenu(value: string): boolean;
+/** Whether the "/"-prefixed single-token line executes immediately when picked. */
+export declare function isOneShotCommandValue(value: string): boolean;
+/**
+ * Completion candidates for the current line, or null outside a completion
+ * context:
+ *   - "/par"     → advertised commands matching the prefix ("/" alone = all)
+ *   - "/model v" → model option values/names matching the argument prefix
+ *   - other text, a second space, or a select not yet advertised → null/[]
+ */
+export declare function completionCandidates(value: string, status: ReplStatus): CompletionItem[] | null;
+/**
+ * Insert a chosen candidate into the line. Command completions keep a
+ * trailing space so the argument menu opens immediately; option completions
+ * replace the argument in place (`/model <value>`).
+ */
+export declare function applyCompletion(value: string, item: CompletionItem): string;
+/** One question parsed from the bridge's AskUserQuestion elicitation form. */
+export interface QuestionForm {
+    /** Content key the answer must ride under (`q_<i>`). */
+    key: string;
+    /** The question text. */
+    title: string;
+    multiSelect: boolean;
+    options: Array<{
+        value: string;
+        label: string;
+    }>;
+}
+/**
+ * Parse an `elicitation/create` form payload (the bridge's AskUserQuestion
+ * mapping — see `buildAskUserElicitationForm`) into renderable questions:
+ * `q_<i>` string fields with `oneOf` const/title options (single-select) or
+ * array fields with `items.anyOf` (multi-select).
+ *
+ * The `q_<i>_other` free-text companions are skipped (the picker has a
+ * built-in custom-answer row) and the skip sentinel option is dropped (esc
+ * covers skip). Returns null when the payload has no renderable question.
+ */
+export declare function parseQuestionForm(params: unknown): QuestionForm[] | null;
+//# sourceMappingURL=model.d.ts.map

package/dist/repl/model.d.ts.map

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