bernard-agent 0.8.1 → 0.9.0

package/dist/memory.js.map

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

package/dist/menu.d.ts

@@ -0,0 +1,97 @@
+import * as readline from 'node:readline';
+/** Pinned-region id used by the interactive menu. Exported for tests. */
+export declare const MENU_REGION_ID = "menu";
+/** A single selectable item in a menu. */
+export interface MenuItem {
+    /** Text shown next to the number. */
+    label: string;
+    /** If true, appends " (active)" marker. */
+    active?: boolean;
+    /** Optional annotation shown after the label (e.g. "= 4096 (default)"). */
+    annotation?: string;
+    /** Optional second line shown below the item, indented further. */
+    description?: string;
+    /** Opaque payload returned to the caller on selection. */
+    value?: unknown;
+}
+/** A section divider inserted between items in the numbered list. */
+export interface MenuSection {
+    type: 'section';
+    /** Header text printed before the next batch of items. */
+    title: string;
+}
+/** Union of what can appear in the entries array. */
+export type MenuEntry = MenuItem | MenuSection;
+/** Options for selectFromMenu(). */
+export interface MenuOptions {
+    /** Prompt string override, e.g. "Select option". Default: "Select". */
+    promptLabel?: string;
+    /** Optional heading rendered inside the ephemeral menu block. */
+    title?: string;
+    /**
+     * Optional header lines pinned above the title. Rendered inside the menu's
+     * own pinned region so they update atomically with the menu, never leaking
+     * into scrollback as the menu repaints.
+     */
+    headerLines?: string[];
+}
+/** Options for promptValue(). */
+export interface ValuePromptOptions {
+    /** Prompt label, e.g. "New value for max-tokens". */
+    label: string;
+    /**
+     * Optional header lines printed above the prompt. Use to provide context
+     * (e.g. an ask_user progress strip).
+     */
+    headerLines?: string[];
+}
+/** Result from selectFromMenu(). */
+export type SelectResult = {
+    cancelled: true;
+} | {
+    cancelled: false;
+    index: number;
+    item: MenuItem;
+};
+/** Result from promptValue(). */
+export type ValueResult = {
+    cancelled: true;
+} | {
+    cancelled: false;
+    raw: string;
+};
+/** Count the selectable (non-section) items in an entries array. */
+export declare function countMenuItems(entries: MenuEntry[]): number;
+/** Get the Nth (0-based) selectable item, skipping sections. */
+export declare function getMenuItem(entries: MenuEntry[], index: number): MenuItem | undefined;
+/**
+ * A single line of the fallback numbered-list rendering, tagged with whether
+ * it should be emitted via `printDim` (description rows) or `printInfo`.
+ */
+export interface LegacyLine {
+    text: string;
+    dim?: boolean;
+}
+export declare function buildLegacyLines(entries: MenuEntry[]): LegacyLine[];
+/**
+ * Build the lines array for the ephemeral menu block.
+ * The highlighted item gets a `>` cursor and accent styling; its description
+ * (if present) is shown below it. Other items show a plain numbered label.
+ *
+ * Exported for direct testing; production callers go through selectFromMenu.
+ */
+export declare function renderMenuLines(entries: MenuEntry[], highlightItemIndex: number, options: MenuOptions | undefined): string[];
+/**
+ * Prompt the user to select from a menu.
+ *
+ * In a TTY without `BERNARD_PLAIN_MENU=1`, renders as an ephemeral arrow-key
+ * menu above the prompt. Otherwise falls back to a numbered list + rl.question.
+ * Returns cancelled on Esc/Ctrl-C/q, on external signal abort, or on empty /
+ * out-of-range input in fallback mode.
+ */
+export declare function selectFromMenu(rl: readline.Interface, entries: MenuEntry[], options?: MenuOptions, signal?: AbortSignal): Promise<SelectResult>;
+/**
+ * Prompt the user to enter a free-form string value.
+ * Returns cancelled if input is empty or signal aborted.
+ */
+export declare function promptValue(rl: readline.Interface, options: ValuePromptOptions, signal?: AbortSignal): Promise<ValueResult>;

package/dist/menu.js

