CherryHQ/cherry-studio
Documented errors, page 2 of 3. Back to CherryHQ/cherry-studio
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| [theme-contract] references invalid custom property | exception | error | theme-contract, build-validation, css, naming-convention, custom-properties |
| [theme-contract] variable catalog is missing | exception | error | theme-contract, css, build, validation, docs |
| OVMS provider requires a non-empty `baseURL`. An empty… | exception | error | validation, configuration, ovms, base-url, fail-fast |
| Found multiple matches for old_string. Provide more… | exception | error | filesystem, validation, mcp, edit-tool, fuzzy-match |
| [theme-contract] is missing root declarations | exception | error | theme-contract, css, build, validation |
| Failed to get gateway URL: HTTP | exception | error | channels, discord, network, auth, rate-limit, retry |
| Invalid arguments for read | validation | warning | zod, validation, read, mcp-tool, filesystem |
| Pattern is required for grep | validation | warning | filesystem, grep, validation, mcp-tool |
| [theme-contract] foundation cannot declare runtime input | exception | error | theme-contract, css, build, validation, layering |
| Agent journal must be a regular file | exception | error | security, filesystem, toctou, agent-memory |
| Not a regular file | exception | error | filesystem, validation, not-a-file, channels |
| Invalid command: command must be a non-empty string | validation | error | validation, mcp, command-injection, manifest |
| Tab was created but not found - it may have been closed | exception | error | electron, browser-tool, race, tabs, webcontents |
| Agent storage root must be a real directory | exception | critical | security, filesystem, symlink, agent, validation |
| Failed to create parent directory | exception | error | filesystem, permissions, mcp, write-tool, mkdir |
| Failed to start in-memory server | exception | error | mcp, in-memory, builtin-server, connection |
| Agent data directory already exists | exception | error | filesystem, agents, state-conflict, duplicate |
| Invalid MCP package upload: file name must be a string | validation | error | mcp, upload, validation, ipc, typescript |
| Invalid response format from Dify API | exception | error | dify, response-validation, schema-mismatch, api |
| parsed.base_resp.status_msg || `MiniMax error | exception | error | api-error, minimax, business-error, content-moderation, base-resp |
| Invalid MCP package upload: expected a . | validation | error | mcp, upload, validation, ipc, file-format |
| manifest.json not found in | exception | error | mcp, manifest, upload, packaging, zip |
| Invalid MCP package upload: file exceeds the 100 MiB size… | validation | error | mcp, upload, validation, ipc, size-limit |
| errorData.error || 'Image generation failed' | exception | error | ollama, image-generation, local-server, configuration |
| Required agent prompt file is not a regular file | exception | error | filesystem, security, symlink, agents, prompts |
| Invalid offset: . File has lines. | validation | error | filesystem, validation, mcp, read-tool, pagination |
| result.task.reason || 'Task failed' | exception | error | ppio, task-failed, terminal, image-generation, policy |
| Unsupported Linux packaging architecture | exception | error | build, electron-builder, linux, packaging, native-modules |
| Unknown in-memory MCP server | exception | critical | mcp, factory, configuration, unknown-server, startup |
| Cherry Assistant package configuration is invalid | exception | error | agents, schema, config, builtin, validation |
| Invalid MCP package env: null byte detected in value of… | validation | error | security, null-byte, mcp, manifest, validation, env, variable-substitution |
| Invalid MCP package upload: file name cannot contain… | validation | warning | mcp, upload, validation, ipc, whitespace |
| OAuth authentication failed | exception | error | mcp, oauth, authentication, network |
| Invalid command: path traversal detected in | validation | error | security, path-traversal, mcp, command-injection, manifest |
| Invalid manifest: missing name | validation | error | mcp, manifest, validation |
| DMXAPI provider requires a non-empty `baseURL` to build the… | exception | error | config, validation, dmxapi, base-url, image-transport |
| HTTP | http | error | network, didi, http-error, api-key |
| Invalid manifest: missing server.mcp_config | validation | error | mcp, manifest, validation, mcp-config |
| [theme-contract] runtime input | exception | error | theme-contract, css, build, validation, layering, host |
| [theme-contract] theme-input.css declares unregistered… | exception | error | theme-contract, css, build, validation, registry |
| failed: `} | exception | error | feishu, lark, api-envelope, permissions, business-error |
| failed | exception | error | wechat, api-error, protocol, session, error-code |
| failed with HTTP | exception | error | wechat, network, api-error, http-status, protocol |
| Use embeddingModel() for embedding endpoint type | exception | error | newapi, endpoint-type, configuration, misroute |
| File not found in workspace | exception | error | filesystem, workspace, file-not-found, enoent, channels |
| Refusing to recursively remove unsafe agent data path | exception | critical | filesystem, security, symlink, destructive, agents |
| responseBody || response.statusText | exception | error | siliconflow, api, http, ai-sdk, image-generation |
| errorData.error?.message || 'Image generation failed' | exception | error | ovms, image-generation, network, local-server |
| DashScope API request timeout after | exception | error | timeout, network, dashscope, fetch |
| [theme-contract] product | exception | error | theme-contract, css, build, validation, layering |
| Agent storage path contains a symbolic link | exception | critical | security, filesystem, symlink, path-traversal, agent |
| Discord API error : HTTP | exception | error | discord, http, rate-limit, auth, network |
| Agent memory file must be a real file | exception | error | security, filesystem, symlink-guard, agent-memory |
| Failed to open Socket Mode connection: HTTP | exception | error | slack, socket-mode, network, authentication, config |
| imageModel | exception | error | model-not-found, moonshot, ai-sdk, configuration, image-generation |
| local-embedding provider only supports text embeddings, not | exception | error | unsupported-feature, local-embedding, capability, routing |
| Invalid JSON tool arguments for | validation | error | mcp, tool-calling, json-parsing, validation |
| Cannot stream on orphan session | exception | error | channels, sessions, lifecycle, orphan, agents |
| ModelScope API request timeout after | exception | error | timeout, network, modelscope, abort, image-generation |
| Agent data directory must be a real directory | exception | error | filesystem, security, symlink, agents, integrity |
| Failed to write OAuth storage | exception | error | mcp, oauth, storage, file-io, disk-space |
| Invalid arguments for write | validation | error | filesystem, validation, zod, mcp, write-tool |
| Agent storage path parent is not a directory | exception | error | security, filesystem, agent, validation |
| Discord bot token is required | exception | error | channels, discord, config, auth, credentials |
| Failed to read OAuth storage | exception | error | mcp, oauth, storage, file-io, corruption |
| Unsupported DashScope image model | exception | error | model-routing, dashscope, image-generation, switch-dispatch |
| Invalid manifest: missing dxt_version | validation | error | mcp, manifest, validation, dxt |
ErrorCode.InternalError Agent not found | exception | error | mcp, lifecycle, agent-memory, internal-error, stale-reference |
| Invalid PEM format: missing BEGIN/END markers or key content | validation | error | auth, private-key, pem, validation |
| Pattern cannot be empty | validation | warning | filesystem, glob, validation, mcp-tool |
| returned a task id but does not implement polling | exception | error | transport, internal, contract, polling, image-generation |
| [theme-contract] product variable | exception | error | theme-contract, css, build, validation, registry |
| API Error | exception | error | network, didi, api-error, json-rpc |
| OpenAI Compatible provider requires settings | validation | error | python, skill-creator, frontmatter, yaml, parsing |
| Invalid manifest: missing manifest_version | validation | error | mcp, manifest, validation, mcpb |
| file not found | exception | error | mcp, upload, filesystem, race-condition |
ErrorCode.InvalidParams Unknown action " ", expected update/append/search | validation | error | mcp, validation, invalid-params, agent-memory |
| Failed to read journal at | exception | error | filesystem, io-error, permissions, agent-memory |
| Socket Mode connection failed | exception | error | slack, socket-mode, authentication, config, api-error |
| DashScope API error | exception | error | api-error, http, dashscope, auth, quota |
| ModelScope provider requires a non-empty `baseURL`. | exception | error | config, validation, modelscope, base-url |
| Gemini image models do not support mask-based image editing. | exception | error | unsupported-feature, gemini, mask, image-editing, gateway |
| Invalid manifest: missing server.mcp_config.command | validation | error | mcp, manifest-validation, package-install, configuration |
| Missing modelDescriptor for DashScope model | exception | error | internal, wiring, model-descriptor, dashscope |
| Path not found | exception | warning | filesystem, enoent, delete, mcp-tool |
| not found. | exception | error | i18n, script, build, localization |
| Invalid MCP package upload: file name contains unsupported… | validation | error | mcp, upload, validation, ipc, filename |
| Invalid MCP package upload: file name cannot be empty | validation | error | mcp, upload, validation, ipc |
| No code verifier saved for session | exception | error | mcp, oauth, pkce, storage, authentication |
| Invalid server type | validation | error | mcp, transport, configuration, server-type |
| Invalid args: must be an array | validation | error | validation, mcp, manifest, type-error |
| Invalid JSON response from SiliconFlow | exception | error | siliconflow, parse-error, json, network, image-generation |
| PPIO API error | exception | error | network, api, ppio, http, image-generation |
| Message text cannot be empty. | exception | error | wechat, validation, message, channels, precondition |
| npx not found in PATH and bundled bun is not available… | exception | error | mcp, npx, nodejs, dependency, environment |
| [theme-contract] product.css declares unregistered product… | exception | error | theme-contract, css, build, validation, registry |
| [theme-contract] shadcn.css declares unregistered Shadcn… | exception | error | theme-contract, css, build, validation, registry |
| Missing value for | exception | error | cli, script, args, validation |
| Unknown model | exception | error | ppio, model-not-found, configuration, registry, image-generation |
| Failed to resolve image model | exception | error | image-generation, model-resolution, runtime, validation |