@mastra/core 0.10.4 → 0.10.6-alpha.0

package/dist/{chunk-SWJKOFCU.js → chunk-VZDPK54I.js}

@@ -1,9 +1,10 @@
-import { DefaultVoice } from './chunk-7UNDRBOU.js';
-import { MessageList } from './chunk-AX6IHSGY.js';
+import { DefaultVoice } from './chunk-YLCFUSJ4.js';
+import { MessageList } from './chunk-DPKEVI6Q.js';
 import { executeHook } from './chunk-BB4KXGBU.js';
-import { MastraLLM } from './chunk-HFEELWJO.js';
-import { InstrumentClass } from './chunk-36UICULV.js';
-import { ensureToolProperties, makeCoreTool, createMastraProxy } from './chunk-TRJIWZKM.js';
+import { MastraLLM } from './chunk-YDGX5LRI.js';
+import { InstrumentClass } from './chunk-6PQRSQZF.js';
+import { ensureToolProperties, makeCoreTool, createMastraProxy } from './chunk-3SY7GRSA.js';
+import { MastraError } from './chunk-LDNCERLU.js';
 import { MastraBase } from './chunk-5IEKR756.js';
 import { RegisteredLogger } from './chunk-5YDTZN2X.js';
 import { RuntimeContext } from './chunk-SGGPJWRQ.js';
