@mastra/code-sdk 1.2.0-alpha.10 → 1.2.0-alpha.14

package/dist/plugins/loader.js

@@ -1,5 +1,6 @@
 import { getPluginRoot } from "./paths.js";
 import { loadPluginRegistry, mergePluginRegistries } from "./registry.js";
+import { isSignalProvider } from "@mastra/core/signals";
 import fs from "fs";
 import path from "path";
 import { pathToFileURL } from "url";
@@ -43,9 +44,13 @@ async function loadPluginRecord(record, options) {
 			cwd: options.projectRoot,
 			scope: record.scope,
 			pluginDir,
-			config: configValues
+			config: configValues,
+			getController: options.runtime?.getController,
+			getActiveSession: options.runtime?.getActiveSession
 		};
 		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,
@@ -57,6 +62,8 @@ async function loadPluginRecord(record, options) {
 			tools,
 			renderConfigs,
 			toolNames: Object.keys(tools).sort(),
+			processors,
+			signalProviders,
 			skillPaths: resolveExistingAssetDirs(pluginRoot, "skills"),
 			commandPaths: resolveExistingAssetDirs(pluginRoot, "commands"),
 			configSchema,
@@ -114,6 +121,8 @@ function validatePluginExport(value) {
 	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) {
@@ -125,6 +134,49 @@ async function resolvePluginTools(plugin, context) {
 	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;

package/dist/plugins/loader.js.map

@@ -1 +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 type {\n  MastraCodePlugin,\n  MastraCodePluginConfigSchema,\n  MastraCodePluginConfigValues,\n  MastraCodePluginContext,\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, PluginRegistry, ScopedInstalledPluginRecord } from './types.js';\n\nexport type LoadPluginsOptions = PluginPathOptions & {\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: PluginPathOptions,\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    };\n    const { tools, renderConfigs } = await resolvePluginTools(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      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 stat = fs.statSync(entryPath, { bigint: true });\n  url.searchParams.set('mtimeNs', stat.mtimeNs.toString());\n  url.searchParams.set('size', stat.size.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  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\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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"}
+{"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    };\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 stat = fs.statSync(entryPath, { bigint: true });\n  url.searchParams.set('mtimeNs', stat.mtimeNs.toString());\n  url.searchParams.set('size', stat.size.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

@@ -1,10 +1,16 @@
-import type { MastraCodePluginConfigValue } from '../plugin.js';
+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, PluginScope } from './types.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;
@@ -14,12 +20,23 @@ export declare class PluginManager {
     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;
@@ -31,7 +48,24 @@ export declare class PluginManager {
     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;

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

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

package/dist/plugins/manager.js

@@ -27,13 +27,27 @@ var PluginManager = class {
 	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);
@@ -47,7 +61,11 @@ var PluginManager = class {
 	async reload() {
 		if (this.reloadInFlight) return this.reloadInFlight;
 		this.reloadInFlight = (async () => {
-			this.loadedPlugins = await loadPlugins(this.options);
+			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);
@@ -81,9 +99,60 @@ var PluginManager = class {
 	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) {
@@ -188,6 +257,7 @@ var PluginManager = class {
 			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;
@@ -311,7 +381,7 @@ var PluginManager = class {
 	}
 	resolvePluginSourcePath(plugin) {
 		const paths = getPluginScopePaths(plugin.scope, this.options);
-		return path.isAbsolute(plugin.path) ? plugin.path : path.join(paths.root, plugin.path);
+		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));
@@ -333,6 +403,7 @@ var PluginManager = class {
 			...this.options,
 			...options
 		});
+		this.githubCheckoutHeads.clear();
 		await this.reload();
 		return id;
 	}
@@ -374,6 +445,7 @@ var PluginManager = class {
 				recursive: true,
 				force: true
 			});
+			this.githubCheckoutHeads.delete(checkoutPath);
 		}
 		await this.reload();
 	}

package/dist/plugins/manager.js.map

@@ -1 +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 { execa } from 'execa';\n\nimport type { MastraCodePluginConfigValue } 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, 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\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  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\n  constructor(private readonly options: PluginManagerOptions) {}\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);\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  private async notifyReloadListeners(plugins: LoadedPlugin[]): Promise<void> {\n    await Promise.all([...this.reloadListeners].map(listener => Promise.resolve(listener(plugins))));\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      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    return 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    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    }\n    await this.reload();\n  }\n}\n"],"mappings":"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"}
+{"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/signal-lane.d.ts

@@ -0,0 +1,58 @@
+import type { Agent } from '@mastra/core/agent';
+import type { Mastra } from '@mastra/core/mastra';
+import type { InputProcessorOrWorkflow, OutputProcessorOrWorkflow } from '@mastra/core/processors';
+import type { SignalProvider } from '@mastra/core/signals';
+import type { PluginContribution } from './types.js';
+export type PluginSignalLaneOptions = {
+    /**
+     * Ids of providers Mastra Code wires itself (through the Agent constructor).
+     * The lane refuses to start a provider that collides with one of them:
+     * two live instances of the same provider silently clobber each other's
+     * polling, and the built-ins are invisible to the lane's own registry.
+     */
+    reservedProviderIds?: string[];
+    onError?: (message: string, error: unknown) => void;
+};
+/**
+ * Owns the lifecycle of signal providers contributed by plugins.
+ *
+ * Providers are long-lived; processors are per-request. The Agent constructor
+ * conflates the two — it harvests a provider's processors into a closure that
+ * can never be undone — so plugin providers are deliberately kept out of the
+ * `signals` array and driven from here instead, through the same public methods
+ * the constructor uses. That is what makes a provider removable when its plugin
+ * is disabled, updated or uninstalled.
+ */
+export declare class PluginSignalLane {
+    #private;
+    constructor(options?: PluginSignalLaneOptions);
+    getInputProcessors(): readonly InputProcessorOrWorkflow[];
+    getOutputProcessors(): readonly OutputProcessorOrWorkflow[];
+    /**
+     * Reconciles the live providers against a freshly loaded plugin list.
+     *
+     * A plugin whose stamp is unchanged keeps the provider instance it already
+     * has, and the freshly resolved one is dropped without ever being registered,
+     * connected or polled — reload re-runs every plugin's resolver, so unchanged
+     * plugins hand over new instances on every call.
+     *
+     * Providers of plugins that went inactive, failed to load or were uninstalled
+     * are absent from the contributions and get stopped here.
+     */
+    sync(contributions: PluginContribution<SignalProvider<string>>[]): void;
+    /**
+     * Called once Mastra exists. Providers resolved before then are registered and
+     * started here — without a Mastra instance a provider has no storage, and
+     * nothing else will ever hand it one: the Agent propagates Mastra only to the
+     * providers in its own `signals` array, which these deliberately are not in.
+     */
+    setMastra(mastra: Mastra, agent: Agent): void;
+    /**
+     * Retires every live provider and empties both processor lanes. The inverse of
+     * `sync()`, for a caller that is done with this lane — an embedder sharing one
+     * `PluginManager` across controllers would otherwise leave a controller's
+     * providers polling after it is gone.
+     */
+    stopAll(): void;
+}
+//# sourceMappingURL=signal-lane.d.ts.map

package/dist/plugins/signal-lane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-lane.d.ts","sourceRoot":"","sources":["../../src/plugins/signal-lane.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACnG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AASrD,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrD,CAAC;AAEF;;;;;;;;;GASG;AACH,qBAAa,gBAAgB;;gBAYf,OAAO,GAAE,uBAA4B;IASjD,kBAAkB,IAAI,SAAS,wBAAwB,EAAE;IAIzD,mBAAmB,IAAI,SAAS,yBAAyB,EAAE;IAI3D;;;;;;;;;;OAUG;IACH,IAAI,CAAC,aAAa,EAAE,kBAAkB,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,IAAI;IA+BvE;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAO7C;;;;;OAKG;IACH,OAAO,IAAI,IAAI;CAyGhB"}