@mastra/code-sdk 0.0.0-client-tool-results-20260912062135

package/dist/plugins/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","names":[],"sources":["../../src/plugins/loader.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { pathToFileURL } from 'node:url';\n\nimport { isSignalProvider } from '@mastra/core/signals';\nimport type { SignalProvider } from '@mastra/core/signals';\n\nimport type {\n  MastraCodePlugin,\n  MastraCodePluginConfigSchema,\n  MastraCodePluginConfigValues,\n  MastraCodePluginContext,\n  MastraCodePluginProcessorEntries,\n  MastraCodePluginRuntime,\n  MastraCodePluginSignalProviderEntries,\n  MastraCodePluginToolEntries,\n  MastraCodePluginTools,\n  MastraCodeToolRenderConfig,\n} from '../plugin.js';\nimport { getPluginRoot } from './paths.js';\nimport type { PluginPathOptions } from './paths.js';\nimport { loadPluginRegistry, mergePluginRegistries } from './registry.js';\nimport type { LoadedPlugin, LoadedPluginProcessors, PluginRegistry, ScopedInstalledPluginRecord } from './types.js';\n\nexport type LoadPluginRecordOptions = PluginPathOptions & {\n  /** Lazy accessors for Mastra Code's runtime, passed on to plugin field resolvers. */\n  runtime?: MastraCodePluginRuntime;\n};\n\nexport type LoadPluginsOptions = LoadPluginRecordOptions & {\n  globalRegistry?: PluginRegistry;\n  projectRegistry?: PluginRegistry;\n};\n\nexport async function loadPlugins(options: LoadPluginsOptions): Promise<LoadedPlugin[]> {\n  const globalRegistry =\n    options.globalRegistry ?? loadPluginRegistry(path.join(getPluginRoot('global', options), 'plugins.json'));\n  const projectRegistry =\n    options.projectRegistry ?? loadPluginRegistry(path.join(getPluginRoot('project', options), 'plugins.json'));\n  const records = mergePluginRegistries(globalRegistry, projectRegistry);\n  const loaded: LoadedPlugin[] = [];\n\n  for (const record of records) {\n    if (record.blocked) {\n      loaded.push({ ...record, status: 'blocked', tools: {}, toolNames: [] });\n      continue;\n    }\n    if (!record.enabled) {\n      loaded.push({ ...record, status: 'inactive', tools: {}, toolNames: [] });\n      continue;\n    }\n\n    loaded.push(await loadPluginRecord(record, options));\n  }\n\n  return markToolConflicts(loaded);\n}\n\nexport async function loadPluginRecord(\n  record: ScopedInstalledPluginRecord,\n  options: LoadPluginRecordOptions,\n): Promise<LoadedPlugin> {\n  try {\n    const entryPath = resolvePluginEntryPath(record, options);\n    const plugin = await importPluginModule(entryPath);\n    if (plugin.id !== record.id) {\n      throw new Error(`Plugin id mismatch: registry has \"${record.id}\" but module exports \"${plugin.id}\"`);\n    }\n\n    const configSchema = validatePluginConfigSchema(plugin.config);\n    const configValues = resolvePluginConfigValues(configSchema, record.config);\n    const pluginDir = path.dirname(entryPath);\n    const pluginRoot = resolvePluginRoot(record, options);\n    const context: MastraCodePluginContext = {\n      cwd: options.projectRoot,\n      scope: record.scope,\n      pluginDir,\n      config: configValues,\n      // Accessors, not instances: plugins load before the controller and the\n      // session exist, so a plugin resolves these when it needs them, not now.\n      getController: options.runtime?.getController,\n      getActiveSession: options.runtime?.getActiveSession,\n    };\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

@@ -0,0 +1,98 @@
+import type { SignalProvider } from '@mastra/core/signals';
+import type { MastraCodePluginConfigValue, MastraCodePluginRuntime } from '../plugin.js';
+import { discoverLocalPlugins } from './install.js';
+import type { InstallPluginOptions } from './install.js';
+import type { PluginPathOptions } from './paths.js';
+import type { LoadedPlugin, PluginContribution, PluginProcessorEntries, PluginScope } from './types.js';
+type PluginManagerOptions = PluginPathOptions & {
+    githubCliPath?: string;
+    /**
+     * Lazy accessors for Mastra Code's runtime, handed to plugin field resolvers on
+     * every load and reload.
+     */
+    runtime?: MastraCodePluginRuntime;
+};
+export declare class PluginManager {
+    private readonly options;
+    private loadedPlugins;
+    private readonly pluginTools;
+    private readonly rawPluginTools;
+    private readonly toolRenderConfigs;
+    private readonly watchedLocalEntries;
+    private readonly localEntryVersions;
+    /** Last known git HEAD per GitHub checkout, kept current by the poller. */
+    private readonly githubCheckoutHeads;
+    private githubPollTimer;
+    private githubPollInFlight;
+    private reloadInFlight;
+    private readonly reloadListeners;
+    private readonly githubUpdateListeners;
+    private runtime;
+    constructor(options: PluginManagerOptions);
+    /**
+     * Publish (or replace) the runtime accessors handed to plugin field resolvers.
+     * Takes effect on the next load or reload. `createMastraCode` calls this for
+     * every manager it uses — including an injected one — so a manager constructed
+     * without a runtime still exposes `getController`/`getActiveSession` to plugins.
+     * A manager shared across controllers sees the most recent controller's accessors.
+     */
+    setRuntime(runtime: MastraCodePluginRuntime): void;
+    onReload(listener: (plugins: LoadedPlugin[]) => void | Promise<void>): () => void;
+    /** Notified with the display names of GitHub plugins that were updated by the background poll. */
+    onGithubPluginsUpdated(listener: (pluginNames: string[]) => void | Promise<void>): () => void;
+    reload(): Promise<LoadedPlugin[]>;
+    listPlugins(): Promise<LoadedPlugin[]>;
+    getLoadedPlugins(): LoadedPlugin[];
+    getPluginTools(): import("../plugin.js").MastraCodePluginTools;
+    getToolRenderConfig(toolName: string): import("../plugin.js").MastraCodeToolRenderConfig | undefined;
+    getPluginSkillPaths(): string[];
+    getPluginCommandPaths(): string[];
+    getPluginInstructions(): string[];
+    /**
+     * Processors contributed by active plugins, tagged with the plugin that owns
+     * each one. Reads already-resolved state — no filesystem access — because the
+     * agent's processor lanes call this before every request.
+     */
+    getPluginProcessors(): PluginProcessorEntries;
+    /** Signal providers contributed by active plugins, tagged with their owning plugin. */
+    getPluginSignalProviders(): PluginContribution<SignalProvider<string>>[];
+    private collectActive;
+    private notifyReloadListeners;
+    /**
+     * Stamps each plugin with a value that changes when its contributions should
+     * be rebuilt. Runs on every reload, so it stays off the network: GitHub heads
+     * come from the cache the poller keeps current and cost one `git rev-parse`
+     * per checkout the first time it is seen.
+     */
+    private stampLoadedPlugins;
+    private readSourceStamp;
+    private updatePluginRenderConfigs;
+    private updatePluginTools;
+    private createLiveToolProxy;
+    private syncLiveToolProxy;
+    private reloadChangedLocalPlugins;
+    private updateLocalEntryWatchers;
+    private updateGithubPoller;
+    pollGithubSourcesForUpdates(): Promise<boolean>;
+    private pollGithubSourcesForUpdatesOnce;
+    private notifyGithubUpdateListeners;
+    private refreshGithubCheckout;
+    private backupGitCheckout;
+    private resolveGitUpstream;
+    private readGitAheadBehind;
+    private hasGitWorkingTreeChanges;
+    private hasGitStagedChanges;
+    private restoreGitCheckout;
+    private readGitCurrentBranch;
+    private createGitBackupBranchName;
+    private resolvePluginSourcePath;
+    private readGitHead;
+    discoverLocal(searchRoot?: string): ReturnType<typeof discoverLocalPlugins>;
+    installLocal(localPath: string, scope: PluginScope, options?: Pick<InstallPluginOptions, 'entry'>): Promise<string>;
+    installGithub(url: string, scope: PluginScope, options?: Pick<InstallPluginOptions, 'entry' | 'ref' | 'onOutput' | 'signal'>): Promise<string>;
+    setEnabled(pluginId: string, scope: PluginScope, enabled: boolean): Promise<void>;
+    setConfigValue(pluginId: string, scope: PluginScope, key: string, value: MastraCodePluginConfigValue): Promise<void>;
+    uninstall(pluginId: string, scope: PluginScope): Promise<void>;
+}
+export {};
+//# sourceMappingURL=manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/plugins/manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,KAAK,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEzF,OAAO,EAAE,oBAAoB,EAAoE,MAAM,cAAc,CAAC;AACtH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAIzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAaxG,KAAK,oBAAoB,GAAG,iBAAiB,GAAG;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,uBAAuB,CAAC;CACnC,CAAC;AAEF,qBAAa,aAAa;IAgBZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAfpC,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmD;IAC/E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmD;IAClF,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAyE;IAC3G,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;IACzD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA6B;IAChE,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA6B;IACjE,OAAO,CAAC,eAAe,CAA6C;IACpE,OAAO,CAAC,kBAAkB,CAA+B;IACzD,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgE;IAChG,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA8D;IACpG,OAAO,CAAC,OAAO,CAAsC;gBAExB,OAAO,EAAE,oBAAoB;IAI1D;;;;;;OAMG;IACH,UAAU,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAIlD,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI;IAKjF,kGAAkG;IAClG,sBAAsB,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI;IAKvF,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAmBjC,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAO5C,gBAAgB,IAAI,YAAY,EAAE;IAIlC,cAAc;IAId,mBAAmB,CAAC,QAAQ,EAAE,MAAM;IAIpC,mBAAmB,IAAI,MAAM,EAAE;IAI/B,qBAAqB,IAAI,MAAM,EAAE;IAIjC,qBAAqB,IAAI,MAAM,EAAE;IAMjC;;;;OAIG;IACH,mBAAmB,IAAI,sBAAsB;IAO7C,uFAAuF;IACvF,wBAAwB,IAAI,kBAAkB,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAAE;IAIxE,OAAO,CAAC,aAAa;YAQP,qBAAqB;IAInC;;;;;OAKG;YACW,kBAAkB;YAUlB,eAAe;IAmB7B,OAAO,CAAC,yBAAyB;IAYjC,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,iBAAiB;YAWX,yBAAyB;IAYvC,OAAO,CAAC,wBAAwB;IAgChC,OAAO,CAAC,kBAAkB;IAgBpB,2BAA2B,IAAI,OAAO,CAAC,OAAO,CAAC;YAQvC,+BAA+B;YAoC/B,2BAA2B;YAI3B,qBAAqB;YA8BrB,iBAAiB;YAkCjB,kBAAkB;YAalB,kBAAkB;YAUlB,wBAAwB;YAKxB,mBAAmB;YASnB,kBAAkB;YAQlB,oBAAoB;IAMlC,OAAO,CAAC,yBAAyB;IAKjC,OAAO,CAAC,uBAAuB;YAOjB,WAAW;IAKzB,aAAa,CAAC,UAAU,SAAM,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC;IAIlE,YAAY,CAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAM,GAChD,OAAO,CAAC,MAAM,CAAC;IAMZ,aAAa,CACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,OAAO,GAAG,KAAK,GAAG,UAAU,GAAG,QAAQ,CAAM,GAChF,OAAO,CAAC,MAAM,CAAC;IAUZ,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjF,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,IAAI,CAAC;IAkBV,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAqBrE"}

package/dist/plugins/manager.js

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