ErrLookup › zylon-ai/private-gpt
zylon-ai/private-gpt
Complete API layer for private AI applications on local models: RAG, skills, tools, MCP, text-to-sql, and more. Works with any OpenAI-compatible inference server. · Python · 671 source files
Analyzed at 4a030776a3 on 2026-08-15. 376 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Empty response from generator. | exception | error | python, regex, ci, maintenance-script, openapi |
| Generator did not return valid JSON. | exception | error | python, regex, toml, dependencies, ci, maintenance-script |
| Handler must define function handle(input, context). | exception | error | fastapi, http-404, file-storage, idempotency, race-condition |
| Invalid system specification (dict): {system} | validation | warning | fastapi, http-400, path-traversal, security, validation |
| Invalid system item in list (dict): {item} | validation | error | fastapi, http-422, ingestion, document-readers, validation |
| Invalid system item in list: {item} | validation | error | fastapi, http-501, celery, ingestion, configuration |
| Invalid system specification: {system} | validation | error | fastapi, http-501, celery, ingestion, deletion |
| Unsupported content block type: {type(block)} | validation | error | fastapi, http-404, skills, collections, not-found |
| Invalid message order: expected {expected_roles} after {prev | validation | error | fastapi, http-404, skills, deletion, idempotency |
| First message in the block must be a USER message. | validation | error | fastapi, http-403, skills, readonly, authorization |
| Unknown message role {self.role}. Expected 'system', 'user', | validation | error | fastapi, http-404, skills, versioning, not-found |
| Image size {image_size} exceeds maximum allowed size of {set | validation | error | fastapi, http-403, skills, readonly, versioning |
| Audio size {audio_size} exceeds maximum allowed size of {set | validation | error | fastapi, http-404, skills, versioning, race-condition |
| Invalid tool specification: {tool} | validation | error | fastapi, http-404, skills, versioning, pagination |
| Invalid system item: {item} | validation | error | fastapi, http-404, skills, versioning, not-found |
| Invalid system value: {value} | validation | error | fastapi, http-404, skills, versioning, stale-token |
| Schema must be a dictionary representing JSON Schema | validation | error | fastapi, http-404, skills, versioning, deletion |
| 'oneOf' must be an array of schemas | validation | error | pydantic, http-422, validation, skills, path-handling |
| 'anyOf' must be an array of schemas | validation | error | pydantic, http-422, validation, skills, windows, path-handling |
| 'allOf' must be an array of schemas | validation | warning | pydantic, http-422, validation, skills, path-traversal, security |
| Schema must define a 'type' field | validation | error | json-schema, validation, structured-output, pydantic |
| Array schemas must define 'items' | validation | error | json-schema, validation, structured-output, pydantic |
| Array 'items' must be a dictionary representing JSON Schema | validation | error | json-schema, validation, structured-output, pydantic |
| Object schemas must define 'properties' | validation | error | json-schema, validation, structured-output, pydantic |
| Expected list or dict with 'items' key, got {type(obj)} | validation | error | pydantic, json-parsing, structured-output, validation |
| Binary not found in PATH: {binary!r} | console | error | cli, environment, path, exit-code |
| Server did not become ready within {_HEALTH_TIMEOUT}s | console | error | cli, server, startup, timeout, health-check |
| Server is already running with PID {existing_pid} | console | warning | cli, server, pid-file, concurrency, exit-code |
| Unknown command: {cmd!r} | console | warning | cli, usage-error, exit-code, typo |
| Redis cache dependencies are not installed. Install with `uv | exception | error | dependencies, optional-extra, redis, cache, installation |
| No content could be extracted from document source (type={do | exception | error | documents, ingestion, ocr, chat-history, empty-content |
| Unknown condense strategy: {strategy} | exception | error | configuration, strategy-pattern, memory, condensation |
| No user messages found in the chat history. | exception | error | chat-history, condensation, invariant, roles |
| Maximum number of iterations for condensing exceeded. | exception | error | condensation, iteration-limit, context-window, chat-history, non-convergence |
| The last user message exceeds the maximum length allowed. | exception | error | condensation, context-window, prompt-size, chat-history |
| No user messages found after condensation. | exception | error | condensation, invariant, chat-history, roles, post-validation |
| No last user message found after condensation. | exception | error | condensation, invariant, chat-history, roles, post-validation |
| Condensed chat history exceeds maximum length after applying | exception | error | chat-history, condensation, token-limit, context-window |
| System messages alone exceed the maximum length. Cannot cond | exception | error | chat-history, system-prompt, token-limit, condensation |
| Condensed history exceeds maximum length after applying cond | exception | error | chat-history, condensation, token-limit, summary |
OVERLOADED_CONDENSATION_ERROR Condensation strategy timed out after {timeout_seconds} seconds | http | error | timeout, condensation, overloaded, asyncio, llm |
| No user message found in conversation history. | exception | error | chat-history, validation, user-message, condensation |
| User block {i} is empty. | exception | error | chat-history, validation, repair, user-blocks |
| User block {i} does not start with a user message: {block[0] | exception | error | chat-history, validation, repair, message-order |
| User block {i} does not end with an assistant message: {bloc | exception | error | chat-history, validation, repair, strict-mode, message-order |
| User block {i} does not end with an assistant or tool messag | exception | error | chat-history, validation, repair, message-order |
| Tool message {j} in user block {i} does not follow an assist | exception | error | chat-history, validation, repair, tool-calls, message-order |
| Message {j} in user block {i} is neither an assistant nor a | exception | error | chat-history, validation, repair, message-order |
| Chat history contains a tool message: {message.content}. Rea | exception | error | chat-history, tool-calls, validation, repair |
| Chat history does not contain any user messages. | exception | error | chat-history, validation, repair, user-message |
| Chat history contains multiple user blocks. This is not supp | exception | error | chat-history, validation, repair, multi-turn |
| Audio blocks found but no audio-capable LLM provided. | exception | error | multimodal, audio, configuration, llm |
| Failed to describe audio in the message. | exception | error | multimodal, audio, llm, empty-response |
| Failed to describe images in the message. | exception | error | multimodal, image, llm, vision, empty-response |
| Path '{canonical_path}' does not match any session mount. | exception | error | code-execution, path-translation, sandbox, validation |
| Code execution provider '{name}' is not registered. Availabl | exception | error | code-execution, configuration, registry, provider |
| Redis semaphore dependencies are not installed. Install with | exception | error | concurrency, redis, optional-dependency, installation |
| Unsupported semaphore mode: {mode!r}. Available: {', '.join( | exception | error | configuration, concurrency, semaphore, registry |
TOOL_NAME_CONFLICT Tool name conflict: name='{tool.name}', layer_a='{existing}', layer_b='{layer.so | exception | error | tools, mcp, context-stack, validation, configuration |
| DB2 database query dependencies are not installed. Install w | exception | error | database, db2, dependencies, import, installation |
| Failed to inspect the database schema. | exception | error | database, sqlalchemy, schema-introspection, connection |
| Failed to inspect the database schema. | exception | error | database, sqlalchemy, schema-introspection, connection |
| Failed to inspect the database schema. | exception | error | database, sqlalchemy, schema-introspection, views, connection |
| No embedding model specified and no models are configured | exception | error | embedding, configuration, settings |
| Embedding model '{target_model}' not found. Available: {avai | exception | error | embedding, configuration, model-registry |
| Embedding model config '{target_model}' not found. Available | exception | error | embedding, configuration, model-registry |
| Embedding mode '{mode}' is not supported. Available: {availa | exception | error | embedding, configuration, registry, factory |
| OpenAI embeddings dependencies are not installed. Install wi | exception | error | embedding, openai, dependencies, import, installation |
| OpenAI-like Embeddings dependencies are not installed. Insta | exception | error | embedding, openai-compatible, dependencies, import, installation |
| Configured model does not support function calling | exception | error | chat-engine, llm, function-calling, configuration |
INVALID_REQUEST_ERROR Configured model does not support function calling | exception | error | chat-engine, llm, function-calling, invalid-request |
INVALID_REQUEST_ERROR Unsupported format strategy: {selected_format_strategy}. Supported strategies ar | validation | error | citations, formatting, invalid-request, validation |
zpgt.ingest.parsing_failure.error zpgt.ingest.parsing_failure.error | error_code | error | ingest, chunking, limits, parsing |
zpgt.ingest.no_valid_nodes.error zpgt.ingest.no_valid_nodes.error | error_code | error | ingest, vector-store, empty-input, parsing |
| Failed to extract file info | exception | error | ingest, validation, file-upload, null-check |
zpgt.ingest.parsing_failure.error zpgt.ingest.parsing_failure.error | error_code | error | ingestion, parsing, vision-ocr, document-processing |
zpgt.ingest.no_valid_files.error zpgt.ingest.no_valid_files.error | error_code | error | ingestion, empty-file, parsing, document-processing |
zpgt.ingest.invalid_file_size.error zpgt.ingest.invalid_file_size.error | error_code | error | ingestion, validation, file-size, upload |
| File not found: {file_data} | exception | error | ingestion, file-not-found, filesystem, distributed-systems |
INVALID_REQUEST_ERROR LibreOffice is required for file conversion. Please install LibreOffice. | exception | error | ingestion, libreoffice, dependencies, conversion |
| Failed to convert {file_info.file_data} to {target_extension | exception | error | ingestion, libreoffice, conversion, corrupt-file |
| Conversion failed: {e} | exception | error | ingestion, conversion, libreoffice, wrapper |
INVALID_REQUEST_ERROR Failed to upload file to S3 for async ingestion | exception | error | ingestion, s3, storage, configuration, async |
INVALID_REQUEST_ERROR structured_outputs must be a StructuredOutputsParams, mapping, JSON object strin | validation | error | llm, structured-output, json, validation |
REQUEST_TOO_LARGE_ERROR structured_outputs JSON must decode to an object; got {type(structured_outputs). | validation | error | llm, structured-output, json, type-error |
| OpenAI-like Responses LLM dependencies are not installed. In | exception | error | llm, openai, dependencies, installation |
| OpenAI Responses LLM dependencies are not installed. Install | exception | error | llm, openai, dependencies, installation |
| Expected tool calls in response but found none. Message: {re | exception | error | llm, openai, function-calling, tools, agent |
| Last item is a FlexibleModel, expected a specific output_cls | exception | error | llm, structured-output, json, parsing, validation |
| No items returned from astream_structured_predict | exception | error | llm, structured-output, async, empty-response, streaming |
| No items returned from astream_structured_chat | exception | error | llm, streaming, empty-response, structured-output |
| Invalid reasoning_effort budget: {budget}. Must be a number | exception | error | llm, reasoning, type-error, configuration |
| OpenAI LLM dependencies are not installed. Install with `uv | exception | error | dependencies, openai, import-error, installation |
| OpenAI-like LLM dependencies are not installed. Install with | exception | error | dependencies, openai-compatible, vllm, ollama, import-error |
| LLM mode '{mode}' is not supported. Available: {available} | exception | error | configuration, llm, registry, validation |
| OpenAI Responses LLM dependencies are not installed. Install | exception | error | dependencies, openai, responses-api, import-error |
| OpenAI Responses LLM dependencies are not installed. Install | exception | error | dependencies, responses-api, openai-compatible, import-error |
| Default LLM model '{model_id}' could not be initialized: {e} | exception | critical | configuration, startup, llm, credentials |
| Default model '{self._default_model_id}' not found in regist | exception | critical | configuration, startup, llm, yaml |
| No model specified and no models are configured | exception | error | configuration, llm, startup, validation |
| Model '{target_model}' not found. Available: {available} | exception | error | llm, registry, validation, configuration |
| Model config '{target_model}' not found. Available: {availab | exception | error | configuration, llm, validation |
| No default model configured to set LLM | exception | warning | deprecated, testing, llm, configuration |
| Unknown reasoning effort level: {effort_str} | exception | error | enum, reasoning, configuration, validation |
| reasoning_effort must be a ReasoningEffort, string, or None; | exception | error | type-error, reasoning, validation, serialization |
| Tokenizer is required and must support apply_chat_template: | exception | error | configuration, tokenizer, prompt-style, validation |
| Unknown prompt_style='{prompt_style}' | exception | error | configuration, registry, prompt-style |
| Names already registered: {existing_names} | exception | error | registry, dependency-injection, lifecycle |
| Harmony parser dependencies are not installed. Install with | exception | error | dependencies, import, openai, installation |
| Transformers dependencies are not installed. | exception | error | dependencies, import, huggingface, tokenizer |
| Local model files not found at '{model_id}'. Ensure the mode | exception | error | huggingface, offline, cache, tokenizer |
| Could not load tokenizer from '{model_id}': {e} | exception | error | huggingface, network, model-id, auth |
| Failed to load tokenizer: {e} | exception | error | huggingface, cache-corruption, versioning, wrapping |
| Multimodal input provided but tokenizer is not multimodal | exception | error | multimodal, tokenizer, validation |
| Mistral tokenizer dependencies are not installed. Install wi | exception | error | dependencies, import, mistral, tokenizer |
| Found {len(matched_files)} files matching the pattern: {file | exception | error | mistral, tokenizer, local-model, filesystem |
| Found {len(matched_files)} files matching the pattern: {file | exception | error | mistral, tokenizer, local-model, model-format |
| Cannot set both `add_generation_prompt` and `continue_final_ | validation | error | mistral, chat-template, api-misuse, validation |
| Cannot set `add_generation_prompt` to True when the last mes | validation | error | mistral, chat-template, prefill, validation |
| Cannot set `continue_final_message` to True when the last me | validation | error | mistral, chat-template, prefill, validation |
| mistral-common only supports function tools. | exception | error | mistral, tools, function-calling, validation |
| Mistral tokenizer must be in test mode. Set `mode=Validation | validation | error | mistral, tokenizer, validation-mode, api-misuse |
| Unsupported tokenizer: {type(self.tokenizer)} | exception | error | mistral, tokenizer, type-error, versioning |
| Empty response from Mistral tokenizer | exception | error | mistral, tokenizer, empty-response, edge-case |
| MistralTokenizer is not available with the given configurati | validation | error | configuration, mistral, tokenizer, registry |
| RemoteTokenizeTokenizer is not available with the given conf | validation | error | configuration, tokenizer, validation, startup |
| HuggingFaceTokenizer is not available with the given configu | exception | error | dependencies, tokenizer, huggingface, import |
| Tokenizer mode {tokenizer_mode} not found. | validation | error | registry, tokenizer, configuration, typo |
| RemoteTokenizeTokenizer only supports text tokenization | exception | error | tokenizer, multimodal, not-implemented, validation |
| Remote tokenizer response did not contain a valid 'tokens' f | exception | error | network, api-contract, tokenizer, json |
| Remote detokenize response did not contain a supported text | exception | error | network, api-contract, tokenizer, json |
| tiktoken dependencies are not installed. Install with `uv sy | exception | error | dependencies, tokenizer, tiktoken, import |
| TikTokenTokenizer only supports text token counting | exception | error | tokenizer, multimodal, not-implemented, tiktoken |
| Failed to parse JSON: {e!s} | exception | error | json, streaming, parsing, llm-output |
| Chunk size must be greater than 0. | validation | error | validation, markdown, ingestion, configuration |
| Unknown memory type: {type} | validation | error | memory, registry, configuration, validation |
| Token limit must be set and greater than 0. | validation | error | memory, validation, pydantic, configuration |
| tokenizer_fn must be provided. | validation | error | memory, validation, tokenizer, pydantic |
| start_on can only be used with 'last' strategy | validation | error | memory, validation, configuration, trimming |
| include_system can only be used with 'last' strategy | validation | error | memory, validation, configuration, trimming |
| Unexpected kwargs: {kwargs} | validation | error | memory, validation, typo, api-mismatch |
| Initial token count exceeds token limit | validation | error | memory, validation, token-limit, context-window |
| LLM does not support structured chat. | exception | error | multimodal, audio, llm, interface-mismatch, not-implemented |
| Model server is not available or request failed. | exception | critical | network, llm, audio, availability, retry |
| LLM does not support structured chat. | exception | error | llm, structured-output, capability-check, multimodality, vision |
| Model server is not available or request failed. | exception | critical | network, llm, availability, vision, retry-exhausted |
| Postgres node store dependencies are not installed. Install | exception | error | dependency, optional-extra, postgres, node-store, packaging |
| Node store '{index_store}' is not supported. Available: {ava | validation | error | configuration, node-store, provider-registry, startup |
| Vector store for collection {collection} not found | validation | error | vector-store, collection, not-found, retrieval |
| Vector store for collection {collection} does not support ge | validation | error | vector-store, capability-check, retrieval, duck-typing |
| doc_id {doc_id} not found. | exception | error | document-store, not-found, kv-store, lookup |
| local_path is required for sqlite client | exception | error | configuration, sqlite, persistence, startup |
| Cannot resolve SQLAlchemy engine for migration store '{store | exception | error | persistence, migrations, sqlalchemy, misconfiguration |
| Unsupported store type: {store} | exception | error | configuration, migrations, persistence, unsupported-provider |
| Migration client is not available for store '{store}' | exception | error | migrations, persistence, configuration, startup |
| Postgres client dependencies are not installed. Install with | exception | error | dependency, optional-extra, postgres, import-guard, packaging |
| Template {template_name} does not have a source or filename. | exception | error | prompts, jinja2, template-loader, configuration |
| API base URL and poll interval must be provided in async mod | exception | error | docling, configuration, initialization, async |
| Task failed with status: {status.task_status} | exception | error | docling, async, task-status, server-side-failure |
| Task did not complete within {self.poll_timeout} seconds | exception | error | docling, timeout, polling, async |
| No OCR languages specified. | exception | error | docling, ocr, configuration, validation |
| OCR model {settings().docling.ocr_model} not supported | exception | error | docling, ocr, configuration, enum |
| No valid content found in the conversion result | exception | error | docling, empty-result, ocr, ingestion |
| Document conversion failed: {e} | exception | error | docling, network, ingestion, error-wrapping |
| Document conversion failed with status: {conversion_result.s | exception | error | docling, conversion-status, ingestion, server-side-failure |
| No valid document content found after conversion | exception | error | docling, empty-result, ingestion, page-range |
| Document extraction unsuccessful for '{file_name}': unmapped | exception | error | docling, data-quality, fonts, ingestion |
| Language {lang} not supported by EasyOCR | exception | error | docling, ocr, easyocr, language-codes, configuration |
| Language {lang} not supported by Tesseract | exception | error | docling, ocr, tesseract, language-codes, configuration |
| Language {lang} not supported by RapidOCR | exception | error | docling, ocr, rapidocr, language-codes, configuration |
| Unknown Docling mode: {docling_settings.mode} | exception | error | docling, factory, configuration, plugin-registry |
| Reader '{normalized_name}' is not supported. Available: {ava | exception | error | readers, factory, registry, configuration |
| MarkItDown reader dependencies are not installed. Install wi | exception | error | dependencies, markitdown, readers, installation |
| PPTX reader dependencies are not installed. Install with `uv | exception | error | dependencies, pptx, readers, installation |
| Delimited text reader dependencies are not installed. | exception | error | dependencies, readers, csv, text, installation |
| Email reader dependencies are not installed. | exception | error | dependencies, readers, email, text, installation |
| HTML reader dependencies are not installed. Install with `uv | exception | error | dependencies, readers, html, installation |
| Text reader dependencies are not installed. | exception | error | dependencies, import, ingestion, text-reader, optional-extras |
| VisionReaderFactory requires additional dependencies that ar | exception | error | dependencies, import, vision, ingestion, optional-extras |
| Header and content length mismatch: {len(value.header)} != { | exception | error | validation, table, ingestion, data-shape, csv |
| No reader registered for extension: {extension} | exception | error | ingestion, reader-registry, file-type, validation |
| No reader available for extension: {extension} | exception | error | ingestion, reader-registry, file-type, validation |
| Failed to load file '{file_info.file_name}' with readers: {a | exception | error | ingestion, aggregated-error, file-parsing, corrupt-file |
| Empty dataframe provided. | validation | error | validation, table, dataframe, ingestion, empty-data |
| Error reading delimited file: {e} | exception | error | csv, parsing, ingestion, encoding, wrapped-error |
| Ghostscript failed for {file_path.name}: {stderr_text} | exception | error | ghostscript, pdf, subprocess, vision, ingestion |
| Ghostscript timed out for {file_path.name} | exception | error | ghostscript, timeout, subprocess, pdf, vision, performance |
| Path '{path}' is in a read-only mount ('{prefix}'). | exception | error | sandbox, filesystem, read-only, mounts, validation |
| Sandbox provider '{name}' is not registered. Available: {ava | exception | error | sandbox, configuration, registry, provider, startup |
NAME_INVALID_FORMAT name must be lowercase alphanumeric with single hyphens only | validation | error | skills, validation, naming, frontmatter, yaml |
MISSING_FRONTMATTER SKILL.md must start with YAML frontmatter | exception | error | skills, frontmatter, parsing, markdown, yaml |
INVALID_FRONTMATTER The SKILL.md frontmatter is not valid YAML. | exception | error | skills, yaml, frontmatter, parsing, syntax |
| Unknown skill_or_version_ids in collection '{collection}': { | exception | error | skills, repository, identifiers, validation, stale-state |
| Invalid page token | validation | warning | skills, pagination, validation, api, tokens |
BUNDLE_TOO_LARGE Skill bundle size ({total} bytes) exceeds the maximum allowed size of {self._max | exception | error | skills, upload, size-limit, validation, configuration |
MISSING_SKILL_MD SKILL.md is required | exception | error | skills, packaging, manifest, upload, validation |
| Local storage provider requires local_root_path | exception | error | storage, configuration, validation, local-filesystem |
| S3 storage provider requires bucket_name | exception | error | storage, s3, configuration, validation |
| Unsupported storage provider: {provider} | exception | error | storage, configuration, unsupported-provider, validation |
| Stream with correlation_id {correlation_id} already exists | exception | error | streaming, in-memory, duplicate, idempotency |
| Stream with correlation_id {correlation_id} not found | exception | error | streaming, in-memory, not-found, lifecycle |
| Stream with correlation_id {event.correlation_id} not found | exception | error | streaming, in-memory, batch, not-found, atomicity |
| Invalid status: {value}. Valid options: {[s.value for s in c | validation | error | streaming, enum, validation, deserialization |
| Stream with correlation_id {correlation_id} already exists | exception | error | streaming, redis, duplicate, idempotency, distributed |
| Redis streaming dependencies are not installed. Install with | exception | error | streaming, redis, dependencies, import, installation |
| Unsupported streaming provider: {settings.stream.broker} | exception | error | streaming, configuration, unsupported-provider, startup |
| Unknown scheduler.chat.mode: {mode} | exception | error | scheduler, configuration, unsupported-provider, startup |
| Database query dependencies are not installed. Install with | exception | error | database, dependencies, import, installation, sqlglot |
| DB2 database query dependencies are not installed. Install w | exception | error | database, db2, dependencies, import, installation |
| MSSQL connection requires pyodbc scheme when no driver speci | exception | error | database, mssql, connection-string, pyodbc, configuration |
| MySQL connection requires mysql, mysql+mysqldb, or mysql+pym | exception | error | database, mysql, connection-string, pymysql, configuration |
| The database schema is too long to fit in the model. | exception | error | database, text-to-sql, context-window, tokens, llm |
| Failed to generate SQL query | exception | error | database, text-to-sql, llm, empty-response, retry |
| Generated SQL query is invalid: {error_str} | exception | error | database, text-to-sql, sqlglot, parse-error, llm |
| Invalid CALL statement format | exception | error | sql, regex, llm-output, stored-procedures, parsing |
| Sandbox client not configured | exception | error | sandbox, lifecycle, configuration, dependency-injection |
| Failed to start sandbox: {e} | exception | error | sandbox, lifecycle, wrapper-exception, startup |
| Client not initialized | exception | error | sandbox, internal-api, lifecycle, invariant |
| Sandbox not started. Call start() first. | exception | error | sandbox, lifecycle, ordering, state-management |
| Failed to execute some SQL queries: {', '.join(str(e) for e | exception | error | sql, sandbox, llm-output, aggregated-errors, database |
| Code execution failed: {message} | exception | error | sandbox, code-execution, llm-output, wrapper-exception, timeout |
| Query not found: {sql_query} | exception | error | sandbox, sql, string-matching, llm-output |
| Execution failed: {result.error or 'Unknown error'} | exception | error | sandbox, code-execution, result-processing, oom |
| Sandbox not started | exception | error | sandbox, lifecycle, file-transfer, ordering |
| File transfer failed: {result.error} | exception | error | sandbox, file-transfer, filesystem, large-data |
| File transfer failed: {e} | exception | error | sandbox, file-transfer, wrapper-exception, retry |
| Output is not a pd.DataFrame | exception | warning | pandas, type-narrowing, accessor, llm-output |
| Output is not a chart | exception | warning | pandas, type-narrowing, charts, accessor |
| Output is not a string, number, pd.DataFrame, or chart | exception | warning | pandas, type-dispatch, llm-output, accessor |
| We don't have any result | exception | error | pandasai, empty-result, llm-output, chat |
| Binary block must contain base64 data before upload | exception | error | binary, s3, upload, data-validation, ingestion |
| code_execution provider is not configured. | exception | error | code-execution, configuration, bash-tool |
| Database query dependencies are not installed. Install with | exception | error | dependencies, import-error, database, optional-extras |
| At least one SQL database artifact is required. | validation | error | database, validation, tool-input |
| One or more database connections failed: \n{errors} | exception | error | database, connection, network, credentials |
| context_filter is required | validation | error | validation, semantic-search, tool-input |
| collection is required in context | validation | error | validation, semantic-search, collection |
| context_filter is required | validation | error | validation, summary, tool-input |
| collection is required in context | validation | error | validation, summary, collection |
| Must provide either text or context_filter | validation | error | validation, summary, retriever |
| Tabular data dependencies are not installed. Install with `u | exception | error | dependencies, import-error, tabular, optional-extras |
| context_filter is required | validation | error | validation, tabular, tool-input |
| collection is required in context | validation | error | validation, tabular, collection |
| Unknown text_editor command: {command!r}. Expected one of: { | validation | error | text-editor, validation, dispatch |
| code_execution provider is not configured. | exception | error | code-execution, configuration, text-editor |
| view_range must contain exactly two integers | validation | error | text-editor, validation, view-range |
| Unable to view file | exception | error | text-editor, code-execution, file-io, sandbox |
| Unable to replace text | exception | error | text-editor, code-execution, str-replace, sandbox |
| Unable to create file | exception | error | text-editor, code-execution, file-create, sandbox |
| Unable to insert text | exception | error | text-editor, file-io, tool, runtime-error |
| {path!r} is not a ToolEventAdapter subclass | exception | error | dynamic-import, registry, type-error, configuration |
| Database query tool requires at least one SQL database artif | validation | error | tools, validation, database, request-validation |
| Semantic search tool requires an ingested artifact context. | validation | error | tools, validation, semantic-search, rag |
| Only one ingested context is supported. | validation | error | tools, validation, semantic-search, rag |
| Skill management tools require a SkillArtifact in the tool c | validation | error | tools, validation, skills, request-validation |
| Only one SkillArtifact is supported per skill management too | validation | error | tools, validation, skills |
| Tabular data analysis tool requires an ingested artifact con | validation | error | tools, validation, tabular-data, pandasai |
| Only one ingested context is supported. | validation | error | tools, validation, tabular-data |
| The tabular data analysis tool is not available because Pand | exception | error | dependencies, optional-extra, pandasai, tools |
| Unknown scheduler.tools.mode: {mode} | exception | error | configuration, scheduler, settings, startup |
| Invalid ToolValidationMode: {mode_str} | validation | error | validation, enum, configuration, user-input |
| ToolSet '{toolset.name}' has duplicate tool names | validation | error | tools, validation, uniqueness, toolset |
| group_id must be provided for logical multitenancy | validation | error | qdrant, vector-store, multitenancy, configuration |
| Hybrid search is not enabled. Please build the query with `e | validation | error | qdrant, vector-store, hybrid-search, configuration |
| Qdrant vector store dependencies are not installed. Install | exception | error | dependencies, optional-extra, qdrant, vector-store |
| Vector store '{settings.vectorstore.database}' is not suppor | validation | error | configuration, vector-store, provider-registry, startup |
| Web scraper provider '{name}' is not registered. Available: | validation | error | web-scraping, provider-registry, configuration |
| Timeout ({config.timeout_seconds}s) scraping {[r.url for r i | exception | error | timeout, scraper, playwright, sandbox, batching |
| Playwright browsers are not installed. Run `playwright insta | exception | error | playwright, dependencies, sandbox, setup |
| Scrape script failed (exit_code={result.exit_code}): {error} | exception | error | scraper, sandbox, diagnostics, playwright |
| Web fetch markdown cleaning dependencies are not installed. | exception | error | dependencies, import, install, extras |
| Web fetching is not properly initialized or it is disabled. | validation | error | configuration, web-fetch, settings, initialization |
| Can't extract information from the provided url, automated t | exception | warning | scraping, content-extraction, spa, anti-bot |
| Web fetching is not properly initialized or it is disabled. | validation | error | configuration, web-search, web-fetch, validation |
| Scraper service not initialized | exception | error | dependency-injection, initialization, web-search, testing |
| Web fetching is not properly initialized or it is disabled. | validation | error | configuration, web-search, web-fetch, validation |
| Brave Search API key is not configured | validation | error | configuration, api-key, brave, web-search |
| Search query cannot be empty | validation | error | validation, input, brave, web-search |
| Offset cannot be negative | validation | error | validation, pagination, brave, off-by-one |
| Brave Search API quota exhausted (x-ratelimit-remaining=0) | exception | error | brave, rate-limit, quota, api |
| Brave Search API rate limit exceeded: {error_message} | exception | error | brave, rate-limit, retry, api |
| Brave Search API invalid token ({error_message}) | validation | error | brave, api-key, authentication, http-400 |
| Brave Search API server error: {error_message} | exception | error | brave, http-5xx, transient, retry |
| Brave Search API error ({status_code}): {error_message} | exception | error | brave, http-4xx, api, diagnostics |
| Web Search is not properly initialized or is disabled in set | validation | error | configuration, web-search, settings, initialization |
| Unsupported web search provider: {self._settings.web_search. | validation | error | configuration, web-search, provider, validation |
| Unknown processor: {self._settings.web_search.processor}. Av | validation | error | configuration, web-search, processor, validation |
| No output object was generated | validation | error | llm, structured-output, pydantic, summarization, workflow |
| Expected output object to be a BaseModel, got {type(response | exception | error | pydantic, type-mismatch, structured-output, version-conflict |
| No summary was generated | validation | error | llm, empty-response, summarization, configuration |
| No response was generated | validation | error | structured-output, llm, pydantic, empty-response |
| Streaming responses are not yet implemented for summarizatio | exception | error | streaming, not-implemented, summarization, configuration |
| No response was generated. Ensure the retriever returns node | validation | error | retriever, empty-index, llama-index, summarization |
| Messages cannot be empty | validation | error | validation, chat-api, http-422, request-body |
| Message content cannot be empty: {message} | validation | error | validation, chat-api, empty-content, http-422 |
| Block cannot be None: {message} | validation | error | validation, content-blocks, null-safety, chat-api |
| Last message role must be one of {self._valid_last_message_r | validation | error | validation, chat-api, message-roles, ordering |
| Tool choice '{self.tool_choice}' is not in the provided tool | validation | error | validation, tools, tool-choice, chat-api |
| Tool context is provided, but no tools are specified. Please | validation | error | validation, tools, configuration, chat-api |
| Tools are not supported when response_format is set to json_ | validation | error | validation, structured-output, tools, mutually-exclusive, chat-api |
| Tools are not supported when structured output is enabled. | validation | error | validation, structured-output, tools, mutually-exclusive |
| MCP servers are not supported when structured output is enab | validation | error | validation, mcp, structured-output, tools |
| Citations are not supported when structured output is enable | validation | error | validation, citations, structured-output, system-config |
| Duplicate tool names found in the tools list. Provided tools | validation | error | validation, tools, duplicate-names, chat-api |
| Block cannot be None | validation | error | validation, content-blocks, null-safety, tools |
| Tool use blocks can only be used in assistant messages: {mes | validation | error | validation, tools, tool-use-blocks, message-roles, protocol |
| Duplicate tool use ID found: {block.id} | validation | error | chat, tool-use, validation, messages |
| Tool result block references an unknown tool use ID: {block. | validation | error | chat, tool-use, validation, messages |
| TLDR blocks can only be used in assistant messages: {message | validation | error | chat, content-blocks, validation |
| Tool result blocks must match the tool use IDs in the same m | validation | error | chat, tool-use, validation, messages |
| JSON schema must be provided when response format is json_sc | validation | error | chat, structured-output, json-schema, request-mapping |
INVALID_REQUEST_AUDIO_MAX_NUM_ERROR The LLM supports a maximum of {max_num_audios} audios, but the message contains | http | error | validation, multimodal, audio, chat, request |
REQUEST_TOO_LARGE_USER_MSG The message length {user_message_tokens} exceeds the maximum token limit {token_ | http | error | validation, tokens, context-window, chat, request |
| System messages should be as layer in the context stack. | exception | error | validation, system-prompt, misuse, chat |
REQUEST_TOO_LARGE_SYSTEM_MSG The system prompt length {system_tokens} exceeds the maximum token limit {token_ | http | error | validation, tokens, system-prompt, context-window |
| The message length {user_message_tokens} and system prompt l | http | error | validation, tokens, context-window, system-prompt |
| No user message found in request. | http | error | validation, chat, messages, misuse |
| Stream with this message_id already exists | exception | error | chat, async, streaming, duplicate, validation |
| Unable to split oversized document subtree | error_code | error | ingestion, chunking, tokens, content |
| Document subtree could not be split within the requested tok | error_code | error | ingestion, chunking, tokens, validation |
| Artifact exceeds the {self.max_content_nodes} node limit | error_code | error | content, limits, tree, ingestion |
| Content request exceeds the {self.max_content_artifacts} art | error_code | error | content, limits, artifacts, retrieval |
| Artifact {artifact} exceeds the {self.max_content_nodes} nod | error_code | error | content, limits, artifacts, tree |
| Artifact {artifact} exceeds the {self.max_content_depth} dep | error_code | error | content, limits, tree, depth, ingestion |
| File '{file_id}' not found or is a sandbox output (cannot be | http | error | |
| Invalid file ID. | http | error | |
| Reader '{body.reader}' is not supported for '{extension}'. V | http | error | |
| Async ingestion is not supported by the configured scheduler | http | error | |
| Async deletion is not supported by the configured scheduler | http | error | |
| Skill with id {skill_id} not found in collection {collection | http | error | |
| Skill with id {skill_id} is readonly and cannot be deleted | http | error | |
| Skill with id {skill_id} is readonly and cannot create versi | http | error | |
| path must be relative and cannot contain '..' | validation | error | |
| path must use '/' separators only | validation | error | |
| Provide SKILL.md either in files or skill_md | validation | error | validation, pydantic, skills, api, bad-request |
MISSING_FILES At least one file is required | error_code | error | upload, multipart, skills, validation, domain-error |
MIME_TYPE_UNKNOWN Could not determine MIME type for file: {value.path} | error_code | error | mime-type, upload, skills, domain-error, validation |
MISSING_SKILL_MD Upload must include a SKILL.md file. | error_code | error | skills, upload, zip, manifest, domain-error |
UNSAFE_PATH_ABSOLUTE Unsafe file path (absolute): {path!r} | error_code | error | security, zip-slip, path-validation, skills, upload |
UNSAFE_PATH_TRAVERSAL Unsafe file path (path traversal): {path!r} | error_code | error | security, zip-slip, path-traversal, skills, upload |
EMPTY_ZIP ZIP file cannot be empty | error_code | error | zip, upload, skills, validation, domain-error |
INVALID_ZIP Invalid ZIP file: {upload.filename or 'unnamed.zip'} | error_code | error | zip, corruption, upload, skills, domain-error |
| File input requires valid base64 encoded content | validation | error | base64, pydantic, validation, file-upload, api |
| MCP tool {tool_name!r} is no longer available from server {c | exception | error | mcp, tooling, stale-config, runtime, integration |
| Visibility timeout should be set when broker or backend is R | validation | critical | celery, redis, configuration, task-queue, startup |
| Soft time limit should be less than or equal to hard time li | validation | critical | celery, configuration, timeouts, task-queue, startup |
| Visibility timeout should be greater than soft time limit | validation | critical | celery, redis, configuration, timeouts, task-queue |
| Visibility timeout should be greater than hard time limit | validation | critical | celery, redis, configuration, timeouts, task-queue |
| must be a list or comma-separated string | validation | error | configuration, pydantic, settings, env-vars, validation |
| Unsupported scheduler.chat.mode={self.scheduler.chat.mode!r} | validation | critical | configuration, settings, scheduler, arq, startup |
| Unsupported scheduler.tools.mode={self.scheduler.tools.mode! | validation | critical | configuration, settings, scheduler, celery, startup |
| scheduler.tools.mode={self.scheduler.tools.mode!r} requires | validation | critical | configuration, scheduler, celery, arq, startup, coupled-config |
| scheduler.chat.mode={self.scheduler.chat.mode!r} requires st | validation | critical | configuration, scheduler, arq, redis, streaming, startup |
| Config file has no top-level mapping: {path} | exception | critical | configuration, yaml, settings-loader, startup, profile |
| Settings file not found for profile '{profile}'. Searched in | exception | critical | configuration, yaml, startup, profiles |
| Conflict setting environment variable for model {model_id}: | exception | error | configuration, environment-variables, models, conflict |
| Environment variable {env_var} is not set and not default wa | exception | critical | configuration, environment-variables, yaml, startup |
| Iterator next() operation failed: {e!s} | exception | error | async, iterator, streaming, error-wrapping |
| Item transformation failed: {e!s} | exception | error | async, iterator, transformation, error-wrapping |
| Async iterator conversion failed: {e!s} | exception | error | async, lifecycle, error-wrapping, concurrency |
| The arq worker mode does not support arguments yet | exception | error | worker, arq, cli, arguments |
| Unsupported PGPT_WORKER_MODE={name!r}. Registered modes: {su | exception | error | worker, configuration, environment-variables, registry |
| PGPT_WORKER_MODE is required | exception | error | worker, configuration, environment-variables, startup |
| Unknown default {model_type} model '{requested_default}'. Av | exception | error | models, discovery, environment-variables, scripts |
| Distribution metadata is missing Name | exception | error | packaging, pip-index, metadata, scripts |
| Unable to read PKG-INFO from {path} | exception | error | packaging, pip-index, sdist, tar |
| Unsupported distribution format: {path.name} | exception | error | packaging, pip-index, file-format, scripts |
| No distributions found in {package_dir} | exception | error | packaging, pip-index, build, scripts |
| Local ingestion is disabled.You can enable it in settings `i | exception | error | ingestion, security, configuration, scripts |
| Folder {folder_path} is not allowed for ingestion | exception | error | ingestion, security, path-validation, configuration |
| Path {args.folder} does not exist | exception | error | ingestion, filesystem, scripts, startup |
| Failed to update project version in pyproject.toml | exception | error | versioning, build, scripts, pyproject |
| `uv lock` failed | exception | error | versioning, build, uv, lockfile, network |
| openapi_spec_url not found in {ANTHROPIC_STATS_URL} | exception | warning | scripts, network, openapi, upstream-drift |
| OPENAPI_SPEC_URL assignment not found in {OPENAPI_TEST_FILE} | exception | error | |
| anthropic dependency not found in {PYPROJECT_FILE} | exception | error |