mastra-ai/mastra
Documented errors, page 14 of 22. Back to mastra-ai/mastra
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Subconscious semantic knowledge requires a vector store… | validation | error | configuration, vector-store, subconscious, validation |
| Analysis step failed to produce results for reason… | exception | error | evals, llm, runtime, schema-validation |
| Both source and target nodes must exist | validation | error | rag, graph-rag, validation, graph-structure |
| DatasetsStorage not configured. Configure storage in Mastra… | exception | error | configuration, storage, missing-config |
| error.message (MastraError rethrown with mapped status in… | http | error | mastra-error, http-mapping, storage, batch-delete, datasets |
| GithubIntegration source-control storage has not been… | exception | error | lifecycle, storage, initialization |
| Invalid audit event response | validation | error | schema-validation, http, audit, api-contract |
| Invalid Code Mode external identifier | exception | error | code-mode, identifier, naming, validation |
INVALID_TSCONFIG INVALID_TSCONFIG | error_code | error | typescript, config, lint, module-resolution |
| No workspace configured | http | error | http-404, workspace, configuration, rest-api |
| Node must have an embedding | validation | error | rag, graph-rag, embedding, validation |
| Related work item not found in this project. | exception | error | storage, work-items, validation |
SCHEDULES_THREADLESS_OPTIONS schedules.create: require a threadId. | error_code | error | schedules, validation, agent |
SCORES_STORAGE_GET_SCORES_BY_SPAN_NOT_IMPLEMENTED SCORES_STORAGE_GET_SCORES_BY_SPAN_NOT_IMPLEMENTED | error_code | error | storage, not-implemented, scores, unsupported-operation |
| Stream part blocked by | exception | warning | agent, processors, streaming, tripwire |
| Version with id not found for agent | http | error | http-404, agent-versions, rest-api, ownership |
| Worker input exceeds inputLimitBytes | validation | error | sandbox, validation, payload-size, input |
| Workflow ' ' (key: ' ') must have a non-empty description… | exception | error | mcp, workflow, configuration, missing-description |
| create-workflow requires a Mastra context. | exception | error | mastra-context, misconfiguration, workflows |
| Failure in install step | exception | error | install, dependencies, workflow, template-builder |
| [FilesystemStorage] path must be a non-empty relative path. | validation | error | validation, path, filesystem, path-traversal |
| Keywords must be greater than 0 | validation | error | rag, extractors, validation, configuration, keywords |
| processes | exception | error | code-mode, sandbox, processes, feature-support |
| Prompt block with id | http | error | conflict, duplicate, server |
| Server configuration not found for name | exception | error | mcp, configuration, lookup, naming |
| Sync function " " already registered | exception | error | registration, duplicate, workflow, integration |
| Bright Data API token is required. Pass | validation | error | configuration, env-var, missing-config |
| Dynamic workflow bundle contains more than one definition… | exception | error | workflow, duplicate-id, validation |
| Factory rules.linear. | validation | error | validation, factory-rules, type-error |
| Path " " not found | http | error | workspace, http-404, file-not-found, path |
| Resource working memory is not implemented by this storage… | exception | error | storage, unsupported-operation, working-memory, bug |
| Snapshot context not found for runId | exception | error | workflow, storage, state |
| Agent ' ' not found for workflow step ' '. Register the… | exception | error | workflows, agents, configuration, registry |
| --continue and --thread cannot be used together | validation | error | cli, argument-parsing, conflicting-flags |
| Datasets require @mastra/core >= 1.4.0 | http | error | versioning, http-501, feature-gate, datasets |
DURABLE_AGENT_RECOVER_NO_STORAGE DurableAgent " " recover() requires persistent storage to load the run… | error_code | error | durable-agent, recover, storage, configuration |
| Factory rules.github. | validation | error | validation, factory-rules, type-error |
| [FactorySecretEncryption] Unknown key id | exception | error | encryption, key-management, rotation, configuration |
| [FilesystemStorage] resourceId must not be empty. | validation | error | validation, storage, filesystem |
| Invalid MemoryRequestContext.resourceId: expected string… | validation | error | memory, validation, request-context, resource-id |
| list-workflows requires a Mastra context. | exception | error | mastra, configuration, runtime-context, workflows |
| [mastra/auth-ee] Agent Builder is configured but no valid… | exception | critical | licensing, enterprise, agent-builder, env-var, startup |
| Mastra instance with pubsub is required for workflow… | exception | error | workflow, pubsub, configuration, evented |
| @mastra/livekit: MastraVoiceAgent requires `agent` or… | validation | error | validation, api-misuse, constructor, livekit |
| Memory storage is not initialized | http | error | memory, storage, http-400, initialization |
| Not logged in to xAI. | exception | error | auth, oauth, xai, login-required |
| must not contain cycles. | validation | error | validation, json, circular-reference, workflow-builder |
| PII detection failed | exception | error | processors, pii, error-wrapping |
| [Processor: ] computeStateSignal could not load thread | exception | error | processors, memory, thread, persistence |
| Skill " " not found | http | error | http-404, skills, workspace, not-found |
| Source thread not found | http | error | http-404, memory, thread, clone |
| Weather agent not found | exception | error | configuration, dependency-injection, agent-builder |
| Agent model not available | exception | critical | model, configuration, durable-agent |
| Extractor name " " produced invalid slug " ". | validation | error | observational-memory, extractor, naming, input-validation |
| Hybrid search requires both vector and BM25 configuration. | validation | error | search, configuration, hybrid-search, misconfiguration |
| Mode " " transitionsTo references unknown mode | exception | error | configuration, agent-controller, state-machine, missing-reference |
| No content available for skill | http | error | http-404, empty-content, skills-api |
OBSERVABILITY_INVALID_DELTA_CURSOR Invalid observability delta cursor | error_code | warning | storage, observability, cursor, validation |
| : per-entity files directory is not configured | exception | error | storage, configuration, filesystem |
| Version with id already exists | exception | error | storage, duplicate-key, scorer-definitions, in-memory |
| Workflow " " declares duplicate schedule id " ". | validation | error | workflow, scheduling, configuration, validation |
| workingMemory.useStateSignals is not supported with… | exception | error | memory, working-memory, configuration, incompatible-options |
| Agent " " is already connected to Telegram. Disconnect… | exception | error | telegram, state-conflict, configuration |
| GitHub capabilities require an app-installation connection. | validation | error | github, authentication, configuration |
| Mapping references unknown workflow init-data | exception | error | workflow, mapping, registration, rehydration |
MASTRA_GET_TOOL_BY_ID_NOT_FOUND Tool with id not found | error_code | error | lookup-failed, tools, empty-registry |
| Not a git repository | exception | error | git, filesystem, configuration |
OBSERVABILITY_STORAGE_GET_ENVIRONMENTS_NOT_IMPLEMENTED This storage provider does not support environment discovery | error_code | warning | storage, observability, not-implemented, telemetry |
OBSERVABILITY_STORAGE_GET_SCORE_BY_ID_NOT_IMPLEMENTED This storage provider does not support getting scores by ID | error_code | error | storage, observability, not-implemented, scores |
OBSERVABILITY_STORAGE_GET_SPAN_NOT_IMPLEMENTED This storage provider does not support getting spans | error_code | error | storage, observability, tracing, unsupported-operation |
| Responses route could not determine the effective model for… | http | error | http-500, model-resolution, responses-api, configuration |
AGENT_SEND_STREAM_RESUME_NO_SUSPENDED_THREAD_RUN Agent " " sendStreamResume() could not find a suspended run " " for thread " ". | error_code | error | agent, streaming, resume, state-not-found |
| agent thread subscriptions are not supported by this Mastra… | http | error | http-501, version-compatibility, subscriptions, server |
| data.errors[0].message | http | error | cloudflare, api, secrets, auth |
| Failed to fetch resource templates from server | exception | error | mcp, network, resources, templates, wrapped-error |
INVALID_SCORER_THRESHOLD threshold for scorer " " must be a finite number between 0 and 1, got | error_code | error | scorer, threshold, config-validation, mastra-error |
| list-available-workflows requires a Mastra context. | exception | error | mastra, configuration, runtime-context, workflows |
| Local plugin path does not exist or is not a directory | validation | error | filesystem, plugins, path-validation, local-install |
| MastraCode requires at least one mode | exception | error | configuration, modes, startup |
| One or more process memory diagnostic artifact writes… | exception | error | filesystem, disk-full, permissions, diagnostics |
| Processor tripwire triggered | exception | warning | workflow, tripwire, processor, guardrails |
| Push notification URL resolved to a local or private IP | validation | error | a2a, ssrf, dns, dns-rebinding |
| Source provider cannot write files | exception | error | storage, agents, permissions, source-provider, write |
| Subconscious agent name is required. | exception | error | configuration, validation, subconscious |
| thread " " not found | http | error | http-404, thread, memory, not-found |
| TokenCostControl requires maxCost to be a finite positive… | validation | error | configuration, validation, cost-control, constructor |
| Unsupported browser provider | exception | error | browser, configuration, unsupported-provider |
| Version with id not found for prompt block | http | error | http-404, rest-api, id-mismatch, versions |
| Workspace does not have search configured | http | error | http-400, search, workspace, configuration |
| You do not have permission to view usage for this connection | http | warning | http-403, authorization, multi-tenancy, tool-providers |
| A2A stream response did not include a body (status: ) | http | error | a2a, streaming, http |
AGENT_LIST_SUSPENDED_RUNS_INVALID_PER_PAGE Agent " " listSuspendedRuns() requires perPage to be a positive integer. | error_code | error | agent, validation, pagination, input-validation |
| AgentControllerChannels is not bound to an AgentController… | exception | error | channels, configuration, initialization-order |
| AISDKv5 chunk type "reasoning-signature" not supported | exception | error | streaming, reasoning, aisdk, unsupported |
| Cannot resume workflow: no snapshot found for runId | exception | error | workflow, storage, resume, missing-snapshot |
| CursorSDKAgent does not support structuredOutput because… | validation | error | cursor, structured-output, unsupported-feature, validation |
DATASETS_STORE_NOT_AVAILABLE Datasets store not available. Ensure your storage adapter provides a datasets… | error_code | error | storage, datasets, compatibility |
| detail | exception | error | cli, api, server-error, http |
| Device credentials not found | exception | warning | auth, credentials, sync, swallowed-error |
| Google ID token is missing subject | exception | error | oauth, openid-connect, jwt, claims, token-validation |