> ## Documentation Index
> Fetch the complete documentation index at: https://docs.complior.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# SDK Overview

> @complior/sdk — runtime compliance wrapper for LLM clients. 14 hooks, 4 providers, zero config.

`@complior/sdk` is an npm library that wraps LLM clients with a compliance pipeline. Every API call passes through: **pre-hooks → LLM call → post-hooks**. All checks are deterministic (regex + rules).

```bash theme={null}
npm install @complior/sdk
```

## Quick start

```typescript theme={null}
import { complior } from '@complior/sdk';
import OpenAI from 'openai';

const client = complior(new OpenAI(), {
  hooks: ['prohibited', 'sanitize', 'disclosure', 'bias'],
});

// Use as normal — hooks work transparently
const response = await client.chat.completions.create({
  model: 'gpt-4',
  messages: [{ role: 'user', content: userInput }],
});
```

## Two modes

| Mode      | Function                              | Features                                                                           |
| --------- | ------------------------------------- | ---------------------------------------------------------------------------------- |
| **Basic** | `complior(client, config)`            | Core hooks: prohibited, sanitize, disclosure, bias, escalation                     |
| **Agent** | `compliorAgent(client, { passport })` | All core hooks + passport enforcement: permissions, rate-limit, budget, action-log |

## Agent mode (passport enforcement)

```typescript theme={null}
import { compliorAgent } from '@complior/sdk';

const passport = JSON.parse(
  fs.readFileSync('.complior/agents/order-processor-manifest.json')
);

const agent = compliorAgent(new OpenAI(), { passport });
// Passport constraints auto-enforced:
// - permissions.tools → allowlist/denylist
// - constraints.rate_limits → sliding window
// - constraints.budget → cost cap per session
```

<CardGroup cols={2}>
  <Card title="All Hooks" icon="list-check" href="/sdk/hooks">
    6 pre-hooks + 8 post-hooks in detail.
  </Card>

  <Card title="Providers" icon="plug" href="/sdk/providers">
    OpenAI, Anthropic, Google, Vercel AI.
  </Card>
</CardGroup>
