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

package/dist/plugins/package-link.js

@@ -0,0 +1,61 @@
+import path from "path";
+import fs from "fs";
+import { fileURLToPath } from "url";
+//#region src/plugins/package-link.ts
+const MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));
+let cachedPackageRoot;
+function mastraCodePackageRoot() {
+	if (cachedPackageRoot === void 0) try {
+		cachedPackageRoot = findMastraCodePackageRoot(MODULE_DIR);
+	} catch (error) {
+		const entryScript = process.argv[1];
+		if (!entryScript) throw error;
+		cachedPackageRoot = findMastraCodePackageRoot(path.dirname(fs.realpathSync(entryScript)));
+	}
+	return cachedPackageRoot;
+}
+function readPackageName(dir) {
+	const packageJsonPath = path.join(dir, "package.json");
+	if (!fs.existsSync(packageJsonPath)) return void 0;
+	return JSON.parse(fs.readFileSync(packageJsonPath, "utf8")).name;
+}
+function findMastraCodePackageRoot(startDir) {
+	let currentDir = path.resolve(startDir);
+	while (true) {
+		const packageName = readPackageName(currentDir);
+		if (packageName === "mastracode") return currentDir;
+		if (packageName === "@mastra/code-sdk") {
+			for (const candidate of [path.resolve(currentDir, "..", "tui"), path.resolve(currentDir, "..", "..", "mastracode")]) if (readPackageName(candidate) === "mastracode") return candidate;
+		}
+		const parentDir = path.dirname(currentDir);
+		if (parentDir === currentDir) throw new Error(`Could not find mastracode package root from ${startDir}`);
+		currentDir = parentDir;
+	}
+}
+function ensureMastraCodePackageLink(pluginDir) {
+	if (declaresInstallableMastraCodeDependency(pluginDir)) return;
+	const packageRoot = mastraCodePackageRoot();
+	const nodeModulesDir = path.join(pluginDir, "node_modules");
+	const linkPath = path.join(nodeModulesDir, "mastracode");
+	try {
+		if (fs.realpathSync(linkPath) === fs.realpathSync(packageRoot)) return;
+		fs.rmSync(linkPath, {
+			recursive: true,
+			force: true
+		});
+	} catch (error) {
+		if (error.code !== "ENOENT") throw error;
+	}
+	fs.mkdirSync(nodeModulesDir, { recursive: true });
+	fs.symlinkSync(packageRoot, linkPath, "dir");
+}
+function declaresInstallableMastraCodeDependency(pluginDir) {
+	const packageJsonPath = path.join(pluginDir, "package.json");
+	if (!fs.existsSync(packageJsonPath)) return false;
+	const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+	return Boolean(packageJson.dependencies?.mastracode ?? packageJson.devDependencies?.mastracode ?? packageJson.optionalDependencies?.mastracode);
+}
+//#endregion
+export { ensureMastraCodePackageLink, findMastraCodePackageRoot };
+
+//# sourceMappingURL=package-link.js.map

