mastra-ai/mastra
Documented errors, page 4 of 22. Back to mastra-ai/mastra
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Either context or contextExtractor is required for Context… | validation | error | evals, scorer, context-precision, config |
| Node descriptions are limited to | exception | error | validation, string-length, memory |
| Output directory must not be the project root or contain… | exception | error | build, cli, path-validation |
| Rule metadata must be an object. | validation | error | validation, json, shape-mismatch |
| [Schema Builder] Failed to convert schema parameters to… | exception | error | schema, json-schema, zod, conversion |
| Vector configuration is required to embed texts. | validation | error | configuration, vector, embedding |
AGENT_REQUEST_CONTEXT_VALIDATION_FAILED Request context validation failed for agent | error_code | error | agent, request-context, validation, zod |
| CreateCancelledError | exception | info | cli, cancellation, interactive-prompt, sigint |
ESTALE File was modified externally | exception | warning | filesystem, concurrency, optimistic-locking, estale |
MCP_CLIENT_ON_LIST_CHANGED_RESOURCE_FAILED MCP_CLIENT_ON_LIST_CHANGED_RESOURCE_FAILED | error_code | error | mcp, resources, notifications, event-handler |
OBSERVATIONAL_MEMORY_THREAD_ID_REQUIRED OBSERVATIONAL_MEMORY_THREAD_ID_REQUIRED: ObservationalMemory (scope: 'thread')… | error_code | error | observational-memory, missing-argument, thread |
MCP_CLIENT_UNSUBSCRIBE_RESOURCE_FAILED MCP_CLIENT_UNSUBSCRIBE_RESOURCE_FAILED | error_code | warning | mcp, resources, unsubscribe, cleanup |
| ${metadata?.errorMessage || 'Workflow execution failed'} | exception | error | workflow, streaming, react |
| Poll failed | exception | error | network, http, deploy, polling |
STRUCTURED_OUTPUT_OBJECT_UNDEFINED structuredOutput object is undefined | error_code | error | structured-output, llm-output, json-parsing, retry |
| Thread not found | exception | error | multi-tenancy, resource-isolation, thread |
| Workflow ID is required | http | error | http-400, workflows, missing-parameter, server-api |
| Invalid model provided. Model must be a MastraLanguageModel… | exception | error | typescript, type-guard, configuration |
| step " " cannot be stored: option " " is a that does not… | exception | error | workflows, serialization, closure, callbacks |
OBSERVABILITY_CREATE_SPAN_NOT_IMPLEMENTED This storage provider does not support creating spans | error_code | error | observability, storage, tracing, unsupported-feature |
| Repository access did not include a bearer token for the… | exception | error | github, auth, missing-token, factory |
SCHEDULES_INVALID_STATUS Schedule : unknown status " ". Expected one of: . | error_code | error | schedules, enum, validation, user-error |
| Unable to verify path stays within workspace root | exception | error | sandbox, filesystem, symlink, verification-failed, shell |
| Unknown stored step type | exception | error | workflow, serialization, exhaustiveness, version-mismatch |
| Channel " " does not support programmatic connection | http | error | channels, http-400, unsupported-operation, server-api |
| Instructions are required | http | error | http-400, validation, stored-agents |
| Invalid encrypted session data | validation | error | auth0, session, encryption, cookie, validation |
MCP_CLIENT_READ_RESOURCE_FAILED MCP_CLIENT_READ_RESOURCE_FAILED | error_code | error | mcp, resources, read, uri |
| No verification key was provided for Agent Card signature… | exception | error | jws, key-management, kid-lookup, signature-verification |
| perPage must be a positive integer | http | error | http-400, workflows, pagination, validation, server-api |
| Cannot merge a knowledge node into a target that is… | exception | error | knowledge, merge, scope, visibility |
| Cookie password must be at least 32 characters for SSO. Set… | validation | critical | auth0, sso, cookie-security, configuration |
| Factory session was retired during workspace materialization | exception | error | race-condition, session-lifecycle, workspace, factory |
| GitHub subscription is missing its session binding. | exception | error | github, webhook, data-integrity |
| Invalid skill | validation | error | skills, validation, schema |
| Invalid token | exception | error | jwt, auth, token, decoding |
| Pin limit reached: the set holds at most | exception | error | quota, knowledge-store, observational-memory |
| Plugin instructions must be a string | validation | error | plugin, type-validation, sdk |
| useSankey must be used within Sankey | exception | error | react, context, provider-missing, charts |
| or Failed to save GitHub token ( ) | http | error | http, github, auth, fetch |
| FACTORY_CREDENTIAL_ENCRYPTION_PREVIOUS_KEYS must be a JSON… | exception | critical | configuration, encryption, env-var, json |
| MastraFactory: integration tool | validation | error | naming-conflict, integration, tools, duplicate |
| No active suspension to resume | exception | error | agent, suspension, resume, lifecycle |
| Auth0 domain and audience are required, please provide them… | validation | critical | auth0, configuration, env-vars, missing-config |
| FirecrawlBrowser requires `apiKey` or FIRECRAWL_API_KEY | exception | error | config, api-key, environment-variable, authentication |
| Invalid MemoryRequestContext.thread.id: expected string, got | validation | error | memory, validation, request-context, typescript |
| Plugin tool " " must be an object with a tool property | validation | error | plugin, tools, shape-validation, sdk |
| Repository access did not include a bearer token. | exception | error | github, authentication, git-push |
| result.error (dynamic message from device-login poll… | exception | error | oauth, device-login, polling, auth-denied |
| Token exchange failed | exception | error | oauth, openai, authentication |
| validation.messages.join(', ') | validation | error | vector, filter, validation, compatibility |
| Version-control installation not found. | exception | error | github, installation, data-integrity, storage |
| Async buffering is not yet supported with scope… | validation | error | configuration, observational-memory, unsupported-feature |
| Channels require a newer version of @mastra/core | http | error | http-501, channels, feature-gate, version-mismatch |
| Cookie password must be at least 32 characters. Set… | validation | error | okta, configuration, validation, security |
${error.code} (remote JSON-RPC error, code ) | exception | error | a2a, network, json-rpc, remote-agent |
| Factory kickoff is waiting on a run that has not ended. | exception | error | factory, timeout, async, agent-run |
| Failed to observe agent builder action stream | http | error | http, streaming, network, client-js |
| Input data not found | exception | error | workflow, input-validation, agent-builder |
| Subconscious curate requires the main agent to resolve its… | exception | error | configuration, model-resolution, observational-memory |
| A2A Agent Card signature verification failed | exception | error | jws, signature-mismatch, agent-card, signature-verification |
| or Request failed ( ) | http | error | http-error, state-transition, api-response, work-items |
DURABLE_AGENT_RECOVER_ALREADY_IN_PROGRESS DurableAgent " " recover( ): another process is already recovering this run. | error_code | error | durable-agent, recovery, concurrency, lease, duplicate-work |
| error.message (workflow schema validation error) | http | error | http-400, schema-validation, workflow, zod |
| Factory rules.github. | validation | error | validation, factory-rules, configuration |
| GitHub subscriptions require an authenticated repository… | exception | error | session, authentication, github |
| Google user is not in an allowed hosted domain | exception | error | oauth, google-workspace, hosted-domain, authorization, sso |
| Knowledge node not found | exception | error | knowledge-append, entity-not-found, merged-node, stale-reference |
| License server responded with | exception | warning | license, http-429, http-5xx, transient, retry |
| Mapping step " " cannot be stored: the function form does… | exception | error | workflows, serialization, closure, mapping |
| MastraFactory: integration | validation | error | oauth, configuration, security, secrets, replication |
| MastraFactory: integrations | validation | error | configuration, integration, channels, conflict |
| must contain base64-encoded 32-byte keys. | exception | critical | configuration, encryption, env-var, security |
| resourceId and threadId are required to queue a message | exception | error | agent, memory, signal, missing-argument |
| (result as any).error?.message || 'Workflow recover failed' | exception | error | durable-agent, recover, workflow-failed, error-wrapping |
SCHEDULES_INVALID_DEFINITION Schedule : expected a schedule definition object, received . | error_code | error | schedules, validation, config, user-error |
| This workflow run was not active | exception | error | workflow, resume, state |
AGENT_RESUME_NO_SNAPSHOT_FOUND Agent " " () could not find a suspended run for runId " ". Ensure you are… | error_code | error | agent, resume, suspend, workflow-snapshot, storage, runid |
| Authenticated user is missing a user id | exception | error | auth, authentication, missing-field, session |
| Experiment worker artifacts cannot contain absolute symlinks | exception | error | build, symlink, portability |
| Failed to fetch prompts from server | exception | error | mcp, network, prompts, wrapped-error |
| GitHub OAuth token exchange returned no token | http | error | oauth, github, authentication |
| LinearIntegration is not initialized — the factory binds… | exception | error | lifecycle, initialization, configuration |
| Model file not found at | exception | error | filesystem, missing-file, onnx, model-loading, embeddings |
| ${resolved.reason} | exception | error | source-control, session, resolution |
| Storage not configured | http | error | http-500, storage, configuration, experiments, mastra |
| Subconscious curate requires a configured knowledge storage… | validation | error | storage, configuration, observational-memory |
| Agent Learning request failed | exception | error | network, http, fetch, playground-ui, agent-learning |
EEXIST File already exists | exception | error | filesystem, eexist, file-exists, concurrency |
ENOTDIR Path is not a directory | exception | error | filesystem, enotdir, parent-path |
| ${inputData.toolName} | exception | error | workflow, tools, tool-not-found, agent-execution |
| Invalid ciphertext payload | validation | error | telegram, encryption, data-corruption |
INVALID_JSON INVALID_JSON: Input JSON must be an object | error_code | error | json, cli, input-validation |
| MastraFactory: 'sandbox' must be a function constructing a… | validation | error | configuration, type-error, sandbox |
unavailable Knowledge record has no scope. | error_code | error | knowledge, data-integrity, rendering |
FAIL_INSTALL_DEPS FAIL_INSTALL_DEPS | error_code | error | install, deployment, dependencies, subprocess |
| Failed to retrieve created version | http | error | storage, internal-error, consistency, prompt-blocks |
| Knowledge node is not a skill | exception | error | knowledge-store, naming-collision, observational-memory |
| Model / is a metadata-only stub. The actual model instance… | exception | error | model, serialization, run-registry, resume |
| No Factory selected | exception | error | react, react-query, missing-parameter, factory-ui |