@metrxbot/sdk 0.1.0

package/README.md

@@ -0,0 +1,207 @@
+# Metrx SDK
+
+TypeScript SDK for integrating with the Metrx gateway. The gateway is a Cloudflare Worker that proxies LLM API calls with cost tracking, rate limiting, and request metadata.
+
+## Installation
+
+```bash
+npm install @metrx/sdk
+```
+
+## Quick Start
+
+### Initialize the Client
+
+```typescript
+import { MetrxbotClient } from '@metrx/sdk';
+
+const client = new MetrxbotClient({
+  apiKey: process.env.METRX_API_KEY,
+  gatewayUrl: 'https://gateway.metrxbot.com', // optional, defaults to this
+  defaultAgentId: 'my-agent', // optional
+  timeout: 30000, // optional, in milliseconds
+});
+```
+
+### Chat Completions (OpenAI-compatible)
+
+```typescript
+const response = await client.chat({
+  model: 'gpt-4',
+  messages: [
+    { role: 'user', content: 'What is 2+2?' }
+  ],
+  customerId: 'user-123', // optional, for tracking
+  sessionId: 'session-456', // optional, for tracking
+});
+
+console.log(response.choices[0].message.content);
+console.log(`Cost: ${response._meta.costMicrocents} microcents`);
+console.log(`Latency: ${response._meta.latencyMs}ms`);
+```
+
+### Streaming Chat Completions
+
+```typescript
+const stream = client.chatStream({
+  model: 'gpt-4',
+  messages: [
+    { role: 'user', content: 'Write a haiku' }
+  ]
+});
+
+for await (const chunk of stream) {
+  if (chunk.choices?.[0]?.delta?.content) {
+    process.stdout.write(chunk.choices[0].delta.content);
+  }
+}
+```
+
+### Anthropic Messages API
+
+```typescript
+const response = await client.messages({
+  model: 'claude-3-sonnet',
+  max_tokens: 1024,
+  messages: [
+    { role: 'user', content: 'Hello, Claude!' }
+  ]
+});
+
+console.log(response.content[0].text);
+```
+
+### Embeddings
+
+```typescript
+const response = await client.embeddings({
+  model: 'text-embedding-3-small',
+  input: 'Hello world'
+});
+
+console.log(response.data[0].embedding);
+```
+
+### Health Check
+
+```typescript
+const health = await client.health();
+console.log(health.status); // 'ok', 'degraded', or 'error'
+console.log(health.version);
+```
+
+### List Available Models
+
+```typescript
+const models = await client.models();
+console.log(models.data.map(m => m.id));
+```
+
+## Configuration
+
+### Client Options
+
+```typescript
+interface MetrxbotConfig {
+  // Required: Your Metrx API key
+  apiKey: string;
+
+  // Optional: Gateway URL (defaults to https://gateway.metrxbot.com)
+  gatewayUrl?: string;
+
+  // Optional: Default agent ID for all requests
+  defaultAgentId?: string;
+
+  // Optional: Default LLM provider (openai, anthropic, etc.)
+  defaultProvider?: string;
+
+  // Optional: Request timeout in milliseconds (defaults to 30000)
+  timeout?: number;
+}
+```
+
+### Request Options
+
+All API methods accept these additional optional parameters:
+
+```typescript
+interface RequestOptions {
+  // Override the default agent ID for this request
+  agentId?: string;
+
+  // Customer/end-user ID for tracking
+  customerId?: string;
+
+  // Session ID for tracking
+  sessionId?: string;
+
+  // Provider API key (if required by provider)
+  providerKey?: string;
+
+  // Force a specific provider for this request
+  provider?: string;
+}
+```
+
+## Error Handling
+
+The SDK provides specific error classes for different failure scenarios:
+
+```typescript
+import {
+  MetrxbotError,
+  AuthenticationError,
+  RateLimitError,
+  GatewayError,
+  ValidationError,
+  TimeoutError,
+} from '@metrxbot/sdk';
+
+try {
+  const response = await client.chat({
+    model: 'gpt-4',
+    messages: [{ role: 'user', content: 'Hello' }]
+  });
+} catch (error) {
+  if (error instanceof AuthenticationError) {
+    console.error('API key is invalid');
+  } else if (error instanceof RateLimitError) {
+    console.error(`Rate limited. Retry after ${error.retryAfter}s`);
+  } else if (error instanceof GatewayError) {
+    console.error('Gateway is experiencing issues');
+  } else if (error instanceof ValidationError) {
+    console.error('Invalid request parameters');
+  } else if (error instanceof TimeoutError) {
+    console.error('Request timed out');
+  } else {
+    console.error('Unknown error:', error);
+  }
+}
+```
+
+## Response Metadata
+
+All responses include a `_meta` field with gateway metadata:
+
+```typescript
+interface MetrxbotMeta {
+  // Gateway response latency in milliseconds
+  latencyMs: number;
+
+  // Cost of the request in microcents
+  costMicrocents: number;
+
+  // X-Request-ID header from gateway
+  requestId?: string;
+}
+```
+
+## Supported Environments
+
+- Node.js 18+
+- Deno
+- Modern browsers (with native fetch support)
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Metrx Client
+ * Main SDK client for interacting with the Metrx gateway
+ */
+import { MetrxbotConfig, ChatCompletionParams, ChatCompletionResponse, EmbeddingsParams, EmbeddingsResponse, HealthResponse, MessagesParams, MessagesResponse, ModelsResponse, StreamChunk } from './types';
+export declare class MetrxbotClient {
+    private apiKey;
+    private gatewayUrl;
+    private defaultAgentId?;
+    private defaultProvider?;
+    private timeout;
+    constructor(config: MetrxbotConfig);
+    /**
+     * Perform a health check on the gateway
+     */
+    health(): Promise<HealthResponse>;
+    /**
+     * List available models
+     */
+    models(): Promise<ModelsResponse>;
+    /**
+     * OpenAI-compatible chat completion
+     */
+    chat(params: ChatCompletionParams): Promise<ChatCompletionResponse>;
+    /**
+     * OpenAI-compatible chat completion with streaming
+     */
+    chatStream(params: ChatCompletionParams): AsyncIterable<StreamChunk>;
+    /**
+     * Anthropic-compatible messages endpoint
+     */
+    messages(params: MessagesParams): Promise<MessagesResponse>;
+    /**
+     * OpenAI-compatible embeddings
+     */
+    embeddings(params: EmbeddingsParams): Promise<EmbeddingsResponse>;
+    /**
+     * Internal: Make a JSON request and return parsed response
+     */
+    private request;
+    /**
+     * Internal: Raw fetch with headers and timeout
+     */
+    private fetchRaw;
+    /**
+     * Internal: Build request headers
+     */
+    private buildHeaders;
+    /**
+     * Internal: Extract metadata from response headers
+     */
+    private extractMetadata;
+    /**
+     * Internal: Handle error responses
+     */
+    private handleErrorResponse;
+}
+//# 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;;;GAGG;AAEH,OAAO,EACL,cAAc,EAEd,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,EAEd,WAAW,EACZ,MAAM,SAAS,CAAC;AAajB,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,cAAc;IAYlC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAIvC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAIvC;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IASzE;;OAEG;IACI,UAAU,CACf,MAAM,EAAE,oBAAoB,GAC3B,aAAa,CAAC,WAAW,CAAC;IAyD7B;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IASjE;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IASvE;;OAEG;YACW,OAAO;IAsBrB;;OAEG;YACW,QAAQ;IAsCtB;;OAEG;IACH,OAAO,CAAC,YAAY;IA+BpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB;;OAEG;YACW,mBAAmB;CAgClC"}

