@mastra/code-sdk 0.0.0-fix-workflow-step-timing-and-parallel-status-20260715180716

package/dist/utils/storage-maintenance.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/storage-maintenance.ts"],"sourcesContent":["/**\n * Storage maintenance — retention defaults and disk reclamation for mastracode.\n *\n * Retention (`DEFAULT_RETENTION`) is wired into the inner store by the storage\n * factory so `storage.prune()` can delete aged rows across every domain,\n * including the legacy libsql observability spans table.\n *\n * `prune()` only deletes rows — SQLite keeps the freed pages inside the file.\n * `reclaimLibSQLDisk()` returns that space to the OS by streaming a\n * `VACUUM INTO` copy of each file and swapping it into place. It requires all\n * connections to be closed first, so it only runs from the post-TUI\n * maintenance flow. We deliberately do NOT expose VACUUM as a public API on\n * LibSQLStore.\n */\n\nimport { closeSync, existsSync, openSync, readSync, renameSync, rmSync, statSync, statfsSync } from 'node:fs';\nimport { dirname } from 'node:path';\n\nimport type { MastraCompositeStore, PruneOptions, PruneResult, RetentionConfig } from '@mastra/core/storage';\n// Native `libsql` driver, deliberately alongside `@libsql/client` (used by the\n// stores): maintenance needs deterministic connection close for the\n// exclusivity probe, and the wrapper's close() can leave the file lock held\n// until GC finalizes cached statements. Don't \"clean up\" either dependency.\n// Upstream report: https://github.com/tursodatabase/libsql-js/issues/228\nimport Database from 'libsql';\n\nimport type { StorageConfig } from './project.js';\nimport { getDatabasePath, getVectorDatabasePath } from './project.js';\n\n/**\n * Default retention for mastracode's own storage. Tables not listed are kept\n * forever. Ages chosen for a local dev tool where observability data dwarfs\n * everything else (spans have been observed at 17+ GB):\n * - spans/logs: short-lived debugging telemetry → 14d\n * - scorer results & workflow snapshots: medium-lived run records → 30d\n * - chat history (messages/threads): long-lived, user-visible → 90d\n */\nexport const DEFAULT_RETENTION: RetentionConfig = {\n  memory: {\n    messages: { maxAge: '90d' },\n    threads: { maxAge: '90d' },\n  },\n  observability: {\n    spans: { maxAge: '14d' },\n    logs: { maxAge: '14d' },\n  },\n  scores: {\n    scorers: { maxAge: '30d' },\n  },\n  workflows: {\n    workflowSnapshot: { maxAge: '30d' },\n  },\n};\n\n/** Result of reclaiming disk for one database file (sizes include the WAL). */\nexport interface ReclaimResult {\n  file: string;\n  bytesBefore: number;\n  bytesAfter: number;\n}\n\n/** Handle the TUI uses to run storage maintenance without reaching into store internals. */\nexport interface StorageMaintenance {\n  backend: 'libsql' | 'pg';\n  /** Retention policies in effect (for display in /prune output). */\n  retention: RetentionConfig;\n  /** Delete rows older than the retention policies. Safe to re-run; batched and cancellable. `options.retention` replaces the standing policies for this call only. */\n  prune: (options?: PruneOptions) => Promise<PruneResult[]>;\n  /** Close the long-lived storage connection (checkpoints WAL for local libsql). Nothing can use the store afterwards. */\n  closeStorage?: () => Promise<void>;\n  /** Compact local libsql files (VACUUM INTO + swap) to return freed pages to the OS. Only set for local libsql backends. */\n  reclaimDisk?: (\n    onFileStart?: (file: string, bytesBefore: number, liveBytes: number) => void,\n  ) => Promise<ReclaimResult[]>;\n}\n\n/** db file size + its WAL sidecar, in bytes. Missing files count as 0. */\nfunction fileSizeWithWal(dbFile: string): number {\n  let total = 0;\n  for (const candidate of [dbFile, `${dbFile}-wal`]) {\n    try {\n      total += statSync(candidate).size;\n    } catch {\n      // file may not exist (e.g. WAL already truncated)\n    }\n  }\n  return total;\n}\n\n/** Free bytes required before compacting: the compacted copy plus 20% + 256 MB headroom. */\nexport function requiredFreeBytes(liveBytes: number): number {\n  return Math.ceil(liveBytes * 1.2) + 256 * 1024 * 1024;\n}\n\n/** First column of the first row of a PRAGMA result, as a number. */\nfunction pragmaNumber(db: InstanceType<typeof Database>, pragma: string): number {\n  const rows = db.pragma(pragma) as Array<Record<string, unknown>> | undefined;\n  const row = rows?.[0];\n  return row ? Number(Object.values(row)[0]) : 0;\n}\n\n/**\n * Journal mode straight from the SQLite file header (bytes 18/19:\n * 1 = rollback journal, 2 = WAL) — readable without opening a connection.\n */\nfunction journalModeFromHeader(file: string): 'wal' | 'delete' | 'unknown' {\n  const fd = openSync(file, 'r');\n  try {\n    const buf = Buffer.alloc(2);\n    if (readSync(fd, buf, 0, 2, 18) !== 2) return 'unknown';\n    if (buf[0] === 2 && buf[1] === 2) return 'wal';\n    if (buf[0] === 1 && buf[1] === 1) return 'delete';\n    return 'unknown';\n  } finally {\n    closeSync(fd);\n  }\n}\n\n/**\n * Compact each local libsql db file by streaming a `VACUUM INTO` copy next to\n * it, then swapping the copy into place. Reports before/after sizes.\n *\n * Deliberately NOT an in-place `VACUUM`: that copies all live content into a\n * temp store (held in memory by libsql builds with `temp_store=MEMORY`) and\n * then rewrites the entire database back through the WAL — on multi-GB\n * databases that has frozen whole machines via memory/IO exhaustion.\n * `VACUUM INTO` reads the logical database once and writes the compacted copy\n * sequentially with bounded memory, and the WAL never grows.\n *\n * Each file is preflighted: live bytes are estimated from\n * `page_count - freelist_count` and the copy is refused unless the volume has\n * `requiredFreeBytes()` available.\n *\n * MUST run with every connection to these files closed (the swap replaces the\n * inode — a surviving connection would keep writing to the unlinked old file).\n * `runStorageMaintenance()` closes storage before calling this.\n */\nexport async function reclaimLibSQLDisk(\n  dbFiles: string[],\n  onFileStart?: (file: string, bytesBefore: number, liveBytes: number) => void,\n): Promise<ReclaimResult[]> {\n  const results: ReclaimResult[] = [];\n  for (const file of dbFiles) {\n    // Skip missing files and files too small to have a SQLite header — nothing to reclaim\n    if (!existsSync(file) || statSync(file).size < 100) continue;\n    const bytesBefore = fileSizeWithWal(file);\n    const tmp = `${file}.vacuum-tmp`;\n    rmSync(tmp, { force: true });\n    // Prove we're the only connection before the swap: every open WAL-mode\n    // connection (all Mastra Code sessions run WAL) holds a shared-memory\n    // lock, so switching WAL -> DELETE only succeeds with exclusive access.\n    // A surviving connection would keep writing to the unlinked old inode\n    // after the swap and silently lose data.\n    //\n    // The probe uses exec() only and verifies the outcome from the SQLite\n    // file header: prepared statements (including db.pragma()) pin a libsql\n    // connection open past close(), so a failed in-connection probe would\n    // itself hold the WAL lock and poison every retry in this process.\n    // Upstream bug (libsql 0.5.x / @libsql/client 0.17.x): Database.close()\n    // does not finalize outstanding statements — they are only finalized by\n    // GC, so lock release after close() is nondeterministic. Reported as\n    // https://github.com/tursodatabase/libsql-js/issues/228 (fix in flight in\n    // PR #214). Once that lands, the header check can become a plain\n    // journal_mode query.\n    const probe = new Database(file);\n    try {\n      probe.exec('PRAGMA busy_timeout = 2000');\n      // Round-trip through WAL so the probe also works when a clean shutdown\n      // already left the file in rollback mode.\n      probe.exec('PRAGMA journal_mode = WAL');\n      probe.exec('PRAGMA journal_mode = DELETE');\n    } catch {\n      // busy — the header check below reports the failure\n    } finally {\n      probe.close();\n    }\n    if (journalModeFromHeader(file) !== 'delete') {\n      throw new Error(\n        `${file} is in use by another process — is another Mastra Code session running? ` +\n          `Close other sessions and run /prune vacuum again.`,\n      );\n    }\n    // Native `libsql` driver, not `@libsql/client`: the wrapper's close() can\n    // leave the file lock held in-process (cached statements), which would\n    // block other connections afterwards. This connection stays in rollback\n    // mode, so even a pinned statement holds no lock once we're done.\n    const db = new Database(file);\n    try {\n      db.exec('PRAGMA busy_timeout = 2000');\n      const pageSize = pragmaNumber(db, 'page_size');\n      const pageCount = pragmaNumber(db, 'page_count');\n      const freelistCount = pragmaNumber(db, 'freelist_count');\n      const liveBytes = Math.max(0, pageCount - freelistCount) * pageSize;\n      const { bsize, bavail } = statfsSync(dirname(file));\n      const freeBytes = bsize * bavail;\n      if (freeBytes < requiredFreeBytes(liveBytes)) {\n        throw new Error(\n          `Not enough free disk space to compact ${file}: need ${formatBytes(requiredFreeBytes(liveBytes))} ` +\n            `for a ${formatBytes(liveBytes)} compacted copy, but only ${formatBytes(freeBytes)} is free.`,\n        );\n      }\n      onFileStart?.(file, bytesBefore, liveBytes);\n      db.exec(`VACUUM INTO '${tmp.replace(/'/g, \"''\")}'`);\n    } catch (err) {\n      rmSync(tmp, { force: true });\n      throw err;\n    } finally {\n      db.close();\n    }\n    // Re-probe right before the swap: `VACUUM INTO` can take tens of seconds\n    // on multi-GB files, and a session started in that window reopens the db\n    // in WAL mode (flipping the header back). Swapping under it would orphan\n    // that session's inode and silently lose its writes.\n    if (journalModeFromHeader(file) !== 'delete') {\n      rmSync(tmp, { force: true });\n      throw new Error(\n        `${file} was opened by another process during compaction — is another Mastra Code session running? ` +\n          `Close other sessions and run /prune vacuum again.`,\n      );\n    }\n    // Swap the compacted copy into place. The old WAL/SHM sidecars belong to\n    // the old inode — they must never be paired with the new file. If any step\n    // after the first rename fails, restore the original so the db path is\n    // never left empty (a naive restart would otherwise create a fresh db).\n    renameSync(file, `${file}.old`);\n    try {\n      rmSync(`${file}-wal`, { force: true });\n      rmSync(`${file}-shm`, { force: true });\n      renameSync(tmp, file);\n    } catch (err) {\n      try {\n        renameSync(`${file}.old`, file);\n      } catch {\n        throw new Error(\n          `Failed to swap compacted copy into place AND failed to restore the original — ` +\n            `your data is intact at ${file}.old; rename it back to ${file} manually. ` +\n            `Original error: ${err instanceof Error ? err.message : String(err)}`,\n        );\n      }\n      rmSync(tmp, { force: true });\n      throw err;\n    }\n    rmSync(`${file}.old`, { force: true });\n    results.push({ file, bytesBefore, bytesAfter: fileSizeWithWal(file) });\n  }\n  return results;\n}\n\n/** `file:/path` or `file:///path` → filesystem path; undefined for non-file urls. */\nfunction fileUrlToPath(url: string): string | undefined {\n  if (!url.startsWith('file:')) return undefined;\n  return url.replace(/^file:\\/\\//, '').replace(/^file:/, '');\n}\n\n/**\n * Resolve the local libsql db files eligible for checkpoint + VACUUM.\n * Returns [] for remote (turso) urls and PG backends. When PG was requested\n * but the factory fell back to libsql, the fallback uses the default files.\n */\nexport function resolveLocalDbFiles(config: StorageConfig, effectiveBackend: 'libsql' | 'pg'): string[] {\n  if (effectiveBackend !== 'libsql') return [];\n  if (config.backend === 'pg') {\n    // PG requested but fell back to the default local libsql files\n    return [getDatabasePath(), getVectorDatabasePath()];\n  }\n  if (config.isRemote) return [];\n  const files: string[] = [];\n  const main = fileUrlToPath(config.url);\n  if (main) files.push(main);\n  const vector = config.vectorUrl ? fileUrlToPath(config.vectorUrl) : getVectorDatabasePath();\n  if (vector) files.push(vector);\n  return files;\n}\n\n/**\n * Build the maintenance handle for the effective storage backend.\n * `localDbFiles` are the local libsql file paths eligible for VACUUM;\n * pass an empty array for remote (turso) or PG backends.\n */\nexport function createStorageMaintenance(opts: {\n  storage: MastraCompositeStore;\n  backend: 'libsql' | 'pg';\n  retention: RetentionConfig;\n  localDbFiles: string[];\n  /** Closes the vector store's connection; required for local libsql so the compaction swap isn't blocked by our own handle. */\n  closeVector?: () => Promise<void>;\n}): StorageMaintenance {\n  const { storage, backend, retention, localDbFiles, closeVector } = opts;\n  return {\n    backend,\n    retention,\n    prune: options => storage.prune(options),\n    closeStorage: async () => {\n      await storage.close?.();\n      await closeVector?.();\n    },\n    ...(backend === 'libsql' && localDbFiles.length > 0\n      ? {\n          reclaimDisk: (onFileStart?: (file: string, bytesBefore: number, liveBytes: number) => void) =>\n            reclaimLibSQLDisk(localDbFiles, onFileStart),\n        }\n      : {}),\n  };\n}\n\nexport function formatBytes(bytes: number): string {\n  if (bytes < 1024) return `${bytes} B`;\n  const units = ['KB', 'MB', 'GB', 'TB'];\n  let value = bytes;\n  let unit = 'B';\n  for (const next of units) {\n    if (value < 1024) break;\n    value /= 1024;\n    unit = next;\n  }\n  return `${value.toFixed(1)} ${unit}`;\n}\n\n/** Rows deleted per table per pass: default batchSize (1000) × 20 batches. */\nconst PASS_MAX_BATCHES = 20;\n\n/**\n * Run storage maintenance with exclusive access to the database, reporting\n * progress through `log` (one line per pass so large deletes are visible).\n *\n * Must run AFTER the TUI is stopped and background writers are quiesced —\n * batched deletes and VACUUM contend with live writes (SQLITE_BUSY) and can\n * starve the event loop that renders the TUI. The storage connection is\n * closed at the end (checkpointing the WAL for local libsql), so the process\n * must exit afterwards.\n */\nexport async function runStorageMaintenance(opts: {\n  maintenance: StorageMaintenance;\n  vacuum: boolean;\n  /** Skip the memory domain (messages/threads) so chat history is preserved. */\n  keepMemory?: boolean;\n  log: (line: string) => void;\n}): Promise<void> {\n  const { maintenance, vacuum, keepMemory = false, log } = opts;\n\n  // keep-memory: prune with the standing policies minus the memory domain,\n  // for this run only. The configured retention is untouched.\n  const { memory: _memory, ...withoutMemory } = maintenance.retention;\n  const retentionForRun = keepMemory ? { retention: withoutMemory } : {};\n\n  log('Pruning rows older than the retention policies:');\n  for (const [domain, tables] of Object.entries(maintenance.retention)) {\n    for (const [table, policy] of Object.entries(tables ?? {})) {\n      const kept = keepMemory && domain === 'memory';\n      log(`  ${domain}.${table}: ${kept ? 'kept (keep-memory)' : (policy as { maxAge: string | number }).maxAge}`);\n    }\n  }\n\n  const totals = new Map<string, number>();\n  for (;;) {\n    const results = await maintenance.prune({ maxBatches: PASS_MAX_BATCHES, ...retentionForRun });\n    if (results.length === 0) break;\n    let remaining = false;\n    let deletedThisPass = 0;\n    for (const r of results) {\n      const key = `${r.domain}.${r.table}`;\n      totals.set(key, (totals.get(key) ?? 0) + r.deleted);\n      deletedThisPass += r.deleted;\n      if (!r.done) remaining = true;\n      if (r.deleted > 0) {\n        log(`  ${key}: ${totals.get(key)} rows deleted${r.done ? '' : ' so far…'}`);\n      }\n    }\n    if (!remaining) break;\n    // Safety valve: a table reported more eligible rows but nothing was\n    // deleted this pass — bail instead of spinning forever.\n    if (deletedThisPass === 0) {\n      log('  stopping: no progress in the last pass.');\n      break;\n    }\n  }\n  const totalDeleted = [...totals.values()].reduce((sum, n) => sum + n, 0);\n  log(\n    totalDeleted === 0\n      ? 'Nothing to prune — no retention-eligible rows found.'\n      : `Prune complete: ${totalDeleted} rows deleted.`,\n  );\n\n  // Release the long-lived connection: checkpoints the WAL for local libsql\n  // and guarantees VACUUM below isn't blocked by our own open handles.\n  await maintenance.closeStorage?.();\n\n  if (!vacuum) {\n    if (maintenance.reclaimDisk) {\n      log('Deleted rows free pages inside the db file but not on disk. Run /prune vacuum to reclaim disk space.');\n    }\n    return;\n  }\n\n  if (!maintenance.reclaimDisk) {\n    log('Disk reclamation (VACUUM) is only available for local libsql storage.');\n    return;\n  }\n\n  log('Reclaiming disk (compacting database files)… this can take several minutes on large databases.');\n  const reclaimed = await maintenance.reclaimDisk((file, bytesBefore, liveBytes) => {\n    log(`  vacuuming ${file} (${formatBytes(bytesBefore)}, ~${formatBytes(liveBytes)} live)…`);\n  });\n  if (reclaimed.length === 0) {\n    log('No local database files found to vacuum.');\n    return;\n  }\n  for (const r of reclaimed) {\n    log(`  ${r.file}: ${formatBytes(r.bytesBefore)} → ${formatBytes(r.bytesAfter)}`);\n  }\n  const saved = reclaimed.reduce((sum, r) => sum + Math.max(0, r.bytesBefore - r.bytesAfter), 0);\n  log(`Reclaimed ${formatBytes(saved)}.`);\n}\n"],"mappings":"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","names":[]}

