mastra-ai/mastra
Documented errors, page 18 of 22. Back to mastra-ai/mastra
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Rule metadata contains too many entries. | validation | error | validation, limits, json |
| Schema for tool not found in provider | http | error | http-404, tool-providers, schema, lookup-failed |
| The related work item chain contains a cycle. | exception | error | storage, work-items, cycle, data-integrity |
| Working memory is not enabled for this memory instance | exception | error | memory, working-memory, configuration |
| xAI token response missing access_token | exception | error | oauth, xai, response-validation |
| A user or system prompt is required for combined alignment… | validation | error | evals, runtime, validation, message-extraction |
| Agent " " does not have memory configured | http | error | memory, http-400, agent-configuration, conversations |
AGENT_NETWORK_ROUTING_AGENT_INVALID_OUTPUT Routing agent returned undefined for 'object'. This may indicate an issue with… | error_code | error | agent-network, structured-output, routing, model-response |
| App creation failed | exception | error | slack, api, manifest, validation |
| Argument " " is required | validation | error | http-400, request-body, validation, rest-api |
| Cannot resume workflow: workflows store is required | exception | error | workflow, storage, resume, configuration |
| countCoreSystemMessageTokens: System message content must… | exception | error | token-limit, processors, content-format, validation |
MASTRA_GET_PROCESSOR_BY_ID_NOT_FOUND Processor with id not found | error_code | error | lookup-failed, processors, empty-registry |
| No active thread context and no cursor or threadId was… | exception | error | memory, missing-argument, threads |
| No search configuration available. Provide bm25 or vector… | validation | error | search, configuration, misconfiguration, setup |
OBSERVABILITY_SPAN_ID_REQUIRED Span ID is required for creating a span | error_code | error | storage, observability, tracing, missing-id |
| Reference " " not found in skill | http | error | http-404, skills, file-not-found, rest-api |
| Schedule not found | exception | error | storage, not-found, schedules, in-memory |
| Sentence chunking requires maxSize to be specified | validation | error | rag, chunking, validation, configuration |
| Subconscious maxSteps must be an integer between 1 and | exception | error | configuration, validation, subconscious |
| : entity with id not found | exception | error | storage, not-found, filesystem |
| Union must have at least 2 options | exception | error | zod, union, schema |
| Version number already exists for MCP server | exception | error | duplicate-key, storage, uniqueness |
| Version number already exists for agent | exception | error | storage, agents, versioning, conflict |
| A2A JSON-RPC response did not include a result | exception | error | a2a, json-rpc, protocol |
| Cannot decline a tool call without a current thread | exception | error | agent, tool-approval, thread |
| GitHub cursor must be a positive page number. | validation | error | github, pagination, validation |
NO_FILESYSTEM Workspace does not have a filesystem configured | error_code | error | configuration, workspace, filesystem, missing-config |
| No Pubsub adapter configured on the Mastra instance | exception | error | workflows, evented, pubsub, configuration |
OBSERVABILITY_STORAGE_GET_SCORE_AGGREGATE_NOT_IMPLEMENTED This storage provider does not support score aggregation | error_code | error | storage, observability, not-implemented, aggregation |
| outputStream phase cannot be executed directly. Use… | validation | error | http-400, processors, streaming |
| Plugin entry must be inside the plugin directory | validation | error | path-traversal, plugins, configuration, security |
| resourceId and threadId are required when runId is not… | http | error | http-400, missing-parameter, agent-signals, server |
| This workflow run was not suspended | exception | error | durable-agent, resume, workflow-state |
| useMobileDrawer must be used within a MainSidebarProvider. | exception | error | react, context, sidebar, playground-ui |
| Could not identify provider from model id | exception | error | models-dev, invalid-input, model-id, gateway |
| Failed to execute Upstash command | exception | error | network, redis, logging, upstash, retry |
| Failed to unlink repository | exception | error | http, fetch, factory, idempotency |
| getMetricsByType() has been removed: metricType is no… | exception | error | deprecated, removed-api, metrics, migration |
| JSON chunking requires maxSize to be specified | validation | error | rag, chunking, validation, configuration, json |
NEXT_MISSING_SERVER_EXTERNAL_PACKAGES NEXT_MISSING_SERVER_EXTERNAL_PACKAGES | error_code | error | lint, nextjs, configuration, bundler |
| No source thread to clone | exception | error | state, lifecycle, threading |
| notification-inbox requires a threadId | exception | error | notifications, tool, missing-argument |
| OrchestrationWorker: call init() before start() | exception | error | lifecycle, worker, initialization |
| Plugin at must declare an exact pnpm version in… | validation | error | pnpm, package-json, configuration, plugins |
| Vector dimensions must match: vec1 | validation | error | rag, dimension-mismatch, embedding, argument-error |
WORKFLOW_SCHEMA_VALIDATION_FAILED Invalid : \n : `).join('\n')} | validation | error | workflow, schema, validation, zod |
| writeMjpegAviFile: frame | validation | error | jpeg, avi, codec, frame-validation |
| Current thread is required when browsing by cursor | exception | error | memory, pagination, missing-argument |
| Failed to stream logs | http | error | cli, streaming, sse, network |
| GitHub installation was not found | exception | error | github, missing-resource, installation |
| Knowledge record not found | exception | error | knowledge, not-found, delete, idempotency |
| Knowledge scope cannot be empty | exception | error | knowledge, scope, validation, empty-input |
| ${message}: ${status} | exception | error | cli, api, http-status, fallback |
| No data source: provide datasetId or data | exception | error | configuration, experiment, invalid-argument, user-input |
| Relaunch requires a new executionId. | validation | error | sandbox, invalid-argument, relaunch, identifier |
| Scorer definition with id | exception | error | storage, duplicate-key, scorer-definitions, in-memory |
| Unsupported file extension | exception | error | filesystem, archive-extraction, cache |
| WorkOS webhook secret is required. Provide it in options or… | validation | error | config, env-var, workos, webhook, directory-sync |
| Could not derive MCP client ID from name. Please provide an… | http | error | validation, mcp, http-400, input |
| must be of the form or . | validation | error | workflow, template, mapping, syntax |
| Failed to refresh OpenAI Codex token | exception | error | oauth, openai, token-refresh |
| Invalid browser configuration: "cdpUrl" cannot be used with | validation | error | browser, configuration, cdp, validation |
MISSING_MASTRA_CORE MISSING_MASTRA_CORE | error_code | error | lint, dependencies, missing-package, configuration |
| No adapter for platform | exception | error | channels, adapter, configuration |
| Path is required | http | error | workspace, http-400, validation, missing-parameter |
| Scorer with id not found | http | error | http-404, storage, server |
| Source-control installation not found for this organization. | exception | error | storage, not-found, github, installation |
| state signal id is required | exception | error | signals, state, missing-argument |
| Stored MCP client with id | http | error | mcp, not-found, http-404, rest |
| Stored responses require the target agent to have memory… | http | error | http-400, memory, responses-api, configuration |
| Tried to query vector index | exception | error | memory, vector-store, configuration, semantic-recall |
| Agent not found | http | error | http-404, agent-not-found, routing |
AGENT_SEND_STREAM_RESUME_MISSING_TARGET sendStreamResume() requires threadId, resourceId, and runId. | error_code | error | agent, streaming, validation, missing-argument |
| [FilesystemStorage] duplicate file path | validation | error | validation, duplicate, filesystem, batch |
| Invalid agent-builder action | http | error | agent-builder, http-400, validation, workflow-registry |
| MCPClientServerProxy does not support stdio transport | exception | error | mcp, unsupported-transport, stdio, client-proxy |
| No environments found for this project. Deploy first with… | exception | error | cli, mastra-cloud, deploy, empty-state |
| Plan file " " not found | http | warning | http-404, workspace, plans, filesystem |
| Summaries must be one of 'self', 'prev', 'next' | validation | error | configuration, validation, rag |
| : version with id already exists | exception | error | storage, versioning, duplicate-key |
| CDP session not available for mouse injection | exception | error | browser, cdp, input-injection, missing-session |
| Factory rule decision type is required. | validation | error | validation, factory-rules, missing-field |
| Failed to create API key | http | error | http-error, platform-api, api-key, auth |
| Kimi For Coding device authorization failed | http | error | network, http, oauth, device-flow, kimi-coding |
| Mode " " transitionsTo cannot reference itself | exception | error | configuration, agent-controller, state-machine, self-reference |
| Recording outputPath must be inside | exception | error | path-traversal, security, validation, recording |
| Repository link is incomplete | exception | error | storage, missing-resource, github, consistency |
| Stored response was not found | http | error | http-404, responses-api, server |
| Token rotation returned incomplete data | exception | error | slack, token-rotation, api-contract |
| xAI device authorization returned a non-https… | exception | error | oauth, xai, device-flow, security |
| Agent " " is already connected to Slack. Disconnect first… | exception | error | state-conflict, duplicate, slack |
| BackgroundTaskManager is shutting down, cannot resume tasks | exception | error | background-tasks, shutdown, resume |
| Could not derive workspace ID from name. Please provide an… | http | error | validation, http-400, workspaces, identifiers |
| File path does not exist | exception | error | filesystem, logging, validation |
| Inspector session is unavailable. | exception | error | inspector, state-error, allocation-sampling |
| Invalid timezone | exception | error | workflows, scheduler, cron, timezone |
| Presets file must contain a JSON object with named presets | validation | error | cli, json, config, schema-validation-failed |
| RBAC provider does not support role permission resolution | http | error | rbac, api-surface, http-404 |
| Restart probability must be between 0 and 1 | validation | error | validation, parameters, graph-rag |