mastra-ai/mastra
Documented errors, page 8 of 22. Back to mastra-ai/mastra
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Invalid knowledge node cursor. | exception | error | storage, knowledge, pagination, cursor, validation |
| Isolation backend ' ' is not available | exception | error | sandbox, isolation, environment, configuration |
MASTRA_ENTRY_FILE_NOT_FOUND MASTRA_ENTRY_FILE_NOT_FOUND | error_code | error | deployment, entry-file, filesystem, config |
| No registry entry found for run | exception | error | durable-agent, resume, not-found, storage |
| stagehand_close requires agent.threadId when browser scope… | exception | error | browser, tooling, misconfiguration |
| TokenCostControl requires warnAtPercent to be a number… | validation | error | configuration, validation, cost-control, constructor |
| ToolCall compounds must be rendered within ToolCall | exception | error | react, context, compound-components, provider-missing |
| Trace with ID ' ' not found | http | warning | http-404, observability, tracing, storage |
| A session workspace must be a valid Workspace instance. | exception | error | configuration, type-error, workspace |
| Choose valid components | validation | error | cli, argument-validation, commander |
| Could not find mastracode package root from | exception | error | filesystem, package-resolution, plugins |
| Could not save the mode model | exception | error | persistence, settings, storage, tui |
| Extractor metadataKeyPath | validation | error | observational-memory, security, prototype-pollution, input-validation |
| Invalid input: expected StepParams, Agent, ToolStep, or… | exception | error | workflow, validation, api-misuse, typescript |
| IsolatedVmCodeModeTransport requires the --no-node-snapshot… | exception | error | node, v8-isolate, startup-flags, code-mode |
| Scorer definitions storage domain is not available | http | error | storage, server, storage-adapter |
| The learner may record at most one skill per reflection. | exception | error | memory, skill-learning, rate-limit |
| Conditional (branch) step cannot be stored: closure… | exception | error | workflows, serialization, closure, conditional |
| createStagehand factory not set - required for thread scope | exception | error | config, dependency-injection, stagehand, thread-scope |
DURABLE_AGENT_LIST_ACTIVE_RUNS_NO_STORAGE DurableAgent " " listActiveRuns() requires storage to discover running runs… | error_code | error | storage, configuration, missing-dependency |
| Factory source control storage is unavailable | exception | error | configuration, dependency-injection, storage, missing-dependency |
MISSING_INPUT MISSING_INPUT: Command requires a single inline JSON input argument | error_code | error | cli, input-validation, json |
| Refusing to overwrite | exception | error | cli, filesystem, safety-guard |
| [ ] Cannot send notification: no agent connected. Was this… | exception | error | signals, wiring, initialization |
| Unsupported encryption algorithm | validation | error | crypto, decryption, data-format |
| Aborted by processor | exception | warning | processors, middleware, tripwire, aborted |
| BM25 search requires BM25 configuration. | validation | error | search, configuration, bm25, misconfiguration |
| Cannot approve a tool call without a current thread | exception | error | agent, tool-approval, thread |
| Invalid Copilot token response | exception | error | github-copilot, token-refresh, response-shape, network |
MCP_CLIENT_ON_LIST_CHANGED_TOOLS_FAILED MCP_CLIENT_ON_LIST_CHANGED_TOOLS_FAILED | error_code | error | mcp, tools, notification, connection |
| No workspace filesystem configured | http | error | workspace, http-404, filesystem, configuration |
| reflection.blockAfter requires reflection.bufferActivation… | validation | error | configuration, validation, observational-memory |
| Search failed | exception | error | network, api-error, firecrawl, auth |
| Skills storage domain is not available | http | error | http-500, storage, skills, version-mismatch |
| Slack OAuth response missing required fields (access_token… | validation | error | slack, oauth, response-validation |
| The cursor " " looks like a range. Use one of the… | exception | error | memory, cursor, format, observational-memory |
| Workflow not found | http | error | http-404, workflows, not-found, server-api |
| Attention read-all response is missing its continuation… | validation | error | pagination, api-contract, invariant, http |
| Auth check failed ( ) | http | error | auth, network, http, server-error |
| Bad Request: No valid session ID provided for… | http | error | mcp, http, session, bad-request, headers |
| Could not derive skill ID from registry skill metadata. | http | warning | http-400, builder-registry, skills, metadata |
| Directory already exists and is not empty | exception | error | filesystem, scaffold, conflict |
| Missing message source for message | exception | error | message-list, internal-state, invariant, agent |
| No mount for source | exception | error | filesystem, mount-resolution, composite-filesystem |
| must contain only plain objects. | validation | error | validation, json-serialization, workflow |
| skillPath does not exist on the server filesystem | http | warning | filesystem, bad-request, deployment |
| state signals cannot be transient | exception | error | signals, invalid-combination, state |
| TokenLimiterProcessor: No messages to process. Cannot send… | exception | error | tripwire, messages, runtime, token-limiter |
| Agent Card signature is missing a protected "alg" header | exception | error | jws, jose-header, agent-card, signature-verification |
| Failed to initialize task manager | exception | error | task-manager, workflow-builder, agent |
| Invalid : . Must start with a letter or underscore, contain… | validation | error | sql, validation, identifier, injection-prevention |
| Processor does not support input phase | validation | error | http-400, processors, phase-not-supported |
| Prompt injection detection failed | exception | error | processors, prompt-injection, error-wrapping |
DATASET_ID_CONFLICT Dataset ID " " is already in use with incompatible immutable fields | error_code | error | storage, datasets, conflict, immutability |
| error.message (MastraError rethrown with mapped status in… | http | error | server, error-mapping, experiments, results |
| Failed to update Edge Config alias | http | error | vercel, edge-config, http-error, api |
invalid-handle Knowledge record handle is invalid or expired. | error_code | error | knowledge-inspector, expired-token, opaque-handle |
| references stepResults. but step " " has no successful… | exception | error | workflow, template, step-results, ordering |
| Received input message with wrong resourceId. Input | exception | error | agent, memory, resource, input-validation |
| Access denied: tool call is not suspended on this durable… | http | error | http-403, durable-workflow, state-conflict, tool-call |
| Authentication failed / server-provided message | http | error | auth, authentication, credentials, http |
DEPLOYER_INVALID_PNPM_BUILD_APPROVAL_CONFIG Invalid pnpm configuration | error_code | error | pnpm, configuration, yaml, validation |
DURABLE_AGENT_RECOVER_INVALID_SNAPSHOT DurableAgent " " recover( ): persisted snapshot does not contain a… | error_code | error | durable-agent, recovery, snapshot, schema-mismatch, data-corruption |
| [FactorySecretEncryption] Key | exception | error | encryption, aes-256-gcm, key-length, configuration |
| Invalid Google ID token nonce | exception | error | oauth, openid-connect, nonce, security, token-validation |
| Invalid skill metadata in | validation | error | skills, validation, frontmatter, workspace |
| Notification is missing agentId | exception | error | notifications, storage, data-integrity |
| Platform GitHub event polling interval must be a positive… | validation | error | configuration, validation, github, worker |
| Subconscious remind requires a resourceId. | exception | error | missing-context, memory, configuration |
| targetType and targetId are required to start an experiment | http | error | validation, http-400, experiments, client-input |
unsupported_provider_item Factory skill invocation requires one exclusive board stage. | error_code | error | dispatch, board, validation, provider-item |
| Invalid metadata filter key | validation | error | validation, storage, metadata |
| RunScope: missing required slot | exception | error | run-scope, missing-slot, initialization-order |
| SchemaUpdateValidationError | exception | error | storage, datasets, schema, validation |
| A rejection cannot be persisted with commit decisions. | validation | error | validation, factory-rules, transaction-semantics |
AGENT_INPUT_PROCESSOR_ERROR [Agent: ] - Input processor error | error_code | error | agent, input-processor, user-code, mastra-error |
| AgentThreadLeaseConflictError(runId, owner) | exception | error | concurrency, distributed-lock, lease, threads |
| Blob not found for hash | exception | critical | storage, skills, blob-store, data-integrity |
| CompositeFilesystem requires at least one mount | exception | error | workspace, filesystem, configuration, constructor |
| Dynamic workflow " " failed validation with issue(s) | validation | error | validation, workflows, dynamic-workflows |
EXPERIMENTS_STORAGE_NOT_CONFIGURED ExperimentsStorage not configured. Configure storage in the Mastra instance. | error_code | error | storage, configuration, experiments |
| Failed to load pull request subscriptions | http | error | http, api, github-subscriptions |
| Item not found | http | error | http-404, not-found, datasets, rest-api |
| @mastra/livekit: reply generation runs through the Mastra… | exception | error | api-misuse, livekit, voice, llm |
MASTRA_MEMORY_GET_EMBEDDING_DIMENSION_FAILED Failed to determine the embedder's output dimension. Semantic recall cannot… | error_code | error | memory, embedder, third-party, dimension-probe, network |
| [Processor: ] sendStateSignal requires Mastra memory with… | exception | error | agent, processors, memory, configuration |
pull-failed Failed to set git remote | error_code | error | git, sandbox, pull, filesystem |
| Sandbox ' ' cannot run the session setup: no executeCommand… | exception | error | sandbox, missing-implementation, api-misuse, session-setup |
| Target not found: / | exception | error | configuration, registry, not-found, experiment |
| Thread with id resourceId does not match the current… | exception | error | memory, tenant-mismatch, thread, validation |
AGENT_GENERATE_V1_MODEL_NOT_SUPPORTED Agent " " is using AI SDK v4 model ( : ) which is not compatible with… | error_code | error | ai-sdk, version-mismatch, agent, generate |
| Cannot expand knowledge scope to | exception | error | knowledge, scope, hierarchy, validation |
| Client exists but is undefined | exception | warning | mcp, internal-state, typescript, invariant |
| Failed to complete upload | exception | error | http, api, deploy, finalization |
| Failed to fetch from Netlify | exception | error | network, http, netlify, api-unavailable |
| GitHub source control request failed | exception | error | network, github, http |
| Invalid signal type: . Use a supported signal type and set… | exception | error | signals, invalid-argument, validation |
| Linear did not accept the comment. | exception | error | linear, graphql, comment, api-rejected |
MASTRA_SERVER_API_INVALID_ROUTE_OPTIONS Invalid options for route | error_code | error | server, api-routes, validation, config |
| MastraAuthWorkos could not resolve a callback URL: pass… | validation | error | config, workos, oauth, redirect-uri, initialization |