@mastra/code-sdk 1.2.0-alpha.1 → 1.2.0-alpha.13

package/dist/plugin.d.ts.map

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

package/dist/plugin.js

@@ -1,5 +1,7 @@
+import { SignalProvider } from "@mastra/core/signals";
 import { createTool } from "@mastra/core/tools";
 import { z } from "zod";
+import { RequestContext } from "@mastra/core/di";
 //#region src/plugin.ts
 async function writeToolProgress(context, progress) {
 	const toolCallId = context?.agent?.toolCallId;
@@ -23,6 +25,6 @@ function defineMastraCodePlugin(plugin) {
 	return plugin;
 }
 //#endregion
-export { createTool, defineMastraCodePlugin, writeToolProgress, z };
+export { RequestContext, SignalProvider, createTool, defineMastraCodePlugin, writeToolProgress, z };
 
 //# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","names":[],"sources":["../src/plugin.ts"],"sourcesContent":["import type { Tool, ToolAction, ToolExecutionContext } from '@mastra/core/tools';\n\nexport { createTool } from '@mastra/core/tools';\nexport type { Tool, ToolAction, ToolExecutionContext } from '@mastra/core/tools';\nexport { z } from 'zod';\n\nexport type MastraCodeToolRenderConfig = {\n  type: 'subagent';\n  agentType?: string;\n  modelId?: string;\n  forked?: boolean;\n  label?: string;\n  maxActivityLines?: number;\n  collapsedLines?: number;\n  colors?: {\n    border?: string;\n    label?: string;\n    agentType?: string;\n    icon?: string;\n  };\n  icons?: {\n    running?: string;\n    success?: string;\n    error?: string;\n  };\n};\n\nexport type MastraCodeSubagentProgress =\n  | {\n      event: 'text';\n      text: string;\n    }\n  | {\n      event: 'tool_start';\n      toolName: string;\n      args?: unknown;\n    }\n  | {\n      event: 'tool_end';\n      toolName: string;\n      result?: unknown;\n      isError?: boolean;\n    }\n  | {\n      event: 'finish';\n      isError?: boolean;\n      durationMs?: number;\n      result?: string;\n    };\n\nexport type MastraCodeToolProgress = string | { status?: string; detail?: string } | MastraCodeSubagentProgress;\n\nexport async function writeToolProgress(\n  context: Pick<ToolExecutionContext, 'writer' | 'agent'> | undefined,\n  progress: MastraCodeToolProgress,\n): Promise<void> {\n  const toolCallId = context?.agent?.toolCallId;\n  if (!toolCallId) return;\n\n  const chunk = {\n    type: 'data-mastracode-tool-progress',\n    data: {\n      toolCallId,\n      progress,\n    },\n    transient: true,\n  } as const;\n\n  const outputWriter = (context.agent as { outputWriter?: (chunk: unknown) => Promise<void> } | undefined)\n    ?.outputWriter;\n  if (outputWriter) {\n    await outputWriter(chunk);\n    return;\n  }\n\n  await context.writer?.custom(chunk);\n}\n\nexport type MastraCodePluginConfigValue = string | boolean | undefined;\n\nexport type MastraCodePluginConfigOption = {\n  type: 'model' | 'boolean' | 'string';\n  label?: string;\n  description?: string;\n  default?: string | boolean;\n};\n\nexport type MastraCodePluginConfigSchema = Record<string, MastraCodePluginConfigOption>;\nexport type MastraCodePluginConfigValues = Record<string, MastraCodePluginConfigValue>;\n\nexport type MastraCodePluginContext = {\n  cwd: string;\n  scope: 'global' | 'project';\n  pluginDir: string;\n  config: MastraCodePluginConfigValues;\n};\n\nexport type MastraCodePluginTool = Tool | ToolAction<any, any, any, any, any, any, any>;\n\nexport type MastraCodePluginToolEntry = {\n  tool: MastraCodePluginTool;\n  render?: MastraCodeToolRenderConfig;\n};\n\nexport type MastraCodePluginTools = Record<string, MastraCodePluginTool>;\nexport type MastraCodePluginToolEntries = Record<string, MastraCodePluginToolEntry>;\nexport type MastraCodePluginInstructions = string | ((context: MastraCodePluginContext) => string | Promise<string>);\n\nexport type MastraCodePlugin = {\n  id: string;\n  name?: string;\n  version?: string;\n  description?: string;\n  config?: MastraCodePluginConfigSchema;\n  instructions?: MastraCodePluginInstructions;\n  tools?:\n    | MastraCodePluginToolEntries\n    | ((context: MastraCodePluginContext) => MastraCodePluginToolEntries | Promise<MastraCodePluginToolEntries>);\n};\n\nexport function defineMastraCodePlugin<TPlugin extends MastraCodePlugin>(plugin: TPlugin): TPlugin {\n  return plugin;\n}\n"],"mappings":";;;AAoDA,eAAsB,kBACpB,SACA,UACe;CACf,MAAM,aAAa,SAAS,OAAO;CACnC,IAAI,CAAC,YAAY;CAEjB,MAAM,QAAQ;EACZ,MAAM;EACN,MAAM;GACJ;GACA;EACF;EACA,WAAW;CACb;CAEA,MAAM,eAAgB,QAAQ,OAC1B;CACJ,IAAI,cAAc;EAChB,MAAM,aAAa,KAAK;EACxB;CACF;CAEA,MAAM,QAAQ,QAAQ,OAAO,KAAK;AACpC;AA4CA,SAAgB,uBAAyD,QAA0B;CACjG,OAAO;AACT"}
+{"version":3,"file":"plugin.js","names":[],"sources":["../src/plugin.ts"],"sourcesContent":["import type { AgentController, Session } from '@mastra/core/agent-controller';\nimport type { InputProcessor, OutputProcessor } from '@mastra/core/processors';\nimport type { SignalProvider } from '@mastra/core/signals';\nimport type { Tool, ToolAction, ToolExecutionContext } from '@mastra/core/tools';\n\nimport type { MastraCodeState } from './schema.js';\n\nexport { createTool } from '@mastra/core/tools';\nexport { RequestContext } from '@mastra/core/di';\nexport type { InputProcessor, OutputProcessor } from '@mastra/core/processors';\nexport { SignalProvider } from '@mastra/core/signals';\nexport type { SignalProviderTarget, SignalSubscription } from '@mastra/core/signals';\nexport type { Tool, ToolAction, ToolExecutionContext } from '@mastra/core/tools';\nexport { z } from 'zod';\n\nexport type MastraCodeToolRenderConfig = {\n  type: 'subagent';\n  agentType?: string;\n  modelId?: string;\n  forked?: boolean;\n  label?: string;\n  maxActivityLines?: number;\n  collapsedLines?: number;\n  colors?: {\n    border?: string;\n    label?: string;\n    agentType?: string;\n    icon?: string;\n  };\n  icons?: {\n    running?: string;\n    success?: string;\n    error?: string;\n  };\n};\n\nexport type MastraCodeSubagentProgress =\n  | {\n      event: 'text';\n      text: string;\n    }\n  | {\n      event: 'tool_start';\n      toolName: string;\n      args?: unknown;\n    }\n  | {\n      event: 'tool_end';\n      toolName: string;\n      result?: unknown;\n      isError?: boolean;\n    }\n  | {\n      event: 'finish';\n      isError?: boolean;\n      durationMs?: number;\n      result?: string;\n    };\n\nexport type MastraCodeToolProgress = string | { status?: string; detail?: string } | MastraCodeSubagentProgress;\n\nexport async function writeToolProgress(\n  context: Pick<ToolExecutionContext, 'writer' | 'agent'> | undefined,\n  progress: MastraCodeToolProgress,\n): Promise<void> {\n  const toolCallId = context?.agent?.toolCallId;\n  if (!toolCallId) return;\n\n  const chunk = {\n    type: 'data-mastracode-tool-progress',\n    data: {\n      toolCallId,\n      progress,\n    },\n    transient: true,\n  } as const;\n\n  const outputWriter = (context.agent as { outputWriter?: (chunk: unknown) => Promise<void> } | undefined)\n    ?.outputWriter;\n  if (outputWriter) {\n    await outputWriter(chunk);\n    return;\n  }\n\n  await context.writer?.custom(chunk);\n}\n\nexport type MastraCodePluginConfigValue = string | boolean | undefined;\n\nexport type MastraCodePluginConfigOption = {\n  type: 'model' | 'boolean' | 'string';\n  label?: string;\n  description?: string;\n  default?: string | boolean;\n};\n\nexport type MastraCodePluginConfigSchema = Record<string, MastraCodePluginConfigOption>;\nexport type MastraCodePluginConfigValues = Record<string, MastraCodePluginConfigValue>;\n\n/** The running Mastra Code controller, as seen by a plugin. */\nexport type MastraCodePluginController = AgentController<MastraCodeState>;\n\n/** The session a plugin's contributions are running alongside. */\nexport type MastraCodePluginSession = Session<MastraCodeState>;\n\n/**\n * Lazy accessors for Mastra Code's runtime, handed to every plugin field resolver.\n *\n * Plugins are loaded before the controller and the session exist, so these are\n * accessors rather than instances: call them at the moment you need the value,\n * never during plugin load. Both return `undefined` until Mastra Code has\n * constructed the corresponding object.\n *\n * @experimental This is an evolving runtime API. It currently exposes the whole\n * controller so real plugins can be built against it; once we know what plugin\n * authors actually reach for, it may narrow to a smaller facade in a future\n * release.\n */\nexport type MastraCodePluginRuntime = {\n  /**\n   * The running controller, or `undefined` when it does not exist yet.\n   * @experimental see {@link MastraCodePluginRuntime}\n   */\n  getController?: () => MastraCodePluginController | undefined;\n  /**\n   * The active session, or `undefined` before one has been created.\n   * @experimental see {@link MastraCodePluginRuntime}\n   */\n  getActiveSession?: () => MastraCodePluginSession | undefined;\n};\n\nexport type MastraCodePluginContext = MastraCodePluginRuntime & {\n  cwd: string;\n  scope: 'global' | 'project';\n  pluginDir: string;\n  config: MastraCodePluginConfigValues;\n};\n\nexport type MastraCodePluginTool = Tool | ToolAction<any, any, any, any, any, any, any>;\n\nexport type MastraCodePluginToolEntry = {\n  tool: MastraCodePluginTool;\n  render?: MastraCodeToolRenderConfig;\n};\n\nexport type MastraCodePluginTools = Record<string, MastraCodePluginTool>;\nexport type MastraCodePluginToolEntries = Record<string, MastraCodePluginToolEntry>;\nexport type MastraCodePluginInstructions = string | ((context: MastraCodePluginContext) => string | Promise<string>);\n\n/**\n * Processors a plugin contributes, split by lane.\n *\n * A bare array is shorthand for `{ input: [...] }`, since input processors are\n * the common case. Plugin processors run last in Mastra Code's own configured\n * processors — after the layers they customize, before the channel and memory\n * layers the agent appends. That slot is fixed and not configurable.\n */\nexport type MastraCodePluginProcessorEntries =\n  | InputProcessor[]\n  | {\n      input?: InputProcessor[];\n      output?: OutputProcessor[];\n    };\n\n/**\n * Signal providers a plugin contributes.\n *\n * Mastra Code owns their lifecycle: it registers Mastra on them, connects them\n * to the coding agent, starts them polling, and stops them when the plugin is\n * updated, disabled or removed. Their `getInputProcessors()` /\n * `getOutputProcessors()` feed the same lanes as {@link MastraCodePluginProcessorEntries}.\n *\n * Note that `getTools()` is **ignored** for plugin-provided providers — inject\n * tools from inside a processor instead.\n */\nexport type MastraCodePluginSignalProviderEntries = SignalProvider<string>[];\n\nexport type MastraCodePlugin = {\n  id: string;\n  name?: string;\n  version?: string;\n  description?: string;\n  config?: MastraCodePluginConfigSchema;\n  instructions?: MastraCodePluginInstructions;\n  tools?:\n    | MastraCodePluginToolEntries\n    | ((context: MastraCodePluginContext) => MastraCodePluginToolEntries | Promise<MastraCodePluginToolEntries>);\n  processors?:\n    | MastraCodePluginProcessorEntries\n    | ((\n        context: MastraCodePluginContext,\n      ) => MastraCodePluginProcessorEntries | Promise<MastraCodePluginProcessorEntries>);\n  signalProviders?:\n    | MastraCodePluginSignalProviderEntries\n    | ((\n        context: MastraCodePluginContext,\n      ) => MastraCodePluginSignalProviderEntries | Promise<MastraCodePluginSignalProviderEntries>);\n};\n\nexport function defineMastraCodePlugin<TPlugin extends MastraCodePlugin>(plugin: TPlugin): TPlugin {\n  return plugin;\n}\n"],"mappings":";;;;;AA6DA,eAAsB,kBACpB,SACA,UACe;CACf,MAAM,aAAa,SAAS,OAAO;CACnC,IAAI,CAAC,YAAY;CAEjB,MAAM,QAAQ;EACZ,MAAM;EACN,MAAM;GACJ;GACA;EACF;EACA,WAAW;CACb;CAEA,MAAM,eAAgB,QAAQ,OAC1B;CACJ,IAAI,cAAc;EAChB,MAAM,aAAa,KAAK;EACxB;CACF;CAEA,MAAM,QAAQ,QAAQ,OAAO,KAAK;AACpC;AAkHA,SAAgB,uBAAyD,QAA0B;CACjG,OAAO;AACT"}

package/dist/plugins/loader.d.ts

@@ -1,12 +1,16 @@
-import type { MastraCodePlugin, MastraCodePluginTools } from '../plugin.js';
+import type { MastraCodePlugin, MastraCodePluginRuntime, MastraCodePluginTools } from '../plugin.js';
 import type { PluginPathOptions } from './paths.js';
 import type { LoadedPlugin, PluginRegistry, ScopedInstalledPluginRecord } from './types.js';
-export type LoadPluginsOptions = PluginPathOptions & {
+export type LoadPluginRecordOptions = PluginPathOptions & {
+    /** Lazy accessors for Mastra Code's runtime, passed on to plugin field resolvers. */
+    runtime?: MastraCodePluginRuntime;
+};
+export type LoadPluginsOptions = LoadPluginRecordOptions & {
     globalRegistry?: PluginRegistry;
     projectRegistry?: PluginRegistry;
 };
 export declare function loadPlugins(options: LoadPluginsOptions): Promise<LoadedPlugin[]>;
-export declare function loadPluginRecord(record: ScopedInstalledPluginRecord, options: PluginPathOptions): Promise<LoadedPlugin>;
+export declare function loadPluginRecord(record: ScopedInstalledPluginRecord, options: LoadPluginRecordOptions): Promise<LoadedPlugin>;
 export declare function loadPluginFromEntry(entryPath: string): Promise<MastraCodePlugin>;
 export declare function resolvePluginRoot(record: ScopedInstalledPluginRecord, options: PluginPathOptions): string;
 export declare function resolvePluginEntryPath(record: ScopedInstalledPluginRecord, options: PluginPathOptions): string;

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

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,gBAAgB,EAKhB,qBAAqB,EAEtB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAE5F,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GAAG;IACnD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,eAAe,CAAC,EAAE,cAAc,CAAC;CAClC,CAAC;AAEF,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAsBtF;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,2BAA2B,EACnC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,YAAY,CAAC,CA6CvB;AAED,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAEtF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,2BAA2B,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAOzG;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,2BAA2B,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAO9G;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAI3E;AA6HD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,qBAAqB,CAWvF"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,gBAAgB,EAKhB,uBAAuB,EAGvB,qBAAqB,EAEtB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAA0B,cAAc,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAEpH,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,GAAG;IACxD,qFAAqF;IACrF,OAAO,CAAC,EAAE,uBAAuB,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,uBAAuB,GAAG;IACzD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,eAAe,CAAC,EAAE,cAAc,CAAC;CAClC,CAAC;AAEF,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAsBtF;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,2BAA2B,EACnC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,YAAY,CAAC,CAqDvB;AAED,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAEtF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,2BAA2B,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAOzG;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,2BAA2B,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAO9G;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAI3E;AAoND,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,qBAAqB,CAWvF"}

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();
 	}