mastra-ai/mastra
Documented errors, page 9 of 22. Back to mastra-ai/mastra
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| observationalMemory.experimental_subconscious must be a… | validation | error | configuration, validation, typescript, observational-memory |
source_control_missing error.message (dynamic; SourceControlConnectionNotFoundError) | error_code | error | source-control, connection, dispatch, error-mapping |
| Stored agent with id | http | error | http-404, stored-agents, authorization |
| Tripwire triggered by | exception | warning | workflow, processor, tripwire, abort |
| API key not found for provider mastra. Set… | exception | error | authentication, api-key, environment, configuration |
| Embedder returned no usable embedding for the dimension… | exception | error | memory, embedder, dimension-probe, empty-response |
| Failed to fetch CDP version info from | http | error | network, cdp, http-error, browser |
| KnowledgeRecord when must be a valid date. | exception | error | date-parsing, input-validation, knowledge-append, iso-8601 |
OBSERVABILITY_STORAGE_GET_METRIC_LABEL_KEYS_NOT_IMPLEMENTED This storage provider does not support metric label key discovery | error_code | warning | storage, observability, not-implemented, metrics |
| Sandbox ' ' default cwd probe failed (exit ) | exception | error | sandbox, remote-execution, shell-probe, infrastructure |
| Sub-agent returned a v1 model but does not implement… | exception | error | agent, delegation, sub-agent, model-version, v1-legacy, compatibility |
| Updating the Edge Config alias requires a Vercel API token… | validation | error | vercel, edge-config, missing-token, configuration |
| conversation_id and previous_response_id must reference the… | http | error | server, validation, http-400, responses-api |
| Could not find config for provider | exception | error | models-dev, configuration, provider, model-id |
DATASET_ITEM_EXTERNAL_ID_INVALID Dataset item externalId must be a non-empty string. | error_code | error | storage, datasets, validation, user-input |
| Failed to resolve updated skill | http | error | storage, consistency, http-500, update |
| [mastra/auth-ee] FGA is configured but | exception | error | auth, fga, routes, configuration |
| MastraClient.deleteThread() requires exactly one of agentId… | validation | error | client, validation, memory |
| Memory instance is required for recall | exception | error | validation, memory, configuration, dependency-injection |
| Output directory does not exist | exception | error | cli, filesystem, missing-directory, build |
| Skill with id " " already exists. | http | warning | http-409, builder-registry, skills, conflict |
| Subconscious remind requires organizationId in the request… | exception | error | missing-context, multi-tenancy, configuration |
| Access denied: thread not found | http | error | http-403, access-denied, thread-not-found, security |
| Could not find skill | http | error | http-404, skills-api, not-found |
| Could not generate title from input | exception | error | agent, memory, title-generation, invalid-input |
| Embedder returned no vector for knowledge search query. | exception | error | embeddings, semantic-search, integration |
| Factory decision is not linked to a work item. | exception | error | data-integrity, factory, dispatch, missing-link |
| Missing environment variable | exception | error | environment, url, configuration, models-dev |
| No active run to decline tool call for | exception | error | agent, tool-approval, lifecycle |
| Not enough free disk space to compact | exception | error | disk-space, sqlite, vacuum, filesystem |
| Registry " " does not have a servers endpoint. | exception | error | configuration, mcp, validation |
| Unknown chunking strategy | validation | error | rag, chunking, validation, configuration |
| Unsupported JWS algorithm for A2A Agent Card signing | exception | error | jws, a2a, crypto, config |
| You have no organizations. Please create one at | exception | error | onboarding, configuration, cli, deploy |
| Browser is and cannot be used | exception | error | browser-lifecycle, state-machine, concurrency |
| Could not load tiktoken encoding. Please install it with… | exception | error | rag, tiktoken, missing-dependency, tokenizer |
| degit completed without cloning template files | exception | error | network, degit, cloning, scaffolding |
| ${errorInfo.message} | exception | error | background-tasks, workflow, task-failure, error-propagation |
| Failed to upload artifact | exception | error | upload, network, http, artifact |
| Location ' ' not found | exception | error | network, external-api, geocoding |
MASTRA_GET_PROMPT_BLOCK_NOT_FOUND Prompt block with key | error_code | error | lookup-failed, prompt-block, user-input |
MCP_SERVER_MODERN_HTTP_OPTIONS_INCOMPATIBLE startHTTP options "`).join(', ')} are incompatible with protocolVersion… | error_code | error | configuration, mcp, http, protocol-version |
MCP_SERVER_RESOURCES_NOT_CONFIGURED MCP_SERVER_RESOURCES_NOT_CONFIGURED | error_code | error | mcp, resources, configuration, missing-handler |
| No result received from agent execution on iteration | exception | error | agent, streaming, structured-output, workflow-builder |
| Sandbox workspace root resolution returned an empty path | exception | error | sandbox, filesystem, initialization |
skill_invocation_failed Skill invocation failed | http | error | http, network, api-error, proxy |
| Source control provider cannot open change requests | http | error | http-400, source-control, feature-availability |
| VectorStoreResolver returned invalid value: expected… | exception | error | configuration, validation, tool, vector-store |
| Agents storage domain is not available | http | error | storage, server, agent-versions, configuration |
| [FactorySecretEncryption] Duplicate key id | exception | error | configuration, key-rotation, duplicate-key, validation |
INVALID_METHOD_TYPE INVALID_METHOD_TYPE | error_code | error | agent, typescript, invalid-argument, user-error |
| Mastra Code requires Corepack to install GitHub plugin… | exception | error | corepack, missing-binary, plugins, environment |
NETLIFY_GATEWAY_TOKEN_ERROR Failed to get Netlify AI Gateway token for model | error_code | error | netlify, authentication, gateway, network |
| No workspace with skills configured | http | error | http-404, skills, workspace, configuration |
| Noise queries require a trace signal and snapshot | exception | error | validation, react-query, signals, defensive-check |
OBSERVABILITY_STORAGE_GET_ENTITY_NAMES_NOT_IMPLEMENTED This storage provider does not support entity name discovery | error_code | warning | storage, observability, not-implemented, telemetry |
| Plugin tool " " is no longer available | exception | error | plugin, hot-reload, stale-reference, tools |
| Telegram getMe returned a non-bot user; expected a… | validation | error | telegram, authentication, configuration |
| Version number already exists for prompt block | exception | error | storage, duplicate-key, prompt-blocks, in-memory |
| Access denied: unable to verify message thread access | http | error | memory, authorization, http-403 |
| Connect a repository before deleting a workspace | exception | error | prerequisite, configuration, factory-ui, react-query |
| Experiment emitted multiple terminal semantic events | exception | error | experiment, runtime, streaming, lifecycle |
| Failed to refresh the OpenAI Codex token. | exception | error | auth, oauth, openai-codex, token-refresh |
| command failed (exit ) | exception | error | sandbox, shell, build |
| Subconscious activity.recentUpdates must be an integer… | exception | error | configuration, validation, subconscious |
| Unable to verify referenced prompt blocks | http | error | http-400, validation, agent-instructions, references |
AGENT_STREAM_UNKNOWN_ERROR An unknown error occurred while streaming | error_code | error | agent, streaming, unknown-status, mastra-core |
| configDirName must be a non-empty directory name | validation | error | configuration, validation, argument-error |
| Environment variable keys must be unique | validation | error | validation, environment-variables, duplicate-key, playground-ui |
| Invalid signal XML | exception | error | signals, xml, validation |
| JWT auth secret is required | exception | critical | jwt, auth, config, env |
| MastraAuthBetterAuth needs a database to build its own… | validation | error | configuration, database, better-auth, storage |
| No response body | http | error | streaming, null, memory, subscription |
| [Processor: ] computeStateSignal requires Mastra memory… | exception | error | processors, memory, configuration, state-signal |
| Random walk steps must be greater than 0 | validation | error | validation, parameters, graph-rag |
| record | exception | error | knowledge, not-found, scope, rescope |
| ${this.latestError} | exception | error | inspector, cdp, heap-profiler, network |
| vectorStore option is not a valid MastraVector instance: got | validation | error | configuration, type-mismatch, rag |
| Access denied: cannot save messages for a different resource | http | error | http-403, authorization, multi-tenancy, memory |
| agent signals are not supported by this Mastra core version | http | error | http-501, version-compatibility, agent-signals, server |
| Cannot flatten intersections with overlapping keys | exception | error | zod, zod-v4, intersection |
| Could not create the session | exception | error | react-query, mutation, error-wrapping, network |
| Dataset item identity history is corrupt for externalId | exception | error | storage, datasets, data-corruption, scd2 |
| Editor is not configured | http | error | http-500, configuration, editor, processor-providers |
| Embedding dimension must be | validation | error | rag, graph-rag, embedding, dimension-mismatch |
| Failed to resolve created MCP client | http | error | storage, mcp, internal, consistency, http-500 |
| Failed to resolve updated prompt block | http | error | storage, server, internal-error |
| GithubIntegration: missing required config field(s) | validation | error | config, github, startup |
| GithubReconcileWorker: call init() before start() | validation | error | lifecycle, github, initialization-order |
INVALID_AGENT_SCORERS Agent scorers must be an array of scorers or an AgentScorerConfig | error_code | error | evals, typescript, configuration |
| @mastra/livekit: the agent requested tool approval or… | exception | error | human-in-the-loop, tools, voice, unsupported-feature, livekit |
| No thread ID available. Start a session before building… | exception | error | evals, session, precondition |
push-failed Refusing to push: invalid repo full name | exception | error | git, validation, security |
| runId required to restart workflow | http | error | http-400, missing-parameter, workflow, server-api |
| Subconscious remind requires a configured knowledge storage… | exception | error | configuration, storage, missing-domain |
| Worker resourceLimits. | validation | error | validation, types, worker, sandbox |
| Agent ' ' (key: ' ') must have a non-empty description to… | exception | error | mcp, agent, configuration, missing-description |
| Cannot start a destroyed sandbox | exception | error | lifecycle, sandbox, state, destroyed |
| Could not find skill | http | error | http-404, builder-registry, skills |
| Directory not found in composite skill source | exception | error | filesystem, skills, path-resolution, not-found |