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

package/dist/plugins/loader.js

@@ -0,0 +1,260 @@
+import { getPluginRoot } from "./paths.js";
+import { loadPluginRegistry, mergePluginRegistries } from "./registry.js";
+import path from "path";
+import fs from "fs";
+import { pathToFileURL } from "url";
+import { isSignalProvider } from "@mastra/core/signals";
+//#region src/plugins/loader.ts
+async function loadPlugins(options) {
+	const records = mergePluginRegistries(options.globalRegistry ?? loadPluginRegistry(path.join(getPluginRoot("global", options), "plugins.json")), options.projectRegistry ?? loadPluginRegistry(path.join(getPluginRoot("project", options), "plugins.json")));
+	const loaded = [];
+	for (const record of records) {
+		if (record.blocked) {
+			loaded.push({
+				...record,
+				status: "blocked",
+				tools: {},
+				toolNames: []
+			});
+			continue;
+		}
+		if (!record.enabled) {
+			loaded.push({
+				...record,
+				status: "inactive",
+				tools: {},
+				toolNames: []
+			});
+			continue;
+		}
+		loaded.push(await loadPluginRecord(record, options));
+	}
+	return markToolConflicts(loaded);
+}
+async function loadPluginRecord(record, options) {
+	try {
+		const entryPath = resolvePluginEntryPath(record, options);
+		const plugin = await importPluginModule(entryPath);
+		if (plugin.id !== record.id) throw new Error(`Plugin id mismatch: registry has "${record.id}" but module exports "${plugin.id}"`);
+		const configSchema = validatePluginConfigSchema(plugin.config);
+		const configValues = resolvePluginConfigValues(configSchema, record.config);
+		const pluginDir = path.dirname(entryPath);
+		const pluginRoot = resolvePluginRoot(record, options);
+		const context = {
+			cwd: options.projectRoot,
+			scope: record.scope,
+			pluginDir,
+			config: configValues,
+			getController: options.runtime?.getController,
+			getActiveSession: options.runtime?.getActiveSession,
+			getStorage: options.runtime?.getStorage
+		};
+		const { tools, renderConfigs } = await resolvePluginTools(plugin, context);
+		const processors = await resolvePluginProcessors(plugin, context);
+		const signalProviders = await resolvePluginSignalProviders(plugin, context);
+		const instructions = await resolvePluginInstructions(plugin, context);
+		return {
+			...record,
+			name: plugin.name,
+			version: plugin.version ?? record.version,
+			description: plugin.description,
+			instructions,
+			status: "active",
+			tools,
+			renderConfigs,
+			toolNames: Object.keys(tools).sort(),
+			processors,
+			signalProviders,
+			skillPaths: resolveExistingAssetDirs(pluginRoot, "skills"),
+			commandPaths: resolveExistingAssetDirs(pluginRoot, "commands"),
+			configSchema,
+			configValues
+		};
+	} catch (error) {
+		return {
+			...record,
+			status: "load failed",
+			error: error instanceof Error ? error.message : String(error),
+			tools: {},
+			toolNames: []
+		};
+	}
+}
+async function loadPluginFromEntry(entryPath) {
+	return validatePluginExport(await importPluginModule(entryPath));
+}
+function resolvePluginRoot(record, options) {
+	const scopeRoot = path.resolve(getPluginRoot(record.scope, options));
+	const pluginRoot = path.resolve(path.isAbsolute(record.path) ? record.path : path.join(scopeRoot, record.path));
+	if (record.source === "github" && !isInsideDirectory(pluginRoot, scopeRoot)) throw new Error(`Plugin path for "${record.id}" must be inside the ${record.scope} plugin directory`);
+	return pluginRoot;
+}
+function resolvePluginEntryPath(record, options) {
+	const pluginRoot = resolvePluginRoot(record, options);
+	const entryPath = path.resolve(pluginRoot, record.entry);
+	if (!isInsideDirectory(entryPath, pluginRoot)) throw new Error(`Plugin entry for "${record.id}" must be inside the plugin directory`);
+	return entryPath;
+}
+function isInsideDirectory(targetPath, root) {
+	const resolvedTarget = path.resolve(targetPath);
+	const resolvedRoot = path.resolve(root);
+	return resolvedTarget === resolvedRoot || resolvedTarget.startsWith(resolvedRoot + path.sep);
+}
+function resolveExistingAssetDirs(pluginRoot, dirname) {
+	const dir = path.join(pluginRoot, dirname);
+	try {
+		return fs.statSync(dir).isDirectory() ? [dir] : [];
+	} catch {
+		return [];
+	}
+}
+async function importPluginModule(entryPath) {
+	if (path.extname(entryPath) !== ".ts") throw new Error(`Unsupported plugin entry extension "${path.extname(entryPath)}". V1 plugins must use .ts entries.`);
+	const url = pathToFileURL(entryPath);
+	const contentHash = Buffer.from(await globalThis.crypto.subtle.digest("SHA-1", fs.readFileSync(entryPath))).toString("hex");
+	const stat = fs.statSync(entryPath, { bigint: true });
+	url.searchParams.set("contentHash", contentHash);
+	url.searchParams.set("mtimeNs", stat.mtimeNs.toString());
+	const mod = await import(url.href);
+	return validatePluginExport(mod.default ?? mod.plugin);
+}
+function validatePluginExport(value) {
+	if (!value || typeof value !== "object") throw new Error("Plugin module must export a plugin object as default or named \"plugin\" export");
+	const plugin = value;
+	if (typeof plugin.id !== "string" || plugin.id.trim().length === 0) throw new Error("Plugin id must be a non-empty string");
+	if (plugin.tools !== void 0 && typeof plugin.tools !== "object" && typeof plugin.tools !== "function") throw new Error("Plugin tools must be an object or function");
+	if (plugin.processors !== void 0 && typeof plugin.processors !== "object" && typeof plugin.processors !== "function") throw new Error("Plugin processors must be an array, object, or function");
+	if (plugin.signalProviders !== void 0 && !Array.isArray(plugin.signalProviders) && typeof plugin.signalProviders !== "function") throw new Error("Plugin signal providers must be an array or function");
+	return plugin;
+}
+async function resolvePluginTools(plugin, context) {
+	if (!plugin.tools) return {
+		tools: {},
+		renderConfigs: {}
+	};
+	const entries = typeof plugin.tools === "function" ? await plugin.tools(context) : plugin.tools;
+	if (!entries || typeof entries !== "object" || Array.isArray(entries)) throw new Error("Plugin tools function must return an object");
+	return normalizePluginToolEntries(entries);
+}
+/** Mirrors {@link resolvePluginTools}: object-or-function, resolved with the same context. */
+async function resolvePluginProcessors(plugin, context) {
+	if (!plugin.processors) return {
+		input: [],
+		output: []
+	};
+	const entries = typeof plugin.processors === "function" ? await plugin.processors(context) : plugin.processors;
+	if (!entries || typeof entries !== "object") throw new Error("Plugin processors function must return an array or object");
+	return normalizePluginProcessorEntries(entries);
+}
+async function resolvePluginSignalProviders(plugin, context) {
+	if (!plugin.signalProviders) return [];
+	const entries = typeof plugin.signalProviders === "function" ? await plugin.signalProviders(context) : plugin.signalProviders;
+	if (!Array.isArray(entries)) throw new Error("Plugin signal providers function must return an array");
+	for (const [index, provider] of entries.entries()) if (!isPluginSignalProvider(provider)) throw new Error(`Plugin signal provider at index ${index} must be a SignalProvider (an object with an id that implements connect, startPolling, stop and __registerMastra)`);
+	return entries;
+}
+/**
+* Structural, not `instanceof`.
+*
+* A plugin that depends on a published provider package — the motivating case, a plugin wrapping
+* `@mastra/github-signals` — installs that package's own copy of `@mastra/core`, so its provider is
+* never an instance of the `SignalProvider` class Mastra Code loaded. `isSignalProvider` would reject
+* a perfectly working provider. Nothing in the lifecycle needs class identity: the lane only calls
+* these methods, so the methods are what is checked.
+*/
+function isPluginSignalProvider(value) {
+	if (isSignalProvider(value)) return true;
+	if (!value || typeof value !== "object") return false;
+	const candidate = value;
+	return typeof candidate.id === "string" && candidate.id.length > 0 && typeof candidate.connect === "function" && typeof candidate.startPolling === "function" && typeof candidate.stop === "function" && typeof candidate.__registerMastra === "function";
+}
+/** A bare array is shorthand for the input lane, the common case. */
+function normalizePluginProcessorEntries(entries) {
+	const input = Array.isArray(entries) ? entries : entries.input ?? [];
+	const output = Array.isArray(entries) ? [] : entries.output ?? [];
+	if (!Array.isArray(input) || !Array.isArray(output)) throw new Error("Plugin processor lanes must be arrays");
+	for (const processor of [...input, ...output]) if (!processor || typeof processor !== "object" || typeof processor.id !== "string") throw new Error("Plugin processors must be objects with an id");
+	return {
+		input,
+		output
+	};
+}
+async function resolvePluginInstructions(plugin, context) {
+	if (plugin.instructions === void 0) return void 0;
+	const instructions = typeof plugin.instructions === "function" ? await plugin.instructions(context) : plugin.instructions;
+	if (typeof instructions !== "string") throw new Error("Plugin instructions must be a string");
+	const trimmed = instructions.trim();
+	return trimmed.length > 0 ? trimmed : void 0;
+}
+function normalizePluginToolEntries(entries) {
+	const tools = {};
+	const renderConfigs = {};
+	for (const [name, entry] of Object.entries(entries)) {
+		if (!isToolEntryObject(entry)) throw new Error(`Plugin tool "${name}" must be an object with a tool property`);
+		tools[name] = entry.tool;
+		if (entry.render) renderConfigs[name] = entry.render;
+	}
+	return {
+		tools,
+		renderConfigs
+	};
+}
+function isToolEntryObject(entry) {
+	if (!entry || typeof entry !== "object" || !("tool" in entry)) return false;
+	const tool = entry.tool;
+	return !!tool && typeof tool === "object" && !Array.isArray(tool);
+}
+function validatePluginConfigSchema(schema) {
+	if (!schema || typeof schema !== "object" || Array.isArray(schema)) return void 0;
+	const validated = {};
+	for (const [key, option] of Object.entries(schema)) {
+		if (!option || typeof option !== "object" || Array.isArray(option)) continue;
+		const record = option;
+		if (record.type !== "model" && record.type !== "boolean" && record.type !== "string") continue;
+		validated[key] = {
+			type: record.type,
+			...typeof record.label === "string" ? { label: record.label } : {},
+			...typeof record.description === "string" ? { description: record.description } : {},
+			...typeof record.default === "string" || typeof record.default === "boolean" ? { default: record.default } : {}
+		};
+	}
+	return Object.keys(validated).length > 0 ? validated : void 0;
+}
+function resolvePluginConfigValues(schema, recordValues) {
+	const values = {};
+	if (!schema) return values;
+	for (const [key, option] of Object.entries(schema)) {
+		const value = recordValues?.[key];
+		if (option.type === "boolean") {
+			values[key] = typeof value === "boolean" ? value : typeof option.default === "boolean" ? option.default : false;
+			continue;
+		}
+		values[key] = typeof value === "string" ? value : typeof option.default === "string" ? option.default : void 0;
+	}
+	return values;
+}
+function collectActivePluginTools(plugins) {
+	const tools = {};
+	for (const plugin of plugins) {
+		if (plugin.status !== "active") continue;
+		for (const [name, tool] of Object.entries(plugin.tools)) if (!(name in tools)) tools[name] = tool;
+	}
+	return tools;
+}
+function markToolConflicts(plugins) {
+	const seen = /* @__PURE__ */ new Map();
+	return plugins.map((plugin) => {
+		if (plugin.status !== "active") return plugin;
+		const conflicts = plugin.toolNames.filter((toolName) => seen.has(toolName));
+		for (const toolName of plugin.toolNames) if (!seen.has(toolName)) seen.set(toolName, plugin.id);
+		return conflicts.length > 0 ? {
+			...plugin,
+			status: "conflicted",
+			conflicts
+		} : plugin;
+	});
+}
+//#endregion
+export { collectActivePluginTools, isInsideDirectory, loadPluginFromEntry, loadPluginRecord, loadPlugins, resolvePluginEntryPath, resolvePluginRoot };
+
+//# sourceMappingURL=loader.js.map