package/dist/plugins/package-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-link.js","names":[],"sources":["../../src/plugins/package-link.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nconst MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));\n\nlet cachedPackageRoot: string | undefined;\n\n// This module ships in @mastra/code-sdk, so the `mastracode` package root is\n// resolved lazily: from the module location (source tree / bundled dist), or —\n// for the published CLI where the sdk is an external dependency — from the\n// entry script, which lives inside the `mastracode` package.\nfunction mastraCodePackageRoot(): string {\n  if (cachedPackageRoot === undefined) {\n    try {\n      cachedPackageRoot = findMastraCodePackageRoot(MODULE_DIR);\n    } catch (error) {\n      const entryScript = process.argv[1];\n      if (!entryScript) throw error;\n      cachedPackageRoot = findMastraCodePackageRoot(path.dirname(fs.realpathSync(entryScript)));\n    }\n  }\n  return cachedPackageRoot;\n}\n\nfunction readPackageName(dir: string): string | undefined {\n  const packageJsonPath = path.join(dir, 'package.json');\n  if (!fs.existsSync(packageJsonPath)) return undefined;\n  return (JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')) as { name?: string }).name;\n}\n\nexport function findMastraCodePackageRoot(startDir: string): string {\n  let currentDir = path.resolve(startDir);\n\n  while (true) {\n    const packageName = readPackageName(currentDir);\n    if (packageName === 'mastracode') {\n      return currentDir;\n    }\n    if (packageName === '@mastra/code-sdk') {\n      // The `mastracode` package sits next to the sdk: mastracode/sdk ↔\n      // mastracode/tui in the source tree, node_modules/@mastra/code-sdk ↔\n      // node_modules/mastracode when installed.\n      for (const candidate of [\n        path.resolve(currentDir, '..', 'tui'),\n        path.resolve(currentDir, '..', '..', 'mastracode'),\n      ]) {\n        if (readPackageName(candidate) === 'mastracode') {\n          return candidate;\n        }\n      }\n    }\n\n    const parentDir = path.dirname(currentDir);\n    if (parentDir === currentDir) {\n      throw new Error(`Could not find mastracode package root from ${startDir}`);\n    }\n    currentDir = parentDir;\n  }\n}\n\nexport function ensureMastraCodePackageLink(pluginDir: string): void {\n  if (declaresInstallableMastraCodeDependency(pluginDir)) {\n    return;\n  }\n\n  const packageRoot = mastraCodePackageRoot();\n  const nodeModulesDir = path.join(pluginDir, 'node_modules');\n  const linkPath = path.join(nodeModulesDir, 'mastracode');\n  try {\n    if (fs.realpathSync(linkPath) === fs.realpathSync(packageRoot)) {\n      return;\n    }\n    fs.rmSync(linkPath, { recursive: true, force: true });\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error;\n  }\n\n  fs.mkdirSync(nodeModulesDir, { recursive: true });\n  fs.symlinkSync(packageRoot, linkPath, 'dir');\n}\n\nfunction declaresInstallableMastraCodeDependency(pluginDir: string): boolean {\n  const packageJsonPath = path.join(pluginDir, 'package.json');\n  if (!fs.existsSync(packageJsonPath)) return false;\n\n  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')) as {\n    dependencies?: Record<string, unknown>;\n    devDependencies?: Record<string, unknown>;\n    optionalDependencies?: Record<string, unknown>;\n  };\n\n  return Boolean(\n    packageJson.dependencies?.mastracode ??\n    packageJson.devDependencies?.mastracode ??\n    packageJson.optionalDependencies?.mastracode,\n  );\n}\n"],"mappings":";;;;AAIA,MAAM,aAAa,KAAK,QAAQ,cAAc,OAAO,KAAK,GAAG,CAAC;AAE9D,IAAI;AAMJ,SAAS,wBAAgC;CACvC,IAAI,sBAAsB,KAAA,GACxB,IAAI;EACF,oBAAoB,0BAA0B,UAAU;CAC1D,SAAS,OAAO;EACd,MAAM,cAAc,QAAQ,KAAK;EACjC,IAAI,CAAC,aAAa,MAAM;EACxB,oBAAoB,0BAA0B,KAAK,QAAQ,GAAG,aAAa,WAAW,CAAC,CAAC;CAC1F;CAEF,OAAO;AACT;AAEA,SAAS,gBAAgB,KAAiC;CACxD,MAAM,kBAAkB,KAAK,KAAK,KAAK,cAAc;CACrD,IAAI,CAAC,GAAG,WAAW,eAAe,GAAG,OAAO,KAAA;CAC5C,OAAQ,KAAK,MAAM,GAAG,aAAa,iBAAiB,MAAM,CAAC,CAAC,CAAuB;AACrF;AAEA,SAAgB,0BAA0B,UAA0B;CAClE,IAAI,aAAa,KAAK,QAAQ,QAAQ;CAEtC,OAAO,MAAM;EACX,MAAM,cAAc,gBAAgB,UAAU;EAC9C,IAAI,gBAAgB,cAClB,OAAO;EAET,IAAI,gBAAgB,oBAIb;QAAA,MAAM,aAAa,CACtB,KAAK,QAAQ,YAAY,MAAM,KAAK,GACpC,KAAK,QAAQ,YAAY,MAAM,MAAM,YAAY,CACnD,GACE,IAAI,gBAAgB,SAAS,MAAM,cACjC,OAAO;EAAA;EAKb,MAAM,YAAY,KAAK,QAAQ,UAAU;EACzC,IAAI,cAAc,YAChB,MAAM,IAAI,MAAM,+CAA+C,UAAU;EAE3E,aAAa;CACf;AACF;AAEA,SAAgB,4BAA4B,WAAyB;CACnE,IAAI,wCAAwC,SAAS,GACnD;CAGF,MAAM,cAAc,sBAAsB;CAC1C,MAAM,iBAAiB,KAAK,KAAK,WAAW,cAAc;CAC1D,MAAM,WAAW,KAAK,KAAK,gBAAgB,YAAY;CACvD,IAAI;EACF,IAAI,GAAG,aAAa,QAAQ,MAAM,GAAG,aAAa,WAAW,GAC3D;EAEF,GAAG,OAAO,UAAU;GAAE,WAAW;GAAM,OAAO;EAAK,CAAC;CACtD,SAAS,OAAO;EACd,IAAK,MAAgC,SAAS,UAAU,MAAM;CAChE;CAEA,GAAG,UAAU,gBAAgB,EAAE,WAAW,KAAK,CAAC;CAChD,GAAG,YAAY,aAAa,UAAU,KAAK;AAC7C;AAEA,SAAS,wCAAwC,WAA4B;CAC3E,MAAM,kBAAkB,KAAK,KAAK,WAAW,cAAc;CAC3D,IAAI,CAAC,GAAG,WAAW,eAAe,GAAG,OAAO;CAE5C,MAAM,cAAc,KAAK,MAAM,GAAG,aAAa,iBAAiB,MAAM,CAAC;CAMvE,OAAO,QACL,YAAY,cAAc,cAC1B,YAAY,iBAAiB,cAC7B,YAAY,sBAAsB,UACpC;AACF"}

package/dist/plugins/paths.d.ts

@@ -0,0 +1,10 @@
+import type { PluginScope, PluginScopePaths } from './types.js';
+export type PluginPathOptions = {
+    projectRoot: string;
+    configDir?: string;
+    homeDir?: string;
+};
+export declare function getPluginRoot(scope: PluginScope, options: PluginPathOptions): string;
+export declare function getPluginRegistryPath(scope: PluginScope, options: PluginPathOptions): string;
+export declare function getPluginScopePaths(scope: PluginScope, options: PluginPathOptions): PluginScopePaths;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/plugins/paths.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAIpF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAE5F;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAQpG"}

package/dist/plugins/paths.js

@@ -0,0 +1,25 @@
+import "../constants.js";
+import path from "path";
+import os from "os";
+//#region src/plugins/paths.ts
+function getPluginRoot(scope, options) {
+	const configDir = options.configDir ?? ".mastracode";
+	const baseDir = scope === "project" ? options.projectRoot : options.homeDir ?? os.homedir();
+	return path.join(baseDir, configDir, "plugins");
+}
+function getPluginRegistryPath(scope, options) {
+	return path.join(getPluginRoot(scope, options), "plugins.json");
+}
+function getPluginScopePaths(scope, options) {
+	const root = getPluginRoot(scope, options);
+	return {
+		scope,
+		root,
+		registryPath: path.join(root, "plugins.json"),
+		sourcesPath: path.join(root, "sources")
+	};
+}
+//#endregion
+export { getPluginRegistryPath, getPluginRoot, getPluginScopePaths };
+
+//# sourceMappingURL=paths.js.map

