@intelli-1113/stratos-sdk 1.1.0 → 1.2.2

package/README.md

@@ -35,6 +35,12 @@ start({ token: "...", url: "https://stratos.lnt.com", appName: "my-agent" });
 ## Why it must load first
 OpenLLMetry patches `openai`/`langchain` to capture spans — it has to run **before** those modules are imported. The `--import` flag and the `/register` entry both guarantee that.
 
+## Auto-detected metadata (no manual entry)
+On each heartbeat the SDK reports, and Stratos auto-fills:
+- **framework** — detected from installed deps (langchain/langgraph, llamaindex, google-adk, vercel-ai, anthropic, openai…).
+- **model** — from `STRATOS_MODEL` / `NVIDIA_MODEL` / `OPENAI_MODEL` / `ANTHROPIC_MODEL` / `LLM_MODEL` / `MODEL` (or `start({ model })`).
+- **tools** — captured from spans automatically; you can also declare them via `STRATOS_TOOLS=a,b,c` or `start({ tools: [...] })`.
+
 ## Changing the URL or token
 Both come from env, read at startup — change the `.env` value and restart. No code edit, no SDK re-publish.
 
@@ -48,7 +54,10 @@ npm i -g @intelli-1113/stratos-sdk
 "weather": {
   "command": "stratos-mcp-proxy",
   "args": ["--","npx","-y","@scope/weather-mcp@latest"],
-  "env": { "STRATOS_TOKEN":"<token>", "STRATOS_URL":"http://localhost:4000", "STRATOS_APP_NAME":"weather" }
+  "env": {
+     "STRATOS_TOKEN":"<token>", 
+     "STRATOS_URL":"http://localhost:4000",
+     "STRATOS_APP_NAME":"weather" }
 }
 ```
 It forwards the JSON-RPC stream verbatim and reports each **tool call** (name, args, result, latency) + liveness.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intelli-1113/stratos-sdk",
-  "version": "1.1.0",
+  "version": "1.2.2",
   "description": "One install for Stratos AI: OpenLLMetry agent telemetry (--import) AND the stratos-mcp-proxy for MCP servers.",
   "type": "module",
   "main": "./src/index.js",

package/src/index.js

@@ -1,49 +1,97 @@
-// @intelli-1113/stratos-sdk — initialize OpenLLMetry and stream telemetry to Stratos AI.
-//
-// Config comes from the environment (so the ingest URL / token can change
-// without editing code or re-publishing the SDK):
-//   STRATOS_TOKEN     enrollment token from Stratos "Add agent"   (required)
-//   STRATOS_URL       Stratos origin, e.g. https://stratos.lnt.com (default http://localhost:4000)
-//   STRATOS_APP_NAME  display name for this agent                 (optional)
-//
-// Why this exists: traceloop defaults to OTLP *protobuf* at <baseUrl>/v1/traces;
-// Stratos ingests OTLP *JSON* at /api/ingest. This wires a JSON exporter to the
-// right URL and runs a heartbeat so the agent shows online while it's up.
-import * as traceloop from "@traceloop/node-server-sdk";
-import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
-
-let started = false;
-
-export function start(opts = {}) {
-  if (started) return; // idempotent — safe to import/register more than once
-  const token = opts.token || process.env.STRATOS_TOKEN || "";
-  const origin = (opts.url || process.env.STRATOS_URL || "http://localhost:4000").replace(/\/+$/, "");
-  const appName = opts.appName || process.env.STRATOS_APP_NAME || process.env.npm_package_name || "agent";
-  const heartbeatMs = Number(opts.heartbeatMs || process.env.STRATOS_HEARTBEAT_MS || 30000);
-
-  if (!token) {
-    console.warn("[stratos] STRATOS_TOKEN not set — telemetry disabled. Add the token from Stratos > Add agent.");
-    return;
-  }
-  started = true;
-
-  const ingest = `${origin}/api/ingest`;
-  const heartbeatUrl = `${origin}/api/heartbeat`;
-
-  traceloop.initialize({
-    appName,
-    disableBatch: true,
-    exporter: new OTLPTraceExporter({ url: ingest, headers: { "x-stratos-token": token } }),
-  });
-
-  // Keep the agent "online" while the process is alive (telemetry alone only
-  // fires on LLM calls, which would let liveness lapse between requests).
-  const ping = () =>
-    fetch(heartbeatUrl, { method: "POST", headers: { "x-stratos-token": token } }).catch(() => {});
-  ping();
-  if (heartbeatMs > 0) setInterval(ping, heartbeatMs).unref();
-
-  console.log(`[stratos] telemetry → ${ingest} (heartbeat ${heartbeatMs}ms)`);
-}
-
-export default { start };
+// @intelli-1113/stratos-sdk — initialize OpenLLMetry and stream telemetry to Stratos AI.
+//
+// Config comes from the environment (so the ingest URL / token can change
+// without editing code or re-publishing the SDK):
+//   STRATOS_TOKEN     enrollment token from Stratos "Add agent"   (required)
+//   STRATOS_URL       Stratos origin, e.g. https://stratos.lnt.com (default http://localhost:4000)
+//   STRATOS_APP_NAME  display name for this agent                 (optional)
+//
+// Why this exists: traceloop defaults to OTLP *protobuf* at <baseUrl>/v1/traces;
+// Stratos ingests OTLP *JSON* at /api/ingest. This wires a JSON exporter to the
+// right URL and runs a heartbeat so the agent shows online while it's up.
+import * as traceloop from "@traceloop/node-server-sdk";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
+import { createRequire } from "node:module";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+
+const _require = createRequire(import.meta.url);
+const resolvable = (pkg) => { try { _require.resolve(pkg); return true; } catch { return false; } };
+
+// The agent's DIRECT dependencies (most reliable signal of the framework in use).
+// Resolution alone is unreliable — some packages (e.g. @google/adk) block default
+// resolution via "exports", and others appear only transitively.
+function agentDeps() {
+  try {
+    const pkg = JSON.parse(readFileSync(join(process.cwd(), "package.json"), "utf8"));
+    return { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
+  } catch { return {}; }
+}
+
+// Detect the agent framework from declared deps (preferred) or resolution — no manual input.
+function detectFramework() {
+  const deps = agentDeps();
+  const has = (n) => n in deps || resolvable(n);
+  // Higher-level agent frameworks FIRST (several pull in @langchain/* transitively).
+  if (has("@google/adk") || has("google-adk") || has("@iqai/adk")) return "google-adk";
+  if (has("@openai/agents")) return "openai-agents";
+  if (has("llamaindex")) return "llamaindex";
+  if (has("crewai")) return "crewai";
+  if (has("@langchain/langgraph")) return "langgraph";
+  if (has("langchain") || has("@langchain/core")) return "langchain";
+  if (has("ai")) return "vercel-ai";
+  if (has("@google/generative-ai") || has("@google/genai")) return "google-genai";
+  if (has("@anthropic-ai/sdk")) return "anthropic";
+  if (has("openai")) return "openai";
+  return null;
+}
+// Best-effort model from common env vars (or opts.model). Spans still refine it.
+function detectModel(opts) {
+  return opts.model || process.env.STRATOS_MODEL || process.env.NVIDIA_MODEL || process.env.OPENAI_MODEL
+    || process.env.ANTHROPIC_MODEL || process.env.LLM_MODEL || process.env.MODEL || null;
+}
+
+let started = false;
+
+export function start(opts = {}) {
+  if (started) return; // idempotent — safe to import/register more than once
+  const token = opts.token || process.env.STRATOS_TOKEN || "";
+  const origin = (opts.url || process.env.STRATOS_URL || "http://localhost:4000").replace(/\/+$/, "");
+  const appName = opts.appName || process.env.STRATOS_APP_NAME || process.env.npm_package_name || "agent";
+  const heartbeatMs = Number(opts.heartbeatMs || process.env.STRATOS_HEARTBEAT_MS || 30000);
+
+  if (!token) {
+    console.warn("[stratos] STRATOS_TOKEN not set — telemetry disabled. Add the token from Stratos > Add agent.");
+    return;
+  }
+  started = true;
+
+  const ingest = `${origin}/api/ingest`;
+  const heartbeatUrl = `${origin}/api/heartbeat`;
+
+  traceloop.initialize({
+    appName,
+    disableBatch: true,
+    exporter: new OTLPTraceExporter({ url: ingest, headers: { "x-stratos-token": token } }),
+  });
+
+  // Auto-detected metadata sent on every heartbeat → Stratos auto-fills the
+  // agent's framework/model/tools (no manual entry, no reliance on span quality).
+  const toolsEnv = (opts.tools || (process.env.STRATOS_TOOLS || "").split(",")).map((s) => String(s).trim()).filter(Boolean);
+  const meta = { framework: detectFramework(), model: detectModel(opts), tools: toolsEnv };
+
+  // Keep the agent "online" while the process is alive (telemetry alone only
+  // fires on LLM calls, which would let liveness lapse between requests).
+  const ping = () =>
+    fetch(heartbeatUrl, {
+      method: "POST",
+      headers: { "x-stratos-token": token, "Content-Type": "application/json" },
+      body: JSON.stringify(meta),
+    }).catch(() => {});
+  ping();
+  if (heartbeatMs > 0) setInterval(ping, heartbeatMs).unref();
+
+  console.log(`[stratos] telemetry → ${ingest} (heartbeat ${heartbeatMs}ms, framework=${meta.framework || "?"})`);
+}
+
+export default { start };