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. 2451 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| AcpAgent does not support resuming suspended generate calls | exception | error | storage, configuration, server, http-500 |
| AcpAgent does not support resuming suspended stream calls | exception | error | storage, adapter, agents-store, server, http-500 |
| Model "${modelId}" is not available. Available models: ${ids | validation | error | http-404, not-found, agents, rest-api |
| ACP connection is not initialized | exception | error | http-404, not-found, versions, rest-api |
| Model "${this.options.model}" is not available. Available mo | validation | error | http-404, not-found, versions, rest-api |
| ACP prompt stopped before completing: ${response.stopReason} | exception | error | storage, configuration, server, http-500 |
| ClaudeSDKAgent resumeData must include a message. | validation | error | storage, adapter, agents-store, server, http-500 |
| ClaudeSDKAgent resumeData must include either sessionId or c | validation | error | http-404, not-found, agents, rest-api |
| ClaudeSDKAgent resumeData.sessionId must be a string. | validation | error | http-404, not-found, versions, rest-api |
| ClaudeSDKAgent resumeData.continue must be true when provide | validation | error | http-404, not-found, versions, rest-api |
| ClaudeSDKAgent resumeData must include sessionId or continue | validation | error | resume, validation, argument-validation, claude |
| ${message.errors.join('\n') || `Claude Agent SDK failed with | exception | error | claude, agent-sdk, runtime-failure, generate |
| CursorSDKAgent resumeData must include a message. | validation | error | resume, validation, argument-validation, cursor |
| CursorSDKAgent resumeData.agentId must be a string when prov | validation | error | resume, validation, type-error, cursor |
| CursorSDKAgent does not support structuredOutput because the | validation | error | cursor, structured-output, unsupported-feature, validation |
| Cursor run ${result.id} ended with status ${result.status} | exception | error | cursor, agent-sdk, runtime-failure, generate |
| OpenAISDKAgent resumeData must include a message. | validation | error | resume, validation, argument-validation, openai |
| OpenAISDKAgent resumeData must include previousResponseId, c | validation | error | validation, resume, openai, argument-error |
| Invalid encrypted session data | validation | error | auth0, session, encryption, cookie, validation |
| Invalid state token format | validation | error | auth0, oauth, csrf, state-token, validation |
| Invalid or tampered state token | validation | error | auth0, oauth, csrf, hmac, signature-verification |
| Invalid state token payload | validation | error | auth0, oauth, state-token, base64, json-parsing |
| State token has expired | validation | error | auth0, sso, expired-token, state-validation |
| Auth0 domain and audience are required, please provide them | validation | critical | auth0, configuration, env-vars, missing-config |
| Cookie password must be at least 32 characters for SSO. Set | validation | critical | auth0, sso, cookie-security, configuration |
| Redirect URI is required for SSO. Set AUTH0_REDIRECT_URI or | validation | error | auth0, sso, oauth, missing-config, redirect-uri |
| Token exchange failed: ${error} | http | error | auth0, oauth, token-exchange, network, api-error |
| Failed to fetch user info from Auth0 | http | error | network, auth0, oauth, http-4xx |
| Better Auth instance is required. Please provide the auth op | validation | error | configuration, better-auth, missing-option, constructor |
| MastraAuthBetterAuth is not initialized — init() must run fi | exception | error | lifecycle, better-auth, initialization-order, async |
| MastraAuthBetterAuth needs a database to build its own bette | validation | error | configuration, database, better-auth, storage |
| ${errorData.message || 'Invalid email or password'} | http | error | authentication, credentials, better-auth, http-4xx |
| Invalid email or password | http | error | authentication, response-shape, better-auth, version-compat |
| ${errorData.message || 'Failed to create account'} | http | error | authentication, signup, better-auth, http-4xx |
| Failed to create account | http | error | authentication, signup, response-shape, better-auth |
| Invalid state token format | validation | warning | oauth, csrf, clerk, token-validation |
| Invalid state token signature | validation | warning | oauth, csrf, clerk, hmac, signature-verification |
| State token has expired | exception | error | auth, oauth, token-expired, sso |
| Clerk JWKS URI, secret key and publishable key are required, | validation | error | auth, clerk, configuration, env-var |
| Cookie password must be at least 32 characters for SSO. Set | validation | error | auth, clerk, sso, configuration, encryption |
| Redirect URI is required for SSO login | validation | error | auth, clerk, sso, oauth, configuration |
| Token exchange failed: ${error} | http | error | auth, clerk, oauth, network, token-exchange |
| Failed to fetch user info from Clerk | http | error | auth, clerk, oauth, network, userinfo |
| Invalid state redirect suffix | exception | error | auth, google, oauth, csrf, state-validation |
| Invalid encrypted session data | exception | error | auth, google, encryption, session, aes-gcm |
| Invalid state token format | exception | error | auth, google, oauth, state-validation, csrf |
| Invalid state token signature | exception | error | auth, google, oauth, hmac, signature-verification, csrf |
| Invalid state token payload | exception | error | oauth, csrf, state-token, base64, parsing |
| State token has expired | exception | error | oauth, csrf, state-token, expired, timeout |
| Google client ID is required. Provide it in the options or s | validation | error | configuration, oauth, google, env-var, startup |
| Cookie password must be at least 32 characters for SSO. Set | validation | error | configuration, security, cookie, encryption, sso |
| [MastraAuthGoogle] GOOGLE_COOKIE_PASSWORD is required for Go | validation | critical | configuration, production, security, session, sso, env-var |
| Invalid Google ID token nonce | exception | error | oauth, openid-connect, nonce, security, token-validation |
| Google ID token has expired | exception | error | oauth, jwt, expired, token-validation, google |
| Google ID token is missing subject | exception | error | oauth, openid-connect, jwt, claims, token-validation |
| Google user is not in an allowed hosted domain | exception | error | oauth, google-workspace, hosted-domain, authorization, sso |
| Redirect URI is required for Google SSO. Set GOOGLE_REDIRECT | validation | error | oauth, configuration, redirect-uri, google, sso |
| Google token exchange failed: ${error} | http | error | oauth, google, network, sso |
| Google token response did not include an ID token | http | error | oauth, oidc, google, sso, missing-field |
| Google RBAC roleMapping is required. | validation | error | configuration, rbac, google, validation |
| Google Directory groups.list failed (${response.status}): ${ | http | error | google, network, api-error, rbac, directory-api |
| Google Workspace Directory authentication is not configured. | validation | error | configuration, authentication, rbac, google, missing-credentials |
| Google service account private key signing failed (${(err as | exception | error | auth, google, crypto, configuration, env |
| Google service account token request failed (${response.stat | http | error | auth, google, oauth, network |
| Neon Auth base URL is required, please provide it in the opt | validation | error | auth, neon, configuration, env |
| Invalid email or password | http | error | auth, neon, login, credentials |
| Failed to create account | http | error | auth, signup, network, http-response |
| Okta domain is required. Provide it in the options or set OK | validation | error | okta, configuration, env-var, constructor |
| Okta client ID is required. Provide it in the options or set | validation | error | okta, configuration, env-var, constructor |
| Okta client secret is required for SSO. Provide it in the op | validation | error | okta, configuration, env-var, sso |
| Okta redirect URI is required for SSO. Provide it in the opt | validation | error | okta, configuration, env-var, sso |
| Cookie password must be at least 32 characters. Set OKTA_COO | validation | error | okta, configuration, validation, security |
| Invalid or expired state parameter | exception | error | okta, sso, oauth-state, csrf |
| State parameter has expired | exception | error | okta, sso, oauth-state, expiration |
| Token exchange failed: ${error} | exception | error | okta, sso, oauth, token-exchange, network |
| Okta domain is required. Provide it in the options or set OK | validation | error | config, env-var, okta, constructor |
| Okta API token is required for RBAC. Provide it in the optio | validation | error | config, env-var, okta, authentication, constructor |
| Session validation failed | exception | error | auth, sso, session, callback |
| Supabase URL and anon key are required, please provide them | validation | error | config, env-var, supabase, constructor |
| WorkOS API key and client ID are required. Provide them in t | validation | error | config, env-var, workos, authentication, constructor |
| Cookie password must be at least 32 characters. Set WORKOS_C | validation | error | config, workos, security, cookies, validation |
| WorkOS redirect URI is required. Provide it in the options, | validation | error | config, workos, sso, oauth, redirect-uri |
| MastraAuthWorkos could not resolve a callback URL: pass `red | validation | error | config, workos, oauth, redirect-uri, initialization |
| WorkOS webhook secret is required. Provide it in options or | validation | error | config, env-var, workos, webhook, directory-sync |
| WorkOS API key and client ID are required. Provide them in t | exception | error | config, env-var, workos, rbac, constructor |
| browser_close requires agent.threadId when browser scope is | exception | error | browser, thread-scope, missing-context, configuration |
| No browser context available for screencast | exception | error | browser, cdp, screencast, missing-session |
| CDP session not available for mouse injection | exception | error | browser, cdp, input-injection, missing-session |
| CDP session not available for keyboard injection | exception | error | browser, cdp, input-injection, missing-session |
| Shared browser not launched. Call createSharedSession() firs | exception | error | browser, lifecycle, initialization-order, shared-session |
| FirecrawlBrowser requires `apiKey` or FIRECRAWL_API_KEY | exception | error | config, api-key, environment-variable, authentication |
| Failed to fetch CDP version info from ${versionUrl}: ${respo | http | error | network, cdp, http-error, browser |
| No webSocketDebuggerUrl found in CDP version response from $ | exception | error | network, cdp, browser, response-shape |
| Timeout resolving WebSocket URL from ${versionUrl} (10s) | exception | error | network, timeout, cdp, browser |
| Browser not launched | exception | error | browser, lifecycle, initialization, stagehand |
| No page available for screencast | exception | error | browser, screencast, cdp, page |
| No CDP session available for page | exception | error | browser, cdp, screencast, session |
| No CDP session available | exception | error | browser, cdp, input, session |
| createStagehand factory not set - required for thread scope | exception | error | config, dependency-injection, stagehand, thread-scope |
| stagehand_close requires agent.threadId when browser scope i | exception | error | browser, tooling, misconfiguration |
| Slack refresh token is invalid. Get fresh tokens from https: | exception | critical | oauth, slack, token-rotation, storage |
| Token rotation failed: ${data.error} | exception | error | oauth, slack, token-rotation, api |
| Token rotation returned incomplete data | exception | error | slack, token-rotation, api-contract |
| App creation failed: ${errorDetails} | exception | error | slack, api, manifest, validation |
| App creation returned incomplete data | validation | error | slack, api-contract, response-shape |
| App deletion failed: ${data.error} | exception | error | slack, api, lifecycle |
| Failed to check whether Slack app exists: ${data.error ?? 'u | exception | error | slack, api, transient, availability |
| App manifest update failed: ${errorDetails} | exception | error | slack, manifest, config-drift, validation |
| Invalid ciphertext format | validation | error | crypto, decryption, data-format |
| Unsupported encryption algorithm: ${prefix} | validation | error | crypto, decryption, data-format |
| Invalid ciphertext payload | validation | error | crypto, decryption, data-corruption |
| [Slack] Failed to resolve Mastra storage. Ensure your Mastra | exception | error | storage, configuration, slack |
| [Slack] No storage available. SlackProvider requires persist | exception | error | storage, configuration, slack |
| SlackProvider not attached to Mastra. Call __attach() first. | exception | error | lifecycle, initialization, slack |
| connect({ id, name }): "name" is required when connecting wi | validation | error | validation, api-misuse, slack |
| Agent "${agentId}" not found | exception | error | validation, agents, slack |
| No agent or agent controller found with id "${agentId}" | exception | error | validation, agents, slack |
| Agent "${agentId}" is already connected to Slack. Disconnect | exception | error | state-conflict, duplicate, slack |
| No Slack installation found for agent "${agentId}" | exception | error | slack, oauth, not-found, configuration |
| SlackProvider is not configured. Provide a refreshToken via | exception | error | slack, configuration, missing-credentials |
| SlackProvider baseUrl not available during OAuth callback | exception | error | slack, oauth, configuration, callback |
| Slack OAuth HTTP error: ${tokenResponse.status} ${tokenRespo | http | error | slack, oauth, http, network |
| OAuth failed: ${tokenData.error} | exception | error | slack, oauth, authorization |
| Slack OAuth response missing required fields (access_token, | validation | error | slack, oauth, response-validation |
| Invalid ciphertext payload | validation | error | telegram, encryption, data-corruption |
| Telegram installation secrets are encrypted at rest, but no | exception | critical | telegram, encryption, missing-env-var, configuration |
| Telegram ${method} failed: ${detail} | exception | error | telegram, api, network, rate-limit |
| Telegram rejected the bot token: ${cause instanceof Error ? | exception | error | telegram, authentication, bot-token |
| Telegram getMe returned a non-bot user; expected a BotFather | validation | error | telegram, authentication, configuration |
| Agent "${agentId}" is already connected to Telegram. Disconn | exception | error | telegram, state-conflict, configuration |
| TelegramProvider needs a baseUrl to register a webhook. Set | exception | error | telegram, configuration, webhook, missing-env-var |
| No Telegram installation found for agent "${agentId}" | exception | error | telegram, state-conflict, cleanup |
| runId is required when resumeData is provided | validation | error | ai-sdk, validation, resume, request-body |
| Agent ${agentId} not found | exception | error | ai-sdk, agent-not-found, configuration, routing |
| Messages must be an array of UIMessage objects | validation | error | ai-sdk, validation, request-body, schema-validation-failed |
| Path must include :agentId to route to the correct agent or | validation | error | ai-sdk, configuration, routing, developer-error |
| Agent ID is required | validation | error | ai-sdk, routing, request-validation |
| Query parameters "versionId" and "status" are mutually exclu | validation | error | ai-sdk, query-params, validation, conflicting-parameters |
| Query parameter "status" must be "draft" or "published" | validation | error | http, query-params, validation, api-contract |
| UI Messages require a data property when using data- prefixe | exception | error | streaming, ai-sdk, data-chunks, validation |
| Aborted by processor | exception | warning | processors, middleware, tripwire, aborted |
| Agent ${agentId} not found | exception | error | http, agents, routing, configuration |
| Path must include :agentId to route to the correct agent or | validation | error | routing, configuration, http, startup |
| Agent ID is required | validation | error | http, routing, validation, agents |
| Query parameters "versionId" and "status" are mutually exclu | validation | error | http, query-parameters, validation, client-sdk |
| Query parameter "status" must be "draft" or "published" | validation | error | http, query-parameters, validation, client-sdk |
| heartbeatMs must be a finite number no greater than ${MAX_TI | validation | error | sse, configuration, range-error, validation |
| toAISdkFormat() has been deprecated. Please use toAISdkStrea | exception | error | deprecation, breaking-change, client-sdk, migration |
| UI Messages require a data property when using data- prefixe | exception | error | streaming, data-chunks, ui-messages, validation |
| UI Messages require a data property when using data- prefixe | exception | error | streaming, data-chunks, ui-messages, validation |
| Workflow ${workflowId} not found | exception | error | workflow, registration, client-sdk, not-found |
| Path must include :workflowId to route to the correct workfl | validation | error | config, routing, startup-validation |
| Workflow ID is required | validation | error | routing, request-time, workflow |
| MastraClient.deleteThread() requires exactly one of agentId | validation | error | client, validation, memory |
| Failed to stream background tasks: ${response.statusText} | http | error | network, streaming, http |
| Response body is null | http | error | streaming, runtime, http |
| A2A JSON-RPC response did not include a result | exception | error | a2a, json-rpc, protocol |
| A2A ${method} stream response did not include a body (status | http | error | a2a, streaming, http |
| runId is required to stream an agent builder action | validation | error | client, validation, streaming |
| Failed to stream agent builder action: ${response.statusText | http | error | network, http, streaming |
| Response body is null | http | error | streaming, runtime, http |
| Failed to observe agent builder action stream: ${response.st | http | error | http, streaming, network, client-js |
| Failed to observe agent builder action stream legacy: ${resp | http | error | http, streaming, legacy, network |
| Failed to resume agent builder action stream: ${response.sta | http | error | http, streaming, resume, network |
| No response body for agent controller session stream | http | error | streaming, null, http, agent-controller |
| No response body | http | error | streaming, null, memory, subscription |
| tool_result must be preceded by a tool_call | exception | error | streaming, protocol, tool-call, state |
| tool_result must be preceded by a tool_call with the same to | exception | error | streaming, tool-calls, state-machine |
| error | exception | error | streaming, server-error, error-part |
| HTTP error! status: ${response.status} - ${JSON.stringify(pa | http | error | http, network, client-js |
| MemoryThread.${methodName}() requires an agentId. Pass it vi | exception | error | api-misuse, typescript, client-js |
| Failed to stream workflow: ${response.statusText} | http | error | network, streaming, workflow |
| Response body is null | exception | error | network, streaming, workflow |
| Failed to observe workflow stream: ${response.statusText} | http | error | network, streaming, workflow |
| Failed to stream vNext workflow: ${response.statusText} | http | error | network, streaming, workflow |
| Failed to time travel workflow: ${response.statusText} | http | error | network, streaming, workflow |
| Invalid route path: "${path}". Path cannot contain '..', '?' | validation | error | validation, url, security, path-traversal |
| Failed to parse A2A stream event: ${error instanceof Error ? | exception | error | streaming, json, parsing, a2a, client |
| A2A stream error - ${JSON.stringify(parsed.error)} | exception | error | a2a, streaming, remote-error, client |
| Expected a PEM-encoded public key or certificate string for | exception | error | crypto, validation, configuration, jws, agent-card |
| Failed to canonicalize A2A Agent Card for signature verifica | exception | error | a2a, agent-card, json-canonicalization, signature-verification |
| Agent Card signature is missing a protected "alg" header | exception | error | jws, jose-header, agent-card, signature-verification |
| Agent Card signature algorithm "${protectedHeader.alg}" is n | exception | error | jws, algorithm-allowlist, agent-card, signature-verification |
| No verification key was provided for Agent Card signature ve | exception | error | jws, key-management, kid-lookup, signature-verification |
| A2A Agent Card signature verification failed: ${verification | exception | error | jws, signature-mismatch, agent-card, signature-verification |
| Unhandled content part type: ${(exhaustiveCheck as { type: s | exception | error | typescript, message-conversion, ai-sdk |
| ${metadata?.errorMessage || 'Workflow execution failed'} | exception | error | workflow, streaming, react |
| IsolatedVmCodeModeTransport requires the --no-node-snapshot | exception | error | node, v8-isolate, startup-flags, code-mode |
NODE_FAIL_INSTALL_SPECIFIED_VERSION NODE_FAIL_INSTALL_SPECIFIED_VERSION | error_code | error | node, install, deployment, subprocess |
FAIL_INSTALL_DEPS FAIL_INSTALL_DEPS | error_code | error | install, deployment, dependencies, subprocess |
FAIL_CUSTOM_INSTALL_COMMAND FAIL_CUSTOM_INSTALL_COMMAND | error_code | error | install, deployment, shell, subprocess |
FAIL_BUILD_SCRIPT FAIL_BUILD_SCRIPT | error_code | error | build, deployment, scripts, subprocess |
FAIL_BUILD_COMMAND FAIL_BUILD_COMMAND | error_code | error | build, deployment, shell, subprocess |
MASTRA_ENTRY_FILE_NOT_FOUND MASTRA_ENTRY_FILE_NOT_FOUND | error_code | error | deployment, entry-file, filesystem, config |
| execa is not available in Cloudflare Workers | exception | error | cloudflare, workers, runtime, sandbox, subprocess |
| require(${specifier}) is not available in Cloudflare Workers | exception | error | cloudflare, workers, esm, require, runtime |
| tagWorker method is no longer supported. Use the Cloudflare | exception | warning | cloudflare, deprecated, api-change |
| mastra-wrapper plugin did not return code, there is likely a | exception | error | babel, plugin, build, deployers |
| data.errors[0].message | http | error | cloudflare, api, secrets, auth |
| Updating the Edge Config alias requires a Vercel API token. | validation | error | vercel, edge-config, missing-token, configuration |
| Failed to update Edge Config alias "${options.key}" (${res.s | http | error | vercel, edge-config, http-error, api |
| @mastra/deployer-sandbox/client is server-only: resolving a | exception | error | browser, server-only, security, credentials |
| Sandbox provider "${sandbox.provider}" does not support netw | exception | error | sandbox, networking, provider, ports |
| Sandbox provider "${sandbox.provider}" did not expose a publ | exception | error | sandbox, networking, port-url, deployment |
| Woke sandbox but the Mastra server did not become healthy at | exception | error | sandbox, health-check, timeout, deployment |
| createSandboxProxy requires an Edge Config connection string | validation | error | edge-config, missing-env-var, sandbox, proxy |
| Failed to copy studio assets from "${studioSource}" to "${st | exception | error | filesystem, studio-assets, deployment, build |
| No index.mjs found in "${dir}" — did the build succeed? | exception | error | build, deployment, missing-file, sandbox |
| Sandbox provider "${sandbox.provider}" does not support netw | exception | error | sandbox, networking, capability, deployment |
| Sandbox provider "${sandbox.provider}" does not support exec | exception | error | sandbox, capability, execute-command, deployment |
| Sandbox provider "${sandbox.provider}" did not expose a publ | exception | error | sandbox, networking, port-url, deployment |
| Mastra server did not become healthy at ${url}${healthCheckP | exception | error | sandbox, health-check, timeout, deployment |
| Invalid environment variable name: "${key}" | validation | error | validation, env, shell, sandbox |
| Could not resolve the sandbox home directory. Pass `remoteDi | exception | error | sandbox, deploy, configuration |
| Sandbox provider "${sandbox.provider}" does not support exec | exception | error | sandbox, capability, deploy |
| Command failed inside sandbox (exit ${result.exitCode}): ${w | exception | error | sandbox, command-failure, deploy |
| Sandbox provider "${options.sandbox.provider}" does not supp | exception | error | sandbox, worker, capability |
| terminationGraceMs must be greater than zero. | validation | error | worker, validation, configuration |
| Worker command must be a non-empty executable path. | validation | error | worker, validation, configuration |
| Worker arguments must not contain NUL bytes. | validation | error | worker, validation, argv |
| Invalid worker environment variable name: ${key} | validation | error | worker, validation, environment-variables |
| ${name} must be greater than zero. | validation | error | worker, validation, configuration |
| Unknown worker resource limit: ${name}. | validation | error | validation, configuration, worker, sandbox |
| Worker resourceLimits.${name} must be a positive safe intege | validation | error | validation, types, worker, sandbox |
| Worker ${label} must stay within the deployed artifact root. | validation | error | validation, path-traversal, security, worker |
sandbox_command sandbox_command | error_code | error | sandbox, capability, resource-limits, preflight |
| Resource-limit preflight command failed. | error_code | error | sandbox, capability, resource-limits, shell |
| Worker ${startup.state} during startup${'message' in startup | exception | error | sandbox, worker-startup, timeout, deployment |
| Sandbox provider "${config.sandbox.provider}" does not suppo | exception | error | sandbox, unsupported-operation, provider-capability, lifecycle |
| Relaunch requires a new executionId. | validation | error | sandbox, invalid-argument, relaunch, identifier |
| Worker input exceeds inputLimitBytes (${data.byteLength} > $ | validation | error | sandbox, validation, payload-size, input |
| Unable to read worker ${stream}. | exception | error | sandbox, file-io, output-stream, shell |
| Worker executionId must contain only letters, numbers, dots, | validation | error | validation, input-sanitization, sandbox |
| Failed to copy studio assets from "${studioSource}" to "${st | exception | error | deployer, vercel, filesystem, build |
| expected an array of route segments | validation | error | deployer, vercel, manifest, schema-validation |
| Failed to read studio routes manifest at "${manifestPath}": | exception | error | deployer, vercel, manifest, filesystem |
| VoyageAI API key is required. Set VOYAGE_API_KEY environment | validation | error | api-key, configuration, env-var, voyageai |
| Unknown content type: ${(content as any).type} | exception | error | voyageai, multimodal, unsupported-type, input-validation |
| VoyageAI API key is required. Set VOYAGE_API_KEY environment | validation | error | api-key, configuration, env-var, voyageai |
| VoyageAI API key is required. Set VOYAGE_API_KEY environment | validation | error | api-key, configuration, env-var, voyageai |
| No relevance score found in VoyageAI response | exception | error | voyageai, reranker, api-response, version-mismatch |
| VoyageAI API key is required. Set VOYAGE_API_KEY environment | validation | error | api-key, configuration, env-var, voyageai |
| invalid API key or insufficient permissions | http | error | auth, http-401, http-403, api-key, network |
| bad request: ${responseText} | http | error | http-400, validation, network, bad-request |
| request failed with status ${response.status}: ${responseTex | http | error | network, http, server-error, rate-limit |
| Request timed out after ${effectiveTimeout}ms | exception | error | timeout, network, abort |
| Bright Data API token is required. Pass { apiKey } or set BR | validation | error | configuration, env-var, missing-config |
| language must be a two-letter code (e.g. "en", "es") | validation | error | validation, parameters, i18n |
| @mastra/livekit: reply generation runs through the Mastra ag | exception | error | api-misuse, livekit, voice, llm |
| @mastra/livekit: MastraVoiceAgent requires `agent` or `gener | validation | error | validation, api-misuse, constructor, livekit |
| @mastra/livekit: MastraVoiceAgent requires `agent` or `gener | validation | error | validation, api-misuse, constructor, livekit |
| @mastra/livekit: set LIVEKIT_URL or pass serverUrl to dispat | validation | error | configuration, env-var, livekit, missing-config |
| @mastra/livekit: set LIVEKIT_API_KEY and LIVEKIT_API_SECRET | validation | error | configuration, credentials, environment-variables, livekit |
| @mastra/livekit: MastraLLM requires exactly one reply source | validation | error | configuration, validation, livekit, llm-plugin |
| @mastra/livekit: no fetch implementation available; pass `fe | exception | error | environment, network, runtime-compatibility, livekit |
| @mastra/livekit: Mastra agent stream request failed with sta | http | error | network, http, streaming, livekit, mastra-server |
| @mastra/livekit: Mastra agent stream returned an empty respo | exception | error | network, streaming, sse, livekit, proxy |
| @mastra/livekit: the agent requested tool approval or suspen | exception | error | human-in-the-loop, tools, voice, unsupported-feature, livekit |
| @mastra/livekit: voice activity detection requires '@livekit | exception | error | dependency, voice-activity-detection, livekit, missing-package |
| @mastra/livekit: turnDetection '${kind}' requires '@livekit/ | exception | error | dependency, turn-detection, livekit, missing-package |
| @mastra/livekit: no Mastra agent specified. Set `agent` on c | validation | error | configuration, routing, agents, livekit |
| @mastra/livekit: no workflow specified. Set `workflow` on cr | validation | error | configuration, workflows, livekit |
| @mastra/livekit: set exactly one reply generator — `generate | validation | error | configuration, validation, livekit, worker |
| @mastra/livekit: set `agent` or `workflow`, not both — they | validation | error | configuration, validation, livekit, worker |
| @mastra/livekit: `workflowInput` is required when `workflow` | validation | error | configuration, livekit, workflow, validation |
| @mastra/livekit: `configuration.endCall` has no effect with | validation | error | configuration, livekit, validation |
| @mastra/opencode: failed to initialize memory storage from $ | exception | error | storage, libsql, memory, opencode |
| Parallel API key is required. Pass { apiKey } or set the PAR | validation | error | api-key, configuration, environment, parallel |
| Perplexity API key is required. Pass { apiKey } or set the P | validation | error | api-key, configuration, environment, perplexity |
| Perplexity Search request failed with status ${response.stat | http | error | network, http, api, perplexity |
| Tavily API key is required. Pass { apiKey } or set TAVILY_AP | validation | error | api-key, configuration, environment, tavily |
| WorkOS provider requested but the active factory auth provid | exception | error | auth, workos, provider, guard |
| MastraFactory: 'storage' is required. Pass a FactoryStorage | validation | error | configuration, constructor, storage, missing-required-argument |
| MastraFactory.prepare() called twice | validation | error | lifecycle, double-initialization, concurrency |
| MastraFactory: duplicate integration id '${integration.id}' | validation | error | configuration, duplicate, integration, validation |
| MastraFactory: 'sandbox' is now a callback, not an options o | validation | error | configuration, breaking-change, sandbox, migration |
| MastraFactory: 'sandbox' must be a function constructing a M | validation | error | configuration, type-error, sandbox |
| MastraFactory: integration '${integration.id}' signs OAuth s | validation | error | oauth, configuration, security, secrets, replication |
| MastraFactory: integration tool '${name}' from '${ownerId}' | validation | error | naming-conflict, integration, tools, duplicate |
| MastraFactory: integrations [${channelRegistrations.map(({ i | validation | error | configuration, integration, channels, conflict |
| MastraFactory.finalize() called before prepare() | validation | error | lifecycle, initialization-order, api-misuse |
| Version-control repository not found. | exception | error | github, storage, not-found, integration |
| Version-control installation not found. | exception | error | github, storage, integration |
| GitHub installation id is invalid. | validation | error | github, data-integrity, validation |
| GithubIntegration: missing required config field(s): ${missi | validation | error | config, github, startup |
| GithubIntegration storage has not been initialized. | exception | error | lifecycle, storage, initialization |
| GithubIntegration source-control storage has not been initia | exception | error | lifecycle, storage, initialization |
| GitHub pull requests require an owner/repository source. | validation | error | github, validation, input |
| A review comment requires commitId, path, line, and side unl | validation | error | github, validation, input |
| A multi-line review comment requires both startLine and star | validation | error | github, validation, input |
| GitHub OAuth token exchange failed: ${res.status} | http | error | github, oauth, network, http |
| GitHub OAuth token exchange returned no token: ${data.error_ | http | error | oauth, github, authentication |
| GitHub triage comments require an owner/repository source. | validation | error | github, validation, input |
| Unsupported GitHub review state: ${state} | validation | error | github, parsing, enum |
| GitHub ${resource} id must be a positive integer. | validation | error | github, validation, input |
| GitHub capabilities require an app-installation connection. | validation | error | github, authentication, configuration |
| ${message} | validation | error | github, validation, input |
| GitHub cursor must be a positive page number. | validation | error | github, pagination, validation |
| GitHub reconcile worker requires a pull request or issue rec | validation | error | github, configuration, constructor |
| GitHub pull request reconcile interval must be a positive nu | validation | error | github, configuration, validation |
| GitHub issue reconcile interval must be a positive number. | validation | error | configuration, validation, github, scheduler |
| GithubReconcileWorker: call init() before start() | validation | error | lifecycle, github, initialization-order |
| Repository access did not include a bearer token. | exception | error | github, authentication, git-push |
clone-failed Refusing to materialize: invalid repo full name '${repo}'. | error_code | error | validation, git-clone, injection-guard, github |
git-missing git is not installed in the sandbox. The sandbox template must include git. | error_code | error | environment, git, sandbox, missing-dependency |
pull-failed Failed to set git remote: ${setUrl.stderr} | error_code | error | git, sandbox, pull, filesystem |
commit-failed Failed to set git user.name: ${setName.stderr.trim()} | error_code | error | git, sandbox, commit, configuration |
push-failed Refusing to push: invalid repo full name '${repoFullName}'. | exception | error | git, validation, security |
| ${label} command failed (exit ${result.exitCode}): ${detail} | exception | error | sandbox, shell, build |
gh-missing The GitHub CLI (gh) is not installed in the sandbox. The sandbox template must i | exception | error | github-cli, sandbox, prerequisites |
pr-failed Refusing to open PR: invalid base branch '${base}'. | exception | error | git, validation, pull-request |
| Pull request must belong to ${expectedRepo}. | exception | error | validation, github, pull-request, url-parsing |
| GitHub subscriptions require an authenticated repository ses | exception | error | session, authentication, github |
| Project repository not found for this organization. | exception | error | storage, not-found, github, session |
| Source-control connection not found for this organization. | exception | error | storage, not-found, github, connection |
| Repository not found for this organization. | exception | error | storage, not-found, github |
| Source-control installation not found for this organization. | exception | error | storage, not-found, github, installation |
| GitHub repository is invalid. | exception | error | validation, github, slug |
| Pull request repository does not match the active project re | exception | error | github, pull-request, validation, mismatch |
| GitHub installation is invalid. | exception | error | github, integration, data-validation |
| Repository access did not include a bearer token for the Fac | exception | error | github, authentication, token |
| GitHub token refresh requires an active Factory sandbox work | exception | error | github, sandbox, request-context |
| GitHub subscription ${subscription.id} is missing its sessio | exception | error | github, webhook, data-integrity |
| GitHub subscription ${subscription.id} has no Factory sessio | exception | error | github, webhook, orphaned-session |
| Session ${sessionId} did not bind thread ${threadId}. | exception | error | github, webhook, thread-binding |
| GitHub integration is required to load webhook subscriptions | exception | error | github, webhook, dependency-injection, misconfiguration |
| GitHub integration is required to retire webhook subscriptio | exception | error | github, webhook, dependency-injection, misconfiguration |
| ${config.integrationId} issue reconcile interval must be a p | validation | error | configuration, worker, validation |
| IssueReconcileWorker: call init() before start() | exception | error | worker, lifecycle, initialization |
| Linear API error: ${body.errors[0]?.message ?? 'unknown erro | exception | error | network, graphql, linear-api, third-party-api |
| Linear API returned no data. | exception | error | network, graphql, linear-api, unexpected-response |
| LinearIntegration is not initialized — the factory binds sto | exception | error | lifecycle, initialization, configuration |
| Linear authorization expired. Reconnect Linear to keep synci | exception | error | oauth, token-expired, linear, reauth-required |
| LinearIntegration is missing required config: ${missing.join | validation | error | configuration, oauth, env-var, startup |
| Linear ${label} returned no access token. | exception | error | oauth, network, linear, unexpected-response |
| Linear did not accept the issue update. | exception | error | linear, graphql, api-rejected, state-update |
| Linear did not accept the comment. | exception | error | linear, graphql, comment, api-rejected |
| Linear capabilities require an OAuth connection. | exception | error | linear, oauth, configuration, auth |
| Platform integration: missing required environment variable | exception | critical | environment, configuration, missing-env-var, platform |
| Platform integration: missing required config field(s): ${mi | exception | error | configuration, validation, constructor, platform |
| Platform API request did not return a redirect. | http | error | http, redirect, api-client, platform-api |
| Platform GitHub event polling interval must be a positive nu | validation | error | configuration, validation, github, worker |
| Platform GitHub pull request reconcile interval must be a po | validation | error | configuration, validation, github, worker |
| Platform GitHub issue reconcile interval must be a positive | validation | error | configuration, validation, github, worker |
| Version-control repository not found. | exception | error | github, storage, not-found, repository |
| Version-control installation not found. | exception | error | github, installation, data-integrity, storage |
| GitHub installation id is invalid. | validation | error | github, installation, validation, data-integrity |
| Platform GitHub event polling requires the mounted Mastra Co | exception | error | configuration, github, workers, bootstrap |
| Platform GitHub token minting requires between one and ten i | exception | error | github, installation-token, limits, permissions |
| A review comment requires commitId, path, line, and side unl | validation | warning | github, validation, pull-request, review-comment |
| GitHub capabilities require an owner/repository source. | exception | error | github, validation, source-id, slug |
| GitHub capabilities require a GitHub connection. | exception | error | github, connection, auth, validation |
| GitHub cursor must be a positive page number. | validation | warning | github, pagination, validation, cursor |
| ${name} must be a positive integer. | validation | error | configuration, env-var, github, validation |
| GitHub ${resource} id must be a positive integer. | validation | error | github, validation, id-parsing, pull-request |
| Platform Linear event polling interval must be a positive nu | validation | error | configuration, validation, linear, polling |
| Platform Linear reconcile interval must be a positive number | validation | error | configuration, validation, linear, polling |
| Linear project source id is invalid. | validation | error | linear, parsing, validation, cursor |
| Linear cursor is invalid. | validation | error | linear, cursor, parsing, json |
| Linear capabilities require an OAuth connection. | exception | error | linear, oauth, authentication, configuration |
| ${name} must be a positive integer. | validation | error | environment, configuration, validation, linear |
| SlackIntegration: 'signingSecret' is required — Slack cannot | exception | critical | slack, configuration, authentication, missing-secret |
| Missing required query param: ${label} | validation | error | http, validation, query-params, filesystem |
| ${label} must be relative | validation | error | http, validation, path-traversal, filesystem |
| ${label} escapes workspace | validation | error | path-traversal, security, validation, filesystem |
| Root is not approved for rendered workspace access | validation | error | security, allowlist, configuration, filesystem |
| Path is outside the browsable root | exception | error | path-traversal, symlink, security, filesystem |
| Path escapes workspace | validation | error | path-traversal, security, validation, filesystem |
| Path is outside the workspace | exception | error | filesystem, path-traversal, symlink, security |
| Root escapes workspace | validation | error | filesystem, path-traversal, security, containment |
| Path is a directory | exception | error | filesystem, validation, wrong-argument-type |
| Unsupported file type | exception | error | filesystem, validation, special-files |
| Session is not available to the current user | exception | error | auth, authorization, multi-tenancy, access-control |
| Missing required query param: threadId | validation | error | http, validation, missing-parameter |
| Session workspace is not available | exception | error | workspace, session, lifecycle |
| Unable to read workspace diff | exception | error | git, diff, exit-code |
| Credential storage is not available | exception | critical | oauth, configuration, storage, missing-dependency |
unsupported_provider_item Factory skill invocation requires one exclusive board stage. | error_code | error | dispatch, board, validation, provider-item |
source_control_missing_or_source_repository_missing error.message (dynamic; FactorySourceSessionResolutionError) | error_code | error | source-control, repository, dispatch, error-mapping |
source_control_missing error.message (dynamic; SourceControlConnectionNotFoundError) | error_code | error | source-control, connection, dispatch, error-mapping |
| error.message (dynamic; MaterializeError) | error_code | error | factory, materialization, wrapped-error, api-route |
| Factory rule version is required. | validation | error | validation, factory-rules, missing-argument, config |
| ${initial.code}: ${initial.reason} | exception | error | rules-engine, dispatch, rejected-decision, factory |
| ${moved.code}: ${moved.reason} | exception | error | rules-engine, stage-transition, dispatch, factory |
| Factory decision is not linked to a work item. | exception | error | data-integrity, factory, dispatch, missing-link |
| Factory work item not found. | exception | error | factory, storage, missing-record, dispatch |
session_unavailable No active Factory binding for role ${role}. | No active Factory binding. | error_code | error | factory, binding, session, dispatch |
| Factory binding ${binding.id} has no authenticated session o | exception | error | factory, authentication, session, data-integrity |
| Factory kickoff is waiting on a run that has not ended. | exception | error | factory, timeout, async, agent-run |
| Factory kickoff was queued onto an ending run and never reac | exception | error | factory, async, race-condition, kickoff |
| Factory kickoff run terminal event was not observed before t | exception | error | factory, timeout, events, agent-run |
| Factory kickoff run ended in error. | exception | error | factory, agent-run, error-propagation, retry |
| Factory kickoff run was aborted before it finished. | exception | warning | factory, abort, lifecycle, retry |
| Factory kickoff lease was lost before completion. | exception | error | factory, lease, concurrency, distributed |
| Factory review phase requires a controller request context. | exception | error | factory, request-context, review-phase, api-misuse |
| Factory review phase requires a selected session model. | exception | error | factory, model-selection, session, review-phase |
| Skill not found: ${invocation.skillName}. | exception | error | skill, workspace, configuration, lookup-failed |
| Factory session not found | exception | error | session, storage, not-found, multi-tenancy |
| Factory session repository not found | exception | error | repository, referential-integrity, storage, not-found |
| Factory session does not belong to this project | exception | error | project, ownership, authorization, mismatch |
| Factory source control storage is unavailable | exception | error | configuration, dependency-injection, storage, missing-dependency |
| Factory transition service is unavailable. | exception | error | factory, dependency-injection, configuration, transition-service |
| Factory transitions require an authenticated bound agent too | exception | error | factory, authentication, tool-execution, session-binding |
| Factory agent binding is unavailable, revoked, or no longer | exception | error | factory, authorization, session-binding, binding-revoked |
| Bound Factory work item not found. | exception | error | factory, storage, data-integrity, work-item |
| ${label} contains an unsupported field. | validation | error | validation, schema, factory-rules, typo |
| ${label} must be a string. | validation | error | validation, typescript, type-mismatch |
| ${label} is invalid. | validation | error | validation, constraints, string-format |
| Rule metadata must contain finite numbers. | validation | error | validation, json, numbers |
| Rule metadata is not bounded JSON. | validation | error | validation, json, depth-limit |
| Rule metadata must not contain cycles. | validation | error | validation, json, cycles |
| Rule metadata contains too many entries. | validation | error | validation, limits, json |
| Rule metadata must use plain objects. | validation | error | validation, json, plain-object |
| Rule metadata contains too many fields. | validation | error | validation, limits, json |
| Rule metadata must be an object. | validation | error | validation, json, shape-mismatch |
| Rule metadata is too large. | validation | error | validation, metadata, size-limit, factory-rules |
| ${label} must be an object. | validation | error | validation, type-mismatch, factory-rules, config |
| ${label}.${stage} must be an object. | validation | error | validation, structure, factory-rules, type-mismatch |
| ${label}.${stage}.${source} must be an object. | validation | error | validation, structure, handlers, factory-rules |
| ${label}.${stage}.${source} handlers must be functions. | validation | error | validation, handlers, type-mismatch, factory-rules |
| Factory rules must be an object. | validation | error | validation, null-check, factory-rules, config |
| Factory rules.tools must be an object. | validation | error | validation, structure, tools, factory-rules |
| Factory rules.tools.${toolName} must be an object. | validation | error | validation, structure, tools, handlers |
| Factory rules.tools.${toolName}.onResult must be a function. | validation | error | validation, handlers, type-mismatch, tools |
| Factory rules.github must be an object. | validation | error | validation, structure, github, factory-rules |
| Factory rules.github.${event} must be an object. | validation | error | validation, factory-rules, configuration |
| Factory rules.github.${event}.onEvent must be a function. | validation | error | validation, factory-rules, type-error |
| Factory rules.linear must be an object. | validation | error | validation, factory-rules, configuration |
| Factory rules.linear.${event} must be an object. | validation | error | validation, factory-rules, configuration |
| Factory rules.linear.${event}.onEvent must be a function. | validation | error | validation, factory-rules, type-error |
| Factory rule causal depth exceeded. | validation | error | validation, recursion, factory-rules |
| Factory rule decision must be an object. | validation | error | validation, factory-rules, type-error |
| Factory rule decision type is required. | validation | error | validation, factory-rules, missing-field |
| Factory transition reenter must be a boolean. | validation | error | validation, factory-rules, type-error |
| Factory transition message must be an object. | validation | error | validation, factory-rules, type-error |
| Factory linked work item URL is invalid. | validation | error | validation, url, factory-rules |
| Factory skill invocation needs exactly one of skillName or p | validation | error | validation, factory-rules, xor-fields |
| Factory skill cancelInFlight must be a boolean. | validation | error | validation, type-mismatch, factory-rules |
| Factory message prepareBinding must be a boolean. | validation | error | validation, type-mismatch, factory-rules |
| Factory rule decision type is unsupported. | validation | error | validation, unsupported-type, factory-rules |
| Factory rule produced too many decisions. | validation | error | validation, limit-exceeded, factory-rules |
| A rejection cannot be persisted with commit decisions. | validation | error | validation, factory-rules, transaction-semantics |
| Factory decisions require unique idempotency keys. | validation | error | validation, idempotency, factory-rules |
| Sandbox provider '${sandbox.provider}' does not support exec | exception | critical | sandbox, configuration, missing-capability |
| Sandbox '${sandbox.id}' cannot resolve its workdir: no execu | exception | critical | sandbox, workdir, missing-capability |
| Sandbox '${sandbox.id}' default cwd probe failed (exit ${pro | exception | error | sandbox, remote-execution, shell-probe, infrastructure |
| Sandbox '${sandbox.id}' cannot run the session setup: no exe | exception | error | sandbox, missing-implementation, api-misuse, session-setup |
| Refusing to use local sandbox path outside configured root: | exception | error | path-traversal, security, sandbox, configuration |
| [FactorySecretEncryption] Key id is required. | exception | error | encryption, configuration, missing-value, keys |
| [FactorySecretEncryption] Key "${id}" must be exactly 32 byt | exception | error | encryption, aes-256-gcm, key-length, configuration |
| [FactorySecretEncryption] Invalid encrypted value. | exception | error | encoding, base64url, json, validation |
| [FactorySecretEncryption] Duplicate key id "${previous.id}". | exception | error | configuration, key-rotation, duplicate-key, validation |
| [FactorySecretEncryption] Unknown key id "${envelope.keyId}" | exception | error | encryption, key-management, rotation, configuration |
| [FactorySecretEncryption] Unable to decrypt encrypted value. | exception | error | encryption, aes-gcm, integrity, key-management |
| ${resolved.reason} | exception | error | source-control, session, resolution |
session_not_found session_not_found | error_code | error | session, not-found, skill-invocation |
skill_not_found skill_not_found | error_code | error | skill, not-found, workspace |
| [FilesystemStorage] resourceId must not be empty. | validation | error | validation, storage, filesystem |
| [FilesystemStorage] path must be a non-empty relative path. | validation | error | validation, path, filesystem, path-traversal |
| [FilesystemStorage] duplicate file path: ${file.path} | validation | error | validation, duplicate, filesystem, batch |
| [QueueHealthStorage] thresholdsSeconds must be a non-empty a | validation | error | validation, config, queue-health |
| [QueueHealthStorage] thresholdsSeconds must be strictly asce | validation | error | validation, config, ordering, queue-health |
| Source-control installation not found for this organization | exception | error | source-control, installation, not-found, storage |
| Source-control repository not found for this organization an | exception | error | source-control, not-found, repository |
| Project repository not found for this integration. | exception | error | source-control, not-found, project-repository |
| Repository ${id} not found in organization ${orgId} | exception | error | source-control, not-found, migration, repository |
| Factory project not found for this organization. | exception | error | source-control, not-found, factory-project, connection |
| Repository does not belong to the connection installation. | exception | error | source-control, installation-mismatch, repository, link |
| Source-control installation not found | exception | error | source-control, not-found, installation, in-memory |
| Repository ${id} not found in organization ${orgId} | exception | error | source-control, not-found, migration, in-memory |
| Source-control connection or repository not found | exception | error | source-control, not-found, installation-mismatch, link, in-memory |
| Source-control session ID already exists | exception | error | storage, uniqueness, source-control |
| Related work item not found in this project. | exception | error | storage, work-items, validation |
| A work item cannot relate to itself. | exception | error | storage, work-items, validation |
| This relationship would create a cycle. | exception | error | storage, work-items, cycle, hierarchy |
| The related work item chain contains a cycle. | exception | error | storage, work-items, cycle, data-integrity |
| Factory session ${session.sessionId} is not available to the | exception | error | authorization, access-control, multi-tenancy |
| Repository link ${session.projectRepositoryId} was not found | exception | error | storage, missing-resource, github |
| Repository link ${session.projectRepositoryId} is incomplete | exception | error | storage, missing-resource, github, consistency |
| GitHub installation ${connection.installationId} was not fou | exception | error | github, missing-resource, installation |
| The active sandbox provider does not support runtime GitHub | exception | error | sandbox, github, token, capability-missing |
| Repository access did not include a bearer token for the Fac | exception | error | github, auth, missing-token, factory |
| GitHub token refresh no longer matches the active Factory wo | exception | error | race-condition, github, auth, stale-state, factory |
| Factory workspace GitHub credential registration is no longe | exception | error | race-condition, workspace, github, factory |
| ${setupError.message}. The sandbox stays usable: this setup | error_code | error | setup-command, configuration, sandbox, factory |
| Factory session ${session.sessionId} was retired during work | exception | error | race-condition, session-lifecycle, workspace, factory |
| await extractError(res) | http | error | http, api-client, fetch, factory-ui |
| Session settings are unavailable | exception | error | react-query, settings, session, factory-ui |
| Failed to load models (${res.status}) | http | error | http, models, react-query, factory-ui |
| Failed to load Factories | exception | error | http, react-query, factory-ui |
| Factory project is required | exception | error | validation, react-query, missing-param, factory-ui |
| Factory project is required | exception | error | react-query, guard-clause, missing-parameter, factory-ui |
| Factory project is required | exception | error | react-query, guard-clause, missing-parameter, factory-ui |
| Factory run requires a board work item | exception | error | guard-clause, missing-parameter, factory-ui, react-query |
| Select a repository before starting a Factory run | exception | error | guard-clause, state-management, factory-ui, react-query |
| Factory runs require one exclusive destination stage | exception | error | guard-clause, validation, factory-ui, domain-rules |
| Session settings are unavailable | exception | error | react-query, cache-miss, guard-clause, agent-controller |
| error | exception | error | websocket, network, agent-controller, verification |
| The server did not persist the requested settings | exception | error | consistency, agent-controller, verification, react-query |
| Work item is required | exception | error | guard-clause, missing-parameter, factory-ui, react-query |
| No Factory selected | exception | error | react, react-query, missing-parameter, factory-ui |
| Unsupported Factory stage: ${stage} | validation | error | validation, enum, factory-ui, state-machine |
| No Factory selected | exception | error | react, react-query, missing-parameter, factory-ui |
| Connect a repository before creating a workspace | exception | error | prerequisite, configuration, factory-ui, react-query |
| Connect a repository before deleting a workspace | exception | error | prerequisite, configuration, factory-ui, react-query |
| Authenticated user is missing a user id | exception | error | auth, authentication, missing-field, session |
| Authentication failed / server-provided message | http | error | auth, authentication, credentials, http |
| Auth check failed (${res.status}) | http | error | auth, network, http, server-error |
| Could not create the session. Reload the page and try again. | exception | error | react, react-query, state, missing-parameter, chat |
| Session configuration is not ready. Try again. | exception | warning | react-query, state-readiness, mutation, ui |
| Could not create the session: ${message}. Try again. | exception | error | react-query, mutation, error-wrapping, network |
invalid_response Skill invocation returned an invalid response. | http | error | http, json-parsing, invalid-response, proxy |
skill_invocation_failed Skill invocation failed (${response.status}). | http | error | http, network, api-error, proxy |
| ${result.reason} | exception | error | board-transition, server-rejection, react-query, state-conflict |
| Attention read-all response is missing its continuation curs | validation | error | pagination, api-contract, invariant, http |
| Request failed (${res.status}) / server-provided message | http | error | http, audit, api-error, auth |
| Invalid audit event response | validation | error | schema-validation, http, audit, api-contract |
| Invalid audit portal response | validation | error | schema-validation, http, audit, api-contract |
| Request failed (${response.status}) / server-provided messag | http | error | http, api, factory-decisions |
| Request failed (${res.status}) / server-provided message | http | error | http, api, github |
| Failed to load pull request subscriptions (${response.status | http | error | http, api, github-subscriptions |
| Pull request subscriptions returned an invalid response. | validation | error | http, validation, contract-mismatch, github-subscriptions |
| Request failed (${res.status}) / server-provided message | http | error | http, api, intake-config |
| Request failed (${res.status}) / server-provided message | http | error | http-error, api-response, network, requesterror |
| ${body.error} or Request failed (${res.status}) | http | error | http-error, state-transition, api-response, work-items |
| Start over from the name step. | exception | warning | validation, client-side-guard, wizard-state, react |
| Failed to load GitHub token status (${res.status}) | http | error | http-error, github, authentication, network |
| ${body?.error} or Failed to save GitHub token (${res.status} | http | error | http, github, auth, fetch |
| Failed to remove GitHub token (${res.status}) | http | error | http, github, auth, fetch |
| Failed to list repos (${res.status}) | exception | error | http, github, fetch, rate-limit |
| Failed to unlink repository (${res.status}) | exception | error | http, fetch, factory, idempotency |
| Failed to delete Factory (${res.status}) | exception | error | http, fetch, factory, idempotency |
| Failed to load repository settings (${res.status}) | exception | error | http, fetch, react-query, network |
| Failed to delete session (${res.status}) | exception | error | http, fetch, delete, network |
| Failed to rename session (${res.status}) | exception | error | http, fetch, rename, network, llm |
| Invalid --region "${region}". Expected one of: eu, us. | validation | error | cli, argument-validation, configuration |
| ${err instanceof Error ? err.message : String(err)}\nYou can | exception | error | cli, dependency-install, spawn, network, node |
| Platform connection response missing DATABASE_URL. | exception | error | platform-api, neon, missing-env-var, contract-violation |
| No organization matched --org "${value}". Available: ${avail | exception | error | cli, configuration, organization, flag-validation |
| Failed to create project — ${await extractError(res)} | http | error | http-error, platform-api, project-creation, network |
| Failed to create API key — ${await extractError(res)} | http | error | http-error, platform-api, api-key, auth |
| Attaching a database requires the admin role in your organiz | http | error | http-403, permissions, rbac, platform-api |
| Failed to attach Neon database — ${await extractError(res)} | http | error | http-error, platform-api, neon, network |
| Failed to read database status — ${await extractError(res)} | http | error | http-error, platform-api, polling, network |
| Failed to fetch connection string — ${await extractError(res | http | error | http-error, platform-api, database-connection, race-condition |
| Neon provisioning failed${row.error ? ` — ${row.error}` : '' | exception | error | neon, provisioning-failed, platform-api, polling |
| Directory ${path.basename(targetPath)} already exists | exception | error | filesystem, cli, conflict, scaffolding |
| degit completed without cloning template files | exception | error | filesystem, network, template-scaffold |
| Failed to clone repository: ${gitError instanceof Error ? gi | exception | critical | git, network, fallback-failure |
| Unknown ACP sessionId: ${sessionId} | exception | error | acp, session-state, state-management |
| Need MOONSHOT_API_KEY | exception | error | configuration, env-var, api-key, authentication |
| Invalid model id: ${modelId} | validation | error | configuration, validation, model-id |
| No model available: this run started without a controller se | exception | error | configuration, request-context, model-resolution |
| No model selected. Use /models to select a model first. | exception | error | configuration, ux, model-selection |
| Not found at ref ${ref}: ${path} | exception | error | git, filesystem, not-found |
| Sandbox workspace root resolution returned an empty path | exception | error | sandbox, filesystem, initialization |
| Path escapes workspace root: ${inputPath} | exception | error | sandbox, filesystem, path-traversal, security |
| Unable to verify path stays within workspace root: ${inputPa | exception | error | sandbox, filesystem, symlink, verification-failed, shell |
| Path escapes workspace root (symlink): ${inputPath} | exception | critical | sandbox, symlink, path-traversal, security |
| ${context} failed (exit ${result.exitCode}): ${result.stderr | exception | error | sandbox, shell, exec, exit-code, filesystem |
| IsDirectoryError: ${path} | error_code | error | filesystem, read-file, directory, typed-error |
| FileNotFoundError: ${path} | error_code | error | filesystem, sandbox, file-not-found |
| readFile ${path} failed (exit ${result.exitCode}): ${result. | exception | error | filesystem, sandbox, permissions, shell |
| FileExistsError: ${path} | error_code | error | filesystem, sandbox, file-exists, write-conflict |
| writeFile ${path} failed (exit ${result.exitCode}): ${result | exception | error | filesystem, sandbox, write-failure, shell |
| deleteFile ${path} failed (exit ${result.exitCode}): ${resul | exception | error | sandbox, filesystem, shell-command, delete |
| copyFile ${src} -> ${dest} failed (exit ${result.exitCode}): | exception | error | sandbox, filesystem, shell-command, copy |
| moveFile ${src} -> ${dest} failed (exit ${result.exitCode}): | exception | error | sandbox, filesystem, shell-command, move |
| Directory not empty or not found: ${path} | exception | error | filesystem, sandbox, shell |
| Directory not found: ${path} | exception | error | filesystem, sandbox, readdir |
| notification_inbox requires a notifications storage domain | exception | error | storage, configuration, notifications |
| Project path is required | validation | critical | configuration, request-context, workspace |
| Login cancelled | exception | info | oauth, device-flow, cancellation, abort-signal |
| Missing authorization code | validation | error | oauth, anthropic, pkce, input-validation |
| Invalid authorization state | validation | error | oauth, anthropic, pkce, csrf, state-mismatch |
| Token exchange failed: ${error} | http | error | oauth, anthropic, token-exchange, http-error, pkce |
| Anthropic token refresh failed: ${error} | http | error | oauth, anthropic, token-refresh, http-error, credentials |
| ${response.status} ${response.statusText}: ${text} | http | error | network, http, github-copilot, oauth, device-flow |
| Invalid device code response | exception | error | github-copilot, oauth, device-flow, response-shape, network |
| Invalid device code response fields | exception | error | github-copilot, oauth, device-flow, schema-validation, response-shape |
| Invalid Copilot token response | exception | error | github-copilot, token-refresh, response-shape, network |
| Invalid Copilot token response fields | exception | error | github-copilot, token-refresh, schema-validation, response-shape |
| Login cancelled | exception | info | auth, abort, user-cancellation, github-copilot |
| Invalid GitHub Enterprise URL/domain | validation | error | auth, validation, input, github-enterprise |
| Failed to fetch Copilot models: ${response.status} ${respons | http | error | network, http, api, github-copilot |
| Invalid Copilot models response: missing `data` array | exception | error | network, api, schema-validation, response-parsing, github-copilot |
| Kimi For Coding credentials have an invalid device ID. Pleas | exception | error | auth, validation, credentials, device-id, kimi-coding |
| Kimi For Coding token ${operation} response missing fields | exception | error | auth, oauth, token, schema-validation, kimi-coding |
| Kimi For Coding device authorization failed: ${response.stat | http | error | network, http, oauth, device-flow, kimi-coding |
| Invalid Kimi For Coding device authorization response | exception | error | oauth, device-flow, schema-validation, response-parsing, kimi-coding |
| Failed to extract ChatGPT account id from OpenAI Codex token | exception | error | auth, jwt, token-parsing, openai-codex |
| OpenAI Codex OAuth is only available in Node.js environments | exception | error | oauth, environment, nodejs, crypto |
| Failed to initiate OpenAI Codex device authorization: ${resp | exception | error | network, oauth, http-status, device-login |
| OpenAI Codex device authorization response missing required | exception | error | oauth, schema-validation, device-login, api-contract |
| Login cancelled | exception | info | abort, cancellation, oauth, device-login |
| result.error (dynamic message from device-login poll failure | exception | error | oauth, device-login, polling, auth-denied |
| State mismatch | exception | error | oauth, csrf, state-mismatch, security |
| Missing authorization code | exception | error | oauth, missing-input, authorization-code, login |
| Token exchange failed | exception | error | oauth, openai, authentication |
| Failed to refresh OpenAI Codex token | exception | error | oauth, openai, token-refresh |
| xAI device authorization returned an invalid verification_ur | exception | error | oauth, xai, device-flow, validation |
| xAI device authorization returned a non-https verification_u | exception | error | oauth, xai, device-flow, security |
| xAI token response missing access_token | exception | error | oauth, xai, response-validation |
| xAI token response missing refresh_token | exception | error | oauth, xai, response-validation |
| Failed to initiate xAI device authorization: ${response.stat | exception | error | oauth, xai, device-flow, http |
| xAI device authorization response missing required fields | exception | error | oauth, xai, device-flow, response-validation |
| xAI token refresh failed: ${response.status}${text ? ` ${tex | exception | error | oauth, xai, token-refresh, http |
| Unknown OAuth provider: ${providerId} | exception | error | oauth, configuration, provider-registry |
| configDirName must be a non-empty directory name | validation | error | configuration, validation, argument-error |
| configDirName must be a single directory name without path s | validation | error | configuration, validation, path-traversal |
| No thread ID available. Start a session before building eval | exception | error | evals, session, precondition |
| --continue and --thread cannot be used together | validation | error | cli, argument-parsing, conflicting-flags |
| ${flag} must be one of: ${allowed.join(', ')} | validation | warning | cli, validation, enum |
| ${flag} must be a positive integer | validation | warning | cli, validation, numeric |
| storageBackend is required when injecting a custom storage i | exception | error | storage, configuration, dependency-injection |
| crossProcessPubSub requires a pubsub instance | exception | error | configuration, pubsub, signals |
| MastraCode requires at least one mode | exception | error | configuration, modes, startup |
unavailable Knowledge record has no scope. | error_code | error | knowledge, data-integrity, rendering |
stale-handle Knowledge scope changed while the request was running. | error_code | error | knowledge-inspector, race-condition, stale-state |
not-visible Knowledge record is not visible in the selected scope. | error_code | error | knowledge-inspector, access-control, scope |
invalid-handle Knowledge record handle is invalid or expired. | error_code | error | knowledge-inspector, expired-token, opaque-handle |
invalid-cursor Knowledge cursor does not match the active scope and filters. | error_code | error | knowledge-inspector, pagination, cursor-mismatch |
| Failed to spawn LSP server | exception | error | lsp, spawn-failure, process |
| Failed to create LSP process with proper stdio | exception | error | lsp, stdio, process |
| Unsupported browser provider: ${provider} | exception | error | browser, configuration, unsupported-provider |
| Mastra Code requires Corepack to install GitHub plugin depen | exception | error | corepack, missing-binary, plugins, environment |
| Plugin at ${pluginRoot} must declare an exact pnpm version i | validation | error | pnpm, package-json, configuration, plugins |
| Local plugin path does not exist or is not a directory: ${lo | validation | error | filesystem, plugins, path-validation, local-install |
| Plugin entry must be inside the plugin directory | validation | error | path-traversal, plugins, configuration, security |
| Plugin entry must be a .ts file | validation | error | plugins, typescript, configuration |
| Plugin entry file does not exist: ${explicitEntry} | validation | error | filesystem, plugins, configuration |
| Could not find a plugin entry file. Tried: ${ENTRY_CANDIDATE | exception | error | plugins, filesystem, convention, configuration |
| GitHub CLI is required to install GitHub plugins. Install gh | exception | error | github-cli, missing-binary, environment, plugins |
| GitHub CLI is not authenticated. Run gh auth login, then ins | exception | error | github-cli, authentication, plugins, environment |
| Invalid GitHub URL: ${specifier} | validation | error | plugin-install, url-validation, github |
| Only github.com plugin URLs are supported | validation | error | plugin-install, url-validation, github, unsupported-host |
| GitHub plugin URL must be in the form https://github.com/own | validation | error | plugin-install, url-validation, github |
| GitHub owner and repo may only contain letters, numbers, dot | validation | error | plugin-install, validation, github, sanitization |
| Plugin id mismatch: registry has "${record.id}" but module e | validation | error | plugin-loading, registry, id-mismatch, consistency |
| Plugin path for "${record.id}" must be inside the ${record.s | validation | error | security, path-traversal, plugin-loading, registry |
| Plugin entry for "${record.id}" must be inside the plugin di | validation | error | security, path-traversal, plugin-loading, registry |
| Unsupported plugin entry extension "${path.extname(entryPath | validation | error | plugin-loading, typescript, entry-point, validation |
| Plugin module must export a plugin object as default or name | validation | error | plugin-loading, module-exports, typescript, validation |
| Plugin instructions must be a string | validation | error | plugin, type-validation, sdk |
| Plugin tool "${name}" must be an object with a tool property | validation | error | plugin, tools, shape-validation, sdk |
| Plugin tool "${toolName}" is no longer available | exception | error | plugin, hot-reload, stale-reference, tools |
| Plugin "${pluginId}" is not installed in ${scope} scope | validation | error | plugin, registry, scope-mismatch, state |
| Could not parse ${PLUGIN_MANIFEST_FILE}: ${error instanceof | exception | error | json, manifest, parse-error, config |
| ${PLUGIN_MANIFEST_FILE} must contain a plugins array | validation | error | manifest, schema-validation, config, shape-mismatch |
| ${PLUGIN_MANIFEST_FILE} contains multiple plugins. Provide a | validation | error | manifest, ambiguity, multiple-plugins, config |
| ${PLUGIN_MANIFEST_FILE} plugin at index ${index} must be an | validation | error | manifest, schema-validation, type-mismatch, config |
| ${PLUGIN_MANIFEST_FILE} plugin at index ${index} must includ | validation | error | plugin-manifest, validation, configuration |
| ${PLUGIN_MANIFEST_FILE} plugin ${candidate.id} must include | validation | error | plugin-manifest, validation, configuration |
| ${PLUGIN_MANIFEST_FILE} plugin ${candidate.id} name must be | validation | error | plugin-manifest, validation, types |
| Could not find mastracode package root from ${startDir} | exception | error | filesystem, package-resolution, plugins |
| Directory already exists and is not empty: ${targetDir} | exception | error | filesystem, scaffold, conflict |
| ${name} must be an integer ${range}; received ${JSON.stringi | validation | warning | configuration, env-vars, validation |
| GC event buffer exceeded ${MAX_PENDING_GC_EVENTS} records be | exception | warning | gc, buffer-overflow, diagnostics |
| One or more process memory diagnostic artifact writes failed | exception | error | filesystem, disk-full, permissions, diagnostics |
| Inspector session is unavailable. | exception | error | inspector, state-error, allocation-sampling |
| Diagnostics output directory is unavailable. | exception | error | state-error, diagnostics, initialization |
| Allocation sampling is not active. | exception | error | inspector, heap-profiler, state-error, diagnostics |
| ${this.latestError} | exception | error | inspector, cdp, heap-profiler, network |
| Allocation sampling did not restart. | exception | error | inspector, heap-profiler, state-error, restart |
| models.dev returned ${response.status} | http | error | network, http, api-outage |
| Anthropic API key credential is configured, but OAuth is req | exception | error | auth, oauth, configuration |
| Not logged in to Anthropic. | exception | error | auth, oauth, not-authenticated |
| Not logged in to GitHub Copilot. | exception | error | auth, oauth, github-copilot |
| Failed to refresh the GitHub Copilot token. | exception | error | auth, oauth, token-refresh |
| No Copilot bearer token | exception | warning | auth, oauth, github-copilot, token-refresh |
| Not logged in to Kimi For Coding. | exception | error | auth, oauth, kimi, login-required |
| Kimi For Coding credentials are invalid. Please reconnect th | exception | error | auth, oauth, kimi, corrupt-credentials |
| Failed to refresh the Kimi For Coding token. | exception | error | auth, oauth, kimi, token-refresh |
| Not logged in to OpenAI Codex. | exception | error | auth, oauth, openai-codex, login-required |
| Failed to refresh the OpenAI Codex token. | exception | error | auth, oauth, openai-codex, token-refresh |
| Codex streaming response had no body | exception | error | streaming, network, openai-codex, response-body |
| Codex stream error: ${JSON.stringify(payload.error ?? payloa | exception | error | streaming, network, openai-codex, server-error |
| Not logged in to xAI. | exception | error | auth, oauth, xai, login-required |
| Failed to refresh the xAI token. | exception | error | auth, oauth, xai, token-refresh |
| Parallel ${operation} returned no output | exception | error | web-search, empty-result, tool-output |
| ${output.message} | exception | error | web-search, schema-validation, tool-output |
| create-workflow requires a Mastra context. | exception | error | mastra-context, misconfiguration, workflows |
| The "workflow-builder" sub-agent is not registered on this M | exception | error | mastra-context, agent-registration, workflows |
| create-workflow failed: save-workflow threw ${saveErrors.len | exception | error | workflows, persistence, sub-agent |
| create-workflow failed: the workflow-builder sub-agent never | exception | error | workflows, sub-agent, missing-tool-call |
| create-workflow failed: save-workflow was called but did not | exception | error | workflows, persistence, sub-agent |
| delete-workflow requires a Mastra context. | exception | error | mastra-context, misconfiguration, workflows |
| get-workflow requires a Mastra context. | exception | error | mastra-context, misconfiguration, workflows |
| No workflow with id "${id}". | exception | error | workflows, not-found, storage |
| list-available-agents requires a Mastra context. | exception | error | mastra, configuration, runtime-context, tools |
| list-available-tools requires a Mastra context. | exception | error | mastra, configuration, runtime-context, tools |
| list-available-workflows requires a Mastra context. | exception | error | mastra, configuration, runtime-context, workflows |
| list-workflows requires a Mastra context. | exception | error | mastra, configuration, runtime-context, workflows |
| run-workflow requires a Mastra context. | exception | error | mastra, configuration, runtime-context, workflows |
| save-workflow requires a Mastra context. | exception | error | mastra, tool-context, workflow, configuration |
| Invalid resourceId: ${resourceId} | validation | error | path-traversal, validation, filesystem, security |
| SignalsPubSub is closed | exception | error | pubsub, lifecycle, unix-socket, use-after-close |
| ${file} is in use by another process — is another Mastra Cod | exception | error | sqlite, concurrency, file-lock, vacuum |
| Not enough free disk space to compact ${file}: need ${format | exception | error | disk-space, sqlite, vacuum, filesystem |
| ${file} was opened by another process during compaction — is | exception | error | sqlite, concurrency, race-condition, vacuum |
| Failed to swap compacted copy into place AND failed to resto | exception | critical | sqlite, filesystem, data-loss-risk, rename |
| ThreadLockError(threadId, ownerPid) | exception | error | concurrency, locking, process, pid |
| Storage is not configured on the Mastra instance. | exception | error | configuration, storage, mastra |
| workflowDefinitions storage domain is not available. | exception | error | storage, mastra, version-mismatch, configuration |
| No workflow registered with id "${workflowId}". Was it built | exception | error | workflow, mastra, not-found, lookup |
| Missing value for ${flag} | exception | error | cli, arguments, parsing, tui |
| Could not save the ${modeId} mode model | exception | error | persistence, settings, storage, tui |
| Could not save the active model pack | exception | error | persistence, settings, race-condition, storage |
| VoiceCredentialError(entry.provider) | exception | error | credentials, authentication, voice, api-key |
| ${name} must contain base64-encoded 32-byte keys. | exception | critical | configuration, encryption, env-var, security |
| FACTORY_CREDENTIAL_ENCRYPTION_PREVIOUS_KEYS must be a JSON o | exception | critical | configuration, encryption, env-var, json |
| FACTORY_CREDENTIAL_ENCRYPTION_PREVIOUS_KEYS values must be b | exception | error | configuration, environment-variables, encryption, startup |
| DATABASE_URL is required outside local development and tests | exception | critical | configuration, environment-variables, database, startup, postgres |
OBSERVABILITY_INVALID_CONFIG Invalid observability configuration: ${errorMessages} | validation | error | configuration, schema-validation, observability, zod |
OBSERVABILITY_INVALID_INSTANCE_CONFIG Invalid configuration for observability instance '${name}': ${errorMessages} | validation | error | configuration, schema-validation, observability, zod |
| AuthFailureError(authFailureStatus, error) | exception | error | authentication, http, network, observability, exporter |
| Snapshot functionality requires a Node.js environment. impor | exception | error | nodejs, runtime, snapshots, environment |
| getMetricsByType() has been removed: metricType is no longer | exception | error | deprecated, removed-api, metrics, migration |
| Snapshot file not found: ${snapshotPath} Run with { updateSn | exception | error | snapshots, missing-file, filesystem, ci |
| Failed to parse snapshot ${snapshotPath}: ${err instanceof E | exception | error | snapshots, json-parse, corrupt-file, filesystem |
| Invalid snapshot format in ${snapshotPath}. Expected an arra | exception | error | snapshots, schema-validation, format, filesystem |
| Structure mismatch in snapshot: Expected: ${expectedStructu | exception | error | testing, snapshot, observability, spans |
| Snapshot has ${mismatches.length} mismatch${mismatches.lengt | exception | error | testing, snapshot, deep-equality, spans |
| Unable to locate pricing data JSONL at any known path: ${can | exception | critical | filesystem, configuration, missing-file, observability |
| Tracing instance '${name}' already registered | exception | error | configuration, registry, duplicate-key, tracing |
| SpanConverter not initialized correctly | exception | critical | opentelemetry, initialization, tracing, lifecycle |
| Input data not found | exception | error | workflow, input-validation, agent-builder |
| Location '${inputData.city}' not found | exception | error | network, external-api, geocoding |
| Forecast data not found | exception | error | workflow, input-validation, data-mapping |
| Weather agent not found | exception | error | configuration, dependency-injection, agent-builder |
| Failed to run install command with swpm and native package m | exception | error | package-manager, process-spawn, install |
| Failed to fetch Mastra templates: ${error instanceof Error ? | exception | error | network, http, external-api |
| Template "${slug}" not found. Available templates: ${templat | exception | error | lookup, not-found, input-validation |
| Invalid model provided. Model must be a MastraLanguageModel | exception | error | typescript, type-guard, configuration |
| Repository URL or path is required | exception | error | input-validation, workflow, git |
| No Mastra units (agents, workflows, tools) found in template | exception | error | template-analysis, empty-result, workflow |
| Failed to parse existing package.json at ${targetPkgPath}: $ | exception | error | json, parse, template-builder, filesystem |
| Critical failure in clone step: ${cloneResult.error} | exception | critical | git, clone, workflow, template-builder |
| Failure in analyze package step: ${analyzeResult.error || 'P | exception | error | workflow, template-builder, analysis |
| Failure in discover units step: ${discoverResult.error || 'U | exception | error | workflow, template-builder, discovery |
| Failure in install step: ${installResult.error || 'Install f | exception | error | install, dependencies, workflow, template-builder |
| Failed to initialize task manager: ${taskManagerResult.messa | exception | error | task-manager, workflow-builder, agent |
| No result received from agent execution on iteration ${itera | exception | error | agent, streaming, structured-output, workflow-builder |
| No result received from agent execution | exception | error | agent, workflow-builder, streaming |
| JWT auth secret is required | exception | critical | jwt, auth, config, env |
| Invalid token | exception | error | jwt, auth, token, decoding |
| Invalid token payload | exception | error | jwt, auth, token-payload, validation |
| Invalid token header | exception | error | jwt, auth, missing-claim, issuer |
HTTP_ERROR HTTP_ERROR: Request failed with status ${response.status} | error_code | error | http, cli, api-error, network |
REQUEST_TIMEOUT REQUEST_TIMEOUT: Request timed out after ${options.timeoutMs}ms | error_code | error | network, timeout, cli, http |
MISSING_ARGUMENT MISSING_ARGUMENT: Missing required argument <${name}> | error_code | error | cli, argument-validation, url |
MALFORMED_HEADER MALFORMED_HEADER: Header must use "Key: Value" format | error_code | error | cli, http-headers, input-validation |
MISSING_INPUT MISSING_INPUT: Command requires a single inline JSON input argument | error_code | error | cli, input-validation, json |
INVALID_JSON INVALID_JSON: Input JSON must be an object | error_code | error | json, cli, input-validation |
MISSING_ARGUMENT MISSING_ARGUMENT: Missing required argument <${name}> | error_code | error | cli, arguments, missing-argument |
SCHEMA_UNAVAILABLE SCHEMA_UNAVAILABLE: This command does not accept JSON input | error_code | warning | cli, schema, unsupported-operation |
SERVER_UNREACHABLE Could not connect to target server | error_code | error | network, cli, connectivity |
PLATFORM_RESOLUTION_FAILED Could not resolve platform deployment URL | error_code | error | platform, configuration, deployment |
| Session expired. Run: mastra auth login | exception | error | cli, auth, http-401, session |
| detail | exception | error | cli, api, server-error, http |
| ${message}: ${status} | exception | error | cli, api, http-status, fallback |
| No credentials | exception | error | cli, auth, credentials, refresh |
| Refresh failed | exception | error | cli, auth, refresh-token, session |
| Not logged in | exception | error | cli, auth, credentials, org |
| auth callback rejected (invalid state/token); 400 HTML failu | http | error | cli, auth, oauth, csrf, login-flow |
| Not logged in. Run `mastra auth login` interactively or set | exception | error | cli, auth, non-interactive, ci, env-var |
| Session expired. Run `mastra auth login` interactively or se | exception | error | cli, auth, session-expired, refresh-token, non-interactive |
| No access to organization ${orgId}. Run: mastra auth orgs | exception | error | cli, auth, organization, permissions, rbac |
| The --empty and --template options can't be used together | validation | error | cli, input-validation, flag-conflict |
| The --llm option can only be used with the default template | validation | error | cli, input-validation, flag-conflict, llm-provider |
| The --llm-api-key option can only be used with the default t | validation | error | cli, input-validation, flag-conflict, api-key |
| Project name must be 1-214 lowercase characters, start with | validation | error | cli, validation, naming, filesystem |
| CreateCancelledError (Operation cancelled) | exception | info | cli, cancellation, sigint, control-flow |
| CreateCancelledError | exception | info | cli, cancellation, interactive-prompt, sigint |
| A file or directory named "${projectName}" already exists. P | exception | error | cli, filesystem, conflict, already-exists |
| Operation terminated by SIGTERM | exception | error | cli, sigterm, process-termination, interruption |
| Invalid GitHub URL format | validation | error | cli, github, url-validation, template |
| No template selected | exception | error | cli, template, input-validation, programmatic-api |
| Invalid Mastra project | exception | error | cli, validation, github, scaffold |
| Invalid GitHub repository URL. Use https://github.com/<owner | validation | error | cli, url-validation, github |
| Template "${template}" not found | exception | error | cli, template, not-found, argument |
| Database not found: ${dbArg}. List databases with: mastra en | exception | error | cli, database, not-found, cloud |
| Environment not found: ${envArg}. List environments with: ma | exception | error | cli, environment, not-found, cloud |
| Unsupported database kind: ${kind}. Supported kinds: turso, | exception | error | cli, validation, argument, database |
| Cannot combine an environment argument with --shared. Pick o | exception | error | cli, argument-conflict, validation |
| Project ${project.name} has no environments. Create one with | exception | error | cli, environment, prerequisite, cloud |
| Project ${project.name} has multiple environments (${slugs}) | exception | error | cli, ambiguity, non-interactive, environment |
| You need the admin role in this organization to manage datab | exception | error | authorization, permissions, http-403, cli |
| Database provisioning failed${db.error ? `: ${db.error}` : ' | exception | error | provisioning, cloud-provider, polling, cli |
| Database was ${db.status === 'deleted' ? 'deleted' : 'schedu | exception | error | provisioning, race-condition, polling, lifecycle |
| Timed out waiting for database to become ready (last status: | exception | error | timeout, provisioning, polling, cli |
| You have no organizations. Please create one at ${MASTRA_STU | exception | error | onboarding, configuration, cli, deploy |
| Found ${projects.length} existing project(s) in this organiz | exception | error | configuration, deploy, ambiguity, cli |
| Could not determine project name from package.json. Use --pr | exception | error | configuration, package-json, deploy, cli |
| Failed to create deploy: ${(err as { detail?: string }).deta | exception | error | http, api, deploy, upload |
| Failed to upload artifact: ${uploadResp.statusText} | exception | error | upload, network, http, artifact |
| Failed to complete upload: ${(err as { detail?: string }).de | exception | error | http, api, deploy, finalization |
| Poll failed: ${err.detail || resp.statusText} | exception | error | network, http, deploy, polling |
| Deploy timed out | exception | error | timeout, deploy, polling |
| MASTRA_ORG_ID and MASTRA_PROJECT_ID are required when MASTRA | exception | error | environment, configuration, cli, ci |
| .mastra/output/index.mjs not found — did the build succeed? | exception | error | build, deploy, filesystem, cli |
| Directory not found: ${dirArg}.${hint} | exception | error | cli, filesystem, argument-validation, deploy |
LOCALHOST_ENV_VAR LOCALHOST_ENV_VAR: ${name} in the env file being deployed points at localhost ($ | error_code | warning | deploy, env-var, localhost, database, preflight |
MISSING_ENV_VAR MISSING_ENV_VAR: Build references ${name} but the env file being deployed does n | error_code | warning | deploy, env-var, database, missing-config, preflight |
LOCAL_STORAGE_PATH LOCAL_STORAGE_PATH: Build contains a host-local storage URL: ${truncate(d.value, | error_code | error | deploy, storage, localhost, hardcoded-config, preflight |
| Diagnosis polling timed out after 5 minutes. Please try agai | exception | error | network, timeout, polling, deployment |
| Server failed to start | exception | error | dev-server, child-process, startup-failure |
| Server failed to start with error: ${currentServerProcess.st | exception | error | cli, dev-server, process-exit, startup |
| Project not found: ${wanted} | exception | error | cli, config, project-lookup, mastra-cloud |
| No project specified. Pass --project <name|slug|id>, set MAS | exception | error | cli, config, missing-argument, mastra-cloud |
| No environments found for this project. Deploy first with `m | exception | error | cli, mastra-cloud, deploy, empty-state |
| Multiple environments found (${slugs}). Specify one: mastra | exception | error | cli, mastra-cloud, ambiguity, environments |
| Environment not found: ${envArg} | exception | error | cli, environment-resolution, user-input |
| Refusing to overwrite ${target}. Re-run with --force to repl | exception | error | cli, filesystem, safety-guard |
| Mastra configuration initialization created or modified unex | exception | error | build, determinism, side-effects |
| #mastra does not provide an export named 'mastra' | exception | critical | runtime, module-exports, experiment-worker |
| Experiment worker artifacts cannot contain absolute symlinks | exception | error | build, symlink, portability |
| Experiment worker artifacts cannot contain escaping symlinks | exception | error | build, symlink, security |
| Unsupported artifact file type: ${artifactPath} | exception | error | build, filesystem, artifact-integrity |
| Output directory must not be the project root or contain the | exception | error | build, cli, path-validation |
| stdout backpressure exceeded the experiment deadline | exception | error | streaming, backpressure, timeout |
| ${error.message} | exception | error | streaming, protocol, backpressure |
| Experiment emitted multiple terminal semantic events | exception | error | experiment, runtime, streaming, lifecycle |
| defaultProjectName is required when mode is "create" | exception | error | cli, init, configuration, observability |
| Cancelled | exception | warning | cli, interactive, user-cancellation, prompt |
| Failed to list projects (${res.status}) | exception | error | network, api, authentication, http |
| Failed to create project (${res.status}) | exception | error | network, api, http, project-creation |
| Failed to create access token (${res.status}) | exception | error | network, api, authentication, http |
MISSING_MASTRA_CORE MISSING_MASTRA_CORE | error_code | error | lint, dependencies, missing-package, configuration |
NEXT_MISSING_SERVER_EXTERNAL_PACKAGES NEXT_MISSING_SERVER_EXTERNAL_PACKAGES | error_code | error | lint, nextjs, configuration, bundler |
MISSING_TSCONFIG MISSING_TSCONFIG | error_code | warning | typescript, config, lint, cli |
INVALID_TSCONFIG INVALID_TSCONFIG | error_code | error | typescript, config, lint, module-resolution |
| Failed to create directory: ${errorMessage} | exception | error | filesystem, permissions, cli, directory |
| Skipped: Scorer ${filename} already exists at ${scorersPath} | exception | error | filesystem, duplicate, cli, conflict |
| Failed to write scorer: ${errorMessage} | exception | error | filesystem, permissions, cli, write |
| No deploys found for linked Server project ${project.name}. | exception | error | cli, deploy, server, api |
| Env file not found: ${options.envFile} | exception | error | env, filesystem, cli, deploy |
| No env file found for deploy. Add a .env or .env.* file befo | exception | error | env, deploy, cli, configuration |
| Multiple env files found: ${availableDeployEnvFiles.join(', | exception | error | env, deploy, cli, ambiguity |
| No organizations found. Create one at ${MASTRA_STUDIO_URL} | exception | error | auth, deploy, cli, organization |
| Could not determine project name from package.json. Use --pr | exception | error | cli, config, project-resolution |
| Found ${existing.length} existing project(s) in this organiz | exception | error | cli, ci, ambiguous-selection |
| MASTRA_ORG_ID and MASTRA_PROJECT_ID (or --org/--project flag | exception | error | cli, ci, env-vars, headless |
| .mastra/output/index.mjs not found — did the build succeed? | exception | error | cli, build, filesystem, artifact |
| No organization selected. Run: mastra auth orgs switch | exception | error | cli, auth, organization, env-vars |
| No linked project found. Deploy first with `mastra server de | exception | error | cli, config, project-linking |
| Could not read file: ${filePath} | exception | error | cli, filesystem, env-file |
| No upload URL returned | exception | error | api, upload, contract-mismatch |
| Artifact upload failed: ${uploadResp.status} ${uploadResp.st | exception | error | network, upload, http, storage |
| Deploy timed out | exception | error | timeout, polling, build, ci |
| Restart was accepted but no deploy ID could be resolved. Che | exception | error | cli, deploy, platform, timeout |
| Output directory ${outputPath} does not exist | exception | error | cli, filesystem, missing-directory, build |
| Failed to fetch logs: ${error.detail} | exception | error | cli, api, logs, network |
| Failed to stream logs: ${resp.status} — ${text} | http | error | cli, streaming, sse, network |
| No response body for log stream | exception | error | cli, streaming, sse, runtime |
| No deploys found for linked Studio project ${linkedProject.n | exception | error | cli, studio, deploy, missing-deploy |
| Linked Studio project ${linkedProjectId} was not found in th | exception | error | cli, studio, config, missing-project |
| No previous studio deploy found. Pass a deploy ID or deploy | exception | error | cli, studio, deploy, missing-deploy |
| Env file not found: ${options.envFile} | exception | error | cli, filesystem, env, deploy |
| No env file found for deploy. Add a .env or .env.* file befo | exception | error | cli, env, deploy, configuration |
| Multiple env files found: ${availableDeployEnvFiles.join(', | exception | error | cli, env-files, configuration |
| You have no organizations. Please create one at ${MASTRA_STU | exception | error | cli, auth, organization |
| Found ${projects.length} existing project(s) in this organiz | exception | error | cli, configuration, project-resolution |
| Could not determine project name from package.json. Use --pr | exception | error | cli, package-json, configuration |
| MASTRA_ORG_ID and MASTRA_PROJECT_ID are required when MASTRA | validation | critical | cli, env-vars, headless, ci |
| .mastra/output/index.mjs not found — did the build succeed? | exception | error | cli, build, filesystem |
| No upload URL returned | exception | critical | api, network, cli |
| Artifact upload failed: ${uploadResp.status} ${uploadResp.st | http | critical | network, upload, http |
| Deploy timed out | exception | error | network, timeout, polling |
| Choose a valid value: ${EDITOR.join(', ')} | validation | warning | cli, argument-validation, commander |
| Choose valid components: ${COMPONENTS.join(', ')} | validation | error | cli, argument-validation, commander |
| Choose a valid provider: ${LLMProvider.join(', ')} | validation | error | cli, argument-validation, llm-provider |
| Invalid ENV key: ${key} | validation | error | env, validation, cli-services |
| Invalid ENV value for ${key}: multiline values are not suppo | validation | error | env, validation, cli-services |
| Missing required file, checked the following paths: ${files. | exception | error | filesystem, missing-file, cli |
| Directory ${projectName} already exists | exception | error | filesystem, cli, directory-exists, scaffolding |
| degit completed without cloning template files | exception | error | network, degit, cloning, scaffolding |
| Failed to clone repository: ${gitError instanceof Error ? gi | exception | error | git, network, cloning, scaffolding |
| Failed to fetch templates: ${response.statusText} | http | error | network, http, api, cli |
| Failed to load templates. Please check your internet connect | exception | error | network, http, cli, offline |
| Presets file not found: ${absolutePath} | exception | error | cli, filesystem, config, file-not-found |
| Invalid JSON in presets file: ${presetsPath} | validation | error | cli, json, config, parse-error |
| Presets file must contain a JSON object with named presets | validation | error | cli, json, config, schema-validation-failed |
| Preset "${key}" must be a JSON object | validation | error | cli, json, config, schema-validation-failed |
${error.code} ${error.message} (remote JSON-RPC error, code ${error.code}) | exception | error | a2a, network, json-rpc, remote-agent |
AGENT_GENERATE_LEGACY_STRUCTURED_OUTPUT_NOT_SUPPORTED This method does not support structured output. Please use generate() instead. | error_code | error | agent, deprecated-api, structured-output, migration |
AGENT_GENERATE_V2_MODEL_NOT_SUPPORTED Models with specificationVersion "${specVersion}" are not supported for generate | error_code | error | agent, model-spec, deprecated-api, migration |
AGENT_STREAM_V2_MODEL_NOT_SUPPORTED Models with specificationVersion "${specVersion}" are not supported for streamLe | error_code | error | agent, streaming, model-spec, deprecated-api, migration |
AGENT_REQUEST_CONTEXT_VALIDATION_FAILED Request context validation failed for agent '${this.id}':
${errorMessages} | error_code | error | agent, request-context, validation, zod |
| Could not generate title from input ${JSON.stringify(message | exception | error | agent, memory, title-generation, invalid-input |
| Either message or messages must be provided | exception | error | agent, title-generation, missing-input, validation |
AGENT_INPUT_PROCESSOR_ERROR [Agent:${this.name}] - Input processor error | error_code | error | agent, input-processor, user-code, mastra-error |
AGENT_INPUT_STEP_PROCESSOR_ERROR [Agent:${this.name}] - Input step processor error | error_code | error | agent, step-processor, user-code, mastra-error |
AGENT_DELEGATION_HOOK_FAILED AGENT_DELEGATION_HOOK_FAILED | error_code | error | agent, delegation, lifecycle-hook, multi-agent, fail-closed |
| Sub-agent ${agent.id} returned a v1 model but does not imple | exception | error | agent, delegation, sub-agent, model-version, v1-legacy, compatibility |
| Sub-agent ${agent.id} returned a v1 model but does not imple | exception | error | agent, delegation, sub-agent, streaming, model-version, v1-legacy |
AGENT_GENEREATE_SCORER_NOT_FOUND Mastra not found when fetching scorer. Make sure to fetch agent from mastra.getA | error_code | error | agent, scorer, mastra-instance, configuration |
AGENT_RESUME_NO_SNAPSHOT_FOUND Agent "${this.name}" ${method}() could not find a suspended run for runId "${run | error_code | error | agent, resume, suspend, workflow-snapshot, storage, runid |
AGENT_RESUME_TOOL_CALL_NOT_SUSPENDED Agent "${this.name}" ${method}() cannot resume tool call "${toolCallId}" because | error_code | error | agent, resume, tool-call, suspend, state, runid |
AGENT_GENERATE_V1_MODEL_NOT_SUPPORTED Agent "${this.name}" is using AI SDK v4 model (${provider}:${modelId}) which is | error_code | error | ai-sdk, version-mismatch, agent, generate |
AGENT_GENERATE_FAILED AGENT_GENERATE_FAILED | error_code | error | agent, generate, execution-failed, wrapped-error |
AGENT_GENERATE_UNKNOWN_ERROR An unknown error occurred while streaming | error_code | error | agent, generate, unknown-status, internal |
AGENT_GENERATE_MALFORMED_RESULT Execution workflow produced a result without getFullOutput | error_code | error | agent, generate, internal, contract-violation |
AGENT_LIST_SUSPENDED_RUNS_INVALID_PER_PAGE Agent "${this.name}" listSuspendedRuns() requires perPage to be a positive integ | error_code | error | agent, validation, pagination, input-validation |
AGENT_LIST_SUSPENDED_RUNS_INVALID_PAGE Agent "${this.name}" listSuspendedRuns() requires page to be a non-negative inte | error_code | error | agent, validation, pagination, input-validation |
AGENT_LIST_SUSPENDED_RUNS_NO_STORAGE Agent "${this.name}" listSuspendedRuns() requires storage to discover suspended | error_code | error | agent, storage, configuration, suspended-runs |
| sendNotificationSignal requires a notifications storage doma | exception | error | agent, storage, notifications, configuration |
AGENT_STREAM_V1_MODEL_NOT_SUPPORTED Agent "${this.name}" is using AI SDK v4 model (${provider}:${modelId}) which is | error_code | error | ai-sdk, version-mismatch, agent, streaming |
AGENT_STREAM_FAILED AGENT_STREAM_FAILED | error_code | error | agent, streaming, execution-failed, wrapped-error |
AGENT_STREAM_UNKNOWN_ERROR An unknown error occurred while streaming | error_code | error | agent, streaming, unknown-status, mastra-core |
AGENT_SEND_STREAM_RESUME_MISSING_TARGET sendStreamResume() requires threadId, resourceId, and runId. | error_code | error | agent, streaming, validation, missing-argument |
AGENT_SEND_STREAM_RESUME_NO_SUSPENDED_THREAD_RUN Agent "${this.name}" sendStreamResume() could not find a suspended run "${runId} | error_code | error | agent, streaming, resume, state-not-found |
AGENT_SEND_TOOL_APPROVAL_AMBIGUOUS_SUSPENDED_RUNS Agent "${this.name}" sendToolApproval() found ${matchingRuns.length} suspended r | error_code | error | agent, tool-approval, ambiguity, user-input, suspended-run |
AGENT_SEND_TOOL_APPROVAL_NO_ACTIVE_THREAD_RUN Agent "${this.name}" sendToolApproval() could not find an active or suspended ru | error_code | error | agent, tool-approval, no-active-run, state-not-found, user-input |
AGENT_DURABLE_METHOD_NOT_AVAILABLE Agent.${method}() is only available on agents constructed with `durable: true`. | error_code | error | agent, durable, configuration, api-misuse, user-input |
DURABLE_AGENT_RECOVER_ALREADY_IN_PROGRESS DurableAgent "${this.name}" recover(${runId}): another process is already recove | error_code | error | durable-agent, recovery, concurrency, lease, duplicate-work |
DURABLE_AGENT_RECOVER_LEASE_ACQUIRE_FAILED DurableAgent "${this.name}" recover(${runId}): failed to acquire the recovery le | error_code | error | durable-agent, recovery, lease, network, backend, system |
DURABLE_AGENT_RECOVER_SNAPSHOT_NOT_FOUND DurableAgent "${this.name}" recover(${runId}): no persisted workflow snapshot fo | error_code | error | durable-agent, recovery, snapshot, storage, state-not-found |
DURABLE_AGENT_RECOVER_INVALID_SNAPSHOT DurableAgent "${this.name}" recover(${runId}): persisted snapshot does not conta | error_code | error | durable-agent, recovery, snapshot, schema-mismatch, data-corruption |
DURABLE_AGENT_RECOVER_AGENT_MISMATCH DurableAgent "${this.name}" recover(${runId}): persisted run belongs to agent "$ | error_code | error | durable-agent, recovery, ownership, agent-mismatch, user-input |
| No registry entry found for run ${runId}. Cannot resume. | exception | error | durable-agent, resume, not-found, storage |
| This workflow run was not suspended | exception | error | durable-agent, resume, workflow-state |
DURABLE_AGENT_RESUME_INVALID_SNAPSHOT DurableAgent "${this.name}" resume(${runId}): persisted snapshot does not contai | error_code | error | durable-agent, snapshot, schema-mismatch |
DURABLE_AGENT_RESUME_AGENT_MISMATCH DurableAgent "${this.name}" resume(${runId}): persisted run belongs to agent "${ | error_code | error | durable-agent, resume, ownership, agent-mismatch |
| Failed to rehydrate registry entry for run ${runId}. Cannot | exception | error | durable-agent, resume, rehydration, registry |
DURABLE_AGENT_RECOVER_NO_MASTRA DurableAgent "${this.name}" recover() requires the agent to be registered on a M | error_code | error | durable-agent, recover, configuration |
DURABLE_AGENT_RECOVER_NO_STORAGE DurableAgent "${this.name}" recover() requires persistent storage to load the ru | error_code | error | durable-agent, recover, storage, configuration |
| (result as any).error?.message || 'Workflow recover failed' | exception | error | durable-agent, recover, workflow-failed, error-wrapping |
| resumeStream() on DurableAgent requires a runId in streamOpt | exception | error | durable-agent, resume-stream, arguments |
DURABLE_AGENT_LIST_ACTIVE_RUNS_INVALID_PER_PAGE DurableAgent "${this.name}" listActiveRuns() requires perPage to be a positive i | error_code | warning | durable-agent, pagination, validation, arguments |
DURABLE_AGENT_LIST_ACTIVE_RUNS_INVALID_PAGE DurableAgent "${this.name}" listActiveRuns() requires page to be a non-negative | error_code | error | pagination, validation, user-input |
DURABLE_AGENT_LIST_ACTIVE_RUNS_NO_STORAGE DurableAgent "${this.name}" listActiveRuns() requires storage to discover runnin | error_code | error | storage, configuration, missing-dependency |
| Agent model not available | exception | critical | model, configuration, durable-agent |
| Model ${config.provider}/${config.modelId} is a metadata-onl | exception | error | model, serialization, run-registry, resume |
| No enabled models available for execution | exception | critical | model, configuration, durable-agent, fallback |
| Unsupported model version: ${(model as any).specificationVer | exception | error | model, compatibility, durable-agent, ai-sdk |
AGENT_FS_ROUTING_MODEL_REQUIRED Agent "${name}": missing model in config.ts and no default. Provide a 'model' in | error_code | error | fs-routing, configuration, model |
AGENT_FS_ROUTING_SUBAGENT_SCHEDULES_UNSUPPORTED Agent "${name}": schedules are only supported on root agents, but agents/.../sub | error_code | error | fs-routing, schedules, configuration |
AGENT_FS_ROUTING_SCHEDULE_NAME_COLLISION Agent "${name}": duplicate schedule "${key}" under agents/${name}/schedules/. Tw | error_code | error | fs-routing, schedules, duplicate-key |
AGENT_FS_ROUTING_INSTRUCTIONS_REQUIRED Agent "${name}": missing instructions. Provide agents/${name}/instructions.md, a | error_code | error | fs-routing, configuration, instructions |
AGENT_FS_ROUTING_INSTRUCTIONS_INVALID Agent "${name}": agents/${name}/instructions.ts must default-export a string, a | error_code | error | agent, filesystem-routing, instructions, config |
AGENT_FS_ROUTING_SUBAGENT_NAME_COLLISION Agent "${name}": duplicate subagent "${childId}" under agents/${name}/subagents/ | error_code | error | agent, subagents, naming-collision, filesystem-routing |
AGENT_FS_ROUTING_SUBAGENT_DESCRIPTION_REQUIRED Agent "${name}": subagent "${childId}" requires a non-empty 'description'. Set o | error_code | error | agent, subagents, validation, config |
AGENT_MEMORY_THREAD_RESOURCE_MISMATCH Thread "${thread.id}" belongs to resource "${thread.resourceId}" but resource "$ | error_code | error | memory, threads, multi-tenancy, authorization |
INVALID_SYSTEM_MESSAGE_FORMAT Invalid system message format. System messages must include 'role' and 'content' | error_code | error | agent, message-conversion, system-message, validation |
MASTRA_AIV5_DATA_PART_INVALID Invalid AIV5 data part in getDataStringFromAIV5DataPart | error_code | error | agent, message-conversion, media, aiv5 |
| Unhandled toolInvocation.state: ${String(part.toolInvocation | exception | error | agent, message-conversion, tool-invocation, aiv6 |
| Received input message with wrong threadId. Input ${message. | exception | error | agent, memory, thread, input-validation |
| Received input message with wrong resourceId. Input ${messag | exception | error | agent, memory, resource, input-validation |
| Found unhandled message ${JSON.stringify(message)} | exception | error | message-conversion, input-validation, agent, memory |
| Saw text content for input CoreMessage, but the role is ${co | exception | error | message-conversion, ai-sdk-v4, tool-messages, prompt |
| Saw incompatible message content part type ${part.type} for | exception | error | message-conversion, ai-sdk-v4, tool-messages, prompt |
| Encountered unknown role ${role} when converting V4 CoreMess | exception | error | message-conversion, ai-sdk-v4, roles, prompt |
| Saw text content for input ModelMessage, but the role is ${m | exception | error | message-conversion, ai-sdk-v5, tool-messages, prompt |
| Encountered unknown role ${role} when converting V5 ModelMes | exception | error | message-conversion, invalid-role, ai-sdk-v5 |
| BUG: add handling for message role ${message.role} in messag | exception | error | message-list, role-detection, internal-invariant |
| Expected role "system" but saw ${coreMessage.role} for messa | exception | error | message-list, system-message, invalid-role |
INVALID_MESSAGE_CONTENT Message with role "${message.role}" must have either a 'content' property (strin | error_code | error | message-list, validation, empty-content |
INVALID_SYSTEM_MESSAGE_FORMAT Invalid system message format. System messages must be CoreMessage format with ' | error_code | error | message-list, system-message, validation, agent |
| Invalid URL: ${attachment.url} | exception | error | url, attachment, validation |
| If the attachment is not an image, it must specify a content | exception | error | attachment, mime-type, validation |
| If the attachment is not an image or text, it must specify a | exception | error | attachment, mime-type, validation |
| Unsupported URL protocol: ${url.protocol} | exception | error | url, attachment, protocol, validation |
| Unsupported part type: ${type} | exception | error | content-part, conversion, ai-sdk |
| Media type is missing for file part | exception | error | file-part, mime-type, conversion |
DOWNLOAD_ASSETS_FAILED Failed to download asset: ${safeUrl} | error_code | error | network, download, http, asset |
| Missing message source for message ${message} | exception | error | message-list, internal-state, invariant, agent |
| Unsupported output format: ${format} | exception | error | configuration, invalid-argument, message-conversion |
| Invalid signal type: ${input.type}. Use a supported signal t | exception | error | signals, invalid-argument, validation |
| Invalid signal XML ${label}: ${name} | exception | error | signals, xml, validation |
| state signals cannot be transient | exception | error | signals, invalid-combination, state |
| state signal id is required | exception | error | signals, state, missing-argument |
| state signal cacheKey is required | exception | error | signals, state, missing-argument |
| Cannot register run ${output.runId}: thread is already activ | exception | error | concurrency, threads, streaming, conflict |
| AgentThreadLeaseConflictError(runId, owner) | exception | error | concurrency, distributed-lock, lease, threads |
| resourceId and threadId are required to queue a message | exception | error | agent, memory, signal, missing-argument |
| resourceId and threadId are required to send a state signal | exception | error | agent, memory, signal, missing-argument |
| sendStateSignal requires Mastra memory | exception | error | agent, memory, configuration, signal |
| sendStateSignal could not load thread ${threadId} | exception | error | agent, memory, storage, thread-not-found |
| No active agent run found for signal target | exception | error | agent, signal, race-condition, missing-argument |
| resourceId and threadId are required to persist an active si | exception | error | agent, signal, memory, missing-argument |
STRUCTURED_OUTPUT_OPTIONS_REQUIRED structuredOutput is required to use tryGenerateWithJsonFallback | error_code | error | structured-output, agent, missing-argument, zod |
STRUCTURED_OUTPUT_OBJECT_UNDEFINED structuredOutput object is undefined | error_code | error | structured-output, llm-output, json-parsing, retry |
MAP_RESULTS_STEP_UNSUPPORTED_MODEL Tripwire handling requires a v2/v3 model | error_code | error | tripwire, guardrails, model-version, agent-workflow |
| Model not allowed by allowlist | error_code | error | allowlist, authorization, agent-builder, model-policy |
| Duplicate mode id "${mode.id}" found when creating the Agent | exception | error | configuration, agent-controller, duplicate-id, startup |
| Mode "${modeRecord.id}" cannot set both "tools" and "additio | exception | error | configuration, agent-controller, tools, mutually-exclusive |
| Mode "${mode.id}" transitionsTo cannot reference itself | exception | error | configuration, agent-controller, state-machine, self-reference |
| Mode "${mode.id}" transitionsTo references unknown mode "${m | exception | error | configuration, agent-controller, state-machine, missing-reference |
| Default mode not found: ${config.defaultModeId} | exception | error | configuration, agent-controller, default-mode, startup |
| Thread not found: ${threadId} | exception | error | session, thread, ownership, multi-tenancy |
| Thread not found: ${overrides.threadId} | exception | error | multi-tenancy, resource-isolation, thread |
| Storage is not configured on this AgentController | exception | error | configuration, storage, memory |
| Storage does not have a memory domain configured | exception | error | configuration, storage, memory |
| This conversation has no message to name it from yet. | exception | error | memory, title-generation, messages |
| Mode ${mode.id} requires a defaultModelId when no backing ag | exception | error | configuration, agent, model |
| Cannot build stream options without a current thread | exception | error | session, thread, streaming |
| Memory is not configured on this AgentController | exception | error | configuration, memory |
| Dynamic memory factory returned empty value | exception | error | configuration, memory, factory |
| No active thread on this session | exception | error | state, lifecycle, threading |
| Memory is not configured on this AgentController | exception | error | configuration, memory, storage |
| Thread not found: ${threadId} | exception | error | state, ownership, threading |
| No source thread to clone | exception | error | state, lifecycle, threading |
| Mode not found: ${this.#id} | exception | error | state, configuration, lifecycle |
| Mode not found: ${modeId} | exception | error | state, configuration, validation |
| Invalid state update: ${messages} | validation | error | validation, schema, state |
| A session workspace must be a valid Workspace instance. | exception | error | configuration, type-error, workspace |
| No active run to approve tool call for | exception | error | agent, tool-approval, lifecycle |
| Cannot approve a tool call without a current thread | exception | error | agent, tool-approval, thread |
| No active run to decline tool call for | exception | error | agent, tool-approval, lifecycle |
| Cannot decline a tool call without a current thread | exception | error | agent, tool-approval, thread |
| No active suspension to resume | exception | error | agent, suspension, resume, lifecycle |
| Cannot resume a suspended tool without a current thread | exception | error | agent, suspension, resume, thread |
| Task has not been dispatched yet | exception | error | background-tasks, lifecycle, dispatch |
| Storage is not initialized | exception | critical | storage, configuration, background-tasks |
| Background tasks storage is not available | exception | critical | storage, background-tasks, version-mismatch |
| BackgroundTaskManager is shutting down, cannot initialize | exception | error | background-tasks, lifecycle, shutdown |
| BackgroundTaskManager is shutting down, cannot enqueue new t | exception | error | background-tasks, shutdown, backpressure |
| Concurrency limit reached, cannot enqueue task for tool "${t | exception | warning | background-tasks, backpressure, concurrency |
| Task not found: ${taskId} | exception | error | background-tasks, not-found, cancel |
| BackgroundTaskManager is shutting down, cannot resume tasks | exception | error | background-tasks, shutdown, resume |
| Mastra is not registered with this manager | exception | critical | background-tasks, configuration, mastra |
| Cannot resume task in status '${task.status}' (expected 'sus | exception | error | background-tasks, state-machine, invalid-state |
| Concurrency limit reached, cannot resume task "${taskId}" — | exception | warning | background-tasks, concurrency, rate-limiting |
| BackgroundTaskManager is shutting down, cannot restart tasks | exception | error | background-tasks, shutdown, lifecycle |
| Cannot restart task in status '${task.status}' (expected 'ru | exception | error | background-tasks, state-machine, invalid-state |
| Concurrency limit reached, cannot restart task "${taskId}" — | exception | warning | background-tasks, concurrency, rate-limiting |
| ${errorInfo.message} | exception | error | background-tasks, workflow, task-failure, error-propagation |
| Invalid browser configuration: "cdpUrl" and "scope: 'thread' | validation | error | browser, configuration, cdp, validation |
| Invalid browser configuration: "cdpUrl" cannot be used with | validation | error | browser, configuration, cdp, validation |
| Cannot launch browser in '${this.status}' state | exception | error | browser-lifecycle, state-machine, race-condition |
| ${this.provider} does not support connecting to external CDP | exception | error | cdp, unsupported-operation, provider-capability |
| Browser is ${this.status} and cannot be used | exception | error | browser-lifecycle, state-machine, concurrency |
| Failed to fetch CDP version info from ${versionUrl}: ${respo | exception | error | cdp, http, network |
| No webSocketDebuggerUrl found in CDP version response from $ | exception | error | cdp, websocket, network, proxy |
| Timeout resolving WebSocket URL from ${versionUrl} (10s) | exception | error | cdp, timeout, network |
| Screencast not supported by this provider | exception | error | screencast, unsupported-operation, provider-capability |
| Mouse event injection not supported by this provider | exception | error | input, unsupported-operation, provider-capability |
| Keyboard event injection not supported by this provider | exception | error | input, unsupported-operation, provider-capability |
| fourcc must be 4 ASCII characters, got "${s}" | exception | error | avi, validation, recording, fourcc |
| writeMjpegAviFile: at least one frame is required | validation | error | avi, muxing, input-validation, recording |
| writeMjpegAviFile: invalid dimensions ${opts.width}x${opts.h | validation | error | avi, dimensions, input-validation |
| writeMjpegAviFile: dimensions exceed AVI header bounds: ${op | validation | error | avi, dimensions, limits, header |
| buildHdrl internal error: wrote ${p} bytes, expected ${hdrlP | exception | error | avi, internal-bug, header, invariant |
| writeMjpegAviFile: frame ${index} is not a JPEG frame (missi | validation | error | jpeg, avi, codec, frame-validation |
| Recording outputPath must be inside ${baseDir} | exception | error | path-traversal, security, validation, recording |
| No frames captured during recording | exception | error | recording, frames, avi, empty-state |
| Frame dimensions changed during recording: expected ${width} | exception | error | recording, dimensions, avi, viewport |
| A browser recording is already active. Call browser_record w | exception | error | recording, concurrency, state, double-start |
| ${key} exists but is not a number | exception | error | cache, type-conflict, counter |
| Channels require storage to be configured on the Mastra inst | exception | error | configuration, storage, channels |
| No adapter for platform "${platform}" | exception | error | channels, adapter, configuration |
| Storage is required for tool approval lookups | exception | error | storage, channels, tool-approval |
| No channel context — cannot determine platform or thread | exception | error | channels, request-context, missing-context |
| No adapter registered for platform "${channel.platform}" | exception | error | channels, adapter, request-context |
| Storage is required for channel thread mapping. Configure st | exception | error | storage, channels, thread-mapping |
| Memory store is required for channel thread mapping. Configu | exception | error | storage, memory-store, channels |
| resolveSession returned a session for resourceId="${session. | exception | error | channels, resource-id, session-ownership |
| ChannelSessionRejectedError | exception | error | channels, session, wrapped-error |
| AgentControllerChannels is not bound to an AgentController. | exception | error | channels, configuration, initialization-order |
| chat module not loaded yet — call getChatModule() first | exception | error | lazy-loading, initialization-order, channels |
DATASETS_STORAGE_NOT_CONFIGURED Storage not configured. Configure storage in Mastra instance. | error_code | error | storage, configuration, datasets |
DATASETS_STORE_NOT_AVAILABLE Datasets store not available. Ensure your storage adapter provides a datasets do | error_code | error | storage, datasets, adapter-compatibility |
EXPERIMENTS_STORE_NOT_AVAILABLE Experiments store not available. Ensure your storage adapter provides an experim | error_code | error | storage, experiments, adapter-compatibility |
DATASET_NOT_FOUND Dataset not found: ${this.id} | error_code | error | datasets, not-found, storage |
EXPERIMENT_NO_ITEMS Cannot run experiment: dataset "${this.id}" has no items at version ${targetVers | error_code | error | storage, dataset, experiment, empty-data |
EXPERIMENT_NOT_FOUND Experiment not found: ${experimentId} | error_code | error | storage, experiment, not-found, ownership |
EXPERIMENT_RESULT_MISSING_EXPERIMENT_ID updateExperimentResult requires experimentId when called via a Dataset handle | error_code | error | storage, experiment, validation, missing-argument |
EXPERIMENT_INVALID_TARGET targetType and targetId must be provided together (got targetType: ${args?.targe | error_code | error | storage, experiment, validation, invalid-arguments |
EXPERIMENT_TARGET_NOT_FOUND Target not found: ${args!.targetType} "${args!.targetId}" | error_code | error | storage, experiment, not-found, registry |
EXPERIMENT_ID_CONFLICT Experiment id ${args.id} already exists and does not match this experiment's dat | error_code | error | storage, experiment, conflict, duplicate-id |
EXPERIMENT_HAS_NO_TARGET Experiment ${args.experimentId} has no target; ingest results via submitExperime | error_code | error | storage, experiments, api-misuse, user-error |
EXPERIMENT_ALREADY_FINALIZED Experiment ${args.experimentId} is already ${experiment.status}; no further item | error_code | error | storage, experiments, state-machine, user-error |
DATASET_ITEM_NOT_FOUND Item ${args.itemId} not found in dataset ${this.id} at version ${experiment.data | error_code | error | storage, experiments, not-found, versioning |
EXPERIMENT_HAS_TARGET Experiment ${args.experimentId} has a target (${experiment.targetType} "${experi | error_code | error | storage, experiments, api-misuse, user-error |
| Storage not configured. Configure storage in Mastra instance | exception | error | storage, configuration, experiments, analytics |
| ExperimentsStorage not configured. | exception | error | storage, configuration, experiments, analytics |
| ScoresStorage not configured. | exception | error | storage, configuration, experiments, analytics, scores |
| Experiment not found: ${experimentIdA} | exception | error | storage, experiment, not-found, user-input |
| Experiment not found: ${experimentIdB} | exception | error | storage, experiment, not-found, user-input |
| Target type '${targetType}' not yet supported. | exception | error | configuration, experiment, unsupported-feature |
| Unknown target type: ${targetType} | exception | error | configuration, experiment, invalid-argument, user-input |
| DatasetsStorage not configured. Configure storage in Mastra | exception | error | configuration, storage, missing-config |
DATASET_NOT_FOUND Dataset not found: ${datasetId} | error_code | error | storage, dataset, not-found, user-input |
EXPERIMENT_NO_ITEMS No items in dataset ${datasetId} at version ${datasetVersion} | error_code | error | storage, dataset, empty-data, experiment |
| No data source: provide datasetId or data | exception | error | configuration, experiment, invalid-argument, user-input |
| Target not found: ${targetType}/${targetId} | exception | error | configuration, registry, not-found, experiment |
| No task: provide targetType+targetId or task | exception | error | configuration, experiment, invalid-argument, user-input |
AbortError Aborted | exception | info | cancellation, abort, async |
EXPERIMENT_HAS_NO_TARGET Experiment ${experiment.id} has no target; results must be ingested via submitEx | error_code | error | configuration, experiments, validation |
EXPERIMENT_TARGET_NOT_FOUND Target not found: ${experiment.targetType} "${experiment.targetId}" | error_code | error | experiments, configuration, not-found |
EXPERIMENTS_STORAGE_NOT_CONFIGURED ExperimentsStorage not configured. Configure storage in the Mastra instance. | error_code | error | storage, configuration, experiments |
DATASETS_STORAGE_NOT_CONFIGURED Storage not configured. Configure storage in Mastra instance. | error_code | error | storage, configuration, datasets |
DATASETS_STORE_NOT_AVAILABLE Datasets store not available. Ensure your storage adapter provides a datasets do | error_code | error | storage, datasets, compatibility |
EXPERIMENTS_STORE_NOT_AVAILABLE Experiments store not available. Ensure your storage adapter provides an experim | error_code | error | storage, experiments, compatibility |
DATASET_NOT_FOUND Dataset not found | error_code | error | not-found, datasets, multi-tenancy |
COMPARE_INVALID_INPUT compareExperiments requires at least 2 experiment IDs. | error_code | error | storage, validation, datasets, argument-error |
| SchemaValidationError(field, this.formatErrors(result.error) | validation | error | validation, schema, zod, datasets |
MASTR_SCORER_FAILED_TO_CREATE_MISSING_ID Scorers must have an ID field. Please provide an ID in the scorer config. | error_code | error | scorer, config, evals, missing-field |
MASTR_SCORER_FAILED_TO_RUN_MISSING_GENERATE_SCORE Cannot execute pipeline without generateScore() step | error_code | error | scorer, pipeline, evals, missing-step |
MASTR_SCORER_FAILED_TO_RUN_WORKFLOW_FAILED Scorer Run Failed: ${workflowFailure.message} | error_code | error | scorer, workflow, evals, llm |
| Step "${scorerStep.name}" is not a prompt object | exception | error | scorer, configuration, llm-judge |
MASTR_SCORER_FAILED_TO_RUN_MISSING_MODEL_OR_INSTRUCTIONS Step "${scorerStep.name}" requires a model and instructions | error_code | error | scorer, configuration, missing-model, missing-instructions |
| Invalid scoring filter: path(s) ${invalid.map(p => `"${p}"`) | validation | error | scorer, predicate, validation, configuration |
RUN_EXPERIMENT_FAILED_NO_DATA_PROVIDED Failed to run experiment: Data array is empty | error_code | error | evals, experiment, validation, empty-input |
INVALID_DATA_ITEM Invalid data item at index ${i}: must have 'input', 'inputs', or 'turns' propert | error_code | error | evals, dataset, validation, schema |
NO_SCORERS_PROVIDED At least one scorer or gate must be provided | error_code | error | evals, configuration, validation |
INVALID_AGENT_SCORERS Agent scorers must be an array of scorers or an AgentScorerConfig | error_code | error | evals, typescript, configuration |
RUN_EXPERIMENT_TARGET_FAILED_TO_GENERATE_RESULT Failed to run experiment: Error generating result from target | error_code | error | evals, agent, workflow, error-wrapping |
RUN_EXPERIMENT_SCORER_FAILED_TO_SCORE_RESULT Failed to run experiment: Error running scorer ${scorer.id} | error_code | error | evals, scorer, error-wrapping |
RUN_EXPERIMENT_SCORER_FAILED_TO_SCORE_TRAJECTORY Failed to run experiment: Error running trajectory scorer ${scorer.id} | error_code | error | evals, scorer, trajectory, error-wrapping |
RUN_EXPERIMENT_SCORER_FAILED_TO_SCORE_STEP_RESULT Failed to run experiment: Error running scorer ${scorer.id} on step ${stepId} | error_code | error | evals, scorer, workflow, error-wrapping |
RUN_EXPERIMENT_SCORER_FAILED_TO_SCORE_WORKFLOW_TRAJECTORY Failed to run experiment: Error running workflow trajectory scorer ${scorer.id} | error_code | error | evals, scorer, workflow, trajectory |
| Span not found for scoring, traceId: ${trace.traceId}, spanI | exception | error | observability, tracing, score-traces, span-lookup |
MASTRA_OBSERVABILITY_STORAGE_NOT_AVAILABLE Observability storage domain is not available | error_code | critical | storage, observability, configuration, score-traces |
| Trace not found for scoring, traceId: ${target.traceId} | exception | error | observability, tracing, storage, score-traces |
| Persisted score is missing spanId for traceId: ${target.trac | exception | error | observability, scorer, score-traces, span-lookup |
MASTRA_SCORES_STORAGE_NOT_AVAILABLE Scores storage domain is not available | error_code | error | storage, scores, deprecated, mastra-error |
| Trace is null or undefined | exception | error | trace, null-check, scoring |
| Trace must have a spans array | exception | error | trace, shape-validation, scoring |
| Trace has no spans | exception | error | trace, empty-data, scoring |
| Span ${span.spanId} references non-existent parent ${span.pa | exception | error | trace, span-tree, data-integrity |
| No model generation span found in trace | exception | error | trace, llm-span, scoring |
| No root agent_run span found in trace | exception | error | trace, agent-run, span-type |
| Root agent span has no output | exception | error | trace, missing-output, scoring |
INVALID_SCORER_THRESHOLD ${label} threshold for scorer "${scorerId}" must be a finite number between 0 an | error_code | error | scorer, threshold, config-validation, mastra-error |
| UnixSocketPubSub does not support grouped subscriptions yet | exception | error | pubsub, unix-socket, unsupported-feature |
| UnixSocketPubSub is closed | exception | error | pubsub, lifecycle, shutdown, unix-socket |
| Stale broker election lock removed | exception | warning | pubsub, unix-socket, broker-election, stale-lock, retry |
| Broker election in progress by another process | exception | warning | pubsub, unix-socket, broker-election, lock-contention, retry |
| UnixSocketPubSub is not connected to a broker | exception | error | pubsub, ipc, connection, lifecycle |
| Sync function "${name}" already registered | exception | error | registration, duplicate, workflow, integration |
| Method not implemented. | exception | error | abstract-method, integration, tools, not-implemented |
| Method not implemented | exception | error | abstract-method, integration, api-client, not-implemented |
| API not implemented | exception | error | not-implemented, openapi, toolset, api-client |
INVALID_KEY INVALID_KEY | LICENSE_EXPIRED | LICENSE_REVOKED | RATE_LIMITED | error_code | error | license, validation, configuration, entitlement |
| License server responded with ${response.status} | exception | warning | license, http-429, http-5xx, transient, retry |
| License server rate limited: ${data.reason} | exception | warning | license, rate-limit, throttling, transient |
| Invalid model string format: "${config}". Expected format: " | exception | error | configuration, model-string, parsing, embeddings |
| Invalid model string format: "${config}". Expected format: " | exception | error | validation, configuration, model-router |
| Invalid model string format: "${config.id}". Expected format | exception | error | validation, configuration, model-router |
| Invalid model string format: "${config.id}". Expected format | exception | error | validation, configuration, model-router |
| API key not found for provider mastra. Set MASTRA_GATEWAY_AP | exception | error | authentication, api-key, environment, configuration |
| Unknown provider: ${normalizedConfig.providerId} | exception | error | configuration, validation, provider-registry |
| API key not found for provider ${normalizedConfig.providerId | exception | error | authentication, api-key, environment |
| Provider ${normalizedConfig.providerId} does not have a URL | exception | error | configuration, url, provider-registry |
| Expected ${gatewayPrefix}/ in model router ID ${routerId} | exception | error | parsing, validation, gateway |
| Expected format azure-openai/deployment-name, but got ${rout | exception | error | parsing, azure, validation |
| Expected format ${gatewayPrefix}/model, but got ${routerId} | exception | error | parsing, gateway, validation |
| Expected atleast 3 id parts ${gatewayPrefix}/provider/model, | exception | error | model-router, parsing, invalid-model-id, gateway |
| Attempted to parse provider/model from ${routerId} but this | exception | error | model-router, parsing, invalid-model-id, gateway |
AZURE_GATEWAY_INVALID_CONFIG resourceName is required for Azure OpenAI gateway | validation | error | azure, configuration, gateway, missing-config |
AZURE_MANAGEMENT_CREDENTIALS_MISSING Management credentials incomplete. Missing: ${missing.join(', ')}. Required fiel | validation | error | azure, authentication, credentials, configuration |
AZURE_AD_TOKEN_ERROR Failed to get Azure AD token: ${response.status} ${error} | http | error | azure, authentication, oauth, entra-id, http |
AZURE_DEPLOYMENTS_FETCH_ERROR Failed to fetch Azure deployments: ${response.status} ${error} | http | error | azure, http, network, gateway |
AZURE_ENTRA_ID_AUTH_NOT_CONFIGURED Entra ID authentication is not configured for Azure OpenAI gateway | validation | error | azure, authentication, configuration, entra-id |
AZURE_ENTRA_ID_TOKEN_ERROR Failed to get Entra ID token for Azure OpenAI gateway | exception | error | azure, entra-id, authentication, token |
MODEL_ROUTER_NO_GATEWAY_FOUND No Mastra model router gateway found for model id ${gatewayId} | error_code | error | model-router, configuration, gateway, invalid-input |
MASTRA_GATEWAY_NO_API_KEY Missing MASTRA_GATEWAY_API_KEY environment variable | error_code | error | api-key, environment, configuration, gateway |
| Missing environment variable ${envVarName} required to build | exception | error | environment, url, configuration, models-dev |
| Failed to fetch from models.dev: ${response.statusText} | exception | error | network, http, models-dev, registry |
| Could not identify provider from model id ${modelId} | exception | error | models-dev, invalid-input, model-id, gateway |
| Could not find config for provider ${provider} with model id | exception | error | models-dev, configuration, provider, model-id |
| Could not find API key process.env.${envVarDisplay} for mode | exception | error | environment, api-key, configuration, model-gateway |
| No API URL found for ${providerId}/${modelId} | exception | error | configuration, base-url, moonshot, model-gateway |
| Failed to fetch from Netlify: ${response.statusText} | exception | error | network, http, netlify, api-unavailable |
NETLIFY_GATEWAY_NO_TOKEN Missing NETLIFY_TOKEN environment variable required for model: ${routerId} | error_code | error | environment, api-key, netlify, configuration, mastra-error |
NETLIFY_GATEWAY_NO_SITE_ID Missing NETLIFY_SITE_ID environment variable required for model: ${routerId} | error_code | error | env-var, netlify, configuration, gateway |
NETLIFY_GATEWAY_TOKEN_ERROR Failed to get Netlify AI Gateway token for model ${routerId}: ${error instanceof | error_code | error | netlify, authentication, gateway, network |
| Failed to get Netlify AI Gateway token: ${response.status} $ | exception | error | netlify, http, authentication, api-error |
INVALID_METHOD_TYPE INVALID_METHOD_TYPE | error_code | error | agent, typescript, invalid-argument, user-error |
| Cannot start an overlapping WebSocket Responses continuation | exception | error | websocket, openai, concurrency, streaming |
| Invalid model configuration provided | exception | error | configuration, model, invalid-argument, typescript |
| We could not convert the schema to a JSONSchema | exception | error | schema, zod, json-schema, validation |
AGENT_NETWORK_OBSERVATIONAL_MEMORY_UNSUPPORTED Observational Memory is not supported with agent network. Agent network does not | error_code | error | agent-network, observational-memory, memory, configuration |
AGENT_NETWORK_ROUTING_AGENT_INVALID_OUTPUT Routing agent returned undefined for 'object'. This may indicate an issue with t | error_code | error | agent-network, structured-output, routing, model-response |
AGENT_NETWORK_MEMORY_REQUIRED Memory is required for the agent network to function properly. Please configure | error_code | error | agent-network, memory, configuration, missing-dependency |
| Unsupported model version: ${(currentStep.model as { specifi | exception | error | ai-sdk, model-version, workflow, compatibility |
| ${inputData.toolName} | exception | error | workflow, tools, tool-not-found, agent-execution |
MASTRA_SCORER_NOT_FOUND Scorer with ID ${scorerId} not found | error_code | error | scorers, registration, configuration |
MASTRA_SCORES_STORAGE_NOT_AVAILABLE Scores storage domain is not available | error_code | error | storage, scores, deprecated, observability |
| Duplicate worker name "${w.name}" in the 'workers' option | exception | error | workers, configuration, duplicate, mastra-constructor |
MASTRA_ADD_WORKSPACE_MISSING_AGENT_METADATA Agent workspaces must include agentId and agentName. | error_code | error | workspace, metadata, validation, configuration |
MASTRA_GET_INTERNAL_WORKFLOW_BY_ID_NOT_FOUND Workflow with id ${String(id)} not found | error_code | error | workflow, internal-workflow, not-found, mastra-api |
MASTRA_GET_PROMPT_BLOCK_NOT_FOUND Prompt block with key ${key} not found | error_code | error | lookup-failed, prompt-block, user-input |
MASTRA_GET_PROMPT_BLOCK_BY_ID_NOT_FOUND Prompt block with id ${id} not found | error_code | error | lookup-failed, prompt-block, id-mismatch |
MASTRA_GET_TOOL_BY_ID_NOT_FOUND Tool with id ${id} not found | error_code | error | lookup-failed, tools, empty-registry |
MASTRA_GET_PROCESSOR_BY_ID_NOT_FOUND Processor with id ${id} not found | error_code | error | lookup-failed, processors, empty-registry |
| Dynamic workflow bundle contains more than one definition wi | exception | error | workflow, duplicate-id, validation |
| Dynamic workflow bundle has a circular nested-workflow depen | exception | error | workflow, circular-dependency, validation |
| Worker "${name}" not found. Available: ${this.#workers.map(w | exception | error | worker, lookup-failed, naming |
| RunScope: missing required slot ${sym.toString()} | exception | error | run-scope, missing-slot, initialization-order |
| The 'processors' option in Memory is deprecated and has been | validation | error | deprecation, memory, migration, breaking-change |
| Semantic recall requires a vector store to be configured. h | validation | error | memory, semantic-recall, missing-dependency, configuration |
| Semantic recall requires an embedder to be configured. http | validation | error | memory, semantic-recall, configuration, missing-embedder |
| Memory requires a storage provider to function. Add a storag | exception | critical | memory, storage, configuration, missing-dependency |
| Embedder returned no usable embedding for the dimension prob | exception | error | memory, embedder, dimension-probe, empty-response |
MASTRA_MEMORY_GET_EMBEDDING_DIMENSION_FAILED Failed to determine the embedder's output dimension. Semantic recall cannot safe | error_code | error | memory, embedder, third-party, dimension-probe, network |
| Tried to create embedding index but no vector db is attached | exception | error | memory, vector-store, semantic-recall, configuration |
| The workingMemory.use option has been removed. Working memor | validation | error | memory, working-memory, deprecation, breaking-change |
| The threads.generateTitle option has been moved. Use the top | validation | error | memory, threads, deprecation, breaking-change |
| addMessage is deprecated. Please use saveMessages instead. | exception | error | memory, deprecation, api-migration, messages |
WORKING_MEMORY_MISSING_STORAGE_ADAPTER Using Mastra Memory working memory requires a storage adapter but no attached ad | error_code | critical | memory, working-memory, storage, configuration |
MESSAGE_HISTORY_MISSING_STORAGE_ADAPTER Using Mastra Memory message history requires a storage adapter but no attached a | error_code | critical | memory, message-history, storage, configuration |
SEMANTIC_RECALL_MISSING_STORAGE_ADAPTER Using Mastra Memory semantic recall requires a storage adapter but no attached a | error_code | error | memory, storage, semantic-recall, configuration |
SEMANTIC_RECALL_MISSING_VECTOR_ADAPTER Using Mastra Memory semantic recall requires a vector adapter but no attached ad | error_code | error | memory, vector, semantic-recall, configuration |
SEMANTIC_RECALL_MISSING_EMBEDDER Using Mastra Memory semantic recall requires an embedder but no attached embedde | error_code | error | memory, embedder, semantic-recall, configuration |
MASTRA_MEMORY_STORAGE_NOT_AVAILABLE Memory storage is not supported by this storage adapter | error_code | error | memory, storage, adapter, unsupported |
| Memory instance is required for working memory updates | exception | error | memory, working-memory, tools, context |
| Thread ID is required for thread-scoped working memory updat | exception | error | memory, working-memory, thread-id, validation |
| Resource ID is required for resource-scoped working memory u | exception | error | memory, working-memory, validation, missing-argument |
| Thread with id ${threadId} resourceId does not match the cur | exception | error | memory, tenant-mismatch, thread, validation |
| Cannot update working memory: ${scope} ID is required | exception | error | memory, working-memory, missing-argument, validation |
| Invalid MemoryRequestContext: expected object, got ${typeof | validation | error | memory, type-error, validation, request-context |
| Invalid MemoryRequestContext.thread: expected object, got ${ | validation | error | memory, type-error, validation, request-context, nested-field |
| Invalid MemoryRequestContext.thread.id: expected string, got | validation | error | memory, validation, request-context, typescript |
| Invalid MemoryRequestContext.resourceId: expected string, go | validation | error | memory, validation, request-context, resource-id |
| Notification ${current.id} is missing agentId | exception | error | notifications, storage, data-integrity |
| Notification ${current.id} is missing resourceId | exception | error | notifications, storage, data-integrity, resource-id |
| Notification summary is missing agentId | exception | error | notifications, storage, batching, data-integrity |
| Notification summary is missing resourceId | exception | error | notifications, missing-field, runtime |
| Notification ${input.id} was not found for thread ${input.th | exception | error | notifications, not-found, storage |
| notification-inbox requires a threadId | exception | error | notifications, tool, missing-argument |
| notification-inbox search requires query | exception | error | notifications, tool, validation |
| Notification ${input.id} was not found for thread ${threadId | exception | error | notifications, tool, not-found |
| notification-inbox ${input.action} requires id | exception | error | notifications, tool, missing-argument |
| Invalid notification dispatch time: ${input} | exception | error | notifications, date-parsing, validation |
| PII detection failed: ${error instanceof Error ? error.stack | exception | error | processors, pii, error-wrapping |
| Prompt injection detection failed: ${error instanceof Error | exception | error | processors, prompt-injection, error-wrapping |
| RegexFilterProcessor requires at least one rule or preset | exception | error | configuration, validation, processors, constructor |
| RegexFilterProcessor streamCarryoverSize must be a positive | exception | error | configuration, validation, streaming, constructor |
STRUCTURED_OUTPUT_PROCESSOR_SCHEMA_REQUIRED StructuredOutputProcessor requires a schema to be provided | error_code | error | configuration, schema, structured-output, constructor |
STRUCTURED_OUTPUT_PROCESSOR_MODEL_REQUIRED StructuredOutputProcessor requires a model to be provided either in options or a | error_code | error | configuration, model, structured-output, constructor |
| SystemPromptScrubber requires a model for detection | exception | error | configuration, model, constructor, detection |
| Structured output returned no object | exception | error | llm, structured-output, runtime, detection |
| TokenCostControl requires maxCost to be a finite positive nu | validation | error | configuration, validation, cost-control, constructor |
| TokenCostControl requires warnAtPercent to be a number betwe | validation | error | configuration, validation, cost-control, constructor |
| TokenCostControl requires observability storage with getMetr | exception | critical | storage, observability, configuration, registration |
| TokenLimiterProcessor: No messages to process. Cannot send L | exception | error | tripwire, messages, runtime, token-limiter |
| TokenLimiterProcessor: System messages alone exceed token li | exception | error | token-limit, processors, configuration, tripwire |
| TokenLimiterProcessor: No messages fit within the remaining | exception | error | token-limit, processors, tripwire, message-list |
| countCoreSystemMessageTokens can only be used with system me | exception | error | internal-invariant, processors, message-list, typescript |
| countCoreSystemMessageTokens: System message content must be | exception | error | token-limit, processors, content-format, validation |
| [Processor:${processor.id}] computeStateSignal requires Mast | exception | error | processors, memory, configuration, state-signal |
| [Processor:${processor.id}] computeStateSignal could not loa | exception | error | processors, memory, thread, persistence |
| Tripwire triggered by ${processor.id} | exception | error | tripwire, processors, state-signal, abort |
| Tripwire triggered in workflow ${workflow.id} | exception | error | tripwire, workflows, processors, abort |
PROCESSOR_WORKFLOW_FAILED Processor workflow ${workflow.id} failed with status: ${result.status}${detailSt | error_code | error | workflows, processors, mastra-error, workflow-failed |
PROCESSOR_WORKFLOW_INVALID_OUTPUT Processor workflow ${workflow.id} returned invalid output format. Expected Proce | error_code | error | workflows, processors, schema-validation, mastra-error |
PROCESSOR_RETURNED_EXTERNAL_MESSAGE_LIST Processor ${processor.id} returned a MessageList instance other than the one tha | error_code | error | agent, processors, messagelist, api-misuse |
| Stream part blocked by ${processor.id} | exception | warning | agent, processors, streaming, tripwire |
| [Processor:${processor.id}] sendStateSignal requires Mastra | exception | error | agent, processors, memory, configuration |
| [Processor:${processor.id}] sendStateSignal could not load t | exception | error | agent, processors, memory, thread-not-found |
PROCESSOR_RETURNED_MESSAGES_AND_MESSAGE_LIST Processor ${processor.id} returned both messages and messageList. Only one of th | error_code | error | processors, input-step, return-shape, user-error |
PROCESSOR_RETURNED_UNSUPPORTED_MODEL Processor ${processor.id} returned an unsupported model version ${resolvedModel. | error_code | error | processors, model-resolution, ai-sdk, version-mismatch |
SCHEDULES_INVALID_DEFINITION Schedule${where}: expected a schedule definition object, received ${definition = | error_code | error | schedules, validation, config, user-error |
SCHEDULES_AMBIGUOUS_MODE Schedule${where}: set exactly one execution mode — remove either 'prompt' or 'ha | error_code | error | schedules, configuration, validation, user-error |
SCHEDULES_MISSING_MODE Schedule${where}: set exactly one execution mode — provide a non-empty 'prompt' | error_code | error | schedules, configuration, validation, user-error |
SCHEDULES_INVALID_CRON Schedule${where}: ${error instanceof Error ? error.message : String(error)} | error_code | error | schedules, cron, configuration, validation |
SCHEDULES_INVALID_SIGNAL_TYPE Schedule${where}: unknown signalType "${definition.signalType}". Expected one of | error_code | error | schedules, enum, validation, user-error |
SCHEDULES_INVALID_STATUS Schedule${where}: unknown status "${definition.status}". Expected one of: ${SCHE | error_code | error | schedules, enum, validation, user-error |
SCHEDULES_MISSING_RESOURCE_ID Schedule${where}: 'resourceId' is required when 'threadId' is set. | error_code | error | schedules, validation, config, user-error |
SCHEDULES_INVALID_ID schedules.create: id "${rawId}" is empty after normalization. Provide an id with | error_code | error | schedules, validation, slugify, user-error |
SCHEDULES_NO_SCHEDULES_STORAGE Schedules require a storage adapter that implements the schedules domain. | error_code | error | schedules, storage, configuration, missing-dependency |
SCHEDULES_MISSING_TARGET_ID schedules.create requires `agentId` or `workflowId`. | error_code | error | schedules, validation, user-error, config |
SCHEDULES_MISSING_RESOURCE_ID schedules.create requires `resourceId` when `threadId` is set. | error_code | error | schedules, validation, memory, user-error |
SCHEDULES_THREADLESS_OPTIONS schedules.create: ${offenders.join(', ')} require a threadId. | error_code | error | schedules, validation, agent |
SCHEDULES_ID_EXISTS schedules.create: a schedule with id "${id}" already exists. Use update() to mod | error_code | error | schedules, conflict, duplicate-id |
SCHEDULES_NOT_FOUND Schedule "${id}" not found. | error_code | error | schedules, not-found |
SCHEDULES_INVALID_WORKFLOW_PATCH schedules.update: ${offenders.join(', ')} only apply to agent schedules. | error_code | error | schedules, validation, workflow, update |
| AgentScheduleWorker requires Mastra instance | exception | error | worker, initialization, schedules |
| AgentScheduleWorker: call init() before start() | exception | error | worker, initialization, lifecycle |
MASTRA_SERVER_API_INVALID_ROUTE_OPTIONS Invalid options for route "${path}", missing "method" property | error_code | error | server, api-routes, validation, config |
| [${this.id}] Cannot send notification: no agent connected. W | exception | error | signals, wiring, initialization |
| Invalid skill "${name}": ${validation.errors.join('; ')} | validation | error | skills, validation, schema |
| ENOENT: no such file or directory: ${path} | exception | error | skills, filesystem, not-found |
| perPage must be >= 0 | exception | error | storage, pagination, validation |
| ${name}: id must be provided and cannot be empty. | exception | error | storage, configuration, validation |
| MastraCompositeStore requires at least one storage source. P | exception | error | storage, configuration, composite-store |
| Agent with id ${agent.id} already exists | exception | error | storage, duplicate, in-memory |
| Agent with id ${id} not found | exception | error | storage, not-found, in-memory |
| page must be >= 0 | exception | error | storage, pagination, validation |
| page value too large | exception | error | storage, pagination, validation |
| Version with id ${input.id} already exists | exception | error | storage, duplicate, versioning |
| Version number ${input.versionNumber} already exists for age | exception | error | storage, duplicate, versioning |
| Source provider ${this.provider.displayName} cannot read fil | exception | error | storage, agents, configuration, source-provider |
| Agent with id ${input.agent.id} already exists | exception | error | storage, agents, duplicate-key, conflict |
| Version with id ${input.id} already exists | exception | error | storage, agents, versioning, duplicate-key |
| Version number ${input.versionNumber} already exists for age | exception | error | storage, agents, versioning, conflict |
| Source provider ${this.provider.displayName} cannot write fi | exception | error | storage, agents, permissions, source-provider, write |
DATASET_INVALID_ID Caller-defined dataset ID must not be empty | error_code | error | storage, datasets, validation, user-input |
DATASET_ID_CONFLICT Dataset ID "${input.id}" is already in use with incompatible immutable fields | error_code | error | storage, datasets, conflict, immutability |
| Dataset not found: ${args.id} | exception | error | storage, datasets, not-found, user-input |
| SchemaUpdateValidationError | exception | error | storage, datasets, schema, validation |
| Dataset not found: ${args.datasetId} | exception | error | storage, datasets, not-found, items |
| Dataset not found: ${input.datasetId} | exception | error | storage, datasets, not-found |
| Dataset item identity history is corrupt for externalId: ${r | exception | error | storage, datasets, data-corruption, scd2 |
DATASET_ITEM_EXTERNAL_ID_INVALID Dataset item externalId must be a non-empty string. | error_code | error | storage, datasets, validation, user-input |
| Dataset not found: ${args.id} | exception | error | storage, datasets, in-memory, not-found |
| Dataset not found: ${args.datasetId} | exception | error | storage, datasets, in-memory, not-found |
| Item not found: ${args.id} | exception | error | storage, datasets, in-memory, not-found |
| Item ${args.id} does not belong to dataset ${args.datasetId} | exception | error | storage, datasets, in-memory, ownership |
| Item ${id} does not belong to dataset ${datasetId} | exception | error | storage, datasets, inmemory, ownership-mismatch |
| Dataset not found: ${datasetId} | exception | error | storage, datasets, inmemory, missing-resource |
| Dataset not found: ${input.datasetId} | exception | error | storage, datasets, inmemory, missing-resource |
| Dataset item identity history is corrupt for externalId: ${f | exception | critical | storage, datasets, inmemory, corruption, invariant |
DATASET_ITEM_PAYLOAD_NOT_SERIALIZABLE Dataset item payload must be JSON-serializable: ${issue.reason}. | error_code | error | storage, datasets, serialization, json, user-error |
| Experiment not found: ${input.id} | exception | error | storage, experiments, inmemory, missing-resource |
| Experiment result not found: ${input.id} | exception | error | storage, experiments, inmemory, missing-resource |
| Experiment result ${input.id} does not belong to experiment | exception | error | storage, experiments, inmemory, ownership-mismatch |
| Cannot favorite: ${entityType} with id ${entityId} does not | exception | error | storage, in-memory, entity-not-found, favorites |
| Harness session "${sessionId}" was not found | exception | error | storage, harness, session-not-found |
| Harness pending item "${item.id}" already exists on session | exception | error | storage, harness, duplicate-id, pending-items |
| Harness pending item "${pendingItemId}" was not found on ses | exception | error | storage, harness, pending-item-not-found |
| Harness session "${sessionId}" was not found | exception | error | storage, harness, in-memory, session-not-found |
| Invalid knowledge node cursor. | exception | error | storage, knowledge, pagination, cursor, validation |
| Knowledge node cursor does not match the active browse filte | exception | error | pagination, cursor, knowledge, validation |
| Invalid knowledge scope entry: ${entry} | exception | error | knowledge, scope, validation, input-format |
| Knowledge scope contains multiple ${level} entries | exception | error | knowledge, scope, validation, duplicate |
| Knowledge scope cannot be empty | exception | error | knowledge, scope, validation, empty-input |
| Thread knowledge scope requires resource and org ancestors | exception | error | knowledge, scope, hierarchy, validation |
| Resource knowledge scope requires an org ancestor | exception | error | knowledge, scope, hierarchy, validation |
| Cannot expand knowledge scope to ${level}: context has no ${ | exception | error | knowledge, scope, hierarchy, validation |
| Knowledge node description exceeds the ${MAX_KNOWLEDGE_NODE_ | exception | error | knowledge, validation, length-limit, write-rejected |
| Knowledge scope exceeds ${maxScope} ceiling | exception | error | knowledge, scope, ceiling, authorization |
| Knowledge ceiling cannot be lowered from ${currentMaxScope} | exception | error | knowledge, ceiling, monotonic-state, validation |
| Merged knowledge node is not visible from scope: ${input.nam | exception | error | knowledge-store, scope-visibility, merge-conflict, inmemory |
| Knowledge node already exists: ${node.id} | exception | error | knowledge-store, duplicate-id, inmemory, idempotency |
| Knowledge node not found: ${id} | exception | error | knowledge-store, not-found, update, inmemory |
| Knowledge record version conflict: ${id} | exception | error | knowledge-store, optimistic-concurrency, version-conflict, retry |
| Cannot update merged knowledge node: ${input.id} | exception | error | knowledge-store, merged-node, tombstone, update |
| Knowledge node already exists in scope: ${name} | exception | error | knowledge-store, name-collision, unique-constraint, rename |
| Cannot merge a knowledge node into itself | exception | error | knowledge-store, merge, invalid-argument, self-reference |
| Cannot create a knowledge merge cycle | exception | error | knowledge, merge, cycle, inmemory-storage |
| Cannot merge a knowledge node into a target that is narrower | exception | error | knowledge, merge, scope, visibility |
| Knowledge already exists: ${record.id} | exception | error | knowledge, duplicate, id-collision, append |
| Knowledge record not found: ${id} | exception | error | knowledge, not-found, delete, idempotency |
| record | exception | error | knowledge, not-found, scope, rescope |
| Knowledge curation cursor cannot move backwards | exception | error | knowledge, cursor, curation, ordering |
| Knowledge merge cycle detected at ${node.id} | exception | critical | knowledge, merge, cycle, corruption, concurrency |
| MCP client with id ${mcpClient.id} already exists | exception | error | storage, duplicate-id, mcp-client, in-memory |
| MCP client with id ${id} not found | exception | error | storage, not-found, mcp-client, in-memory |
| page must be >= 0 | exception | error | pagination, validation, argument-error, in-memory |
| page value too large | exception | error | pagination, validation, argument-error, in-memory |
| Version with id ${input.id} already exists | exception | error | storage, duplicate-id, versioning, mcp-client, in-memory |
| Version number ${input.versionNumber} already exists for MCP | exception | error | storage, duplicate, versioning, mcp-client, in-memory |
| MCP server with id ${mcpServer.id} already exists | exception | error | storage, duplicate-id, mcp-server, in-memory |
| MCP server with id ${id} not found | exception | error | storage, not-found, mcp-server, in-memory |
| page must be >= 0 | exception | error | pagination, validation, storage |
| page value too large | exception | error | pagination, validation, storage |
| Version with id ${input.id} already exists | exception | error | duplicate-key, storage, uniqueness |
| Version number ${input.versionNumber} already exists for MCP | exception | error | duplicate-key, storage, uniqueness |
| Resource-scoped message listing is not implemented by this s | exception | error | storage, unsupported-operation, observational-memory |
| Message deletion is not supported by this storage adapter ($ | exception | error | storage, unsupported-operation, memory |
| Thread cloning is not implemented by this storage adapter ($ | exception | error | storage, unsupported-operation, memory |
| Resource working memory is not implemented by this storage a | exception | error | storage, unsupported-operation, working-memory, bug |
| Observational memory is not implemented by this storage adap | exception | error | storage, observational-memory, unimplemented-method |
| Invalid metadata key: "${key}". | validation | error | validation, metadata, prototype-pollution, storage |
| Invalid metadata key: "${key}". Keys must start with a lette | validation | error | validation, storage, metadata |
| Metadata key "${key}" exceeds maximum length of ${MAX_METADA | validation | error | validation, storage, metadata |
| page must be >= 0 | validation | error | validation, pagination, storage |
| perPage must be >= 0 | validation | error | validation, pagination, storage |
| page value too large | validation | error | validation, pagination, overflow |
| perPage must be false or a safe integer | validation | error | validation, pagination, types |
| page must be 0 when perPage is false | validation | error | validation, pagination, storage |
| Thread with id ${id} not found | exception | error | storage, not-found, in-memory |
| threadId must be a non-empty string or array of non-empty st | validation | error | validation, pagination, storage, argument-error |
| page must be >= 0 | validation | error | validation, pagination, storage, argument-error |
| page value too large | validation | error | validation, pagination, storage, argument-error |
| Source thread with id ${sourceThreadId} not found | exception | error | storage, not-found, thread, state |
| Thread with id ${newThreadId} already exists | exception | error | storage, conflict, duplicate-id, thread |
| Observational memory record not found: ${id} | exception | error | storage, not-found, observational-memory, state |
| Observational memory record not found: ${currentRecord.id} | exception | error | memory, in-memory-storage, observational-memory |
| No buffered reflection to swap | exception | error | memory, observational-memory, state-conflict |
| Observational memory record not found: ${input.id} | exception | error | memory, in-memory-storage, configuration |
OBSERVABILITY_CREATE_SPAN_NOT_IMPLEMENTED This storage provider does not support creating spans | error_code | error | observability, storage, tracing, unsupported-feature |
OBSERVABILITY_STORAGE_UPDATE_SPAN_NOT_IMPLEMENTED This storage provider does not support updating spans | error_code | error | storage, observability, tracing, unsupported-operation |
OBSERVABILITY_STORAGE_GET_SPAN_NOT_IMPLEMENTED This storage provider does not support getting spans | error_code | error | storage, observability, tracing, unsupported-operation |
OBSERVABILITY_STORAGE_GET_ROOT_SPAN_NOT_IMPLEMENTED This storage provider does not support getting root spans | error_code | error | storage, observability, tracing, unsupported-operation |
OBSERVABILITY_STORAGE_GET_TRACE_NOT_IMPLEMENTED This storage provider does not support getting traces | error_code | error | storage, observability, tracing, unsupported-operation |
OBSERVABILITY_STORAGE_GET_STRUCTURE_NOT_IMPLEMENTED This storage provider does not support getting trace structure | error_code | error | storage, observability, tracing, unsupported-operation |
OBSERVABILITY_STORAGE_GET_TRACE_LIGHT_NOT_IMPLEMENTED This storage provider does not support getting lightweight traces | error_code | warning | storage, observability, tracing, deprecated-api, unsupported-operation |
OBSERVABILITY_STORAGE_GET_SPANS_NOT_IMPLEMENTED This storage provider does not support batch-fetching spans | error_code | error | storage, observability, tracing, batch, unsupported-operation |
OBSERVABILITY_STORAGE_LIST_TRACES_NOT_IMPLEMENTED This storage provider does not support listing traces | error_code | error | storage, observability, tracing, pagination, unsupported-operation |
OBSERVABILITY_STORAGE_LIST_BRANCHES_NOT_IMPLEMENTED This storage provider does not support listing trace branches | error_code | error | storage, observability, tracing, branches, unsupported-operation |
OBSERVABILITY_STORAGE_BATCH_CREATE_SPAN_NOT_IMPLEMENTED This storage provider does not support batch creating spans | error_code | error | storage, observability, tracing, batch, unsupported-operation |
OBSERVABILITY_STORAGE_BATCH_UPDATE_SPANS_NOT_IMPLEMENTED This storage provider does not support batch updating spans | error_code | error | storage, observability, not-implemented, spans, batch |
OBSERVABILITY_STORAGE_BATCH_DELETE_TRACES_NOT_IMPLEMENTED This storage provider does not support batch deleting traces | error_code | error | storage, observability, not-implemented, traces, batch-delete |
OBSERVABILITY_STORAGE_BATCH_CREATE_LOGS_NOT_IMPLEMENTED This storage provider does not support batch creating logs | error_code | error | storage, observability, not-implemented, logs, batch |
OBSERVABILITY_STORAGE_LIST_LOGS_NOT_IMPLEMENTED This storage provider does not support listing logs | error_code | error | storage, observability, not-implemented, logs, query |
OBSERVABILITY_STORAGE_BATCH_CREATE_METRICS_NOT_IMPLEMENTED This storage provider does not support batch creating metrics | error_code | error | storage, observability, not-implemented, metrics, batch |
OBSERVABILITY_STORAGE_LIST_METRICS_NOT_IMPLEMENTED This storage provider does not support listing metrics | error_code | error | storage, observability, metrics, not-implemented |
OBSERVABILITY_STORAGE_GET_METRIC_AGGREGATE_NOT_IMPLEMENTED This storage provider does not support metric aggregation | error_code | error | storage, observability, metrics, aggregation, not-implemented |
OBSERVABILITY_STORAGE_GET_METRIC_BREAKDOWN_NOT_IMPLEMENTED This storage provider does not support metric breakdown | error_code | error | storage, observability, metrics, breakdown, not-implemented |
OBSERVABILITY_STORAGE_GET_METRIC_TIME_SERIES_NOT_IMPLEMENTED This storage provider does not support metric time series | error_code | error | storage, observability, metrics, time-series, not-implemented |
OBSERVABILITY_STORAGE_GET_METRIC_PERCENTILES_NOT_IMPLEMENTED This storage provider does not support metric percentiles | error_code | error | storage, observability, metrics, percentiles, not-implemented |
OBSERVABILITY_STORAGE_GET_METRIC_NAMES_NOT_IMPLEMENTED This storage provider does not support metric name discovery | error_code | warning | storage, observability, not-implemented, metrics |
OBSERVABILITY_STORAGE_GET_METRIC_LABEL_KEYS_NOT_IMPLEMENTED This storage provider does not support metric label key discovery | error_code | warning | storage, observability, not-implemented, metrics |
OBSERVABILITY_STORAGE_GET_LABEL_VALUES_NOT_IMPLEMENTED This storage provider does not support label value discovery | error_code | warning | storage, observability, not-implemented, metrics |
OBSERVABILITY_STORAGE_GET_ENTITY_TYPES_NOT_IMPLEMENTED This storage provider does not support entity type discovery | error_code | warning | storage, observability, not-implemented, telemetry |
OBSERVABILITY_STORAGE_GET_ENTITY_NAMES_NOT_IMPLEMENTED This storage provider does not support entity name discovery | error_code | warning | storage, observability, not-implemented, telemetry |
OBSERVABILITY_STORAGE_GET_SERVICE_NAMES_NOT_IMPLEMENTED This storage provider does not support service name discovery | error_code | warning | storage, observability, not-implemented, telemetry |
OBSERVABILITY_STORAGE_GET_ENVIRONMENTS_NOT_IMPLEMENTED This storage provider does not support environment discovery | error_code | warning | storage, observability, not-implemented, telemetry |
OBSERVABILITY_STORAGE_GET_TAGS_NOT_IMPLEMENTED This storage provider does not support tag discovery | error_code | warning | storage, observability, not-implemented, telemetry |
OBSERVABILITY_STORAGE_CREATE_SCORE_NOT_IMPLEMENTED This storage provider does not support creating scores | error_code | error | storage, observability, not-implemented, scores |
OBSERVABILITY_STORAGE_BATCH_CREATE_SCORES_NOT_IMPLEMENTED This storage provider does not support batch creating scores | error_code | error | storage, observability, not-implemented, scores, batch |
OBSERVABILITY_STORAGE_LIST_SCORES_NOT_IMPLEMENTED This storage provider does not support listing scores | error_code | error | storage, observability, not-implemented, scores |
OBSERVABILITY_STORAGE_GET_SCORE_BY_ID_NOT_IMPLEMENTED This storage provider does not support getting scores by ID | error_code | error | storage, observability, not-implemented, scores |
OBSERVABILITY_STORAGE_GET_SCORE_AGGREGATE_NOT_IMPLEMENTED This storage provider does not support score aggregation | error_code | error | storage, observability, not-implemented, aggregation |
OBSERVABILITY_STORAGE_GET_SCORE_BREAKDOWN_NOT_IMPLEMENTED This storage provider does not support score breakdown | error_code | error | storage, observability, not-implemented, analytics |
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 |
OBSERVABILITY_STORAGE_GET_SCORE_PERCENTILES_NOT_IMPLEMENTED This storage provider does not support score percentiles | error_code | error | storage, observability, not-implemented, percentiles |
OBSERVABILITY_STORAGE_CREATE_FEEDBACK_NOT_IMPLEMENTED This storage provider does not support creating feedback | error_code | error | storage, observability, not-implemented, feedback |
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 |
OBSERVABILITY_STORAGE_LIST_FEEDBACK_NOT_IMPLEMENTED This storage provider does not support listing feedback | error_code | error | storage, observability, not-implemented, feedback |
OBSERVABILITY_STORAGE_GET_FEEDBACK_AGGREGATE_NOT_IMPLEMENTED This storage provider does not support feedback aggregation | error_code | error | storage, observability, not-implemented, feedback, aggregation |
OBSERVABILITY_STORAGE_GET_FEEDBACK_BREAKDOWN_NOT_IMPLEMENTED This storage provider does not support feedback breakdown | error_code | error | storage, observability, not-implemented, feedback |
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 |
OBSERVABILITY_STORAGE_GET_FEEDBACK_PERCENTILES_NOT_IMPLEMENTED This storage provider does not support feedback percentiles | error_code | error | storage, observability, not-implemented, feedback, percentiles |
OBSERVABILITY_DELTA_POLLING_NOT_SUPPORTED This storage provider does not support observability delta polling | error_code | error | storage, observability, in-memory, feature-flag, delta-polling |
OBSERVABILITY_MISSING_RECORD_ID Observability record is missing required id field '${String(idField)}' | error_code | error | storage, observability, validation, missing-id |
OBSERVABILITY_INVALID_DELTA_CURSOR Invalid observability delta cursor | error_code | warning | storage, observability, cursor, validation |
OBSERVABILITY_SPAN_ID_REQUIRED Span ID is required for creating a span | error_code | error | storage, observability, tracing, missing-id |
OBSERVABILITY_TRACE_ID_REQUIRED Trace ID is required for creating a span | error_code | error | storage, observability, tracing, missing-id, trace-context |
OBSERVABILITY_UPDATE_SPAN_NOT_FOUND Trace not found for span update | error_code | error | storage, observability, tracing, not-found, in-memory |
| Version number ${input.versionNumber} already exists for pro | exception | error | storage, duplicate-key, prompt-blocks, in-memory |
| Schedule ${schedule.id} already exists | exception | error | storage, duplicate-key, schedules, in-memory |
| Schedule ${id} not found | exception | error | storage, not-found, schedules, in-memory |
| Scorer definition with id ${scorerDefinition.id} already exi | exception | error | storage, duplicate-key, scorer-definitions, in-memory |
| Scorer definition with id ${id} not found | exception | error | storage, not-found, scorer-definitions, in-memory |
| page must be >= 0 | validation | error | storage, pagination, argument-validation, scorer-definitions |
| page value too large | validation | error | storage, pagination, argument-validation, scorer-definitions |
| Version with id ${input.id} already exists | exception | error | storage, duplicate-key, scorer-definitions, in-memory |
| Version number ${input.versionNumber} already exists for sco | exception | error | storage, duplicate-version, scorer-definitions, in-memory |
SCORES_STORAGE_GET_SCORES_BY_SPAN_NOT_IMPLEMENTED SCORES_STORAGE_GET_SCORES_BY_SPAN_NOT_IMPLEMENTED | error_code | error | storage, not-implemented, scores, unsupported-operation |
| FilesystemSkillsStorage: skill with id ${id} not found | exception | error | storage, filesystem, not-found, skills |
| No versions found for skill ${id} | exception | error | storage, filesystem, corrupt-state, skills, versions |
| Skill with id ${skill.id} already exists | exception | error | storage, duplicate-key, skills, in-memory, idempotency |
| Skill with id ${id} not found | exception | error | storage, not-found, skills, in-memory |
| No versions found for skill ${id} | exception | error | storage, corrupt-state, skills, in-memory, versions |
| page must be >= 0 | validation | error | storage, pagination, validation, in-memory |
| page value too large | validation | error | pagination, argument-validation, storage |
| Version with id ${input.id} already exists | exception | error | duplicate-key, idempotency, storage |
| Version number ${input.versionNumber} already exists for ski | exception | error | duplicate-key, versioning, storage |
| Cannot create workflow definition "${input.id}": inputSchema | exception | error | schema-validation, workflow, missing-field |
| Snapshot not found for runId ${runId} | exception | error | workflow, missing-state, snapshot |
| page must be >= 0 | validation | error | pagination, argument-validation, storage |
| Workspace with id ${workspace.id} already exists | exception | error | duplicate-key, idempotency, storage |
| Workspace with id ${id} not found | exception | error | storage, workspace, not-found, in-memory |
| No versions found for workspace ${id} | exception | error | storage, workspace, versioning, in-memory |
| page must be >= 0 | validation | error | pagination, validation, storage, workspace |
| page value too large | validation | error | pagination, validation, storage, workspace |
| Version with id ${input.id} already exists | exception | error | storage, workspace, duplicate-key, versioning |
| Version number ${input.versionNumber} already exists for wor | exception | error | storage, workspace, duplicate-key, versioning |
| Factory storage domain name must not be empty | exception | error | storage, factory, validation, configuration |
| Factory storage domain '${this.name}' is already bound to an | exception | error | storage, factory, lifecycle, dependency-injection |
| Factory storage domain '${this.name}' has not been registere | exception | error | storage, initialization, lifecycle |
| Factory storage domain '${domain.name}' is already registere | exception | error | storage, duplicate-registration, lifecycle |
| Factory storage domain '${name}' is not registered | exception | error | storage, initialization, lookup |
| Path traversal detected: directory "${directory}" escapes st | exception | error | security, path-traversal, filesystem |
| Configured domain path "${directory}" is a file, expected a | exception | error | filesystem, storage, configuration |
| Path traversal detected: file "${filename}" escapes storage | exception | error | security, path-traversal, filesystem |
| Path traversal detected: skill name "${skillName}" escapes s | exception | error | security, path-traversal, skills, filesystem |
| Path traversal detected: "${relativePath}" escapes skill dir | exception | error | security, path-traversal, skills, zip-slip |
| ${this.name}: per-entity files directory is not configured | exception | error | storage, configuration, filesystem |
| ${this.name}: entity with id ${id} already exists | exception | error | storage, duplicate-key, filesystem |
| ${this.name}: entity with id ${id} not found | exception | error | storage, not-found, filesystem |
| page must be >= 0 | validation | error | storage, pagination, validation |
| ${this.name}: version with id ${input.id} already exists | exception | error | storage, versioning, duplicate-key |
| ${this.name}: version number ${input.versionNumber} already | exception | error | storage, versioning, conflict |
| Not a git repository: ${dir} | exception | error | git, filesystem, configuration |
| GitHub source control request failed: ${res.status} | exception | error | network, github, http |
TOOL_MOCK_MISMATCH TOOL_MOCK_MISMATCH | error_code | error | datasets, tool-mocking, evaluation |
| Invalid retention duration: ${duration}. Must be a non-negat | validation | error | validation, configuration, duration |
| Invalid retention duration: "${duration}". Expected a number | validation | error | validation, configuration, storage |
| Metadata filter must be an object. | validation | error | validation, storage, metadata |
| Invalid metadata filter key "${key}". | validation | error | validation, storage, metadata |
| Invalid metadata filter value for key "${key}". Values must | validation | error | validation, storage, metadata |
| Snapshot context not found for runId ${snapshot?.runId} | exception | error | workflow, storage, state |
INVALID_DATA_URL_FORMAT Invalid data URL format in content ${content.toString()} | exception | error | validation, data-url, multimodal, aisdk |
| Unsupported tool type: ${exhaustiveCheck} | exception | error | tools, exhaustiveness, aisdk, internals |
| Unknown chunk type: ${exhaustiveCheck} | exception | error | streaming, aisdk, exhaustiveness, internals |
| Cannot convert URL-backed generated file to Uint8Array. Down | exception | error | files, generated-files, url, aisdk |
| AISDKv5 chunk type "reasoning-signature" not supported | exception | error | streaming, reasoning, aisdk, unsupported |
| AISDKv5 chunk type "redacted-reasoning" not supported | exception | error | streaming, ai-sdk-v5, reasoning, unsupported-type |
| The chunking function must return a non-empty string. | validation | error | streaming, smooth-stream, validation, typeerror |
| The chunking function must return a prefix of the buffered t | validation | error | streaming, smooth-stream, validation, typeerror |
| chunking must be "word", "line", a RegExp, an Intl.Segmenter | validation | error | streaming, smooth-stream, validation, configuration |
| The chunking RegExp must match a non-empty string. | validation | error | streaming, smooth-stream, regex, validation |
| prepareStep returned an unsupported model version | exception | error | agent, prepare-step, model-version, configuration |
| Could not extract settings from ToolLoopAgent. The agent may | exception | error | agent, version-compatibility, reflection, internal-api |
| URL resolves to a private or reserved address. | exception | error | security, ssrf, web-fetch, validation |
| Too many redirects. Maximum is ${MAX_REDIRECTS}. | exception | error | network, http, redirects, web-fetch |
| Redirect target must use HTTP or HTTPS. | exception | error | network, http, redirects, security, web-fetch |
WEB_SEARCH_UNSUPPORTED_PROVIDER The built-in webSearchTool supports OpenAI, Anthropic, Google, and xAI models. C | exception | error | web-search, unsupported-provider, agent-config, user-error |
| Code Mode requires a sandbox to run model-authored code, but | exception | error | code-mode, sandbox, configuration, missing-dependency |
| Tool "${toolId}" is not available in Code Mode | exception | error | code-mode, tool-dispatch, missing-tool, runtime |
| Invalid input for tool "${toolId}" | exception | error | code-mode, input-validation, schema, tool-dispatch |
| Invalid Code Mode external identifier: ${externalName} | exception | error | code-mode, identifier, naming, validation |
| Code Mode external identifier collision: tools "${existing}" | exception | error | code-mode, identifier-collision, naming, validation |
| Code Mode tool id collision: "${prior}" and "${toolId}" both | exception | error | code-mode, stub-generation, identifier-collision, naming |
| StdioCodeModeTransport requires a sandbox | exception | error | code-mode, sandbox, transport, configuration |
| processes | exception | error | code-mode, sandbox, processes, feature-support |
| Tool parameters are required | exception | error | tool-builder, input-schema, v5, validation |
| Your schema is async, which is not supported. Please use a s | exception | error | schema, validation, async, standard-schema |
| Unable to persist request context key "${key}": the value is | exception | error | request-context, schema, encoding, validation |
| Your schema is async, which is not supported. Please use a s | validation | error | schema, validation, async, tools |
| Schema validation failed due to an invalid schema definition | validation | error | schema, validation, zod, union, circular-import |
TOOL_INVALID_FORMAT TOOL_INVALID_FORMAT | error_code | error | tools, configuration, type-error |
| Invalid ${kind}: ${name}. Must start with a letter or unders | validation | error | sql, validation, identifier, injection-prevention |
| Field key cannot be empty | validation | error | sql, validation, field-key, storage |
| Invalid field key segment: ${segment} in ${key} | validation | error | sql, validation, field-key, json-path |
| validation.messages.join(', ') | validation | error | vector, filter, validation, compatibility |
| Vectors array cannot be empty | error_code | error | validation, vector-store, upsert |
| Metadata array length must match vectors array length | error_code | error | validation, vector-store, upsert, metadata |
| IDs array length must match vectors array length | error_code | error | validation, vector-store, upsert, ids |
| topK must be a positive integer | error_code | error | validation, vector-store, query, topk |
| Vector at index ${i} is null or undefined | error_code | error | validation, vector-store, upsert, null-check |
| Vector contains invalid value (null, undefined, NaN, or Infi | error_code | error | validation, vector-store, upsert, numeric |
VECTOR_INVALID_ID Vector id must be provided and cannot be empty | error_code | error | configuration, vector-store, constructor |
| StepExecutionError(res.status, text) | http | error | network, http, worker, remote-execution |
| HttpRemoteStrategy: requestContext is not JSON-serializable. | exception | error | serialization, worker, http, request-context |
| InProcessStrategy requires Mastra instance. Call __registerM | exception | error | worker, initialization, in-process, lifecycle |
| InProcessStrategy: could not resolve step "${params.stepId}" | exception | error | workflow, configuration, step-resolution |
| BackgroundTaskWorker: call init() before start() | exception | error | lifecycle, worker, initialization |
| BackgroundTaskWorker: failed to initialize background task m | exception | error | worker, initialization, manager |
| OrchestrationWorker requires Mastra instance | exception | error | worker, configuration, dependency-injection |
| OrchestrationWorker requires a pull-capable PubSub, but the | exception | error | pubsub, worker, configuration, incompatible-transport |
| OrchestrationWorker: call init() before start() | exception | error | lifecycle, worker, initialization |
| OrchestrationWorker not initialized | exception | error | worker, lifecycle, race-condition |
| ${path} must contain only finite numbers. | validation | error | validation, json, workflow-builder |
| ${path} must be JSON-safe. | validation | error | validation, json, workflow-builder |
| ${path} must not contain cycles. | validation | error | validation, json, circular-reference, workflow-builder |
| ${path} must contain only plain objects. | validation | error | validation, json-serialization, workflow |
| Workflow definition graph must be an array. | validation | error | validation, workflow, schema |
| Agent '${entry.agentId}' not found for workflow step '${entr | exception | error | workflow, agent, runtime-lookup |
| Tool '${entry.toolId}' not found for workflow step '${entry. | exception | error | workflow, tool, runtime-lookup |
| ${message} | exception | error | json-schema, zod, schema-conversion |
| Stored mapping step "${stepId}" has invalid JSON mapConfig: | exception | error | json, persistence, mapping |
| Stored sleep "${entry.id}" missing literal duration. | exception | error | workflow, persistence, validation |
| Stored sleepUntil "${entry.id}" missing literal date. | exception | error | workflow, persistence, date |
| Stored sleepUntil "${entry.id}" has an unparseable date: ${S | exception | error | workflow, date, persistence |
| Foreach step cannot iterate a mapping: mappings project data | exception | error | workflow, foreach, validation |
| Cannot rehydrate conditional step: missing or mismatched pre | exception | error | workflow, serialization, rehydration, conditional |
| Cannot rehydrate loop step: missing declarative predicate or | exception | error | workflow, serialization, loop, rehydration |
| Unknown stored step type: ${JSON.stringify(_exhaustive)} | exception | error | workflow, serialization, exhaustiveness, version-mismatch |
| Dynamic workflow references agent "${entry.agentId}" which i | exception | error | workflow, agent, registration, rehydration |
| Dynamic workflow references tool "${entry.toolId}" which is | exception | error | workflow, tool, registration, rehydration |
| Dynamic workflow references step "${id}" which is not regist | exception | error | workflow, step, registration, rehydration |
| mapping entries cannot appear inside .parallel(), .branch(), | exception | error | workflow, mapping, structure, rehydration |
| Mapping references unknown workflow init-data "${source.init | exception | error | workflow, mapping, registration, rehydration |
| Dynamic workflow references nested workflow "${workflowId}" | exception | error | workflow, nested-workflow, registration, rehydration |
| Sleep step "${entry.id}" cannot be stored: dynamic duration | exception | error | workflow, serialization, sleep, dynamic-duration |
| SleepUntil step "${entry.id}" cannot be stored: dynamic date | exception | error | workflows, serialization, closure |
| Foreach step cannot iterate a mapping: mappings project data | exception | error | workflows, serialization, foreach, misuse |
| Conditional (branch) step cannot be stored: closure predicat | exception | error | workflows, serialization, closure, conditional |
| Loop step "${getSingleStepEntryId(entry.step)}" cannot be st | exception | error | workflows, serialization, closure, loop |
| Unknown step entry type: ${JSON.stringify(_exhaustive)} | exception | error | workflows, serialization, exhaustiveness, schema-mismatch |
| Mapping step "${entry.id}" cannot be stored: the function fo | exception | error | workflows, serialization, closure, mapping |
| Mapping step "${entry.id}" key "${key}" cannot be stored: so | exception | error | workflows, serialization, closure, mapping |
| ${kind === 'agent' ? 'Agent' : 'Tool'} step "${entryId}" can | exception | error | workflows, serialization, closure, callbacks |
| ${kind === 'agent' ? 'Agent' : 'Tool'} step "${entryId}" can | exception | error | workflows, serialization, closure, scorers |
| Agent step "${entryId}" cannot be stored: structuredOutput.s | exception | error | workflows, serialization, schema, structured-output |
| Dynamic workflow "${def.id}" failed validation with ${issues | validation | error | validation, workflows, dynamic-workflows |
| Agent '${entry.agentId}' not found for workflow step '${entr | exception | error | workflows, agents, configuration, registry |
| ${tripwireChunk.payload?.reason || 'Agent tripwire triggered | exception | warning | workflows, agents, tripwire, processors, streaming |
| Tool '${entry.toolId}' not found for workflow step '${entry. | exception | error | workflows, tools, configuration, registry |
| No Pubsub adapter configured on the Mastra instance | exception | error | workflows, evented, pubsub, configuration |
| Not implemented | exception | error | workflows, evented, not-implemented, bail |
| Invalid input: expected StepParams, Agent, ToolStep, or Proc | exception | error | workflow, validation, api-misuse, typescript |
| Agent step "${params.id}" uses a legacy v1 model but does no | exception | error | agent, workflow, version-compat, legacy-model |
| Tool must have input and output schemas defined | exception | error | tool, schema, validation, workflow |
| Tool ${params.id} does not have an execute function | exception | error | tool, runtime, execute, workflow |
| Tripwire triggered by ${processor.id} | exception | warning | processor, tripwire, guardrail, stream |
PROCESSOR_MISSING_MESSAGE_LIST Processor ${processor.id} requires messageList or messages for processInput phas | error_code | error | processor, messagelist, workflow, input-validation |
PROCESSOR_RETURNED_EXTERNAL_MESSAGE_LIST Processor ${processor.id} returned a MessageList instance other than the one pas | error_code | error | processor, messagelist, immutability, workflow |
| Workflow "${params.id}" declares an array of schedules but o | validation | error | workflow, scheduling, configuration, validation |
| Workflow "${params.id}" declares duplicate schedule id "${en | validation | error | workflow, scheduling, configuration, validation |
| Execution flow of workflow is not defined. Add steps to the | exception | error | workflow, configuration, definition, missing-steps |
| Uncommitted step flow changes detected. Call .commit() to re | exception | error | workflow, configuration, commit, lifecycle |
ATOMIC_STORAGE_OPERATIONS_NOT_SUPPORTED Workflow "${this.id}" runs on the evented execution engine, which requires a sto | error_code | error | storage, workflow, scheduling, configuration, evented-engine |
| Mastra instance with pubsub is required for workflow executi | exception | error | workflow, pubsub, configuration, evented |
| Cannot resume workflow: workflows store is required | exception | error | workflow, storage, resume, configuration |
| Cannot resume workflow: no snapshot found for runId ${this.r | exception | error | workflow, storage, resume, missing-snapshot |
| This workflow run was not suspended | exception | error | workflow, resume, state |
| Resume label "${params.label}" not found. Available labels: | exception | error | workflow, resume, label, configuration |
| No suspended steps found in this workflow run | exception | error | workflow, resume, suspended-step |
| Multiple suspended steps found: ${pathStrings.join(', ')}. P | exception | error | workflow, resume, ambiguity, suspend |
| This workflow step "${steps?.[0]}" was not suspended. Availa | exception | error | workflow, resume, suspend, validation |
| Invalid path ${path} in ${errorLabel} | exception | error | workflow, mapping, path-traversal, configuration |
| ${describeBadPlaceholder(template, idx, rawExpr)} has empty | validation | error | workflow, template, mapping, syntax |
| ${describeBadPlaceholder(template, idx, rawExpr)} must be of | validation | error | workflow, template, mapping, syntax |
| ${describeBadPlaceholder(template, idx, rawExpr)} requires a | validation | error | workflow, template, request-context, syntax |
| ${describeBadPlaceholder(template, idx, rawExpr)} references | validation | error | workflow, template, mapping, namespace |
| ${describeBadPlaceholder(template, idx, rawExpr)} resolved t | exception | error | workflow, template, serialization, json |
| ${label} references stepResults.${stepId} but step "${stepId | exception | error | workflow, template, step-results, ordering |
| ${label} references unknown namespace "${scope}". Use one of | exception | error | workflows, mapping-template, template-validation |
| Invalid cron expression: expected a non-empty cron string (e | validation | error | workflows, scheduler, cron, validation |
| Invalid cron expression "${cron}": ${reason} | validation | error | workflows, scheduler, cron, validation |
| Invalid timezone "${timezone}": ${reason} | exception | error | workflows, scheduler, cron, timezone |
| Cron expression "${cron}" has no future occurrence after ${r | exception | error | workflows, scheduler, cron, scheduling |
| Unsupported schedule target type: ${(schedule.target as { ty | exception | error | workflows, scheduler, unsupported-target, dispatch |
| Tool must have input and output schemas defined | exception | error | workflows, tools, schema-validation, step-factory |
| Cannot time travel to step '${targetStepId}': the step does | exception | error | workflows, time-travel, snapshot-mismatch, execution-graph |
| Cannot time travel to step '${targetStepId}': step(s) ${miss | exception | error | workflows, time-travel, snapshot-mismatch, execution-graph |
| Time travel target step not found in execution graph: '${ste | exception | error | workflows, time-travel, execution-graph, invalid-path |
| This workflow run was not active | exception | error | workflow, resume, state |
| Invalid input: expected StepParams, Agent, ToolStep, or Proc | exception | error | workflow, types, configuration |
| Tripwire triggered by ${processor.id} | exception | warning | workflow, processor, tripwire, abort |
PROCESSOR_MISSING_MESSAGE_LIST Processor ${processor.id} requires messageList or messages for processInput phas | error_code | error | workflow, processor, messages |
PROCESSOR_RETURNED_EXTERNAL_MESSAGE_LIST Processor ${processor.id} returned a MessageList instance other than the one pas | error_code | error | workflow, processor, messagelist |
WORKFLOW_WAIT_FOR_EVENT_REMOVED waitForEvent has been removed. Please use suspend & resume flow instead. See htt | error_code | error | workflow, removed-api, migration, suspend-resume |
| Execution flow of workflow is not defined. Add steps to the | exception | error | workflow, configuration, missing-steps |
| Uncommitted step flow changes detected. Call .commit() to re | exception | error | workflow, configuration, commit, execution-graph |
| res.error.message | exception | error | workflow, run-failure, error-propagation |
| Processor tripwire triggered | exception | warning | workflow, tripwire, processor, guardrails |
WORKFLOW_SCHEMA_VALIDATION_FAILED Invalid ${type}: \n${validatedInputData.issues.map(e => `- ${e.path?.join('.')}: | validation | error | workflow, schema, validation, zod |
| Your schema is async, which is not supported. Please use a s | exception | error | workflow, request-context, schema, async |
| Request context validation failed for workflow '${this.workf | validation | error | workflow, request-context, validation, schema |
| No snapshot found for this workflow run: ${this.workflowId} | exception | error | workflow, storage, resume, snapshot |
WORKFLOW_RESUME_ALREADY_CLAIMED This suspended workflow run was already resumed by another caller. Workflow "${t | error_code | error | workflow, concurrency, resume, race-condition |
| This workflow run was not suspended | exception | error | workflow, resume, state-machine, lifecycle |
| No suspended steps found in this workflow run | exception | error | workflow, resume, suspended-steps |
| Multiple suspended steps found: ${pathStrings.join(', ')}. P | exception | error | workflow, resume, ambiguous-step, parallel |
| This workflow step "${steps?.[0]}" was not suspended. Availa | exception | error | workflow, resume, step-id, validation |
| restart() is not supported on ${this.workflowEngineType} wor | exception | error | workflow, restart, engine, unsupported |
| Snapshot not found for run ${this.runId} | exception | error | workflow, restart, storage, snapshot, crash-recovery |
| Step is required and must be a valid step or array of steps | exception | error | workflow, resume, validation, missing-parameter |
| This workflow run is still running, cannot time travel | exception | error | workflow, concurrency, time-travel, state-conflict |
| CompositeFilesystem requires at least one mount | exception | error | workspace, filesystem, configuration, constructor |
| Nested mount paths are not supported: "${b}" is nested under | exception | error | workspace, filesystem, configuration, path-collision |
EACCES Permission denied: ${operation} (filesystem is read-only) on ${path} | exception | error | workspace, filesystem, permissions, read-only |
| Some filesystems failed to destroy | exception | error | workspace, filesystem, cleanup, aggregate-error |
| No mount for path: ${path} | exception | error | workspace, filesystem, path-resolution, mount |
| No mount for source: ${src} | exception | error | filesystem, mount-resolution, composite-filesystem |
| No mount for dest: ${dest} | exception | error | filesystem, mount-resolution, composite-filesystem |
ENOENT File not found: ${path} | exception | error | filesystem, enoent, file-not-found |
EACCES Permission denied: ${operation} on ${path} | exception | error | filesystem, permissions, path-traversal, containment |
READ_ONLY Workspace is in read-only mode. Cannot perform: ${operation} | exception | error | filesystem, read-only, workspace, configuration |
EISDIR Path is a directory: ${path} | exception | error | filesystem, eisdir, wrong-path-type |
ENOENT File not found: ${path} | exception | error | filesystem, enoent, file-not-found |
ENOTDIR Path is not a directory: ${path} | exception | error | filesystem, enotdir, parent-path |
ESTALE File was modified externally: ${path} (expected mtime ${expectedMtime.toISOStrin | exception | warning | filesystem, concurrency, optimistic-locking, estale |
EEXIST File already exists: ${path} | exception | error | filesystem, eexist, file-exists, concurrency |
| Process failed to spawn | exception | critical | process, spawn, execa, sandbox |
| Invalid mount path: ${mountPath}. Must be an absolute path w | validation | error | validation, filesystem, mount, path |
| Invalid mount path: ${mountPath}. Root path "/" is not allow | validation | error | validation, filesystem, mount, path |
| Invalid mount path: ${mountPath}. Path segments cannot be ". | validation | error | validation, security, path-traversal, mount |
| Isolation backend '${requestedIsolation}' is not available | exception | error | sandbox, isolation, environment, configuration |
| Invalid checkpoint name: ${name} | validation | error | validation, security, path-traversal, checkpoint |
| ${this.constructor.name}: find() requires connect() to adopt | exception | error | typescript, subclassing, sandbox, contract-violation |
| Cannot start a destroyed sandbox | exception | error | lifecycle, sandbox, state, destroyed |
| Sandbox '${this.id}' onStart hook failed: ${error instanceof | exception | error | sandbox, lifecycle-hook, startup |
| ${this.constructor.name} implements neither start() nor the | exception | error | sandbox, subclassing, api-misuse |
| SandboxNotReadyError: sandbox with id '${this.id}' is not re | exception | error | sandbox, lifecycle, stale-reference |
| allowSystemBinaries: false is not supported by seatbelt (mac | validation | error | sandbox, macos, seatbelt, unsupported-config |
| maxRetainedBytes must be a non-negative integer or Infinity | validation | error | validation, range-error, process |
| ${this.constructor.name} does not support closing stdin | exception | error | process, stdin, unsupported-operation |
| Vector search requires vector configuration. | validation | error | search, vector, configuration, validation |
| BM25 search requires BM25 configuration. | validation | error | search, configuration, bm25, misconfiguration |
| Hybrid search requires both vector and BM25 configuration. | validation | error | search, configuration, hybrid-search, misconfiguration |
| No search configuration available. Provide bm25 or vector co | validation | error | search, configuration, misconfiguration, setup |
| Vector configuration is required to embed text. | validation | error | embeddings, vector-search, configuration, misconfiguration |
| Batch embedder returned no embedding for input text. | exception | error | embeddings, batch-embedder, vector-search, contract-violation |
| Vector configuration is required to embed texts. | validation | error | configuration, vector, embedding |
| Batch embedder returned ${embeddings.length} embeddings for | exception | critical | embedding, contract-violation, batch |
| Path not found in composite skill source: ${path} | exception | error | filesystem, path, skills |
| File not found in composite skill source: ${path} | exception | error | filesystem, skills, path-resolution, not-found |
| Directory not found in composite skill source: ${path} | exception | error | filesystem, skills, path-resolution, not-found |
| SKILL.md not found in skill files | exception | error | skills, publishing, validation, missing-file |
| SKILL.md not found in ${skillPath} | exception | error | skills, publishing, missing-file, validation |
| Path not found in skill version tree: ${path} | exception | error | filesystem, skills, versioning, not-found |
| File not found in skill version tree: ${path} | exception | error | filesystem, skills, versioning, not-found |
| Blob not found for hash ${entry.blobHash} (file: ${path}) | exception | critical | storage, skills, blob-store, data-integrity |
| Directory not found in skill version tree: ${path} | exception | error | filesystem, skills, versioning, not-found |
| [WorkspaceSkills] Cannot resolve skill "${winner.name}": mul | exception | error | skills, naming-conflict, resolution, configuration |
| Invalid skill metadata in ${filePath}: ${validation.errors.j | validation | error | skills, validation, frontmatter, workspace |
| Invalid ${label} path: ${input} | exception | error | path-traversal, security, validation, skills |
READ_ONLY Workspace is in read-only mode. Cannot perform: ast_edit | error_code | error | read-only, workspace, ast-edit, filesystem |
FEATURE_NOT_SUPPORTED Sandbox does not support computer | error_code | error | sandbox, feature-flags, computer-use, capability |
READ_ONLY Workspace is in read-only mode. Cannot perform: delete | error_code | error | read-only, workspace, delete, filesystem |
READ_ONLY Workspace is in read-only mode. Cannot perform: edit_file | error_code | error | read-only, workspace, edit-file, filesystem |
FEATURE_NOT_SUPPORTED Sandbox does not support processes | error_code | error | sandbox, processes, feature-flags, background-process |
NO_WORKSPACE Workspace not available. Ensure the agent has a workspace configured. | error_code | error | configuration, workspace, missing-config, tools |
NO_FILESYSTEM Workspace does not have a filesystem configured | error_code | error | configuration, workspace, filesystem, missing-config |
NO_SANDBOX Workspace does not have a sandbox configured | error_code | error | configuration, workspace, sandbox, missing-config |
FEATURE_NOT_SUPPORTED Sandbox does not support processes | error_code | error | sandbox, processes, feature-not-supported, workspace-tools |
READ_ONLY Workspace is in read-only mode. Cannot perform: mkdir | error_code | error | read-only, filesystem, workspace, permissions |
| Invalid \`mediaTypes\` pattern: ${JSON.stringify(pattern)}. | validation | error | validation, mime-type, media-types, input-validation |
EREAD_REQUIRED ${reason} | error_code | error | read-tracker, stale-read, conflict, workspace-tools |
| wrapWithWriteLock: input.path is required | exception | error | write-lock, missing-argument, input-validation, workspace-tools |
| Duplicate workspace tool name "${exposedName}": tool "${name | exception | error | duplicate-name, configuration, tool-registration, workspace |
READ_ONLY Workspace is in read-only mode. Cannot perform: write_file | error_code | error | read-only, filesystem, write, workspace-tools |
INVALID_CONFIG Cannot use both "filesystem" and "mounts" | error_code | error | configuration, invalid-config, workspace, mounts |
DEPLOYER_BUNDLER_BUNDLE_STAGE_FAILED Failed during bundler bundle stage: ${message} | error_code | error | deployer, bundler, build |
| Could not find workspace root | exception | error | deployer, pnpm, monorepo, workspace |
| Refusing to pass unsafe argument to shell command: ${JSON.st | exception | error | security, shell, child-process, input-validation |
| apiError.message || defaultMessage | http | error | server, http, error-handling, hono |
| JSON.stringify(errorResponse) | http | warning | server, http, validation, bad-request |
| server.drainTimeout must be a finite number between 0 and 21 | validation | error | server, configuration, validation, shutdown |
DEPLOYER_INVALID_PNPM_BUILD_APPROVAL_CONFIG Invalid pnpm ${key} configuration | error_code | error | pnpm, configuration, yaml, validation |
DEPLOYER_PNPM_IGNORED_BUILDS pnpm blocked build scripts for: ${ignoredPackages.join(', ')}. Add these package | error_code | error | pnpm, build-scripts, configuration, install |
| Missing required file, checked the following paths: ${files. | exception | error | deployer, filesystem, missing-file, build |
| Inputs cannot be null or undefined | validation | error | evals, scorer, completeness, null-validation |
| Either expectedTool or expectedToolOrder must be provided | validation | error | evals, scorer, tool-call-accuracy, config |
| Input and output messages cannot be null or empty | validation | error | evals, scorer, tool-call-accuracy, empty-input |
| Answer Similarity Scorer requires ground truth to be provide | validation | error | evals, scorer, llm-judge, answer-similarity, ground-truth |
| Either context or contextExtractor is required for Context P | validation | error | evals, scorer, context-precision, config |
| Context array cannot be empty if provided | validation | error | evals, scorer, context-precision, empty-array |
| No context available for evaluation | validation | error | evals, scorer, context-precision, runtime |
| Either context or contextExtractor is required for Context R | validation | error | evals, scorer, context-recall, config |
| Context array cannot be empty if provided | validation | error | evals, scorer, context-recall, empty-array |
| Either context or contextExtractor is required for Context R | validation | error | configuration, validation, evals, missing-parameter |
| Context array cannot be empty if provided | validation | error | configuration, validation, evals, empty-array |
| createMultiTurnJudgeScorer: options.scale must be a finite n | validation | error | configuration, validation, evals, nan |
| Both baselineResponse and noisyQuery are required for Noise | validation | error | configuration, validation, evals, missing-parameter |
| Both original query and noisy response are required for eval | validation | error | evals, runtime, empty-input, message-extraction |
| Analysis step failed to produce results | exception | error | evals, llm, runtime, schema-validation |
| Analysis step failed to produce results for reason generatio | exception | error | evals, llm, runtime, schema-validation |
| User prompt is required for user prompt alignment scoring | validation | error | evals, runtime, validation, message-extraction |
| System prompt is required for system prompt alignment scorin | validation | error | evals, runtime, validation, message-extraction |
| A user or system prompt is required for combined alignment s | validation | error | evals, runtime, validation, message-extraction |
| Agent response is required for prompt alignment scoring | validation | error | validation, scorer, missing-argument, llm-evals |
| maxQuestions must be at least 1 for Summarization scoring | validation | error | validation, range-check, scorer, configuration |
| Input and output messages cannot be null or empty | validation | error | validation, empty-input, scorer, preprocess |
| Tokenizer file not found at ${tokenizerPath} | exception | error | filesystem, missing-file, model-loading, embeddings |
| Config file not found at ${configPath} | exception | error | filesystem, missing-file, model-loading, embeddings |
| Tokenizer config file not found at ${tokenizerFilePath} | exception | error | filesystem, missing-file, tokenizer, embeddings |
| Tokens map file not found at ${tokensMapPath} | exception | error | filesystem, missing-file, tokenizer, embeddings |
| For custom model, modelAbsoluteDirPath is required in FlagEm | validation | error | validation, missing-argument, configuration, embeddings |
| For custom model, modelName is required in FlagEmbedding.ini | exception | error | validation, missing-argument, configuration, embeddings |
| Model file not found at ${modelPath} | exception | error | filesystem, missing-file, onnx, model-loading, embeddings |
| Unsupported file extension: ${targzPath} | exception | error | filesystem, archive-extraction, cache |
| For custom model, modelAbsoluteDirPath is required in Sparse | exception | error | validation, configuration, fastembed |
| For custom model, modelName is required in SparseTextEmbeddi | exception | error | validation, configuration, fastembed |
| No embeddings generated | exception | error | embeddings, empty-input, validation, fastembed |
| File path does not exist | exception | error | filesystem, logging, validation |
| HTTP URL is required | exception | error | logging, configuration, http, validation |
| HTTP ${response.status}: ${response.statusText} | exception | error | network, http, logging, retry |
| Upstash URL and token are required | exception | error | logging, configuration, redis, upstash, validation |
| Failed to execute Upstash command: ${response.statusText} | exception | error | network, redis, logging, upstash, retry |
| No arguments provided | exception | error | mcp, validation, missing-arguments |
| Invalid arguments for firecrawl_scrape | exception | error | mcp, validation, type-guard |
| ${response.error || 'Scraping failed'} | exception | error | api-response, scraping, auth |
| Invalid arguments for firecrawl_map | exception | error | mcp, validation, type-guard |
| ${response.error} | exception | error | api-response, network, auth |
| No links received from Firecrawl API | exception | warning | api-response, schema-mismatch, empty-result |
| Invalid arguments for firecrawl_crawl | exception | error | mcp, validation, type-guard |
| Invalid arguments for firecrawl_check_crawl_status | exception | error | mcp, validation, type-guard |
| Invalid arguments for firecrawl_search | exception | error | mcp, validation, tool-arguments, firecrawl |
| Search failed: ${response.error || 'Unknown error'} | exception | error | network, api-error, firecrawl, auth |
| Invalid arguments for firecrawl_extract | exception | error | mcp, validation, tool-arguments, firecrawl |
| ${extractResponse.error || 'Extraction failed'} | exception | error | network, api-error, firecrawl, async-job |
| Invalid arguments for firecrawl_deep_research | exception | error | mcp, validation, tool-arguments, firecrawl |
| ${response.error || 'Deep research failed'} | exception | error | network, api-error, firecrawl, long-running-job |
| Invalid arguments for firecrawl_generate_llmstxt | exception | error | mcp, validation, tool-arguments, firecrawl |
| ${response.error || 'LLMs.txt generation failed'} | exception | error | network, api-error, firecrawl, async-job |
| Location '${location}' not found | exception | error | network, geocoding, open-meteo, not-found |
| Mock resource content not found for ${uri} | exception | error | mcp, mock, resource-not-found, testing |
| Mock prompt not found for ${name} | exception | error | mcp, fixtures, test, prompt |
| Failed to fetch prompts from server ${this.client.name}: ${e | exception | error | mcp, network, prompts, wrapped-error |
| Failed to fetch resources from server ${this.client.name}: $ | exception | error | mcp, network, resources, wrapped-error |
| Failed to fetch resource templates from server ${this.client | exception | error | mcp, network, resources, templates, wrapped-error |
| Could not connect to server with any available HTTP transpor | exception | critical | mcp, network, http, sse, transport, connection |
| No OAuth authorization is pending for this server. Call conn | exception | error | mcp, oauth, auth, state |
| Server configuration must include either a command or a url. | exception | error | mcp, config, validation, client |
| MCP client was disconnected while recovering the failed tran | exception | warning | mcp, lifecycle, disconnect, reconnect, race |
| Cannot register an elicitation handler after connecting unle | exception | error | mcp, elicitation, capability, initialization |
MCP_CLIENT_TOOL_HYDRATION_FAILED Failed to rebuild MCP tool "${definition.name}" from its cached definition | error_code | error | mcp, cache, hydration, tool-resolution |
MCP_CLIENT_TOOL_EXECUTION_FAILED ${errorText} | error_code | error | mcp, tool-execution, remote-error, third-party |
| MCPClient was initialized multiple times with the same confi | exception | error | mcp, memory-leak, duplicate-instance, lifecycle |
MCP_CLIENT_ON_UPDATE_PROGRESS_FAILED MCP_CLIENT_ON_UPDATE_PROGRESS_FAILED | error_code | error | mcp, progress, event-handler, server-not-found |
MCP_CLIENT_ON_REQUEST_ELICITATION_FAILED MCP_CLIENT_ON_REQUEST_ELICITATION_FAILED | error_code | error | mcp, elicitation, event-handler, server-not-found |
MCP_CLIENT_READ_RESOURCE_FAILED MCP_CLIENT_READ_RESOURCE_FAILED | error_code | error | mcp, resources, read, uri |
MCP_CLIENT_SUBSCRIBE_RESOURCE_FAILED MCP_CLIENT_SUBSCRIBE_RESOURCE_FAILED | error_code | error | mcp, resources, subscribe, capability |
MCP_CLIENT_UNSUBSCRIBE_RESOURCE_FAILED MCP_CLIENT_UNSUBSCRIBE_RESOURCE_FAILED | error_code | warning | mcp, resources, unsubscribe, cleanup |
MCP_CLIENT_ON_UPDATED_RESOURCE_FAILED MCP_CLIENT_ON_UPDATED_RESOURCE_FAILED | error_code | error | mcp, resources, notifications, event-handler |
MCP_CLIENT_ON_LIST_CHANGED_RESOURCE_FAILED MCP_CLIENT_ON_LIST_CHANGED_RESOURCE_FAILED | error_code | error | mcp, resources, notifications, event-handler |
MCP_CLIENT_GET_PROMPT_FAILED MCP_CLIENT_GET_PROMPT_FAILED | error_code | error | mcp, prompts, third-party, remote-call |
MCP_CLIENT_ON_LIST_CHANGED_PROMPT_FAILED MCP_CLIENT_ON_LIST_CHANGED_PROMPT_FAILED | error_code | error | mcp, prompts, notification, connection |
MCP_CLIENT_ON_LIST_CHANGED_TOOLS_FAILED MCP_CLIENT_ON_LIST_CHANGED_TOOLS_FAILED | error_code | error | mcp, tools, notification, connection |
| Authentication for MCP server ${serverName} was cancelled. | exception | info | mcp, oauth, abort, cancellation |
| Cannot authenticate MCP server ${serverName}: it is not conf | exception | error | mcp, oauth, configuration, type-mismatch |
| Cannot authenticate MCP server ${serverName}: the provider's | exception | error | mcp, oauth, configuration, loopback, redirect-url |
| Server configuration not found for name: ${serverName} | exception | error | mcp, configuration, lookup, naming |
| Client ${name} exists but is undefined | exception | warning | mcp, internal-state, typescript, invariant |
| Failed to start OAuth callback server: ports ${firstPort}-${ | exception | error | mcp, oauth, port-in-use, network, callback-server |
| No code verifier found. Authorization flow may not have star | exception | error | mcp, oauth, pkce, state, storage |
| Tool '${toolId}' not found on remote MCP server '${this.name | exception | error | mcp, tool-not-found, client-proxy |
| Tool '${toolId}' on remote MCP server '${this.name}' has no | exception | error | mcp, missing-execute, client-proxy |
| MCPClientServerProxy does not support stdio transport | exception | error | mcp, unsupported-transport, stdio, client-proxy |
| MCPClientServerProxy does not support SSE transport | exception | error | mcp, unsupported-transport, sse, client-proxy |
| MCPClientServerProxy does not support Hono SSE transport | exception | error | mcp, unsupported-transport, hono, sse, client-proxy |
| MCPClientServerProxy does not support HTTP transport | exception | error | mcp, unsupported-transport, http, client-proxy |
MCP_CLIENT_REDIRECT_MISSING_LOCATION Received a ${response.status} redirect with no Location header from "${currentUr | error_code | error | mcp, redirect, network, url-policy |
MCP_CLIENT_TOO_MANY_REDIRECTS Exceeded the maximum of ${MAX_REDIRECT_HOPS} redirect hops while requesting host | error_code | error | mcp, redirect-loop, network, url-policy |
MCP_CLIENT_REDIRECT_BODY_NOT_REPLAYABLE Cannot follow a ${response.status} redirect under the allowedHosts policy: the r | error_code | error | mcp, redirect, request-body, fetch, url-policy |
| Bearer token required | http | error | mcp, oauth, bearer-token, auth, http-401 |
| ${validationResult.error || 'invalid_token'} | http | error | oauth, authentication, http-401, mcp |
MCP_SERVER_MODERN_HTTP_OPTIONS_INCOMPATIBLE startHTTP options ${names.map(name => `"${name}"`).join(', ')} are incompatible | error_code | error | configuration, mcp, http, protocol-version |
| App resource not found: ${uri} | exception | error | mcp, resources, not-found |
| The "elicitation" key is now nested under "mcp.elicitation" | exception | error | mcp, migration, breaking-change, tools |
| The "extra" key is now nested under "mcp.extra" in tool argu | exception | error | mcp, migration, breaking-change, tools |
| Invalid structured content for tool ${request.params.name}: | validation | error | mcp, schema-validation, tools, zod |
| Failed to load resources | exception | error | mcp, resources, callback |
| Resource not found: ${uri} | exception | error | mcp, resources, not-found, protocol-error |
| Resource '${uri}' returned content with neither text nor blo | exception | error | mcp, resources, payload-shape |
| Failed to load prompts | exception | error | mcp, prompts, callback |
| Prompt "${name}" not found | exception | error | mcp, prompt-not-found, invalid-params, lookup |
| Missing required argument: ${arg.name} | validation | error | mcp, invalid-params, missing-argument, validation |
| Agent '${agent.name}' (key: '${agentKey}') must have a non-e | exception | error | mcp, agent, configuration, missing-description |
| Workflow '${workflow.id}' (key: '${workflowKey}') must have | exception | error | mcp, workflow, configuration, missing-description |
| SSE connection not established | http | error | mcp, sse, transport, connection-state |
| Bad Request: No valid session ID provided for non-initialize | http | error | mcp, http, session, bad-request, headers |
| Bad Request: ${req.method} request requires a valid session | http | error | http, mcp, session, bad-request |
| FGA denied for tool '${resourceId}' | exception | error | auth, fga, authorization, mcp |
MCP_SERVER_TOOL_EXECUTE_PREPARATION_FAILED Unknown tool: ${toolId} | exception | error | mcp, tools, unknown-tool, invalid-params |
MCP_SERVER_RESOURCES_NOT_CONFIGURED MCP_SERVER_RESOURCES_NOT_CONFIGURED | error_code | error | mcp, resources, configuration, missing-handler |
| Prompt not found: ${name} | exception | error | mcp, prompts, not-found, input-validation |
| No message handler for prompt: ${name} | exception | error | mcp, prompts, missing-handler, internal-consistency |
| Registration failed with status ${response.status}: ${respon | exception | error | http, network, api-error, registration |
| Lesson "${lessonName}" not found. | exception | error | not-found, filesystem, input-validation |
| Step "${stepName}" not found in lesson "${lessonName}". | exception | error | not-found, filesystem, input-validation |
| Failed to read step "${stepName}" in lesson "${lessonName}": | exception | error | filesystem, io, read-error |
| Device credentials not found. | exception | error | auth, credentials, not-found |
| Course state update failed with status ${response.status}: $ | exception | error | network, http, api |
| Cannot save course state: User is not registered | exception | error | auth, registration, precondition |
| Device credentials not found | exception | warning | auth, credentials, sync, swallowed-error |
| Failed to save course state: ${error} | exception | error | filesystem, persistence, permissions |
| Failed to load course state: ${error} | exception | error | filesystem, json, corruption |
| Registry with ID "${registryId}" not found. | exception | error | not-found, input-validation, registry |
| Registry "${registry.name}" does not have a servers endpoint | exception | error | configuration, mcp, validation |
| Failed to fetch servers from ${registry.servers_url}: ${resp | exception | error | network, http, mcp |
| No post-processor found for registry ${registry.name} | exception | error | configuration, mcp, data-mapping |
| observationalMemory.experimental_subconscious must be a Subc | validation | error | configuration, validation, typescript, observational-memory |
| `retrieval: { vector: true }` requires a vector store. Pass | validation | error | configuration, vector-store, observational-memory, validation |
| `retrieval: { vector: true }` requires an embedder. Pass an | validation | error | configuration, embedder, observational-memory, validation |
| Subconscious semantic knowledge requires a vector store. Pas | validation | error | configuration, vector-store, subconscious, validation |
| Subconscious semantic knowledge requires an embedder. Pass a | validation | error | configuration, embedder, subconscious, validation |
| Knowledge storage domain is not available on ${this.storage. | exception | error | storage, knowledge, configuration |
| Subconscious semantic knowledge requires both a vector store | exception | error | vector-store, embedder, semantic-index, configuration |
| Memory storage domain is not available on ${this.storage.con | exception | error | memory, storage, configuration, version-mismatch |
| No thread found with id ${threadId} | exception | error | memory, thread, not-found |
| Thread with id ${threadId} is for resource with id ${thread. | exception | error | memory, thread, authorization, multi-tenancy |
| Memory error: Resource-scoped semantic recall is enabled but | exception | error | memory, semantic-recall, configuration, validation |
| Tried to query vector index ${indexName} but this Memory ins | exception | error | memory, vector-store, configuration, semantic-recall |
| Working memory is not enabled for this memory instance | exception | error | memory, working-memory, configuration |
| Memory error: Resource-scoped working memory is enabled but | exception | error | memory, working-memory, validation |
| Thread ${threadId} not found | exception | error | memory, thread, working-memory, not-found |
| Tried to embed message content but this Memory instance does | exception | error | memory, embedder, configuration |
| Could not fetch metadata for thread ${threadId} while saving | exception | error | memory, storage, embeddings, wrapped-error |
| Tried to upsert embeddings but this Memory instance doesn't | exception | error | memory, vector-store, embeddings, configuration |
| Observational memory is enabled but the installed version of | exception | error | memory, observational-memory, version-compatibility, upgrade |
| Observational memory async buffering is enabled by default b | exception | error | memory, observational-memory, async-buffering, version-compatibility |
| Observational memory requires @mastra/core support for reque | exception | error | memory, observational-memory, version-compatibility, upgrade |
| workingMemory.useStateSignals is not supported with workingM | exception | error | memory, working-memory, configuration, incompatible-options |
| Tried to create observation embedding index but no vector db | exception | error | memory, observational-memory, vector-store, configuration |
| searchMessages requires a vector store. Configure vector and | exception | error | memory, vector-store, configuration, semantic-search |
| Observational memory is not enabled | exception | error | memory, observational-memory, feature-flag, configuration |
| Invalid input: must be an array of message IDs or message ob | validation | error | memory, input-validation, api-misuse |
| Invalid input: array items must be strings or objects with a | validation | error | memory, input-validation, api-misuse |
| All message IDs must be non-empty strings | validation | error | memory, input-validation, api-misuse |
| Extractor metadataKeyPath "${keyPath}" contains an unsafe pa | validation | error | observational-memory, security, prototype-pollution, input-validation |
| structuredOutput object is undefined | exception | error | observational-memory, llm, structured-output, extraction |
| Extractor name "${name}" must produce a non-empty slug. | validation | error | observational-memory, extractor, naming, input-validation |
| Extractor name "${name}" produced invalid slug "${slug}". | validation | error | observational-memory, extractor, naming, input-validation |
| Extractor name is required. | validation | error | observational-memory, extractor, naming, input-validation |
| Extractor "${name}" must include instructions. | validation | error | config, validation, observational-memory |
| Hook extractor "${name}" must include an onExtracted handler | validation | error | config, callback, observational-memory |
| Hook extractor "${name}" cannot include instructions or a sc | validation | error | config, mutually-exclusive-options, observational-memory |
| Extractor slug "${slug}" is reserved by Observational Memory | validation | error | naming, reserved-words, observational-memory |
| Extractor "${this.name}" must include instructions. | validation | error | runtime, dynamic-config, observational-memory |
| Extractor slug "${extractor.slug}" is reserved by Observatio | validation | error | naming, reserved-words, observational-memory |
| Duplicate extractor slug "${extractor.slug}" from "${previou | validation | error | naming, duplicate-key, observational-memory |
| Extractor "${extractor.slug}" output did not match its schem | validation | error | schema-validation, zod, llm-output, observational-memory |
| ${EXTRACTED_VALUES_TAG} must contain a JSON object. | validation | error | json, llm-output, parsing, observational-memory |
| ModelByInputTokens requires at least one threshold in "upTo" | validation | error | config, observational-memory, constructor |
| ModelByInputTokens threshold keys must be positive numbers. | validation | error | config, validation, observational-memory |
| ModelByInputTokens requires a valid model target for thresho | validation | error | config, validation, observational-memory |
| ModelByInputTokens: input token count (${inputTokens}) excee | exception | error | observational-memory, token-limits, runtime |
| Step not prepared yet — call prepare() first | exception | error | observational-memory, lifecycle, state |
| Step ${this.stepNumber} already prepared | exception | error | observational-memory, lifecycle, idempotency |
| Turn not started — call start() first | exception | error | observational-memory, lifecycle, state |
| Turn already started | exception | error | observational-memory, lifecycle, idempotency |
| Turn already ended | exception | error | lifecycle, state-management, memory |
| ${fieldPath} must be a non-negative number of milliseconds o | validation | error | config, validation, duration |
| ${fieldPath} must be a non-negative number of milliseconds o | validation | error | config, validation, duration, parsing |
| Observational memory requires @mastra/core support for reque | validation | critical | version-compatibility, dependency, installation |
| Cannot set both `model` and `observation.model`. Use `model` | validation | error | config, validation, conflicting-options |
| Cannot set both `model` and `reflection.model`. Use `model` | validation | error | config, validation, conflicting-options |
| shareTokenBudget requires async buffering to be disabled (th | validation | error | config, validation, incompatible-options, tokens |
| shareTokenBudget requires async buffering to be disabled (th | validation | error | config, validation, incompatible-options, tokens |
| ModelByInputTokens requires inputTokens for resolution | exception | error | configuration, model-resolution, observational-memory |
| Async buffering is not yet supported with scope: 'resource'. | validation | error | configuration, observational-memory, unsupported-feature |
| observation.bufferTokens must be > 0, got ${this.observation | validation | error | configuration, validation, observational-memory |
| observation.bufferTokens (${this.observationConfig.bufferTok | validation | error | configuration, validation, observational-memory, token-limits |
| observation.bufferActivation must be > 0, got ${this.observa | validation | error | configuration, validation, observational-memory |
| observation.bufferActivation must be <= 1 (ratio) or >= 1000 | validation | error | configuration, validation, observational-memory |
| observation.bufferActivation as absolute retention (${this.o | validation | error | configuration, validation, observational-memory, token-limits |
| observation.blockAfter (${this.observationConfig.blockAfter} | validation | error | configuration, validation, observational-memory, token-limits |
| observation.blockAfter requires observation.bufferTokens to | validation | error | configuration, validation, observational-memory |
| observation.previousObserverTokens must be false or a finite | validation | error | configuration, validation, observational-memory |
| reflection.bufferActivation must be in range (0, 1], got ${t | validation | error | configuration, validation, observational-memory |
| reflection.blockAfter (${this.reflectionConfig.blockAfter}) | validation | error | configuration, validation, observational-memory |
| reflection.blockAfter requires reflection.bufferActivation t | validation | error | configuration, validation, observational-memory |
OBSERVATIONAL_MEMORY_THREAD_ID_REQUIRED OBSERVATIONAL_MEMORY_THREAD_ID_REQUIRED: ObservationalMemory (scope: 'thread') r | error_code | error | observational-memory, missing-argument, thread |
| No observational memory record found for thread ${ids.thread | exception | error | observational-memory, not-found, storage |
| The operation was aborted. | exception | warning | abortsignal, cancellation, observational-memory |
| Observer produced degenerate output after retry. ${describeD | exception | error | llm-output, degenerate-repetition, observational-memory, model-quality |
| Multi-thread observer produced degenerate output after retry | exception | error | llm-output, degenerate-repetition, multi-thread, observational-memory |
| The operation was aborted. | exception | warning | abortsignal, cancellation, reflector, observational-memory |
| Reflector produced empty output after ${attemptNumber} attem | exception | error | llm, reflection, empty-output, memory |
| The operation was aborted. | exception | info | abort, retry, cancellation, llm |
| Subconscious requires requestContext.organizationId to deriv | validation | error | configuration, request-context, subconscious, multi-tenancy |
| Subconscious requires resourceId to derive scoped knowledge. | exception | error | configuration, request-context, subconscious, resourceid |
| Subconscious requires threadId to derive scoped knowledge. | exception | error | configuration, subconscious, thread, request-context |
| Subconscious capture requires an active Memory instance. | exception | error | configuration, memory, subconscious, storage |
| Subconscious requires a knowledge storage domain. Configure | validation | error | storage, subconscious, configuration, compatibility |
| Invalid Subconscious record time: ${value} | validation | warning | llm, validation, date-parsing, subconscious |
| Subconscious curate requires organizationId in the request c | validation | error | configuration, request-context, subconscious, curation |
| Subconscious curate requires a configured knowledge storage | validation | error | storage, configuration, observational-memory |
| Curator did not acknowledge a valid processed KnowledgeRecor | exception | error | llm-output, protocol-violation, observational-memory |
| Subconscious curate requires the main agent to resolve its m | exception | error | configuration, model-resolution, observational-memory |
| Subconscious ${phase} agent name is required. | exception | error | configuration, validation, subconscious |
| Duplicate Subconscious ${phase} agent: ${name} | exception | error | configuration, validation, subconscious |
| Subconscious maxSteps must be an integer between 1 and ${MAX | exception | error | configuration, validation, subconscious |
| Subconscious activity.recentUpdates must be an integer betwe | exception | error | configuration, validation, subconscious |
| Subconscious pins.maxPins must be a positive integer. | exception | error | configuration, validation, subconscious |
| Subconscious pins.maxCharacters must be an integer between 1 | exception | error | configuration, validation, subconscious |
| Subconscious curationCadence must be a positive integer. | exception | error | configuration, validation, subconscious |
| Unknown Subconscious observation agent: ${name} | exception | error | configuration, validation, observational-memory |
| Subconscious capture shares the Observer model and does not | exception | error | configuration, validation, observational-memory |
| A custom capture schema requires an onExtracted hook that ha | exception | error | configuration, validation, schema |
| Subconscious observation extractor "${name}" shares the Obse | exception | error | configuration, validation, observational-memory |
| Custom Subconscious observation agent "${name}" requires sch | exception | error | configuration, validation, schema |
| Unknown Subconscious reflection agent: ${name} | exception | error | configuration, validation, observational-memory |
| Built-in Subconscious reflection agent "${name}" cannot be r | exception | error | configuration, validation, observational-memory |
| Custom Subconscious reflection agent "${name}" requires inst | exception | error | configuration, validation, observational-memory |
| Knowledge tools require requestContext.organizationId. | exception | error | configuration, request-context, multi-tenancy, knowledge-tools |
| Knowledge tools require an active resourceId. | exception | error | configuration, request-context, knowledge-tools, memory |
| Knowledge tools require an active threadId. | exception | error | knowledge-tools, missing-thread, scope-resolution, mastra-memory |
| Knowledge tools require a configured knowledge storage domai | exception | error | knowledge-tools, storage-configuration, missing-store, mastra-memory |
| knowledge_read requires id or name. | exception | error | tool-input-validation, knowledge-tools, missing-argument, llm-tool-call |
| Knowledge write tools require a configured knowledge storage | exception | error | knowledge-write-tools, storage-configuration, missing-store, mastra-memory |
| ${label} is outside the curator's visible scope. | exception | error | scope-visibility, authorization, knowledge-write-tools, multi-tenancy |
| Knowledge node not found: ${value.node} | exception | error | knowledge-append, entity-not-found, merged-node, stale-reference |
| KnowledgeRecord when must be a valid date. | exception | error | date-parsing, input-validation, knowledge-append, iso-8601 |
| KnowledgeRecord not found: ${(input as { recordId: string }) | exception | error | knowledge-remove, entity-not-found, stale-reference, tool-input-validation |
| knowledge_update_node requires at least one of: name, kind. | exception | error | tool-input-validation, knowledge-update, missing-argument, llm-tool-call |
| Knowledge merge requires two existing nodes. | exception | error | memory, knowledge-graph, entity-not-found |
| KnowledgeRecord not found: ${value.recordId} | exception | error | memory, knowledge-graph, entity-not-found |
| Node descriptions are limited to ${MAX_KNOWLEDGE_NODE_DESCRI | exception | error | validation, string-length, memory |
| capture-guidance is limited to ${MAX_GUIDANCE_LENGTH} charac | exception | error | validation, string-length, memory |
| expectedVersion is only valid for an existing node. | exception | error | validation, memory, optimistic-concurrency |
| Updating node content requires expectedVersion. | exception | error | validation, memory, optimistic-concurrency |
| Subconscious learn requires organizationId in the request co | exception | critical | memory, missing-context, multi-tenancy |
| Skill evidence requires at least two distinct records from t | exception | error | memory, validation, skill-learning |
| The learner may record at most one skill per reflection. | exception | error | memory, skill-learning, rate-limit |
| Knowledge node is not a skill: ${normalizedName} | exception | error | knowledge-store, naming-collision, observational-memory |
| Subconscious learn requires a configured knowledge storage d | exception | error | configuration, storage, observational-memory |
| Learner did not acknowledge a valid reviewed record cursor. | exception | error | llm-output, observational-memory, cursor-validation |
| Subconscious learn requires the main agent to resolve its mo | exception | error | configuration, model-resolution, observational-memory |
| Pin limit reached: the set holds at most ${options.maxPins}. | exception | error | quota, knowledge-store, observational-memory |
| Pin budget exceeded: the pin set is limited to ${options.max | exception | error | quota, knowledge-store, observational-memory |
| Pinned knowledge requires a configured knowledge storage dom | exception | error | configuration, storage, observational-memory |
| Pin not found: ${recordId} | exception | error | not-found, knowledge-store, observational-memory |
| Record is not a pin: ${recordId} | exception | error | invalid-argument, knowledge-store, observational-memory |
| Pin is outside the visible scope. | exception | error | scope-mismatch, memory, observational-memory |
| Subconscious remind requires organizationId in the request c | exception | error | missing-context, multi-tenancy, configuration |
| Subconscious remind requires a resourceId. | exception | error | missing-context, memory, configuration |
| Subconscious remind requires a configured knowledge storage | exception | error | configuration, storage, missing-domain |
| Embedder returned no vector for knowledge search query. | exception | error | embeddings, semantic-search, integration |
| Knowledge semantic index ${indexName} is unavailable. Captur | exception | warning | semantic-index, stale-index, embeddings |
| Knowledge semantic index is stale: a visible operation is pe | exception | warning | concurrency, outbox, stale-index |
| Knowledge semantic index is stale because operation ${entry. | exception | warning | outbox, stale-index, retry |
| Knowledge semantic index remained stale after ${MAX_DRAIN_BA | exception | warning | outbox, backlog, stale-index |
| Embedder returned no vector for ${entry.documentId} | exception | error | embeddings, indexing, outbox |
| Cursor is required | exception | error | validation, memory, cursor, observational-memory |
| Could not resolve cursor message: ${cursor} | exception | error | memory, cursor, not-found, observational-memory |
| Resource ID is required to list threads | exception | error | validation, memory, resource-id, threads |
| Memory instance is required for recall | exception | error | validation, memory, configuration, dependency-injection |
| Thread ID is required for recall | exception | error | validation, memory, thread-id |
| The cursor "${cursor}" looks like a range. Use one of the in | exception | error | memory, cursor, format, observational-memory |
| Message ${cursor} has no visible content (it may be an inter | exception | error | memory, cursor, empty-content, observational-memory |
| Part index ${partIndex} not found in message ${cursor}. Avai | exception | error | memory, cursor, part-index, pagination |
| recall requires a Memory instance with storage access | exception | error | memory, wrong-type, duck-typing, recall |
| Thread not found | exception | error | memory, authorization, not-found, multi-tenancy |
| Could not resolve current thread. | exception | error | memory, thread-id, tool-context, sentinel-value |
| query is required for mode="search" | exception | error | memory, validation, search, tool-arguments |
| Resource ID is required for recall | exception | error | memory, missing-argument, validation |
| Thread does not belong to the active resource | exception | error | memory, authorization, multi-tenancy |
| No active thread context and no cursor or threadId was provi | exception | error | memory, missing-argument, threads |
| Memory instance cannot verify thread access for recall | exception | error | memory, api-mismatch, configuration |
| Current thread is required when browsing by cursor | exception | error | memory, pagination, missing-argument |
| Memory instance is required for working memory updates | exception | error | memory, configuration, missing-argument |
| Thread ID is required for thread-scoped working memory updat | exception | error | memory, working-memory, configuration, missing-argument |
| Resource ID is required for resource-scoped working memory u | exception | error | memory, working-memory, configuration, missing-argument |
| Thread with id ${threadId} resourceId does not match the cur | exception | error | memory, working-memory, resource-mismatch, multi-tenancy |
| Failed to parse working memory input as JSON: ${errorMessage | exception | error | memory, working-memory, json, llm-output, parsing |
| traceId and spanId are required | exception | warning | react, react-query, traces, missing-argument, playground-ui |
| Trace ID and Span ID are required | exception | warning | react, react-query, traces, missing-argument, playground-ui |
| Trace ID is required | exception | error | react-query, precondition, traces, playground-ui |
| Trace ID is required | exception | error | react-query, precondition, traces, playground-ui |
| Comment compounds must be rendered within Comment | exception | error | react, context, compound-components, playground-ui |
| ${componentName} must be used within EnvironmentVariablesEdi | exception | error | react, context, compound-components, playground-ui |
| useJSONSchemaForm must be used within a JSONSchemaForm.Root | exception | error | react, context, compound-components, json-schema, playground-ui |
| useJSONSchemaFormField must be used within a JSONSchemaForm. | exception | error | react, context, compound-components, json-schema, playground-ui |
| useMainSidebar must be used within a MainSidebarProvider. | exception | error | react, context, sidebar, playground-ui |
| useMobileDrawer must be used within a MainSidebarProvider. | exception | error | react, context, sidebar, playground-ui |
| MainSidebarNavLink accepts either `render` or `asChild`, not | exception | error | react, props-validation, api-misuse, playground-ui |
| MainSidebarNavLink requires a valid React element child when | exception | error | react, aschild, props-validation, playground-ui |
| ${hookName} must be used within MessageScrollerProvider. | exception | error | react, context, provider-missing, playground-ui |
| useSankey must be used within Sankey | exception | error | react, context, provider-missing, charts |
| SankeyChart must be used within Sankey | exception | error | react, context, provider-missing, charts |
| Plan compound components must be rendered inside <Plan>. | exception | error | react, context, compound-components, provider-missing |
| ToolCall compounds must be rendered within ToolCall | exception | error | react, context, compound-components, provider-missing |
| A numeric theme id is required | exception | error | validation, query-parameters, react-query, signals |
| A theme snapshot is required | exception | error | validation, query-parameters, react-query, signals |
| Noise example queries require a trace signal and snapshot | exception | error | validation, react-query, signals, defensive-check |
| Noise queries require a trace signal and snapshot | exception | error | validation, react-query, signals, defensive-check |
| A theme snapshot is required | exception | error | validation, react-query, signals, defensive-check |
| Agent Learning request failed (${response.status}) | exception | error | network, http, fetch, playground-ui, agent-learning |
| Environment variable keys must be unique | validation | error | validation, environment-variables, duplicate-key, playground-ui |
| Failed to get file content type | exception | error | network, http, content-type, fetch, files |
| Invalid message type | exception | error | typescript, toast, developer-error, playground-ui |
| Unknown strategy: ${strategy} | validation | error | rag, chunking, invalid-argument, typescript |
| HTML chunking requires either headers or sections to be spec | validation | error | rag, chunking, validation, configuration, html |
| JSON chunking requires maxSize to be specified | validation | error | rag, chunking, validation, configuration, json |
| Sentence chunking requires maxSize to be specified | validation | error | rag, chunking, validation, configuration |
| Keywords must be greater than 0 | validation | error | rag, extractors, validation, configuration, keywords |
| Questions must be greater than 0 | validation | error | configuration, validation, rag |
| Summaries must be one of 'self', 'prev', 'next' | validation | error | configuration, validation, rag |
| Only `TextNode` is allowed for `Summary` extractor | validation | error | type-error, rag, node-types |
| Source object must be a single RelatedNodeInfo object | validation | error | data-structure, rag, relationships |
| Previous object must be a single RelatedNodeInfo object | validation | error | data-structure, rag, relationships |
| Next object must be a single RelatedNodeInfo object | validation | error | data-structure, rag, relationships |
| Parent object must be a single RelatedNodeInfo object | validation | error | data-structure, rag, relationships |
| Child object must be a an array of RelatedNodeInfo objects | validation | error | data-structure, rag, relationships |
| Language ${language} is not supported! Please choose from ${ | validation | error | configuration, unsupported-language, rag |
| Could not load tiktoken encoding. Please install it with `np | exception | critical | dependency, tokenizer, rag |
| Chunk overlap (${overlap}) must be smaller than chunk size ( | validation | error | rag, chunking, configuration, validation |
| Could not load tiktoken encoding. Please install it with `np | exception | error | rag, tiktoken, missing-dependency, tokenizer |
| Unknown chunking strategy: ${strategy} | validation | error | rag, chunking, validation, configuration |
| Invalid parameters for ${strategy} strategy: '${keys}' not s | validation | error | rag, chunking, validation, zod, configuration |
| Invalid parameters for ${strategy} strategy: ${errorMessage} | validation | error | rag, chunking, validation, zod, configuration |
| Node must have an embedding | validation | error | rag, graph-rag, embedding, validation |
| Embedding dimension must be ${this.dimension} | validation | error | rag, graph-rag, embedding, dimension-mismatch |
| Both source and target nodes must exist | validation | error | rag, graph-rag, validation, graph-structure |
| Unsupported GraphRAG snapshot version: ${snapshot?.version} | exception | error | serialization, version-mismatch, rag, validation |
| Edge references unknown node: ${edge.source} | validation | error | serialization, graph-integrity, rag, dangling-reference |
| Edge references unknown node: ${edge.target} | validation | error | serialization, graph-integrity, rag, dangling-reference |
| Node ${id} not found | exception | error | rag, missing-key, graph, argument-error |
| Vectors must not be null or undefined | validation | error | rag, null-check, embedding, argument-error |
| Vector dimensions must match: vec1(${vec1.length}) !== vec2( | validation | error | rag, dimension-mismatch, embedding, argument-error |
| Chunks and embeddings arrays must not be empty | validation | error | rag, empty-input, validation, argument-error |
| Chunks and embeddings must have the same length | validation | error | rag, length-mismatch, embedding, validation |
| Query embedding must have dimension ${this.dimension} | validation | error | rag, dimension-mismatch, embedding, query |
| TopK must be greater than 0 | validation | error | rag, invalid-argument, query, validation |
| Random walk steps must be greater than 0 | validation | error | validation, parameters, graph-rag |
| Restart probability must be between 0 and 1 | validation | error | validation, parameters, graph-rag |
| Cohere API key is required. Pass an apiKey or set COHERE_API | exception | error | configuration, api-key, cohere, environment |
| Cohere API error: ${response.status} ${await response.text() | exception | error | network, api-error, cohere, rerank |
| No relevance score found on Cohere response | exception | error | api-error, cohere, rerank, response-parsing |
| Invalid relevance score returned by model: ${responseText} | exception | error | llm, parsing, rerank, response-parsing |
| indexName is required, got: ${indexName} | validation | error | configuration, validation, tool, graph-rag |
| vectorStoreName is required, got: ${vectorStoreName} | validation | error | configuration, validation, tool, graph-rag |
| indexName is required, got: ${indexName} | validation | error | configuration, validation, tool, vector-search |
| VectorStoreResolver returned invalid value: expected MastraV | exception | error | configuration, validation, tool, vector-store |
| vectorStore option is not a valid MastraVector instance: got | validation | error | configuration, type-mismatch, rag |
| Invalid filter format: ${error instanceof Error ? error.mess | validation | error | json, parsing, rag |
| Invalid filter format: expected a plain object, got ${receiv | validation | error | validation, filter, rag |
| Async validation is not supported | exception | error | schema, async, ai-sdk |
| ${this.model.modelId} does not support zod type: ${value._de | exception | error | zod, schema, unsupported-type |
| Union must have at least 2 options | exception | error | zod, union, schema |
| ${this.model.modelId} does not support zod type: ${value.con | exception | error | zod, zod-v4, unsupported-type |
| Union must have at least 2 options | exception | error | zod, zod-v4, union |
| Cannot flatten intersections with overlapping keys | exception | error | zod, zod-v4, intersection |
| Unsupported JSON Schema target: "${options.target}". Support | exception | error | json-schema, configuration, zod |
| Unsupported schema type: ${typeof schema} | exception | error | schema, invalid-input, typeerror |
| Unsupported schema type: function (schema libraries should i | exception | error | schema, standard-schema, invalid-input |
| [Schema Builder] Failed to convert schema parameters to Zod. | exception | error | schema, json-schema, zod, conversion |
| StandardSchemaWithJSON is not supported for applyCompatLayer | exception | error | schema, standard-schema, compat, gemini |
| No exports are available from the top-level "@mastra/server" | exception | error | imports, module-resolution, package-exports |
| Unsupported JWS algorithm for A2A Agent Card signing: ${alg} | exception | error | jws, a2a, crypto, config |
| Unsupported JWS algorithm for A2A Agent Card signing: ${algo | exception | error | jws, a2a, crypto |
| Failed to canonicalize A2A Agent Card for signing | exception | error | a2a, jws, canonicalization, crypto |
| Failed to create compact JWS for A2A Agent Card | exception | error | a2a, jws, crypto, signing |
| Data parts are not supported in core messages | exception | error | a2a, messages, unsupported-feature |
| Push notification URL must use http or https: ${url.protocol | validation | error | a2a, url-validation, ssrf, push-notifications |
| Push notification host is not allowed: ${hostname} | validation | error | a2a, allowlist, ssrf, configuration |
| Push notification URL must not target local or internal host | validation | error | a2a, ssrf, security, localhost |
| Push notification URL must not target local or private IPs: | validation | error | a2a, ssrf, security, private-ip |
| Push notification URL resolved to a local or private IP: ${h | validation | error | a2a, ssrf, dns, dns-rebinding |
| Push notification failed with status ${response.status} ${re | exception | error | a2a, http, push-notifications, network |
| Task ID is required | validation | error | a2a, validation, tasks, missing-id |
| No token verification method configured | exception | critical | auth, configuration, jwt, middleware |
| Invalid agent-builder action: ${actionId}. Valid actions are | http | error | agent-builder, http-400, validation, workflow-registry |
| Invalid agent-builder action: ${actionId} | http | error | agent-builder, http-400, validation, workflow-registry |
| agent controller "${controllerId}" not found | http | error | http-404, agent-controller, not-found, configuration |
| thread "${requestedThreadId}" not found | http | error | http-404, thread, memory, not-found |
| Thread not found: ${threadId} | exception | error | ownership, thread, multi-tenant, authorization |
| session has no active thread | http | error | http-400, session, thread, objective |
| Storage is not configured | http | error | http-500, storage, configuration, persistence |
| Agents storage domain is not available | http | error | storage, server, agent-versions, configuration |
| Failed to retrieve created version | http | error | storage, internal-error, agent-versions, consistency |
| Cannot delete the active version. Activate a different versi | http | error | http-400, validation, server, state-conflict |
| Version with id ${from} not found | http | error | http-404, not-found, server, rest |
| Version with id ${from} not found for agent ${agentId} | http | error | http-404, agent-versions, rest-api, ownership |
| Version with id ${to} not found | http | error | http-404, agent-versions, rest-api |
| Version with id ${to} not found for agent ${agentId} | http | error | http-404, agent-versions, rest-api, ownership |
| Access denied: durable run belongs to a different resource | http | error | http-403, authorization, durable-workflow, multi-tenancy |
| Access denied: tool call is not suspended on this durable ru | http | error | http-403, durable-workflow, state-conflict, tool-call |
| Agent ID is required | http | error | http-400, validation, rest-api, agents |
| Agent with id ${agentId} not found | http | error | http-404, agents, rest-api, configuration |
| Both threadId or resourceId must be provided | http | error | http-400, validation, memory, legacy-api |
| ${error.message} | http | error | http-400, user-error, validation, server |
| agent signals are not supported by this Mastra core version | http | error | http-501, version-compatibility, agent-signals, server |
| resourceId and threadId are required when runId is not provi | http | error | http-400, missing-parameter, agent-signals, server |
| agent ${methodName} is not supported by this Mastra core ver | http | error | http-501, version-compatibility, agent-stream, server |
| agent thread aborts are not supported by this Mastra core ve | http | error | http-501, version-compatibility, abort, server |
| threadId is required | http | error | http-400, missing-parameter, abort, server |
| agent thread subscriptions are not supported by this Mastra | http | error | http-501, version-compatibility, subscriptions, server |
| Run id is required | http | error | http-400, missing-parameter, tool-approval, server |
| Tool call id is required | http | error | http-400, missing-parameter, tool-approval, api |
| Access denied: agent has no memory configured to validate th | http | error | http-403, access-denied, memory, security, thread-ownership |
| Access denied: thread not found | http | error | http-403, access-denied, thread-not-found, security |
| Agent does not support recover. Only durable agents (createD | http | error | http-400, durable-agent, agents-api, capability-mismatch |
| Agent model list is not found or empty | http | error | http-400, agents, configuration, model-list, empty-state |
| Model config with id ${modelConfigId} not found | http | error | http-404, agents, model-list, not-found, stale-identifier |
| No model with a configured API key found. Please set the req | http | error | http-400, api-key, environment, model-provider |
| This endpoint is deprecated. Please use /stream instead. | http | warning | http-410, deprecated-endpoint, migration |
DEPRECATED_ENDPOINT This endpoint is deprecated. Please use the @mastra/ai-sdk package to for uiMess | error_code | warning | http-410, deprecated-endpoint, ai-sdk, migration |
| Agent not found | http | error | http-404, agent-not-found, routing |
| Skill "${identifier}" not found | http | error | http-404, skill-not-found, routing |
| SSO not configured | http | error | http-404, sso, auth-configuration |
| Session refresh not configured | http | error | http-404, session, auth-configuration |
| No session | http | error | http-401, session, authentication |
| Session expired | http | error | http-401, session-expired, authentication |
| Credentials authentication not configured | http | error | http-404, credentials, auth-configuration |
| Invalid email or password | http | error | auth, http-401, credentials |
| Failed to create account | http | error | auth, http-400, sign-up |
| Admin access required | http | error | rbac, authorization, http-403 |
| RBAC provider does not support role permission resolution | http | error | rbac, api-surface, http-404 |
| Not found | http | warning | authorization, http-404, rbac |
| Background task not found | http | warning | background-tasks, http-404, not-found |
| Registry not found | http | error | http-404, builder-registry, feature-flag |
| Storage is not configured | http | error | http-500, storage, configuration |
| Skills storage domain is not available | http | error | http-500, storage, skills, version-mismatch |
| Could not find skill "${skillName}" in ${owner}/${repo}. | http | error | http-404, builder-registry, skills |
| Could not derive skill ID from registry skill metadata. | http | warning | http-400, builder-registry, skills, metadata |
| Skill with id "${id}" already exists. | http | warning | http-409, builder-registry, skills, conflict |
| Channels require a newer version of @mastra/core | http | error | http-501, channels, feature-gate, version-mismatch |
| Channel "${platform}" is not registered. Available: ${availa | http | error | http-404, channels, configuration |
| Agent "${agentId}" not found | http | error | http-404, channels, agents, acl |
| Not found | http | error | authorization, http-404, rbac, server-api |
| Channel "${platform}" does not support programmatic connecti | http | error | channels, http-400, unsupported-operation, server-api |
| Channel "${platform}" does not support programmatic disconne | http | error | channels, http-400, unsupported-operation, server-api |
| Mastra instance is required for conversations | http | critical | server, http-500, configuration, di-wiring |
| Agent "${agent.id}" does not have memory configured | http | error | memory, http-400, agent-configuration, conversations |
| Memory storage is not configured for agent "${agent.id}" | http | error | memory, storage, http-400, agent-configuration |
| Conversation ${conversationId} was not found | http | error | http-404, conversations, not-found, server-api |
| Datasets require @mastra/core >= 1.4.0 | http | error | versioning, http-501, feature-gate, datasets |
| error.message | http | error | http, server, datasets, mastra-error |
| Item not found: ${itemId} | http | error | http-404, not-found, datasets, rest-api |
| Storage not configured | http | error | http-500, storage, configuration, experiments, mastra |
| Experiments storage not available | http | error | storage, server, configuration, experiments |
| targetType and targetId are required to start an experiment | http | error | validation, http-400, experiments, client-input |
| error.message (MastraError rethrown with mapped status in RU | http | error | server, error-mapping, experiments, items |
| error.message (MastraError rethrown with mapped status in SU | http | error | server, error-mapping, experiments, results |
| Item not found in dataset: ${itemId} | http | error | http-404, datasets, rest-api, identifier-mismatch |
| error.message (MastraError rethrown with mapped status in LI | http | error | mastra-error, http-mapping, storage, datasets |
| Item ${itemId} not found at version ${datasetVersion} | http | error | http-404, datasets, versioning, scd2 |
| error.message (MastraError rethrown with mapped status in GE | http | error | mastra-error, http-mapping, storage, datasets |
| error.message (schema validation error, cause: field/errors) | http | error | http-400, schema-validation, zod, datasets, batch-insert |
DATASET_ITEM_IDENTITY_CONFLICT error.message (DATASET_ITEM_IDENTITY_CONFLICT, cause: conflicts) | error_code | error | http-409, conflict, duplicate-key, datasets, batch-insert |
DATASET_ITEM_EXTERNAL_ID_INVALID error.message (DATASET_ITEM_EXTERNAL_ID_INVALID, cause: field externalId) | error_code | error | http-400, validation, external-id, datasets, batch-insert |
| error.message (MastraError rethrown with mapped status in BA | http | error | mastra-error, http-mapping, storage, batch-insert |
| error.message (MastraError rethrown with mapped status in BA | http | error | mastra-error, http-mapping, storage, batch-delete, datasets |
| error.message (MastraError rethrown with mapped status in AI | http | error | server, http, error-mapping, datasets |
| error.message (MastraError rethrown with mapped status in fa | http | error | server, http, error-mapping, clustering, ai |
| Storage is not configured | http | error | server, storage, configuration, dynamic-workflows |
| workflowDefinitions storage domain is not available | http | error | server, storage, storage-domain, dynamic-workflows |
| error.message (422 res body includes attempted/offendingLabe | http | error | http-422, model-policy, agent-builder, validation |
| error.message (workflow resume already claimed conflict) | http | warning | http-409, concurrency, workflow, race-condition |
| error.message (workflow schema validation error) | http | error | http-400, schema-validation, workflow, zod |
| apiError.message || defaultMessage (fallback handler error) | http | error | http-500, api-error, error-handling |
| Gateway API error ${res.status}: ${body} | exception | error | network, http, gateway, memory |
| Storage is not configured | http | error | storage, configuration, mcp, http-500 |
| MCP clients storage domain is not available | http | error | storage, mcp, adapter, http-500 |
| MCP client with id ${mcpClientId} not found | http | error | http-404, not-found, mcp |
| Failed to retrieve created version | http | error | http-500, storage, internal-error, mcp |
| Version with id ${versionId} not found | http | error | http-404, not-found, mcp, storage |
| Version with id ${versionId} not found for MCP client ${mcpC | http | error | http-404, ownership, mcp, mismatch |
| Cannot delete the active version. Activate a different versi | http | error | http-400, business-rule, mcp-client, versioning |
| Version with id ${from} not found | http | error | http-404, storage, versioning, query-params |
| Version with id ${from} not found for MCP client ${mcpClient | http | error | http-404, ownership-mismatch, versioning, rest-api |
| Version with id ${to} not found | http | error | http-404, storage, versioning, query-params |
| Version with id ${to} not found for MCP client ${mcpClientId | http | error | http-404, ownership-mismatch, versioning, rest-api |
| Mastra instance or listMCPServers method not available | http | critical | http-500, version-mismatch, mcp, configuration |
| Mastra instance or getMCPServerById method not available | http | error | server, mastra-instance, mcp, api-contract |
| Server '${serverId}' cannot execute tools in this way. | http | error | mcp, not-implemented, type-mismatch, version-mismatch |
| MCP server '${serverId}' not found | http | error | mcp, http-404, server-config |
| Access denied: unable to verify message thread access | http | error | memory, authorization, http-403 |
| Agent not found | http | error | memory, http-404, agent-resolution |
| Observational Memory is not enabled for this agent | http | error | memory, observational-memory, http-400, configuration |
| Memory is not configured for this agent | http | error | memory, configuration, http-400 |
| Memory storage is not initialized | http | error | memory, storage, http-400, initialization |
| resourceId is required for observational memory lookup | http | error | validation, observational-memory, missing-parameter |
| Observational Memory processor not available | http | error | configuration, processors, observational-memory, version-mismatch |
| resourceId is required | http | error | validation, missing-parameter, observational-memory |
| Memory is not initialized | http | error | memory, storage, configuration, threads |
| Thread not found | http | error | http-404, memory, thread |
| No threadId found | http | error | http-400, validation, thread |
| Gateway memory message metadata filters are not supported by | http | warning | http-501, gateway, unsupported-feature |
| Messages are required | http | error | http-400, validation, request-body |
| Messages should be an array | http | error | http-400, request-validation, memory, api |
| All messages for the same threadId must use the same resourc | http | error | http-400, consistency, memory, batch-validation |
| All messages must have threadId and resourceId fields. Found | http | error | http-400, missing-field, memory, api |
| Access denied: cannot save messages for a different resource | http | error | http-403, authorization, multi-tenancy, memory |
| Thread not found on gateway | http | error | http-404, gateway, delete, not-found |
| Source thread not found | http | error | http-404, memory, thread, clone |
| messageIds is required | http | error | http-400, validation, request-body, memory |
| Access denied: unable to verify message ownership | http | error | http-403, authorization, storage, multi-tenancy |
| New observability endpoints require @mastra/core >= 1.13.2, | http | error | observability, version-mismatch, http-501, upgrade |
| Storage is not available | http | error | storage, observability, http-500, configuration |
| Trace with ID '${traceId}' not found | http | warning | http-404, observability, tracing, storage |
| Span not found | http | warning | http-404, observability, tracing, spans |
| Scorer '${scorerName}' not found | http | error | http-404, scorers, configuration, observability |
| Plan capability not found | http | error | http-404, agents, tools, plans |
| Invalid plan path | http | error | http-400, validation, plans, paths |
| No workspace filesystem configured | http | error | http-404, workspace, configuration, plans |
| Plan file "${path}" not found | http | warning | http-404, workspace, plans, filesystem |
| Editor is not configured | http | error | http-500, configuration, editor, processor-providers |
| Processor provider with id ${providerId} not found | http | warning | mastra-server, not-found, processor-provider, http-404 |
| Processor not found | http | warning | mastra-server, not-found, processor, http-404 |
| Processor ID is required | validation | info | mastra-server, validation, http-400, bad-request |
| Phase is required | validation | info | mastra-server, validation, http-400, bad-request |
| Messages array is required | validation | info | mastra-server, validation, http-400, messages |
| Processor workflow ${processor.id} failed with status: ${res | http | error | mastra-server, workflow, processor, http-500 |
| Error executing processor workflow: ${error.message} | http | error | mastra-server, workflow, processor, http-500, unhandled-exception |
| TRIPWIRE:${reason || 'Processor aborted'} | exception | info | mastra-server, processor, tripwire, abort, control-flow |
| Processor does not support input phase | validation | error | http-400, processors, phase-not-supported |
| Processor does not support inputStep phase | validation | error | http-400, processors, phase-not-supported |
| Processor does not support outputResult phase | validation | error | http-400, processors, phase-not-supported |
| Processor does not support outputStep phase | validation | error | http-400, processors, phase-not-supported |
| outputStream phase cannot be executed directly. Use streamin | validation | error | http-400, processors, streaming |
| Unknown phase: ${phase} | validation | error | http-400, processors, invalid-parameter |
| Storage is not configured | http | critical | http-500, storage, configuration |
| Prompt blocks storage domain is not available | http | critical | http-500, storage, storage-domain |
| Prompt block with id ${promptBlockId} not found | http | error | http-404, storage, not-found |
| Failed to retrieve created version | http | error | storage, internal-error, consistency, prompt-blocks |
| Version with id ${versionId} not found | http | error | http-404, not-found, versioning, rest |
| Version with id ${versionId} not found for prompt block ${pr | http | error | http-404, id-mismatch, versioning, rest |
| Cannot delete the active version. Activate a different versi | http | error | http-400, business-rule, prompt-blocks, versions |
| Version with id ${from} not found | http | error | http-404, rest-api, versions, not-found |
| Version with id ${from} not found for prompt block ${promptB | http | error | http-404, rest-api, id-mismatch, versions |
| Version with id ${to} not found | http | error | http-404, rest-api, versions, not-found |
| Version with id ${to} not found for prompt block ${promptBlo | http | error | http-404, rest-api, id-mismatch, versions |
| Memory storage was not available while storing the response | http | error | server, storage, memory, http-500 |
| conversation_id and previous_response_id must reference the | http | error | server, validation, http-400, responses-api |
| conversation_id requires the target agent to have memory con | http | error | server, validation, memory, http-400 |
| Conversation ${conversationId} was not found | http | error | server, http-404, storage, responses-api |
| Responses requests require an agent_id | http | error | server, validation, http-400, responses-api |
| Mastra instance is required for agent-backed responses | http | error | server, http-500, initialization, responses-api |
| ${errorMessage} | http | error | server, validation, memory, http-400 |
| Stored response ${body.previous_response_id} belongs to agen | http | error | server, validation, http-400, ownership |
| Stored response ${body.previous_response_id} was not found | http | error | server, http-404, responses-api, storage |
| Responses route could not determine the effective model for | http | error | http-500, model-resolution, responses-api, configuration |
| Stored responses require the target agent to have memory con | http | error | http-400, memory, responses-api, configuration |
| Stored response ${responseId} was not found | http | error | http-404, responses-api, server |
| `computeNextFireAt` is not available in this version of @mas | exception | error | version-mismatch, schedules, cron, dependency |
| `validateCron` is not available in this version of @mastra/c | exception | error | version-mismatch, schedules, cron, dependency |
| Schedule not found | http | error | http-404, schedules, server |
| Workflow "${body.workflowId}" not found | http | error | http-404, schedules, workflow, configuration |
| Agent "${agentBody.agentId}" not found | http | error | http-404, schedules, agent, configuration |
| Storage is not configured | http | error | storage, server, configuration |
| Scorer definitions storage domain is not available | http | error | storage, server, storage-adapter |
| Scorer with id ${scorerId} not found | http | error | http-404, storage, server |
| Failed to retrieve created version | http | error | storage, server, consistency |
| Version with id ${versionId} not found | http | error | http-404, storage, server |
| Cannot delete the active version. Activate a different versi | http | warning | http-400, validation, scorers, versions |
| Version with id ${from} not found | http | error | http-404, scorer-versions, rest-api |
| Version with id ${from} not found for scorer ${scorerId} | http | error | http-404, scorer-versions, ownership-mismatch |
| Version with id ${to} not found | http | error | http-404, scorer-versions, rest-api |
| Version with id ${to} not found for scorer ${scorerId} | http | error | http-404, scorer-versions, ownership-mismatch |
| Storage not configured | http | error | storage, configuration, http-500 |
| Invalid skill name "${name}". Names must start with alphanum | validation | warning | validation, http-400, skills |
| Invalid file path "${filePath}". Absolute paths are not allo | validation | warning | security, path-traversal, http-400, skills |
| Invalid file path "${filePath}". Path traversal is not allow | validation | warning | security, path-traversal, http-400, skills |
| Skills API error: ${response.status} ${response.statusText} | http | error | network, http-502, upstream-api, skills-registry |
| Could not find skill "${skillName}" for ${owner}/${repo} | http | error | http-404, skills-api, not-found |
| No content available for skill "${skillName}" | http | error | http-404, empty-content, skills-api |
| Storage is not configured | http | critical | storage, configuration, http-500 |
| Agents storage domain is not available | http | critical | storage, storage-domain, http-500 |
| Favorites storage domain is not available | http | critical | storage, storage-domain, favorites, http-500 |
| Authentication required | http | error | auth, http-401, unauthenticated |
| Stored agent with id ${storedAgentId} not found | http | error | http-404, not-found, storage, stored-agents |
| Instructions are required | http | error | http-400, validation, stored-agents |
| Storage is not configured | http | critical | http-500, storage, server-configuration |
| Agents storage domain is not available | http | critical | http-500, storage, stored-agents |
| Favorites storage domain is not available | http | error | http-500, storage, favorites |
| Agent with id ${storedAgentId} not found | http | error | http-404, stored-agents, export |
| Source control provider cannot open change requests | http | error | http-400, source-control, feature-availability |
| Stored agent with id ${storedAgentId} not found | http | error | http-404, stored-agents, authorization |
| Could not derive agent ID from name. Please provide an expli | http | error | validation, bad-request, slug, agent-id |
| Agent with id ${id} already exists | http | error | conflict, http-409, duplicate, unique-constraint |
| Failed to resolve created agent | http | error | storage, resolution, http-500, read-after-write |
| handleAutoVersioning returned undefined | exception | error | versioning, internal-error, http-500, storage |
| Failed to resolve updated agent | http | error | storage, resolution, http-500, draft, read-after-write |
| Editor is not configured | http | error | editor, configuration, server, prompt-preview |
| Storage is not configured | http | critical | storage, configuration, mcp, server |
| MCP clients storage domain is not available | http | critical | storage, store-domain, mcp, server |
| Stored MCP client with id ${storedMCPClientId} not found | http | error | mcp, not-found, http-404, rest |
| Could not derive MCP client ID from name. Please provide an | http | error | validation, mcp, http-400, input |
| MCP client with id ${id} already exists | http | error | mcp, conflict, http-409, duplicate |
| Failed to resolve created MCP client | http | error | storage, mcp, internal, consistency, http-500 |
| Failed to resolve updated MCP client | http | error | http-500, storage, mcp, server |
| Storage is not configured | http | error | http-500, storage, configuration, prompt-blocks |
| Prompt blocks storage domain is not available | http | error | http-500, storage, prompt-blocks, version-skew |
| Stored prompt block with id ${storedPromptBlockId} not found | http | error | http-404, not-found, prompt-blocks, rest |
| Could not derive prompt block ID from name. Please provide a | http | error | validation, server, slug |
| Prompt block with id ${id} already exists | http | error | conflict, duplicate, server |
| Failed to resolve created prompt block | http | error | storage, versioning, server, internal |
| Failed to resolve updated prompt block | http | error | storage, server, internal-error |
| Storage is not configured | http | error | configuration, storage, http-500, server |
| Scorer definitions storage domain is not available | http | error | storage, http-500, version-mismatch, configuration |
| Stored scorer definition with id ${storedScorerId} not found | http | error | http-404, storage, not-found, rest-api |
| Could not derive scorer definition ID from name. Please prov | http | warning | http-400, validation, input, rest-api |
| Scorer definition with id ${id} already exists | http | warning | http-409, conflict, duplicate, rest-api |
| Storage is not configured | http | critical | storage, configuration, http-500, favorites, server |
| Skills storage domain is not available | http | critical | storage, storage-domain, http-500, skills, adapter |
| Favorites storage domain is not available | http | critical | storage, server, configuration, favorites |
| Authentication required | http | error | authentication, http-401, server, favorites |
| Stored skill with id ${storedSkillId} not found | http | error | http-404, not-found, stored-skills, server |
| Storage is not configured | http | critical | storage, configuration, server, stored-skills |
| Skills storage domain is not available | http | critical | storage, configuration, server, stored-skills |
| Favorites storage domain is not available | http | critical | storage, favorites, server, configuration |
| Stored skill with id ${storedSkillId} not found | http | warning | http-404, not-found, storage, rest-api |
| Could not derive skill ID from name. Please provide an expli | http | error | validation, http-400, input, slug |
| Skill with id ${id} already exists | http | warning | conflict, http-409, duplicate, rest-api |
| Failed to resolve created skill | http | error | storage, consistency, http-500, read-after-write |
| Failed to resolve updated skill | http | error | storage, consistency, http-500, update |
| Blob storage domain is not available | http | error | storage, blobs, adapter |
| skillPath must be within the allowed directory: ${allowedBas | http | warning | security, path-traversal, validation |
| skillPath is not a directory: ${resolvedPath} | http | warning | validation, filesystem, bad-request |
| skillPath does not exist on the server filesystem: ${resolve | http | warning | filesystem, bad-request, deployment |
| skillPath is missing SKILL.md: ${resolvedPath} | http | error | filesystem, validation, skills, http-400 |
| Failed to resolve skill after publish | http | error | storage, internal-state, http-500, skills |
| Storage is not configured | http | error | storage, configuration, http-500, workspaces |
| Workspaces storage domain is not available | http | error | storage, adapter-compatibility, http-500, workspaces |
| Stored workspace with id ${storedWorkspaceId} not found | http | error | not-found, http-404, workspaces, rest |
| Could not derive workspace ID from name. Please provide an e | http | error | validation, http-400, workspaces, identifiers |
| Workspace with id ${id} already exists | http | error | http-409, conflict, rest-api, storage |
| Failed to resolve created workspace | http | error | http-500, storage, internal-state |
| Failed to resolve updated workspace | http | error | http-500, storage, internal-state |
| Editor is not configured | http | error | http-500, configuration, editor, missing-config |
| UnknownToolProviderError.message (e.g. unknown tool provider | http | error | http-404, tool-providers, server, configuration |
| Tool provider ${providerId} does not support getToolSchema | http | error | http-404, tool-providers, missing-capability, server |
| Schema for tool ${toolSlug} not found in provider ${provider | http | error | http-404, tool-providers, schema, lookup-failed |
| Tool provider ${providerId} does not support authorize | http | error | http-400, tool-providers, missing-capability, oauth |
| Cannot authorize caller-supplied connection: request context | http | error | http-400, tool-providers, request-context, authorization, multi-tenancy |
| Tool provider ${providerId} does not support getAuthStatus | http | error | http-400, tool-providers, missing-capability, oauth |
| Tool provider ${providerId} does not support getConnectionSt | http | error | http-400, tool-providers, missing-capability, connections |
| Tool provider ${providerId} does not support listConnections | http | error | http-400, tool-providers, missing-capability, connections |
| You do not have permission to disconnect this connection | http | warning | http-403, tool-providers, authorization, multi-tenancy, fail-closed |
| Connection ${connectionId} is still pinned by ${usage} agent | http | warning | http-409, tool-providers, conflict, api |
| Tool provider connections storage is not configured | http | error | http-500, storage, configuration, tool-providers |
| Connection ${connectionId} not found for provider ${provider | http | error | http-404, tool-providers, not-found, api |
| You do not have permission to update this connection | http | warning | http-403, authorization, tool-providers, permissions |
| You do not have permission to view usage for this connection | http | warning | http-403, authorization, multi-tenancy, tool-providers |
| Tool not found | http | error | http-404, tools, not-found, api |
| Tool ID is required | http | error | http-400, validation, tools, api |
| Tool is not executable | http | error | http-400, tools, validation, tool-definition |
| Agent ID is required | http | error | http-400, missing-parameter, rest-api, server |
| Argument "${key}" is required | validation | error | http-400, request-body, validation, rest-api |
| A resource ID is required when using memory. Provide memory. | http | error | http-400, memory, resource-id, authentication |
| Access denied: thread belongs to a different resource | http | error | http-403, authorization, memory, multi-tenancy |
| FGA authorization denied: authenticated user is required | http | error | http-403, fga, authorization, authentication |
| Access denied: workflow run belongs to a different resource | http | error | http-403, authorization, workflows, multi-tenancy |
| Unable to verify referenced prompt blocks: ${unresolvedIds.j | http | error | http-400, validation, agent-instructions, references |
| Unable to use unpublished referenced prompt blocks: {ids}. P | http | error | http-400, validation, lifecycle, agent-instructions |
| metadata.avatarUrl must be a string | http | error | http-400, type-mismatch, metadata, validation |
| metadata.avatarUrl must be a valid data URL (data:<mime>;bas | http | error | http-400, format-validation, metadata, data-url |
| metadata.avatarUrl contains invalid base64 | http | error | http-400, base64, encoding, validation |
| metadata.avatarUrl is empty | http | error | http-400, empty-value, metadata, validation |
| metadata.avatarUrl exceeds ${AVATAR_MAX_BYTES}-byte limit (g | http | error | http-413, payload-too-large, metadata, validation |
| Vector name is required | http | error | http-400, missing-parameter, vector, api |
| Vector store ${vectorName} not found | http | error | http-404, not-found, vector, configuration |
| Invalid request index. indexName and vectors array are requi | http | error | http-400, request-body, vector, validation |
| Invalid request index, indexName and positive dimension numb | http | error | http-400, validation, vector, rest-api |
| Invalid metric. Must be one of: cosine, euclidean, dotproduc | http | error | http-400, validation, vector, rest-api |
| Invalid request query. indexName and queryVector array are r | http | error | http-400, validation, vector, rest-api |
| Index name is required | http | error | http-400, validation, vector, rest-api |
| Workflow ID is required | http | error | http-400, workflows, missing-parameter, server-api |
| Workflow not found | http | error | http-404, workflows, not-found, server-api |
| perPage must be a positive integer | http | error | http-400, workflows, pagination, validation, server-api |
| page must be a non-negative integer | http | error | http-400, workflows, pagination, validation, server-api |
| Run ID is required | http | error | http-400, workflows, missing-parameter, server-api |
| Workflow run not found | http | error | http-404, workflow-run, storage, rest-api |
| runId required to stream workflow | http | warning | http-400, validation, missing-parameter, streaming |
| Workflow run ${runId} already finished with status "${existi | http | error | http-409, conflict, workflow-run, streaming |
| runId required to resume workflow | http | error | http-400, validation, missing-parameter, workflow-run |
| runId required to start run | http | error | http-400, validation, missing-parameter, workflow-run |
| runId required to observe workflow stream | http | warning | http-400, validation, mastra-server |
| Server cache not found | http | error | http-500, server-cache, configuration, mastra-server |
| runId required to restart workflow | http | error | http-400, missing-parameter, workflow, server-api |
| runId required to time travel workflow | http | error | http-400, validation, workflow, rest-api |
| runId required to time travel workflow stream | http | error | http-400, validation, workflow, missing-parameter |
| runId required to cancel workflow run | http | error | http-400, validation, workflow, missing-parameter |
| Failed to create observe stream | http | error | http-500, streaming, version-mismatch |
| Invalid createdAt | http | error | http-400, date-parsing, validation |
| Not found | http | error | http-404, filesystem, workspace |
| Permission denied | http | error | http-403, filesystem, permissions |
| Workspace v1 not supported by this version of @mastra/core. | http | error | http-501, version-mismatch, workspaces |
| Mount "${requestedMount}" not found. Available mounts: ${fil | http | error | workspace, filesystem, mount, bad-request, skill-install |
| Mount "${requestedMount}" is read-only | http | error | workspace, filesystem, mount, read-only, forbidden |
| No writable mount available for skill installation | http | error | workspace, filesystem, mount, read-only, skill-install |
| Path is required | http | error | workspace, http-400, validation, missing-parameter |
| No workspace filesystem configured | http | error | workspace, http-404, filesystem, configuration |
| Path "${decodedPath}" not found | http | error | workspace, http-404, file-not-found, path |
| Path and content are required | http | error | workspace, http-400, validation, missing-parameter, file-write |
| Workspace is in read-only mode | http | error | workspace, http-403, read-only, file-write, forbidden |
| Search query is required | http | warning | http-400, validation, search, missing-parameter |
| No workspace configured | http | error | http-404, workspace, configuration, rest-api |
| Workspace does not have search configured | http | error | http-400, search, workspace, configuration |
| Skill name is required | http | warning | http-400, skills, missing-parameter, rest-api |
| No workspace with skills configured | http | error | http-404, skills, workspace, configuration |
| Skill "${identifier}" not found | http | error | http-404, skills, workspace, not-found |
| Skill name and reference path are required | http | error | http-400, validation, skills, rest-api |
| Malformed referencePath | http | error | http-400, url-encoding, validation, skills |
| Reference "${decodedPath}" not found in skill "${identifier} | http | error | http-404, skills, file-not-found, rest-api |
| Skills API error: ${response.status} ${response.statusText} | http | error | http-502, network, upstream, registry, skills |
| Invalid skill name "${name}". Names must start with alphanum | http | error | http-400, validation, naming, skills |
| Invalid file path "${filePath}". Absolute paths are not allo | http | error | path-validation, security, http-400, workspace |
| Invalid file path "${filePath}". Path traversal is not allow | http | error | path-traversal, security, http-400, workspace |
| Could not find skill "${skillName}" for ${owner}/${repo} | http | error | http-404, not-found, upstream-api, skills |
| No content available for skill "${skillName}" | http | warning | http-404, empty-content, upstream-api, skills |
| Workspace not found | http | error | http-404, not-found, workspace, invalid-id |
| Workspace filesystem not available | http | error | http-400, workspace, filesystem, configuration |
| Workspace is read-only | http | error | http-403, forbidden, read-only, workspace, permissions |
| Could not find skill "${skillName}" in ${owner}/${repo}. | http | error | http-404, not-found, upstream-api, skills, workspace |
| Skill "${skillName}" not found at ${skillPath} | http | error | workspace, skills, http-404, not-found |
| [mastra/auth-ee] ${featureList} ${configuredFeatures.length | exception | critical | licensing, enterprise, configuration, env-var, startup |
| [mastra/auth-ee] ${configuredFeatures.join(' and ')} ${confi | exception | critical | licensing, enterprise, module-resolution, version-mismatch, startup |
| [mastra/auth-ee] Agent Builder is configured but no valid EE | exception | critical | licensing, enterprise, agent-builder, env-var, startup |
| [mastra/auth-ee] Agent Builder is configured but the EE modu | exception | critical | licensing, enterprise, agent-builder, module-resolution, version-mismatch |
| [mastra/auth-ee] FGA is configured but ${missingRoutes.lengt | exception | error | auth, fga, routes, configuration |
| Custom API route "${route.path}" must not start with "${pref | exception | error | routes, configuration, path-conflict |
| Invalid route path: "${path}". Path cannot contain '..', '?' | exception | error | routes, validation, path-traversal |
| Stored resource scope is required | http | error | http-403, resource-scope, agent-versions |
| Stored resource not found | http | error | http-404, resource-scope, access-control, agent-versions |