mastra-ai/mastra
Documented errors, page 7 of 22. Back to mastra-ai/mastra
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
AGENT_GENEREATE_SCORER_NOT_FOUND Mastra not found when fetching scorer. Make sure to fetch agent from… | error_code | error | agent, scorer, mastra-instance, configuration |
| capture-guidance is limited to | exception | error | validation, string-length, memory |
| must be one of | validation | warning | cli, validation, enum |
| Harness session " " was not found | exception | error | storage, harness, session-not-found |
| Invalid state token format | exception | error | auth, google, oauth, state-validation, csrf |
| mapping entries cannot appear inside .parallel()… | exception | error | workflow, mapping, structure, rehydration |
| #mastra does not provide an export named 'mastra' | exception | critical | runtime, module-exports, experiment-worker |
OBSERVABILITY_STORAGE_BATCH_CREATE_LOGS_NOT_IMPLEMENTED This storage provider does not support batch creating logs | error_code | error | storage, observability, not-implemented, logs, batch |
| Source provider cannot read files | exception | error | storage, agents, configuration, source-provider |
| Unsupported output format | exception | error | configuration, invalid-argument, message-conversion |
| bad request | http | error | http-400, validation, network, bad-request |
| Could not create the session. Reload the page and try again. | exception | error | react, react-query, state, missing-parameter, chat |
| Embedder returned no vector for | exception | error | embeddings, indexing, outbox |
| Execution flow of workflow is not defined. Add steps to the… | exception | error | workflow, configuration, definition, missing-steps |
| Factory decisions require unique idempotency keys. | validation | error | validation, idempotency, factory-rules |
| Linear capabilities require an OAuth connection. | exception | error | linear, oauth, authentication, configuration |
| Linear returned no access token. | exception | error | oauth, network, linear, unexpected-response |
| @mastra/livekit: MastraLLM requires exactly one reply… | validation | error | configuration, validation, livekit, llm-plugin |
| No message handler for prompt | exception | error | mcp, prompts, missing-handler, internal-consistency |
| Not logged in to GitHub Copilot. | exception | error | auth, oauth, github-copilot |
| Operation terminated by SIGTERM | exception | error | cli, sigterm, process-termination, interruption |
| SlackProvider is not configured. Provide a refreshToken via… | exception | error | slack, configuration, missing-credentials |
| Start over from the name step. | exception | warning | validation, client-side-guard, wizard-state, react |
| Too many redirects. Maximum is | exception | error | network, http, redirects, web-fetch |
| Duplicate worker name | exception | error | workers, configuration, duplicate, mastra-constructor |
| Knowledge semantic index is stale because operation | exception | warning | outbox, stale-index, retry |
not-visible Knowledge record is not visible in the selected scope. | error_code | error | knowledge-inspector, access-control, scope |
| Observational memory record not found | exception | error | storage, not-found, observational-memory, state |
| Project path is required | validation | critical | configuration, request-context, workspace |
| TokenLimiterProcessor: No messages fit within the remaining… | exception | error | token-limit, processors, tripwire, message-list |
| Tried to create embedding index but no vector db is… | exception | error | memory, vector-store, semantic-recall, configuration |
| Browser not launched | exception | error | browser, lifecycle, initialization, stagehand |
| Experiment worker artifacts cannot contain escaping symlinks | exception | error | build, symlink, security |
| GitHub token refresh no longer matches the active Factory… | exception | error | race-condition, github, auth, stale-state, factory |
| Invalid request query. indexName and queryVector array are… | http | error | http-400, validation, vector, rest-api |
MALFORMED_HEADER MALFORMED_HEADER: Header must use "Key: Value" format | error_code | error | cli, http-headers, input-validation |
NETLIFY_GATEWAY_NO_TOKEN Missing NETLIFY_TOKEN environment variable required for model | error_code | error | environment, api-key, netlify, configuration, mastra-error |
| No credentials | exception | error | cli, auth, credentials, refresh |
| Sandbox provider ' ' does not support executeCommand, which… | exception | critical | sandbox, configuration, missing-capability |
| Storage is not configured | http | error | storage, configuration, mcp, http-500 |
| The --llm-api-key option can only be used with the default… | validation | error | cli, input-validation, flag-conflict, api-key |
| API not implemented | exception | error | not-implemented, openapi, toolset, api-client |
| HttpRemoteStrategy: requestContext is not JSON-serializable. | exception | error | serialization, worker, http, request-context |
| Invalid arguments for firecrawl_extract | exception | error | mcp, validation, tool-arguments, firecrawl |
| Invalid message type | exception | error | typescript, toast, developer-error, playground-ui |
| @mastra/livekit: set exactly one reply generator —… | validation | error | configuration, validation, livekit, worker |
| Path not found in composite skill source | exception | error | filesystem, path, skills |
PLATFORM_RESOLUTION_FAILED Could not resolve platform deployment URL | error_code | error | platform, configuration, deployment |
| plugin at index must include an id | validation | error | plugin-manifest, validation, configuration |
session_unavailable No active Factory binding for role | error_code | error | factory, binding, session, dispatch |
| Unsupported tool type | exception | error | tools, exhaustiveness, aisdk, internals |
| apiError.message || defaultMessage | http | error | server, http, error-handling, hono |
| Failed to run install command with swpm and native package… | exception | error | package-manager, process-spawn, install |
| Invalid metadata key | validation | error | validation, metadata, prototype-pollution, storage |
| No webSocketDebuggerUrl found in CDP version response from | exception | error | network, cdp, browser, response-shape |
| Notification summary is missing agentId | exception | error | notifications, storage, batching, data-integrity |
OBSERVABILITY_STORAGE_BATCH_CREATE_METRICS_NOT_IMPLEMENTED This storage provider does not support batch creating metrics | error_code | error | storage, observability, not-implemented, metrics, batch |
| observation.previousObserverTokens must be false or a… | validation | error | configuration, validation, observational-memory |
| Path must include :workflowId to route to the correct… | validation | error | config, routing, startup-validation |
| Registration failed with status | exception | error | http, network, api-error, registration |
| Saw text content for input CoreMessage, but the role is | exception | error | message-conversion, ai-sdk-v4, tool-messages, prompt |
| Unable to locate pricing data JSONL at any known path | exception | critical | filesystem, configuration, missing-file, observability |
| fourcc must be 4 ASCII characters, got | exception | error | avi, validation, recording, fourcc |
INVALID_DATA_ITEM Invalid data item at index | error_code | error | evals, dataset, validation, schema |
| must be relative | validation | error | http, validation, path-traversal, filesystem |
| [MastraAuthGoogle] GOOGLE_COOKIE_PASSWORD is required for… | validation | critical | configuration, production, security, session, sso, env-var |
MCP_CLIENT_SUBSCRIBE_RESOURCE_FAILED MCP_CLIENT_SUBSCRIBE_RESOURCE_FAILED | error_code | error | mcp, resources, subscribe, capability |
| Mock prompt not found for | exception | error | mcp, fixtures, test, prompt |
| No versions found for workspace | exception | error | storage, workspace, versioning, in-memory |
| Platform integration: missing required environment variable… | exception | critical | environment, configuration, missing-env-var, platform |
| request failed with status | http | error | network, http, server-error, rate-limit |
| runId required to time travel workflow stream | http | error | http-400, validation, workflow, missing-parameter |
AZURE_MANAGEMENT_CREDENTIALS_MISSING Management credentials incomplete. Missing | validation | error | azure, authentication, credentials, configuration |
| failed (exit ) | exception | error | sandbox, shell, exec, exit-code, filesystem |
| ENOENT: no such file or directory | exception | error | skills, filesystem, not-found |
| [FactorySecretEncryption] Invalid encrypted value. | exception | error | encoding, base64url, json, validation |
| Invalid browser configuration: "cdpUrl" and "scope… | validation | error | browser, configuration, cdp, validation |
| Kimi For Coding credentials are invalid. Please reconnect… | exception | error | auth, oauth, kimi, corrupt-credentials |
MAP_RESULTS_STEP_UNSUPPORTED_MODEL Tripwire handling requires a v2/v3 model | error_code | error | tripwire, guardrails, model-version, agent-workflow |
| Missing required query param | validation | error | http, validation, query-params, filesystem |
| Path not found in skill version tree | exception | error | filesystem, skills, versioning, not-found |
| Pull request must belong to | exception | error | validation, github, pull-request, url-parsing |
| Skill " " not found at | http | error | workspace, skills, http-404, not-found |
| Thread with id already exists | exception | error | storage, conflict, duplicate-id, thread |
| Uncommitted step flow changes detected. Call .commit() to… | exception | error | workflow, configuration, commit, lifecycle |
| Code Mode requires a sandbox to run model-authored code… | exception | error | code-mode, sandbox, configuration, missing-dependency |
DURABLE_AGENT_RECOVER_SNAPSHOT_NOT_FOUND DurableAgent " " recover( ): no persisted workflow snapshot found. The run may… | error_code | error | durable-agent, recovery, snapshot, storage, state-not-found |
| Env file not found | exception | error | env, filesystem, cli, deploy |
| Factory session does not belong to this project | exception | error | project, ownership, authorization, mismatch |
| Failed to create account | http | error | auth, http-400, sign-up |
INVALID_DATA_URL_FORMAT Invalid data URL format in content | exception | error | validation, data-url, multimodal, aisdk |
| Invalid retention duration | validation | error | validation, configuration, storage |
| language must be a two-letter code (e.g. "en", "es") | validation | error | validation, parameters, i18n |
| Memory requires a storage provider to function. Add a… | exception | critical | memory, storage, configuration, missing-dependency |
| Prompt " " not found | exception | error | mcp, prompt-not-found, invalid-params, lookup |
| Sandbox ' ' cannot resolve its workdir: no executeCommand… | exception | critical | sandbox, workdir, missing-capability |
| Sleep step " " cannot be stored: dynamic duration… | exception | error | workflow, serialization, sleep, dynamic-duration |
| SSE connection not established | http | error | mcp, sse, transport, connection-state |
| Unknown step entry type | exception | error | workflows, serialization, exhaustiveness, schema-mismatch |
| GitHub installation id is invalid. | validation | error | github, installation, validation, data-integrity |