@loopers/client 1.0.0 → 1.3.0

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+## [1.3.0](https://github.com/CURSED-ME/loopers-oss/compare/sdk-ts-v1.2.0...sdk-ts-v1.3.0) (2026-06-28)
+
+
+### Features
+
+* add 14 providers, bump SDKs to 1.0.0, prepare for launch ([abd1d6d](https://github.com/CURSED-ME/loopers-oss/commit/abd1d6d06623bd4ba475247cc8f4d83d744e67f4))
+* **sdk:** support Phase 1 session headers ([ec81008](https://github.com/CURSED-ME/loopers-oss/commit/ec81008939fb5c3d9e78fe210d2e6c766bfc99b6))
+
+
+### Bug Fixes
+
+* bump sdk versions and disable homebrew publishing for CI ([9e8ceae](https://github.com/CURSED-ME/loopers-oss/commit/9e8ceaef264fcde3dad46af132481f9db91cebb0))
+* **ci:** disable homebrew tap until repo is created, bump versions to 0.4.5 ([8523ff4](https://github.com/CURSED-ME/loopers-oss/commit/8523ff498a82e8310a8cdc6f856e39b399ef7d5a))
+* **ci:** fix goreleaser sbom config and bump versions to 0.4.3 ([56563ec](https://github.com/CURSED-ME/loopers-oss/commit/56563ece8d04927227308905b7105e396326880f))
+* **ci:** fix invalid action commit hashes for goreleaser, bump version to 0.4.2 ([d6a40ef](https://github.com/CURSED-ME/loopers-oss/commit/d6a40efa1f51529046d3513368b9bea6e7d4ae54))
+* **ci:** point syft to latest v0 to support --enrich flag and bump to v0.4.7 ([29a7f7f](https://github.com/CURSED-ME/loopers-oss/commit/29a7f7f7c2ae1ba293004db61a9743a2218b55d5))
+* **ci:** use latest syft for goreleaser sboms, bump versions to 0.4.4 ([af0790a](https://github.com/CURSED-ME/loopers-oss/commit/af0790a6245cd9e9bf309b5747dfb89e6fe8c3f3))
+* **sdk:** add Phase 1 headers to all adapters, bump to v1.2.0, expand test coverage ([9a40389](https://github.com/CURSED-ME/loopers-oss/commit/9a40389146df62674d53705f500851601181d1cb))
+* **sdk:** fix anthropic sdk version in TS package, bump versions to 0.4.1 ([df374e6](https://github.com/CURSED-ME/loopers-oss/commit/df374e6d4e95aa09d77f24f94dd10dd41444c3b2))
+* **security:** address OpenSSF scorecard issues and bump to v0.4.6 ([4d31477](https://github.com/CURSED-ME/loopers-oss/commit/4d3147704db87b8c11e988ddd17b06f18a658c9d))

package/dist/client.d.ts

@@ -7,6 +7,9 @@ export interface LoopersClientOptions {
     sessionId?: string;
     sessionBudget?: number;
     maxSteps?: number;
+    sessionTtl?: number;
+    maxTools?: number;
+    maxServers?: number;
 }
 export declare class LoopersOpenAI extends OpenAI {
     constructor(options: LoopersClientOptions & {

package/dist/client.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LoopersAnthropic = exports.LoopersTogether = exports.LoopersDeepSeek = exports.LoopersMistral = exports.LoopersGroq = exports.LoopersOpenAI = void 0;
 const openai_1 = __importDefault(require("openai"));
 const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
-function createLoopersFetch(loopersKey, providerKey, sessionId, sessionBudget, maxSteps, customFetch) {
+function createLoopersFetch(loopersKey, providerKey, sessionId, sessionBudget, maxSteps, sessionTtl, maxTools, maxServers, customFetch) {
     const originalFetch = customFetch || (typeof fetch !== 'undefined' ? fetch : undefined);
     if (!originalFetch) {
         throw new Error('A global fetch function is not available. Please pass a custom fetch implementation (e.g. node-fetch) or use Node.js 18+.');
@@ -28,6 +28,15 @@ function createLoopersFetch(loopersKey, providerKey, sessionId, sessionBudget, m
         if (maxSteps !== undefined) {
             headers.set('X-Loopers-Session-Max-Steps', String(maxSteps));
         }
+        if (sessionTtl !== undefined) {
+            headers.set('X-Loopers-Session-TTL', String(sessionTtl));
+        }
+        if (maxTools !== undefined) {
+            headers.set('X-Loopers-Session-Max-Tools', String(maxTools));
+        }
+        if (maxServers !== undefined) {
+            headers.set('X-Loopers-Session-Max-Servers', String(maxServers));
+        }
         const modifiedInit = {
             ...init,
             headers,
@@ -78,9 +87,9 @@ function createLoopersFetch(loopersKey, providerKey, sessionId, sessionBudget, m
 }
 class LoopersOpenAI extends openai_1.default {
     constructor(options) {
-        const { loopersUrl, loopersKey, providerKey, sessionId, sessionBudget, maxSteps, _providerPath, ...openaiOptions } = options;
+        const { loopersUrl, loopersKey, providerKey, sessionId, sessionBudget, maxSteps, sessionTtl, maxTools, maxServers, _providerPath, ...openaiOptions } = options;
         const baseFetch = openaiOptions.fetch;
-        const loopersFetch = createLoopersFetch(loopersKey, providerKey, sessionId, sessionBudget, maxSteps, baseFetch);
+        const loopersFetch = createLoopersFetch(loopersKey, providerKey, sessionId, sessionBudget, maxSteps, sessionTtl, maxTools, maxServers, baseFetch);
         super({
             ...openaiOptions,
             baseURL: `${loopersUrl.replace(/\/$/, '')}/${_providerPath || 'openai/v1'}`,
@@ -116,9 +125,9 @@ class LoopersTogether extends LoopersOpenAI {
 exports.LoopersTogether = LoopersTogether;
 class LoopersAnthropic extends sdk_1.default {
     constructor(options) {
-        const { loopersUrl, loopersKey, providerKey, sessionId, sessionBudget, maxSteps, ...anthropicOptions } = options;
+        const { loopersUrl, loopersKey, providerKey, sessionId, sessionBudget, maxSteps, sessionTtl, maxTools, maxServers, ...anthropicOptions } = options;
         const baseFetch = anthropicOptions.fetch;
-        const loopersFetch = createLoopersFetch(loopersKey, providerKey, sessionId, sessionBudget, maxSteps, baseFetch);
+        const loopersFetch = createLoopersFetch(loopersKey, providerKey, sessionId, sessionBudget, maxSteps, sessionTtl, maxTools, maxServers, baseFetch);
         super({
             ...anthropicOptions,
             baseURL: `${loopersUrl.replace(/\/$/, '')}/anthropic`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loopers/client",
-  "version": "1.0.0",
+  "version": "1.3.0",
   "description": "A premium TypeScript client wrapper for the Loopers AI budget & rate-limit proxy.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/client.ts

@@ -8,6 +8,9 @@ export interface LoopersClientOptions {
   sessionId?: string;
   sessionBudget?: number;
   maxSteps?: number;
+  sessionTtl?: number;
+  maxTools?: number;
+  maxServers?: number;
 }
 
 function createLoopersFetch(
@@ -16,6 +19,9 @@ function createLoopersFetch(
   sessionId?: string,
   sessionBudget?: number,
   maxSteps?: number,
+  sessionTtl?: number,
+  maxTools?: number,
+  maxServers?: number,
   customFetch?: typeof fetch
 ) {
   const originalFetch = customFetch || (typeof fetch !== 'undefined' ? fetch : undefined);
@@ -41,6 +47,15 @@ function createLoopersFetch(
     if (maxSteps !== undefined) {
       headers.set('X-Loopers-Session-Max-Steps', String(maxSteps));
     }
+    if (sessionTtl !== undefined) {
+      headers.set('X-Loopers-Session-TTL', String(sessionTtl));
+    }
+    if (maxTools !== undefined) {
+      headers.set('X-Loopers-Session-Max-Tools', String(maxTools));
+    }
+    if (maxServers !== undefined) {
+      headers.set('X-Loopers-Session-Max-Servers', String(maxServers));
+    }
 
     const modifiedInit = {
       ...init,
@@ -108,6 +123,9 @@ export class LoopersOpenAI extends OpenAI {
       sessionId,
       sessionBudget,
       maxSteps,
+      sessionTtl,
+      maxTools,
+      maxServers,
       _providerPath,
       ...openaiOptions
     } = options;
@@ -119,6 +137,9 @@ export class LoopersOpenAI extends OpenAI {
       sessionId,
       sessionBudget,
       maxSteps,
+      sessionTtl,
+      maxTools,
+      maxServers,
       baseFetch
     );
 
@@ -168,6 +189,9 @@ export class LoopersAnthropic extends Anthropic {
       sessionId,
       sessionBudget,
       maxSteps,
+      sessionTtl,
+      maxTools,
+      maxServers,
       ...anthropicOptions
     } = options;
 
@@ -178,6 +202,9 @@ export class LoopersAnthropic extends Anthropic {
       sessionId,
       sessionBudget,
       maxSteps,
+      sessionTtl,
+      maxTools,
+      maxServers,
       baseFetch
     );
 

package/test/client.test.ts

@@ -1,16 +1,40 @@
 import { describe, it, expect, vi } from 'vitest';
-import { LoopersOpenAI, LoopersAnthropic } from '../src/client';
+import { LoopersOpenAI, LoopersAnthropic, LoopersGroq } from '../src/client';
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function makeMockFetch(responseHeaders: Record<string, string> = {}) {
+  return vi.fn().mockResolvedValue({
+    json: async () => ({ id: 'chatcmpl-123', choices: [], object: 'chat.completion' }),
+    text: async () => JSON.stringify({ id: 'chatcmpl-123', choices: [], object: 'chat.completion' }),
+    headers: new Headers(responseHeaders),
+    ok: true,
+    status: 200,
+  });
+}
+
+// ---------------------------------------------------------------------------
+// LoopersOpenAI
+// ---------------------------------------------------------------------------
 
 describe('LoopersOpenAI', () => {
-  it('should override baseURL and inject headers', async () => {
-    const mockFetch = vi.fn().mockResolvedValue({
-      json: async () => ({ id: 'chatcmpl-123' }),
-      text: async () => JSON.stringify({ id: 'chatcmpl-123' }),
-      headers: new Headers(),
-      ok: true,
-      status: 200,
+  it('should route to the correct URL', async () => {
+    const mockFetch = makeMockFetch();
+    const client = new LoopersOpenAI({
+      loopersUrl: 'http://localhost:8080',
+      loopersKey: 'lp-123',
+      fetch: mockFetch as any,
     });
+    await client.chat.completions.create({ model: 'gpt-4', messages: [{ role: 'user', content: 'hi' }] });
 
+    const [url] = mockFetch.mock.calls[0];
+    expect(url.toString()).toBe('http://localhost:8080/openai/v1/chat/completions');
+  });
+
+  it('should inject all governance headers', async () => {
+    const mockFetch = makeMockFetch();
     const client = new LoopersOpenAI({
       loopersUrl: 'http://localhost:8080',
       loopersKey: 'lp-123',
@@ -18,60 +42,70 @@ describe('LoopersOpenAI', () => {
       sessionId: 'sess-1',
       sessionBudget: 5.0,
       maxSteps: 10,
+      sessionTtl: 3600,
+      maxTools: 5,
+      maxServers: 2,
       fetch: mockFetch as any,
     });
+    await client.chat.completions.create({ model: 'gpt-4', messages: [{ role: 'user', content: 'hi' }] });
 
-    await client.chat.completions.create({
-      model: 'gpt-4',
-      messages: [{ role: 'user', content: 'hi' }],
-    });
-
-    expect(mockFetch).toHaveBeenCalledTimes(1);
-    const [url, init] = mockFetch.mock.calls[0];
-    expect(url.toString()).toBe('http://localhost:8080/openai/v1/chat/completions');
-    
+    const [, init] = mockFetch.mock.calls[0];
     const headers = new Headers(init.headers);
     expect(headers.get('Authorization')).toBe('Bearer lp-123');
     expect(headers.get('X-Loopers-Provider-Key')).toBe('sk-openai');
     expect(headers.get('X-Loopers-Session-ID')).toBe('sess-1');
     expect(headers.get('X-Loopers-Session-Budget')).toBe('5');
     expect(headers.get('X-Loopers-Session-Max-Steps')).toBe('10');
+    expect(headers.get('X-Loopers-Session-TTL')).toBe('3600');
+    expect(headers.get('X-Loopers-Session-Max-Tools')).toBe('5');
+    expect(headers.get('X-Loopers-Session-Max-Servers')).toBe('2');
   });
 
-  // BUG: The TS SDK intercepts res.json() to attach metrics, but the underlying 
-  // OpenAI SDK uses res.text() and JSON.parse() internally. This means the metrics
-  // are never attached to the returned object. Skipping this test until the SDK is redesigned.
-  it.skip('should parse loopers metrics from headers', async () => {
-
-    const mockFetch = vi.fn().mockResolvedValue({
-      json: async () => ({ id: 'chatcmpl-123' }),
-      text: async () => JSON.stringify({ id: 'chatcmpl-123' }),
-      headers: mockHeaders,
-      ok: true,
-      status: 200,
-    });
-
+  it('should NOT send optional headers when they are not set', async () => {
+    const mockFetch = makeMockFetch();
     const client = new LoopersOpenAI({
       loopersUrl: 'http://localhost:8080',
       loopersKey: 'lp-123',
       fetch: mockFetch as any,
     });
+    await client.chat.completions.create({ model: 'gpt-4', messages: [{ role: 'user', content: 'hi' }] });
 
-    const res = await client.chat.completions.create({
-      model: 'gpt-4',
-      messages: [{ role: 'user', content: 'hi' }],
-    }) as any;
+    const [, init] = mockFetch.mock.calls[0];
+    const headers = new Headers(init.headers);
+    expect(headers.get('X-Loopers-Session-Budget')).toBeNull();
+    expect(headers.get('X-Loopers-Session-Max-Steps')).toBeNull();
+    expect(headers.get('X-Loopers-Session-TTL')).toBeNull();
+    expect(headers.get('X-Loopers-Session-Max-Tools')).toBeNull();
+    expect(headers.get('X-Loopers-Session-Max-Servers')).toBeNull();
+  });
 
+  // NOTE: The TS SDK intercepts res.json() but the underlying OpenAI SDK
+  // internally uses res.text() + JSON.parse(), so metrics are not attached
+  // to the returned typed object. This is a known limitation documented as
+  // a skipped test — the raw fetch response does expose the headers correctly.
+  it.skip('should parse loopers metrics from response headers', async () => {
+    const mockFetch = vi.fn().mockResolvedValue({
+      json: async () => ({ id: 'chatcmpl-123', choices: [], object: 'chat.completion' }),
+      text: async () => JSON.stringify({ id: 'chatcmpl-123', choices: [], object: 'chat.completion' }),
+      headers: new Headers({ 'X-Loopers-Request-Cost': '0.01', 'X-Loopers-Session-Spend': '0.05' }),
+      ok: true,
+      status: 200,
+    });
+    const client = new LoopersOpenAI({ loopersUrl: 'http://localhost:8080', loopersKey: 'lp-123', fetch: mockFetch as any });
+    const res = await client.chat.completions.create({ model: 'gpt-4', messages: [{ role: 'user', content: 'hi' }] }) as any;
     expect(res.loopers_cost).toBe(0.01);
-    expect(res.loopers_session_spend).toBe(0.05);
   });
 });
 
+// ---------------------------------------------------------------------------
+// LoopersAnthropic
+// ---------------------------------------------------------------------------
+
 describe('LoopersAnthropic', () => {
-  it('should override baseURL and inject headers', async () => {
+  it('should route to the correct URL and inject governance headers', async () => {
     const mockFetch = vi.fn().mockResolvedValue({
-      json: async () => ({ id: 'msg_123', type: 'message' }),
-      text: async () => JSON.stringify({ id: 'msg_123', type: 'message' }),
+      json: async () => ({ id: 'msg_123', type: 'message', role: 'assistant', content: [], model: 'claude-3', stop_reason: 'end_turn', usage: { input_tokens: 1, output_tokens: 1 } }),
+      text: async () => JSON.stringify({ id: 'msg_123', type: 'message', role: 'assistant', content: [], model: 'claude-3', stop_reason: 'end_turn', usage: { input_tokens: 1, output_tokens: 1 } }),
       headers: new Headers(),
       ok: true,
       status: 200,
@@ -81,6 +115,12 @@ describe('LoopersAnthropic', () => {
       loopersUrl: 'http://localhost:8080',
       loopersKey: 'lp-123',
       providerKey: 'sk-ant',
+      sessionId: 'sess-ant-1',
+      sessionBudget: 10.0,
+      maxSteps: 5,
+      sessionTtl: 1800,
+      maxTools: 3,
+      maxServers: 1,
       fetch: mockFetch as any,
     });
 
@@ -90,42 +130,43 @@ describe('LoopersAnthropic', () => {
       max_tokens: 10,
     });
 
-    expect(mockFetch).toHaveBeenCalledTimes(1);
     const [url, init] = mockFetch.mock.calls[0];
     expect(url.toString()).toBe('http://localhost:8080/anthropic/v1/messages');
-    
     const headers = new Headers(init.headers);
     expect(headers.get('Authorization')).toBe('Bearer lp-123');
     expect(headers.get('X-Loopers-Provider-Key')).toBe('sk-ant');
+    expect(headers.get('X-Loopers-Session-ID')).toBe('sess-ant-1');
+    expect(headers.get('X-Loopers-Session-Budget')).toBe('10');
+    expect(headers.get('X-Loopers-Session-Max-Steps')).toBe('5');
+    expect(headers.get('X-Loopers-Session-TTL')).toBe('1800');
+    expect(headers.get('X-Loopers-Session-Max-Tools')).toBe('3');
+    expect(headers.get('X-Loopers-Session-Max-Servers')).toBe('1');
   });
 });
 
-import { LoopersGroq } from '../src/client';
+// ---------------------------------------------------------------------------
+// Provider subclasses
+// ---------------------------------------------------------------------------
 
 describe('LoopersGroq', () => {
-  it('should override baseURL to groq/v1', async () => {
-    const mockFetch = vi.fn().mockResolvedValue({
-      json: async () => ({ id: 'chatcmpl-123' }),
-      text: async () => JSON.stringify({ id: 'chatcmpl-123' }),
-      headers: new Headers(),
-      ok: true,
-      status: 200,
-    });
-
+  it('should route to groq/v1 path with all new headers', async () => {
+    const mockFetch = makeMockFetch();
     const client = new LoopersGroq({
       loopersUrl: 'http://localhost:8080',
       loopersKey: 'lp-123',
       providerKey: 'gsk_123',
+      sessionTtl: 600,
+      maxTools: 10,
+      maxServers: 3,
       fetch: mockFetch as any,
     });
+    await client.chat.completions.create({ model: 'llama-3', messages: [{ role: 'user', content: 'hi' }] });
 
-    await client.chat.completions.create({
-      model: 'llama-3',
-      messages: [{ role: 'user', content: 'hi' }],
-    });
-
-    expect(mockFetch).toHaveBeenCalledTimes(1);
     const [url, init] = mockFetch.mock.calls[0];
     expect(url.toString()).toBe('http://localhost:8080/groq/v1/chat/completions');
+    const headers = new Headers(init.headers);
+    expect(headers.get('X-Loopers-Session-TTL')).toBe('600');
+    expect(headers.get('X-Loopers-Session-Max-Tools')).toBe('10');
+    expect(headers.get('X-Loopers-Session-Max-Servers')).toBe('3');
   });
 });