mastra-ai/mastra
Documented errors, page 17 of 22. Back to mastra-ai/mastra
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Factory transition message must be an object. | validation | error | validation, factory-rules, type-error |
| No agent or agent controller found with id | exception | error | validation, agents, slack |
| Notification was not found for thread | exception | error | notifications, tool, not-found |
OBSERVABILITY_STORAGE_BATCH_CREATE_SCORES_NOT_IMPLEMENTED This storage provider does not support batch creating scores | error_code | error | storage, observability, not-implemented, scores, batch |
| Project repository not found for this integration. | exception | error | source-control, not-found, project-repository |
RUN_EXPERIMENT_SCORER_FAILED_TO_SCORE_TRAJECTORY Failed to run experiment: Error running trajectory scorer | error_code | error | evals, scorer, trajectory, error-wrapping |
| Run id is required | http | error | http-400, missing-parameter, tool-approval, server |
| The active sandbox provider does not support runtime GitHub… | exception | error | sandbox, github, token, capability-missing |
| Tried to create observation embedding index but no vector… | exception | error | memory, observational-memory, vector-store, configuration |
| API key not found for provider | exception | error | authentication, api-key, environment |
| Custom Subconscious reflection agent | exception | error | configuration, validation, observational-memory |
| Encountered unknown role | exception | error | message-conversion, invalid-role, ai-sdk-v5 |
| File not found in skill version tree | exception | error | filesystem, skills, versioning, not-found |
| [QueueHealthStorage] thresholdsSeconds must be strictly… | validation | error | validation, config, ordering, queue-health |
| Sandbox provider " " does not support executeCommand, which… | exception | error | sandbox, worker, capability |
| Session refresh not configured | http | error | http-404, session, auth-configuration |
| The "extra" key is now nested under "mcp.extra" in tool… | exception | error | mcp, migration, breaking-change, tools |
| AcpAgent does not support resuming suspended stream calls | exception | error | storage, adapter, agents-store, server, http-500 |
| addMessage is deprecated. Please use saveMessages instead. | exception | error | memory, deprecation, api-migration, messages |
| `computeNextFireAt` is not available in this version of… | exception | error | version-mismatch, schedules, cron, dependency |
| Failed to list repos | exception | error | http, github, fetch, rate-limit |
| Google RBAC roleMapping is required. | validation | error | configuration, rbac, google, validation |
| Invalid structured content for tool | validation | error | mcp, schema-validation, tools, zod |
| MemoryThread. () requires an agentId. Pass it via… | exception | error | api-misuse, typescript, client-js |
| metadata.avatarUrl contains invalid base64 | http | error | http-400, base64, encoding, validation |
| No previous studio deploy found. Pass a deploy ID or deploy… | exception | error | cli, studio, deploy, missing-deploy |
| No task: provide targetType+targetId or task | exception | error | configuration, experiment, invalid-argument, user-input |
| OrchestrationWorker requires Mastra instance | exception | error | worker, configuration, dependency-injection |
| Thread does not belong to the active resource | exception | error | memory, authorization, multi-tenancy |
| Woke sandbox but the Mastra server did not become healthy at | exception | error | sandbox, health-check, timeout, deployment |
| WorkOS provider requested but the active factory auth… | exception | error | auth, workos, provider, guard |
| Workspace with id already exists | http | error | http-409, conflict, rest-api, storage |
| Channels require storage to be configured on the Mastra… | exception | error | configuration, storage, channels |
| Failed to load resources | exception | error | mcp, resources, callback |
| heartbeatMs must be a finite number no greater than | validation | error | sse, configuration, range-error, validation |
| No token verification method configured | exception | critical | auth, configuration, jwt, middleware |
| Notification is missing resourceId | exception | error | notifications, storage, data-integrity, resource-id |
| OAuth failed | exception | error | slack, oauth, authorization |
| Tool ' ' on remote MCP server ' ' has no execute method | exception | error | mcp, missing-execute, client-proxy |
AGENT_NETWORK_MEMORY_REQUIRED Memory is required for the agent network to function properly. Please configure… | error_code | error | agent-network, memory, configuration, missing-dependency |
| allowSystemBinaries: false is not supported by seatbelt… | validation | error | sandbox, macos, seatbelt, unsupported-config |
| Diagnostics output directory is unavailable. | exception | error | state-error, diagnostics, initialization |
| Failed to create directory | exception | error | filesystem, permissions, cli, directory |
| Memory is not initialized | http | error | memory, storage, configuration, threads |
| [Processor: ] sendStateSignal could not load thread | exception | error | agent, processors, memory, thread-not-found |
| Repository not found for this organization. | exception | error | storage, not-found, github |
| Unknown provider | exception | error | configuration, validation, provider-registry |
| Failed to stream workflow | http | error | network, streaming, workflow |
| Google ID token has expired | exception | error | oauth, jwt, expired, token-validation, google |
| HTTP error! status | http | error | http, network, client-js |
| Media type is missing for file part | exception | error | file-part, mime-type, conversion |
| Multiple environments found | exception | error | cli, mastra-cloud, ambiguity, environments |
| No CDP session available | exception | error | browser, cdp, input, session |
| No workflow registered with id | exception | error | workflow, mastra, not-found, lookup |
OBSERVABILITY_UPDATE_SPAN_NOT_FOUND Trace not found for span update | error_code | error | storage, observability, tracing, not-found, in-memory |
| Observational memory is not enabled | exception | error | memory, observational-memory, feature-flag, configuration |
| Push notification URL must not target local or internal… | validation | error | a2a, ssrf, security, localhost |
| Refresh failed | exception | error | cli, auth, refresh-token, session |
| Storage is required for tool approval lookups | exception | error | storage, channels, tool-approval |
| Subconscious requires a knowledge storage domain. Configure… | validation | error | storage, subconscious, configuration, compatibility |
| Trace not found for scoring, traceId | exception | error | observability, tracing, storage, score-traces |
| Unknown target type | exception | error | configuration, experiment, invalid-argument, user-input |
AZURE_GATEWAY_INVALID_CONFIG resourceName is required for Azure OpenAI gateway | validation | error | azure, configuration, gateway, missing-config |
| Broker election in progress by another process | exception | warning | pubsub, unix-socket, broker-election, lock-contention, retry |
| Cohere API key is required. Pass an apiKey or set… | exception | error | configuration, api-key, cohere, environment |
| Could not resolve the sandbox home directory. Pass… | exception | error | sandbox, deploy, configuration |
| create-workflow failed: save-workflow was called but did… | exception | error | workflows, persistence, sub-agent |
EXPERIMENTS_STORE_NOT_AVAILABLE Experiments store not available. Ensure your storage adapter provides an… | error_code | error | storage, experiments, adapter-compatibility |
| GitHub repository is invalid. | exception | error | validation, github, slug |
| Invalid agent-builder action | http | error | agent-builder, http-400, validation, workflow-registry |
| Invalid relevance score returned by model | exception | error | llm, parsing, rerank, response-parsing |
| Session workspace is not available | exception | error | workspace, session, lifecycle |
AGENT_STREAM_FAILED AGENT_STREAM_FAILED | error_code | error | agent, streaming, execution-failed, wrapped-error |
| buildHdrl internal error: wrote | exception | error | avi, internal-bug, header, invariant |
| Invalid filter format | validation | error | json, parsing, rag |
| Invalid input: must be an array of message IDs or message… | validation | error | memory, input-validation, api-misuse |
| Invalid skill name " ". Names must start with alphanumeric… | http | error | http-400, validation, naming, skills |
| MCP client with id already exists | exception | error | storage, duplicate-id, mcp-client, in-memory |
| Sandbox provider " " does not support executeCommand, which… | exception | error | sandbox, capability, deploy |
| Saw incompatible message content part type | exception | error | message-conversion, ai-sdk-v4, tool-messages, prompt |
| Tool not found | http | error | http-404, tools, not-found, api |
| Unknown phase | validation | error | http-400, processors, invalid-parameter |
| Chunks and embeddings must have the same length | validation | error | rag, length-mismatch, embedding, validation |
| Connection not found for provider | http | error | http-404, tool-providers, not-found, api |
| ExperimentsStorage not configured. | exception | error | storage, configuration, experiments, analytics |
| Invalid JSON in presets file | validation | error | cli, json, config, parse-error |
| ModelByInputTokens requires a valid model target for… | validation | error | config, validation, observational-memory |
| No embeddings generated | exception | error | embeddings, empty-input, validation, fastembed |
| No mount for path | exception | error | workspace, filesystem, path-resolution, mount |
| Query embedding must have dimension | validation | error | rag, dimension-mismatch, embedding, query |
| session has no active thread | http | error | http-400, session, thread, objective |
| Tool parameters are required | exception | error | tool-builder, input-schema, v5, validation |
AGENT_GENERATE_LEGACY_STRUCTURED_OUTPUT_NOT_SUPPORTED This method does not support structured output. Please use generate() instead. | error_code | error | agent, deprecated-api, structured-output, migration |
DURABLE_AGENT_LIST_ACTIVE_RUNS_INVALID_PER_PAGE DurableAgent " " listActiveRuns() requires perPage to be a positive integer. | error_code | warning | durable-agent, pagination, validation, arguments |
| GitHub CLI is not authenticated. Run gh auth login, then… | exception | error | github-cli, authentication, plugins, environment |
| Invalid file path " ". Path traversal is not allowed. | validation | warning | security, path-traversal, http-400, skills |
| Mastra is not registered with this manager | exception | critical | background-tasks, configuration, mastra |
OBSERVABILITY_MISSING_RECORD_ID Observability record is missing required id field | error_code | error | storage, observability, validation, missing-id |
| Observational Memory processor not available | http | error | configuration, processors, observational-memory, version-mismatch |
PROCESSOR_RETURNED_MESSAGES_AND_MESSAGE_LIST Processor returned both messages and messageList. Only one of these is allowed. | error_code | error | processors, input-step, return-shape, user-error |