@within-7/minto 0.1.6 → 0.2.0

package/dist/utils/tooling/safeRender.js

@@ -0,0 +1,115 @@
+import * as React from "react";
+import { Box, Text } from "ink";
+function DefaultToolResult({
+  output
+}) {
+  let displayContent;
+  if (output === null || output === void 0) {
+    displayContent = "(no output)";
+  } else if (typeof output === "string") {
+    displayContent = output.length > 500 ? output.slice(0, 500) + "..." : output;
+  } else if (typeof output === "object") {
+    try {
+      const json = JSON.stringify(output, null, 2);
+      displayContent = json.length > 500 ? json.slice(0, 500) + "..." : json;
+    } catch {
+      displayContent = "[Object - cannot stringify]";
+    }
+  } else {
+    displayContent = String(output);
+  }
+  return /* @__PURE__ */ React.createElement(Box, { flexDirection: "column" }, /* @__PURE__ */ React.createElement(Text, { dimColor: true }, displayContent));
+}
+function ErrorToolResult({
+  error,
+  toolName
+}) {
+  const errorMessage = error instanceof Error ? error.message : String(error || "Unknown error");
+  return /* @__PURE__ */ React.createElement(Box, { flexDirection: "column" }, /* @__PURE__ */ React.createElement(Text, { color: "red" }, toolName ? `[${toolName}] ` : "", "Error rendering result:"), /* @__PURE__ */ React.createElement(Text, { dimColor: true }, errorMessage));
+}
+function safeRenderToolResult(tool, output, options) {
+  if (!tool) {
+    return /* @__PURE__ */ React.createElement(DefaultToolResult, { output });
+  }
+  if (!tool.renderToolResultMessage) {
+    return /* @__PURE__ */ React.createElement(DefaultToolResult, { output });
+  }
+  try {
+    const rendered = tool.renderToolResultMessage(output, options);
+    if (rendered === null || rendered === void 0) {
+      return /* @__PURE__ */ React.createElement(DefaultToolResult, { output });
+    }
+    return rendered;
+  } catch (error) {
+    return /* @__PURE__ */ React.createElement(ErrorToolResult, { error, toolName: tool.name });
+  }
+}
+function safeRenderToolUseMessage(tool, input, options) {
+  if (!tool) {
+    return /* @__PURE__ */ React.createElement(Box, null, /* @__PURE__ */ React.createElement(Text, { dimColor: true }, "Unknown tool call"));
+  }
+  if (!tool.renderToolUseMessage) {
+    return /* @__PURE__ */ React.createElement(Box, null, /* @__PURE__ */ React.createElement(Text, null, /* @__PURE__ */ React.createElement(Text, { color: "cyan" }, tool.name), options.verbose && /* @__PURE__ */ React.createElement(Text, { dimColor: true }, " ", JSON.stringify(input).slice(0, 100))));
+  }
+  try {
+    const rendered = tool.renderToolUseMessage(input, options);
+    if (rendered === null || rendered === void 0) {
+      return /* @__PURE__ */ React.createElement(Box, null, /* @__PURE__ */ React.createElement(Text, { color: "cyan" }, tool.name));
+    }
+    return rendered;
+  } catch (error) {
+    return /* @__PURE__ */ React.createElement(ErrorToolResult, { error, toolName: tool.name });
+  }
+}
+function safeRenderToolRejectedMessage(tool, ...args) {
+  if (!tool || !tool.renderToolUseRejectedMessage) {
+    return /* @__PURE__ */ React.createElement(Box, null, /* @__PURE__ */ React.createElement(Text, { color: "yellow" }, "Tool use rejected"));
+  }
+  try {
+    const rendered = tool.renderToolUseRejectedMessage(...args);
+    if (rendered === null || rendered === void 0) {
+      return /* @__PURE__ */ React.createElement(Box, null, /* @__PURE__ */ React.createElement(Text, { color: "yellow" }, tool.name, " rejected"));
+    }
+    return rendered;
+  } catch (error) {
+    return /* @__PURE__ */ React.createElement(ErrorToolResult, { error, toolName: tool.name });
+  }
+}
+function isValidReactNode(value) {
+  if (value === null || value === void 0) {
+    return true;
+  }
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    return true;
+  }
+  if (Array.isArray(value)) {
+    return value.every(isValidReactNode);
+  }
+  if (typeof value === "object" && value !== null) {
+    return "$$typeof" in value || React.isValidElement(value);
+  }
+  return false;
+}
+function wrapRenderFunction(renderFn, fallback) {
+  return (...args) => {
+    try {
+      const result = renderFn(...args);
+      if (result === null || result === void 0) {
+        return fallback;
+      }
+      return result;
+    } catch {
+      return fallback;
+    }
+  };
+}
+export {
+  DefaultToolResult,
+  ErrorToolResult,
+  isValidReactNode,
+  safeRenderToolRejectedMessage,
+  safeRenderToolResult,
+  safeRenderToolUseMessage,
+  wrapRenderFunction
+};
+//# sourceMappingURL=safeRender.js.map

