opsveritas-sdk 0.3.0 → 0.3.2

package/README.md

@@ -1,79 +1,79 @@
-# opsveritas-sdk
-
-Monitor your AI agents in **three lines of code**. Tracks tokens, cost, latency, model, and silent failures (200 OK with empty output) — and routes alerts to Slack / Email / Teams via [OpsVeritas AI Agents Control Tower](https://agents.opsveritas.com).
-
-```bash
-npm install opsveritas-sdk
-```
-
-## Quick start (3 lines)
-
-```ts
-import { OpsVeritas } from 'opsveritas-sdk';
-
-OpsVeritas.init('<your-ingest-key>');                 // key from Settings → Integrations
-const client = OpsVeritas.wrap(new OpenAI(), { agentName: 'Support Bot' });
-// use `client` exactly as before — runs appear in your dashboard automatically
-```
-
-Works the same for Anthropic and Gemini clients. Prefer manual control? Wrap a function:
-
-```ts
-await OpsVeritas.trace('Nightly Report', async () => runReport());
-```
-
-## LangChain (one line)
-
-Attach the handler to any LangChain chat model, LLM or chain — every call reports token / cost / latency / silent-failure automatically:
-
-```ts
-import { ChatOpenAI } from '@langchain/openai';
-import { OpsVeritas } from 'opsveritas-sdk';
-
-OpsVeritas.init('<your-ingest-key>');
-const model = new ChatOpenAI({ callbacks: [OpsVeritas.langchain('My Agent')] });
-```
-
-No extra dependency — it's a plain LangChain callback handler. Works with any LangChain-backed provider (OpenAI, Anthropic, Gemini, Groq…). Inside `OpsVeritas.run(...)` the handler aggregates into a single execution instead of double-counting.
-
-## What data is sent
-
-By design the SDK sends **metadata only, plus a short output snippet** — never your prompts/inputs:
-
-| Sent | Detail |
-|------|--------|
-| ✅ Metadata | agent name, status, timestamps, duration, token counts, model, cost, tool-call count |
-| ⚠️ Output snippet | first 300 chars of the response (`output_summary`) — powers silent-failure detection |
-| ⚠️ Error message | the exception text, if a call fails |
-| ❌ Prompts / inputs | **never sent** — only token counts |
-
-### Metadata-only mode (for regulated / client data)
-
-Drop the output snippet and redact error text so **no response content ever leaves your environment** — token/cost/latency metadata still flows:
-
-```ts
-OpsVeritas.init('<your-ingest-key>', { metadataOnly: true });
-```
-
-Or set the environment variable:
-
-```bash
-OPSVERITAS_METADATA_ONLY=true
-```
-
-## Reliability
-
-Telemetry is **non-blocking and fire-and-forget** — it never throws into your code and never slows your agent. If the ingest endpoint is briefly unreachable, sends are **retried with backoff** and **buffered in memory** (bounded), then flushed on the next event — so a transient outage doesn't lose telemetry.
-
-## Configuration
-
-```ts
-OpsVeritas.init(apiKey, {
-  endpoint,      // optional — defaults to https://agents.opsveritas.com
-  metadataOnly,  // optional — default false; when true, no response content is sent
-});
-```
-
-## License
-
-MIT
+# opsveritas-sdk
+
+Monitor your AI agents in **three lines of code**. Tracks tokens, cost, latency, model, and silent failures (200 OK with empty output) — and routes alerts to Slack / Email / Teams via [OpsVeritas AI Agents Control Tower](https://agents.opsveritas.com).
+
+```bash
+npm install opsveritas-sdk
+```
+
+## Quick start (3 lines)
+
+```ts
+import { OpsVeritas } from 'opsveritas-sdk';
+
+OpsVeritas.init('<your-ingest-key>');                 // key from Settings → Integrations
+const client = OpsVeritas.wrap(new OpenAI(), { agentName: 'Support Bot' });
+// use `client` exactly as before — runs appear in your dashboard automatically
+```
+
+Works the same for Anthropic and Gemini clients. Prefer manual control? Wrap a function:
+
+```ts
+await OpsVeritas.trace('Nightly Report', async () => runReport());
+```
+
+## LangChain (one line)
+
+Attach the handler to any LangChain chat model, LLM or chain — every call reports token / cost / latency / silent-failure automatically:
+
+```ts
+import { ChatOpenAI } from '@langchain/openai';
+import { OpsVeritas } from 'opsveritas-sdk';
+
+OpsVeritas.init('<your-ingest-key>');
+const model = new ChatOpenAI({ callbacks: [OpsVeritas.langchain('My Agent')] });
+```
+
+No extra dependency — it's a plain LangChain callback handler. Works with any LangChain-backed provider (OpenAI, Anthropic, Gemini, Groq…). Inside `OpsVeritas.run(...)` the handler aggregates into a single execution instead of double-counting.
+
+## What data is sent
+
+By design the SDK sends **metadata only, plus a short output snippet** — never your prompts/inputs:
+
+| Sent | Detail |
+|------|--------|
+| ✅ Metadata | agent name, status, timestamps, duration, token counts, model, cost, tool-call count |
+| ⚠️ Output snippet | first 300 chars of the response (`output_summary`) — powers silent-failure detection |
+| ⚠️ Error message | the exception text, if a call fails |
+| ❌ Prompts / inputs | **never sent** — only token counts |
+
+### Metadata-only mode (for regulated / client data)
+
+Drop the output snippet and redact error text so **no response content ever leaves your environment** — token/cost/latency metadata still flows:
+
+```ts
+OpsVeritas.init('<your-ingest-key>', { metadataOnly: true });
+```
+
+Or set the environment variable:
+
+```bash
+OPSVERITAS_METADATA_ONLY=true
+```
+
+## Reliability
+
+Telemetry is **non-blocking and fire-and-forget** — it never throws into your code and never slows your agent. If the ingest endpoint is briefly unreachable, sends are **retried with backoff** and **buffered in memory** (bounded), then flushed on the next event — so a transient outage doesn't lose telemetry.
+
+## Configuration
+
+```ts
+OpsVeritas.init(apiKey, {
+  endpoint,      // optional — defaults to https://agents.opsveritas.com
+  metadataOnly,  // optional — default false; when true, no response content is sent
+});
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -56,6 +56,8 @@ interface ExecutionPayload {
     error_message?: string | null;
     user_id?: string;
     output_summary?: string;
+    /** Set automatically by the SDK so the server can identify SDK vs raw-webhook ingestion. Not user-configurable. */
+    source?: 'sdk';
 }
 
 declare const OpsVeritas: {

package/dist/index.d.ts

@@ -56,6 +56,8 @@ interface ExecutionPayload {
     error_message?: string | null;
     user_id?: string;
     output_summary?: string;
+    /** Set automatically by the SDK so the server can identify SDK vs raw-webhook ingestion. Not user-configurable. */
+    source?: 'sdk';
 }
 
 declare const OpsVeritas: {

package/dist/index.js

@@ -117,7 +117,8 @@ async function sendExecution(payload) {
     return;
   }
   const { apiKey, endpoint, metadataOnly } = cfg;
-  const body = metadataOnly ? scrubForMetadataOnly(payload) : payload;
+  const base = metadataOnly ? scrubForMetadataOnly(payload) : payload;
+  const body = { ...base, source: "sdk" };
   void flush(endpoint, apiKey);
   const ok = await deliver(endpoint, apiKey, body);
   if (!ok) enqueue(body);
@@ -356,17 +357,18 @@ async function trace(agentName, fn, options) {
 
 // src/wrap.ts
 var PATCHED = /* @__PURE__ */ Symbol("opsveritas.patched");
+var OUTPUT_SUMMARY_MAX = 3e3;
 function extractOutput(resp) {
   if (!resp) return void 0;
   const choices = resp.choices;
   if (Array.isArray(choices) && choices[0]) {
     const content = choices[0].message?.content;
-    if (typeof content === "string" && content.trim()) return content.slice(0, 300);
+    if (typeof content === "string" && content.trim()) return content.slice(0, OUTPUT_SUMMARY_MAX);
   }
   const blocks = resp.content;
   if (Array.isArray(blocks)) {
     const tb = blocks.find((b) => b.type === "text");
-    if (typeof tb?.text === "string" && tb.text.trim()) return tb.text.slice(0, 300);
+    if (typeof tb?.text === "string" && tb.text.trim()) return tb.text.slice(0, OUTPUT_SUMMARY_MAX);
   }
   return void 0;
 }
@@ -575,7 +577,7 @@ function extractText(output) {
           const c = gen?.message?.content;
           if (typeof c === "string") t = c;
         }
-        if (typeof t === "string" && t.trim()) return t.slice(0, 300);
+        if (typeof t === "string" && t.trim()) return t.slice(0, 3e3);
       }
     }
   } catch {

package/dist/index.mjs

@@ -85,7 +85,8 @@ async function sendExecution(payload) {
     return;
   }
   const { apiKey, endpoint, metadataOnly } = cfg;
-  const body = metadataOnly ? scrubForMetadataOnly(payload) : payload;
+  const base = metadataOnly ? scrubForMetadataOnly(payload) : payload;
+  const body = { ...base, source: "sdk" };
   void flush(endpoint, apiKey);
   const ok = await deliver(endpoint, apiKey, body);
   if (!ok) enqueue(body);
@@ -324,17 +325,18 @@ async function trace(agentName, fn, options) {
 
 // src/wrap.ts
 var PATCHED = /* @__PURE__ */ Symbol("opsveritas.patched");
+var OUTPUT_SUMMARY_MAX = 3e3;
 function extractOutput(resp) {
   if (!resp) return void 0;
   const choices = resp.choices;
   if (Array.isArray(choices) && choices[0]) {
     const content = choices[0].message?.content;
-    if (typeof content === "string" && content.trim()) return content.slice(0, 300);
+    if (typeof content === "string" && content.trim()) return content.slice(0, OUTPUT_SUMMARY_MAX);
   }
   const blocks = resp.content;
   if (Array.isArray(blocks)) {
     const tb = blocks.find((b) => b.type === "text");
-    if (typeof tb?.text === "string" && tb.text.trim()) return tb.text.slice(0, 300);
+    if (typeof tb?.text === "string" && tb.text.trim()) return tb.text.slice(0, OUTPUT_SUMMARY_MAX);
   }
   return void 0;
 }
@@ -543,7 +545,7 @@ function extractText(output) {
           const c = gen?.message?.content;
           if (typeof c === "string") t = c;
         }
-        if (typeof t === "string" && t.trim()) return t.slice(0, 300);
+        if (typeof t === "string" && t.trim()) return t.slice(0, 3e3);
       }
     }
   } catch {

package/package.json

@@ -1,57 +1,57 @@
-{
-  "name": "opsveritas-sdk",
-  "version": "0.3.0",
-  "description": "Monitor your AI agents in 3 lines of code — tokens, cost, latency, and silent failures",
-  "main": "dist/index.js",
-  "module": "dist/index.mjs",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsup src/index.ts --format esm,cjs --dts --clean",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
-    "test": "jest"
-  },
-  "devDependencies": {
-    "@types/jest": "^29.5.12",
-    "@types/node": "^20.14.0",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.1.5",
-    "tsup": "^8.1.0",
-    "typescript": "^5.4.5"
-  },
-  "peerDependencies": {
-    "@anthropic-ai/sdk": ">=0.20.0",
-    "@langchain/core": ">=0.2.0",
-    "openai": ">=4.0.0"
-  },
-  "peerDependenciesMeta": {
-    "@anthropic-ai/sdk": {
-      "optional": true
-    },
-    "@langchain/core": {
-      "optional": true
-    },
-    "openai": {
-      "optional": true
-    }
-  },
-  "keywords": [
-    "ai",
-    "agents",
-    "monitoring",
-    "observability",
-    "openai",
-    "anthropic",
-    "langchain"
-  ],
-  "license": "MIT"
-}
+{
+  "name": "opsveritas-sdk",
+  "version": "0.3.2",
+  "description": "Monitor your AI agents in 3 lines of code — tokens, cost, latency, and silent failures",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
+    "test": "jest"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.14.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.5",
+    "tsup": "^8.1.0",
+    "typescript": "^5.4.5"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/sdk": ">=0.20.0",
+    "@langchain/core": ">=0.2.0",
+    "openai": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/sdk": {
+      "optional": true
+    },
+    "@langchain/core": {
+      "optional": true
+    },
+    "openai": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "monitoring",
+    "observability",
+    "openai",
+    "anthropic",
+    "langchain"
+  ],
+  "license": "MIT"
+}