@within-7/minto 0.4.2 → 0.4.3

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

@@ -1,7 +0,0 @@
-{
-  "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'\nimport { SEMANTIC_COLORS } from '@constants/colors'\n\n/**\n * Default tool result component when tool doesn't provide a renderer.\n *\n * This is used as a fallback when:\n * 1. Tool is not found (e.g., MCP tool no longer available)\n * 2. Tool doesn't have a renderToolResultMessage method\n * 3. Tool's renderToolResultMessage returns null/undefined\n *\n * For better UX, we display a simple success message instead of raw JSON data,\n * which can be confusing for users.\n */\nexport function DefaultToolResult({\n  output,\n}: {\n  output: unknown\n}): React.ReactElement {\n  // For objects (like tool data), show a simple success message\n  // instead of raw JSON which can be confusing\n  if (output !== null && output !== undefined && typeof output === 'object') {\n    // Try to extract meaningful info from the object\n    const obj = output as Record<string, unknown>\n\n    // Check for common success indicators\n    if ('success' in obj || 'result' in obj || 'data' in obj) {\n      return (\n        <Box flexDirection=\"row\">\n          <Text>&nbsp;&nbsp;\u23BF &nbsp;</Text>\n          <Text color={SEMANTIC_COLORS.success}>Done</Text>\n        </Box>\n      )\n    }\n\n    // For other objects, show a generic completion message\n    return (\n      <Box flexDirection=\"row\">\n        <Text>&nbsp;&nbsp;\u23BF &nbsp;</Text>\n        <Text color={SEMANTIC_COLORS.success}>Completed</Text>\n      </Box>\n    )\n  }\n\n  // For strings, show the content (truncated if too long)\n  if (typeof output === 'string') {\n    const displayContent =\n      output.length > 500 ? output.slice(0, 500) + '...' : output\n    return (\n      <Box flexDirection=\"column\">\n        <Text color={SEMANTIC_COLORS.dim}>{displayContent}</Text>\n      </Box>\n    )\n  }\n\n  // For null/undefined, show no output message\n  if (output === null || output === undefined) {\n    return (\n      <Box flexDirection=\"row\">\n        <Text>&nbsp;&nbsp;\u23BF &nbsp;</Text>\n        <Text color={SEMANTIC_COLORS.dim}>(no output)</Text>\n      </Box>\n    )\n  }\n\n  // For other primitives, convert to string\n  return (\n    <Box flexDirection=\"column\">\n      <Text color={SEMANTIC_COLORS.dim}>{String(output)}</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 color={SEMANTIC_COLORS.dim}>{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 color={SEMANTIC_COLORS.dim}>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 color={SEMANTIC_COLORS.dim}>\n              {' '}\n              {JSON.stringify(input).slice(0, 100)}\n            </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": "AASA,YAAY,WAAW;AACvB,SAAS,KAAK,YAAY;AAE1B,SAAS,uBAAuB;AAazB,SAAS,kBAAkB;AAAA,EAChC;AACF,GAEuB;AAGrB,MAAI,WAAW,QAAQ,WAAW,UAAa,OAAO,WAAW,UAAU;AAEzE,UAAM,MAAM;AAGZ,QAAI,aAAa,OAAO,YAAY,OAAO,UAAU,KAAK;AACxD,aACE,oCAAC,OAAI,eAAc,SACjB,oCAAC,YAAK,qBAAoB,GAC1B,oCAAC,QAAK,OAAO,gBAAgB,WAAS,MAAI,CAC5C;AAAA,IAEJ;AAGA,WACE,oCAAC,OAAI,eAAc,SACjB,oCAAC,YAAK,qBAAoB,GAC1B,oCAAC,QAAK,OAAO,gBAAgB,WAAS,WAAS,CACjD;AAAA,EAEJ;AAGA,MAAI,OAAO,WAAW,UAAU;AAC9B,UAAM,iBACJ,OAAO,SAAS,MAAM,OAAO,MAAM,GAAG,GAAG,IAAI,QAAQ;AACvD,WACE,oCAAC,OAAI,eAAc,YACjB,oCAAC,QAAK,OAAO,gBAAgB,OAAM,cAAe,CACpD;AAAA,EAEJ;AAGA,MAAI,WAAW,QAAQ,WAAW,QAAW;AAC3C,WACE,oCAAC,OAAI,eAAc,SACjB,oCAAC,YAAK,qBAAoB,GAC1B,oCAAC,QAAK,OAAO,gBAAgB,OAAK,aAAW,CAC/C;AAAA,EAEJ;AAGA,SACE,oCAAC,OAAI,eAAc,YACjB,oCAAC,QAAK,OAAO,gBAAgB,OAAM,OAAO,MAAM,CAAE,CACpD;AAEJ;AAKO,SAAS,gBAAgB;AAAA,EAC9B;AAAA,EACA;AACF,GAGuB;AACrB,QAAM,eACJ,iBAAiB,QAAQ,MAAM,UAAU,OAAO,SAAS,eAAe;AAE1E,SACE,oCAAC,OAAI,eAAc,YACjB,oCAAC,QAAK,OAAM,SACT,WAAW,IAAI,QAAQ,OAAO,IAAG,yBACpC,GACA,oCAAC,QAAK,OAAO,gBAAgB,OAAM,YAAa,CAClD;AAEJ;AAUO,SAAS,qBACd,MACA,QACA,SACiB;AAEjB,MAAI,CAAC,MAAM;AACT,WAAO,oCAAC,qBAAkB,QAAgB;AAAA,EAC5C;AAGA,MAAI,CAAC,KAAK,yBAAyB;AACjC,WAAO,oCAAC,qBAAkB,QAAgB;AAAA,EAC5C;AAEA,MAAI;AACF,UAAM,WAAW,KAAK,wBAAwB,QAAQ,OAAO;AAG7D,QAAI,aAAa,QAAQ,aAAa,QAAW;AAC/C,aAAO,oCAAC,qBAAkB,QAAgB;AAAA,IAC5C;AAEA,WAAO;AAAA,EACT,SAAS,OAAO;AAEd,WAAO,oCAAC,mBAAgB,OAAc,UAAU,KAAK,MAAM;AAAA,EAC7D;AACF;AAUO,SAAS,yBACd,MACA,OACA,SACiB;AAEjB,MAAI,CAAC,MAAM;AACT,WACE,oCAAC,WACC,oCAAC,QAAK,OAAO,gBAAgB,OAAK,mBAAiB,CACrD;AAAA,EAEJ;AAGA,MAAI,CAAC,KAAK,sBAAsB;AAC9B,WACE,oCAAC,WACC,oCAAC,YACC,oCAAC,QAAK,OAAM,UAAQ,KAAK,IAAK,GAC7B,QAAQ,WACP,oCAAC,QAAK,OAAO,gBAAgB,OAC1B,KACA,KAAK,UAAU,KAAK,EAAE,MAAM,GAAG,GAAG,CACrC,CAEJ,CACF;AAAA,EAEJ;AAEA,MAAI;AACF,UAAM,WAAW,KAAK,qBAAqB,OAAO,OAAO;AAGzD,QAAI,aAAa,QAAQ,aAAa,QAAW;AAC/C,aACE,oCAAC,WACC,oCAAC,QAAK,OAAM,UAAQ,KAAK,IAAK,CAChC;AAAA,IAEJ;AAEA,WAAO;AAAA,EACT,SAAS,OAAO;AACd,WAAO,oCAAC,mBAAgB,OAAc,UAAU,KAAK,MAAM;AAAA,EAC7D;AACF;AASO,SAAS,8BACd,SACG,MACc;AAEjB,MAAI,CAAC,QAAQ,CAAC,KAAK,8BAA8B;AAC/C,WACE,oCAAC,WACC,oCAAC,QAAK,OAAM,YAAS,mBAAiB,CACxC;AAAA,EAEJ;AAEA,MAAI;AACF,UAAM,WAAW,KAAK,6BAA6B,GAAG,IAAI;AAG1D,QAAI,aAAa,QAAQ,aAAa,QAAW;AAC/C,aACE,oCAAC,WACC,oCAAC,QAAK,OAAM,YAAU,KAAK,MAAK,WAAS,CAC3C;AAAA,IAEJ;AAEA,WAAO;AAAA,EACT,SAAS,OAAO;AACd,WAAO,oCAAC,mBAAgB,OAAc,UAAU,KAAK,MAAM;AAAA,EAC7D;AACF;AAKO,SAAS,iBAAiB,OAA0C;AACzE,MAAI,UAAU,QAAQ,UAAU,QAAW;AACzC,WAAO;AAAA,EACT;AAEA,MACE,OAAO,UAAU,YACjB,OAAO,UAAU,YACjB,OAAO,UAAU,WACjB;AACA,WAAO;AAAA,EACT;AAEA,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM,MAAM,gBAAgB;AAAA,EACrC;AAGA,MAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,WAAO,cAAc,SAAS,MAAM,eAAe,KAAK;AAAA,EAC1D;AAEA,SAAO;AACT;AASO,SAAS,mBACd,UACA,UACqC;AACrC,SAAO,IAAI,SAAgB;AACzB,QAAI;AACF,YAAM,SAAS,SAAS,GAAG,IAAI;AAC/B,UAAI,WAAW,QAAQ,WAAW,QAAW;AAC3C,eAAO;AAAA,MACT;AACA,aAAO;AAAA,IACT,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACF;",
-  "names": []
-}