package/dist/plugins/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","names":[],"sources":["../../src/plugins/paths.ts"],"sourcesContent":["import os from 'node:os';\nimport path from 'node:path';\n\nimport { DEFAULT_CONFIG_DIR } from '../constants.js';\nimport type { PluginScope, PluginScopePaths } from './types.js';\n\nexport type PluginPathOptions = {\n  projectRoot: string;\n  configDir?: string;\n  homeDir?: string;\n};\n\nexport function getPluginRoot(scope: PluginScope, options: PluginPathOptions): string {\n  const configDir = options.configDir ?? DEFAULT_CONFIG_DIR;\n  const baseDir = scope === 'project' ? options.projectRoot : (options.homeDir ?? os.homedir());\n  return path.join(baseDir, configDir, 'plugins');\n}\n\nexport function getPluginRegistryPath(scope: PluginScope, options: PluginPathOptions): string {\n  return path.join(getPluginRoot(scope, options), 'plugins.json');\n}\n\nexport function getPluginScopePaths(scope: PluginScope, options: PluginPathOptions): PluginScopePaths {\n  const root = getPluginRoot(scope, options);\n  return {\n    scope,\n    root,\n    registryPath: path.join(root, 'plugins.json'),\n    sourcesPath: path.join(root, 'sources'),\n  };\n}\n"],"mappings":";;;;AAYA,SAAgB,cAAc,OAAoB,SAAoC;CACpF,MAAM,YAAY,QAAQ,aAAA;CAC1B,MAAM,UAAU,UAAU,YAAY,QAAQ,cAAe,QAAQ,WAAW,GAAG,QAAQ;CAC3F,OAAO,KAAK,KAAK,SAAS,WAAW,SAAS;AAChD;AAEA,SAAgB,sBAAsB,OAAoB,SAAoC;CAC5F,OAAO,KAAK,KAAK,cAAc,OAAO,OAAO,GAAG,cAAc;AAChE;AAEA,SAAgB,oBAAoB,OAAoB,SAA8C;CACpG,MAAM,OAAO,cAAc,OAAO,OAAO;CACzC,OAAO;EACL;EACA;EACA,cAAc,KAAK,KAAK,MAAM,cAAc;EAC5C,aAAa,KAAK,KAAK,MAAM,SAAS;CACxC;AACF"}

package/dist/plugins/registry.d.ts

@@ -0,0 +1,8 @@
+import type { InstalledPluginRecord, PluginRegistry, ScopedInstalledPluginRecord } from './types.js';
+export declare const EMPTY_PLUGIN_REGISTRY: PluginRegistry;
+export declare function loadPluginRegistry(registryPath: string): PluginRegistry;
+export declare function savePluginRegistry(registryPath: string, registry: PluginRegistry): void;
+export declare function mergePluginRegistries(globalRegistry: PluginRegistry, projectRegistry: PluginRegistry): ScopedInstalledPluginRecord[];
+export declare function setPluginRecord(registry: PluginRegistry, pluginId: string, record: InstalledPluginRecord): PluginRegistry;
+export declare function removePluginRecord(registry: PluginRegistry, pluginId: string): PluginRegistry;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/plugins/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAErG,eAAO,MAAM,qBAAqB,EAAE,cAAqD,CAAC;AAE1F,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,CAQvE;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAGvF;AAED,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,cAAc,EAC9B,eAAe,EAAE,cAAc,GAC9B,2BAA2B,EAAE,CAqB/B;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,qBAAqB,GAC5B,cAAc,CAQhB;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAI7F"}

package/dist/plugins/registry.js

@@ -0,0 +1,112 @@
+import path from "path";
+import fs from "fs";
+//#region src/plugins/registry.ts
+const EMPTY_PLUGIN_REGISTRY = {
+	plugins: {},
+	disabledPlugins: []
+};
+function loadPluginRegistry(registryPath) {
+	try {
+		if (!fs.existsSync(registryPath)) return {
+			plugins: {},
+			disabledPlugins: []
+		};
+		return validatePluginRegistry(JSON.parse(fs.readFileSync(registryPath, "utf-8")));
+	} catch {
+		return {
+			plugins: {},
+			disabledPlugins: []
+		};
+	}
+}
+function savePluginRegistry(registryPath, registry) {
+	fs.mkdirSync(path.dirname(registryPath), { recursive: true });
+	fs.writeFileSync(registryPath, `${JSON.stringify(validatePluginRegistry(registry), null, 2)}\n`);
+}
+function mergePluginRegistries(globalRegistry, projectRegistry) {
+	const merged = /* @__PURE__ */ new Map();
+	const disabledPlugins = /* @__PURE__ */ new Set([...globalRegistry.disabledPlugins ?? [], ...projectRegistry.disabledPlugins ?? []]);
+	for (const [id, record] of Object.entries(globalRegistry.plugins)) merged.set(id, {
+		id,
+		scope: "global",
+		...record
+	});
+	for (const [id, record] of Object.entries(projectRegistry.plugins)) merged.set(id, {
+		id,
+		scope: "project",
+		...record
+	});
+	return [...merged.values()].map((record) => disabledPlugins.has(record.id) ? {
+		...record,
+		blocked: true
+	} : record).sort((a, b) => {
+		if (a.scope !== b.scope) return a.scope === "project" ? -1 : 1;
+		return a.id.localeCompare(b.id);
+	});
+}
+function setPluginRecord(registry, pluginId, record) {
+	return {
+		plugins: {
+			...registry.plugins,
+			[pluginId]: record
+		},
+		disabledPlugins: registry.disabledPlugins ?? []
+	};
+}
+function removePluginRecord(registry, pluginId) {
+	const plugins = { ...registry.plugins };
+	delete plugins[pluginId];
+	return {
+		plugins,
+		disabledPlugins: registry.disabledPlugins ?? []
+	};
+}
+function validatePluginRegistry(raw) {
+	if (!raw || typeof raw !== "object") return {
+		plugins: {},
+		disabledPlugins: []
+	};
+	const plugins = raw.plugins;
+	if (!plugins || typeof plugins !== "object" || Array.isArray(plugins)) return {
+		plugins: {},
+		disabledPlugins: []
+	};
+	const disabledPlugins = raw.disabledPlugins;
+	const validated = {
+		plugins: {},
+		disabledPlugins: Array.isArray(disabledPlugins) ? [...new Set(disabledPlugins.filter((pluginId) => typeof pluginId === "string"))].sort() : []
+	};
+	for (const [id, value] of Object.entries(plugins)) {
+		if (typeof id !== "string" || id.trim().length === 0) continue;
+		if (!value || typeof value !== "object" || Array.isArray(value)) continue;
+		const record = value;
+		if (typeof record.enabled !== "boolean") continue;
+		if (record.source !== "local" && record.source !== "github") continue;
+		if (typeof record.specifier !== "string") continue;
+		if (typeof record.path !== "string") continue;
+		if (typeof record.entry !== "string") continue;
+		validated.plugins[id] = {
+			enabled: record.enabled,
+			source: record.source,
+			specifier: record.specifier,
+			path: record.path,
+			entry: record.entry,
+			...typeof record.ref === "string" ? { ref: record.ref } : {},
+			...typeof record.version === "string" ? { version: record.version } : {},
+			...record.config && typeof record.config === "object" && !Array.isArray(record.config) ? { config: validatePluginConfigValues(record.config) } : {}
+		};
+	}
+	return validated;
+}
+function validatePluginConfigValues(raw) {
+	const values = {};
+	for (const [key, value] of Object.entries(raw)) {
+		if (typeof key !== "string" || key.trim().length === 0) continue;
+		if (typeof value === "string" || typeof value === "boolean") values[key] = value;
+	}
+	return values;
+}
+//#endregion
+export { EMPTY_PLUGIN_REGISTRY, loadPluginRegistry, mergePluginRegistries, removePluginRecord, savePluginRegistry, setPluginRecord };
+
+//# sourceMappingURL=registry.js.map