package/dist/utils/thread-lock.d.ts

@@ -0,0 +1,26 @@
+export declare class ThreadLockError extends Error {
+    readonly threadId: string;
+    readonly ownerPid: number;
+    constructor(threadId: string, ownerPid: number);
+}
+/**
+ * Attempt to acquire a lock for the given thread.
+ * Throws ThreadLockError if another live process holds the lock.
+ * Reclaims stale locks from dead processes.
+ */
+export declare function acquireThreadLock(threadId: string): void;
+/**
+ * Release the lock for the given thread (only if we own it).
+ */
+export declare function releaseThreadLock(threadId: string): void;
+/**
+ * Check if a thread is locked by another process.
+ * Returns the PID of the owner if locked, null otherwise.
+ */
+export declare function getThreadLockOwner(threadId: string): number | null;
+/**
+ * Release all thread locks owned by this process.
+ * Call this on process exit.
+ */
+export declare function releaseAllThreadLocks(): void;
+//# sourceMappingURL=thread-lock.d.ts.map

package/dist/utils/thread-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-lock.d.ts","sourceRoot":"","sources":["../../src/utils/thread-lock.ts"],"names":[],"mappings":"AAWA,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,QAAQ,EAAE,MAAM;aAChB,QAAQ,EAAE,MAAM;gBADhB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM;CAKnC;AAyBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAsBxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAiBxD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuBlE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAqB5C"}

