mastra-ai/mastra
Documented errors, page 15 of 22. Back to mastra-ai/mastra
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Hook extractor " " cannot include instructions or a schema. | validation | error | config, mutually-exclusive-options, observational-memory |
| Invalid createdAt | http | error | http-400, date-parsing, validation |
| @mastra/livekit: Mastra agent stream request failed with… | http | error | network, http, streaming, livekit, mastra-server |
| Plugin entry for " " must be inside the plugin directory | validation | error | security, path-traversal, plugin-loading, registry |
| Push notification failed with status | exception | error | a2a, http, push-notifications, network |
| Server ' ' cannot execute tools in this way. | http | error | mcp, not-implemented, type-mismatch, version-mismatch |
| Source thread with id | exception | error | storage, not-found, thread, state |
| Span not found for scoring, traceId | exception | error | observability, tracing, score-traces, span-lookup |
| Tool call id is required | http | error | http-400, missing-parameter, tool-approval, api |
AGENT_GENERATE_V2_MODEL_NOT_SUPPORTED Models with specificationVersion | error_code | error | agent, model-spec, deprecated-api, migration |
| App resource not found | exception | error | mcp, resources, not-found |
| Config file not found at | exception | error | filesystem, missing-file, model-loading, embeddings |
| Cookie password must be at least 32 characters for SSO. Set… | validation | error | configuration, security, cookie, encryption, sso |
| Could not derive agent ID from name. Please provide an… | http | error | validation, bad-request, slug, agent-id |
| Failed to save course state | exception | error | filesystem, persistence, permissions |
| Failure in discover units step | exception | error | workflow, template-builder, discovery |
| models.dev returned | http | error | network, http, api-outage |
| No organization selected. Run: mastra auth orgs switch | exception | error | cli, auth, organization, env-vars |
| Not logged in | exception | error | cli, auth, credentials, org |
| SlackProvider not attached to Mastra. Call __attach() first. | exception | error | lifecycle, initialization, slack |
| Storage is not configured on the Mastra instance. | exception | error | configuration, storage, mastra |
| Access denied: workflow run belongs to a different resource | http | error | http-403, authorization, workflows, multi-tenancy |
| Failed to resume agent builder action stream | http | error | http, streaming, resume, network |
| Invalid environment variable name | validation | error | validation, env, shell, sandbox |
| Invalid input for tool | exception | error | code-mode, input-validation, schema, tool-dispatch |
| Invalid path | exception | error | path-traversal, security, validation, skills |
| Invalid model id | validation | error | configuration, validation, model-id |
| No post-processor found for registry | exception | error | configuration, mcp, data-mapping |
OBSERVABILITY_STORAGE_LIST_TRACES_NOT_IMPLEMENTED This storage provider does not support listing traces | error_code | error | storage, observability, tracing, pagination, unsupported-operation |
| [QueueHealthStorage] thresholdsSeconds must be a non-empty… | validation | error | validation, config, queue-health |
| Run ID is required | http | error | http-400, workflows, missing-parameter, server-api |
| Semantic recall requires a vector store to be… | validation | error | memory, semantic-recall, missing-dependency, configuration |
| Tokens map file not found at | exception | error | filesystem, missing-file, tokenizer, embeddings |
| Unable to read workspace diff | exception | error | git, diff, exit-code |
| xAI device authorization returned an invalid… | exception | error | oauth, xai, device-flow, validation |
| Edge references unknown node | validation | error | serialization, graph-integrity, rag, dangling-reference |
| Invalid plan path | http | error | http-400, validation, plans, paths |
| ModelByInputTokens threshold keys must be positive numbers… | validation | error | config, validation, observational-memory |
| Mount " " is read-only | http | error | workspace, filesystem, mount, read-only, forbidden |
| Plugin entry file does not exist | validation | error | filesystem, plugins, configuration |
session_not_found session_not_found | error_code | error | session, not-found, skill-invocation |
| shareTokenBudget requires async buffering to be disabled… | validation | error | config, validation, incompatible-options, tokens |
| This workflow step " " was not suspended. Available… | exception | error | workflow, resume, suspend, validation |
| Unsupported JSON Schema target | exception | error | json-schema, configuration, zod |
| Vector configuration is required to embed text. | validation | error | embeddings, vector-search, configuration, misconfiguration |
| Admin access required | http | error | rbac, authorization, http-403 |
| Both original query and noisy response are required for… | validation | error | evals, runtime, empty-input, message-extraction |
| Error executing processor workflow | http | error | mastra-server, workflow, processor, http-500, unhandled-exception |
EXPERIMENT_HAS_TARGET Experiment has a target ( " "); results are produced by Mastra, not ingested… | error_code | error | storage, experiments, api-misuse, user-error |
| Failed to refresh the xAI token. | exception | error | auth, oauth, xai, token-refresh |
| Lesson " " not found. | exception | error | not-found, filesystem, input-validation |
| No organizations found. Create one at | exception | error | auth, deploy, cli, organization |
| Plan capability not found | http | error | http-404, agents, tools, plans |
| resumeStream() on DurableAgent requires a runId in… | exception | error | durable-agent, resume-stream, arguments |
RUN_EXPERIMENT_SCORER_FAILED_TO_SCORE_RESULT Failed to run experiment: Error running scorer | error_code | error | evals, scorer, error-wrapping |
| Sandbox provider " " does not support networking (public… | exception | error | sandbox, networking, capability, deployment |
| StepExecutionError(res.status, text) | http | error | network, http, worker, remote-execution |
| Subconscious pins.maxCharacters must be an integer between… | exception | error | configuration, validation, subconscious |
| Access denied: thread belongs to a different resource | http | error | http-403, authorization, memory, multi-tenancy |
| Conversation was not found | http | error | http-404, conversations, not-found, server-api |
| Database not found: . List databases with: mastra env db… | exception | error | cli, database, not-found, cloud |
| Factory rule causal depth exceeded. | validation | error | validation, recursion, factory-rules |
| must be a non-negative number of milliseconds or a duration… | validation | error | config, validation, duration |
| Invalid GitHub URL | validation | error | plugin-install, url-validation, github |
| Invalid state update | validation | error | validation, schema, state |
| Mastra instance is required for agent-backed responses | http | error | server, http-500, initialization, responses-api |
| No writable mount available for skill installation | http | error | workspace, filesystem, mount, read-only, skill-install |
| observation.blockAfter requires observation.bufferTokens to… | validation | error | configuration, validation, observational-memory |
| Tokenizer config file not found at | exception | error | filesystem, missing-file, tokenizer, embeddings |
| @mastra/livekit: no Mastra agent specified. Set `agent` on… | validation | error | configuration, routing, agents, livekit |
| Memory error: Resource-scoped semantic recall is enabled… | exception | error | memory, semantic-recall, configuration, validation |
| Mode requires a defaultModelId when no backing agent is… | exception | error | configuration, agent, model |
| No deploys found for linked Studio project | exception | error | cli, studio, deploy, missing-deploy |
| run-workflow requires a Mastra context. | exception | error | mastra, configuration, runtime-context, workflows |
| Skill with id already exists | http | warning | conflict, http-409, duplicate, rest-api |
| SSO not configured | http | error | http-404, sso, auth-configuration |
| Workspaces storage domain is not available | http | error | storage, adapter-compatibility, http-500, workspaces |
| Agent with id already exists | http | error | conflict, http-409, duplicate, unique-constraint |
DATASET_ITEM_IDENTITY_CONFLICT error.message (DATASET_ITEM_IDENTITY_CONFLICT, cause: conflicts) | error_code | error | http-409, conflict, duplicate-key, datasets, batch-insert |
| Failed to create project | http | error | http-error, platform-api, project-creation, network |
| Failed to load GitHub token status | http | error | http-error, github, authentication, network |
| Failed to parse snapshot | exception | error | snapshots, json-parse, corrupt-file, filesystem |
| @mastra/livekit: `workflowInput` is required when… | validation | error | configuration, livekit, workflow, validation |
| Memory store is required for channel thread mapping… | exception | error | storage, memory-store, channels |
| must be greater than zero. | validation | error | worker, validation, configuration |
| Processor workflow failed with status | http | error | mastra-server, workflow, processor, http-500 |
| runId is required when resumeData is provided | validation | error | ai-sdk, validation, resume, request-body |
| Tool provider does not support getToolSchema | http | error | http-404, tool-providers, missing-capability, server |
| writeFile failed (exit ) | exception | error | filesystem, sandbox, write-failure, shell |
| Cannot authenticate MCP server | exception | error | mcp, oauth, configuration, loopback, redirect-url |
| Command failed inside sandbox | exception | error | sandbox, command-failure, deploy |
| Either message or messages must be provided | exception | error | agent, title-generation, missing-input, validation |
| Google Workspace Directory authentication is not configured. | validation | error | configuration, authentication, rbac, google, missing-credentials |
| No relevance score found in VoyageAI response | exception | error | voyageai, reranker, api-response, version-mismatch |
| Stale broker election lock removed | exception | warning | pubsub, unix-socket, broker-election, stale-lock, retry |
| Workspace v1 not supported by this version of @mastra/core… | http | error | http-501, version-mismatch, workspaces |
| agent thread aborts are not supported by this Mastra core… | http | error | http-501, version-compatibility, abort, server |
| Comment compounds must be rendered within Comment | exception | error | react, context, compound-components, playground-ui |
| Duplicate mode id " " found when creating the… | exception | error | configuration, agent-controller, duplicate-id, startup |
| Failed to start OAuth callback server: ports | exception | error | mcp, oauth, port-in-use, network, callback-server |