{ "repository": "https://github.com/onfire7777/Mnemosyne", "revision": "e1ad2d0cf5ac19298547740363795c2ad25da356", "schema": "mnemetric.mcp-coverage-inventory/v1", "scope": "Static tool declarations and method signatures; excludes runtime schema patches, transport behavior and behavioral coverage.", "source_path": "src/mnemosyne/mcp_tools.py", "source_sha256": "5bb2eaca8e218b8f59c1694cb0d9d601a4ec3ad7b5a7b0752d7d5e8299a46ac5", "tools": [ { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "session_id", "user_id", "agent_id", "task_id", "branch", "kind", "content", "evidence_ids", "ttl_seconds", "created_at", "role", "source_trust_tier" ], "description": "Seed tenant/session-scoped working memory with bounded TTL and evidence provenance.", "evidence": [], "method_line": 635, "method_only_arguments": [ "item_id" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "session_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "agent_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "task_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "branch", "required": true }, { "annotation": "str", "default_expression": null, "name": "kind", "required": true }, { "annotation": "str", "default_expression": null, "name": "content", "required": true }, { "annotation": "list[str]", "default_expression": null, "name": "evidence_ids", "required": true }, { "annotation": "int", "default_expression": null, "name": "ttl_seconds", "required": true }, { "annotation": "str | datetime", "default_expression": null, "name": "created_at", "required": true }, { "annotation": "WriteRole", "default_expression": "'agent'", "name": "role", "required": false }, { "annotation": "int", "default_expression": "int(TrustTier.NORMAL)", "name": "source_trust_tier", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "item_id", "required": false } ], "tool": "working_seed" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "session_id", "user_id", "agent_id", "task_id", "branch", "as_of" ], "description": "List live working-memory items in an explicit authenticated subject scope, newest first. limit keeps only the newest `limit` items after the scope filter; kinds keeps only items of those kinds. With neither, every live item of the scope is returned.", "evidence": [], "method_line": 666, "method_only_arguments": [ "limit", "kinds" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "session_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "agent_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "task_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "branch", "required": true }, { "annotation": "str | datetime", "default_expression": null, "name": "as_of", "required": true }, { "annotation": "int | None", "default_expression": "None", "name": "limit", "required": false }, { "annotation": "list[str] | None", "default_expression": "None", "name": "kinds", "required": false } ], "tool": "working_query" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "session_id", "user_id", "agent_id", "task_id", "branch", "item_id", "as_of", "cases", "role", "source_trust_tier" ], "description": "Promote one working item through the regression-backed promotion gate.", "evidence": [], "method_line": 687, "method_only_arguments": [], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "session_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "agent_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "task_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "branch", "required": true }, { "annotation": "str", "default_expression": null, "name": "item_id", "required": true }, { "annotation": "str | datetime", "default_expression": null, "name": "as_of", "required": true }, { "annotation": "list[dict[str, Any]]", "default_expression": null, "name": "cases", "required": true }, { "annotation": "WriteRole", "default_expression": null, "name": "role", "required": true }, { "annotation": "int", "default_expression": null, "name": "source_trust_tier", "required": true } ], "tool": "working_promote" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "session_id", "user_id", "agent_id", "task_id", "branch", "expired_at", "role", "source_trust_tier" ], "description": "Expire due working-memory items in an explicit authenticated subject scope.", "evidence": [], "method_line": 732, "method_only_arguments": [], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "session_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "agent_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "task_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "branch", "required": true }, { "annotation": "str | datetime", "default_expression": null, "name": "expired_at", "required": true }, { "annotation": "WriteRole", "default_expression": null, "name": "role", "required": true }, { "annotation": "int", "default_expression": null, "name": "source_trust_tier", "required": true } ], "tool": "working_expire" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "user_id", "actor", "source_type", "content" ], "description": "Append verbatim evidence to the content-addressed ledger. created=true only when this call inserted a live row; idempotent=true only when that live row was already present. A blocked erased replay or a deferred write sets both to false. tenant_id must not be empty.", "evidence": [], "method_line": 759, "method_only_arguments": [ "branch", "trust_tier", "source_identity", "session_id", "metadata" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "actor", "required": true }, { "annotation": "str", "default_expression": null, "name": "source_type", "required": true }, { "annotation": "str", "default_expression": null, "name": "content", "required": true }, { "annotation": "str", "default_expression": "'main'", "name": "branch", "required": false }, { "annotation": "int", "default_expression": "int(TrustTier.DIRECT_USER)", "name": "trust_tier", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "source_identity", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "session_id", "required": false }, { "annotation": "dict[str, Any] | None", "default_expression": "None", "name": "metadata", "required": false } ], "tool": "capture" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "user_id", "actor", "source_type", "content", "data", "media_type", "modality", "signed_provenance", "capability_tags" ], "description": "Run the ingestion pipeline with provenance verification and optional object externalization.", "evidence": [], "method_line": 812, "method_only_arguments": [ "branch", "trust_tier", "source_identity", "metadata", "sensitivity" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "actor", "required": true }, { "annotation": "str", "default_expression": null, "name": "source_type", "required": true }, { "annotation": "str | None", "default_expression": "None", "name": "content", "required": false }, { "annotation": "bytes | None", "default_expression": "None", "name": "data", "required": false }, { "annotation": "str", "default_expression": "'main'", "name": "branch", "required": false }, { "annotation": "int | None", "default_expression": "None", "name": "trust_tier", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "source_identity", "required": false }, { "annotation": "str", "default_expression": "'text/plain'", "name": "media_type", "required": false }, { "annotation": "str", "default_expression": "'text'", "name": "modality", "required": false }, { "annotation": "dict[str, Any] | None", "default_expression": "None", "name": "metadata", "required": false }, { "annotation": "dict[str, Any] | None", "default_expression": "None", "name": "signed_provenance", "required": false }, { "annotation": "list[str] | None", "default_expression": "None", "name": "capability_tags", "required": false }, { "annotation": "int", "default_expression": "0", "name": "sensitivity", "required": false } ], "tool": "ingest" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "subject", "predicate", "object_value", "source_evidence_cids" ], "description": "Upsert a typed assertion with evidence provenance.", "evidence": [], "method_line": 875, "method_only_arguments": [ "user_id", "branch", "confidence", "trust_tier", "role", "source_trust_tier", "valid_from" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "subject", "required": true }, { "annotation": "str", "default_expression": null, "name": "predicate", "required": true }, { "annotation": "str", "default_expression": null, "name": "object_value", "required": true }, { "annotation": "list[str]", "default_expression": null, "name": "source_evidence_cids", "required": true }, { "annotation": "str | None", "default_expression": "None", "name": "user_id", "required": false }, { "annotation": "str", "default_expression": "'main'", "name": "branch", "required": false }, { "annotation": "float", "default_expression": "0.7", "name": "confidence", "required": false }, { "annotation": "int", "default_expression": "int(TrustTier.DIRECT_USER)", "name": "trust_tier", "required": false }, { "annotation": "WriteRole", "default_expression": "'agent'", "name": "role", "required": false }, { "annotation": "int | None", "default_expression": "None", "name": "source_trust_tier", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "valid_from", "required": false } ], "tool": "assert_fact" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "user_id", "root" ], "description": "Compile committed Markdown/git source-of-truth assertion blocks into evidence-backed memory.", "evidence": [], "method_line": 915, "method_only_arguments": [ "branch", "apply", "role", "source_trust_tier", "allow_dirty" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "root", "required": true }, { "annotation": "str", "default_expression": "'main'", "name": "branch", "required": false }, { "annotation": "bool", "default_expression": "False", "name": "apply", "required": false }, { "annotation": "WriteRole", "default_expression": "'operator'", "name": "role", "required": false }, { "annotation": "int", "default_expression": "int(TrustTier.USER_AUTHORED)", "name": "source_trust_tier", "required": false }, { "annotation": "bool", "default_expression": "False", "name": "allow_dirty", "required": false } ], "tool": "source_sync" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "source", "predicate", "target" ], "description": "Add a temporal relation edge for graph retrieval. Without source_evidence_cids a self-attested evidence record is minted so the edge is still retrievable, and the result carries a warning: such an edge earns no independent corroboration and is graded at the lowest visible trust tier.", "evidence": [], "method_line": 945, "method_only_arguments": [ "branch", "confidence", "source_evidence_cids", "role", "source_trust_tier" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "source", "required": true }, { "annotation": "str", "default_expression": null, "name": "predicate", "required": true }, { "annotation": "str", "default_expression": null, "name": "target", "required": true }, { "annotation": "str", "default_expression": "'main'", "name": "branch", "required": false }, { "annotation": "float", "default_expression": "0.7", "name": "confidence", "required": false }, { "annotation": "list[str] | None", "default_expression": "None", "name": "source_evidence_cids", "required": false }, { "annotation": "WriteRole", "default_expression": "'agent'", "name": "role", "required": false }, { "annotation": "int", "default_expression": "int(TrustTier.NORMAL)", "name": "source_trust_tier", "required": false } ], "tool": "relation" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "user_id", "category", "statement" ], "description": "Record an explicit or inferred preference with precedence rules.", "evidence": [], "method_line": 1018, "method_only_arguments": [ "explicit", "confidence", "source_evidence_cids", "access_policy", "role", "source_trust_tier" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "category", "required": true }, { "annotation": "str", "default_expression": null, "name": "statement", "required": true }, { "annotation": "bool", "default_expression": "False", "name": "explicit", "required": false }, { "annotation": "float", "default_expression": "0.7", "name": "confidence", "required": false }, { "annotation": "list[str] | None", "default_expression": "None", "name": "source_evidence_cids", "required": false }, { "annotation": "dict[str, Any] | None", "default_expression": "None", "name": "access_policy", "required": false }, { "annotation": "WriteRole", "default_expression": "'agent'", "name": "role", "required": false }, { "annotation": "int | None", "default_expression": "None", "name": "source_trust_tier", "required": false } ], "tool": "preference" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "user_id", "agent_id", "trigger_type", "trigger_expression", "action", "due_at", "evidence_ids", "priority", "dependencies", "reschedule_history", "recurrence_policy", "idempotency_key" ], "description": "Schedule a data-only prospective-memory intention backed by originating evidence. An optional session-scoped idempotency_key replays the original creation acknowledgement; use list_intentions for current state.", "evidence": [], "method_line": 1053, "method_only_arguments": [], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "agent_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "trigger_type", "required": true }, { "annotation": "dict[str, Any]", "default_expression": null, "name": "trigger_expression", "required": true }, { "annotation": "dict[str, Any]", "default_expression": null, "name": "action", "required": true }, { "annotation": "str", "default_expression": null, "name": "due_at", "required": true }, { "annotation": "list[str]", "default_expression": null, "name": "evidence_ids", "required": true }, { "annotation": "str", "default_expression": "'normal'", "name": "priority", "required": false }, { "annotation": "list[str] | None", "default_expression": "None", "name": "dependencies", "required": false }, { "annotation": "list[dict[str, Any]] | None", "default_expression": "None", "name": "reschedule_history", "required": false }, { "annotation": "dict[str, Any] | None", "default_expression": "None", "name": "recurrence_policy", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "idempotency_key", "required": false } ], "tool": "schedule_intention" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "intention_id", "user_id", "agent_id", "due_at", "action", "recurrence_policy", "expected_revision", "idempotency_key" ], "description": "Reschedule or replace the data-only action for an authenticated subject intention.", "evidence": [], "method_line": 1118, "method_only_arguments": [], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "intention_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "agent_id", "required": true }, { "annotation": "str | None", "default_expression": "None", "name": "due_at", "required": false }, { "annotation": "dict[str, Any] | None", "default_expression": "None", "name": "action", "required": false }, { "annotation": "dict[str, Any] | None", "default_expression": "None", "name": "recurrence_policy", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "expected_revision", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "idempotency_key", "required": false } ], "tool": "update_intention" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "intention_id", "cancelled_by", "expected_revision", "idempotency_key" ], "description": "Cancel a scheduled prospective-memory intention as its owning user or agent.", "evidence": [], "method_line": 1151, "method_only_arguments": [], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "intention_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "cancelled_by", "required": true }, { "annotation": "str | None", "default_expression": "None", "name": "expected_revision", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "idempotency_key", "required": false } ], "tool": "cancel_intention" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "evaluated_at", "trigger_context", "operating_point" ], "description": "Evaluate due prospective-memory intentions from an authenticated scheduler context.", "evidence": [], "method_line": 1225, "method_only_arguments": [], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "evaluated_at", "required": true }, { "annotation": "dict[str, Any]", "default_expression": null, "name": "trigger_context", "required": true }, { "annotation": "dict[str, Any]", "default_expression": null, "name": "operating_point", "required": true } ], "tool": "evaluate_intentions" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "include_revision" ], "description": "List prospective-memory intentions owned by the authenticated subject.", "evidence": [], "method_line": 1261, "method_only_arguments": [], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "bool", "default_expression": "False", "name": "include_revision", "required": false } ], "tool": "list_intentions" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "query" ], "description": "Fast hybrid retrieval with trust filtering, provenance, confidence, and abstention. Trust tiers are numeric and lower is MORE trusted (0 = direct user, 5 = untrusted external). min_trust_tier and max_trust_tier both name the least-trusted tier still admitted, and max_trust_tier is the one applied when both are given, so a contradictory pair (min above max) is refused rather than silently collapsed. session_id (honoured only with a valid signed session_token for that session, refused otherwise) ranks that session's live working memory together with long-term memory in the one list, and a working item and the ledger record it cites come back as one hit. token_budget fits the hits to fewer tokens and is clamped, not refused, above the policy budget of 4096. lean leaves out the explain block and the per-hit diagnostics. Every hit's metadata says its memory_type and created_at.", "evidence": [], "method_line": 1311, "method_only_arguments": [ "branch", "min_trust_tier", "max_trust_tier", "max_sensitivity", "role", "user_id", "capability_tags", "purpose", "residency", "region", "break_glass", "lawful_basis", "session_id", "token_budget", "lean" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "query", "required": true }, { "annotation": "str", "default_expression": "'main'", "name": "branch", "required": false }, { "annotation": "int | None", "default_expression": "None", "name": "min_trust_tier", "required": false }, { "annotation": "int | None", "default_expression": "None", "name": "max_trust_tier", "required": false }, { "annotation": "int | None", "default_expression": "None", "name": "max_sensitivity", "required": false }, { "annotation": "WriteRole", "default_expression": "'reader'", "name": "role", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "user_id", "required": false }, { "annotation": "list[str] | None", "default_expression": "None", "name": "capability_tags", "required": false }, { "annotation": "str | list[str] | None", "default_expression": "None", "name": "purpose", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "residency", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "region", "required": false }, { "annotation": "bool", "default_expression": "False", "name": "break_glass", "required": false }, { "annotation": "str | list[str] | None", "default_expression": "None", "name": "lawful_basis", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "session_id", "required": false }, { "annotation": "int | None", "default_expression": "None", "name": "token_budget", "required": false }, { "annotation": "bool", "default_expression": "False", "name": "lean", "required": false } ], "tool": "search" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "query" ], "description": "Expanded retrieval path with graph channel enabled when graph data exists. Takes session_id, token_budget and lean exactly as search does.", "evidence": [], "method_line": 1361, "method_only_arguments": [ "branch", "role", "user_id", "max_sensitivity", "capability_tags", "purpose", "residency", "region", "break_glass", "lawful_basis", "session_id", "token_budget", "lean" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "query", "required": true }, { "annotation": "str", "default_expression": "'main'", "name": "branch", "required": false }, { "annotation": "WriteRole", "default_expression": "'reader'", "name": "role", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "user_id", "required": false }, { "annotation": "int | None", "default_expression": "None", "name": "max_sensitivity", "required": false }, { "annotation": "list[str] | None", "default_expression": "None", "name": "capability_tags", "required": false }, { "annotation": "str | list[str] | None", "default_expression": "None", "name": "purpose", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "residency", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "region", "required": false }, { "annotation": "bool", "default_expression": "False", "name": "break_glass", "required": false }, { "annotation": "str | list[str] | None", "default_expression": "None", "name": "lawful_basis", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "session_id", "required": false }, { "annotation": "int | None", "default_expression": "None", "name": "token_budget", "required": false }, { "annotation": "bool", "default_expression": "False", "name": "lean", "required": false } ], "tool": "deep_search" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "id" ], "description": "Fetch one CURRENTLY VALID memory record by id or cid from the tenant export surface. History is deliberately out of scope: a superseded, retracted or erased record is reported as not found. The ledger still retains a superseded assertion (status=superseded, with valid_to set), and its earlier value is read with graph_as_of at a timestamp inside its validity window.", "evidence": [], "method_line": 1504, "method_only_arguments": [ "branch", "role", "user_id", "max_sensitivity", "capability_tags", "purpose", "residency", "region", "break_glass", "lawful_basis" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "id", "required": true }, { "annotation": "str | None", "default_expression": "None", "name": "branch", "required": false }, { "annotation": "WriteRole", "default_expression": "'reader'", "name": "role", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "user_id", "required": false }, { "annotation": "int | None", "default_expression": "None", "name": "max_sensitivity", "required": false }, { "annotation": "list[str] | None", "default_expression": "None", "name": "capability_tags", "required": false }, { "annotation": "str | list[str] | None", "default_expression": "None", "name": "purpose", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "residency", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "region", "required": false }, { "annotation": "bool", "default_expression": "False", "name": "break_glass", "required": false }, { "annotation": "str | list[str] | None", "default_expression": "None", "name": "lawful_basis", "required": false } ], "tool": "get" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "query" ], "description": "Return retrieval stages, channels, provenance, confidence, and immutable rails.", "evidence": [], "method_line": 1404, "method_only_arguments": [ "branch", "role", "user_id", "max_sensitivity", "capability_tags", "purpose", "residency", "region", "break_glass", "lawful_basis" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "query", "required": true }, { "annotation": "str", "default_expression": "'main'", "name": "branch", "required": false }, { "annotation": "WriteRole", "default_expression": "'reader'", "name": "role", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "user_id", "required": false }, { "annotation": "int | None", "default_expression": "None", "name": "max_sensitivity", "required": false }, { "annotation": "list[str] | None", "default_expression": "None", "name": "capability_tags", "required": false }, { "annotation": "str | list[str] | None", "default_expression": "None", "name": "purpose", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "residency", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "region", "required": false }, { "annotation": "bool", "default_expression": "False", "name": "break_glass", "required": false }, { "annotation": "str | list[str] | None", "default_expression": "None", "name": "lawful_basis", "required": false } ], "tool": "explain" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "user_id", "subject", "predicate", "object_value" ], "description": "Write a candidate fact into an isolated proposal branch for later confirmation.", "evidence": [], "method_line": 1558, "method_only_arguments": [ "source_evidence_cids", "confidence", "trust_tier", "branch", "role", "source_trust_tier" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "subject", "required": true }, { "annotation": "str", "default_expression": null, "name": "predicate", "required": true }, { "annotation": "str", "default_expression": null, "name": "object_value", "required": true }, { "annotation": "list[str] | None", "default_expression": "None", "name": "source_evidence_cids", "required": false }, { "annotation": "float", "default_expression": "0.7", "name": "confidence", "required": false }, { "annotation": "int", "default_expression": "int(TrustTier.NORMAL)", "name": "trust_tier", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "branch", "required": false }, { "annotation": "WriteRole", "default_expression": "'agent'", "name": "role", "required": false }, { "annotation": "int | None", "default_expression": "None", "name": "source_trust_tier", "required": false } ], "tool": "propose" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "id" ], "description": "Confirm a proposed branch or candidate id by merging it into main.", "evidence": [], "method_line": 1604, "method_only_arguments": [ "role", "source_trust_tier", "tenant_id", "branch", "into" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "id", "required": true }, { "annotation": "WriteRole", "default_expression": null, "name": "role", "required": true }, { "annotation": "int", "default_expression": null, "name": "source_trust_tier", "required": true }, { "annotation": "str | None", "default_expression": "None", "name": "tenant_id", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "branch", "required": false }, { "annotation": "str", "default_expression": "'main'", "name": "into", "required": false } ], "tool": "confirm" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "user_id", "subject", "predicate", "object_value", "correction_text" ], "description": "Record an authoritative correction and upsert the superseding assertion.", "evidence": [], "method_line": 1708, "method_only_arguments": [ "branch", "confidence", "role", "source_trust_tier" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "subject", "required": true }, { "annotation": "str", "default_expression": null, "name": "predicate", "required": true }, { "annotation": "str", "default_expression": null, "name": "object_value", "required": true }, { "annotation": "str", "default_expression": null, "name": "correction_text", "required": true }, { "annotation": "str", "default_expression": "'main'", "name": "branch", "required": false }, { "annotation": "float", "default_expression": "0.95", "name": "confidence", "required": false }, { "annotation": "WriteRole", "default_expression": "'agent'", "name": "role", "required": false }, { "annotation": "int", "default_expression": "int(TrustTier.USER_AUTHORED)", "name": "source_trust_tier", "required": false } ], "tool": "correct" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "user_id", "id", "new" ], "description": "Supersede an existing assertion with a newer assertion value.", "evidence": [], "method_line": 1650, "method_only_arguments": [ "branch", "confidence", "role", "source_trust_tier", "valid_from" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "id", "required": true }, { "annotation": "dict[str, Any]", "default_expression": null, "name": "new", "required": true }, { "annotation": "str", "default_expression": "'main'", "name": "branch", "required": false }, { "annotation": "float", "default_expression": "0.95", "name": "confidence", "required": false }, { "annotation": "WriteRole", "default_expression": "'agent'", "name": "role", "required": false }, { "annotation": "int", "default_expression": "int(TrustTier.USER_AUTHORED)", "name": "source_trust_tier", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "valid_from", "required": false } ], "tool": "supersede" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "cid" ], "description": "Erase evidence content on EVERY branch holding the cid and propagate retraction or provenance trimming. Reports branches_erased; pass all_branches=false to erase only the named branch.", "evidence": [], "method_line": 1777, "method_only_arguments": [ "branch", "requested_by", "role", "source_trust_tier", "erasure_mode", "all_branches" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "cid", "required": true }, { "annotation": "str", "default_expression": "'main'", "name": "branch", "required": false }, { "annotation": "str", "default_expression": "'user'", "name": "requested_by", "required": false }, { "annotation": "WriteRole", "default_expression": "'operator'", "name": "role", "required": false }, { "annotation": "int", "default_expression": "int(TrustTier.USER_AUTHORED)", "name": "source_trust_tier", "required": false }, { "annotation": "str", "default_expression": "'tombstone_recompute'", "name": "erasure_mode", "required": false }, { "annotation": "bool", "default_expression": "True", "name": "all_branches", "required": false } ], "tool": "forget" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "role", "user_id", "max_sensitivity", "capability_tags", "purpose" ], "description": "Export a caller-scoped tenant disclosure view with omissions and redactions reported.", "evidence": [], "method_line": 1885, "method_only_arguments": [ "residency", "region", "break_glass", "lawful_basis" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "WriteRole", "default_expression": "'reader'", "name": "role", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "user_id", "required": false }, { "annotation": "int | None", "default_expression": "None", "name": "max_sensitivity", "required": false }, { "annotation": "list[str] | None", "default_expression": "None", "name": "capability_tags", "required": false }, { "annotation": "str | list[str] | None", "default_expression": "None", "name": "purpose", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "residency", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "region", "required": false }, { "annotation": "bool", "default_expression": "False", "name": "break_glass", "required": false }, { "annotation": "str | list[str] | None", "default_expression": "None", "name": "lawful_basis", "required": false } ], "tool": "export" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [], "description": "Inspect configured data/runtime residency enforcement and transfer allowlists.", "evidence": [], "method_line": 872, "method_only_arguments": [], "method_parameters": [], "tool": "residency_policy" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "name" ], "description": "Create a branch from an existing branch. The name must be non-empty, must not be the reserved name 'main', and must not be path-like.", "evidence": [], "method_line": 1959, "method_only_arguments": [ "role", "source_trust_tier", "from_branch", "kind", "tenant_id" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "name", "required": true }, { "annotation": "WriteRole", "default_expression": null, "name": "role", "required": true }, { "annotation": "int", "default_expression": null, "name": "source_trust_tier", "required": true }, { "annotation": "str", "default_expression": "'main'", "name": "from_branch", "required": false }, { "annotation": "str", "default_expression": "'scratch'", "name": "kind", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "tenant_id", "required": false } ], "tool": "branch" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "from_branch" ], "description": "Merge a branch into another branch through the engine contract.", "evidence": [], "method_line": 1990, "method_only_arguments": [ "role", "source_trust_tier", "into", "tenant_id" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "from_branch", "required": true }, { "annotation": "WriteRole", "default_expression": null, "name": "role", "required": true }, { "annotation": "int", "default_expression": null, "name": "source_trust_tier", "required": true }, { "annotation": "str", "default_expression": "'main'", "name": "into", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "tenant_id", "required": false } ], "tool": "merge" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "branch" ], "description": "Discard a non-main branch and its candidate memories.", "evidence": [], "method_line": 2008, "method_only_arguments": [ "role", "source_trust_tier", "tenant_id" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "branch", "required": true }, { "annotation": "WriteRole", "default_expression": null, "name": "role", "required": true }, { "annotation": "int", "default_expression": null, "name": "source_trust_tier", "required": true }, { "annotation": "str | None", "default_expression": "None", "name": "tenant_id", "required": false } ], "tool": "discard" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "user_id", "kind", "statement" ], "description": "Add a typed user-model entry.", "evidence": [], "method_line": 2025, "method_only_arguments": [ "scope", "confidence", "exceptions", "source_evidence_cids", "role", "source_trust_tier" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "kind", "required": true }, { "annotation": "str", "default_expression": null, "name": "statement", "required": true }, { "annotation": "dict[str, Any] | None", "default_expression": "None", "name": "scope", "required": false }, { "annotation": "float", "default_expression": "0.7", "name": "confidence", "required": false }, { "annotation": "dict[str, Any] | None", "default_expression": "None", "name": "exceptions", "required": false }, { "annotation": "list[str] | None", "default_expression": "None", "name": "source_evidence_cids", "required": false }, { "annotation": "WriteRole", "default_expression": "'agent'", "name": "role", "required": false }, { "annotation": "int | None", "default_expression": "None", "name": "source_trust_tier", "required": false } ], "tool": "profile_add" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "user_id" ], "description": "Return scope-matched user-model context.", "evidence": [], "method_line": 2079, "method_only_arguments": [ "scope" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "dict[str, Any] | None", "default_expression": "None", "name": "scope", "required": false } ], "tool": "profile_context" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "user_id" ], "description": "Blueprint alias for returning relevant user-profile context.", "evidence": [], "method_line": 2082, "method_only_arguments": [ "context" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "dict[str, Any] | None", "default_expression": "None", "name": "context", "required": false } ], "tool": "profile_get_relevant" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "user_id", "statement" ], "description": "Blueprint alias for recording an explicit user preference.", "evidence": [], "method_line": 2085, "method_only_arguments": [ "scope", "confidence", "source_evidence_cids" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "statement", "required": true }, { "annotation": "dict[str, Any] | None", "default_expression": "None", "name": "scope", "required": false }, { "annotation": "float", "default_expression": "0.9", "name": "confidence", "required": false }, { "annotation": "list[str] | None", "default_expression": "None", "name": "source_evidence_cids", "required": false } ], "tool": "profile_record_explicit" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "user_id", "statement" ], "description": "Blueprint alias for proposing an inferred user preference.", "evidence": [], "method_line": 2106, "method_only_arguments": [ "context", "confidence", "source_evidence_cids" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "statement", "required": true }, { "annotation": "dict[str, Any] | None", "default_expression": "None", "name": "context", "required": false }, { "annotation": "float", "default_expression": "0.55", "name": "confidence", "required": false }, { "annotation": "list[str] | None", "default_expression": "None", "name": "source_evidence_cids", "required": false } ], "tool": "profile_propose_inference" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "user_id", "id", "statement" ], "description": "Record an explicit profile correction. The entry named by id is superseded by the corrected statement and no longer appears in profile_context; weaker inferred entries that differ are superseded too. id must name an active entry in this tenant/user scope. The correction keeps that entry's scope unless context is given, and is an explicit preference unless it replaces an instruction or an identity, which stay what they are. Authority is the caller's role and trust tier (a signed session sets both): correcting a hard instruction is a policy write.", "evidence": [], "method_line": 2127, "method_only_arguments": [ "context", "confidence", "role", "source_trust_tier" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "id", "required": true }, { "annotation": "str", "default_expression": null, "name": "statement", "required": true }, { "annotation": "dict[str, Any] | None", "default_expression": "None", "name": "context", "required": false }, { "annotation": "float", "default_expression": "0.95", "name": "confidence", "required": false }, { "annotation": "WriteRole", "default_expression": "'agent'", "name": "role", "required": false }, { "annotation": "int", "default_expression": "int(TrustTier.USER_AUTHORED)", "name": "source_trust_tier", "required": false } ], "tool": "profile_correct" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "user_id", "id" ], "description": "Take a profile entry back: it stops being active and no longer appears in profile_context. The record is kept, marked retracted. An unknown id, or one from another tenant or user, is an error. Authority is the caller's role and trust tier (a signed session sets both): taking an entry back is a destructive write, which needs the operator or consolidator role, and a hard instruction is a policy write.", "evidence": [], "method_line": 2192, "method_only_arguments": [ "role", "source_trust_tier" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "id", "required": true }, { "annotation": "WriteRole", "default_expression": "'operator'", "name": "role", "required": false }, { "annotation": "int", "default_expression": "int(TrustTier.USER_AUTHORED)", "name": "source_trust_tier", "required": false } ], "tool": "profile_retire" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "user_id", "pattern", "description" ], "description": "Record a neutral user-slip episode and promote scoped support only after repeated similar events.", "evidence": [], "method_line": 2231, "method_only_arguments": [ "scope", "suggestion", "occurred_at", "role", "source_trust_tier" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "pattern", "required": true }, { "annotation": "str", "default_expression": null, "name": "description", "required": true }, { "annotation": "dict[str, Any] | None", "default_expression": "None", "name": "scope", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "suggestion", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "occurred_at", "required": false }, { "annotation": "WriteRole", "default_expression": "'agent'", "name": "role", "required": false }, { "annotation": "int | None", "default_expression": "None", "name": "source_trust_tier", "required": false } ], "tool": "profile_record_mistake" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "user_id", "strategy_id", "role", "source_trust_tier" ], "description": "Retire a scoped support strategy so it no longer appears in profile context.", "evidence": [], "method_line": 2276, "method_only_arguments": [], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "strategy_id", "required": true }, { "annotation": "WriteRole", "default_expression": "'operator'", "name": "role", "required": false }, { "annotation": "int", "default_expression": "int(TrustTier.USER_AUTHORED)", "name": "source_trust_tier", "required": false } ], "tool": "profile_retire_support_strategy" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "candidates" ], "description": "Warm retrieval contexts through the anticipatory predictability gate.", "evidence": [], "method_line": 2305, "method_only_arguments": [ "branch", "role", "user_id", "capability_tags", "purpose" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "list[dict[str, Any]]", "default_expression": null, "name": "candidates", "required": true }, { "annotation": "str", "default_expression": "'main'", "name": "branch", "required": false }, { "annotation": "WriteRole", "default_expression": "'agent'", "name": "role", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "user_id", "required": false }, { "annotation": "list[str] | None", "default_expression": "None", "name": "capability_tags", "required": false }, { "annotation": "str | list[str] | None", "default_expression": "None", "name": "purpose", "required": false } ], "tool": "prefetch" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "seeds" ], "description": "Run tenant- and branch-scoped graph PPR over relation seeds. k is the number of hits and must be at least 1.", "evidence": [], "method_line": 2341, "method_only_arguments": [ "branch", "k" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "list[str]", "default_expression": null, "name": "seeds", "required": true }, { "annotation": "str", "default_expression": "'main'", "name": "branch", "required": false }, { "annotation": "int", "default_expression": "8", "name": "k", "required": false } ], "tool": "graph_neighbors" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "seeds" ], "description": "Graph neighbour query over relation seeds, limited to edges whose both endpoints lie within hops edges of a seed. hops and k must each be at least 1.", "evidence": [], "method_line": 2407, "method_only_arguments": [ "branch", "hops", "k" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "list[str]", "default_expression": null, "name": "seeds", "required": true }, { "annotation": "str", "default_expression": "'main'", "name": "branch", "required": false }, { "annotation": "int", "default_expression": "1", "name": "hops", "required": false }, { "annotation": "int", "default_expression": "8", "name": "k", "required": false } ], "tool": "graph_query" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "entity" ], "description": "Return assertion and relation events involving an entity.", "evidence": [], "method_line": 2432, "method_only_arguments": [ "branch", "role", "user_id", "max_sensitivity", "capability_tags", "purpose", "residency", "region", "break_glass", "lawful_basis" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "entity", "required": true }, { "annotation": "str", "default_expression": "'main'", "name": "branch", "required": false }, { "annotation": "WriteRole", "default_expression": "'reader'", "name": "role", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "user_id", "required": false }, { "annotation": "int | None", "default_expression": "None", "name": "max_sensitivity", "required": false }, { "annotation": "list[str] | None", "default_expression": "None", "name": "capability_tags", "required": false }, { "annotation": "str | list[str] | None", "default_expression": "None", "name": "purpose", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "residency", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "region", "required": false }, { "annotation": "bool", "default_expression": "False", "name": "break_glass", "required": false }, { "annotation": "str | list[str] | None", "default_expression": "None", "name": "lawful_basis", "required": false } ], "tool": "graph_timeline" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "subject", "predicate", "time" ], "description": "Return bitemporal assertions for a subject/predicate at a timestamp.", "evidence": [], "method_line": 2476, "method_only_arguments": [ "branch" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "subject", "required": true }, { "annotation": "str", "default_expression": null, "name": "predicate", "required": true }, { "annotation": "str", "default_expression": null, "name": "time", "required": true }, { "annotation": "str", "default_expression": "'main'", "name": "branch", "required": false } ], "tool": "graph_as_of" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "user_id", "session_id", "task", "steps", "outcome", "reward", "memory_version" ], "description": "Persist a trajectory for procedural/corrective learning. outcome must be 'success' or 'failure'.", "evidence": [], "method_line": 2492, "method_only_arguments": [], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "session_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "task", "required": true }, { "annotation": "list[dict[str, Any]]", "default_expression": null, "name": "steps", "required": true }, { "annotation": "TrajectoryOutcome", "default_expression": null, "name": "outcome", "required": true }, { "annotation": "float", "default_expression": null, "name": "reward", "required": true }, { "annotation": "str", "default_expression": null, "name": "memory_version", "required": true } ], "tool": "trajectory_log" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "user_id", "session_id", "task", "steps", "outcome", "reward", "memory_version" ], "description": "Blueprint alias for persisting a trajectory. outcome must be 'success' or 'failure'.", "evidence": [], "method_line": 2519, "method_only_arguments": [], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "user_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "session_id", "required": true }, { "annotation": "str", "default_expression": null, "name": "task", "required": true }, { "annotation": "list[dict[str, Any]]", "default_expression": null, "name": "steps", "required": true }, { "annotation": "TrajectoryOutcome", "default_expression": null, "name": "outcome", "required": true }, { "annotation": "float", "default_expression": null, "name": "reward", "required": true }, { "annotation": "str", "default_expression": null, "name": "memory_version", "required": true } ], "tool": "trajectory_record" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "trajectory_id" ], "description": "Attribute a logged failure trajectory.", "evidence": [], "method_line": 2532, "method_only_arguments": [], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "trajectory_id", "required": true } ], "tool": "trajectory_attribute" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "trajectory_id" ], "description": "Induce a corrective lesson from a failure attribution.", "evidence": [], "method_line": 2537, "method_only_arguments": [], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "trajectory_id", "required": true } ], "tool": "lesson_induce" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "trajectory_id" ], "description": "Blueprint alias for proposing a lesson from a trajectory.", "evidence": [], "method_line": 2543, "method_only_arguments": [], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "trajectory_id", "required": true } ], "tool": "lesson_propose" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "lesson_id" ], "description": "Induce a procedure from a corrective lesson.", "evidence": [], "method_line": 2546, "method_only_arguments": [], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "lesson_id", "required": true } ], "tool": "procedure_induce" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "lesson_id" ], "description": "Blueprint alias for proposing a procedure from a lesson.", "evidence": [], "method_line": 2552, "method_only_arguments": [], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "lesson_id", "required": true } ], "tool": "procedure_propose" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "lesson_id", "cases", "role", "source_trust_tier" ], "description": "Promote a lesson through protected regression cases. Requires at least one regression case, like working_promote.", "evidence": [], "method_line": 2555, "method_only_arguments": [], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "lesson_id", "required": true }, { "annotation": "list[dict[str, Any]]", "default_expression": null, "name": "cases", "required": true }, { "annotation": "WriteRole", "default_expression": null, "name": "role", "required": true }, { "annotation": "int", "default_expression": null, "name": "source_trust_tier", "required": true } ], "tool": "lesson_promote" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "procedure_id", "role", "source_trust_tier" ], "description": "Mark an induced procedure as validated for the isolated parametric tier.", "evidence": [], "method_line": 2596, "method_only_arguments": [], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "procedure_id", "required": true }, { "annotation": "WriteRole", "default_expression": null, "name": "role", "required": true }, { "annotation": "int", "default_expression": null, "name": "source_trust_tier", "required": true } ], "tool": "procedure_validate" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "procedure_id", "role", "source_trust_tier" ], "description": "Promote a validated procedure into the active procedural tier.", "evidence": [], "method_line": 2610, "method_only_arguments": [], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "procedure_id", "required": true }, { "annotation": "WriteRole", "default_expression": null, "name": "role", "required": true }, { "annotation": "int", "default_expression": null, "name": "source_trust_tier", "required": true } ], "tool": "procedure_promote" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "query" ], "description": "Search procedures by name, body, signature, tenant, and status.", "evidence": [], "method_line": 2639, "method_only_arguments": [ "tenant_id", "status" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "query", "required": true }, { "annotation": "str | None", "default_expression": "None", "name": "tenant_id", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "status", "required": false } ], "tool": "procedure_search" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "procedure_id", "role", "source_trust_tier" ], "description": "Mark a procedure as rolled back without deleting history.", "evidence": [], "method_line": 2652, "method_only_arguments": [], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "procedure_id", "required": true }, { "annotation": "WriteRole", "default_expression": null, "name": "role", "required": true }, { "annotation": "int", "default_expression": null, "name": "source_trust_tier", "required": true } ], "tool": "procedure_rollback" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "signature" ], "description": "Search lessons by failure signature, content, tenant, and status.", "evidence": [], "method_line": 2626, "method_only_arguments": [ "tenant_id", "status" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "signature", "required": true }, { "annotation": "str | None", "default_expression": "None", "name": "tenant_id", "required": false }, { "annotation": "str | None", "default_expression": "None", "name": "status", "required": false } ], "tool": "lesson_search" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "trajectory_id" ], "description": "Evaluate a logged trajectory outcome or counterfactual before/after counts.", "evidence": [], "method_line": 2669, "method_only_arguments": [ "before_successes", "after_successes", "total_cases" ], "method_parameters": [ { "annotation": "str | None", "default_expression": "None", "name": "trajectory_id", "required": false }, { "annotation": "int | None", "default_expression": "None", "name": "before_successes", "required": false }, { "annotation": "int | None", "default_expression": "None", "name": "after_successes", "required": false }, { "annotation": "int | None", "default_expression": "None", "name": "total_cases", "required": false } ], "tool": "outcome_evaluate" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "tenant_id", "role", "source_trust_tier" ], "description": "Create an isolated shadow parametric artifact from active lessons/procedures.", "evidence": [], "method_line": 2705, "method_only_arguments": [], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "tenant_id", "required": true }, { "annotation": "WriteRole", "default_expression": null, "name": "role", "required": true }, { "annotation": "int", "default_expression": null, "name": "source_trust_tier", "required": true } ], "tool": "parametric_propose" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "artifact_uri", "role", "source_trust_tier", "protected_case_count" ], "description": "Evaluate a shadow parametric artifact against persisted protected gate evidence.", "evidence": [], "method_line": 2748, "method_only_arguments": [ "gate_promoted", "protected_regressions" ], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "artifact_uri", "required": true }, { "annotation": "WriteRole", "default_expression": null, "name": "role", "required": true }, { "annotation": "int", "default_expression": null, "name": "source_trust_tier", "required": true }, { "annotation": "int", "default_expression": "1", "name": "protected_case_count", "required": false }, { "annotation": "bool", "default_expression": "True", "name": "gate_promoted", "required": false }, { "annotation": "list[str] | None", "default_expression": "None", "name": "protected_regressions", "required": false } ], "tool": "parametric_evaluate" }, { "benchmark_tests": [], "coverage_status": "unmapped", "declaration_only_arguments": [], "declared_arguments": [ "artifact_uri", "reason", "role", "source_trust_tier", "protected_case_count" ], "description": "Roll back a persisted isolated parametric artifact with protected-suite evidence.", "evidence": [], "method_line": 2800, "method_only_arguments": [], "method_parameters": [ { "annotation": "str", "default_expression": null, "name": "artifact_uri", "required": true }, { "annotation": "str", "default_expression": null, "name": "reason", "required": true }, { "annotation": "WriteRole", "default_expression": null, "name": "role", "required": true }, { "annotation": "int", "default_expression": null, "name": "source_trust_tier", "required": true }, { "annotation": "int", "default_expression": "1", "name": "protected_case_count", "required": false } ], "tool": "parametric_rollback" } ], "unresolved": [] }