@amodalai/runtime 0.3.64 → 0.3.66

package/dist/src/sinks/http-audit-sink.test.js

@@ -0,0 +1,124 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { HttpAuditSink } from './http-audit-sink.js';
+function captureFetch(status = 200) {
+    const calls = [];
+    const fetchMock = vi.fn(async (input, init) => {
+        const url = String(input);
+        const body = typeof init?.body === 'string'
+            ? JSON.parse(init.body)
+            : { entries: [] };
+        const headers = init?.headers;
+        const authorization = headers?.['Authorization'] ?? '';
+        calls.push({ url, body, authorization });
+        return new Response(null, { status });
+    });
+    vi.stubGlobal('fetch', fetchMock);
+    return { fetchMock, calls };
+}
+describe('HttpAuditSink', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+        vi.unstubAllGlobals();
+    });
+    it('substitutes {agentId} in the URL template and sends with bearer auth', async () => {
+        const { calls } = captureFetch();
+        const sink = new HttpAuditSink({
+            url: 'https://api.example.com/api/agents/{agentId}/audit-logs',
+            getBearerToken: () => 'jwt-value',
+            maxBatchSize: 1,
+        });
+        sink.log('agent/special chars', undefined, {
+            event: 'session_completed',
+            resource_name: 'session-1',
+        });
+        await vi.runOnlyPendingTimersAsync();
+        expect(calls).toHaveLength(1);
+        expect(calls[0]?.url).toBe('https://api.example.com/api/agents/agent%2Fspecial%20chars/audit-logs');
+        expect(calls[0]?.authorization).toBe('Bearer jwt-value');
+        expect(calls[0]?.body.entries).toHaveLength(1);
+        expect(calls[0]?.body.entries[0]?.event).toBe('session_completed');
+        expect(calls[0]?.body.entries[0]?.timestamp).toBeDefined();
+        await sink.shutdown();
+    });
+    it('batches entries with the same agent + partition key', async () => {
+        const { calls } = captureFetch();
+        const sink = new HttpAuditSink({
+            url: 'https://api.example.com/audit',
+            getBearerToken: () => 'jwt',
+            maxBatchSize: 100,
+        });
+        sink.log('agent-1', 'user-a', { event: 'e1', resource_name: 'r' });
+        sink.log('agent-1', 'user-a', { event: 'e2', resource_name: 'r' });
+        sink.log('agent-1', 'user-a', { event: 'e3', resource_name: 'r' });
+        await sink.flush();
+        expect(calls).toHaveLength(1);
+        expect(calls[0]?.body.entries).toHaveLength(3);
+        await sink.shutdown();
+    });
+    it('separates batches by partition key', async () => {
+        const { calls } = captureFetch();
+        const sink = new HttpAuditSink({
+            url: 'https://api.example.com/audit',
+            getBearerToken: ({ partitionKey }) => partitionKey === 'user-a' ? 'token-a' : 'token-b',
+            maxBatchSize: 100,
+        });
+        sink.log('agent-1', 'user-a', { event: 'e1', resource_name: 'r' });
+        sink.log('agent-1', 'user-b', { event: 'e2', resource_name: 'r' });
+        await sink.flush();
+        expect(calls).toHaveLength(2);
+        const tokens = calls.map((c) => c.authorization).sort();
+        expect(tokens).toEqual(['Bearer token-a', 'Bearer token-b']);
+        await sink.shutdown();
+    });
+    it('auto-flushes when batch size threshold is hit', async () => {
+        const { calls } = captureFetch();
+        const sink = new HttpAuditSink({
+            url: 'https://api.example.com/audit',
+            getBearerToken: () => 'jwt',
+            maxBatchSize: 2,
+        });
+        sink.log('agent-1', undefined, { event: 'e1', resource_name: 'r' });
+        sink.log('agent-1', undefined, { event: 'e2', resource_name: 'r' });
+        // Auto-flush kicks in after the second entry — give microtasks a tick
+        await vi.runOnlyPendingTimersAsync();
+        expect(calls).toHaveLength(1);
+        expect(calls[0]?.body.entries).toHaveLength(2);
+        await sink.shutdown();
+    });
+    it('preserves the entry-supplied timestamp when present', async () => {
+        const { calls } = captureFetch();
+        const sink = new HttpAuditSink({
+            url: 'https://api.example.com/audit',
+            getBearerToken: () => 'jwt',
+            maxBatchSize: 1,
+        });
+        sink.log('agent-1', undefined, {
+            event: 'e1',
+            resource_name: 'r',
+            timestamp: '2026-01-01T00:00:00.000Z',
+        });
+        await vi.runOnlyPendingTimersAsync();
+        expect(calls[0]?.body.entries[0]?.timestamp).toBe('2026-01-01T00:00:00.000Z');
+        await sink.shutdown();
+    });
+    it('does not throw when fetch rejects (fire-and-forget)', async () => {
+        vi.stubGlobal('fetch', vi.fn(() => Promise.reject(new Error('network down'))));
+        const sink = new HttpAuditSink({
+            url: 'https://api.example.com/audit',
+            getBearerToken: () => 'jwt',
+            maxBatchSize: 1,
+        });
+        sink.log('agent-1', undefined, { event: 'e1', resource_name: 'r' });
+        await expect(sink.flush()).resolves.toBeUndefined();
+        await sink.shutdown();
+    });
+});
+//# sourceMappingURL=http-audit-sink.test.js.map