package/dist/plugins/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":[],"sources":["../../src/plugins/registry.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { InstalledPluginRecord, PluginRegistry, ScopedInstalledPluginRecord } from './types.js';\n\nexport const EMPTY_PLUGIN_REGISTRY: PluginRegistry = { plugins: {}, disabledPlugins: [] };\n\nexport function loadPluginRegistry(registryPath: string): PluginRegistry {\n  try {\n    if (!fs.existsSync(registryPath)) return { plugins: {}, disabledPlugins: [] };\n    const raw = JSON.parse(fs.readFileSync(registryPath, 'utf-8')) as unknown;\n    return validatePluginRegistry(raw);\n  } catch {\n    return { plugins: {}, disabledPlugins: [] };\n  }\n}\n\nexport function savePluginRegistry(registryPath: string, registry: PluginRegistry): void {\n  fs.mkdirSync(path.dirname(registryPath), { recursive: true });\n  fs.writeFileSync(registryPath, `${JSON.stringify(validatePluginRegistry(registry), null, 2)}\\n`);\n}\n\nexport function mergePluginRegistries(\n  globalRegistry: PluginRegistry,\n  projectRegistry: PluginRegistry,\n): ScopedInstalledPluginRecord[] {\n  const merged = new Map<string, ScopedInstalledPluginRecord>();\n  const disabledPlugins = new Set([\n    ...(globalRegistry.disabledPlugins ?? []),\n    ...(projectRegistry.disabledPlugins ?? []),\n  ]);\n\n  for (const [id, record] of Object.entries(globalRegistry.plugins)) {\n    merged.set(id, { id, scope: 'global', ...record });\n  }\n\n  for (const [id, record] of Object.entries(projectRegistry.plugins)) {\n    merged.set(id, { id, scope: 'project', ...record });\n  }\n\n  return [...merged.values()]\n    .map(record => (disabledPlugins.has(record.id) ? { ...record, blocked: true } : record))\n    .sort((a, b) => {\n      if (a.scope !== b.scope) return a.scope === 'project' ? -1 : 1;\n      return a.id.localeCompare(b.id);\n    });\n}\n\nexport function setPluginRecord(\n  registry: PluginRegistry,\n  pluginId: string,\n  record: InstalledPluginRecord,\n): PluginRegistry {\n  return {\n    plugins: {\n      ...registry.plugins,\n      [pluginId]: record,\n    },\n    disabledPlugins: registry.disabledPlugins ?? [],\n  };\n}\n\nexport function removePluginRecord(registry: PluginRegistry, pluginId: string): PluginRegistry {\n  const plugins = { ...registry.plugins };\n  delete plugins[pluginId];\n  return { plugins, disabledPlugins: registry.disabledPlugins ?? [] };\n}\n\nfunction validatePluginRegistry(raw: unknown): PluginRegistry {\n  if (!raw || typeof raw !== 'object') return { plugins: {}, disabledPlugins: [] };\n  const plugins = (raw as { plugins?: unknown }).plugins;\n  if (!plugins || typeof plugins !== 'object' || Array.isArray(plugins)) return { plugins: {}, disabledPlugins: [] };\n\n  const disabledPlugins = (raw as { disabledPlugins?: unknown }).disabledPlugins;\n  const validated: PluginRegistry = {\n    plugins: {},\n    disabledPlugins: Array.isArray(disabledPlugins)\n      ? [...new Set(disabledPlugins.filter((pluginId): pluginId is string => typeof pluginId === 'string'))].sort()\n      : [],\n  };\n  for (const [id, value] of Object.entries(plugins)) {\n    if (typeof id !== 'string' || id.trim().length === 0) continue;\n    if (!value || typeof value !== 'object' || Array.isArray(value)) continue;\n    const record = value as Record<string, unknown>;\n    if (typeof record.enabled !== 'boolean') continue;\n    if (record.source !== 'local' && record.source !== 'github') continue;\n    if (typeof record.specifier !== 'string') continue;\n    if (typeof record.path !== 'string') continue;\n    if (typeof record.entry !== 'string') continue;\n\n    validated.plugins[id] = {\n      enabled: record.enabled,\n      source: record.source,\n      specifier: record.specifier,\n      path: record.path,\n      entry: record.entry,\n      ...(typeof record.ref === 'string' ? { ref: record.ref } : {}),\n      ...(typeof record.version === 'string' ? { version: record.version } : {}),\n      ...(record.config && typeof record.config === 'object' && !Array.isArray(record.config)\n        ? { config: validatePluginConfigValues(record.config) }\n        : {}),\n    };\n  }\n\n  return validated;\n}\n\nfunction validatePluginConfigValues(raw: object): Record<string, string | boolean> {\n  const values: Record<string, string | boolean> = {};\n  for (const [key, value] of Object.entries(raw)) {\n    if (typeof key !== 'string' || key.trim().length === 0) continue;\n    if (typeof value === 'string' || typeof value === 'boolean') values[key] = value;\n  }\n  return values;\n}\n"],"mappings":";;;AAKA,MAAa,wBAAwC;CAAE,SAAS,CAAC;CAAG,iBAAiB,CAAC;AAAE;AAExF,SAAgB,mBAAmB,cAAsC;CACvE,IAAI;EACF,IAAI,CAAC,GAAG,WAAW,YAAY,GAAG,OAAO;GAAE,SAAS,CAAC;GAAG,iBAAiB,CAAC;EAAE;EAE5E,OAAO,uBADK,KAAK,MAAM,GAAG,aAAa,cAAc,OAAO,CAC5B,CAAC;CACnC,QAAQ;EACN,OAAO;GAAE,SAAS,CAAC;GAAG,iBAAiB,CAAC;EAAE;CAC5C;AACF;AAEA,SAAgB,mBAAmB,cAAsB,UAAgC;CACvF,GAAG,UAAU,KAAK,QAAQ,YAAY,GAAG,EAAE,WAAW,KAAK,CAAC;CAC5D,GAAG,cAAc,cAAc,GAAG,KAAK,UAAU,uBAAuB,QAAQ,GAAG,MAAM,CAAC,EAAE,GAAG;AACjG;AAEA,SAAgB,sBACd,gBACA,iBAC+B;CAC/B,MAAM,yBAAS,IAAI,IAAyC;CAC5D,MAAM,kCAAkB,IAAI,IAAI,CAC9B,GAAI,eAAe,mBAAmB,CAAC,GACvC,GAAI,gBAAgB,mBAAmB,CAAC,CAC1C,CAAC;CAED,KAAK,MAAM,CAAC,IAAI,WAAW,OAAO,QAAQ,eAAe,OAAO,GAC9D,OAAO,IAAI,IAAI;EAAE;EAAI,OAAO;EAAU,GAAG;CAAO,CAAC;CAGnD,KAAK,MAAM,CAAC,IAAI,WAAW,OAAO,QAAQ,gBAAgB,OAAO,GAC/D,OAAO,IAAI,IAAI;EAAE;EAAI,OAAO;EAAW,GAAG;CAAO,CAAC;CAGpD,OAAO,CAAC,GAAG,OAAO,OAAO,CAAC,CAAC,CACxB,KAAI,WAAW,gBAAgB,IAAI,OAAO,EAAE,IAAI;EAAE,GAAG;EAAQ,SAAS;CAAK,IAAI,MAAO,CAAC,CACvF,MAAM,GAAG,MAAM;EACd,IAAI,EAAE,UAAU,EAAE,OAAO,OAAO,EAAE,UAAU,YAAY,KAAK;EAC7D,OAAO,EAAE,GAAG,cAAc,EAAE,EAAE;CAChC,CAAC;AACL;AAEA,SAAgB,gBACd,UACA,UACA,QACgB;CAChB,OAAO;EACL,SAAS;GACP,GAAG,SAAS;IACX,WAAW;EACd;EACA,iBAAiB,SAAS,mBAAmB,CAAC;CAChD;AACF;AAEA,SAAgB,mBAAmB,UAA0B,UAAkC;CAC7F,MAAM,UAAU,EAAE,GAAG,SAAS,QAAQ;CACtC,OAAO,QAAQ;CACf,OAAO;EAAE;EAAS,iBAAiB,SAAS,mBAAmB,CAAC;CAAE;AACpE;AAEA,SAAS,uBAAuB,KAA8B;CAC5D,IAAI,CAAC,OAAO,OAAO,QAAQ,UAAU,OAAO;EAAE,SAAS,CAAC;EAAG,iBAAiB,CAAC;CAAE;CAC/E,MAAM,UAAW,IAA8B;CAC/C,IAAI,CAAC,WAAW,OAAO,YAAY,YAAY,MAAM,QAAQ,OAAO,GAAG,OAAO;EAAE,SAAS,CAAC;EAAG,iBAAiB,CAAC;CAAE;CAEjH,MAAM,kBAAmB,IAAsC;CAC/D,MAAM,YAA4B;EAChC,SAAS,CAAC;EACV,iBAAiB,MAAM,QAAQ,eAAe,IAC1C,CAAC,GAAG,IAAI,IAAI,gBAAgB,QAAQ,aAAiC,OAAO,aAAa,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,IAC1G,CAAC;CACP;CACA,KAAK,MAAM,CAAC,IAAI,UAAU,OAAO,QAAQ,OAAO,GAAG;EACjD,IAAI,OAAO,OAAO,YAAY,GAAG,KAAK,CAAC,CAAC,WAAW,GAAG;EACtD,IAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAAG;EACjE,MAAM,SAAS;EACf,IAAI,OAAO,OAAO,YAAY,WAAW;EACzC,IAAI,OAAO,WAAW,WAAW,OAAO,WAAW,UAAU;EAC7D,IAAI,OAAO,OAAO,cAAc,UAAU;EAC1C,IAAI,OAAO,OAAO,SAAS,UAAU;EACrC,IAAI,OAAO,OAAO,UAAU,UAAU;EAEtC,UAAU,QAAQ,MAAM;GACtB,SAAS,OAAO;GAChB,QAAQ,OAAO;GACf,WAAW,OAAO;GAClB,MAAM,OAAO;GACb,OAAO,OAAO;GACd,GAAI,OAAO,OAAO,QAAQ,WAAW,EAAE,KAAK,OAAO,IAAI,IAAI,CAAC;GAC5D,GAAI,OAAO,OAAO,YAAY,WAAW,EAAE,SAAS,OAAO,QAAQ,IAAI,CAAC;GACxE,GAAI,OAAO,UAAU,OAAO,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,MAAM,IAClF,EAAE,QAAQ,2BAA2B,OAAO,MAAM,EAAE,IACpD,CAAC;EACP;CACF;CAEA,OAAO;AACT;AAEA,SAAS,2BAA2B,KAA+C;CACjF,MAAM,SAA2C,CAAC;CAClD,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,GAAG,GAAG;EAC9C,IAAI,OAAO,QAAQ,YAAY,IAAI,KAAK,CAAC,CAAC,WAAW,GAAG;EACxD,IAAI,OAAO,UAAU,YAAY,OAAO,UAAU,WAAW,OAAO,OAAO;CAC7E;CACA,OAAO;AACT"}