package/dist/utils/tooling/safeRender.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/tooling/safeRender.tsx"],
+  "sourcesContent": ["/**\n * Safe Rendering Utilities for Tool Results\n *\n * Provides null-safe wrappers for tool rendering methods to prevent\n * crashes from undefined returns or exceptions.\n *\n * Part of Phase 1.3: Null Guards Completion\n */\n\nimport * as React from 'react'\nimport { Box, Text } from 'ink'\nimport { Tool } from '@tool'\n\n/**\n * Default tool result component when tool doesn't provide a renderer.\n */\nexport function DefaultToolResult({\n  output,\n}: {\n  output: unknown\n}): React.ReactElement {\n  let displayContent: string\n\n  if (output === null || output === undefined) {\n    displayContent = '(no output)'\n  } else if (typeof output === 'string') {\n    displayContent = output.length > 500 ? output.slice(0, 500) + '...' : output\n  } else if (typeof output === 'object') {\n    try {\n      const json = JSON.stringify(output, null, 2)\n      displayContent = json.length > 500 ? json.slice(0, 500) + '...' : json\n    } catch {\n      displayContent = '[Object - cannot stringify]'\n    }\n  } else {\n    displayContent = String(output)\n  }\n\n  return (\n    <Box flexDirection=\"column\">\n      <Text dimColor>{displayContent}</Text>\n    </Box>\n  )\n}\n\n/**\n * Error display component for tool rendering failures.\n */\nexport function ErrorToolResult({\n  error,\n  toolName,\n}: {\n  error: unknown\n  toolName?: string\n}): React.ReactElement {\n  const errorMessage =\n    error instanceof Error ? error.message : String(error || 'Unknown error')\n\n  return (\n    <Box flexDirection=\"column\">\n      <Text color=\"red\">\n        {toolName ? `[${toolName}] ` : ''}Error rendering result:\n      </Text>\n      <Text dimColor>{errorMessage}</Text>\n    </Box>\n  )\n}\n\n/**\n * Safely render a tool result with comprehensive error handling.\n *\n * @param tool - The tool that produced the result\n * @param output - The tool's output data\n * @param options - Rendering options\n * @returns A React node that is guaranteed to be renderable\n */\nexport function safeRenderToolResult(\n  tool: Tool | undefined | null,\n  output: unknown,\n  options: { verbose: boolean },\n): React.ReactNode {\n  // No tool provided\n  if (!tool) {\n    return <DefaultToolResult output={output} />\n  }\n\n  // Tool doesn't have a renderer\n  if (!tool.renderToolResultMessage) {\n    return <DefaultToolResult output={output} />\n  }\n\n  try {\n    const rendered = tool.renderToolResultMessage(output, options)\n\n    // Handle null/undefined returns\n    if (rendered === null || rendered === undefined) {\n      return <DefaultToolResult output={output} />\n    }\n\n    return rendered\n  } catch (error) {\n    // Catch any rendering errors\n    return <ErrorToolResult error={error} toolName={tool.name} />\n  }\n}\n\n/**\n * Safely render a tool use message with comprehensive error handling.\n *\n * @param tool - The tool being used\n * @param input - The tool's input parameters\n * @param options - Rendering options\n * @returns A React node that is guaranteed to be renderable\n */\nexport function safeRenderToolUseMessage(\n  tool: Tool | undefined | null,\n  input: unknown,\n  options: { verbose: boolean },\n): React.ReactNode {\n  // No tool provided\n  if (!tool) {\n    return (\n      <Box>\n        <Text dimColor>Unknown tool call</Text>\n      </Box>\n    )\n  }\n\n  // Tool doesn't have a renderer\n  if (!tool.renderToolUseMessage) {\n    return (\n      <Box>\n        <Text>\n          <Text color=\"cyan\">{tool.name}</Text>\n          {options.verbose && (\n            <Text dimColor> {JSON.stringify(input).slice(0, 100)}</Text>\n          )}\n        </Text>\n      </Box>\n    )\n  }\n\n  try {\n    const rendered = tool.renderToolUseMessage(input, options)\n\n    // Handle null/undefined returns\n    if (rendered === null || rendered === undefined) {\n      return (\n        <Box>\n          <Text color=\"cyan\">{tool.name}</Text>\n        </Box>\n      )\n    }\n\n    return rendered\n  } catch (error) {\n    return <ErrorToolResult error={error} toolName={tool.name} />\n  }\n}\n\n/**\n * Safely render a tool rejection message with comprehensive error handling.\n *\n * @param tool - The tool that was rejected\n * @param args - Arguments to pass to the rejection renderer\n * @returns A React node that is guaranteed to be renderable\n */\nexport function safeRenderToolRejectedMessage(\n  tool: Tool | undefined | null,\n  ...args: unknown[]\n): React.ReactNode {\n  // No tool or no renderer\n  if (!tool || !tool.renderToolUseRejectedMessage) {\n    return (\n      <Box>\n        <Text color=\"yellow\">Tool use rejected</Text>\n      </Box>\n    )\n  }\n\n  try {\n    const rendered = tool.renderToolUseRejectedMessage(...args)\n\n    // Handle null/undefined returns\n    if (rendered === null || rendered === undefined) {\n      return (\n        <Box>\n          <Text color=\"yellow\">{tool.name} rejected</Text>\n        </Box>\n      )\n    }\n\n    return rendered\n  } catch (error) {\n    return <ErrorToolResult error={error} toolName={tool.name} />\n  }\n}\n\n/**\n * Type guard to check if a value is a valid React node.\n */\nexport function isValidReactNode(value: unknown): value is React.ReactNode {\n  if (value === null || value === undefined) {\n    return true // React accepts null/undefined\n  }\n\n  if (\n    typeof value === 'string' ||\n    typeof value === 'number' ||\n    typeof value === 'boolean'\n  ) {\n    return true\n  }\n\n  if (Array.isArray(value)) {\n    return value.every(isValidReactNode)\n  }\n\n  // Check for React element\n  if (typeof value === 'object' && value !== null) {\n    return '$$typeof' in value || React.isValidElement(value)\n  }\n\n  return false\n}\n\n/**\n * Wrap a potentially unsafe render function with error boundaries.\n *\n * @param renderFn - The render function to wrap\n * @param fallback - Fallback content on error\n * @returns A safe render function\n */\nexport function wrapRenderFunction<TArgs extends unknown[]>(\n  renderFn: (...args: TArgs) => React.ReactNode,\n  fallback: React.ReactNode,\n): (...args: TArgs) => React.ReactNode {\n  return (...args: TArgs) => {\n    try {\n      const result = renderFn(...args)\n      if (result === null || result === undefined) {\n        return fallback\n      }\n      return result\n    } catch {\n      return fallback\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/utils/userFriendlyError.js

@@ -0,0 +1,346 @@
+import { randomUUID } from "crypto";
+import * as fs from "fs";
+import * as path from "path";
+import { t, tSafe } from "../i18n/index.js";
+var ErrorCategory = /* @__PURE__ */ ((ErrorCategory2) => {
+  ErrorCategory2["NETWORK_CONNECTION"] = "network_connection";
+  ErrorCategory2["NETWORK_TIMEOUT"] = "network_timeout";
+  ErrorCategory2["NETWORK_DNS"] = "network_dns";
+  ErrorCategory2["API_RATE_LIMIT"] = "api_rate_limit";
+  ErrorCategory2["API_AUTH"] = "api_auth";
+  ErrorCategory2["API_QUOTA"] = "api_quota";
+  ErrorCategory2["API_SERVER_ERROR"] = "api_server_error";
+  ErrorCategory2["API_INVALID_RESPONSE"] = "api_invalid_response";
+  ErrorCategory2["FILE_NOT_FOUND"] = "file_not_found";
+  ErrorCategory2["FILE_PERMISSION"] = "file_permission";
+  ErrorCategory2["FILE_TOO_LARGE"] = "file_too_large";
+  ErrorCategory2["FILE_ENCODING"] = "file_encoding";
+  ErrorCategory2["CONFIG_MISSING"] = "config_missing";
+  ErrorCategory2["CONFIG_INVALID"] = "config_invalid";
+  ErrorCategory2["CONFIG_API_KEY"] = "config_api_key";
+  ErrorCategory2["MODEL_UNAVAILABLE"] = "model_unavailable";
+  ErrorCategory2["MODEL_CONTEXT_LENGTH"] = "model_context_length";
+  ErrorCategory2["MODEL_CONTENT_FILTER"] = "model_content_filter";
+  ErrorCategory2["SYSTEM_MEMORY"] = "system_memory";
+  ErrorCategory2["SYSTEM_PROCESS"] = "system_process";
+  ErrorCategory2["UNKNOWN"] = "unknown";
+  return ErrorCategory2;
+})(ErrorCategory || {});
+const CATEGORY_TO_I18N_PREFIX = {
+  ["network_connection" /* NETWORK_CONNECTION */]: "friendlyError.networkConnection",
+  ["network_timeout" /* NETWORK_TIMEOUT */]: "friendlyError.networkTimeout",
+  ["network_dns" /* NETWORK_DNS */]: "friendlyError.networkDns",
+  ["api_rate_limit" /* API_RATE_LIMIT */]: "friendlyError.apiRateLimit",
+  ["api_auth" /* API_AUTH */]: "friendlyError.apiAuth",
+  ["api_quota" /* API_QUOTA */]: "friendlyError.apiQuota",
+  ["api_server_error" /* API_SERVER_ERROR */]: "friendlyError.apiServerError",
+  ["api_invalid_response" /* API_INVALID_RESPONSE */]: "friendlyError.apiInvalidResponse",
+  ["file_not_found" /* FILE_NOT_FOUND */]: "friendlyError.fileNotFound",
+  ["file_permission" /* FILE_PERMISSION */]: "friendlyError.filePermission",
+  ["file_too_large" /* FILE_TOO_LARGE */]: "friendlyError.fileTooLarge",
+  ["file_encoding" /* FILE_ENCODING */]: "friendlyError.fileEncoding",
+  ["config_missing" /* CONFIG_MISSING */]: "friendlyError.configMissing",
+  ["config_invalid" /* CONFIG_INVALID */]: "friendlyError.configInvalid",
+  ["config_api_key" /* CONFIG_API_KEY */]: "friendlyError.configApiKey",
+  ["model_unavailable" /* MODEL_UNAVAILABLE */]: "friendlyError.modelUnavailable",
+  ["model_context_length" /* MODEL_CONTEXT_LENGTH */]: "friendlyError.modelContextLength",
+  ["model_content_filter" /* MODEL_CONTENT_FILTER */]: "friendlyError.modelContentFilter",
+  ["system_memory" /* SYSTEM_MEMORY */]: "friendlyError.systemMemory",
+  ["system_process" /* SYSTEM_PROCESS */]: "friendlyError.systemProcess",
+  ["unknown" /* UNKNOWN */]: "friendlyError.unknown"
+};
+function getFriendlyMessage(category) {
+  const prefix = CATEGORY_TO_I18N_PREFIX[category];
+  const suggestions = [];
+  for (let i = 1; i <= 3; i++) {
+    const suggestion = tSafe(`${prefix}.suggestion${i}`);
+    if (suggestion) {
+      suggestions.push(suggestion);
+    }
+  }
+  return {
+    title: tSafe(`${prefix}.title`) || category,
+    description: tSafe(`${prefix}.description`) || "",
+    suggestions
+  };
+}
+const FRIENDLY_MESSAGES = Object.fromEntries(
+  Object.values(ErrorCategory).map((category) => [
+    category,
+    getFriendlyMessage(category)
+  ])
+);
+const ERROR_PATTERNS = [
+  // Network errors
+  {
+    category: "network_connection" /* NETWORK_CONNECTION */,
+    patterns: [
+      "socket.*closed",
+      "ECONNREFUSED",
+      "ECONNRESET",
+      "ENOTFOUND",
+      "connection.*refused",
+      "connection.*closed",
+      "network.*error",
+      "fetch failed"
+    ]
+  },
+  {
+    category: "network_timeout" /* NETWORK_TIMEOUT */,
+    patterns: [
+      "timeout",
+      "ETIMEDOUT",
+      "timed out",
+      "deadline exceeded",
+      "request.*timeout"
+    ]
+  },
+  {
+    category: "network_dns" /* NETWORK_DNS */,
+    patterns: ["ENOTFOUND", "getaddrinfo", "DNS", "resolve.*failed"]
+  },
+  // API errors
+  {
+    category: "api_rate_limit" /* API_RATE_LIMIT */,
+    patterns: ["rate.*limit", "429", "too many requests", "quota.*exceeded"]
+  },
+  {
+    category: "api_auth" /* API_AUTH */,
+    patterns: [
+      "401",
+      "unauthorized",
+      "authentication.*failed",
+      "invalid.*key",
+      "api.*key.*invalid"
+    ]
+  },
+  {
+    category: "api_quota" /* API_QUOTA */,
+    patterns: [
+      "insufficient.*quota",
+      "billing",
+      "credit",
+      "exceeded.*quota",
+      "402"
+    ]
+  },
+  {
+    category: "api_server_error" /* API_SERVER_ERROR */,
+    patterns: ["500", "502", "503", "504", "internal.*error", "server.*error"]
+  },
+  // File errors
+  {
+    category: "file_not_found" /* FILE_NOT_FOUND */,
+    patterns: ["ENOENT", "no such file", "file.*not.*found", "does not exist"]
+  },
+  {
+    category: "file_permission" /* FILE_PERMISSION */,
+    patterns: ["EACCES", "EPERM", "permission.*denied", "access.*denied"]
+  },
+  {
+    category: "file_too_large" /* FILE_TOO_LARGE */,
+    patterns: ["file.*too.*large", "EFBIG", "size.*limit"]
+  },
+  // Model errors
+  {
+    category: "model_context_length" /* MODEL_CONTEXT_LENGTH */,
+    patterns: [
+      "context.*length",
+      "token.*limit",
+      "max.*tokens",
+      "too.*long",
+      "exceeds.*maximum"
+    ]
+  },
+  {
+    category: "model_content_filter" /* MODEL_CONTENT_FILTER */,
+    patterns: ["content.*filter", "safety", "blocked", "moderation"]
+  },
+  {
+    category: "model_unavailable" /* MODEL_UNAVAILABLE */,
+    patterns: ["model.*not.*found", "model.*unavailable", "does not exist"]
+  },
+  // Config errors
+  {
+    category: "config_api_key" /* CONFIG_API_KEY */,
+    patterns: [
+      "api.*key.*not.*set",
+      "missing.*api.*key",
+      "ANTHROPIC_API_KEY",
+      "OPENAI_API_KEY"
+    ]
+  },
+  // System errors
+  {
+    category: "system_memory" /* SYSTEM_MEMORY */,
+    patterns: ["ENOMEM", "out of memory", "heap", "memory.*limit"]
+  }
+];
+function classifyError(error) {
+  const errorString = getErrorString(error).toLowerCase();
+  for (const { category, patterns } of ERROR_PATTERNS) {
+    for (const pattern of patterns) {
+      if (typeof pattern === "string") {
+        if (errorString.includes(pattern.toLowerCase())) {
+          return category;
+        }
+      } else if (pattern.test(errorString)) {
+        return category;
+      }
+    }
+  }
+  return "unknown" /* UNKNOWN */;
+}
+function getErrorString(error) {
+  if (error instanceof Error) {
+    return `${error.name}: ${error.message} ${error.stack || ""}`;
+  }
+  return String(error);
+}
+class UserFriendlyError extends Error {
+  id;
+  category;
+  friendlyMessage;
+  originalError;
+  context;
+  timestamp;
+  constructor(originalError, context = {}, categoryOverride) {
+    const category = categoryOverride || classifyError(originalError);
+    const friendly = FRIENDLY_MESSAGES[category];
+    super(friendly.title);
+    this.name = "UserFriendlyError";
+    this.id = randomUUID().slice(0, 8);
+    this.category = category;
+    this.friendlyMessage = friendly;
+    this.originalError = originalError;
+    this.context = context;
+    this.timestamp = /* @__PURE__ */ new Date();
+    if (originalError instanceof Error && originalError.stack) {
+      this.stack = originalError.stack;
+    }
+  }
+  /**
+   * Get user-facing display message
+   */
+  getUserMessage() {
+    const message = getFriendlyMessage(this.category);
+    const suggestionLabel = t("friendlyError.suggestionLabel");
+    const errorIdLabel = t("friendlyError.errorIdLabel");
+    const lines = [
+      `\u26A0\uFE0F ${message.title}`,
+      "",
+      message.description,
+      "",
+      `\u{1F4A1} ${suggestionLabel}:`,
+      ...message.suggestions.map((s) => `  \u2022 ${s}`),
+      "",
+      `\u{1F4CB} ${errorIdLabel}: ${this.id}`
+    ];
+    return lines.join("\n");
+  }
+  /**
+   * Get technical message for developers
+   */
+  getTechnicalMessage() {
+    const original = this.originalError instanceof Error ? this.originalError.message : String(this.originalError);
+    return `[${this.category}] ${original}`;
+  }
+  /**
+   * Create structured log entry
+   */
+  toLogEntry() {
+    return {
+      id: this.id,
+      timestamp: this.timestamp.toISOString(),
+      category: this.category,
+      friendlyTitle: this.friendlyMessage.title,
+      technicalMessage: this.getTechnicalMessage(),
+      stack: this.stack,
+      context: this.context,
+      systemInfo: {
+        platform: process.platform,
+        nodeVersion: process.version,
+        mintoVersion: getMintoVersion()
+      }
+    };
+  }
+}
+let errorLogPath = null;
+function getErrorLogPath() {
+  if (!errorLogPath) {
+    const logDir = path.join(process.env.HOME || "", ".minto", "logs");
+    errorLogPath = path.join(logDir, "errors.jsonl");
+  }
+  return errorLogPath;
+}
+function logUserFriendlyError(error) {
+  try {
+    const logPath = getErrorLogPath();
+    const logDir = path.dirname(logPath);
+    if (!fs.existsSync(logDir)) {
+      fs.mkdirSync(logDir, { recursive: true });
+    }
+    const entry = error.toLogEntry();
+    fs.appendFileSync(logPath, JSON.stringify(entry) + "\n");
+  } catch {
+  }
+}
+function getRecentErrors(limit = 10) {
+  try {
+    const logPath = getErrorLogPath();
+    if (!fs.existsSync(logPath)) {
+      return [];
+    }
+    const content = fs.readFileSync(logPath, "utf-8");
+    const lines = content.trim().split("\n").filter(Boolean);
+    const entries = lines.slice(-limit).map((line) => {
+      try {
+        return JSON.parse(line);
+      } catch {
+        return null;
+      }
+    }).filter((e) => e !== null);
+    return entries.reverse();
+  } catch {
+    return [];
+  }
+}
+function getMintoVersion() {
+  try {
+    const packageJsonPath = path.join(__dirname, "../../package.json");
+    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+    return packageJson.version || "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+function toUserFriendlyError(error, context) {
+  if (error instanceof UserFriendlyError) {
+    return error;
+  }
+  return new UserFriendlyError(error, context);
+}
+function formatErrorForUser(error, options = {}) {
+  const friendly = toUserFriendlyError(error, options.context);
+  logUserFriendlyError(friendly);
+  let message = friendly.getUserMessage();
+  if (options.showTechnical) {
+    const technicalLabel = t("friendlyError.technicalDetailsLabel");
+    message += `
+
+\u{1F527} ${technicalLabel}: ${friendly.getTechnicalMessage()}`;
+  }
+  return message;
+}
+export {
+  ERROR_PATTERNS,
+  ErrorCategory,
+  FRIENDLY_MESSAGES,
+  UserFriendlyError,
+  classifyError,
+  formatErrorForUser,
+  getRecentErrors,
+  logUserFriendlyError,
+  toUserFriendlyError
+};
+//# sourceMappingURL=userFriendlyError.js.map

package/dist/utils/userFriendlyError.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/userFriendlyError.ts"],
+  "sourcesContent": ["/**\n * User-Friendly Error System\n *\n * Transforms technical errors into friendly messages for non-developer users.\n * Provides structured logging for debugging and optional cloud reporting.\n *\n * Design Philosophy:\n * - User layer: Simple, actionable messages in their language\n * - Developer layer: Full technical details for debugging\n * - Operations layer: Structured data for analysis and improvement\n */\n\nimport { randomUUID } from 'crypto'\nimport * as fs from 'fs'\nimport * as path from 'path'\nimport { t, tSafe } from '@i18n/index'\n\n// ============================================================================\n// Error Categories\n// ============================================================================\n\n/**\n * High-level error categories that map to user-understandable concepts\n */\nexport enum ErrorCategory {\n  // Network & Connectivity\n  NETWORK_CONNECTION = 'network_connection', // Can't reach the server\n  NETWORK_TIMEOUT = 'network_timeout', // Request took too long\n  NETWORK_DNS = 'network_dns', // Can't find the server\n\n  // API & Service\n  API_RATE_LIMIT = 'api_rate_limit', // Too many requests\n  API_AUTH = 'api_auth', // Authentication failed\n  API_QUOTA = 'api_quota', // Usage quota exceeded\n  API_SERVER_ERROR = 'api_server_error', // Server is having issues\n  API_INVALID_RESPONSE = 'api_invalid_response', // Unexpected response\n\n  // File & Storage\n  FILE_NOT_FOUND = 'file_not_found', // File doesn't exist\n  FILE_PERMISSION = 'file_permission', // Can't access file\n  FILE_TOO_LARGE = 'file_too_large', // File is too big\n  FILE_ENCODING = 'file_encoding', // Can't read file format\n\n  // Configuration\n  CONFIG_MISSING = 'config_missing', // Missing required setting\n  CONFIG_INVALID = 'config_invalid', // Invalid setting value\n  CONFIG_API_KEY = 'config_api_key', // API key issue\n\n  // Model & AI\n  MODEL_UNAVAILABLE = 'model_unavailable', // Model not accessible\n  MODEL_CONTEXT_LENGTH = 'model_context_length', // Input too long\n  MODEL_CONTENT_FILTER = 'model_content_filter', // Content blocked\n\n  // System\n  SYSTEM_MEMORY = 'system_memory', // Out of memory\n  SYSTEM_PROCESS = 'system_process', // Process error\n\n  // Unknown\n  UNKNOWN = 'unknown', // Unclassified error\n}\n\n// ============================================================================\n// User-Friendly Messages (Multi-language support via i18n)\n// ============================================================================\n\ninterface FriendlyMessage {\n  title: string\n  description: string\n  suggestions: string[]\n}\n\n/**\n * Maps error categories to i18n translation key prefixes\n */\nconst CATEGORY_TO_I18N_PREFIX: Record<ErrorCategory, string> = {\n  [ErrorCategory.NETWORK_CONNECTION]: 'friendlyError.networkConnection',\n  [ErrorCategory.NETWORK_TIMEOUT]: 'friendlyError.networkTimeout',\n  [ErrorCategory.NETWORK_DNS]: 'friendlyError.networkDns',\n  [ErrorCategory.API_RATE_LIMIT]: 'friendlyError.apiRateLimit',\n  [ErrorCategory.API_AUTH]: 'friendlyError.apiAuth',\n  [ErrorCategory.API_QUOTA]: 'friendlyError.apiQuota',\n  [ErrorCategory.API_SERVER_ERROR]: 'friendlyError.apiServerError',\n  [ErrorCategory.API_INVALID_RESPONSE]: 'friendlyError.apiInvalidResponse',\n  [ErrorCategory.FILE_NOT_FOUND]: 'friendlyError.fileNotFound',\n  [ErrorCategory.FILE_PERMISSION]: 'friendlyError.filePermission',\n  [ErrorCategory.FILE_TOO_LARGE]: 'friendlyError.fileTooLarge',\n  [ErrorCategory.FILE_ENCODING]: 'friendlyError.fileEncoding',\n  [ErrorCategory.CONFIG_MISSING]: 'friendlyError.configMissing',\n  [ErrorCategory.CONFIG_INVALID]: 'friendlyError.configInvalid',\n  [ErrorCategory.CONFIG_API_KEY]: 'friendlyError.configApiKey',\n  [ErrorCategory.MODEL_UNAVAILABLE]: 'friendlyError.modelUnavailable',\n  [ErrorCategory.MODEL_CONTEXT_LENGTH]: 'friendlyError.modelContextLength',\n  [ErrorCategory.MODEL_CONTENT_FILTER]: 'friendlyError.modelContentFilter',\n  [ErrorCategory.SYSTEM_MEMORY]: 'friendlyError.systemMemory',\n  [ErrorCategory.SYSTEM_PROCESS]: 'friendlyError.systemProcess',\n  [ErrorCategory.UNKNOWN]: 'friendlyError.unknown',\n}\n\n/**\n * Get friendly message using i18n\n * Designed for non-technical users (analysts, researchers, writers, etc.)\n */\nfunction getFriendlyMessage(category: ErrorCategory): FriendlyMessage {\n  const prefix = CATEGORY_TO_I18N_PREFIX[category]\n\n  // Build suggestions array dynamically (use tSafe to avoid warnings for missing keys)\n  const suggestions: string[] = []\n  for (let i = 1; i <= 3; i++) {\n    const suggestion = tSafe(`${prefix}.suggestion${i}`)\n    if (suggestion) {\n      suggestions.push(suggestion)\n    }\n  }\n\n  return {\n    title: tSafe(`${prefix}.title`) || category,\n    description: tSafe(`${prefix}.description`) || '',\n    suggestions,\n  }\n}\n\n/**\n * Legacy FRIENDLY_MESSAGES for backward compatibility\n * @deprecated Use getFriendlyMessage() for i18n support\n */\nconst FRIENDLY_MESSAGES: Record<ErrorCategory, FriendlyMessage> =\n  Object.fromEntries(\n    Object.values(ErrorCategory).map(category => [\n      category,\n      getFriendlyMessage(category),\n    ]),\n  ) as Record<ErrorCategory, FriendlyMessage>\n\n// ============================================================================\n// Error Classification Logic\n// ============================================================================\n\ninterface ErrorPattern {\n  category: ErrorCategory\n  patterns: (string | RegExp)[]\n}\n\n/**\n * Patterns to classify raw errors into categories\n * Order matters - more specific patterns should come first\n */\nconst ERROR_PATTERNS: ErrorPattern[] = [\n  // Network errors\n  {\n    category: ErrorCategory.NETWORK_CONNECTION,\n    patterns: [\n      'socket.*closed',\n      'ECONNREFUSED',\n      'ECONNRESET',\n      'ENOTFOUND',\n      'connection.*refused',\n      'connection.*closed',\n      'network.*error',\n      'fetch failed',\n    ],\n  },\n  {\n    category: ErrorCategory.NETWORK_TIMEOUT,\n    patterns: [\n      'timeout',\n      'ETIMEDOUT',\n      'timed out',\n      'deadline exceeded',\n      'request.*timeout',\n    ],\n  },\n  {\n    category: ErrorCategory.NETWORK_DNS,\n    patterns: ['ENOTFOUND', 'getaddrinfo', 'DNS', 'resolve.*failed'],\n  },\n\n  // API errors\n  {\n    category: ErrorCategory.API_RATE_LIMIT,\n    patterns: ['rate.*limit', '429', 'too many requests', 'quota.*exceeded'],\n  },\n  {\n    category: ErrorCategory.API_AUTH,\n    patterns: [\n      '401',\n      'unauthorized',\n      'authentication.*failed',\n      'invalid.*key',\n      'api.*key.*invalid',\n    ],\n  },\n  {\n    category: ErrorCategory.API_QUOTA,\n    patterns: [\n      'insufficient.*quota',\n      'billing',\n      'credit',\n      'exceeded.*quota',\n      '402',\n    ],\n  },\n  {\n    category: ErrorCategory.API_SERVER_ERROR,\n    patterns: ['500', '502', '503', '504', 'internal.*error', 'server.*error'],\n  },\n\n  // File errors\n  {\n    category: ErrorCategory.FILE_NOT_FOUND,\n    patterns: ['ENOENT', 'no such file', 'file.*not.*found', 'does not exist'],\n  },\n  {\n    category: ErrorCategory.FILE_PERMISSION,\n    patterns: ['EACCES', 'EPERM', 'permission.*denied', 'access.*denied'],\n  },\n  {\n    category: ErrorCategory.FILE_TOO_LARGE,\n    patterns: ['file.*too.*large', 'EFBIG', 'size.*limit'],\n  },\n\n  // Model errors\n  {\n    category: ErrorCategory.MODEL_CONTEXT_LENGTH,\n    patterns: [\n      'context.*length',\n      'token.*limit',\n      'max.*tokens',\n      'too.*long',\n      'exceeds.*maximum',\n    ],\n  },\n  {\n    category: ErrorCategory.MODEL_CONTENT_FILTER,\n    patterns: ['content.*filter', 'safety', 'blocked', 'moderation'],\n  },\n  {\n    category: ErrorCategory.MODEL_UNAVAILABLE,\n    patterns: ['model.*not.*found', 'model.*unavailable', 'does not exist'],\n  },\n\n  // Config errors\n  {\n    category: ErrorCategory.CONFIG_API_KEY,\n    patterns: [\n      'api.*key.*not.*set',\n      'missing.*api.*key',\n      'ANTHROPIC_API_KEY',\n      'OPENAI_API_KEY',\n    ],\n  },\n\n  // System errors\n  {\n    category: ErrorCategory.SYSTEM_MEMORY,\n    patterns: ['ENOMEM', 'out of memory', 'heap', 'memory.*limit'],\n  },\n]\n\n/**\n * Classifies a raw error into a category\n */\nexport function classifyError(error: unknown): ErrorCategory {\n  const errorString = getErrorString(error).toLowerCase()\n\n  for (const { category, patterns } of ERROR_PATTERNS) {\n    for (const pattern of patterns) {\n      if (typeof pattern === 'string') {\n        if (errorString.includes(pattern.toLowerCase())) {\n          return category\n        }\n      } else if (pattern.test(errorString)) {\n        return category\n      }\n    }\n  }\n\n  return ErrorCategory.UNKNOWN\n}\n\nfunction getErrorString(error: unknown): string {\n  if (error instanceof Error) {\n    return `${error.name}: ${error.message} ${error.stack || ''}`\n  }\n  return String(error)\n}\n\n// ============================================================================\n// User-Friendly Error Class\n// ============================================================================\n\nexport interface ErrorContext {\n  /** Operation being performed (e.g., \"reading file\", \"calling API\") */\n  operation?: string\n  /** Model being used */\n  model?: string\n  /** File path involved */\n  filePath?: string\n  /** API endpoint */\n  endpoint?: string\n  /** Additional context */\n  [key: string]: unknown\n}\n\nexport interface ErrorLogEntry {\n  id: string\n  timestamp: string\n  category: ErrorCategory\n  friendlyTitle: string\n  technicalMessage: string\n  stack?: string\n  context: ErrorContext\n  systemInfo: {\n    platform: string\n    nodeVersion: string\n    mintoVersion: string\n  }\n}\n\n/**\n * User-Friendly Error wrapper\n * Provides both user-facing messages and technical details\n */\nexport class UserFriendlyError extends Error {\n  readonly id: string\n  readonly category: ErrorCategory\n  readonly friendlyMessage: FriendlyMessage\n  readonly originalError: unknown\n  readonly context: ErrorContext\n  readonly timestamp: Date\n\n  constructor(\n    originalError: unknown,\n    context: ErrorContext = {},\n    categoryOverride?: ErrorCategory,\n  ) {\n    const category = categoryOverride || classifyError(originalError)\n    const friendly = FRIENDLY_MESSAGES[category]\n\n    super(friendly.title)\n    this.name = 'UserFriendlyError'\n    this.id = randomUUID().slice(0, 8)\n    this.category = category\n    this.friendlyMessage = friendly\n    this.originalError = originalError\n    this.context = context\n    this.timestamp = new Date()\n\n    // Preserve original stack\n    if (originalError instanceof Error && originalError.stack) {\n      this.stack = originalError.stack\n    }\n  }\n\n  /**\n   * Get user-facing display message\n   */\n  getUserMessage(): string {\n    // Get fresh translations (in case language changed)\n    const message = getFriendlyMessage(this.category)\n    const suggestionLabel = t('friendlyError.suggestionLabel')\n    const errorIdLabel = t('friendlyError.errorIdLabel')\n\n    const lines = [\n      `\u26A0\uFE0F ${message.title}`,\n      '',\n      message.description,\n      '',\n      `\uD83D\uDCA1 ${suggestionLabel}:`,\n      ...message.suggestions.map(s => `  \u2022 ${s}`),\n      '',\n      `\uD83D\uDCCB ${errorIdLabel}: ${this.id}`,\n    ]\n    return lines.join('\\n')\n  }\n\n  /**\n   * Get technical message for developers\n   */\n  getTechnicalMessage(): string {\n    const original =\n      this.originalError instanceof Error\n        ? this.originalError.message\n        : String(this.originalError)\n    return `[${this.category}] ${original}`\n  }\n\n  /**\n   * Create structured log entry\n   */\n  toLogEntry(): ErrorLogEntry {\n    return {\n      id: this.id,\n      timestamp: this.timestamp.toISOString(),\n      category: this.category,\n      friendlyTitle: this.friendlyMessage.title,\n      technicalMessage: this.getTechnicalMessage(),\n      stack: this.stack,\n      context: this.context,\n      systemInfo: {\n        platform: process.platform,\n        nodeVersion: process.version,\n        mintoVersion: getMintoVersion(),\n      },\n    }\n  }\n}\n\n// ============================================================================\n// Error Logging\n// ============================================================================\n\nlet errorLogPath: string | null = null\n\nfunction getErrorLogPath(): string {\n  if (!errorLogPath) {\n    const logDir = path.join(process.env.HOME || '', '.minto', 'logs')\n    errorLogPath = path.join(logDir, 'errors.jsonl')\n  }\n  return errorLogPath\n}\n\n/**\n * Log error to local file (JSONL format for easy analysis)\n */\nexport function logUserFriendlyError(error: UserFriendlyError): void {\n  try {\n    const logPath = getErrorLogPath()\n    const logDir = path.dirname(logPath)\n\n    // Ensure log directory exists\n    if (!fs.existsSync(logDir)) {\n      fs.mkdirSync(logDir, { recursive: true })\n    }\n\n    const entry = error.toLogEntry()\n    fs.appendFileSync(logPath, JSON.stringify(entry) + '\\n')\n  } catch {\n    // Silent fail - don't let logging errors break the app\n  }\n}\n\n/**\n * Get recent errors for debugging\n */\nexport function getRecentErrors(limit = 10): ErrorLogEntry[] {\n  try {\n    const logPath = getErrorLogPath()\n    if (!fs.existsSync(logPath)) {\n      return []\n    }\n\n    const content = fs.readFileSync(logPath, 'utf-8')\n    const lines = content.trim().split('\\n').filter(Boolean)\n    const entries = lines\n      .slice(-limit)\n      .map(line => {\n        try {\n          return JSON.parse(line) as ErrorLogEntry\n        } catch {\n          return null\n        }\n      })\n      .filter((e): e is ErrorLogEntry => e !== null)\n\n    return entries.reverse()\n  } catch {\n    return []\n  }\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\nfunction getMintoVersion(): string {\n  try {\n    const packageJsonPath = path.join(__dirname, '../../package.json')\n    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'))\n    return packageJson.version || 'unknown'\n  } catch {\n    return 'unknown'\n  }\n}\n\n/**\n * Wrap any error into a UserFriendlyError\n */\nexport function toUserFriendlyError(\n  error: unknown,\n  context?: ErrorContext,\n): UserFriendlyError {\n  if (error instanceof UserFriendlyError) {\n    return error\n  }\n  return new UserFriendlyError(error, context)\n}\n\n/**\n * Format error for display to user\n * Returns the friendly message, optionally with technical details\n */\nexport function formatErrorForUser(\n  error: unknown,\n  options: { showTechnical?: boolean; context?: ErrorContext } = {},\n): string {\n  const friendly = toUserFriendlyError(error, options.context)\n\n  // Log the error\n  logUserFriendlyError(friendly)\n\n  let message = friendly.getUserMessage()\n\n  if (options.showTechnical) {\n    const technicalLabel = t('friendlyError.technicalDetailsLabel')\n    message += `\\n\\n\uD83D\uDD27 ${technicalLabel}: ${friendly.getTechnicalMessage()}`\n  }\n\n  return message\n}\n\n// ============================================================================\n// Exports for Integration\n// ============================================================================\n\nexport { FRIENDLY_MESSAGES, ERROR_PATTERNS }\n"],
+  "mappings": "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",
+  "names": ["ErrorCategory"]
+}

package/dist/version.js

@@ -1,5 +1,5 @@
-const VERSION = "0.1.6";
-const BUILD_DATE = "2025-12-30T04:03:47.920Z";
+const VERSION = "0.2.0";
+const BUILD_DATE = "2026-01-30T12:44:29.956Z";
 export {
   BUILD_DATE,
   VERSION

package/dist/version.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/version.ts"],
-  "sourcesContent": ["/**\n * Application version\n * This file is auto-generated during build process\n */\n\nexport const VERSION = '0.1.6'\nexport const BUILD_DATE = '2025-12-30T04:03:47.920Z'\n"],
+  "sourcesContent": ["/**\n * Application version\n * This file is auto-generated during build process\n */\n\nexport const VERSION = '0.2.0'\nexport const BUILD_DATE = '2026-01-30T12:44:29.956Z'\n"],
   "mappings": "AAKO,MAAM,UAAU;AAChB,MAAM,aAAa;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@within-7/minto",
-  "version": "0.1.6",
+  "version": "0.2.0",
   "bin": {
     "minto": "cli.js"
   },
@@ -27,7 +27,8 @@
   "scripts": {
     "dev": "bun run ./src/entrypoints/cli.tsx --verbose",
     "build": "node scripts/build.mjs",
-    "clean": "rm -rf cli.js",
+    "build:packages": "node scripts/build-platform-packages.mjs",
+    "clean": "rm -rf cli.js binaries packages",
     "prepublishOnly": "node scripts/build.mjs && node scripts/prepublish-check.js",
     "postinstall": "node scripts/postinstall.js || true",
     "format": "prettier --write \"src/**/*.{ts,tsx,js,jsx,json}\"",
@@ -37,9 +38,17 @@
     "test": "cd tests && bun test",
     "typecheck": "tsc --noEmit",
     "prepare": "",
+    "publish:packages": "node scripts/publish-platform-packages.mjs",
     "publish:dev": "node scripts/publish-dev.js",
     "publish:release": "node scripts/publish-release.js"
   },
+  "optionalDependencies": {
+    "@within-7/minto-darwin-arm64": "0.2.0",
+    "@within-7/minto-darwin-x64": "0.2.0",
+    "@within-7/minto-linux-arm64": "0.2.0",
+    "@within-7/minto-linux-x64": "0.2.0",
+    "@within-7/minto-win32-x64": "0.2.0"
+  },
   "dependencies": {
     "@anthropic-ai/bedrock-sdk": "^0.12.6",
     "@anthropic-ai/sdk": "^0.39.0",
@@ -49,7 +58,6 @@
     "@modelcontextprotocol/sdk": "^1.15.1",
     "@types/lodash-es": "^4.17.12",
     "@types/react": "^19.1.8",
-    "@within-7/minto": "0.1.5",
     "ansi-escapes": "^7.0.0",
     "chalk": "^5.4.1",
     "cli-highlight": "^2.1.11",
@@ -70,6 +78,7 @@
     "lodash-es": "^4.17.21",
     "lru-cache": "^11.1.0",
     "marked": "^15.0.12",
+    "minimatch": "10.1.1",
     "nanoid": "^5.1.5",
     "node-fetch": "^3.3.2",
     "node-html-parser": "^7.0.1",
@@ -92,6 +101,7 @@
   "devDependencies": {
     "@types/bun": "latest",
     "@types/jest": "^30.0.0",
+    "@types/minimatch": "6.0.0",
     "@types/node": "^24.1.0",
     "bun-types": "latest",
     "esbuild": "^0.25.9",
@@ -112,4 +122,4 @@
     "formdata-node": "^6.0.3",
     "node-domexception": "npm:domexception@^4.0.0"
   }
-}
+}