PR #24 · pramaan-io/pramaan-agents · merged 2026-06-03
sequenceDiagram autonumber participant harness as Strands Harness participant ctx as Tool Context participant db as Database participant rec as Recorder harness->>ctx: bind firm/user/run ctx->>db: open connection db->>db: set RLS = firm_id db-->>ctx: rows ctx->>ctx: stamp duration ctx->>rec: log call ctx-->>harness: result
| Method | in → out | what it does |
|---|---|---|
MatterChatToolContext | (firm_id, user_id, run_id, tool_call_recorder, _tool_context) | |
matter_chat_tool_context | (context) → Iterator[None] | |
_current_firm_id | () → UUID |
Holds the seven MatterChat read tools plus the run-scoped context class, RLS guard, and recorder decorator — landing the deterministic toolset and firm/user/run binding this PR ships.
| new class | signature |
|---|---|
MatterChatToolContext | (firm_id, user_id, run_id, tool_call_recorder, _tool_context) |
matter_chat_tool_context | (context) → Iterator[None] |
_current_firm_id | () → UUID |
_get_engine | () → Any |
_set_rls | (conn, firm_id) → None |
_rows | (statement, params) → list[Mapping[str, Any]] |
_one | (statement, params) → Mapping[str, Any] | None |
_text | (value, default) → Any |
_uuid_text | (value) → str |
_string_list | (value) → list[str] |
_date_text | (value) → str | None |
_optional_int | (value) → int | None |
_citation | (document_id, quote_id) → str |
_run_tool | (tool_name, input_json, body) → dict[str, Any] |
_duration_ms | (started) → int |
_record_tool_calls | (func) → F |
wrapper | () → dict[str, Any] |
Gains a run id field so the tool context can carry a stable run identifier for the recorder and audit trail during MatterChat calls.
run_id : UUID | None