package/dist/utils/tooling/toolError.js

@@ -1,12 +0,0 @@
-function createToolErrorResult(error, prefix) {
-  const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
-  return {
-    type: "result",
-    data: { error: errorMessage },
-    resultForAssistant: `${prefix}: ${errorMessage}`
-  };
-}
-export {
-  createToolErrorResult
-};
-//# sourceMappingURL=toolError.js.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/utils/tooling/toolError.ts"],
-  "sourcesContent": ["/**\n * Shared utility for creating consistent tool error results.\n */\nexport function createToolErrorResult(error: unknown, prefix: string) {\n  const errorMessage =\n    error instanceof Error ? error.message : 'Unknown error occurred'\n  return {\n    type: 'result' as const,\n    data: { error: errorMessage },\n    resultForAssistant: `${prefix}: ${errorMessage}`,\n  }\n}\n"],
-  "mappings": "AAGO,SAAS,sBAAsB,OAAgB,QAAgB;AACpE,QAAM,eACJ,iBAAiB,QAAQ,MAAM,UAAU;AAC3C,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,EAAE,OAAO,aAAa;AAAA,IAC5B,oBAAoB,GAAG,MAAM,KAAK,YAAY;AAAA,EAChD;AACF;",
-  "names": []
-}

package/dist/utils/unaryLogging.js