@@ -0,0 +1,338 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MENU_REGION_ID = void 0;
+exports.countMenuItems = countMenuItems;
+exports.getMenuItem = getMenuItem;
+exports.buildLegacyLines = buildLegacyLines;
+exports.renderMenuLines = renderMenuLines;
+exports.selectFromMenu = selectFromMenu;
+exports.promptValue = promptValue;
+const readline = __importStar(require("node:readline"));
+const output_js_1 = require("./output.js");
+const theme_js_1 = require("./theme.js");
+/** Pinned-region id used by the interactive menu. Exported for tests. */
+exports.MENU_REGION_ID = 'menu';
+/** Pinned-region id used by promptValue() to display optional header lines. */
+const PROMPT_HEADER_REGION_ID = 'prompt-header';
+const DIGIT_KEY_RE = /^[1-9]$/;
+/** Type guard for MenuSection entries. */
+function isSection(entry) {
+    return 'type' in entry && entry.type === 'section';
+}
+/** Count the selectable (non-section) items in an entries array. */
+function countMenuItems(entries) {
+    let count = 0;
+    for (const e of entries) {
+        if (!isSection(e))
+            count++;
+    }
+    return count;
+}
+/** Get the Nth (0-based) selectable item, skipping sections. */
+function getMenuItem(entries, index) {
+    let n = 0;
+    for (const e of entries) {
+        if (!isSection(e)) {
+            if (n === index)
+                return e;
+            n++;
+        }
+    }
+    return undefined;
+}
+/** True when we should skip the interactive renderer and use the legacy numbered-list path. */
+function useFallback() {
+    const flag = process.env.BERNARD_PLAIN_MENU;
+    const forcePlain = flag === 'true' || flag === '1';
+    // setRawMode throws on non-TTY stdin, so both streams must be TTY.
+    return !process.stdout.isTTY || !process.stdin.isTTY || forcePlain;
+}
+function buildLegacyLines(entries) {
+    const out = [];
+    let n = 1;
+    for (const entry of entries) {
+        if (isSection(entry)) {
+            out.push({ text: `\n  ${entry.title}` });
+        }
+        else {
+            const activeMarker = entry.active ? ' (active)' : '';
+            const annotation = entry.annotation ? ` ${entry.annotation}` : '';
+            out.push({ text: `    ${n}. ${entry.label}${activeMarker}${annotation}` });
+            if (entry.description) {
+                out.push({ text: `       ${entry.description}`, dim: true });
+            }
+            n++;
+        }
+    }
+    return out;
+}
+/**
+ * Wrap rl.question in a Promise with optional AbortSignal support.
+ * Returns null on abort or if the signal was already aborted.
+ */
+function questionWithSignal(rl, prompt, signal) {
+    return new Promise((resolve) => {
+        if (signal?.aborted) {
+            resolve(null);
+            return;
+        }
+        let settled = false;
+        const settle = (val) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(val);
+        };
+        const onAbort = () => settle(null);
+        signal?.addEventListener('abort', onAbort, { once: true });
+        if (signal) {
+            rl.question(prompt, { signal }, (answer) => {
+                signal.removeEventListener('abort', onAbort);
+                settle(answer);
+            });
+        }
+        else {
+            rl.question(prompt, (answer) => settle(answer));
+        }
+    });
+}
+/** Legacy numbered-list + rl.question selection flow. */
+async function legacySelect(rl, entries, options, signal) {
+    if (options?.headerLines && options.headerLines.length > 0) {
+        for (const headerLine of options.headerLines)
+            (0, output_js_1.printInfo)(headerLine);
+        (0, output_js_1.printInfo)('');
+    }
+    if (options?.title) {
+        (0, output_js_1.printInfo)(`\n  ${options.title}\n`);
+    }
+    for (const line of buildLegacyLines(entries)) {
+        if (line.dim)
+            (0, output_js_1.printDim)(line.text);
+        else
+            (0, output_js_1.printInfo)(line.text);
+    }
+    (0, output_js_1.printInfo)('');
+    const items = entries.filter((e) => !isSection(e));
+    const label = options?.promptLabel ?? 'Select';
+    const { ansi } = (0, theme_js_1.getTheme)();
+    const promptStr = `  ${ansi.prompt}${label} [1-${items.length}]${ansi.reset} (Enter or Esc to cancel): `;
+    const answer = await questionWithSignal(rl, promptStr, signal);
+    if (answer === null || answer.trim() === '') {
+        (0, output_js_1.printInfo)('  Cancelled.');
+        return { cancelled: true };
+    }
+    const num = parseInt(answer.trim(), 10);
+    if (num >= 1 && num <= items.length) {
+        return { cancelled: false, index: num - 1, item: items[num - 1] };
+    }
+    (0, output_js_1.printInfo)('  Cancelled.');
+    return { cancelled: true };
+}
+/**
+ * Build the lines array for the ephemeral menu block.
+ * The highlighted item gets a `>` cursor and accent styling; its description
+ * (if present) is shown below it. Other items show a plain numbered label.
+ *
+ * Exported for direct testing; production callers go through selectFromMenu.
+ */
+function renderMenuLines(entries, highlightItemIndex, options) {
+    const { accent, accentBold, dim, muted } = (0, theme_js_1.getTheme)();
+    const lines = [];
+    if (options?.headerLines && options.headerLines.length > 0) {
+        for (const headerLine of options.headerLines)
+            lines.push(headerLine);
+        lines.push('');
+    }
+    if (options?.title) {
+        lines.push(`  ${accentBold(options.title)}`);
+        lines.push('');
+    }
+    let itemIndex = 0;
+    for (const entry of entries) {
+        if (isSection(entry)) {
+            lines.push(`  ${muted(entry.title)}`);
+            continue;
+        }
+        const n = itemIndex + 1;
+        const activeMarker = entry.active ? ' (active)' : '';
+        const annotation = entry.annotation ? ` ${entry.annotation}` : '';
+        const labelText = `${n}. ${entry.label}${activeMarker}${annotation}`;
+        const isHighlighted = itemIndex === highlightItemIndex;
+        if (isHighlighted) {
+            lines.push(`  ${accent('>')} ${accentBold(labelText)}`);
+            if (entry.description) {
+                lines.push(`       ${dim(entry.description)}`);
+            }
+        }
+        else {
+            lines.push(`    ${labelText}`);
+        }
+        itemIndex++;
+    }
+    lines.push('');
+    lines.push(`  ${dim('\u2191/\u2193 move \u00B7 Enter select \u00B7 Esc cancel')}`);
+    return lines;
+}
+/** Interactive arrow-key menu rendered via the pinned region. */
+async function interactiveSelect(rl, entries, options, signal) {
+    if (signal?.aborted) {
+        return { cancelled: true };
+    }
+    const itemCount = countMenuItems(entries);
+    if (itemCount === 0) {
+        return { cancelled: true };
+    }
+    readline.emitKeypressEvents(process.stdin);
+    const wasRaw = process.stdin.isRaw ?? false;
+    process.stdin.setRawMode(true);
+    rl.pause();
+    // rl.pause() pauses the underlying stdin; resume so 'keypress' events fire.
+    process.stdin.resume();
+    let highlight = 0;
+    const repaint = () => {
+        (0, output_js_1.setPinnedRegion)(exports.MENU_REGION_ID, renderMenuLines(entries, highlight, options));
+    };
+    return new Promise((resolve) => {
+        let settled = false;
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            process.stdin.removeListener('keypress', onKeypress);
+            signal?.removeEventListener('abort', onAbort);
+            try {
+                process.stdin.setRawMode(wasRaw);
+            }
+            catch {
+                // stdin may have been detached; ignore.
+            }
+            (0, output_js_1.clearPinnedRegion)(exports.MENU_REGION_ID);
+            rl.resume();
+            if (!result.cancelled) {
+                (0, output_js_1.printInfo)(`  Selected: ${result.item.label}`);
+            }
+            resolve(result);
+        };
+        const commit = (idx) => {
+            const item = getMenuItem(entries, idx);
+            if (!item) {
+                finish({ cancelled: true });
+                return;
+            }
+            finish({ cancelled: false, index: idx, item });
+        };
+        const onKeypress = (_str, key) => {
+            if (!key)
+                return;
+            if (key.ctrl && key.name === 'c') {
+                finish({ cancelled: true });
+                return;
+            }
+            if (key.name === 'escape' || key.name === 'q') {
+                finish({ cancelled: true });
+                return;
+            }
+            if (key.name === 'return' || key.name === 'enter') {
+                commit(highlight);
+                return;
+            }
+            if (key.name === 'up') {
+                if (highlight > 0) {
+                    highlight--;
+                    repaint();
+                }
+                return;
+            }
+            if (key.name === 'down') {
+                if (highlight < itemCount - 1) {
+                    highlight++;
+                    repaint();
+                }
+                return;
+            }
+            if (key.name && DIGIT_KEY_RE.test(key.name)) {
+                const n = parseInt(key.name, 10) - 1;
+                if (n < itemCount) {
+                    commit(n);
+                }
+            }
+        };
+        const onAbort = () => finish({ cancelled: true });
+        signal?.addEventListener('abort', onAbort, { once: true });
+        process.stdin.on('keypress', onKeypress);
+        repaint();
+    });
+}
+/**
+ * Prompt the user to select from a menu.
+ *
+ * In a TTY without `BERNARD_PLAIN_MENU=1`, renders as an ephemeral arrow-key
+ * menu above the prompt. Otherwise falls back to a numbered list + rl.question.
+ * Returns cancelled on Esc/Ctrl-C/q, on external signal abort, or on empty /
+ * out-of-range input in fallback mode.
+ */
+async function selectFromMenu(rl, entries, options, signal) {
+    if (useFallback()) {
+        return legacySelect(rl, entries, options, signal);
+    }
+    return interactiveSelect(rl, entries, options, signal);
+}
+/**
+ * Prompt the user to enter a free-form string value.
+ * Returns cancelled if input is empty or signal aborted.
+ */
+async function promptValue(rl, options, signal) {
+    const { ansi } = (0, theme_js_1.getTheme)();
+    const promptStr = `  ${ansi.prompt}${options.label}${ansi.reset} (Enter or Esc to cancel): `;
+    const hasHeader = options.headerLines && options.headerLines.length > 0;
+    if (hasHeader) {
+        (0, output_js_1.setPinnedRegion)(PROMPT_HEADER_REGION_ID, [...options.headerLines, '']);
+    }
+    try {
+        const answer = await questionWithSignal(rl, promptStr, signal);
+        if (answer === null || answer.trim() === '') {
+            (0, output_js_1.printInfo)('  Cancelled.');
+            return { cancelled: true };
+        }
+        return { cancelled: false, raw: answer.trim() };
+    }
+    finally {
+        if (hasHeader)
+            (0, output_js_1.clearPinnedRegion)(PROMPT_HEADER_REGION_ID);
+    }
+}
+//# sourceMappingURL=menu.js.map

