@mastra/code-sdk 0.0.0-esbuild-bundle-worker-20260807173433

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan-diff.js","names":[],"sources":["../../src/utils/plan-diff.ts"],"sourcesContent":["/**\n * Line-level diffing for plan revisions.\n *\n * Uses a real LCS (longest common subsequence) diff so that inserting or deleting a few\n * lines doesn't mark everything after it as changed. Both the rendered approval diff and\n * the \"is a diff worth showing\" heuristic share this so the heuristic measures the actual\n * diff rather than predicting one.\n */\n\nexport interface DiffEntry {\n  type: 'added' | 'removed' | 'context';\n  text: string;\n}\n\n/** Produce structured diff entries between two plan texts using an LCS diff. */\nexport function generatePlanDiff(oldText: string, newText: string): DiffEntry[] {\n  const oldLines = oldText.split(/\\r?\\n/);\n  const newLines = newText.split(/\\r?\\n/);\n  const n = oldLines.length;\n  const m = newLines.length;\n\n  // LCS length table.\n  const lcs: number[][] = Array.from({ length: n + 1 }, () => new Array<number>(m + 1).fill(0));\n  for (let i = n - 1; i >= 0; i--) {\n    for (let j = m - 1; j >= 0; j--) {\n      lcs[i]![j] = oldLines[i] === newLines[j] ? lcs[i + 1]![j + 1]! + 1 : Math.max(lcs[i + 1]![j]!, lcs[i]![j + 1]!);\n    }\n  }\n\n  const entries: DiffEntry[] = [];\n  let i = 0;\n  let j = 0;\n  while (i < n && j < m) {\n    if (oldLines[i] === newLines[j]) {\n      entries.push({ type: 'context', text: oldLines[i]! });\n      i++;\n      j++;\n    } else if (lcs[i + 1]![j]! >= lcs[i]![j + 1]!) {\n      entries.push({ type: 'removed', text: oldLines[i]! });\n      i++;\n    } else {\n      entries.push({ type: 'added', text: newLines[j]! });\n      j++;\n    }\n  }\n  while (i < n) entries.push({ type: 'removed', text: oldLines[i++]! });\n  while (j < m) entries.push({ type: 'added', text: newLines[j++]! });\n\n  return entries;\n}\n\n/**\n * Decide whether a diff is worth rendering instead of just showing the full new plan.\n *\n * We generate the real diff and compare its size (added + removed lines) against the size\n * of the whole diff (added + removed + unchanged context). When most of the diff is changes\n * rather than shared context, the diff is no clearer than the full text, so callers fall\n * back to rendering the whole plan. A genuinely new plan (no previous text, or no shared\n * lines) is therefore shown in full.\n */\nexport function shouldShowDiff(previousPlan: string, plan: string, maxChangedRatio = 0.5): boolean {\n  if (!previousPlan || previousPlan === plan) return false;\n\n  const entries = generatePlanDiff(previousPlan, plan);\n  const changed = entries.filter(e => e.type !== 'context').length;\n  if (changed === 0) return false;\n\n  // changed / total entries == diff size relative to the full plan view.\n  return changed / Math.max(entries.length, 1) <= maxChangedRatio;\n}\n"],"mappings":";;AAeA,SAAgB,iBAAiB,SAAiB,SAA8B;CAC9E,MAAM,WAAW,QAAQ,MAAM,OAAO;CACtC,MAAM,WAAW,QAAQ,MAAM,OAAO;CACtC,MAAM,IAAI,SAAS;CACnB,MAAM,IAAI,SAAS;CAGnB,MAAM,MAAkB,MAAM,KAAK,EAAE,QAAQ,IAAI,EAAE,SAAS,IAAI,MAAc,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;CAC5F,KAAK,IAAI,IAAI,IAAI,GAAG,KAAK,GAAG,KAC1B,KAAK,IAAI,IAAI,IAAI,GAAG,KAAK,GAAG,KAC1B,IAAI,EAAE,CAAE,KAAK,SAAS,OAAO,SAAS,KAAK,IAAI,IAAI,EAAE,CAAE,IAAI,KAAM,IAAI,KAAK,IAAI,IAAI,IAAI,EAAE,CAAE,IAAK,IAAI,EAAE,CAAE,IAAI,EAAG;CAIlH,MAAM,UAAuB,CAAC;CAC9B,IAAI,IAAI;CACR,IAAI,IAAI;CACR,OAAO,IAAI,KAAK,IAAI,GAClB,IAAI,SAAS,OAAO,SAAS,IAAI;EAC/B,QAAQ,KAAK;GAAE,MAAM;GAAW,MAAM,SAAS;EAAI,CAAC;EACpD;EACA;CACF,OAAO,IAAI,IAAI,IAAI,EAAE,CAAE,MAAO,IAAI,EAAE,CAAE,IAAI,IAAK;EAC7C,QAAQ,KAAK;GAAE,MAAM;GAAW,MAAM,SAAS;EAAI,CAAC;EACpD;CACF,OAAO;EACL,QAAQ,KAAK;GAAE,MAAM;GAAS,MAAM,SAAS;EAAI,CAAC;EAClD;CACF;CAEF,OAAO,IAAI,GAAG,QAAQ,KAAK;EAAE,MAAM;EAAW,MAAM,SAAS;CAAM,CAAC;CACpE,OAAO,IAAI,GAAG,QAAQ,KAAK;EAAE,MAAM;EAAS,MAAM,SAAS;CAAM,CAAC;CAElE,OAAO;AACT;;;;;;;;;;AAWA,SAAgB,eAAe,cAAsB,MAAc,kBAAkB,IAAc;CACjG,IAAI,CAAC,gBAAgB,iBAAiB,MAAM,OAAO;CAEnD,MAAM,UAAU,iBAAiB,cAAc,IAAI;CACnD,MAAM,UAAU,QAAQ,QAAO,MAAK,EAAE,SAAS,SAAS,CAAC,CAAC;CAC1D,IAAI,YAAY,GAAG,OAAO;CAG1B,OAAO,UAAU,KAAK,IAAI,QAAQ,QAAQ,CAAC,KAAK;AAClD"}

package/dist/utils/plans.d.ts

@@ -0,0 +1,56 @@
+/** Global plans directory for approved-plan archives. */
+export declare function getPlansDir(): string;
+/** Local (project-scoped) plans directory where the agent writes named plan files. */
+export declare function getLocalPlansDir(projectPath: string): string;
+/** Workspace-relative directory the agent writes plan files into. */
+export declare function getLocalPlansRelativeDir(): string;
+/** Derive a plan filename from a title (e.g. `add-dark-mode.md`). */
+export declare function getPlanFilename(title: string): string;
+/**
+ * Suggested workspace-relative path for a new plan file, shown in plan-mode prompts.
+ * Without a title we fall back to a generic name the agent can rename later.
+ */
+export declare function getSuggestedPlanRelativePath(title?: string): string;
+/**
+ * Resolve a plan path submitted by the agent (absolute or project-relative) to an
+ * absolute path. Returns `undefined` when no usable path was provided.
+ */
+export declare function resolvePlanPath(projectPath: string, submittedPath: string): string | undefined;
+/**
+ * Whether `targetPath` (absolute or project-relative) is a valid plan file: a `.md`
+ * file located directly inside the project's `.mastracode/plans/` directory. Used by the
+ * plan-mode write guard so the agent can write any named plan file there, but nothing
+ * outside that directory.
+ */
+export declare function isPlanFilePath(projectPath: string, targetPath: string): boolean;
+export declare function savePlanToDisk(opts: {
+    title: string;
+    plan: string;
+    resourceId: string;
+    plansDir?: string;
+}): Promise<void>;
+/**
+ * Read a plan markdown file by absolute path.
+ *
+ * The leading `# <title>` heading (if present) is parsed as the title and the remaining
+ * content is returned as the plan body. Returns `undefined` when the file does not exist.
+ */
+export declare function readPlanFile(absPath: string): Promise<{
+    title: string;
+    plan: string;
+} | undefined>;
+/**
+ * Approve the plan file at `planPath`: write a timestamped copy to the global plans
+ * archive so approved plans are findable later. The local named plan file is left in
+ * place so the user can review every plan made over time.
+ *
+ * Returns the local plan filename (e.g. `add-dark-mode.md`), or `undefined` when there
+ * was no plan file to approve.
+ */
+export declare function approvePlanFile(opts: {
+    planPath: string;
+    title: string;
+    resourceId: string;
+    plansDir?: string;
+}): Promise<string | undefined>;
+//# sourceMappingURL=plans.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plans.d.ts","sourceRoot":"","sources":["../../src/utils/plans.ts"],"names":[],"mappings":"AAKA,yDAAyD;AACzD,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,qEAAqE;AACrE,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAUD,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG9F;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAU/E;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBhB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,CAsBxG;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAc9B"}

package/dist/utils/plans.js

@@ -0,0 +1,117 @@
+import { DEFAULT_CONFIG_DIR } from "../constants.js";
+import { getAppDataDir } from "./project.js";
+import path from "path";
+import fs from "fs/promises";
+//#region src/utils/plans.ts
+/** Global plans directory for approved-plan archives. */
+function getPlansDir() {
+	return process.env.MASTRA_PLANS_DIR ?? path.join(getAppDataDir(), "plans");
+}
+/** Local (project-scoped) plans directory where the agent writes named plan files. */
+function getLocalPlansDir(projectPath) {
+	return path.join(projectPath, DEFAULT_CONFIG_DIR, "plans");
+}
+/** Workspace-relative directory the agent writes plan files into. */
+function getLocalPlansRelativeDir() {
+	return path.join(DEFAULT_CONFIG_DIR, "plans");
+}
+function slugify(str) {
+	return str.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "untitled";
+}
+/** Derive a plan filename from a title (e.g. `add-dark-mode.md`). */
+function getPlanFilename(title) {
+	return `${slugify(title)}.md`;
+}
+/**
+* Suggested workspace-relative path for a new plan file, shown in plan-mode prompts.
+* Without a title we fall back to a generic name the agent can rename later.
+*/
+function getSuggestedPlanRelativePath(title) {
+	const filename = title ? getPlanFilename(title) : "plan.md";
+	return path.join(getLocalPlansRelativeDir(), filename);
+}
+/**
+* Resolve a plan path submitted by the agent (absolute or project-relative) to an
+* absolute path. Returns `undefined` when no usable path was provided.
+*/
+function resolvePlanPath(projectPath, submittedPath) {
+	if (!submittedPath) return void 0;
+	return path.isAbsolute(submittedPath) ? submittedPath : path.resolve(projectPath, submittedPath);
+}
+/**
+* Whether `targetPath` (absolute or project-relative) is a valid plan file: a `.md`
+* file located directly inside the project's `.mastracode/plans/` directory. Used by the
+* plan-mode write guard so the agent can write any named plan file there, but nothing
+* outside that directory.
+*/
+function isPlanFilePath(projectPath, targetPath) {
+	const abs = resolvePlanPath(projectPath, targetPath);
+	if (!abs) return false;
+	if (path.extname(abs).toLowerCase() !== ".md") return false;
+	const plansDir = path.resolve(getLocalPlansDir(projectPath));
+	const rel = path.relative(plansDir, abs);
+	if (rel === "" || rel.startsWith("..") || path.isAbsolute(rel)) return false;
+	return !rel.includes(path.sep);
+}
+async function savePlanToDisk(opts) {
+	const { title, plan, resourceId } = opts;
+	const plansDir = opts.plansDir ?? getPlansDir();
+	const baseDir = path.resolve(plansDir);
+	const dir = path.resolve(baseDir, resourceId);
+	const rel = path.relative(baseDir, dir);
+	if (rel.startsWith("..") || path.isAbsolute(rel)) throw new Error(`Invalid resourceId: ${resourceId}`);
+	await fs.mkdir(dir, { recursive: true });
+	const now = /* @__PURE__ */ new Date();
+	const filename = `${now.toISOString().replace(/:/g, "-")}-${slugify(title)}.md`;
+	const content = `# ${title}\n\nApproved: ${now.toISOString()}\n\n${plan}\n`;
+	await fs.writeFile(path.join(dir, filename), content, "utf-8");
+}
+/**
+* Read a plan markdown file by absolute path.
+*
+* The leading `# <title>` heading (if present) is parsed as the title and the remaining
+* content is returned as the plan body. Returns `undefined` when the file does not exist.
+*/
+async function readPlanFile(absPath) {
+	let raw;
+	try {
+		raw = await fs.readFile(absPath, "utf-8");
+	} catch {
+		return;
+	}
+	const lines = raw.split(/\r?\n/);
+	const headingIndex = lines.findIndex((line) => line.trim().length > 0);
+	const heading = headingIndex >= 0 ? lines[headingIndex] : void 0;
+	if (heading?.startsWith("# ")) return {
+		title: heading.slice(2).trim(),
+		plan: lines.slice(headingIndex + 1).join("\n").replace(/^\n+/, "").trimEnd()
+	};
+	return {
+		title: "",
+		plan: raw.trimEnd()
+	};
+}
+/**
+* Approve the plan file at `planPath`: write a timestamped copy to the global plans
+* archive so approved plans are findable later. The local named plan file is left in
+* place so the user can review every plan made over time.
+*
+* Returns the local plan filename (e.g. `add-dark-mode.md`), or `undefined` when there
+* was no plan file to approve.
+*/
+async function approvePlanFile(opts) {
+	const { planPath, title, resourceId, plansDir } = opts;
+	const current = await readPlanFile(planPath);
+	if (!current) return;
+	await savePlanToDisk({
+		title: title || current.title || "Implementation Plan",
+		plan: current.plan,
+		resourceId,
+		plansDir
+	});
+	return path.basename(planPath);
+}
+//#endregion
+export { approvePlanFile, getLocalPlansDir, getLocalPlansRelativeDir, getPlanFilename, getPlansDir, getSuggestedPlanRelativePath, isPlanFilePath, readPlanFile, resolvePlanPath, savePlanToDisk };
+
+//# sourceMappingURL=plans.js.map

package/dist/utils/plans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plans.js","names":[],"sources":["../../src/utils/plans.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { DEFAULT_CONFIG_DIR } from '../constants.js';\nimport { getAppDataDir } from './project.js';\n\n/** Global plans directory for approved-plan archives. */\nexport function getPlansDir(): string {\n  return process.env.MASTRA_PLANS_DIR ?? path.join(getAppDataDir(), 'plans');\n}\n\n/** Local (project-scoped) plans directory where the agent writes named plan files. */\nexport function getLocalPlansDir(projectPath: string): string {\n  return path.join(projectPath, DEFAULT_CONFIG_DIR, 'plans');\n}\n\n/** Workspace-relative directory the agent writes plan files into. */\nexport function getLocalPlansRelativeDir(): string {\n  return path.join(DEFAULT_CONFIG_DIR, 'plans');\n}\n\nfunction slugify(str: string): string {\n  const slug = str\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-|-$/g, '');\n  return slug || 'untitled';\n}\n\n/** Derive a plan filename from a title (e.g. `add-dark-mode.md`). */\nexport function getPlanFilename(title: string): string {\n  return `${slugify(title)}.md`;\n}\n\n/**\n * Suggested workspace-relative path for a new plan file, shown in plan-mode prompts.\n * Without a title we fall back to a generic name the agent can rename later.\n */\nexport function getSuggestedPlanRelativePath(title?: string): string {\n  const filename = title ? getPlanFilename(title) : 'plan.md';\n  return path.join(getLocalPlansRelativeDir(), filename);\n}\n\n/**\n * Resolve a plan path submitted by the agent (absolute or project-relative) to an\n * absolute path. Returns `undefined` when no usable path was provided.\n */\nexport function resolvePlanPath(projectPath: string, submittedPath: string): string | undefined {\n  if (!submittedPath) return undefined;\n  return path.isAbsolute(submittedPath) ? submittedPath : path.resolve(projectPath, submittedPath);\n}\n\n/**\n * Whether `targetPath` (absolute or project-relative) is a valid plan file: a `.md`\n * file located directly inside the project's `.mastracode/plans/` directory. Used by the\n * plan-mode write guard so the agent can write any named plan file there, but nothing\n * outside that directory.\n */\nexport function isPlanFilePath(projectPath: string, targetPath: string): boolean {\n  const abs = resolvePlanPath(projectPath, targetPath);\n  if (!abs) return false;\n  if (path.extname(abs).toLowerCase() !== '.md') return false;\n\n  const plansDir = path.resolve(getLocalPlansDir(projectPath));\n  const rel = path.relative(plansDir, abs);\n  // Must be directly inside the plans dir (no nested subdirectories, no escaping it).\n  if (rel === '' || rel.startsWith('..') || path.isAbsolute(rel)) return false;\n  return !rel.includes(path.sep);\n}\n\nexport async function savePlanToDisk(opts: {\n  title: string;\n  plan: string;\n  resourceId: string;\n  plansDir?: string;\n}): Promise<void> {\n  const { title, plan, resourceId } = opts;\n  const plansDir = opts.plansDir ?? getPlansDir();\n  const baseDir = path.resolve(plansDir);\n  const dir = path.resolve(baseDir, resourceId);\n  const rel = path.relative(baseDir, dir);\n  if (rel.startsWith('..') || path.isAbsolute(rel)) {\n    throw new Error(`Invalid resourceId: ${resourceId}`);\n  }\n\n  await fs.mkdir(dir, { recursive: true });\n\n  const now = new Date();\n  const timestamp = now.toISOString().replace(/:/g, '-');\n  const slug = slugify(title);\n  const filename = `${timestamp}-${slug}.md`;\n\n  const content = `# ${title}\\n\\nApproved: ${now.toISOString()}\\n\\n${plan}\\n`;\n\n  await fs.writeFile(path.join(dir, filename), content, 'utf-8');\n}\n\n/**\n * Read a plan markdown file by absolute path.\n *\n * The leading `# <title>` heading (if present) is parsed as the title and the remaining\n * content is returned as the plan body. Returns `undefined` when the file does not exist.\n */\nexport async function readPlanFile(absPath: string): Promise<{ title: string; plan: string } | undefined> {\n  let raw: string;\n  try {\n    raw = await fs.readFile(absPath, 'utf-8');\n  } catch {\n    return undefined;\n  }\n\n  const lines = raw.split(/\\r?\\n/);\n  const headingIndex = lines.findIndex(line => line.trim().length > 0);\n  const heading = headingIndex >= 0 ? lines[headingIndex] : undefined;\n  if (heading?.startsWith('# ')) {\n    const title = heading.slice(2).trim();\n    const plan = lines\n      .slice(headingIndex + 1)\n      .join('\\n')\n      .replace(/^\\n+/, '')\n      .trimEnd();\n    return { title, plan };\n  }\n\n  return { title: '', plan: raw.trimEnd() };\n}\n\n/**\n * Approve the plan file at `planPath`: write a timestamped copy to the global plans\n * archive so approved plans are findable later. The local named plan file is left in\n * place so the user can review every plan made over time.\n *\n * Returns the local plan filename (e.g. `add-dark-mode.md`), or `undefined` when there\n * was no plan file to approve.\n */\nexport async function approvePlanFile(opts: {\n  planPath: string;\n  title: string;\n  resourceId: string;\n  plansDir?: string;\n}): Promise<string | undefined> {\n  const { planPath, title, resourceId, plansDir } = opts;\n\n  const current = await readPlanFile(planPath);\n  if (!current) {\n    return undefined;\n  }\n\n  const resolvedTitle = title || current.title || 'Implementation Plan';\n\n  // Global archive (timestamped, never overwritten) so approved plans are findable later.\n  await savePlanToDisk({ title: resolvedTitle, plan: current.plan, resourceId, plansDir });\n\n  return path.basename(planPath);\n}\n"],"mappings":"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"}

package/dist/utils/project.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Project detection utilities
+ *
+ * Detects project identity from git repo or filesystem path.
+ * Handles git worktrees by finding the main repository.
+ */
+export interface ProjectInfo {
+    /** Unique resource ID for this project (used for thread grouping) */
+    resourceId: string;
+    /** Human-readable project name */
+    name: string;
+    /** Absolute path to the project root */
+    rootPath: string;
+    /** Git remote URL if available */
+    gitUrl?: string;
+    /** Current git branch */
+    gitBranch?: string;
+    /** Whether this is a git worktree */
+    isWorktree: boolean;
+    /** Path to main git repo (different from rootPath if worktree) */
+    mainRepoPath?: string;
+    /** Whether the resourceId was explicitly overridden (env var or config) */
+    resourceIdOverride?: boolean;
+}
+/**
+ * Detect project info from a directory path
+ */
+export declare function detectProject(projectPath: string): ProjectInfo;
+/**
+ * Get the current git branch for a given directory.
+ * Lightweight alternative to detectProject() for refreshing just the branch.
+ */
+export declare function getCurrentGitBranch(cwd: string): string | undefined;
+/**
+ * Async version of getCurrentGitBranch — avoids blocking the event loop
+ * with execSync.  Falls back to undefined on any failure.
+ */
+export declare function getCurrentGitBranchAsync(cwd: string): Promise<string | undefined>;
+/**
+ * Get the application data directory for mastracode
+ * - macOS: ~/Library/Application Support/mastracode
+ * - Linux: ~/.local/share/mastracode
+ * - Windows: %APPDATA%/mastracode
+ */
+export declare function getAppDataDir(): string;
+/**
+ * Get the database path for mastracode
+ * Can be overridden with the MASTRA_DB_PATH environment variable for debugging.
+ */
+export declare function getDatabasePath(): string;
+/**
+ * Get the vector database path for mastracode.
+ * Separate from the main DB to avoid bloating it with embedding data.
+ */
+export declare function getVectorDatabasePath(): string;
+/**
+ * Get the observability DuckDB database path for mastracode.
+ * Separate from the main DB — DuckDB is used for OLAP-style trace/score/feedback queries.
+ * Can be overridden with the MASTRA_OBSERVABILITY_DB_PATH environment variable.
+ */
+export declare function getObservabilityDatabasePath(): string;
+import type { StorageSettings } from '../onboarding/settings.js';
+/**
+ * LibSQL storage configuration.
+ */
+export interface LibSQLStorageConfig {
+    backend: 'libsql';
+    url: string;
+    authToken?: string;
+    isRemote: boolean;
+    /**
+     * Optional explicit url for the recall vector DB. When omitted, the factory
+     * uses the shared default vector file.
+     */
+    vectorUrl?: string;
+    /** Auth token for the vector DB when `vectorUrl` points at a remote libSQL. */
+    vectorAuthToken?: string;
+}
+/**
+ * PostgreSQL storage configuration.
+ */
+export interface PgStorageConfig {
+    backend: 'pg';
+    connectionString?: string;
+    host?: string;
+    port?: number;
+    database?: string;
+    user?: string;
+    password?: string;
+    schemaName?: string;
+    disableInit?: boolean;
+    skipDefaultIndexes?: boolean;
+}
+/**
+ * Resolved storage configuration for either backend.
+ */
+export type StorageConfig = LibSQLStorageConfig | PgStorageConfig;
+/**
+ * Get the resolved storage configuration.
+ *
+ * Priority (highest to lowest):
+ *   1. Environment variables: MASTRA_STORAGE_BACKEND + backend-specific vars
+ *   2. Global settings (from /settings): settings.storage
+ *   3. Legacy config files: .mastracode/database.json (LibSQL only)
+ *   4. Local file database (LibSQL default)
+ *
+ * For PG, the env vars are:
+ *   MASTRA_STORAGE_BACKEND=pg
+ *   MASTRA_PG_CONNECTION_STRING or MASTRA_PG_HOST/PORT/DATABASE/USER/PASSWORD
+ *   MASTRA_PG_SCHEMA_NAME (optional)
+ *
+ * For LibSQL, the legacy env vars still work:
+ *   MASTRA_DB_URL + MASTRA_DB_AUTH_TOKEN
+ */
+export declare function getStorageConfig(projectDir?: string, storageSettings?: StorageSettings, configDirName?: string): StorageConfig;
+/**
+ * Get the current user identity.
+ *
+ * Priority:
+ *   1. MASTRA_USER_ID environment variable
+ *   2. git config user.email (from project dir or global)
+ *   3. OS username as fallback
+ */
+export declare function getUserId(projectDir?: string): string;
+/**
+ * Get the current user's display name.
+ *
+ * Priority:
+ *   1. git config user.name
+ *   2. OS username as fallback
+ */
+export declare function getUserName(projectDir?: string): string;
+/**
+ * Observational memory scope: "thread" (per-conversation) or "resource" (shared across threads).
+ */
+export type OmScope = 'thread' | 'resource';
+/**
+ * Get the configured observational memory scope.
+ *
+ * Priority:
+ *   1. MASTRA_OM_SCOPE environment variable ("thread" or "resource")
+ *   2. Project config: .mastracode/database.json → omScope
+ *   3. Global config: ~/.mastracode/database.json → omScope
+ *   4. Default: "thread"
+ */
+export declare function getOmScope(projectDir?: string, configDirName?: string): OmScope;
+/**
+ * Get an explicit resource ID override, if configured.
+ *
+ * Resource IDs act as shared tags — two users who set the same resourceId
+ * will share threads and observations for that resource.
+ *
+ * Priority:
+ *   1. MASTRA_RESOURCE_ID environment variable
+ *   2. Project config: .mastracode/database.json → resourceId
+ *   3. Global config: ~/.mastracode/database.json → resourceId
+ *   4. null (use auto-detected value)
+ */
+export declare function getResourceIdOverride(projectDir?: string, configDirName?: string): string | null;
+//# sourceMappingURL=project.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/utils/project.ts"],"names":[],"mappings":"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"}