@mastra/code-sdk 0.0.0-livekit-beta-v3-20260709031728

package/dist/utils/project.js.map

@@ -0,0 +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. Per-tenant storage sets this so each\n   * tenant's recall vectors live in their own isolated DB, not a shared 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"]}

package/dist/utils/signals-pubsub.d.ts

@@ -0,0 +1,41 @@
+import { PubSub, UnixSocketPubSub } from '@mastra/core/events';
+import type { PubSubDeliveryMode, Event, EventCallback, SubscribeOptions } from '@mastra/core/events';
+/**
+ * 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.
+ */
+declare class SignalsPubSub extends PubSub {
+    #private;
+    constructor(resourceId: string);
+    get supportedModes(): ReadonlyArray<PubSubDeliveryMode>;
+    publish(topic: string, event: Omit<Event, 'id' | 'createdAt'>, options?: {
+        localOnly?: boolean;
+    }): Promise<void>;
+    subscribe(topic: string, cb: EventCallback, options?: SubscribeOptions): Promise<void>;
+    unsubscribe(topic: string, cb: EventCallback): Promise<void>;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+    /** Get the underlying socket for a topic (for testing/inspection). */
+    getSocket(topic: string): UnixSocketPubSub | undefined;
+}
+/**
+ * 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.
+ */
+export declare function createSignalsPubSub(resourceId: string): SignalsPubSub;
+export {};
+//# sourceMappingURL=signals-pubsub.d.ts.map

package/dist/utils/signals-pubsub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals-pubsub.d.ts","sourceRoot":"","sources":["../../src/utils/signals-pubsub.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAItG;;;;;;;;;;;;;GAaG;AACH,cAAM,aAAc,SAAQ,MAAM;;gBAMpB,UAAU,EAAE,MAAM;IAK9B,IAAa,cAAc,IAAI,aAAa,CAAC,kBAAkB,CAAC,CAE/D;IAEK,OAAO,CACX,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,WAAW,CAAC,EACtC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAChC,OAAO,CAAC,IAAI,CAAC;IAKV,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtF,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,sEAAsE;IACtE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;CAmEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAErE"}

package/dist/utils/signals-pubsub.js

@@ -0,0 +1,104 @@
+import { createHash } from "node:crypto";
+import { mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { PubSub, UnixSocketPubSub } from "@mastra/core/events";
+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, "_");
+  }
+}
+function createSignalsPubSub(resourceId) {
+  return new SignalsPubSub(resourceId);
+}
+export {
+  createSignalsPubSub
+};
+//# sourceMappingURL=signals-pubsub.js.map

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

@@ -0,0 +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":[]}

package/dist/utils/slash-command-loader.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Metadata for a slash command
+ */
+export interface SlashCommandMetadata {
+    /** Command name (e.g., "git:commit") */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** The command template with variables */
+    template: string;
+    /** Source file path */
+    sourcePath: string;
+    /** Namespace derived from directory structure */
+    namespace?: string;
+    /** Whether this command should also be exposed as /goal/<name> */
+    goal?: boolean;
+}
+/**
+ * Parse a command file and extract metadata and template
+ * Supports both frontmatter-based and plain markdown files
+ */
+export declare function parseCommandFile(filePath: string, baseDir?: string): Promise<SlashCommandMetadata | null>;
+/**
+ * Extract command name from file path
+ * Converts path like "git/commit.md" to "git:commit"
+ */
+export declare function extractCommandName(filePath: string, baseDir: string): string;
+/**
+ * Recursively scan a directory for command files.
+ * @param dirPath - Current directory to scan
+ * @param rootDir - Original root commands directory (used for namespace derivation).
+ *                  When omitted the first call sets it to dirPath.
+ */
+export declare function scanCommandDirectory(dirPath: string, rootDir?: string): Promise<SlashCommandMetadata[]>;
+/**
+ * Load custom slash commands from all configured directories
+ * Priority: mastra project > claude project > opencode project > mastra user > claude user > opencode user
+ */
+export declare function loadCustomCommands(projectDir?: string, configDirName?: string, extraCommandDirs?: string[]): Promise<SlashCommandMetadata[]>;
+/**
+ * Get the commands directory path for a project
+ */
+export declare function getProjectCommandsDir(projectDir: string, configDirName?: string): string;
+/**
+ * Initialize a commands directory with an example command
+ */
+export declare function initCommandsDirectory(projectDir: string, configDirName?: string): Promise<void>;
+//# sourceMappingURL=slash-command-loader.d.ts.map

