mastra-ai/mastra
Documented errors, page 6 of 22. Back to mastra-ai/mastra
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| recall requires a Memory instance with storage access | exception | error | memory, wrong-type, duck-typing, recall |
| The --llm option can only be used with the default template | validation | error | cli, input-validation, flag-conflict, llm-provider |
| tool_result must be preceded by a tool_call | exception | error | streaming, protocol, tool-call, state |
| Unsupported model version | exception | error | ai-sdk, model-version, workflow, compatibility |
| Unsupported model version | exception | error | model, compatibility, durable-agent, ai-sdk |
| VoiceCredentialError(entry.provider) | exception | error | credentials, authentication, voice, api-key |
| [WorkspaceSkills] Cannot resolve skill | exception | error | skills, naming-conflict, resolution, configuration |
| expectedVersion is only valid for an existing node. | exception | error | validation, memory, optimistic-concurrency |
| Factory review phase requires a selected session model. | exception | error | factory, model-selection, session, review-phase |
| Invalid token payload | exception | error | jwt, auth, token-payload, validation |
MCP_CLIENT_ON_LIST_CHANGED_PROMPT_FAILED MCP_CLIENT_ON_LIST_CHANGED_PROMPT_FAILED | error_code | error | mcp, prompts, notification, connection |
| readFile failed (exit ) | exception | error | filesystem, sandbox, permissions, shell |
| Connection is still pinned by agent(s). Pass ?force=true to… | http | warning | http-409, tool-providers, conflict, api |
| Critical failure in clone step | exception | critical | git, clone, workflow, template-builder |
| Foreach step cannot iterate a mapping: mappings project… | exception | error | workflows, serialization, foreach, misuse |
| handleAutoVersioning returned undefined | exception | error | versioning, internal-error, http-500, storage |
MASTRA_SCORES_STORAGE_NOT_AVAILABLE Scores storage domain is not available | error_code | error | storage, scores, deprecated, mastra-error |
OBSERVABILITY_DELTA_POLLING_NOT_SUPPORTED This storage provider does not support observability delta polling | error_code | error | storage, observability, in-memory, feature-flag, delta-polling |
| Path must include :agentId to route to the correct agent or… | validation | error | ai-sdk, configuration, routing, developer-error |
| query is required for mode="search" | exception | error | memory, validation, search, tool-arguments |
| Redirect URI is required for SSO. Set AUTH0_REDIRECT_URI or… | validation | error | auth0, sso, oauth, missing-config, redirect-uri |
| Slack refresh token is invalid. Get fresh tokens from… | exception | critical | oauth, slack, token-rotation, storage |
| storageBackend is required when injecting a custom storage… | exception | error | storage, configuration, dependency-injection |
| The chunking function must return a prefix of the buffered… | validation | error | streaming, smooth-stream, validation, typeerror |
| Unsupported artifact file type | exception | error | build, filesystem, artifact-integrity |
| Attempted to parse provider/model from | exception | error | model-router, parsing, invalid-model-id, gateway |
| Environment not found | exception | error | cli, environment-resolution, user-input |
| Failed to fetch user info from Auth0 | http | error | network, auth0, oauth, http-4xx |
| Google service account token request failed | http | error | auth, google, oauth, network |
| Linear authorization expired. Reconnect Linear to keep… | exception | error | oauth, token-expired, linear, reauth-required |
MASTR_SCORER_FAILED_TO_RUN_WORKFLOW_FAILED Scorer Run Failed | error_code | error | scorer, workflow, evals, llm |
| No API URL found for | exception | error | configuration, base-url, moonshot, model-gateway |
| observation.bufferTokens | validation | error | configuration, validation, observational-memory, token-limits |
| Skill name is required | http | warning | http-400, skills, missing-parameter, rest-api |
| The --empty and --template options can't be used together | validation | error | cli, input-validation, flag-conflict |
| No Mastra units (agents, workflows, tools) found in… | exception | error | template-analysis, empty-result, workflow |
| No model with a configured API key found. Please set the… | http | error | http-400, api-key, environment, model-provider |
| Refusing to pass unsafe argument to shell command | exception | error | security, shell, child-process, input-validation |
| SKILL.md not found in skill files | exception | error | skills, publishing, validation, missing-file |
| Anthropic API key credential is configured, but OAuth is… | exception | error | auth, oauth, configuration |
| Bound Factory work item not found. | exception | error | factory, storage, data-integrity, work-item |
| Failed to create compact JWS for A2A Agent Card | exception | error | a2a, jws, crypto, signing |
| Knowledge curation cursor cannot move backwards | exception | error | knowledge, cursor, curation, ordering |
| Channel " " is not registered. Available | http | error | http-404, channels, configuration |
| configDirName must be a single directory name without path… | validation | error | configuration, validation, path-traversal |
| Could not resolve cursor message | exception | error | memory, cursor, not-found, observational-memory |
| Invalid file path " ". Absolute paths are not allowed. | http | error | path-validation, security, http-400, workspace |
| Knowledge tools require a configured knowledge storage… | exception | error | knowledge-tools, storage-configuration, missing-store, mastra-memory |
| Platform GitHub event polling requires the mounted Mastra… | exception | error | configuration, github, workers, bootstrap |
| ${response.error || 'Scraping failed'} | exception | error | api-response, scraping, auth |
AGENT_NETWORK_OBSERVATIONAL_MEMORY_UNSUPPORTED Observational Memory is not supported with agent network. Agent network does… | error_code | error | agent-network, observational-memory, memory, configuration |
| Codex stream error | exception | error | streaming, network, openai-codex, server-error |
| Failed to create deploy | exception | error | http, api, deploy, upload |
| GitHub integration is required to retire webhook… | exception | error | github, webhook, dependency-injection, misconfiguration |
| Google Directory groups.list failed | http | error | google, network, api-error, rbac, directory-api |
| Index name is required | http | error | http-400, validation, vector, rest-api |
| ${initial.code}: ${initial.reason} | exception | error | rules-engine, dispatch, rejected-decision, factory |
| KnowledgeRecord not found | exception | error | knowledge-remove, entity-not-found, stale-reference, tool-input-validation |
| Memory storage was not available while storing the response | http | error | server, storage, memory, http-500 |
| Server failed to start with error | exception | error | cli, dev-server, process-exit, startup |
| . The sandbox stays usable: this setup command is skipped… | error_code | error | setup-command, configuration, sandbox, factory |
| Version with id not found | http | error | http-404, scorer-versions, rest-api |
| Work item is required | exception | error | guard-clause, missing-parameter, factory-ui, react-query |
| A resource ID is required when using memory. Provide… | http | error | http-400, memory, resource-id, authentication |
EISDIR Path is a directory | exception | error | filesystem, eisdir, wrong-path-type |
EXPERIMENT_HAS_NO_TARGET Experiment has no target; results must be ingested via submitExperimentResult | error_code | error | configuration, experiments, validation |
| Mastra instance is required for conversations | http | critical | server, http-500, configuration, di-wiring |
| Multiple env files found | exception | error | cli, env-files, configuration |
| Multiple suspended steps found | exception | error | workflow, resume, ambiguity, suspend |
| observation.bufferActivation as absolute retention | validation | error | configuration, validation, observational-memory, token-limits |
| Plugin " " is not installed in scope | validation | error | plugin, registry, scope-mismatch, state |
| Resource ID is required for resource-scoped working memory… | exception | error | memory, working-memory, validation, missing-argument |
STRUCTURED_OUTPUT_PROCESSOR_SCHEMA_REQUIRED StructuredOutputProcessor requires a schema to be provided | error_code | error | configuration, schema, structured-output, constructor |
| Cursor is required | exception | error | validation, memory, cursor, observational-memory |
| Either context or contextExtractor is required for Context… | validation | error | configuration, validation, evals, missing-parameter |
| Platform GitHub issue reconcile interval must be a positive… | validation | error | configuration, validation, github, worker |
| TelegramProvider needs a baseUrl to register a webhook. Set… | exception | error | telegram, configuration, webhook, missing-env-var |
AGENT_SEND_TOOL_APPROVAL_AMBIGUOUS_SUSPENDED_RUNS Agent " " sendToolApproval() found suspended runs for thread " ". Pass a… | error_code | error | agent, tool-approval, ambiguity, user-input, suspended-run |
| Failed to parse existing package.json at | exception | error | json, parse, template-builder, filesystem |
| Invalid field key segment | validation | error | sql, validation, field-key, json-path |
| Knowledge storage domain is not available on | exception | error | storage, knowledge, configuration |
| is invalid. | validation | error | validation, constraints, string-format |
MASTRA_AIV5_DATA_PART_INVALID Invalid AIV5 data part in getDataStringFromAIV5DataPart | error_code | error | agent, message-conversion, media, aiv5 |
MASTRA_GET_INTERNAL_WORKFLOW_BY_ID_NOT_FOUND Workflow with id not found | error_code | error | workflow, internal-workflow, not-found, mastra-api |
| No access to organization | exception | error | cli, auth, organization, permissions, rbac |
| RegexFilterProcessor streamCarryoverSize must be a positive… | exception | error | configuration, validation, streaming, constructor |
WORKFLOW_RESUME_ALREADY_CLAIMED This suspended workflow run was already resumed by another caller. Workflow | error_code | error | workflow, concurrency, resume, race-condition |
AGENT_LIST_SUSPENDED_RUNS_NO_STORAGE Agent " " listSuspendedRuns() requires storage to discover suspended runs… | error_code | error | agent, storage, configuration, suspended-runs |
| Batch embedder returned | exception | critical | embedding, contract-violation, batch |
| Cannot register an elicitation handler after connecting… | exception | error | mcp, elicitation, capability, initialization |
| Cannot resume a suspended tool without a current thread | exception | error | agent, suspension, resume, thread |
| Could not derive prompt block ID from name. Please provide… | http | error | validation, server, slug |
invalid-cursor Knowledge cursor does not match the active scope and filters. | error_code | error | knowledge-inspector, pagination, cursor-mismatch |
| Knowledge ceiling cannot be lowered from | exception | error | knowledge, ceiling, monotonic-state, validation |
| No model available: this run started without a controller… | exception | error | configuration, request-context, model-resolution |
| must be JSON-safe. | validation | error | validation, json, workflow-builder |
| Pin not found | exception | error | not-found, knowledge-store, observational-memory |
| RegexFilterProcessor requires at least one rule or preset | exception | error | configuration, validation, processors, constructor |
| A numeric theme id is required | exception | error | validation, query-parameters, react-query, signals |
| Agent Card signature algorithm | exception | error | jws, algorithm-allowlist, agent-card, signature-verification |