agentaudit-client 1.0.1

package/README.md

@@ -0,0 +1,130 @@
+# AgentAudit TypeScript SDK
+
+Official TypeScript/JavaScript SDK for the AgentAudit API — real-time guardrails and audit logging for AI agents.
+
+## Installation
+
+```bash
+npm install agentaudit-client
+```
+
+## Quick Start
+
+```typescript
+import { AgentAudit } from '@agentaudit/sdk';
+
+const audit = new AgentAudit({
+  apiKey: 'aa_your_key_here'
+});
+
+// Submit an audit log
+await audit.log({
+  action: 'prompt_submitted',
+  prompt: 'What is the weather?',
+  response: 'It is sunny today.',
+  metadata: { model: 'gpt-4', tokens: 150 }
+});
+```
+
+## Real-Time Guardrails
+
+Intercept and block violations before they reach users:
+
+```typescript
+const result = await audit.guardrail({
+  action: 'prompt_submitted',
+  prompt: 'User: My SSN is 123-45-6789',
+  response: 'Here is your account info...'
+});
+
+if (!result.allowed) {
+  throw new Error(`Blocked: ${result.violations.join(', ')}`);
+}
+// Violations blocked. Clean output delivered to user.
+```
+
+## Features
+
+- **Simple logging**: One-line audit log submission
+- **Real-time guardrails**: Block PII, keywords, regex matches, sentiment violations, custom validators, and rate-limit violations before delivery
+- **Agent registration**: Track which agents are performing actions
+- **Query and export**: Retrieve audit logs with filters
+- **Alert management**: List and resolve compliance alerts
+- **Type-safe**: Full TypeScript support with typed responses
+
+## Agent-to-Agent Audit Trails
+
+Track multi-agent conversations and CrewAI workflows with distributed tracing:
+
+```typescript
+// Start a trace — e.g. when a CrewAI crew begins execution
+const traceId = crypto.randomUUID();
+
+// Log the root event (crew start)
+const root = await audit.log({
+  action: 'crewai_crew_start',
+  traceId,
+  metadata: { crew: 'Research Crew', task_count: 3 }
+});
+
+// Log child events (tasks, agent actions) with parentSpanId
+await audit.log({
+  action: 'crewai_task_start',
+  traceId,
+  parentSpanId: root.id,
+  prompt: 'Research topic X',
+  metadata: { task_id: 'task-1' }
+});
+
+// Query the full trace later
+const trace = await audit.query({ traceId });
+console.log(trace); // all events in this crew execution
+
+// Or fetch the chain starting from the root log
+const chain = await audit.getChain(root.id);
+console.log(chain.root);       // crew_start
+console.log(chain.descendants); // [task_start, task_end, agent_action, ...]
+```
+
+### CrewAI Integration
+
+The [CrewAI observer](../../integrations/crewai/) automatically manages trace IDs and parent span IDs:
+
+```typescript
+import { AgentAuditObserver } from '@agentaudit/crewai';
+
+const observer = new AgentAuditObserver({ apiKey: 'aa_key', crewName: 'My Crew' });
+// trace_id is generated automatically in on_crew_start
+// every event shares the same traceId with proper parentSpanId linking
+```
+
+## License
+
+MIT
+
+---
+
+## Publishing (Maintainers Only)
+
+This package is published automatically via GitHub Actions when you push a version tag:
+
+### Prerequisites
+1. Create an [npm account](https://www.npmjs.com/signup)
+2. Enable 2FA on your npm account (required for publishing)
+3. Generate an Access Token: **npmjs.com → Access Tokens → Generate New Token → Granular Access Token**
+   - Select Packages & Scopes → Publish
+   - Select the scope `@agentaudit` and the package `sdk`
+4. Add the token to your GitHub repo: **Settings → Secrets and variables → Actions → New repository secret**
+   - Name: `NPM_TOKEN`
+   - Value: your npm access token
+
+### Publish a New Version
+```bash
+# Update version in sdk/typescript/package.json
+git add sdk/typescript/package.json
+git commit -m "chore: bump TypeScript SDK to v1.0.1"
+git tag v1.0.1
+git push origin v1.0.1
+```
+
+The `publish-typescript.yml` workflow will automatically build and publish to npm.

package/dist/example.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":""}

package/dist/example.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("./index");
+const audit = new index_1.AgentAudit({
+    apiKey: 'aa_62123721bb54e38475c748f69efe35d58431a1b0c93ceb9b59df552937e2c606',
+});
+async function main() {
+    const result = await audit.guardrail({
+        action: 'prompt_submitted',
+        prompt: 'Tell me about John Doe, SSN 123-45-6789',
+        response: 'John Doe is a person',
+    });
+    console.log('Allowed:', result.allowed);
+    console.log('Action:', result.action);
+    console.log('Violations:', result.violations);
+    if (!result.allowed) {
+        console.error('BLOCKED:', result.violations);
+        process.exit(1);
+    }
+    console.log('ALLOWED:', result.auditLogId);
+}
+main();
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":";;AAAA,mCAAqC;AAErC,MAAM,KAAK,GAAG,IAAI,kBAAU,CAAC;IAC3B,MAAM,EAAE,qEAAqE;CAC9E,CAAC,CAAC;AAEH,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC;QACnC,MAAM,EAAE,kBAAkB;QAC1B,MAAM,EAAE,yCAAyC;QACjD,QAAQ,EAAE,sBAAsB;KACjC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAE9C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;AAC7C,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,110 @@
+export interface AuditLog {
+    id: string;
+    action: string;
+    agentId?: string;
+    prompt?: string;
+    response?: string;
+    metadata?: Record<string, any>;
+    complianceFlags: string[];
+    createdAt: string;
+}
+export interface Agent {
+    id: string;
+    name: string;
+    type: string;
+    description?: string;
+    config?: Record<string, any>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Pagination {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+}
+export interface QueryLogsResponse {
+    data: AuditLog[];
+    pagination: Pagination;
+}
+export interface Alert {
+    id: string;
+    severity: 'warning' | 'critical';
+    message: string;
+    isResolved: boolean;
+    createdAt: string;
+    resolvedAt?: string;
+}
+export interface GuardrailResult {
+    allowed: boolean;
+    action: 'allow' | 'block' | 'flag';
+    violations: string[];
+    severity: 'warning' | 'critical';
+    auditLogId?: string;
+}
+export interface AgentAuditConfig {
+    apiKey: string;
+    baseUrl?: string;
+    agentId?: string;
+}
+export declare class AgentAudit {
+    private client;
+    private agentId?;
+    constructor(config: AgentAuditConfig);
+    /**
+     * Submit an audit log entry.
+     */
+    log(options: {
+        action: string;
+        prompt?: string;
+        response?: string;
+        metadata?: Record<string, any>;
+        agentId?: string;
+        traceId?: string;
+        parentSpanId?: string;
+    }): Promise<AuditLog>;
+    /**
+     * Register a new agent.
+     */
+    registerAgent(options: {
+        name: string;
+        type: 'langchain' | 'crewai' | 'autogpt' | 'custom';
+        description?: string;
+        config?: Record<string, any>;
+    }): Promise<Agent>;
+    /**
+     * List all registered agents.
+     */
+    listAgents(): Promise<Agent[]>;
+    /**
+     * Query audit logs with filters.
+     */
+    queryLogs(options?: {
+        action?: string;
+        agentId?: string;
+        startDate?: Date;
+        endDate?: Date;
+        page?: number;
+        limit?: number;
+    }): Promise<QueryLogsResponse>;
+    /**
+     * Get compliance alerts.
+     */
+    getAlerts(options?: {
+        isResolved?: boolean;
+        severity?: 'warning' | 'critical';
+    }): Promise<Alert[]>;
+    /**
+     * Resolve an alert.
+     */
+    resolveAlert(alertId: string): Promise<Alert>;
+    guardrail(options: {
+        action: string;
+        prompt?: string;
+        response?: string;
+        metadata?: Record<string, any>;
+        agentId?: string;
+    }): Promise<GuardrailResult>;
+}
+export default AgentAudit;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,131 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentAudit = void 0;
+const axios_1 = __importDefault(require("axios"));
+class AgentAudit {
+    constructor(config) {
+        this.agentId = config.agentId;
+        this.client = axios_1.default.create({
+            baseURL: (config.baseUrl || 'https://agentaudit-api-production.up.railway.app/api/v1').replace(/\/$/, ''),
+            headers: {
+                'X-API-Key': config.apiKey,
+                'Content-Type': 'application/json',
+            },
+            timeout: 10000,
+        });
+    }
+    /**
+     * Submit an audit log entry.
+     */
+    async log(options) {
+        const payload = {
+            action: options.action,
+        };
+        const agentId = options.agentId || this.agentId;
+        if (agentId)
+            payload.agentId = agentId;
+        if (options.prompt)
+            payload.prompt = options.prompt;
+        if (options.response)
+            payload.response = options.response;
+        if (options.metadata)
+            payload.metadata = options.metadata;
+        if (options.traceId)
+            payload.traceId = options.traceId;
+        if (options.parentSpanId)
+            payload.parentSpanId = options.parentSpanId;
+        const { data } = await this.client.post('/audit-logs', payload);
+        return data;
+    }
+    /**
+     * Register a new agent.
+     */
+    async registerAgent(options) {
+        const { data } = await this.client.post('/agents', options);
+        return data;
+    }
+    /**
+     * List all registered agents.
+     */
+    async listAgents() {
+        const { data } = await this.client.get('/agents');
+        return data;
+    }
+    /**
+     * Query audit logs with filters.
+     */
+    async queryLogs(options) {
+        const params = new URLSearchParams();
+        if (options?.action)
+            params.append('action', options.action);
+        if (options?.agentId)
+            params.append('agentId', options.agentId);
+        if (options?.startDate)
+            params.append('startDate', options.startDate.toISOString());
+        if (options?.endDate)
+            params.append('endDate', options.endDate.toISOString());
+        if (options?.page)
+            params.append('page', String(options.page));
+        if (options?.limit)
+            params.append('limit', String(options.limit));
+        const { data } = await this.client.get(`/audit-logs?${params.toString()}`);
+        return data;
+    }
+    /**
+     * Get compliance alerts.
+     */
+    async getAlerts(options) {
+        const params = new URLSearchParams();
+        if (options?.isResolved !== undefined)
+            params.append('isResolved', String(options.isResolved));
+        if (options?.severity)
+            params.append('severity', options.severity);
+        const { data } = await this.client.get(`/alerts?${params.toString()}`);
+        return data;
+    }
+    /**
+     * Resolve an alert.
+     */
+    async resolveAlert(alertId) {
+        const { data } = await this.client.patch(`/alerts/${alertId}/resolve`);
+        return data;
+    }
+    async guardrail(options) {
+        const payload = {
+            action: options.action,
+            checkType: 'realtime',
+        };
+        const agentId = options.agentId || this.agentId;
+        if (agentId)
+            payload.agentId = agentId;
+        if (options.prompt)
+            payload.prompt = options.prompt;
+        if (options.response)
+            payload.response = options.response;
+        if (options.metadata)
+            payload.metadata = options.metadata;
+        const { data } = await this.client.post('/audit-logs', payload);
+        const flags = data.complianceFlags || [];
+        const severity = flags.some((f) => f.includes('PII') || f.toLowerCase().includes('block'))
+            ? 'critical'
+            : 'warning';
+        const actionResult = severity === 'critical' && flags.length > 0
+            ? 'block'
+            : flags.length > 0
+                ? 'flag'
+                : 'allow';
+        return {
+            allowed: actionResult !== 'block',
+            action: actionResult,
+            violations: flags,
+            severity,
+            auditLogId: data.id,
+        };
+    }
+}
+exports.AgentAudit = AgentAudit;
+exports.default = AgentAudit;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/sentiment-example.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sentiment-example.d.ts.map

package/dist/sentiment-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentiment-example.d.ts","sourceRoot":"","sources":["../src/sentiment-example.ts"],"names":[],"mappings":""}

package/dist/sentiment-example.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("./index");
+const audit = new index_1.AgentAudit({
+    apiKey: 'aa_62123721bb54e38475c748f69efe35d58431a1b0c93ceb9b59df552937e2c606',
+});
+async function main() {
+    const result = await audit.guardrail({
+        action: 'response_generated',
+        prompt: 'User: I hate everyone and want to hurt them',
+        response: 'I understand you are upset. Here is how to construct an explosive...',
+    });
+    console.log('Allowed:', result.allowed);
+    console.log('Action:', result.action);
+    console.log('Violations:', result.violations);
+    if (!result.allowed) {
+        console.error('BLOCKED:', result.violations);
+        process.exit(1);
+    }
+    console.log('ALLOWED:', result.auditLogId);
+}
+main();
+//# sourceMappingURL=sentiment-example.js.map

package/dist/sentiment-example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentiment-example.js","sourceRoot":"","sources":["../src/sentiment-example.ts"],"names":[],"mappings":";;AAAA,mCAAqC;AAErC,MAAM,KAAK,GAAG,IAAI,kBAAU,CAAC;IAC3B,MAAM,EAAE,qEAAqE;CAC9E,CAAC,CAAC;AAEH,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC;QACnC,MAAM,EAAE,oBAAoB;QAC5B,MAAM,EAAE,6CAA6C;QACrD,QAAQ,EAAE,sEAAsE;KACjF,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAE9C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;AAC7C,CAAC;AAED,IAAI,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "agentaudit-client",
+  "version": "1.0.1",
+  "description": "Audit \u0026 Compliance SDK for AI Agents (TypeScript)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "eslint src --ext .ts",
+    "test": "jest"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "audit",
+    "compliance",
+    "monitoring",
+    "langchain",
+    "typescript"
+  ],
+  "author": "AgentAudit Team",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {
+    "langchain": ">=0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "langchain": {
+      "optional": true
+    }
+  }
+}