package/dist/plugins/scaffold.d.ts

@@ -0,0 +1,10 @@
+export type ScaffoldPluginOptions = {
+    id?: string;
+    name?: string;
+    projectRoot?: string;
+    configDir?: string;
+};
+export declare function resolveScaffoldTarget(target: string, options?: Pick<ScaffoldPluginOptions, 'projectRoot' | 'configDir'>): string;
+export declare function scaffoldPlugin(targetDir: string, options?: ScaffoldPluginOptions): string;
+export declare function formatScaffoldSuccess(targetDir: string): string;
+//# sourceMappingURL=scaffold.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/plugins/scaffold.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,IAAI,CAAC,qBAAqB,EAAE,aAAa,GAAG,WAAW,CAAM,GACrE,MAAM,CAYR;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,MAAM,CA8D7F;AAqBD,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAY/D"}

package/dist/plugins/scaffold.js

@@ -0,0 +1,116 @@
+import "../constants.js";
+import { upsertPluginManifestEntry } from "./manifest.js";
+import { ensureMastraCodePackageLink } from "./package-link.js";
+import path from "path";
+import fs from "fs";
+//#region src/plugins/scaffold.ts
+function resolveScaffoldTarget(target, options = {}) {
+	if (isBarePluginName(target)) return path.join(options.projectRoot ?? process.cwd(), options.configDir ?? ".mastracode", "plugins", "sources", "local", target);
+	return path.resolve(options.projectRoot ?? process.cwd(), target);
+}
+function scaffoldPlugin(targetDir, options = {}) {
+	const dir = resolveScaffoldTarget(targetDir, options);
+	if (fs.existsSync(dir) && fs.readdirSync(dir).length > 0) throw new Error(`Directory already exists and is not empty: ${targetDir}`);
+	const packageName = path.basename(dir).toLowerCase().replace(/[^a-z0-9_.-]+/g, "-").replace(/^-|-$/g, "") || "mastracode-plugin";
+	const pluginId = options.id ?? packageName;
+	const pluginName = options.name ?? humanizeName(packageName);
+	fs.mkdirSync(path.join(dir, "src"), { recursive: true });
+	fs.writeFileSync(path.join(dir, "package.json"), `${JSON.stringify({
+		name: packageName,
+		type: "module",
+		exports: "./src/index.ts",
+		peerDependencies: { mastracode: "*" },
+		devDependencies: { typescript: "^5.9.3" },
+		scripts: { check: "tsc --noEmit" }
+	}, null, 2)}\n`);
+	fs.writeFileSync(path.join(dir, "tsconfig.json"), `${JSON.stringify({
+		compilerOptions: {
+			target: "ES2024",
+			module: "NodeNext",
+			moduleResolution: "NodeNext",
+			strict: true,
+			verbatimModuleSyntax: true,
+			erasableSyntaxOnly: true,
+			skipLibCheck: true,
+			noEmit: true
+		},
+		include: ["src/**/*.ts"]
+	}, null, 2)}\n`);
+	fs.writeFileSync(path.join(dir, "src/index.ts"), renderIndex(pluginId, pluginName));
+	fs.writeFileSync(path.join(dir, "README.md"), renderReadme(pluginName, pluginId));
+	writeScaffoldManifest(targetDir, dir, pluginId, pluginName, options);
+	ensureMastraCodePackageLink(dir);
+	return dir;
+}
+function writeScaffoldManifest(originalTarget, scaffoldDir, pluginId, pluginName, options) {
+	const projectRoot = options.projectRoot ?? process.cwd();
+	upsertPluginManifestEntry(isBarePluginName(originalTarget) ? projectRoot : scaffoldDir, {
+		id: pluginId,
+		name: pluginName,
+		entry: (isBarePluginName(originalTarget) ? path.join(path.relative(projectRoot, scaffoldDir), "src/index.ts") : "src/index.ts").split(path.sep).join("/")
+	});
+}
+function formatScaffoldSuccess(targetDir) {
+	return [
+		`Created Mastra Code plugin scaffold at ${targetDir}`,
+		"",
+		"Next steps:",
+		`  cd ${targetDir}`,
+		"  pnpm install",
+		"  pnpm check",
+		"  mastracode",
+		"  /plugins",
+		"  Install new plugin → Local path"
+	].join("\n");
+}
+function isBarePluginName(target) {
+	return !path.isAbsolute(target) && !target.startsWith(".") && !target.includes("/") && !target.includes("\\");
+}
+function renderIndex(pluginId, pluginName) {
+	return `import { createTool, defineMastraCodePlugin, z } from 'mastracode/plugin';
+
+export default defineMastraCodePlugin({
+  id: ${JSON.stringify(pluginId)},
+  name: ${JSON.stringify(pluginName)},
+  description: 'A Mastra Code tool plugin.',
+  tools: {
+    example_tool: {
+      tool: createTool({
+        id: 'example_tool',
+        description: 'Echo a message from the scaffolded plugin.',
+        inputSchema: z.object({
+          message: z.string(),
+        }),
+        execute: async context => {
+          return { message: context.message };
+        },
+      }),
+    },
+  },
+});
+`;
+}
+function renderReadme(pluginName, pluginId) {
+	return `# ${pluginName}
+
+Mastra Code tool plugin: \`${pluginId}\`.
+
+## Develop
+
+\`\`\`sh
+pnpm install
+pnpm check
+\`\`\`
+
+## Install locally
+
+Open Mastra Code, run \`/plugins\`, and install this directory as a local plugin.
+`;
+}
+function humanizeName(value) {
+	return value.split(/[-_.]+/g).filter(Boolean).map((part) => part[0]?.toUpperCase() + part.slice(1)).join(" ") || "Mastra Code Plugin";
+}
+//#endregion
+export { formatScaffoldSuccess, resolveScaffoldTarget, scaffoldPlugin };
+
+//# sourceMappingURL=scaffold.js.map

