@travisennis/acai 0.0.7 → 0.0.9

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

@@ -4,7 +4,8 @@ import { mkdir, readdir, readFile, rename, stat, unlink, writeFile, } from "node
 import { basename, join } from "node:path";
 import { isString } from "@travisennis/stdlib/typeguards";
 import { generateText, } from "ai";
-import { logger } from "./logger.js";
+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)
@@ -38,7 +39,7 @@ function createAssistantMessage(content) {
         ],
     };
 }
-export class MessageHistory extends EventEmitter {
+export class SessionManager extends EventEmitter {
     history;
     sessionId;
     modelId;
@@ -53,7 +54,7 @@ export class MessageHistory extends EventEmitter {
         super();
         this.history = [];
         this.sessionId = randomUUID();
-        this.modelId = "";
+        this.modelId = modelManager.getModel("repl").modelId;
         this.title = "";
         this.createdAt = new Date();
         this.updatedAt = new Date();
@@ -70,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) {
@@ -110,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;
         }
@@ -193,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");
@@ -251,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);
@@ -327,6 +373,8 @@ export class MessageHistory extends EventEmitter {
     }
     // Method to restore state from a SavedMessageHistory object
     restore(savedHistory) {
+        this.sessionId = savedHistory.sessionId;
+        this.modelId = savedHistory.modelId;
         this.title = savedHistory.title;
         // Ensure dates are Date objects, though load should handle this
         this.createdAt =

package/dist/skills.d.ts

@@ -1,7 +1,3 @@
-export interface SkillFrontmatter {
-    name?: string;
-    description: string;
-}
 export interface Skill {
     name: string;
     description: string;

package/dist/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../source/skills.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,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;AA4KD,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,CAqB7D"}
+{"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

@@ -1,40 +1,71 @@
 import { readdir, readFile, stat } from "node:fs/promises";
 import { homedir } from "node:os";
-import { join, resolve, sep } from "node:path";
+import { basename, dirname, join, resolve } from "node:path";
 import { logger } from "./logger.js";
+import { parseFrontMatter } from "./utils/yaml.js";
 const CONFIG_DIR_NAME = ".acai";
-function stripQuotes(str) {
-    if ((str.startsWith('"') && str.endsWith('"')) ||
-        (str.startsWith("'") && str.endsWith("'"))) {
-        return str.slice(1, -1);
+// Validation functions
+function validateSkillName(name, directoryName) {
+    // Check required field
+    if (!name) {
+        return { valid: false, error: "Name field is required" };
     }
-    return str;
+    // 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 parseFrontmatter(content) {
-    const frontmatter = { description: "" };
-    const normalizedContent = content.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
-    if (!normalizedContent.startsWith("---")) {
-        return { frontmatter, body: normalizedContent };
-    }
-    const endIndex = normalizedContent.indexOf("\n---", 3);
-    if (endIndex === -1) {
-        return { frontmatter, body: normalizedContent };
-    }
-    const frontmatterBlock = normalizedContent.slice(4, endIndex);
-    const body = normalizedContent.slice(endIndex + 4).trim();
-    for (const line of frontmatterBlock.split("\n")) {
-        const match = line.match(/^(\w+):\s*(.*)$/);
-        if (match) {
-            const key = match[1];
-            const value = stripQuotes(match[2].trim());
-            if (key === "name") {
-                frontmatter.name = value;
-            }
-            else if (key === "description") {
-                frontmatter.description = value;
-            }
-        }
+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 = "") {
@@ -72,12 +103,19 @@ async function loadSkillsFromDirInternal(dir, source, mode, useColonPath, subdir
                     try {
                         const content = await readFile(skillPath, "utf8");
                         const { frontmatter } = parseFrontmatter(content);
-                        if (!frontmatter.description) {
+                        // 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;
                         }
-                        const skillName = frontmatter.name || entry.name;
                         skills.push({
-                            name: skillName,
+                            name: frontmatter.name,
                             description: frontmatter.description,
                             filePath: skillPath,
                             baseDir: entryPath,
@@ -96,31 +134,21 @@ async function loadSkillsFromDirInternal(dir, source, mode, useColonPath, subdir
                 try {
                     const content = await readFile(entryPath, "utf8");
                     const { frontmatter } = parseFrontmatter(content);
-                    if (!frontmatter.description) {
+                    // Validate required fields
+                    const nameValidation = validateSkillName(frontmatter.name, basename(dirname(entryPath)));
+                    if (!nameValidation.valid) {
+                        logger.warn(`Invalid skill name in ${entryPath}: ${nameValidation.error}`);
                         continue;
                     }
-                    // Determine skill name
-                    let skillName;
-                    if (frontmatter.name) {
-                        skillName = frontmatter.name;
-                    }
-                    else if (useColonPath && subdir) {
-                        // Use colon-separated path for subdirectories
-                        skillName = subdir.split(sep).join(":");
-                    }
-                    else if (subdir) {
-                        // Use the directory name
-                        const dirParts = subdir.split(sep);
-                        skillName = dirParts[dirParts.length - 1];
-                    }
-                    else {
-                        // Shouldn't happen in practice, but fallback
-                        skillName = "unnamed";
+                    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: skillName,
+                        name: frontmatter.name,
                         description: frontmatter.description,
                         filePath: entryPath,
                         baseDir,
@@ -161,7 +189,7 @@ export async function loadSkills() {
     for (const skill of await loadSkillsFromDirInternal(claudeProjectDir, "claude-project", "claude", false)) {
         skillMap.set(skill.name, skill);
     }
-    // Pi: recursive, colon-separated path names
+    // 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);
@@ -177,15 +205,28 @@ export function formatSkillsForPrompt(skills) {
         return "";
     }
     const lines = [
-        "\n\n<available_skills>",
-        "The following skills provide specialized instructions for specific tasks.",
+        "\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.\n",
+        "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.name}: ${skill.description}`);
-        lines.push(`  File: ${skill.filePath}`);
-        lines.push(`  Base directory: ${skill.baseDir}`);
+        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/stdin.d.ts

@@ -0,0 +1,9 @@
+export declare const STDIN_SOFT_LIMIT: number;
+export declare const STDIN_HARD_LIMIT: number;
+export interface StdinResult {
+    content: string | null;
+    sizeBytes: number;
+    wasPiped: boolean;
+}
+export declare function readStdinWithLimits(): Promise<StdinResult>;
+//# sourceMappingURL=stdin.d.ts.map

package/dist/stdin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin.d.ts","sourceRoot":"","sources":["../source/stdin.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,QAAY,CAAC;AAC1C,eAAO,MAAM,gBAAgB,QAAa,CAAC;AAE3C,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,WAAW,CAAC,CA6BhE"}

package/dist/stdin.js

@@ -0,0 +1,26 @@
+import { text } from "node:stream/consumers";
+export const STDIN_SOFT_LIMIT = 50 * 1024; // 50KB
+export const STDIN_HARD_LIMIT = 200 * 1024; // 200KB
+export async function readStdinWithLimits() {
+    if (process.stdin.isTTY) {
+        return { content: null, sizeBytes: 0, wasPiped: false };
+    }
+    try {
+        const content = await text(process.stdin);
+        const sizeBytes = Buffer.byteLength(content, "utf8");
+        if (sizeBytes > STDIN_HARD_LIMIT) {
+            const sizeKb = Math.round(sizeBytes / 1024);
+            console.error(`Error: Input exceeds ${STDIN_HARD_LIMIT / 1024}KB size limit (${sizeKb}KB provided).`);
+            process.exit(1);
+        }
+        if (sizeBytes > STDIN_SOFT_LIMIT) {
+            const sizeKb = Math.round(sizeBytes / 1024);
+            console.error(`Warning: Input is ${sizeKb}KB. Large inputs may increase latency and costs.`);
+        }
+        return { content, sizeBytes, wasPiped: true };
+    }
+    catch (error) {
+        console.error(`Error reading stdin: ${error.message}`);
+        return { content: null, sizeBytes: 0, wasPiped: true };
+    }
+}

package/dist/terminal/control.d.ts

@@ -3,6 +3,7 @@
  *
  * Provides functions for controlling terminal behavior and state.
  */
+export { isAltBackspace, isAltEnter, isAltLeft, isAltRight, isArrowDown, isArrowLeft, isArrowRight, isArrowUp, isBackspace, isCtrlA, isCtrlC, isCtrlD, isCtrlE, isCtrlG, isCtrlK, isCtrlL, isCtrlP, isCtrlT, isCtrlU, isCtrlW, isCtrlZ, isDelete, isEnd, isEnter, isEscape, isHome, isKittyCtrl, isKittyKey, isNavigationKey, isPageDown, isPageUp, isShiftCtrlD, isShiftCtrlO, isShiftCtrlP, isShiftEnter, isShiftTab, isTab, } from "./keys.ts";
 /**
  * Get the current shell
  */

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

@@ -1 +1 @@
-{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../../source/terminal/control.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;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"}
+{"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,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,CAYpD;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,CAQpC;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAQnC"}

package/dist/terminal/control.js

@@ -5,6 +5,8 @@
  */
 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, isCtrlG, isCtrlK, isCtrlL, isCtrlP, isCtrlT, isCtrlU, isCtrlW, isCtrlZ, isDelete, isEnd, isEnter, isEscape, isHome, isKittyCtrl, isKittyKey, isNavigationKey, isPageDown, isPageUp, isShiftCtrlD, isShiftCtrlO, isShiftCtrlP, isShiftEnter, isShiftTab, isTab, } from "./keys.js";
 /**
  * Get the current shell
  */
@@ -67,11 +69,18 @@ export function clearTerminal() {
  * Sets the terminal title
  */
 export function setTerminalTitle(title) {
-    if (process.platform === "win32") {
-        process.title = title ? `✳✳ ${title}` : title;
+    try {
+        if (process.platform === "win32") {
+            process.title = title ? `✳✳ ${title}` : title;
+        }
+        else {
+            if (process.stdout.writable) {
+                process.stdout.write(`\x1b]0;${title ? `✳✳ ${title}` : ""}\x07`);
+            }
+        }
     }
-    else {
-        process.stdout.write(`\x1b]0;${title ? `✳✳ ${title}` : ""}\x07`);
+    catch (err) {
+        logger.warn({ err }, "Failed to set terminal title");
     }
 }
 /**
@@ -98,12 +107,26 @@ export function getTerminalSize() {
  * Sends terminal escape sequence to show progress animation
  */
 export function startProgress() {
-    process.stdout.write("\u001b]9;4;3;0\u0007");
+    try {
+        if (process.stdout.writable) {
+            process.stdout.write("\u001b]9;4;3;0\u0007");
+        }
+    }
+    catch {
+        // Ignore write errors (e.g., EPIPE)
+    }
 }
 /**
  * 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");
+    try {
+        if (process.stdout.writable) {
+            process.stdout.write("\u001b]9;4;0;0\u0007");
+        }
+    }
+    catch {
+        // Ignore write errors (e.g., EPIPE)
+    }
 }

package/dist/terminal/formatting.d.ts

@@ -1,4 +1,3 @@
-export { clearScreen, clearTerminal, getTerminalSize, setTerminalTitle, startProgress, stopProgress, } from "./control.ts";
 /**
  * Create a horizontal rule
  */
@@ -7,7 +6,7 @@ export declare function hr(width: number): string;
  * Word wrap text to the specified width
  */
 export declare function wordWrap(text: string, width: number): string;
-export declare const link: (text: string, url: string) => string;
+export declare const link: (text: string, url: string) => string | null;
 export declare const image: (data: string | Buffer, options?: {
     width?: number | string;
     height?: number | string;

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

@@ -1 +1 @@
-{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../source/terminal/formatting.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,WAAW,EACX,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,wBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,UAE/B;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI5D;AA2CD,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,EAAE,KAAK,MAAM,WAO7C,CAAC;AAEF,eAAO,MAAM,KAAK,GAChB,MAAM,MAAM,GAAG,MAAM,EACrB,UAAS;IACP,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC1B,WAiBP,CAAC;AAEF;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7C"}
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../source/terminal/formatting.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,wBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,UAE/B;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI5D;AA2CD,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,EAAE,KAAK,MAAM,kBAO7C,CAAC;AAEF,eAAO,MAAM,KAAK,GAChB,MAAM,MAAM,GAAG,MAAM,EACrB,UAAS;IACP,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC1B,WAiBP,CAAC;AAEF;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/terminal/formatting.js

@@ -5,7 +5,6 @@
  */
 import style from "./style.js";
 import { supportsHyperlinks } from "./supports-hyperlinks.js";
-export { clearScreen, clearTerminal, getTerminalSize, setTerminalTitle, startProgress, stopProgress, } from "./control.js";
 /**
  * Create a horizontal rule
  */
@@ -60,7 +59,7 @@ export const link = (text, url) => {
     if (supportsHyperlinks.stdout) {
         return [OSC, "8", SEP, SEP, url, BEL, text, OSC, "8", SEP, SEP, BEL].join("");
     }
-    return `[${text}](${url})`;
+    return null;
 };
 export const image = (data, options = {}) => {
     let returnValue = `${OSC}1337;File=inline=1`;