SDK Integration

The LetsCompl.ai SDKs (@letscomplai/sdk for TypeScript/JavaScript, letscomplai for Python) redact PII/PHI locally before any network call, then submit the redacted payload to the LetsCompl.ai evaluation gateway (https://api.letscompl.ai) for a compliance verdict against your workspace's active rulesets.

Installation

# npm
npm install @letscomplai/sdk

# pip
pip install letscomplai

TypeScript / JavaScript

import { LetsComplaiClient } from "@letscomplai/sdk";

const client = new LetsComplaiClient({
  apiKey: process.env.LETSCOMPLAI_API_KEY!,
});

const result = await client.evaluate({
  patientName: "John Doe",
  mrn: "MRN-12345",
  diagnosis: "Acute bronchitis",
  amount: 250,
});

console.log(result.verdict); // "approved" | "blocked" | "error"
console.log(result.redactedPayload);
/*
{
  patientName: "[REDACTED_NAME]",
  mrn: "[REDACTED_MRN]",
  diagnosis: "Acute bronchitis",
  amount: 250
}
*/

evaluate() redacts locally before sending anything over the network — raw PII/PHI never leaves your process unless you pass redact: false as an explicit opt-out. If you only need local redaction with no network call, use client.redactLocal(payload) or the standalone redact() export.

Guarding an action

guardAction wraps a payload check and the action it gates in one call: it throws ComplianceBlockedError if the verdict is blocked, and (by default) ComplianceUnavailableError if the gateway is unreachable, before your action runs.

import { LetsComplaiClient } from "@letscomplai/sdk";

const client = new LetsComplaiClient({
  apiKey: process.env.LETSCOMPLAI_API_KEY!,
});

const result = await client.guardAction(
  { action: "payout", amount: 1200 },
  () => payments.createPayout({ amount: 1200 }),
);

Python

from letscomplai import LetsComplaiClient

client = LetsComplaiClient(api_key="your-api-key")

result = client.evaluate({
    "patient_notes": "Mr. John Smith has a history of asthma.",
})
print(result["verdict"])  # "approved" | "blocked" | "error"

An async client mirrors the same methods for asyncio applications:

from letscomplai import AsyncLetsComplaiClient

client = AsyncLetsComplaiClient(api_key="your-api-key")
result = await client.evaluate({"action": "payout", "amount": 1200})
await client.aclose()

Both clients expose guard_action(payload, action, ...), which raises ComplianceBlockedError/ComplianceUnavailableError the same way the TypeScript SDK does.

Full reference

See docs/user/api-reference.md for the request/response schema, verdict values, and policyScope/evaluatedRules/pinnedVersions behavior — the SDKs are thin clients over that same contract.

For timeout, fail-open/fail-closed, retry, SLA, and local-enforcement behavior, see docs/operations/client-availability.md.

LEGAL_DISCLAIMER (lib/engine/disclaimer.ts): "LetsCompl.ai is a technical enforcement tool, not a legal compliance service. Verdicts do not constitute legal advice." Every gateway response's disclaimer field carries this exact text; the SDK-fabricated error envelope returned when a request never reaches the gateway (transport/timeout failures) does not populate it.