mastra-ai/mastra
Documented errors, page 2 of 22. Back to mastra-ai/mastra
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Workflow run not found | http | error | http-404, workflow-run, storage, rest-api |
| notification_inbox requires a notifications storage domain | exception | error | storage, configuration, notifications |
OBSERVABILITY_STORAGE_GET_METRIC_TIME_SERIES_NOT_IMPLEMENTED This storage provider does not support metric time series | error_code | error | storage, observability, metrics, time-series, not-implemented |
| MCP clients storage domain is not available | http | error | storage, mcp, adapter, http-500 |
OBSERVABILITY_STORAGE_GET_METRIC_BREAKDOWN_NOT_IMPLEMENTED This storage provider does not support metric breakdown | error_code | error | storage, observability, metrics, breakdown, not-implemented |
| Unsupported schema type | exception | error | schema, invalid-input, typeerror |
| Linear project source id is invalid. | validation | error | linear, parsing, validation, cursor |
| No result received from agent execution | exception | error | agent, workflow-builder, streaming |
OBSERVABILITY_STORAGE_GET_METRIC_NAMES_NOT_IMPLEMENTED This storage provider does not support metric name discovery | error_code | warning | storage, observability, not-implemented, metrics |
| prepareStep returned an unsupported model version | exception | error | agent, prepare-step, model-version, configuration |
MCP_CLIENT_ON_REQUEST_ELICITATION_FAILED MCP_CLIENT_ON_REQUEST_ELICITATION_FAILED | error_code | error | mcp, elicitation, event-handler, server-not-found |
| Agent response is required for prompt alignment scoring | validation | error | validation, scorer, missing-argument, llm-evals |
| Agent step " " cannot be stored: structuredOutput.schema is… | exception | error | workflows, serialization, schema, structured-output |
| Failed to resolve updated MCP client | http | error | http-500, storage, mcp, server |
| Platform Linear reconcile interval must be a positive… | validation | error | configuration, validation, linear, polling |
| issue reconcile interval must be a positive number. | validation | error | configuration, worker, validation |
| Extractor " " output did not match its schema | validation | error | schema-validation, zod, llm-output, observational-memory |
| Knowledge scope exceeds | exception | error | knowledge, scope, ceiling, authorization |
| Linear API error | exception | error | network, graphql, linear-api, third-party-api |
| Experiments storage not available | http | error | storage, server, configuration, experiments |
| Found unhandled message | exception | error | message-conversion, input-validation, agent, memory |
LOCALHOST_ENV_VAR LOCALHOST_ENV_VAR: in the env file being deployed points at localhost ( ) — the… | error_code | warning | deploy, env-var, localhost, database, preflight |
| Worker during startup ` : ''}. | exception | error | sandbox, worker-startup, timeout, deployment |
| Invalid request index, indexName and positive dimension… | http | error | http-400, validation, vector, rest-api |
| Path is outside the browsable root | exception | error | path-traversal, symlink, security, filesystem |
| apiError.message || defaultMessage (fallback handler error) | http | error | http-500, api-error, error-handling |
| CreateCancelledError (Operation cancelled) | exception | info | cli, cancellation, sigint, control-flow |
| FGA denied for tool | exception | error | auth, fga, authorization, mcp |
| reflection.blockAfter | validation | error | configuration, validation, observational-memory |
| Snapshot functionality requires a Node.js environment… | exception | error | nodejs, runtime, snapshots, environment |
| Cannot start an overlapping WebSocket Responses… | exception | error | websocket, openai, concurrency, streaming |
| Failed to canonicalize A2A Agent Card for signing | exception | error | a2a, jws, canonicalization, crypto |
| Failed to resolve created prompt block | http | error | storage, versioning, server, internal |
| Project name must be 1-214 lowercase characters, start with… | validation | error | cli, validation, naming, filesystem |
| Unsupported schema type: function (schema libraries should… | exception | error | schema, standard-schema, invalid-input |
| Database was while provisioning | exception | error | provisioning, race-condition, polling, lifecycle |
| GitHub subscription has no Factory session to run as. | exception | error | github, webhook, orphaned-session |
| Directory not empty or not found | exception | error | filesystem, sandbox, shell |
LOCAL_STORAGE_PATH LOCAL_STORAGE_PATH: Build contains a host-local storage URL | error_code | error | deploy, storage, localhost, hardcoded-config, preflight |
| No observational memory record found for thread | exception | error | observational-memory, not-found, storage |
| chunking must be "word", "line", a RegExp, an… | validation | error | streaming, smooth-stream, validation, configuration |
| Extractor " " must include instructions. | validation | error | runtime, dynamic-config, observational-memory |
| GitHub token refresh requires an active Factory sandbox… | exception | error | github, sandbox, request-context |
| Pin is outside the visible scope. | exception | error | scope-mismatch, memory, observational-memory |
| Root is not approved for rendered workspace access | validation | error | security, allowlist, configuration, filesystem |
| Bad Request: request requires a valid session ID | http | error | http, mcp, session, bad-request |
DEPLOYER_PNPM_IGNORED_BUILDS pnpm blocked build scripts for | error_code | error | pnpm, build-scripts, configuration, install |
| error.message (workflow resume already claimed conflict) | http | warning | http-409, concurrency, workflow, race-condition |
OBSERVABILITY_STORAGE_BATCH_UPDATE_SPANS_NOT_IMPLEMENTED This storage provider does not support batch updating spans | error_code | error | storage, observability, not-implemented, spans, batch |
DEPLOYER_BUNDLER_BUNDLE_STAGE_FAILED Failed during bundler bundle stage | error_code | error | deployer, bundler, build |
| Factory kickoff run terminal event was not observed before… | exception | error | factory, timeout, events, agent-run |
| Invalid state redirect suffix | exception | error | auth, google, oauth, csrf, state-validation |
| reflection.bufferActivation must be in range | validation | error | configuration, validation, observational-memory |
| Structure mismatch in snapshot: Expected | exception | error | testing, snapshot, observability, spans |
| Anthropic token refresh failed | http | error | oauth, anthropic, token-refresh, http-error, credentials |
| Cannot favorite: with id does not exist | exception | error | storage, in-memory, entity-not-found, favorites |
| contains an unsupported field. | validation | error | validation, schema, factory-rules, typo |
| Linear did not accept the issue update. | exception | error | linear, graphql, api-rejected, state-update |
OBSERVABILITY_INVALID_CONFIG Invalid observability configuration | validation | error | configuration, schema-validation, observability, zod |
WEB_SEARCH_UNSUPPORTED_PROVIDER The built-in webSearchTool supports OpenAI, Anthropic, Google, and xAI models… | exception | error | web-search, unsupported-provider, agent-config, user-error |
MCP_CLIENT_ON_UPDATE_PROGRESS_FAILED MCP_CLIENT_ON_UPDATE_PROGRESS_FAILED | error_code | error | mcp, progress, event-handler, server-not-found |
| threadId must be a non-empty string or array of non-empty… | validation | error | validation, pagination, storage, argument-error |
| Invalid arguments for firecrawl_search | exception | error | mcp, validation, tool-arguments, firecrawl |
INVALID_KEY INVALID_KEY | LICENSE_EXPIRED | LICENSE_REVOKED | RATE_LIMITED | error_code | error | license, validation, configuration, entitlement |
| knowledge_read requires id or name. | exception | error | tool-input-validation, knowledge-tools, missing-argument, llm-tool-call |
MISSING_ENV_VAR MISSING_ENV_VAR: Build references | error_code | warning | deploy, env-var, database, missing-config, preflight |
| Redirect URI is required for SSO login | validation | error | auth, clerk, sso, oauth, configuration |
| Context array cannot be empty if provided | validation | error | evals, scorer, context-precision, empty-array |
| Invalid device code response fields | exception | error | github-copilot, oauth, device-flow, schema-validation, response-shape |
| Invalid email or password | http | error | auth, http-401, credentials |
| Knowledge merge requires two existing nodes. | exception | error | memory, knowledge-graph, entity-not-found |
| ${response.status} ${response.statusText}: ${text} | http | error | network, http, github-copilot, oauth, device-flow |
| Subconscious semantic knowledge requires both a vector… | exception | error | vector-store, embedder, semantic-index, configuration |
| Agent " " not found | http | error | http-404, channels, agents, acl |
| Factory kickoff was queued onto an ending run and never… | exception | error | factory, async, race-condition, kickoff |
| FileNotFoundError | error_code | error | filesystem, sandbox, file-not-found |
| Knowledge write tools require a configured knowledge… | exception | error | knowledge-write-tools, storage-configuration, missing-store, mastra-memory |
| MastraFactory: 'sandbox' is now a callback, not an options… | validation | error | configuration, breaking-change, sandbox, migration |
| No Slack installation found for agent | exception | error | slack, oauth, not-found, configuration |
OBSERVABILITY_STORAGE_BATCH_DELETE_TRACES_NOT_IMPLEMENTED This storage provider does not support batch deleting traces | error_code | error | storage, observability, not-implemented, traces, batch-delete |
| Refusing to use local sandbox path outside configured root | exception | error | path-traversal, security, sandbox, configuration |
| DATABASE_URL is required outside local development and… | exception | critical | configuration, environment-variables, database, startup, postgres |
| error.message (dynamic; MaterializeError) | error_code | error | factory, materialization, wrapped-error, api-route |
| escapes workspace | validation | error | path-traversal, security, validation, filesystem |
| resolveSession returned a session for resourceId= | exception | error | channels, resource-id, session-ownership |
| Schema validation failed due to an invalid schema… | validation | error | schema, validation, zod, union, circular-import |
| \nYou can retry manually: cd && install | exception | error | cli, dependency-install, spawn, network, node |
| Could not save the active model pack | exception | error | persistence, settings, race-condition, storage |
| Path escapes workspace root (symlink) | exception | critical | sandbox, symlink, path-traversal, security |
| Token exchange failed | http | error | auth, clerk, oauth, network, token-exchange |
| Encountered unknown role | exception | error | message-conversion, ai-sdk-v4, roles, prompt |
| GitHub integration is required to load webhook… | exception | error | github, webhook, dependency-injection, misconfiguration |
| Invalid or tampered state token | validation | error | auth0, oauth, csrf, hmac, signature-verification |
| Knowledge node description exceeds the | exception | error | knowledge, validation, length-limit, write-rejected |
READ_ONLY Workspace is in read-only mode. Cannot perform | exception | error | filesystem, read-only, workspace, configuration |
| Allocation sampling did not restart. | exception | error | inspector, heap-profiler, state-error, restart |
| Dataset not found | exception | error | storage, datasets, not-found |
| was opened by another process during compaction — is… | exception | error | sqlite, concurrency, race-condition, vacuum |
MASTR_SCORER_FAILED_TO_RUN_MISSING_MODEL_OR_INSTRUCTIONS Step " " requires a model and instructions | error_code | error | scorer, configuration, missing-model, missing-instructions |
| Multi-thread observer produced degenerate output after… | exception | error | llm-output, degenerate-repetition, multi-thread, observational-memory |