mastra-ai/mastra
Documented errors, page 10 of 22. Back to mastra-ai/mastra
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| execa is not available in Cloudflare Workers | exception | error | cloudflare, workers, runtime, sandbox, subprocess |
| Failed to check whether Slack app exists | exception | error | slack, api, transient, availability |
| Invalid checkpoint name | validation | error | validation, security, path-traversal, checkpoint |
MCP_CLIENT_TOO_MANY_REDIRECTS Exceeded the maximum of | error_code | error | mcp, redirect-loop, network, url-policy |
| Memory is not configured on this AgentController | exception | error | configuration, memory, storage |
| No code verifier found. Authorization flow may not have… | exception | error | mcp, oauth, pkce, state, storage |
OBSERVABILITY_STORAGE_GET_STRUCTURE_NOT_IMPLEMENTED This storage provider does not support getting trace structure | error_code | error | storage, observability, tracing, unsupported-operation |
| Query parameter "status" must be "draft" or "published" | validation | error | http, query-params, validation, api-contract |
| Rule metadata is too large. | validation | error | validation, metadata, size-limit, factory-rules |
| Unsupported Factory stage | validation | error | validation, enum, factory-ui, state-machine |
| Failed to extract ChatGPT account id from OpenAI Codex token | exception | error | auth, jwt, token-parsing, openai-codex |
| Failure in analyze package step | exception | error | workflow, template-builder, analysis |
| Forecast data not found | exception | error | workflow, input-validation, data-mapping |
INVALID_CONFIG Cannot use both "filesystem" and "mounts" | error_code | error | configuration, invalid-config, workspace, mounts |
| Skill evidence requires at least two distinct records from… | exception | error | memory, validation, skill-learning |
| SystemPromptScrubber requires a model for detection | exception | error | configuration, model, constructor, detection |
| tagWorker method is no longer supported. Use the Cloudflare… | exception | warning | cloudflare, deprecated, api-change |
DATASETS_STORAGE_NOT_CONFIGURED Storage not configured. Configure storage in Mastra instance. | error_code | error | storage, configuration, datasets |
| Factory session is not available to the current user | exception | error | authorization, access-control, multi-tenancy |
| Loop step " " cannot be stored: closure predicates do not… | exception | error | workflows, serialization, closure, loop |
| MCP client with id not found | http | error | http-404, not-found, mcp |
| Messages should be an array | http | error | http-400, request-validation, memory, api |
| Platform GitHub token minting requires between one and ten… | exception | error | github, installation-token, limits, permissions |
| Pull request subscriptions returned an invalid response. | validation | error | http, validation, contract-mismatch, github-subscriptions |
| Rule metadata must contain finite numbers. | validation | error | validation, json, numbers |
| Cookie password must be at least 32 characters. Set… | validation | error | config, workos, security, cookies, validation |
| Could not fetch metadata for thread | exception | error | memory, storage, embeddings, wrapped-error |
| Factory storage domain | exception | error | storage, duplicate-registration, lifecycle |
| Failed to load templates. Please check your internet… | exception | error | network, http, cli, offline |
| Failed to resolve skill after publish | http | error | storage, internal-state, http-500, skills |
| Failed to swap compacted copy into place AND failed to… | exception | critical | sqlite, filesystem, data-loss-risk, rename |
| Mapping step " " key " " cannot be stored: source is a… | exception | error | workflows, serialization, closure, mapping |
| @mastra/livekit: voice activity detection requires… | exception | error | dependency, voice-activity-detection, livekit, missing-package |
| MastraAuthBetterAuth is not initialized — init() must run… | exception | error | lifecycle, better-auth, initialization-order, async |
| Missing required argument | validation | error | mcp, invalid-params, missing-argument, validation |
MISSING_TSCONFIG MISSING_TSCONFIG | error_code | warning | typescript, config, lint, cli |
| Plugin module must export a plugin object as default or… | validation | error | plugin-loading, module-exports, typescript, validation |
| Project not found | exception | error | cli, config, project-lookup, mastra-cloud |
| Unable to use unpublished referenced prompt blocks | http | error | http-400, validation, lifecycle, agent-instructions |
| Cannot authorize caller-supplied connection: request… | http | error | http-400, tool-providers, request-context, authorization, multi-tenancy |
| Choose a valid provider | validation | error | cli, argument-validation, llm-provider |
| Duplicate Subconscious | exception | error | configuration, validation, subconscious |
| error.message (MastraError rethrown with mapped status in… | http | error | server, error-mapping, experiments, items |
PROCESSOR_RETURNED_UNSUPPORTED_MODEL Processor returned an unsupported model version in step . Only models are… | error_code | error | processors, model-resolution, ai-sdk, version-mismatch |
RUN_EXPERIMENT_FAILED_NO_DATA_PROVIDED Failed to run experiment: Data array is empty | error_code | error | evals, experiment, validation, empty-input |
AGENT_GENERATE_FAILED AGENT_GENERATE_FAILED | error_code | error | agent, generate, execution-failed, wrapped-error |
| Directory already exists | exception | error | filesystem, cli, directory-exists, scaffolding |
| GitHub owner and repo may only contain letters, numbers… | validation | error | plugin-install, validation, github, sanitization |
| Project repository not found for this organization. | exception | error | storage, not-found, github, session |
| Received input message with wrong threadId. Input | exception | error | agent, memory, thread, input-validation |
| Request timed out after | exception | error | timeout, network, abort |
| Tool ' ' not found for workflow step ' '. Pass the tool… | exception | error | workflow, tool, runtime-lookup |
| Unsupported GitHub review state | validation | error | github, parsing, enum |
| workflowDefinitions storage domain is not available. | exception | error | storage, mastra, version-mismatch, configuration |
| Better Auth instance is required. Please provide the auth… | validation | error | configuration, better-auth, missing-option, constructor |
| Cannot rehydrate loop step: missing declarative predicate… | exception | error | workflow, serialization, loop, rehydration |
| Concurrency limit reached, cannot resume task | exception | warning | background-tasks, concurrency, rate-limiting |
| Data parts are not supported in core messages | exception | error | a2a, messages, unsupported-feature |
FAIL_BUILD_SCRIPT FAIL_BUILD_SCRIPT | error_code | error | build, deployment, scripts, subprocess |
| Failed to fetch Mastra templates | exception | error | network, http, external-api |
| Invalid --region " ". Expected one of: eu, us. | validation | error | cli, argument-validation, configuration |
MODEL_ROUTER_NO_GATEWAY_FOUND No Mastra model router gateway found for model id | error_code | error | model-router, configuration, gateway, invalid-input |
| observation.bufferActivation must be <= 1 (ratio) or >=… | validation | error | configuration, validation, observational-memory |
| Snapshot not found for runId | exception | error | workflow, missing-state, snapshot |
| : entity with id already exists | exception | error | storage, duplicate-key, filesystem |
| Unsupported file type | exception | error | filesystem, validation, special-files |
AGENT_RESUME_TOOL_CALL_NOT_SUSPENDED Agent " " () cannot resume tool call " " because it is not suspended. | error_code | error | agent, resume, tool-call, suspend, state, runid |
| Background tasks storage is not available | exception | critical | storage, background-tasks, version-mismatch |
| Both baselineResponse and noisyQuery are required for Noise… | validation | error | configuration, validation, evals, missing-parameter |
DATASET_ITEM_PAYLOAD_NOT_SERIALIZABLE Dataset item payload must be JSON-serializable | error_code | error | storage, datasets, serialization, json, user-error |
| Duplicate workspace tool name | exception | error | duplicate-name, configuration, tool-registration, workspace |
| Invalid token header | exception | error | jwt, auth, missing-claim, issuer |
| plugin name must be a string | validation | error | plugin-manifest, validation, types |
| ${response.error || 'Deep research failed'} | exception | error | network, api-error, firecrawl, long-running-job |
| The "elicitation" key is now nested under "mcp.elicitation"… | exception | error | mcp, migration, breaking-change, tools |
| Version with id not found for scorer | http | error | http-404, scorer-versions, ownership-mismatch |
| Cannot update working memory | exception | error | memory, working-memory, missing-argument, validation |
| conversation_id requires the target agent to have memory… | http | error | server, validation, memory, http-400 |
| has empty or whitespace-padded contents. Use with no… | validation | error | workflow, template, mapping, syntax |
| Dynamic workflow bundle has a circular nested-workflow… | exception | error | workflow, circular-dependency, validation |
| For custom model, modelAbsoluteDirPath is required in… | validation | error | validation, missing-argument, configuration, embeddings |
| Invalid metadata key | validation | error | validation, storage, metadata |
| [mastra/auth-ee] configured but no valid EE license was… | exception | critical | licensing, enterprise, configuration, env-var, startup |
| MASTRA_ORG_ID and MASTRA_PROJECT_ID are required when… | exception | error | environment, configuration, cli, ci |
| Persisted score is missing spanId for traceId | exception | error | observability, scorer, score-traces, span-lookup |
| Rule metadata is not bounded JSON. | validation | error | validation, json, depth-limit |
| SKILL.md not found in | exception | error | skills, publishing, missing-file, validation |
| Slack OAuth HTTP error | http | error | slack, oauth, http, network |
| Task has not been dispatched yet | exception | error | background-tasks, lifecycle, dispatch |
| Unsupported GraphRAG snapshot version | exception | error | serialization, version-mismatch, rag, validation |
| Agent not found | exception | error | ai-sdk, agent-not-found, configuration, routing |
| Agent with id not found | http | error | http-404, stored-agents, export |
commit-failed Failed to set git user.name | error_code | error | git, sandbox, commit, configuration |
| Could not derive skill ID from name. Please provide an… | http | error | validation, http-400, input, slug |
| Factory storage domain name must not be empty | exception | error | storage, factory, validation, configuration |
| Failed to refresh the Kimi For Coding token. | exception | error | auth, oauth, kimi, token-refresh |
| Invalid MemoryRequestContext: expected object, got | validation | error | memory, type-error, validation, request-context |
| [mastra/auth-ee] Agent Builder is configured but the EE… | exception | critical | licensing, enterprise, agent-builder, module-resolution, version-mismatch |
| Observational memory async buffering is enabled by default… | exception | error | memory, observational-memory, async-buffering, version-compatibility |
| `retrieval: ` requires a vector store. Pass a `vector`… | validation | error | configuration, vector-store, observational-memory, validation |