package/dist/src/sinks/http-audit-sink.test.js.map

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

package/dist/src/sinks/http-usage-sink.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { UsageReport } from '../session/stream-hooks.js';
+export interface HttpUsageSinkOptions {
+    /**
+     * Full URL the batch is POSTed to. May include the literal placeholder
+     * `{agentId}`, which is replaced at send time with the URL-encoded
+     * `agentId` from the call. Example:
+     *
+     *   'https://platform.example.com/api/agents/{agentId}/usage'
+     */
+    url: string;
+    /**
+     * Resolve the bearer token to send with each batch. Called once per send.
+     * Typically returns the per-deploy JWT carried by the runtime — usage is
+     * not user-attributed at the auth layer (attribution is in `scopeId`).
+     */
+    getBearerToken: (ctx: {
+        agentId: string;
+    }) => string;
+    /** Default 2000ms */
+    flushIntervalMs?: number;
+    /** Default 20 — auto-flush threshold per agent batch */
+    maxBatchSize?: number;
+    /** Default 10000ms — abort if a single POST takes longer */
+    requestTimeoutMs?: number;
+}
+export declare class HttpUsageSink {
+    private readonly url;
+    private readonly getBearerToken;
+    private readonly flushIntervalMs;
+    private readonly maxBatchSize;
+    private readonly requestTimeoutMs;
+    private readonly pending;
+    private flushTimer;
+    constructor(options: HttpUsageSinkOptions);
+    /**
+     * Queue a usage report for batched delivery. Fire-and-forget — never throws.
+     * Reports are batched per `agentId`; consumers attribute per end-user via
+     * each report's `scopeId` field.
+     */
+    log(agentId: string, report: UsageReport): void;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+    private send;
+}

package/dist/src/sinks/http-usage-sink.js

