Module validation

Source

Expand description

Localized validation messages for memory fields. Localized validation messages for memory fields and CLI guards.

Modules§

app_error_pt: Portuguese translations for AppError Display messages.
runtime_pt: Portuguese translations for runtime startup progress messages.

Functions§

anthropic_api_key_oauth_required: ANTHROPIC_API_KEY set — OAuth required.
api_key_cannot_be_empty: API key empty after read.
batch_line_invalid_json: Batch line: invalid JSON.
batch_line_name_empty: Batch line: name normalizes empty.
batch_line_type_description_required: Batch line: type/description required.
binary_not_found_at_path: External CLI binary missing at an explicit path.
body_exceeds: Localized message for body_exceeds.
child_name_exceeds_max: Child name derived from parent exceeds MAX_MEMORY_NAME_LEN.
child_name_not_kebab: Child name is not kebab-case ASCII.
claude_extraction_failed: Claude extraction failed.
claude_output_missing_result: Claude output missing result element.
claude_p_failed: Claude -p failed with an error message.
claude_p_stdout_not_utf8: Claude -p stdout not UTF-8.
claude_version_not_utf8: Claude –version not UTF-8.
codex_agent_message_not_json_object: Codex agent_message not JSON object.
codex_agent_message_not_valid_json: Codex agent_message is not valid JSON (with raw snippet).
codex_exec_stdout_not_utf8: Codex exec stdout not UTF-8.
codex_model_not_supported_oauth: Codex model not supported with ChatGPT Pro OAuth.
codex_no_agent_message: Codex output missing agent_message.
codex_rate_limited: Codex rate-limited message.
codex_stdout_not_utf8: Codex stdout not UTF-8.
codex_turn_failed: Codex turn failed with a message.
codex_version_not_utf8: Codex –version not UTF-8.
config_file_is_symlink: Config file is a symlink (potential attack).
config_file_wrong_owner: Config file owned by a different uid; refuse overwrite.
config_key_retired: Rejects a config set key that was advertised historically but never read.
config_key_unknown: Rejects a config set key that is not in the canonical registry.
config_parse_error: Config parse error at path.
config_path_no_parent: Config path has no parent directory component.
could_not_parse_opencode_version: Could not parse opencode version string.
deep_research_output_empty: Deep-research output file is empty.
deep_research_output_missing: Deep-research output path missing after atomic write.
description_exceeds: Localized message for description_exceeds.
directory_not_found: Directory path does not exist.
embedded_schema_invalid_json: Embedded schema JSON is invalid.
embedding_binary_not_found_on_path: Named binary not found on PATH.
embedding_cancelled_by_shutdown: Embedding cancelled by shutdown signal (keep “cancelled” for batch matcher).
embedding_claude_embedder_unavailable: Claude embedder singleton missing after set.
embedding_claude_probe_binary_not_on_path: Claude probe: binary missing from PATH.
embedding_codex_probe_auth_missing: Codex probe: auth.json missing.
embedding_codex_probe_binary_not_on_path: Codex probe: binary missing from PATH.
embedding_codex_stdin_write_failed: Codex stdin write failed.
embedding_detail: Wrap an external / dynamic error detail as an embedding payload.
embedding_dimension_less_than_requested: Provider returned fewer dimensions than requested.
embedding_dry_run_claude_not_on_path: --llm-backend claude but claude missing (codex detected).
embedding_dry_run_codex_not_on_path: --llm-backend codex but codex missing (claude detected).
embedding_dry_run_opencode_not_on_path: --llm-backend opencode but opencode not on PATH.
embedding_dry_run_opencode_resolved_other: --llm-backend opencode but auto-detect resolved another flavour.
embedding_embedder_unavailable: Default embedder singleton missing after set.
embedding_empty_response_from_openrouter: Empty data array in a successful OpenRouter embedding response.
embedding_entity_cache_null: Entity embed cache produced a null slot.
embedding_expected_count: Batch response length mismatch.
embedding_failed_to_parse_response: Failed to parse embedding JSON body.
embedding_failed_to_read_response_body: Failed to read embedding response body.
embedding_failed_to_spawn_opencode: Failed to spawn opencode.
embedding_fanout_lost_index: Fan-out lost an item index.
embedding_has_dims_expected: Vector length diverges from configured embedding dim (G42/C5).
embedding_http_client_build_failed: Failed to build the reqwest HTTP client for OpenRouter embeddings.
embedding_http_request_failed: Transient network failure during embedding HTTP.
embedding_knn_search_chunks_dim_mismatch: KNN search dim mismatch (chunks).
embedding_knn_search_dim_mismatch: KNN search dim mismatch (memories / entities).
embedding_llm_batch_index_out_of_range: LLM batch item index out of range.
embedding_llm_batch_item_count: LLM batch returned wrong item count.
embedding_llm_batch_item_dims: LLM batch item dimension mismatch (G42/C5).
embedding_llm_batch_missing_item: LLM batch response missing an item index.
embedding_llm_batch_parse_failed: LLM batch embedding JSON parse failed.
embedding_llm_item_dims: LLM returned wrong dim for a specific fan-out item.
embedding_llm_parse_failed: Single LLM embedding JSON parse failed.
embedding_llm_returned_dims: Single LLM embedding dimension mismatch (G42/C5).
embedding_no_llm_cli_on_path: No codex/claude/opencode on PATH.
embedding_oauth_usage_quota_exhausted_claude: Claude OAuth usage quota exhausted (markers: OAuth, quota).
embedding_opencode_embedder_unavailable: OpenCode embedder singleton missing after set.
embedding_opencode_exited: OpenCode non-zero exit with tails.
embedding_opencode_json_parse_failed: OpenCode JSON parse failed.
embedding_opencode_no_text_events: OpenCode NDJSON had no text events.
embedding_opencode_probe_binary_not_on_path: OpenCode probe: binary missing from PATH.
embedding_opencode_timed_out: OpenCode timed out.
embedding_openrouter_200_neither_data_nor_error: HTTP 200 body had neither data nor error.
embedding_openrouter_chat_client_unavailable: OpenRouter chat client singleton missing after set.
embedding_openrouter_client_not_initialised: OpenRouter client not initialised for embed path.
embedding_openrouter_client_unavailable: OpenRouter embed client singleton missing after set.
embedding_openrouter_invalid_api_key_401: Invalid OpenRouter API key (HTTP 401).
embedding_openrouter_max_retries: Max retries exhausted for OpenRouter embedding request.
embedding_openrouter_probe_not_initialised: OpenRouter probe: client not initialised.
embedding_openrouter_request_timed_out: OpenRouter embedding request timed out.
embedding_openrouter_returned: OpenRouter hard-failure status with body.
embedding_openrouter_server_error: OpenRouter 5xx during embedding.
embedding_schema_tempfile_create_failed: Schema tempfile create failed.
embedding_schema_tempfile_write_failed: Schema tempfile write failed.
embedding_semaphore_closed: Semaphore closed mid fan-out.
embedding_slot_exhausted: LLM slot semaphore exhausted (marker: slot exhausted).
embedding_task_join_error: JoinSet join error while embedding.
embedding_task_panicked: Embedding JoinSet task panicked.
embedding_tokio_runtime_init_failed: Tokio multi-thread runtime failed to initialise.
embedding_tokio_runtime_unavailable: Tokio runtime missing after set.
embedding_unexpected_http: Unexpected HTTP status with body snippet.
empty_body: Localized message for empty_body.
empty_query: Localized message for empty_query.
empty_version_string: Empty version string.
enable_ner_skip_extraction_exclusive: --enable-ner and --skip-extraction conflict.
entity_name_all_caps_noise: Short ALL_CAPS entity name rejected as NER noise.
entity_name_already_exists: Entity rename target already exists.
entity_name_normalizes_too_short: Entity name normalizes too short.
entity_name_purely_numeric: Purely numeric entity name rejected.
entity_name_too_short: Entity name too short.
entity_required_when_memory: –entity required when –memory is used.
executable_not_in_path: Executable not found in PATH.
executable_not_in_path_generic: Executable not found in PATH (generic install wording).
failed_to_open_claude_stdin: Failed to open claude stdin.
failed_to_open_codex_stdin: Failed to open codex stdin.
failed_to_parse_chat_response: Failed to parse chat response JSON.
failed_to_parse_claude_json_array: Failed to parse claude output as JSON array.
failed_to_parse_claude_result_field: Failed to parse claude result field as JSON.
failed_to_parse_codex_agent_message: Failed to parse codex agent_message as ExtractionResult.
failed_to_parse_codex_agent_message_json: Failed to parse codex agent_message as JSON.
failed_to_parse_entities_array: Failed to parse entities array.
failed_to_parse_extraction: Failed to parse an ExtractionResult from a provider.
failed_to_parse_relationships_array: Failed to parse relationships array.
failed_to_read_names_file: Failed to read names file.
failed_to_read_response_body: Failed to read HTTP response body.
failed_to_run_opencode_version: Failed to run opencode –version.
file_not_utf8: File bytes are not valid UTF-8.
from_required_without_entity_all: –from required when not using –entity/–all.
from_type_required_batch: Batch reclassify missing –from-type.
http_client_build_failed: Failed to build the HTTP client.
http_request_failed: HTTP request failed (transport-level).
ingest_aborted_on_first_failure: Ingest aborted on first failure (--fail-fast / default all-or-nothing path).
invalid_chunk_id_in_reembed_key: Invalid chunk id in re-embed key.
invalid_json_in_flag: Invalid JSON for a CLI flag that takes a file path (e.g. --entities-file).
invalid_json_payload_on_flag: Invalid JSON payload on a stdin flag (e.g. --graph-stdin).
invalid_json_schema_for_request: Invalid JSON schema for an OpenRouter request body.
invalid_link_weight: Localized message for invalid_link_weight.
invalid_memory_source: Invalid memory source string.
invalid_namespace_config: Localized message for invalid_namespace_config.
invalid_projects_mapping: Localized message for invalid_projects_mapping.
invalid_relationship_id: Invalid relationship id.
invalid_relationship_strength: Relationship strength outside [0.0, 1.0].
invalid_status_filter: Invalid pending-embeddings status filter.
invalid_tz: Localized message for invalid_tz.
legacy_embedding_backend_removed: Legacy embedding extraction backend removed.
llm_missing_calibrated_weight: LLM result missing calibrated_weight.
llm_missing_description_field: LLM result missing description field.
llm_missing_enriched_body_field: LLM result missing enriched_body field.
llm_missing_relation: LLM result missing relation.
max_files_exceeded: --max-files cap exceeded (generic form used by ingest-claude/codex).
max_files_exceeded_all_or_nothing: --max-files cap exceeded with all-or-nothing abort (ingest-opencode).
max_files_exceeded_matching: --max-files cap exceeded with pattern-matching wording (ingest).
missing_field: Generic “missing / required field” helper.
mode_flag_conflicts: Mode-conditional flag conflicts (G20).
model_json_parse_failed: Model content could not be parsed even after JSON repair.
model_no_structured_content: Model returned no structured content.
model_non_object_json: Model returned non-object JSON after repair.
name_empty_after_normalization: Name normalized to empty (only hyphens/underscores/spaces).
name_kebab: Localized message for name_kebab.
name_length: Localized message for name_length.
name_must_not_be_empty: Empty name rejected.
name_prefix_kebab: --name-prefix must be kebab-case starting with a letter.
name_required_positional_or_flag: Memory/entity name required as positional or –name.
name_required_single_mode: Single-mode missing –name.
namespace_format: Localized message for namespace_format.
namespace_length: Localized message for namespace_length.
new_name_kebab: Localized message for new_name_kebab.
new_name_length: Localized message for new_name_length.
no_agent_message_in_codex_jsonl: No agent_message in codex JSONL output.
non_canonical_relation: Non-canonical relation under –strict-relations.
not_a_directory: Path exists but is not a directory.
openai_api_key_oauth_required: OPENAI_API_KEY set — OAuth required.
opencode_response_not_valid_json: Opencode response is not valid JSON.
opencode_stdout_not_utf8: Opencode stdout not UTF-8.
openrouter_api_key_not_found: OpenRouter API key could not be resolved.
openrouter_chat_max_retries: Max retries exceeded for OpenRouter chat.
openrouter_chat_timed_out: OpenRouter chat timed out.
openrouter_invalid_api_key_401: Invalid OpenRouter API key HTTP 401.
openrouter_model_required: OpenRouter mode requires an explicit model flag.
openrouter_server_error: OpenRouter 5xx server error.
openrouter_status_error: OpenRouter returned a non-success status for a model.
path_no_valid_parent: Path has no valid parent component.
path_traversal: Localized message for path_traversal.
preflight_probe_failed: Preflight probe failed.
preflight_probe_timed_out: Preflight probe timed out.
preflight_rate_limit_fallback: Preflight rate-limit with a distinct fallback provider.
preflight_rate_limit_same_mode: Preflight rate-limit when fallback equals current mode.
preflight_rate_limit_suggestion: Preflight rate-limit with operator suggestion (no fallback configured).
process_exited: External process exited with a non-zero code.
process_timed_out: External process timed out.
queue_clear_failed: Queue clear failed.
queue_insert_failed: Queue insert failed.
queue_namespace_migration_failed: Queue namespace migration failed.
queue_resume_failed: Queue resume (status=processing → pending) failed.
queue_retry_failed_reset_failed: Queue retry-failed reset failed.
reembed_target_only: --target only applies to re-embed operation.
refuse_delete_orphans_without_yes: Refusing orphan entity delete without –yes.
refuse_delete_vec_orphans_without_yes: Refusing vec orphan delete without –yes.
refuse_release_slot_without_yes: Refusing to release slot without –yes.
relation_format_for_relationship: Relation format error scoped to a source→target edge.
requeue_dead_failed: Requeue-dead failed.
requeue_skipped_failed: Requeue-skipped failed.
reserved_name: Localized message for reserved_name.
self_merge_id: Self-referential merge by id (generic).
self_merge_id_in_ids: Self-referential merge by id (pre-check with –ids hint).
self_merge_name: Self-referential merge by name (generic).
self_merge_name_in_names: Self-referential merge by name (pre-check with –names hint).
self_merge_name_resolves_to_target: Source name resolves to target id (self-merge).
self_referential_link: Localized message for self_referential_link.
source_target_entity_names_identical: Source and target entity names identical.
source_target_names_identical: Source and target names identical.
stdin_thread_panicked: Stdin writer thread panicked.
strict_name_not_canonical: --strict-name refused auto-normalization.
sub_queries_file_empty: Sub-queries file has no usable lines.
sync_destination_equals_source: Localized message for sync_destination_equals_source.
system_load_exceeded: System load average exceeds 2× ncpus.
target_required_single_mode: Single-mode missing –target.
to_required_without_entity_all: –to required when not using –entity/–all.
to_type_required_batch: Batch reclassify missing –to-type.
too_many_name_collisions: Too many name collisions while generating a unique memory name.
type_and_description_required: CREATE path requires --type and --description.
unexpected_http_status: Unexpected HTTP status with body snippet.
unknown_pending_embeddings_status: Unknown pending_embeddings status string.
unknown_pending_memories_status: Unknown pending_memories status string.
version_below_minimum: Tool version below the minimum required.

Module validation

Module validation Copy item path

Modules§

Functions§

Module validation