@@ -89,7 +90,18 @@ var Agent = class extends (_a = MastraBase) {
     this.#instructions = config.instructions;
     this.#description = config.description;
     if (!config.model) {
-      throw new Error(`LanguageModel is required to create an Agent. Please provide the 'model'.`);
+      const mastraError = new MastraError({
+        id: "AGENT_CONSTRUCTOR_MODEL_REQUIRED",
+        domain: "AGENT" /* AGENT */,
+        category: "USER" /* USER */,
+        details: {
+          agentName: config.name
+        },
+        text: `LanguageModel is required to create an Agent. Please provide the 'model'.`
+      });
+      this.logger.trackException(mastraError);
+      this.logger.error(mastraError.toString());
+      throw mastraError;
     }
     this.model = config.model;
     if (config.workflows) {
@@ -145,7 +157,18 @@ var Agent = class extends (_a = MastraBase) {
   }
   get voice() {
     if (typeof this.#instructions === "function") {
-      throw new Error("Voice is not compatible when instructions are a function. Please use getVoice() instead.");
+      const mastraError = new MastraError({
+        id: "AGENT_VOICE_INCOMPATIBLE_WITH_FUNCTION_INSTRUCTIONS",
+        domain: "AGENT" /* AGENT */,
+        category: "USER" /* USER */,
+        details: {
+          agentName: this.name
+        },
+        text: "Voice is not compatible when instructions are a function. Please use getVoice() instead."
+      });
+      this.logger.trackException(mastraError);
+      this.logger.error(mastraError.toString());
+      throw mastraError;
     }
     return this.#voice;
   }
@@ -186,7 +209,18 @@ var Agent = class extends (_a = MastraBase) {
   get instructions() {
     this.logger.warn("The instructions property is deprecated. Please use getInstructions() instead.");
     if (typeof this.#instructions === "function") {
-      throw new Error("Instructions are not compatible when instructions are a function. Please use getInstructions() instead.");
+      const mastraError = new MastraError({
+        id: "AGENT_INSTRUCTIONS_INCOMPATIBLE_WITH_FUNCTION_INSTRUCTIONS",
+        domain: "AGENT" /* AGENT */,
+        category: "USER" /* USER */,
+        details: {
+          agentName: this.name
+        },
+        text: "Instructions are not compatible when instructions are a function. Please use getInstructions() instead."
+      });
+      this.logger.trackException(mastraError);
+      this.logger.error(mastraError.toString());
+      throw mastraError;
     }
     return this.#instructions;
   }
@@ -201,8 +235,18 @@ var Agent = class extends (_a = MastraBase) {
     });
     return resolveMaybePromise(result, instructions => {
       if (!instructions) {
-        this.logger.error(`[Agent:${this.name}] - Function-based instructions returned empty value`);
-        throw new Error("Instructions are required to use an Agent. The function-based instructions returned an empty value.");
+        const mastraError = new MastraError({
+          id: "AGENT_GET_INSTRUCTIONS_FUNCTION_EMPTY_RETURN",
+          domain: "AGENT" /* AGENT */,
+          category: "USER" /* USER */,
+          details: {
+            agentName: this.name
+          },
+          text: "Instructions are required to use an Agent. The function-based instructions returned an empty value."
+        });
+        this.logger.trackException(mastraError);
+        this.logger.error(mastraError.toString());
+        throw mastraError;
       }
       return instructions;
     });
@@ -219,7 +263,18 @@ var Agent = class extends (_a = MastraBase) {
   get tools() {
     this.logger.warn("The tools property is deprecated. Please use getTools() instead.");
     if (typeof this.#tools === "function") {
-      throw new Error("Tools are not compatible when tools are a function. Please use getTools() instead.");
+      const mastraError = new MastraError({
+        id: "AGENT_GET_TOOLS_FUNCTION_INCOMPATIBLE_WITH_TOOL_FUNCTION_TYPE",
+        domain: "AGENT" /* AGENT */,
+        category: "USER" /* USER */,
+        details: {
+          agentName: this.name
+        },
+        text: "Tools are not compatible when tools are a function. Please use getTools() instead."
+      });
+      this.logger.trackException(mastraError);
+      this.logger.error(mastraError.toString());
+      throw mastraError;
     }
     return ensureToolProperties(this.#tools);
   }
@@ -234,8 +289,18 @@ var Agent = class extends (_a = MastraBase) {
     });
     return resolveMaybePromise(result, tools => {
       if (!tools) {
-        this.logger.error(`[Agent:${this.name}] - Function-based tools returned empty value`);
-        throw new Error("Tools are required when using a function to provide them. The function returned an empty value.");
+        const mastraError = new MastraError({
+          id: "AGENT_GET_TOOLS_FUNCTION_EMPTY_RETURN",
+          domain: "AGENT" /* AGENT */,
+          category: "USER" /* USER */,
+          details: {
+            agentName: this.name
+          },
+          text: `[Agent:${this.name}] - Function-based tools returned empty value`
+        });
+        this.logger.trackException(mastraError);
+        this.logger.error(mastraError.toString());
+        throw mastraError;
       }
       return ensureToolProperties(tools);
     });
@@ -243,7 +308,18 @@ var Agent = class extends (_a = MastraBase) {
   get llm() {
     this.logger.warn("The llm property is deprecated. Please use getLLM() instead.");
     if (typeof this.model === "function") {
-      throw new Error("LLM is not compatible when model is a function. Please use getLLM() instead.");
+      const mastraError = new MastraError({
+        id: "AGENT_LLM_GETTER_INCOMPATIBLE_WITH_FUNCTION_MODEL",
+        domain: "AGENT" /* AGENT */,
+        category: "USER" /* USER */,
+        details: {
+          agentName: this.name
+        },
+        text: "LLM is not compatible when model is a function. Please use getLLM() instead."
+      });
+      this.logger.trackException(mastraError);
+      this.logger.error(mastraError.toString());
+      throw mastraError;
     }
     return this.getLLM();
   }
@@ -282,8 +358,18 @@ var Agent = class extends (_a = MastraBase) {
   } = {}) {
     if (typeof this.model !== "function") {
       if (!this.model) {
-        this.logger.error(`[Agent:${this.name}] - No model provided`);
-        throw new Error("Model is required to use an Agent.");
+        const mastraError = new MastraError({
+          id: "AGENT_GET_MODEL_MISSING_MODEL_INSTANCE",
+          domain: "AGENT" /* AGENT */,
+          category: "USER" /* USER */,
+          details: {
+            agentName: this.name
+          },
+          text: `[Agent:${this.name}] - No model provided`
+        });
+        this.logger.trackException(mastraError);
+        this.logger.error(mastraError.toString());
+        throw mastraError;
       }
       return this.model;
     }
@@ -292,8 +378,18 @@ var Agent = class extends (_a = MastraBase) {
     });
     return resolveMaybePromise(result, model => {
       if (!model) {
-        this.logger.error(`[Agent:${this.name}] - Function-based model returned empty value`);
-        throw new Error("Model is required to use an Agent. The function-based model returned an empty value.");
+        const mastraError = new MastraError({
+          id: "AGENT_GET_MODEL_FUNCTION_EMPTY_RETURN",
+          domain: "AGENT" /* AGENT */,
+          category: "USER" /* USER */,
+          details: {
+            agentName: this.name
+          },
+          text: `[Agent:${this.name}] - Function-based model returned empty value`
+        });
+        this.logger.trackException(mastraError);
+        this.logger.error(mastraError.toString());
+        throw mastraError;
       }
       return model;
     });
@@ -480,13 +576,21 @@ var Agent = class extends (_a = MastraBase) {
                 runtimeContext
               }, options) ?? void 0;
             } catch (err) {
-              this.logger.error(`[Agent:${this.name}] - Failed memory tool execution`, {
-                error: err,
-                runId,
-                threadId,
-                resourceId
-              });
-              throw err;
+              const mastraError = new MastraError({
+                id: "AGENT_MEMORY_TOOL_EXECUTION_FAILED",
+                domain: "AGENT" /* AGENT */,
+                category: "USER" /* USER */,
+                details: {
+                  agentName: this.name,
+                  runId: runId || "",
+                  threadId: threadId || "",
+                  resourceId: resourceId || ""
+                },
+                text: `[Agent:${this.name}] - Failed memory tool execution`
+              }, err);
+              this.logger.trackException(mastraError);
+              this.logger.error(mastraError.toString());
+              throw mastraError;
             }
           } : void 0
         }];