package/dist/utils/slash-command-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-command-loader.d.ts","sourceRoot":"","sources":["../../src/utils/slash-command-loader.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAqD/G;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAY5E;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA2B7G;AACD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,CAAC,EAAE,MAAM,EACnB,aAAa,SAAqB,EAClC,gBAAgB,GAAE,MAAM,EAAO,GAC9B,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA4DjC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,SAAqB,GAAG,MAAM,CAEpG;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,SAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BjH"}

package/dist/utils/slash-command-loader.js

@@ -0,0 +1,155 @@
+import { promises as fs } from "node:fs";
+import * as path from "node:path";
+import { parse as parseYaml } from "yaml";
+import { DEFAULT_CONFIG_DIR } from "../constants.js";
+async function parseCommandFile(filePath, baseDir) {
+  try {
+    const content = await fs.readFile(filePath, "utf-8");
+    const trimmedContent = content.trim();
+    if (!trimmedContent.startsWith("---")) {
+      const name2 = baseDir ? extractCommandName(filePath, baseDir) : path.basename(filePath, ".md");
+      return {
+        name: name2,
+        description: "",
+        template: content,
+        sourcePath: filePath
+      };
+    }
+    const parts = content.split("---");
+    if (parts.length < 3) {
+      return null;
+    }
+    const frontmatter = parts[1].trim();
+    const template = parts.slice(2).join("---").trim();
+    const metadata = parseYaml(frontmatter);
+    let name;
+    if (typeof metadata?.name === "string" && metadata.name) {
+      name = metadata.name;
+    } else if (baseDir) {
+      name = extractCommandName(filePath, baseDir);
+    } else {
+      name = path.basename(filePath, ".md");
+    }
+    return {
+      name,
+      description: typeof metadata?.description === "string" ? metadata.description : "",
+      template,
+      sourcePath: filePath,
+      namespace: typeof metadata?.namespace === "string" ? metadata.namespace : void 0,
+      goal: metadata?.goal === true
+    };
+  } catch (error) {
+    console.error(`Error parsing command file ${filePath}:`, error);
+    return null;
+  }
+}
+function extractCommandName(filePath, baseDir) {
+  const relativePath = path.relative(baseDir, filePath);
+  const dirName = path.dirname(relativePath);
+  const baseName = path.basename(relativePath, ".md");
+  if (dirName === "." || dirName === "") {
+    return baseName;
+  }
+  const namespace = dirName.replace(/[\\/]/g, ":");
+  return `${namespace}:${baseName}`;
+}
+async function scanCommandDirectory(dirPath, rootDir) {
+  const baseDir = rootDir ?? dirPath;
+  const commands = [];
+  try {
+    const entries = await fs.readdir(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = path.join(dirPath, entry.name);
+      if (entry.isDirectory()) {
+        const subCommands = await scanCommandDirectory(fullPath, baseDir);
+        commands.push(...subCommands);
+      } else if (entry.isFile() && entry.name.endsWith(".md")) {
+        const command = await parseCommandFile(fullPath, baseDir);
+        if (command) {
+          commands.push(command);
+        }
+      }
+    }
+  } catch {
+  }
+  return commands;
+}
+async function loadCustomCommands(projectDir, configDirName = DEFAULT_CONFIG_DIR, extraCommandDirs = []) {
+  const commandMap = /* @__PURE__ */ new Map();
+  const addCommands = (newCommands) => {
+    for (const cmd of newCommands) {
+      commandMap.set(cmd.name, cmd);
+    }
+  };
+  const homeDir = process.env.HOME || process.env.USERPROFILE;
+  if (homeDir) {
+    const opencodeUserDir = path.join(homeDir, ".opencode", "command");
+    const opencodeUserCommands = await scanCommandDirectory(opencodeUserDir);
+    addCommands(opencodeUserCommands);
+  }
+  if (homeDir) {
+    const claudeUserDir = path.join(homeDir, ".claude", "commands");
+    const claudeUserCommands = await scanCommandDirectory(claudeUserDir);
+    addCommands(claudeUserCommands);
+  }
+  if (homeDir) {
+    const mastraUserDir = path.join(homeDir, configDirName, "commands");
+    const mastraUserCommands = await scanCommandDirectory(mastraUserDir);
+    addCommands(mastraUserCommands);
+  }
+  if (projectDir) {
+    const opencodeProjectDir = path.join(projectDir, ".opencode", "command");
+    const opencodeProjectCommands = await scanCommandDirectory(opencodeProjectDir);
+    addCommands(opencodeProjectCommands);
+  }
+  if (projectDir) {
+    const claudeProjectDir = path.join(projectDir, ".claude", "commands");
+    const claudeProjectCommands = await scanCommandDirectory(claudeProjectDir);
+    addCommands(claudeProjectCommands);
+  }
+  if (projectDir) {
+    const mastraProjectDir = path.join(projectDir, configDirName, "commands");
+    const mastraProjectCommands = await scanCommandDirectory(mastraProjectDir);
+    addCommands(mastraProjectCommands);
+  }
+  for (const commandsDir of extraCommandDirs) {
+    addCommands(await scanCommandDirectory(commandsDir));
+  }
+  return Array.from(commandMap.values());
+}
+function getProjectCommandsDir(projectDir, configDirName = DEFAULT_CONFIG_DIR) {
+  return path.join(projectDir, configDirName, "commands");
+}
+async function initCommandsDirectory(projectDir, configDirName = DEFAULT_CONFIG_DIR) {
+  const commandsDir = getProjectCommandsDir(projectDir, configDirName);
+  try {
+    await fs.mkdir(commandsDir, { recursive: true });
+    const examplePath = path.join(commandsDir, "example.md");
+    const exampleContent = `---
+name: example
+description: An example slash command
+---
+
+This is an example slash command template.
+You can use variables like $ARGUMENTS or $1, $2 for positional args.
+You can also include file content with @filename.
+Shell commands with !command will be executed and output included.
+`;
+    try {
+      await fs.access(examplePath);
+    } catch {
+      await fs.writeFile(examplePath, exampleContent, "utf-8");
+    }
+  } catch (error) {
+    console.error("Error initializing commands directory:", error);
+  }
+}
+export {
+  extractCommandName,
+  getProjectCommandsDir,
+  initCommandsDirectory,
+  loadCustomCommands,
+  parseCommandFile,
+  scanCommandDirectory
+};
+//# sourceMappingURL=slash-command-loader.js.map

