risicare 0.1.4 → 0.1.5

package/dist/index.d.ts

@@ -345,6 +345,34 @@ declare function getMetrics(): {
     queueCapacity: number;
     queueUtilization: number;
 };
+/**
+ * Report a caught exception to the self-healing pipeline.
+ *
+ * Creates an error span that triggers diagnosis and fix generation.
+ * This function never throws and is non-blocking.
+ *
+ * @param error - The caught exception (Error object or string)
+ * @param options - Optional attributes and context overrides
+ */
+declare function reportError(error: unknown, options?: {
+    name?: string;
+    attributes?: Record<string, unknown>;
+}): void;
+/**
+ * Record a custom evaluation score on a trace.
+ *
+ * Sends the score to the server in a fire-and-forget fashion.
+ * This function never throws and is non-blocking.
+ *
+ * @param traceId - The trace to score
+ * @param name - Score name (e.g., "accuracy", "user_satisfaction")
+ * @param value - Score value between 0.0 and 1.0 inclusive
+ * @param options - Optional span_id and comment
+ */
+declare function score(traceId: string, name: string, value: number, options?: {
+    spanId?: string;
+    comment?: string;
+}): void;
 
 /**
  * Agent context — identifies which agent is executing.
@@ -590,4 +618,4 @@ declare function registerSpan(span: Span, ttlMs?: number): void;
 declare function getSpanById(spanId: string): Span | undefined;
 declare function unregisterSpan(spanId: string): void;
 
-export { type AgentContext, type AgentOptions, AgentRole, MessageType, type RisicareConfig, SemanticPhase, type SessionContext, type SessionOptions, Span, SpanKind, type SpanOptions, SpanStatus, type StartSpanOptions, type TraceContext, Tracer, agent, disable, enable, extractTraceContext, flush, getCurrentAgent, getCurrentAgentId, getCurrentContext, getCurrentPhase, getCurrentSession, getCurrentSessionId, getCurrentSpan, getCurrentSpanId, getCurrentTraceId, getMetrics, getSpanById, getTraceContent, getTraceContext, getTracer, init, injectTraceContext, isEnabled, registerSpan, session, shutdown, traceAct, traceCoordinate, traceDecide, traceDelegate, traceMessage, traceObserve, traceThink, unregisterSpan, withAgent, withPhase, withSession };
+export { type AgentContext, type AgentOptions, AgentRole, MessageType, type RisicareConfig, SemanticPhase, type SessionContext, type SessionOptions, Span, SpanKind, type SpanOptions, SpanStatus, type StartSpanOptions, type TraceContext, Tracer, agent, disable, enable, extractTraceContext, flush, getCurrentAgent, getCurrentAgentId, getCurrentContext, getCurrentPhase, getCurrentSession, getCurrentSessionId, getCurrentSpan, getCurrentSpanId, getCurrentTraceId, getMetrics, getSpanById, getTraceContent, getTraceContext, getTracer, init, injectTraceContext, isEnabled, registerSpan, reportError, score, session, shutdown, traceAct, traceCoordinate, traceDecide, traceDelegate, traceMessage, traceObserve, traceThink, unregisterSpan, withAgent, withPhase, withSession };

package/dist/index.js

@@ -1043,10 +1043,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 = {
@@ -1079,7 +1135,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,
@@ -1100,7 +1155,6 @@ function session(optionsOrResolver, fn) {
 
 // src/context/phase.ts
 function withPhase(phase, fn) {
-  if (!isEnabled()) return fn();
   return runWithContext({ phase }, fn);
 }
 
@@ -1336,6 +1390,8 @@ export {
   injectTraceContext,
   isEnabled,
   registerSpan,
+  reportError,
+  score,
   session,
   shutdown,
   traceAct,