mastra-ai/mastra
Documented errors, page 19 of 22. Back to mastra-ai/mastra
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| must be a positive integer | validation | warning | cli, validation, numeric |
| HTTP | exception | error | network, http, logging, retry |
| InProcessStrategy requires Mastra instance. Call… | exception | error | worker, initialization, in-process, lifecycle |
| Invalid ciphertext format | validation | error | crypto, decryption, data-format |
| Repository does not belong to the connection installation. | exception | error | source-control, installation-mismatch, repository, link |
| Schedule already exists | exception | error | storage, duplicate-key, schedules, in-memory |
| The "workflow-builder" sub-agent is not registered on this… | exception | error | mastra-context, agent-registration, workflows |
| Worker " " not found. Available | exception | error | worker, lookup-failed, naming |
| Factory message prepareBinding must be a boolean. | validation | error | validation, type-mismatch, factory-rules |
| . must be an object. | validation | error | validation, structure, factory-rules, type-mismatch |
| No relevance score found on Cohere response | exception | error | api-error, cohere, rerank, response-parsing |
OBSERVABILITY_STORAGE_GET_SCORE_PERCENTILES_NOT_IMPLEMENTED This storage provider does not support score percentiles | error_code | error | storage, observability, not-implemented, percentiles |
| Skill name and reference path are required | http | error | http-400, validation, skills, rest-api |
| terminationGraceMs must be greater than zero. | validation | error | worker, validation, configuration |
| Cannot combine an environment argument with --shared. Pick… | exception | error | cli, argument-conflict, validation |
| Could not find a plugin entry file. Tried | exception | error | plugins, filesystem, convention, configuration |
| Failed to initiate xAI device authorization | exception | error | oauth, xai, device-flow, http |
| Failed to parse A2A stream event | exception | error | streaming, json, parsing, a2a, client |
| Missing required query param: threadId | validation | error | http, validation, missing-parameter |
OBSERVABILITY_STORAGE_GET_FEEDBACK_AGGREGATE_NOT_IMPLEMENTED This storage provider does not support feedback aggregation | error_code | error | storage, observability, not-implemented, feedback, aggregation |
| Path traversal detected | exception | error | security, path-traversal, skills, zip-slip |
| Push notification URL must not target local or private IPs | validation | error | a2a, ssrf, security, private-ip |
| runId required to cancel workflow run | http | error | http-400, validation, workflow, missing-parameter |
| skillPath must be within the allowed directory | http | warning | security, path-traversal, validation |
| Tool is not executable | http | error | http-400, tools, validation, tool-definition |
| useMainSidebar must be used within a MainSidebarProvider. | exception | error | react, context, sidebar, playground-ui |
AGENT_GENERATE_UNKNOWN_ERROR An unknown error occurred while streaming | error_code | error | agent, generate, unknown-status, internal |
| Failed to read database status | http | error | http-error, platform-api, polling, network |
| Invalid model configuration provided | exception | error | configuration, model, invalid-argument, typescript |
OBSERVABILITY_STORAGE_GET_TRACE_NOT_IMPLEMENTED This storage provider does not support getting traces | error_code | error | storage, observability, tracing, unsupported-operation |
| Path and content are required | http | error | workspace, http-400, validation, missing-parameter, file-write |
| skillPath is not a directory | http | warning | validation, filesystem, bad-request |
| Subconscious requires requestContext.organizationId to… | validation | error | configuration, request-context, subconscious, multi-tenancy |
| Factory rules.linear must be an object. | validation | error | validation, factory-rules, configuration |
| Failed to rehydrate registry entry for run | exception | error | durable-agent, resume, rehydration, registry |
| GitHub plugin URL must be in the form… | validation | error | plugin-install, url-validation, github |
| Missing value for | exception | error | cli, arguments, parsing, tui |
| Node not found | exception | error | rag, missing-key, graph, argument-error |
OBSERVABILITY_STORAGE_GET_SCORE_BREAKDOWN_NOT_IMPLEMENTED This storage provider does not support score breakdown | error_code | error | storage, observability, not-implemented, analytics |
OBSERVABILITY_STORAGE_GET_SPANS_NOT_IMPLEMENTED This storage provider does not support batch-fetching spans | error_code | error | storage, observability, tracing, batch, unsupported-operation |
| Project has no environments. Create one with: mastra env… | exception | error | cli, environment, prerequisite, cloud |
SCHEDULES_INVALID_WORKFLOW_PATCH schedules.update: only apply to agent schedules. | error_code | error | schedules, validation, workflow, update |
| Source-control connection not found for this organization. | exception | error | storage, not-found, github, connection |
| BackgroundTaskManager is shutting down, cannot enqueue new… | exception | error | background-tasks, shutdown, backpressure |
EXPERIMENT_RESULT_MISSING_EXPERIMENT_ID updateExperimentResult requires experimentId when called via a Dataset handle | error_code | error | storage, experiment, validation, missing-argument |
| Factory rules.linear. | validation | error | validation, factory-rules, configuration |
| Memory is not configured for this agent | http | error | memory, configuration, http-400 |
| Message deletion is not supported by this storage adapter | exception | error | storage, unsupported-operation, memory |
| No mount for dest | exception | error | filesystem, mount-resolution, composite-filesystem |
| The threads.generateTitle option has been moved. Use the… | validation | error | memory, threads, deprecation, breaking-change |
| Unknown ACP sessionId | exception | error | acp, session-state, state-management |
| Unknown content type | exception | error | voyageai, multimodal, unsupported-type, input-validation |
| Version number already exists for skill | exception | error | duplicate-key, versioning, storage |
WORKFLOW_WAIT_FOR_EVENT_REMOVED waitForEvent has been removed. Please use suspend & resume flow instead. See… | error_code | error | workflow, removed-api, migration, suspend-resume |
| Field key cannot be empty | validation | error | sql, validation, field-key, storage |
| get-workflow requires a Mastra context. | exception | error | mastra-context, misconfiguration, workflows |
| MCPClientServerProxy does not support HTTP transport | exception | error | mcp, unsupported-transport, http, client-proxy |
| Okta API token is required for RBAC. Provide it in the… | validation | error | config, env-var, okta, authentication, constructor |
| sendStateSignal could not load thread | exception | error | agent, memory, storage, thread-not-found |
| State parameter has expired | exception | error | okta, sso, oauth-state, expiration |
| Step not prepared yet — call prepare() first | exception | error | observational-memory, lifecycle, state |
| Stored scorer definition with id | http | error | http-404, storage, not-found, rest-api |
| Subconscious curate requires organizationId in the request… | validation | error | configuration, request-context, subconscious, curation |
| Template " " not found. Available templates | exception | error | lookup, not-found, input-validation |
| This conversation has no message to name it from yet. | exception | error | memory, title-generation, messages |
| Version with id not found for MCP client | http | error | http-404, ownership, mcp, mismatch |
| Failed to load prompts | exception | error | mcp, prompts, callback |
| Failed to write scorer | exception | error | filesystem, permissions, cli, write |
| GitHub reconcile worker requires a pull request or issue… | validation | error | github, configuration, constructor |
| Invalid cron expression: expected a non-empty cron string… | validation | error | workflows, scheduler, cron, validation |
| Invalid worker environment variable name | validation | error | worker, validation, environment-variables |
| Knowledge node already exists in scope | exception | error | knowledge-store, name-collision, unique-constraint, rename |
| maxRetainedBytes must be a non-negative integer or Infinity | validation | error | validation, range-error, process |
| Resume label " " not found. Available labels: [ ] | exception | error | workflow, resume, label, configuration |
| UnixSocketPubSub is closed | exception | error | pubsub, lifecycle, shutdown, unix-socket |
| Unsupported URL protocol | exception | error | url, attachment, protocol, validation |
| Vectors array cannot be empty | error_code | error | validation, vector-store, upsert |
| xAI token response missing refresh_token | exception | error | oauth, xai, response-validation |
| Built-in Subconscious reflection agent | exception | error | configuration, validation, observational-memory |
DATASET_ITEM_NOT_FOUND Item not found in dataset at version | error_code | error | storage, experiments, not-found, versioning |
| Factory rules must be an object. | validation | error | validation, null-check, factory-rules, config |
| Okta redirect URI is required for SSO. Provide it in the… | validation | error | okta, configuration, env-var, sso |
| Sub-agent returned a v1 model but does not implement… | exception | error | agent, delegation, sub-agent, streaming, model-version, v1-legacy |
| Timeout resolving WebSocket URL from | exception | error | network, timeout, cdp, browser |
| Cohere API error | exception | error | network, api-error, cohere, rerank |
| Invalid input: array items must be strings or objects with… | validation | error | memory, input-validation, api-misuse |
| Knowledge scope contains multiple | exception | error | knowledge, scope, validation, duplicate |
| @mastra/livekit: Mastra agent stream returned an empty… | exception | error | network, streaming, sse, livekit, proxy |
| No channel context — cannot determine platform or thread | exception | error | channels, request-context, missing-context |
| Perplexity Search request failed with status | http | error | network, http, api, perplexity |
| plugin at index must be an object | validation | error | manifest, schema-validation, type-mismatch, config |
| Source object must be a single RelatedNodeInfo object | validation | error | data-structure, rag, relationships |
| xAI device authorization response missing required fields | exception | error | oauth, xai, device-flow, response-validation |
| Cannot set both `model` and `observation.model`. Use… | validation | error | config, validation, conflicting-options |
| Expected format azure-openai/deployment-name, but got | exception | error | parsing, azure, validation |
| Invalid mount path: . Path segments cannot be "." or "..". | validation | error | validation, security, path-traversal, mount |
| metadata.avatarUrl must be a string | http | error | http-400, type-mismatch, metadata, validation |
| Rule metadata contains too many fields. | validation | error | validation, limits, json |
| Schedule not found | http | error | http-404, schedules, server |
| Agent model list is not found or empty | http | error | http-400, agents, configuration, model-list, empty-state |