@@ -1,6 +0,0 @@
-function logUnaryEvent(event) {
-}
-export {
-  logUnaryEvent
-};
-//# sourceMappingURL=unaryLogging.js.map

package/dist/utils/unaryLogging.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/utils/unaryLogging.ts"],
-  "sourcesContent": ["export type CompletionType =\n  | 'str_replace_single'\n  | 'write_file_single'\n  | 'tool_use_single'\n\ntype LogEvent = {\n  completion_type: CompletionType\n  event: 'accept' | 'reject' | 'response'\n  metadata: {\n    language_name: string\n    message_id: string\n    platform: string\n  }\n}\n\nexport function logUnaryEvent(event: LogEvent): void {\n  // intentionally no-op\n}\n"],
-  "mappings": "AAeO,SAAS,cAAc,OAAuB;AAErD;",
-  "names": []
-}

package/dist/utils/user.js

@@ -1,40 +0,0 @@
-import { getGlobalConfig, getOrCreateUserID } from "./config.js";
-import { memoize } from "lodash-es";
-import { env } from "./env.js";
-import { execFileNoThrow } from "./execFileNoThrow.js";
-import { logError, SESSION_ID } from "./log.js";
-import { MACRO } from "../constants/macros.js";
-const getGitEmail = memoize(async () => {
-  const result = await execFileNoThrow("git", ["config", "user.email"]);
-  if (result.code !== 0) {
-    logError(`Failed to get git email: ${result.stdout} ${result.stderr}`);
-    return void 0;
-  }
-  return result.stdout.trim() || void 0;
-});
-const getUser = memoize(async () => {
-  const userID = getOrCreateUserID();
-  const config = getGlobalConfig();
-  const email = void 0;
-  return {
-    customIDs: {
-      // for session level tests
-      sessionId: SESSION_ID
-    },
-    userID,
-    appVersion: MACRO.VERSION,
-    userAgent: env.platform,
-    email,
-    custom: {
-      nodeVersion: env.nodeVersion,
-      userType: process.env.USER_TYPE,
-      organizationUuid: config.oauthAccount?.organizationUuid,
-      accountUuid: config.oauthAccount?.accountUuid
-    }
-  };
-});
-export {
-  getGitEmail,
-  getUser
-};
-//# sourceMappingURL=user.js.map

