@rubric-protocol/sdk 1.0.1 → 1.0.2

package/README.md

@@ -0,0 +1,218 @@
+# @rubric-protocol/sdk
+
+Post-quantum AI attestation for Node.js. Every AI decision your system makes — signed locally in microseconds, anchored to Hedera's public ledger in the background.
+
+Built for [EU AI Act Article 12](https://rubric-protocol.com) compliance and beyond.
+
+---
+
+## How it works
+
+The SDK signs AI decisions locally using ML-DSA-65 (NIST FIPS 204, post-quantum) before any network call is made. Attestations are queued and flushed to Rubric's global federation in the background. Your AI pipeline sees zero added latency.
+
+```
+AI decision ‒ local sign (<1ms) → proof returned immediately
+                                 ↓ background
+                          Rubric anchor (5-10s) → HCS confirmed (~30s)
+```
+
+Each proof upgrades automatically as anchoring completes. You can fire-and-forget, or await full HCS confirmation for high-stakes decisions.
+
+---
+
+## Install
+
+```bash
+npm install @rubric-protocol/sdk
+```
+
+Peer dependencies (install only what you use):
+
+```bash
+npm install openai              # for OpenAI plugin
+npm install @langchain/core     # for LangChain plugin
+```
+
+---
+
+## Quickstart
+
+```typescript
+import { createRubricClient } from '@rubric-protocol/sdk';
+
+const rubric = createRubricClient({
+  apiKey: process.env.RUBRIC_API_KEY!,
+  localSigning: true,       // sign locally before network
+  backgroundQueue: true,    // non-blocking flush
+  node: 'auto',             // route to nearest healthy node
+});
+
+const proof = await rubric.attest({
+  agentId: 'my-agent-v1',
+  output: 'Loan application approved. Score: 742, DTI: 28%.',
+  leafType: 'AGENT_OUTPUT',
+  metadata: { model: 'gpt-4o', pipeline: 'credit-decisioning' },
+});
+
+console.log(proof.attestationId);  // immediate
+console.log(proof.stage);          // 'local'
+
+// Optional: wait for full HCS confirmation
+proof.onUpgrade('confirmed', (confirmed) => {
+  console.log(confirmed.hashScanUrl); // publicly verifiable on HashScan
+});
+```
+
+---
+
+## LangChain
+
+Add one handler and every LLM call, agent action, chain, and tool invocation is automatically attested.
+
+```typescript
+import { ChatOpenAI } from '@langchain/openai';
+import { AgentExecutor } from 'langchain/agents';
+import { RubricLangChainHandler } from '@rubric-protocol/sdk';
+
+const rubric = new RubricLangChainHandler({
+  apiKey: process.env.RUBRIC_API_KEY!,
+  localSigning: true,
+  backgroundQueue: true,
+  events: ['llm', 'agent', 'tool'],  // choose what to attest
+  pipelineId: 'my-pipeline',
+});
+
+const executor = await AgentExecutor.fromAgentAndTools({
+  agent,
+  tools,
+  callbacks: [rubric],  // that's it
+});
+
+await executor.invoke({ input: 'Analyze this transaction for fraud.' });
+await rubric.shutdown(); // flush remaining queue on exit
+```
+
+---
+
+## OpenAI
+
+Drop-in wrapper — your existing code is unchanged.
+
+```typescript
+import OpenAI from 'openai';
+import { withRubric } from '@rubric-protocol/sdk';
+
+const openai = withRubric(new OpenAI(), {
+  apiKey: process.env.RUBRIC_API_KEY!,
+  agentId: 'my-openai-agent',
+  localSigning: true,
+  backgroundQueue: true,
+});
+
+// Use exactly as before — attestation happens automatically
+const completion = await openai.chat.completions.create({
+  model: 'gpt-4o',
+  messages: [{ role: 'user', content: 'Should we approve this claim?' }],
+});
+```
+
+---
+
+## High-stakes decisions
+
+For decisions requiring immediate confirmation (medical triage, credit denial, hiring rejection), await full HCS anchoring:
+
+```typescript
+const confirmed = await rubric.attestAndConfirm({
+  agentId: 'triage-agent',
+  output: 'Patient flagged for immediate review.',
+  leafType: 'AGENT_OUTPUT',
+  risk: 'high',
+}, 90_000); // timeout ms
+
+console.log(confirmed.hcsSequenceNumber);
+console.log(confirmed.hashScanUrl); // immutable public record
+```
+
+---
+
+## Proof lifecycle
+
+Every attestation returns a `LiveProof` that upgrades automatically:
+
+| Stage | When | What you have |
+|---|---|---|
+| `local` | <1ms | ML-DSA-65 signature + timestamp |
+| `anchored` | 5–10s | Merkle root committed to Rubric |
+| `confirmed` | ~30s | HCS sequence number, HashScan URL |
+
+```typescript
+proof.onUpgrade('anchored', (p) => console.log(p.merkleRoot));
+proof.onUpgrade('confirmed', (p) => console.log(p.hashScanUrl));
+proof.onUpgrade('any', (p) => console.log(p.stage)); // fires on each upgrade
+```
+
+---
+
+## Configuration
+
+```typescript
+createRubricClient({
+  apiKey: string,               // required — get one at rubric-protocol.com
+  node?: 'us'|'sg'|'jp'|'ca'|'eu'|'auto',  // default: 'us'
+  localSigning?: boolean,       // default: false
+  keystorePath?: string,        // default: ~/.rubric/sdk-keypair.json
+  keystorePassphrase?: string,  // AES-256-GCM encrypts the keystore
+  backgroundQueue?: boolean,    // default: false
+  enterprise?: boolean,         // uses /v1/tiered-attest (Merkle batching)
+  proofUpgrade?: boolean,       // auto-poll for stage upgrades
+  timeout?: number,             // HTTP timeout ms, default: 15000
+})
+```
+
+---
+
+## Nodes
+
+The SDK routes to Rubric's global federation automatically when `node: 'auto'`.
+
+| Region | Endpoint |
+|---|---|
+| US East | `https://rubric-protocol.com/verify` |
+| Singapore | `https://sg.rubric-protocol.com/verify` |
+| Japan | `https://jp.rubric-protocol.com/verify` |
+| Canada | `https://ca.rubric-protocol.com/verify` |
+| EU Central | `https://eu.rubric-protocol.com/verify` |
+
+---
+
+## Security
+
+- **ML-DSA-65** (NIST FIPS 204) — post-quantum signature scheme, same algorithm used server-side
+- Keypairs stored at `~/.rubric/sdk-keypair.json` with optional AES-256-GCM encryption via passphrase
+- Canonical JSON serialization ensures deterministic, tamper-evident signing
+- All attestations anchored to [Hedera Consensus Service](https://hedera.com) — public, immutable, independently verifiable
+
+---
+
+## Requirements
+
+- Node.js >= 18.0.0
+- TypeScript >= 5.0 (if using TypeScript)
+
+---
+
+## Links
+
+- [Documentation](https://rubric-protocol.com)
+- [API Reference](https://rubric-protocol.com/docs)
+- [HashScan](https://hashscan.io/testnet/topic/0.0.8207826) — live attestation stream
+- [EU AI Act Article 12](https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32024R1689)
+
+---
+
+## License
+
+MIT — Echelon Intelligence Systems LLC
+
+*Patent Pending*

package/dist/background-queue.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Rubric Protocol — Background Attestation Queue
+ * Buffers attestation calls, submits in batches, retries on failure.
+ * Survives process restart via optional JSON persistence.
+ */
+export interface QueueItem {
+    id: string;
+    endpoint: string;
+    payload: Record<string, unknown>;
+    headers: Record<string, string>;
+    attempts: number;
+    maxAttempts: number;
+    nextRetryAt: number;
+    enqueuedAt: number;
+    failedPermanently?: boolean;
+    lastError?: string;
+}
+export interface QueueConfig {
+    flushInterval?: number;
+    batchSize?: number;
+    maxAttempts?: number;
+    backoffBase?: number;
+    persistPath?: string;
+    onDeadLetter?: (item: QueueItem) => void;
+    onSuccess?: (item: QueueItem, response: unknown) => void;
+    onError?: (item: QueueItem, error: Error) => void;
+}
+export type QueueStats = {
+    queued: number;
+    inflight: number;
+    deadLetters: number;
+    totalSubmitted: number;
+    totalFailed: number;
+};
+export declare class BackgroundQueue {
+    private queue;
+    private deadLetters;
+    private inflight;
+    private timer;
+    private totalSubmitted;
+    private totalFailed;
+    private readonly config;
+    constructor(config?: QueueConfig);
+    enqueue(endpoint: string, payload: Record<string, unknown>, headers: Record<string, string>, options?: {
+        maxAttempts?: number;
+    }): string;
+    start(): void;
+    stop(): Promise<void>;
+    stats(): QueueStats;
+    flush(): Promise<void>;
+    private _flush;
+    private _submit;
+    private _persist;
+    private _loadFromDisk;
+}
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=background-queue.d.ts.map

package/dist/background-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-queue.d.ts","sourceRoot":"","sources":["../background-queue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACzC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACzD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACnD;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAM;gBAEjB,MAAM,GAAE,WAAgB;IAapC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,MAAM;IAO5I,KAAK,IAAI,IAAI;IAOP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,KAAK,IAAI,UAAU;IAIb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAEd,MAAM;YAMN,OAAO;IA0BrB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,aAAa;CAUtB;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/background-queue.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * Rubric Protocol — Background Attestation Queue
+ * Buffers attestation calls, submits in batches, retries on failure.
+ * Survives process restart via optional JSON persistence.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackgroundQueue = void 0;
+exports.sleep = sleep;
+const fs = __importStar(require("fs"));
+const crypto = __importStar(require("crypto"));
+class BackgroundQueue {
+    constructor(config = {}) {
+        this.queue = new Map();
+        this.deadLetters = [];
+        this.inflight = new Set();
+        this.timer = null;
+        this.totalSubmitted = 0;
+        this.totalFailed = 0;
+        this.config = {
+            flushInterval: config.flushInterval ?? 2000,
+            batchSize: config.batchSize ?? 50,
+            maxAttempts: config.maxAttempts ?? 5,
+            backoffBase: config.backoffBase ?? 1000,
+            persistPath: config.persistPath,
+            onDeadLetter: config.onDeadLetter,
+            onSuccess: config.onSuccess,
+            onError: config.onError,
+        };
+        if (this.config.persistPath)
+            this._loadFromDisk();
+    }
+    enqueue(endpoint, payload, headers, options = {}) {
+        const id = crypto.randomUUID();
+        this.queue.set(id, { id, endpoint, payload, headers, attempts: 0, maxAttempts: options.maxAttempts ?? this.config.maxAttempts, nextRetryAt: Date.now(), enqueuedAt: Date.now() });
+        this._persist();
+        return id;
+    }
+    start() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => this._flush(), this.config.flushInterval);
+        if (typeof this.timer === 'object' && 'unref' in this.timer)
+            this.timer.unref();
+        this._flush();
+    }
+    async stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        const deadline = Date.now() + 10000;
+        while (this.inflight.size > 0 && Date.now() < deadline)
+            await new Promise(r0 => setTimeout(r0, 100));
+        this._persist();
+    }
+    stats() {
+        return { queued: this.queue.size, inflight: this.inflight.size, deadLetters: this.deadLetters.length, totalSubmitted: this.totalSubmitted, totalFailed: this.totalFailed };
+    }
+    async flush() { await this._flush(); }
+    async _flush() {
+        const now = Date.now();
+        const eligible = [...this.queue.values()].filter(i => !this.inflight.has(i.id) && i.nextRetryAt <= now).slice(0, this.config.batchSize);
+        if (eligible.length === 0)
+            return;
+        await Promise.allSettled(eligible.map(i => this._submit(i)));
+    }
+    async _submit(item) {
+        this.inflight.add(item.id);
+        item.attempts++;
+        try {
+            const res = await fetch(item.endpoint, { method: 'POST', headers: { 'Content-Type': 'application/json', ...item.headers }, body: JSON.stringify(item.payload), signal: AbortSignal.timeout(15000) });
+            if (!res.ok) {
+                const b = await res.text().catch(() => '');
+                throw new Error(`HTTP ${res.status}: ${b.slice(0, 200)}`);
+            }
+            const response = await res.json().catch(() => null);
+            this.queue.delete(item.id);
+            this.inflight.delete(item.id);
+            this.totalSubmitted++;
+            this.config.onSuccess?.(item, response);
+            this._persist();
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            item.lastError = error.message;
+            this.inflight.delete(item.id);
+            this.config.onError?.(item, error);
+            if (item.attempts >= item.maxAttempts) {
+                item.failedPermanently = true;
+                this.queue.delete(item.id);
+                this.deadLetters.push(item);
+                this.totalFailed++;
+                this.config.onDeadLetter?.(item);
+            }
+            else {
+                const baseDelay = this.config.backoffBase * Math.pow(2, item.attempts - 1);
+                const jitter = baseDelay * 0.1 * (Math.random() * 2 - 1);
+                item.nextRetryAt = Date.now() + Math.round(baseDelay + jitter);
+            }
+            this._persist();
+        }
+    }
+    _persist() {
+        if (!this.config.persistPath)
+            return;
+        try {
+            fs.writeFileSync(this.config.persistPath, JSON.stringify({ version: 1, savedAt: new Date().toISOString(), queue: [...this.queue.values()], deadLetters: this.deadLetters }), { encoding: 'utf8' });
+        }
+        catch { /* non-fatal */ }
+    }
+    _loadFromDisk() {
+        if (!this.config.persistPath || !fs.existsSync(this.config.persistPath))
+            return;
+        try {
+            const data = JSON.parse(fs.readFileSync(this.config.persistPath, 'utf8'));
+            if (data.version !== 1)
+                return;
+            for (const item of (data.queue ?? []))
+                this.queue.set(item.id, item);
+            this.deadLetters = data.deadLetters ?? [];
+            console.log(`[RubricQueue] Restored ${this.queue.size} items from disk`);
+        }
+        catch { /* corrupt file - start fresh */ }
+    }
+}
+exports.BackgroundQueue = BackgroundQueue;
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=background-queue.js.map

package/dist/background-queue.js.map

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

package/dist/index.d.ts

@@ -1,126 +1,15 @@
-/**
- * RUBRIC PROTOCOL SDK
- * AI Attestation Infrastructure — EU AI Act Article 12 Compliance
- * Rubric Protocol
- */
-export interface RubricConfig {
-    baseUrl: string;
-    apiKey: string;
-}
-export interface Agent {
-    agentId: string;
-    name: string;
-    capabilities: {
-        name: string;
-        description: string;
-    }[];
-    endpoint: string;
-    status: string;
-    reputation: {
-        tasksCompleted: number;
-        successRate: number;
-        score?: number;
-    };
-}
-export interface Task {
-    taskId: string;
-    type: string;
-    description: string;
-    status: string;
-    bids: Bid[];
-    assignment: any;
-    result: TaskResult | null;
-}
-export interface Bid {
-    bidId: string;
-    agentId: string;
-    cost: number;
-    estimatedTime: number;
-    confidence: number;
-}
-export interface TaskResult {
-    agentId: string;
-    output: any;
-    executionTime: number;
-    completedAt: string;
-    attestationId: string;
-}
-export interface Pipeline {
-    pipelineId: string;
-    name: string;
-    status: string;
-    steps: PipelineStep[];
-    attestations: string[];
-    completedAt?: string;
-}
-export interface PipelineStep {
-    stepIndex: number;
-    type: string;
-    description: string;
-    status: string;
-    attestationId?: string;
-    output?: any;
-}
-export interface Proof {
-    sequenceNumber: string;
-    topic: string;
-    explorer: string;
-    task: any;
-    pipeline: any;
-    verified: boolean;
-    network: string;
-}
-export declare class RubricClient {
-    private baseUrl;
-    private apiKey;
-    constructor(config: RubricConfig);
-    private request;
-    health(): Promise<any>;
-    stats(): Promise<any>;
-    registerAgent(name: string, capabilities: {
-        name: string;
-        description: string;
-    }[], endpoint: string): Promise<Agent>;
-    listAgents(capability?: string): Promise<{
-        data: Agent[];
-        total: number;
-    }>;
-    getAgent(agentId: string): Promise<Agent>;
-    deregisterAgent(agentId: string): Promise<any>;
-    getReputation(agentId: string): Promise<any>;
-    leaderboard(): Promise<any>;
-    submitTask(type: string, description: string, input?: any): Promise<Task>;
-    listTasks(): Promise<{
-        data: Task[];
-        total: number;
-    }>;
-    getTask(taskId: string): Promise<Task>;
-    placeBid(taskId: string, agentId: string, cost: number, estimatedTime: number, confidence: number): Promise<Bid>;
-    assignTask(taskId: string): Promise<any>;
-    submitResult(taskId: string, agentId: string, output: any, executionTime: number): Promise<TaskResult>;
-    createPipeline(name: string, steps: {
-        type: string;
-        capability: string;
-        description: string;
-    }[]): Promise<Pipeline>;
-    listPipelines(): Promise<{
-        data: Pipeline[];
-        total: number;
-    }>;
-    getPipeline(pipelineId: string): Promise<Pipeline>;
-    startPipeline(pipelineId: string, input?: any): Promise<any>;
-    completeStep(pipelineId: string, agentId: string, output: any, executionTime: number): Promise<any>;
-    verify(sequenceNumber: string): Promise<Proof>;
-    events(limit?: number, type?: string): Promise<any>;
-    runTask(agentId: string, type: string, description: string, output: any, executionTime?: number): Promise<TaskResult>;
-    runPipeline(name: string, steps: {
-        type: string;
-        capability: string;
-        description: string;
-        output: any;
-    }[], input?: any): Promise<{
-        pipeline: Pipeline;
-        attestations: string[];
-    }>;
-}
-export default RubricClient;
+export { RubricClient, createRubricClient } from './rubric-client';
+export type { RubricClientConfig, AttestationRequest } from './rubric-client';
+export { LiveProof, STAGE_METADATA } from './proof-types';
+export type { ProofStage, LocalProofData, AnchoredProofData, ConfirmedProofData, AnyProofData, UpgradeCallback } from './proof-types';
+export { ProofUpgradeManager, getUpgradeManager, resetUpgradeManager } from './proof-upgrade-manager';
+export type { UpgradeManagerConfig } from './proof-upgrade-manager';
+export { generateKeyPair, signPayload, verifySignedPayload, loadOrCreateKeyPair, saveKeyPair, loadKeyPair } from './ml-dsa-local';
+export type { LocalKeyPair, SignedPayload } from './ml-dsa-local';
+export { BackgroundQueue } from './background-queue';
+export type { QueueItem, QueueConfig, QueueStats } from './background-queue';
+export { RubricLangChainHandler } from './plugins/langchain';
+export type { RubricLangChainConfig } from './plugins/langchain';
+export { withRubric, RubricOpenAIClient } from './plugins/openai-plugin';
+export type { RubricOpenAIConfig } from './plugins/openai-plugin';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC1D,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACtI,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACtG,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClI,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACzE,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}