Build on the audit layer

Step 1: Install the SDK

pip install sigmodx
# or
npm install @sigmodx/sdk

Step 2: Hash your inputs and submit a decision

from sigmodx import SigmodxClient, InvoiceDecision

client = SigmodxClient(
    api_key="your-api-key",
    agent_id="your-agent-id",
)

input_hash = client.hash_inputs({
    "invoice_id": "INV-2026-0042",
    "vendor_id": "VENDOR-4821",
    "amount": 32000,
    "po_reference": "PO-4821",
})

result = client.submit_invoice_decision(
    InvoiceDecision(
        decision_type="approve",
        input_hash=input_hash,
        rationale="Invoice matches PO. Vendor in good standing. Within limit.",
        invoice_amount=32000,
        vendor_id="VENDOR-4821",
    )
)

print(result.decision_event_id)
print(result.agent_state)  # ALLOW / LIMIT / BLOCK

Step 3: Record the outcome (optional but recommended)

client.record_outcome(
    decision_event_id=result.decision_event_id,
    outcome="processed",
)

Outcome recording uses an org admin or member session token (not the agent API key). See the Agent API reference.

LangChain

pip install sigmodx-integrations

from sigmodx_integrations import (
    SigmodxCallbackHandler,
    ANOMALY_DETECTION_CONFIG,
)

handler = SigmodxCallbackHandler(
    client=client,
    config=ANOMALY_DETECTION_CONFIG,
)

# Register with your agent executor
result = agent_executor.invoke(
    {"input": "Check this transaction"},
    config={"callbacks": [handler]},
)
# Every tool call is now automatically logged to Sigmodx

MCP Server

pip install sigmodx-mcp

# Start the server
SIGMODX_API_KEY=your-key \
SIGMODX_AGENT_ID=your-agent-uuid \
sigmodx-mcp

Universal (any framework)

from sigmodx_integrations.universal import SigmodxAdapter

adapter = SigmodxAdapter(client=client, scenario="anomaly_detection")
adapter.log(
    inputs={"txn_ref": "TXN-001", "amount": 5000},
    decision_type="flag",
    rationale="Amount 3x historical average.",
    anomaly_subtype="unusual_amount",
    severity="high",
)