package/dist/utils/user.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/utils/user.ts"],
-  "sourcesContent": ["import { getGlobalConfig, getOrCreateUserID } from './config'\nimport { memoize } from 'lodash-es'\nimport { env } from './env'\nimport { execFileNoThrow } from './execFileNoThrow'\nimport { logError, SESSION_ID } from './log'\nimport { MACRO } from '@constants/macros'\nexport const getGitEmail = memoize(async (): Promise<string | undefined> => {\n  const result = await execFileNoThrow('git', ['config', 'user.email'])\n  if (result.code !== 0) {\n    logError(`Failed to get git email: ${result.stdout} ${result.stderr}`)\n    return undefined\n  }\n  return result.stdout.trim() || undefined\n})\n\ntype SimpleUser = {\n  customIDs?: Record<string, string>\n  userID: string\n  appVersion?: string\n  userAgent?: string\n  email?: string\n  custom?: Record<string, unknown>\n}\n\nexport const getUser = memoize(async (): Promise<SimpleUser> => {\n  const userID = getOrCreateUserID()\n  const config = getGlobalConfig()\n  const email = undefined\n  return {\n    customIDs: {\n      // for session level tests\n      sessionId: SESSION_ID,\n    },\n    userID,\n    appVersion: MACRO.VERSION,\n    userAgent: env.platform,\n    email,\n    custom: {\n      nodeVersion: env.nodeVersion,\n      userType: process.env.USER_TYPE,\n      organizationUuid: config.oauthAccount?.organizationUuid,\n      accountUuid: config.oauthAccount?.accountUuid,\n    },\n  }\n})\n"],
-  "mappings": "AAAA,SAAS,iBAAiB,yBAAyB;AACnD,SAAS,eAAe;AACxB,SAAS,WAAW;AACpB,SAAS,uBAAuB;AAChC,SAAS,UAAU,kBAAkB;AACrC,SAAS,aAAa;AACf,MAAM,cAAc,QAAQ,YAAyC;AAC1E,QAAM,SAAS,MAAM,gBAAgB,OAAO,CAAC,UAAU,YAAY,CAAC;AACpE,MAAI,OAAO,SAAS,GAAG;AACrB,aAAS,4BAA4B,OAAO,MAAM,IAAI,OAAO,MAAM,EAAE;AACrE,WAAO;AAAA,EACT;AACA,SAAO,OAAO,OAAO,KAAK,KAAK;AACjC,CAAC;AAWM,MAAM,UAAU,QAAQ,YAAiC;AAC9D,QAAM,SAAS,kBAAkB;AACjC,QAAM,SAAS,gBAAgB;AAC/B,QAAM,QAAQ;AACd,SAAO;AAAA,IACL,WAAW;AAAA;AAAA,MAET,WAAW;AAAA,IACb;AAAA,IACA;AAAA,IACA,YAAY,MAAM;AAAA,IAClB,WAAW,IAAI;AAAA,IACf;AAAA,IACA,QAAQ;AAAA,MACN,aAAa,IAAI;AAAA,MACjB,UAAU,QAAQ,IAAI;AAAA,MACtB,kBAAkB,OAAO,cAAc;AAAA,MACvC,aAAa,OAAO,cAAc;AAAA,IACpC;AAAA,EACF;AACF,CAAC;",
-  "names": []
-}

package/dist/utils/userFriendlyError.js

@@ -1,346 +0,0 @@
-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

