@reaatech/prompt-version-control 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# @reaatech/prompt-version-control
+
+## 0.1.0
+
+### Initial release
+
+- Typed `PromptVersionControlClient` covering prompts, versions, tags, evaluations, deployments, and metrics
+- Automatic retry with exponential backoff and jitter on 5xx and network errors
+- `AbortController`-based request timeouts (default 30s)
+- Optional in-memory LRU cache with TTL
+- `zod` is a required peer dependency — install it alongside this package

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 prompt-version-control contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,168 @@
+# @reaatech/prompt-version-control
+
+[![npm version](https://img.shields.io/npm/v/@reaatech/prompt-version-control.svg)](https://www.npmjs.com/package/@reaatech/prompt-version-control)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/reaatech/prompt-version-control/blob/main/LICENSE)
+[![CI](https://img.shields.io/github/actions/workflow/status/reaatech/prompt-version-control/ci.yml?branch=main&label=CI)](https://github.com/reaatech/prompt-version-control/actions/workflows/ci.yml)
+
+> **Status:** Pre-1.0 — APIs may change in minor versions. Pin to a specific version in production.
+
+TypeScript client SDK for the Prompt Version Control API. Provides a typed, authenticated client with built-in retry logic, configurable timeouts, and optional in-memory caching.
+
+## Installation
+
+```bash
+npm install @reaatech/prompt-version-control
+# or
+pnpm add @reaatech/prompt-version-control
+```
+
+## Feature Overview
+
+- **Typed API client** — full TypeScript types for all responses
+- **Automatic retry** — exponential backoff with jitter on 5xx errors and network failures
+- **Configurable timeouts** — `AbortController`-based request timeout (default 30s)
+- **In-memory cache** — optional LRU cache with TTL and max-entries eviction
+- **Zero-config defaults** — `baseUrl` defaults to `http://localhost:3000`
+- **4xx passthrough** — client errors are thrown immediately without retry
+
+## Quick Start
+
+```typescript
+import { PromptVersionControlClient } from "@reaatech/prompt-version-control";
+
+const client = new PromptVersionControlClient({
+  baseUrl: "http://localhost:3000",
+  apiKey: "pvc_your-api-key",
+});
+
+// Get a prompt by ID
+const prompt = await client.getPrompt("prompt-abc123");
+console.log(prompt.name, prompt.template);
+
+// List all prompts
+const { data } = await client.listPrompts();
+
+// Get the production version of a prompt
+const prod = await client.getProduction("prompt-abc123");
+console.log(prod.number, prod.content);
+```
+
+## API Reference
+
+### `PromptVersionControlClient` (class)
+
+Also exported as `PVCClient` (shorthand alias).
+
+```typescript
+import { PromptVersionControlClient } from "@reaatech/prompt-version-control";
+// or
+import { PVCClient } from "@reaatech/prompt-version-control";
+
+const client = new PVCClient({ apiKey: "pvc_...", baseUrl: "..." });
+```
+
+#### Constructor
+
+```typescript
+new PromptVersionControlClient(options: PVCClientOptions)
+```
+
+### `PVCClientOptions`
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `apiKey` | `string` | (required) | API key for Bearer authentication |
+| `baseUrl` | `string` | `"http://localhost:3000"` | API server base URL |
+| `retries` | `number` | `3` | Max retry attempts on 5xx / network errors |
+| `retryDelay` | `number` | `1000` | Base delay in ms for exponential backoff |
+| `timeoutMs` | `number` | `30000` | Per-request timeout in ms |
+| `cache` | `boolean` | `false` | Enable in-memory response caching |
+| `cacheTtl` | `number` | `60000` | Cache TTL in ms |
+| `cacheMaxEntries` | `number` | `1000` | Max entries before FIFO eviction |
+
+### Instance Methods
+
+| Method | Parameters | Returns | Description |
+|--------|------------|---------|-------------|
+| `getPrompt` | `id: string` | `Promise<{ id, name, template }>` | Retrieve a prompt by ID |
+| `listPrompts` | — | `Promise<{ data: Array<{ id, name }> }>` | List all prompts |
+| `getProduction` | `promptId: string` | `Promise<{ id, number, content, template, variables, metadata }>` | Get the production-tagged version of a prompt |
+
+## Usage Patterns
+
+### Retry with Backoff
+
+```typescript
+const client = new PromptVersionControlClient({
+  apiKey: "pvc_...",
+  retries: 5,         // up to 5 retries
+  retryDelay: 500,    // 500ms base → 500, 1000, 2000, 4000, 8000ms
+});
+
+// Transient network errors and 5xx are automatically retried
+// 4xx errors are thrown immediately
+const prompt = await client.getPrompt("prompt-id");
+```
+
+### Caching
+
+```typescript
+const client = new PromptVersionControlClient({
+  apiKey: "pvc_...",
+  cache: true,
+  cacheTtl: 120_000,       // cache entries for 2 minutes
+  cacheMaxEntries: 500,    // evict oldest when > 500 entries
+});
+
+// First call hits the API
+const prod1 = await client.getProduction("my-prompt");
+
+// Subsequent calls within TTL return cached result
+const prod2 = await client.getProduction("my-prompt");
+```
+
+### Custom Timeout
+
+```typescript
+const client = new PromptVersionControlClient({
+  apiKey: "pvc_...",
+  timeoutMs: 5000,  // fail fast — 5 second timeout
+});
+```
+
+### Using the Alias
+
+```typescript
+import { PVCClient } from "@reaatech/prompt-version-control";
+
+const client = new PVCClient({ apiKey: "pvc_..." });
+const prompt = await client.getPrompt("prompt-id");
+```
+
+## Error Handling
+
+The SDK uses raw `fetch` under the hood. On failure:
+
+- **5xx and network errors** — retried with exponential backoff + jitter, up to `retries` attempts
+- **4xx errors** — thrown immediately as `Error` with the response status and body
+- **Timeout** — thrown as `Error` with message `"Request timed out"`
+
+```typescript
+try {
+  const prompt = await client.getPrompt("nonexistent-id");
+} catch (err) {
+  // err.message will contain the HTTP status and response body
+  console.error(err.message);
+}
+```
+
+## Related Packages
+
+- [`@reaatech/prompt-version-control-shared`](https://www.npmjs.com/package/@reaatech/prompt-version-control-shared) — Shared types and utilities
+- [`@reaatech/prompt-version-control-server`](https://www.npmjs.com/package/@reaatech/prompt-version-control-server) — API server this client talks to
+- [`@reaatech/prompt-version-control-cli`](https://www.npmjs.com/package/@reaatech/prompt-version-control-cli) — CLI tool (uses this SDK)
+- [`@reaatech/prompt-version-control-mcp`](https://www.npmjs.com/package/@reaatech/prompt-version-control-mcp) — MCP server (uses this SDK)
+
+## License
+
+[MIT](https://github.com/reaatech/prompt-version-control/blob/main/LICENSE)

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+export interface PVCClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+    retries?: number;
+    retryDelay?: number;
+    timeoutMs?: number;
+    cache?: boolean;
+    cacheTtl?: number;
+    cacheMaxEntries?: number;
+}
+export declare class PromptVersionControlClient {
+    private apiKey;
+    private baseUrl;
+    private retries;
+    private retryDelay;
+    private timeoutMs;
+    private cache;
+    private cacheEnabled;
+    private cacheTtl;
+    private cacheMaxEntries;
+    constructor(options: PVCClientOptions);
+    private cacheKey;
+    private getCached;
+    private setCached;
+    private fetchWithRetry;
+    getPrompt(id: string): Promise<{
+        id: string;
+        name: string;
+        template: string;
+    }>;
+    listPrompts(): Promise<{
+        data: Array<{
+            id: string;
+            name: string;
+        }>;
+    }>;
+    getProduction(promptId: string): Promise<{
+        id: string;
+        number: number;
+        content: string;
+        template: string;
+        variables: Record<string, unknown>;
+        metadata: Record<string, unknown> | null;
+    }>;
+}
+export { PromptVersionControlClient as PVCClient };
+//# 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":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAiBD,qBAAa,0BAA0B;IACrC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,eAAe,CAAS;gBAEpB,OAAO,EAAE,gBAAgB;IAYrC,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,SAAS;YAaH,cAAc;IA2CtB,SAAS,CAAC,EAAE,EAAE,MAAM;YACS,MAAM;cAAQ,MAAM;kBAAY,MAAM;;IAKnE,WAAW;cACoB,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;;IAGlE,aAAa,CAAC,QAAQ,EAAE,MAAM;YAE5B,MAAM;gBACF,MAAM;iBACL,MAAM;kBACL,MAAM;mBACL,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;kBACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;;CAG7C;AAED,OAAO,EAAE,0BAA0B,IAAI,SAAS,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,109 @@
+import { sleep } from '@reaatech/prompt-version-control-shared';
+class HttpError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = 'HttpError';
+    }
+}
+export class PromptVersionControlClient {
+    apiKey;
+    baseUrl;
+    retries;
+    retryDelay;
+    timeoutMs;
+    cache;
+    cacheEnabled;
+    cacheTtl;
+    cacheMaxEntries;
+    constructor(options) {
+        this.apiKey = options.apiKey;
+        this.baseUrl = options.baseUrl ?? 'http://localhost:3000';
+        this.retries = options.retries ?? 3;
+        this.retryDelay = options.retryDelay ?? 1000;
+        this.timeoutMs = options.timeoutMs ?? 30_000;
+        this.cacheEnabled = options.cache ?? false;
+        this.cacheTtl = options.cacheTtl ?? 60_000;
+        this.cacheMaxEntries = options.cacheMaxEntries ?? 1000;
+        this.cache = new Map();
+    }
+    cacheKey(path) {
+        return `${this.baseUrl}${path}`;
+    }
+    getCached(path) {
+        if (!this.cacheEnabled)
+            return undefined;
+        const key = this.cacheKey(path);
+        const entry = this.cache.get(key);
+        if (entry && entry.expiresAt > Date.now()) {
+            return entry.data;
+        }
+        if (entry)
+            this.cache.delete(key);
+        return undefined;
+    }
+    setCached(path, data) {
+        if (!this.cacheEnabled)
+            return;
+        if (this.cache.size >= this.cacheMaxEntries) {
+            // Simple FIFO eviction — drop the oldest entry.
+            const oldestKey = this.cache.keys().next().value;
+            if (oldestKey !== undefined)
+                this.cache.delete(oldestKey);
+        }
+        this.cache.set(this.cacheKey(path), {
+            data,
+            expiresAt: Date.now() + this.cacheTtl,
+        });
+    }
+    async fetchWithRetry(path, init) {
+        const cached = this.getCached(path);
+        if (cached !== undefined)
+            return cached;
+        let lastError;
+        for (let attempt = 0; attempt < this.retries; attempt++) {
+            try {
+                const res = await fetch(`${this.baseUrl}${path}`, {
+                    ...init,
+                    headers: {
+                        Authorization: `Bearer ${this.apiKey}`,
+                        'Content-Type': 'application/json',
+                        ...init?.headers,
+                    },
+                    signal: AbortSignal.timeout(this.timeoutMs),
+                });
+                if (!res.ok) {
+                    const body = (await res.json().catch(() => ({})));
+                    throw new HttpError(res.status, body.error?.message || `HTTP ${res.status}`);
+                }
+                const data = (await res.json());
+                this.setCached(path, data);
+                return data;
+            }
+            catch (err) {
+                lastError = err;
+                // Only retry on network errors and 5xx; client errors will not become
+                // success on retry, and rate limits should be respected by the caller.
+                const retriable = !(err instanceof HttpError) || (err.status >= 500 && err.status < 600);
+                if (!retriable)
+                    throw err;
+                if (attempt < this.retries - 1) {
+                    await sleep(this.retryDelay * (attempt + 1));
+                }
+            }
+        }
+        throw lastError;
+    }
+    async getPrompt(id) {
+        return this.fetchWithRetry(`/api/v1/prompts/${id}`);
+    }
+    async listPrompts() {
+        return this.fetchWithRetry('/api/v1/prompts');
+    }
+    async getProduction(promptId) {
+        return this.fetchWithRetry(`/api/v1/prompts/${promptId}/production`);
+    }
+}
+export { PromptVersionControlClient as PVCClient };
+//# 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,KAAK,EAAE,MAAM,yCAAyC,CAAC;AAkBhE,MAAM,SAAU,SAAQ,KAAK;IAElB;IADT,YACS,MAAc,EACrB,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,WAAM,GAAN,MAAM,CAAQ;QAIrB,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,0BAA0B;IAC7B,MAAM,CAAS;IACf,OAAO,CAAS;IAChB,OAAO,CAAS;IAChB,UAAU,CAAS;IACnB,SAAS,CAAS;IAClB,KAAK,CAAmC;IACxC,YAAY,CAAU;IACtB,QAAQ,CAAS;IACjB,eAAe,CAAS;IAEhC,YAAY,OAAyB;QACnC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,uBAAuB,CAAC;QAC1D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;QAC7C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;QAC7C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;QAC3C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC;QAC3C,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC;QACvD,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;IACzB,CAAC;IAEO,QAAQ,CAAC,IAAY;QAC3B,OAAO,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;IAClC,CAAC;IAEO,SAAS,CAAI,IAAY;QAC/B,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,OAAO,SAAS,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,KAAK,IAAI,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC,IAAS,CAAC;QACzB,CAAC;QACD,IAAI,KAAK;YAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,SAAS,CAAI,IAAY,EAAE,IAAO;QACxC,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,OAAO;QAC/B,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC5C,gDAAgD;YAChD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YACjD,IAAI,SAAS,KAAK,SAAS;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;YAClC,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ;SACtC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,cAAc,CAAI,IAAY,EAAE,IAAkB;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAI,IAAI,CAAC,CAAC;QACvC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QAExC,IAAI,SAA4B,CAAC;QAEjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;YACxD,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;oBAChD,GAAG,IAAI;oBACP,OAAO,EAAE;wBACP,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;wBACtC,cAAc,EAAE,kBAAkB;wBAClC,GAAG,IAAI,EAAE,OAAO;qBACjB;oBACD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;iBAC5C,CAAC,CAAC;gBAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACZ,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAqC,CAAC;oBACtF,MAAM,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,IAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC/E,CAAC;gBAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAC;gBACrC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAC3B,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,SAAS,GAAG,GAAY,CAAC;gBAEzB,sEAAsE;gBACtE,uEAAuE;gBACvE,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,YAAY,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;gBACzF,IAAI,CAAC,SAAS;oBAAE,MAAM,GAAG,CAAC;gBAE1B,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;oBAC/B,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC/C,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,SAAS,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,EAAU;QACxB,OAAO,IAAI,CAAC,cAAc,CACxB,mBAAmB,EAAE,EAAE,CACxB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,cAAc,CAAgD,iBAAiB,CAAC,CAAC;IAC/F,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,QAAgB;QAClC,OAAO,IAAI,CAAC,cAAc,CAOvB,mBAAmB,QAAQ,aAAa,CAAC,CAAC;IAC/C,CAAC;CACF;AAED,OAAO,EAAE,0BAA0B,IAAI,SAAS,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@reaatech/prompt-version-control",
+  "version": "0.1.0",
+  "description": "Prompt Version Control TypeScript SDK",
+  "license": "MIT",
+  "author": "Rick Somers <rick@reaatech.com> (https://reaatech.com)",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/reaatech/prompt-version-control.git",
+    "directory": "packages/sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/reaatech/prompt-version-control/issues"
+  },
+  "homepage": "https://github.com/reaatech/prompt-version-control/tree/main/packages/sdk#readme",
+  "keywords": [
+    "prompt",
+    "version-control",
+    "sdk",
+    "typescript"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@reaatech/prompt-version-control-shared": "0.1.0"
+  },
+  "peerDependencies": {
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.8.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.1",
+    "zod": "^3.23.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "clean": "rm -rf dist coverage .turbo *.tsbuildinfo"
+  }
+}