@mastra/code-sdk 0.0.0-mastracode-cloud-20260706153555

package/dist/utils/binaries.js

@@ -0,0 +1,74 @@
+import { execFile, execFileSync } from "node:child_process";
+const COMMON_BINARIES = [
+  "python",
+  "python3",
+  "node",
+  "npm",
+  "pnpm",
+  "yarn",
+  "bun",
+  "git",
+  "rg",
+  "fd",
+  "fdfind",
+  "curl",
+  "wget",
+  "docker",
+  "make",
+  "gcc",
+  "g++",
+  "go",
+  "rustc",
+  "cargo"
+];
+let cachedBinaries = null;
+let inFlightPromise = null;
+function resolveBinary(name) {
+  const command = process.platform === "win32" ? "where" : "which";
+  try {
+    const output = execFileSync(command, [name], { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+    return output.split(/\r?\n/)[0] || null;
+  } catch {
+    return null;
+  }
+}
+function resolveBinaryAsync(name) {
+  const command = process.platform === "win32" ? "where" : "which";
+  return new Promise((resolve) => {
+    execFile(command, [name], { encoding: "utf-8" }, (err, stdout) => {
+      if (err) {
+        resolve(null);
+        return;
+      }
+      resolve(stdout.trim().split(/\r?\n/)[0] || null);
+    });
+  });
+}
+function detectCommonBinaries() {
+  cachedBinaries ??= COMMON_BINARIES.map((name) => ({
+    name,
+    path: resolveBinary(name)
+  }));
+  return cachedBinaries;
+}
+async function detectCommonBinariesAsync() {
+  if (cachedBinaries) return cachedBinaries;
+  if (inFlightPromise) return inFlightPromise;
+  inFlightPromise = Promise.all(
+    COMMON_BINARIES.map(async (name) => ({
+      name,
+      path: await resolveBinaryAsync(name)
+    }))
+  );
+  try {
+    cachedBinaries = await inFlightPromise;
+    return cachedBinaries;
+  } finally {
+    inFlightPromise = null;
+  }
+}
+export {
+  detectCommonBinaries,
+  detectCommonBinariesAsync
+};
+//# sourceMappingURL=binaries.js.map

package/dist/utils/binaries.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/binaries.ts"],"sourcesContent":["import { execFile, execFileSync } from 'node:child_process';\n\nexport interface CommonBinary {\n  name: string;\n  path: string | null;\n}\n\nconst COMMON_BINARIES = [\n  'python',\n  'python3',\n  'node',\n  'npm',\n  'pnpm',\n  'yarn',\n  'bun',\n  'git',\n  'rg',\n  'fd',\n  'fdfind',\n  'curl',\n  'wget',\n  'docker',\n  'make',\n  'gcc',\n  'g++',\n  'go',\n  'rustc',\n  'cargo',\n] as const;\n\nlet cachedBinaries: CommonBinary[] | null = null;\nlet inFlightPromise: Promise<CommonBinary[]> | null = null;\n\nfunction resolveBinary(name: string): string | null {\n  const command = process.platform === 'win32' ? 'where' : 'which';\n  try {\n    const output = execFileSync(command, [name], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();\n    return output.split(/\\r?\\n/)[0] || null;\n  } catch {\n    return null;\n  }\n}\n\nfunction resolveBinaryAsync(name: string): Promise<string | null> {\n  const command = process.platform === 'win32' ? 'where' : 'which';\n  return new Promise(resolve => {\n    execFile(command, [name], { encoding: 'utf-8' }, (err, stdout) => {\n      if (err) {\n        resolve(null);\n        return;\n      }\n      resolve(stdout.trim().split(/\\r?\\n/)[0] || null);\n    });\n  });\n}\n\nexport function detectCommonBinaries(): CommonBinary[] {\n  cachedBinaries ??= COMMON_BINARIES.map(name => ({\n    name,\n    path: resolveBinary(name),\n  }));\n\n  return cachedBinaries;\n}\n\nexport async function detectCommonBinariesAsync(): Promise<CommonBinary[]> {\n  if (cachedBinaries) return cachedBinaries;\n  if (inFlightPromise) return inFlightPromise;\n\n  inFlightPromise = Promise.all(\n    COMMON_BINARIES.map(async name => ({\n      name,\n      path: await resolveBinaryAsync(name),\n    })),\n  );\n\n  try {\n    cachedBinaries = await inFlightPromise;\n    return cachedBinaries;\n  } finally {\n    inFlightPromise = null;\n  }\n}\n"],"mappings":"AAAA,SAAS,UAAU,oBAAoB;AAOvC,MAAM,kBAAkB;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,IAAI,iBAAwC;AAC5C,IAAI,kBAAkD;AAEtD,SAAS,cAAc,MAA6B;AAClD,QAAM,UAAU,QAAQ,aAAa,UAAU,UAAU;AACzD,MAAI;AACF,UAAM,SAAS,aAAa,SAAS,CAAC,IAAI,GAAG,EAAE,UAAU,SAAS,OAAO,CAAC,QAAQ,QAAQ,MAAM,EAAE,CAAC,EAAE,KAAK;AAC1G,WAAO,OAAO,MAAM,OAAO,EAAE,CAAC,KAAK;AAAA,EACrC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,mBAAmB,MAAsC;AAChE,QAAM,UAAU,QAAQ,aAAa,UAAU,UAAU;AACzD,SAAO,IAAI,QAAQ,aAAW;AAC5B,aAAS,SAAS,CAAC,IAAI,GAAG,EAAE,UAAU,QAAQ,GAAG,CAAC,KAAK,WAAW;AAChE,UAAI,KAAK;AACP,gBAAQ,IAAI;AACZ;AAAA,MACF;AACA,cAAQ,OAAO,KAAK,EAAE,MAAM,OAAO,EAAE,CAAC,KAAK,IAAI;AAAA,IACjD,CAAC;AAAA,EACH,CAAC;AACH;AAEO,SAAS,uBAAuC;AACrD,qBAAmB,gBAAgB,IAAI,WAAS;AAAA,IAC9C;AAAA,IACA,MAAM,cAAc,IAAI;AAAA,EAC1B,EAAE;AAEF,SAAO;AACT;AAEA,eAAsB,4BAAqD;AACzE,MAAI,eAAgB,QAAO;AAC3B,MAAI,gBAAiB,QAAO;AAE5B,oBAAkB,QAAQ;AAAA,IACxB,gBAAgB,IAAI,OAAM,UAAS;AAAA,MACjC;AAAA,MACA,MAAM,MAAM,mBAAmB,IAAI;AAAA,IACrC,EAAE;AAAA,EACJ;AAEA,MAAI;AACF,qBAAiB,MAAM;AACvB,WAAO;AAAA,EACT,UAAE;AACA,sBAAkB;AAAA,EACpB;AACF;","names":[]}

package/dist/utils/debug-log.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Truncate a log file to roughly {@link KEEP_SIZE} bytes if it exceeds
+ * {@link MAX_LOG_SIZE}, cutting at the first newline so we don't start mid-line.
+ */
+export declare function truncateLogFile(logFile: string): void;
+/**
+ * Set up debug logging. When {@link MASTRA_DEBUG} is `"true"`, redirects
+ * `console.error` and `console.warn` to a log file (truncating it first if
+ * oversized). Otherwise silences them to avoid corrupting the TUI.
+ */
+export declare function setupDebugLogging(): void;
+//# sourceMappingURL=debug-log.d.ts.map

package/dist/utils/debug-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-log.d.ts","sourceRoot":"","sources":["../../src/utils/debug-log.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAerD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CA4BxC"}

package/dist/utils/debug-log.js

@@ -0,0 +1,55 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { getAppDataDir } from "./project.js";
+const MAX_LOG_SIZE = 5 * 1024 * 1024;
+const KEEP_SIZE = 4 * 1024 * 1024;
+function truncateLogFile(logFile) {
+  try {
+    const stat = fs.statSync(logFile);
+    if (stat.size > MAX_LOG_SIZE) {
+      const buf = Buffer.alloc(KEEP_SIZE);
+      const fd = fs.openSync(logFile, "r");
+      fs.readSync(fd, buf, 0, KEEP_SIZE, stat.size - KEEP_SIZE);
+      fs.closeSync(fd);
+      const firstNewline = buf.indexOf(10);
+      const trimmed = firstNewline >= 0 ? buf.subarray(firstNewline + 1) : buf;
+      fs.writeFileSync(logFile, trimmed);
+    }
+  } catch {
+  }
+}
+function setupDebugLogging() {
+  const debugEnabled = ["true", "1"].includes(process.env.MASTRA_DEBUG ?? "");
+  if (debugEnabled) {
+    const logFile = path.join(getAppDataDir(), "debug.log");
+    truncateLogFile(logFile);
+    const logStream = fs.createWriteStream(logFile, { flags: "a" });
+    const fmt = (a) => {
+      if (typeof a === "string") return a;
+      if (a instanceof Error) return a.stack ?? `${a.name}: ${a.message}`;
+      try {
+        return JSON.stringify(a);
+      } catch {
+        return String(a);
+      }
+    };
+    console.error = (...args) => {
+      logStream.write(`[ERROR] ${(/* @__PURE__ */ new Date()).toISOString()} ${args.map(fmt).join(" ")}
+`);
+    };
+    console.warn = (...args) => {
+      logStream.write(`[WARN] ${(/* @__PURE__ */ new Date()).toISOString()} ${args.map(fmt).join(" ")}
+`);
+    };
+  } else {
+    const noop = () => {
+    };
+    console.error = noop;
+    console.warn = noop;
+  }
+}
+export {
+  setupDebugLogging,
+  truncateLogFile
+};
+//# sourceMappingURL=debug-log.js.map

package/dist/utils/debug-log.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/debug-log.ts"],"sourcesContent":["import * as fs from 'node:fs';\nimport * as path from 'node:path';\n\nimport { getAppDataDir } from './project.js';\n\nconst MAX_LOG_SIZE = 5 * 1024 * 1024; // 5 MB\nconst KEEP_SIZE = 4 * 1024 * 1024; // 4 MB\n\n/**\n * Truncate a log file to roughly {@link KEEP_SIZE} bytes if it exceeds\n * {@link MAX_LOG_SIZE}, cutting at the first newline so we don't start mid-line.\n */\nexport function truncateLogFile(logFile: string): void {\n  try {\n    const stat = fs.statSync(logFile);\n    if (stat.size > MAX_LOG_SIZE) {\n      const buf = Buffer.alloc(KEEP_SIZE);\n      const fd = fs.openSync(logFile, 'r');\n      fs.readSync(fd, buf, 0, KEEP_SIZE, stat.size - KEEP_SIZE);\n      fs.closeSync(fd);\n      const firstNewline = buf.indexOf(10);\n      const trimmed = firstNewline >= 0 ? buf.subarray(firstNewline + 1) : buf;\n      fs.writeFileSync(logFile, trimmed);\n    }\n  } catch {\n    // File may not exist yet — that's fine\n  }\n}\n\n/**\n * Set up debug logging. When {@link MASTRA_DEBUG} is `\"true\"`, redirects\n * `console.error` and `console.warn` to a log file (truncating it first if\n * oversized). Otherwise silences them to avoid corrupting the TUI.\n */\nexport function setupDebugLogging(): void {\n  const debugEnabled = ['true', '1'].includes(process.env.MASTRA_DEBUG ?? '');\n\n  if (debugEnabled) {\n    const logFile = path.join(getAppDataDir(), 'debug.log');\n    truncateLogFile(logFile);\n\n    const logStream = fs.createWriteStream(logFile, { flags: 'a' });\n    const fmt = (a: unknown): string => {\n      if (typeof a === 'string') return a;\n      if (a instanceof Error) return a.stack ?? `${a.name}: ${a.message}`;\n      try {\n        return JSON.stringify(a);\n      } catch {\n        return String(a);\n      }\n    };\n    console.error = (...args: unknown[]) => {\n      logStream.write(`[ERROR] ${new Date().toISOString()} ${args.map(fmt).join(' ')}\\n`);\n    };\n    console.warn = (...args: unknown[]) => {\n      logStream.write(`[WARN] ${new Date().toISOString()} ${args.map(fmt).join(' ')}\\n`);\n    };\n  } else {\n    const noop = () => {};\n    console.error = noop;\n    console.warn = noop;\n  }\n}\n"],"mappings":"AAAA,YAAY,QAAQ;AACpB,YAAY,UAAU;AAEtB,SAAS,qBAAqB;AAE9B,MAAM,eAAe,IAAI,OAAO;AAChC,MAAM,YAAY,IAAI,OAAO;AAMtB,SAAS,gBAAgB,SAAuB;AACrD,MAAI;AACF,UAAM,OAAO,GAAG,SAAS,OAAO;AAChC,QAAI,KAAK,OAAO,cAAc;AAC5B,YAAM,MAAM,OAAO,MAAM,SAAS;AAClC,YAAM,KAAK,GAAG,SAAS,SAAS,GAAG;AACnC,SAAG,SAAS,IAAI,KAAK,GAAG,WAAW,KAAK,OAAO,SAAS;AACxD,SAAG,UAAU,EAAE;AACf,YAAM,eAAe,IAAI,QAAQ,EAAE;AACnC,YAAM,UAAU,gBAAgB,IAAI,IAAI,SAAS,eAAe,CAAC,IAAI;AACrE,SAAG,cAAc,SAAS,OAAO;AAAA,IACnC;AAAA,EACF,QAAQ;AAAA,EAER;AACF;AAOO,SAAS,oBAA0B;AACxC,QAAM,eAAe,CAAC,QAAQ,GAAG,EAAE,SAAS,QAAQ,IAAI,gBAAgB,EAAE;AAE1E,MAAI,cAAc;AAChB,UAAM,UAAU,KAAK,KAAK,cAAc,GAAG,WAAW;AACtD,oBAAgB,OAAO;AAEvB,UAAM,YAAY,GAAG,kBAAkB,SAAS,EAAE,OAAO,IAAI,CAAC;AAC9D,UAAM,MAAM,CAAC,MAAuB;AAClC,UAAI,OAAO,MAAM,SAAU,QAAO;AAClC,UAAI,aAAa,MAAO,QAAO,EAAE,SAAS,GAAG,EAAE,IAAI,KAAK,EAAE,OAAO;AACjE,UAAI;AACF,eAAO,KAAK,UAAU,CAAC;AAAA,MACzB,QAAQ;AACN,eAAO,OAAO,CAAC;AAAA,MACjB;AAAA,IACF;AACA,YAAQ,QAAQ,IAAI,SAAoB;AACtC,gBAAU,MAAM,YAAW,oBAAI,KAAK,GAAE,YAAY,CAAC,IAAI,KAAK,IAAI,GAAG,EAAE,KAAK,GAAG,CAAC;AAAA,CAAI;AAAA,IACpF;AACA,YAAQ,OAAO,IAAI,SAAoB;AACrC,gBAAU,MAAM,WAAU,oBAAI,KAAK,GAAE,YAAY,CAAC,IAAI,KAAK,IAAI,GAAG,EAAE,KAAK,GAAG,CAAC;AAAA,CAAI;AAAA,IACnF;AAAA,EACF,OAAO;AACL,UAAM,OAAO,MAAM;AAAA,IAAC;AACpB,YAAQ,QAAQ;AAChB,YAAQ,OAAO;AAAA,EACjB;AACF;","names":[]}

package/dist/utils/errors.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Error handling utilities for the Mastra Code TUI.
+ * Parses API errors and provides user-friendly messages.
+ */
+export interface ParsedError {
+    /** User-friendly error message */
+    message: string;
+    /** Extra diagnostic detail to surface to the user */
+    detail?: string;
+    /** Request URL involved in the failure, when available */
+    requestUrl?: string;
+    /** Error type for categorization */
+    type: ErrorType;
+    /** Whether this error is retryable */
+    retryable: boolean;
+    /** Suggested retry delay in ms (if retryable) */
+    retryDelay?: number;
+    /** Original error for debugging */
+    originalError: Error;
+}
+export type ErrorType = 'rate_limit' | 'auth' | 'network' | 'timeout' | 'invalid_request' | 'server_error' | 'model_not_found' | 'context_length' | 'content_filter' | 'unknown';
+export declare function parseError(error: unknown): ParsedError;
+/**
+ * Sleep for a given number of milliseconds.
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Retry a function with exponential backoff.
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: {
+    maxRetries?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    onRetry?: (error: ParsedError, attempt: number) => void;
+}): Promise<T>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,IAAI,EAAE,SAAS,CAAC;IAChB,sCAAsC;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,aAAa,EAAE,KAAK,CAAC;CACtB;AAED,MAAM,MAAM,SAAS,GACjB,YAAY,GACZ,MAAM,GACN,SAAS,GACT,SAAS,GACT,iBAAiB,GACjB,cAAc,GACd,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,SAAS,CAAC;AA6Dd,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAgLtD;AAkDD;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD,GACL,OAAO,CAAC,CAAC,CAAC,CA6BZ"}

package/dist/utils/errors.js

@@ -0,0 +1,207 @@
+function summarizeErrorDetail(error) {
+  if (error instanceof Error) {
+    if (error.cause instanceof Error && error.cause.message) {
+      return error.cause.message;
+    }
+    if (typeof error.cause === "string" && error.cause.trim().length > 0) {
+      return error.cause;
+    }
+    if (error.message.trim().length > 0) {
+      return error.message;
+    }
+  }
+  if (typeof error === "string" && error.trim().length > 0) {
+    return error;
+  }
+  if (error && typeof error === "object") {
+    const errorObj = error;
+    const candidates = [errorObj["message"], errorObj["cause"], errorObj["code"], errorObj["statusText"]];
+    for (const candidate of candidates) {
+      if (typeof candidate === "string" && candidate.trim().length > 0) {
+        return candidate;
+      }
+    }
+  }
+  return void 0;
+}
+function extractRequestUrl(error) {
+  if (!error || typeof error !== "object") {
+    return void 0;
+  }
+  const candidates = [];
+  const errorObj = error;
+  candidates.push(errorObj["requestUrl"], errorObj["url"]);
+  if (errorObj["cause"] && typeof errorObj["cause"] === "object") {
+    const causeObj = errorObj["cause"];
+    candidates.push(causeObj["requestUrl"], causeObj["url"]);
+  }
+  for (const candidate of candidates) {
+    if (typeof candidate === "string" && candidate.trim().length > 0) {
+      return candidate;
+    }
+  }
+  return void 0;
+}
+function parseError(error) {
+  const err = error instanceof Error ? error : new Error(String(error));
+  const message = err.message.toLowerCase();
+  const errorObj = error;
+  const detail = summarizeErrorDetail(error);
+  const requestUrl = extractRequestUrl(error);
+  if (message.includes("rate limit") || message.includes("rate_limit") || message.includes("429") || errorObj.statusCode === 429 || errorObj.status === 429) {
+    const retryAfter = extractRetryAfter(errorObj);
+    return {
+      message: "Rate limited. Please wait a moment before trying again.",
+      type: "rate_limit",
+      retryable: true,
+      retryDelay: retryAfter || 5e3,
+      originalError: err
+    };
+  }
+  if (message.includes("unauthorized") || message.includes("authentication") || message.includes("invalid api key") || message.includes("invalid_api_key") || message.includes("api key") || errorObj.statusCode === 401 || errorObj.status === 401) {
+    return {
+      message: "Authentication failed. Please check your API key or login with /login.",
+      detail,
+      requestUrl,
+      type: "auth",
+      retryable: false,
+      originalError: err
+    };
+  }
+  if (errorObj.statusCode === 403 || errorObj.status === 403) {
+    return {
+      message: "Access denied. You may not have permission to use this model.",
+      detail,
+      requestUrl,
+      type: "auth",
+      retryable: false,
+      originalError: err
+    };
+  }
+  if (message.includes("network") || message.includes("econnrefused") || message.includes("enotfound") || message.includes("fetch failed") || message.includes("connection")) {
+    return {
+      message: "Network error while contacting the provider or gateway.",
+      detail,
+      requestUrl,
+      type: "network",
+      retryable: true,
+      retryDelay: 2e3,
+      originalError: err
+    };
+  }
+  if (message.includes("timeout") || message.includes("timed out") || message.includes("etimedout")) {
+    return {
+      message: "Request timed out. The server may be overloaded.",
+      type: "timeout",
+      retryable: true,
+      retryDelay: 3e3,
+      originalError: err
+    };
+  }
+  if (message.includes("model not found") || message.includes("model_not_found") || message.includes("does not exist") || message.includes("invalid model")) {
+    return {
+      message: "Model not found. Please select a different model with /models.",
+      type: "model_not_found",
+      retryable: false,
+      originalError: err
+    };
+  }
+  if (message.includes("context length") || message.includes("context_length") || message.includes("too many tokens") || message.includes("maximum context") || message.includes("token limit")) {
+    return {
+      message: "Message too long. Try starting a new thread with /new.",
+      type: "context_length",
+      retryable: false,
+      originalError: err
+    };
+  }
+  if (message.includes("content filter") || message.includes("content_filter") || message.includes("content policy") || message.includes("safety") || message.includes("prohibited")) {
+    return {
+      message: "Content was filtered by the model's safety system.",
+      type: "content_filter",
+      retryable: false,
+      originalError: err
+    };
+  }
+  if (message.includes("internal server") || message.includes("server error") || errorObj.statusCode === 500 || errorObj.status === 500 || errorObj.statusCode === 502 || errorObj.status === 502 || errorObj.statusCode === 503 || errorObj.status === 503) {
+    return {
+      message: "Server error. The API may be experiencing issues.",
+      type: "server_error",
+      retryable: true,
+      retryDelay: 5e3,
+      originalError: err
+    };
+  }
+  if (message.includes("invalid request") || message.includes("bad request") || errorObj.statusCode === 400 || errorObj.status === 400) {
+    return {
+      message: `Invalid request: ${extractErrorDetail(err)}`,
+      type: "invalid_request",
+      retryable: false,
+      originalError: err
+    };
+  }
+  return {
+    message: extractErrorDetail(err),
+    type: "unknown",
+    retryable: false,
+    originalError: err
+  };
+}
+function extractRetryAfter(error) {
+  const headers = error.headers;
+  const retryAfter = error.retryAfter || headers?.["retry-after"];
+  if (typeof retryAfter === "number") {
+    return retryAfter * 1e3;
+  }
+  if (typeof retryAfter === "string") {
+    const seconds = parseInt(retryAfter, 10);
+    if (!isNaN(seconds)) {
+      return seconds * 1e3;
+    }
+  }
+  return void 0;
+}
+function extractErrorDetail(error) {
+  const errorObj = error;
+  if (errorObj.error && typeof errorObj.error === "object") {
+    const apiError = errorObj.error;
+    if (apiError.message) return String(apiError.message);
+  }
+  if (errorObj.message) return String(errorObj.message);
+  if (errorObj.detail) return String(errorObj.detail);
+  if (errorObj.reason) return String(errorObj.reason);
+  let message = error.message;
+  message = message.replace(/^(error|exception|failed):\s*/i, "");
+  if (message.length > 200) {
+    message = message.substring(0, 200) + "...";
+  }
+  return message || "An unknown error occurred";
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function withRetry(fn, options = {}) {
+  const { maxRetries = 3, initialDelay = 1e3, maxDelay = 3e4, onRetry } = options;
+  let lastError;
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    try {
+      return await fn();
+    } catch (error) {
+      lastError = parseError(error);
+      if (!lastError.retryable || attempt === maxRetries) {
+        throw lastError.originalError;
+      }
+      const delay = Math.min(lastError.retryDelay || initialDelay * Math.pow(2, attempt), maxDelay);
+      if (onRetry) {
+        onRetry(lastError, attempt + 1);
+      }
+      await sleep(delay);
+    }
+  }
+  throw lastError?.originalError || new Error("Retry failed");
+}
+export {
+  parseError,
+  sleep,
+  withRetry
+};
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/errors.ts"],"sourcesContent":["/**\n * Error handling utilities for the Mastra Code TUI.\n * Parses API errors and provides user-friendly messages.\n */\n\nexport interface ParsedError {\n  /** User-friendly error message */\n  message: string;\n  /** Extra diagnostic detail to surface to the user */\n  detail?: string;\n  /** Request URL involved in the failure, when available */\n  requestUrl?: string;\n  /** Error type for categorization */\n  type: ErrorType;\n  /** Whether this error is retryable */\n  retryable: boolean;\n  /** Suggested retry delay in ms (if retryable) */\n  retryDelay?: number;\n  /** Original error for debugging */\n  originalError: Error;\n}\n\nexport type ErrorType =\n  | 'rate_limit'\n  | 'auth'\n  | 'network'\n  | 'timeout'\n  | 'invalid_request'\n  | 'server_error'\n  | 'model_not_found'\n  | 'context_length'\n  | 'content_filter'\n  | 'unknown';\n\n/**\n * Parse an error and return a user-friendly representation.\n */\nfunction summarizeErrorDetail(error: unknown): string | undefined {\n  if (error instanceof Error) {\n    if (error.cause instanceof Error && error.cause.message) {\n      return error.cause.message;\n    }\n\n    if (typeof error.cause === 'string' && error.cause.trim().length > 0) {\n      return error.cause;\n    }\n\n    if (error.message.trim().length > 0) {\n      return error.message;\n    }\n  }\n\n  if (typeof error === 'string' && error.trim().length > 0) {\n    return error;\n  }\n\n  if (error && typeof error === 'object') {\n    const errorObj = error as Record<string, unknown>;\n    const candidates = [errorObj['message'], errorObj['cause'], errorObj['code'], errorObj['statusText']];\n\n    for (const candidate of candidates) {\n      if (typeof candidate === 'string' && candidate.trim().length > 0) {\n        return candidate;\n      }\n    }\n  }\n\n  return undefined;\n}\n\nfunction extractRequestUrl(error: unknown): string | undefined {\n  if (!error || typeof error !== 'object') {\n    return undefined;\n  }\n\n  const candidates: unknown[] = [];\n  const errorObj = error as Record<string, unknown>;\n  candidates.push(errorObj['requestUrl'], errorObj['url']);\n\n  if (errorObj['cause'] && typeof errorObj['cause'] === 'object') {\n    const causeObj = errorObj['cause'] as Record<string, unknown>;\n    candidates.push(causeObj['requestUrl'], causeObj['url']);\n  }\n\n  for (const candidate of candidates) {\n    if (typeof candidate === 'string' && candidate.trim().length > 0) {\n      return candidate;\n    }\n  }\n\n  return undefined;\n}\n\nexport function parseError(error: unknown): ParsedError {\n  const err = error instanceof Error ? error : new Error(String(error));\n  const message = err.message.toLowerCase();\n  const errorObj = error as Record<string, unknown>;\n  const detail = summarizeErrorDetail(error);\n  const requestUrl = extractRequestUrl(error);\n\n  // Check for rate limiting\n  if (\n    message.includes('rate limit') ||\n    message.includes('rate_limit') ||\n    message.includes('429') ||\n    errorObj.statusCode === 429 ||\n    errorObj.status === 429\n  ) {\n    const retryAfter = extractRetryAfter(errorObj);\n    return {\n      message: 'Rate limited. Please wait a moment before trying again.',\n      type: 'rate_limit',\n      retryable: true,\n      retryDelay: retryAfter || 5000,\n      originalError: err,\n    };\n  }\n\n  // Check for authentication errors\n  if (\n    message.includes('unauthorized') ||\n    message.includes('authentication') ||\n    message.includes('invalid api key') ||\n    message.includes('invalid_api_key') ||\n    message.includes('api key') ||\n    errorObj.statusCode === 401 ||\n    errorObj.status === 401\n  ) {\n    return {\n      message: 'Authentication failed. Please check your API key or login with /login.',\n      detail,\n      requestUrl,\n      type: 'auth',\n      retryable: false,\n      originalError: err,\n    };\n  }\n\n  // Check for forbidden/permission errors\n  if (errorObj.statusCode === 403 || errorObj.status === 403) {\n    return {\n      message: 'Access denied. You may not have permission to use this model.',\n      detail,\n      requestUrl,\n      type: 'auth',\n      retryable: false,\n      originalError: err,\n    };\n  }\n\n  // Check for network errors\n  if (\n    message.includes('network') ||\n    message.includes('econnrefused') ||\n    message.includes('enotfound') ||\n    message.includes('fetch failed') ||\n    message.includes('connection')\n  ) {\n    return {\n      message: 'Network error while contacting the provider or gateway.',\n      detail,\n      requestUrl,\n      type: 'network',\n      retryable: true,\n      retryDelay: 2000,\n      originalError: err,\n    };\n  }\n\n  // Check for timeout errors\n  if (message.includes('timeout') || message.includes('timed out') || message.includes('etimedout')) {\n    return {\n      message: 'Request timed out. The server may be overloaded.',\n      type: 'timeout',\n      retryable: true,\n      retryDelay: 3000,\n      originalError: err,\n    };\n  }\n\n  // Check for model not found\n  if (\n    message.includes('model not found') ||\n    message.includes('model_not_found') ||\n    message.includes('does not exist') ||\n    message.includes('invalid model')\n  ) {\n    return {\n      message: 'Model not found. Please select a different model with /models.',\n      type: 'model_not_found',\n      retryable: false,\n      originalError: err,\n    };\n  }\n\n  // Check for context length errors\n  if (\n    message.includes('context length') ||\n    message.includes('context_length') ||\n    message.includes('too many tokens') ||\n    message.includes('maximum context') ||\n    message.includes('token limit')\n  ) {\n    return {\n      message: 'Message too long. Try starting a new thread with /new.',\n      type: 'context_length',\n      retryable: false,\n      originalError: err,\n    };\n  }\n\n  // Check for content filter errors\n  if (\n    message.includes('content filter') ||\n    message.includes('content_filter') ||\n    message.includes('content policy') ||\n    message.includes('safety') ||\n    message.includes('prohibited')\n  ) {\n    return {\n      message: \"Content was filtered by the model's safety system.\",\n      type: 'content_filter',\n      retryable: false,\n      originalError: err,\n    };\n  }\n\n  // Check for server errors\n  if (\n    message.includes('internal server') ||\n    message.includes('server error') ||\n    errorObj.statusCode === 500 ||\n    errorObj.status === 500 ||\n    errorObj.statusCode === 502 ||\n    errorObj.status === 502 ||\n    errorObj.statusCode === 503 ||\n    errorObj.status === 503\n  ) {\n    return {\n      message: 'Server error. The API may be experiencing issues.',\n      type: 'server_error',\n      retryable: true,\n      retryDelay: 5000,\n      originalError: err,\n    };\n  }\n\n  // Check for invalid request errors\n  if (\n    message.includes('invalid request') ||\n    message.includes('bad request') ||\n    errorObj.statusCode === 400 ||\n    errorObj.status === 400\n  ) {\n    return {\n      message: `Invalid request: ${extractErrorDetail(err)}`,\n      type: 'invalid_request',\n      retryable: false,\n      originalError: err,\n    };\n  }\n\n  // Unknown error - try to extract useful info\n  return {\n    message: extractErrorDetail(err),\n    type: 'unknown',\n    retryable: false,\n    originalError: err,\n  };\n}\n\n/**\n * Extract retry-after header value from error.\n */\nfunction extractRetryAfter(error: Record<string, unknown>): number | undefined {\n  const headers = error.headers as Record<string, unknown> | undefined;\n  const retryAfter = error.retryAfter || headers?.['retry-after'];\n  if (typeof retryAfter === 'number') {\n    return retryAfter * 1000; // Convert seconds to ms\n  }\n  if (typeof retryAfter === 'string') {\n    const seconds = parseInt(retryAfter, 10);\n    if (!isNaN(seconds)) {\n      return seconds * 1000;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Extract a useful error detail from an error object.\n */\nfunction extractErrorDetail(error: Error): string {\n  const errorObj = error as unknown as Record<string, unknown>;\n\n  // Try to get a specific error message from common API error formats\n  if (errorObj.error && typeof errorObj.error === 'object') {\n    const apiError = errorObj.error as Record<string, unknown>;\n    if (apiError.message) return String(apiError.message);\n  }\n\n  if (errorObj.message) return String(errorObj.message);\n  if (errorObj.detail) return String(errorObj.detail);\n  if (errorObj.reason) return String(errorObj.reason);\n\n  // Clean up the error message\n  let message = error.message;\n\n  // Remove common prefixes\n  message = message.replace(/^(error|exception|failed):\\s*/i, '');\n\n  // Truncate very long messages\n  if (message.length > 200) {\n    message = message.substring(0, 200) + '...';\n  }\n\n  return message || 'An unknown error occurred';\n}\n\n/**\n * Sleep for a given number of milliseconds.\n */\nexport function sleep(ms: number): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, ms));\n}\n\n/**\n * Retry a function with exponential backoff.\n */\nexport async function withRetry<T>(\n  fn: () => Promise<T>,\n  options: {\n    maxRetries?: number;\n    initialDelay?: number;\n    maxDelay?: number;\n    onRetry?: (error: ParsedError, attempt: number) => void;\n  } = {},\n): Promise<T> {\n  const { maxRetries = 3, initialDelay = 1000, maxDelay = 30000, onRetry } = options;\n\n  let lastError: ParsedError | undefined;\n\n  for (let attempt = 0; attempt <= maxRetries; attempt++) {\n    try {\n      return await fn();\n    } catch (error) {\n      lastError = parseError(error);\n\n      // Don't retry non-retryable errors\n      if (!lastError.retryable || attempt === maxRetries) {\n        throw lastError.originalError;\n      }\n\n      // Calculate delay with exponential backoff\n      const delay = Math.min(lastError.retryDelay || initialDelay * Math.pow(2, attempt), maxDelay);\n\n      if (onRetry) {\n        onRetry(lastError, attempt + 1);\n      }\n\n      await sleep(delay);\n    }\n  }\n\n  // Should never reach here, but TypeScript needs this\n  throw lastError?.originalError || new Error('Retry failed');\n}\n"],"mappings":"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","names":[]}

package/dist/utils/gateway-sync.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Gateway sync utility for keeping the model registry up to date.
+ *
+ * This is a thin wrapper around `@mastra/core/llm`'s `GatewayRegistry` so
+ * mastracode and `mastra dev` share a single implementation for fetching
+ * providers, generating types, and writing to the global cache. Keep this
+ * file small — provider/registry logic belongs in `@mastra/core`.
+ */
+/**
+ * Sync gateways and update the global cache via `@mastra/core`'s registry.
+ *
+ * Skips the sync if the global cache was refreshed within the last
+ * `DEFAULT_SYNC_INTERVAL_MS`, unless `force` is set. Multiple calls in
+ * the same process coalesce while a sync is in flight.
+ */
+export declare function syncGateways(force?: boolean): Promise<void>;
+/**
+ * Start periodic gateway sync.
+ * @param intervalMs Sync interval in milliseconds (default: 5 minutes)
+ */
+export declare function startGatewaySync(intervalMs?: number): void;
+/**
+ * Stop periodic gateway sync.
+ */
+export declare function stopGatewaySync(): void;
+//# sourceMappingURL=gateway-sync.d.ts.map

package/dist/utils/gateway-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-sync.d.ts","sourceRoot":"","sources":["../../src/utils/gateway-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB/D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,SAA2B,GAAG,IAAI,CAe5E;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAKtC"}

package/dist/utils/gateway-sync.js

@@ -0,0 +1,49 @@
+import { GatewayRegistry } from "@mastra/core/llm";
+const DEFAULT_SYNC_INTERVAL_MS = 5 * 60 * 1e3;
+let syncInterval = null;
+let isSyncing = false;
+function getRegistry() {
+  return GatewayRegistry.getInstance({ useDynamicLoading: true });
+}
+async function syncGateways(force = false) {
+  if (isSyncing && !force) {
+    return;
+  }
+  if (!force) {
+    const lastSync = getRegistry().getLastRefreshTime();
+    if (lastSync && Date.now() - lastSync.getTime() < DEFAULT_SYNC_INTERVAL_MS) {
+      return;
+    }
+  }
+  isSyncing = true;
+  try {
+    await getRegistry().syncGateways(true);
+  } catch {
+  } finally {
+    isSyncing = false;
+  }
+}
+function startGatewaySync(intervalMs = DEFAULT_SYNC_INTERVAL_MS) {
+  if (syncInterval) {
+    return;
+  }
+  syncGateways().catch(() => {
+  });
+  syncInterval = setInterval(() => {
+    syncGateways().catch(() => {
+    });
+  }, intervalMs);
+  syncInterval.unref();
+}
+function stopGatewaySync() {
+  if (syncInterval) {
+    clearInterval(syncInterval);
+    syncInterval = null;
+  }
+}
+export {
+  startGatewaySync,
+  stopGatewaySync,
+  syncGateways
+};
+//# sourceMappingURL=gateway-sync.js.map

package/dist/utils/gateway-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/gateway-sync.ts"],"sourcesContent":["/**\n * Gateway sync utility for keeping the model registry up to date.\n *\n * This is a thin wrapper around `@mastra/core/llm`'s `GatewayRegistry` so\n * mastracode and `mastra dev` share a single implementation for fetching\n * providers, generating types, and writing to the global cache. Keep this\n * file small — provider/registry logic belongs in `@mastra/core`.\n */\n\nimport { GatewayRegistry } from '@mastra/core/llm';\n\nconst DEFAULT_SYNC_INTERVAL_MS = 5 * 60 * 1000;\n\nlet syncInterval: NodeJS.Timeout | null = null;\nlet isSyncing = false;\n\nfunction getRegistry(): GatewayRegistry {\n  return GatewayRegistry.getInstance({ useDynamicLoading: true });\n}\n\n/**\n * Sync gateways and update the global cache via `@mastra/core`'s registry.\n *\n * Skips the sync if the global cache was refreshed within the last\n * `DEFAULT_SYNC_INTERVAL_MS`, unless `force` is set. Multiple calls in\n * the same process coalesce while a sync is in flight.\n */\nexport async function syncGateways(force = false): Promise<void> {\n  if (isSyncing && !force) {\n    return;\n  }\n\n  if (!force) {\n    const lastSync = getRegistry().getLastRefreshTime();\n    if (lastSync && Date.now() - lastSync.getTime() < DEFAULT_SYNC_INTERVAL_MS) {\n      return;\n    }\n  }\n\n  isSyncing = true;\n  try {\n    await getRegistry().syncGateways(true);\n  } catch {\n    // Silently ignore — the bundled registry already contains all model\n    // data so a failed network fetch is non-critical.\n  } finally {\n    isSyncing = false;\n  }\n}\n\n/**\n * Start periodic gateway sync.\n * @param intervalMs Sync interval in milliseconds (default: 5 minutes)\n */\nexport function startGatewaySync(intervalMs = DEFAULT_SYNC_INTERVAL_MS): void {\n  if (syncInterval) {\n    return;\n  }\n\n  // Do an initial sync (will skip if recently synced)\n  syncGateways().catch(() => {});\n\n  // Set up periodic sync\n  syncInterval = setInterval(() => {\n    syncGateways().catch(() => {});\n  }, intervalMs);\n\n  // Don't prevent process exit\n  syncInterval.unref();\n}\n\n/**\n * Stop periodic gateway sync.\n */\nexport function stopGatewaySync(): void {\n  if (syncInterval) {\n    clearInterval(syncInterval);\n    syncInterval = null;\n  }\n}\n"],"mappings":"AASA,SAAS,uBAAuB;AAEhC,MAAM,2BAA2B,IAAI,KAAK;AAE1C,IAAI,eAAsC;AAC1C,IAAI,YAAY;AAEhB,SAAS,cAA+B;AACtC,SAAO,gBAAgB,YAAY,EAAE,mBAAmB,KAAK,CAAC;AAChE;AASA,eAAsB,aAAa,QAAQ,OAAsB;AAC/D,MAAI,aAAa,CAAC,OAAO;AACvB;AAAA,EACF;AAEA,MAAI,CAAC,OAAO;AACV,UAAM,WAAW,YAAY,EAAE,mBAAmB;AAClD,QAAI,YAAY,KAAK,IAAI,IAAI,SAAS,QAAQ,IAAI,0BAA0B;AAC1E;AAAA,IACF;AAAA,EACF;AAEA,cAAY;AACZ,MAAI;AACF,UAAM,YAAY,EAAE,aAAa,IAAI;AAAA,EACvC,QAAQ;AAAA,EAGR,UAAE;AACA,gBAAY;AAAA,EACd;AACF;AAMO,SAAS,iBAAiB,aAAa,0BAAgC;AAC5E,MAAI,cAAc;AAChB;AAAA,EACF;AAGA,eAAa,EAAE,MAAM,MAAM;AAAA,EAAC,CAAC;AAG7B,iBAAe,YAAY,MAAM;AAC/B,iBAAa,EAAE,MAAM,MAAM;AAAA,IAAC,CAAC;AAAA,EAC/B,GAAG,UAAU;AAGb,eAAa,MAAM;AACrB;AAKO,SAAS,kBAAwB;AACtC,MAAI,cAAc;AAChB,kBAAc,YAAY;AAC1B,mBAAe;AAAA,EACjB;AACF;","names":[]}

package/dist/utils/plan-diff.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Line-level diffing for plan revisions.
+ *
+ * Uses a real LCS (longest common subsequence) diff so that inserting or deleting a few
+ * lines doesn't mark everything after it as changed. Both the rendered approval diff and
+ * the "is a diff worth showing" heuristic share this so the heuristic measures the actual
+ * diff rather than predicting one.
+ */
+export interface DiffEntry {
+    type: 'added' | 'removed' | 'context';
+    text: string;
+}
+/** Produce structured diff entries between two plan texts using an LCS diff. */
+export declare function generatePlanDiff(oldText: string, newText: string): DiffEntry[];
+/**
+ * Decide whether a diff is worth rendering instead of just showing the full new plan.
+ *
+ * We generate the real diff and compare its size (added + removed lines) against the size
+ * of the whole diff (added + removed + unchanged context). When most of the diff is changes
+ * rather than shared context, the diff is no clearer than the full text, so callers fall
+ * back to rendering the whole plan. A genuinely new plan (no previous text, or no shared
+ * lines) is therefore shown in full.
+ */
+export declare function shouldShowDiff(previousPlan: string, plan: string, maxChangedRatio?: number): boolean;
+//# sourceMappingURL=plan-diff.d.ts.map

package/dist/utils/plan-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-diff.d.ts","sourceRoot":"","sources":["../../src/utils/plan-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAkC9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,SAAM,GAAG,OAAO,CASjG"}

package/dist/utils/plan-diff.js

@@ -0,0 +1,43 @@
+function generatePlanDiff(oldText, newText) {
+  const oldLines = oldText.split(/\r?\n/);
+  const newLines = newText.split(/\r?\n/);
+  const n = oldLines.length;
+  const m = newLines.length;
+  const lcs = Array.from({ length: n + 1 }, () => new Array(m + 1).fill(0));
+  for (let i2 = n - 1; i2 >= 0; i2--) {
+    for (let j2 = m - 1; j2 >= 0; j2--) {
+      lcs[i2][j2] = oldLines[i2] === newLines[j2] ? lcs[i2 + 1][j2 + 1] + 1 : Math.max(lcs[i2 + 1][j2], lcs[i2][j2 + 1]);
+    }
+  }
+  const entries = [];
+  let i = 0;
+  let j = 0;
+  while (i < n && j < m) {
+    if (oldLines[i] === newLines[j]) {
+      entries.push({ type: "context", text: oldLines[i] });
+      i++;
+      j++;
+    } else if (lcs[i + 1][j] >= lcs[i][j + 1]) {
+      entries.push({ type: "removed", text: oldLines[i] });
+      i++;
+    } else {
+      entries.push({ type: "added", text: newLines[j] });
+      j++;
+    }
+  }
+  while (i < n) entries.push({ type: "removed", text: oldLines[i++] });
+  while (j < m) entries.push({ type: "added", text: newLines[j++] });
+  return entries;
+}
+function shouldShowDiff(previousPlan, plan, maxChangedRatio = 0.5) {
+  if (!previousPlan || previousPlan === plan) return false;
+  const entries = generatePlanDiff(previousPlan, plan);
+  const changed = entries.filter((e) => e.type !== "context").length;
+  if (changed === 0) return false;
+  return changed / Math.max(entries.length, 1) <= maxChangedRatio;
+}
+export {
+  generatePlanDiff,
+  shouldShowDiff
+};
+//# sourceMappingURL=plan-diff.js.map

package/dist/utils/plan-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/plan-diff.ts"],"sourcesContent":["/**\n * Line-level diffing for plan revisions.\n *\n * Uses a real LCS (longest common subsequence) diff so that inserting or deleting a few\n * lines doesn't mark everything after it as changed. Both the rendered approval diff and\n * the \"is a diff worth showing\" heuristic share this so the heuristic measures the actual\n * diff rather than predicting one.\n */\n\nexport interface DiffEntry {\n  type: 'added' | 'removed' | 'context';\n  text: string;\n}\n\n/** Produce structured diff entries between two plan texts using an LCS diff. */\nexport function generatePlanDiff(oldText: string, newText: string): DiffEntry[] {\n  const oldLines = oldText.split(/\\r?\\n/);\n  const newLines = newText.split(/\\r?\\n/);\n  const n = oldLines.length;\n  const m = newLines.length;\n\n  // LCS length table.\n  const lcs: number[][] = Array.from({ length: n + 1 }, () => new Array<number>(m + 1).fill(0));\n  for (let i = n - 1; i >= 0; i--) {\n    for (let j = m - 1; j >= 0; j--) {\n      lcs[i]![j] = oldLines[i] === newLines[j] ? lcs[i + 1]![j + 1]! + 1 : Math.max(lcs[i + 1]![j]!, lcs[i]![j + 1]!);\n    }\n  }\n\n  const entries: DiffEntry[] = [];\n  let i = 0;\n  let j = 0;\n  while (i < n && j < m) {\n    if (oldLines[i] === newLines[j]) {\n      entries.push({ type: 'context', text: oldLines[i]! });\n      i++;\n      j++;\n    } else if (lcs[i + 1]![j]! >= lcs[i]![j + 1]!) {\n      entries.push({ type: 'removed', text: oldLines[i]! });\n      i++;\n    } else {\n      entries.push({ type: 'added', text: newLines[j]! });\n      j++;\n    }\n  }\n  while (i < n) entries.push({ type: 'removed', text: oldLines[i++]! });\n  while (j < m) entries.push({ type: 'added', text: newLines[j++]! });\n\n  return entries;\n}\n\n/**\n * Decide whether a diff is worth rendering instead of just showing the full new plan.\n *\n * We generate the real diff and compare its size (added + removed lines) against the size\n * of the whole diff (added + removed + unchanged context). When most of the diff is changes\n * rather than shared context, the diff is no clearer than the full text, so callers fall\n * back to rendering the whole plan. A genuinely new plan (no previous text, or no shared\n * lines) is therefore shown in full.\n */\nexport function shouldShowDiff(previousPlan: string, plan: string, maxChangedRatio = 0.5): boolean {\n  if (!previousPlan || previousPlan === plan) return false;\n\n  const entries = generatePlanDiff(previousPlan, plan);\n  const changed = entries.filter(e => e.type !== 'context').length;\n  if (changed === 0) return false;\n\n  // changed / total entries == diff size relative to the full plan view.\n  return changed / Math.max(entries.length, 1) <= maxChangedRatio;\n}\n"],"mappings":"AAeO,SAAS,iBAAiB,SAAiB,SAA8B;AAC9E,QAAM,WAAW,QAAQ,MAAM,OAAO;AACtC,QAAM,WAAW,QAAQ,MAAM,OAAO;AACtC,QAAM,IAAI,SAAS;AACnB,QAAM,IAAI,SAAS;AAGnB,QAAM,MAAkB,MAAM,KAAK,EAAE,QAAQ,IAAI,EAAE,GAAG,MAAM,IAAI,MAAc,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;AAC5F,WAASA,KAAI,IAAI,GAAGA,MAAK,GAAGA,MAAK;AAC/B,aAASC,KAAI,IAAI,GAAGA,MAAK,GAAGA,MAAK;AAC/B,UAAID,EAAC,EAAGC,EAAC,IAAI,SAASD,EAAC,MAAM,SAASC,EAAC,IAAI,IAAID,KAAI,CAAC,EAAGC,KAAI,CAAC,IAAK,IAAI,KAAK,IAAI,IAAID,KAAI,CAAC,EAAGC,EAAC,GAAI,IAAID,EAAC,EAAGC,KAAI,CAAC,CAAE;AAAA,IAChH;AAAA,EACF;AAEA,QAAM,UAAuB,CAAC;AAC9B,MAAI,IAAI;AACR,MAAI,IAAI;AACR,SAAO,IAAI,KAAK,IAAI,GAAG;AACrB,QAAI,SAAS,CAAC,MAAM,SAAS,CAAC,GAAG;AAC/B,cAAQ,KAAK,EAAE,MAAM,WAAW,MAAM,SAAS,CAAC,EAAG,CAAC;AACpD;AACA;AAAA,IACF,WAAW,IAAI,IAAI,CAAC,EAAG,CAAC,KAAM,IAAI,CAAC,EAAG,IAAI,CAAC,GAAI;AAC7C,cAAQ,KAAK,EAAE,MAAM,WAAW,MAAM,SAAS,CAAC,EAAG,CAAC;AACpD;AAAA,IACF,OAAO;AACL,cAAQ,KAAK,EAAE,MAAM,SAAS,MAAM,SAAS,CAAC,EAAG,CAAC;AAClD;AAAA,IACF;AAAA,EACF;AACA,SAAO,IAAI,EAAG,SAAQ,KAAK,EAAE,MAAM,WAAW,MAAM,SAAS,GAAG,EAAG,CAAC;AACpE,SAAO,IAAI,EAAG,SAAQ,KAAK,EAAE,MAAM,SAAS,MAAM,SAAS,GAAG,EAAG,CAAC;AAElE,SAAO;AACT;AAWO,SAAS,eAAe,cAAsB,MAAc,kBAAkB,KAAc;AACjG,MAAI,CAAC,gBAAgB,iBAAiB,KAAM,QAAO;AAEnD,QAAM,UAAU,iBAAiB,cAAc,IAAI;AACnD,QAAM,UAAU,QAAQ,OAAO,OAAK,EAAE,SAAS,SAAS,EAAE;AAC1D,MAAI,YAAY,EAAG,QAAO;AAG1B,SAAO,UAAU,KAAK,IAAI,QAAQ,QAAQ,CAAC,KAAK;AAClD;","names":["i","j"]}