@agentlensai/sdk 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Amit Paz
+
+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/dist/__tests__/client.test.d.ts

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

package/dist/__tests__/client.test.d.ts.map

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

package/dist/__tests__/client.test.js

@@ -0,0 +1,165 @@
+/**
+ * Tests for AgentLensClient (Story 13.1)
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { AgentLensClient } from '../client.js';
+import { AgentLensError, AuthenticationError, NotFoundError, ValidationError, ConnectionError, } from '../errors.js';
+// ─── Helpers ────────────────────────────────────────────────────────
+function mockFetch(status, body) {
+    return vi.fn().mockResolvedValue({
+        ok: status >= 200 && status < 300,
+        status,
+        text: () => Promise.resolve(JSON.stringify(body)),
+        json: () => Promise.resolve(body),
+    });
+}
+function createClient(fetchFn) {
+    return new AgentLensClient({
+        url: 'http://localhost:3400',
+        apiKey: 'als_test123',
+        fetch: fetchFn,
+    });
+}
+// ─── Tests ──────────────────────────────────────────────────────────
+describe('AgentLensClient', () => {
+    describe('constructor', () => {
+        it('strips trailing slash from URL', () => {
+            const fn = mockFetch(200, { events: [], total: 0, hasMore: false });
+            const client = new AgentLensClient({ url: 'http://localhost:3400/', fetch: fn });
+            client.queryEvents();
+            expect(fn).toHaveBeenCalledWith(expect.stringMatching(/^http:\/\/localhost:3400\/api/), expect.anything());
+        });
+    });
+    describe('queryEvents', () => {
+        it('returns typed EventQueryResult', async () => {
+            const expected = { events: [], total: 0, hasMore: false };
+            const fn = mockFetch(200, expected);
+            const client = createClient(fn);
+            const result = await client.queryEvents();
+            expect(result).toEqual(expected);
+        });
+        it('sends correct query params', async () => {
+            const fn = mockFetch(200, { events: [], total: 0, hasMore: false });
+            const client = createClient(fn);
+            await client.queryEvents({
+                sessionId: 'ses_abc',
+                eventType: 'tool_call',
+                limit: 10,
+                order: 'asc',
+            });
+            const url = fn.mock.calls[0][0];
+            expect(url).toContain('sessionId=ses_abc');
+            expect(url).toContain('eventType=tool_call');
+            expect(url).toContain('limit=10');
+            expect(url).toContain('order=asc');
+        });
+        it('handles array eventType', async () => {
+            const fn = mockFetch(200, { events: [], total: 0, hasMore: false });
+            const client = createClient(fn);
+            await client.queryEvents({ eventType: ['tool_call', 'tool_error'] });
+            const url = fn.mock.calls[0][0];
+            expect(url).toContain('eventType=tool_call%2Ctool_error');
+        });
+        it('sends Authorization header with apiKey', async () => {
+            const fn = mockFetch(200, { events: [], total: 0, hasMore: false });
+            const client = createClient(fn);
+            await client.queryEvents();
+            const opts = fn.mock.calls[0][1];
+            expect(opts.headers['Authorization']).toBe('Bearer als_test123');
+        });
+    });
+    describe('getEvent', () => {
+        it('returns a single event', async () => {
+            const event = { id: 'ev_1', eventType: 'tool_call', sessionId: 'ses_abc' };
+            const fn = mockFetch(200, event);
+            const client = createClient(fn);
+            const result = await client.getEvent('ev_1');
+            expect(result.id).toBe('ev_1');
+        });
+        it('throws NotFoundError for 404', async () => {
+            const fn = mockFetch(404, { error: 'Event not found' });
+            const client = createClient(fn);
+            await expect(client.getEvent('ev_missing')).rejects.toThrow(NotFoundError);
+        });
+    });
+    describe('getSessions', () => {
+        it('returns typed SessionQueryResult', async () => {
+            const expected = { sessions: [], total: 0, hasMore: false };
+            const fn = mockFetch(200, expected);
+            const client = createClient(fn);
+            const result = await client.getSessions();
+            expect(result).toEqual(expected);
+        });
+        it('sends status and agent filters', async () => {
+            const fn = mockFetch(200, { sessions: [], total: 0, hasMore: false });
+            const client = createClient(fn);
+            await client.getSessions({ status: 'error', agentId: 'agent-1' });
+            const url = fn.mock.calls[0][0];
+            expect(url).toContain('status=error');
+            expect(url).toContain('agentId=agent-1');
+        });
+    });
+    describe('getSession', () => {
+        it('returns a single session', async () => {
+            const session = { id: 'ses_abc', status: 'active' };
+            const fn = mockFetch(200, session);
+            const client = createClient(fn);
+            const result = await client.getSession('ses_abc');
+            expect(result.id).toBe('ses_abc');
+        });
+    });
+    describe('getSessionTimeline', () => {
+        it('returns timeline with chain validity', async () => {
+            const expected = { events: [], chainValid: true };
+            const fn = mockFetch(200, expected);
+            const client = createClient(fn);
+            const result = await client.getSessionTimeline('ses_abc');
+            expect(result.chainValid).toBe(true);
+            expect(result.events).toEqual([]);
+        });
+    });
+    describe('health', () => {
+        it('does not send Authorization header', async () => {
+            const fn = mockFetch(200, { status: 'ok', version: '0.1.0' });
+            const client = createClient(fn);
+            await client.health();
+            const opts = fn.mock.calls[0][1];
+            expect(opts.headers['Authorization']).toBeUndefined();
+        });
+    });
+    describe('error handling', () => {
+        it('throws AuthenticationError for 401', async () => {
+            const fn = mockFetch(401, { error: 'Invalid API key' });
+            const client = createClient(fn);
+            await expect(client.queryEvents()).rejects.toThrow(AuthenticationError);
+        });
+        it('throws ValidationError for 400', async () => {
+            const fn = mockFetch(400, { error: 'Validation failed', details: [{ path: 'limit', message: 'too big' }] });
+            const client = createClient(fn);
+            await expect(client.queryEvents()).rejects.toThrow(ValidationError);
+        });
+        it('throws AgentLensError for other HTTP errors', async () => {
+            const fn = mockFetch(500, { error: 'Internal server error' });
+            const client = createClient(fn);
+            await expect(client.queryEvents()).rejects.toThrow(AgentLensError);
+        });
+        it('throws ConnectionError when fetch rejects', async () => {
+            const fn = vi.fn().mockRejectedValue(new Error('ECONNREFUSED'));
+            const client = createClient(fn);
+            await expect(client.queryEvents()).rejects.toThrow(ConnectionError);
+        });
+        it('ConnectionError includes the original error message', async () => {
+            const fn = vi.fn().mockRejectedValue(new Error('ECONNREFUSED'));
+            const client = createClient(fn);
+            try {
+                await client.queryEvents();
+                expect.fail('should throw');
+            }
+            catch (err) {
+                expect(err).toBeInstanceOf(ConnectionError);
+                expect(err.message).toContain('ECONNREFUSED');
+            }
+        });
+    });
+});
+//# sourceMappingURL=client.test.js.map

package/dist/__tests__/client.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.test.js","sourceRoot":"","sources":["../../src/__tests__/client.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,uEAAuE;AAEvE,SAAS,SAAS,CAAC,MAAc,EAAE,IAAa;IAC9C,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;QAC/B,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;QACjC,MAAM;QACN,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;KACtB,CAAC,CAAC;AACjB,CAAC;AAED,SAAS,YAAY,CAAC,OAAgC;IACpD,OAAO,IAAI,eAAe,CAAC;QACzB,GAAG,EAAE,uBAAuB;QAC5B,MAAM,EAAE,aAAa;QACrB,KAAK,EAAE,OAAO;KACf,CAAC,CAAC;AACL,CAAC;AAED,uEAAuE;AAEvE,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;YACxC,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACpE,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,GAAG,EAAE,wBAAwB,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YACjF,MAAM,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,CAAC,EAAE,CAAC,CAAC,oBAAoB,CAC7B,MAAM,CAAC,cAAc,CAAC,+BAA+B,CAAC,EACtD,MAAM,CAAC,QAAQ,EAAE,CAClB,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;YAC9C,MAAM,QAAQ,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC1D,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;YAEhC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;YAC1C,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACpE,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;YAEhC,MAAM,MAAM,CAAC,WAAW,CAAC;gBACvB,SAAS,EAAE,SAAS;gBACpB,SAAS,EAAE,WAAW;gBACtB,KAAK,EAAE,EAAE;gBACT,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;YAEH,MAAM,GAAG,GAAI,EAA+B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAW,CAAC;YACzE,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;YAC3C,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YAClC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;YACvC,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACpE,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;YAEhC,MAAM,MAAM,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;YAErE,MAAM,GAAG,GAAI,EAA+B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAW,CAAC;YACzE,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,kCAAkC,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;YACtD,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACpE,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;YAEhC,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;YAE3B,MAAM,IAAI,GAAI,EAA+B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAgB,CAAC;YAC/E,MAAM,CAAE,IAAI,CAAC,OAAkC,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC/F,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;QACxB,EAAE,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;YACtC,MAAM,KAAK,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;YAC3E,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACjC,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;YAEhC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC7C,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;YAC5C,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;YACxD,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;YAEhC,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAC7E,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;YAChD,MAAM,QAAQ,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC5D,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;YAEhC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;YAC9C,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACtE,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;YAEhC,MAAM,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;YAElE,MAAM,GAAG,GAAI,EAA+B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAW,CAAC;YACzE,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;YACtC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;YACxC,MAAM,OAAO,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YACpD,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YACnC,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;YAEhC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YAClD,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;YACpD,MAAM,QAAQ,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;YAClD,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;YAEhC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;YAC1D,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;QACtB,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;YAClD,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YAC9D,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;YAEhC,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;YAEtB,MAAM,IAAI,GAAI,EAA+B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAgB,CAAC;YAC/E,MAAM,CAAE,IAAI,CAAC,OAAkC,CAAC,eAAe,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACpF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;YAClD,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;YACxD,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;YAEhC,MAAM,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;YAC9C,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;YAC5G,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;YAEhC,MAAM,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;YAC3D,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;YAC9D,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;YAEhC,MAAM,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;YACzD,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;YAChE,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;YAEhC,MAAM,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;YACnE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;YAChE,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;YAEhC,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC9B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;gBAC5C,MAAM,CAAE,GAAuB,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;YACrE,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @agentlens/sdk — AgentLensClient
+ *
+ * Typed HTTP client for the AgentLens REST API.
+ * Uses native fetch — works in Node.js ≥ 18 and browsers.
+ */
+import type { EventQuery, EventQueryResult, AgentLensEvent, Session, SessionQuery } from '@agentlens/core';
+export interface AgentLensClientOptions {
+    /** Base URL of the AgentLens server (e.g. "http://localhost:3400") */
+    url: string;
+    /** API key for authentication */
+    apiKey?: string;
+    /** Custom fetch implementation (defaults to global fetch) */
+    fetch?: typeof globalThis.fetch;
+}
+export interface SessionQueryResult {
+    sessions: Session[];
+    total: number;
+    hasMore: boolean;
+}
+export interface TimelineResult {
+    events: AgentLensEvent[];
+    chainValid: boolean;
+}
+export interface HealthResult {
+    status: string;
+    version: string;
+}
+export declare class AgentLensClient {
+    private readonly baseUrl;
+    private readonly apiKey?;
+    private readonly _fetch;
+    constructor(options: AgentLensClientOptions);
+    /**
+     * Query events with filters and pagination.
+     */
+    queryEvents(query?: EventQuery): Promise<EventQueryResult>;
+    /**
+     * Get a single event by ID.
+     */
+    getEvent(id: string): Promise<AgentLensEvent>;
+    /**
+     * Query sessions with filters and pagination.
+     */
+    getSessions(query?: SessionQuery): Promise<SessionQueryResult>;
+    /**
+     * Get a single session by ID.
+     */
+    getSession(id: string): Promise<Session>;
+    /**
+     * Get the full timeline of events for a session, with hash chain verification.
+     */
+    getSessionTimeline(sessionId: string): Promise<TimelineResult>;
+    /**
+     * Check server health (no auth required).
+     */
+    health(): Promise<HealthResult>;
+    private request;
+}
+//# 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;;;;;GAKG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,OAAO,EACP,YAAY,EACb,MAAM,iBAAiB,CAAC;AAWzB,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC;IACZ,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;gBAErC,OAAO,EAAE,sBAAsB;IAS3C;;OAEG;IACG,WAAW,CAAC,KAAK,GAAE,UAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoBpE;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAMnD;;OAEG;IACG,WAAW,CAAC,KAAK,GAAE,YAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAexE;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9C;;OAEG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAQpE;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;YAMvB,OAAO;CAwDtB"}

