Skip to content

crv.core.tables.oracle_calls

Experimental API

crv.core.tables.oracle_calls

Canonical descriptor for the 'oracle_calls' table.

Purpose: - LLM/tool invocation metadata and cache signals for deterministic audit.

Schema: - columns: bucket i64, tick i64, agent_id str, engine str, signature_id str, persona_id str, persona_hash str, representation_hash str, context_hash str, value_json str, latency_ms i64, cache_hit i64, n_tool_calls i64, tool_seq struct - required: ["bucket","tick","agent_id","engine","signature_id","persona_id","persona_hash", "representation_hash","context_hash","value_json","latency_ms","cache_hit", "n_tool_calls","tool_seq"] - nullable: [] - partitioning: ["bucket"] - version: pinned to crv.core.versioning.SCHEMA_V

Notes: - cache_hit is stored as 0/1 (i64) to conform to allowed dtypes in core tables. - Core is zero-IO; IO layers (crv.io) materialize and validate row schemas. - See src/crv/core/README.md (Table Catalog) for details and downstream usage.

crv.core.tables.oracle_calls.ORACLE_CALLS_DESC module-attribute 

ORACLE_CALLS_DESC = crv.core.grammar.TableDescriptor(
    name=crv.core.grammar.TableName.ORACLE_CALLS,
    columns={
        "bucket": "i64",
        "tick": "i64",
        "agent_id": "str",
        "engine": "str",
        "signature_id": "str",
        "persona_id": "str",
        "persona_hash": "str",
        "representation_hash": "str",
        "context_hash": "str",
        "value_json": "str",
        "latency_ms": "i64",
        "cache_hit": "i64",
        "n_tool_calls": "i64",
        "tool_seq": "struct",
    },
    partitioning=["bucket"],
    required=[
        "bucket",
        "tick",
        "agent_id",
        "engine",
        "signature_id",
        "persona_id",
        "persona_hash",
        "representation_hash",
        "context_hash",
        "value_json",
        "latency_ms",
        "cache_hit",
        "n_tool_calls",
        "tool_seq",
    ],
    nullable=[],
    version=crv.core.versioning.SCHEMA_V,
)