package/dist/menu.js.map

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

package/dist/os-info.d.ts

@@ -0,0 +1,22 @@
+/** Minimal OS fingerprint used to tailor tool-wrapper prompts and examples. */
+export interface OsInfo {
+    /** Node's `process.platform` — 'darwin' | 'linux' | 'win32' | ... */
+    platform: NodeJS.Platform;
+    /** 'x64', 'arm64', etc. */
+    arch: string;
+    /** Default shell path, best-effort from $SHELL or a platform fallback. */
+    shell: string;
+    /** Human-readable OS label (e.g. "macOS 14.3", "Ubuntu 22.04", "Windows 10"). */
+    osRelease?: string;
+}
+/** Returns a cached OS fingerprint for the current process. */
+export declare function getOsInfo(): OsInfo;
+/** Clears the cached value. Used by tests. */
+export declare function _resetOsInfoCache(): void;
+/**
+ * Returns a short markdown block describing the host OS, suitable for injecting
+ * into a tool-wrapper specialist's system prompt. The block is a few lines so
+ * specialists can tailor commands (brew vs apt, gfind vs find, etc.) without
+ * re-detecting.
+ */
+export declare function osPromptBlock(): string;

package/dist/os-info.js

@@ -0,0 +1,111 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOsInfo = getOsInfo;
+exports._resetOsInfoCache = _resetOsInfoCache;
+exports.osPromptBlock = osPromptBlock;
+const os = __importStar(require("node:os"));
+const fs = __importStar(require("node:fs"));
+const node_child_process_1 = require("node:child_process");
+let cached;
+function detectOsRelease(platform) {
+    try {
+        if (platform === 'linux' && fs.existsSync('/etc/os-release')) {
+            const contents = fs.readFileSync('/etc/os-release', 'utf-8');
+            const pretty = /^PRETTY_NAME="?([^"\n]+)"?/m.exec(contents);
+            if (pretty)
+                return pretty[1];
+            const name = /^NAME="?([^"\n]+)"?/m.exec(contents);
+            if (name)
+                return name[1];
+        }
+        if (platform === 'darwin') {
+            const raw = (0, node_child_process_1.execSync)('sw_vers', { encoding: 'utf-8', timeout: 1000 });
+            const product = /ProductName:\s*(.+)/i.exec(raw)?.[1]?.trim() ?? 'macOS';
+            const version = /ProductVersion:\s*(.+)/i.exec(raw)?.[1]?.trim() ?? '';
+            return `${product} ${version}`.trim();
+        }
+    }
+    catch {
+        /* best-effort — fall through */
+    }
+    return `${os.type()} ${os.release()}`;
+}
+function detectShell(platform) {
+    const envShell = process.env.SHELL;
+    if (envShell)
+        return envShell;
+    if (platform === 'win32')
+        return process.env.ComSpec ?? 'cmd.exe';
+    return '/bin/sh';
+}
+/** Returns a cached OS fingerprint for the current process. */
+function getOsInfo() {
+    if (cached)
+        return cached;
+    const platform = os.platform();
+    const info = {
+        platform,
+        arch: os.arch(),
+        shell: detectShell(platform),
+        osRelease: detectOsRelease(platform),
+    };
+    cached = info;
+    return info;
+}
+/** Clears the cached value. Used by tests. */
+function _resetOsInfoCache() {
+    cached = undefined;
+}
+/**
+ * Returns a short markdown block describing the host OS, suitable for injecting
+ * into a tool-wrapper specialist's system prompt. The block is a few lines so
+ * specialists can tailor commands (brew vs apt, gfind vs find, etc.) without
+ * re-detecting.
+ */
+function osPromptBlock() {
+    const info = getOsInfo();
+    const lines = [
+        '## Host OS',
+        `- Platform: ${info.platform}`,
+        `- Architecture: ${info.arch}`,
+        `- Shell: ${info.shell}`,
+    ];
+    if (info.osRelease)
+        lines.push(`- Release: ${info.osRelease}`);
+    lines.push('', 'Tailor commands to this platform. On macOS, BSD userland (e.g. `find` without `-printf`) applies unless GNU tools are installed as `g*` prefixes. On Linux, assume GNU userland. On Windows, prefer PowerShell-compatible syntax.');
+    return lines.join('\n');
+}
+//# sourceMappingURL=os-info.js.map