package/dist/client.js

@@ -0,0 +1,219 @@
+/**
+ * Metrx Client
+ * Main SDK client for interacting with the Metrx gateway
+ */
+import { MetrxbotError, AuthenticationError, GatewayError, RateLimitError, TimeoutError, ValidationError, } from './errors';
+const DEFAULT_GATEWAY_URL = 'https://gateway.metrxbot.com';
+const DEFAULT_TIMEOUT = 30000; // 30 seconds
+export class MetrxbotClient {
+    apiKey;
+    gatewayUrl;
+    defaultAgentId;
+    defaultProvider;
+    timeout;
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new ValidationError('apiKey is required');
+        }
+        this.apiKey = config.apiKey;
+        this.gatewayUrl = config.gatewayUrl || DEFAULT_GATEWAY_URL;
+        this.defaultAgentId = config.defaultAgentId;
+        this.defaultProvider = config.defaultProvider;
+        this.timeout = config.timeout || DEFAULT_TIMEOUT;
+    }
+    /**
+     * Perform a health check on the gateway
+     */
+    async health() {
+        return this.request('GET', '/health');
+    }
+    /**
+     * List available models
+     */
+    async models() {
+        return this.request('GET', '/v1/models');
+    }
+    /**
+     * OpenAI-compatible chat completion
+     */
+    async chat(params) {
+        return this.request('POST', '/v1/chat/completions', { ...params, stream: false }, params);
+    }
+    /**
+     * OpenAI-compatible chat completion with streaming
+     */
+    async *chatStream(params) {
+        const response = await this.fetchRaw('POST', '/v1/chat/completions', { ...params, stream: true }, params);
+        if (!response.ok) {
+            await this.handleErrorResponse(response);
+        }
+        if (!response.body) {
+            throw new MetrxbotError('No response body for streaming request');
+        }
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        try {
+            let buffer = '';
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split('\n');
+                buffer = lines.pop() || '';
+                for (const line of lines) {
+                    if (!line.trim())
+                        continue;
+                    if (!line.startsWith('data: '))
+                        continue;
+                    const data = line.slice(6).trim();
+                    if (data === '[DONE]') {
+                        break;
+                    }
+                    try {
+                        const chunk = JSON.parse(data);
+                        // Attach metadata from response headers
+                        chunk._meta = this.extractMetadata(response);
+                        yield chunk;
+                    }
+                    catch {
+                        // Skip malformed JSON
+                    }
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    /**
+     * Anthropic-compatible messages endpoint
+     */
+    async messages(params) {
+        return this.request('POST', '/v1/messages', params, params);
+    }
+    /**
+     * OpenAI-compatible embeddings
+     */
+    async embeddings(params) {
+        return this.request('POST', '/v1/embeddings', params, params);
+    }
+    /**
+     * Internal: Make a JSON request and return parsed response
+     */
+    async request(method, path, body, options) {
+        const response = await this.fetchRaw(method, path, body, options);
+        if (!response.ok) {
+            await this.handleErrorResponse(response);
+        }
+        const data = (await response.json());
+        // Attach metadata from response headers
+        if (data && typeof data === 'object') {
+            data._meta = this.extractMetadata(response);
+        }
+        return data;
+    }
+    /**
+     * Internal: Raw fetch with headers and timeout
+     */
+    async fetchRaw(method, path, body, options) {
+        const url = `${this.gatewayUrl}${path}`;
+        const headers = this.buildHeaders(options);
+        const init = {
+            method,
+            headers,
+        };
+        if (body) {
+            init.body = JSON.stringify(body);
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                ...init,
+                signal: controller.signal,
+            });
+            return response;
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new TimeoutError(`Request timeout after ${this.timeout}ms`);
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Internal: Build request headers
+     */
+    buildHeaders(options) {
+        const headers = {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${this.apiKey}`,
+        };
+        const agentId = options?.agentId || this.defaultAgentId;
+        if (agentId) {
+            headers['X-Agent-ID'] = agentId;
+        }
+        if (options?.customerId) {
+            headers['X-Customer-ID'] = options.customerId;
+        }
+        if (options?.sessionId) {
+            headers['X-Session-ID'] = options.sessionId;
+        }
+        if (options?.providerKey) {
+            headers['X-Provider-Key'] = options.providerKey;
+        }
+        const provider = options?.provider || this.defaultProvider;
+        if (provider) {
+            headers['X-Provider'] = provider;
+        }
+        return headers;
+    }
+    /**
+     * Internal: Extract metadata from response headers
+     */
+    extractMetadata(response) {
+        const latencyMs = parseInt(response.headers.get('X-Gateway-Latency') || '0', 10);
+        const costMicrocents = parseInt(response.headers.get('X-Gateway-Cost') || '0', 10);
+        const requestId = response.headers.get('X-Request-ID') || undefined;
+        return {
+            latencyMs,
+            costMicrocents,
+            requestId: requestId || undefined,
+        };
+    }
+    /**
+     * Internal: Handle error responses
+     */
+    async handleErrorResponse(response) {
+        const requestId = response.headers.get('X-Request-ID') || undefined;
+        let errorMessage = `HTTP ${response.status}`;
+        try {
+            const errorData = (await response.json());
+            if (errorData.error?.message) {
+                errorMessage = errorData.error.message;
+            }
+        }
+        catch {
+            // Response is not JSON, use default message
+        }
+        switch (response.status) {
+            case 400:
+                throw new ValidationError(errorMessage, requestId);
+            case 401:
+                throw new AuthenticationError(errorMessage, requestId);
+            case 429:
+                const retryAfter = response.headers.get('Retry-After');
+                throw new RateLimitError(errorMessage, retryAfter || undefined, requestId);
+            case 502:
+            case 504:
+                throw new GatewayError(errorMessage, response.status, requestId);
+            default:
+                throw new MetrxbotError(errorMessage, response.status, requestId);
+        }
+    }
+}
+//# 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,26 @@
+/**
+ * Metrx Error Classes
+ */
+export declare class MetrxbotError extends Error {
+    statusCode?: number;
+    retryAfter?: number;
+    requestId?: string;
+    constructor(message: string, statusCode?: number, requestId?: string);
+}
+export declare class AuthenticationError extends MetrxbotError {
+    constructor(message?: string, requestId?: string);
+}
+export declare class RateLimitError extends MetrxbotError {
+    constructor(message?: string, retryAfter?: number | string, requestId?: string);
+}
+export declare class GatewayError extends MetrxbotError {
+    constructor(message: string, statusCode: number, requestId?: string);
+}
+export declare class ValidationError extends MetrxbotError {
+    constructor(message?: string, requestId?: string);
+}
+export declare class TimeoutError extends MetrxbotError {
+    constructor(message?: string, requestId?: string);
+}
+export declare function isMetrxbotError(error: unknown): error is MetrxbotError;
+//# 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,qBAAa,aAAc,SAAQ,KAAK;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAMrE;AAED,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,OAAO,GAAE,MAAgC,EAAE,SAAS,CAAC,EAAE,MAAM;CAI1E;AAED,qBAAa,cAAe,SAAQ,aAAa;gBAE7C,OAAO,GAAE,MAA8B,EACvC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAC5B,SAAS,CAAC,EAAE,MAAM;CAOrB;AAED,qBAAa,YAAa,SAAQ,aAAa;gBACjC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIpE;AAED,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,GAAE,MAA4B,EAAE,SAAS,CAAC,EAAE,MAAM;CAItE;AAED,qBAAa,YAAa,SAAQ,aAAa;gBACjC,OAAO,GAAE,MAA0B,EAAE,SAAS,CAAC,EAAE,MAAM;CAIpE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE"}

package/dist/errors.js

@@ -0,0 +1,50 @@
+/**
+ * Metrx Error Classes
+ */
+export class MetrxbotError extends Error {
+    statusCode;
+    retryAfter;
+    requestId;
+    constructor(message, statusCode, requestId) {
+        super(message);
+        this.name = 'MetrxbotError';
+        this.statusCode = statusCode;
+        this.requestId = requestId;
+    }
+}
+export class AuthenticationError extends MetrxbotError {
+    constructor(message = 'Authentication failed', requestId) {
+        super(message, 401, requestId);
+        this.name = 'AuthenticationError';
+    }
+}
+export class RateLimitError extends MetrxbotError {
+    constructor(message = 'Rate limit exceeded', retryAfter, requestId) {
+        super(message, 429, requestId);
+        this.name = 'RateLimitError';
+        this.retryAfter =
+            typeof retryAfter === 'string' ? parseInt(retryAfter, 10) : retryAfter;
+    }
+}
+export class GatewayError extends MetrxbotError {
+    constructor(message, statusCode, requestId) {
+        super(message, statusCode, requestId);
+        this.name = 'GatewayError';
+    }
+}
+export class ValidationError extends MetrxbotError {
+    constructor(message = 'Validation failed', requestId) {
+        super(message, 400, requestId);
+        this.name = 'ValidationError';
+    }
+}
+export class TimeoutError extends MetrxbotError {
+    constructor(message = 'Request timeout', requestId) {
+        super(message, 0, requestId);
+        this.name = 'TimeoutError';
+    }
+}
+export function isMetrxbotError(error) {
+    return error instanceof MetrxbotError;
+}
+//# 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,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC/B,UAAU,CAAU;IACpB,UAAU,CAAU;IACpB,SAAS,CAAU;IAE1B,YAAY,OAAe,EAAE,UAAmB,EAAE,SAAkB;QAClE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IACpD,YAAY,UAAkB,uBAAuB,EAAE,SAAkB;QACvE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,aAAa;IAC/C,YACE,UAAkB,qBAAqB,EACvC,UAA4B,EAC5B,SAAkB;QAElB,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,UAAU;YACb,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IAC3E,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,aAAa;IAC7C,YAAY,OAAe,EAAE,UAAkB,EAAE,SAAkB;QACjE,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,aAAa;IAChD,YAAY,UAAkB,mBAAmB,EAAE,SAAkB;QACnE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,aAAa;IAC7C,YAAY,UAAkB,iBAAiB,EAAE,SAAkB;QACjE,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,YAAY,aAAa,CAAC;AACxC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Metrx SDK
+ * TypeScript SDK for integrating with Metrx gateway
+ */
+export { MetrxbotClient } from './client';
+export { MetrxbotSpanExporter } from './otel';
+export type { MetrxbotConfig, MetrxbotMeta, RequestOptions, ChatCompletionParams, ChatCompletionResponse, ChatMessage, ChatChoice, StreamChunk, StreamChoice, MessagesParams, MessagesResponse, AnthropicMessage, AnthropicContent, MessageContent, EmbeddingsParams, EmbeddingsResponse, Embedding, HealthResponse, ModelsResponse, Model, APIError, OtelExporterConfig, } from './types';
+export { MetrxbotError, AuthenticationError, RateLimitError, GatewayError, ValidationError, TimeoutError, isMetrxbotError, } from './errors';
+//# 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;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAG9C,YAAY,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,cAAc,EACd,KAAK,EACL,QAAQ,EACR,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,eAAe,GAChB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * Metrx SDK
+ * TypeScript SDK for integrating with Metrx gateway
+ */
+export { MetrxbotClient } from './client';
+// OpenTelemetry Exporter
+export { MetrxbotSpanExporter } from './otel';
+// Errors
+export { MetrxbotError, AuthenticationError, RateLimitError, GatewayError, ValidationError, TimeoutError, isMetrxbotError, } from './errors';
+//# 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;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,yBAAyB;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AA4B9C,SAAS;AACT,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,eAAe,GAChB,MAAM,UAAU,CAAC"}

package/dist/otel.d.ts

@@ -0,0 +1,115 @@
+/**
+ * OpenTelemetry Span Exporter for Metrx
+ *
+ * Exports LLM-related spans to Metrx's event ingestion API.
+ * Uses duck typing to avoid @opentelemetry dependencies (zero-dependency SDK).
+ */
+import type { OtelExporterConfig } from './types';
+/**
+ * Minimal SpanExporter interface (duck-typed from OpenTelemetry)
+ */
+interface SpanExporter {
+    export(spans: ReadableSpan[], resultCallback: ExportResultCallback): void;
+    shutdown(): Promise<void>;
+    forceFlush(timeoutMs?: number): Promise<void>;
+}
+/**
+ * Minimal ReadableSpan interface (duck-typed from OpenTelemetry)
+ */
+interface ReadableSpan {
+    name: string;
+    spanContext(): {
+        traceId: string;
+        spanId: string;
+    };
+    parentSpanId?: string;
+    startTime: [number, number];
+    endTime: [number, number];
+    duration: [number, number];
+    status?: {
+        code: number;
+        message?: string;
+    };
+    attributes?: Record<string, any>;
+    links?: Array<any>;
+    events?: Array<any>;
+    resource?: {
+        attributes?: Record<string, any>;
+    };
+}
+/**
+ * Result callback for span export
+ */
+type ExportResultCallback = (result: ExportResult) => void;
+/**
+ * Export result status codes
+ */
+declare enum ExportResultCode {
+    SUCCESS = 0,
+    FAILED = 1
+}
+/**
+ * Export result passed to callback
+ */
+interface ExportResult {
+    code: ExportResultCode;
+}
+/**
+ * OpenTelemetry Span Exporter for Metrx
+ *
+ * Filters LLM-related spans from OpenTelemetry SDK and exports them
+ * to Metrx's event ingestion API.
+ */
+export declare class MetrxbotSpanExporter implements SpanExporter {
+    private apiKey;
+    private gatewayUrl;
+    private agentId?;
+    private batchSize;
+    private flushIntervalMs;
+    private buffer;
+    private flushTimer?;
+    private isShuttingDown;
+    constructor(config: OtelExporterConfig);
+    /**
+     * Export spans from OpenTelemetry SDK
+     */
+    export(spans: ReadableSpan[], resultCallback: ExportResultCallback): void;
+    /**
+     * Shutdown exporter and flush remaining spans
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Force flush buffered spans immediately
+     */
+    forceFlush(_timeoutMs?: number): Promise<void>;
+    /**
+     * Convert an OpenTelemetry span to an LLM event
+     */
+    private spanToLLMEvent;
+    /**
+     * Check if a span is LLM-related
+     */
+    private isLLMSpan;
+    /**
+     * Calculate latency in milliseconds from span timing
+     */
+    private calculateLatencyMs;
+    /**
+     * Start periodic flush timer
+     */
+    private startFlushTimer;
+    /**
+     * Flush buffered spans synchronously (best effort)
+     */
+    private flush;
+    /**
+     * Flush buffered spans asynchronously
+     */
+    private flushAsync;
+    /**
+     * Send events to Metrx API
+     */
+    private sendEvents;
+}
+export {};
+//# sourceMappingURL=otel.d.ts.map

package/dist/otel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../src/otel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;GAEG;AACH,UAAU,YAAY;IACpB,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,cAAc,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1E,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,MAAM,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACpB,QAAQ,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAC;CACjD;AAED;;GAEG;AACH,KAAK,oBAAoB,GAAG,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;AAE3D;;GAEG;AACH,aAAK,gBAAgB;IACnB,OAAO,IAAI;IACX,MAAM,IAAI;CACX;AAED;;GAEG;AACH,UAAU,YAAY;IACpB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAoBD;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAC,CAAiB;IACpC,OAAO,CAAC,cAAc,CAAS;gBAEnB,MAAM,EAAE,kBAAkB;IActC;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,cAAc,EAAE,oBAAoB,GAAG,IAAI;IA0BzE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAc/B;;OAEG;IACG,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpD;;OAEG;IACH,OAAO,CAAC,cAAc;IA8DtB;;OAEG;IACH,OAAO,CAAC,SAAS;IA2BjB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;IACH,OAAO,CAAC,KAAK;IAeb;;OAEG;YACW,UAAU;IAiBxB;;OAEG;YACW,UAAU;CA8BzB"}

package/dist/otel.js

@@ -0,0 +1,249 @@
+/**
+ * OpenTelemetry Span Exporter for Metrx
+ *
+ * Exports LLM-related spans to Metrx's event ingestion API.
+ * Uses duck typing to avoid @opentelemetry dependencies (zero-dependency SDK).
+ */
+/**
+ * Export result status codes
+ */
+var ExportResultCode;
+(function (ExportResultCode) {
+    ExportResultCode[ExportResultCode["SUCCESS"] = 0] = "SUCCESS";
+    ExportResultCode[ExportResultCode["FAILED"] = 1] = "FAILED";
+})(ExportResultCode || (ExportResultCode = {}));
+/**
+ * OpenTelemetry Span Exporter for Metrx
+ *
+ * Filters LLM-related spans from OpenTelemetry SDK and exports them
+ * to Metrx's event ingestion API.
+ */
+export class MetrxbotSpanExporter {
+    apiKey;
+    gatewayUrl;
+    agentId;
+    batchSize;
+    flushIntervalMs;
+    buffer = [];
+    flushTimer;
+    isShuttingDown = false;
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new Error('apiKey is required');
+        }
+        this.apiKey = config.apiKey;
+        this.gatewayUrl = config.gatewayUrl || 'https://gateway.metrxbot.com';
+        this.agentId = config.agentId;
+        this.batchSize = config.batchSize ?? 50;
+        this.flushIntervalMs = config.flushIntervalMs ?? 5000;
+        this.startFlushTimer();
+    }
+    /**
+     * Export spans from OpenTelemetry SDK
+     */
+    export(spans, resultCallback) {
+        if (this.isShuttingDown) {
+            resultCallback({ code: ExportResultCode.FAILED });
+            return;
+        }
+        try {
+            for (const span of spans) {
+                const event = this.spanToLLMEvent(span);
+                if (event) {
+                    this.buffer.push(event);
+                    // Flush if batch size reached
+                    if (this.buffer.length >= this.batchSize) {
+                        this.flush();
+                    }
+                }
+            }
+            resultCallback({ code: ExportResultCode.SUCCESS });
+        }
+        catch (error) {
+            console.error('Error exporting spans to Metrx:', error);
+            resultCallback({ code: ExportResultCode.FAILED });
+        }
+    }
+    /**
+     * Shutdown exporter and flush remaining spans
+     */
+    async shutdown() {
+        this.isShuttingDown = true;
+        // Clear flush timer
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+        }
+        // Flush remaining spans
+        if (this.buffer.length > 0) {
+            await this.flushAsync();
+        }
+    }
+    /**
+     * Force flush buffered spans immediately
+     */
+    async forceFlush(_timeoutMs) {
+        if (this.buffer.length > 0) {
+            await this.flushAsync();
+        }
+    }
+    /**
+     * Convert an OpenTelemetry span to an LLM event
+     */
+    spanToLLMEvent(span) {
+        // Check if this is an LLM-related span
+        if (!this.isLLMSpan(span)) {
+            return null;
+        }
+        const attributes = span.attributes || {};
+        const spanContext = span.spanContext();
+        // Extract model - check multiple conventions
+        const model = attributes['llm.model'] || attributes['gen_ai.request.model'] || 'unknown';
+        // Extract provider - check multiple conventions
+        const provider = attributes['llm.provider'] || attributes['gen_ai.system'];
+        // Extract token counts - check multiple conventions
+        const inputTokens = attributes['llm.usage.prompt_tokens'] || attributes['gen_ai.usage.input_tokens'];
+        const outputTokens = attributes['llm.usage.completion_tokens'] || attributes['gen_ai.usage.output_tokens'];
+        // Extract cost if available
+        const costMicrocents = attributes['llm.cost'];
+        // Calculate latency in milliseconds
+        const latencyMs = this.calculateLatencyMs(span);
+        // Build event
+        const event = {
+            model,
+            latency_ms: latencyMs,
+            timestamp: new Date().toISOString(),
+            span_name: span.name,
+            trace_id: spanContext.traceId,
+            span_id: spanContext.spanId,
+        };
+        // Add optional fields
+        if (this.agentId) {
+            event.agent_id = this.agentId;
+        }
+        if (provider) {
+            event.provider = provider;
+        }
+        if (typeof inputTokens === 'number') {
+            event.input_tokens = inputTokens;
+        }
+        if (typeof outputTokens === 'number') {
+            event.output_tokens = outputTokens;
+        }
+        if (typeof costMicrocents === 'number') {
+            event.cost_microcents = costMicrocents;
+        }
+        return event;
+    }
+    /**
+     * Check if a span is LLM-related
+     */
+    isLLMSpan(span) {
+        const spanName = span.name.toLowerCase();
+        const attributes = span.attributes || {};
+        // Check span name for LLM keywords
+        const llmKeywords = ['chat', 'completion', 'embedding', 'llm'];
+        if (llmKeywords.some((keyword) => spanName.includes(keyword))) {
+            return true;
+        }
+        // Check for OpenTelemetry semantic conventions
+        if (attributes['gen_ai.system']) {
+            return true;
+        }
+        // Check for other LLM-related attributes
+        if (attributes['llm.model'] ||
+            attributes['llm.provider'] ||
+            attributes['gen_ai.request.model']) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Calculate latency in milliseconds from span timing
+     */
+    calculateLatencyMs(span) {
+        const startTime = span.startTime;
+        const endTime = span.endTime;
+        // Convert [seconds, nanoseconds] to milliseconds
+        const startMs = startTime[0] * 1000 + startTime[1] / 1000000;
+        const endMs = endTime[0] * 1000 + endTime[1] / 1000000;
+        return Math.round(endMs - startMs);
+    }
+    /**
+     * Start periodic flush timer
+     */
+    startFlushTimer() {
+        this.flushTimer = setInterval(() => {
+            if (this.buffer.length > 0) {
+                this.flush();
+            }
+        }, this.flushIntervalMs);
+        // Allow timer to not block process exit
+        if (this.flushTimer.unref) {
+            this.flushTimer.unref();
+        }
+    }
+    /**
+     * Flush buffered spans synchronously (best effort)
+     */
+    flush() {
+        if (this.buffer.length === 0) {
+            return;
+        }
+        const events = this.buffer.splice(0, this.batchSize);
+        // Fire and forget - don't block on network
+        this.sendEvents(events).catch((error) => {
+            console.error('Failed to send events to Metrx:', error);
+            // Re-add failed events to buffer for retry
+            this.buffer.unshift(...events);
+        });
+    }
+    /**
+     * Flush buffered spans asynchronously
+     */
+    async flushAsync() {
+        if (this.buffer.length === 0) {
+            return;
+        }
+        const events = this.buffer.splice(0, this.batchSize);
+        try {
+            await this.sendEvents(events);
+        }
+        catch (error) {
+            console.error('Failed to send events to Metrx:', error);
+            // Re-add failed events to buffer for retry
+            this.buffer.unshift(...events);
+            throw error;
+        }
+    }
+    /**
+     * Send events to Metrx API
+     */
+    async sendEvents(events) {
+        if (events.length === 0) {
+            return;
+        }
+        const url = `${this.gatewayUrl}/api/events/ingest`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({ events }),
+        });
+        if (!response.ok) {
+            let errorMessage = `HTTP ${response.status}`;
+            try {
+                const errorData = (await response.json());
+                if (errorData.error?.message) {
+                    errorMessage = errorData.error.message;
+                }
+            }
+            catch {
+                // Ignore JSON parse errors
+            }
+            throw new Error(`Failed to send events to Metrx: ${errorMessage}`);
+        }
+    }
+}
+//# sourceMappingURL=otel.js.map

package/dist/otel.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Metrx SDK Type Definitions
+ */
+export interface MetrxbotConfig {
+    /** Metrx API key for authentication */
+    apiKey: string;
+    /** Gateway URL (default: https://gateway.metrxbot.com) */
+    gatewayUrl?: string;
+    /** Default agent ID for all requests */
+    defaultAgentId?: string;
+    /** Default LLM provider (openai, anthropic, etc.) */
+    defaultProvider?: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+}
+export interface MetrxbotMeta {
+    /** Gateway response latency in milliseconds */
+    latencyMs: number;
+    /** Cost of the request in microcents */
+    costMicrocents: number;
+    /** X-Request-ID header from gateway */
+    requestId?: string;
+}
+export interface RequestOptions {
+    /** Override agent ID for this request */
+    agentId?: string;
+    /** Customer/end-user ID for tracking */
+    customerId?: string;
+    /** Session ID for tracking */
+    sessionId?: string;
+    /** Provider API key override */
+    providerKey?: string;
+    /** Force specific provider */
+    provider?: string;
+}
+export interface ChatCompletionParams extends RequestOptions {
+    model: string;
+    messages: ChatMessage[];
+    temperature?: number;
+    top_p?: number;
+    max_tokens?: number;
+    stop?: string | string[];
+    stream?: boolean;
+    [key: string]: unknown;
+}
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface ChatCompletionResponse {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: ChatChoice[];
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+    _meta: MetrxbotMeta;
+}
+export interface ChatChoice {
+    index: number;
+    message: ChatMessage;
+    finish_reason: string;
+    logprobs?: unknown;
+}
+export interface StreamChunk {
+    id?: string;
+    object?: string;
+    created?: number;
+    model?: string;
+    choices?: StreamChoice[];
+    _meta?: MetrxbotMeta;
+}
+export interface StreamChoice {
+    index: number;
+    delta: {
+        role?: string;
+        content?: string;
+    };
+    finish_reason?: string;
+}
+export interface MessagesParams extends RequestOptions {
+    model: string;
+    messages: AnthropicMessage[];
+    max_tokens: number;
+    system?: string;
+    temperature?: number;
+    top_p?: number;
+    [key: string]: unknown;
+}
+export interface AnthropicMessage {
+    role: 'user' | 'assistant';
+    content: string | AnthropicContent[];
+}
+export interface AnthropicContent {
+    type: 'text' | 'image';
+    text?: string;
+    source?: {
+        type: 'base64' | 'url';
+        media_type?: string;
+        data?: string;
+        url?: string;
+    };
+}
+export interface MessagesResponse {
+    id: string;
+    type: string;
+    role: string;
+    content: MessageContent[];
+    model: string;
+    stop_reason: string;
+    stop_sequence?: string;
+    usage?: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+    _meta: MetrxbotMeta;
+}
+export interface MessageContent {
+    type: 'text';
+    text: string;
+}
+export interface EmbeddingsParams extends RequestOptions {
+    model: string;
+    input: string | string[];
+    encoding_format?: 'float' | 'base64';
+}
+export interface EmbeddingsResponse {
+    object: string;
+    data: Embedding[];
+    model: string;
+    usage: {
+        prompt_tokens: number;
+        total_tokens: number;
+    };
+    _meta: MetrxbotMeta;
+}
+export interface Embedding {
+    object: string;
+    embedding: number[];
+    index: number;
+}
+export interface HealthResponse {
+    status: 'ok' | 'degraded' | 'error';
+    timestamp: string;
+    version: string;
+}
+export interface ModelsResponse {
+    object: 'list';
+    data: Model[];
+}
+export interface Model {
+    id: string;
+    object: 'model';
+    owned_by: string;
+    permission?: unknown[];
+}
+export interface APIError {
+    message: string;
+    type: string;
+    param?: string;
+    code?: string;
+}
+export interface OtelExporterConfig {
+    /** Metrx API key for authentication */
+    apiKey: string;
+    /** Gateway URL (default: https://gateway.metrxbot.com) */
+    gatewayUrl?: string;
+    /** Agent ID for tracking LLM calls */
+    agentId?: string;
+    /** Batch size before forcing export (default: 50) */
+    batchSize?: number;
+    /** Flush interval in milliseconds (default: 5000) */
+    flushIntervalMs?: number;
+}
+//# 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,5 @@
+/**
+ * Metrx SDK Type Definitions
+ */
+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;;GAEG"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@metrxbot/sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for integrating with Metrx gateway",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "metrx",
+    "llm",
+    "sdk",
+    "openai",
+    "anthropic"
+  ],
+  "author": "Metrx",
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}