@@ -1,7 +0,0 @@
-{
-  "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": "AAYA,SAAS,kBAAkB;AAC3B,YAAY,QAAQ;AACpB,YAAY,UAAU;AACtB,SAAS,GAAG,aAAa;AASlB,IAAK,gBAAL,kBAAKA,mBAAL;AAEL,EAAAA,eAAA,wBAAqB;AACrB,EAAAA,eAAA,qBAAkB;AAClB,EAAAA,eAAA,iBAAc;AAGd,EAAAA,eAAA,oBAAiB;AACjB,EAAAA,eAAA,cAAW;AACX,EAAAA,eAAA,eAAY;AACZ,EAAAA,eAAA,sBAAmB;AACnB,EAAAA,eAAA,0BAAuB;AAGvB,EAAAA,eAAA,oBAAiB;AACjB,EAAAA,eAAA,qBAAkB;AAClB,EAAAA,eAAA,oBAAiB;AACjB,EAAAA,eAAA,mBAAgB;AAGhB,EAAAA,eAAA,oBAAiB;AACjB,EAAAA,eAAA,oBAAiB;AACjB,EAAAA,eAAA,oBAAiB;AAGjB,EAAAA,eAAA,uBAAoB;AACpB,EAAAA,eAAA,0BAAuB;AACvB,EAAAA,eAAA,0BAAuB;AAGvB,EAAAA,eAAA,mBAAgB;AAChB,EAAAA,eAAA,oBAAiB;AAGjB,EAAAA,eAAA,aAAU;AAlCA,SAAAA;AAAA,GAAA;AAkDZ,MAAM,0BAAyD;AAAA,EAC7D,CAAC,6CAAgC,GAAG;AAAA,EACpC,CAAC,uCAA6B,GAAG;AAAA,EACjC,CAAC,+BAAyB,GAAG;AAAA,EAC7B,CAAC,qCAA4B,GAAG;AAAA,EAChC,CAAC,yBAAsB,GAAG;AAAA,EAC1B,CAAC,2BAAuB,GAAG;AAAA,EAC3B,CAAC,yCAA8B,GAAG;AAAA,EAClC,CAAC,iDAAkC,GAAG;AAAA,EACtC,CAAC,qCAA4B,GAAG;AAAA,EAChC,CAAC,uCAA6B,GAAG;AAAA,EACjC,CAAC,qCAA4B,GAAG;AAAA,EAChC,CAAC,mCAA2B,GAAG;AAAA,EAC/B,CAAC,qCAA4B,GAAG;AAAA,EAChC,CAAC,qCAA4B,GAAG;AAAA,EAChC,CAAC,qCAA4B,GAAG;AAAA,EAChC,CAAC,2CAA+B,GAAG;AAAA,EACnC,CAAC,iDAAkC,GAAG;AAAA,EACtC,CAAC,iDAAkC,GAAG;AAAA,EACtC,CAAC,mCAA2B,GAAG;AAAA,EAC/B,CAAC,qCAA4B,GAAG;AAAA,EAChC,CAAC,uBAAqB,GAAG;AAC3B;AAMA,SAAS,mBAAmB,UAA0C;AACpE,QAAM,SAAS,wBAAwB,QAAQ;AAG/C,QAAM,cAAwB,CAAC;AAC/B,WAAS,IAAI,GAAG,KAAK,GAAG,KAAK;AAC3B,UAAM,aAAa,MAAM,GAAG,MAAM,cAAc,CAAC,EAAE;AACnD,QAAI,YAAY;AACd,kBAAY,KAAK,UAAU;AAAA,IAC7B;AAAA,EACF;AAEA,SAAO;AAAA,IACL,OAAO,MAAM,GAAG,MAAM,QAAQ,KAAK;AAAA,IACnC,aAAa,MAAM,GAAG,MAAM,cAAc,KAAK;AAAA,IAC/C;AAAA,EACF;AACF;AAMA,MAAM,oBACJ,OAAO;AAAA,EACL,OAAO,OAAO,aAAa,EAAE,IAAI,cAAY;AAAA,IAC3C;AAAA,IACA,mBAAmB,QAAQ;AAAA,EAC7B,CAAC;AACH;AAeF,MAAM,iBAAiC;AAAA;AAAA,EAErC;AAAA,IACE,UAAU;AAAA,IACV,UAAU;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EACA;AAAA,IACE,UAAU;AAAA,IACV,UAAU;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EACA;AAAA,IACE,UAAU;AAAA,IACV,UAAU,CAAC,aAAa,eAAe,OAAO,iBAAiB;AAAA,EACjE;AAAA;AAAA,EAGA;AAAA,IACE,UAAU;AAAA,IACV,UAAU,CAAC,eAAe,OAAO,qBAAqB,iBAAiB;AAAA,EACzE;AAAA,EACA;AAAA,IACE,UAAU;AAAA,IACV,UAAU;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EACA;AAAA,IACE,UAAU;AAAA,IACV,UAAU;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EACA;AAAA,IACE,UAAU;AAAA,IACV,UAAU,CAAC,OAAO,OAAO,OAAO,OAAO,mBAAmB,eAAe;AAAA,EAC3E;AAAA;AAAA,EAGA;AAAA,IACE,UAAU;AAAA,IACV,UAAU,CAAC,UAAU,gBAAgB,oBAAoB,gBAAgB;AAAA,EAC3E;AAAA,EACA;AAAA,IACE,UAAU;AAAA,IACV,UAAU,CAAC,UAAU,SAAS,sBAAsB,gBAAgB;AAAA,EACtE;AAAA,EACA;AAAA,IACE,UAAU;AAAA,IACV,UAAU,CAAC,oBAAoB,SAAS,aAAa;AAAA,EACvD;AAAA;AAAA,EAGA;AAAA,IACE,UAAU;AAAA,IACV,UAAU;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EACA;AAAA,IACE,UAAU;AAAA,IACV,UAAU,CAAC,mBAAmB,UAAU,WAAW,YAAY;AAAA,EACjE;AAAA,EACA;AAAA,IACE,UAAU;AAAA,IACV,UAAU,CAAC,qBAAqB,sBAAsB,gBAAgB;AAAA,EACxE;AAAA;AAAA,EAGA;AAAA,IACE,UAAU;AAAA,IACV,UAAU;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA;AAAA,IACE,UAAU;AAAA,IACV,UAAU,CAAC,UAAU,iBAAiB,QAAQ,eAAe;AAAA,EAC/D;AACF;AAKO,SAAS,cAAc,OAA+B;AAC3D,QAAM,cAAc,eAAe,KAAK,EAAE,YAAY;AAEtD,aAAW,EAAE,UAAU,SAAS,KAAK,gBAAgB;AACnD,eAAW,WAAW,UAAU;AAC9B,UAAI,OAAO,YAAY,UAAU;AAC/B,YAAI,YAAY,SAAS,QAAQ,YAAY,CAAC,GAAG;AAC/C,iBAAO;AAAA,QACT;AAAA,MACF,WAAW,QAAQ,KAAK,WAAW,GAAG;AACpC,eAAO;AAAA,MACT;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,eAAe,OAAwB;AAC9C,MAAI,iBAAiB,OAAO;AAC1B,WAAO,GAAG,MAAM,IAAI,KAAK,MAAM,OAAO,IAAI,MAAM,SAAS,EAAE;AAAA,EAC7D;AACA,SAAO,OAAO,KAAK;AACrB;AAsCO,MAAM,0BAA0B,MAAM;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAET,YACE,eACA,UAAwB,CAAC,GACzB,kBACA;AACA,UAAM,WAAW,oBAAoB,cAAc,aAAa;AAChE,UAAM,WAAW,kBAAkB,QAAQ;AAE3C,UAAM,SAAS,KAAK;AACpB,SAAK,OAAO;AACZ,SAAK,KAAK,WAAW,EAAE,MAAM,GAAG,CAAC;AACjC,SAAK,WAAW;AAChB,SAAK,kBAAkB;AACvB,SAAK,gBAAgB;AACrB,SAAK,UAAU;AACf,SAAK,YAAY,oBAAI,KAAK;AAG1B,QAAI,yBAAyB,SAAS,cAAc,OAAO;AACzD,WAAK,QAAQ,cAAc;AAAA,IAC7B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,iBAAyB;AAEvB,UAAM,UAAU,mBAAmB,KAAK,QAAQ;AAChD,UAAM,kBAAkB,EAAE,+BAA+B;AACzD,UAAM,eAAe,EAAE,4BAA4B;AAEnD,UAAM,QAAQ;AAAA,MACZ,gBAAM,QAAQ,KAAK;AAAA,MACnB;AAAA,MACA,QAAQ;AAAA,MACR;AAAA,MACA,aAAM,eAAe;AAAA,MACrB,GAAG,QAAQ,YAAY,IAAI,OAAK,YAAO,CAAC,EAAE;AAAA,MAC1C;AAAA,MACA,aAAM,YAAY,KAAK,KAAK,EAAE;AAAA,IAChC;AACA,WAAO,MAAM,KAAK,IAAI;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA,EAKA,sBAA8B;AAC5B,UAAM,WACJ,KAAK,yBAAyB,QAC1B,KAAK,cAAc,UACnB,OAAO,KAAK,aAAa;AAC/B,WAAO,IAAI,KAAK,QAAQ,KAAK,QAAQ;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA,EAKA,aAA4B;AAC1B,WAAO;AAAA,MACL,IAAI,KAAK;AAAA,MACT,WAAW,KAAK,UAAU,YAAY;AAAA,MACtC,UAAU,KAAK;AAAA,MACf,eAAe,KAAK,gBAAgB;AAAA,MACpC,kBAAkB,KAAK,oBAAoB;AAAA,MAC3C,OAAO,KAAK;AAAA,MACZ,SAAS,KAAK;AAAA,MACd,YAAY;AAAA,QACV,UAAU,QAAQ;AAAA,QAClB,aAAa,QAAQ;AAAA,QACrB,cAAc,gBAAgB;AAAA,MAChC;AAAA,IACF;AAAA,EACF;AACF;AAMA,IAAI,eAA8B;AAElC,SAAS,kBAA0B;AACjC,MAAI,CAAC,cAAc;AACjB,UAAM,SAAS,KAAK,KAAK,QAAQ,IAAI,QAAQ,IAAI,UAAU,MAAM;AACjE,mBAAe,KAAK,KAAK,QAAQ,cAAc;AAAA,EACjD;AACA,SAAO;AACT;AAKO,SAAS,qBAAqB,OAAgC;AACnE,MAAI;AACF,UAAM,UAAU,gBAAgB;AAChC,UAAM,SAAS,KAAK,QAAQ,OAAO;AAGnC,QAAI,CAAC,GAAG,WAAW,MAAM,GAAG;AAC1B,SAAG,UAAU,QAAQ,EAAE,WAAW,KAAK,CAAC;AAAA,IAC1C;AAEA,UAAM,QAAQ,MAAM,WAAW;AAC/B,OAAG,eAAe,SAAS,KAAK,UAAU,KAAK,IAAI,IAAI;AAAA,EACzD,QAAQ;AAAA,EAER;AACF;AAKO,SAAS,gBAAgB,QAAQ,IAAqB;AAC3D,MAAI;AACF,UAAM,UAAU,gBAAgB;AAChC,QAAI,CAAC,GAAG,WAAW,OAAO,GAAG;AAC3B,aAAO,CAAC;AAAA,IACV;AAEA,UAAM,UAAU,GAAG,aAAa,SAAS,OAAO;AAChD,UAAM,QAAQ,QAAQ,KAAK,EAAE,MAAM,IAAI,EAAE,OAAO,OAAO;AACvD,UAAM,UAAU,MACb,MAAM,CAAC,KAAK,EACZ,IAAI,UAAQ;AACX,UAAI;AACF,eAAO,KAAK,MAAM,IAAI;AAAA,MACxB,QAAQ;AACN,eAAO;AAAA,MACT;AAAA,IACF,CAAC,EACA,OAAO,CAAC,MAA0B,MAAM,IAAI;AAE/C,WAAO,QAAQ,QAAQ;AAAA,EACzB,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAMA,SAAS,kBAA0B;AACjC,MAAI;AACF,UAAM,kBAAkB,KAAK,KAAK,WAAW,oBAAoB;AACjE,UAAM,cAAc,KAAK,MAAM,GAAG,aAAa,iBAAiB,OAAO,CAAC;AACxE,WAAO,YAAY,WAAW;AAAA,EAChC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAKO,SAAS,oBACd,OACA,SACmB;AACnB,MAAI,iBAAiB,mBAAmB;AACtC,WAAO;AAAA,EACT;AACA,SAAO,IAAI,kBAAkB,OAAO,OAAO;AAC7C;AAMO,SAAS,mBACd,OACA,UAA+D,CAAC,GACxD;AACR,QAAM,WAAW,oBAAoB,OAAO,QAAQ,OAAO;AAG3D,uBAAqB,QAAQ;AAE7B,MAAI,UAAU,SAAS,eAAe;AAEtC,MAAI,QAAQ,eAAe;AACzB,UAAM,iBAAiB,EAAE,qCAAqC;AAC9D,eAAW;AAAA;AAAA,YAAU,cAAc,KAAK,SAAS,oBAAoB,CAAC;AAAA,EACxE;AAEA,SAAO;AACT;",
-  "names": ["ErrorCategory"]
-}