@@ -653,13 +757,21 @@ var Agent = class extends (_a = MastraBase) {
               });
               return result;
             } catch (err) {
-              this.logger.error(`[Agent:${this.name}] - Failed workflow tool execution`, {
-                error: err,
-                runId,
-                threadId,
-                resourceId
-              });
-              throw err;
+              const mastraError = new MastraError({
+                id: "AGENT_WORKFLOW_TOOL_EXECUTION_FAILED",
+                domain: "AGENT" /* AGENT */,
+                category: "USER" /* USER */,
+                details: {
+                  agentName: this.name,
+                  runId: runId || "",
+                  threadId: threadId || "",
+                  resourceId: resourceId || ""
+                },
+                text: `[Agent:${this.name}] - Failed workflow tool execution`
+              }, err);
+              this.logger.trackException(mastraError);
+              this.logger.error(mastraError.toString());
+              throw mastraError;
             }
           }
         };
@@ -786,7 +898,20 @@ var Agent = class extends (_a = MastraBase) {
           };
         }
         if (!threadId || !resourceId) {
-          throw new Error(`A resourceId must be provided when passing a threadId and using Memory. Saw threadId ${threadId} but resourceId is ${resourceId}`);
+          const mastraError = new MastraError({
+            id: "AGENT_MEMORY_MISSING_RESOURCE_ID",
+            domain: "AGENT" /* AGENT */,
+            category: "USER" /* USER */,
+            details: {
+              agentName: this.name,
+              threadId: threadId || "",
+              resourceId: resourceId || ""
+            },
+            text: `A resourceId must be provided when passing a threadId and using Memory. Saw threadId ${threadId} but resourceId is ${resourceId}`
+          });
+          this.logger.trackException(mastraError);
+          this.logger.error(mastraError.toString());
+          throw mastraError;
         }
         const store = memory.constructor.name;
         this.logger.debug(`[Agent:${this.name}] - Memory persistence enabled: store=${store}, resourceId=${resourceId}`, {
@@ -934,14 +1059,23 @@ ${JSON.stringify(
               memoryConfig: memoryConfig2
             });
           } catch (e) {
-            const message = e instanceof Error ? e.message : JSON.stringify(e);
-            this.logger.error("Error saving response", {
-              error: message,
-              runId: runId2,
-              result: resToLog,
-              threadId: threadId2
-            });
-            throw e;
+            if (e instanceof MastraError) {
+              throw e;
+            }
+            const mastraError = new MastraError({
+              id: "AGENT_MEMORY_PERSIST_RESPONSE_MESSAGES_FAILED",
+              domain: "AGENT" /* AGENT */,
+              category: "SYSTEM" /* SYSTEM */,
+              details: {
+                agentName: this.name,
+                runId: runId2 || "",
+                threadId: threadId2 || "",
+                result: JSON.stringify(resToLog)
+              }
+            }, e);
+            this.logger.trackException(mastraError);
+            this.logger.error(mastraError.toString());
+            throw mastraError;
           }
         }
         if (Object.keys(this.evals || {}).length > 0) {
@@ -1280,16 +1414,40 @@ ${JSON.stringify(
    */
   async speak(input, options) {
     if (!this.voice) {
-      throw new Error("No voice provider configured");
+      const mastraError = new MastraError({
+        id: "AGENT_SPEAK_METHOD_VOICE_NOT_CONFIGURED",
+        domain: "AGENT" /* AGENT */,
+        category: "USER" /* USER */,
+        details: {
+          agentName: this.name
+        },
+        text: "No voice provider configured"
+      });
+      this.logger.trackException(mastraError);
+      this.logger.error(mastraError.toString());
+      throw mastraError;
     }
     this.logger.warn("Warning: agent.speak() is deprecated. Please use agent.voice.speak() instead.");
     try {
       return this.voice.speak(input, options);
     } catch (e) {
-      this.logger.error("Error during agent speak", {
-        error: e
-      });
-      throw e;
+      let err;
+      if (e instanceof MastraError) {
+        err = e;
+      } else {
+        err = new MastraError({
+          id: "AGENT_SPEAK_METHOD_ERROR",
+          domain: "AGENT" /* AGENT */,
+          category: "UNKNOWN" /* UNKNOWN */,
+          details: {
+            agentName: this.name
+          },
+          text: "Error during agent speak"
+        }, e);
+      }
+      this.logger.trackException(err);
+      this.logger.error(err.toString());
+      throw err;
     }
   }
   /**
@@ -1301,16 +1459,40 @@ ${JSON.stringify(
    */
   async listen(audioStream, options) {
     if (!this.voice) {
-      throw new Error("No voice provider configured");
+      const mastraError = new MastraError({
+        id: "AGENT_LISTEN_METHOD_VOICE_NOT_CONFIGURED",
+        domain: "AGENT" /* AGENT */,
+        category: "USER" /* USER */,
+        details: {
+          agentName: this.name
+        },
+        text: "No voice provider configured"
+      });
+      this.logger.trackException(mastraError);
+      this.logger.error(mastraError.toString());
+      throw mastraError;
     }
     this.logger.warn("Warning: agent.listen() is deprecated. Please use agent.voice.listen() instead");
     try {
       return this.voice.listen(audioStream, options);
     } catch (e) {
-      this.logger.error("Error during agent listen", {
-        error: e
-      });
-      throw e;
+      let err;
+      if (e instanceof MastraError) {
+        err = e;
+      } else {
+        err = new MastraError({
+          id: "AGENT_LISTEN_METHOD_ERROR",
+          domain: "AGENT" /* AGENT */,
+          category: "UNKNOWN" /* UNKNOWN */,
+          details: {
+            agentName: this.name
+          },
+          text: "Error during agent listen"
+        }, e);
+      }
+      this.logger.trackException(err);
+      this.logger.error(err.toString());
+      throw err;
     }
   }
   /**
@@ -1321,16 +1503,40 @@ ${JSON.stringify(
    */
   async getSpeakers() {
     if (!this.voice) {
-      throw new Error("No voice provider configured");
+      const mastraError = new MastraError({
+        id: "AGENT_SPEAKERS_METHOD_VOICE_NOT_CONFIGURED",
+        domain: "AGENT" /* AGENT */,
+        category: "USER" /* USER */,
+        details: {
+          agentName: this.name
+        },
+        text: "No voice provider configured"
+      });
+      this.logger.trackException(mastraError);
+      this.logger.error(mastraError.toString());
+      throw mastraError;
     }
     this.logger.warn("Warning: agent.getSpeakers() is deprecated. Please use agent.voice.getSpeakers() instead.");
     try {
       return await this.voice.getSpeakers();
     } catch (e) {
-      this.logger.error("Error during agent getSpeakers", {
-        error: e
-      });
-      throw e;
+      let err;
+      if (e instanceof MastraError) {
+        err = e;
+      } else {
+        err = new MastraError({
+          id: "AGENT_GET_SPEAKERS_METHOD_ERROR",
+          domain: "AGENT" /* AGENT */,
+          category: "UNKNOWN" /* UNKNOWN */,
+          details: {
+            agentName: this.name
+          },
+          text: "Error during agent getSpeakers"
+        }, e);
+      }
+      this.logger.trackException(err);
+      this.logger.error(err.toString());
+      throw err;
     }
   }
   toStep() {