package/dist/plugins/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","names":[],"sources":["../../src/plugins/scaffold.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport { DEFAULT_CONFIG_DIR } from '../constants.js';\nimport { upsertPluginManifestEntry } from './manifest.js';\nimport { ensureMastraCodePackageLink } from './package-link.js';\n\nexport type ScaffoldPluginOptions = {\n  id?: string;\n  name?: string;\n  projectRoot?: string;\n  configDir?: string;\n};\n\nexport function resolveScaffoldTarget(\n  target: string,\n  options: Pick<ScaffoldPluginOptions, 'projectRoot' | 'configDir'> = {},\n): string {\n  if (isBarePluginName(target)) {\n    return path.join(\n      options.projectRoot ?? process.cwd(),\n      options.configDir ?? DEFAULT_CONFIG_DIR,\n      'plugins',\n      'sources',\n      'local',\n      target,\n    );\n  }\n  return path.resolve(options.projectRoot ?? process.cwd(), target);\n}\n\nexport function scaffoldPlugin(targetDir: string, options: ScaffoldPluginOptions = {}): string {\n  const dir = resolveScaffoldTarget(targetDir, options);\n  if (fs.existsSync(dir) && fs.readdirSync(dir).length > 0) {\n    throw new Error(`Directory already exists and is not empty: ${targetDir}`);\n  }\n\n  const packageName =\n    path\n      .basename(dir)\n      .toLowerCase()\n      .replace(/[^a-z0-9_.-]+/g, '-')\n      .replace(/^-|-$/g, '') || 'mastracode-plugin';\n  const pluginId = options.id ?? packageName;\n  const pluginName = options.name ?? humanizeName(packageName);\n\n  fs.mkdirSync(path.join(dir, 'src'), { recursive: true });\n  fs.writeFileSync(\n    path.join(dir, 'package.json'),\n    `${JSON.stringify(\n      {\n        name: packageName,\n        type: 'module',\n        exports: './src/index.ts',\n        peerDependencies: {\n          mastracode: '*',\n        },\n        devDependencies: {\n          typescript: '^5.9.3',\n        },\n        scripts: {\n          check: 'tsc --noEmit',\n        },\n      },\n      null,\n      2,\n    )}\\n`,\n  );\n  fs.writeFileSync(\n    path.join(dir, 'tsconfig.json'),\n    `${JSON.stringify(\n      {\n        compilerOptions: {\n          target: 'ES2024',\n          module: 'NodeNext',\n          moduleResolution: 'NodeNext',\n          strict: true,\n          verbatimModuleSyntax: true,\n          erasableSyntaxOnly: true,\n          skipLibCheck: true,\n          noEmit: true,\n        },\n        include: ['src/**/*.ts'],\n      },\n      null,\n      2,\n    )}\\n`,\n  );\n  fs.writeFileSync(path.join(dir, 'src/index.ts'), renderIndex(pluginId, pluginName));\n  fs.writeFileSync(path.join(dir, 'README.md'), renderReadme(pluginName, pluginId));\n  writeScaffoldManifest(targetDir, dir, pluginId, pluginName, options);\n  ensureMastraCodePackageLink(dir);\n  return dir;\n}\n\nfunction writeScaffoldManifest(\n  originalTarget: string,\n  scaffoldDir: string,\n  pluginId: string,\n  pluginName: string,\n  options: ScaffoldPluginOptions,\n): void {\n  const projectRoot = options.projectRoot ?? process.cwd();\n  const manifestRoot = isBarePluginName(originalTarget) ? projectRoot : scaffoldDir;\n  const entry = isBarePluginName(originalTarget)\n    ? path.join(path.relative(projectRoot, scaffoldDir), 'src/index.ts')\n    : 'src/index.ts';\n  upsertPluginManifestEntry(manifestRoot, {\n    id: pluginId,\n    name: pluginName,\n    entry: entry.split(path.sep).join('/'),\n  });\n}\n\nexport function formatScaffoldSuccess(targetDir: string): string {\n  return [\n    `Created Mastra Code plugin scaffold at ${targetDir}`,\n    '',\n    'Next steps:',\n    `  cd ${targetDir}`,\n    '  pnpm install',\n    '  pnpm check',\n    '  mastracode',\n    '  /plugins',\n    '  Install new plugin → Local path',\n  ].join('\\n');\n}\n\nfunction isBarePluginName(target: string): boolean {\n  return !path.isAbsolute(target) && !target.startsWith('.') && !target.includes('/') && !target.includes('\\\\');\n}\n\nfunction renderIndex(pluginId: string, pluginName: string): string {\n  return `import { createTool, defineMastraCodePlugin, z } from 'mastracode/plugin';\n\nexport default defineMastraCodePlugin({\n  id: ${JSON.stringify(pluginId)},\n  name: ${JSON.stringify(pluginName)},\n  description: 'A Mastra Code tool plugin.',\n  tools: {\n    example_tool: {\n      tool: createTool({\n        id: 'example_tool',\n        description: 'Echo a message from the scaffolded plugin.',\n        inputSchema: z.object({\n          message: z.string(),\n        }),\n        execute: async context => {\n          return { message: context.message };\n        },\n      }),\n    },\n  },\n});\n`;\n}\n\nfunction renderReadme(pluginName: string, pluginId: string): string {\n  return `# ${pluginName}\n\nMastra Code tool plugin: \\`${pluginId}\\`.\n\n## Develop\n\n\\`\\`\\`sh\npnpm install\npnpm check\n\\`\\`\\`\n\n## Install locally\n\nOpen Mastra Code, run \\`/plugins\\`, and install this directory as a local plugin.\n`;\n}\n\nfunction humanizeName(value: string): string {\n  return (\n    value\n      .split(/[-_.]+/g)\n      .filter(Boolean)\n      .map(part => part[0]?.toUpperCase() + part.slice(1))\n      .join(' ') || 'Mastra Code Plugin'\n  );\n}\n"],"mappings":"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"}

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

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

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

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

