agensights 0.3.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,257 @@
+# AgenSights TypeScript SDK
+
+TypeScript SDK for [AgenSights](https://github.com/agensights/agensights-js) - AI Agent Observability.
+
+Track LLM calls, tool invocations, and multi-step agent executions with zero-friction auto-instrumentation or manual tracking.
+
+## Installation
+
+```bash
+npm install agensights
+```
+
+## Quick Start — Auto-Instrumentation (Recommended)
+
+Wrap your OpenAI client and every call is tracked automatically. Zero manual work.
+
+```typescript
+import OpenAI from "openai";
+import { instrumentOpenAI } from "agensights";
+
+const openai = instrumentOpenAI(
+  new OpenAI({ apiKey: "sk-xxx" }),
+  {
+    agensightsApiKey: "sk-prod-xxx",
+    agentName: "support_bot",          // optional — tags all events
+  }
+);
+
+// This call is now automatically tracked (model, tokens, latency, errors)
+const response = await openai.chat.completions.create({
+  model: "gpt-4o",
+  messages: [{ role: "user", content: "Hello!" }],
+});
+
+// Flush on shutdown
+await (openai as any)._agensights.close();
+```
+
+### Environment Variables
+
+You can configure the SDK via environment variables instead of passing options:
+
+```bash
+export AGENSIGHTS_BASE_URL="https://api.agensights.dev/api/v1"
+```
+
+The SDK reads `AGENSIGHTS_BASE_URL` at startup. If set, it is used as the default base URL for all clients.
+
+### What Gets Captured Automatically
+
+| Field | Source |
+|-------|--------|
+| `model` | Response `model` (falls back to request `model`) |
+| `inputTokens` | `response.usage.prompt_tokens` |
+| `outputTokens` | `response.usage.completion_tokens` |
+| `latencyMs` | Wall-clock time around the API call |
+| `status` | `"success"` or `"error"` |
+| `errorCode` | HTTP status code or error name on failure |
+| `provider` | `"openai"` |
+| `agentName` | From `InstrumentOptions.agentName` |
+
+### Using an Existing AgenSights Client
+
+If you already have an `AgenSights` instance, pass it directly instead of an API key:
+
+```typescript
+import { AgenSights, instrumentOpenAI } from "agensights";
+import OpenAI from "openai";
+
+const as = new AgenSights({ apiKey: "sk-prod-xxx" });
+const openai = instrumentOpenAI(new OpenAI({ apiKey: "sk-xxx" }), {
+  agensightsClient: as,
+  agentName: "support_bot",
+});
+
+// ... use openai as normal ...
+
+await as.close();
+```
+
+## Manual Tracking
+
+For non-OpenAI providers or when you need full control:
+
+```typescript
+import { AgenSights } from "agensights";
+
+const client = new AgenSights({ apiKey: "sk-prod-xxx" });
+
+// Track a single LLM call
+client.trackLLM({
+  model: "gpt-4o",
+  inputTokens: 100,
+  outputTokens: 50,
+  latencyMs: 300,
+});
+
+// Track a tool call
+client.trackTool({
+  toolName: "web_search",
+  latencyMs: 150,
+});
+
+// Flush and close when done
+await client.close();
+```
+
+## Tracing
+
+Group related LLM and tool calls under a single trace:
+
+```typescript
+const trace = client.startTrace("support_agent", "workflow-123");
+
+trace.llmCall({
+  model: "gpt-4o",
+  inputTokens: 100,
+  outputTokens: 50,
+  latencyMs: 300,
+});
+
+trace.toolCall({ toolName: "web_search", latencyMs: 150 });
+trace.toolCall({ toolName: "db_lookup", latencyMs: 80 });
+
+await trace.end();
+```
+
+All events within a trace share the same `traceId`, making it easy to view the full execution flow in the AgenSights dashboard.
+
+## Agent Hierarchy
+
+Track multi-agent workflows with parent-child spans:
+
+```typescript
+const trace = client.startTrace("pipeline", "wf-001");
+
+const orchestrator = trace.agent("orchestrator");
+
+// Sub-agents with automatic parent linking
+const researcher = orchestrator.agent("researcher");
+researcher.toolCall({ name: "web_search", latencyMs: 200 });
+researcher.llmCall({ model: "gpt-4o", inputTokens: 100, outputTokens: 50, latencyMs: 300 });
+
+const writer = orchestrator.agent("writer");
+writer.llmCall({
+  model: "claude-3-5-sonnet",
+  inputTokens: 200,
+  outputTokens: 100,
+  latencyMs: 400,
+  provider: "anthropic",
+});
+
+await trace.end();
+```
+
+This produces a full trace tree in the dashboard:
+
+```
+pipeline (trace)
+  └── orchestrator (agent)
+        ├── researcher (agent)
+        │     ├── web_search (tool)
+        │     └── gpt-4o (llm)
+        └── writer (agent)
+              └── claude-3-5-sonnet (llm)
+```
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `AGENSIGHTS_BASE_URL` | Backend API base URL (default: `https://api.agensights.com/api/v1`) |
+
+### Client Options
+
+```typescript
+const client = new AgenSights({
+  apiKey: "sk-prod-xxx",                          // Required
+  baseUrl: "https://api.agensights.dev/api/v1",   // Or set AGENSIGHTS_BASE_URL env var
+  flushInterval: 5000,                             // Auto-flush every 5s (default)
+  flushSize: 100,                                  // Auto-flush at 100 events (default)
+});
+```
+
+## API Reference
+
+### `instrumentOpenAI(openaiClient, options)`
+
+Monkey-patches `chat.completions.create` to automatically track every call. Returns the same client object.
+
+| Option | Type | Required | Description |
+|--------|------|----------|-------------|
+| `agensightsApiKey` | string | * | API key for AgenSights (creates a new client) |
+| `agensightsClient` | AgenSights | * | Existing AgenSights client instance |
+| `agentName` | string | no | Tag all events with this agent name |
+| `baseUrl` | string | no | Override AgenSights API base URL |
+
+\* Provide either `agensightsApiKey` or `agensightsClient`.
+
+### `client.trackLLM(params)`
+
+Track an LLM call.
+
+| Parameter     | Type     | Required | Default     |
+|---------------|----------|----------|-------------|
+| `model`       | string   | yes      |             |
+| `inputTokens` | number  | yes      |             |
+| `outputTokens`| number  | yes      |             |
+| `latencyMs`   | number  | yes      |             |
+| `status`      | string   | no       | `"success"` |
+| `provider`    | string   | no       | `null`      |
+| `errorCode`   | string   | no       | `null`      |
+| `traceId`     | string   | no       | auto        |
+| `agentName`   | string   | no       | `null`      |
+
+### `client.trackTool(params)`
+
+Track a tool call.
+
+| Parameter   | Type     | Required | Default     |
+|-------------|----------|----------|-------------|
+| `toolName`  | string   | yes      |             |
+| `latencyMs` | number   | yes      |             |
+| `status`    | string   | no       | `"success"` |
+| `traceId`   | string   | no       | auto        |
+| `agentName` | string   | no       | `null`      |
+
+### `client.startTrace(agentName, workflowId?)`
+
+Returns a `Trace` instance. All calls made through the trace share the same `traceId`.
+
+- `trace.llmCall(params)` — record an LLM call within the trace
+- `trace.toolCall(params)` — record a tool call within the trace
+- `trace.agent(name)` — create an `AgentSpan` for hierarchy tracking
+- `trace.end()` — flush all trace events
+
+### `AgentSpan`
+
+Created via `trace.agent(name)` or `agent.agent(name)` for nesting.
+
+- `agent.llmCall(params)` — LLM call as child of this agent
+- `agent.toolCall(params)` — tool call as child of this agent
+- `agent.agent(name)` — create a sub-agent
+
+### `client.flush()`
+
+Manually flush buffered events to the backend.
+
+### `client.close()`
+
+Flush remaining events and stop the background flush timer.
+
+## License
+
+MIT - see [LICENSE](LICENSE) for details.

package/dist/client.d.ts

@@ -0,0 +1,23 @@
+import { Trace } from "./trace";
+import type { AgenSightsEvent, AgenSightsOptions, TrackLLMParams, TrackToolParams } from "./types";
+export declare class AgenSights {
+    private apiKey;
+    private baseUrl;
+    private flushInterval;
+    private flushSize;
+    private buffer;
+    private timer;
+    private closed;
+    constructor(options: AgenSightsOptions);
+    trackLLM(params: TrackLLMParams): void;
+    trackTool(params: TrackToolParams): void;
+    startTrace(agentName: string, workflowId?: string): Trace;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+    /** Exposed for testing - returns a copy of the current buffer */
+    _getBuffer(): AgenSightsEvent[];
+    /** @internal Add a raw event to the buffer. Used by AgentSpan for hierarchy tracking. */
+    _addEvent(event: AgenSightsEvent): void;
+    private enqueue;
+}
+//# 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,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,eAAe,EAChB,MAAM,SAAS,CAAC;AAQjB,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,iBAAiB;IAkBtC,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IA2BtC,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IA2BxC,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK;IAInD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,iEAAiE;IACjE,UAAU,IAAI,eAAe,EAAE;IAI/B,yFAAyF;IACzF,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAIvC,OAAO,CAAC,OAAO;CAMhB"}

package/dist/client.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgenSights = void 0;
+const trace_1 = require("./trace");
+const DEFAULT_BASE_URL = (typeof process !== "undefined" && process.env?.AGENSIGHTS_BASE_URL) ||
+    "https://api.agensights.com/api/v1";
+const DEFAULT_FLUSH_INTERVAL = 5000;
+const DEFAULT_FLUSH_SIZE = 100;
+class AgenSights {
+    constructor(options) {
+        this.buffer = [];
+        this.timer = null;
+        this.closed = false;
+        this.apiKey = options.apiKey;
+        this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.flushInterval = options.flushInterval ?? DEFAULT_FLUSH_INTERVAL;
+        this.flushSize = options.flushSize ?? DEFAULT_FLUSH_SIZE;
+        this.timer = setInterval(() => {
+            if (this.buffer.length > 0) {
+                this.flush().catch(() => { });
+            }
+        }, this.flushInterval);
+        // Allow the Node process to exit even if the timer is still running
+        if (this.timer && typeof this.timer === "object" && "unref" in this.timer) {
+            this.timer.unref();
+        }
+    }
+    trackLLM(params) {
+        if (this.closed)
+            return;
+        const event = {
+            timestamp: new Date().toISOString(),
+            trace_id: params.traceId ?? generateId(),
+            span_id: generateId(),
+            parent_span_id: null,
+            type: "llm",
+            model: params.model,
+            provider: params.provider ?? null,
+            input_tokens: params.inputTokens,
+            output_tokens: params.outputTokens,
+            latency_ms: params.latencyMs,
+            status: params.status ?? "success",
+            error_code: params.errorCode ?? null,
+            metadata: {
+                agent_name: params.agentName ?? null,
+                workflow_id: null,
+                tool_name: null,
+            },
+            endpoint: null,
+        };
+        this.enqueue(event);
+    }
+    trackTool(params) {
+        if (this.closed)
+            return;
+        const event = {
+            timestamp: new Date().toISOString(),
+            trace_id: params.traceId ?? generateId(),
+            span_id: generateId(),
+            parent_span_id: null,
+            type: "tool",
+            model: null,
+            provider: null,
+            input_tokens: 0,
+            output_tokens: 0,
+            latency_ms: params.latencyMs,
+            status: params.status ?? "success",
+            error_code: null,
+            metadata: {
+                agent_name: params.agentName ?? null,
+                workflow_id: null,
+                tool_name: params.toolName,
+            },
+            endpoint: null,
+        };
+        this.enqueue(event);
+    }
+    startTrace(agentName, workflowId) {
+        return new trace_1.Trace(this, agentName, workflowId);
+    }
+    async flush() {
+        if (this.buffer.length === 0)
+            return;
+        const events = this.buffer.splice(0);
+        const url = `${this.baseUrl}/ingest/events`;
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "X-API-Key": this.apiKey,
+            },
+            body: JSON.stringify({ events }),
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => "");
+            throw new Error(`AgenSights flush failed (${response.status}): ${text}`);
+        }
+    }
+    async close() {
+        this.closed = true;
+        if (this.timer !== null) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        await this.flush();
+    }
+    /** Exposed for testing - returns a copy of the current buffer */
+    _getBuffer() {
+        return [...this.buffer];
+    }
+    /** @internal Add a raw event to the buffer. Used by AgentSpan for hierarchy tracking. */
+    _addEvent(event) {
+        this.enqueue(event);
+    }
+    enqueue(event) {
+        this.buffer.push(event);
+        if (this.buffer.length >= this.flushSize) {
+            this.flush().catch(() => { });
+        }
+    }
+}
+exports.AgenSights = AgenSights;
+function generateId() {
+    const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
+    let result = "";
+    for (let i = 0; i < 16; i++) {
+        result += chars.charAt(Math.floor(Math.random() * chars.length));
+    }
+    return result;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;AAAA,mCAAgC;AAQhC,MAAM,gBAAgB,GACpB,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,mBAAmB,CAAC;IACpE,mCAAmC,CAAC;AACtC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AACpC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,MAAa,UAAU;IASrB,YAAY,OAA0B;QAJ9B,WAAM,GAAsB,EAAE,CAAC;QAC/B,UAAK,GAA0C,IAAI,CAAC;QACpD,WAAM,GAAG,KAAK,CAAC;QAGrB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,sBAAsB,CAAC;QACrE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC;QAEzD,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC5B,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAEvB,oEAAoE;QACpE,IAAI,IAAI,CAAC,KAAK,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACzE,IAAI,CAAC,KAAwB,CAAC,KAAK,EAAE,CAAC;QACzC,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,MAAsB;QAC7B,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QAExB,MAAM,KAAK,GAAoB;YAC7B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ,EAAE,MAAM,CAAC,OAAO,IAAI,UAAU,EAAE;YACxC,OAAO,EAAE,UAAU,EAAE;YACrB,cAAc,EAAE,IAAI;YACpB,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,IAAI;YACjC,YAAY,EAAE,MAAM,CAAC,WAAW;YAChC,aAAa,EAAE,MAAM,CAAC,YAAY;YAClC,UAAU,EAAE,MAAM,CAAC,SAAS;YAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,SAAS;YAClC,UAAU,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI;YACpC,QAAQ,EAAE;gBACR,UAAU,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI;gBACpC,WAAW,EAAE,IAAI;gBACjB,SAAS,EAAE,IAAI;aAChB;YACD,QAAQ,EAAE,IAAI;SACf,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,SAAS,CAAC,MAAuB;QAC/B,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QAExB,MAAM,KAAK,GAAoB;YAC7B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ,EAAE,MAAM,CAAC,OAAO,IAAI,UAAU,EAAE;YACxC,OAAO,EAAE,UAAU,EAAE;YACrB,cAAc,EAAE,IAAI;YACpB,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,aAAa,EAAE,CAAC;YAChB,UAAU,EAAE,MAAM,CAAC,SAAS;YAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,SAAS;YAClC,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE;gBACR,UAAU,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI;gBACpC,WAAW,EAAE,IAAI;gBACjB,SAAS,EAAE,MAAM,CAAC,QAAQ;aAC3B;YACD,QAAQ,EAAE,IAAI;SACf,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,UAAU,CAAC,SAAiB,EAAE,UAAmB;QAC/C,OAAO,IAAI,aAAK,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAErC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,gBAAgB,CAAC;QAE5C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,WAAW,EAAE,IAAI,CAAC,MAAM;aACzB;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;SACjC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,4BAA4B,QAAQ,CAAC,MAAM,MAAM,IAAI,EAAE,CACxD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxB,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,iEAAiE;IACjE,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,yFAAyF;IACzF,SAAS,CAAC,KAAsB;QAC9B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAEO,OAAO,CAAC,KAAsB;QACpC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACzC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;CACF;AArID,gCAqIC;AAED,SAAS,UAAU;IACjB,MAAM,KAAK,GAAG,sCAAsC,CAAC;IACrD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { AgenSights } from "./client";
+export { AgentSpan, Trace } from "./trace";
+export { instrumentOpenAI } from "./instrument";
+export type { AgenSightsEvent, AgenSightsOptions, EventMetadata, TrackLLMParams, TrackToolParams, } from "./types";
+export type { InstrumentOptions } from "./instrument";
+//# 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,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instrumentOpenAI = exports.Trace = exports.AgentSpan = exports.AgenSights = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "AgenSights", { enumerable: true, get: function () { return client_1.AgenSights; } });
+var trace_1 = require("./trace");
+Object.defineProperty(exports, "AgentSpan", { enumerable: true, get: function () { return trace_1.AgentSpan; } });
+Object.defineProperty(exports, "Trace", { enumerable: true, get: function () { return trace_1.Trace; } });
+var instrument_1 = require("./instrument");
+Object.defineProperty(exports, "instrumentOpenAI", { enumerable: true, get: function () { return instrument_1.instrumentOpenAI; } });
+//# 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,mCAAsC;AAA7B,oGAAA,UAAU,OAAA;AACnB,iCAA2C;AAAlC,kGAAA,SAAS,OAAA;AAAE,8FAAA,KAAK,OAAA;AACzB,2CAAgD;AAAvC,8GAAA,gBAAgB,OAAA"}

package/dist/instrument.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Auto-instrumentation for LLM clients. Zero manual tracking needed.
+ *
+ * Usage:
+ *   import { instrumentOpenAI } from "agensights";
+ *   import OpenAI from "openai";
+ *
+ *   const client = instrumentOpenAI(
+ *     new OpenAI({ apiKey: "sk-xxx" }),
+ *     { agensightsApiKey: "sk-dev-xxx" }
+ *   );
+ *   // All calls now automatically tracked
+ *   await client.chat.completions.create({ model: "gpt-4o", messages: [...] });
+ */
+import { AgenSights } from "./client";
+export interface InstrumentOptions {
+    agensightsApiKey?: string;
+    agensightsClient?: AgenSights;
+    agentName?: string;
+    baseUrl?: string;
+}
+export declare function instrumentOpenAI<T extends {
+    chat: {
+        completions: {
+            create: Function;
+        };
+    };
+}>(openaiClient: T, options: InstrumentOptions): T;
+//# sourceMappingURL=instrument.d.ts.map

package/dist/instrument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrument.d.ts","sourceRoot":"","sources":["../src/instrument.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,UAAU,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE;QAAE,WAAW,EAAE;YAAE,MAAM,EAAE,QAAQ,CAAA;SAAE,CAAA;KAAE,CAAA;CAAE,EACxF,YAAY,EAAE,CAAC,EACf,OAAO,EAAE,iBAAiB,GACzB,CAAC,CAgDH"}

package/dist/instrument.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * Auto-instrumentation for LLM clients. Zero manual tracking needed.
+ *
+ * Usage:
+ *   import { instrumentOpenAI } from "agensights";
+ *   import OpenAI from "openai";
+ *
+ *   const client = instrumentOpenAI(
+ *     new OpenAI({ apiKey: "sk-xxx" }),
+ *     { agensightsApiKey: "sk-dev-xxx" }
+ *   );
+ *   // All calls now automatically tracked
+ *   await client.chat.completions.create({ model: "gpt-4o", messages: [...] });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instrumentOpenAI = instrumentOpenAI;
+const client_1 = require("./client");
+function instrumentOpenAI(openaiClient, options) {
+    const asClient = options.agensightsClient || new client_1.AgenSights({
+        apiKey: options.agensightsApiKey,
+        baseUrl: options.baseUrl,
+    });
+    const originalCreate = openaiClient.chat.completions.create.bind(openaiClient.chat.completions);
+    openaiClient.chat.completions.create = async function (...args) {
+        const kwargs = args[0] || {};
+        const model = kwargs.model || "unknown";
+        const start = Date.now();
+        try {
+            const response = await originalCreate(...args);
+            const latencyMs = Date.now() - start;
+            const usage = response?.usage || {};
+            asClient.trackLLM({
+                model: response?.model || model,
+                inputTokens: usage.prompt_tokens || 0,
+                outputTokens: usage.completion_tokens || 0,
+                latencyMs,
+                status: "success",
+                provider: "openai",
+                agentName: options.agentName,
+            });
+            return response;
+        }
+        catch (error) {
+            const latencyMs = Date.now() - start;
+            asClient.trackLLM({
+                model,
+                inputTokens: 0,
+                outputTokens: 0,
+                latencyMs,
+                status: "error",
+                errorCode: String(error?.status || error?.name || "unknown"),
+                provider: "openai",
+                agentName: options.agentName,
+            });
+            throw error;
+        }
+    };
+    // Store reference for cleanup
+    openaiClient._agensights = asClient;
+    return openaiClient;
+}
+//# sourceMappingURL=instrument.js.map

package/dist/instrument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrument.js","sourceRoot":"","sources":["../src/instrument.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;AAYH,4CAmDC;AA7DD,qCAAsC;AAUtC,SAAgB,gBAAgB,CAC9B,YAAe,EACf,OAA0B;IAE1B,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,IAAI,IAAI,mBAAU,CAAC;QAC1D,MAAM,EAAE,OAAO,CAAC,gBAAiB;QACjC,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAEhG,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,KAAK,WAAU,GAAG,IAAW;QAClE,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,SAAS,CAAC;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEzB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,GAAG,IAAI,CAAC,CAAC;YAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YACrC,MAAM,KAAK,GAAG,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC;YAEpC,QAAQ,CAAC,QAAQ,CAAC;gBAChB,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,KAAK;gBAC/B,WAAW,EAAE,KAAK,CAAC,aAAa,IAAI,CAAC;gBACrC,YAAY,EAAE,KAAK,CAAC,iBAAiB,IAAI,CAAC;gBAC1C,SAAS;gBACT,MAAM,EAAE,SAAS;gBACjB,QAAQ,EAAE,QAAQ;gBAClB,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B,CAAC,CAAC;YAEH,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YACrC,QAAQ,CAAC,QAAQ,CAAC;gBAChB,KAAK;gBACL,WAAW,EAAE,CAAC;gBACd,YAAY,EAAE,CAAC;gBACf,SAAS;gBACT,MAAM,EAAE,OAAO;gBACf,SAAS,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,EAAE,IAAI,IAAI,SAAS,CAAC;gBAC5D,QAAQ,EAAE,QAAQ;gBAClB,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAQ,CAAC;IAET,8BAA8B;IAC7B,YAAoB,CAAC,WAAW,GAAG,QAAQ,CAAC;IAC7C,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/trace.d.ts

@@ -0,0 +1,52 @@
+import type { AgenSights } from "./client";
+export declare class AgentSpan {
+    readonly spanId: string;
+    readonly name: string;
+    private trace;
+    private parentSpanId;
+    constructor(trace: Trace, name: string, parentSpanId?: string | null);
+    /** Create a sub-agent (child span of this agent). */
+    agent(name: string): AgentSpan;
+    /** Record an LLM call as a child of this agent. */
+    llmCall(params: {
+        model: string;
+        inputTokens: number;
+        outputTokens: number;
+        latencyMs: number;
+        status?: "success" | "error";
+        provider?: string;
+        errorCode?: string;
+    }): string;
+    /** Record a tool call as a child of this agent. */
+    toolCall(params: {
+        name: string;
+        latencyMs: number;
+        status?: "success" | "error";
+        errorCode?: string;
+    }): string;
+}
+export declare class Trace {
+    readonly traceId: string;
+    private client;
+    private agentName;
+    private workflowId;
+    constructor(client: AgenSights, agentName: string, workflowId?: string);
+    /** Create a root-level agent span in this trace. */
+    agent(name: string): AgentSpan;
+    llmCall(params: {
+        model: string;
+        inputTokens: number;
+        outputTokens: number;
+        latencyMs: number;
+        status?: "success" | "error";
+        provider?: string;
+        errorCode?: string;
+    }): void;
+    toolCall(params: {
+        toolName: string;
+        latencyMs: number;
+        status?: "success" | "error";
+    }): void;
+    end(): Promise<void>;
+}
+//# sourceMappingURL=trace.d.ts.map

package/dist/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C,qBAAa,SAAS;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,YAAY,CAAgB;gBAExB,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,GAAE,MAAM,GAAG,IAAW;IA8B1E,qDAAqD;IACrD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;IAI9B,mDAAmD;IACnD,OAAO,CAAC,MAAM,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;QAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,MAAM;IA0BV,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE;QACf,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;QAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,MAAM;CAyBX;AAED,qBAAa,KAAK;IAChB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAgB;gBAEtB,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAOtE,oDAAoD;IACpD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;IAI9B,OAAO,CAAC,MAAM,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;QAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI;IAcR,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;KAC9B,GAAG,IAAI;IAUF,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAG3B"}

package/dist/trace.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Trace = exports.AgentSpan = void 0;
+class AgentSpan {
+    constructor(trace, name, parentSpanId = null) {
+        this.spanId = generateId();
+        this.name = name;
+        this.trace = trace;
+        this.parentSpanId = parentSpanId;
+        // Record agent span event
+        const event = {
+            timestamp: new Date().toISOString(),
+            trace_id: trace.traceId,
+            span_id: this.spanId,
+            parent_span_id: parentSpanId,
+            type: "agent",
+            model: null,
+            provider: null,
+            input_tokens: 0,
+            output_tokens: 0,
+            latency_ms: 0,
+            status: "success",
+            error_code: null,
+            metadata: {
+                agent_name: name,
+                workflow_id: trace["workflowId"],
+                tool_name: null,
+            },
+            endpoint: null,
+        };
+        trace["client"]._addEvent(event);
+    }
+    /** Create a sub-agent (child span of this agent). */
+    agent(name) {
+        return new AgentSpan(this.trace, name, this.spanId);
+    }
+    /** Record an LLM call as a child of this agent. */
+    llmCall(params) {
+        const spanId = generateId();
+        const event = {
+            timestamp: new Date().toISOString(),
+            trace_id: this.trace.traceId,
+            span_id: spanId,
+            parent_span_id: this.spanId,
+            type: "llm",
+            model: params.model,
+            provider: params.provider ?? null,
+            input_tokens: params.inputTokens,
+            output_tokens: params.outputTokens,
+            latency_ms: params.latencyMs,
+            status: params.status ?? "success",
+            error_code: params.errorCode ?? null,
+            metadata: {
+                agent_name: this.name,
+                workflow_id: this.trace["workflowId"],
+                tool_name: null,
+            },
+            endpoint: null,
+        };
+        this.trace["client"]._addEvent(event);
+        return spanId;
+    }
+    /** Record a tool call as a child of this agent. */
+    toolCall(params) {
+        const spanId = generateId();
+        const event = {
+            timestamp: new Date().toISOString(),
+            trace_id: this.trace.traceId,
+            span_id: spanId,
+            parent_span_id: this.spanId,
+            type: "tool",
+            model: null,
+            provider: null,
+            input_tokens: 0,
+            output_tokens: 0,
+            latency_ms: params.latencyMs,
+            status: params.status ?? "success",
+            error_code: params.errorCode ?? null,
+            metadata: {
+                agent_name: this.name,
+                workflow_id: this.trace["workflowId"],
+                tool_name: params.name,
+            },
+            endpoint: null,
+        };
+        this.trace["client"]._addEvent(event);
+        return spanId;
+    }
+}
+exports.AgentSpan = AgentSpan;
+class Trace {
+    constructor(client, agentName, workflowId) {
+        this.client = client;
+        this.traceId = generateId();
+        this.agentName = agentName;
+        this.workflowId = workflowId ?? null;
+    }
+    /** Create a root-level agent span in this trace. */
+    agent(name) {
+        return new AgentSpan(this, name, null);
+    }
+    llmCall(params) {
+        this.client.trackLLM({
+            model: params.model,
+            inputTokens: params.inputTokens,
+            outputTokens: params.outputTokens,
+            latencyMs: params.latencyMs,
+            status: params.status,
+            provider: params.provider,
+            errorCode: params.errorCode,
+            traceId: this.traceId,
+            agentName: this.agentName,
+        });
+    }
+    toolCall(params) {
+        this.client.trackTool({
+            toolName: params.toolName,
+            latencyMs: params.latencyMs,
+            status: params.status,
+            traceId: this.traceId,
+            agentName: this.agentName,
+        });
+    }
+    async end() {
+        await this.client.flush();
+    }
+}
+exports.Trace = Trace;
+function generateId() {
+    const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
+    let result = "";
+    for (let i = 0; i < 16; i++) {
+        result += chars.charAt(Math.floor(Math.random() * chars.length));
+    }
+    return result;
+}
+//# sourceMappingURL=trace.js.map

package/dist/trace.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,46 @@
+export interface EventMetadata {
+    agent_name: string | null;
+    workflow_id: string | null;
+    tool_name: string | null;
+}
+export interface AgenSightsEvent {
+    timestamp: string;
+    trace_id: string;
+    span_id: string;
+    parent_span_id: string | null;
+    type: "llm" | "tool" | "system" | "agent";
+    model: string | null;
+    provider: string | null;
+    input_tokens: number;
+    output_tokens: number;
+    latency_ms: number;
+    status: "success" | "error";
+    error_code: string | null;
+    metadata: EventMetadata;
+    endpoint: string | null;
+}
+export interface TrackLLMParams {
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    latencyMs: number;
+    status?: "success" | "error";
+    provider?: string;
+    errorCode?: string;
+    traceId?: string;
+    agentName?: string;
+}
+export interface TrackToolParams {
+    toolName: string;
+    latencyMs: number;
+    status?: "success" | "error";
+    traceId?: string;
+    agentName?: string;
+}
+export interface AgenSightsOptions {
+    apiKey: string;
+    baseUrl?: string;
+    flushInterval?: number;
+    flushSize?: 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":"AAAA,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC1C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "agensights",
+  "version": "0.3.0",
+  "description": "AgenSights SDK - AI Agent Observability. Zero-friction tracking for LLM calls, agents, and tools.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "llm",
+    "observability",
+    "ai-agents",
+    "monitoring",
+    "tracing",
+    "openai",
+    "anthropic",
+    "analytics"
+  ],
+  "author": "AgenSights <support@agensights.dev>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agensights/agensights-js"
+  },
+  "homepage": "https://docs.agensights.dev",
+  "bugs": {
+    "url": "https://github.com/agensights/agensights-js/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.39",
+    "typescript": "^5.0.0",
+    "vitest": "^2.0.0"
+  }
+}