@claiv/memory 0.1.0

package/README.md

@@ -0,0 +1,178 @@
+# @claiv/memory
+
+Official JavaScript/TypeScript SDK for the Claiv Memory API.
+
+## Installation
+
+```bash
+npm install @claiv/memory
+```
+
+## Quick Start
+
+```typescript
+import { ClaivClient } from '@claiv/memory';
+
+const client = new ClaivClient({
+  apiKey: 'your-api-key',
+});
+
+// Store a memory
+const { event_id } = await client.ingest({
+  user_id: 'user-123',
+  type: 'message',
+  content: 'User prefers dark mode and uses VS Code',
+});
+
+// Recall relevant memory
+const { memory_blocks, citations, token_estimate } = await client.recall({
+  user_id: 'user-123',
+  task: 'Help the user configure their editor',
+  token_budget: 2000,
+});
+
+// Forget memory for a user
+const { receipt_id, deleted_counts } = await client.forget({
+  user_id: 'user-123',
+});
+```
+
+## API Reference
+
+### `new ClaivClient(options)`
+
+| Option       | Type       | Default                  | Description                        |
+|--------------|------------|--------------------------|------------------------------------|
+| `apiKey`     | `string`   | *required*               | API key (sent as Bearer token)     |
+| `baseUrl`    | `string`   | `https://api.claiv.com`  | API base URL                       |
+| `timeout`    | `number`   | `30000`                  | Request timeout in milliseconds    |
+| `maxRetries` | `number`   | `2`                      | Retries on 429/5xx (0 to disable)  |
+| `fetch`      | `function` | `globalThis.fetch`       | Custom fetch implementation        |
+
+### Core Methods
+
+#### `client.ingest(request): Promise<IngestResponse>`
+
+Store a memory event.
+
+```typescript
+const result = await client.ingest({
+  user_id: 'user-123',         // required
+  type: 'message',             // required: 'message' | 'tool_call' | 'app_event'
+  content: 'The actual text',  // required
+  thread_id: 'thread-456',     // optional: scope to a conversation
+  metadata: { source: 'chat' },// optional: arbitrary metadata
+  event_time: '2025-01-01T00:00:00Z', // optional: ISO 8601
+  idempotency_key: 'unique-1', // optional: prevents duplicate ingestion
+});
+// result: { event_id: string, deduped: boolean }
+```
+
+#### `client.recall(request): Promise<RecallResponse>`
+
+Retrieve relevant memory for a task.
+
+```typescript
+const result = await client.recall({
+  user_id: 'user-123',                    // required
+  task: 'Help configure their editor',    // required: what the AI is doing
+  token_budget: 2000,                     // required: 200–8000
+  thread_id: 'thread-456',               // optional
+  scope: { project: 'claiv' },           // optional
+});
+// result: {
+//   system_context: string,
+//   memory_blocks: Array<{ type, content, source_ids, score }>,
+//   citations: string[],
+//   token_estimate: number,
+// }
+```
+
+Memory block types: `open_loop`, `fact`, `claim`, `episode`, `chunk`.
+
+#### `client.forget(request): Promise<ForgetResponse>`
+
+Delete memory matching a scope.
+
+```typescript
+const result = await client.forget({
+  user_id: 'user-123',                     // required
+  thread_id: 'thread-456',                 // optional
+  from_time: '2025-01-01T00:00:00Z',       // optional
+  to_time: '2025-06-01T00:00:00Z',         // optional
+});
+// result: {
+//   receipt_id: string,
+//   deleted_counts: { events, chunks, episodes, facts, claims, open_loops },
+// }
+```
+
+### Usage Methods
+
+```typescript
+// Aggregated summary with daily breakdown
+const summary = await client.getUsageSummary('30d'); // '7d' | '30d' | 'month' | 'today'
+
+// Breakdown by endpoint
+const breakdown = await client.getUsageBreakdown('today');
+
+// Current plan limits and quota
+const limits = await client.getUsageLimits();
+```
+
+### Health Check
+
+```typescript
+const { ok } = await client.healthCheck(); // no auth required
+```
+
+## Error Handling
+
+All errors extend `ClaivError`.
+
+```typescript
+import { ClaivApiError, ClaivTimeoutError, ClaivNetworkError } from '@claiv/memory';
+
+try {
+  await client.ingest({ ... });
+} catch (err) {
+  if (err instanceof ClaivApiError) {
+    console.log(err.status);    // HTTP status code
+    console.log(err.code);      // 'invalid_request' | 'unauthorized' | 'quota_exceeded' | ...
+    console.log(err.requestId); // server request ID for support
+    console.log(err.details);   // validation errors, quota info, etc.
+  } else if (err instanceof ClaivTimeoutError) {
+    // request timed out
+  } else if (err instanceof ClaivNetworkError) {
+    // DNS failure, connection refused, etc.
+  }
+}
+```
+
+## Retries
+
+The SDK automatically retries on 429 (rate limited) and 5xx (server error) responses with exponential backoff and jitter. Client errors (400, 401, 403, 404) are never retried.
+
+```typescript
+// Default: 2 retries (3 total attempts)
+const client = new ClaivClient({ apiKey: 'key' });
+
+// Disable retries
+const client = new ClaivClient({ apiKey: 'key', maxRetries: 0 });
+
+// More retries for critical paths
+const client = new ClaivClient({ apiKey: 'key', maxRetries: 5 });
+```
+
+## TypeScript
+
+All request/response types are exported:
+
+```typescript
+import type {
+  IngestRequest, IngestResponse,
+  RecallRequest, RecallResponse, ContextPack, MemoryBlock,
+  ForgetRequest, ForgetResponse, DeletedCounts,
+  UsageSummaryResponse, UsageBreakdownResponse, UsageLimitsResponse,
+} from '@claiv/memory';
+```

