@falkenslab/agent-kit 0.10.2 → 0.12.0

package/dist/tui/ink/PromptInput.js

@@ -8,8 +8,9 @@ import { isMouseReport } from "./fullscreen.js";
 import { CursorContext } from "./terminalCursor.js";
 import { isFocusReport } from "./terminalStatus.js";
 import { matchingFiles, mentionAt } from "./fileMentions.js";
-import { continueLine, createPasteRegistry, cursorLine, deleteBack, deleteForward, deleteWordBack, insert, isBlockPaste, isForwardDelete, killToLineEnd, moveLine, normalizePaste, searchHistory, toLineEnd, toLineStart, wordLeft, wordRight, } from "./promptEditing.js";
+import { continueLine, createPasteRegistry, cursorLine, deleteBack, deleteForward, deleteWordBack, insert, isBlockPaste, isForwardDelete, killToLineEnd, moveLine, normalizePaste, PASTE_TOKEN_AFTER, PASTE_TOKEN_BEFORE, searchHistory, toLineEnd, toLineStart, wordLeft, wordRight, } from "./promptEditing.js";
 import * as ui from "../ui.js";
+import { t } from "../../core/messages/index.js";
 const MAX_SUGGESTIONS = 6;
 /** Commands (names without "/") a partial "/name" line could still become. */
 export function matchingCommands(value, commands) {
@@ -44,19 +45,8 @@ export function visibleWindow(length, cursor, room) {
     const start = Math.min(Math.max(0, cursor + 1 - span), Math.max(0, length + 1 - span));
     return [start, Math.min(length, start + span)];
 }
-/** The shortcuts panel, opened with "?" on an empty prompt. */
-export const SHORTCUTS = [
-    "Enter send  ·  \\ + Enter or Ctrl+J new line  ·  Tab complete or take the suggestion",
-    "↑/↓ history  ·  Ctrl+R search history  ·  ↑ on an empty prompt edits the last queued message",
-    "Ctrl+W delete word  ·  Ctrl+K to line end  ·  Ctrl+U clear  ·  Ctrl+←/→ move by word",
-    "@ mention a file  ·  /copy copy the last reply  ·  Shift+Tab switch mode  ·  Ctrl+O unfold tool calls",
-    "Esc interrupt  ·  Ctrl+C interrupt or exit  ·  PgUp/PgDn or wheel scroll  ·  Ctrl+End bottom",
-    "Drag to select, right-click to copy (full screen)",
-];
 // A paste can reach us in several chunks; pieces this close together extend the same one.
 const PASTE_CHUNK_MS = 100;
-const PASTE_TOKEN_BEFORE = /\[Pasted text #\d+ \+\d+ lines?\]$/;
-const PASTE_TOKEN_AFTER = /^\[Pasted text #\d+ \+\d+ lines?\]/;
 /**
  * The chat's prompt: history (↑/↓), "/command" completion and suggestions (Tab), pasted
  * blocks folded into a token, multi-line input (`\` + Enter or Ctrl+J), word and line
@@ -310,7 +300,7 @@ export function PromptInput({ label, inset = 0, suggestion, history, commands, o
     const width = liveWidth(stdout.columns) - inset;
     const labelWidth = stringWidth(stripAnsi(label));
     const room = width - labelWidth;
-    const ghost = suggestion ? `${suggestion}  (tab)` : null;
+    const ghost = suggestion ? `${suggestion}  (${t().suggestionKey})` : null;
     // Suggestions give way on a short terminal: the live area must stay shorter than it.
     const maxSuggestions = Math.min(MAX_SUGGESTIONS, Math.max(0, (stdout.rows || 24) - 10));
     const mention = mentionAt(value, cursor);
@@ -326,7 +316,7 @@ export function PromptInput({ label, inset = 0, suggestion, history, commands, o
     let rows;
     let cursorColumn;
     if (search) {
-        const prefix = `(reverse-i-search)'${search.query}': `;
+        const prefix = t().reverseSearch(search.query);
         const match = search.index >= 0 ? history[search.index] : "";
         cursorColumn = Math.min(stringWidth(prefix) - 3, width - 1);
         rows = [
@@ -352,5 +342,5 @@ export function PromptInput({ label, inset = 0, suggestion, history, commands, o
             cursorController.setTarget({ node: cursorLineRef.current, column: cursorColumn });
     });
     useLayoutEffect(() => () => cursorController?.setTarget(null), [cursorController]);
-    return (_jsxs(Box, { flexDirection: "column", children: [rows, suggestions.map((item) => (_jsx(Text, { children: ui.dim(fitWidth(`  ${item}`, width)) }, item))), showHelp ? SHORTCUTS.map((line) => _jsx(Text, { children: ui.dim(fitWidth(`  ${line}`, width)) }, line)) : null] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [rows, suggestions.map((item) => (_jsx(Text, { children: ui.dim(fitWidth(`  ${item}`, width)) }, item))), showHelp ? t().shortcuts.map((line) => _jsx(Text, { children: ui.dim(fitWidth(`  ${line}`, width)) }, line)) : null] }));
 }

package/dist/tui/ink/SessionView.js

@@ -8,13 +8,14 @@ import { framePosition } from "./terminalCursor.js";
 import { isFocusReport } from "./terminalStatus.js";
 import { fitWidth, stripAnsi } from "./lineBuffer.js";
 import * as ui from "../ui.js";
+import { t } from "../../core/messages/index.js";
 // Numbered as in the Claude Code CLI's permission prompt; the digits and y/n/q answer too.
-const DECISION_OPTIONS = [
-    { label: "1. Yes", value: "y" },
-    { label: "2. No", value: "n" },
-    { label: "3. Stop", value: "q" },
+const decisionOptions = () => [
+    { label: `1. ${t().yes}`, value: "y" },
+    { label: `2. ${t().no}`, value: "n" },
+    { label: `3. ${t().stop}`, value: "q" },
 ];
-const MANUAL_OPTIONS = [{ label: "1. Done, continue", value: "continue" }];
+const manualOptions = () => [{ label: `1. ${t().doneContinue}`, value: "continue" }];
 const DECISION_KEYS = { "1": "y", "2": "n", "3": "q", y: "y", n: "n", q: "q" };
 const ACCENT_HEX = "#d77757";
 /**
@@ -25,7 +26,7 @@ const ACCENT_HEX = "#d77757";
 export function previewLines(lines, terminalRows) {
     const all = lines.flatMap((line) => line.split("\n"));
     const max = Math.max(3, (terminalRows || 24) - 12);
-    return all.length <= max ? all : [...all.slice(0, max - 1), ui.dim(`… (${all.length - max + 1} more lines)`)];
+    return all.length <= max ? all : [...all.slice(0, max - 1), ui.dim(t().moreLines(all.length - max + 1))];
 }
 function CheckpointPanel({ checkpoint, renderApproval }) {
     const decision = checkpoint.kind === "decision";
@@ -38,17 +39,17 @@ function CheckpointPanel({ checkpoint, renderApproval }) {
     });
     const { prompt } = checkpoint;
     const { stdout } = useStdout();
-    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: ACCENT_HEX, paddingX: 1, children: [renderApproval ? (renderApproval(prompt)) : (_jsxs(_Fragment, { children: [_jsx(Text, { bold: true, children: prompt.title }), previewLines(prompt.lines, stdout.rows).map((line, index) => (_jsx(Text, { children: line }, index))), !decision && prompt.question ? _jsx(Text, { dimColor: true, children: prompt.question }) : null] })), decision ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { children: "Do you want to proceed?" }) })) : null, _jsx(Box, { marginTop: decision ? 0 : 1, children: _jsx(Select, { options: decision ? DECISION_OPTIONS : MANUAL_OPTIONS, onChange: (value) => checkpoint.answer(decision ? value : "") }, checkpoint.id) })] }));
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: ACCENT_HEX, paddingX: 1, children: [renderApproval ? (renderApproval(prompt)) : (_jsxs(_Fragment, { children: [_jsx(Text, { bold: true, children: prompt.title }), previewLines(prompt.lines, stdout.rows).map((line, index) => (_jsx(Text, { children: line }, index))), !decision && prompt.question ? _jsx(Text, { dimColor: true, children: prompt.question }) : null] })), decision ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { children: t().proceed }) })) : null, _jsx(Box, { marginTop: decision ? 0 : 1, children: _jsx(Select, { options: decision ? decisionOptions() : manualOptions(), onChange: (value) => checkpoint.answer(decision ? value : "") }, checkpoint.id) })] }));
 }
 function formatTokens(count) {
     return count >= 1000 ? `${(count / 1000).toFixed(1)}k` : String(count);
 }
 export function statusText(mode, turns, usage, extra = {}) {
     const parts = [
-        ...(mode ? [`⏵⏵ ${mode}${extra.modeSwitchable ? " (shift+tab)" : ""}`] : []),
-        `${turns} ${turns === 1 ? "turn" : "turns"}`,
-        ...(usage ? [`${formatTokens(usage.inputTokens)} in / ${formatTokens(usage.outputTokens)} out`] : []),
-        ...(extra.contextPercent != null ? [`context ${Math.round(extra.contextPercent)}%`] : []),
+        ...(mode ? [`⏵⏵ ${t().mode(mode)}${extra.modeSwitchable ? ` (${t().switchModeKey})` : ""}`] : []),
+        t().turns(turns),
+        ...(usage ? [t().tokens(formatTokens(usage.inputTokens), formatTokens(usage.outputTokens))] : []),
+        ...(extra.contextPercent != null ? [t().context(Math.round(extra.contextPercent))] : []),
     ];
     return parts.join(" · ");
 }
@@ -63,7 +64,7 @@ function Working({ label, startedAt, width }) {
     }, []);
     const seconds = startedAt === null ? 0 : Math.floor((Date.now() - startedAt) / 1000);
     const glyph = WORKING_GLYPHS[tick % WORKING_GLYPHS.length];
-    return _jsx(Text, { children: fitWidth(`${ui.working(`${glyph} ${label}`)} ${ui.dim(`(${seconds}s · esc to interrupt)`)}`, width) });
+    return _jsx(Text, { children: fitWidth(`${ui.working(`${glyph} ${label}`)} ${ui.dim(`(${seconds}s · ${t().escToInterrupt})`)}`, width) });
 }
 /** Line in progress, checkpoint panel or spinner, the input, and the status bar. */
 function LiveArea({ session, checkpoint, renderApproval, mode, width, statusExtra, modeSwitchable, children }) {
@@ -74,7 +75,7 @@ function LiveArea({ session, checkpoint, renderApproval, mode, width, statusExtr
     return (_jsxs(Box, { flexDirection: "column", flexShrink: 0, width: width, marginTop: session.liveGap ? 1 : 0, children: [stripAnsi(session.live) ? _jsx(Text, { children: session.live }) : null, checkpoint ? (_jsx(CheckpointPanel, { checkpoint: checkpoint, renderApproval: renderApproval })) : session.busy ? (
             // Always one blank line above the spinner: from this margin, or from the live area's
             // own when a separator is pending and nothing is written above the spinner yet.
-            _jsxs(Box, { flexDirection: "column", marginTop: stripAnsi(session.live) || !session.liveGap ? 1 : 0, children: [_jsx(Working, { label: session.activity ?? "Thinking…", startedAt: session.turnStartedAt, width: width }), session.subagentActivity ? _jsx(Text, { dimColor: true, children: fitWidth(`  ↳ ${session.subagentActivity}`, width) }) : null] })) : null, checkpoint ? null : children, _jsx(Text, { children: fitWidth(status, width) })] }));
+            _jsxs(Box, { flexDirection: "column", marginTop: stripAnsi(session.live) || !session.liveGap ? 1 : 0, children: [_jsx(Working, { label: session.activity ?? t().thinking, startedAt: session.turnStartedAt, width: width }), session.subagentActivity ? _jsx(Text, { dimColor: true, children: fitWidth(`  ↳ ${session.subagentActivity}`, width) }) : null] })) : null, checkpoint ? null : children, _jsx(Text, { children: fitWidth(status, width) })] }));
 }
 /** A history line for the inline view: the human's line as a bar, a tool group unfolded with Ctrl+O. */
 function inlineItem(item, expanded, width) {
@@ -184,7 +185,7 @@ function FullscreenSession({ session, checkpoint, renderApproval, mode, header,
                 setSelection(null);
                 if (text && onCopy) {
                     onCopy(text);
-                    setCopied(`copied ${text.length} ${text.length === 1 ? "character" : "characters"}`);
+                    setCopied(t().copiedCharacters(text.length));
                 }
             }
         }
@@ -205,7 +206,7 @@ function FullscreenSession({ session, checkpoint, renderApproval, mode, header,
             setAnchor(null); // typing
     });
     const below = rowsBelow(anchor, total);
-    const statusExtra = [anchor === null ? null : `↓ ${below} more ${below === 1 ? "line" : "lines"} (Ctrl+End)`, copied]
+    const statusExtra = [anchor === null ? null : t().linesBelow(below), copied]
         .filter(Boolean)
         .join(" · ");
     return (_jsxs(Box, { flexDirection: "column", width: columns - 1, height: rows, children: [header && header.length > 0 ? (_jsx(Box, { flexDirection: "column", flexShrink: 0, marginBottom: 1, children: header.map((line, i) => (_jsx(Text, { wrap: "truncate-end", children: line || " " }, i))) })) : null, _jsx(Box, { ref: historyRef, flexDirection: "column", flexGrow: 1, flexShrink: 1, overflow: "hidden", justifyContent: "flex-end", children: wrapped.rows.slice(start, end).map((row, i) => (_jsx(Text, { wrap: "truncate-end", children: highlightRow(row, selection, start + i) || " " }, start + i))) }), _jsx(LiveArea, { session: session, checkpoint: checkpoint, renderApproval: renderApproval, mode: mode, width: width, statusExtra: statusExtra || undefined, modeSwitchable: modeSwitchable, children: children })] }));

package/dist/tui/ink/inkInteraction.js

@@ -1,9 +1,6 @@
 import * as ui from "../ui.js";
-const OUTCOMES = {
-    y: ui.success("✔ Approved"),
-    n: ui.warn("✘ Rejected"),
-    q: ui.error("■ Stopped"),
-};
+import { t } from "../../core/messages/index.js";
+const outcome = (answer) => ({ y: ui.success(t().approved), n: ui.warn(t().rejected), q: ui.error(t().stopped) })[answer];
 /**
  * An `InteractionPort` for the Ink views: each checkpoint waits in a queue (the step gate
  * can fire for several tool calls at once) until the panel answers it, or until the
@@ -37,13 +34,13 @@ export function createInkInteraction(note) {
                 answer(value) {
                     if (!remove(checkpoint))
                         return;
-                    record(prompt, kind === "decision" ? (OUTCOMES[value] ?? value) : ui.success("✔ Done"));
+                    record(prompt, kind === "decision" ? (outcome(value) ?? value) : ui.success(t().done));
                     resolve(value);
                 },
             };
             signal.addEventListener("abort", () => {
                 if (remove(checkpoint))
-                    record(prompt, ui.dim("(answered through the response file)"));
+                    record(prompt, ui.dim(t().answeredByFile));
             }, { once: true });
             queue = [...queue, checkpoint];
             emit();

package/dist/tui/ink/progressView.d.ts

@@ -11,6 +11,12 @@ export interface ProgressViewOptions extends Omit<ConsoleRendererOptions, "outpu
     mode?: Mode;
     /** Use the plain console renderer even on a TTY. */
     plain?: boolean;
+    /**
+     * The language of the kit's texts ("en", "es", "fr", "de"). `--language=<code>` on the
+     * command line wins; without either, the one `buildSessionOptions()` chose from
+     * `config.language`, or else the system's.
+     */
+    language?: string;
 }
 export interface ProgressView extends ConsoleRenderer {
     /** Removes the live area and restores the previous interaction port; await it before printing anything else. */

package/dist/tui/ink/progressView.js

@@ -7,6 +7,7 @@ import { createConsoleRenderer } from "../consoleRenderer.js";
 import { createInkInteraction } from "./inkInteraction.js";
 import { createSessionModel, liveWidth } from "./sessionModel.js";
 import { SessionView } from "./SessionView.js";
+import { applyLanguage } from "../language.js";
 function ProgressApp({ model, interaction, renderApproval, mode, closed }) {
     const checkpoint = useSyncExternalStore(interaction.subscribe, interaction.getSnapshot);
     // Only a panel reads the keyboard (and so puts stdin in raw mode, where Ctrl+C no longer
@@ -29,6 +30,7 @@ function ProgressApp({ model, interaction, renderApproval, mode, closed }) {
  * Without a TTY or with `plain`, it is `createConsoleRenderer()` with a no-op `close()`.
  */
 export function createProgressView(options = {}) {
+    applyLanguage(options.language);
     if (options.plain || !stdin.isTTY || !stdout.isTTY) {
         const renderer = createConsoleRenderer(options);
         return Object.assign(renderer, { close: async () => { } });

package/dist/tui/ink/promptEditing.d.ts

@@ -1,8 +1,3 @@
-/**
- * Pure editing operations on the prompt's text and cursor (a UTF-16 index into `value`),
- * so PromptInput.tsx only maps keys to them. The value may hold line breaks ("\n"): a
- * multi-line prompt.
- */
 export interface EditState {
     value: string;
     cursor: number;
@@ -51,6 +46,8 @@ export interface PasteRegistry {
     /** `value` with every token replaced by its text. */
     expand(value: string): string;
 }
+export declare const PASTE_TOKEN_BEFORE: RegExp;
+export declare const PASTE_TOKEN_AFTER: RegExp;
 /** Normalizes a pasted chunk's line breaks (terminals send "\r" or "\r\n"). */
 export declare function normalizePaste(text: string): string;
 /** A paste worth folding into a token: more than one line. */

package/dist/tui/ink/promptEditing.js

@@ -1,3 +1,9 @@
+/**
+ * Pure editing operations on the prompt's text and cursor (a UTF-16 index into `value`),
+ * so PromptInput.tsx only maps keys to them. The value may hold line breaks ("\n"): a
+ * multi-line prompt.
+ */
+import { t } from "../../core/messages/index.js";
 export function insert({ value, cursor }, text) {
     return { value: value.slice(0, cursor) + text + value.slice(cursor), cursor: cursor + text.length };
 }
@@ -91,10 +97,12 @@ export function continueLine(state) {
         return null;
     return insert(deleteBack(state), "\n");
 }
-const PASTE_TOKEN = /\[Pasted text #(\d+) \+\d+ lines?\]/g;
+// A paste token in any language ("[Pasted text #1 +2 lines]", "[Texto pegado #1 +2 líneas]"...).
+const PASTE_TOKEN = /\[[^\]\n#]+#(\d+) \+\d+ [^\]\n]+\]/g;
+export const PASTE_TOKEN_BEFORE = /\[[^\]\n#]+#\d+ \+\d+ [^\]\n]+\]$/;
+export const PASTE_TOKEN_AFTER = /^\[[^\]\n#]+#\d+ \+\d+ [^\]\n]+\]/;
 function pasteToken(id, text) {
-    const extra = text.split("\n").length - 1;
-    return `[Pasted text #${id} +${extra} ${extra === 1 ? "line" : "lines"}]`;
+    return t().pastedText(id, text.split("\n").length - 1);
 }
 /** Normalizes a pasted chunk's line breaks (terminals send "\r" or "\r\n"). */
 export function normalizePaste(text) {

package/dist/tui/ink/runChatInk.d.ts

@@ -2,6 +2,7 @@ import type { Options } from "@anthropic-ai/claude-agent-sdk";
 import type { Mode } from "../../core/agentSpec.js";
 import { type ModeControl } from "../../core/session.js";
 import { type ChatTuiOptions } from "../chatTui.js";
+import { type SessionOpener } from "../runs.js";
 import { type RenderApproval } from "./SessionView.js";
 import type { ToolPhrase } from "./toolGroup.js";
 import { type HeaderInfo } from "./header.js";
@@ -46,7 +47,8 @@ export interface InkChatOptions extends ChatTuiOptions {
     /**
      * The session's mode control (`buildSessionOptions()` returns it): the status bar shows the
      * current mode, and Shift+Tab switches between the modes it allows ("guided" and
-     * "interactive"; an autonomous session can't switch).
+     * "interactive"; an autonomous session can't switch). With a session opener, the one it
+     * returns is used instead.
      */
     modeControl?: ModeControl;
     /**
@@ -55,6 +57,16 @@ export interface InkChatOptions extends ChatTuiOptions {
      */
     firstPromptSuggestion?: string;
 }
+/** A choice asked in place of the prompt (the /resume list). */
+export interface ChatPicker {
+    title: string;
+    options: {
+        label: string;
+        value: string;
+    }[];
+    /** Settles it with the chosen value, or null if cancelled. */
+    resolve(value: string | null): void;
+}
 export interface ChatInputSnapshot {
     /** The chat loop is waiting for a line (no turn in flight). */
     prompting: boolean;
@@ -68,6 +80,8 @@ export interface ChatInputSnapshot {
     files: string[];
     /** The current mode, when a mode control is given. */
     mode: Mode | null;
+    /** A choice shown in place of the prompt, if any. */
+    picker: ChatPicker | null;
     closed: boolean;
 }
 /**
@@ -85,6 +99,11 @@ export declare function createChatInput(): {
     setSuggestion: (suggestion: string | null) => void;
     setFiles: (files: string[]) => void;
     setMode: (mode: Mode | null) => void;
+    /** Shows a choice in place of the prompt; resolves with the value chosen, or null if cancelled. */
+    pick(title: string, options: {
+        label: string;
+        value: string;
+    }[]): Promise<string | null>;
     /** Takes the last queued line back out of the queue (to edit it in the prompt), or null. */
     unqueueLast(): string | null;
     close: () => void;
@@ -98,6 +117,10 @@ export declare function createChatInput(): {
  *
  * With `fullscreen` it takes the whole terminal instead (see `InkChatOptions.fullscreen`).
  *
+ * Given a session opener instead of options, and `runsDir`, each run keeps its conversation
+ * in its own folder and can be resumed: `--continue` on the command line starts with the
+ * latest, and `/resume` picks one (see `ChatTuiOptions.runsDir`).
+ *
  * Without a TTY (piped, background) or with `plain`, it is `runChatTui()` unchanged.
  */
-export declare function runChatInk(options: Options, tuiOptions?: InkChatOptions): Promise<void>;
+export declare function runChatInk(options: Options | SessionOpener, tuiOptions?: InkChatOptions): Promise<void>;