package/dist/client.js

@@ -0,0 +1,144 @@
+/**
+ * @agentlens/sdk — AgentLensClient
+ *
+ * Typed HTTP client for the AgentLens REST API.
+ * Uses native fetch — works in Node.js ≥ 18 and browsers.
+ */
+import { AgentLensError, AuthenticationError, NotFoundError, ValidationError, ConnectionError, } from './errors.js';
+// ─── Client ─────────────────────────────────────────────────────────
+export class AgentLensClient {
+    baseUrl;
+    apiKey;
+    _fetch;
+    constructor(options) {
+        // Strip trailing slash
+        this.baseUrl = options.url.replace(/\/+$/, '');
+        this.apiKey = options.apiKey;
+        this._fetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+    }
+    // ─── Events ──────────────────────────────────────────────
+    /**
+     * Query events with filters and pagination.
+     */
+    async queryEvents(query = {}) {
+        const params = new URLSearchParams();
+        if (query.sessionId)
+            params.set('sessionId', query.sessionId);
+        if (query.agentId)
+            params.set('agentId', query.agentId);
+        if (query.eventType) {
+            params.set('eventType', Array.isArray(query.eventType) ? query.eventType.join(',') : query.eventType);
+        }
+        if (query.severity) {
+            params.set('severity', Array.isArray(query.severity) ? query.severity.join(',') : query.severity);
+        }
+        if (query.from)
+            params.set('from', query.from);
+        if (query.to)
+            params.set('to', query.to);
+        if (query.search)
+            params.set('search', query.search);
+        if (query.limit != null)
+            params.set('limit', String(query.limit));
+        if (query.offset != null)
+            params.set('offset', String(query.offset));
+        if (query.order)
+            params.set('order', query.order);
+        return this.request(`/api/events?${params.toString()}`);
+    }
+    /**
+     * Get a single event by ID.
+     */
+    async getEvent(id) {
+        return this.request(`/api/events/${encodeURIComponent(id)}`);
+    }
+    // ─── Sessions ────────────────────────────────────────────
+    /**
+     * Query sessions with filters and pagination.
+     */
+    async getSessions(query = {}) {
+        const params = new URLSearchParams();
+        if (query.agentId)
+            params.set('agentId', query.agentId);
+        if (query.status) {
+            params.set('status', Array.isArray(query.status) ? query.status.join(',') : query.status);
+        }
+        if (query.from)
+            params.set('from', query.from);
+        if (query.to)
+            params.set('to', query.to);
+        if (query.tags)
+            params.set('tags', query.tags.join(','));
+        if (query.limit != null)
+            params.set('limit', String(query.limit));
+        if (query.offset != null)
+            params.set('offset', String(query.offset));
+        return this.request(`/api/sessions?${params.toString()}`);
+    }
+    /**
+     * Get a single session by ID.
+     */
+    async getSession(id) {
+        return this.request(`/api/sessions/${encodeURIComponent(id)}`);
+    }
+    /**
+     * Get the full timeline of events for a session, with hash chain verification.
+     */
+    async getSessionTimeline(sessionId) {
+        return this.request(`/api/sessions/${encodeURIComponent(sessionId)}/timeline`);
+    }
+    // ─── Health ──────────────────────────────────────────────
+    /**
+     * Check server health (no auth required).
+     */
+    async health() {
+        return this.request('/api/health', { skipAuth: true });
+    }
+    // ─── Internal ────────────────────────────────────────────
+    async request(path, options = {}) {
+        const { method = 'GET', body, skipAuth = false } = options;
+        const headers = {
+            'Accept': 'application/json',
+        };
+        if (!skipAuth && this.apiKey) {
+            headers['Authorization'] = `Bearer ${this.apiKey}`;
+        }
+        if (body != null) {
+            headers['Content-Type'] = 'application/json';
+        }
+        let response;
+        try {
+            response = await this._fetch(`${this.baseUrl}${path}`, {
+                method,
+                headers,
+                body: body != null ? JSON.stringify(body) : undefined,
+            });
+        }
+        catch (err) {
+            throw new ConnectionError(`Failed to connect to AgentLens at ${this.baseUrl}: ${err instanceof Error ? err.message : String(err)}`, err);
+        }
+        if (!response.ok) {
+            const text = await response.text().catch(() => '');
+            let parsed = null;
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                // not JSON
+            }
+            const message = parsed?.error ?? (text || `HTTP ${response.status}`);
+            switch (response.status) {
+                case 401:
+                    throw new AuthenticationError(message);
+                case 404:
+                    throw new NotFoundError(message);
+                case 400:
+                    throw new ValidationError(message, parsed?.details);
+                default:
+                    throw new AgentLensError(message, response.status, 'API_ERROR', parsed?.details);
+            }
+        }
+        return response.json();
+    }
+}
+//# 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,37 @@
+/**
+ * @agentlens/sdk — Typed Errors
+ */
+/**
+ * Base error class for all AgentLens SDK errors.
+ */
+export declare class AgentLensError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly details?: unknown;
+    constructor(message: string, status: number, code: string, details?: unknown);
+}
+/**
+ * Thrown when the server returns 401 Unauthorized.
+ */
+export declare class AuthenticationError extends AgentLensError {
+    constructor(message?: string);
+}
+/**
+ * Thrown when the server returns 404 Not Found.
+ */
+export declare class NotFoundError extends AgentLensError {
+    constructor(resource: string, id?: string);
+}
+/**
+ * Thrown when the server returns 400 Bad Request (validation errors).
+ */
+export declare class ValidationError extends AgentLensError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Thrown when the server is unreachable or returns a 5xx error.
+ */
+export declare class ConnectionError extends AgentLensError {
+    constructor(message: string, cause?: unknown);
+}
+//# 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;;GAEG;AAEH;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAO7E;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;gBACzC,OAAO,SAA0B;CAI9C;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,cAAc;gBACnC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM;CAK1C;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,cAAc;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,cAAc;gBACrC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C"}

