@mastra/code-sdk 1.0.3-alpha.0 → 1.1.0-alpha.2

package/dist/utils/project.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/project.ts"],"sourcesContent":["/**\n * Project detection utilities\n *\n * Detects project identity from git repo or filesystem path.\n * Handles git worktrees by finding the main repository.\n */\n\nimport { execFile, execSync } from 'node:child_process';\nimport { createHash } from 'node:crypto';\nimport fs from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { DEFAULT_CONFIG_DIR } from '../constants.js';\nexport interface ProjectInfo {\n  /** Unique resource ID for this project (used for thread grouping) */\n  resourceId: string;\n  /** Human-readable project name */\n  name: string;\n  /** Absolute path to the project root */\n  rootPath: string;\n  /** Git remote URL if available */\n  gitUrl?: string;\n  /** Current git branch */\n  gitBranch?: string;\n  /** Whether this is a git worktree */\n  isWorktree: boolean;\n  /** Path to main git repo (different from rootPath if worktree) */\n  mainRepoPath?: string;\n  /** Whether the resourceId was explicitly overridden (env var or config) */\n  resourceIdOverride?: boolean;\n}\n\n/**\n * Run a git command and return stdout, or undefined if it fails\n */\nfunction git(args: string, cwd: string): string | undefined {\n  try {\n    return execSync(`git ${args}`, {\n      cwd,\n      encoding: 'utf-8',\n      stdio: ['pipe', 'pipe', 'pipe'],\n    }).trim();\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Slugify a string for use in IDs\n */\nfunction slugify(str: string): string {\n  return str\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-|-$/g, '');\n}\n\n/**\n * Create a short hash of a string\n */\nfunction shortHash(str: string): string {\n  return createHash('sha256').update(str).digest('hex').slice(0, 12);\n}\n\n/**\n * Normalize a git URL to a canonical form for comparison\n * - Removes .git suffix\n * - Converts SSH to HTTPS format for consistency\n * - Lowercases\n */\nfunction normalizeGitUrl(url: string): string {\n  return url\n    .replace(/\\.git$/, '')\n    .replace(/^git@([^:]+):/, 'https://$1/')\n    .replace(/^ssh:\\/\\/git@/, 'https://')\n    .toLowerCase();\n}\n\n/**\n * Detect project info from a directory path\n */\nexport function detectProject(projectPath: string): ProjectInfo {\n  const absolutePath = path.resolve(projectPath);\n\n  // Check if this is a git repo\n  const gitDir = git('rev-parse --git-dir', absolutePath);\n  const isGitRepo = gitDir !== undefined;\n\n  let rootPath = absolutePath;\n  let gitUrl: string | undefined;\n  let gitBranch: string | undefined;\n  let isWorktree = false;\n  let mainRepoPath: string | undefined;\n\n  if (isGitRepo) {\n    // Get the repo root (handles being in a subdirectory)\n    rootPath = git('rev-parse --show-toplevel', absolutePath) || absolutePath;\n\n    // Check for worktree - git-common-dir differs from git-dir in worktrees\n    const commonDir = git('rev-parse --git-common-dir', absolutePath);\n    if (commonDir && commonDir !== '.git' && commonDir !== gitDir) {\n      isWorktree = true;\n      // The common dir is inside the main repo's .git folder\n      mainRepoPath = path.dirname(path.resolve(rootPath, commonDir));\n    }\n\n    // Get remote URL (prefer origin, fall back to first remote)\n    gitUrl = git('remote get-url origin', absolutePath);\n    if (!gitUrl) {\n      const remotes = git('remote', absolutePath);\n      if (remotes) {\n        const firstRemote = remotes.split('\\n')[0];\n        if (firstRemote) {\n          gitUrl = git(`remote get-url ${firstRemote}`, absolutePath);\n        }\n      }\n    }\n\n    // Get current branch\n    gitBranch = git('rev-parse --abbrev-ref HEAD', absolutePath);\n  }\n\n  // Generate resource ID\n  // Priority: normalized git URL > main repo path (for worktrees) > absolute path\n  let resourceIdSource: string;\n  if (gitUrl) {\n    resourceIdSource = normalizeGitUrl(gitUrl);\n  } else if (mainRepoPath) {\n    resourceIdSource = mainRepoPath;\n  } else {\n    resourceIdSource = rootPath;\n  }\n\n  // Create a readable but unique resource ID\n  // Format: slugified-name-shorthash\n  const baseName = gitUrl\n    ? gitUrl\n        .split('/')\n        .pop()\n        ?.replace(/\\.git$/, '') || 'project'\n    : path.basename(rootPath);\n\n  const resourceId = `${slugify(baseName)}-${shortHash(resourceIdSource)}`;\n\n  return {\n    resourceId,\n    name: baseName,\n    rootPath,\n    gitUrl,\n    gitBranch,\n    isWorktree,\n    mainRepoPath,\n  };\n}\n\n/**\n * Get the current git branch for a given directory.\n * Lightweight alternative to detectProject() for refreshing just the branch.\n */\nexport function getCurrentGitBranch(cwd: string): string | undefined {\n  return git('rev-parse --abbrev-ref HEAD', cwd);\n}\n\n/**\n * Async version of getCurrentGitBranch — avoids blocking the event loop\n * with execSync.  Falls back to undefined on any failure.\n */\nexport function getCurrentGitBranchAsync(cwd: string): Promise<string | undefined> {\n  return new Promise(resolve => {\n    execFile('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd, encoding: 'utf-8' }, (err, stdout) => {\n      if (err) {\n        resolve(undefined);\n        return;\n      }\n      const branch = stdout.trim();\n      resolve(branch || undefined);\n    });\n  });\n}\n\n/**\n * Get the application data directory for mastracode\n * - macOS: ~/Library/Application Support/mastracode\n * - Linux: ~/.local/share/mastracode\n * - Windows: %APPDATA%/mastracode\n */\nexport function getAppDataDir(): string {\n  if (process.env.MASTRA_APP_DATA_DIR) {\n    fs.mkdirSync(process.env.MASTRA_APP_DATA_DIR, { recursive: true });\n    return process.env.MASTRA_APP_DATA_DIR;\n  }\n\n  const platform = os.platform();\n  let baseDir: string;\n\n  if (platform === 'darwin') {\n    baseDir = path.join(os.homedir(), 'Library', 'Application Support');\n  } else if (platform === 'win32') {\n    baseDir = process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming');\n  } else {\n    // Linux and others - follow XDG spec\n    baseDir = process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share');\n  }\n\n  const appDir = path.join(baseDir, 'mastracode');\n\n  // Ensure directory exists\n  if (!fs.existsSync(appDir)) {\n    fs.mkdirSync(appDir, { recursive: true });\n  }\n\n  return appDir;\n}\n/**\n * Get the database path for mastracode\n * Can be overridden with the MASTRA_DB_PATH environment variable for debugging.\n */\nexport function getDatabasePath(): string {\n  if (process.env.MASTRA_DB_PATH) {\n    return process.env.MASTRA_DB_PATH;\n  }\n  return path.join(getAppDataDir(), 'mastra.db');\n}\n\n/**\n * Get the vector database path for mastracode.\n * Separate from the main DB to avoid bloating it with embedding data.\n */\nexport function getVectorDatabasePath(): string {\n  return path.join(getAppDataDir(), 'mastra-vectors.db');\n}\n\n/**\n * Get the observability DuckDB database path for mastracode.\n * Separate from the main DB — DuckDB is used for OLAP-style trace/score/feedback queries.\n * Can be overridden with the MASTRA_OBSERVABILITY_DB_PATH environment variable.\n */\nexport function getObservabilityDatabasePath(): string {\n  if (process.env.MASTRA_OBSERVABILITY_DB_PATH) {\n    return process.env.MASTRA_OBSERVABILITY_DB_PATH;\n  }\n  return path.join(getAppDataDir(), 'observability.duckdb');\n}\n\nimport type { StorageBackend, StorageSettings } from '../onboarding/settings.js';\n\n/**\n * LibSQL storage configuration.\n */\nexport interface LibSQLStorageConfig {\n  backend: 'libsql';\n  url: string;\n  authToken?: string;\n  isRemote: boolean;\n  /**\n   * Optional explicit url for the recall vector DB. When omitted, the factory\n   * uses the shared default vector file.\n   */\n  vectorUrl?: string;\n  /** Auth token for the vector DB when `vectorUrl` points at a remote libSQL. */\n  vectorAuthToken?: string;\n}\n\n/**\n * PostgreSQL storage configuration.\n */\nexport interface PgStorageConfig {\n  backend: 'pg';\n  connectionString?: string;\n  host?: string;\n  port?: number;\n  database?: string;\n  user?: string;\n  password?: string;\n  schemaName?: string;\n  disableInit?: boolean;\n  skipDefaultIndexes?: boolean;\n}\n\n/**\n * Resolved storage configuration for either backend.\n */\nexport type StorageConfig = LibSQLStorageConfig | PgStorageConfig;\n\n/**\n * Get the resolved storage configuration.\n *\n * Priority (highest to lowest):\n *   1. Environment variables: MASTRA_STORAGE_BACKEND + backend-specific vars\n *   2. Global settings (from /settings): settings.storage\n *   3. Legacy config files: .mastracode/database.json (LibSQL only)\n *   4. Local file database (LibSQL default)\n *\n * For PG, the env vars are:\n *   MASTRA_STORAGE_BACKEND=pg\n *   MASTRA_PG_CONNECTION_STRING or MASTRA_PG_HOST/PORT/DATABASE/USER/PASSWORD\n *   MASTRA_PG_SCHEMA_NAME (optional)\n *\n * For LibSQL, the legacy env vars still work:\n *   MASTRA_DB_URL + MASTRA_DB_AUTH_TOKEN\n */\nexport function getStorageConfig(\n  projectDir?: string,\n  storageSettings?: StorageSettings,\n  configDirName = DEFAULT_CONFIG_DIR,\n): StorageConfig {\n  // 1. Environment variable — explicit backend selection\n  const envBackend = process.env.MASTRA_STORAGE_BACKEND as StorageBackend | undefined;\n\n  if (envBackend === 'pg') {\n    return resolvePgFromEnv();\n  }\n\n  // Legacy LibSQL env vars (MASTRA_DB_URL) — treat as explicit libsql\n  if (envBackend === 'libsql' || process.env.MASTRA_DB_URL) {\n    return resolveLibSQLFromEnv();\n  }\n\n  // 2. Global settings (from /settings)\n  if (storageSettings && storageSettings.backend === 'pg') {\n    return resolvePgFromSettings(storageSettings);\n  }\n\n  if (storageSettings && storageSettings.backend === 'libsql' && storageSettings.libsql.url) {\n    return {\n      backend: 'libsql',\n      url: storageSettings.libsql.url,\n      authToken: storageSettings.libsql.authToken,\n      isRemote: !storageSettings.libsql.url.startsWith('file:'),\n    };\n  }\n\n  // 3. Legacy project/global config files (.mastracode/database.json)\n  if (projectDir) {\n    const projectConfig = loadDatabaseConfig(path.join(projectDir, configDirName, 'database.json'));\n    if (projectConfig) return projectConfig;\n  }\n  const globalConfig = loadDatabaseConfig(path.join(os.homedir(), configDirName, 'database.json'));\n  if (globalConfig) return globalConfig;\n\n  // 4. Default: local LibSQL file database\n  return {\n    backend: 'libsql',\n    url: `file:${getDatabasePath()}`,\n    isRemote: false,\n  };\n}\n\nfunction resolveLibSQLFromEnv(): LibSQLStorageConfig {\n  const url = process.env.MASTRA_DB_URL!;\n  return {\n    backend: 'libsql',\n    url,\n    authToken: process.env.MASTRA_DB_AUTH_TOKEN,\n    isRemote: !url.startsWith('file:'),\n  };\n}\n\nfunction resolvePgFromEnv(): PgStorageConfig {\n  const connectionString = process.env.MASTRA_PG_CONNECTION_STRING;\n  if (connectionString) {\n    return {\n      backend: 'pg',\n      connectionString,\n      schemaName: process.env.MASTRA_PG_SCHEMA_NAME,\n    };\n  }\n\n  // Host/port style\n  return {\n    backend: 'pg',\n    host: process.env.MASTRA_PG_HOST,\n    port: process.env.MASTRA_PG_PORT ? parseInt(process.env.MASTRA_PG_PORT, 10) : undefined,\n    database: process.env.MASTRA_PG_DATABASE,\n    user: process.env.MASTRA_PG_USER,\n    password: process.env.MASTRA_PG_PASSWORD,\n    schemaName: process.env.MASTRA_PG_SCHEMA_NAME,\n  };\n}\n\nfunction resolvePgFromSettings(settings: StorageSettings): PgStorageConfig {\n  const pg = settings.pg;\n  return {\n    backend: 'pg',\n    connectionString: pg.connectionString,\n    host: pg.host,\n    port: pg.port,\n    database: pg.database,\n    user: pg.user,\n    password: pg.password,\n    schemaName: pg.schemaName,\n    disableInit: pg.disableInit,\n    skipDefaultIndexes: pg.skipDefaultIndexes,\n  };\n}\n\n/**\n * Load database config from a legacy JSON file.\n * Expected format: { \"url\": \"libsql://...\", \"authToken\": \"...\" }\n */\nfunction loadDatabaseConfig(filePath: string): LibSQLStorageConfig | null {\n  try {\n    if (!fs.existsSync(filePath)) return null;\n    const raw = fs.readFileSync(filePath, 'utf-8');\n    const parsed = JSON.parse(raw);\n    if (typeof parsed?.url === 'string' && parsed.url) {\n      return {\n        backend: 'libsql',\n        url: parsed.url,\n        authToken: typeof parsed.authToken === 'string' ? parsed.authToken : undefined,\n        isRemote: !parsed.url.startsWith('file:'),\n      };\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Get the current user identity.\n *\n * Priority:\n *   1. MASTRA_USER_ID environment variable\n *   2. git config user.email (from project dir or global)\n *   3. OS username as fallback\n */\nexport function getUserId(projectDir?: string): string {\n  // 1. Environment variable override\n  if (process.env.MASTRA_USER_ID) {\n    return process.env.MASTRA_USER_ID;\n  }\n\n  // 2. git user.email\n  const cwd = projectDir || process.cwd();\n  const email = git('config user.email', cwd);\n  if (email) {\n    return email;\n  }\n\n  // 3. OS username fallback\n  return os.userInfo().username || 'unknown';\n}\n\n/**\n * Get the current user's display name.\n *\n * Priority:\n *   1. git config user.name\n *   2. OS username as fallback\n */\nexport function getUserName(projectDir?: string): string {\n  const cwd = projectDir || process.cwd();\n  const name = git('config user.name', cwd);\n  if (name) {\n    return name;\n  }\n  return os.userInfo().username || 'unknown';\n}\n\n/**\n * Observational memory scope: \"thread\" (per-conversation) or \"resource\" (shared across threads).\n */\nexport type OmScope = 'thread' | 'resource';\n\n/**\n * Get the configured observational memory scope.\n *\n * Priority:\n *   1. MASTRA_OM_SCOPE environment variable (\"thread\" or \"resource\")\n *   2. Project config: .mastracode/database.json → omScope\n *   3. Global config: ~/.mastracode/database.json → omScope\n *   4. Default: \"thread\"\n */\nexport function getOmScope(projectDir?: string, configDirName = DEFAULT_CONFIG_DIR): OmScope {\n  // 1. Environment variable\n  const envScope = process.env.MASTRA_OM_SCOPE;\n  if (envScope === 'thread' || envScope === 'resource') {\n    return envScope;\n  }\n\n  // 2. Project-level config\n  if (projectDir) {\n    const scope = loadOmScopeFromConfig(path.join(projectDir, configDirName, 'database.json'));\n    if (scope) return scope;\n  }\n\n  // 3. Global config\n  const scope = loadOmScopeFromConfig(path.join(os.homedir(), configDirName, 'database.json'));\n  if (scope) return scope;\n\n  // 4. Default\n  return 'thread';\n}\n\nfunction loadOmScopeFromConfig(filePath: string): OmScope | null {\n  try {\n    if (!fs.existsSync(filePath)) return null;\n    const raw = fs.readFileSync(filePath, 'utf-8');\n    const parsed = JSON.parse(raw);\n    if (parsed?.omScope === 'thread' || parsed?.omScope === 'resource') {\n      return parsed.omScope;\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Get an explicit resource ID override, if configured.\n *\n * Resource IDs act as shared tags — two users who set the same resourceId\n * will share threads and observations for that resource.\n *\n * Priority:\n *   1. MASTRA_RESOURCE_ID environment variable\n *   2. Project config: .mastracode/database.json → resourceId\n *   3. Global config: ~/.mastracode/database.json → resourceId\n *   4. null (use auto-detected value)\n */\nexport function getResourceIdOverride(projectDir?: string, configDirName = DEFAULT_CONFIG_DIR): string | null {\n  // 1. Environment variable\n  if (process.env.MASTRA_RESOURCE_ID) {\n    return process.env.MASTRA_RESOURCE_ID;\n  }\n\n  // 2. Project-level config\n  if (projectDir) {\n    const rid = loadStringField(path.join(projectDir, configDirName, 'database.json'), 'resourceId');\n    if (rid) return rid;\n  }\n\n  // 3. Global config\n  const rid = loadStringField(path.join(os.homedir(), configDirName, 'database.json'), 'resourceId');\n  if (rid) return rid;\n\n  return null;\n}\n\nfunction loadStringField(filePath: string, field: string): string | null {\n  try {\n    if (!fs.existsSync(filePath)) return null;\n    const raw = fs.readFileSync(filePath, 'utf-8');\n    const parsed = JSON.parse(raw);\n    const value = parsed?.[field];\n    if (typeof value === 'string' && value) {\n      return value;\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n"],"mappings":"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","names":["scope","rid"]}
+{"version":3,"file":"project.js","names":[],"sources":["../../src/utils/project.ts"],"sourcesContent":["/**\n * Project detection utilities\n *\n * Detects project identity from git repo or filesystem path.\n * Handles git worktrees by finding the main repository.\n */\n\nimport { execFile, execSync } from 'node:child_process';\nimport { createHash } from 'node:crypto';\nimport fs from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { DEFAULT_CONFIG_DIR } from '../constants.js';\nexport interface ProjectInfo {\n  /** Unique resource ID for this project (used for thread grouping) */\n  resourceId: string;\n  /** Human-readable project name */\n  name: string;\n  /** Absolute path to the project root */\n  rootPath: string;\n  /** Git remote URL if available */\n  gitUrl?: string;\n  /** Current git branch */\n  gitBranch?: string;\n  /** Whether this is a git worktree */\n  isWorktree: boolean;\n  /** Path to main git repo (different from rootPath if worktree) */\n  mainRepoPath?: string;\n  /** Whether the resourceId was explicitly overridden (env var or config) */\n  resourceIdOverride?: boolean;\n}\n\n/**\n * Run a git command and return stdout, or undefined if it fails\n */\nfunction git(args: string, cwd: string): string | undefined {\n  try {\n    return execSync(`git ${args}`, {\n      cwd,\n      encoding: 'utf-8',\n      stdio: ['pipe', 'pipe', 'pipe'],\n    }).trim();\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Slugify a string for use in IDs\n */\nfunction slugify(str: string): string {\n  return str\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-|-$/g, '');\n}\n\n/**\n * Create a short hash of a string\n */\nfunction shortHash(str: string): string {\n  return createHash('sha256').update(str).digest('hex').slice(0, 12);\n}\n\n/**\n * Normalize a git URL to a canonical form for comparison\n * - Removes .git suffix\n * - Converts SSH to HTTPS format for consistency\n * - Lowercases\n */\nfunction normalizeGitUrl(url: string): string {\n  return url\n    .replace(/\\.git$/, '')\n    .replace(/^git@([^:]+):/, 'https://$1/')\n    .replace(/^ssh:\\/\\/git@/, 'https://')\n    .toLowerCase();\n}\n\n/**\n * Detect project info from a directory path\n */\nexport function detectProject(projectPath: string): ProjectInfo {\n  const absolutePath = path.resolve(projectPath);\n\n  // Check if this is a git repo\n  const gitDir = git('rev-parse --git-dir', absolutePath);\n  const isGitRepo = gitDir !== undefined;\n\n  let rootPath = absolutePath;\n  let gitUrl: string | undefined;\n  let gitBranch: string | undefined;\n  let isWorktree = false;\n  let mainRepoPath: string | undefined;\n\n  if (isGitRepo) {\n    // Get the repo root (handles being in a subdirectory)\n    rootPath = git('rev-parse --show-toplevel', absolutePath) || absolutePath;\n\n    // Check for worktree - git-common-dir differs from git-dir in worktrees\n    const commonDir = git('rev-parse --git-common-dir', absolutePath);\n    if (commonDir && commonDir !== '.git' && commonDir !== gitDir) {\n      isWorktree = true;\n      // The common dir is inside the main repo's .git folder\n      mainRepoPath = path.dirname(path.resolve(rootPath, commonDir));\n    }\n\n    // Get remote URL (prefer origin, fall back to first remote)\n    gitUrl = git('remote get-url origin', absolutePath);\n    if (!gitUrl) {\n      const remotes = git('remote', absolutePath);\n      if (remotes) {\n        const firstRemote = remotes.split('\\n')[0];\n        if (firstRemote) {\n          gitUrl = git(`remote get-url ${firstRemote}`, absolutePath);\n        }\n      }\n    }\n\n    // Get current branch\n    gitBranch = git('rev-parse --abbrev-ref HEAD', absolutePath);\n  }\n\n  // Generate resource ID\n  // Priority: normalized git URL > main repo path (for worktrees) > absolute path\n  let resourceIdSource: string;\n  if (gitUrl) {\n    resourceIdSource = normalizeGitUrl(gitUrl);\n  } else if (mainRepoPath) {\n    resourceIdSource = mainRepoPath;\n  } else {\n    resourceIdSource = rootPath;\n  }\n\n  // Create a readable but unique resource ID\n  // Format: slugified-name-shorthash\n  const baseName = gitUrl\n    ? gitUrl\n        .split('/')\n        .pop()\n        ?.replace(/\\.git$/, '') || 'project'\n    : path.basename(rootPath);\n\n  const resourceId = `${slugify(baseName)}-${shortHash(resourceIdSource)}`;\n\n  return {\n    resourceId,\n    name: baseName,\n    rootPath,\n    gitUrl,\n    gitBranch,\n    isWorktree,\n    mainRepoPath,\n  };\n}\n\n/**\n * Get the current git branch for a given directory.\n * Lightweight alternative to detectProject() for refreshing just the branch.\n */\nexport function getCurrentGitBranch(cwd: string): string | undefined {\n  return git('rev-parse --abbrev-ref HEAD', cwd);\n}\n\n/**\n * Async version of getCurrentGitBranch — avoids blocking the event loop\n * with execSync.  Falls back to undefined on any failure.\n */\nexport function getCurrentGitBranchAsync(cwd: string): Promise<string | undefined> {\n  return new Promise(resolve => {\n    execFile('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd, encoding: 'utf-8' }, (err, stdout) => {\n      if (err) {\n        resolve(undefined);\n        return;\n      }\n      const branch = stdout.trim();\n      resolve(branch || undefined);\n    });\n  });\n}\n\n/**\n * Get the application data directory for mastracode\n * - macOS: ~/Library/Application Support/mastracode\n * - Linux: ~/.local/share/mastracode\n * - Windows: %APPDATA%/mastracode\n */\nexport function getAppDataDir(): string {\n  if (process.env.MASTRA_APP_DATA_DIR) {\n    fs.mkdirSync(process.env.MASTRA_APP_DATA_DIR, { recursive: true });\n    return process.env.MASTRA_APP_DATA_DIR;\n  }\n\n  const platform = os.platform();\n  let baseDir: string;\n\n  if (platform === 'darwin') {\n    baseDir = path.join(os.homedir(), 'Library', 'Application Support');\n  } else if (platform === 'win32') {\n    baseDir = process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming');\n  } else {\n    // Linux and others - follow XDG spec\n    baseDir = process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share');\n  }\n\n  const appDir = path.join(baseDir, 'mastracode');\n\n  // Ensure directory exists\n  if (!fs.existsSync(appDir)) {\n    fs.mkdirSync(appDir, { recursive: true });\n  }\n\n  return appDir;\n}\n/**\n * Get the database path for mastracode\n * Can be overridden with the MASTRA_DB_PATH environment variable for debugging.\n */\nexport function getDatabasePath(): string {\n  if (process.env.MASTRA_DB_PATH) {\n    return process.env.MASTRA_DB_PATH;\n  }\n  return path.join(getAppDataDir(), 'mastra.db');\n}\n\n/**\n * Get the vector database path for mastracode.\n * Separate from the main DB to avoid bloating it with embedding data.\n */\nexport function getVectorDatabasePath(): string {\n  return path.join(getAppDataDir(), 'mastra-vectors.db');\n}\n\n/**\n * Get the observability DuckDB database path for mastracode.\n * Separate from the main DB — DuckDB is used for OLAP-style trace/score/feedback queries.\n * Can be overridden with the MASTRA_OBSERVABILITY_DB_PATH environment variable.\n */\nexport function getObservabilityDatabasePath(): string {\n  if (process.env.MASTRA_OBSERVABILITY_DB_PATH) {\n    return process.env.MASTRA_OBSERVABILITY_DB_PATH;\n  }\n  return path.join(getAppDataDir(), 'observability.duckdb');\n}\n\nimport type { StorageBackend, StorageSettings } from '../onboarding/settings.js';\n\n/**\n * LibSQL storage configuration.\n */\nexport interface LibSQLStorageConfig {\n  backend: 'libsql';\n  url: string;\n  authToken?: string;\n  isRemote: boolean;\n  /**\n   * Optional explicit url for the recall vector DB. When omitted, the factory\n   * uses the shared default vector file.\n   */\n  vectorUrl?: string;\n  /** Auth token for the vector DB when `vectorUrl` points at a remote libSQL. */\n  vectorAuthToken?: string;\n}\n\n/**\n * PostgreSQL storage configuration.\n */\nexport interface PgStorageConfig {\n  backend: 'pg';\n  connectionString?: string;\n  host?: string;\n  port?: number;\n  database?: string;\n  user?: string;\n  password?: string;\n  schemaName?: string;\n  disableInit?: boolean;\n  skipDefaultIndexes?: boolean;\n}\n\n/**\n * Resolved storage configuration for either backend.\n */\nexport type StorageConfig = LibSQLStorageConfig | PgStorageConfig;\n\n/**\n * Get the resolved storage configuration.\n *\n * Priority (highest to lowest):\n *   1. Environment variables: MASTRA_STORAGE_BACKEND + backend-specific vars\n *   2. Global settings (from /settings): settings.storage\n *   3. Legacy config files: .mastracode/database.json (LibSQL only)\n *   4. Local file database (LibSQL default)\n *\n * For PG, the env vars are:\n *   MASTRA_STORAGE_BACKEND=pg\n *   MASTRA_PG_CONNECTION_STRING or MASTRA_PG_HOST/PORT/DATABASE/USER/PASSWORD\n *   MASTRA_PG_SCHEMA_NAME (optional)\n *\n * For LibSQL, the legacy env vars still work:\n *   MASTRA_DB_URL + MASTRA_DB_AUTH_TOKEN\n */\nexport function getStorageConfig(\n  projectDir?: string,\n  storageSettings?: StorageSettings,\n  configDirName = DEFAULT_CONFIG_DIR,\n): StorageConfig {\n  // 1. Environment variable — explicit backend selection\n  const envBackend = process.env.MASTRA_STORAGE_BACKEND as StorageBackend | undefined;\n\n  if (envBackend === 'pg') {\n    return resolvePgFromEnv();\n  }\n\n  // Legacy LibSQL env vars (MASTRA_DB_URL) — treat as explicit libsql\n  if (envBackend === 'libsql' || process.env.MASTRA_DB_URL) {\n    return resolveLibSQLFromEnv();\n  }\n\n  // 2. Global settings (from /settings)\n  if (storageSettings && storageSettings.backend === 'pg') {\n    return resolvePgFromSettings(storageSettings);\n  }\n\n  if (storageSettings && storageSettings.backend === 'libsql' && storageSettings.libsql.url) {\n    return {\n      backend: 'libsql',\n      url: storageSettings.libsql.url,\n      authToken: storageSettings.libsql.authToken,\n      isRemote: !storageSettings.libsql.url.startsWith('file:'),\n    };\n  }\n\n  // 3. Legacy project/global config files (.mastracode/database.json)\n  if (projectDir) {\n    const projectConfig = loadDatabaseConfig(path.join(projectDir, configDirName, 'database.json'));\n    if (projectConfig) return projectConfig;\n  }\n  const globalConfig = loadDatabaseConfig(path.join(os.homedir(), configDirName, 'database.json'));\n  if (globalConfig) return globalConfig;\n\n  // 4. Default: local LibSQL file database\n  return {\n    backend: 'libsql',\n    url: `file:${getDatabasePath()}`,\n    isRemote: false,\n  };\n}\n\nfunction resolveLibSQLFromEnv(): LibSQLStorageConfig {\n  const url = process.env.MASTRA_DB_URL!;\n  return {\n    backend: 'libsql',\n    url,\n    authToken: process.env.MASTRA_DB_AUTH_TOKEN,\n    isRemote: !url.startsWith('file:'),\n  };\n}\n\nfunction resolvePgFromEnv(): PgStorageConfig {\n  const connectionString = process.env.MASTRA_PG_CONNECTION_STRING;\n  if (connectionString) {\n    return {\n      backend: 'pg',\n      connectionString,\n      schemaName: process.env.MASTRA_PG_SCHEMA_NAME,\n    };\n  }\n\n  // Host/port style\n  return {\n    backend: 'pg',\n    host: process.env.MASTRA_PG_HOST,\n    port: process.env.MASTRA_PG_PORT ? parseInt(process.env.MASTRA_PG_PORT, 10) : undefined,\n    database: process.env.MASTRA_PG_DATABASE,\n    user: process.env.MASTRA_PG_USER,\n    password: process.env.MASTRA_PG_PASSWORD,\n    schemaName: process.env.MASTRA_PG_SCHEMA_NAME,\n  };\n}\n\nfunction resolvePgFromSettings(settings: StorageSettings): PgStorageConfig {\n  const pg = settings.pg;\n  return {\n    backend: 'pg',\n    connectionString: pg.connectionString,\n    host: pg.host,\n    port: pg.port,\n    database: pg.database,\n    user: pg.user,\n    password: pg.password,\n    schemaName: pg.schemaName,\n    disableInit: pg.disableInit,\n    skipDefaultIndexes: pg.skipDefaultIndexes,\n  };\n}\n\n/**\n * Load database config from a legacy JSON file.\n * Expected format: { \"url\": \"libsql://...\", \"authToken\": \"...\" }\n */\nfunction loadDatabaseConfig(filePath: string): LibSQLStorageConfig | null {\n  try {\n    if (!fs.existsSync(filePath)) return null;\n    const raw = fs.readFileSync(filePath, 'utf-8');\n    const parsed = JSON.parse(raw);\n    if (typeof parsed?.url === 'string' && parsed.url) {\n      return {\n        backend: 'libsql',\n        url: parsed.url,\n        authToken: typeof parsed.authToken === 'string' ? parsed.authToken : undefined,\n        isRemote: !parsed.url.startsWith('file:'),\n      };\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Get the current user identity.\n *\n * Priority:\n *   1. MASTRA_USER_ID environment variable\n *   2. git config user.email (from project dir or global)\n *   3. OS username as fallback\n */\nexport function getUserId(projectDir?: string): string {\n  // 1. Environment variable override\n  if (process.env.MASTRA_USER_ID) {\n    return process.env.MASTRA_USER_ID;\n  }\n\n  // 2. git user.email\n  const cwd = projectDir || process.cwd();\n  const email = git('config user.email', cwd);\n  if (email) {\n    return email;\n  }\n\n  // 3. OS username fallback\n  return os.userInfo().username || 'unknown';\n}\n\n/**\n * Get the current user's display name.\n *\n * Priority:\n *   1. git config user.name\n *   2. OS username as fallback\n */\nexport function getUserName(projectDir?: string): string {\n  const cwd = projectDir || process.cwd();\n  const name = git('config user.name', cwd);\n  if (name) {\n    return name;\n  }\n  return os.userInfo().username || 'unknown';\n}\n\n/**\n * Observational memory scope: \"thread\" (per-conversation) or \"resource\" (shared across threads).\n */\nexport type OmScope = 'thread' | 'resource';\n\n/**\n * Get the configured observational memory scope.\n *\n * Priority:\n *   1. MASTRA_OM_SCOPE environment variable (\"thread\" or \"resource\")\n *   2. Project config: .mastracode/database.json → omScope\n *   3. Global config: ~/.mastracode/database.json → omScope\n *   4. Default: \"thread\"\n */\nexport function getOmScope(projectDir?: string, configDirName = DEFAULT_CONFIG_DIR): OmScope {\n  // 1. Environment variable\n  const envScope = process.env.MASTRA_OM_SCOPE;\n  if (envScope === 'thread' || envScope === 'resource') {\n    return envScope;\n  }\n\n  // 2. Project-level config\n  if (projectDir) {\n    const scope = loadOmScopeFromConfig(path.join(projectDir, configDirName, 'database.json'));\n    if (scope) return scope;\n  }\n\n  // 3. Global config\n  const scope = loadOmScopeFromConfig(path.join(os.homedir(), configDirName, 'database.json'));\n  if (scope) return scope;\n\n  // 4. Default\n  return 'thread';\n}\n\nfunction loadOmScopeFromConfig(filePath: string): OmScope | null {\n  try {\n    if (!fs.existsSync(filePath)) return null;\n    const raw = fs.readFileSync(filePath, 'utf-8');\n    const parsed = JSON.parse(raw);\n    if (parsed?.omScope === 'thread' || parsed?.omScope === 'resource') {\n      return parsed.omScope;\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Get an explicit resource ID override, if configured.\n *\n * Resource IDs act as shared tags — two users who set the same resourceId\n * will share threads and observations for that resource.\n *\n * Priority:\n *   1. MASTRA_RESOURCE_ID environment variable\n *   2. Project config: .mastracode/database.json → resourceId\n *   3. Global config: ~/.mastracode/database.json → resourceId\n *   4. null (use auto-detected value)\n */\nexport function getResourceIdOverride(projectDir?: string, configDirName = DEFAULT_CONFIG_DIR): string | null {\n  // 1. Environment variable\n  if (process.env.MASTRA_RESOURCE_ID) {\n    return process.env.MASTRA_RESOURCE_ID;\n  }\n\n  // 2. Project-level config\n  if (projectDir) {\n    const rid = loadStringField(path.join(projectDir, configDirName, 'database.json'), 'resourceId');\n    if (rid) return rid;\n  }\n\n  // 3. Global config\n  const rid = loadStringField(path.join(os.homedir(), configDirName, 'database.json'), 'resourceId');\n  if (rid) return rid;\n\n  return null;\n}\n\nfunction loadStringField(filePath: string, field: string): string | null {\n  try {\n    if (!fs.existsSync(filePath)) return null;\n    const raw = fs.readFileSync(filePath, 'utf-8');\n    const parsed = JSON.parse(raw);\n    const value = parsed?.[field];\n    if (typeof value === 'string' && value) {\n      return value;\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n"],"mappings":"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"}

package/dist/utils/signals-pubsub.js

@@ -1,104 +1,122 @@
-import { createHash } from "node:crypto";
-import { mkdir } from "node:fs/promises";
-import { join } from "node:path";
+import { createHash } from "crypto";
+import { join } from "path";
+import { mkdir } from "fs/promises";
 import { PubSub, UnixSocketPubSub } from "@mastra/core/events";
+//#region src/utils/signals-pubsub.ts
 const THREAD_STREAM_PREFIX = "agent.thread-stream.";
-class SignalsPubSub extends PubSub {
-  #resourceId;
-  #sockets = /* @__PURE__ */ new Map();
-  #pending = /* @__PURE__ */ new Map();
-  #closed = false;
-  constructor(resourceId) {
-    super();
-    this.#resourceId = resourceId;
-  }
-  get supportedModes() {
-    return ["push"];
-  }
-  async publish(topic, event, options) {
-    const socket = await this.#getOrCreate(topic);
-    await socket.publish(topic, event, options);
-  }
-  async subscribe(topic, cb, options) {
-    const socket = await this.#getOrCreate(topic);
-    await socket.subscribe(topic, cb, options);
-  }
-  async unsubscribe(topic, cb) {
-    const socket = this.#sockets.get(this.#topicKey(topic));
-    if (!socket) return;
-    await socket.unsubscribe(topic, cb);
-  }
-  async flush() {
-    await Promise.all([...this.#sockets.values()].map((s) => s.flush()));
-  }
-  async close() {
-    this.#closed = true;
-    await Promise.allSettled([...this.#sockets.values()].map((s) => s.close()));
-    this.#sockets.clear();
-  }
-  /** Get the underlying socket for a topic (for testing/inspection). */
-  getSocket(topic) {
-    return this.#sockets.get(this.#topicKey(topic));
-  }
-  async #getOrCreate(topic) {
-    if (this.#closed) throw new Error("SignalsPubSub is closed");
-    const key = this.#topicKey(topic);
-    const existing = this.#sockets.get(key);
-    if (existing) return existing;
-    let inflight = this.#pending.get(key);
-    if (!inflight) {
-      inflight = this.#initSocket(topic, key);
-      this.#pending.set(key, inflight);
-    }
-    const socket = await inflight;
-    if (this.#closed) throw new Error("SignalsPubSub is closed");
-    return socket;
-  }
-  async #initSocket(topic, key) {
-    try {
-      const socketPath = await this.#socketPath(topic);
-      if (this.#closed) throw new Error("SignalsPubSub is closed");
-      const socket = new UnixSocketPubSub(socketPath);
-      this.#sockets.set(key, socket);
-      return socket;
-    } finally {
-      this.#pending.delete(key);
-    }
-  }
-  async #socketPath(topic) {
-    let key = this.#topicKey(topic);
-    const dir = join("/tmp/mc", this.#resourceId);
-    await mkdir(dir, { recursive: true });
-    const candidate = join(dir, `${key}.sock`);
-    if (Buffer.byteLength(candidate) > 104) {
-      key = createHash("sha256").update(key).digest("hex").slice(0, 16);
-      return join(dir, `${key}.sock`);
-    }
-    return candidate;
-  }
-  /**
-   * Derive a filesystem-safe key for the topic. Thread-stream topics embed
-   * a threadId; all other topics use a sanitized version of the topic name.
-   */
-  #topicKey(topic) {
-    if (topic.startsWith(THREAD_STREAM_PREFIX)) {
-      const encoded = topic.slice(THREAD_STREAM_PREFIX.length);
-      try {
-        const decoded = decodeURIComponent(encoded);
-        const separatorIdx = decoded.indexOf("\0");
-        if (separatorIdx !== -1) {
-          return decoded.slice(separatorIdx + 1);
-        }
-      } catch {
-      }
-    }
-    return topic.replace(/[^a-zA-Z0-9_-]/g, "_");
-  }
-}
+/**
+* A PubSub that manages one Unix socket per topic for cross-process signal
+* coordination within a mastracode resource.
+*
+* Socket paths use `/tmp/mc/<resourceId>/<sanitized-topic>.sock` for
+* inspectability and automatic OS cleanup. Each topic gets its own isolated
+* socket so broker election and message routing are per-topic.
+*
+* Stale sockets from crashed processes are handled by
+* {@link UnixSocketPubSub}'s built-in election logic: it detects
+* ECONNREFUSED on a dead broker socket, unlinks it, and re-elects.
+* No blanket cleanup is needed here — that would break concurrent
+* mc instances sharing the same resourceId.
+*/
+var SignalsPubSub = class extends PubSub {
+	#resourceId;
+	#sockets = /* @__PURE__ */ new Map();
+	#pending = /* @__PURE__ */ new Map();
+	#closed = false;
+	constructor(resourceId) {
+		super();
+		this.#resourceId = resourceId;
+	}
+	get supportedModes() {
+		return ["push"];
+	}
+	async publish(topic, event, options) {
+		await (await this.#getOrCreate(topic)).publish(topic, event, options);
+	}
+	async subscribe(topic, cb, options) {
+		await (await this.#getOrCreate(topic)).subscribe(topic, cb, options);
+	}
+	async unsubscribe(topic, cb) {
+		const socket = this.#sockets.get(this.#topicKey(topic));
+		if (!socket) return;
+		await socket.unsubscribe(topic, cb);
+	}
+	async flush() {
+		await Promise.all([...this.#sockets.values()].map((s) => s.flush()));
+	}
+	async close() {
+		this.#closed = true;
+		await Promise.allSettled([...this.#sockets.values()].map((s) => s.close()));
+		this.#sockets.clear();
+	}
+	/** Get the underlying socket for a topic (for testing/inspection). */
+	getSocket(topic) {
+		return this.#sockets.get(this.#topicKey(topic));
+	}
+	async #getOrCreate(topic) {
+		if (this.#closed) throw new Error("SignalsPubSub is closed");
+		const key = this.#topicKey(topic);
+		const existing = this.#sockets.get(key);
+		if (existing) return existing;
+		let inflight = this.#pending.get(key);
+		if (!inflight) {
+			inflight = this.#initSocket(topic, key);
+			this.#pending.set(key, inflight);
+		}
+		const socket = await inflight;
+		if (this.#closed) throw new Error("SignalsPubSub is closed");
+		return socket;
+	}
+	async #initSocket(topic, key) {
+		try {
+			const socketPath = await this.#socketPath(topic);
+			if (this.#closed) throw new Error("SignalsPubSub is closed");
+			const socket = new UnixSocketPubSub(socketPath);
+			this.#sockets.set(key, socket);
+			return socket;
+		} finally {
+			this.#pending.delete(key);
+		}
+	}
+	async #socketPath(topic) {
+		let key = this.#topicKey(topic);
+		const dir = join("/tmp/mc", this.#resourceId);
+		await mkdir(dir, { recursive: true });
+		const candidate = join(dir, `${key}.sock`);
+		if (Buffer.byteLength(candidate) > 104) {
+			key = createHash("sha256").update(key).digest("hex").slice(0, 16);
+			return join(dir, `${key}.sock`);
+		}
+		return candidate;
+	}
+	/**
+	* Derive a filesystem-safe key for the topic. Thread-stream topics embed
+	* a threadId; all other topics use a sanitized version of the topic name.
+	*/
+	#topicKey(topic) {
+		if (topic.startsWith(THREAD_STREAM_PREFIX)) {
+			const encoded = topic.slice(20);
+			try {
+				const decoded = decodeURIComponent(encoded);
+				const separatorIdx = decoded.indexOf("\0");
+				if (separatorIdx !== -1) return decoded.slice(separatorIdx + 1);
+			} catch {}
+		}
+		return topic.replace(/[^a-zA-Z0-9_-]/g, "_");
+	}
+};
+/**
+* Creates a per-topic PubSub backed by Unix sockets for cross-process signal
+* and workflow event coordination within a mastracode resource.
+*
+* Each topic gets its own Unix socket under `/tmp/mc/<resourceId>/`.
+* Stale sockets from crashed processes are handled by the underlying
+* {@link UnixSocketPubSub}'s broker election logic.
+*/
 function createSignalsPubSub(resourceId) {
-  return new SignalsPubSub(resourceId);
+	return new SignalsPubSub(resourceId);
 }
-export {
-  createSignalsPubSub
-};
+//#endregion
+export { createSignalsPubSub };
+
 //# sourceMappingURL=signals-pubsub.js.map

package/dist/utils/signals-pubsub.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/signals-pubsub.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { mkdir } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport { PubSub, UnixSocketPubSub } from '@mastra/core/events';\nimport type { PubSubDeliveryMode, Event, EventCallback, SubscribeOptions } from '@mastra/core/events';\n\nconst THREAD_STREAM_PREFIX = 'agent.thread-stream.';\n\n/**\n * A PubSub that manages one Unix socket per topic for cross-process signal\n * coordination within a mastracode resource.\n *\n * Socket paths use `/tmp/mc/<resourceId>/<sanitized-topic>.sock` for\n * inspectability and automatic OS cleanup. Each topic gets its own isolated\n * socket so broker election and message routing are per-topic.\n *\n * Stale sockets from crashed processes are handled by\n * {@link UnixSocketPubSub}'s built-in election logic: it detects\n * ECONNREFUSED on a dead broker socket, unlinks it, and re-elects.\n * No blanket cleanup is needed here — that would break concurrent\n * mc instances sharing the same resourceId.\n */\nclass SignalsPubSub extends PubSub {\n  readonly #resourceId: string;\n  readonly #sockets = new Map<string, UnixSocketPubSub>();\n  readonly #pending = new Map<string, Promise<UnixSocketPubSub>>();\n  #closed = false;\n\n  constructor(resourceId: string) {\n    super();\n    this.#resourceId = resourceId;\n  }\n\n  override get supportedModes(): ReadonlyArray<PubSubDeliveryMode> {\n    return ['push'];\n  }\n\n  async publish(\n    topic: string,\n    event: Omit<Event, 'id' | 'createdAt'>,\n    options?: { localOnly?: boolean },\n  ): Promise<void> {\n    const socket = await this.#getOrCreate(topic);\n    await socket.publish(topic, event, options);\n  }\n\n  async subscribe(topic: string, cb: EventCallback, options?: SubscribeOptions): Promise<void> {\n    const socket = await this.#getOrCreate(topic);\n    await socket.subscribe(topic, cb, options);\n  }\n\n  async unsubscribe(topic: string, cb: EventCallback): Promise<void> {\n    const socket = this.#sockets.get(this.#topicKey(topic));\n    if (!socket) return;\n    await socket.unsubscribe(topic, cb);\n  }\n\n  async flush(): Promise<void> {\n    await Promise.all([...this.#sockets.values()].map(s => s.flush()));\n  }\n\n  async close(): Promise<void> {\n    this.#closed = true;\n    await Promise.allSettled([...this.#sockets.values()].map(s => s.close()));\n    this.#sockets.clear();\n  }\n\n  /** Get the underlying socket for a topic (for testing/inspection). */\n  getSocket(topic: string): UnixSocketPubSub | undefined {\n    return this.#sockets.get(this.#topicKey(topic));\n  }\n\n  async #getOrCreate(topic: string): Promise<UnixSocketPubSub> {\n    if (this.#closed) throw new Error('SignalsPubSub is closed');\n    const key = this.#topicKey(topic);\n    const existing = this.#sockets.get(key);\n    if (existing) return existing;\n    // Deduplicate concurrent callers so only one socket is created per topic.\n    let inflight = this.#pending.get(key);\n    if (!inflight) {\n      inflight = this.#initSocket(topic, key);\n      this.#pending.set(key, inflight);\n    }\n    const socket = await inflight;\n    if (this.#closed) throw new Error('SignalsPubSub is closed');\n    return socket;\n  }\n\n  async #initSocket(topic: string, key: string): Promise<UnixSocketPubSub> {\n    try {\n      const socketPath = await this.#socketPath(topic);\n      if (this.#closed) throw new Error('SignalsPubSub is closed');\n      const socket = new UnixSocketPubSub(socketPath);\n      this.#sockets.set(key, socket);\n      return socket;\n    } finally {\n      this.#pending.delete(key);\n    }\n  }\n\n  async #socketPath(topic: string): Promise<string> {\n    let key = this.#topicKey(topic);\n    const dir = join('/tmp/mc', this.#resourceId);\n    await mkdir(dir, { recursive: true });\n    const candidate = join(dir, `${key}.sock`);\n    // macOS sun_path limit is 104 bytes; Linux is 108. Use 104 as the\n    // conservative bound. When the path is too long, replace the key with\n    // a short hash so the socket can still be created.\n    if (Buffer.byteLength(candidate) > 104) {\n      key = createHash('sha256').update(key).digest('hex').slice(0, 16);\n      return join(dir, `${key}.sock`);\n    }\n    return candidate;\n  }\n\n  /**\n   * Derive a filesystem-safe key for the topic. Thread-stream topics embed\n   * a threadId; all other topics use a sanitized version of the topic name.\n   */\n  #topicKey(topic: string): string {\n    if (topic.startsWith(THREAD_STREAM_PREFIX)) {\n      const encoded = topic.slice(THREAD_STREAM_PREFIX.length);\n      try {\n        const decoded = decodeURIComponent(encoded);\n        const separatorIdx = decoded.indexOf('\\0');\n        if (separatorIdx !== -1) {\n          return decoded.slice(separatorIdx + 1);\n        }\n      } catch {\n        // Malformed URI — fall through to sanitized fallback.\n      }\n    }\n    // Fallback: use the topic directly (sanitized for filesystem)\n    return topic.replace(/[^a-zA-Z0-9_-]/g, '_');\n  }\n}\n\n/**\n * Creates a per-topic PubSub backed by Unix sockets for cross-process signal\n * and workflow event coordination within a mastracode resource.\n *\n * Each topic gets its own Unix socket under `/tmp/mc/<resourceId>/`.\n * Stale sockets from crashed processes are handled by the underlying\n * {@link UnixSocketPubSub}'s broker election logic.\n */\nexport function createSignalsPubSub(resourceId: string): SignalsPubSub {\n  return new SignalsPubSub(resourceId);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"file":"signals-pubsub.js","names":["#resourceId","#sockets","#pending","#getOrCreate","#topicKey","#closed","#initSocket","#socketPath"],"sources":["../../src/utils/signals-pubsub.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { mkdir } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport { PubSub, UnixSocketPubSub } from '@mastra/core/events';\nimport type { PubSubDeliveryMode, Event, EventCallback, SubscribeOptions } from '@mastra/core/events';\n\nconst THREAD_STREAM_PREFIX = 'agent.thread-stream.';\n\n/**\n * A PubSub that manages one Unix socket per topic for cross-process signal\n * coordination within a mastracode resource.\n *\n * Socket paths use `/tmp/mc/<resourceId>/<sanitized-topic>.sock` for\n * inspectability and automatic OS cleanup. Each topic gets its own isolated\n * socket so broker election and message routing are per-topic.\n *\n * Stale sockets from crashed processes are handled by\n * {@link UnixSocketPubSub}'s built-in election logic: it detects\n * ECONNREFUSED on a dead broker socket, unlinks it, and re-elects.\n * No blanket cleanup is needed here — that would break concurrent\n * mc instances sharing the same resourceId.\n */\nclass SignalsPubSub extends PubSub {\n  readonly #resourceId: string;\n  readonly #sockets = new Map<string, UnixSocketPubSub>();\n  readonly #pending = new Map<string, Promise<UnixSocketPubSub>>();\n  #closed = false;\n\n  constructor(resourceId: string) {\n    super();\n    this.#resourceId = resourceId;\n  }\n\n  override get supportedModes(): ReadonlyArray<PubSubDeliveryMode> {\n    return ['push'];\n  }\n\n  async publish(\n    topic: string,\n    event: Omit<Event, 'id' | 'createdAt'>,\n    options?: { localOnly?: boolean },\n  ): Promise<void> {\n    const socket = await this.#getOrCreate(topic);\n    await socket.publish(topic, event, options);\n  }\n\n  async subscribe(topic: string, cb: EventCallback, options?: SubscribeOptions): Promise<void> {\n    const socket = await this.#getOrCreate(topic);\n    await socket.subscribe(topic, cb, options);\n  }\n\n  async unsubscribe(topic: string, cb: EventCallback): Promise<void> {\n    const socket = this.#sockets.get(this.#topicKey(topic));\n    if (!socket) return;\n    await socket.unsubscribe(topic, cb);\n  }\n\n  async flush(): Promise<void> {\n    await Promise.all([...this.#sockets.values()].map(s => s.flush()));\n  }\n\n  async close(): Promise<void> {\n    this.#closed = true;\n    await Promise.allSettled([...this.#sockets.values()].map(s => s.close()));\n    this.#sockets.clear();\n  }\n\n  /** Get the underlying socket for a topic (for testing/inspection). */\n  getSocket(topic: string): UnixSocketPubSub | undefined {\n    return this.#sockets.get(this.#topicKey(topic));\n  }\n\n  async #getOrCreate(topic: string): Promise<UnixSocketPubSub> {\n    if (this.#closed) throw new Error('SignalsPubSub is closed');\n    const key = this.#topicKey(topic);\n    const existing = this.#sockets.get(key);\n    if (existing) return existing;\n    // Deduplicate concurrent callers so only one socket is created per topic.\n    let inflight = this.#pending.get(key);\n    if (!inflight) {\n      inflight = this.#initSocket(topic, key);\n      this.#pending.set(key, inflight);\n    }\n    const socket = await inflight;\n    if (this.#closed) throw new Error('SignalsPubSub is closed');\n    return socket;\n  }\n\n  async #initSocket(topic: string, key: string): Promise<UnixSocketPubSub> {\n    try {\n      const socketPath = await this.#socketPath(topic);\n      if (this.#closed) throw new Error('SignalsPubSub is closed');\n      const socket = new UnixSocketPubSub(socketPath);\n      this.#sockets.set(key, socket);\n      return socket;\n    } finally {\n      this.#pending.delete(key);\n    }\n  }\n\n  async #socketPath(topic: string): Promise<string> {\n    let key = this.#topicKey(topic);\n    const dir = join('/tmp/mc', this.#resourceId);\n    await mkdir(dir, { recursive: true });\n    const candidate = join(dir, `${key}.sock`);\n    // macOS sun_path limit is 104 bytes; Linux is 108. Use 104 as the\n    // conservative bound. When the path is too long, replace the key with\n    // a short hash so the socket can still be created.\n    if (Buffer.byteLength(candidate) > 104) {\n      key = createHash('sha256').update(key).digest('hex').slice(0, 16);\n      return join(dir, `${key}.sock`);\n    }\n    return candidate;\n  }\n\n  /**\n   * Derive a filesystem-safe key for the topic. Thread-stream topics embed\n   * a threadId; all other topics use a sanitized version of the topic name.\n   */\n  #topicKey(topic: string): string {\n    if (topic.startsWith(THREAD_STREAM_PREFIX)) {\n      const encoded = topic.slice(THREAD_STREAM_PREFIX.length);\n      try {\n        const decoded = decodeURIComponent(encoded);\n        const separatorIdx = decoded.indexOf('\\0');\n        if (separatorIdx !== -1) {\n          return decoded.slice(separatorIdx + 1);\n        }\n      } catch {\n        // Malformed URI — fall through to sanitized fallback.\n      }\n    }\n    // Fallback: use the topic directly (sanitized for filesystem)\n    return topic.replace(/[^a-zA-Z0-9_-]/g, '_');\n  }\n}\n\n/**\n * Creates a per-topic PubSub backed by Unix sockets for cross-process signal\n * and workflow event coordination within a mastracode resource.\n *\n * Each topic gets its own Unix socket under `/tmp/mc/<resourceId>/`.\n * Stale sockets from crashed processes are handled by the underlying\n * {@link UnixSocketPubSub}'s broker election logic.\n */\nexport function createSignalsPubSub(resourceId: string): SignalsPubSub {\n  return new SignalsPubSub(resourceId);\n}\n"],"mappings":"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"}