package/dist/plugins/signal-lane.js

@@ -0,0 +1,166 @@
+//#region src/plugins/signal-lane.ts
+/**
+* Owns the lifecycle of signal providers contributed by plugins.
+*
+* Providers are long-lived; processors are per-request. The Agent constructor
+* conflates the two — it harvests a provider's processors into a closure that
+* can never be undone — so plugin providers are deliberately kept out of the
+* `signals` array and driven from here instead, through the same public methods
+* the constructor uses. That is what makes a provider removable when its plugin
+* is disabled, updated or uninstalled.
+*/
+var PluginSignalLane = class {
+	#live = /* @__PURE__ */ new Map();
+	#reservedProviderIds;
+	#onError;
+	#agent;
+	#mastra;
+	#inputProcessors = [];
+	#outputProcessors = [];
+	constructor(options = {}) {
+		this.#reservedProviderIds = new Set(options.reservedProviderIds ?? []);
+		this.#onError = options.onError ?? ((message, error) => {
+			console.warn(message, error);
+		});
+	}
+	getInputProcessors() {
+		return this.#inputProcessors;
+	}
+	getOutputProcessors() {
+		return this.#outputProcessors;
+	}
+	/**
+	* Reconciles the live providers against a freshly loaded plugin list.
+	*
+	* A plugin whose stamp is unchanged keeps the provider instance it already
+	* has, and the freshly resolved one is dropped without ever being registered,
+	* connected or polled — reload re-runs every plugin's resolver, so unchanged
+	* plugins hand over new instances on every call.
+	*
+	* Providers of plugins that went inactive, failed to load or were uninstalled
+	* are absent from the contributions and get stopped here.
+	*/
+	sync(contributions) {
+		const seen = /* @__PURE__ */ new Set();
+		for (const { pluginId, versionStamp, value: provider } of contributions) {
+			const key = `${pluginId}::${provider.id}`;
+			seen.add(key);
+			const live = this.#live.get(key);
+			if (live && live.versionStamp === versionStamp) continue;
+			if (live) this.#retire(key, live);
+			if (this.#isProviderIdTaken(provider.id)) {
+				this.#onError(`Plugin "${pluginId}" signal provider "${provider.id}" is already running; refusing to start a second instance.`, void 0);
+				seen.delete(key);
+				continue;
+			}
+			this.#live.set(key, {
+				pluginId,
+				provider,
+				versionStamp,
+				started: false
+			});
+		}
+		for (const [key, live] of this.#live) if (!seen.has(key)) this.#retire(key, live);
+		this.#startPending();
+		this.#rebuildProcessors();
+	}
+	/**
+	* Called once Mastra exists. Providers resolved before then are registered and
+	* started here — without a Mastra instance a provider has no storage, and
+	* nothing else will ever hand it one: the Agent propagates Mastra only to the
+	* providers in its own `signals` array, which these deliberately are not in.
+	*/
+	setMastra(mastra, agent) {
+		this.#mastra = mastra;
+		this.#agent = agent;
+		this.#startPending();
+		this.#rebuildProcessors();
+	}
+	/**
+	* Retires every live provider and empties both processor lanes. The inverse of
+	* `sync()`, for a caller that is done with this lane — an embedder sharing one
+	* `PluginManager` across controllers would otherwise leave a controller's
+	* providers polling after it is gone.
+	*/
+	stopAll() {
+		for (const [key, live] of this.#live) this.#retire(key, live);
+		this.#rebuildProcessors();
+	}
+	#startPending() {
+		const mastra = this.#mastra;
+		const agent = this.#agent;
+		if (!mastra || !agent) return;
+		for (const [key, live] of this.#live) {
+			if (live.started) continue;
+			try {
+				live.provider.__registerMastra(mastra);
+				live.provider.connect(agent);
+				live.provider.startPolling();
+				live.started = true;
+				this.#runStart(key, live);
+			} catch (error) {
+				this.#failProvider(key, live, error);
+			}
+		}
+	}
+	async #runStart(key, live) {
+		try {
+			await live.provider.start?.();
+			if (this.#live.get(key) !== live) this.#stopProvider(live);
+		} catch (error) {
+			if (this.#live.get(key) !== live) {
+				this.#stopProvider(live);
+				return;
+			}
+			this.#failProvider(key, live, error);
+			this.#rebuildProcessors();
+		}
+	}
+	/**
+	* Isolated: one failing provider does not take down its plugin's tools,
+	* commands, skills or sibling providers. A plugin author who wants a provider
+	* treated as required throws from the `signalProviders` resolver instead,
+	* which fails the whole plugin record.
+	*/
+	#failProvider(key, live, error) {
+		this.#onError(`Plugin "${live.pluginId}" signal provider "${live.provider.id}" failed to start:`, error);
+		this.#retire(key, live);
+	}
+	#retire(key, live) {
+		this.#stopProvider(live);
+		this.#live.delete(key);
+	}
+	#stopProvider(live) {
+		try {
+			live.provider.stop();
+		} catch (error) {
+			this.#onError(`Plugin "${live.pluginId}" signal provider "${live.provider.id}" failed to stop:`, error);
+		}
+	}
+	#isProviderIdTaken(providerId) {
+		if (this.#reservedProviderIds.has(providerId)) return true;
+		for (const live of this.#live.values()) if (live.provider.id === providerId) return true;
+		return false;
+	}
+	#rebuildProcessors() {
+		const input = [];
+		const output = [];
+		for (const live of this.#live.values()) {
+			if (!live.started) continue;
+			try {
+				const providerInput = live.provider.getInputProcessors?.() ?? [];
+				const providerOutput = live.provider.getOutputProcessors?.() ?? [];
+				input.push(...providerInput);
+				output.push(...providerOutput);
+			} catch (error) {
+				this.#onError(`Plugin "${live.pluginId}" signal provider "${live.provider.id}" failed to provide processors:`, error);
+			}
+		}
+		this.#inputProcessors = input;
+		this.#outputProcessors = output;
+	}
+};
+//#endregion
+export { PluginSignalLane };
+
+//# sourceMappingURL=signal-lane.js.map