package/dist/client.d.ts

@@ -0,0 +1,67 @@
+import type { ClaivClientOptions, IngestRequest, IngestResponse, RecallRequest, RecallResponse, ForgetRequest, ForgetResponse, DeletionReceipt, ListDeletionReceiptsResponse, UsageRange, UsageSummaryResponse, UsageBreakdownResponse, UsageLimitsResponse } from './types.js';
+export declare class ClaivClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly timeoutMs;
+    private readonly maxRetries;
+    private readonly _fetch;
+    constructor(options: ClaivClientOptions);
+    /**
+     * Ingest a memory event.
+     *
+     * Stores context your AI should remember — user messages, tool calls, or
+     * application events. Returns immediately; enrichment happens asynchronously.
+     */
+    ingest(request: IngestRequest): Promise<IngestResponse>;
+    /**
+     * Recall relevant memory for a task.
+     *
+     * Returns ranked memory blocks that fit within the specified token budget,
+     * along with citations linking each block to its source event.
+     */
+    recall(request: RecallRequest): Promise<RecallResponse>;
+    /**
+     * Forget (delete) memory matching the given scope.
+     *
+     * Deletes all memory for the specified user, optionally scoped to a thread
+     * and/or time range. Returns a receipt with deletion counts.
+     */
+    forget(request: ForgetRequest): Promise<ForgetResponse>;
+    /**
+     * Get aggregated usage summary with daily breakdown.
+     */
+    getUsageSummary(range?: UsageRange): Promise<UsageSummaryResponse>;
+    /**
+     * Get usage breakdown by endpoint.
+     */
+    getUsageBreakdown(range?: UsageRange): Promise<UsageBreakdownResponse>;
+    /**
+     * Get current plan limits and quota status.
+     */
+    getUsageLimits(): Promise<UsageLimitsResponse>;
+    /**
+     * List deletion receipts, newest first.
+     * Supports filtering by user_id and pagination via limit/offset.
+     */
+    listDeletionReceipts(options?: {
+        user_id?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<ListDeletionReceiptsResponse>;
+    /**
+     * Get a single deletion receipt by ID.
+     */
+    getDeletionReceipt(receiptId: string): Promise<DeletionReceipt>;
+    /**
+     * Check if the API is reachable and healthy.
+     * Does not require authentication.
+     */
+    healthCheck(): Promise<{
+        ok: boolean;
+    }>;
+    private post;
+    private get;
+    private request;
+    private getBackoffMs;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,eAAe,EACf,4BAA4B,EAC5B,UAAU,EACV,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAepB,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;gBAErC,OAAO,EAAE,kBAAkB;IAiCvC;;;;;OAKG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAI7D;;;;;OAKG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAI7D;;;;;OAKG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAQ7D;;OAEG;IACG,eAAe,CAAC,KAAK,GAAE,UAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAI9E;;OAEG;IACG,iBAAiB,CAAC,KAAK,GAAE,UAAiB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAIlF;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAQpD;;;OAGG;IACG,oBAAoB,CAAC,OAAO,CAAC,EAAE;QACnC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAQzC;;OAEG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAQrE;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC;YAQ/B,IAAI;YAIJ,GAAG;YASH,OAAO;IA2ErB,OAAO,CAAC,YAAY;CAgBrB"}

package/dist/client.js

@@ -0,0 +1,221 @@
+import { ClaivApiError, ClaivTimeoutError, ClaivNetworkError } from './errors.js';
+const DEFAULT_BASE_URL = 'https://api.claiv.com';
+const DEFAULT_TIMEOUT_MS = 30_000;
+const DEFAULT_MAX_RETRIES = 2;
+const INITIAL_BACKOFF_MS = 500;
+const MAX_BACKOFF_MS = 30_000;
+const RETRYABLE_STATUS_CODES = new Set([429, 500, 502, 503, 504]);
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export class ClaivClient {
+    baseUrl;
+    apiKey;
+    timeoutMs;
+    maxRetries;
+    _fetch;
+    constructor(options) {
+        if (!options.apiKey) {
+            throw new Error('apiKey is required');
+        }
+        if (options.timeout !== undefined && (!Number.isFinite(options.timeout) || options.timeout <= 0)) {
+            throw new Error('timeout must be a positive number');
+        }
+        if (options.maxRetries !== undefined &&
+            (!Number.isInteger(options.maxRetries) || options.maxRetries < 0)) {
+            throw new Error('maxRetries must be a non-negative integer');
+        }
+        if (options.fetch !== undefined && typeof options.fetch !== 'function') {
+            throw new Error('fetch must be a function');
+        }
+        this.apiKey = options.apiKey;
+        this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
+        this.timeoutMs = options.timeout ?? DEFAULT_TIMEOUT_MS;
+        this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+        if (options.fetch) {
+            this._fetch = options.fetch;
+        }
+        else if (typeof globalThis.fetch === 'function') {
+            this._fetch = globalThis.fetch;
+        }
+        else {
+            throw new Error('No fetch implementation available. Provide options.fetch.');
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Core Memory Endpoints
+    // -------------------------------------------------------------------------
+    /**
+     * Ingest a memory event.
+     *
+     * Stores context your AI should remember — user messages, tool calls, or
+     * application events. Returns immediately; enrichment happens asynchronously.
+     */
+    async ingest(request) {
+        return this.post('/v1/ingest', request);
+    }
+    /**
+     * Recall relevant memory for a task.
+     *
+     * Returns ranked memory blocks that fit within the specified token budget,
+     * along with citations linking each block to its source event.
+     */
+    async recall(request) {
+        return this.post('/v1/recall', request);
+    }
+    /**
+     * Forget (delete) memory matching the given scope.
+     *
+     * Deletes all memory for the specified user, optionally scoped to a thread
+     * and/or time range. Returns a receipt with deletion counts.
+     */
+    async forget(request) {
+        return this.post('/v1/forget', request);
+    }
+    // -------------------------------------------------------------------------
+    // Usage Endpoints
+    // -------------------------------------------------------------------------
+    /**
+     * Get aggregated usage summary with daily breakdown.
+     */
+    async getUsageSummary(range = '7d') {
+        return this.get('/v1/usage/summary', { range });
+    }
+    /**
+     * Get usage breakdown by endpoint.
+     */
+    async getUsageBreakdown(range = '7d') {
+        return this.get('/v1/usage/breakdown', { range });
+    }
+    /**
+     * Get current plan limits and quota status.
+     */
+    async getUsageLimits() {
+        return this.get('/v1/usage/limits');
+    }
+    // -------------------------------------------------------------------------
+    // Deletion Receipts
+    // -------------------------------------------------------------------------
+    /**
+     * List deletion receipts, newest first.
+     * Supports filtering by user_id and pagination via limit/offset.
+     */
+    async listDeletionReceipts(options) {
+        const params = {};
+        if (options?.user_id)
+            params.user_id = options.user_id;
+        if (options?.limit !== undefined)
+            params.limit = String(options.limit);
+        if (options?.offset !== undefined)
+            params.offset = String(options.offset);
+        return this.get('/v1/deletion-receipts', params);
+    }
+    /**
+     * Get a single deletion receipt by ID.
+     */
+    async getDeletionReceipt(receiptId) {
+        return this.get(`/v1/deletion-receipts/${receiptId}`);
+    }
+    // -------------------------------------------------------------------------
+    // Health
+    // -------------------------------------------------------------------------
+    /**
+     * Check if the API is reachable and healthy.
+     * Does not require authentication.
+     */
+    async healthCheck() {
+        return this.request('GET', '/healthz', undefined, false);
+    }
+    // -------------------------------------------------------------------------
+    // Internal HTTP Methods
+    // -------------------------------------------------------------------------
+    async post(path, body) {
+        return this.request('POST', path, body, true);
+    }
+    async get(path, params) {
+        let url = path;
+        if (params) {
+            const qs = new URLSearchParams(params).toString();
+            if (qs)
+                url = `${path}?${qs}`;
+        }
+        return this.request('GET', url, undefined, true);
+    }
+    async request(method, path, body, auth) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            'Accept': 'application/json',
+        };
+        if (auth) {
+            headers['Authorization'] = `Bearer ${this.apiKey}`;
+        }
+        if (body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+        }
+        let lastError;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            if (attempt > 0 && lastError) {
+                const backoff = this.getBackoffMs(attempt, lastError);
+                await sleep(backoff);
+            }
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+            let response;
+            try {
+                response = await this._fetch(url, {
+                    method,
+                    headers,
+                    body: body !== undefined ? JSON.stringify(body) : undefined,
+                    signal: controller.signal,
+                });
+            }
+            catch (err) {
+                clearTimeout(timer);
+                if (err instanceof DOMException && err.name === 'AbortError') {
+                    throw new ClaivTimeoutError(this.timeoutMs);
+                }
+                throw new ClaivNetworkError(err instanceof Error ? err : new Error(String(err)));
+            }
+            finally {
+                clearTimeout(timer);
+            }
+            if (response.ok) {
+                return (await response.json());
+            }
+            let errorBody;
+            try {
+                errorBody = (await response.json());
+            }
+            catch {
+                errorBody = {
+                    error: {
+                        code: 'unknown',
+                        message: response.statusText || `HTTP ${response.status}`,
+                        request_id: '00000000-0000-0000-0000-000000000000',
+                    },
+                };
+            }
+            lastError = new ClaivApiError(response.status, errorBody);
+            if (!RETRYABLE_STATUS_CODES.has(response.status) || attempt === this.maxRetries) {
+                throw lastError;
+            }
+        }
+        // Unreachable, but satisfies TypeScript
+        throw lastError;
+    }
+    getBackoffMs(attempt, error) {
+        // Respect Retry-After header for 429 responses (stored in details if present)
+        const retryAfter = error.details && typeof error.details === 'object' &&
+            'retry_after' in error.details
+            ? Number(error.details.retry_after)
+            : undefined;
+        if (retryAfter && retryAfter > 0) {
+            return Math.min(retryAfter * 1000, MAX_BACKOFF_MS);
+        }
+        // Exponential backoff with jitter
+        const base = INITIAL_BACKOFF_MS * Math.pow(2, attempt - 1);
+        const jitter = base * 0.5 * Math.random();
+        return Math.min(base + jitter, MAX_BACKOFF_MS);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,35 @@
+import type { ApiErrorBody } from './types.js';
+/**
+ * Base error for all Claiv SDK errors.
+ */
+export declare class ClaivError extends Error {
+    constructor(message: string);
+}
+/**
+ * Thrown when the API returns an error response (4xx / 5xx).
+ */
+export declare class ClaivApiError extends ClaivError {
+    /** HTTP status code */
+    readonly status: number;
+    /** Machine-readable error code from the API */
+    readonly code: string;
+    /** Server-assigned request ID for support tickets */
+    readonly requestId: string;
+    /** Optional extra details (e.g. validation errors, quota info) */
+    readonly details: unknown;
+    constructor(status: number, body: ApiErrorBody);
+}
+/**
+ * Thrown when a request times out.
+ */
+export declare class ClaivTimeoutError extends ClaivError {
+    constructor(timeoutMs: number);
+}
+/**
+ * Thrown when a network-level error occurs (DNS failure, connection refused, etc.).
+ */
+export declare class ClaivNetworkError extends ClaivError {
+    readonly cause: Error;
+    constructor(cause: Error);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C,uBAAuB;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBAEd,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAQ/C;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,UAAU;gBACnC,SAAS,EAAE,MAAM;CAI9B;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,UAAU;IAC/C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;gBAEV,KAAK,EAAE,KAAK;CAKzB"}

package/dist/errors.js

@@ -0,0 +1,51 @@
+/**
+ * Base error for all Claiv SDK errors.
+ */
+export class ClaivError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ClaivError';
+    }
+}
+/**
+ * Thrown when the API returns an error response (4xx / 5xx).
+ */
+export class ClaivApiError extends ClaivError {
+    /** HTTP status code */
+    status;
+    /** Machine-readable error code from the API */
+    code;
+    /** Server-assigned request ID for support tickets */
+    requestId;
+    /** Optional extra details (e.g. validation errors, quota info) */
+    details;
+    constructor(status, body) {
+        super(body.error.message);
+        this.name = 'ClaivApiError';
+        this.status = status;
+        this.code = body.error.code;
+        this.requestId = body.error.request_id;
+        this.details = body.error.details;
+    }
+}
+/**
+ * Thrown when a request times out.
+ */
+export class ClaivTimeoutError extends ClaivError {
+    constructor(timeoutMs) {
+        super(`Request timed out after ${timeoutMs}ms`);
+        this.name = 'ClaivTimeoutError';
+    }
+}
+/**
+ * Thrown when a network-level error occurs (DNS failure, connection refused, etc.).
+ */
+export class ClaivNetworkError extends ClaivError {
+    cause;
+    constructor(cause) {
+        super(`Network error: ${cause.message}`);
+        this.name = 'ClaivNetworkError';
+        this.cause = cause;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,uBAAuB;IACd,MAAM,CAAS;IACxB,+CAA+C;IACtC,IAAI,CAAS;IACtB,qDAAqD;IAC5C,SAAS,CAAS;IAC3B,kEAAkE;IACzD,OAAO,CAAU;IAE1B,YAAY,MAAc,EAAE,IAAkB;QAC5C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,UAAU;IAC/C,YAAY,SAAiB;QAC3B,KAAK,CAAC,2BAA2B,SAAS,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,UAAU;IACtC,KAAK,CAAQ;IAEtB,YAAY,KAAY;QACtB,KAAK,CAAC,kBAAkB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { ClaivClient } from './client.js';
+export { ClaivError, ClaivApiError, ClaivTimeoutError, ClaivNetworkError } from './errors.js';
+export type { ClaivClientOptions, EventType, MemoryBlockType, UsageRange, IngestRequest, IngestResponse, RecallRequest, RecallResponse, ContextPack, MemoryBlock, ForgetRequest, ForgetResponse, DeletedCounts, DeletionScope, DeletionReceipt, ListDeletionReceiptsResponse, UsageSummaryResponse, UsageTotals, UsageDailyEntry, UsageBreakdownResponse, EndpointBreakdownEntry, UsageLimitsResponse, UsageLimitMetric, ApiErrorBody, } from './types.js';
+//# 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":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC9F,YAAY,EACV,kBAAkB,EAClB,SAAS,EACT,eAAe,EACf,UAAU,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EACf,4BAA4B,EAC5B,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { ClaivClient } from './client.js';
+export { ClaivError, ClaivApiError, ClaivTimeoutError, ClaivNetworkError } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,158 @@
+/**
+ * TypeScript types matching the Claiv Memory API contracts exactly.
+ *
+ * These mirror the Zod schemas in @claiv/shared without importing them,
+ * so the SDK has zero dependency on internal packages.
+ */
+export type EventType = 'message' | 'tool_call' | 'app_event';
+export type MemoryBlockType = 'open_loop' | 'fact' | 'claim' | 'episode' | 'chunk';
+export type UsageRange = '7d' | '30d' | 'month' | 'today';
+export interface IngestRequest {
+    user_id: string;
+    thread_id?: string;
+    type: EventType;
+    content: string;
+    metadata?: Record<string, unknown>;
+    event_time?: string;
+    idempotency_key?: string;
+}
+export interface IngestResponse {
+    event_id: string;
+    deduped: boolean;
+}
+export interface RecallRequest {
+    user_id: string;
+    thread_id?: string;
+    task: string;
+    token_budget: number;
+    scope?: Record<string, unknown>;
+}
+export interface MemoryBlock {
+    type: MemoryBlockType;
+    content: string;
+    source_ids: string[];
+    score: number;
+}
+export interface RecallResponse {
+    system_context: string;
+    memory_blocks: MemoryBlock[];
+    citations: string[];
+    token_estimate: number;
+}
+export type ContextPack = RecallResponse;
+export interface ForgetRequest {
+    user_id: string;
+    thread_id?: string;
+    from_time?: string;
+    to_time?: string;
+}
+export interface DeletedCounts {
+    events: number;
+    chunks: number;
+    episodes: number;
+    facts: number;
+    claims: number;
+    open_loops: number;
+}
+export interface ForgetResponse {
+    receipt_id: string;
+    deleted_counts: DeletedCounts;
+}
+export interface DeletionScope {
+    user_id: string;
+    thread_id?: string | null;
+    from_time?: string | null;
+    to_time?: string | null;
+}
+export interface DeletionReceipt {
+    receipt_id: string;
+    scope: DeletionScope;
+    requested_at: string;
+    completed_at: string | null;
+    deleted_counts: DeletedCounts;
+}
+export interface ListDeletionReceiptsResponse {
+    receipts: DeletionReceipt[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface UsageTotals {
+    requests: number;
+    ingest_requests: number;
+    recall_requests: number;
+    forget_requests: number;
+    ingest_events: number;
+    tokens: number;
+    work_units: number;
+    errors: number;
+    request_bytes: number;
+    response_bytes: number;
+}
+export interface UsageDailyEntry {
+    date: string;
+    requests: number;
+    ingest_events: number;
+    tokens: number;
+    work_units: number;
+    errors: number;
+}
+export interface UsageSummaryResponse {
+    range: string;
+    start_date: string;
+    end_date: string;
+    totals: UsageTotals;
+    daily: UsageDailyEntry[];
+}
+export interface EndpointBreakdownEntry {
+    endpoint: string;
+    requests: number;
+    errors: number;
+    error_rate: number;
+    avg_latency_ms: number;
+}
+export interface UsageBreakdownResponse {
+    range: string;
+    start_date: string;
+    end_date: string;
+    endpoints: EndpointBreakdownEntry[];
+}
+export interface UsageLimitMetric {
+    used: number;
+    limit: number | null;
+    remaining: number | null;
+    percentage_used: number;
+}
+export interface UsageLimitsResponse {
+    plan: string;
+    billing_cycle_day: number;
+    reset_date: string;
+    is_within_quota: boolean;
+    limits: {
+        requests: UsageLimitMetric;
+        tokens: UsageLimitMetric;
+        work_units: UsageLimitMetric;
+        ingest_events: UsageLimitMetric;
+    };
+}
+export interface ApiErrorBody {
+    error: {
+        code: string;
+        message: string;
+        request_id: string;
+        details?: unknown;
+    };
+}
+export interface ClaivClientOptions {
+    /** API key for authentication (sent as Bearer token). */
+    apiKey: string;
+    /** Base URL of the Claiv Memory API. Defaults to https://api.claiv.com */
+    baseUrl?: string;
+    /** Request timeout in milliseconds. Defaults to 30000. */
+    timeout?: number;
+    /** Maximum number of retries on 429 and 5xx errors. Set to 0 to disable. Defaults to 2. */
+    maxRetries?: number;
+    /** Custom fetch implementation. Defaults to global fetch. */
+    fetch?: typeof globalThis.fetch;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * TypeScript types matching the Claiv Memory API contracts exactly.
+ *
+ * These mirror the Zod schemas in @claiv/shared without importing them,
+ * so the SDK has zero dependency on internal packages.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@claiv/memory",
+  "version": "0.1.0",
+  "description": "Official JavaScript/TypeScript SDK for the Claiv Memory API",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run"
+  },
+  "keywords": ["claiv", "memory", "ai", "context", "llm", "sdk"],
+  "author": "Claiv",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kinkaid2002/claiv-memory.git",
+    "directory": "packages/sdk-js"
+  },
+  "homepage": "https://claiv.com",
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.18"
+  }
+}