mastra-ai/mastra
Documented errors, page 5 of 22. Back to mastra-ai/mastra
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Platform GitHub pull request reconcile interval must be a… | validation | error | configuration, validation, github, worker |
| Presets file not found | exception | error | cli, filesystem, config, file-not-found |
| Sandbox provider " " does not support networking (public… | exception | error | sandbox, networking, provider, ports |
| Stored skill with id | http | warning | http-404, not-found, storage, rest-api |
| Thread not found | exception | error | memory, authorization, not-found, multi-tenancy |
| ${extractResponse.error || 'Extraction failed'} | exception | error | network, api-error, firecrawl, async-job |
SCHEDULES_NO_SCHEDULES_STORAGE Schedules require a storage adapter that implements the schedules domain. | error_code | error | schedules, storage, configuration, missing-dependency |
| Session settings are unavailable | exception | error | react-query, cache-miss, guard-clause, agent-controller |
stale-handle Knowledge scope changed while the request was running. | error_code | error | knowledge-inspector, race-condition, stale-state |
| State mismatch | exception | error | oauth, csrf, state-mismatch, security |
| Storage is not available | http | error | storage, observability, http-500, configuration |
| TokenLimiterProcessor: System messages alone exceed token… | exception | error | token-limit, processors, configuration, tripwire |
TOOL_INVALID_FORMAT TOOL_INVALID_FORMAT | error_code | error | tools, configuration, type-error |
DURABLE_AGENT_RECOVER_LEASE_ACQUIRE_FAILED DurableAgent " " recover( ): failed to acquire the recovery lease. | error_code | error | durable-agent, recovery, lease, network, backend, system |
| error.message (MastraError rethrown with mapped status in… | http | error | server, http, error-mapping, clustering, ai |
| Google token exchange failed | http | error | oauth, google, network, sso |
| Kimi For Coding token | exception | error | auth, oauth, token, schema-validation, kimi-coding |
| .mastra/output/index.mjs not found — did the build succeed? | exception | error | build, deploy, filesystem, cli |
MCP_CLIENT_REDIRECT_BODY_NOT_REPLAYABLE Cannot follow a redirect under the allowedHosts policy: the request body is not… | error_code | error | mcp, redirect, request-body, fetch, url-policy |
| Message has no visible content (it may be an internal… | exception | error | memory, cursor, empty-content, observational-memory |
| Path escapes workspace root | exception | error | sandbox, filesystem, path-traversal, security |
| Worker executionId must contain only letters, numbers… | validation | error | validation, input-sanitization, sandbox |
AGENT_DELEGATION_HOOK_FAILED AGENT_DELEGATION_HOOK_FAILED | error_code | error | agent, delegation, lifecycle-hook, multi-agent, fail-closed |
COMPARE_INVALID_INPUT compareExperiments requires at least 2 experiment IDs. | error_code | error | storage, validation, datasets, argument-error |
| Expected atleast 3 id parts | exception | error | model-router, parsing, invalid-model-id, gateway |
| IssueReconcileWorker: call init() before start() | exception | error | worker, lifecycle, initialization |
MCP_SERVER_TOOL_EXECUTE_PREPARATION_FAILED Unknown tool | exception | error | mcp, tools, unknown-tool, invalid-params |
| must be a positive integer. | validation | error | environment, configuration, validation, linear |
| observation.blockAfter | validation | error | configuration, validation, observational-memory, token-limits |
PROCESSOR_MISSING_MESSAGE_LIST Processor requires messageList or messages for processInput phase | error_code | error | workflow, processor, messages |
| Version number already exists for scorer definition | exception | error | storage, duplicate-version, scorer-definitions, in-memory |
| We could not convert the schema to a JSONSchema | exception | error | schema, zod, json-schema, validation |
| Cannot time travel to step | exception | error | workflows, time-travel, snapshot-mismatch, execution-graph |
EREAD_REQUIRED ${reason} | error_code | error | read-tracker, stale-read, conflict, workspace-tools |
| Factory session repository not found | exception | error | repository, referential-integrity, storage, not-found |
| Invalid Mastra project | exception | error | cli, validation, github, scaffold |
| Invalid metric. Must be one of: cosine, euclidean… | http | error | http-400, validation, vector, rest-api |
| OpenAI Codex device authorization response missing required… | exception | error | oauth, schema-validation, device-login, api-contract |
| Subconscious learn requires a configured knowledge storage… | exception | error | configuration, storage, observational-memory |
| Could not determine project name from package.json. Use… | exception | error | cli, config, project-resolution |
| error.message (MastraError rethrown with mapped status in… | http | error | mastra-error, http-mapping, storage, datasets |
| Factory kickoff run was aborted before it finished. | exception | warning | factory, abort, lifecycle, retry |
| For custom model, modelName is required in… | exception | error | validation, missing-argument, configuration, embeddings |
| Invalid knowledge scope entry | exception | error | knowledge, scope, validation, input-format |
| Invalid state token signature | exception | error | auth, google, oauth, hmac, signature-verification, csrf |
| OpenAI Codex OAuth is only available in Node.js environments | exception | error | oauth, environment, nodejs, crypto |
PROCESSOR_WORKFLOW_INVALID_OUTPUT Processor workflow returned invalid output format. Expected ProcessorStepOutput. | error_code | error | workflows, processors, schema-validation, mastra-error |
| Session configuration is not ready. Try again. | exception | warning | react-query, state-readiness, mutation, ui |
| [Slack] Failed to resolve Mastra storage. Ensure your… | exception | error | storage, configuration, slack |
| SlackIntegration: 'signingSecret' is required — Slack… | exception | critical | slack, configuration, authentication, missing-secret |
| Unknown Subconscious observation agent | exception | error | configuration, validation, observational-memory |
| Unknown worker resource limit | validation | error | validation, configuration, worker, sandbox |
| Factory run requires a board work item | exception | error | guard-clause, missing-parameter, factory-ui, react-query |
| Factory session not found | exception | error | session, storage, not-found, multi-tenancy |
| Not logged in to Kimi For Coding. | exception | error | auth, oauth, kimi, login-required |
| page value too large | validation | error | pagination, argument-validation, storage |
| Path is a directory | exception | error | filesystem, validation, wrong-argument-type |
| Subconscious learn requires organizationId in the request… | exception | critical | memory, missing-context, multi-tenancy |
| Thread ID is required for thread-scoped working memory… | exception | error | memory, working-memory, configuration, missing-argument |
| auth callback rejected (invalid state/token); 400 HTML… | http | error | cli, auth, oauth, csrf, login-flow |
| Curator did not acknowledge a valid processed… | exception | error | llm-output, protocol-violation, observational-memory |
| error | exception | error | websocket, network, agent-controller, verification |
| [FactorySecretEncryption] Unable to decrypt encrypted value. | exception | error | encryption, aes-gcm, integrity, key-management |
| Invalid state token payload | validation | error | auth0, oauth, state-token, base64, json-parsing |
| Part index not found in message . Available indices | exception | error | memory, cursor, part-index, pagination |
| Record is not a pin | exception | error | invalid-argument, knowledge-store, observational-memory |
| Unknown strategy | validation | error | rag, chunking, invalid-argument, typescript |
| Either context or contextExtractor is required for Context… | validation | error | evals, scorer, context-recall, config |
| Memory instance is required for working memory updates | exception | error | memory, working-memory, tools, context |
| tool_result must be preceded by a tool_call with the same… | exception | error | streaming, tool-calls, state-machine |
| Workflow " " declares an array of schedules but one entry… | validation | error | workflow, scheduling, configuration, validation |
| workflowDefinitions storage domain is not available | http | error | server, storage, storage-domain, dynamic-workflows |
| Bearer token required | http | error | mcp, oauth, bearer-token, auth, http-401 |
| crossProcessPubSub requires a pubsub instance | exception | error | configuration, pubsub, signals |
| Dynamic workflow references agent | exception | error | workflow, agent, registration, rehydration |
| Failed to resolve updated agent | http | error | storage, resolution, http-500, draft, read-after-write |
| is in use by another process — is another Mastra Code… | exception | error | sqlite, concurrency, file-lock, vacuum |
| Found existing project(s) in this organization. Pass… | exception | error | configuration, deploy, ambiguity, cli |
HTTP_ERROR HTTP_ERROR: Request failed with status | error_code | error | http, cli, api-error, network |
| Kimi For Coding credentials have an invalid device ID… | exception | error | auth, validation, credentials, device-id, kimi-coding |
| Not logged in. Run `mastra auth login` interactively or set… | exception | error | cli, auth, non-interactive, ci, env-var |
| Observational memory is enabled but the installed version… | exception | error | memory, observational-memory, version-compatibility, upgrade |
| Request failed ( ) / server-provided message | http | error | http, api, github |
| Agent ID is required | http | error | http-400, missing-parameter, rest-api, server |
| browser_close requires agent.threadId when browser scope is… | exception | error | browser, thread-scope, missing-context, configuration |
| Could not find workspace root | exception | error | deployer, pnpm, monorepo, workspace |
| Factory skill invocation needs exactly one of skillName or… | validation | error | validation, factory-rules, xor-fields |
| Failed to refresh the GitHub Copilot token. | exception | error | auth, oauth, token-refresh |
| Failed to resolve created skill | http | error | storage, consistency, http-500, read-after-write |
| InProcessStrategy: could not resolve step | exception | error | workflow, configuration, step-resolution |
| Invalid device code response | exception | error | github-copilot, oauth, device-flow, response-shape, network |
| MastraFactory: duplicate integration id | validation | error | configuration, duplicate, integration, validation |
| maxQuestions must be at least 1 for Summarization scoring | validation | error | validation, range-check, scorer, configuration |
OBSERVABILITY_STORAGE_GET_FEEDBACK_BREAKDOWN_NOT_IMPLEMENTED This storage provider does not support feedback breakdown | error_code | error | storage, observability, not-implemented, feedback |
| Pin budget exceeded: the pin set is limited to | exception | error | quota, knowledge-store, observational-memory |
| Workspace is in read-only mode | http | error | workspace, http-403, read-only, file-write, forbidden |
| Cannot create a knowledge merge cycle | exception | error | knowledge, merge, cycle, inmemory-storage |
MCP_CLIENT_ON_UPDATED_RESOURCE_FAILED MCP_CLIENT_ON_UPDATED_RESOURCE_FAILED | error_code | error | mcp, resources, notifications, event-handler |
| MCP client was disconnected while recovering the failed… | exception | warning | mcp, lifecycle, disconnect, reconnect, race |
| Plan compound components must be rendered inside | exception | error | react, context, compound-components, provider-missing |