mastra-ai/mastra
Documented errors, page 3 of 22. Back to mastra-ai/mastra
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| No snapshot found for this workflow run | exception | error | workflow, storage, resume, snapshot |
| Telegram failed | exception | error | telegram, api, network, rate-limit |
| ${validationResult.error || 'invalid_token'} | http | error | oauth, authentication, http-401, mcp |
| Failed to resolve created agent | http | error | storage, resolution, http-500, read-after-write |
| No exports are available from the top-level… | exception | error | imports, module-resolution, package-exports |
| Registry not found | http | error | http-404, builder-registry, feature-flag |
| Snapshot has mismatch : Snapshot: Run with to update. | exception | error | testing, snapshot, deep-equality, spans |
| TokenCostControl requires observability storage with… | exception | critical | storage, observability, configuration, registration |
| Factory project is required | exception | error | react-query, guard-clause, missing-parameter, factory-ui |
| No template selected | exception | error | cli, template, input-validation, programmatic-api |
| TRIPWIRE | exception | info | mastra-server, processor, tripwire, abort, control-flow |
| Access denied: unable to verify message ownership | http | error | http-403, authorization, storage, multi-tenancy |
| Observer produced degenerate output after retry. | exception | error | llm-output, degenerate-repetition, observational-memory, model-quality |
| The server did not persist the requested settings | exception | error | consistency, agent-controller, verification, react-query |
| A theme snapshot is required | exception | error | validation, react-query, signals, defensive-check |
| Answer Similarity Scorer requires ground truth to be… | validation | error | evals, scorer, llm-judge, answer-similarity, ground-truth |
| Failed to fetch user info from Clerk | http | error | auth, clerk, oauth, network, userinfo |
| Item not found in dataset | http | error | http-404, datasets, rest-api, identifier-mismatch |
| Select a repository before starting a Factory run | exception | error | guard-clause, state-management, factory-ui, react-query |
| ChannelSessionRejectedError | exception | error | channels, session, wrapped-error |
| Directory not found | exception | error | filesystem, sandbox, readdir |
| No response body for agent controller session stream | http | error | streaming, null, http, agent-controller |
OBSERVABILITY_STORAGE_LIST_LOGS_NOT_IMPLEMENTED This storage provider does not support listing logs | error_code | error | storage, observability, not-implemented, logs, query |
| Platform connection response missing DATABASE_URL. | exception | error | platform-api, neon, missing-env-var, contract-violation |
SCHEDULES_INVALID_SIGNAL_TYPE Schedule : unknown signalType " ". Expected one of: . | error_code | error | schedules, enum, validation, user-error |
| SpanConverter not initialized correctly | exception | critical | opentelemetry, initialization, tracing, lifecycle |
| Could not find API key process.env. | exception | error | environment, api-key, configuration, model-gateway |
| Either expectedTool or expectedToolOrder must be provided | validation | error | evals, scorer, tool-call-accuracy, config |
| Invalid Copilot token response fields | exception | error | github-copilot, token-refresh, schema-validation, response-shape |
| MastraFactory.prepare() called twice | validation | error | lifecycle, double-initialization, concurrency |
PROCESSOR_RETURNED_EXTERNAL_MESSAGE_LIST Processor returned a MessageList instance other than the one passed in. Use the… | error_code | error | workflow, processor, messagelist |
| SignalsPubSub is closed | exception | error | pubsub, lifecycle, unix-socket, use-after-close |
source_control_missing_or_source_repository_missing error.message (dynamic; FactorySourceSessionResolutionError) | error_code | error | source-control, repository, dispatch, error-mapping |
| Unhandled content part type | exception | error | typescript, message-conversion, ai-sdk |
| Notification summary is missing resourceId | exception | error | notifications, missing-field, runtime |
| Semantic recall requires an embedder to be… | validation | error | memory, semantic-recall, configuration, missing-embedder |
| UnknownToolProviderError.message | http | error | http-404, tool-providers, server, configuration |
| Factory rule decision type is unsupported. | validation | error | validation, unsupported-type, factory-rules |
| FileExistsError | error_code | error | filesystem, sandbox, file-exists, write-conflict |
| Mastra instance or getMCPServerById method not available | http | error | server, mastra-instance, mcp, api-contract |
| SankeyChart must be used within Sankey | exception | error | react, context, provider-missing, charts |
| Factory runs require one exclusive destination stage | exception | error | guard-clause, validation, factory-ui, domain-rules |
| invalid API key or insufficient permissions | http | error | auth, http-401, http-403, api-key, network |
SEMANTIC_RECALL_MISSING_STORAGE_ADAPTER Using Mastra Memory semantic recall requires a storage adapter but no attached… | error_code | error | memory, storage, semantic-recall, configuration |
| Structured output returned no object | exception | error | llm, structured-output, runtime, detection |
| must contain a JSON object. | validation | error | json, llm-output, parsing, observational-memory |
| No Copilot bearer token | exception | warning | auth, oauth, github-copilot, token-refresh |
| Access denied: agent has no memory configured to validate… | http | error | http-403, access-denied, memory, security, thread-ownership |
ENOENT File not found | exception | error | filesystem, enoent, file-not-found |
| Invalid Kimi For Coding device authorization response | exception | error | oauth, device-flow, schema-validation, response-parsing, kimi-coding |
| @mastra/deployer-sandbox/client is server-only: resolving a… | exception | error | browser, server-only, security, credentials |
| MastraFactory.finalize() called before prepare() | validation | error | lifecycle, initialization-order, api-misuse |
| No context available for evaluation | validation | error | evals, scorer, context-precision, runtime |
| OpenAISDKAgent resumeData must include previousResponseId… | validation | error | validation, resume, openai, argument-error |
| UnixSocketPubSub is not connected to a broker | exception | error | pubsub, ipc, connection, lifecycle |
| Knowledge merge cycle detected at | exception | critical | knowledge, merge, cycle, corruption, concurrency |
| License server rate limited | exception | warning | license, rate-limit, throttling, transient |
| Model not allowed by allowlist | error_code | error | allowlist, authorization, agent-builder, model-policy |
| Database provisioning failed | exception | error | provisioning, cloud-provider, polling, cli |
| Directory not found: . | exception | error | cli, filesystem, argument-validation, deploy |
| Factory linked work item URL is invalid. | validation | error | validation, url, factory-rules |
| Failed to delete session | exception | error | http, fetch, delete, network |
| Failed to rename session | exception | error | http, fetch, rename, network, llm |
| New observability endpoints require @mastra/core >= 1.13.2… | http | error | observability, version-mismatch, http-501, upgrade |
AGENT_FS_ROUTING_SUBAGENT_NAME_COLLISION Agent " ": duplicate subagent " " under agents/ /subagents/. | error_code | error | agent, subagents, naming-collision, filesystem-routing |
| Deploy timed out | exception | error | timeout, deploy, polling |
| Invalid ENV key | validation | error | env, validation, cli-services |
| Invalid model string format | exception | error | validation, configuration, model-router |
| [mastra/auth-ee] configured but the EE module… | exception | critical | licensing, enterprise, module-resolution, version-mismatch, startup |
| The chunking function must return a non-empty string. | validation | error | streaming, smooth-stream, validation, typeerror |
| Noise example queries require a trace signal and snapshot | exception | error | validation, react-query, signals, defensive-check |
SCHEDULES_MISSING_MODE Schedule : set exactly one execution mode — provide a non-empty 'prompt' or a… | error_code | error | schedules, configuration, validation, user-error |
| skillPath is missing SKILL.md | http | error | filesystem, validation, skills, http-400 |
| Tracing instance ' ' already registered | exception | error | configuration, registry, duplicate-key, tracing |
| Unhandled toolInvocation.state | exception | error | agent, message-conversion, tool-invocation, aiv6 |
| Linear cursor is invalid. | validation | error | linear, cursor, parsing, json |
| Mount " " not found. Available mounts | http | error | workspace, filesystem, mount, bad-request, skill-install |
| No active run to approve tool call for | exception | error | agent, tool-approval, lifecycle |
| Step " " is not a prompt object | exception | error | scorer, configuration, llm-judge |
| Stored resource not found | http | error | http-404, resource-scope, access-control, agent-versions |
| Authentication required | http | error | authentication, http-401, server, favorites |
| MCPClient was initialized multiple times with the same… | exception | error | mcp, memory-leak, duplicate-instance, lifecycle |
OBSERVABILITY_STORAGE_LIST_SCORES_NOT_IMPLEMENTED This storage provider does not support listing scores | error_code | error | storage, observability, not-implemented, scores |
| Restart was accepted but no deploy ID could be resolved… | exception | error | cli, deploy, platform, timeout |
| Stored resource scope is required | http | error | http-403, resource-scope, agent-versions |
| Subconscious learn requires the main agent to resolve its… | exception | error | configuration, model-resolution, observational-memory |
| The chunking RegExp must match a non-empty string. | validation | error | streaming, smooth-stream, regex, validation |
| Cannot time travel to step | exception | error | workflows, time-travel, snapshot-mismatch, execution-graph |
| Inputs cannot be null or undefined | validation | error | evals, scorer, completeness, null-validation |
| Invalid authorization state | validation | error | oauth, anthropic, pkce, csrf, state-mismatch |
| Knowledge semantic index | exception | warning | semantic-index, stale-index, embeddings |
| Knowledge semantic index is stale: a visible operation is… | exception | warning | concurrency, outbox, stale-index |
OBSERVABILITY_STORAGE_UPDATE_SPAN_NOT_IMPLEMENTED This storage provider does not support updating spans | error_code | error | storage, observability, tracing, unsupported-operation |
| Trace ID is required | exception | error | react-query, precondition, traces, playground-ui |
| A file or directory named | exception | error | cli, filesystem, conflict, already-exists |
| Factory kickoff run ended in error. | exception | error | factory, agent-run, error-propagation, retry |
FEATURE_NOT_SUPPORTED Sandbox does not support processes | error_code | error | sandbox, processes, feature-not-supported, workspace-tools |
| IsDirectoryError | error_code | error | filesystem, read-file, directory, typed-error |
| Merged knowledge node is not visible from scope | exception | error | knowledge-store, scope-visibility, merge-conflict, inmemory |
REQUEST_TIMEOUT REQUEST_TIMEOUT: Request timed out after | error_code | error | network, timeout, cli, http |