@within-7/minto 0.1.7 → 0.2.0

package/dist/core/tools/executor.js

@@ -0,0 +1,143 @@
+class ToolExecutor {
+  permissionEngine;
+  constructor(permissionEngine) {
+    this.permissionEngine = permissionEngine;
+  }
+  /**
+   * Set the permission engine
+   */
+  setPermissionEngine(engine) {
+    this.permissionEngine = engine;
+  }
+  /**
+   * Execute a tool
+   */
+  async *execute(tool, input, context, options = {}) {
+    const startTime = Date.now();
+    try {
+      if (!options.skipValidation) {
+        const validationResult = this.validateInput(tool, input, context);
+        if (!validationResult.result) {
+          yield {
+            type: "error",
+            error: new Error(
+              validationResult.message || "Input validation failed"
+            )
+          };
+          return;
+        }
+      }
+      if (!options.skipPermissionCheck && this.permissionEngine) {
+        const permissionResult = await this.checkPermission(
+          tool,
+          input,
+          context,
+          options.permissionContext
+        );
+        if (!permissionResult.allowed) {
+          yield {
+            type: "error",
+            error: new Error(permissionResult.reason || "Permission denied")
+          };
+          return;
+        }
+        if (permissionResult.promptUser) {
+          yield {
+            type: "result",
+            resultForAssistant: permissionResult.message || "Permission required"
+          };
+          return;
+        }
+      }
+      const generator = tool.call(input, context);
+      if (options.timeout) {
+        const timeoutPromise = new Promise((_, reject) => {
+          setTimeout(
+            () => reject(
+              new Error(
+                `Tool execution timed out after ${options.timeout}ms`
+              )
+            ),
+            options.timeout
+          );
+        });
+        for await (const result of generator) {
+          if (Date.now() - startTime > options.timeout) {
+            yield {
+              type: "error",
+              error: new Error(
+                `Tool execution timed out after ${options.timeout}ms`
+              )
+            };
+            return;
+          }
+          yield result;
+        }
+      } else {
+        for await (const result of generator) {
+          yield result;
+        }
+      }
+    } catch (error) {
+      yield {
+        type: "error",
+        error: error instanceof Error ? error : new Error(String(error))
+      };
+    }
+  }
+  /**
+   * Validate tool input
+   */
+  validateInput(tool, input, context) {
+    const schemaResult = tool.inputSchema.safeParse(input);
+    if (!schemaResult.success) {
+      return {
+        result: false,
+        message: `Input validation failed: ${schemaResult.error.message}`
+      };
+    }
+    if (tool.validateInput) {
+      const customResult = tool.validateInput(input, context);
+      if (customResult instanceof Promise) {
+        return { result: true };
+      }
+      return customResult;
+    }
+    return { result: true };
+  }
+  /**
+   * Check tool permissions
+   */
+  async checkPermission(tool, input, context, extra) {
+    if (!this.permissionEngine) {
+      return { allowed: true };
+    }
+    const permissionContext = {
+      tool,
+      input,
+      toolUseContext: context,
+      allowedTools: context.options?.allowedTools || [],
+      safeMode: context.options?.safeMode,
+      planMode: context.options?.planMode,
+      agentId: context.options?.agentId,
+      ...extra
+    };
+    return this.permissionEngine.checkPermission(permissionContext);
+  }
+}
+let globalExecutor = null;
+function getToolExecutor() {
+  if (!globalExecutor) {
+    globalExecutor = new ToolExecutor();
+  }
+  return globalExecutor;
+}
+function resetToolExecutor() {
+  globalExecutor = null;
+}
+export {
+  ToolExecutor,
+  getToolExecutor,
+  resetToolExecutor
+};
+//# sourceMappingURL=executor.js.map

