mastra-ai/mastra
Documented errors, page 11 of 22. Back to mastra-ai/mastra
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| SchemaValidationError(field… | validation | error | validation, schema, zod, datasets |
| Workspace with id not found | exception | error | storage, workspace, not-found, in-memory |
| Authentication for MCP server | exception | info | mcp, oauth, abort, cancellation |
AZURE_AD_TOKEN_ERROR Failed to get Azure AD token | http | error | azure, authentication, oauth, entra-id, http |
| Batch embedder returned no embedding for input text. | exception | error | embeddings, batch-embedder, vector-search, contract-violation |
| countCoreSystemMessageTokens can only be used with system… | exception | error | internal-invariant, processors, message-list, typescript |
| Credential storage is not available | exception | critical | oauth, configuration, storage, missing-dependency |
DURABLE_AGENT_RESUME_INVALID_SNAPSHOT DurableAgent " " resume( ): persisted snapshot does not contain a durable-agent… | error_code | error | durable-agent, snapshot, schema-mismatch |
| ${errorData.message || 'Invalid email or password'} | http | error | authentication, credentials, better-auth, http-4xx |
| Factory storage domain | exception | error | storage, initialization, lifecycle |
| Failed to clone repository | exception | critical | git, network, fallback-failure |
| Failed to copy studio assets from | exception | error | deployer, vercel, filesystem, build |
| FGA authorization denied: authenticated user is required | http | error | http-403, fga, authorization, authentication |
INVALID_MESSAGE_CONTENT Message with role " " must have either a 'content' property (string or array)… | error_code | error | message-list, validation, empty-content |
MASTRA_ADD_WORKSPACE_MISSING_AGENT_METADATA Agent workspaces must include agentId and agentName. | error_code | error | workspace, metadata, validation, configuration |
| Redirect URI is required for Google SSO. Set… | validation | error | oauth, configuration, redirect-uri, google, sso |
| ${result.reason} | exception | error | board-transition, server-rejection, react-query, state-conflict |
| Rule metadata must use plain objects. | validation | error | validation, json, plain-object |
| wrapWithWriteLock: input.path is required | exception | error | write-lock, missing-argument, input-validation, workspace-tools |
| agent controller " " not found | http | error | http-404, agent-controller, not-found, configuration |
| Default mode not found | exception | error | configuration, agent-controller, default-mode, startup |
| Failed to create LSP process with proper stdio | exception | error | lsp, stdio, process |
| Invalid arguments for firecrawl_generate_llmstxt | exception | error | mcp, validation, tool-arguments, firecrawl |
| Knowledge semantic index remained stale after | exception | warning | outbox, backlog, stale-index |
| list-available-tools requires a Mastra context. | exception | error | mastra, configuration, runtime-context, tools |
MCP_CLIENT_REDIRECT_MISSING_LOCATION Received a redirect with no Location header from " " while following redirects… | error_code | error | mcp, redirect, network, url-policy |
| Method not implemented | exception | error | abstract-method, integration, api-client, not-implemented |
NETLIFY_GATEWAY_NO_SITE_ID Missing NETLIFY_SITE_ID environment variable required for model | error_code | error | env-var, netlify, configuration, gateway |
| Observational memory requires @mastra/core support for… | exception | error | memory, observational-memory, version-compatibility, upgrade |
| Parallel returned no output | exception | error | web-search, empty-result, tool-output |
| must contain only finite numbers. | validation | error | validation, json, workflow-builder |
| Source-control installation not found for this organization… | exception | error | source-control, installation, not-found, storage |
STRUCTURED_OUTPUT_OPTIONS_REQUIRED structuredOutput is required to use tryGenerateWithJsonFallback | error_code | error | structured-output, agent, missing-argument, zod |
| ClaudeSDKAgent resumeData must include sessionId or… | validation | error | resume, validation, argument-validation, claude |
| must be used within EnvironmentVariablesEditor.Root | exception | error | react, context, compound-components, playground-ui |
| error.message (schema validation error, cause: field/errors) | http | error | http-400, schema-validation, zod, datasets, batch-insert |
FAIL_CUSTOM_INSTALL_COMMAND FAIL_CUSTOM_INSTALL_COMMAND | error_code | error | install, deployment, shell, subprocess |
| GitHub id must be a positive integer. | validation | error | github, validation, id-parsing, pull-request |
| Knowledge node already exists | exception | error | knowledge-store, duplicate-id, inmemory, idempotency |
| references unknown namespace " ". Use one of: . | exception | error | workflows, mapping-template, template-validation |
| @mastra/livekit: no workflow specified. Set `workflow` on… | validation | error | configuration, workflows, livekit |
MISSING_ARGUMENT MISSING_ARGUMENT: Missing required argument < | error_code | error | cli, argument-validation, url |
| No buffered reflection to swap | exception | error | memory, observational-memory, state-conflict |
| No env file found for deploy. Add a .env or .env.* file… | exception | error | cli, env, deploy, configuration |
OBSERVABILITY_STORAGE_CREATE_SCORE_NOT_IMPLEMENTED This storage provider does not support creating scores | error_code | error | storage, observability, not-implemented, scores |
| Storage is not initialized | exception | critical | storage, configuration, background-tasks |
| does not support zod type | exception | error | zod, schema, unsupported-type |
| Cannot launch browser in | exception | error | browser-lifecycle, state-machine, race-condition |
DURABLE_AGENT_RECOVER_AGENT_MISMATCH DurableAgent " " recover( ): persisted run belongs to agent " ", not " ". | error_code | error | durable-agent, recovery, ownership, agent-mismatch, user-input |
| @mastra/livekit: no fetch implementation available; pass… | exception | error | environment, network, runtime-compatibility, livekit |
MASTRA_MEMORY_STORAGE_NOT_AVAILABLE Memory storage is not supported by this storage adapter | error_code | error | memory, storage, adapter, unsupported |
| ${message} | exception | error | json-schema, zod, schema-conversion |
MESSAGE_HISTORY_MISSING_STORAGE_ADAPTER Using Mastra Memory message history requires a storage adapter but no attached… | error_code | critical | memory, message-history, storage, configuration |
| Nested mount paths are not supported | exception | error | workspace, filesystem, configuration, path-collision |
| No arguments provided | exception | error | mcp, validation, missing-arguments |
OBSERVABILITY_STORAGE_GET_SERVICE_NAMES_NOT_IMPLEMENTED This storage provider does not support service name discovery | error_code | warning | storage, observability, not-implemented, telemetry |
STRUCTURED_OUTPUT_PROCESSOR_MODEL_REQUIRED StructuredOutputProcessor requires a model to be provided either in options or… | error_code | error | configuration, model, structured-output, constructor |
| Tripwire triggered in workflow | exception | error | tripwire, workflows, processors, abort |
| Unknown chunk type | exception | error | streaming, aisdk, exhaustiveness, internals |
| Worker must stay within the deployed artifact root. | validation | error | validation, path-traversal, security, worker |
| Async validation is not supported | exception | error | schema, async, ai-sdk |
| If the attachment is not an image, it must specify a… | exception | error | attachment, mime-type, validation |
| Invalid audit portal response | validation | error | schema-validation, http, audit, api-contract |
| Invalid parameters for | validation | error | rag, chunking, validation, zod, configuration |
| Neon Auth base URL is required, please provide it in the… | validation | error | auth, neon, configuration, env |
| No upload URL returned | exception | error | api, upload, contract-mismatch |
| Observational memory is not implemented by this storage… | exception | error | storage, observational-memory, unimplemented-method |
| OrchestrationWorker not initialized | exception | error | worker, lifecycle, race-condition |
| page must be a non-negative integer | http | error | http-400, workflows, pagination, validation, server-api |
| Rule metadata must not contain cycles. | validation | error | validation, json, cycles |
WORKING_MEMORY_MISSING_STORAGE_ADAPTER Using Mastra Memory working memory requires a storage adapter but no attached… | error_code | critical | memory, working-memory, storage, configuration |
| AcpAgent does not support resuming suspended generate calls | exception | error | storage, configuration, server, http-500 |
AGENT_INPUT_STEP_PROCESSOR_ERROR [Agent: ] - Input step processor error | error_code | error | agent, step-processor, user-code, mastra-error |
AGENT_SEND_TOOL_APPROVAL_NO_ACTIVE_THREAD_RUN Agent " " sendToolApproval() could not find an active or suspended run for… | error_code | error | agent, tool-approval, no-active-run, state-not-found, user-input |
| Cannot register run : thread is already active with run | exception | error | concurrency, threads, streaming, conflict |
| Could not resolve current thread. | exception | error | memory, thread-id, tool-context, sentinel-value |
| resolved to a value that could not be JSON-stringified ( )… | exception | error | workflow, template, serialization, json |
| Directory not found in skill version tree | exception | error | filesystem, skills, versioning, not-found |
EXPERIMENT_NO_ITEMS Cannot run experiment: dataset | error_code | error | storage, dataset, experiment, empty-data |
| Failed to parse working memory input as JSON | exception | error | memory, working-memory, json, llm-output, parsing |
| GC event buffer exceeded | exception | warning | gc, buffer-overflow, diagnostics |
| Invalid route path: " ". Path cannot contain '..', '?', or… | exception | error | routes, validation, path-traversal |
| knowledge_update_node requires at least one of: name, kind. | exception | error | tool-input-validation, knowledge-update, missing-argument, llm-tool-call |
| ${moved.code}: ${moved.reason} | exception | error | rules-engine, stage-transition, dispatch, factory |
| Okta domain is required. Provide it in the options or set… | validation | error | config, env-var, okta, constructor |
DATASET_NOT_FOUND Dataset not found | error_code | error | not-found, datasets, multi-tenancy |
| Invalid \`mediaTypes\` pattern | validation | error | validation, mime-type, media-types, input-validation |
| Invalid URL | exception | error | url, attachment, validation |
| Knowledge tools require requestContext.organizationId. | exception | error | configuration, request-context, multi-tenancy, knowledge-tools |
| @mastra/livekit: set LIVEKIT_API_KEY and LIVEKIT_API_SECRET… | validation | error | configuration, credentials, environment-variables, livekit |
| MASTRA_ORG_ID and MASTRA_PROJECT_ID (or --org/--project… | exception | error | cli, ci, env-vars, headless |
| MCP server ' ' not found | http | error | mcp, http-404, server-config |
NO_SCORERS_PROVIDED At least one scorer or gate must be provided | error_code | error | evals, configuration, validation |
| Plugin path for " " must be inside the plugin directory | validation | error | security, path-traversal, plugin-loading, registry |
| Project has multiple environments ( ). Pass an environment… | exception | error | cli, ambiguity, non-interactive, environment |
| runId required to stream workflow | http | warning | http-400, validation, missing-parameter, streaming |
| Sandbox ' ' onStart hook failed | exception | error | sandbox, lifecycle-hook, startup |
| Saw text content for input ModelMessage, but the role is | exception | error | message-conversion, ai-sdk-v5, tool-messages, prompt |
AGENT_FS_ROUTING_SUBAGENT_DESCRIPTION_REQUIRED Agent " ": subagent " " requires a non-empty 'description'. Set one in agents/… | error_code | error | agent, subagents, validation, config |
| Could not connect to server with any available HTTP… | exception | critical | mcp, network, http, sse, transport, connection |