sqai 0.1.5

SQAI (Structured Query AI) — the deterministic, read-only structured-data SDK for AI agents, with full provenance.

sqai

SQAI (Structured Query AI) — the deterministic, read-only structured-data SDK for AI agents, with full provenance. Python twin of @thyn-ai/sqai: same vocabulary, same error codes, same golden numbers, byte-identical cross-language hashes.

from sqai import create_sqai

sq = create_sqai()  # zero-config: SQAI_ENGINE_URL -> self_hosted, SQAI_API_KEY -> api, else local
sq.connect("sales.csv", name="sales")

# Query plane — in-process, no key
outcome = sq.ask({"metric": "revenue", "aggregation": "sum",
                  "group_by": "region", "source_name": "sales"})

# Compute plane — one of 4,778 read-only capabilities; same value + hashes as TypeScript
result = sq.compute(module="finance", function="npv", args=[0.1, [-1000, 300, 420, 560, 680]])
print(result["value"], result["computation_hash"])
# 505.020148896933 b74f67d0d7a594aa7ac91f6291612452aa8ccdf603351ebc8d801a6fddd91bc8

• Query plane — connect / resolve / query / verify / ask, in-process, no daemon or key.
• Compute plane — validated against the embedded capability contract, dispatched to the managed runtime (it provisions once, then stays warm — no per-query cold start); results pass through verbatim with a determinism envelope (invocation_hash before execution, computation_hash after).
• Policy — allow-lists for sources, fields, and functions; the surface is read-only deterministic capabilities, and policy can only narrow it.
• Errors — engine codes pass through verbatim (source="engine"); SQAI codes share the same snake_case vocabulary (source="sqai"). Messages never leak absolute paths.

The unsafe escape hatch (from sqai.unsafe import get_unsafe_runtime) bypasses every guarantee above and is deliberately not exported from the package root.

Apache-2.0.