ErrLookup › mastra-ai/mastra
mastra-ai/mastra
Mastra is the modern TypeScript framework for AI-powered applications and agents. · TypeScript · 6,026 source files
Analyzed at 75dd419e61 on 2026-08-30. 2181 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Extractor slug " " is reserved by Observational Memory. | validation | error | naming, reserved-words, observational-memory |
MCP_CLIENT_TOOL_HYDRATION_FAILED Failed to rebuild MCP tool | error_code | error | mcp, cache, hydration, tool-resolution |
| Your schema is async, which is not supported. Please use a… | exception | error | schema, validation, async, standard-schema |
| copyFile -> failed (exit ) | exception | error | sandbox, filesystem, shell-command, copy |
| error.message (422 res body includes… | http | error | http-422, model-policy, agent-builder, validation |
| Gateway API error | exception | error | network, http, gateway, memory |
| Cannot rehydrate conditional step: missing or mismatched… | exception | error | workflow, serialization, rehydration, conditional |
| Invalid scoring filter: path(s) | validation | error | scorer, predicate, validation, configuration |
| Root escapes workspace | validation | error | filesystem, path-traversal, security, containment |
| Server failed to start | exception | error | dev-server, child-process, startup-failure |
SCHEDULES_MISSING_RESOURCE_ID Schedule : 'resourceId' is required when 'threadId' is set. | error_code | error | schedules, validation, config, user-error |
| Path is outside the workspace | exception | error | filesystem, path-traversal, symlink, security |
| Mastra configuration initialization created or modified… | exception | error | build, determinism, side-effects |
| require( ) is not available in Cloudflare Workers | exception | error | cloudflare, workers, esm, require, runtime |
| error.message | http | error | http, server, datasets, mastra-error |
| The operation was aborted. | exception | warning | abortsignal, cancellation, observational-memory |
| is outside the curator's visible scope. | exception | error | scope-visibility, authorization, knowledge-write-tools, multi-tenancy |
| must be a string. | validation | error | validation, typescript, type-mismatch |
AGENT_MEMORY_THREAD_RESOURCE_MISMATCH Thread " " belongs to resource " " but resource " " was provided. A thread can… | error_code | error | memory, threads, multi-tenancy, authorization |
| Knowledge tools require an active threadId. | exception | error | knowledge-tools, missing-thread, scope-resolution, mastra-memory |
| Session is not available to the current user | exception | error | auth, authorization, multi-tenancy, access-control |
| Knowledge node cursor does not match the active browse… | exception | error | pagination, cursor, knowledge, validation |
| AuthFailureError(authFailureStatus, error) | exception | error | authentication, http, network, observability, exporter |
| deleteFile failed (exit ) | exception | error | sandbox, filesystem, shell-command, delete |
ATOMIC_STORAGE_OPERATIONS_NOT_SUPPORTED Workflow " " runs on the evented execution engine, which requires a storage… | error_code | error | storage, workflow, scheduling, configuration, evented-engine |
| Factory transitions require an authenticated bound agent… | exception | error | factory, authentication, tool-execution, session-binding |
| Missing required file, checked the following paths | exception | error | deployer, filesystem, missing-file, build |
AGENT_FS_ROUTING_INSTRUCTIONS_INVALID Agent " ": agents/ /instructions.ts must default-export a string, a system… | error_code | error | agent, filesystem-routing, instructions, config |
| FACTORY_CREDENTIAL_ENCRYPTION_PREVIOUS_KEYS values must be… | exception | error | configuration, environment-variables, encryption, startup |
| moveFile -> failed (exit ) | exception | error | sandbox, filesystem, shell-command, move |
| Platform API request did not return a redirect. | http | error | http, redirect, api-client, platform-api |
| AISDKv5 chunk type "redacted-reasoning" not supported | exception | error | streaming, ai-sdk-v5, reasoning, unsupported-type |
sandbox_command sandbox_command | error_code | error | sandbox, capability, resource-limits, preflight |
| Factory agent binding is unavailable, revoked, or no longer… | exception | error | factory, authorization, session-binding, binding-revoked |
MCP_CLIENT_TOOL_EXECUTION_FAILED ${errorText} | error_code | error | mcp, tool-execution, remote-error, third-party |
| GitHub installation is invalid. | exception | error | github, integration, data-validation |
| error.message (MastraError rethrown with mapped status in… | http | error | server, http, error-mapping, datasets |
| Not found | http | error | authorization, http-404, rbac, server-api |
| Learner did not acknowledge a valid reviewed record cursor. | exception | error | llm-output, observational-memory, cursor-validation |
| MastraFactory: 'storage' is required. Pass a FactoryStorage… | validation | error | configuration, constructor, storage, missing-required-argument |
| Failed to canonicalize A2A Agent Card for signature… | exception | error | a2a, agent-card, json-canonicalization, signature-verification |
| save-workflow requires a Mastra context. | exception | error | mastra, tool-context, workflow, configuration |
| Telegram rejected the bot token | exception | error | telegram, authentication, bot-token |
| Allocation sampling is not active. | exception | error | inspector, heap-profiler, state-error, diagnostics |
| Unable to persist request context key | exception | error | request-context, schema, encoding, validation |
| You need the admin role in this organization to manage… | exception | error | authorization, permissions, http-403, cli |
| File not found in composite skill source | exception | error | filesystem, skills, path-resolution, not-found |
SCHEDULES_INVALID_CRON Schedule | error_code | error | schedules, cron, configuration, validation |
| GitHub issue reconcile interval must be a positive number. | validation | error | configuration, validation, github, scheduler |
| Login cancelled | exception | info | oauth, device-flow, cancellation, abort-signal |
| ModelByInputTokens requires inputTokens for resolution | exception | error | configuration, model-resolution, observational-memory |
| stdout backpressure exceeded the experiment deadline | exception | error | streaming, backpressure, timeout |
| must be an integer ; received . | validation | warning | configuration, env-vars, validation |
| Resource-limit preflight command failed. | error_code | error | sandbox, capability, resource-limits, shell |
| Agent does not support recover. Only durable agents… | http | error | http-400, durable-agent, agents-api, capability-mismatch |
| Google service account private key signing failed | exception | error | auth, google, crypto, configuration, env |
| Session expired. Run: mastra auth login | exception | error | cli, auth, http-401, session |
| list-available-agents requires a Mastra context. | exception | error | mastra, configuration, runtime-context, tools |
MCP_CLIENT_GET_PROMPT_FAILED MCP_CLIENT_GET_PROMPT_FAILED | error_code | error | mcp, prompts, third-party, remote-call |
| Factory transition service is unavailable. | exception | error | factory, dependency-injection, configuration, transition-service |
| Invalid GitHub URL format | validation | error | cli, github, url-validation, template |
| Repository access did not include a bearer token for the… | exception | error | github, authentication, token |
| Skill not found: . | exception | error | skill, workspace, configuration, lookup-failed |
| Factory kickoff lease was lost before completion. | exception | error | factory, lease, concurrency, distributed |
| Path escapes workspace | validation | error | path-traversal, security, validation, filesystem |
OBSERVABILITY_STORAGE_GET_METRIC_AGGREGATE_NOT_IMPLEMENTED This storage provider does not support metric aggregation | error_code | error | storage, observability, metrics, aggregation, not-implemented |
| ${error.message} | exception | error | streaming, protocol, backpressure |
| Factory review phase requires a controller request context. | exception | error | factory, request-context, review-phase, api-misuse |
| Could not extract settings from ToolLoopAgent. The agent… | exception | error | agent, version-compatibility, reflection, internal-api |
| must be used within MessageScrollerProvider. | exception | error | react, context, provider-missing, playground-ui |
SCHEDULES_MISSING_TARGET_ID schedules.create requires `agentId` or `workflowId`. | error_code | error | schedules, validation, user-error, config |
| : find() requires connect() to adopt the handle it returns. | exception | error | typescript, subclassing, sandbox, contract-violation |
| Clerk JWKS URI, secret key and publishable key are… | validation | error | auth, clerk, configuration, env-var |
| URL resolves to a private or reserved address. | exception | error | security, ssrf, web-fetch, validation |
| Invalid resourceId | validation | error | path-traversal, validation, filesystem, security |
SCHEDULES_AMBIGUOUS_MODE Schedule : set exactly one execution mode — remove either 'prompt' or 'handler'. | error_code | error | schedules, configuration, validation, user-error |
| SleepUntil step " " cannot be stored: dynamic date… | exception | error | workflows, serialization, closure |
OBSERVABILITY_STORAGE_LIST_METRICS_NOT_IMPLEMENTED This storage provider does not support listing metrics | error_code | error | storage, observability, metrics, not-implemented |
| Platform Linear event polling interval must be a positive… | validation | error | configuration, validation, linear, polling |
| Redirect target must use HTTP or HTTPS. | exception | error | network, http, redirects, security, web-fetch |
RUN_EXPERIMENT_TARGET_FAILED_TO_GENERATE_RESULT Failed to run experiment: Error generating result from target | error_code | error | evals, agent, workflow, error-wrapping |
SCHEDULES_INVALID_ID schedules.create: id | error_code | error | schedules, validation, slugify, user-error |
| Telegram installation secrets are encrypted at rest, but no… | exception | critical | telegram, encryption, missing-env-var, configuration |
| Session did not bind thread . | exception | error | github, webhook, thread-binding |
| State token has expired | exception | error | auth, oauth, token-expired, sso |
| Invalid model string format | exception | error | configuration, model-string, parsing, embeddings |
| Cookie password must be at least 32 characters for SSO. Set… | validation | error | auth, clerk, sso, configuration, encryption |
EACCES Permission denied: (filesystem is read-only) on | exception | error | workspace, filesystem, permissions, read-only |
| Failed to load repository settings | exception | error | http, fetch, react-query, network |
| Factory binding has no authenticated session owner. | exception | error | factory, authentication, session, data-integrity |
| Input and output messages cannot be null or empty | validation | error | evals, scorer, tool-call-accuracy, empty-input |
| Missing authorization code | validation | error | oauth, anthropic, pkce, input-validation |
| StandardSchemaWithJSON is not supported for… | exception | error | schema, standard-schema, compat, gemini |
| Version-control repository not found. | exception | error | github, storage, not-found, integration |
AbortError Aborted | exception | info | cancellation, abort, async |
INVALID_SYSTEM_MESSAGE_FORMAT Invalid system message format. System messages must be CoreMessage format with… | error_code | error | message-list, system-message, validation, agent |
| Favorites storage domain is not available | http | critical | storage, server, configuration, favorites |
OBSERVABILITY_INVALID_INSTANCE_CONFIG Invalid configuration for observability instance | validation | error | configuration, schema-validation, observability, zod |
OBSERVABILITY_STORAGE_GET_METRIC_PERCENTILES_NOT_IMPLEMENTED This storage provider does not support metric percentiles | error_code | error | storage, observability, metrics, percentiles, not-implemented |
| SlackProvider baseUrl not available during OAuth callback | exception | error | slack, oauth, configuration, callback |