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

package/dist/plugin.js

@@ -0,0 +1,30 @@
+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;
+	if (!toolCallId) return;
+	const chunk = {
+		type: "data-mastracode-tool-progress",
+		data: {
+			toolCallId,
+			progress
+		},
+		transient: true
+	};
+	const outputWriter = context.agent?.outputWriter;
+	if (outputWriter) {
+		await outputWriter(chunk);
+		return;
+	}
+	await context.writer?.custom(chunk);
+}
+function defineMastraCodePlugin(plugin) {
+	return plugin;
+}
+//#endregion
+export { RequestContext, SignalProvider, createTool, defineMastraCodePlugin, writeToolProgress, z };
+
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"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 { MastraCompositeStore } from '@mastra/core/storage';\nimport type { Tool, ToolAction, ToolExecutionContext } from '@mastra/core/tools';\nimport type { MastraVector } from '@mastra/core/vector';\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   * Borrow the host's persistence when booting a nested controller. Do not close\n   * these instances or run storage maintenance on them; the host owns their lifetime.\n   * Opening the same SQLite files with a plugin-local native library is unsafe.\n   */\n  getStorage?: () => {\n    storage: MastraCompositeStore;\n    storageBackend: 'libsql' | 'pg';\n    vector?: MastraVector;\n  };\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":";;;;;AA+DA,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;AA4HA,SAAgB,uBAAyD,QAA0B;CACjG,OAAO;AACT"}

package/dist/plugins/dependencies.d.ts

@@ -0,0 +1,9 @@
+export type PluginInstallExecutionOptions = {
+    onOutput?: (chunk: Buffer | string) => void;
+    signal?: AbortSignal;
+};
+export declare function installPluginDependencies(pluginRoot: string, commandRoot?: string, options?: PluginInstallExecutionOptions): Promise<boolean>;
+export declare function installPluginDependenciesForEntry(pluginRoot: string, entry: string, options?: PluginInstallExecutionOptions): Promise<void>;
+export declare function getPluginDependencyRoots(pluginRoot: string, entry: string): string[];
+export declare function getEntryPackageRoot(pluginRoot: string, entry: string): string;
+//# sourceMappingURL=dependencies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../src/plugins/dependencies.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IAC5C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,EAClB,WAAW,SAAa,EACxB,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAAC,OAAO,CAAC,CAqClB;AAED,wBAAsB,iCAAiC,CACrD,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAOpF;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7E"}

package/dist/plugins/dependencies.js

