mastra-ai/mastra
Documented errors, page 16 of 22. Back to mastra-ai/mastra
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Item does not belong to dataset | exception | error | storage, datasets, in-memory, ownership |
| No organization matched --org | exception | error | cli, configuration, organization, flag-validation |
| perPage must be >= 0 | exception | error | storage, pagination, validation |
| Skills API error | http | error | network, http-502, upstream-api, skills-registry |
| Snapshot file not found | exception | error | snapshots, missing-file, filesystem, ci |
| structuredOutput object is undefined | exception | error | observational-memory, llm, structured-output, extraction |
| Subconscious capture shares the Observer model and does not… | exception | error | configuration, validation, observational-memory |
| Tried to embed message content but this Memory instance… | exception | error | memory, embedder, configuration |
| useJSONSchemaForm must be used within a JSONSchemaForm.Root | exception | error | react, context, compound-components, json-schema, playground-ui |
| chat module not loaded yet — call getChatModule() first | exception | error | lazy-loading, initialization-order, channels |
EXPERIMENT_NOT_FOUND Experiment not found | error_code | error | storage, experiment, not-found, ownership |
| Failed to fetch logs | exception | error | cli, api, logs, network |
| If the attachment is not an image or text, it must specify… | exception | error | attachment, mime-type, validation |
| Invalid GitHub repository URL. Use https://github.com/ | validation | error | cli, url-validation, github |
| Messages must be an array of UIMessage objects | validation | error | ai-sdk, validation, request-body, schema-validation-failed |
| Mode " " cannot set both "tools" and "additionalTools" -… | exception | error | configuration, agent-controller, tools, mutually-exclusive |
OBSERVABILITY_STORAGE_GET_FEEDBACK_TIME_SERIES_NOT_IMPLEMENTED This storage provider does not support feedback time series | error_code | error | storage, observability, not-implemented, feedback, time-series |
| Push notification URL must use http or https | validation | error | a2a, url-validation, ssrf, push-notifications |
| shareTokenBudget requires async buffering to be disabled… | validation | error | config, validation, incompatible-options, tokens |
| Vectors must not be null or undefined | validation | error | rag, null-check, embedding, argument-error |
AZURE_ENTRA_ID_AUTH_NOT_CONFIGURED Entra ID authentication is not configured for Azure OpenAI gateway | validation | error | azure, authentication, configuration, entra-id |
| Failed to fetch from models.dev | exception | error | network, http, models-dev, registry |
| Failed to fetch resources from server | exception | error | mcp, network, resources, wrapped-error |
| GitHub capabilities require an owner/repository source. | exception | error | github, validation, source-id, slug |
| Knowledge record version conflict | exception | error | knowledge-store, optimistic-concurrency, version-conflict, retry |
| `} | exception | error | claude, agent-sdk, runtime-failure, generate |
| observation.bufferTokens must be > 0, got | validation | error | configuration, validation, observational-memory |
| contains multiple plugins. Provide an entry path for one… | validation | error | manifest, ambiguity, multiple-plugins, config |
| Preset " " must be a JSON object | validation | error | cli, json, config, schema-validation-failed |
| Provider does not have a URL configured | exception | error | configuration, url, provider-registry |
| Resource-scoped message listing is not implemented by this… | exception | error | storage, unsupported-operation, observational-memory |
| Response body is null | http | error | streaming, runtime, http |
| Sandbox provider " " did not expose a public URL for port … | exception | error | sandbox, networking, port-url, deployment |
| searchMessages requires a vector store. Configure vector… | exception | error | memory, vector-store, configuration, semantic-search |
SEMANTIC_RECALL_MISSING_EMBEDDER Using Mastra Memory semantic recall requires an embedder but no attached… | error_code | error | memory, embedder, semantic-recall, configuration |
| Stored response belongs to agent , not | http | error | server, validation, http-400, ownership |
| Tool does not have an execute function | exception | error | tool, runtime, execute, workflow |
| Tool provider connections storage is not configured | http | error | http-500, storage, configuration, tool-providers |
| Trace ID and Span ID are required | exception | warning | react, react-query, traces, missing-argument, playground-ui |
| Cannot delete the active version. Activate a different… | http | error | http-400, validation, server, state-conflict |
| Failed to resolve updated workspace | http | error | http-500, storage, internal-state |
| Failed to stream background tasks | http | error | network, streaming, http |
| must be an object. | validation | error | validation, type-mismatch, factory-rules, config |
OBSERVABILITY_STORAGE_GET_TAGS_NOT_IMPLEMENTED This storage provider does not support tag discovery | error_code | warning | storage, observability, not-implemented, telemetry |
| Reflector produced empty output after | exception | error | llm, reflection, empty-output, memory |
| Codex streaming response had no body | exception | error | streaming, network, openai-codex, response-body |
| Expected role "system" but saw | exception | error | message-list, system-message, invalid-role |
| Failed to fetch servers from | exception | error | network, http, mcp |
MASTRA_GET_PROMPT_BLOCK_BY_ID_NOT_FOUND Prompt block with id | error_code | error | lookup-failed, prompt-block, id-mismatch |
| No linked project found. Deploy first with `mastra server… | exception | error | cli, config, project-linking |
OBSERVABILITY_STORAGE_LIST_BRANCHES_NOT_IMPLEMENTED This storage provider does not support listing trace branches | error_code | error | storage, observability, tracing, branches, unsupported-operation |
| ${output.message} | exception | error | web-search, schema-validation, tool-output |
| The 'processors' option in Memory is deprecated and has… | validation | error | deprecation, memory, migration, breaking-change |
| does not support connecting to external CDP | exception | error | cdp, unsupported-operation, provider-capability |
| Workflow definition graph must be an array. | validation | error | validation, workflow, schema |
| WorkOS API key and client ID are required. Provide them in… | validation | error | config, env-var, workos, authentication, constructor |
| Artifact upload failed | http | critical | network, upload, http |
| Attaching a database requires the admin role in your… | http | error | http-403, permissions, rbac, platform-api |
| Channel " " does not support programmatic disconnection | http | error | channels, http-400, unsupported-operation, server-api |
| Cron expression " " has no future occurrence after | exception | error | workflows, scheduler, cron, scheduling |
| error.message (MastraError rethrown with mapped status in… | http | error | mastra-error, http-mapping, storage, datasets |
| No active agent run found for signal target | exception | error | agent, signal, race-condition, missing-argument |
| page must be >= 0 | exception | error | pagination, validation, storage |
| Processor not found | http | warning | mastra-server, not-found, processor, http-404 |
| Resource ID is required to list threads | exception | error | validation, memory, resource-id, threads |
| Search query is required | http | warning | http-400, validation, search, missing-parameter |
AGENT_FS_ROUTING_MODEL_REQUIRED Agent " ": missing model in config.ts and no default. Provide a 'model' in… | error_code | error | fs-routing, configuration, model |
| BackgroundTaskManager is shutting down, cannot initialize | exception | error | background-tasks, lifecycle, shutdown |
DURABLE_AGENT_LIST_ACTIVE_RUNS_INVALID_PAGE DurableAgent " " listActiveRuns() requires page to be a non-negative integer. | error_code | error | pagination, validation, user-input |
| GitHub capabilities require a GitHub connection. | exception | error | github, connection, auth, validation |
| Memory instance cannot verify thread access for recall | exception | error | memory, api-mismatch, configuration |
| No CDP session available for page | exception | error | browser, cdp, screencast, session |
| Stored workspace with id | http | error | not-found, http-404, workspaces, rest |
| Supabase URL and anon key are required, please provide them… | validation | error | config, env-var, supabase, constructor |
| threadId is required | http | error | http-400, missing-parameter, abort, server |
| Unsupported part type | exception | error | content-part, conversion, ai-sdk |
| Background task not found | http | warning | background-tasks, http-404, not-found |
| Concurrency limit reached, cannot enqueue task for tool | exception | warning | background-tasks, backpressure, concurrency |
DATASET_INVALID_ID Caller-defined dataset ID must not be empty | error_code | error | storage, datasets, validation, user-input |
| Dynamic workflow references step | exception | error | workflow, step, registration, rehydration |
| Failed to read studio routes manifest at | exception | error | deployer, vercel, manifest, filesystem |
| Processor provider with id | http | warning | mastra-server, not-found, processor-provider, http-404 |
| Push notification host is not allowed | validation | error | a2a, allowlist, ssrf, configuration |
| Repository link was not found | exception | error | storage, missing-resource, github |
| Scorer ' ' not found | http | error | http-404, scorers, configuration, observability |
SERVER_UNREACHABLE Could not connect to target server | error_code | error | network, cli, connectivity |
| Stored sleepUntil " " missing literal date. | exception | error | workflow, persistence, date |
| Thread knowledge scope requires resource and org ancestors | exception | error | knowledge, scope, hierarchy, validation |
| Updating node content requires expectedVersion. | exception | error | validation, memory, optimistic-concurrency |
| A custom capture schema requires an onExtracted hook that… | exception | error | configuration, validation, schema |
| Concurrency limit reached, cannot restart task | exception | warning | background-tasks, concurrency, rate-limiting |
| GitHub CLI is required to install GitHub plugins. Install… | exception | error | github-cli, missing-binary, environment, plugins |
| GitHub triage comments require an owner/repository source. | validation | error | github, validation, input |
| ModelByInputTokens: input token count | exception | error | observational-memory, token-limits, runtime |
| Neon provisioning failed | exception | error | neon, provisioning-failed, platform-api, polling |
| No enabled models available for execution | exception | critical | model, configuration, durable-agent, fallback |
| No response body for log stream | exception | error | cli, streaming, sse, runtime |
| Resource ' ' returned content with neither text nor blob | exception | error | mcp, resources, payload-shape |
| Code Mode external identifier collision: tools | exception | error | code-mode, identifier-collision, naming, validation |
| Could not derive scorer definition ID from name. Please… | http | warning | http-400, validation, input, rest-api |