package/dist/core/tools/executor.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/tools/executor.ts"],
+  "sourcesContent": ["/**\n * Tool Executor\n *\n * Handles tool execution with validation, permission checking, and error handling.\n */\n\nimport type {\n  RegisterableTool,\n  ToolExecutionContext,\n  ToolExecutionResult,\n} from './types'\nimport type { PermissionEngine } from '../permissions/engine/permissionEngine'\nimport type { PermissionContext } from '../permissions/engine/types'\n\n/**\n * Execution options\n */\nexport interface ExecutionOptions {\n  /** Skip permission check */\n  skipPermissionCheck?: boolean\n\n  /** Skip input validation */\n  skipValidation?: boolean\n\n  /** Timeout in milliseconds */\n  timeout?: number\n\n  /** Custom permission context data */\n  permissionContext?: Partial<PermissionContext>\n}\n\n/**\n * Tool Executor\n *\n * Executes tools with proper validation and permission checking.\n */\nexport class ToolExecutor {\n  private permissionEngine?: PermissionEngine\n\n  constructor(permissionEngine?: PermissionEngine) {\n    this.permissionEngine = permissionEngine\n  }\n\n  /**\n   * Set the permission engine\n   */\n  setPermissionEngine(engine: PermissionEngine): void {\n    this.permissionEngine = engine\n  }\n\n  /**\n   * Execute a tool\n   */\n  async *execute<TInput, TOutput>(\n    tool: RegisterableTool<TInput, TOutput>,\n    input: TInput,\n    context: ToolExecutionContext,\n    options: ExecutionOptions = {},\n  ): AsyncGenerator<ToolExecutionResult<TOutput>> {\n    const startTime = Date.now()\n\n    try {\n      // Step 1: Validate input\n      if (!options.skipValidation) {\n        const validationResult = this.validateInput(tool, input, context)\n        if (!validationResult.result) {\n          yield {\n            type: 'error',\n            error: new Error(\n              validationResult.message || 'Input validation failed',\n            ),\n          }\n          return\n        }\n      }\n\n      // Step 2: Check permissions\n      if (!options.skipPermissionCheck && this.permissionEngine) {\n        const permissionResult = await this.checkPermission(\n          tool,\n          input as Record<string, unknown>,\n          context,\n          options.permissionContext,\n        )\n\n        if (!permissionResult.allowed) {\n          yield {\n            type: 'error',\n            error: new Error(permissionResult.reason || 'Permission denied'),\n          }\n          return\n        }\n\n        // Handle prompting user case\n        if (permissionResult.promptUser) {\n          yield {\n            type: 'result',\n            resultForAssistant:\n              permissionResult.message || 'Permission required',\n          }\n          return\n        }\n      }\n\n      // Step 3: Execute tool\n      const generator = tool.call(input, context)\n\n      // Step 4: Handle timeout if specified\n      if (options.timeout) {\n        const timeoutPromise = new Promise<never>((_, reject) => {\n          setTimeout(\n            () =>\n              reject(\n                new Error(\n                  `Tool execution timed out after ${options.timeout}ms`,\n                ),\n              ),\n            options.timeout,\n          )\n        })\n\n        // Yield results with timeout checking\n        for await (const result of generator) {\n          // Check if we've exceeded timeout\n          if (Date.now() - startTime > options.timeout) {\n            yield {\n              type: 'error',\n              error: new Error(\n                `Tool execution timed out after ${options.timeout}ms`,\n              ),\n            }\n            return\n          }\n          yield result\n        }\n      } else {\n        // No timeout, just yield results\n        for await (const result of generator) {\n          yield result\n        }\n      }\n    } catch (error) {\n      yield {\n        type: 'error',\n        error: error instanceof Error ? error : new Error(String(error)),\n      }\n    }\n  }\n\n  /**\n   * Validate tool input\n   */\n  private validateInput<TInput>(\n    tool: RegisterableTool<TInput>,\n    input: TInput,\n    context: ToolExecutionContext,\n  ): { result: boolean; message?: string } {\n    // Schema validation\n    const schemaResult = tool.inputSchema.safeParse(input)\n    if (!schemaResult.success) {\n      return {\n        result: false,\n        message: `Input validation failed: ${schemaResult.error.message}`,\n      }\n    }\n\n    // Custom validation\n    if (tool.validateInput) {\n      const customResult = tool.validateInput(input, context)\n      if (customResult instanceof Promise) {\n        // For sync executor, we can't await here\n        // This should be handled by execute() method\n        return { result: true }\n      }\n      return customResult\n    }\n\n    return { result: true }\n  }\n\n  /**\n   * Check tool permissions\n   */\n  private async checkPermission(\n    tool: RegisterableTool,\n    input: Record<string, unknown>,\n    context: ToolExecutionContext,\n    extra?: Partial<PermissionContext>,\n  ): Promise<{\n    allowed: boolean\n    reason?: string\n    message?: string\n    promptUser?: boolean\n  }> {\n    if (!this.permissionEngine) {\n      return { allowed: true }\n    }\n\n    const permissionContext: PermissionContext = {\n      tool: tool as any,\n      input,\n      toolUseContext: context as any,\n      allowedTools: (context.options?.allowedTools as string[]) || [],\n      safeMode: context.options?.safeMode,\n      planMode: context.options?.planMode,\n      agentId: context.options?.agentId,\n      ...extra,\n    }\n\n    return this.permissionEngine.checkPermission(permissionContext)\n  }\n}\n\n// Global singleton instance\nlet globalExecutor: ToolExecutor | null = null\n\n/**\n * Get the global tool executor instance\n */\nexport function getToolExecutor(): ToolExecutor {\n  if (!globalExecutor) {\n    globalExecutor = new ToolExecutor()\n  }\n  return globalExecutor\n}\n\n/**\n * Reset the global tool executor (for testing)\n */\nexport function resetToolExecutor(): void {\n  globalExecutor = null\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/core/tools/index.js

@@ -0,0 +1,15 @@
+import { ToolRegistry, getToolRegistry, resetToolRegistry } from "./registry.js";
+import {
+  ToolExecutor,
+  getToolExecutor,
+  resetToolExecutor
+} from "./executor.js";
+export {
+  ToolExecutor,
+  ToolRegistry,
+  getToolExecutor,
+  getToolRegistry,
+  resetToolExecutor,
+  resetToolRegistry
+};
+//# sourceMappingURL=index.js.map

package/dist/core/tools/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/tools/index.ts"],
+  "sourcesContent": ["/**\n * Core Tools Module\n *\n * Tool registry, executor, and type definitions.\n */\n\n// Types\nexport type {\n  ToolCategory,\n  ToolMetadata,\n  ToolExecutionContext,\n  ToolExecutionResult,\n  RegisterableTool,\n} from './types'\n\n// Registry\nexport { ToolRegistry, getToolRegistry, resetToolRegistry } from './registry'\n\n// Executor\nexport {\n  ToolExecutor,\n  getToolExecutor,\n  resetToolExecutor,\n  type ExecutionOptions,\n} from './executor'\n"],
+  "mappings": "AAgBA,SAAS,cAAc,iBAAiB,yBAAyB;AAGjE;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;",
+  "names": []
+}