package/dist/os-info.js.map

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

package/dist/output.d.ts

@@ -1,4 +1,24 @@
 import type { CoreMessage } from 'ai';
+import type { Step } from './plan-store.js';
+/**
+ * Enables or disables printing of tool-call arguments and tool result bodies.
+ * Tool names and call lines (▶ toolName) are always shown regardless.
+ */
+export declare function setToolDetailsVisible(enabled: boolean): void;
+/**
+ * Number of visual terminal rows a single logical line will occupy, given
+ * the current column width. Strips ANSI CSI escapes so zero-width control
+ * codes don't inflate the count. Exported for direct testing.
+ */
+export declare function visualRowCount(line: string, columns: number): number;
+/**
+ * Pins or updates a named region of lines above the prompt.
+ * Passing an empty array removes the region. No-op when the new content
+ * matches what is already pinned under that id.
+ */
+export declare function setPinnedRegion(id: string, lines: string[]): void;
+/** Removes a named pinned region. */
+export declare function clearPinnedRegion(id: string): void;
 /** Cumulative token-usage statistics displayed alongside the thinking spinner. */
 export interface SpinnerStats {
     /** Epoch timestamp (ms) when the current agent step began. */
@@ -37,7 +57,7 @@ export declare function startSpinner(message?: string | (() => string)): void;
 /** Stops the spinner, clears its line, and restores the cursor. */
 export declare function stopSpinner(): void;
 /** Prints the branded welcome banner with provider, model, and optional version info. */
-export declare function printWelcome(provider: string, model: string, version?: string): void;
+export declare function printWelcome(provider: string, model: string, version?: string, baseURL?: string): void;
 /** Prints an assistant response, stopping any active spinner first. */
 export declare function printAssistantText(text: string, prefix?: string): void;
 /**
@@ -57,6 +77,8 @@ export declare function printToolResult(toolName: string, result: unknown, prefi
 export declare function printError(message: string): void;
 /** Prints an informational message in the theme's muted color. */
 export declare function printInfo(message: string): void;
+/** Prints a dimmed, de-emphasized line — used for secondary text like menu descriptions. */
+export declare function printDim(message: string): void;
 /** Prints a warning message in the theme's warning color. */
 export declare function printWarning(message: string): void;
 /**
@@ -66,6 +88,18 @@ export declare function printWarning(message: string): void;
  * Tool-role messages are skipped.
  */
 export declare function printConversationReplay(messages: CoreMessage[]): void;
+/**
+ * Pins the current plan as a bulleted, status-decorated list above the prompt.
+ *
+ * Uses the generic pinned-region mechanism keyed by `'plan'`, so the block
+ * stays anchored while other chat-flow output scrolls above it.
+ * Passing no steps removes the pinned plan.
+ */
+export declare function printPlan(steps: Step[], prefix?: string): void;
+/** Prints a visible thought block, styled as secondary (dim italic) so it reads below the main response. */
+export declare function printThought(thought: string, prefix?: string): void;
+/** Prints a visible post-action self-evaluation, styled to mirror printThought. */
+export declare function printEvaluation(evaluation: string, prefix?: string): void;
 /** Prints a colored top-border line when a sub-agent begins executing a task. */
 export declare function printSubAgentStart(id: number, task: string): void;
 /** Prints a colored bottom-border line when a sub-agent finishes. */