@vascend/talos 0.1.0

package/dist/tui/queued-questions.d.ts

@@ -0,0 +1,20 @@
+import { type QueueStyle } from "./queue-screen.js";
+import type { ScreenKey } from "./terminal-screen.js";
+export declare class QueuedQuestions {
+    private readonly changed;
+    private readonly pending;
+    focused: boolean;
+    constructor(changed: () => void);
+    get count(): number;
+    enqueue(title: string, options?: readonly string[], signal?: AbortSignal): Promise<string | null>;
+    open(): void;
+    hide(): void;
+    clear(): void;
+    paste(text: string): void;
+    key(text: string, key: ScreenKey): void;
+    render(columns: number, maxRows: number, style?: QueueStyle): {
+        lines: string[];
+        cursorRow: number;
+        cursorCol: number;
+    };
+}

package/dist/tui/queued-questions.js

@@ -0,0 +1,163 @@
+import { tr } from "./i18n.js";
+import { fitLine, plainText, terminalWidth, wrapText } from "./terminal-text.js";
+import { PLAIN_QUEUE_STYLE } from "./queue-screen.js";
+// Questions own their editor. Enqueuing, answering or hiding one never changes
+// the main composer's draft, cursor, history or attachments.
+export class QueuedQuestions {
+    changed;
+    pending = [];
+    focused = false;
+    constructor(changed) {
+        this.changed = changed;
+    }
+    get count() { return this.pending.length; }
+    enqueue(title, options = [], signal) {
+        if (signal?.aborted)
+            return Promise.resolve(null);
+        return new Promise(resolve => {
+            const question = {
+                title, options: [...options], index: 0, text: "", cursor: 0, offset: 0,
+                finish: answer => {
+                    signal?.removeEventListener("abort", abort);
+                    const index = this.pending.indexOf(question);
+                    if (index < 0)
+                        return;
+                    this.pending.splice(index, 1);
+                    if (index === 0)
+                        this.focused = false;
+                    resolve(answer);
+                    this.changed();
+                },
+            };
+            const abort = () => question.finish(null);
+            this.pending.push(question);
+            signal?.addEventListener("abort", abort, { once: true });
+            if (signal?.aborted)
+                abort();
+            else
+                this.changed();
+        });
+    }
+    open() { if (this.count) {
+        this.focused = true;
+        this.changed();
+    } }
+    hide() { this.focused = false; this.changed(); }
+    clear() { for (const question of [...this.pending])
+        question.finish(null); }
+    paste(text) {
+        const q = this.pending[0];
+        if (!q || !this.focused)
+            return;
+        const clean = plainText(text).replace(/[\r\n\t]+/g, " ");
+        q.index = q.options.length;
+        q.text = q.text.slice(0, q.cursor) + clean + q.text.slice(q.cursor);
+        q.cursor += clean.length;
+        q.offset = -1;
+        this.changed();
+    }
+    key(text, key) {
+        const q = this.pending[0];
+        if (!q || !this.focused)
+            return;
+        if (key.name === "escape" || key.meta && key.name === "down") {
+            this.hide();
+            return;
+        }
+        if (text === "\x1d" || key.ctrl && key.name === "]") {
+            q.finish(null);
+            return;
+        }
+        if (key.name === "return" || key.name === "enter") {
+            const answer = q.options[q.index] ?? q.text.trim();
+            if (answer)
+                q.finish(answer);
+            return;
+        }
+        if (key.name === "pageup" || key.name === "pagedown") {
+            q.offset = Math.max(0, q.offset + (key.name === "pageup" ? -3 : 3));
+        }
+        else if (key.name === "up" || key.name === "down" || key.name === "tab") {
+            const delta = key.name === "up" || key.shift ? -1 : 1;
+            q.index = (q.index + delta + q.options.length + 1) % (q.options.length + 1);
+            q.offset = -1;
+        }
+        else if (key.ctrl && key.name === "a" || key.name === "home")
+            q.cursor = 0;
+        else if (key.ctrl && key.name === "e" || key.name === "end")
+            q.cursor = q.text.length;
+        else if (key.name === "left")
+            q.cursor = Math.max(0, q.cursor - 1);
+        else if (key.name === "right")
+            q.cursor = Math.min(q.text.length, q.cursor + 1);
+        else if (key.ctrl && key.name === "u") {
+            q.text = q.text.slice(q.cursor);
+            q.cursor = 0;
+        }
+        else if (key.ctrl && key.name === "k")
+            q.text = q.text.slice(0, q.cursor);
+        else if (key.name === "backspace" && q.cursor) {
+            q.text = q.text.slice(0, q.cursor - 1) + q.text.slice(q.cursor);
+            q.cursor--;
+        }
+        else if (key.name === "delete")
+            q.text = q.text.slice(0, q.cursor) + q.text.slice(q.cursor + 1);
+        else if (text && !key.ctrl && !key.meta && !/[\x00-\x1f\x7f]/.test(text)) {
+            this.paste(text);
+            return;
+        }
+        this.changed();
+    }
+    render(columns, maxRows, style = PLAIN_QUEUE_STYLE) {
+        const width = Math.max(4, columns - 1);
+        const heading = fitLine(style.muted("  • " + tr("Richieste in coda", "Queued follow-up inputs")), width);
+        if (!this.count)
+            return { lines: [], cursorRow: 0, cursorCol: 1 };
+        if (!this.focused)
+            return {
+                lines: [heading,
+                    fitLine(style.heading("    ? " + (this.count === 1 ? tr("1 domanda", "1 question") : tr("{count} domande", "{count} questions", { count: this.count }))), width),
+                    fitLine(style.muted("      " + tr("Shift+← per rispondere", "Shift+← to answer")), width)],
+                cursorRow: 0, cursorCol: 1,
+            };
+        const q = this.pending[0];
+        const bodyWidth = Math.max(2, width - 4);
+        const body = wrapText(plainText(q.title), bodyWidth, true).map(row => style.heading("  " + row));
+        body.push("");
+        let selectedRow = 0, selectedEnd = 0, cursorCol = 3;
+        [...q.options, tr("Altro", "Other")].forEach((option, index) => {
+            const prefix = `${index === q.index ? "›" : " "} ${index + 1}. `;
+            const available = Math.max(1, width - terminalWidth(prefix) - 2);
+            if (index === q.index)
+                selectedRow = body.length;
+            if (index === q.options.length && index === q.index) {
+                let start = 0;
+                while (start < q.cursor && terminalWidth(q.text.slice(start, q.cursor)) >= available)
+                    start++;
+                cursorCol = 2 + terminalWidth(prefix) + terminalWidth(q.text.slice(start, q.cursor));
+                body.push(" " + style.heading(prefix) + (style.text ?? style.selected)(fitLine(q.text.slice(start) || option, available)));
+            }
+            else {
+                for (const [part, row] of wrapText(plainText(option), available, true).entries()) {
+                    body.push(" " + (index === q.index ? style.heading : style.muted)((part ? " ".repeat(prefix.length) : prefix) + row));
+                }
+            }
+            if (index === q.index)
+                selectedEnd = body.length;
+        });
+        const shortcuts = tr("Invio invia · Ctrl+] salta · Alt+↓ prompt", "Enter submit · Ctrl+] skip · Alt+↓ main prompt");
+        const footer = wrapText(shortcuts, bodyWidth, true).map(row => style.muted("  " + row));
+        const page = Math.max(1, maxRows - footer.length - 2);
+        if (q.offset < 0)
+            q.offset = Math.max(0, Math.min(selectedRow, selectedEnd - page));
+        q.offset = Math.min(q.offset, Math.max(0, body.length - page));
+        const background = (row) => {
+            const content = fitLine(row, width - 1);
+            return " " + "\x1b[48;5;236m" + content.replace(/\x1b\[0m/g, "\x1b[0m\x1b[48;5;236m")
+                + " ".repeat(Math.max(0, width - 1 - terminalWidth(content))) + "\x1b[0m";
+        };
+        const lines = [heading, ...body.slice(q.offset, q.offset + page).map(background), ...footer.map(background)];
+        return { lines, cursorRow: Math.max(1, Math.min(selectedRow - q.offset + 1, lines.length - footer.length - 1)),
+            cursorCol: Math.min(width, cursorCol + 1) };
+    }
+}

package/dist/tui/quick-help.d.ts

@@ -0,0 +1 @@
+export declare const QUICK_HELP = "## Inizia qui\nScrivi una richiesta e premi **Invio**. Talos mostra la risposta nella chat; l'input resta in basso.\n\n### Token e contesto\n- **Contesto~** mostra una barra breve con token e percentuale **attivi** e **archiviati**, stimati rispetto alla finestra del modello. Il valore dopo **/** \u00E8 la capacit\u00E0 della finestra. Sotto l'input, **7g** \u00E8 la quota settimanale residua e **reset** il tempo rimasto; **~** davanti alla quota indica un dato non recente. Tutte le finestre e i consumi restano in **/usage**.\n- I blocchi **lime** rappresentano il contesto attivo; i **grigi** la quantit\u00E0 originale archiviata, dal pi\u00F9 vecchio (scuro) al pi\u00F9 recente (chiaro). **Archiviato** e **attivo** hanno percentuali separate rispetto alla finestra del modello. Il materiale grigio \u00E8 conservato fuori dalla finestra viva; riassunti e riferimenti fanno parte dell'attivo. **\u00D7N** indica la scala della barra quando il totale supera una finestra. Dettagli in **/context**.\n- Il totale in **/usage** somma i token delle chiamate della sessione, anche input ripetuti e cache: non indica il contesto di una singola richiesta. **\u2265** significa totale parziale.\n- Talos seleziona informazioni rilevanti e gestisce la cronologia con recupero e compattazione secondo la configurazione; i consumi del provider restano reali.\n- **ctx~** \u00E8 una stima locale del contesto, non la misura esatta del payload inviato. La quota ChatGPT \u00E8 separata. **/usage** mostra dettagli, cache e ultima chiamata.\n\n### Copiare e incollare\n- **/copy** copia l'ultima risposta testuale, senza colori del terminale (mantiene il Markdown).\n- **/copy una frase** copia soltanto il testo scritto dopo il comando.\n- Per selezionare una frase dalla chat: trascina il mouse senza tenere Shift, poi usa **Ctrl+Shift+C** (Windows/Linux) o **Cmd+C** (macOS). Dipende dalle impostazioni del terminale.\n- Incolla testo con **Ctrl+Shift+V** o **Cmd+V**. **Alt+V** legge un'immagine dagli appunti; puoi anche usare **/img percorso**.\n- I riferimenti **img #N** e **txt #N** sono evidenziati in ciano nel campo di input e nella chat; il contenuto completo viene allegato all'invio.\n- **Ctrl+C non \u00E8 il comando di copia di Talos.**\n\n### Fermare senza perdere il controllo\n- Primo **Ctrl+C**: avviso, nessuna azione. Secondo **Ctrl+C entro 2 secondi**: conferma l'azione indicata (fermare il lavoro, svuotare la bozza o uscire).\n- Un altro tasto annulla la conferma. **Esc** ferma subito il lavoro; in un menu o una domanda chiude solo quel pannello.\n- Fermare il lavoro conserva i messaggi in coda e li mette in pausa. **Alt+Q** apre la gestione per riprenderli o eliminarli. I processi in background si gestiscono con **/bg**.\n- **/quit** esce direttamente. Le chat gi\u00E0 inviate restano salvate; le bozze non sono salvate.\n\n### Messaggi in attesa\n- Sopra l'input, il punto **\u2022** indica i messaggi in attesa e quando verranno consegnati; la riga rientrata **\u21B3** mostra il prossimo messaggio. Normalmente partono in ordine dopo la risposta corrente; **Alt+Q** mostra tutti i messaggi.\n- **Alt+Q** o **/queue** (anche **/coda**) apre subito la coda: frecce per scegliere, **Invio** modifica, **Canc** elimina, **Shift+Su/Gi\u00F9** riordina, **p** mette in pausa o riprende.\n- **Alt+S** invia subito il testo che stai scrivendo, anche durante la risposta; se l'input \u00E8 vuoto, invia la prima richiesta in coda. Nella coda, **s \u00B7 Invia subito** invia il messaggio selezionato. Talos interrompe la generazione e riparte con il nuovo input; un'operazione gi\u00E0 avviata termina prima. **Alt+Invio** \u00E8 un alias nei terminali che lo inoltrano.\n- Con **almeno 3 richieste** in coda, **Alt+T** le invia subito insieme e chiede all'agente di ingaggiare il team per implementarle tutte. Nella gestione coda puoi usare anche **g \u00B7 Invia al team**. I comandi sono esclusi e la bozza che stai scrivendo resta intatta. Fino alla consegna puoi ancora modificare le singole richieste; il gruppo viene conservato anche al riavvio, in pausa.\n- **t** sceglie tra \u201Cdopo la risposta\u201D e \u201Cdurante il lavoro\u201D. Questa seconda modalit\u00E0 attende la risposta o l'operazione corrente senza interromperla.\n- Mentre gestisci o modifichi la coda nessun messaggio viene consegnato. **Invio** salva la modifica, **Esc** la annulla e conserva l'originale. La bozza precedente resta intatta.\n- Un messaggio compare nella conversazione solo alla consegna, con l'etichetta **Dalla coda \u00B7 consegnato**. Da quel momento non \u00E8 pi\u00F9 modificabile nella coda.\n- La coda \u00E8 salvata per chat, con ordine, modifiche confermate, testo incollato e immagini. Dopo la chiusura, il normale avvio riprende la chat con l'ultima coda pendente; una chat scelta esplicitamente ha precedenza. Aprire la chat lascia i messaggi **in pausa**. Quando Talos \u00E8 a riposo, **Invio** riprende la coda, anche con input vuoto; un nuovo prompt viene aggiunto in fondo e avvia la consegna. Puoi anche usare **Alt+Q**, poi **p** per riprenderli oppure **s** per inviarne uno subito.\n\n### Modalit\u00E0 fast\n- **/fast on** attiva la modalit\u00E0 veloce per ChatGPT/OpenAI, **/fast off** la disattiva, **/fast status** mostra lo stato. Quando \u00E8 attiva, **fast** compare accanto al modello. La preferenza \u00E8 salvata per i prossimi avvii.\n- Fast richiede il relativo supporto del modello e del provider e pu\u00F2 aumentare i consumi.\n\n### Ritrovare le chat\n- **/new** apre una chat vuota: la precedente resta salvata.\n- **/chats** (o **/resume**) apre la ricerca delle chat salvate; scrivi per filtrare, usa le frecce e Invio, Esc per annullare.\n- **/rename Titolo** assegna un nome riconoscibile alla chat corrente.\n- **/sessions** mostra gli ID; **/resume ID** riprende una chat specifica.\n\n### Leggere e navigare\n- **PageUp / PageDown**, rotella o **Shift+Su/Gi\u00F9** scorrono la conversazione senza spostare l'input.\n- **Su/Gi\u00F9** in fondo alla chat richiamano le richieste precedenti. **Tab** completa i comandi.\n- **Ctrl+R** apre la revisione delle attivit\u00E0; **Ctrl+O** apre l'elenco dei file modificati: frecce per scegliere, Invio per leggere il confronto, Esc per tornare. **Ctrl+G** o **/todo** apre la lista delle attivit\u00E0, con gruppi e stati: da fare, in corso, completata e fallita.\n- **/commands** apre tutti i comandi, con ricerca. **/help** riapre questa guida.\n\nLe scorciatoie descritte valgono nella TUI interattiva. In terminali remoti, copia e selezione dipendono anche dal client; /copy usa gli appunti della macchina dove gira Talos.\n";

package/dist/tui/quick-help.js

@@ -0,0 +1,53 @@
+// Guida orientata alle azioni; /commands resta il catalogo completo ricercabile.
+export const QUICK_HELP = `## Inizia qui
+Scrivi una richiesta e premi **Invio**. Talos mostra la risposta nella chat; l'input resta in basso.
+
+### Token e contesto
+- **Contesto~** mostra una barra breve con token e percentuale **attivi** e **archiviati**, stimati rispetto alla finestra del modello. Il valore dopo **/** è la capacità della finestra. Sotto l'input, **7g** è la quota settimanale residua e **reset** il tempo rimasto; **~** davanti alla quota indica un dato non recente. Tutte le finestre e i consumi restano in **/usage**.
+- I blocchi **lime** rappresentano il contesto attivo; i **grigi** la quantità originale archiviata, dal più vecchio (scuro) al più recente (chiaro). **Archiviato** e **attivo** hanno percentuali separate rispetto alla finestra del modello. Il materiale grigio è conservato fuori dalla finestra viva; riassunti e riferimenti fanno parte dell'attivo. **×N** indica la scala della barra quando il totale supera una finestra. Dettagli in **/context**.
+- Il totale in **/usage** somma i token delle chiamate della sessione, anche input ripetuti e cache: non indica il contesto di una singola richiesta. **≥** significa totale parziale.
+- Talos seleziona informazioni rilevanti e gestisce la cronologia con recupero e compattazione secondo la configurazione; i consumi del provider restano reali.
+- **ctx~** è una stima locale del contesto, non la misura esatta del payload inviato. La quota ChatGPT è separata. **/usage** mostra dettagli, cache e ultima chiamata.
+
+### Copiare e incollare
+- **/copy** copia l'ultima risposta testuale, senza colori del terminale (mantiene il Markdown).
+- **/copy una frase** copia soltanto il testo scritto dopo il comando.
+- Per selezionare una frase dalla chat: trascina il mouse senza tenere Shift, poi usa **Ctrl+Shift+C** (Windows/Linux) o **Cmd+C** (macOS). Dipende dalle impostazioni del terminale.
+- Incolla testo con **Ctrl+Shift+V** o **Cmd+V**. **Alt+V** legge un'immagine dagli appunti; puoi anche usare **/img percorso**.
+- I riferimenti **img #N** e **txt #N** sono evidenziati in ciano nel campo di input e nella chat; il contenuto completo viene allegato all'invio.
+- **Ctrl+C non è il comando di copia di Talos.**
+
+### Fermare senza perdere il controllo
+- Primo **Ctrl+C**: avviso, nessuna azione. Secondo **Ctrl+C entro 2 secondi**: conferma l'azione indicata (fermare il lavoro, svuotare la bozza o uscire).
+- Un altro tasto annulla la conferma. **Esc** ferma subito il lavoro; in un menu o una domanda chiude solo quel pannello.
+- Fermare il lavoro conserva i messaggi in coda e li mette in pausa. **Alt+Q** apre la gestione per riprenderli o eliminarli. I processi in background si gestiscono con **/bg**.
+- **/quit** esce direttamente. Le chat già inviate restano salvate; le bozze non sono salvate.
+
+### Messaggi in attesa
+- Sopra l'input, il punto **•** indica i messaggi in attesa e quando verranno consegnati; la riga rientrata **↳** mostra il prossimo messaggio. Normalmente partono in ordine dopo la risposta corrente; **Alt+Q** mostra tutti i messaggi.
+- **Alt+Q** o **/queue** (anche **/coda**) apre subito la coda: frecce per scegliere, **Invio** modifica, **Canc** elimina, **Shift+Su/Giù** riordina, **p** mette in pausa o riprende.
+- **Alt+S** invia subito il testo che stai scrivendo, anche durante la risposta; se l'input è vuoto, invia la prima richiesta in coda. Nella coda, **s · Invia subito** invia il messaggio selezionato. Talos interrompe la generazione e riparte con il nuovo input; un'operazione già avviata termina prima. **Alt+Invio** è un alias nei terminali che lo inoltrano.
+- Con **almeno 3 richieste** in coda, **Alt+T** le invia subito insieme e chiede all'agente di ingaggiare il team per implementarle tutte. Nella gestione coda puoi usare anche **g · Invia al team**. I comandi sono esclusi e la bozza che stai scrivendo resta intatta. Fino alla consegna puoi ancora modificare le singole richieste; il gruppo viene conservato anche al riavvio, in pausa.
+- **t** sceglie tra “dopo la risposta” e “durante il lavoro”. Questa seconda modalità attende la risposta o l'operazione corrente senza interromperla.
+- Mentre gestisci o modifichi la coda nessun messaggio viene consegnato. **Invio** salva la modifica, **Esc** la annulla e conserva l'originale. La bozza precedente resta intatta.
+- Un messaggio compare nella conversazione solo alla consegna, con l'etichetta **Dalla coda · consegnato**. Da quel momento non è più modificabile nella coda.
+- La coda è salvata per chat, con ordine, modifiche confermate, testo incollato e immagini. Dopo la chiusura, il normale avvio riprende la chat con l'ultima coda pendente; una chat scelta esplicitamente ha precedenza. Aprire la chat lascia i messaggi **in pausa**. Quando Talos è a riposo, **Invio** riprende la coda, anche con input vuoto; un nuovo prompt viene aggiunto in fondo e avvia la consegna. Puoi anche usare **Alt+Q**, poi **p** per riprenderli oppure **s** per inviarne uno subito.
+
+### Modalità fast
+- **/fast on** attiva la modalità veloce per ChatGPT/OpenAI, **/fast off** la disattiva, **/fast status** mostra lo stato. Quando è attiva, **fast** compare accanto al modello. La preferenza è salvata per i prossimi avvii.
+- Fast richiede il relativo supporto del modello e del provider e può aumentare i consumi.
+
+### Ritrovare le chat
+- **/new** apre una chat vuota: la precedente resta salvata.
+- **/chats** (o **/resume**) apre la ricerca delle chat salvate; scrivi per filtrare, usa le frecce e Invio, Esc per annullare.
+- **/rename Titolo** assegna un nome riconoscibile alla chat corrente.
+- **/sessions** mostra gli ID; **/resume ID** riprende una chat specifica.
+
+### Leggere e navigare
+- **PageUp / PageDown**, rotella o **Shift+Su/Giù** scorrono la conversazione senza spostare l'input.
+- **Su/Giù** in fondo alla chat richiamano le richieste precedenti. **Tab** completa i comandi.
+- **Ctrl+R** apre la revisione delle attività; **Ctrl+O** apre l'elenco dei file modificati: frecce per scegliere, Invio per leggere il confronto, Esc per tornare. **Ctrl+G** o **/todo** apre la lista delle attività, con gruppi e stati: da fare, in corso, completata e fallita.
+- **/commands** apre tutti i comandi, con ricerca. **/help** riapre questa guida.
+
+Le scorciatoie descritte valgono nella TUI interattiva. In terminali remoti, copia e selezione dipendono anche dal client; /copy usa gli appunti della macchina dove gira Talos.
+`;

package/dist/tui/repl.d.ts

@@ -0,0 +1,78 @@
+import { type UserInbox } from "../core/user-inbox.js";
+import type { AgentEvent, ContentPart } from "../core/types.js";
+import type { Harness } from "../core/bootstrap.js";
+import { type TuiTheme } from "./branding.js";
+export { resumeReplay } from "./session-replay.js";
+import { ReviewStore } from "./review-store.js";
+export { filterOptions, pickerPageSize } from "./selector.js";
+interface ReplDeps {
+    readonly harness: Harness;
+    readonly resumePicker?: boolean;
+    readonly recoverQueue?: boolean;
+}
+export interface InputControl {
+    writeConversation?(text: string): void;
+    clearConversation?(): void;
+    replayConversation?(renderer: (columns: number) => string): void;
+    readonly userInbox?: UserInbox;
+    showQueue?(): void;
+    queueQuestion?(title: string, options?: readonly string[], signal?: AbortSignal): Promise<string | null>;
+    restoreQueue?(): void;
+    acceptQueuedMessage?(id: string): string | undefined;
+    pauseQueuedMessages?(): void;
+    readonly review?: ReviewStore;
+    showReview?(section?: string): void;
+    pause(): void;
+    resume(): void;
+    write(text: string): void;
+    replaceTail?(lines: readonly string[], count: number): void;
+    refresh?(): void;
+    setStatus(label: string | null): void;
+    setStatusTool?(name: string | null): void;
+    setRoomStatus?(label: string | null, state?: "running" | "done" | "failed"): void;
+    setLogLine?(index: number, text: string): void;
+    getLogLine?(index: number): string | undefined;
+    setTokens(newInput: number, cache: number, outTok: number): void;
+    setOverlay(lines: string[] | null): void;
+    promptInput(label: string): Promise<string | null>;
+    logLength(): number;
+    fold(start: number, end: number, summary: string): number;
+    openFold(start: number, summary: string): number;
+    updateFoldSummary(id: number, summary: string): void;
+    updateFold(id: number, end: number, summary: string): void;
+    closeFold(id: number, summary?: string): void;
+    expandFold(id?: number): boolean;
+    expandAllFolds(): number;
+    removeFold(id: number): boolean;
+    setKingdomVassals(data: ReadonlyArray<{
+        slug: string;
+        lines: readonly string[];
+    }> | null): void;
+    setKingdomBoard(lines: readonly string[] | null): void;
+    hasKingdomBoard(): boolean;
+}
+type ReadlineLineResult = "quit" | void;
+export interface SerialReadlineQueueOptions {
+    readonly processLine: (raw: string, signal: AbortSignal) => Promise<ReadlineLineResult>;
+    readonly prompt: () => void;
+    readonly requestClose: () => void;
+    readonly onError?: (error: unknown) => void;
+    readonly installAbort?: (abort: () => void) => (() => void);
+    readonly deliverToActive?: (raw: string) => boolean;
+}
+export interface SerialReadlineQueue {
+    enqueue(raw: string): Promise<void>;
+    close(): void;
+    idle(): Promise<void>;
+}
+export declare function beginActiveTurnInbox(): UserInbox;
+export declare function endActiveTurnInbox(): void;
+export declare function deliverToActiveTurn(raw: string, parts?: readonly ContentPart[]): boolean;
+export declare function createSerialReadlineQueue(options: SerialReadlineQueueOptions): SerialReadlineQueue;
+export declare function startRepl(deps: ReplDeps): Promise<void>;
+export declare function makeSink(theme: TuiTheme, terminalColumns: () => number, cwd: string, env: NodeJS.ProcessEnv, ctl: InputControl, plan?: {
+    sdir: string;
+    sid: string;
+}): (event: AgentEvent) => void;
+export declare function gitSummary(command: string): string | null;
+export declare function oneLinePreview(text: string, max: number): string;