mastra-ai/mastra
Documented errors, page 20 of 22. Back to mastra-ai/mastra
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| All message IDs must be non-empty strings | validation | error | memory, input-validation, api-misuse |
| defaultProjectName is required when mode is "create" | exception | error | cli, init, configuration, observability |
| must be a non-negative number of milliseconds or a duration… | validation | error | config, validation, duration, parsing |
| No frames captured during recording | exception | error | recording, frames, avi, empty-state |
| Request context validation failed for workflow | validation | error | workflow, request-context, validation, schema |
| Source-control connection or repository not found | exception | error | source-control, not-found, installation-mismatch, link, in-memory |
| Step " " not found in lesson " ". | exception | error | not-found, filesystem, input-validation |
| Task ID is required | validation | error | a2a, validation, tasks, missing-id |
| does not support closing stdin | exception | error | process, stdin, unsupported-operation |
| Thread cloning is not implemented by this storage adapter | exception | error | storage, unsupported-operation, memory |
| Tool provider does not support getConnectionStatus | http | error | http-400, tool-providers, missing-capability, connections |
| Unsupported plugin entry extension | validation | error | plugin-loading, typescript, entry-point, validation |
| Credentials authentication not configured | http | error | http-404, credentials, auth-configuration |
| Factory transition reenter must be a boolean. | validation | error | validation, factory-rules, type-error |
| Failed to delete Factory | exception | error | http, fetch, factory, idempotency |
| Frame dimensions changed during recording: expected | exception | error | recording, dimensions, avi, viewport |
| GitHub OAuth token exchange failed | http | error | github, oauth, network, http |
| No thread found with id | exception | error | memory, thread, not-found |
OBSERVABILITY_STORAGE_GET_SCORE_TIME_SERIES_NOT_IMPLEMENTED This storage provider does not support score time series | error_code | error | storage, observability, not-implemented, time-series |
| Processor does not support inputStep phase | validation | error | http-400, processors, phase-not-supported |
| BackgroundTaskManager is shutting down, cannot restart tasks | exception | error | background-tasks, shutdown, lifecycle |
| Failed to observe workflow stream | http | error | network, streaming, workflow |
| Messages array is required | validation | info | mastra-server, validation, http-400, messages |
| Subconscious curationCadence must be a positive integer. | exception | error | configuration, validation, subconscious |
| System prompt is required for system prompt alignment… | validation | error | evals, runtime, validation, message-extraction |
| Task not found | exception | error | background-tasks, not-found, cancel |
| Upstash URL and token are required | exception | error | logging, configuration, redis, upstash, validation |
| Dynamic memory factory returned empty value | exception | error | configuration, memory, factory |
| Factory work item not found. | exception | error | factory, storage, missing-record, dispatch |
| Resource not found | exception | error | mcp, resources, not-found, protocol-error |
skill_not_found skill_not_found | error_code | error | skill, not-found, workspace |
| Tool provider does not support listConnections | http | error | http-400, tool-providers, missing-capability, connections |
| Trace is null or undefined | exception | error | trace, null-check, scoring |
| Turn already ended | exception | error | lifecycle, state-management, memory |
| Turn already started | exception | error | observational-memory, lifecycle, idempotency |
| Workflow not found | exception | error | workflow, registration, client-sdk, not-found |
AGENT_FS_ROUTING_INSTRUCTIONS_REQUIRED Agent " ": missing instructions. Provide agents/ /instructions.md, agents/… | error_code | error | fs-routing, configuration, instructions |
| Factory rules.tools. | validation | error | validation, handlers, type-mismatch, tools |
| Failed to fetch connection string | http | error | http-error, platform-api, database-connection, race-condition |
| Invalid cron expression | validation | error | workflows, scheduler, cron, validation |
| Invalid mount path: . Root path "/" is not allowed. | validation | error | validation, filesystem, mount, path |
| Perplexity API key is required. Pass | validation | error | api-key, configuration, environment, perplexity |
| Processor does not support outputStep phase | validation | error | http-400, processors, phase-not-supported |
| Screencast not supported by this provider | exception | error | screencast, unsupported-operation, provider-capability |
| Subconscious observation extractor | exception | error | configuration, validation, observational-memory |
| Subconscious semantic knowledge requires an embedder. Pass… | validation | error | configuration, embedder, subconscious, validation |
| vectorStoreName is required, got | validation | error | configuration, validation, tool, graph-rag |
| Failed to load Factories | exception | error | http, react-query, factory-ui |
| Metadata key " " exceeds maximum length of characters. | validation | error | validation, storage, metadata |
| Mouse event injection not supported by this provider | exception | error | input, unsupported-operation, provider-capability |
| perPage must be false or a safe integer | validation | error | validation, pagination, types |
| Stored prompt block with id | http | error | http-404, not-found, prompt-blocks, rest |
| Tool provider does not support getAuthStatus | http | error | http-400, tool-providers, missing-capability, oauth |
| ClaudeSDKAgent resumeData must include a message. | validation | error | storage, adapter, agents-store, server, http-500 |
| delete-workflow requires a Mastra context. | exception | error | mastra-context, misconfiguration, workflows |
| No links received from Firecrawl API | exception | warning | api-response, schema-mismatch, empty-result |
| Permission denied | http | error | http-403, filesystem, permissions |
| Plugin entry must be a .ts file | validation | error | plugins, typescript, configuration |
AGENT_FS_ROUTING_SUBAGENT_SCHEDULES_UNSUPPORTED Agent " ": schedules are only supported on root agents, but… | error_code | error | fs-routing, schedules, configuration |
| exists but is not a number | exception | error | cache, type-conflict, counter |
| No index.mjs found in | exception | error | build, deployment, missing-file, sandbox |
| Path traversal detected: directory | exception | error | security, path-traversal, filesystem |
| Registry with ID " " not found. | exception | error | not-found, input-validation, registry |
| runId required to time travel workflow | http | error | http-400, validation, workflow, rest-api |
| Stored sleep " " missing literal duration. | exception | error | workflow, persistence, validation |
| Thread with id is for resource with id but resource was… | exception | error | memory, thread, authorization, multi-tenancy |
| A browser recording is already active. Call browser_record… | exception | error | recording, concurrency, state, double-start |
AGENT_LIST_SUSPENDED_RUNS_INVALID_PAGE Agent " " listSuspendedRuns() requires page to be a non-negative integer. | error_code | error | agent, validation, pagination, input-validation |
| create-workflow failed: the workflow-builder sub-agent… | exception | error | workflows, sub-agent, missing-tool-call |
| Extractor name " " must produce a non-empty slug. | validation | error | observational-memory, extractor, naming, input-validation |
| Failed to load course state | exception | error | filesystem, json, corruption |
| Failed to load models | http | error | http, models, react-query, factory-ui |
| FilesystemSkillsStorage: skill with id | exception | error | storage, filesystem, not-found, skills |
| Resource knowledge scope requires an org ancestor | exception | error | knowledge, scope, hierarchy, validation |
| Unsupported database kind | exception | error | cli, validation, argument, database |
| Unsupported schedule target type | exception | error | workflows, scheduler, unsupported-target, dispatch |
| `validateCron` is not available in this version of… | exception | error | version-mismatch, schedules, cron, dependency |
| CDP session not available for keyboard injection | exception | error | browser, cdp, input-injection, missing-session |
| GitHub pull request reconcile interval must be a positive… | validation | error | github, configuration, validation |
| indexName is required, got | validation | error | configuration, validation, tool, graph-rag |
| : id must be provided and cannot be empty. | exception | error | storage, configuration, validation |
| Prompt blocks storage domain is not available | http | error | http-500, storage, prompt-blocks, version-skew |
| Questions must be greater than 0 | validation | error | configuration, validation, rag |
| restart() is not supported on | exception | error | workflow, restart, engine, unsupported |
| Cannot build stream options without a current thread | exception | error | session, thread, streaming |
| Child object must be a an array of RelatedNodeInfo objects | validation | error | data-structure, rag, relationships |
| Chunks and embeddings arrays must not be empty | validation | error | rag, empty-input, validation, argument-error |
| Environment not found | exception | error | cli, environment, not-found, cloud |
| Memory storage is not configured for agent | http | error | memory, storage, http-400, agent-configuration |
OBSERVABILITY_STORAGE_BATCH_CREATE_FEEDBACK_NOT_IMPLEMENTED This storage provider does not support batch creating feedback | error_code | error | storage, observability, not-implemented, feedback, batch |
pr-failed Refusing to open PR: invalid base branch | exception | error | git, validation, pull-request |
| Span references non-existent parent | exception | error | trace, span-tree, data-integrity |
| Step already prepared | exception | error | observational-memory, lifecycle, idempotency |
AGENT_FS_ROUTING_SCHEDULE_NAME_COLLISION Agent " ": duplicate schedule " " under agents/ /schedules/. Two files resolve… | error_code | error | fs-routing, schedules, duplicate-key |
| AgentScheduleWorker requires Mastra instance | exception | error | worker, initialization, schedules |
| Factory storage domain | exception | error | storage, initialization, lookup |
| MainSidebarNavLink accepts either `render` or `asChild`… | exception | error | react, props-validation, api-misuse, playground-ui |
| Only github.com plugin URLs are supported | validation | error | plugin-install, url-validation, github, unsupported-host |
| OpenAISDKAgent resumeData must include a message. | validation | error | resume, validation, argument-validation, openai |
| state signal cacheKey is required | exception | error | signals, state, missing-argument |