package/dist/errors.js

@@ -0,0 +1,56 @@
+/**
+ * @agentlens/sdk — Typed Errors
+ */
+/**
+ * Base error class for all AgentLens SDK errors.
+ */
+export class AgentLensError extends Error {
+    status;
+    code;
+    details;
+    constructor(message, status, code, details) {
+        super(message);
+        this.name = 'AgentLensError';
+        this.status = status;
+        this.code = code;
+        this.details = details;
+    }
+}
+/**
+ * Thrown when the server returns 401 Unauthorized.
+ */
+export class AuthenticationError extends AgentLensError {
+    constructor(message = 'Authentication failed') {
+        super(message, 401, 'AUTHENTICATION_ERROR');
+        this.name = 'AuthenticationError';
+    }
+}
+/**
+ * Thrown when the server returns 404 Not Found.
+ */
+export class NotFoundError extends AgentLensError {
+    constructor(resource, id) {
+        const msg = id ? `${resource} '${id}' not found` : `${resource} not found`;
+        super(msg, 404, 'NOT_FOUND');
+        this.name = 'NotFoundError';
+    }
+}
+/**
+ * Thrown when the server returns 400 Bad Request (validation errors).
+ */
+export class ValidationError extends AgentLensError {
+    constructor(message, details) {
+        super(message, 400, 'VALIDATION_ERROR', details);
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Thrown when the server is unreachable or returns a 5xx error.
+ */
+export class ConnectionError extends AgentLensError {
+    constructor(message, cause) {
+        super(message, 0, 'CONNECTION_ERROR', cause);
+        this.name = 'ConnectionError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvB,MAAM,CAAS;IACf,IAAI,CAAS;IACb,OAAO,CAAW;IAElC,YAAY,OAAe,EAAE,MAAc,EAAE,IAAY,EAAE,OAAiB;QAC1E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IACrD,YAAY,OAAO,GAAG,uBAAuB;QAC3C,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,sBAAsB,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,cAAc;IAC/C,YAAY,QAAgB,EAAE,EAAW;QACvC,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,QAAQ,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,QAAQ,YAAY,CAAC;QAC3E,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,cAAc;IACjD,YAAY,OAAe,EAAE,OAAiB;QAC5C,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,cAAc;IACjD,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,kBAAkB,EAAE,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @agentlens/sdk — Programmatic client for the AgentLens API
+ */
+export { AgentLensClient } from './client.js';
+export type { AgentLensClientOptions, SessionQueryResult, TimelineResult, HealthResult, } from './client.js';
+export { AgentLensError, AuthenticationError, NotFoundError, ValidationError, ConnectionError, } from './errors.js';
+export type { AgentLensEvent, EventQuery, EventQueryResult, EventType, EventSeverity, Session, SessionQuery, SessionStatus, Agent, } from '@agentlens/core';
+//# 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;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EACV,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACd,YAAY,GACb,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,OAAO,EACP,YAAY,EACZ,aAAa,EACb,KAAK,GACN,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * @agentlens/sdk — Programmatic client for the AgentLens API
+ */
+// Client
+export { AgentLensClient } from './client.js';
+// Errors
+export { AgentLensError, AuthenticationError, NotFoundError, ValidationError, ConnectionError, } 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;;GAEG;AAEH,SAAS;AACT,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAQ9C,SAAS;AACT,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@agentlensai/sdk",
+  "version": "0.2.0",
+  "description": "TypeScript SDK for the AgentLens API — programmatic access to agent observability data",
+  "type": "module",
+  "license": "MIT",
+  "author": "Amit Paz",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/amitpaz/agentlens.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://github.com/amitpaz/agentlens/tree/main/packages/sdk",
+  "bugs": {
+    "url": "https://github.com/amitpaz/agentlens/issues"
+  },
+  "keywords": [
+    "agentlens",
+    "ai-agents",
+    "observability",
+    "sdk",
+    "client",
+    "typescript",
+    "api-client"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@agentlensai/core": "0.2.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsc -b --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}