package/dist/plugins/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","names":[],"sources":["../../src/plugins/loader.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { pathToFileURL } from 'node:url';\n\nimport { isSignalProvider } from '@mastra/core/signals';\nimport type { SignalProvider } from '@mastra/core/signals';\n\nimport type {\n  MastraCodePlugin,\n  MastraCodePluginConfigSchema,\n  MastraCodePluginConfigValues,\n  MastraCodePluginContext,\n  MastraCodePluginProcessorEntries,\n  MastraCodePluginRuntime,\n  MastraCodePluginSignalProviderEntries,\n  MastraCodePluginToolEntries,\n  MastraCodePluginTools,\n  MastraCodeToolRenderConfig,\n} from '../plugin.js';\nimport { getPluginRoot } from './paths.js';\nimport type { PluginPathOptions } from './paths.js';\nimport { loadPluginRegistry, mergePluginRegistries } from './registry.js';\nimport type { LoadedPlugin, LoadedPluginProcessors, PluginRegistry, ScopedInstalledPluginRecord } from './types.js';\n\nexport type LoadPluginRecordOptions = PluginPathOptions & {\n  /** Lazy accessors for Mastra Code's runtime, passed on to plugin field resolvers. */\n  runtime?: MastraCodePluginRuntime;\n};\n\nexport type LoadPluginsOptions = LoadPluginRecordOptions & {\n  globalRegistry?: PluginRegistry;\n  projectRegistry?: PluginRegistry;\n};\n\nexport async function loadPlugins(options: LoadPluginsOptions): Promise<LoadedPlugin[]> {\n  const globalRegistry =\n    options.globalRegistry ?? loadPluginRegistry(path.join(getPluginRoot('global', options), 'plugins.json'));\n  const projectRegistry =\n    options.projectRegistry ?? loadPluginRegistry(path.join(getPluginRoot('project', options), 'plugins.json'));\n  const records = mergePluginRegistries(globalRegistry, projectRegistry);\n  const loaded: LoadedPlugin[] = [];\n\n  for (const record of records) {\n    if (record.blocked) {\n      loaded.push({ ...record, status: 'blocked', tools: {}, toolNames: [] });\n      continue;\n    }\n    if (!record.enabled) {\n      loaded.push({ ...record, status: 'inactive', tools: {}, toolNames: [] });\n      continue;\n    }\n\n    loaded.push(await loadPluginRecord(record, options));\n  }\n\n  return markToolConflicts(loaded);\n}\n\nexport async function loadPluginRecord(\n  record: ScopedInstalledPluginRecord,\n  options: LoadPluginRecordOptions,\n): Promise<LoadedPlugin> {\n  try {\n    const entryPath = resolvePluginEntryPath(record, options);\n    const plugin = await importPluginModule(entryPath);\n    if (plugin.id !== record.id) {\n      throw new Error(`Plugin id mismatch: registry has \"${record.id}\" but module exports \"${plugin.id}\"`);\n    }\n\n    const configSchema = validatePluginConfigSchema(plugin.config);\n    const configValues = resolvePluginConfigValues(configSchema, record.config);\n    const pluginDir = path.dirname(entryPath);\n    const pluginRoot = resolvePluginRoot(record, options);\n    const context: MastraCodePluginContext = {\n      cwd: options.projectRoot,\n      scope: record.scope,\n      pluginDir,\n      config: configValues,\n      // Accessors, not instances: plugins load before the controller and the\n      // session exist, so a plugin resolves these when it needs them, not now.\n      getController: options.runtime?.getController,\n      getActiveSession: options.runtime?.getActiveSession,\n      getStorage: options.runtime?.getStorage,\n    };\n    const { tools, renderConfigs } = await resolvePluginTools(plugin, context);\n    const processors = await resolvePluginProcessors(plugin, context);\n    const signalProviders = await resolvePluginSignalProviders(plugin, context);\n    const instructions = await resolvePluginInstructions(plugin, context);\n\n    return {\n      ...record,\n      name: plugin.name,\n      version: plugin.version ?? record.version,\n      description: plugin.description,\n      instructions,\n      status: 'active',\n      tools,\n      renderConfigs,\n      toolNames: Object.keys(tools).sort(),\n      processors,\n      signalProviders,\n      skillPaths: resolveExistingAssetDirs(pluginRoot, 'skills'),\n      commandPaths: resolveExistingAssetDirs(pluginRoot, 'commands'),\n      configSchema,\n      configValues,\n    };\n  } catch (error) {\n    return {\n      ...record,\n      status: 'load failed',\n      error: error instanceof Error ? error.message : String(error),\n      tools: {},\n      toolNames: [],\n    };\n  }\n}\n\nexport async function loadPluginFromEntry(entryPath: string): Promise<MastraCodePlugin> {\n  return validatePluginExport(await importPluginModule(entryPath));\n}\n\nexport function resolvePluginRoot(record: ScopedInstalledPluginRecord, options: PluginPathOptions): string {\n  const scopeRoot = path.resolve(getPluginRoot(record.scope, options));\n  const pluginRoot = path.resolve(path.isAbsolute(record.path) ? record.path : path.join(scopeRoot, record.path));\n  if (record.source === 'github' && !isInsideDirectory(pluginRoot, scopeRoot)) {\n    throw new Error(`Plugin path for \"${record.id}\" must be inside the ${record.scope} plugin directory`);\n  }\n  return pluginRoot;\n}\n\nexport function resolvePluginEntryPath(record: ScopedInstalledPluginRecord, options: PluginPathOptions): string {\n  const pluginRoot = resolvePluginRoot(record, options);\n  const entryPath = path.resolve(pluginRoot, record.entry);\n  if (!isInsideDirectory(entryPath, pluginRoot)) {\n    throw new Error(`Plugin entry for \"${record.id}\" must be inside the plugin directory`);\n  }\n  return entryPath;\n}\n\nexport function isInsideDirectory(targetPath: string, root: string): boolean {\n  const resolvedTarget = path.resolve(targetPath);\n  const resolvedRoot = path.resolve(root);\n  return resolvedTarget === resolvedRoot || resolvedTarget.startsWith(resolvedRoot + path.sep);\n}\n\nfunction resolveExistingAssetDirs(pluginRoot: string, dirname: 'skills' | 'commands'): string[] {\n  const dir = path.join(pluginRoot, dirname);\n  try {\n    return fs.statSync(dir).isDirectory() ? [dir] : [];\n  } catch {\n    return [];\n  }\n}\n\nasync function importPluginModule(entryPath: string): Promise<MastraCodePlugin> {\n  if (path.extname(entryPath) !== '.ts') {\n    throw new Error(\n      `Unsupported plugin entry extension \"${path.extname(entryPath)}\". V1 plugins must use .ts entries.`,\n    );\n  }\n\n  const url = pathToFileURL(entryPath);\n  const contentHash = Buffer.from(await globalThis.crypto.subtle.digest('SHA-1', fs.readFileSync(entryPath))).toString(\n    'hex',\n  );\n  const stat = fs.statSync(entryPath, { bigint: true });\n  url.searchParams.set('contentHash', contentHash);\n  url.searchParams.set('mtimeNs', stat.mtimeNs.toString());\n  const mod = (await import(url.href)) as { default?: unknown; plugin?: unknown };\n  return validatePluginExport(mod.default ?? mod.plugin);\n}\n\nfunction validatePluginExport(value: unknown): MastraCodePlugin {\n  if (!value || typeof value !== 'object') {\n    throw new Error('Plugin module must export a plugin object as default or named \"plugin\" export');\n  }\n\n  const plugin = value as MastraCodePlugin;\n  if (typeof plugin.id !== 'string' || plugin.id.trim().length === 0) {\n    throw new Error('Plugin id must be a non-empty string');\n  }\n\n  if (plugin.tools !== undefined && typeof plugin.tools !== 'object' && typeof plugin.tools !== 'function') {\n    throw new Error('Plugin tools must be an object or function');\n  }\n\n  if (\n    plugin.processors !== undefined &&\n    typeof plugin.processors !== 'object' &&\n    typeof plugin.processors !== 'function'\n  ) {\n    throw new Error('Plugin processors must be an array, object, or function');\n  }\n\n  if (\n    plugin.signalProviders !== undefined &&\n    !Array.isArray(plugin.signalProviders) &&\n    typeof plugin.signalProviders !== 'function'\n  ) {\n    throw new Error('Plugin signal providers must be an array or function');\n  }\n\n  return plugin;\n}\n\nasync function resolvePluginTools(\n  plugin: MastraCodePlugin,\n  context: MastraCodePluginContext,\n): Promise<{ tools: MastraCodePluginTools; renderConfigs: Record<string, MastraCodeToolRenderConfig> }> {\n  if (!plugin.tools) return { tools: {}, renderConfigs: {} };\n  const entries = typeof plugin.tools === 'function' ? await plugin.tools(context) : plugin.tools;\n  if (!entries || typeof entries !== 'object' || Array.isArray(entries)) {\n    throw new Error('Plugin tools function must return an object');\n  }\n  return normalizePluginToolEntries(entries);\n}\n\n/** Mirrors {@link resolvePluginTools}: object-or-function, resolved with the same context. */\nasync function resolvePluginProcessors(\n  plugin: MastraCodePlugin,\n  context: MastraCodePluginContext,\n): Promise<LoadedPluginProcessors> {\n  if (!plugin.processors) return { input: [], output: [] };\n  const entries = typeof plugin.processors === 'function' ? await plugin.processors(context) : plugin.processors;\n  if (!entries || typeof entries !== 'object') {\n    throw new Error('Plugin processors function must return an array or object');\n  }\n  return normalizePluginProcessorEntries(entries);\n}\n\nasync function resolvePluginSignalProviders(\n  plugin: MastraCodePlugin,\n  context: MastraCodePluginContext,\n): Promise<MastraCodePluginSignalProviderEntries> {\n  if (!plugin.signalProviders) return [];\n  const entries =\n    typeof plugin.signalProviders === 'function' ? await plugin.signalProviders(context) : plugin.signalProviders;\n  if (!Array.isArray(entries)) {\n    throw new Error('Plugin signal providers function must return an array');\n  }\n  for (const [index, provider] of entries.entries()) {\n    if (!isPluginSignalProvider(provider)) {\n      throw new Error(\n        `Plugin signal provider at index ${index} must be a SignalProvider (an object with an id that implements connect, startPolling, stop and __registerMastra)`,\n      );\n    }\n  }\n  return entries;\n}\n\n/**\n * Structural, not `instanceof`.\n *\n * A plugin that depends on a published provider package — the motivating case, a plugin wrapping\n * `@mastra/github-signals` — installs that package's own copy of `@mastra/core`, so its provider is\n * never an instance of the `SignalProvider` class Mastra Code loaded. `isSignalProvider` would reject\n * a perfectly working provider. Nothing in the lifecycle needs class identity: the lane only calls\n * these methods, so the methods are what is checked.\n */\nfunction isPluginSignalProvider(value: unknown): value is SignalProvider<string> {\n  if (isSignalProvider(value)) return true;\n  if (!value || typeof value !== 'object') return false;\n  const candidate = value as Partial<SignalProvider<string>> & { __registerMastra?: unknown };\n  return (\n    typeof candidate.id === 'string' &&\n    candidate.id.length > 0 &&\n    typeof candidate.connect === 'function' &&\n    typeof candidate.startPolling === 'function' &&\n    typeof candidate.stop === 'function' &&\n    typeof candidate.__registerMastra === 'function'\n  );\n}\n\n/** A bare array is shorthand for the input lane, the common case. */\nfunction normalizePluginProcessorEntries(entries: MastraCodePluginProcessorEntries): LoadedPluginProcessors {\n  const input = Array.isArray(entries) ? entries : (entries.input ?? []);\n  const output = Array.isArray(entries) ? [] : (entries.output ?? []);\n  if (!Array.isArray(input) || !Array.isArray(output)) {\n    throw new Error('Plugin processor lanes must be arrays');\n  }\n  for (const processor of [...input, ...output]) {\n    if (!processor || typeof processor !== 'object' || typeof processor.id !== 'string') {\n      throw new Error('Plugin processors must be objects with an id');\n    }\n  }\n  return { input, output };\n}\n\nasync function resolvePluginInstructions(\n  plugin: MastraCodePlugin,\n  context: MastraCodePluginContext,\n): Promise<string | undefined> {\n  if (plugin.instructions === undefined) return undefined;\n  const instructions =\n    typeof plugin.instructions === 'function' ? await plugin.instructions(context) : plugin.instructions;\n  if (typeof instructions !== 'string') {\n    throw new Error('Plugin instructions must be a string');\n  }\n  const trimmed = instructions.trim();\n  return trimmed.length > 0 ? trimmed : undefined;\n}\n\nfunction normalizePluginToolEntries(entries: MastraCodePluginToolEntries): {\n  tools: MastraCodePluginTools;\n  renderConfigs: Record<string, MastraCodeToolRenderConfig>;\n} {\n  const tools: MastraCodePluginTools = {};\n  const renderConfigs: Record<string, MastraCodeToolRenderConfig> = {};\n  for (const [name, entry] of Object.entries(entries)) {\n    if (!isToolEntryObject(entry)) {\n      throw new Error(`Plugin tool \"${name}\" must be an object with a tool property`);\n    }\n    tools[name] = entry.tool;\n    if (entry.render) renderConfigs[name] = entry.render;\n  }\n  return { tools, renderConfigs };\n}\n\nfunction isToolEntryObject(entry: MastraCodePluginToolEntries[string]): entry is MastraCodePluginToolEntries[string] {\n  if (!entry || typeof entry !== 'object' || !('tool' in entry)) return false;\n  const tool = (entry as { tool?: unknown }).tool;\n  return !!tool && typeof tool === 'object' && !Array.isArray(tool);\n}\n\nfunction validatePluginConfigSchema(schema: unknown): MastraCodePluginConfigSchema | undefined {\n  if (!schema || typeof schema !== 'object' || Array.isArray(schema)) return undefined;\n  const validated: MastraCodePluginConfigSchema = {};\n  for (const [key, option] of Object.entries(schema)) {\n    if (!option || typeof option !== 'object' || Array.isArray(option)) continue;\n    const record = option as Record<string, unknown>;\n    if (record.type !== 'model' && record.type !== 'boolean' && record.type !== 'string') continue;\n    validated[key] = {\n      type: record.type,\n      ...(typeof record.label === 'string' ? { label: record.label } : {}),\n      ...(typeof record.description === 'string' ? { description: record.description } : {}),\n      ...(typeof record.default === 'string' || typeof record.default === 'boolean' ? { default: record.default } : {}),\n    };\n  }\n  return Object.keys(validated).length > 0 ? validated : undefined;\n}\n\nfunction resolvePluginConfigValues(\n  schema: MastraCodePluginConfigSchema | undefined,\n  recordValues: Record<string, unknown> | undefined,\n): MastraCodePluginConfigValues {\n  const values: MastraCodePluginConfigValues = {};\n  if (!schema) return values;\n  for (const [key, option] of Object.entries(schema)) {\n    const value = recordValues?.[key];\n    if (option.type === 'boolean') {\n      values[key] = typeof value === 'boolean' ? value : typeof option.default === 'boolean' ? option.default : false;\n      continue;\n    }\n    values[key] = typeof value === 'string' ? value : typeof option.default === 'string' ? option.default : undefined;\n  }\n  return values;\n}\n\nexport function collectActivePluginTools(plugins: LoadedPlugin[]): MastraCodePluginTools {\n  const tools: MastraCodePluginTools = {};\n  for (const plugin of plugins) {\n    if (plugin.status !== 'active') continue;\n    for (const [name, tool] of Object.entries(plugin.tools)) {\n      if (!(name in tools)) {\n        tools[name] = tool;\n      }\n    }\n  }\n  return tools;\n}\n\nfunction markToolConflicts(plugins: LoadedPlugin[]): LoadedPlugin[] {\n  const seen = new Map<string, string>();\n  return plugins.map(plugin => {\n    if (plugin.status !== 'active') return plugin;\n    const conflicts = plugin.toolNames.filter(toolName => seen.has(toolName));\n    for (const toolName of plugin.toolNames) {\n      if (!seen.has(toolName)) seen.set(toolName, plugin.id);\n    }\n    return conflicts.length > 0 ? { ...plugin, status: 'conflicted', conflicts } : plugin;\n  });\n}\n"],"mappings":"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"}

package/dist/plugins/manager.d.ts

@@ -0,0 +1,98 @@
+import type { SignalProvider } from '@mastra/core/signals';
+import type { MastraCodePluginConfigValue, MastraCodePluginRuntime } from '../plugin.js';
+import { discoverLocalPlugins } from './install.js';
+import type { InstallPluginOptions } from './install.js';
+import type { PluginPathOptions } from './paths.js';
+import type { LoadedPlugin, PluginContribution, PluginProcessorEntries, PluginScope } from './types.js';
+type PluginManagerOptions = PluginPathOptions & {
+    githubCliPath?: string;
+    /**
+     * Lazy accessors for Mastra Code's runtime, handed to plugin field resolvers on
+     * every load and reload.
+     */
+    runtime?: MastraCodePluginRuntime;
+};
+export declare class PluginManager {
+    private readonly options;
+    private loadedPlugins;
+    private readonly pluginTools;
+    private readonly rawPluginTools;
+    private readonly toolRenderConfigs;
+    private readonly watchedLocalEntries;
+    private readonly localEntryVersions;
+    /** Last known git HEAD per GitHub checkout, kept current by the poller. */
+    private readonly githubCheckoutHeads;
+    private githubPollTimer;
+    private githubPollInFlight;
+    private reloadInFlight;
+    private readonly reloadListeners;
+    private readonly githubUpdateListeners;
+    private runtime;
+    constructor(options: PluginManagerOptions);
+    /**
+     * 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: MastraCodePluginRuntime): void;
+    onReload(listener: (plugins: LoadedPlugin[]) => void | Promise<void>): () => void;
+    /** Notified with the display names of GitHub plugins that were updated by the background poll. */
+    onGithubPluginsUpdated(listener: (pluginNames: string[]) => void | Promise<void>): () => void;
+    reload(): Promise<LoadedPlugin[]>;
+    listPlugins(): Promise<LoadedPlugin[]>;
+    getLoadedPlugins(): LoadedPlugin[];
+    getPluginTools(): import("../plugin.js").MastraCodePluginTools;
+    getToolRenderConfig(toolName: string): import("../plugin.js").MastraCodeToolRenderConfig | undefined;
+    getPluginSkillPaths(): string[];
+    getPluginCommandPaths(): string[];
+    getPluginInstructions(): string[];
+    /**
+     * 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(): PluginProcessorEntries;
+    /** Signal providers contributed by active plugins, tagged with their owning plugin. */
+    getPluginSignalProviders(): PluginContribution<SignalProvider<string>>[];
+    private collectActive;
+    private notifyReloadListeners;
+    /**
+     * 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.
+     */
+    private stampLoadedPlugins;
+    private readSourceStamp;
+    private updatePluginRenderConfigs;
+    private updatePluginTools;
+    private createLiveToolProxy;
+    private syncLiveToolProxy;
+    private reloadChangedLocalPlugins;
+    private updateLocalEntryWatchers;
+    private updateGithubPoller;
+    pollGithubSourcesForUpdates(): Promise<boolean>;
+    private pollGithubSourcesForUpdatesOnce;
+    private notifyGithubUpdateListeners;
+    private refreshGithubCheckout;
+    private backupGitCheckout;
+    private resolveGitUpstream;
+    private readGitAheadBehind;
+    private hasGitWorkingTreeChanges;
+    private hasGitStagedChanges;
+    private restoreGitCheckout;
+    private readGitCurrentBranch;
+    private createGitBackupBranchName;
+    private resolvePluginSourcePath;
+    private readGitHead;
+    discoverLocal(searchRoot?: string): ReturnType<typeof discoverLocalPlugins>;
+    installLocal(localPath: string, scope: PluginScope, options?: Pick<InstallPluginOptions, 'entry'>): Promise<string>;
+    installGithub(url: string, scope: PluginScope, options?: Pick<InstallPluginOptions, 'entry' | 'ref' | 'onOutput' | 'signal'>): Promise<string>;
+    setEnabled(pluginId: string, scope: PluginScope, enabled: boolean): Promise<void>;
+    setConfigValue(pluginId: string, scope: PluginScope, key: string, value: MastraCodePluginConfigValue): Promise<void>;
+    uninstall(pluginId: string, scope: PluginScope): Promise<void>;
+}
+export {};
+//# sourceMappingURL=manager.d.ts.map

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

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