package/dist/utils/slash-command-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/slash-command-loader.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport * as path from 'node:path';\nimport { parse as parseYaml } from 'yaml';\nimport { DEFAULT_CONFIG_DIR } from '../constants.js';\n\n/**\n * Metadata for a slash command\n */\nexport interface SlashCommandMetadata {\n  /** Command name (e.g., \"git:commit\") */\n  name: string;\n  /** Human-readable description */\n  description: string;\n  /** The command template with variables */\n  template: string;\n  /** Source file path */\n  sourcePath: string;\n  /** Namespace derived from directory structure */\n  namespace?: string;\n  /** Whether this command should also be exposed as /goal/<name> */\n  goal?: boolean;\n}\n\n/**\n * Parse a command file and extract metadata and template\n * Supports both frontmatter-based and plain markdown files\n */\nexport async function parseCommandFile(filePath: string, baseDir?: string): Promise<SlashCommandMetadata | null> {\n  try {\n    const content = await fs.readFile(filePath, 'utf-8');\n    const trimmedContent = content.trim();\n\n    // Check if file has frontmatter (starts with ---)\n    if (!trimmedContent.startsWith('---')) {\n      // No frontmatter - treat entire file as template\n      // Derive name from file path\n      const name = baseDir ? extractCommandName(filePath, baseDir) : path.basename(filePath, '.md');\n\n      return {\n        name,\n        description: '',\n        template: content,\n        sourcePath: filePath,\n      };\n    }\n\n    // Split frontmatter and template\n    const parts = content.split('---');\n    if (parts.length < 3) {\n      return null;\n    }\n\n    const frontmatter = parts[1]!.trim();\n    const template = parts.slice(2).join('---').trim();\n\n    // Parse YAML frontmatter\n    const metadata = parseYaml(frontmatter) as Record<string, unknown>;\n\n    // Derive name from file path if not specified in frontmatter\n    let name: string;\n    if (typeof metadata?.name === 'string' && metadata.name) {\n      name = metadata.name;\n    } else if (baseDir) {\n      name = extractCommandName(filePath, baseDir);\n    } else {\n      name = path.basename(filePath, '.md');\n    }\n\n    return {\n      name,\n      description: typeof metadata?.description === 'string' ? metadata.description : '',\n      template,\n      sourcePath: filePath,\n      namespace: typeof metadata?.namespace === 'string' ? metadata.namespace : undefined,\n      goal: metadata?.goal === true,\n    };\n  } catch (error) {\n    console.error(`Error parsing command file ${filePath}:`, error);\n    return null;\n  }\n}\n\n/**\n * Extract command name from file path\n * Converts path like \"git/commit.md\" to \"git:commit\"\n */\nexport function extractCommandName(filePath: string, baseDir: string): string {\n  const relativePath = path.relative(baseDir, filePath);\n  const dirName = path.dirname(relativePath);\n  const baseName = path.basename(relativePath, '.md');\n\n  if (dirName === '.' || dirName === '') {\n    return baseName;\n  }\n\n  // Replace path separators with colons for namespacing\n  const namespace = dirName.replace(/[\\\\/]/g, ':');\n  return `${namespace}:${baseName}`;\n}\n\n/**\n * Recursively scan a directory for command files.\n * @param dirPath - Current directory to scan\n * @param rootDir - Original root commands directory (used for namespace derivation).\n *                  When omitted the first call sets it to dirPath.\n */\nexport async function scanCommandDirectory(dirPath: string, rootDir?: string): Promise<SlashCommandMetadata[]> {\n  const baseDir = rootDir ?? dirPath;\n  const commands: SlashCommandMetadata[] = [];\n\n  try {\n    const entries = await fs.readdir(dirPath, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const fullPath = path.join(dirPath, entry.name);\n\n      if (entry.isDirectory()) {\n        // Recursively scan subdirectories, preserving the root directory for namespace derivation\n        const subCommands = await scanCommandDirectory(fullPath, baseDir);\n        commands.push(...subCommands);\n      } else if (entry.isFile() && entry.name.endsWith('.md')) {\n        // Parse markdown command files, passing the root commands dir as baseDir for name derivation\n        const command = await parseCommandFile(fullPath, baseDir);\n        if (command) {\n          commands.push(command);\n        }\n      }\n    }\n  } catch {\n    // Directory doesn't exist or can't be read - silently skip\n  }\n\n  return commands;\n}\n/**\n * Load custom slash commands from all configured directories\n * Priority: mastra project > claude project > opencode project > mastra user > claude user > opencode user\n */\nexport async function loadCustomCommands(\n  projectDir?: string,\n  configDirName = DEFAULT_CONFIG_DIR,\n  extraCommandDirs: string[] = [],\n): Promise<SlashCommandMetadata[]> {\n  // Use a Map so later (higher priority) sources override earlier ones with the same name\n  const commandMap = new Map<string, SlashCommandMetadata>();\n\n  const addCommands = (newCommands: SlashCommandMetadata[]) => {\n    for (const cmd of newCommands) {\n      commandMap.set(cmd.name, cmd);\n    }\n  };\n\n  const homeDir = process.env.HOME || process.env.USERPROFILE;\n\n  // 1. Load from opencode user directory ~/.opencode/command (lowest priority)\n  if (homeDir) {\n    const opencodeUserDir = path.join(homeDir, '.opencode', 'command');\n    const opencodeUserCommands = await scanCommandDirectory(opencodeUserDir);\n    addCommands(opencodeUserCommands);\n  }\n\n  // 2. Load from claude user directory ~/.claude/commands (Claude Code compat)\n  if (homeDir) {\n    const claudeUserDir = path.join(homeDir, '.claude', 'commands');\n    const claudeUserCommands = await scanCommandDirectory(claudeUserDir);\n    addCommands(claudeUserCommands);\n  }\n\n  // 3. Load from mastra user directory ~/<configDirName>/commands\n  if (homeDir) {\n    const mastraUserDir = path.join(homeDir, configDirName, 'commands');\n    const mastraUserCommands = await scanCommandDirectory(mastraUserDir);\n    addCommands(mastraUserCommands);\n  }\n\n  // 4. Load from opencode project directory .opencode/command\n  if (projectDir) {\n    const opencodeProjectDir = path.join(projectDir, '.opencode', 'command');\n    const opencodeProjectCommands = await scanCommandDirectory(opencodeProjectDir);\n    addCommands(opencodeProjectCommands);\n  }\n\n  // 5. Load from claude project directory .claude/commands (Claude Code compat)\n  if (projectDir) {\n    const claudeProjectDir = path.join(projectDir, '.claude', 'commands');\n    const claudeProjectCommands = await scanCommandDirectory(claudeProjectDir);\n    addCommands(claudeProjectCommands);\n  }\n\n  // 6. Load from mastra project directory <configDirName>/commands\n  if (projectDir) {\n    const mastraProjectDir = path.join(projectDir, configDirName, 'commands');\n    const mastraProjectCommands = await scanCommandDirectory(mastraProjectDir);\n    addCommands(mastraProjectCommands);\n  }\n\n  // 7. Load from active plugin command directories (highest priority)\n  for (const commandsDir of extraCommandDirs) {\n    addCommands(await scanCommandDirectory(commandsDir));\n  }\n\n  return Array.from(commandMap.values());\n}\n\n/**\n * Get the commands directory path for a project\n */\nexport function getProjectCommandsDir(projectDir: string, configDirName = DEFAULT_CONFIG_DIR): string {\n  return path.join(projectDir, configDirName, 'commands');\n}\n\n/**\n * Initialize a commands directory with an example command\n */\nexport async function initCommandsDirectory(projectDir: string, configDirName = DEFAULT_CONFIG_DIR): Promise<void> {\n  const commandsDir = getProjectCommandsDir(projectDir, configDirName);\n\n  try {\n    await fs.mkdir(commandsDir, { recursive: true });\n\n    // Create an example command\n    const examplePath = path.join(commandsDir, 'example.md');\n    const exampleContent = `---\nname: example\ndescription: An example slash command\n---\n\nThis is an example slash command template.\nYou can use variables like \\$ARGUMENTS or \\$1, \\$2 for positional args.\nYou can also include file content with @filename.\nShell commands with !command will be executed and output included.\n`;\n\n    try {\n      await fs.access(examplePath);\n      // File already exists, don't overwrite\n    } catch {\n      await fs.writeFile(examplePath, exampleContent, 'utf-8');\n    }\n  } catch (error) {\n    console.error('Error initializing commands directory:', error);\n  }\n}\n"],"mappings":"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","names":["name"]}

package/dist/utils/slash-command-processor.d.ts

@@ -0,0 +1,14 @@
+import type { SlashCommandMetadata } from './slash-command-loader.js';
+/**
+ * Process a slash command by replacing variables and executing shell commands
+ */
+export declare function processSlashCommand(command: SlashCommandMetadata, args: string[], workingDir: string): Promise<string>;
+/**
+ * Format a command for display in help/autocomplete
+ */
+export declare function formatCommandForDisplay(command: SlashCommandMetadata): string;
+/**
+ * Group commands by namespace for display
+ */
+export declare function groupCommandsByNamespace(commands: SlashCommandMetadata[]): Map<string, SlashCommandMetadata[]>;
+//# sourceMappingURL=slash-command-processor.d.ts.map

package/dist/utils/slash-command-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-command-processor.d.ts","sourceRoot":"","sources":["../../src/utils/slash-command-processor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,oBAAoB,EAC7B,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAgBjB;AA0FD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAQ7E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAc9G"}

package/dist/utils/slash-command-processor.js

@@ -0,0 +1,96 @@
+import { execSync } from "node:child_process";
+import { promises as fs } from "node:fs";
+import * as path from "node:path";
+async function processSlashCommand(command, args, workingDir) {
+  const { result: withArgs, shouldAppendRawArgs } = replaceArguments(command.template, args);
+  let result = withArgs;
+  result = await replaceShellOutput(result, workingDir);
+  result = await replaceFileReferences(result, workingDir);
+  if (shouldAppendRawArgs) {
+    result = result.trimEnd() + `
+
+ARGUMENTS: ${args.join(" ")}`;
+  }
+  return result;
+}
+function replaceArguments(template, args) {
+  let result = template;
+  const hasArgumentsVar = /\$ARGUMENTS/.test(template);
+  const hasPositionalVar = /\$[1-9]\d*/.test(template);
+  result = result.replace(/\$ARGUMENTS/g, args.join(" "));
+  args.forEach((_, index) => {
+    const argNumber = index + 1;
+    const pattern = new RegExp(`\\$${argNumber}\\+`, "g");
+    result = result.replace(pattern, args.slice(index).join(" "));
+  });
+  args.forEach((arg, index) => {
+    const pattern = new RegExp(`\\$${index + 1}`, "g");
+    result = result.replace(pattern, arg);
+  });
+  result = result.replace(/\$[1-9]\d*\+?/g, "");
+  return {
+    result,
+    shouldAppendRawArgs: !hasArgumentsVar && !hasPositionalVar && args.length > 0
+  };
+}
+async function replaceShellOutput(template, workingDir) {
+  const shellPattern = /!`([^`]+)`/g;
+  const matches = [...template.matchAll(shellPattern)];
+  let result = template;
+  for (const match of matches) {
+    const [fullMatch, command] = match;
+    try {
+      const output = execSync(command, {
+        cwd: workingDir,
+        encoding: "utf-8",
+        timeout: 3e4,
+        maxBuffer: 1024 * 1024
+        // 1MB buffer
+      });
+      result = result.replace(fullMatch, output.trim());
+    } catch (error) {
+      console.error(`Error executing shell command "${command}":`, error);
+      result = result.replace(fullMatch, `[Error: Failed to execute "${command}"]`);
+    }
+  }
+  return result;
+}
+async function replaceFileReferences(template, workingDir) {
+  const filePattern = /@([\w./-]+)/g;
+  const matches = [...template.matchAll(filePattern)];
+  let result = template;
+  for (const match of matches) {
+    const [fullMatch, filePath] = match;
+    try {
+      const fullPath = path.resolve(workingDir, filePath);
+      const content = await fs.readFile(fullPath, "utf-8");
+      result = result.replace(fullMatch, content);
+    } catch {
+    }
+  }
+  return result;
+}
+function formatCommandForDisplay(command) {
+  const parts = [command.name];
+  if (command.description) {
+    parts.push(`- ${command.description}`);
+  }
+  return parts.join(" ");
+}
+function groupCommandsByNamespace(commands) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const command of commands) {
+    const namespace = command.namespace || command.name.split(":")[0] || "general";
+    if (!groups.has(namespace)) {
+      groups.set(namespace, []);
+    }
+    groups.get(namespace).push(command);
+  }
+  return groups;
+}
+export {
+  formatCommandForDisplay,
+  groupCommandsByNamespace,
+  processSlashCommand
+};
+//# sourceMappingURL=slash-command-processor.js.map

package/dist/utils/slash-command-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/slash-command-processor.ts"],"sourcesContent":["import { execSync } from 'node:child_process';\nimport { promises as fs } from 'node:fs';\nimport * as path from 'node:path';\nimport type { SlashCommandMetadata } from './slash-command-loader.js';\n\n/**\n * Process a slash command by replacing variables and executing shell commands\n */\nexport async function processSlashCommand(\n  command: SlashCommandMetadata,\n  args: string[],\n  workingDir: string,\n): Promise<string> {\n  const { result: withArgs, shouldAppendRawArgs } = replaceArguments(command.template, args);\n  let result = withArgs;\n\n  // Replace shell commands\n  result = await replaceShellOutput(result, workingDir);\n\n  // Replace file references\n  result = await replaceFileReferences(result, workingDir);\n\n  // Append raw args after shell/file processing to avoid executing user input\n  if (shouldAppendRawArgs) {\n    result = result.trimEnd() + `\\n\\nARGUMENTS: ${args.join(' ')}`;\n  }\n\n  return result;\n}\n\n/**\n * Replace argument variables in template\n * $ARGUMENTS - all arguments joined\n * $1, $2, etc. - positional arguments\n */\nfunction replaceArguments(template: string, args: string[]): { result: string; shouldAppendRawArgs: boolean } {\n  let result = template;\n\n  // Check if template references any argument variables\n  const hasArgumentsVar = /\\$ARGUMENTS/.test(template);\n  const hasPositionalVar = /\\$[1-9]\\d*/.test(template);\n\n  // Replace $ARGUMENTS with all args joined\n  result = result.replace(/\\$ARGUMENTS/g, args.join(' '));\n\n  // Replace range arguments $1+, $2+, etc. before single positional arguments.\n  args.forEach((_, index) => {\n    const argNumber = index + 1;\n    const pattern = new RegExp(`\\\\\\$${argNumber}\\\\+`, 'g');\n    result = result.replace(pattern, args.slice(index).join(' '));\n  });\n\n  // Replace positional arguments $1, $2, etc.\n  args.forEach((arg, index) => {\n    const pattern = new RegExp(`\\\\\\$${index + 1}`, 'g');\n    result = result.replace(pattern, arg);\n  });\n\n  // Clear unused positional and range arguments\n  result = result.replace(/\\$[1-9]\\d*\\+?/g, '');\n\n  return {\n    result,\n    shouldAppendRawArgs: !hasArgumentsVar && !hasPositionalVar && args.length > 0,\n  };\n}\n\n/**\n * Replace shell command references with their output\n * Format: !`command`\n */\nasync function replaceShellOutput(template: string, workingDir: string): Promise<string> {\n  const shellPattern = /!`([^`]+)`/g;\n  const matches = [...template.matchAll(shellPattern)];\n\n  let result = template;\n  for (const match of matches) {\n    const [fullMatch, command] = match;\n    try {\n      const output = execSync(command!, {\n        cwd: workingDir,\n        encoding: 'utf-8',\n        timeout: 30000,\n        maxBuffer: 1024 * 1024, // 1MB buffer\n      });\n      result = result.replace(fullMatch, output.trim());\n    } catch (error) {\n      console.error(`Error executing shell command \"${command}\":`, error);\n      result = result.replace(fullMatch, `[Error: Failed to execute \"${command}\"]`);\n    }\n  }\n\n  return result;\n}\n\n/**\n * Replace file references with file content\n * Format: @filename or @path/to/file\n */\nasync function replaceFileReferences(template: string, workingDir: string): Promise<string> {\n  const filePattern = /@([\\w./-]+)/g;\n  const matches = [...template.matchAll(filePattern)];\n\n  let result = template;\n  for (const match of matches) {\n    const [fullMatch, filePath] = match;\n    try {\n      const fullPath = path.resolve(workingDir, filePath!);\n      const content = await fs.readFile(fullPath, 'utf-8');\n      result = result.replace(fullMatch, content);\n    } catch {\n      // Leave literal @mentions/search qualifiers such as @me intact when they do not resolve to files.\n    }\n  }\n\n  return result;\n}\n\n/**\n * Format a command for display in help/autocomplete\n */\nexport function formatCommandForDisplay(command: SlashCommandMetadata): string {\n  const parts = [command.name];\n\n  if (command.description) {\n    parts.push(`- ${command.description}`);\n  }\n\n  return parts.join(' ');\n}\n\n/**\n * Group commands by namespace for display\n */\nexport function groupCommandsByNamespace(commands: SlashCommandMetadata[]): Map<string, SlashCommandMetadata[]> {\n  const groups = new Map<string, SlashCommandMetadata[]>();\n\n  for (const command of commands) {\n    const namespace = command.namespace || command.name.split(':')[0] || 'general';\n\n    if (!groups.has(namespace)) {\n      groups.set(namespace, []);\n    }\n\n    groups.get(namespace)!.push(command);\n  }\n\n  return groups;\n}\n"],"mappings":"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","names":[]}

package/dist/utils/stdin-pipe.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Clean up raw piped output so the agent sees readable text, not terminal
+ * control noise.
+ *
+ * 1. Strip all ANSI escape sequences (colors, cursor movement, line clears).
+ * 2. Simulate carriage-return overwrites: for each line, split on `\r` and
+ *    keep only the last segment — this is what the terminal would display
+ *    after a spinner/progress bar finishes.
+ * 3. Collapse runs of blank lines.
+ */
+export declare function sanitizePipedOutput(raw: string): string;
+/**
+ * If stdin is a pipe (not a TTY), read **all** data until EOF and return it as
+ * a string. The returned promise only resolves once the write end of the pipe
+ * is closed — i.e. the sending process has fully exited — so callers are
+ * guaranteed to receive the complete output, not a partial snapshot from a
+ * program that writes progressively.
+ *
+ * Returns `null` when:
+ * - stdin is a TTY (interactive terminal)
+ * - the pipe was empty or contained only whitespace
+ */
+export declare function drainPipedStdin(): Promise<string | null>;
+/**
+ * Reopen `/dev/tty` (or `CON` on Windows) as `process.stdin` so that the
+ * interactive TUI can read keyboard input after the original piped stdin has
+ * been consumed.
+ *
+ * @returns `true` if the swap succeeded, `false` if a TTY could not be opened
+ * (e.g. running in a headless CI container with no controlling terminal).
+ */
+export declare function reopenStdinFromTTY(): boolean;
+//# sourceMappingURL=stdin-pipe.d.ts.map

package/dist/utils/stdin-pipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin-pipe.d.ts","sourceRoot":"","sources":["../../src/utils/stdin-pipe.ts"],"names":[],"mappings":"AAYA;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA0BvD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA2C9D;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAmB5C"}