package/dist/core/tools/registry.js

@@ -0,0 +1,183 @@
+class ToolRegistry {
+  tools = /* @__PURE__ */ new Map();
+  metadata = /* @__PURE__ */ new Map();
+  aliases = /* @__PURE__ */ new Map();
+  /**
+   * Register a tool
+   */
+  register(tool, meta) {
+    const name = tool.name;
+    this.tools.set(name, tool);
+    const metadata = {
+      name,
+      displayName: tool.userFacingName?.() || name,
+      isReadOnly: tool.isReadOnly?.() ?? false,
+      needsPermissions: tool.needsPermissions?.() ?? true,
+      isConcurrencySafe: tool.isConcurrencySafe?.() ?? false,
+      ...meta
+    };
+    this.metadata.set(name, metadata);
+    if (metadata.aliases) {
+      for (const alias of metadata.aliases) {
+        this.aliases.set(alias, name);
+      }
+    }
+  }
+  /**
+   * Register multiple tools
+   */
+  registerAll(tools) {
+    for (const tool of tools) {
+      this.register(tool);
+    }
+  }
+  /**
+   * Unregister a tool
+   */
+  unregister(name) {
+    const meta = this.metadata.get(name);
+    if (meta?.aliases) {
+      for (const alias of meta.aliases) {
+        this.aliases.delete(alias);
+      }
+    }
+    this.metadata.delete(name);
+    return this.tools.delete(name);
+  }
+  /**
+   * Get a tool by name or alias
+   */
+  get(nameOrAlias) {
+    const tool = this.tools.get(nameOrAlias);
+    if (tool) return tool;
+    const realName = this.aliases.get(nameOrAlias);
+    if (realName) {
+      return this.tools.get(realName);
+    }
+    return void 0;
+  }
+  /**
+   * Check if a tool exists
+   */
+  has(nameOrAlias) {
+    return this.tools.has(nameOrAlias) || this.aliases.has(nameOrAlias);
+  }
+  /**
+   * Get all tools
+   */
+  getAll() {
+    return Array.from(this.tools.values());
+  }
+  /**
+   * Get all tool names
+   */
+  getNames() {
+    return Array.from(this.tools.keys());
+  }
+  /**
+   * Get tools by category
+   */
+  getByCategory(category) {
+    const results = [];
+    for (const [name, meta] of this.metadata.entries()) {
+      if (meta.category === category) {
+        const tool = this.tools.get(name);
+        if (tool) results.push(tool);
+      }
+    }
+    return results;
+  }
+  /**
+   * Get tools by tag
+   */
+  getByTag(tag) {
+    const results = [];
+    for (const [name, meta] of this.metadata.entries()) {
+      if (meta.tags?.includes(tag)) {
+        const tool = this.tools.get(name);
+        if (tool) results.push(tool);
+      }
+    }
+    return results;
+  }
+  /**
+   * Get enabled tools
+   */
+  async getEnabled() {
+    const results = [];
+    for (const tool of this.tools.values()) {
+      if (tool.isEnabled) {
+        const enabled = await Promise.resolve(tool.isEnabled());
+        if (enabled) {
+          results.push(tool);
+        }
+      } else {
+        results.push(tool);
+      }
+    }
+    return results;
+  }
+  /**
+   * Get read-only tools
+   */
+  getReadOnly() {
+    const results = [];
+    for (const tool of this.tools.values()) {
+      if (tool.isReadOnly?.()) {
+        results.push(tool);
+      }
+    }
+    return results;
+  }
+  /**
+   * Get tool metadata
+   */
+  getMetadata(name) {
+    const meta = this.metadata.get(name);
+    if (meta) return meta;
+    const realName = this.aliases.get(name);
+    if (realName) {
+      return this.metadata.get(realName);
+    }
+    return void 0;
+  }
+  /**
+   * Update tool metadata
+   */
+  updateMetadata(name, update) {
+    const existing = this.metadata.get(name);
+    if (!existing) return false;
+    this.metadata.set(name, { ...existing, ...update });
+    return true;
+  }
+  /**
+   * Get count of registered tools
+   */
+  get size() {
+    return this.tools.size;
+  }
+  /**
+   * Clear all tools
+   */
+  clear() {
+    this.tools.clear();
+    this.metadata.clear();
+    this.aliases.clear();
+  }
+}
+let globalRegistry = null;
+function getToolRegistry() {
+  if (!globalRegistry) {
+    globalRegistry = new ToolRegistry();
+  }
+  return globalRegistry;
+}
+function resetToolRegistry() {
+  globalRegistry = null;
+}
+export {
+  ToolRegistry,
+  getToolRegistry,
+  resetToolRegistry
+};
+//# sourceMappingURL=registry.js.map

