@mastra/code-sdk 0.0.0-aggregate-trace-20261015182851

package/dist/plugins/manager.js

@@ -0,0 +1,456 @@
+import { getEntryPackageRoot, installPluginDependenciesForEntry } from "./dependencies.js";
+import { getPluginScopePaths } from "./paths.js";
+import { loadPluginRegistry, removePluginRecord, savePluginRegistry, setPluginRecord } from "./registry.js";
+import { collectActivePluginTools, isInsideDirectory, loadPlugins, resolvePluginEntryPath } from "./loader.js";
+import { ensureMastraCodePackageLink } from "./package-link.js";
+import { NON_INTERACTIVE_GIT_ENV, discoverLocalPlugins, installGithubPlugin, installLocalPlugin } from "./install.js";
+import path from "path";
+import fs from "fs";
+import { execa } from "execa";
+//#region src/plugins/manager.ts
+const GITHUB_PLUGIN_POLL_INTERVAL_MS = 6e4;
+function gitExecOptions(cwd) {
+	return {
+		cwd,
+		env: NON_INTERACTIVE_GIT_ENV
+	};
+}
+function getEntryVersion(entryPath) {
+	const stat = fs.statSync(entryPath, { bigint: true });
+	return `${stat.mtimeNs}:${stat.size}`;
+}
+var PluginManager = class {
+	options;
+	loadedPlugins = [];
+	pluginTools = {};
+	rawPluginTools = {};
+	toolRenderConfigs = /* @__PURE__ */ new Map();
+	watchedLocalEntries = /* @__PURE__ */ new Set();
+	localEntryVersions = /* @__PURE__ */ new Map();
+	/** Last known git HEAD per GitHub checkout, kept current by the poller. */
+	githubCheckoutHeads = /* @__PURE__ */ new Map();
+	githubPollTimer;
+	githubPollInFlight;
+	reloadInFlight;
+	reloadListeners = /* @__PURE__ */ new Set();
+	githubUpdateListeners = /* @__PURE__ */ new Set();
+	runtime;
+	constructor(options) {
+		this.options = options;
+		this.runtime = options.runtime;
+	}
+	/**
+	* Publish (or replace) the runtime accessors handed to plugin field resolvers.
+	* Takes effect on the next load or reload. `createMastraCode` calls this for
+	* every manager it uses — including an injected one — so a manager constructed
+	* without a runtime still exposes `getController`/`getActiveSession` to plugins.
+	* A manager shared across controllers sees the most recent controller's accessors.
+	*/
+	setRuntime(runtime) {
+		this.runtime = runtime;
+	}
+	onReload(listener) {
+		this.reloadListeners.add(listener);
+		return () => this.reloadListeners.delete(listener);
+	}
+	/** Notified with the display names of GitHub plugins that were updated by the background poll. */
+	onGithubPluginsUpdated(listener) {
+		this.githubUpdateListeners.add(listener);
+		return () => this.githubUpdateListeners.delete(listener);
+	}
+	async reload() {
+		if (this.reloadInFlight) return this.reloadInFlight;
+		this.reloadInFlight = (async () => {
+			this.loadedPlugins = await loadPlugins({
+				...this.options,
+				runtime: this.runtime
+			});
+			await this.stampLoadedPlugins(this.loadedPlugins);
+			this.updateLocalEntryWatchers(this.loadedPlugins);
+			this.updateGithubPoller(this.loadedPlugins);
+			this.updatePluginRenderConfigs(this.loadedPlugins);
+			this.updatePluginTools(collectActivePluginTools(this.loadedPlugins));
+			await this.notifyReloadListeners(this.loadedPlugins);
+			return this.loadedPlugins;
+		})().finally(() => {
+			this.reloadInFlight = void 0;
+		});
+		return this.reloadInFlight;
+	}
+	async listPlugins() {
+		if (this.loadedPlugins.length === 0) await this.reload();
+		return this.loadedPlugins;
+	}
+	getLoadedPlugins() {
+		return this.loadedPlugins;
+	}
+	getPluginTools() {
+		return this.pluginTools;
+	}
+	getToolRenderConfig(toolName) {
+		return this.toolRenderConfigs.get(toolName);
+	}
+	getPluginSkillPaths() {
+		return this.loadedPlugins.flatMap((plugin) => plugin.status === "active" ? plugin.skillPaths ?? [] : []);
+	}
+	getPluginCommandPaths() {
+		return this.loadedPlugins.flatMap((plugin) => plugin.status === "active" ? plugin.commandPaths ?? [] : []);
+	}
+	getPluginInstructions() {
+		return this.loadedPlugins.flatMap((plugin) => plugin.status === "active" && plugin.instructions ? [plugin.instructions] : []);
+	}
+	/**
+	* Processors contributed by active plugins, tagged with the plugin that owns
+	* each one. Reads already-resolved state — no filesystem access — because the
+	* agent's processor lanes call this before every request.
+	*/
+	getPluginProcessors() {
+		return {
+			input: this.collectActive((plugin) => plugin.processors?.input ?? []),
+			output: this.collectActive((plugin) => plugin.processors?.output ?? [])
+		};
+	}
+	/** Signal providers contributed by active plugins, tagged with their owning plugin. */
+	getPluginSignalProviders() {
+		return this.collectActive((plugin) => plugin.signalProviders ?? []);
+	}
+	collectActive(select) {
+		return this.loadedPlugins.flatMap((plugin) => plugin.status === "active" ? select(plugin).map((value) => ({
+			pluginId: plugin.id,
+			versionStamp: plugin.versionStamp ?? "",
+			value
+		})) : []);
+	}
+	async notifyReloadListeners(plugins) {
+		await Promise.all([...this.reloadListeners].map((listener) => Promise.resolve(listener(plugins))));
+	}
+	/**
+	* Stamps each plugin with a value that changes when its contributions should
+	* be rebuilt. Runs on every reload, so it stays off the network: GitHub heads
+	* come from the cache the poller keeps current and cost one `git rev-parse`
+	* per checkout the first time it is seen.
+	*/
+	async stampLoadedPlugins(plugins) {
+		for (const plugin of plugins) plugin.versionStamp = [
+			plugin.status,
+			await this.readSourceStamp(plugin),
+			JSON.stringify(plugin.configValues ?? {})
+		].join("|");
+	}
+	async readSourceStamp(plugin) {
+		try {
+			if (plugin.source === "github") {
+				const checkoutPath = this.resolvePluginSourcePath(plugin);
+				let head = this.githubCheckoutHeads.get(checkoutPath);
+				if (head === void 0) {
+					head = await this.readGitHead(checkoutPath);
+					this.githubCheckoutHeads.set(checkoutPath, head);
+				}
+				return head;
+			}
+			return getEntryVersion(resolvePluginEntryPath(plugin, this.options));
+		} catch {
+			return "";
+		}
+	}
+	updatePluginRenderConfigs(plugins) {
+		this.toolRenderConfigs.clear();
+		for (const plugin of plugins) {
+			if (plugin.status !== "active") continue;
+			for (const [toolName, renderConfig] of Object.entries(plugin.renderConfigs ?? {})) if (!this.toolRenderConfigs.has(toolName)) this.toolRenderConfigs.set(toolName, renderConfig);
+		}
+	}
+	updatePluginTools(nextTools) {
+		for (const name of Object.keys(this.rawPluginTools)) if (!(name in nextTools)) {
+			delete this.rawPluginTools[name];
+			delete this.pluginTools[name];
+		}
+		for (const [name, tool] of Object.entries(nextTools)) {
+			this.rawPluginTools[name] = tool;
+			if (!this.pluginTools[name]) this.pluginTools[name] = this.createLiveToolProxy(name);
+			this.syncLiveToolProxy(name, tool);
+		}
+	}
+	createLiveToolProxy(toolName) {
+		return { execute: async (...args) => {
+			await this.reloadChangedLocalPlugins();
+			const latestTool = this.rawPluginTools[toolName];
+			if (!latestTool?.execute) throw new Error(`Plugin tool "${toolName}" is no longer available`);
+			return latestTool.execute(...args);
+		} };
+	}
+	syncLiveToolProxy(toolName, tool) {
+		const proxy = this.pluginTools[toolName];
+		if (!proxy) return;
+		const mutableProxy = proxy;
+		for (const key of Object.keys(mutableProxy)) delete mutableProxy[key];
+		Object.assign(proxy, tool);
+		proxy.execute = this.createLiveToolProxy(toolName).execute;
+	}
+	async reloadChangedLocalPlugins() {
+		for (const plugin of this.loadedPlugins) {
+			if (plugin.source !== "local" || plugin.status !== "active") continue;
+			const entryPath = resolvePluginEntryPath(plugin, this.options);
+			const currentVersion = getEntryVersion(entryPath);
+			if (this.localEntryVersions.get(entryPath) !== currentVersion) {
+				await this.reload();
+				return;
+			}
+		}
+	}
+	updateLocalEntryWatchers(plugins) {
+		const nextEntries = /* @__PURE__ */ new Set();
+		for (const plugin of plugins) {
+			if (plugin.source !== "local" || plugin.status !== "active") continue;
+			let entryPath;
+			let entryVersion;
+			try {
+				entryPath = resolvePluginEntryPath(plugin, this.options);
+				entryVersion = getEntryVersion(entryPath);
+			} catch {
+				continue;
+			}
+			nextEntries.add(entryPath);
+			this.localEntryVersions.set(entryPath, entryVersion);
+			if (this.watchedLocalEntries.has(entryPath)) continue;
+			fs.watchFile(entryPath, { interval: 500 }, (current, previous) => {
+				if (current.mtimeMs === previous.mtimeMs) return;
+				this.reload().catch(() => void 0);
+			}).unref?.();
+			this.watchedLocalEntries.add(entryPath);
+		}
+		for (const entryPath of this.watchedLocalEntries) {
+			if (nextEntries.has(entryPath)) continue;
+			fs.unwatchFile(entryPath);
+			this.watchedLocalEntries.delete(entryPath);
+			this.localEntryVersions.delete(entryPath);
+		}
+	}
+	updateGithubPoller(plugins) {
+		const hasGithubPlugin = plugins.some((plugin) => plugin.source === "github" && plugin.status !== "inactive" && plugin.status !== "blocked");
+		if (hasGithubPlugin && !this.githubPollTimer) {
+			this.githubPollTimer = setInterval(() => {
+				this.pollGithubSourcesForUpdates().catch(() => void 0);
+			}, GITHUB_PLUGIN_POLL_INTERVAL_MS);
+			this.githubPollTimer.unref?.();
+		}
+		if (!hasGithubPlugin && this.githubPollTimer) {
+			clearInterval(this.githubPollTimer);
+			this.githubPollTimer = void 0;
+		}
+	}
+	async pollGithubSourcesForUpdates() {
+		if (this.githubPollInFlight) return this.githubPollInFlight;
+		this.githubPollInFlight = this.pollGithubSourcesForUpdatesOnce().finally(() => {
+			this.githubPollInFlight = void 0;
+		});
+		return this.githubPollInFlight;
+	}
+	async pollGithubSourcesForUpdatesOnce() {
+		const changedCheckouts = /* @__PURE__ */ new Set();
+		const seen = /* @__PURE__ */ new Set();
+		for (const plugin of this.loadedPlugins) {
+			if (plugin.source !== "github" || plugin.status === "inactive" || plugin.status === "blocked") continue;
+			const checkoutPath = this.resolvePluginSourcePath(plugin);
+			if (seen.has(checkoutPath) || !fs.existsSync(path.join(checkoutPath, ".git"))) continue;
+			seen.add(checkoutPath);
+			const before = await this.readGitHead(checkoutPath);
+			const checkoutChanged = await this.refreshGithubCheckout(plugin, checkoutPath, before);
+			const after = await this.readGitHead(checkoutPath);
+			this.githubCheckoutHeads.set(checkoutPath, after);
+			if (checkoutChanged || before !== after) changedCheckouts.add(checkoutPath);
+		}
+		if (changedCheckouts.size === 0) return false;
+		await this.reload();
+		const updatedPluginNames = this.loadedPlugins.filter((plugin) => plugin.source === "github" && plugin.status !== "inactive" && plugin.status !== "blocked" && changedCheckouts.has(this.resolvePluginSourcePath(plugin))).map((plugin) => plugin.name ?? plugin.id);
+		await this.notifyGithubUpdateListeners(updatedPluginNames);
+		return true;
+	}
+	async notifyGithubUpdateListeners(pluginNames) {
+		await Promise.all([...this.githubUpdateListeners].map((listener) => Promise.resolve(listener(pluginNames))));
+	}
+	async refreshGithubCheckout(plugin, checkoutPath, currentHead) {
+		await execa("git", ["fetch", "origin"], gitExecOptions(checkoutPath));
+		const upstream = await this.resolveGitUpstream(checkoutPath, plugin.ref);
+		if (!upstream) return false;
+		const [localOnly, remoteOnly] = await this.readGitAheadBehind(checkoutPath, upstream);
+		const hasLocalChanges = await this.hasGitWorkingTreeChanges(checkoutPath);
+		if (localOnly > 0 || hasLocalChanges) await this.backupGitCheckout(checkoutPath, currentHead, hasLocalChanges);
+		if (remoteOnly > 0 || localOnly > 0 || hasLocalChanges) {
+			await execa("git", [
+				"reset",
+				"--hard",
+				upstream
+			], gitExecOptions(checkoutPath));
+			try {
+				await installPluginDependenciesForEntry(checkoutPath, plugin.entry);
+				ensureMastraCodePackageLink(getEntryPackageRoot(checkoutPath, plugin.entry));
+			} catch (error) {
+				await execa("git", [
+					"reset",
+					"--hard",
+					currentHead
+				], gitExecOptions(checkoutPath));
+				throw error;
+			}
+			return true;
+		}
+		return false;
+	}
+	async backupGitCheckout(checkoutPath, currentHead, includeWorkingTree) {
+		const backupBranch = this.createGitBackupBranchName(currentHead);
+		if (includeWorkingTree) {
+			const currentBranch = await this.readGitCurrentBranch(checkoutPath);
+			await execa("git", [
+				"switch",
+				"-c",
+				backupBranch
+			], gitExecOptions(checkoutPath));
+			await execa("git", ["add", "-A"], gitExecOptions(checkoutPath));
+			if (await this.hasGitStagedChanges(checkoutPath)) await execa("git", [
+				"-c",
+				"user.name=Mastra Code",
+				"-c",
+				"user.email=noreply@mastra.ai",
+				"commit",
+				"-m",
+				"chore: backup local plugin checkout changes"
+			], gitExecOptions(checkoutPath));
+			await this.restoreGitCheckout(checkoutPath, currentBranch, currentHead);
+			return;
+		}
+		await execa("git", [
+			"branch",
+			backupBranch,
+			"HEAD"
+		], gitExecOptions(checkoutPath));
+	}
+	async resolveGitUpstream(cwd, installedRef) {
+		try {
+			const { stdout } = await execa("git", [
+				"rev-parse",
+				"--abbrev-ref",
+				"--symbolic-full-name",
+				"@{u}"
+			], gitExecOptions(cwd));
+			return stdout.trim();
+		} catch {
+			return installedRef ? void 0 : "origin/main";
+		}
+	}
+	async readGitAheadBehind(cwd, upstream) {
+		const { stdout } = await execa("git", [
+			"rev-list",
+			"--left-right",
+			"--count",
+			`HEAD...${upstream}`
+		], gitExecOptions(cwd));
+		const [ahead = "0", behind = "0"] = stdout.trim().split(/\s+/);
+		return [Number(ahead) || 0, Number(behind) || 0];
+	}
+	async hasGitWorkingTreeChanges(cwd) {
+		const { stdout } = await execa("git", ["status", "--porcelain"], gitExecOptions(cwd));
+		return stdout.trim().length > 0;
+	}
+	async hasGitStagedChanges(cwd) {
+		try {
+			await execa("git", [
+				"diff",
+				"--cached",
+				"--quiet"
+			], gitExecOptions(cwd));
+			return false;
+		} catch {
+			return true;
+		}
+	}
+	async restoreGitCheckout(cwd, branch, fallbackHead) {
+		if (branch) {
+			await execa("git", ["switch", branch], gitExecOptions(cwd));
+			return;
+		}
+		await execa("git", ["checkout", fallbackHead], gitExecOptions(cwd));
+	}
+	async readGitCurrentBranch(cwd) {
+		const { stdout } = await execa("git", ["branch", "--show-current"], gitExecOptions(cwd));
+		const branch = stdout.trim();
+		return branch.length > 0 ? branch : void 0;
+	}
+	createGitBackupBranchName(currentHead) {
+		return `mastracode/plugin-backup/${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}-${currentHead.slice(0, 8)}`;
+	}
+	resolvePluginSourcePath(plugin) {
+		const paths = getPluginScopePaths(plugin.scope, this.options);
+		return path.resolve(path.isAbsolute(plugin.path) ? plugin.path : path.join(paths.root, plugin.path));
+	}
+	async readGitHead(cwd) {
+		const { stdout } = await execa("git", ["rev-parse", "HEAD"], gitExecOptions(cwd));
+		return stdout.trim();
+	}
+	discoverLocal(searchRoot = ".") {
+		return discoverLocalPlugins(searchRoot, this.options);
+	}
+	async installLocal(localPath, scope, options = {}) {
+		const id = await installLocalPlugin(localPath, scope, {
+			...this.options,
+			...options
+		});
+		await this.reload();
+		return id;
+	}
+	async installGithub(url, scope, options = {}) {
+		const id = await installGithubPlugin(url, scope, {
+			...this.options,
+			...options
+		});
+		this.githubCheckoutHeads.clear();
+		await this.reload();
+		return id;
+	}
+	async setEnabled(pluginId, scope, enabled) {
+		const paths = getPluginScopePaths(scope, this.options);
+		const registry = loadPluginRegistry(paths.registryPath);
+		const record = registry.plugins[pluginId];
+		if (!record) throw new Error(`Plugin "${pluginId}" is not installed in ${scope} scope`);
+		savePluginRegistry(paths.registryPath, setPluginRecord(registry, pluginId, {
+			...record,
+			enabled
+		}));
+		await this.reload();
+	}
+	async setConfigValue(pluginId, scope, key, value) {
+		const paths = getPluginScopePaths(scope, this.options);
+		const registry = loadPluginRegistry(paths.registryPath);
+		const record = registry.plugins[pluginId];
+		if (!record) throw new Error(`Plugin "${pluginId}" is not installed in ${scope} scope`);
+		const config = { ...record.config ?? {} };
+		if (value === void 0 || value === "") delete config[key];
+		else config[key] = value;
+		const nextRecord = {
+			...record,
+			config: Object.keys(config).length > 0 ? config : void 0
+		};
+		savePluginRegistry(paths.registryPath, setPluginRecord(registry, pluginId, nextRecord));
+		await this.reload();
+	}
+	async uninstall(pluginId, scope) {
+		const paths = getPluginScopePaths(scope, this.options);
+		const registry = loadPluginRegistry(paths.registryPath);
+		const record = registry.plugins[pluginId];
+		if (!record) throw new Error(`Plugin "${pluginId}" is not installed in ${scope} scope`);
+		savePluginRegistry(paths.registryPath, removePluginRecord(registry, pluginId));
+		if (record.source === "github") {
+			const checkoutPath = path.resolve(path.isAbsolute(record.path) ? record.path : path.join(paths.root, record.path));
+			if (isInsideDirectory(checkoutPath, path.resolve(paths.sourcesPath, "github"))) fs.rmSync(checkoutPath, {
+				recursive: true,
+				force: true
+			});
+			this.githubCheckoutHeads.delete(checkoutPath);
+		}
+		await this.reload();
+	}
+};
+//#endregion
+export { PluginManager };
+
+//# sourceMappingURL=manager.js.map

