confidencenumber
How certain the agent is about the purpose/tags, 0–1. Default 0.7 (moderate). Use ~0.9 when the symbol is obvious (big docstring, clear name), ~0.5 when guessing.
domain_tagsstring[]
Free-form business-domain labels (e.g. ["payments", "webhooks", "security"]). Used to slice the graph by domain. Defaults to []. Lowercase snake-case recommended.
extracted_bystringобязательный
Identifier of the agent / model that produced this extraction, e.g. "claude-opus-4-7" or "gpt-5-mini". Required for audit trails and for re-running extraction on model upgrades.
file_idstring
CodeFile ID to annotate. Provide EITHER file_id or symbol_id (exactly one — tool errors if both or neither). Use file_id for file-level purpose descriptions; use symbol_id for a specific function/class.
is_god_nodeboolean
Optional override of the auto-computed isGodNode flag on the symbol. Usually omit — Tentra derives it from fanIn/fanOut. Set true only when you have strong evidence of coupling the static analysis missed.
job_idstringобязательный
Active indexing job_id from index_code. Required — this is what ties the annotation back to a job and advances its progress cursor.
lens_metadataobject
Arbitrary JSON payload scoped to whichever "lens" (security, performance, testing…) the agent is extracting for. Free-form; no schema enforced.
purposestringобязательный
One-sentence human-readable purpose string. Example: "Verifies HMAC signatures on incoming Stripe webhooks". Shown in query_symbols results, get_service_code_graph (include_semantics=true), and explain_code_path hop annotations. Keep under ~200 chars.
semantic_role_slugstring
Optional semantic role from the SemanticRole catalog (e.g. "service", "repository", "controller", "handler"). Helps query_symbols filter by architectural role.
snapshot_idstringобязательный
Snapshot the file or symbol belongs to (from index_code response). Required — semantic nodes are snapshot-scoped so they can evolve over time.
symbol_idstring
CodeSymbol ID to annotate. Provide EITHER file_id or symbol_id (not both). Use for fine-grained annotations on one function/class/method; prefer file_id for coarse per-file summaries.