package/dist/utils/thread-lock.js

@@ -0,0 +1,108 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { getAppDataDir } from "./project.js";
+class ThreadLockError extends Error {
+  constructor(threadId, ownerPid) {
+    super(`Thread ${threadId} is locked by another process (PID ${ownerPid})`);
+    this.threadId = threadId;
+    this.ownerPid = ownerPid;
+    this.name = "ThreadLockError";
+  }
+  threadId;
+  ownerPid;
+}
+function getLocksDir() {
+  const dir = path.join(getAppDataDir(), "locks");
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  return dir;
+}
+function getLockPath(threadId) {
+  const safeId = threadId.replace(/[^a-zA-Z0-9_-]/g, "_");
+  return path.join(getLocksDir(), `${safeId}.lock`);
+}
+function isProcessAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function acquireThreadLock(threadId) {
+  const lockPath = getLockPath(threadId);
+  const myPid = process.pid;
+  if (fs.existsSync(lockPath)) {
+    try {
+      const content = fs.readFileSync(lockPath, "utf-8").trim();
+      const ownerPid = parseInt(content, 10);
+      if (!isNaN(ownerPid) && ownerPid !== myPid && isProcessAlive(ownerPid)) {
+        throw new ThreadLockError(threadId, ownerPid);
+      }
+    } catch (error) {
+      if (error instanceof ThreadLockError) throw error;
+    }
+  }
+  fs.writeFileSync(lockPath, String(myPid), { mode: 420 });
+}
+function releaseThreadLock(threadId) {
+  const lockPath = getLockPath(threadId);
+  const myPid = process.pid;
+  try {
+    if (!fs.existsSync(lockPath)) return;
+    const content = fs.readFileSync(lockPath, "utf-8").trim();
+    const ownerPid = parseInt(content, 10);
+    if (ownerPid === myPid) {
+      fs.unlinkSync(lockPath);
+    }
+  } catch {
+  }
+}
+function getThreadLockOwner(threadId) {
+  const lockPath = getLockPath(threadId);
+  try {
+    if (!fs.existsSync(lockPath)) return null;
+    const content = fs.readFileSync(lockPath, "utf-8").trim();
+    const ownerPid = parseInt(content, 10);
+    if (isNaN(ownerPid)) return null;
+    if (ownerPid === process.pid) return null;
+    if (!isProcessAlive(ownerPid)) {
+      try {
+        fs.unlinkSync(lockPath);
+      } catch {
+      }
+      return null;
+    }
+    return ownerPid;
+  } catch {
+    return null;
+  }
+}
+function releaseAllThreadLocks() {
+  try {
+    const locksDir = getLocksDir();
+    const files = fs.readdirSync(locksDir);
+    const myPid = String(process.pid);
+    for (const file of files) {
+      if (!file.endsWith(".lock")) continue;
+      const lockPath = path.join(locksDir, file);
+      try {
+        const content = fs.readFileSync(lockPath, "utf-8").trim();
+        if (content === myPid) {
+          fs.unlinkSync(lockPath);
+        }
+      } catch {
+      }
+    }
+  } catch {
+  }
+}
+export {
+  ThreadLockError,
+  acquireThreadLock,
+  getThreadLockOwner,
+  releaseAllThreadLocks,
+  releaseThreadLock
+};
+//# sourceMappingURL=thread-lock.js.map