package/dist/plugins/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","names":[],"sources":["../../src/plugins/manager.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { SignalProvider } from '@mastra/core/signals';\nimport { execa } from 'execa';\n\nimport type { MastraCodePluginConfigValue, MastraCodePluginRuntime } from '../plugin.js';\nimport { getEntryPackageRoot, installPluginDependenciesForEntry } from './dependencies.js';\nimport { discoverLocalPlugins, installGithubPlugin, installLocalPlugin, NON_INTERACTIVE_GIT_ENV } from './install.js';\nimport type { InstallPluginOptions } from './install.js';\nimport { collectActivePluginTools, isInsideDirectory, loadPlugins, resolvePluginEntryPath } from './loader.js';\nimport { ensureMastraCodePackageLink } from './package-link.js';\nimport { getPluginScopePaths } from './paths.js';\nimport type { PluginPathOptions } from './paths.js';\nimport { loadPluginRegistry, removePluginRecord, savePluginRegistry, setPluginRecord } from './registry.js';\nimport type { LoadedPlugin, PluginContribution, PluginProcessorEntries, PluginScope } from './types.js';\n\nconst GITHUB_PLUGIN_POLL_INTERVAL_MS = 60_000;\n\nfunction gitExecOptions(cwd: string) {\n  return { cwd, env: NON_INTERACTIVE_GIT_ENV };\n}\n\nfunction getEntryVersion(entryPath: string): string {\n  const stat = fs.statSync(entryPath, { bigint: true });\n  return `${stat.mtimeNs}:${stat.size}`;\n}\n\ntype PluginManagerOptions = PluginPathOptions & {\n  githubCliPath?: string;\n  /**\n   * Lazy accessors for Mastra Code's runtime, handed to plugin field resolvers on\n   * every load and reload.\n   */\n  runtime?: MastraCodePluginRuntime;\n};\n\nexport class PluginManager {\n  private loadedPlugins: LoadedPlugin[] = [];\n  private readonly pluginTools: ReturnType<typeof collectActivePluginTools> = {};\n  private readonly rawPluginTools: ReturnType<typeof collectActivePluginTools> = {};\n  private readonly toolRenderConfigs = new Map<string, NonNullable<LoadedPlugin['renderConfigs']>[string]>();\n  private readonly watchedLocalEntries = new Set<string>();\n  private readonly localEntryVersions = new Map<string, string>();\n  /** Last known git HEAD per GitHub checkout, kept current by the poller. */\n  private readonly githubCheckoutHeads = new Map<string, string>();\n  private githubPollTimer: ReturnType<typeof setInterval> | undefined;\n  private githubPollInFlight: Promise<boolean> | undefined;\n  private reloadInFlight: Promise<LoadedPlugin[]> | undefined;\n  private readonly reloadListeners = new Set<(plugins: LoadedPlugin[]) => void | Promise<void>>();\n  private readonly githubUpdateListeners = new Set<(pluginNames: string[]) => void | Promise<void>>();\n  private runtime: MastraCodePluginRuntime | undefined;\n\n  constructor(private readonly options: PluginManagerOptions) {\n    this.runtime = options.runtime;\n  }\n\n  /**\n   * Publish (or replace) the runtime accessors handed to plugin field resolvers.\n   * Takes effect on the next load or reload. `createMastraCode` calls this for\n   * every manager it uses — including an injected one — so a manager constructed\n   * without a runtime still exposes `getController`/`getActiveSession` to plugins.\n   * A manager shared across controllers sees the most recent controller's accessors.\n   */\n  setRuntime(runtime: MastraCodePluginRuntime): void {\n    this.runtime = runtime;\n  }\n\n  onReload(listener: (plugins: LoadedPlugin[]) => void | Promise<void>): () => void {\n    this.reloadListeners.add(listener);\n    return () => this.reloadListeners.delete(listener);\n  }\n\n  /** Notified with the display names of GitHub plugins that were updated by the background poll. */\n  onGithubPluginsUpdated(listener: (pluginNames: string[]) => void | Promise<void>): () => void {\n    this.githubUpdateListeners.add(listener);\n    return () => this.githubUpdateListeners.delete(listener);\n  }\n\n  async reload(): Promise<LoadedPlugin[]> {\n    if (this.reloadInFlight) return this.reloadInFlight;\n\n    this.reloadInFlight = (async () => {\n      this.loadedPlugins = await loadPlugins({ ...this.options, runtime: this.runtime });\n      await this.stampLoadedPlugins(this.loadedPlugins);\n      this.updateLocalEntryWatchers(this.loadedPlugins);\n      this.updateGithubPoller(this.loadedPlugins);\n      this.updatePluginRenderConfigs(this.loadedPlugins);\n      this.updatePluginTools(collectActivePluginTools(this.loadedPlugins));\n      await this.notifyReloadListeners(this.loadedPlugins);\n      return this.loadedPlugins;\n    })().finally(() => {\n      this.reloadInFlight = undefined;\n    });\n\n    return this.reloadInFlight;\n  }\n\n  async listPlugins(): Promise<LoadedPlugin[]> {\n    if (this.loadedPlugins.length === 0) {\n      await this.reload();\n    }\n    return this.loadedPlugins;\n  }\n\n  getLoadedPlugins(): LoadedPlugin[] {\n    return this.loadedPlugins;\n  }\n\n  getPluginTools() {\n    return this.pluginTools;\n  }\n\n  getToolRenderConfig(toolName: string) {\n    return this.toolRenderConfigs.get(toolName);\n  }\n\n  getPluginSkillPaths(): string[] {\n    return this.loadedPlugins.flatMap(plugin => (plugin.status === 'active' ? (plugin.skillPaths ?? []) : []));\n  }\n\n  getPluginCommandPaths(): string[] {\n    return this.loadedPlugins.flatMap(plugin => (plugin.status === 'active' ? (plugin.commandPaths ?? []) : []));\n  }\n\n  getPluginInstructions(): string[] {\n    return this.loadedPlugins.flatMap(plugin =>\n      plugin.status === 'active' && plugin.instructions ? [plugin.instructions] : [],\n    );\n  }\n\n  /**\n   * Processors contributed by active plugins, tagged with the plugin that owns\n   * each one. Reads already-resolved state — no filesystem access — because the\n   * agent's processor lanes call this before every request.\n   */\n  getPluginProcessors(): PluginProcessorEntries {\n    return {\n      input: this.collectActive(plugin => plugin.processors?.input ?? []),\n      output: this.collectActive(plugin => plugin.processors?.output ?? []),\n    };\n  }\n\n  /** Signal providers contributed by active plugins, tagged with their owning plugin. */\n  getPluginSignalProviders(): PluginContribution<SignalProvider<string>>[] {\n    return this.collectActive(plugin => plugin.signalProviders ?? []);\n  }\n\n  private collectActive<TValue>(select: (plugin: LoadedPlugin) => TValue[]): PluginContribution<TValue>[] {\n    return this.loadedPlugins.flatMap(plugin =>\n      plugin.status === 'active'\n        ? select(plugin).map(value => ({ pluginId: plugin.id, versionStamp: plugin.versionStamp ?? '', value }))\n        : [],\n    );\n  }\n\n  private async notifyReloadListeners(plugins: LoadedPlugin[]): Promise<void> {\n    await Promise.all([...this.reloadListeners].map(listener => Promise.resolve(listener(plugins))));\n  }\n\n  /**\n   * Stamps each plugin with a value that changes when its contributions should\n   * be rebuilt. Runs on every reload, so it stays off the network: GitHub heads\n   * come from the cache the poller keeps current and cost one `git rev-parse`\n   * per checkout the first time it is seen.\n   */\n  private async stampLoadedPlugins(plugins: LoadedPlugin[]): Promise<void> {\n    for (const plugin of plugins) {\n      plugin.versionStamp = [\n        plugin.status,\n        await this.readSourceStamp(plugin),\n        JSON.stringify(plugin.configValues ?? {}),\n      ].join('|');\n    }\n  }\n\n  private async readSourceStamp(plugin: LoadedPlugin): Promise<string> {\n    try {\n      if (plugin.source === 'github') {\n        const checkoutPath = this.resolvePluginSourcePath(plugin);\n        let head = this.githubCheckoutHeads.get(checkoutPath);\n        if (head === undefined) {\n          head = await this.readGitHead(checkoutPath);\n          this.githubCheckoutHeads.set(checkoutPath, head);\n        }\n        return head;\n      }\n      return getEntryVersion(resolvePluginEntryPath(plugin, this.options));\n    } catch {\n      // A plugin that failed to load has no readable source. Its stamp is then\n      // status + config, which is enough to notice when it starts working.\n      return '';\n    }\n  }\n\n  private updatePluginRenderConfigs(plugins: LoadedPlugin[]): void {\n    this.toolRenderConfigs.clear();\n    for (const plugin of plugins) {\n      if (plugin.status !== 'active') continue;\n      for (const [toolName, renderConfig] of Object.entries(plugin.renderConfigs ?? {})) {\n        if (!this.toolRenderConfigs.has(toolName)) {\n          this.toolRenderConfigs.set(toolName, renderConfig);\n        }\n      }\n    }\n  }\n\n  private updatePluginTools(nextTools: ReturnType<typeof collectActivePluginTools>): void {\n    for (const name of Object.keys(this.rawPluginTools)) {\n      if (!(name in nextTools)) {\n        delete this.rawPluginTools[name];\n        delete this.pluginTools[name];\n      }\n    }\n\n    for (const [name, tool] of Object.entries(nextTools)) {\n      this.rawPluginTools[name] = tool;\n      if (!this.pluginTools[name]) {\n        this.pluginTools[name] = this.createLiveToolProxy(name);\n      }\n      this.syncLiveToolProxy(name, tool);\n    }\n  }\n\n  private createLiveToolProxy(toolName: string) {\n    return {\n      execute: async (...args: any[]) => {\n        await this.reloadChangedLocalPlugins();\n        const latestTool = this.rawPluginTools[toolName];\n        if (!latestTool?.execute) {\n          throw new Error(`Plugin tool \"${toolName}\" is no longer available`);\n        }\n        return (latestTool.execute as (...args: any[]) => unknown)(...args);\n      },\n    } as LoadedPlugin['tools'][string];\n  }\n\n  private syncLiveToolProxy(toolName: string, tool: LoadedPlugin['tools'][string]): void {\n    const proxy = this.pluginTools[toolName];\n    if (!proxy) return;\n    const mutableProxy = proxy as unknown as Record<string, unknown>;\n    for (const key of Object.keys(mutableProxy)) {\n      delete mutableProxy[key];\n    }\n    Object.assign(proxy, tool);\n    proxy.execute = this.createLiveToolProxy(toolName).execute;\n  }\n\n  private async reloadChangedLocalPlugins(): Promise<void> {\n    for (const plugin of this.loadedPlugins) {\n      if (plugin.source !== 'local' || plugin.status !== 'active') continue;\n      const entryPath = resolvePluginEntryPath(plugin, this.options);\n      const currentVersion = getEntryVersion(entryPath);\n      if (this.localEntryVersions.get(entryPath) !== currentVersion) {\n        await this.reload();\n        return;\n      }\n    }\n  }\n\n  private updateLocalEntryWatchers(plugins: LoadedPlugin[]): void {\n    const nextEntries = new Set<string>();\n    for (const plugin of plugins) {\n      if (plugin.source !== 'local' || plugin.status !== 'active') continue;\n      let entryPath: string;\n      let entryVersion: string;\n      try {\n        entryPath = resolvePluginEntryPath(plugin, this.options);\n        entryVersion = getEntryVersion(entryPath);\n      } catch {\n        continue;\n      }\n      nextEntries.add(entryPath);\n      this.localEntryVersions.set(entryPath, entryVersion);\n      if (this.watchedLocalEntries.has(entryPath)) continue;\n\n      const watcher = fs.watchFile(entryPath, { interval: 500 }, (current, previous) => {\n        if (current.mtimeMs === previous.mtimeMs) return;\n        void this.reload().catch(() => undefined);\n      });\n      watcher.unref?.();\n      this.watchedLocalEntries.add(entryPath);\n    }\n\n    for (const entryPath of this.watchedLocalEntries) {\n      if (nextEntries.has(entryPath)) continue;\n      fs.unwatchFile(entryPath);\n      this.watchedLocalEntries.delete(entryPath);\n      this.localEntryVersions.delete(entryPath);\n    }\n  }\n\n  private updateGithubPoller(plugins: LoadedPlugin[]): void {\n    const hasGithubPlugin = plugins.some(\n      plugin => plugin.source === 'github' && plugin.status !== 'inactive' && plugin.status !== 'blocked',\n    );\n    if (hasGithubPlugin && !this.githubPollTimer) {\n      this.githubPollTimer = setInterval(() => {\n        void this.pollGithubSourcesForUpdates().catch(() => undefined);\n      }, GITHUB_PLUGIN_POLL_INTERVAL_MS);\n      this.githubPollTimer.unref?.();\n    }\n    if (!hasGithubPlugin && this.githubPollTimer) {\n      clearInterval(this.githubPollTimer);\n      this.githubPollTimer = undefined;\n    }\n  }\n\n  async pollGithubSourcesForUpdates(): Promise<boolean> {\n    if (this.githubPollInFlight) return this.githubPollInFlight;\n    this.githubPollInFlight = this.pollGithubSourcesForUpdatesOnce().finally(() => {\n      this.githubPollInFlight = undefined;\n    });\n    return this.githubPollInFlight;\n  }\n\n  private async pollGithubSourcesForUpdatesOnce(): Promise<boolean> {\n    const changedCheckouts = new Set<string>();\n    const seen = new Set<string>();\n    for (const plugin of this.loadedPlugins) {\n      if (plugin.source !== 'github' || plugin.status === 'inactive' || plugin.status === 'blocked') continue;\n      const checkoutPath = this.resolvePluginSourcePath(plugin);\n      if (seen.has(checkoutPath) || !fs.existsSync(path.join(checkoutPath, '.git'))) continue;\n      seen.add(checkoutPath);\n\n      const before = await this.readGitHead(checkoutPath);\n      const checkoutChanged = await this.refreshGithubCheckout(plugin, checkoutPath, before);\n      const after = await this.readGitHead(checkoutPath);\n      // Feed the cache before reloading: the stamp is computed during reload and\n      // has to see the new head, or a real update would look unchanged.\n      this.githubCheckoutHeads.set(checkoutPath, after);\n      if (checkoutChanged || before !== after) changedCheckouts.add(checkoutPath);\n    }\n\n    if (changedCheckouts.size === 0) return false;\n\n    await this.reload();\n    // Derive names from the reloaded state so a manifest display-name change reports the new name.\n    // Multiple plugins can share one checkout — report every plugin whose source changed.\n    const updatedPluginNames = this.loadedPlugins\n      .filter(\n        plugin =>\n          plugin.source === 'github' &&\n          plugin.status !== 'inactive' &&\n          plugin.status !== 'blocked' &&\n          changedCheckouts.has(this.resolvePluginSourcePath(plugin)),\n      )\n      .map(plugin => plugin.name ?? plugin.id);\n    await this.notifyGithubUpdateListeners(updatedPluginNames);\n    return true;\n  }\n\n  private async notifyGithubUpdateListeners(pluginNames: string[]): Promise<void> {\n    await Promise.all([...this.githubUpdateListeners].map(listener => Promise.resolve(listener(pluginNames))));\n  }\n\n  private async refreshGithubCheckout(\n    plugin: LoadedPlugin,\n    checkoutPath: string,\n    currentHead: string,\n  ): Promise<boolean> {\n    await execa('git', ['fetch', 'origin'], gitExecOptions(checkoutPath));\n    const upstream = await this.resolveGitUpstream(checkoutPath, plugin.ref);\n    if (!upstream) return false;\n    const [localOnly, remoteOnly] = await this.readGitAheadBehind(checkoutPath, upstream);\n    const hasLocalChanges = await this.hasGitWorkingTreeChanges(checkoutPath);\n\n    if (localOnly > 0 || hasLocalChanges) {\n      await this.backupGitCheckout(checkoutPath, currentHead, hasLocalChanges);\n    }\n\n    if (remoteOnly > 0 || localOnly > 0 || hasLocalChanges) {\n      await execa('git', ['reset', '--hard', upstream], gitExecOptions(checkoutPath));\n      try {\n        await installPluginDependenciesForEntry(checkoutPath, plugin.entry);\n        ensureMastraCodePackageLink(getEntryPackageRoot(checkoutPath, plugin.entry));\n      } catch (error) {\n        await execa('git', ['reset', '--hard', currentHead], gitExecOptions(checkoutPath));\n        throw error;\n      }\n      return true;\n    }\n\n    return false;\n  }\n\n  private async backupGitCheckout(\n    checkoutPath: string,\n    currentHead: string,\n    includeWorkingTree: boolean,\n  ): Promise<void> {\n    const backupBranch = this.createGitBackupBranchName(currentHead);\n\n    if (includeWorkingTree) {\n      const currentBranch = await this.readGitCurrentBranch(checkoutPath);\n      await execa('git', ['switch', '-c', backupBranch], gitExecOptions(checkoutPath));\n      await execa('git', ['add', '-A'], gitExecOptions(checkoutPath));\n      const hasStagedChanges = await this.hasGitStagedChanges(checkoutPath);\n      if (hasStagedChanges) {\n        await execa(\n          'git',\n          [\n            '-c',\n            'user.name=Mastra Code',\n            '-c',\n            'user.email=noreply@mastra.ai',\n            'commit',\n            '-m',\n            'chore: backup local plugin checkout changes',\n          ],\n          gitExecOptions(checkoutPath),\n        );\n      }\n      await this.restoreGitCheckout(checkoutPath, currentBranch, currentHead);\n      return;\n    }\n\n    await execa('git', ['branch', backupBranch, 'HEAD'], gitExecOptions(checkoutPath));\n  }\n\n  private async resolveGitUpstream(cwd: string, installedRef?: string): Promise<string | undefined> {\n    try {\n      const { stdout } = await execa(\n        'git',\n        ['rev-parse', '--abbrev-ref', '--symbolic-full-name', '@{u}'],\n        gitExecOptions(cwd),\n      );\n      return stdout.trim();\n    } catch {\n      return installedRef ? undefined : 'origin/main';\n    }\n  }\n\n  private async readGitAheadBehind(cwd: string, upstream: string): Promise<[number, number]> {\n    const { stdout } = await execa(\n      'git',\n      ['rev-list', '--left-right', '--count', `HEAD...${upstream}`],\n      gitExecOptions(cwd),\n    );\n    const [ahead = '0', behind = '0'] = stdout.trim().split(/\\s+/);\n    return [Number(ahead) || 0, Number(behind) || 0];\n  }\n\n  private async hasGitWorkingTreeChanges(cwd: string): Promise<boolean> {\n    const { stdout } = await execa('git', ['status', '--porcelain'], gitExecOptions(cwd));\n    return stdout.trim().length > 0;\n  }\n\n  private async hasGitStagedChanges(cwd: string): Promise<boolean> {\n    try {\n      await execa('git', ['diff', '--cached', '--quiet'], gitExecOptions(cwd));\n      return false;\n    } catch {\n      return true;\n    }\n  }\n\n  private async restoreGitCheckout(cwd: string, branch: string | undefined, fallbackHead: string): Promise<void> {\n    if (branch) {\n      await execa('git', ['switch', branch], gitExecOptions(cwd));\n      return;\n    }\n    await execa('git', ['checkout', fallbackHead], gitExecOptions(cwd));\n  }\n\n  private async readGitCurrentBranch(cwd: string): Promise<string | undefined> {\n    const { stdout } = await execa('git', ['branch', '--show-current'], gitExecOptions(cwd));\n    const branch = stdout.trim();\n    return branch.length > 0 ? branch : undefined;\n  }\n\n  private createGitBackupBranchName(currentHead: string): string {\n    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');\n    return `mastracode/plugin-backup/${timestamp}-${currentHead.slice(0, 8)}`;\n  }\n\n  private resolvePluginSourcePath(plugin: LoadedPlugin): string {\n    const paths = getPluginScopePaths(plugin.scope, this.options);\n    // Normalized so cache keys derived here match the `path.resolve`-normalized\n    // key that `uninstall` deletes with.\n    return path.resolve(path.isAbsolute(plugin.path) ? plugin.path : path.join(paths.root, plugin.path));\n  }\n\n  private async readGitHead(cwd: string): Promise<string> {\n    const { stdout } = await execa('git', ['rev-parse', 'HEAD'], gitExecOptions(cwd));\n    return stdout.trim();\n  }\n\n  discoverLocal(searchRoot = '.'): ReturnType<typeof discoverLocalPlugins> {\n    return discoverLocalPlugins(searchRoot, this.options);\n  }\n\n  async installLocal(\n    localPath: string,\n    scope: PluginScope,\n    options: Pick<InstallPluginOptions, 'entry'> = {},\n  ): Promise<string> {\n    const id = await installLocalPlugin(localPath, scope, { ...this.options, ...options });\n    await this.reload();\n    return id;\n  }\n\n  async installGithub(\n    url: string,\n    scope: PluginScope,\n    options: Pick<InstallPluginOptions, 'entry' | 'ref' | 'onOutput' | 'signal'> = {},\n  ): Promise<string> {\n    const id = await installGithubPlugin(url, scope, { ...this.options, ...options });\n    // Installing over an existing checkout replaces it at the same path, so the\n    // cached head would make a genuinely different commit stamp as unchanged and\n    // leave the previous signal providers running.\n    this.githubCheckoutHeads.clear();\n    await this.reload();\n    return id;\n  }\n\n  async setEnabled(pluginId: string, scope: PluginScope, enabled: boolean): Promise<void> {\n    const paths = getPluginScopePaths(scope, this.options);\n    const registry = loadPluginRegistry(paths.registryPath);\n    const record = registry.plugins[pluginId];\n    if (!record) {\n      throw new Error(`Plugin \"${pluginId}\" is not installed in ${scope} scope`);\n    }\n    savePluginRegistry(paths.registryPath, setPluginRecord(registry, pluginId, { ...record, enabled }));\n    await this.reload();\n  }\n\n  async setConfigValue(\n    pluginId: string,\n    scope: PluginScope,\n    key: string,\n    value: MastraCodePluginConfigValue,\n  ): Promise<void> {\n    const paths = getPluginScopePaths(scope, this.options);\n    const registry = loadPluginRegistry(paths.registryPath);\n    const record = registry.plugins[pluginId];\n    if (!record) {\n      throw new Error(`Plugin \"${pluginId}\" is not installed in ${scope} scope`);\n    }\n    const config = { ...(record.config ?? {}) };\n    if (value === undefined || value === '') {\n      delete config[key];\n    } else {\n      config[key] = value;\n    }\n    const nextRecord = { ...record, config: Object.keys(config).length > 0 ? config : undefined };\n    savePluginRegistry(paths.registryPath, setPluginRecord(registry, pluginId, nextRecord));\n    await this.reload();\n  }\n\n  async uninstall(pluginId: string, scope: PluginScope): Promise<void> {\n    const paths = getPluginScopePaths(scope, this.options);\n    const registry = loadPluginRegistry(paths.registryPath);\n    const record = registry.plugins[pluginId];\n    if (!record) {\n      throw new Error(`Plugin \"${pluginId}\" is not installed in ${scope} scope`);\n    }\n\n    savePluginRegistry(paths.registryPath, removePluginRecord(registry, pluginId));\n    if (record.source === 'github') {\n      const checkoutPath = path.resolve(\n        path.isAbsolute(record.path) ? record.path : path.join(paths.root, record.path),\n      );\n      const githubSourcesPath = path.resolve(paths.sourcesPath, 'github');\n      if (isInsideDirectory(checkoutPath, githubSourcesPath)) {\n        fs.rmSync(checkoutPath, { recursive: true, force: true });\n      }\n      this.githubCheckoutHeads.delete(checkoutPath);\n    }\n    await this.reload();\n  }\n}\n"],"mappings":"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"}

package/dist/plugins/manifest.d.ts

@@ -0,0 +1,14 @@
+export declare const PLUGIN_MANIFEST_FILE = ".mastracode-plugin.json";
+export type PluginManifestEntry = {
+    id: string;
+    name?: string;
+    entry: string;
+};
+export type PluginManifest = {
+    plugins: PluginManifestEntry[];
+};
+export declare function loadPluginManifest(rootDir: string): PluginManifest | undefined;
+export declare function savePluginManifest(rootDir: string, manifest: PluginManifest): void;
+export declare function upsertPluginManifestEntry(rootDir: string, entry: PluginManifestEntry): void;
+export declare function getSingleManifestPlugin(rootDir: string): PluginManifestEntry | undefined;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/plugins/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/plugins/manifest.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,oBAAoB,4BAA4B,CAAC;AAE9D,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAoB9E;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAElF;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAU3F;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAYxF"}

package/dist/plugins/manifest.js

@@ -0,0 +1,50 @@
+import path from "path";
+import fs from "fs";
+//#region src/plugins/manifest.ts
+const PLUGIN_MANIFEST_FILE = ".mastracode-plugin.json";
+function loadPluginManifest(rootDir) {
+	const manifestPath = path.join(rootDir, PLUGIN_MANIFEST_FILE);
+	if (!fs.existsSync(manifestPath)) return void 0;
+	let parsed;
+	try {
+		parsed = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+	} catch (error) {
+		throw new Error(`Could not parse ${PLUGIN_MANIFEST_FILE}: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	if (!parsed || typeof parsed !== "object" || !Array.isArray(parsed.plugins)) throw new Error(`${PLUGIN_MANIFEST_FILE} must contain a plugins array`);
+	return { plugins: parsed.plugins.map((entry, index) => validateManifestEntry(entry, index)) };
+}
+function savePluginManifest(rootDir, manifest) {
+	fs.writeFileSync(path.join(rootDir, PLUGIN_MANIFEST_FILE), `${JSON.stringify(manifest, null, 2)}\n`);
+}
+function upsertPluginManifestEntry(rootDir, entry) {
+	const manifest = loadPluginManifest(rootDir) ?? { plugins: [] };
+	const validatedEntry = validateManifestEntry(entry, manifest.plugins.length);
+	const existingIndex = manifest.plugins.findIndex((plugin) => plugin.id === validatedEntry.id);
+	if (existingIndex >= 0) manifest.plugins[existingIndex] = validateManifestEntry(validatedEntry, existingIndex);
+	else manifest.plugins.push(validatedEntry);
+	savePluginManifest(rootDir, manifest);
+}
+function getSingleManifestPlugin(rootDir) {
+	const manifest = loadPluginManifest(rootDir);
+	if (!manifest) return void 0;
+	if (manifest.plugins.length === 0) return void 0;
+	if (manifest.plugins.length > 1) throw new Error(`${PLUGIN_MANIFEST_FILE} contains multiple plugins. Provide an entry path for one of: ${manifest.plugins.map((plugin) => `${plugin.id} (${plugin.entry})`).join(", ")}`);
+	return manifest.plugins[0];
+}
+function validateManifestEntry(entry, index) {
+	if (!entry || typeof entry !== "object") throw new Error(`${PLUGIN_MANIFEST_FILE} plugin at index ${index} must be an object`);
+	const candidate = entry;
+	if (typeof candidate.id !== "string" || candidate.id.length === 0) throw new Error(`${PLUGIN_MANIFEST_FILE} plugin at index ${index} must include an id`);
+	if (typeof candidate.entry !== "string" || candidate.entry.length === 0) throw new Error(`${PLUGIN_MANIFEST_FILE} plugin ${candidate.id} must include an entry`);
+	if (candidate.name !== void 0 && typeof candidate.name !== "string") throw new Error(`${PLUGIN_MANIFEST_FILE} plugin ${candidate.id} name must be a string`);
+	return {
+		id: candidate.id,
+		entry: candidate.entry,
+		...candidate.name ? { name: candidate.name } : {}
+	};
+}
+//#endregion
+export { PLUGIN_MANIFEST_FILE, getSingleManifestPlugin, loadPluginManifest, savePluginManifest, upsertPluginManifestEntry };
+
+//# sourceMappingURL=manifest.js.map

package/dist/plugins/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","names":[],"sources":["../../src/plugins/manifest.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nexport const PLUGIN_MANIFEST_FILE = '.mastracode-plugin.json';\n\nexport type PluginManifestEntry = {\n  id: string;\n  name?: string;\n  entry: string;\n};\n\nexport type PluginManifest = {\n  plugins: PluginManifestEntry[];\n};\n\nexport function loadPluginManifest(rootDir: string): PluginManifest | undefined {\n  const manifestPath = path.join(rootDir, PLUGIN_MANIFEST_FILE);\n  if (!fs.existsSync(manifestPath)) return undefined;\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));\n  } catch (error) {\n    throw new Error(\n      `Could not parse ${PLUGIN_MANIFEST_FILE}: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n\n  if (!parsed || typeof parsed !== 'object' || !Array.isArray((parsed as { plugins?: unknown }).plugins)) {\n    throw new Error(`${PLUGIN_MANIFEST_FILE} must contain a plugins array`);\n  }\n\n  return {\n    plugins: (parsed as { plugins: unknown[] }).plugins.map((entry, index) => validateManifestEntry(entry, index)),\n  };\n}\n\nexport function savePluginManifest(rootDir: string, manifest: PluginManifest): void {\n  fs.writeFileSync(path.join(rootDir, PLUGIN_MANIFEST_FILE), `${JSON.stringify(manifest, null, 2)}\\n`);\n}\n\nexport function upsertPluginManifestEntry(rootDir: string, entry: PluginManifestEntry): void {\n  const manifest = loadPluginManifest(rootDir) ?? { plugins: [] };\n  const validatedEntry = validateManifestEntry(entry, manifest.plugins.length);\n  const existingIndex = manifest.plugins.findIndex(plugin => plugin.id === validatedEntry.id);\n  if (existingIndex >= 0) {\n    manifest.plugins[existingIndex] = validateManifestEntry(validatedEntry, existingIndex);\n  } else {\n    manifest.plugins.push(validatedEntry);\n  }\n  savePluginManifest(rootDir, manifest);\n}\n\nexport function getSingleManifestPlugin(rootDir: string): PluginManifestEntry | undefined {\n  const manifest = loadPluginManifest(rootDir);\n  if (!manifest) return undefined;\n  if (manifest.plugins.length === 0) return undefined;\n  if (manifest.plugins.length > 1) {\n    throw new Error(\n      `${PLUGIN_MANIFEST_FILE} contains multiple plugins. Provide an entry path for one of: ${manifest.plugins\n        .map(plugin => `${plugin.id} (${plugin.entry})`)\n        .join(', ')}`,\n    );\n  }\n  return manifest.plugins[0];\n}\n\nfunction validateManifestEntry(entry: unknown, index: number): PluginManifestEntry {\n  if (!entry || typeof entry !== 'object') {\n    throw new Error(`${PLUGIN_MANIFEST_FILE} plugin at index ${index} must be an object`);\n  }\n  const candidate = entry as { id?: unknown; name?: unknown; entry?: unknown };\n  if (typeof candidate.id !== 'string' || candidate.id.length === 0) {\n    throw new Error(`${PLUGIN_MANIFEST_FILE} plugin at index ${index} must include an id`);\n  }\n  if (typeof candidate.entry !== 'string' || candidate.entry.length === 0) {\n    throw new Error(`${PLUGIN_MANIFEST_FILE} plugin ${candidate.id} must include an entry`);\n  }\n  if (candidate.name !== undefined && typeof candidate.name !== 'string') {\n    throw new Error(`${PLUGIN_MANIFEST_FILE} plugin ${candidate.id} name must be a string`);\n  }\n  return {\n    id: candidate.id,\n    entry: candidate.entry,\n    ...(candidate.name ? { name: candidate.name } : {}),\n  };\n}\n"],"mappings":";;;AAGA,MAAa,uBAAuB;AAYpC,SAAgB,mBAAmB,SAA6C;CAC9E,MAAM,eAAe,KAAK,KAAK,SAAS,oBAAoB;CAC5D,IAAI,CAAC,GAAG,WAAW,YAAY,GAAG,OAAO,KAAA;CAEzC,IAAI;CACJ,IAAI;EACF,SAAS,KAAK,MAAM,GAAG,aAAa,cAAc,MAAM,CAAC;CAC3D,SAAS,OAAO;EACd,MAAM,IAAI,MACR,mBAAmB,qBAAqB,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GACnG;CACF;CAEA,IAAI,CAAC,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAS,OAAiC,OAAO,GACnG,MAAM,IAAI,MAAM,GAAG,qBAAqB,8BAA8B;CAGxE,OAAO,EACL,SAAU,OAAkC,QAAQ,KAAK,OAAO,UAAU,sBAAsB,OAAO,KAAK,CAAC,EAC/G;AACF;AAEA,SAAgB,mBAAmB,SAAiB,UAAgC;CAClF,GAAG,cAAc,KAAK,KAAK,SAAS,oBAAoB,GAAG,GAAG,KAAK,UAAU,UAAU,MAAM,CAAC,EAAE,GAAG;AACrG;AAEA,SAAgB,0BAA0B,SAAiB,OAAkC;CAC3F,MAAM,WAAW,mBAAmB,OAAO,KAAK,EAAE,SAAS,CAAC,EAAE;CAC9D,MAAM,iBAAiB,sBAAsB,OAAO,SAAS,QAAQ,MAAM;CAC3E,MAAM,gBAAgB,SAAS,QAAQ,WAAU,WAAU,OAAO,OAAO,eAAe,EAAE;CAC1F,IAAI,iBAAiB,GACnB,SAAS,QAAQ,iBAAiB,sBAAsB,gBAAgB,aAAa;MAErF,SAAS,QAAQ,KAAK,cAAc;CAEtC,mBAAmB,SAAS,QAAQ;AACtC;AAEA,SAAgB,wBAAwB,SAAkD;CACxF,MAAM,WAAW,mBAAmB,OAAO;CAC3C,IAAI,CAAC,UAAU,OAAO,KAAA;CACtB,IAAI,SAAS,QAAQ,WAAW,GAAG,OAAO,KAAA;CAC1C,IAAI,SAAS,QAAQ,SAAS,GAC5B,MAAM,IAAI,MACR,GAAG,qBAAqB,gEAAgE,SAAS,QAC9F,KAAI,WAAU,GAAG,OAAO,GAAG,IAAI,OAAO,MAAM,EAAE,CAAC,CAC/C,KAAK,IAAI,GACd;CAEF,OAAO,SAAS,QAAQ;AAC1B;AAEA,SAAS,sBAAsB,OAAgB,OAAoC;CACjF,IAAI,CAAC,SAAS,OAAO,UAAU,UAC7B,MAAM,IAAI,MAAM,GAAG,qBAAqB,mBAAmB,MAAM,mBAAmB;CAEtF,MAAM,YAAY;CAClB,IAAI,OAAO,UAAU,OAAO,YAAY,UAAU,GAAG,WAAW,GAC9D,MAAM,IAAI,MAAM,GAAG,qBAAqB,mBAAmB,MAAM,oBAAoB;CAEvF,IAAI,OAAO,UAAU,UAAU,YAAY,UAAU,MAAM,WAAW,GACpE,MAAM,IAAI,MAAM,GAAG,qBAAqB,UAAU,UAAU,GAAG,uBAAuB;CAExF,IAAI,UAAU,SAAS,KAAA,KAAa,OAAO,UAAU,SAAS,UAC5D,MAAM,IAAI,MAAM,GAAG,qBAAqB,UAAU,UAAU,GAAG,uBAAuB;CAExF,OAAO;EACL,IAAI,UAAU;EACd,OAAO,UAAU;EACjB,GAAI,UAAU,OAAO,EAAE,MAAM,UAAU,KAAK,IAAI,CAAC;CACnD;AACF"}

package/dist/plugins/package-link.d.ts

@@ -0,0 +1,3 @@
+export declare function findMastraCodePackageRoot(startDir: string): string;
+export declare function ensureMastraCodePackageLink(pluginDir: string): void;
+//# sourceMappingURL=package-link.d.ts.map

package/dist/plugins/package-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-link.d.ts","sourceRoot":"","sources":["../../src/plugins/package-link.ts"],"names":[],"mappings":"AA+BA,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA4BlE;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAmBnE"}