package/dist/utils/validate.js

@@ -1,132 +0,0 @@
-function validateField(field, value) {
-  const trimmed = value.trim();
-  if (!trimmed && field === "address2") {
-    return null;
-  }
-  if (!trimmed) {
-    return { message: "This field is required" };
-  }
-  switch (field) {
-    case "email": {
-      const emailRegex = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;
-      if (!emailRegex.test(trimmed)) {
-        return { message: "Please enter a valid email address" };
-      }
-      break;
-    }
-    case "name":
-      if (trimmed.length < 2) {
-        return { message: "Name must be at least 2 characters long" };
-      }
-      break;
-    case "address1": {
-      if (trimmed.length < 3) {
-        return { message: "Please enter a valid address" };
-      }
-      const isPOBox = /^P\.?O\.?\s*Box\s+\d+$/i.test(trimmed);
-      const hasNumber = /\d+/.test(trimmed);
-      if (!isPOBox && !hasNumber) {
-        return { message: "Please include a number in the street address" };
-      }
-      break;
-    }
-    case "address2":
-      break;
-    case "city":
-      if (trimmed.length < 2) {
-        return { message: "City name must be at least 2 characters long" };
-      }
-      if (!/^[a-zA-Z\s.-]+$/.test(trimmed)) {
-        return {
-          message: "City can only contain letters, spaces, periods, and hyphens"
-        };
-      }
-      break;
-    case "state": {
-      const states = /* @__PURE__ */ new Set([
-        "AL",
-        "AK",
-        "AZ",
-        "AR",
-        "CA",
-        "CO",
-        "CT",
-        "DE",
-        "FL",
-        "GA",
-        "HI",
-        "ID",
-        "IL",
-        "IN",
-        "IA",
-        "KS",
-        "KY",
-        "LA",
-        "ME",
-        "MD",
-        "MA",
-        "MI",
-        "MN",
-        "MS",
-        "MO",
-        "MT",
-        "NE",
-        "NV",
-        "NH",
-        "NJ",
-        "NM",
-        "NY",
-        "NC",
-        "ND",
-        "OH",
-        "OK",
-        "OR",
-        "PA",
-        "RI",
-        "SC",
-        "SD",
-        "TN",
-        "TX",
-        "UT",
-        "VT",
-        "VA",
-        "WA",
-        "WV",
-        "WI",
-        "WY",
-        "DC"
-      ]);
-      const stateCode = trimmed.toUpperCase();
-      if (!states.has(stateCode)) {
-        return { message: "Please enter a valid US state code (e.g. CA)" };
-      }
-      break;
-    }
-    case "usLocation": {
-      const normalized = trimmed.toLowerCase();
-      if (!["y", "yes", "n", "no"].includes(normalized)) {
-        return { message: "Please enter y/yes or n/no" };
-      }
-      break;
-    }
-    case "zip":
-      if (!/^\d{5}(-\d{4})?$/.test(trimmed)) {
-        return {
-          message: "Please enter a valid ZIP code (e.g. 12345 or 12345-6789)"
-        };
-      }
-      break;
-    case "phone":
-      if (!/^(\+1\s?)?(\d{3}[-.\s]??)?\d{3}[-.\s]??\d{4}$/.test(trimmed)) {
-        return {
-          message: "Please enter a valid US phone number"
-        };
-      }
-      break;
-  }
-  return null;
-}
-export {
-  validateField
-};
-//# sourceMappingURL=validate.js.map