@travisennis/acai 0.0.6 → 0.0.8

package/dist/{messages.js → sessions/manager.js}

@@ -1,9 +1,11 @@
 import { randomUUID } from "node:crypto";
 import EventEmitter from "node:events";
-import { readdir, readFile, stat, writeFile } from "node:fs/promises";
+import { mkdir, readdir, readFile, rename, stat, unlink, writeFile, } from "node:fs/promises";
 import { basename, join } from "node:path";
 import { isString } from "@travisennis/stdlib/typeguards";
 import { generateText, } from "ai";
+import { dedent } from "../dedent.js";
+import { logger } from "../logger.js";
 export function createUserMessage(contentItems, prompt) {
     const messageParts = [];
     // Process content items (images and pre-defined texts)
@@ -37,7 +39,7 @@ function createAssistantMessage(content) {
         ],
     };
 }
-export class MessageHistory extends EventEmitter {
+export class SessionManager extends EventEmitter {
     history;
     sessionId;
     modelId;
@@ -45,17 +47,19 @@ export class MessageHistory extends EventEmitter {
     createdAt;
     updatedAt;
     stateDir;
+    contextWindow;
     modelManager;
     tokenTracker;
     constructor({ stateDir, modelManager, tokenTracker, }) {
         super();
         this.history = [];
         this.sessionId = randomUUID();
-        this.modelId = "";
+        this.modelId = modelManager.getModel("repl").modelId;
         this.title = "";
         this.createdAt = new Date();
         this.updatedAt = new Date();
         this.stateDir = stateDir;
+        this.contextWindow = 0;
         this.modelManager = modelManager;
         this.tokenTracker = tokenTracker;
     }
@@ -67,6 +71,9 @@ export class MessageHistory extends EventEmitter {
         this.createdAt = new Date();
         this.updatedAt = new Date();
     }
+    setModelId(modelId) {
+        this.modelId = modelId;
+    }
     validMessage(msg) {
         // Filter out messages with empty content arrays
         if (Array.isArray(msg.content) && msg.content.length === 0) {
@@ -87,8 +94,18 @@ export class MessageHistory extends EventEmitter {
     }
     clear() {
         this.history.length = 0;
+        this.contextWindow = 0;
         this.emit("clear-history");
     }
+    setContextWindow(contextWindow) {
+        if (contextWindow < 0) {
+            throw new Error("Context window cannot be negative");
+        }
+        this.contextWindow = contextWindow;
+    }
+    getContextWindow() {
+        return this.contextWindow;
+    }
     appendUserMessage(msg) {
         const now = new Date();
         const msgObj = isString(msg) ? createUserMessage([], msg) : msg;
@@ -97,7 +114,7 @@ export class MessageHistory extends EventEmitter {
             msgObj.content.length > 0) {
             const textPart = msgObj.content.at(-1);
             if (textPart?.text && textPart.text.trim() !== "") {
-                this.generateTitle(textPart.text);
+                void this.generateTitle(textPart.text);
             }
             this.createdAt = now;
         }
@@ -126,6 +143,14 @@ export class MessageHistory extends EventEmitter {
         const msgHistoryDir = this.stateDir;
         const fileName = `message-history-${this.sessionId}.json`;
         const filePath = join(msgHistoryDir, fileName);
+        const tempFilePath = `${filePath}.tmp`;
+        // Validate data before writing
+        if (!this.sessionId || this.sessionId.trim() === "") {
+            throw new Error("Cannot save: sessionId is empty");
+        }
+        if (!Array.isArray(this.history)) {
+            throw new Error("Cannot save: history is not an array");
+        }
         const project = basename(process.cwd());
         const output = {
             project,
@@ -136,7 +161,35 @@ export class MessageHistory extends EventEmitter {
             updatedAt: this.updatedAt,
             messages: this.history,
         };
-        await writeFile(filePath, JSON.stringify(output, null, 2));
+        try {
+            // Ensure directory exists
+            await mkdir(msgHistoryDir, { recursive: true });
+            // Write to temporary file first
+            await writeFile(tempFilePath, JSON.stringify(output, null, 2));
+            // Atomically rename to final file
+            await rename(tempFilePath, filePath);
+            logger.info(`Message history saved to ${filePath}`);
+        }
+        catch (error) {
+            // Clean up temp file if it exists
+            try {
+                await unlink(tempFilePath);
+            }
+            catch (_cleanupError) {
+                // Ignore cleanup errors
+            }
+            // Check if it's an ENOENT error from rename (temp file doesn't exist)
+            if (error instanceof Error &&
+                "code" in error &&
+                error.code === "ENOENT") {
+                logger.warn(`Temp file missing during save for ${filePath}, write may have been interrupted`);
+            }
+            else {
+                logger.error(error, `Failed to save message history to ${filePath}:`);
+                // Don't throw - just log. This is called from interrupt handlers
+                // and we don't want to crash the program on save failure.
+            }
+        }
     }
     async generateTitle(message) {
         // Skip title generation if message is empty
@@ -144,23 +197,49 @@ export class MessageHistory extends EventEmitter {
             return;
         }
         const app = "title-conversation";
-        const systemPrompt = "You are an assistant who task is to analyze messages to generate a conversation topic that can be used as a conversation title. For each message, generate a 4-7 word title that captures the topic. Return only the title with no other text.\n\nExamples:\nMessage:\nHow do I implement authentication in my Express app?\nTitle: Express Authentication Implementation\n\nMessage:\nCan you help me debug this React component that isn't rendering correctly?\nTitle:React Component Rendering Debug";
+        const systemPrompt = dedent `
+You are an assistant who is tasked to analyze messages to generate a conversation topic that can be used as a conversation title. For each message, generate a short title that captures the topic. Return only the title with no other text.
+
+## Examples:
+
+<example>
+Message:
+How do I implement authentication in my Express app?
+
+Title:
+Express Authentication Implementation
+</example>
+
+<example>
+Message:
+Can you help me debug this React component that isn't rendering correctly?
+
+Title:
+React Component Rendering Debug";
+</example>
+`;
+        let title = "";
         try {
-            const { text, usage } = await generateText({
-                model: this.modelManager.getModel(app),
+            const model = this.modelManager.getModel(app);
+            const result = await generateText({
+                model,
                 system: systemPrompt,
-                maxOutputTokens: 100,
-                prompt: `Request:\n${message}\nTitle:`,
+                prompt: `Message:\n${message}\n\nTitle:`,
             });
-            this.tokenTracker.trackUsage(app, usage);
-            if (text && text.split(" ").length < 10) {
-                this.title = text;
-                this.emit("update-title", this.title);
+            this.tokenTracker.trackUsage(app, result.usage);
+            if (result.text && result.text.length > 0) {
+                title = result.text;
+                this.title = title;
             }
         }
         catch (error) {
-            console.error(error);
+            logger.error(error, "[generateTitle] Failed to generate conversation title:");
         }
+        if (title.length === 0) {
+            this.title =
+                message.slice(0, 50).trim() + (message.length > 50 ? "..." : "");
+        }
+        this.emit("update-title", this.title);
     }
     getFirstUserMessage() {
         const firstUser = this.get().find((msg) => msg.role === "user");
@@ -202,6 +281,22 @@ export class MessageHistory extends EventEmitter {
         }
         return null;
     }
+    // Getter methods for session information
+    getSessionId() {
+        return this.sessionId;
+    }
+    getModelId() {
+        return this.modelId;
+    }
+    getTitle() {
+        return this.title;
+    }
+    getCreatedAt() {
+        return this.createdAt;
+    }
+    getUpdatedAt() {
+        return this.updatedAt;
+    }
     static async load(stateDir, count = 10) {
         try {
             const files = await readdir(stateDir);
@@ -232,7 +327,17 @@ export class MessageHistory extends EventEmitter {
             const fileReadPromises = sortedFiles.map(async (fileName) => {
                 const filePath = join(stateDir, fileName);
                 try {
+                    // Check file stats first to avoid reading empty files
+                    const stats = await stat(filePath);
+                    if (stats.size === 0) {
+                        // Silently skip empty files - they're likely from interrupted saves
+                        return null;
+                    }
                     const content = await readFile(filePath, "utf-8");
+                    // Skip files that only contain whitespace
+                    if (content.trim().length === 0) {
+                        return null;
+                    }
                     const parsed = JSON.parse(content);
                     const result = parsed;
                     // Basic validation - ensure messages array exists
@@ -244,7 +349,12 @@ export class MessageHistory extends EventEmitter {
                     }
                 }
                 catch (error) {
-                    console.error(`Error reading or parsing file ${filePath}:`, error);
+                    // Only log unexpected errors, not empty/malformed JSON files
+                    // which are common from interrupted saves
+                    if (!(error instanceof SyntaxError) ||
+                        !error.message.includes("Unexpected end of JSON input")) {
+                        console.error(`Error reading or parsing file ${filePath}:`, error);
+                    }
                 }
                 return null; // Return null for failed reads/parses
             });

package/dist/skills.d.ts

@@ -0,0 +1,16 @@
+export interface Skill {
+    name: string;
+    description: string;
+    filePath: string;
+    baseDir: string;
+    source: string;
+}
+export interface LoadSkillsFromDirOptions {
+    dir: string;
+    source: string;
+    useColonPath?: boolean;
+}
+export declare function loadSkillsFromDir(options: LoadSkillsFromDirOptions, subdir?: string): Promise<Skill[]>;
+export declare function loadSkills(): Promise<Skill[]>;
+export declare function formatSkillsForPrompt(skills: Skill[]): string;
+//# sourceMappingURL=skills.d.ts.map

package/dist/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../source/skills.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAwOD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,EACjC,MAAM,SAAK,GACV,OAAO,CAAC,KAAK,EAAE,CAAC,CASlB;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAyDnD;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAkC7D"}

package/dist/skills.js

@@ -0,0 +1,233 @@
+import { readdir, readFile, stat } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, dirname, join, resolve } from "node:path";
+import { logger } from "./logger.js";
+import { parseFrontMatter } from "./utils/yaml.js";
+const CONFIG_DIR_NAME = ".acai";
+// Validation functions
+function validateSkillName(name, directoryName) {
+    // Check required field
+    if (!name) {
+        return { valid: false, error: "Name field is required" };
+    }
+    // Check length (1-64 characters)
+    if (name.length < 1 || name.length > 64) {
+        return { valid: false, error: "Name must be 1-64 characters long" };
+    }
+    // Check allowed characters (lowercase letters, numbers, hyphens)
+    if (!/^[a-z0-9-]+$/.test(name)) {
+        return {
+            valid: false,
+            error: "Name can only contain lowercase letters, numbers, and hyphens",
+        };
+    }
+    // Check no leading or trailing hyphens
+    if (name.startsWith("-") || name.endsWith("-")) {
+        return { valid: false, error: "Name cannot start or end with a hyphen" };
+    }
+    // Check no consecutive hyphens
+    if (name.includes("--")) {
+        return { valid: false, error: "Name cannot contain consecutive hyphens" };
+    }
+    // Check matches directory name
+    if (name !== directoryName) {
+        return {
+            valid: false,
+            error: `Name "${name}" must match directory name "${directoryName}"`,
+        };
+    }
+    return { valid: true };
+}
+function validateSkillDescription(description) {
+    // Check required field
+    if (!description) {
+        return { valid: false, error: "Description field is required" };
+    }
+    // Check length (1-1024 characters)
+    if (description.length < 1 || description.length > 1024) {
+        return {
+            valid: false,
+            error: "Description must be 1-1024 characters long",
+        };
+    }
+    return { valid: true };
+}
+function parseFrontmatter(content) {
+    const { data, content: body } = parseFrontMatter(content);
+    // Type cast and validate required fields
+    const name = data["name"];
+    const description = data["description"];
+    // Set default empty values for optional fields
+    const frontmatter = {
+        name: name || "",
+        description: description || "",
+        license: data["license"] || undefined,
+        compatibility: data["compatibility"] || undefined,
+        metadata: data["metadata"] || undefined,
+        "allowed-tools": data["allowed-tools"] || undefined,
+    };
+    return { frontmatter, body };
+}
+async function loadSkillsFromDirInternal(dir, source, mode, useColonPath, subdir = "") {
+    const skills = [];
+    const fullDir = join(dir, subdir);
+    try {
+        const entries = await readdir(fullDir, { withFileTypes: true });
+        for (const entry of entries) {
+            // Skip hidden files and directories
+            if (entry.name.startsWith(".")) {
+                continue;
+            }
+            const entryPath = join(fullDir, entry.name);
+            // Skip symbolic links to avoid infinite recursion
+            try {
+                const stats = await stat(entryPath);
+                if (stats.isSymbolicLink()) {
+                    continue;
+                }
+            }
+            catch {
+                // If we can't stat, skip it
+                continue;
+            }
+            if (entry.isDirectory()) {
+                if (mode === "recursive") {
+                    // Recursively scan subdirectories
+                    const newSubdir = subdir ? join(subdir, entry.name) : entry.name;
+                    const subSkills = await loadSkillsFromDirInternal(dir, source, mode, useColonPath, newSubdir);
+                    skills.push(...subSkills);
+                }
+                else if (mode === "claude") {
+                    // Claude mode: only check immediate subdirectories for SKILL.md
+                    const skillPath = join(entryPath, "SKILL.md");
+                    try {
+                        const content = await readFile(skillPath, "utf8");
+                        const { frontmatter } = parseFrontmatter(content);
+                        // Validate required fields
+                        const nameValidation = validateSkillName(frontmatter.name, entry.name);
+                        if (!nameValidation.valid) {
+                            logger.warn(`Invalid skill name in ${skillPath}: ${nameValidation.error}`);
+                            continue;
+                        }
+                        const descriptionValidation = validateSkillDescription(frontmatter.description);
+                        if (!descriptionValidation.valid) {
+                            logger.warn(`Invalid skill description in ${skillPath}: ${descriptionValidation.error}`);
+                            continue;
+                        }
+                        skills.push({
+                            name: frontmatter.name,
+                            description: frontmatter.description,
+                            filePath: skillPath,
+                            baseDir: entryPath,
+                            source,
+                        });
+                    }
+                    catch (error) {
+                        logger.warn(error, `Failed to load skill from ${skillPath}:`);
+                    }
+                }
+            }
+            else if (entry.isFile() &&
+                entry.name === "SKILL.md" &&
+                mode === "recursive") {
+                // Found a SKILL.md file in recursive mode
+                try {
+                    const content = await readFile(entryPath, "utf8");
+                    const { frontmatter } = parseFrontmatter(content);
+                    // Validate required fields
+                    const nameValidation = validateSkillName(frontmatter.name, basename(dirname(entryPath)));
+                    if (!nameValidation.valid) {
+                        logger.warn(`Invalid skill name in ${entryPath}: ${nameValidation.error}`);
+                        continue;
+                    }
+                    const descriptionValidation = validateSkillDescription(frontmatter.description);
+                    if (!descriptionValidation.valid) {
+                        logger.warn(`Invalid skill description in ${entryPath}: ${descriptionValidation.error}`);
+                        continue;
+                    }
+                    // Base directory is the directory containing the SKILL.md file
+                    const baseDir = subdir ? join(dir, subdir) : dir;
+                    skills.push({
+                        name: frontmatter.name,
+                        description: frontmatter.description,
+                        filePath: entryPath,
+                        baseDir,
+                        source,
+                    });
+                }
+                catch (error) {
+                    logger.warn(error, `Failed to load skill from ${entryPath}:`);
+                }
+            }
+        }
+    }
+    catch (error) {
+        // Directory doesn't exist or can't be read
+        if (error.code !== "ENOENT") {
+            logger.error(error, `Error reading skills directory ${fullDir}:`);
+        }
+    }
+    return skills;
+}
+export async function loadSkillsFromDir(options, subdir = "") {
+    const { dir, source, useColonPath = false } = options;
+    return await loadSkillsFromDirInternal(dir, source, "recursive", useColonPath, subdir);
+}
+export async function loadSkills() {
+    const skillMap = new Map();
+    // Codex: recursive, simple directory name
+    const codexUserDir = join(homedir(), ".codex", "skills");
+    for (const skill of await loadSkillsFromDirInternal(codexUserDir, "codex-user", "recursive", false)) {
+        skillMap.set(skill.name, skill);
+    }
+    // Claude: single level only
+    const claudeUserDir = join(homedir(), ".claude", "skills");
+    for (const skill of await loadSkillsFromDirInternal(claudeUserDir, "claude-user", "claude", false)) {
+        skillMap.set(skill.name, skill);
+    }
+    const claudeProjectDir = resolve(process.cwd(), ".claude", "skills");
+    for (const skill of await loadSkillsFromDirInternal(claudeProjectDir, "claude-project", "claude", false)) {
+        skillMap.set(skill.name, skill);
+    }
+    // acai: recursive, colon-separated path names
+    const globalSkillsDir = join(homedir(), CONFIG_DIR_NAME, "skills");
+    for (const skill of await loadSkillsFromDirInternal(globalSkillsDir, "user", "recursive", true)) {
+        skillMap.set(skill.name, skill);
+    }
+    const projectSkillsDir = resolve(process.cwd(), CONFIG_DIR_NAME, "skills");
+    for (const skill of await loadSkillsFromDirInternal(projectSkillsDir, "project", "recursive", true)) {
+        skillMap.set(skill.name, skill);
+    }
+    return Array.from(skillMap.values());
+}
+export function formatSkillsForPrompt(skills) {
+    if (skills.length === 0) {
+        return "";
+    }
+    const lines = [
+        "\n\n## Skills",
+        "",
+        "<skills_instructions>",
+        "When users ask you to perform tasks, check if any of the available skills below can help complete the task more effectively. Skills provide specialized capabilities and domain knowledge.",
+        "Use the readFile tool to load a skill's file when the task matches its description.",
+        "Skills may contain {baseDir} placeholders - replace them with the skill's base directory path.",
+        "</skills_instructions>",
+        "",
+        "<available_skills>",
+    ];
+    for (const skill of skills) {
+        lines.push("<skill>");
+        lines.push("<name>");
+        lines.push(skill.name);
+        lines.push("</name>");
+        lines.push("<description>");
+        lines.push(skill.description);
+        lines.push("</description>");
+        lines.push("<location>");
+        lines.push(skill.filePath);
+        lines.push("</location>");
+        lines.push("</skill>");
+    }
+    lines.push("</available_skills>");
+    return lines.join("\n");
+}

package/dist/terminal/control.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Terminal Control Module
+ *
+ * Provides functions for controlling terminal behavior and state.
+ */
+export { isAltBackspace, isAltEnter, isAltLeft, isAltRight, isArrowDown, isArrowLeft, isArrowRight, isArrowUp, isBackspace, isCtrlA, isCtrlC, isCtrlD, isCtrlE, isCtrlK, isCtrlL, isCtrlP, isCtrlT, isCtrlU, isCtrlW, isDelete, isEnd, isEnter, isEscape, isHome, isKittyCtrl, isKittyKey, isNavigationKey, isPageDown, isPageUp, isShiftCtrlD, isShiftCtrlO, isShiftCtrlP, isShiftEnter, isShiftTab, isTab, } from "./keys.ts";
+/**
+ * Get the current shell
+ */
+export declare function getShell(): string;
+/**
+ * Check if terminal is interactive
+ */
+export declare function isInteractive(): boolean;
+/**
+ * Send terminal alert/notification
+ */
+export declare function alert(): Promise<void>;
+/**
+ * Clear the terminal screen
+ */
+export declare function clearScreen(): void;
+/**
+ * Clear the terminal screen including scrollback buffer
+ *
+ * Unlike clearScreen, this function:
+ * 1. Clears the entire screen (\x1b[2J)
+ * 2. Clears the scrollback buffer (\x1b[3J)
+ * 3. Moves cursor to home position (\x1b[H)
+ * 4. Returns a Promise that resolves when the write operation completes
+ *
+ * @returns Promise that resolves when the terminal has been cleared
+ */
+export declare function clearTerminal(): Promise<void>;
+/**
+ * Sets the terminal title
+ */
+export declare function setTerminalTitle(title: string): void;
+/**
+ * Get the terminal size (rows and columns)
+ */
+export declare function getTerminalSize(): {
+    rows: number;
+    columns: number;
+};
+/**
+ * Start progress indicator in terminal
+ * Sends terminal escape sequence to show progress animation
+ */
+export declare function startProgress(): void;
+/**
+ * Stop progress indicator in terminal
+ * Sends terminal escape sequence to hide progress animation
+ */
+export declare function stopProgress(): void;
+//# sourceMappingURL=control.d.ts.map

package/dist/terminal/control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../../source/terminal/control.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EACL,cAAc,EACd,UAAU,EACV,SAAS,EACT,UAAU,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,SAAS,EACT,WAAW,EACX,OAAO,EACP,OAAO,EACP,OAAO,EACP,OAAO,EACP,OAAO,EACP,OAAO,EACP,OAAO,EACP,OAAO,EACP,OAAO,EACP,OAAO,EACP,QAAQ,EACR,KAAK,EACL,OAAO,EACP,QAAQ,EACR,MAAM,EACN,WAAW,EACX,UAAU,EACV,eAAe,EACf,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,KAAK,GACN,MAAM,WAAW,CAAC;AAEnB;;GAEG;AACH,wBAAgB,QAAQ,WAEvB;AAED;;GAEG;AACH,wBAAgB,aAAa,YAE5B;AAED;;GAEG;AACH,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAkB3C;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAM7C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAMpD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAgBnE;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}

package/dist/terminal/control.js

@@ -0,0 +1,111 @@
+/**
+ * Terminal Control Module
+ *
+ * Provides functions for controlling terminal behavior and state.
+ */
+import { config } from "../config.js";
+import { logger } from "../logger.js";
+// Re-export key functions from keys.ts for convenient imports
+export { isAltBackspace, isAltEnter, isAltLeft, isAltRight, isArrowDown, isArrowLeft, isArrowRight, isArrowUp, isBackspace, isCtrlA, isCtrlC, isCtrlD, isCtrlE, isCtrlK, isCtrlL, isCtrlP, isCtrlT, isCtrlU, isCtrlW, isDelete, isEnd, isEnter, isEscape, isHome, isKittyCtrl, isKittyKey, isNavigationKey, isPageDown, isPageUp, isShiftCtrlD, isShiftCtrlO, isShiftCtrlP, isShiftEnter, isShiftTab, isTab, } from "./keys.js";
+/**
+ * Get the current shell
+ */
+export function getShell() {
+    return process.env["ZSH_VERSION"] ? "zsh" : process.env["SHELL"] || "bash";
+}
+/**
+ * Check if terminal is interactive
+ */
+export function isInteractive() {
+    return Boolean(process.stdout.isTTY && process.stdin.isTTY);
+}
+/**
+ * Send terminal alert/notification
+ */
+export async function alert() {
+    if (!(await config.getConfig()).notify) {
+        return;
+    }
+    const t = "acai";
+    const b = "";
+    try {
+        process.stdout.write("\x07");
+        const esc = "\u001b";
+        const bel = "\u0007";
+        const safe = (s) => s.replaceAll("\u0007", "").replaceAll("\u001b", "");
+        const payload = `${esc}]777;notify;${safe(t)};${safe(b)}${bel}`;
+        process.stdout.write(payload);
+    }
+    catch (err) {
+        logger.warn({ err }, "Failed to emit alert");
+    }
+}
+/**
+ * Clear the terminal screen
+ */
+export function clearScreen() {
+    // Clear screen and move cursor to top-left
+    process.stdout.write("\x1b[2J\x1b[0f");
+}
+/**
+ * Clear the terminal screen including scrollback buffer
+ *
+ * Unlike clearScreen, this function:
+ * 1. Clears the entire screen (\x1b[2J)
+ * 2. Clears the scrollback buffer (\x1b[3J)
+ * 3. Moves cursor to home position (\x1b[H)
+ * 4. Returns a Promise that resolves when the write operation completes
+ *
+ * @returns Promise that resolves when the terminal has been cleared
+ */
+export function clearTerminal() {
+    return new Promise((resolve) => {
+        process.stdout.write("\x1b[2J\x1b[3J\x1b[H", () => {
+            resolve();
+        });
+    });
+}
+/**
+ * Sets the terminal title
+ */
+export function setTerminalTitle(title) {
+    if (process.platform === "win32") {
+        process.title = title ? `✳✳ ${title}` : title;
+    }
+    else {
+        process.stdout.write(`\x1b]0;${title ? `✳✳ ${title}` : ""}\x07`);
+    }
+}
+/**
+ * Get the terminal size (rows and columns)
+ */
+export function getTerminalSize() {
+    // Default to a reasonable size if we can't determine the actual size
+    const defaultSize = { rows: 24, columns: 80 };
+    try {
+        if (process.stdout.isTTY) {
+            return {
+                rows: process.stdout.rows || defaultSize.rows,
+                columns: process.stdout.columns || defaultSize.columns,
+            };
+        }
+    }
+    catch (_error) {
+        // Ignore errors
+    }
+    return defaultSize;
+}
+/**
+ * Start progress indicator in terminal
+ * Sends terminal escape sequence to show progress animation
+ */
+export function startProgress() {
+    process.stdout.write("\u001b]9;4;3;0\u0007");
+}
+/**
+ * Stop progress indicator in terminal
+ * Sends terminal escape sequence to hide progress animation
+ */
+export function stopProgress() {
+    process.stdout.write("\u001b]9;4;0;0\u0007");
+}

package/dist/terminal/default-theme.d.ts

@@ -2,5 +2,5 @@ import type { Theme } from "./highlight/theme.ts";
 /**
  * The default theme. It is possible to override just individual keys.
  */
-export declare const DEFAULT_THEME: Theme;
+export declare const DEFAULT_HIGHLIGHT_THEME: Theme;
 //# sourceMappingURL=default-theme.d.ts.map

package/dist/terminal/default-theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"default-theme.d.ts","sourceRoot":"","sources":["../../source/terminal/default-theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AASlD;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,KAqN3B,CAAC"}
+{"version":3,"file":"default-theme.d.ts","sourceRoot":"","sources":["../../source/terminal/default-theme.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAGlD;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,KAqNrC,CAAC"}