@@ -0,0 +1,87 @@
+import path from "path";
+import fs from "fs";
+import { execa } from "execa";
+//#region src/plugins/dependencies.ts
+async function installPluginDependencies(pluginRoot, commandRoot = pluginRoot, options = {}) {
+	const packageJsonPath = path.join(pluginRoot, "package.json");
+	if (!fs.existsSync(packageJsonPath)) return false;
+	const packageJson = readPackageJson(pluginRoot);
+	const commandPackageJson = commandRoot === pluginRoot ? packageJson : readPackageJson(commandRoot);
+	const installCommand = getInstallCommand(pluginRoot, getPnpmSpec(pluginRoot, Object.hasOwn(packageJson, "packageManager") ? packageJson.packageManager : commandPackageJson.packageManager));
+	const child = execa(installCommand.command, installCommand.args, {
+		cwd: pluginRoot,
+		env: {
+			...process.env,
+			GIT_TERMINAL_PROMPT: "0"
+		},
+		stdout: options.onOutput ? "pipe" : "ignore",
+		stderr: options.onOutput ? "pipe" : "ignore",
+		cancelSignal: options.signal
+	});
+	if (options.onOutput) {
+		child.stdout?.on("data", options.onOutput);
+		child.stderr?.on("data", options.onOutput);
+	}
+	try {
+		await child;
+	} catch (error) {
+		if (isCommandNotFoundError(error)) throw new Error("Mastra Code requires Corepack to install GitHub plugin dependencies. Install it with \"npm install --global corepack\" and try again.", { cause: error });
+		throw error;
+	}
+	return true;
+}
+async function installPluginDependenciesForEntry(pluginRoot, entry, options = {}) {
+	for (const dependencyRoot of getPluginDependencyRoots(pluginRoot, entry)) await installPluginDependencies(dependencyRoot, pluginRoot, options);
+}
+function getPluginDependencyRoots(pluginRoot, entry) {
+	const roots = fs.existsSync(path.join(pluginRoot, "package.json")) ? [pluginRoot] : [];
+	const entryPackageRoot = findEntryPackageRoot(pluginRoot, entry);
+	if (entryPackageRoot && entryPackageRoot !== pluginRoot) roots.push(entryPackageRoot);
+	return roots;
+}
+function getEntryPackageRoot(pluginRoot, entry) {
+	return findEntryPackageRoot(pluginRoot, entry) ?? pluginRoot;
+}
+function findEntryPackageRoot(pluginRoot, entry) {
+	const root = path.resolve(pluginRoot);
+	let current = path.dirname(path.resolve(pluginRoot, entry));
+	while (isInsideDirectory(current, root)) {
+		if (fs.existsSync(path.join(current, "package.json"))) return current;
+		if (current === root) break;
+		current = path.dirname(current);
+	}
+}
+function isInsideDirectory(targetPath, root) {
+	const resolvedTarget = path.resolve(targetPath);
+	const resolvedRoot = path.resolve(root);
+	return resolvedTarget === resolvedRoot || resolvedTarget.startsWith(resolvedRoot + path.sep);
+}
+const PNPM_SPEC_PATTERN = /^pnpm@\d+\.\d+\.\d+(?:\+sha(?:1|224|256|384|512)\.[0-9a-f]+)?$/;
+function getPnpmSpec(pluginRoot, packageManager) {
+	if (typeof packageManager !== "string" || !PNPM_SPEC_PATTERN.test(packageManager)) throw new Error(`Plugin at ${pluginRoot} must declare an exact pnpm version in package.json using "packageManager": "pnpm@x.y.z".`);
+	return packageManager;
+}
+function getInstallCommand(pluginRoot, pnpmSpec) {
+	const installArgs = ["install", "--ignore-workspace"];
+	if (hasFile(pluginRoot, "pnpm-lock.yaml")) installArgs.push("--frozen-lockfile");
+	installArgs.push("--ignore-scripts");
+	return {
+		command: "corepack",
+		args: [pnpmSpec, ...installArgs]
+	};
+}
+function isCommandNotFoundError(error) {
+	return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+function readPackageJson(pluginRoot) {
+	const packageJsonPath = path.join(pluginRoot, "package.json");
+	if (!fs.existsSync(packageJsonPath)) return {};
+	return JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+}
+function hasFile(pluginRoot, fileName) {
+	return fs.existsSync(path.join(pluginRoot, fileName));
+}
+//#endregion
+export { getEntryPackageRoot, getPluginDependencyRoots, installPluginDependencies, installPluginDependenciesForEntry };
+
+//# sourceMappingURL=dependencies.js.map

package/dist/plugins/dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.js","names":[],"sources":["../../src/plugins/dependencies.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport { execa } from 'execa';\n\ntype InstallCommand = {\n  command: string;\n  args: string[];\n};\n\nexport type PluginInstallExecutionOptions = {\n  onOutput?: (chunk: Buffer | string) => void;\n  signal?: AbortSignal;\n};\n\nexport async function installPluginDependencies(\n  pluginRoot: string,\n  commandRoot = pluginRoot,\n  options: PluginInstallExecutionOptions = {},\n): Promise<boolean> {\n  const packageJsonPath = path.join(pluginRoot, 'package.json');\n  if (!fs.existsSync(packageJsonPath)) {\n    return false;\n  }\n\n  const packageJson = readPackageJson(pluginRoot);\n  const commandPackageJson = commandRoot === pluginRoot ? packageJson : readPackageJson(commandRoot);\n  const packageManager = Object.hasOwn(packageJson, 'packageManager')\n    ? packageJson.packageManager\n    : commandPackageJson.packageManager;\n  const pnpmSpec = getPnpmSpec(pluginRoot, packageManager);\n  const installCommand = getInstallCommand(pluginRoot, pnpmSpec);\n\n  const child = execa(installCommand.command, installCommand.args, {\n    cwd: pluginRoot,\n    env: { ...process.env, GIT_TERMINAL_PROMPT: '0' },\n    stdout: options.onOutput ? 'pipe' : 'ignore',\n    stderr: options.onOutput ? 'pipe' : 'ignore',\n    cancelSignal: options.signal,\n  });\n  if (options.onOutput) {\n    child.stdout?.on('data', options.onOutput);\n    child.stderr?.on('data', options.onOutput);\n  }\n  try {\n    await child;\n  } catch (error) {\n    if (isCommandNotFoundError(error)) {\n      throw new Error(\n        'Mastra Code requires Corepack to install GitHub plugin dependencies. Install it with \"npm install --global corepack\" and try again.',\n        { cause: error },\n      );\n    }\n    throw error;\n  }\n  return true;\n}\n\nexport async function installPluginDependenciesForEntry(\n  pluginRoot: string,\n  entry: string,\n  options: PluginInstallExecutionOptions = {},\n): Promise<void> {\n  for (const dependencyRoot of getPluginDependencyRoots(pluginRoot, entry)) {\n    await installPluginDependencies(dependencyRoot, pluginRoot, options);\n  }\n}\n\nexport function getPluginDependencyRoots(pluginRoot: string, entry: string): string[] {\n  const roots = fs.existsSync(path.join(pluginRoot, 'package.json')) ? [pluginRoot] : [];\n  const entryPackageRoot = findEntryPackageRoot(pluginRoot, entry);\n  if (entryPackageRoot && entryPackageRoot !== pluginRoot) {\n    roots.push(entryPackageRoot);\n  }\n  return roots;\n}\n\nexport function getEntryPackageRoot(pluginRoot: string, entry: string): string {\n  return findEntryPackageRoot(pluginRoot, entry) ?? pluginRoot;\n}\n\nfunction findEntryPackageRoot(pluginRoot: string, entry: string): string | undefined {\n  const root = path.resolve(pluginRoot);\n  let current = path.dirname(path.resolve(pluginRoot, entry));\n\n  while (isInsideDirectory(current, root)) {\n    if (fs.existsSync(path.join(current, 'package.json'))) {\n      return current;\n    }\n    if (current === root) break;\n    current = path.dirname(current);\n  }\n\n  return undefined;\n}\n\nfunction 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\n// Accepts the optional Corepack integrity suffix (e.g. `+sha512.<hex>`) written by `corepack use`.\nconst PNPM_SPEC_PATTERN = /^pnpm@\\d+\\.\\d+\\.\\d+(?:\\+sha(?:1|224|256|384|512)\\.[0-9a-f]+)?$/;\n\nfunction getPnpmSpec(pluginRoot: string, packageManager: unknown): string {\n  if (typeof packageManager !== 'string' || !PNPM_SPEC_PATTERN.test(packageManager)) {\n    throw new Error(\n      `Plugin at ${pluginRoot} must declare an exact pnpm version in package.json using \"packageManager\": \"pnpm@x.y.z\".`,\n    );\n  }\n  return packageManager;\n}\n\nfunction getInstallCommand(pluginRoot: string, pnpmSpec: string): InstallCommand {\n  const installArgs = ['install', '--ignore-workspace'];\n  if (hasFile(pluginRoot, 'pnpm-lock.yaml')) installArgs.push('--frozen-lockfile');\n  installArgs.push('--ignore-scripts');\n\n  return {\n    command: 'corepack',\n    args: [pnpmSpec, ...installArgs],\n  };\n}\n\nfunction isCommandNotFoundError(error: unknown): boolean {\n  return typeof error === 'object' && error !== null && 'code' in error && error.code === 'ENOENT';\n}\n\nfunction readPackageJson(pluginRoot: string): { packageManager?: unknown } {\n  const packageJsonPath = path.join(pluginRoot, 'package.json');\n  if (!fs.existsSync(packageJsonPath)) return {};\n  return JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')) as { packageManager?: unknown };\n}\n\nfunction hasFile(pluginRoot: string, fileName: string): boolean {\n  return fs.existsSync(path.join(pluginRoot, fileName));\n}\n"],"mappings":"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"}

package/dist/plugins/install.d.ts

@@ -0,0 +1,21 @@
+import type { PluginInstallExecutionOptions } from './dependencies.js';
+import type { PluginPathOptions } from './paths.js';
+import type { PluginScope } from './types.js';
+export type InstallPluginOptions = PluginPathOptions & PluginInstallExecutionOptions & {
+    entry?: string;
+    ref?: string;
+    githubCliPath?: string;
+};
+export type DiscoveredLocalPlugin = {
+    name: string;
+    path: string;
+    entry: string;
+};
+export declare const NON_INTERACTIVE_GIT_ENV: {
+    GIT_TERMINAL_PROMPT: string;
+};
+export declare function installLocalPlugin(localPath: string, scope: PluginScope, options: InstallPluginOptions): Promise<string>;
+export declare function installGithubPlugin(url: string, scope: PluginScope, options: InstallPluginOptions): Promise<string>;
+export declare function discoverLocalPlugins(searchRoot: string, options: PluginPathOptions): DiscoveredLocalPlugin[];
+export declare function detectEntry(pluginDir: string, explicitEntry?: string): string;
+//# sourceMappingURL=install.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/plugins/install.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAKvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,KAAK,EAAyB,WAAW,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAClD,6BAA6B,GAAG;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEJ,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAIF,eAAO,MAAM,uBAAuB;;CAA+C,CAAC;AAIpF,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAED,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAyCjB;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,qBAAqB,EAAE,CAa5G;AA2BD,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAiC7E"}

package/dist/plugins/install.js

@@ -0,0 +1,190 @@
+import "../constants.js";
+import { getEntryPackageRoot, installPluginDependenciesForEntry } from "./dependencies.js";
+import { getPluginRoot, getPluginScopePaths } from "./paths.js";
+import { loadPluginRegistry, removePluginRecord, savePluginRegistry, setPluginRecord } from "./registry.js";
+import { loadPluginFromEntry } from "./loader.js";
+import { getSingleManifestPlugin } from "./manifest.js";
+import { ensureMastraCodePackageLink } from "./package-link.js";
+import path from "path";
+import fs from "fs";
+import { execa } from "execa";
+//#region src/plugins/install.ts
+const ENTRY_CANDIDATES = ["src/index.ts", "index.ts"];
+const NON_INTERACTIVE_GIT_ENV = {
+	...process.env,
+	GIT_TERMINAL_PROMPT: "0"
+};
+const NON_INTERACTIVE_EXEC_OPTIONS = { env: NON_INTERACTIVE_GIT_ENV };
+async function installLocalPlugin(localPath, scope, options) {
+	const sourcePath = path.resolve(options.projectRoot, localPath);
+	if (!fs.existsSync(sourcePath) || !fs.statSync(sourcePath).isDirectory()) throw new Error(`Local plugin path does not exist or is not a directory: ${localPath}`);
+	const entry = detectEntry(sourcePath, options.entry);
+	ensureMastraCodePackageLink(sourcePath);
+	const plugin = await loadPluginFromEntry(path.join(sourcePath, entry));
+	const registryPath = getPluginScopePaths(scope, options).registryPath;
+	const registry = removePluginRecord(loadPluginRegistry(registryPath), plugin.id);
+	const record = {
+		enabled: true,
+		source: "local",
+		specifier: localPath,
+		path: sourcePath,
+		entry,
+		...plugin.version ? { version: plugin.version } : {}
+	};
+	savePluginRegistry(registryPath, setPluginRecord(registry, plugin.id, record));
+	return plugin.id;
+}
+async function installGithubPlugin(url, scope, options) {
+	const parsed = parseGithubUrl(url);
+	const paths = getPluginScopePaths(scope, options);
+	const checkoutDir = path.join(paths.sourcesPath, "github", `${parsed.owner}-${parsed.repo}`);
+	const githubCli = options.githubCliPath ?? "gh";
+	await assertGithubCliAvailable(githubCli);
+	await assertGithubCliAuthenticated(githubCli);
+	fs.rmSync(checkoutDir, {
+		recursive: true,
+		force: true
+	});
+	fs.mkdirSync(path.dirname(checkoutDir), { recursive: true });
+	const ref = options.ref ?? parsed.ref;
+	await runPluginInstallCommand(githubCli, [
+		"repo",
+		"clone",
+		parsed.repoSpec,
+		checkoutDir,
+		...ref ? [] : [
+			"--",
+			"--depth",
+			"1"
+		]
+	], { env: NON_INTERACTIVE_GIT_ENV }, options);
+	if (ref) await runPluginInstallCommand("git", ["checkout", ref], {
+		cwd: checkoutDir,
+		env: NON_INTERACTIVE_GIT_ENV
+	}, options);
+	const entry = detectEntry(checkoutDir, options.entry);
+	await installPluginDependenciesForEntry(checkoutDir, entry, options);
+	ensureMastraCodePackageLink(getEntryPackageRoot(checkoutDir, entry));
+	const plugin = await loadPluginFromEntry(path.join(checkoutDir, entry));
+	const registry = removePluginRecord(loadPluginRegistry(paths.registryPath), plugin.id);
+	const record = {
+		enabled: true,
+		source: "github",
+		specifier: url,
+		path: path.relative(getPluginRoot(scope, options), checkoutDir),
+		entry,
+		...ref ? { ref } : {},
+		...plugin.version ? { version: plugin.version } : {}
+	};
+	savePluginRegistry(paths.registryPath, setPluginRecord(registry, plugin.id, record));
+	return plugin.id;
+}
+function discoverLocalPlugins(searchRoot, options) {
+	const root = path.resolve(options.projectRoot, searchRoot);
+	const localSourcesRoot = path.join(root, options.configDir ?? ".mastracode", "plugins", "sources", "local");
+	const scanRoot = isLocalSourcesDir(root) ? root : localSourcesRoot;
+	const seen = /* @__PURE__ */ new Set();
+	return discoverPluginDirs(scanRoot).filter((candidate) => {
+		if (seen.has(candidate.path)) return false;
+		seen.add(candidate.path);
+		return true;
+	}).sort((a, b) => a.name.localeCompare(b.name));
+}
+function isLocalSourcesDir(dir) {
+	return dir.split(path.sep).join("/").endsWith("/plugins/sources/local");
+}
+function discoverPluginDirs(root) {
+	if (!fs.existsSync(root) || !fs.statSync(root).isDirectory()) return [];
+	return fs.readdirSync(root, { withFileTypes: true }).filter((entry) => entry.isDirectory()).flatMap((entry) => {
+		const pluginDir = path.join(root, entry.name);
+		const detectedEntry = tryDetectEntry(pluginDir);
+		return detectedEntry ? [{
+			name: entry.name,
+			path: pluginDir,
+			entry: detectedEntry
+		}] : [];
+	});
+}
+function tryDetectEntry(pluginDir) {
+	try {
+		return detectEntry(pluginDir);
+	} catch {
+		return;
+	}
+}
+function detectEntry(pluginDir, explicitEntry) {
+	const root = path.resolve(pluginDir);
+	if (explicitEntry) {
+		const entryPath = path.resolve(pluginDir, explicitEntry);
+		if (!isInsideDirectory(entryPath, root)) throw new Error("Plugin entry must be inside the plugin directory");
+		if (fs.existsSync(entryPath) && fs.statSync(entryPath).isDirectory()) {
+			const nestedEntry = detectEntry(entryPath);
+			return path.relative(root, path.join(entryPath, nestedEntry));
+		}
+		if (path.extname(entryPath) !== ".ts") throw new Error("Plugin entry must be a .ts file");
+		if (!fs.existsSync(entryPath) || !fs.statSync(entryPath).isFile()) throw new Error(`Plugin entry file does not exist: ${explicitEntry}`);
+		return path.relative(root, entryPath);
+	}
+	const manifestPlugin = getSingleManifestPlugin(pluginDir);
+	if (manifestPlugin) return detectEntry(pluginDir, manifestPlugin.entry);
+	for (const candidate of ENTRY_CANDIDATES) {
+		const entryPath = path.join(pluginDir, candidate);
+		if (fs.existsSync(entryPath) && fs.statSync(entryPath).isFile()) return candidate;
+	}
+	throw new Error(`Could not find a plugin entry file. Tried: ${ENTRY_CANDIDATES.join(", ")}`);
+}
+function isInsideDirectory(targetPath, root) {
+	return targetPath === root || targetPath.startsWith(root + path.sep);
+}
+async function runPluginInstallCommand(command, args, execaOptions, options) {
+	const child = execa(command, args, {
+		...execaOptions,
+		stdout: options.onOutput ? "pipe" : "ignore",
+		stderr: options.onOutput ? "pipe" : "ignore",
+		cancelSignal: options.signal
+	});
+	if (options.onOutput) {
+		child.stdout?.on("data", options.onOutput);
+		child.stderr?.on("data", options.onOutput);
+	}
+	await child;
+}
+async function assertGithubCliAvailable(githubCli) {
+	try {
+		await execa(githubCli, ["--version"], NON_INTERACTIVE_EXEC_OPTIONS);
+	} catch {
+		throw new Error("GitHub CLI is required to install GitHub plugins. Install gh and run gh auth login.");
+	}
+}
+async function assertGithubCliAuthenticated(githubCli) {
+	try {
+		await execa(githubCli, ["auth", "status"], NON_INTERACTIVE_EXEC_OPTIONS);
+	} catch {
+		throw new Error("GitHub CLI is not authenticated. Run gh auth login, then install the plugin again.");
+	}
+}
+function parseGithubUrl(specifier) {
+	const [urlPart, ref] = specifier.split("#", 2);
+	if (!urlPart) throw new Error(`Invalid GitHub URL: ${specifier}`);
+	let url;
+	try {
+		url = new URL(urlPart);
+	} catch {
+		throw new Error(`Invalid GitHub URL: ${specifier}`);
+	}
+	if (url.hostname !== "github.com") throw new Error("Only github.com plugin URLs are supported");
+	const [owner, rawRepo, ...rest] = url.pathname.split("/").filter(Boolean);
+	if (!owner || !rawRepo || rest.length > 0) throw new Error("GitHub plugin URL must be in the form https://github.com/owner/repo");
+	const repo = rawRepo.replace(/\.git$/, "");
+	if (!/^[A-Za-z0-9_.-]+$/.test(owner) || !/^[A-Za-z0-9_.-]+$/.test(repo)) throw new Error("GitHub owner and repo may only contain letters, numbers, dots, underscores, and dashes");
+	return {
+		owner,
+		repo,
+		repoSpec: `${owner}/${repo}`,
+		...ref ? { ref } : {}
+	};
+}
+//#endregion
+export { NON_INTERACTIVE_GIT_ENV, detectEntry, discoverLocalPlugins, installGithubPlugin, installLocalPlugin };
+
+//# sourceMappingURL=install.js.map

package/dist/plugins/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","names":[],"sources":["../../src/plugins/install.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport { execa } from 'execa';\n\nimport { DEFAULT_CONFIG_DIR } from '../constants.js';\nimport { getEntryPackageRoot, installPluginDependenciesForEntry } from './dependencies.js';\nimport type { PluginInstallExecutionOptions } from './dependencies.js';\nimport { loadPluginFromEntry } from './loader.js';\nimport { getSingleManifestPlugin } from './manifest.js';\nimport { ensureMastraCodePackageLink } from './package-link.js';\nimport { getPluginRoot, getPluginScopePaths } from './paths.js';\nimport type { PluginPathOptions } from './paths.js';\nimport { loadPluginRegistry, removePluginRecord, savePluginRegistry, setPluginRecord } from './registry.js';\nimport type { InstalledPluginRecord, PluginScope } from './types.js';\n\nexport type InstallPluginOptions = PluginPathOptions &\n  PluginInstallExecutionOptions & {\n    entry?: string;\n    ref?: string;\n    githubCliPath?: string;\n  };\n\nexport type DiscoveredLocalPlugin = {\n  name: string;\n  path: string;\n  entry: string;\n};\n\nconst ENTRY_CANDIDATES = ['src/index.ts', 'index.ts'];\n\nexport const NON_INTERACTIVE_GIT_ENV = { ...process.env, GIT_TERMINAL_PROMPT: '0' };\n\nconst NON_INTERACTIVE_EXEC_OPTIONS = { env: NON_INTERACTIVE_GIT_ENV };\n\nexport async function installLocalPlugin(\n  localPath: string,\n  scope: PluginScope,\n  options: InstallPluginOptions,\n): Promise<string> {\n  const sourcePath = path.resolve(options.projectRoot, localPath);\n  if (!fs.existsSync(sourcePath) || !fs.statSync(sourcePath).isDirectory()) {\n    throw new Error(`Local plugin path does not exist or is not a directory: ${localPath}`);\n  }\n\n  const entry = detectEntry(sourcePath, options.entry);\n  ensureMastraCodePackageLink(sourcePath);\n  const plugin = await loadPluginFromEntry(path.join(sourcePath, entry));\n  const registryPath = getPluginScopePaths(scope, options).registryPath;\n  const registry = removePluginRecord(loadPluginRegistry(registryPath), plugin.id);\n  const record: InstalledPluginRecord = {\n    enabled: true,\n    source: 'local',\n    specifier: localPath,\n    path: sourcePath,\n    entry,\n    ...(plugin.version ? { version: plugin.version } : {}),\n  };\n\n  savePluginRegistry(registryPath, setPluginRecord(registry, plugin.id, record));\n  return plugin.id;\n}\n\nexport async function installGithubPlugin(\n  url: string,\n  scope: PluginScope,\n  options: InstallPluginOptions,\n): Promise<string> {\n  const parsed = parseGithubUrl(url);\n  const paths = getPluginScopePaths(scope, options);\n  const checkoutDir = path.join(paths.sourcesPath, 'github', `${parsed.owner}-${parsed.repo}`);\n\n  const githubCli = options.githubCliPath ?? 'gh';\n  await assertGithubCliAvailable(githubCli);\n  await assertGithubCliAuthenticated(githubCli);\n\n  fs.rmSync(checkoutDir, { recursive: true, force: true });\n  fs.mkdirSync(path.dirname(checkoutDir), { recursive: true });\n  const ref = options.ref ?? parsed.ref;\n  const cloneArgs = ['repo', 'clone', parsed.repoSpec, checkoutDir, ...(ref ? [] : ['--', '--depth', '1'])];\n  await runPluginInstallCommand(githubCli, cloneArgs, { env: NON_INTERACTIVE_GIT_ENV }, options);\n  if (ref) {\n    await runPluginInstallCommand(\n      'git',\n      ['checkout', ref],\n      { cwd: checkoutDir, env: NON_INTERACTIVE_GIT_ENV },\n      options,\n    );\n  }\n\n  const entry = detectEntry(checkoutDir, options.entry);\n  await installPluginDependenciesForEntry(checkoutDir, entry, options);\n  ensureMastraCodePackageLink(getEntryPackageRoot(checkoutDir, entry));\n  const plugin = await loadPluginFromEntry(path.join(checkoutDir, entry));\n  const registry = removePluginRecord(loadPluginRegistry(paths.registryPath), plugin.id);\n  const relativePath = path.relative(getPluginRoot(scope, options), checkoutDir);\n  const record: InstalledPluginRecord = {\n    enabled: true,\n    source: 'github',\n    specifier: url,\n    path: relativePath,\n    entry,\n    ...(ref ? { ref } : {}),\n    ...(plugin.version ? { version: plugin.version } : {}),\n  };\n\n  savePluginRegistry(paths.registryPath, setPluginRecord(registry, plugin.id, record));\n  return plugin.id;\n}\n\nexport function discoverLocalPlugins(searchRoot: string, options: PluginPathOptions): DiscoveredLocalPlugin[] {\n  const root = path.resolve(options.projectRoot, searchRoot);\n  const localSourcesRoot = path.join(root, options.configDir ?? DEFAULT_CONFIG_DIR, 'plugins', 'sources', 'local');\n  const scanRoot = isLocalSourcesDir(root) ? root : localSourcesRoot;\n\n  const seen = new Set<string>();\n  return discoverPluginDirs(scanRoot)\n    .filter(candidate => {\n      if (seen.has(candidate.path)) return false;\n      seen.add(candidate.path);\n      return true;\n    })\n    .sort((a, b) => a.name.localeCompare(b.name));\n}\n\nfunction isLocalSourcesDir(dir: string): boolean {\n  const normalized = dir.split(path.sep).join('/');\n  return normalized.endsWith('/plugins/sources/local');\n}\n\nfunction discoverPluginDirs(root: string): DiscoveredLocalPlugin[] {\n  if (!fs.existsSync(root) || !fs.statSync(root).isDirectory()) return [];\n  return fs\n    .readdirSync(root, { withFileTypes: true })\n    .filter(entry => entry.isDirectory())\n    .flatMap(entry => {\n      const pluginDir = path.join(root, entry.name);\n      const detectedEntry = tryDetectEntry(pluginDir);\n      return detectedEntry ? [{ name: entry.name, path: pluginDir, entry: detectedEntry }] : [];\n    });\n}\n\nfunction tryDetectEntry(pluginDir: string): string | undefined {\n  try {\n    return detectEntry(pluginDir);\n  } catch {\n    return undefined;\n  }\n}\n\nexport function detectEntry(pluginDir: string, explicitEntry?: string): string {\n  const root = path.resolve(pluginDir);\n  if (explicitEntry) {\n    const entryPath = path.resolve(pluginDir, explicitEntry);\n    if (!isInsideDirectory(entryPath, root)) {\n      throw new Error('Plugin entry must be inside the plugin directory');\n    }\n    if (fs.existsSync(entryPath) && fs.statSync(entryPath).isDirectory()) {\n      const nestedEntry = detectEntry(entryPath);\n      return path.relative(root, path.join(entryPath, nestedEntry));\n    }\n    if (path.extname(entryPath) !== '.ts') {\n      throw new Error('Plugin entry must be a .ts file');\n    }\n    if (!fs.existsSync(entryPath) || !fs.statSync(entryPath).isFile()) {\n      throw new Error(`Plugin entry file does not exist: ${explicitEntry}`);\n    }\n    return path.relative(root, entryPath);\n  }\n\n  const manifestPlugin = getSingleManifestPlugin(pluginDir);\n  if (manifestPlugin) {\n    return detectEntry(pluginDir, manifestPlugin.entry);\n  }\n\n  for (const candidate of ENTRY_CANDIDATES) {\n    const entryPath = path.join(pluginDir, candidate);\n    if (fs.existsSync(entryPath) && fs.statSync(entryPath).isFile()) {\n      return candidate;\n    }\n  }\n\n  throw new Error(`Could not find a plugin entry file. Tried: ${ENTRY_CANDIDATES.join(', ')}`);\n}\n\nfunction isInsideDirectory(targetPath: string, root: string): boolean {\n  return targetPath === root || targetPath.startsWith(root + path.sep);\n}\n\nasync function runPluginInstallCommand(\n  command: string,\n  args: string[],\n  execaOptions: typeof NON_INTERACTIVE_EXEC_OPTIONS & { cwd?: string },\n  options: PluginInstallExecutionOptions,\n): Promise<void> {\n  const child = execa(command, args, {\n    ...execaOptions,\n    stdout: options.onOutput ? 'pipe' : 'ignore',\n    stderr: options.onOutput ? 'pipe' : 'ignore',\n    cancelSignal: options.signal,\n  });\n  if (options.onOutput) {\n    child.stdout?.on('data', options.onOutput);\n    child.stderr?.on('data', options.onOutput);\n  }\n  await child;\n}\n\nasync function assertGithubCliAvailable(githubCli: string): Promise<void> {\n  try {\n    await execa(githubCli, ['--version'], NON_INTERACTIVE_EXEC_OPTIONS);\n  } catch {\n    throw new Error('GitHub CLI is required to install GitHub plugins. Install gh and run gh auth login.');\n  }\n}\n\nasync function assertGithubCliAuthenticated(githubCli: string): Promise<void> {\n  try {\n    await execa(githubCli, ['auth', 'status'], NON_INTERACTIVE_EXEC_OPTIONS);\n  } catch {\n    throw new Error('GitHub CLI is not authenticated. Run gh auth login, then install the plugin again.');\n  }\n}\n\nfunction parseGithubUrl(specifier: string): { owner: string; repo: string; repoSpec: string; ref?: string } {\n  const [urlPart, ref] = specifier.split('#', 2);\n  if (!urlPart) {\n    throw new Error(`Invalid GitHub URL: ${specifier}`);\n  }\n  let url: URL;\n  try {\n    url = new URL(urlPart);\n  } catch {\n    throw new Error(`Invalid GitHub URL: ${specifier}`);\n  }\n\n  if (url.hostname !== 'github.com') {\n    throw new Error('Only github.com plugin URLs are supported');\n  }\n\n  const [owner, rawRepo, ...rest] = url.pathname.split('/').filter(Boolean);\n  if (!owner || !rawRepo || rest.length > 0) {\n    throw new Error('GitHub plugin URL must be in the form https://github.com/owner/repo');\n  }\n\n  const repo = rawRepo.replace(/\\.git$/, '');\n  if (!/^[A-Za-z0-9_.-]+$/.test(owner) || !/^[A-Za-z0-9_.-]+$/.test(repo)) {\n    throw new Error('GitHub owner and repo may only contain letters, numbers, dots, underscores, and dashes');\n  }\n\n  return {\n    owner,\n    repo,\n    repoSpec: `${owner}/${repo}`,\n    ...(ref ? { ref } : {}),\n  };\n}\n"],"mappings":"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"}

package/dist/plugins/loader.d.ts

@@ -0,0 +1,19 @@
+import type { MastraCodePlugin, MastraCodePluginRuntime, MastraCodePluginTools } from '../plugin.js';
+import type { PluginPathOptions } from './paths.js';
+import type { LoadedPlugin, PluginRegistry, ScopedInstalledPluginRecord } from './types.js';
+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: 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;
+export declare function isInsideDirectory(targetPath: string, root: string): boolean;
+export declare function collectActivePluginTools(plugins: LoadedPlugin[]): MastraCodePluginTools;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"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,CAsDvB;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;AAuND,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,qBAAqB,CAWvF"}