risicare 0.1.3 → 0.1.5

package/dist/index.cjs

@@ -58,6 +58,8 @@ __export(src_exports, {
   injectTraceContext: () => injectTraceContext,
   isEnabled: () => isEnabled,
   registerSpan: () => registerSpan,
+  reportError: () => reportError,
+  score: () => score,
   session: () => session,
   shutdown: () => shutdown,
   traceAct: () => traceAct,
@@ -81,6 +83,11 @@ function resolveConfig(config) {
   const apiKey = config?.apiKey ?? env.RISICARE_API_KEY;
   const endpoint = config?.endpoint ?? env.RISICARE_ENDPOINT ?? DEFAULT_ENDPOINT;
   const projectId = config?.projectId ?? env.RISICARE_PROJECT_ID;
+  if (config?.projectId || env.RISICARE_PROJECT_ID) {
+    console.warn(
+      "[risicare] projectId is deprecated and ignored by the gateway. Your API key determines the project. Use serviceName and environment for within-project organization. projectId will be removed in v1.0."
+    );
+  }
   const environment = config?.environment ?? env.RISICARE_ENVIRONMENT ?? "development";
   const serviceName = config?.serviceName ?? env.RISICARE_SERVICE_NAME;
   const serviceVersion = config?.serviceVersion ?? env.RISICARE_SERVICE_VERSION;
@@ -1114,10 +1121,66 @@ function getMetrics() {
     queueUtilization: 0
   };
 }
+function reportError(error, options) {
+  try {
+    const tracer = getTracer2();
+    if (!tracer) return;
+    const err = error instanceof Error ? error : new Error(String(error));
+    const spanName = options?.name ?? `error:${err.constructor.name}`;
+    tracer.startSpan({ name: spanName, kind: "internal" /* INTERNAL */ }, (span) => {
+      span.setStatus("error" /* ERROR */, err.message);
+      span.setAttribute("error", true);
+      span.setAttribute("error.type", err.constructor.name);
+      span.setAttribute("error.message", err.message.slice(0, 2e3));
+      if (err.stack) span.setAttribute("error.stack", err.stack.slice(0, 4e3));
+      span.setAttribute("risicare.reported_error", true);
+      if (options?.attributes) {
+        for (const [k, v] of Object.entries(options.attributes)) {
+          span.setAttribute(k, v);
+        }
+      }
+    });
+  } catch {
+    debug("reportError failed");
+  }
+}
+function score(traceId, name, value, options) {
+  try {
+    if (typeof value !== "number" || value < 0 || value > 1) {
+      debug(`score: value must be in [0.0, 1.0], got ${value}. Score not sent.`);
+      return;
+    }
+    if (!traceId || !name) {
+      debug("score: traceId and name are required");
+      return;
+    }
+    const client = getClient();
+    if (!client?.enabled || !client.config.apiKey) return;
+    const endpoint = client.config.endpoint.replace(/\/$/, "");
+    const url = `${endpoint}/api/v1/scores`;
+    const body = JSON.stringify({
+      trace_id: traceId,
+      name,
+      score: value,
+      source: "sdk",
+      ...options?.spanId && { span_id: options.spanId },
+      ...options?.comment && { comment: options.comment }
+    });
+    fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${client.config.apiKey}`
+      },
+      body
+    }).catch((err) => debug(`score: send failed: ${err}`));
+  } catch {
+    debug("score failed");
+  }
+}
 
 // src/context/agent.ts
 function withAgent(options, fn) {
-  if (!isEnabled()) return fn();
   const parent = getCurrentAgent();
   const agentName = options.name ?? "agent";
   const agent2 = {
@@ -1150,7 +1213,6 @@ function agent(options, fn) {
 
 // src/context/session.ts
 function withSession(options, fn) {
-  if (!isEnabled()) return fn();
   const session2 = {
     sessionId: options.sessionId,
     userId: options.userId,
@@ -1171,7 +1233,6 @@ function session(optionsOrResolver, fn) {
 
 // src/context/phase.ts
 function withPhase(phase, fn) {
-  if (!isEnabled()) return fn();
   return runWithContext({ phase }, fn);
 }
 
@@ -1408,6 +1469,8 @@ function maybeCleanup() {
   injectTraceContext,
   isEnabled,
   registerSpan,
+  reportError,
+  score,
   session,
   shutdown,
   traceAct,