mastra-ai/mastra
Documented errors, page 13 of 22. Back to mastra-ai/mastra
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| connect( ): "name" is required when connecting without an… | validation | error | validation, api-misuse, slack |
| Factory skill cancelInFlight must be a boolean. | validation | error | validation, type-mismatch, factory-rules |
| Mastra instance or listMCPServers method not available | http | critical | http-500, version-mismatch, mcp, configuration |
| Subconscious pins.maxPins must be a positive integer. | exception | error | configuration, validation, subconscious |
| The workingMemory.use option has been removed. Working… | validation | error | memory, working-memory, deprecation, breaking-change |
| You do not have permission to disconnect this connection | http | warning | http-403, tool-providers, authorization, multi-tenancy, fail-closed |
AGENT_GENERATE_MALFORMED_RESULT Execution workflow produced a result without getFullOutput | error_code | error | agent, generate, internal, contract-violation |
| Cannot authenticate MCP server | exception | error | mcp, oauth, configuration, type-mismatch |
| Chunk overlap ( ) must be smaller than chunk size ( ). | validation | error | rag, chunking, configuration, validation |
| Connect a repository before creating a workspace | exception | error | prerequisite, configuration, factory-ui, react-query |
| error.message (MastraError rethrown with mapped status in… | http | error | mastra-error, http-mapping, storage, batch-insert |
| Factory rule produced too many decisions. | validation | error | validation, limit-exceeded, factory-rules |
| Failed to resolve created workspace | http | error | http-500, storage, internal-state |
| Invalid snapshot format in | exception | error | snapshots, schema-validation, format, filesystem |
| Knowledge tools require an active resourceId. | exception | error | configuration, request-context, knowledge-tools, memory |
| MainSidebarNavLink requires a valid React element child… | exception | error | react, aschild, props-validation, playground-ui |
| No OAuth authorization is pending for this server. Call… | exception | error | mcp, oauth, auth, state |
| WorkOS redirect URI is required. Provide it in the options… | validation | error | config, workos, sso, oauth, redirect-uri |
AZURE_ENTRA_ID_TOKEN_ERROR Failed to get Entra ID token for Azure OpenAI gateway | exception | error | azure, entra-id, authentication, token |
| Device credentials not found. | exception | error | auth, credentials, not-found |
| Dynamic workflow references tool | exception | error | workflow, tool, registration, rehydration |
| HTML chunking requires either headers or sections to be… | validation | error | rag, chunking, validation, configuration, html |
| Item not found at version | http | error | http-404, datasets, versioning, scd2 |
| Method not implemented. | exception | error | abstract-method, integration, tools, not-implemented |
| No adapter registered for platform | exception | error | channels, adapter, request-context |
| Not found at ref | exception | error | git, filesystem, not-found |
| Not logged in to Anthropic. | exception | error | auth, oauth, not-authenticated |
| Not logged in to OpenAI Codex. | exception | error | auth, oauth, openai-codex, login-required |
OBSERVABILITY_STORAGE_BATCH_CREATE_SPAN_NOT_IMPLEMENTED This storage provider does not support batch creating spans | error_code | error | storage, observability, tracing, batch, unsupported-operation |
| Some filesystems failed to destroy | exception | error | workspace, filesystem, cleanup, aggregate-error |
| Tried to upsert embeddings but this Memory instance doesn't… | exception | error | memory, vector-store, embeddings, configuration |
| useJSONSchemaFormField must be used within a… | exception | error | react, context, compound-components, json-schema, playground-ui |
| Dynamic workflow references nested workflow | exception | error | workflow, nested-workflow, registration, rehydration |
| Invalid path in | exception | error | workflow, mapping, path-traversal, configuration |
| JSON.stringify(errorResponse) | http | warning | server, http, validation, bad-request |
| mastra-wrapper plugin did not return code, there is likely… | exception | error | babel, plugin, build, deployers |
| BackgroundTaskWorker: failed to initialize background task… | exception | error | worker, initialization, manager |
| Could not read file | exception | error | cli, filesystem, env-file |
DEPRECATED_ENDPOINT This endpoint is deprecated. Please use the @mastra/ai-sdk package to for… | error_code | warning | http-410, deprecated-endpoint, ai-sdk, migration |
EXPERIMENT_TARGET_NOT_FOUND Target not found | error_code | error | experiments, configuration, not-found |
| Invalid arguments for firecrawl_deep_research | exception | error | mcp, validation, tool-arguments, firecrawl |
| Invalid parameters for | validation | error | rag, chunking, validation, zod, configuration |
| KnowledgeRecord not found | exception | error | memory, knowledge-graph, entity-not-found |
MASTR_SCORER_FAILED_TO_CREATE_MISSING_ID Scorers must have an ID field. Please provide an ID in the scorer config. | error_code | error | scorer, config, evals, missing-field |
| @mastra/opencode: failed to initialize memory storage from | exception | error | storage, libsql, memory, opencode |
| Not implemented | exception | error | workflows, evented, not-implemented, bail |
OBSERVABILITY_STORAGE_GET_TRACE_LIGHT_NOT_IMPLEMENTED This storage provider does not support getting lightweight traces | error_code | warning | storage, observability, tracing, deprecated-api, unsupported-operation |
| resourceId and threadId are required to persist an active… | exception | error | agent, signal, memory, missing-argument |
RUN_EXPERIMENT_SCORER_FAILED_TO_SCORE_STEP_RESULT Failed to run experiment: Error running scorer | error_code | error | evals, scorer, workflow, error-wrapping |
SEMANTIC_RECALL_MISSING_VECTOR_ADAPTER Using Mastra Memory semantic recall requires a vector adapter but no attached… | error_code | error | memory, vector, semantic-recall, configuration |
| Cannot resume task in status | exception | error | background-tasks, state-machine, invalid-state |
| Failed to fetch Copilot models | http | error | network, http, api, github-copilot |
| Failed to fetch templates | http | error | network, http, api, cli |
| Invalid or expired state parameter | exception | error | okta, sso, oauth-state, csrf |
| Memory storage domain is not available on | exception | error | memory, storage, configuration, version-mismatch |
| ModelByInputTokens requires at least one threshold in "upTo" | validation | error | config, observational-memory, constructor |
| No Telegram installation found for agent | exception | error | telegram, state-conflict, cleanup |
| Platform integration: missing required config field(s) | exception | error | configuration, validation, constructor, platform |
| ${response.error || 'LLMs.txt generation failed'} | exception | error | network, api-error, firecrawl, async-job |
| Tool " " is not available in Code Mode | exception | error | code-mode, tool-dispatch, missing-tool, runtime |
| traceId and spanId are required | exception | warning | react, react-query, traces, missing-argument, playground-ui |
DURABLE_AGENT_RESUME_AGENT_MISMATCH DurableAgent " " resume( ): persisted run belongs to agent " ", not " ". | error_code | error | durable-agent, resume, ownership, agent-mismatch |
| [FactorySecretEncryption] Key id is required. | exception | error | encryption, configuration, missing-value, keys |
| Failed to get Netlify AI Gateway token | exception | error | netlify, http, authentication, api-error |
| Google token response did not include an ID token | http | error | oauth, oidc, google, sso, missing-field |
| @mastra/livekit: `configuration.endCall` has no effect with… | validation | error | configuration, livekit, validation |
| @mastra/livekit: MastraVoiceAgent requires `agent` or… | validation | error | validation, api-misuse, constructor, livekit |
| Metadata filter must be an object. | validation | error | validation, storage, metadata |
| No deploys found for linked Server project | exception | error | cli, deploy, server, api |
| No suspended steps found in this workflow run | exception | error | workflow, resume, suspended-step |
| No versions found for skill | exception | error | storage, corrupt-state, skills, in-memory, versions |
NODE_FAIL_INSTALL_SPECIFIED_VERSION NODE_FAIL_INSTALL_SPECIFIED_VERSION | error_code | error | node, install, deployment, subprocess |
| res.error.message | exception | error | workflow, run-failure, error-propagation |
| resourceId and threadId are required to send a state signal | exception | error | agent, memory, signal, missing-argument |
SCHEMA_UNAVAILABLE SCHEMA_UNAVAILABLE: This command does not accept JSON input | error_code | warning | cli, schema, unsupported-operation |
| Session validation failed | exception | error | auth, sso, session, callback |
| Storage is required for channel thread mapping. Configure… | exception | error | storage, channels, thread-mapping |
| Stored sleepUntil " " has an unparseable date | exception | error | workflow, date, persistence |
DOWNLOAD_ASSETS_FAILED Failed to download asset | error_code | error | network, download, http, asset |
git-missing git is not installed in the sandbox. The sandbox template must include git. | error_code | error | environment, git, sandbox, missing-dependency |
| GithubIntegration storage has not been initialized. | exception | error | lifecycle, storage, initialization |
| Google client ID is required. Provide it in the options or… | validation | error | configuration, oauth, google, env-var, startup |
| Invalid Copilot models response: missing `data` array | exception | error | network, api, schema-validation, response-parsing, github-copilot |
MASTRA_GATEWAY_NO_API_KEY Missing MASTRA_GATEWAY_API_KEY environment variable | error_code | error | api-key, environment, configuration, gateway |
| No page available for screencast | exception | error | browser, screencast, cdp, page |
| must contain a plugins array | validation | error | manifest, schema-validation, config, shape-mismatch |
| Resource ID is required for recall | exception | error | memory, missing-argument, validation |
| sendNotificationSignal requires a notifications storage… | exception | error | agent, storage, notifications, configuration |
| User prompt is required for user prompt alignment scoring | validation | error | evals, runtime, validation, message-extraction |
| A2A stream error | exception | error | a2a, streaming, remote-error, client |
| BUG: add handling for message role | exception | error | message-list, role-detection, internal-invariant |
| createMultiTurnJudgeScorer: options.scale must be a finite… | validation | error | configuration, validation, evals, nan |
| Expected format /model, but got | exception | error | parsing, gateway, validation |
| Gateway memory message metadata filters are not supported… | http | warning | http-501, gateway, unsupported-feature |
gh-missing The GitHub CLI (gh) is not installed in the sandbox. The sandbox template must… | exception | error | github-cli, sandbox, prerequisites |
| Invalid ENV value for | validation | error | env, validation, cli-services |
| Invalid retention duration | validation | error | validation, configuration, duration |
| OrchestrationWorker requires a pull-capable PubSub, but the… | exception | error | pubsub, worker, configuration, incompatible-transport |
| Prompt not found | exception | error | mcp, prompts, not-found, input-validation |
| [Slack] No storage available. SlackProvider requires… | exception | error | storage, configuration, slack |