mastra-ai/mastra
Documented errors, page 12 of 22. Back to mastra-ai/mastra
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
DURABLE_AGENT_RECOVER_NO_MASTRA DurableAgent " " recover() requires the agent to be registered on a Mastra… | error_code | error | durable-agent, recover, configuration |
| ${errorData.message || 'Failed to create account'} | http | error | authentication, signup, better-auth, http-4xx |
EXPERIMENT_ID_CONFLICT Experiment id already exists and does not match this experiment's dataset or… | error_code | error | storage, experiment, conflict, duplicate-id |
| Failed to observe agent builder action stream legacy | http | error | http, streaming, legacy, network |
| Invalid filter format: expected a plain object, got | validation | error | validation, filter, rag |
| Invalid mount path: . Must be an absolute path with… | validation | error | validation, filesystem, mount, path |
| Invalid notification dispatch time | exception | error | notifications, date-parsing, validation |
| Process failed to spawn | exception | critical | process, spawn, execa, sandbox |
| Server configuration must include either a command or a url. | exception | error | mcp, config, validation, client |
| Session expired. Run `mastra auth login` interactively or… | exception | error | cli, auth, session-expired, refresh-token, non-interactive |
AZURE_DEPLOYMENTS_FETCH_ERROR Failed to fetch Azure deployments | http | error | azure, http, network, gateway |
| expected an array of route segments | validation | error | deployer, vercel, manifest, schema-validation |
| Expected / in model router ID | exception | error | parsing, validation, gateway |
FAIL_BUILD_COMMAND FAIL_BUILD_COMMAND | error_code | error | build, deployment, shell, subprocess |
| MastraCompositeStore requires at least one storage source… | exception | error | storage, configuration, composite-store |
OBSERVABILITY_STORAGE_GET_LABEL_VALUES_NOT_IMPLEMENTED This storage provider does not support label value discovery | error_code | warning | storage, observability, not-implemented, metrics |
RUN_EXPERIMENT_SCORER_FAILED_TO_SCORE_WORKFLOW_TRAJECTORY Failed to run experiment: Error running workflow trajectory scorer | error_code | error | evals, scorer, workflow, trajectory |
| agent is not supported by this Mastra core version | http | error | http-501, version-compatibility, agent-stream, server |
| Agent step " " uses a legacy v1 model but does not… | exception | error | agent, workflow, version-compat, legacy-model |
| BackgroundTaskWorker: call init() before start() | exception | error | lifecycle, worker, initialization |
| Code Mode tool id collision | exception | error | code-mode, stub-generation, identifier-collision, naming |
| createSandboxProxy requires an Edge Config connection… | validation | error | edge-config, missing-env-var, sandbox, proxy |
| Custom API route " " must not start with " " — that path is… | exception | error | routes, configuration, path-conflict |
| Custom Subconscious observation agent | exception | error | configuration, validation, schema |
| Expected a PEM-encoded public key or certificate string for… | exception | error | crypto, validation, configuration, jws, agent-card |
| Failed to get file content type | exception | error | network, http, content-type, fetch, files |
| Invalid GitHub Enterprise URL/domain | validation | error | auth, validation, input, github-enterprise |
invalid_response Skill invocation returned an invalid response. | http | error | http, json-parsing, invalid-response, proxy |
| Knowledge already exists | exception | error | knowledge, duplicate, id-collision, append |
| LinearIntegration is missing required config | validation | error | configuration, oauth, env-var, startup |
| Linked Studio project | exception | error | cli, studio, config, missing-project |
| Mode not found | exception | error | state, configuration, lifecycle |
| This workflow run is still running, cannot time travel | exception | error | workflow, concurrency, time-travel, state-conflict |
| ThreadLockError(threadId, ownerPid) | exception | error | concurrency, locking, process, pid |
TOOL_MOCK_MISMATCH TOOL_MOCK_MISMATCH | error_code | error | datasets, tool-mocking, evaluation |
| Analysis step failed to produce results | exception | error | evals, llm, runtime, schema-validation |
| Diagnosis polling timed out after 5 minutes. Please try… | exception | error | network, timeout, polling, deployment |
| Factory rule decision must be an object. | validation | error | validation, factory-rules, type-error |
| Factory workspace GitHub credential registration is no… | exception | error | race-condition, workspace, github, factory |
| Failed to initiate OpenAI Codex device authorization | exception | error | network, oauth, http-status, device-login |
| Failed to spawn LSP server | exception | error | lsp, spawn-failure, process |
| Hook extractor " " must include an onExtracted handler. | validation | error | config, callback, observational-memory |
| Invalid MemoryRequestContext.thread: expected object, got | validation | error | memory, type-error, validation, request-context, nested-field |
| step " " cannot be stored: "scorers" is a function; only… | exception | error | workflows, serialization, closure, scorers |
| @mastra/livekit: set LIVEKIT_URL or pass serverUrl to… | validation | error | configuration, env-var, livekit, missing-config |
MASTRA_OBSERVABILITY_STORAGE_NOT_AVAILABLE Observability storage domain is not available | error_code | critical | storage, observability, configuration, score-traces |
| messageIds is required | http | error | http-400, validation, request-body, memory |
| Mock resource content not found for | exception | error | mcp, mock, resource-not-found, testing |
| No browser context available for screencast | exception | error | browser, cdp, screencast, missing-session |
| observation.bufferActivation must be > 0, got | validation | error | configuration, validation, observational-memory |
| server.drainTimeout must be a finite number between 0 and… | validation | error | server, configuration, validation, shutdown |
| Tool ' ' not found on remote MCP server | exception | error | mcp, tool-not-found, client-proxy |
| Unable to read worker | exception | error | sandbox, file-io, output-stream, shell |
AGENT_DURABLE_METHOD_NOT_AVAILABLE Agent. () is only available on agents constructed with `durable: true`… | error_code | error | agent, durable, configuration, api-misuse, user-input |
| Choose a valid value | validation | warning | cli, argument-validation, commander |
| Factory rule version is required. | validation | error | validation, factory-rules, missing-argument, config |
| No active thread on this session | exception | error | state, lifecycle, threading |
| No project specified. Pass --project <name|slug|id>, set… | exception | error | cli, config, missing-argument, mastra-cloud |
| Plugin id mismatch: registry has | validation | error | plugin-loading, registry, id-mismatch, consistency |
PROCESSOR_WORKFLOW_FAILED Processor workflow failed with status | error_code | error | workflows, processors, mastra-error, workflow-failed |
| Pull request repository does not match the active project… | exception | error | github, pull-request, validation, mismatch |
| Query parameters "versionId" and "status" are mutually… | validation | error | http, query-parameters, validation, client-sdk |
| Source-control session ID already exists | exception | error | storage, uniqueness, source-control |
| Stored mapping step " " has invalid JSON mapConfig | exception | error | json, persistence, mapping |
| Vector search requires vector configuration. | validation | error | search, vector, configuration, validation |
| Workflow run already finished with status " ". Use /observe… | http | error | http-409, conflict, workflow-run, streaming |
| A review comment requires commitId, path, line, and side… | validation | warning | github, validation, pull-request, review-comment |
clone-failed Refusing to materialize: invalid repo full name | error_code | error | validation, git-clone, injection-guard, github |
| Duplicate extractor slug | validation | error | naming, duplicate-key, observational-memory |
| Experiment not found | exception | error | storage, experiment, not-found, user-input |
MASTR_SCORER_FAILED_TO_RUN_MISSING_GENERATE_SCORE Cannot execute pipeline without generateScore() step | error_code | error | scorer, pipeline, evals, missing-step |
OBSERVABILITY_STORAGE_GET_FEEDBACK_PERCENTILES_NOT_IMPLEMENTED This storage provider does not support feedback percentiles | error_code | error | storage, observability, not-implemented, feedback, percentiles |
| Pinned knowledge requires a configured knowledge storage… | exception | error | configuration, storage, observational-memory |
| Repository URL or path is required | exception | error | input-validation, workflow, git |
| `retrieval: ` requires an embedder. Pass an `embedder`… | validation | error | configuration, embedder, observational-memory, validation |
| Thread not found on gateway | http | error | http-404, gateway, delete, not-found |
| Tokenizer file not found at | exception | error | filesystem, missing-file, model-loading, embeddings |
| ${errorMessage} | http | error | server, validation, memory, http-400 |
| Factory storage domain | exception | error | storage, factory, lifecycle, dependency-injection |
| Mastra server did not become healthy at | exception | error | sandbox, health-check, timeout, deployment |
OBSERVABILITY_STORAGE_GET_ENTITY_TYPES_NOT_IMPLEMENTED This storage provider does not support entity type discovery | error_code | warning | storage, observability, not-implemented, telemetry |
| Shared browser not launched. Call createSharedSession()… | exception | error | browser, lifecycle, initialization-order, shared-session |
| implements neither start() nor the create() acquisition… | exception | error | sandbox, subclassing, api-misuse |
| Timed out waiting for database to become ready | exception | error | timeout, provisioning, polling, cli |
| ${tripwireChunk.payload?.reason || 'Agent tripwire… | exception | warning | workflows, agents, tripwire, processors, streaming |
| Access denied: durable run belongs to a different resource | http | error | http-403, authorization, durable-workflow, multi-tenancy |
AGENT_STREAM_V1_MODEL_NOT_SUPPORTED Agent " " is using AI SDK v4 model ( : ) which is not compatible with stream()… | error_code | error | ai-sdk, version-mismatch, agent, streaming |
| All messages for the same threadId must use the same… | http | error | http-400, consistency, memory, batch-validation |
| Cannot create workflow definition | exception | error | schema-validation, workflow, missing-field |
| create-workflow failed: save-workflow threw | exception | error | workflows, persistence, sub-agent |
| Linear API returned no data. | exception | error | network, graphql, linear-api, unexpected-response |
| @mastra/livekit: turnDetection | exception | error | dependency, turn-detection, livekit, missing-package |
MASTRA_SCORER_NOT_FOUND Scorer with ID not found | error_code | error | scorers, registration, configuration |
| plugin must include an entry | validation | error | plugin-manifest, validation, configuration |
| Source-control repository not found for this organization… | exception | error | source-control, not-found, repository |
| UI Messages require a data property when using data-… | exception | error | streaming, ai-sdk, data-chunks, validation |
| All messages must have threadId and resourceId fields. Found | http | error | http-400, missing-field, memory, api |
| await extractError(res) | http | error | http, api-client, fetch, factory-ui |
| Both threadId or resourceId must be provided | http | error | http-400, validation, memory, legacy-api |
| Cannot convert URL-backed generated file to Uint8Array… | exception | error | files, generated-files, url, aisdk |