@mastra/editor 0.7.25-alpha.0 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,92 @@
 # @mastra/editor
 
+## 0.8.0
+
+### Minor Changes
+
+- Added optional `metadata` to code-defined agents. Pass a `metadata` record to `new Agent({...})`, read it back with `agent.getMetadata()`, and clients can filter on it from the existing `/agents` and `/agents/:agentId` responses without encoding the data into IDs or names. ([#16603](https://github.com/mastra-ai/mastra/pull/16603))
+
+  Metadata supports the same `DynamicArgument` form as other agent config fields, so it can also be resolved per request from the request context.
+
+  Stored agents loaded via the editor also expose their metadata through `agent.getMetadata()`, so clients can filter these agents as well. Cloning a runtime agent via `editor.agent.clone()` now carries the source agent's metadata over to the stored clone when the caller does not provide one explicitly.
+
+  ```ts
+  // Static
+  const supportAgent = new Agent({
+    id: 'support-agent',
+    name: 'Support Agent',
+    instructions: 'You help customers with support requests.',
+    model: 'openai/gpt-5',
+    metadata: { type: 'support' },
+  });
+
+  supportAgent.getMetadata(); // { type: 'support' }
+
+  // Dynamic
+  const tenantAgent = new Agent({
+    id: 'tenant-agent',
+    name: 'Tenant Agent',
+    instructions: 'You help customers with tenant-specific tasks.',
+    model: 'openai/gpt-5',
+    metadata: ({ requestContext }) => ({
+      type: 'support',
+      tenant: requestContext.get('tenant'),
+    }),
+  });
+
+  await tenantAgent.getMetadata({ requestContext }); // { type: 'support', tenant: 'acme' }
+  ```
+
+### Patch Changes
+
+- Fixed stored agent tool overrides so conditional tool configuration no longer recursively calls the forked agent when merging code-defined tools. ([#16544](https://github.com/mastra-ai/mastra/pull/16544))
+
+- Updated dependencies [[`20787de`](https://github.com/mastra-ai/mastra/commit/20787de5965234a1af28fe35f49437c537dbfa0d), [`784ad98`](https://github.com/mastra-ai/mastra/commit/784ad989549de91dc5d33ab8ef36caa6f7dcd34e), [`fceae1f`](https://github.com/mastra-ai/mastra/commit/fceae1f5f5db4722cb078a663c6eb4bd22944123), [`090a647`](https://github.com/mastra-ai/mastra/commit/090a647ba5a66d36f203f9f49457e03a1ff4e6fb), [`97fe629`](https://github.com/mastra-ai/mastra/commit/97fe629d07b0a9952e6657b1e6334ca4d9aa15ce), [`bf02acb`](https://github.com/mastra-ai/mastra/commit/bf02acbb8a6110f638ac844e89f1ebf04cb7fe74), [`090a647`](https://github.com/mastra-ai/mastra/commit/090a647ba5a66d36f203f9f49457e03a1ff4e6fb), [`bdb4cbf`](https://github.com/mastra-ai/mastra/commit/bdb4cbf8ba4b685d7481f28bb9dc3de6c79c9ed2), [`0fd3fbe`](https://github.com/mastra-ai/mastra/commit/0fd3fbe40fb63657aedd72f6e7b38c8e8ee6940d), [`f84447d`](https://github.com/mastra-ai/mastra/commit/f84447d6c80f3471836a9b300d246b331fb47e0d), [`a1a5b3e`](https://github.com/mastra-ai/mastra/commit/a1a5b3e42ab2ca5161ea21db59ebf28442680fa7), [`af84f57`](https://github.com/mastra-ai/mastra/commit/af84f571ed762e92e8e61c5f9a72363520914274), [`8b3c6f9`](https://github.com/mastra-ai/mastra/commit/8b3c6f90f7879833ba7d1bc70937e1d8f69d0804), [`fed0475`](https://github.com/mastra-ai/mastra/commit/fed0475ccfea31e4fc251469ac05640d0742c1f0), [`0d53730`](https://github.com/mastra-ai/mastra/commit/0d53730c1ed87ef80c87caa5701c4170ea8028e6), [`522f44d`](https://github.com/mastra-ai/mastra/commit/522f44d947214bfc06cff50599bae1ef3494880d)]:
+  - @mastra/core@1.34.0
+  - @mastra/memory@1.18.1
+
+## 0.8.0-alpha.1
+
+### Minor Changes
+
+- Added optional `metadata` to code-defined agents. Pass a `metadata` record to `new Agent({...})`, read it back with `agent.getMetadata()`, and clients can filter on it from the existing `/agents` and `/agents/:agentId` responses without encoding the data into IDs or names. ([#16603](https://github.com/mastra-ai/mastra/pull/16603))
+
+  Metadata supports the same `DynamicArgument` form as other agent config fields, so it can also be resolved per request from the request context.
+
+  Stored agents loaded via the editor also expose their metadata through `agent.getMetadata()`, so clients can filter these agents as well. Cloning a runtime agent via `editor.agent.clone()` now carries the source agent's metadata over to the stored clone when the caller does not provide one explicitly.
+
+  ```ts
+  // Static
+  const supportAgent = new Agent({
+    id: 'support-agent',
+    name: 'Support Agent',
+    instructions: 'You help customers with support requests.',
+    model: 'openai/gpt-5',
+    metadata: { type: 'support' },
+  });
+
+  supportAgent.getMetadata(); // { type: 'support' }
+
+  // Dynamic
+  const tenantAgent = new Agent({
+    id: 'tenant-agent',
+    name: 'Tenant Agent',
+    instructions: 'You help customers with tenant-specific tasks.',
+    model: 'openai/gpt-5',
+    metadata: ({ requestContext }) => ({
+      type: 'support',
+      tenant: requestContext.get('tenant'),
+    }),
+  });
+
+  await tenantAgent.getMetadata({ requestContext }); // { type: 'support', tenant: 'acme' }
+  ```
+
+### Patch Changes
+
+- Updated dependencies [[`090a647`](https://github.com/mastra-ai/mastra/commit/090a647ba5a66d36f203f9f49457e03a1ff4e6fb), [`090a647`](https://github.com/mastra-ai/mastra/commit/090a647ba5a66d36f203f9f49457e03a1ff4e6fb), [`f84447d`](https://github.com/mastra-ai/mastra/commit/f84447d6c80f3471836a9b300d246b331fb47e0d), [`a1a5b3e`](https://github.com/mastra-ai/mastra/commit/a1a5b3e42ab2ca5161ea21db59ebf28442680fa7), [`af84f57`](https://github.com/mastra-ai/mastra/commit/af84f571ed762e92e8e61c5f9a72363520914274), [`8b3c6f9`](https://github.com/mastra-ai/mastra/commit/8b3c6f90f7879833ba7d1bc70937e1d8f69d0804)]:
+  - @mastra/core@1.34.0-alpha.3
+
 ## 0.7.25-alpha.0
 
 ### Patch Changes

package/dist/index.cjs

@@ -971,6 +971,7 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
       id: storedAgent.id,
       name: storedAgent.name,
       description: storedAgent.description,
+      metadata: storedAgent.metadata,
       instructions: instructions ?? "",
       model,
       memory,
@@ -1363,6 +1364,13 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
       maxProcessorRetries: defaultOptions?.maxProcessorRetries,
       includeRawChunks: defaultOptions?.includeRawChunks
     } : void 0;
+    let resolvedMetadata = options.metadata;
+    if (resolvedMetadata === void 0 && typeof agent.getMetadata === "function") {
+      try {
+        resolvedMetadata = await agent.getMetadata({ requestContext });
+      } catch {
+      }
+    }
     const createInput = {
       id: options.newId,
       name: options.newName || `${agent.name} (Clone)`,
@@ -1375,7 +1383,7 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
       memory: memoryConfig,
       scorers: storedScorers,
       defaultOptions: storageDefaultOptions,
-      metadata: options.metadata,
+      metadata: resolvedMetadata,
       authorId: options.authorId
     };
     const adapter = await this.getStorageAdapter();

package/dist/index.js

@@ -923,6 +923,7 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
       id: storedAgent.id,
       name: storedAgent.name,
       description: storedAgent.description,
+      metadata: storedAgent.metadata,
       instructions: instructions ?? "",
       model,
       memory,
@@ -1315,6 +1316,13 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
       maxProcessorRetries: defaultOptions?.maxProcessorRetries,
       includeRawChunks: defaultOptions?.includeRawChunks
     } : void 0;
+    let resolvedMetadata = options.metadata;
+    if (resolvedMetadata === void 0 && typeof agent.getMetadata === "function") {
+      try {
+        resolvedMetadata = await agent.getMetadata({ requestContext });
+      } catch {
+      }
+    }
     const createInput = {
       id: options.newId,
       name: options.newName || `${agent.name} (Clone)`,
@@ -1327,7 +1335,7 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
       memory: memoryConfig,
       scorers: storedScorers,
       defaultOptions: storageDefaultOptions,
-      metadata: options.metadata,
+      metadata: resolvedMetadata,
       authorId: options.authorId
     };
     const adapter = await this.getStorageAdapter();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/editor",
-  "version": "0.7.25-alpha.0",
+  "version": "0.8.0",
   "description": "Mastra Editor for agent management and instantiation",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -65,8 +65,8 @@
     "@arcadeai/arcadejs": "^2.3.0",
     "@composio/core": "^0.6.5",
     "@composio/mastra": "^0.6.5",
-    "@mastra/memory": "1.18.1-alpha.0",
-    "@mastra/schema-compat": "1.2.10"
+    "@mastra/schema-compat": "1.2.10",
+    "@mastra/memory": "1.18.1"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.11",
@@ -75,13 +75,13 @@
     "typescript": "^6.0.3",
     "vitest": "4.1.5",
     "zod": "^3.25.76",
-    "@internal/ai-sdk-v4": "0.0.41",
-    "@internal/ai-sdk-v5": "0.0.41",
-    "@mastra/core": "1.34.0-alpha.2",
-    "@mastra/hono": "1.4.16-alpha.2",
+    "@internal/ai-sdk-v4": "0.0.42",
+    "@internal/ai-sdk-v5": "0.0.42",
+    "@internal/ai-v6": "0.0.42",
+    "@mastra/hono": "1.4.16",
     "@mastra/libsql": "1.10.1",
     "@mastra/mcp": "1.7.0",
-    "@internal/ai-v6": "0.0.41"
+    "@mastra/core": "1.34.0"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.13.2-0 <2.0.0-0",