package/dist/core/tools/registry.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/tools/registry.ts"],
+  "sourcesContent": ["/**\n * Tool Registry\n *\n * Centralized registry for tool management.\n */\n\nimport type { RegisterableTool, ToolCategory, ToolMetadata } from './types'\n\n/**\n * Tool Registry\n *\n * Manages registration and lookup of tools.\n */\nexport class ToolRegistry {\n  private tools: Map<string, RegisterableTool> = new Map()\n  private metadata: Map<string, ToolMetadata> = new Map()\n  private aliases: Map<string, string> = new Map()\n\n  /**\n   * Register a tool\n   */\n  register(tool: RegisterableTool, meta?: Partial<ToolMetadata>): void {\n    const name = tool.name\n\n    // Store tool\n    this.tools.set(name, tool)\n\n    // Build metadata\n    const metadata: ToolMetadata = {\n      name,\n      displayName: tool.userFacingName?.() || name,\n      isReadOnly: tool.isReadOnly?.() ?? false,\n      needsPermissions: tool.needsPermissions?.() ?? true,\n      isConcurrencySafe: tool.isConcurrencySafe?.() ?? false,\n      ...meta,\n    }\n    this.metadata.set(name, metadata)\n\n    // Register aliases\n    if (metadata.aliases) {\n      for (const alias of metadata.aliases) {\n        this.aliases.set(alias, name)\n      }\n    }\n  }\n\n  /**\n   * Register multiple tools\n   */\n  registerAll(tools: RegisterableTool[]): void {\n    for (const tool of tools) {\n      this.register(tool)\n    }\n  }\n\n  /**\n   * Unregister a tool\n   */\n  unregister(name: string): boolean {\n    const meta = this.metadata.get(name)\n\n    // Remove aliases\n    if (meta?.aliases) {\n      for (const alias of meta.aliases) {\n        this.aliases.delete(alias)\n      }\n    }\n\n    // Remove from registry\n    this.metadata.delete(name)\n    return this.tools.delete(name)\n  }\n\n  /**\n   * Get a tool by name or alias\n   */\n  get(nameOrAlias: string): RegisterableTool | undefined {\n    // Try direct lookup first\n    const tool = this.tools.get(nameOrAlias)\n    if (tool) return tool\n\n    // Try alias lookup\n    const realName = this.aliases.get(nameOrAlias)\n    if (realName) {\n      return this.tools.get(realName)\n    }\n\n    return undefined\n  }\n\n  /**\n   * Check if a tool exists\n   */\n  has(nameOrAlias: string): boolean {\n    return this.tools.has(nameOrAlias) || this.aliases.has(nameOrAlias)\n  }\n\n  /**\n   * Get all tools\n   */\n  getAll(): RegisterableTool[] {\n    return Array.from(this.tools.values())\n  }\n\n  /**\n   * Get all tool names\n   */\n  getNames(): string[] {\n    return Array.from(this.tools.keys())\n  }\n\n  /**\n   * Get tools by category\n   */\n  getByCategory(category: ToolCategory): RegisterableTool[] {\n    const results: RegisterableTool[] = []\n\n    for (const [name, meta] of this.metadata.entries()) {\n      if (meta.category === category) {\n        const tool = this.tools.get(name)\n        if (tool) results.push(tool)\n      }\n    }\n\n    return results\n  }\n\n  /**\n   * Get tools by tag\n   */\n  getByTag(tag: string): RegisterableTool[] {\n    const results: RegisterableTool[] = []\n\n    for (const [name, meta] of this.metadata.entries()) {\n      if (meta.tags?.includes(tag)) {\n        const tool = this.tools.get(name)\n        if (tool) results.push(tool)\n      }\n    }\n\n    return results\n  }\n\n  /**\n   * Get enabled tools\n   */\n  async getEnabled(): Promise<RegisterableTool[]> {\n    const results: RegisterableTool[] = []\n\n    for (const tool of this.tools.values()) {\n      if (tool.isEnabled) {\n        const enabled = await Promise.resolve(tool.isEnabled())\n        if (enabled) {\n          results.push(tool)\n        }\n      } else {\n        // No isEnabled means always enabled\n        results.push(tool)\n      }\n    }\n\n    return results\n  }\n\n  /**\n   * Get read-only tools\n   */\n  getReadOnly(): RegisterableTool[] {\n    const results: RegisterableTool[] = []\n\n    for (const tool of this.tools.values()) {\n      if (tool.isReadOnly?.()) {\n        results.push(tool)\n      }\n    }\n\n    return results\n  }\n\n  /**\n   * Get tool metadata\n   */\n  getMetadata(name: string): ToolMetadata | undefined {\n    // Try direct lookup\n    const meta = this.metadata.get(name)\n    if (meta) return meta\n\n    // Try alias lookup\n    const realName = this.aliases.get(name)\n    if (realName) {\n      return this.metadata.get(realName)\n    }\n\n    return undefined\n  }\n\n  /**\n   * Update tool metadata\n   */\n  updateMetadata(name: string, update: Partial<ToolMetadata>): boolean {\n    const existing = this.metadata.get(name)\n    if (!existing) return false\n\n    this.metadata.set(name, { ...existing, ...update })\n    return true\n  }\n\n  /**\n   * Get count of registered tools\n   */\n  get size(): number {\n    return this.tools.size\n  }\n\n  /**\n   * Clear all tools\n   */\n  clear(): void {\n    this.tools.clear()\n    this.metadata.clear()\n    this.aliases.clear()\n  }\n}\n\n// Global singleton instance\nlet globalRegistry: ToolRegistry | null = null\n\n/**\n * Get the global tool registry instance\n */\nexport function getToolRegistry(): ToolRegistry {\n  if (!globalRegistry) {\n    globalRegistry = new ToolRegistry()\n  }\n  return globalRegistry\n}\n\n/**\n * Reset the global tool registry (for testing)\n */\nexport function resetToolRegistry(): void {\n  globalRegistry = null\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/core/tools/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/core/tools/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/cost-tracker.js

@@ -1,5 +1,6 @@
 import chalk from "chalk";
 import { useEffect } from "react";
+import signalExit from "signal-exit";
 import { formatDuration } from "./utils/format.js";
 import {
   getCurrentProjectConfig,
@@ -34,23 +35,30 @@ Total duration (API): ${formatDuration(STATE.totalAPIDuration)}
 Total duration (wall): ${formatDuration(getTotalDuration())}`
   );
 }
+let exitHandlerRegistered = false;
 function useCostSummary() {
   useEffect(() => {
-    const f = () => {
-      process.stdout.write("\n" + formatTotalCost() + "\n");
-      const projectConfig = getCurrentProjectConfig();
-      saveCurrentProjectConfig({
-        ...projectConfig,
-        lastCost: STATE.totalCost,
-        lastAPIDuration: STATE.totalAPIDuration,
-        lastDuration: getTotalDuration(),
-        lastSessionId: SESSION_ID
-      });
-    };
-    process.on("exit", f);
-    return () => {
-      process.off("exit", f);
-    };
+    if (exitHandlerRegistered) {
+      return;
+    }
+    exitHandlerRegistered = true;
+    signalExit(
+      () => {
+        process.stdout.write("\n" + formatTotalCost() + "\n");
+        try {
+          const projectConfig = getCurrentProjectConfig();
+          saveCurrentProjectConfig({
+            ...projectConfig,
+            lastCost: STATE.totalCost,
+            lastAPIDuration: STATE.totalAPIDuration,
+            lastDuration: getTotalDuration(),
+            lastSessionId: SESSION_ID
+          });
+        } catch {
+        }
+      },
+      { alwaysLast: true }
+    );
   }, []);
 }
 function round(number, precision) {

package/dist/cost-tracker.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/cost-tracker.ts"],
-  "sourcesContent": ["import chalk from 'chalk'\nimport { useEffect } from 'react'\nimport { formatDuration } from './utils/format'\nimport {\n  getCurrentProjectConfig,\n  saveCurrentProjectConfig,\n} from '@utils/config'\nimport { SESSION_ID } from './utils/log'\n\n// DO NOT ADD MORE STATE HERE OR BORIS WILL CURSE YOU\nconst STATE: {\n  totalCost: number\n  totalAPIDuration: number\n  startTime: number\n} = {\n  totalCost: 0,\n  totalAPIDuration: 0,\n  startTime: Date.now(),\n}\n\nexport function addToTotalCost(cost: number, duration: number): void {\n  STATE.totalCost += cost\n  STATE.totalAPIDuration += duration\n}\n\nexport function getTotalCost(): number {\n  return STATE.totalCost\n}\n\nexport function getTotalDuration(): number {\n  return Date.now() - STATE.startTime\n}\n\nexport function getTotalAPIDuration(): number {\n  return STATE.totalAPIDuration\n}\n\nfunction formatCost(cost: number): string {\n  return `$${cost > 0.5 ? round(cost, 100).toFixed(2) : cost.toFixed(4)}`\n}\n\nexport function formatTotalCost(): string {\n  return chalk.grey(\n    `Total cost: ${formatCost(STATE.totalCost)}\nTotal duration (API): ${formatDuration(STATE.totalAPIDuration)}\nTotal duration (wall): ${formatDuration(getTotalDuration())}`,\n  )\n}\n\nexport function useCostSummary(): void {\n  useEffect(() => {\n    const f = () => {\n      process.stdout.write('\\n' + formatTotalCost() + '\\n')\n\n      // Save last cost and duration to project config\n      const projectConfig = getCurrentProjectConfig()\n      saveCurrentProjectConfig({\n        ...projectConfig,\n        lastCost: STATE.totalCost,\n        lastAPIDuration: STATE.totalAPIDuration,\n        lastDuration: getTotalDuration(),\n        lastSessionId: SESSION_ID,\n      })\n    }\n    process.on('exit', f)\n    return () => {\n      process.off('exit', f)\n    }\n  }, [])\n}\n\nfunction round(number: number, precision: number): number {\n  return Math.round(number * precision) / precision\n}\n\n// Only used in tests\nexport function resetStateForTests(): void {\n  if (process.env.NODE_ENV !== 'test') {\n    throw new Error('resetStateForTests can only be called in tests')\n  }\n  STATE.startTime = Date.now()\n  STATE.totalCost = 0\n  STATE.totalAPIDuration = 0\n}\n"],
-  "mappings": "AAAA,OAAO,WAAW;AAClB,SAAS,iBAAiB;AAC1B,SAAS,sBAAsB;AAC/B;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB;AAG3B,MAAM,QAIF;AAAA,EACF,WAAW;AAAA,EACX,kBAAkB;AAAA,EAClB,WAAW,KAAK,IAAI;AACtB;AAEO,SAAS,eAAe,MAAc,UAAwB;AACnE,QAAM,aAAa;AACnB,QAAM,oBAAoB;AAC5B;AAEO,SAAS,eAAuB;AACrC,SAAO,MAAM;AACf;AAEO,SAAS,mBAA2B;AACzC,SAAO,KAAK,IAAI,IAAI,MAAM;AAC5B;AAEO,SAAS,sBAA8B;AAC5C,SAAO,MAAM;AACf;AAEA,SAAS,WAAW,MAAsB;AACxC,SAAO,IAAI,OAAO,MAAM,MAAM,MAAM,GAAG,EAAE,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;AACvE;AAEO,SAAS,kBAA0B;AACxC,SAAO,MAAM;AAAA,IACX,eAAe,WAAW,MAAM,SAAS,CAAC;AAAA,wBACtB,eAAe,MAAM,gBAAgB,CAAC;AAAA,yBACrC,eAAe,iBAAiB,CAAC,CAAC;AAAA,EACzD;AACF;AAEO,SAAS,iBAAuB;AACrC,YAAU,MAAM;AACd,UAAM,IAAI,MAAM;AACd,cAAQ,OAAO,MAAM,OAAO,gBAAgB,IAAI,IAAI;AAGpD,YAAM,gBAAgB,wBAAwB;AAC9C,+BAAyB;AAAA,QACvB,GAAG;AAAA,QACH,UAAU,MAAM;AAAA,QAChB,iBAAiB,MAAM;AAAA,QACvB,cAAc,iBAAiB;AAAA,QAC/B,eAAe;AAAA,MACjB,CAAC;AAAA,IACH;AACA,YAAQ,GAAG,QAAQ,CAAC;AACpB,WAAO,MAAM;AACX,cAAQ,IAAI,QAAQ,CAAC;AAAA,IACvB;AAAA,EACF,GAAG,CAAC,CAAC;AACP;AAEA,SAAS,MAAM,QAAgB,WAA2B;AACxD,SAAO,KAAK,MAAM,SAAS,SAAS,IAAI;AAC1C;AAGO,SAAS,qBAA2B;AACzC,MAAI,QAAQ,IAAI,aAAa,QAAQ;AACnC,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,QAAM,YAAY,KAAK,IAAI;AAC3B,QAAM,YAAY;AAClB,QAAM,mBAAmB;AAC3B;",
+  "sourcesContent": ["import chalk from 'chalk'\nimport { useEffect } from 'react'\nimport signalExit from 'signal-exit'\nimport { formatDuration } from './utils/format'\nimport {\n  getCurrentProjectConfig,\n  saveCurrentProjectConfig,\n} from '@utils/config'\nimport { SESSION_ID } from './utils/log'\n\n// DO NOT ADD MORE STATE HERE OR BORIS WILL CURSE YOU\nconst STATE: {\n  totalCost: number\n  totalAPIDuration: number\n  startTime: number\n} = {\n  totalCost: 0,\n  totalAPIDuration: 0,\n  startTime: Date.now(),\n}\n\nexport function addToTotalCost(cost: number, duration: number): void {\n  STATE.totalCost += cost\n  STATE.totalAPIDuration += duration\n}\n\nexport function getTotalCost(): number {\n  return STATE.totalCost\n}\n\nexport function getTotalDuration(): number {\n  return Date.now() - STATE.startTime\n}\n\nexport function getTotalAPIDuration(): number {\n  return STATE.totalAPIDuration\n}\n\nfunction formatCost(cost: number): string {\n  return `$${cost > 0.5 ? round(cost, 100).toFixed(2) : cost.toFixed(4)}`\n}\n\nexport function formatTotalCost(): string {\n  return chalk.grey(\n    `Total cost: ${formatCost(STATE.totalCost)}\nTotal duration (API): ${formatDuration(STATE.totalAPIDuration)}\nTotal duration (wall): ${formatDuration(getTotalDuration())}`,\n  )\n}\n\n/**\n * useCostSummary - Register exit handler to display cost summary\n *\n * CRITICAL FIX: Use signal-exit with alwaysLast: true\n *\n * The problem was that Ink also uses signal-exit (with alwaysLast: false)\n * to clean up on exit. During Ink's cleanup, it may:\n * 1. Call onRender() one last time\n * 2. Use ansiEscapes.eraseLines() to clear previous output\n * 3. Or even call clearTerminal if output height >= terminal rows\n *\n * By using signal-exit with alwaysLast: true, we ensure our handler\n * runs AFTER Ink's cleanup, so our statistics are the last thing printed.\n */\n// Flag to ensure we only register once and never unregister\nlet exitHandlerRegistered = false\n\nexport function useCostSummary(): void {\n  useEffect(() => {\n    // Only register ONCE, and NEVER unregister\n    if (exitHandlerRegistered) {\n      return\n    }\n    exitHandlerRegistered = true\n\n    // Use signal-exit with alwaysLast: true to run AFTER Ink's cleanup\n    // This ensures our statistics are printed after Ink finishes its final render\n    signalExit(\n      () => {\n        // Write statistics to stdout\n        // Using stdout.write directly to avoid any Ink interception\n        process.stdout.write('\\n' + formatTotalCost() + '\\n')\n\n        // Save last cost and duration to project config\n        try {\n          const projectConfig = getCurrentProjectConfig()\n          saveCurrentProjectConfig({\n            ...projectConfig,\n            lastCost: STATE.totalCost,\n            lastAPIDuration: STATE.totalAPIDuration,\n            lastDuration: getTotalDuration(),\n            lastSessionId: SESSION_ID,\n          })\n        } catch {\n          // Ignore errors during exit - config save is best-effort\n        }\n      },\n      { alwaysLast: true },\n    )\n\n    // NO cleanup function - we NEVER want to unregister this handler\n  }, [])\n}\n\nfunction round(number: number, precision: number): number {\n  return Math.round(number * precision) / precision\n}\n\n// Only used in tests\nexport function resetStateForTests(): void {\n  if (process.env.NODE_ENV !== 'test') {\n    throw new Error('resetStateForTests can only be called in tests')\n  }\n  STATE.startTime = Date.now()\n  STATE.totalCost = 0\n  STATE.totalAPIDuration = 0\n}\n"],
+  "mappings": "AAAA,OAAO,WAAW;AAClB,SAAS,iBAAiB;AAC1B,OAAO,gBAAgB;AACvB,SAAS,sBAAsB;AAC/B;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB;AAG3B,MAAM,QAIF;AAAA,EACF,WAAW;AAAA,EACX,kBAAkB;AAAA,EAClB,WAAW,KAAK,IAAI;AACtB;AAEO,SAAS,eAAe,MAAc,UAAwB;AACnE,QAAM,aAAa;AACnB,QAAM,oBAAoB;AAC5B;AAEO,SAAS,eAAuB;AACrC,SAAO,MAAM;AACf;AAEO,SAAS,mBAA2B;AACzC,SAAO,KAAK,IAAI,IAAI,MAAM;AAC5B;AAEO,SAAS,sBAA8B;AAC5C,SAAO,MAAM;AACf;AAEA,SAAS,WAAW,MAAsB;AACxC,SAAO,IAAI,OAAO,MAAM,MAAM,MAAM,GAAG,EAAE,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;AACvE;AAEO,SAAS,kBAA0B;AACxC,SAAO,MAAM;AAAA,IACX,eAAe,WAAW,MAAM,SAAS,CAAC;AAAA,wBACtB,eAAe,MAAM,gBAAgB,CAAC;AAAA,yBACrC,eAAe,iBAAiB,CAAC,CAAC;AAAA,EACzD;AACF;AAiBA,IAAI,wBAAwB;AAErB,SAAS,iBAAuB;AACrC,YAAU,MAAM;AAEd,QAAI,uBAAuB;AACzB;AAAA,IACF;AACA,4BAAwB;AAIxB;AAAA,MACE,MAAM;AAGJ,gBAAQ,OAAO,MAAM,OAAO,gBAAgB,IAAI,IAAI;AAGpD,YAAI;AACF,gBAAM,gBAAgB,wBAAwB;AAC9C,mCAAyB;AAAA,YACvB,GAAG;AAAA,YACH,UAAU,MAAM;AAAA,YAChB,iBAAiB,MAAM;AAAA,YACvB,cAAc,iBAAiB;AAAA,YAC/B,eAAe;AAAA,UACjB,CAAC;AAAA,QACH,QAAQ;AAAA,QAER;AAAA,MACF;AAAA,MACA,EAAE,YAAY,KAAK;AAAA,IACrB;AAAA,EAGF,GAAG,CAAC,CAAC;AACP;AAEA,SAAS,MAAM,QAAgB,WAA2B;AACxD,SAAO,KAAK,MAAM,SAAS,SAAS,IAAI;AAC1C;AAGO,SAAS,qBAA2B;AACzC,MAAI,QAAQ,IAAI,aAAa,QAAQ;AACnC,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,QAAM,YAAY,KAAK,IAAI;AAC3B,QAAM,YAAY;AAClB,QAAM,mBAAmB;AAC3B;",
   "names": []
 }

package/dist/entrypoints/cli.js

@@ -1,11 +1,15 @@
 #!/usr/bin/env -S node --no-warnings=ExperimentalWarning --enable-source-maps
 process.env.DEV = "false";
+import { EventEmitter } from "events";
+EventEmitter.defaultMaxListeners = 20;
 import { fileURLToPath } from "node:url";
 import { dirname, join } from "node:path";
 import { existsSync } from "node:fs";
 import { initSentry } from "../services/sentry.js";
 import { PRODUCT_COMMAND, PRODUCT_NAME } from "../constants/product.js";
+import { initGlobalErrorHandlers } from "../utils/globalErrorHandler.js";
 initSentry();
+initGlobalErrorHandlers();
 try {
   if (!process.env.YOGA_WASM_PATH) {
     const __filename = fileURLToPath(import.meta.url);
@@ -59,6 +63,7 @@ import { getCommands } from "../commands.js";
 import { getNextAvailableLogForkNumber, loadLogList } from "../utils/log.js";
 import { loadMessagesFromLog } from "../utils/conversationRecovery.js";
 import { cleanupOldMessageFilesInBackground } from "../utils/cleanup.js";
+import { runLogRotationInBackground, shouldRotate } from "../utils/logRotation.js";
 import {
   handleListApprovedTools,
   handleRemoveApprovedTool
@@ -70,8 +75,7 @@ import {
   parseEnvVars,
   removeMcpServer,
   getClients,
-  ensureConfigScope,
-  shutdownMCPClients
+  ensureConfigScope
 } from "../services/mcpClient.js";
 import { handleMcprcServerApprovals } from "../services/mcpServerApproval.js";
 import { cursorShow } from "ansi-escapes";
@@ -80,10 +84,16 @@ import {
   assertMinVersion,
   getUpdateCommandSuggestions
 } from "../utils/autoUpdater.js";
+import {
+  initI18n,
+  setLanguage,
+  isLanguageSupported
+} from "../i18n/index.js";
 import { gt } from "semver";
 import { CACHE_PATHS } from "../utils/log.js";
-import { PersistentShell } from "../utils/PersistentShell.js";
+import { onShellCrash } from "../utils/PersistentShell.js";
 import { clearTerminal } from "../utils/terminal.js";
+import { setupExitHandlers } from "../utils/exit.js";
 import { showInvalidConfigDialog } from "../components/InvalidConfigDialog.js";
 import { ConfigParseError } from "../utils/errors.js";
 import { grantReadPermissionForOriginalDir } from "../utils/permissions/filesystem.js";
@@ -204,6 +214,9 @@ async function setup(cwd2, safeMode) {
     return;
   }
   cleanupOldMessageFilesInBackground();
+  if (shouldRotate()) {
+    runLogRotationInBackground();
+  }
   getContext();
   const globalConfig = getGlobalConfig();
   if (globalConfig.iterm2KeyBindingInstalled === true && globalConfig.shiftEnterKeyBindingInstalled !== true) {
@@ -254,7 +267,24 @@ if (process.env.NODE_ENV !== "test") {
   });
 }
 async function main() {
+  const globalConfig = getGlobalConfig();
+  const configLang = globalConfig.language;
+  if (configLang && isLanguageSupported(configLang)) {
+    initI18n(configLang);
+  } else {
+    initI18n("en");
+  }
   initDebugLogger();
+  onShellCrash((code, signal) => {
+    console.error("");
+    console.error(
+      `\u26A0\uFE0F  Shell process crashed unexpectedly (code: ${code}, signal: ${signal})`
+    );
+    console.error(
+      "   Bash commands may fail. Try running /clear or restart the CLI."
+    );
+    console.error("");
+  });
   try {
     enableConfigs();
     try {
@@ -347,6 +377,10 @@ ${commandList}`
     "-r, --resume",
     "Select a previous conversation to resume",
     () => true
+  ).option(
+    "-l, --lang <language>",
+    "Set interface language (en, zh-CN)",
+    String
   ).action(
     async (prompt, {
       cwd: cwd2,
@@ -356,8 +390,12 @@ ${commandList}`
       print,
       safe,
       new: startNew,
-      resume: selectResume
+      resume: selectResume,
+      lang
     }) => {
+      if (lang && isLanguageSupported(lang)) {
+        setLanguage(lang);
+      }
       await showSetupScreens(safe, print, rawModeSupported);
       await setup(cwd2, safe);
       assertMinVersion();
@@ -1184,45 +1222,7 @@ async function stdin() {
   for await (const chunk of process.stdin) data += chunk;
   return data;
 }
-process.on("exit", () => {
-  resetCursor();
-  PersistentShell.getInstance().close();
-});
-let isShuttingDown = false;
-async function gracefulExit(code = 0) {
-  if (isShuttingDown) return;
-  isShuttingDown = true;
-  try {
-    resetCursor();
-  } catch {
-  }
-  try {
-    PersistentShell.getInstance().close();
-  } catch {
-  }
-  try {
-    await shutdownMCPClients();
-  } catch {
-  }
-  process.exit(code);
-}
-process.on("SIGINT", () => {
-  gracefulExit(0);
-});
-process.on("SIGTERM", () => {
-  gracefulExit(0);
-});
-process.on("SIGBREAK", () => {
-  gracefulExit(0);
-});
-process.on("unhandledRejection", (err) => {
-  console.error("Unhandled rejection:", err);
-  gracefulExit(1);
-});
-process.on("uncaughtException", (err) => {
-  console.error("Uncaught exception:", err);
-  gracefulExit(1);
-});
+setupExitHandlers();
 function resetCursor() {
   const terminal = process.stderr.isTTY ? process.stderr : process.stdout.isTTY ? process.stdout : void 0;
   terminal?.write(`\x1B[?25h${cursorShow}`);