package/dist/utils/thread-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/thread-lock.ts"],"sourcesContent":["/**\n * Thread lock — ensures only one process writes to a thread at a time.\n *\n * Uses filesystem lock files: <appDataDir>/locks/<threadId>.lock\n * Each lock file contains the PID of the owning process.\n * Stale locks (from crashed processes) are detected and reclaimed.\n */\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport { getAppDataDir } from './project.js';\n\nexport class ThreadLockError extends Error {\n  constructor(\n    public readonly threadId: string,\n    public readonly ownerPid: number,\n  ) {\n    super(`Thread ${threadId} is locked by another process (PID ${ownerPid})`);\n    this.name = 'ThreadLockError';\n  }\n}\n\nfunction getLocksDir(): string {\n  const dir = path.join(getAppDataDir(), 'locks');\n  if (!fs.existsSync(dir)) {\n    fs.mkdirSync(dir, { recursive: true });\n  }\n  return dir;\n}\n\nfunction getLockPath(threadId: string): string {\n  // Sanitize thread ID for filesystem safety\n  const safeId = threadId.replace(/[^a-zA-Z0-9_-]/g, '_');\n  return path.join(getLocksDir(), `${safeId}.lock`);\n}\n\nfunction isProcessAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Attempt to acquire a lock for the given thread.\n * Throws ThreadLockError if another live process holds the lock.\n * Reclaims stale locks from dead processes.\n */\nexport function acquireThreadLock(threadId: string): void {\n  const lockPath = getLockPath(threadId);\n  const myPid = process.pid;\n\n  // Check for existing lock\n  if (fs.existsSync(lockPath)) {\n    try {\n      const content = fs.readFileSync(lockPath, 'utf-8').trim();\n      const ownerPid = parseInt(content, 10);\n\n      if (!isNaN(ownerPid) && ownerPid !== myPid && isProcessAlive(ownerPid)) {\n        throw new ThreadLockError(threadId, ownerPid);\n      }\n      // Stale lock (dead process) or our own lock — reclaim it\n    } catch (error) {\n      if (error instanceof ThreadLockError) throw error;\n      // File read error — try to overwrite\n    }\n  }\n\n  // Write our PID to the lock file\n  fs.writeFileSync(lockPath, String(myPid), { mode: 0o644 });\n}\n\n/**\n * Release the lock for the given thread (only if we own it).\n */\nexport function releaseThreadLock(threadId: string): void {\n  const lockPath = getLockPath(threadId);\n  const myPid = process.pid;\n\n  try {\n    if (!fs.existsSync(lockPath)) return;\n\n    const content = fs.readFileSync(lockPath, 'utf-8').trim();\n    const ownerPid = parseInt(content, 10);\n\n    // Only remove if we own it\n    if (ownerPid === myPid) {\n      fs.unlinkSync(lockPath);\n    }\n  } catch {\n    // Best-effort cleanup — ignore errors\n  }\n}\n\n/**\n * Check if a thread is locked by another process.\n * Returns the PID of the owner if locked, null otherwise.\n */\nexport function getThreadLockOwner(threadId: string): number | null {\n  const lockPath = getLockPath(threadId);\n\n  try {\n    if (!fs.existsSync(lockPath)) return null;\n\n    const content = fs.readFileSync(lockPath, 'utf-8').trim();\n    const ownerPid = parseInt(content, 10);\n\n    if (isNaN(ownerPid)) return null;\n    if (ownerPid === process.pid) return null; // Our own lock\n    if (!isProcessAlive(ownerPid)) {\n      // Stale lock — clean it up\n      try {\n        fs.unlinkSync(lockPath);\n      } catch {}\n      return null;\n    }\n\n    return ownerPid;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Release all thread locks owned by this process.\n * Call this on process exit.\n */\nexport function releaseAllThreadLocks(): void {\n  try {\n    const locksDir = getLocksDir();\n    const files = fs.readdirSync(locksDir);\n    const myPid = String(process.pid);\n\n    for (const file of files) {\n      if (!file.endsWith('.lock')) continue;\n      const lockPath = path.join(locksDir, file);\n      try {\n        const content = fs.readFileSync(lockPath, 'utf-8').trim();\n        if (content === myPid) {\n          fs.unlinkSync(lockPath);\n        }\n      } catch {\n        // Best-effort\n      }\n    }\n  } catch {\n    // Best-effort\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/utils/token-estimator.d.ts

@@ -0,0 +1,3 @@
+export declare function tokenEstimate(text: string | object): number;
+export declare function truncateStringForTokenEstimate(text: string, desiredTokenCount: number, fromEnd?: boolean): string;
+//# sourceMappingURL=token-estimator.d.ts.map

package/dist/utils/token-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.d.ts","sourceRoot":"","sources":["../../src/utils/token-estimator.ts"],"names":[],"mappings":"AASA,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,UAAO,UAUrG"}

package/dist/utils/token-estimator.js

@@ -0,0 +1,21 @@
+import { estimateTokenCount, sliceByTokens } from "tokenx";
+function sanitizeInput(text) {
+  if (!text) return "";
+  return (typeof text === `string` ? text : JSON.stringify(text)).replaceAll(`<|endoftext|>`, ``).replaceAll(`<|endofprompt|>`, ``);
+}
+function tokenEstimate(text) {
+  return estimateTokenCount(sanitizeInput(text));
+}
+function truncateStringForTokenEstimate(text, desiredTokenCount, fromEnd = true) {
+  const sanitized = sanitizeInput(text);
+  const totalTokens = estimateTokenCount(sanitized);
+  if (totalTokens <= desiredTokenCount) return sanitized;
+  const kept = fromEnd ? sliceByTokens(sanitized, -desiredTokenCount) : sliceByTokens(sanitized, 0, desiredTokenCount);
+  return `[Truncated ~${totalTokens - desiredTokenCount} tokens]
+${kept}`;
+}
+export {
+  tokenEstimate,
+  truncateStringForTokenEstimate
+};
+//# sourceMappingURL=token-estimator.js.map

package/dist/utils/token-estimator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/token-estimator.ts"],"sourcesContent":["import { estimateTokenCount, sliceByTokens } from 'tokenx';\n\nfunction sanitizeInput(text: string | object) {\n  if (!text) return '';\n  return (typeof text === `string` ? text : JSON.stringify(text))\n    .replaceAll(`<|endoftext|>`, ``)\n    .replaceAll(`<|endofprompt|>`, ``);\n}\n\nexport function tokenEstimate(text: string | object): number {\n  return estimateTokenCount(sanitizeInput(text));\n}\n\nexport function truncateStringForTokenEstimate(text: string, desiredTokenCount: number, fromEnd = true) {\n  const sanitized = sanitizeInput(text);\n  const totalTokens = estimateTokenCount(sanitized);\n\n  if (totalTokens <= desiredTokenCount) return sanitized;\n\n  const kept = fromEnd ? sliceByTokens(sanitized, -desiredTokenCount) : sliceByTokens(sanitized, 0, desiredTokenCount);\n\n  return `[Truncated ~${totalTokens - desiredTokenCount} tokens]\n${kept}`;\n}\n"],"mappings":"AAAA,SAAS,oBAAoB,qBAAqB;AAElD,SAAS,cAAc,MAAuB;AAC5C,MAAI,CAAC,KAAM,QAAO;AAClB,UAAQ,OAAO,SAAS,WAAW,OAAO,KAAK,UAAU,IAAI,GAC1D,WAAW,iBAAiB,EAAE,EAC9B,WAAW,mBAAmB,EAAE;AACrC;AAEO,SAAS,cAAc,MAA+B;AAC3D,SAAO,mBAAmB,cAAc,IAAI,CAAC;AAC/C;AAEO,SAAS,+BAA+B,MAAc,mBAA2B,UAAU,MAAM;AACtG,QAAM,YAAY,cAAc,IAAI;AACpC,QAAM,cAAc,mBAAmB,SAAS;AAEhD,MAAI,eAAe,kBAAmB,QAAO;AAE7C,QAAM,OAAO,UAAU,cAAc,WAAW,CAAC,iBAAiB,IAAI,cAAc,WAAW,GAAG,iBAAiB;AAEnH,SAAO,eAAe,cAAc,iBAAiB;AAAA,EACrD,IAAI;AACN;","names":[]}

package/dist/utils/update-check.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Check for newer versions of mastracode on npm.
+ */
+export type PackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun';
+/**
+ * Detect which package manager was used to install mastracode globally.
+ *
+ * Uses a multi-tier approach:
+ * 1. npm_config_user_agent env var (set when run via `pnpm run`, `npm run`, etc.)
+ * 2. npm_execpath env var (fallback for script-based invocation)
+ * 3. NODE_PATH env var (set by pnpm global bin stubs)
+ * 4. Resolved path of the running script (process.argv[1])
+ * 5. Shell-out to `pnpm list -g` to check if pnpm manages the package
+ * 6. Falls back to 'npm'
+ */
+export declare function detectPackageManager(): Promise<PackageManager>;
+/**
+ * Build the shell command string a user would run to install/update globally.
+ */
+export declare function getInstallCommand(pm: PackageManager, version?: string): string;
+/**
+ * Read the current version, injected at build time by tsup's `define` option.
+ * Falls back to reading package.json at runtime (e.g. when running from source with tsx).
+ */
+export declare function getCurrentVersion(): string;
+/**
+ * Fetch the latest published version from npm.
+ * Returns null if the fetch fails (network error, timeout, etc.).
+ */
+export declare function fetchLatestVersion(): Promise<string | null>;
+/**
+ * Simple semver comparison: returns true if `latest` is newer than `current`.
+ * Handles standard x.y.z versions. Ignores pre-release tags.
+ */
+export declare function isNewerVersion(current: string, latest: string): boolean;
+/**
+ * Fetch the CHANGELOG.md for a specific published version from the npm CDN
+ * and extract a human-readable summary of changes.
+ * Returns null if the fetch fails or the changelog can't be parsed.
+ */
+export declare function fetchChangelog(version: string): Promise<string | null>;
+/**
+ * Extract the changelog section for a specific version and format it
+ * as a concise bullet list suitable for terminal display.
+ */
+export declare function parseChangelog(markdown: string, version: string): string | null;
+/**
+ * Run the appropriate global install command to update mastracode.
+ * Returns true on success, false on failure.
+ */
+export declare function runUpdate(pm: PackageManager, targetVersion: string): Promise<boolean>;
+//# sourceMappingURL=update-check.d.ts.map

package/dist/utils/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../../src/utils/update-check.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAW7D;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,cAAc,CAAC,CA0CpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAY9E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAS1C;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAcjE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAevE;AAKD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAe5E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiD/E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOrF"}

package/dist/utils/update-check.js

@@ -0,0 +1,177 @@
+import { execFile } from "node:child_process";
+import { readFileSync, realpathSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const PACKAGE_NAME = "mastracode";
+const NPM_REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+const FETCH_TIMEOUT_MS = 5e3;
+function matchPM(str) {
+  if (/pnpm/i.test(str)) return "pnpm";
+  if (/\byarn\b/i.test(str)) return "yarn";
+  if (/\bbun\b/i.test(str)) return "bun";
+  if (/\bnpm\b/i.test(str)) return "npm";
+  return null;
+}
+async function detectPackageManager() {
+  const userAgent = process.env.npm_config_user_agent;
+  if (userAgent) {
+    const pm = matchPM(userAgent);
+    if (pm) return pm;
+  }
+  const execPath = process.env.npm_execpath;
+  if (execPath) {
+    const pm = matchPM(execPath);
+    if (pm) return pm;
+  }
+  const nodePath = process.env.NODE_PATH;
+  if (nodePath) {
+    if (/[/\\]\.pnpm[/\\]/.test(nodePath) || /[/\\]pnpm[/\\]/.test(nodePath)) return "pnpm";
+    if (/[/\\]\.yarn[/\\]/.test(nodePath)) return "yarn";
+    if (/[/\\]\.bun[/\\]/.test(nodePath)) return "bun";
+  }
+  try {
+    const scriptPath = realpathSync(process.argv[1] ?? "");
+    if (/[/\\]\.?pnpm[/\\]/.test(scriptPath)) return "pnpm";
+    if (/[/\\]\.?yarn[/\\]/.test(scriptPath)) return "yarn";
+    if (/[/\\]\.?bun[/\\]/.test(scriptPath)) return "bun";
+  } catch {
+  }
+  const pnpmResult = await new Promise((resolve2) => {
+    execFile("pnpm", ["list", "-g", "--depth=0", PACKAGE_NAME], { timeout: 3e3 }, (error, stdout) => {
+      resolve2(!error && stdout.includes(PACKAGE_NAME));
+    });
+  });
+  if (pnpmResult) return "pnpm";
+  return "npm";
+}
+function getInstallCommand(pm, version) {
+  const pkg = version ? `${PACKAGE_NAME}@${version}` : `${PACKAGE_NAME}@latest`;
+  switch (pm) {
+    case "pnpm":
+      return `pnpm add -g ${pkg}`;
+    case "yarn":
+      return `yarn global add ${pkg}`;
+    case "bun":
+      return `bun add -g ${pkg}`;
+    default:
+      return `npm install -g ${pkg}`;
+  }
+}
+function getCurrentVersion() {
+  if (typeof MASTRACODE_VERSION !== "undefined") {
+    return MASTRACODE_VERSION;
+  }
+  const dir = dirname(fileURLToPath(import.meta.url));
+  const pkgPath = resolve(dir, "../../package.json");
+  const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+  return pkg.version;
+}
+async function fetchLatestVersion() {
+  if (process.env.MASTRACODE_UPDATE_LATEST_VERSION) return process.env.MASTRACODE_UPDATE_LATEST_VERSION;
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+    const res = await fetch(NPM_REGISTRY_URL, { signal: controller.signal });
+    clearTimeout(timeout);
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data.version ?? null;
+  } catch {
+    return null;
+  }
+}
+function isNewerVersion(current, latest) {
+  const parse = (v) => v.replace(/^v/, "").split("-")[0].split(".").map((s) => {
+    const n = Number(s);
+    return Number.isFinite(n) ? n : 0;
+  });
+  const [cMajor = 0, cMinor = 0, cPatch = 0] = parse(current);
+  const [lMajor = 0, lMinor = 0, lPatch = 0] = parse(latest);
+  if (lMajor !== cMajor) return lMajor > cMajor;
+  if (lMinor !== cMinor) return lMinor > cMinor;
+  return lPatch > cPatch;
+}
+const MAX_CHANGELOG_ENTRIES = 20;
+async function fetchChangelog(version) {
+  if (process.env.MASTRACODE_UPDATE_CHANGELOG) return process.env.MASTRACODE_UPDATE_CHANGELOG;
+  try {
+    const url = `https://unpkg.com/${PACKAGE_NAME}@${version}/CHANGELOG.md`;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+    const res = await fetch(url, { signal: controller.signal });
+    clearTimeout(timeout);
+    if (!res.ok) return null;
+    const text = await res.text();
+    return parseChangelog(text, version);
+  } catch {
+    return null;
+  }
+}
+function parseChangelog(markdown, version) {
+  const versionHeader = `## ${version}`;
+  const startIdx = markdown.indexOf(versionHeader);
+  if (startIdx === -1) return null;
+  const afterHeader = startIdx + versionHeader.length;
+  const nextHeaderIdx = markdown.indexOf("\n## ", afterHeader);
+  const section = nextHeaderIdx === -1 ? markdown.slice(afterHeader) : markdown.slice(afterHeader, nextHeaderIdx);
+  const lines = section.split("\n");
+  const entries = [];
+  let skipIndented = false;
+  for (let i = 0; i < lines.length; i++) {
+    const raw = lines[i];
+    const trimmed = raw.trim();
+    const isTopLevel = raw === trimmed && trimmed.startsWith("- ");
+    if (!isTopLevel) {
+      if (skipIndented && /^\s+-\s/.test(raw)) continue;
+      skipIndented = false;
+      continue;
+    }
+    if (/^- Updated dependenc/i.test(trimmed)) {
+      skipIndented = true;
+      continue;
+    }
+    skipIndented = false;
+    let entry = trimmed.slice(2);
+    entry = entry.replace(/\[([^\]]+)\]\([^)]+\)/g, "$1");
+    entry = entry.replace(/\s*\(#\d+\)\s*/g, " ");
+    entry = entry.replace(/\s*\(`[a-f0-9]+`\)\s*/g, " ");
+    entry = entry.replace(/\.\s*$/, "");
+    entry = entry.trim();
+    if (entry) entries.push(entry);
+    if (entries.length >= MAX_CHANGELOG_ENTRIES) break;
+  }
+  if (entries.length === 0) return null;
+  return entries.map((e) => `  \u2022 ${e}`).join("\n");
+}
+function runUpdate(pm, targetVersion) {
+  const args = buildInstallArgs(pm, targetVersion);
+  return new Promise((resolve2) => {
+    execFile(pm, args, { timeout: 6e4 }, (error) => {
+      resolve2(!error);
+    });
+  });
+}
+function buildInstallArgs(pm, version) {
+  const pkg = `${PACKAGE_NAME}@${version}`;
+  switch (pm) {
+    case "pnpm":
+      return ["add", "-g", pkg];
+    case "yarn":
+      return ["global", "add", pkg];
+    case "bun":
+      return ["add", "-g", pkg];
+    default:
+      return ["install", "-g", pkg];
+  }
+}
+export {
+  detectPackageManager,
+  fetchChangelog,
+  fetchLatestVersion,
+  getCurrentVersion,
+  getInstallCommand,
+  isNewerVersion,
+  parseChangelog,
+  runUpdate
+};
+//# sourceMappingURL=update-check.js.map

package/dist/utils/update-check.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/update-check.ts"],"sourcesContent":["/**\n * Check for newer versions of mastracode on npm.\n */\n\nimport { execFile } from 'node:child_process';\nimport { readFileSync, realpathSync } from 'node:fs';\nimport { dirname, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\ndeclare const MASTRACODE_VERSION: string | undefined;\n\nconst PACKAGE_NAME = 'mastracode';\nconst NPM_REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;\n\n/** Timeout for the npm registry fetch (ms). */\nconst FETCH_TIMEOUT_MS = 5_000;\n\nexport type PackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun';\n\nfunction matchPM(str: string): PackageManager | null {\n  // Order matters: check pnpm before npm since \"npm\" is a substring of some paths\n  if (/pnpm/i.test(str)) return 'pnpm';\n  if (/\\byarn\\b/i.test(str)) return 'yarn';\n  if (/\\bbun\\b/i.test(str)) return 'bun';\n  if (/\\bnpm\\b/i.test(str)) return 'npm';\n  return null;\n}\n\n/**\n * Detect which package manager was used to install mastracode globally.\n *\n * Uses a multi-tier approach:\n * 1. npm_config_user_agent env var (set when run via `pnpm run`, `npm run`, etc.)\n * 2. npm_execpath env var (fallback for script-based invocation)\n * 3. NODE_PATH env var (set by pnpm global bin stubs)\n * 4. Resolved path of the running script (process.argv[1])\n * 5. Shell-out to `pnpm list -g` to check if pnpm manages the package\n * 6. Falls back to 'npm'\n */\nexport async function detectPackageManager(): Promise<PackageManager> {\n  // Tier 1: npm_config_user_agent (most reliable when available)\n  const userAgent = process.env.npm_config_user_agent;\n  if (userAgent) {\n    const pm = matchPM(userAgent);\n    if (pm) return pm;\n  }\n\n  // Tier 2: npm_execpath\n  const execPath = process.env.npm_execpath;\n  if (execPath) {\n    const pm = matchPM(execPath);\n    if (pm) return pm;\n  }\n\n  // Tier 3: NODE_PATH (pnpm global stubs set this to paths containing .pnpm)\n  const nodePath = process.env.NODE_PATH;\n  if (nodePath) {\n    if (/[/\\\\]\\.pnpm[/\\\\]/.test(nodePath) || /[/\\\\]pnpm[/\\\\]/.test(nodePath)) return 'pnpm';\n    if (/[/\\\\]\\.yarn[/\\\\]/.test(nodePath)) return 'yarn';\n    if (/[/\\\\]\\.bun[/\\\\]/.test(nodePath)) return 'bun';\n  }\n\n  // Tier 4: Resolved script path\n  try {\n    const scriptPath = realpathSync(process.argv[1] ?? '');\n    if (/[/\\\\]\\.?pnpm[/\\\\]/.test(scriptPath)) return 'pnpm';\n    if (/[/\\\\]\\.?yarn[/\\\\]/.test(scriptPath)) return 'yarn';\n    if (/[/\\\\]\\.?bun[/\\\\]/.test(scriptPath)) return 'bun';\n  } catch {\n    // realpathSync can fail if argv[1] is missing/broken — fall through\n  }\n\n  // Tier 5: Check if the package is in pnpm's global store (non-blocking)\n  const pnpmResult = await new Promise<boolean>(resolve => {\n    execFile('pnpm', ['list', '-g', '--depth=0', PACKAGE_NAME], { timeout: 3_000 }, (error, stdout) => {\n      resolve(!error && stdout.includes(PACKAGE_NAME));\n    });\n  });\n  if (pnpmResult) return 'pnpm';\n\n  return 'npm';\n}\n\n/**\n * Build the shell command string a user would run to install/update globally.\n */\nexport function getInstallCommand(pm: PackageManager, version?: string): string {\n  const pkg = version ? `${PACKAGE_NAME}@${version}` : `${PACKAGE_NAME}@latest`;\n  switch (pm) {\n    case 'pnpm':\n      return `pnpm add -g ${pkg}`;\n    case 'yarn':\n      return `yarn global add ${pkg}`;\n    case 'bun':\n      return `bun add -g ${pkg}`;\n    default:\n      return `npm install -g ${pkg}`;\n  }\n}\n\n/**\n * Read the current version, injected at build time by tsup's `define` option.\n * Falls back to reading package.json at runtime (e.g. when running from source with tsx).\n */\nexport function getCurrentVersion(): string {\n  if (typeof MASTRACODE_VERSION !== 'undefined') {\n    return MASTRACODE_VERSION;\n  }\n  // Fallback for running from source (e.g. pnpx tsx mastracode/src/main.ts)\n  const dir = dirname(fileURLToPath(import.meta.url));\n  const pkgPath = resolve(dir, '../../package.json');\n  const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));\n  return pkg.version;\n}\n\n/**\n * Fetch the latest published version from npm.\n * Returns null if the fetch fails (network error, timeout, etc.).\n */\nexport async function fetchLatestVersion(): Promise<string | null> {\n  if (process.env.MASTRACODE_UPDATE_LATEST_VERSION) return process.env.MASTRACODE_UPDATE_LATEST_VERSION;\n\n  try {\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);\n    const res = await fetch(NPM_REGISTRY_URL, { signal: controller.signal });\n    clearTimeout(timeout);\n    if (!res.ok) return null;\n    const data = (await res.json()) as { version?: string };\n    return data.version ?? null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Simple semver comparison: returns true if `latest` is newer than `current`.\n * Handles standard x.y.z versions. Ignores pre-release tags.\n */\nexport function isNewerVersion(current: string, latest: string): boolean {\n  const parse = (v: string) =>\n    v\n      .replace(/^v/, '')\n      .split('-')[0]!\n      .split('.')\n      .map(s => {\n        const n = Number(s);\n        return Number.isFinite(n) ? n : 0;\n      });\n  const [cMajor = 0, cMinor = 0, cPatch = 0] = parse(current);\n  const [lMajor = 0, lMinor = 0, lPatch = 0] = parse(latest);\n  if (lMajor !== cMajor) return lMajor > cMajor;\n  if (lMinor !== cMinor) return lMinor > cMinor;\n  return lPatch > cPatch;\n}\n\n/** Max entries to show in the changelog summary. */\nconst MAX_CHANGELOG_ENTRIES = 20;\n\n/**\n * Fetch the CHANGELOG.md for a specific published version from the npm CDN\n * and extract a human-readable summary of changes.\n * Returns null if the fetch fails or the changelog can't be parsed.\n */\nexport async function fetchChangelog(version: string): Promise<string | null> {\n  if (process.env.MASTRACODE_UPDATE_CHANGELOG) return process.env.MASTRACODE_UPDATE_CHANGELOG;\n\n  try {\n    const url = `https://unpkg.com/${PACKAGE_NAME}@${version}/CHANGELOG.md`;\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);\n    const res = await fetch(url, { signal: controller.signal });\n    clearTimeout(timeout);\n    if (!res.ok) return null;\n    const text = await res.text();\n    return parseChangelog(text, version);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Extract the changelog section for a specific version and format it\n * as a concise bullet list suitable for terminal display.\n */\nexport function parseChangelog(markdown: string, version: string): string | null {\n  const versionHeader = `## ${version}`;\n  const startIdx = markdown.indexOf(versionHeader);\n  if (startIdx === -1) return null;\n\n  const afterHeader = startIdx + versionHeader.length;\n  const nextHeaderIdx = markdown.indexOf('\\n## ', afterHeader);\n  const section = nextHeaderIdx === -1 ? markdown.slice(afterHeader) : markdown.slice(afterHeader, nextHeaderIdx);\n\n  const lines = section.split('\\n');\n  const entries: string[] = [];\n  let skipIndented = false;\n\n  for (let i = 0; i < lines.length; i++) {\n    const raw = lines[i]!;\n    const trimmed = raw.trim();\n\n    // Only match top-level entries (no leading whitespace before \"- \")\n    const isTopLevel = raw === trimmed && trimmed.startsWith('- ');\n    if (!isTopLevel) {\n      // Skip indented sub-items (e.g. dependency list entries)\n      if (skipIndented && /^\\s+-\\s/.test(raw)) continue;\n      skipIndented = false;\n      continue;\n    }\n\n    // Skip dependency update entries and their sub-items\n    if (/^- Updated dependenc/i.test(trimmed)) {\n      skipIndented = true;\n      continue;\n    }\n    skipIndented = false;\n\n    let entry = trimmed.slice(2);\n    // Strip markdown links: [text](url) → text\n    entry = entry.replace(/\\[([^\\]]+)\\]\\([^)]+\\)/g, '$1');\n    // Strip PR references like (#15760)\n    entry = entry.replace(/\\s*\\(#\\d+\\)\\s*/g, ' ');\n    // Strip commit SHA references like (`abc123`)\n    entry = entry.replace(/\\s*\\(`[a-f0-9]+`\\)\\s*/g, ' ');\n    // Trim trailing periods for cleaner bullet display\n    entry = entry.replace(/\\.\\s*$/, '');\n    entry = entry.trim();\n    if (entry) entries.push(entry);\n    if (entries.length >= MAX_CHANGELOG_ENTRIES) break;\n  }\n\n  if (entries.length === 0) return null;\n  return entries.map(e => `  • ${e}`).join('\\n');\n}\n\n/**\n * Run the appropriate global install command to update mastracode.\n * Returns true on success, false on failure.\n */\nexport function runUpdate(pm: PackageManager, targetVersion: string): Promise<boolean> {\n  const args = buildInstallArgs(pm, targetVersion);\n  return new Promise(resolve => {\n    execFile(pm, args, { timeout: 60_000 }, error => {\n      resolve(!error);\n    });\n  });\n}\n\nfunction buildInstallArgs(pm: PackageManager, version: string): string[] {\n  const pkg = `${PACKAGE_NAME}@${version}`;\n  switch (pm) {\n    case 'pnpm':\n      return ['add', '-g', pkg];\n    case 'yarn':\n      return ['global', 'add', pkg];\n    case 'bun':\n      return ['add', '-g', pkg];\n    default:\n      return ['install', '-g', pkg];\n  }\n}\n"],"mappings":"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","names":["resolve"]}

package/dist/voice/stt-registry.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Speech-to-text (STT) model registry for push-to-talk voice input.
+ *
+ * This is the single source of truth shared by the `/voice` settings picker,
+ * settings validation, and the cloud transcription resolver. Entries are
+ * derived from models.dev (https://models.dev/api.json): a model is treated as
+ * STT when its modalities are audio-in / text-out with no text input.
+ *
+ * Most cloud providers here speak the OpenAI `/audio/transcriptions` shape, so
+ * the cloud engine resolves them through Mastra's `OpenAIVoice` (`MastraVoice`)
+ * built on the OpenAI client — `openai` uses the default endpoint, every other
+ * OpenAI-compatible host supplies its `baseURL`. Deepgram is the exception: it
+ * is not OpenAI-compatible, so it resolves through `@mastra/voice-deepgram`
+ * (`DeepgramVoice`). Deepgram is not in the models.dev STT snapshot but is a
+ * first-class hosted STT provider, so it is added deliberately.
+ *
+ * The accompanying snapshot test (`__tests__/stt-registry.test.ts`) re-derives
+ * the models.dev-backed entries from a checked-in snapshot so this list stays
+ * honest and can be refreshed deliberately rather than drifting by hand.
+ */
+/**
+ * How a provider's transcription model is constructed.
+ * - `openai`: `OpenAIVoice` with the default OpenAI endpoint.
+ * - `openai-compatible`: `OpenAIVoice` pointed at the host's `baseURL`
+ *   (its `/audio/transcriptions` endpoint follows the OpenAI shape).
+ * - `deepgram`: `DeepgramVoice` from `@mastra/voice-deepgram` (not
+ *   OpenAI-compatible; uses the Deepgram SDK).
+ */
+export type STTResolver = 'openai' | 'openai-compatible' | 'deepgram';
+export interface STTModel {
+    /** models.dev provider id (also the AuthStorage key for the API key). */
+    provider: string;
+    /** Bare model id passed to the provider's transcription factory. */
+    model: string;
+    /** Human-friendly label for the picker. */
+    label: string;
+    /** How to build the transcription model. */
+    resolver: STTResolver;
+    /** Base URL for `openai-compatible` providers (from models.dev `api`). */
+    baseURL?: string;
+}
+/**
+ * The curated STT catalog. Order matters: the first entry for a provider is its
+ * default model, and the first overall entry (`openai`/`whisper-1`) is the
+ * global default.
+ */
+export declare const STT_MODELS: readonly STTModel[];
+/** The global default STT model (first registry entry). */
+export declare const DEFAULT_STT_MODEL: STTModel;
+/** The default STT provider when none is configured. */
+export declare const DEFAULT_STT_PROVIDER: string;
+/** Unique provider ids in registry order. */
+export declare function sttProviders(): string[];
+/** All models offered for a provider, in registry order. */
+export declare function sttModelsForProvider(provider: string): STTModel[];
+/** The default (first) model for a provider, or undefined if unknown. */
+export declare function defaultModelForProvider(provider: string): STTModel | undefined;
+/**
+ * Resolve a provider/model pair to a concrete registry entry.
+ * Falls back to the provider default (then the global default) so callers
+ * always get a usable entry even if settings name an unknown model.
+ */
+export declare function resolveSTTModel(provider?: string, model?: string): STTModel;
+//# sourceMappingURL=stt-registry.d.ts.map

package/dist/voice/stt-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stt-registry.d.ts","sourceRoot":"","sources":["../../src/voice/stt-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,mBAAmB,GAAG,UAAU,CAAC;AAEtE,MAAM,WAAW,QAAQ;IACvB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,QAAQ,EAAE,WAAW,CAAC;IACtB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAqFhC,CAAC;AAEX,2DAA2D;AAC3D,eAAO,MAAM,iBAAiB,EAAE,QAAyB,CAAC;AAE1D,wDAAwD;AACxD,eAAO,MAAM,oBAAoB,QAA6B,CAAC;AAE/D,6CAA6C;AAC7C,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAUvC;AAED,4DAA4D;AAC5D,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE,CAEjE;AAED,yEAAyE;AACzE,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAE9E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CAU3E"}