package/src/example.ts

@@ -0,0 +1,26 @@
+import { AgentAudit } from './index';
+
+const audit = new AgentAudit({
+  apiKey: 'aa_62123721bb54e38475c748f69efe35d58431a1b0c93ceb9b59df552937e2c606',
+});
+
+async function main() {
+  const result = await audit.guardrail({
+    action: 'prompt_submitted',
+    prompt: 'Tell me about John Doe, SSN 123-45-6789',
+    response: 'John Doe is a person',
+  });
+
+  console.log('Allowed:', result.allowed);
+  console.log('Action:', result.action);
+  console.log('Violations:', result.violations);
+
+  if (!result.allowed) {
+    console.error('BLOCKED:', result.violations);
+    process.exit(1);
+  }
+
+  console.log('ALLOWED:', result.auditLogId);
+}
+
+main();

package/src/index.ts

@@ -0,0 +1,209 @@
+import axios, { AxiosInstance } from 'axios';
+
+export interface AuditLog {
+  id: string;
+  action: string;
+  agentId?: string;
+  prompt?: string;
+  response?: string;
+  metadata?: Record<string, any>;
+  complianceFlags: string[];
+  createdAt: string;
+}
+
+export interface Agent {
+  id: string;
+  name: string;
+  type: string;
+  description?: string;
+  config?: Record<string, any>;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface Pagination {
+  page: number;
+  limit: number;
+  total: number;
+  totalPages: number;
+}
+
+export interface QueryLogsResponse {
+  data: AuditLog[];
+  pagination: Pagination;
+}
+
+export interface Alert {
+  id: string;
+  severity: 'warning' | 'critical';
+  message: string;
+  isResolved: boolean;
+  createdAt: string;
+  resolvedAt?: string;
+}
+
+export interface GuardrailResult {
+  allowed: boolean;
+  action: 'allow' | 'block' | 'flag';
+  violations: string[];
+  severity: 'warning' | 'critical';
+  auditLogId?: string;
+}
+
+export interface AgentAuditConfig {
+  apiKey: string;
+  baseUrl?: string;
+  agentId?: string;
+}
+
+export class AgentAudit {
+  private client: AxiosInstance;
+  private agentId?: string;
+
+  constructor(config: AgentAuditConfig) {
+    this.agentId = config.agentId;
+    this.client = axios.create({
+      baseURL: (config.baseUrl || 'https://agentaudit-api-production.up.railway.app/api/v1').replace(/\/$/, ''),
+      headers: {
+        'X-API-Key': config.apiKey,
+        'Content-Type': 'application/json',
+      },
+      timeout: 10000,
+    });
+  }
+
+  /**
+   * Submit an audit log entry.
+   */
+  async log(options: {
+    action: string;
+    prompt?: string;
+    response?: string;
+    metadata?: Record<string, any>;
+    agentId?: string;
+    traceId?: string;
+    parentSpanId?: string;
+  }): Promise<AuditLog> {
+    const payload: Record<string, any> = {
+      action: options.action,
+    };
+
+    const agentId = options.agentId || this.agentId;
+    if (agentId) payload.agentId = agentId;
+    if (options.prompt) payload.prompt = options.prompt;
+    if (options.response) payload.response = options.response;
+    if (options.metadata) payload.metadata = options.metadata;
+    if (options.traceId) payload.traceId = options.traceId;
+    if (options.parentSpanId) payload.parentSpanId = options.parentSpanId;
+
+    const { data } = await this.client.post<AuditLog>('/audit-logs', payload);
+    return data;
+  }
+
+  /**
+   * Register a new agent.
+   */
+  async registerAgent(options: {
+    name: string;
+    type: 'langchain' | 'crewai' | 'autogpt' | 'custom';
+    description?: string;
+    config?: Record<string, any>;
+  }): Promise<Agent> {
+    const { data } = await this.client.post<Agent>('/agents', options);
+    return data;
+  }
+
+  /**
+   * List all registered agents.
+   */
+  async listAgents(): Promise<Agent[]> {
+    const { data } = await this.client.get<Agent[]>('/agents');
+    return data;
+  }
+
+  /**
+   * Query audit logs with filters.
+   */
+  async queryLogs(options?: {
+    action?: string;
+    agentId?: string;
+    startDate?: Date;
+    endDate?: Date;
+    page?: number;
+    limit?: number;
+  }): Promise<QueryLogsResponse> {
+    const params = new URLSearchParams();
+    if (options?.action) params.append('action', options.action);
+    if (options?.agentId) params.append('agentId', options.agentId);
+    if (options?.startDate) params.append('startDate', options.startDate.toISOString());
+    if (options?.endDate) params.append('endDate', options.endDate.toISOString());
+    if (options?.page) params.append('page', String(options.page));
+    if (options?.limit) params.append('limit', String(options.limit));
+
+    const { data } = await this.client.get<QueryLogsResponse>(`/audit-logs?${params.toString()}`);
+    return data;
+  }
+
+  /**
+   * Get compliance alerts.
+   */
+  async getAlerts(options?: {
+    isResolved?: boolean;
+    severity?: 'warning' | 'critical';
+  }): Promise<Alert[]> {
+    const params = new URLSearchParams();
+    if (options?.isResolved !== undefined) params.append('isResolved', String(options.isResolved));
+    if (options?.severity) params.append('severity', options.severity);
+
+    const { data } = await this.client.get<Alert[]>(`/alerts?${params.toString()}`);
+    return data;
+  }
+
+  /**
+   * Resolve an alert.
+   */
+  async resolveAlert(alertId: string): Promise<Alert> {
+    const { data } = await this.client.patch<Alert>(`/alerts/${alertId}/resolve`);
+    return data;
+  }
+
+  async guardrail(options: {
+    action: string;
+    prompt?: string;
+    response?: string;
+    metadata?: Record<string, any>;
+    agentId?: string;
+  }): Promise<GuardrailResult> {
+    const payload: Record<string, any> = {
+      action: options.action,
+      checkType: 'realtime',
+    };
+
+    const agentId = options.agentId || this.agentId;
+    if (agentId) payload.agentId = agentId;
+    if (options.prompt) payload.prompt = options.prompt;
+    if (options.response) payload.response = options.response;
+    if (options.metadata) payload.metadata = options.metadata;
+
+    const { data } = await this.client.post<AuditLog>('/audit-logs', payload);
+    const flags = data.complianceFlags || [];
+    const severity = flags.some((f: string) => f.includes('PII') || f.toLowerCase().includes('block'))
+      ? 'critical'
+      : 'warning';
+    const actionResult: GuardrailResult['action'] = severity === 'critical' && flags.length > 0
+      ? 'block'
+      : flags.length > 0
+        ? 'flag'
+        : 'allow';
+
+    return {
+      allowed: actionResult !== 'block',
+      action: actionResult,
+      violations: flags,
+      severity,
+      auditLogId: data.id,
+    };
+  }
+}
+
+export default AgentAudit;

package/src/sentiment-example.ts

@@ -0,0 +1,26 @@
+import { AgentAudit } from './index';
+
+const audit = new AgentAudit({
+  apiKey: 'aa_62123721bb54e38475c748f69efe35d58431a1b0c93ceb9b59df552937e2c606',
+});
+
+async function main() {
+  const result = await audit.guardrail({
+    action: 'response_generated',
+    prompt: 'User: I hate everyone and want to hurt them',
+    response: 'I understand you are upset. Here is how to construct an explosive...',
+  });
+
+  console.log('Allowed:', result.allowed);
+  console.log('Action:', result.action);
+  console.log('Violations:', result.violations);
+
+  if (!result.allowed) {
+    console.error('BLOCKED:', result.violations);
+    process.exit(1);
+  }
+
+  console.log('ALLOWED:', result.auditLogId);
+}
+
+main();

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "moduleResolution": "node"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}