vercel/ai
Documented errors, page 2 of 6. Back to vercel/ai
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
AI_UnsupportedFunctionalityError 'tool choice type: ' functionality not supported. | exception | error | bedrock, tool-choice, unsupported-functionality, exhaustive-switch |
| Cannot connect to API | exception | error | network, fetch-failed, connection, dns, proxy |
| Stored OAuth authorization server metadata is required when… | exception | error | oauth, mcp, issuer-validation, state-persistence |
| Permission mode is not supported by this ACP harness. Use… | exception | error | acp, permissions, configuration, unsupported-mode |
| No object generated: could not parse the response. | exception | error | json-parsing, llm-output, structured-output, no-object-generated |
| `Harness ' ' emitted approval request ' ' for unknown tool… | exception | error | harness, tool-approval, protocol-violation, id-mismatch |
| HarnessAgent: pipeTextStreamToResponse is not implemented… | exception | error | not-implemented, harness, streaming, api-surface |
| Pi private session directory | exception | error | configuration, path-validation, sandbox |
| The Gemini Live translation API only supports 16kHz 16-bit… | validation | error | audio-format, google, speech-translation, validation |
| Tool approval signature verification failed for approval | exception | error | security, signature, tool-approval, validation |
| Host tool relay request is not valid JSON. | http | error | http, json, bad-request |
| [WorkflowAgent] Provider-executed tool | console | warning | tools, streaming, workflow, provider |
| Google schema conversion only supports references to direct… | exception | error | google, json-schema, ref, schema-conversion |
| SandboxChannel: cannot send | exception | error | sandbox, channel, lifecycle, messaging |
| The response body is empty. | exception | error | network, streaming, chat-transport, reconnect |
| targetLanguage is required for translation model | validation | error | google, speech-translation, missing-argument, validation |
| The claude-code harness needs a TCP port exposed by the… | exception | error | sandbox, network, port, capability-unsupported, harness-claude-code |
AI_TooManyEmbeddingValuesForCallError Too many values for a single embedding call. The | exception | error | embeddings, bedrock, batching, limits |
| Gemini image models do not support mask-based image editing. | exception | error | unsupported-parameter, image-generation, google-vertex, gemini |
BYTEDANCE_VIDEO_GENERATION_ERROR No task ID returned from API | exception | error | video-generation, api-response, bytedance |
| Prodia multipart response missing job part | exception | error | network, multipart, provider-response, prodia |
| The Claude Code harness requires an explicit `port` when… | exception | error | sandbox, configuration, port, capability-unsupported, harness-claude-code |
| ACP MCP server must be configured with an object value. | exception | error | acp, mcp, configuration, validation |
| ACP process-loss rerun requires the agent to advertise… | exception | error | acp, capability, session, resume |
| Tool " " did not return structuredContent or parseable text… | exception | error | mcp, structured-output, empty-response, tools |
| Duplicate skill name | validation | error | validation, skills, harness, duplicate |
| Failed to create MCP headers for tool | exception | error | mcp, headers, binding, configuration |
| `Harness ' ' could not execute host tool ' '. | exception | error | harness, host-tool, tool-execution, toolset |
| No tool invocation found for approval ID | exception | error | streaming, tool-approval, human-in-the-loop, state-mismatch |
| Black Forest Labs poll response is Ready but missing… | exception | error | image-generation, polling, api-response, black-forest-labs |
| 'element streams in object mode' functionality not… | exception | error | streaming, object-mode, unsupported-functionality, api-misuse |
| Failed to resolve sandbox default working directory… | exception | error | sandbox, path, harness, validation |
| ACP environment variable name is invalid | validation | error | configuration, environment, validation |
| ACP resolved environment value | exception | error | environment, missing-env-var, configuration |
| pi: only text user-message parts are supported; got | exception | error | unsupported-feature, multimodal, input-validation |
| The provider does not support file uploads. Make sure it… | exception | error | provider-capability, file-upload, typescript |
| The deepagents harness cannot use `mintBridgeToken` with a… | exception | error | sandbox, capability, configuration |
| Unsupported MCP App resource MIME type | exception | error | mcp, mcp-apps, mime-type, resource |
| ACP connection closed before cancellation. | exception | warning | acp, cancellation, connection, race-condition |
| cannot perform lossy ACP rerun without persisted start… | exception | error | acp, recovery, lossy-rerun, persisted-state |
| Invalid host tool catalog. | exception | error | validation, schema, config, json |
| providerOptions.xai.channels is required when… | validation | error | xai, transcription, provider-options, validation |
| Transcription request timed out after 60 seconds | exception | error | timeout, network, transcription, fal |
| allowedTools with only tools that cannot be allow-listed | exception | error | openai, tools, allowed-tools, responses-api, unsupported-functionality |
| Cold ACP session restoration requires the agent to… | exception | error | acp, capability, session, restore |
| Deep Agents runtime was not initialized | exception | error | lifecycle, initialization, internal-state |
| Existing OAuth client information is required when… | exception | error | oauth, state-management, client-information, mcp |
| A host tool relay turn is already active. | exception | error | harness-acp, relay, concurrency, state-conflict |
KLINGAI_VIDEO_GENERATION_ERROR No task_id returned from KlingAI API. Response | error_code | error | video, api-response, missing-field |
| [WorkflowChatTransport] Negative initialStartIndex is… | console | warning | streaming, resume, headers, workflow |
| Unsupported Deep Agents conversation checkpoint format | exception | error | persistence, versioning, checkpoint |
| xAI video status response exceeded | exception | error | xai, video-generation, response-size, network, polling |
| no active turn | exception | error | lifecycle, concurrency, internal-state |
| Timed out waiting for snapshot of template | exception | error | timeout, sandbox, polling, vercel |
| `Harness session has no unfinished turn to continue. | exception | error | lifecycle, state-machine, harness, invalid-operation |
| tool choice type | exception | error | openai, tool-choice, responses-api, unsupported-functionality, typescript |
| google.interactions: timed out polling interaction | exception | error | timeout, polling, google-interactions, background-task |
| languageModel | exception | error | unsupported-model-type, provider-api, fal, typescript |
| `Harness ' ' could not find parsed tool call ' ' for custom… | exception | error | harness, tool-call, host-tool, id-mismatch |
| Invalid argument for parameter requests: requests must not… | validation | error | acp, lifecycle, identity-mismatch, session-resume |
| Unable to resolve sandbox HOME directory | exception | error | sandbox, home-directory, environment, harness |
| Invalid skill file path for | validation | error | path-traversal, validation, skills |
| Unsupported request schema. Only ElicitationRequestSchema… | exception | error | api-misuse, elicitation, schema |
| OpenCode event stream ended before the turn settled. | exception | error | sse, streaming, network, opencode |
| OpenCode turn settled without a correlated assistant… | exception | error | opencode, event-stream, correlation, version-mismatch |
| ${parsedError.value.error} | exception | error | xai, streaming, api-call-error, retryable |
| Invalid argument for parameter schemaName: Schema name is… | validation | error | validation, invalid-argument, enum-output |
| Recursive reference detected at | console | warning | json-schema, zod, recursion, schema-conversion |
| Tool argument " " does not match its x-mcp-header type | exception | error | type-mismatch, headers, validation |
AI_NoSuchModelError No such embeddingModel | exception | error | no-such-model, embeddings, provider-capability, luma |
| `getMutableAIState` must be called before returning from an… | exception | error | rsc, ai-state, lifecycle, react-server-components |
| OAuth state parameter mismatch - possible CSRF attack | exception | error | oauth, security, csrf, state-mismatch |
| `useSyncUIState` must be used inside an | exception | error | react, context, hooks, rsc |
| Tool is not app-visible | validation | error | mcp-apps, security, allowlist, authorization, iframe |
| Amazon Bedrock request was moderated | exception | error | bedrock, image-generation, content-moderation |
| claude-code session is already stopped; cannot stop. | exception | error | session-lifecycle, claude-code, harness, double-stop |
| File not found | exception | error | filesystem, file-not-found, sandbox |
| Host tool is not active in catalog revision . | http | error | relay, tool-not-found, catalog, harness-acp |
| Invalid Pi session file name | exception | error | path-traversal, validation, sessions |
| Path not found | exception | error | grep, filesystem, path-not-found |
| 'element streams in enum mode' functionality not supported. | exception | error | streaming, enum, unsupported-functionality, api-misuse |
| 'HarnessAgent: `sandboxConfig.onBootstrap` and… | validation | error | config, sandbox, validation, harness |
| ACP credentialEnv and credentialBrokering must be… | exception | error | configuration, validation, acp |
| DeepSeek file uploads support JPEG, PNG, GIF, and WebP… | validation | error | file-upload, media-type, content-sniffing, validation |
| This component can only be used inside Server Components. | exception | error | rsc, react-server-components, client-server-boundary, nextjs |
| ACP-transport MCP servers require client-side mcp/connect… | exception | error | acp, mcp, unsupported-capability, configuration |
| Audio format must be provided or determinable from media… | exception | error | audio, media-type, custom-provider |
| 'file parts with provider references' functionality is not… | exception | error | google, vertex, file-parts, messages |
| Harness 'cline' requires a JSON schema for structured… | exception | error | structured-output, schema, capability, cline |
| `Harness ' ' could not find parsed tool call ' ' for… | exception | error | harness, tool-approval, id-mismatch, protocol-violation |
| media type | exception | error | unsupported-functionality, multimodal, content-conversion |
| Model could not be resolved | exception | error | model-resolution, configuration, speech |
| Invalid Cline skill name | validation | error | validation, naming, skills, cline |
| The Google Vertex xAI model function cannot be called with… | exception | error | google-vertex, xai, api-misuse, typescript |
BLACK_FOREST_LABS_VIDEO_GENERATION_FAILED ${statusResult.error} | exception | error | video-generation, provider-api, polling, content-policy |
| embeddingModel | exception | error | provider-capability, embeddings, no-such-model |
FAL_VIDEO_GENERATION_ERROR No response URL returned from queue endpoint | exception | error | api-response, network, video-generation, fal |
| Harness 'claude-code' requires a JSON schema for structured… | exception | error | structured-output, json, schema, validation |
| HarnessAgent: pipeUIMessageStreamToResponse is not… | exception | error | not-implemented, ui-message-stream, harness-agent, api-limitation |
| OAuth authorization server metadata must be saveable before… | exception | error | oauth, mcp, persistence, configuration |