@@ -0,0 +1,101 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Batched HTTP sink for per-turn usage reports.
+ *
+ * Wire to `StreamHooks.onUsageReport` in hosted setups; self-hosters point
+ * the URL at their own metering endpoint. Each report carries `scopeId`
+ * (end-user identity from the auth JWT) and `sessionId`, so consumers can
+ * attribute tokens per end-user — something LiteLLM-style proxies can't do
+ * because they only see the deploy's virtual key.
+ *
+ * Failures are non-fatal — the sink logs and drops the batch rather than
+ * blocking chat handling.
+ */
+import { log } from '../logger.js';
+const DEFAULT_FLUSH_INTERVAL_MS = 2000;
+const DEFAULT_MAX_BATCH_SIZE = 20;
+const DEFAULT_REQUEST_TIMEOUT_MS = 10_000;
+export class HttpUsageSink {
+    url;
+    getBearerToken;
+    flushIntervalMs;
+    maxBatchSize;
+    requestTimeoutMs;
+    pending = new Map();
+    flushTimer;
+    constructor(options) {
+        this.url = options.url;
+        this.getBearerToken = options.getBearerToken;
+        this.flushIntervalMs = options.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;
+        this.maxBatchSize = options.maxBatchSize ?? DEFAULT_MAX_BATCH_SIZE;
+        this.requestTimeoutMs = options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+        this.flushTimer = setInterval(() => {
+            void this.flush();
+        }, this.flushIntervalMs);
+        this.flushTimer.unref();
+    }
+    /**
+     * Queue a usage report for batched delivery. Fire-and-forget — never throws.
+     * Reports are batched per `agentId`; consumers attribute per end-user via
+     * each report's `scopeId` field.
+     */
+    log(agentId, report) {
+        let batch = this.pending.get(agentId);
+        if (!batch) {
+            batch = { agentId, reports: [] };
+            this.pending.set(agentId, batch);
+        }
+        batch.reports.push(report);
+        if (batch.reports.length >= this.maxBatchSize) {
+            const toSend = batch;
+            this.pending.delete(agentId);
+            void this.send(toSend);
+        }
+    }
+    async flush() {
+        const batches = [...this.pending.values()];
+        this.pending.clear();
+        await Promise.all(batches.map((b) => this.send(b)));
+    }
+    async shutdown() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        await this.flush();
+    }
+    async send(batch) {
+        const url = this.url.replace('{agentId}', encodeURIComponent(batch.agentId));
+        const token = this.getBearerToken({ agentId: batch.agentId });
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                signal: AbortSignal.timeout(this.requestTimeoutMs),
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${token}`,
+                },
+                body: JSON.stringify({ reports: batch.reports }),
+            });
+            if (!response.ok) {
+                log.warn('usage_sink_http_error', {
+                    status: response.status,
+                    agentId: batch.agentId,
+                    batchSize: batch.reports.length,
+                });
+            }
+        }
+        catch (err) {
+            log.warn('usage_sink_send_failed', {
+                agentId: batch.agentId,
+                batchSize: batch.reports.length,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+}
+//# sourceMappingURL=http-usage-sink.js.map

package/dist/src/sinks/http-usage-sink.js.map

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

package/dist/src/sinks/http-usage-sink.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export {};

package/dist/src/sinks/http-usage-sink.test.js

@@ -0,0 +1,105 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { HttpUsageSink } from './http-usage-sink.js';
+function captureFetch(status = 200) {
+    const calls = [];
+    const fetchMock = vi.fn(async (input, init) => {
+        const url = String(input);
+        const body = typeof init?.body === 'string'
+            ? JSON.parse(init.body)
+            : { reports: [] };
+        const headers = init?.headers;
+        const authorization = headers?.['Authorization'] ?? '';
+        calls.push({ url, body, authorization });
+        return new Response(null, { status });
+    });
+    vi.stubGlobal('fetch', fetchMock);
+    return { fetchMock, calls };
+}
+function makeReport(scopeId) {
+    return {
+        sessionId: 'session-1',
+        scopeId,
+        model: 'claude-sonnet-4-20250514',
+        taskAgentRuns: 0,
+        tokens: { inputTokens: 100, outputTokens: 50, cachedTokens: 0 },
+    };
+}
+describe('HttpUsageSink', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+        vi.unstubAllGlobals();
+    });
+    it('substitutes {agentId} in the URL template and sends with bearer auth', async () => {
+        const { calls } = captureFetch();
+        const sink = new HttpUsageSink({
+            url: 'https://api.example.com/api/agents/{agentId}/usage',
+            getBearerToken: () => 'deploy-jwt',
+            maxBatchSize: 1,
+        });
+        sink.log('agent-1', makeReport('end-user-x'));
+        await vi.runOnlyPendingTimersAsync();
+        expect(calls).toHaveLength(1);
+        expect(calls[0]?.url).toBe('https://api.example.com/api/agents/agent-1/usage');
+        expect(calls[0]?.authorization).toBe('Bearer deploy-jwt');
+        expect(calls[0]?.body.reports).toHaveLength(1);
+        expect(calls[0]?.body.reports[0]?.scopeId).toBe('end-user-x');
+        await sink.shutdown();
+    });
+    it('batches reports per agent regardless of scope', async () => {
+        const { calls } = captureFetch();
+        const sink = new HttpUsageSink({
+            url: 'https://api.example.com/usage',
+            getBearerToken: () => 'jwt',
+            maxBatchSize: 100,
+        });
+        sink.log('agent-1', makeReport('user-a'));
+        sink.log('agent-1', makeReport('user-b'));
+        sink.log('agent-1', makeReport(''));
+        await sink.flush();
+        expect(calls).toHaveLength(1);
+        expect(calls[0]?.body.reports.map((r) => r.scopeId).sort()).toEqual([
+            '',
+            'user-a',
+            'user-b',
+        ]);
+        await sink.shutdown();
+    });
+    it('keeps batches separate per agent', async () => {
+        const { calls } = captureFetch();
+        const sink = new HttpUsageSink({
+            url: 'https://api.example.com/api/agents/{agentId}/usage',
+            getBearerToken: () => 'jwt',
+            maxBatchSize: 100,
+        });
+        sink.log('agent-1', makeReport('user-a'));
+        sink.log('agent-2', makeReport('user-a'));
+        await sink.flush();
+        expect(calls).toHaveLength(2);
+        const urls = calls.map((c) => c.url).sort();
+        expect(urls).toEqual([
+            'https://api.example.com/api/agents/agent-1/usage',
+            'https://api.example.com/api/agents/agent-2/usage',
+        ]);
+        await sink.shutdown();
+    });
+    it('does not throw when fetch rejects (fire-and-forget)', async () => {
+        vi.stubGlobal('fetch', vi.fn(() => Promise.reject(new Error('network down'))));
+        const sink = new HttpUsageSink({
+            url: 'https://api.example.com/usage',
+            getBearerToken: () => 'jwt',
+            maxBatchSize: 1,
+        });
+        sink.log('agent-1', makeReport('user-a'));
+        await expect(sink.flush()).resolves.toBeUndefined();
+        await sink.shutdown();
+    });
+});
+//# sourceMappingURL=http-usage-sink.test.js.map

package/dist/src/sinks/http-usage-sink.test.js.map

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