@ydking0911/observr 0.4.8 → 0.5.0

package/dist/index.d.mts

@@ -60,6 +60,22 @@ declare class ObservrClient {
     start(): void;
     /** Wrap an async function in a named span. */
     span(name: string, attributes?: Record<string, unknown>): Span;
+    /**
+     * Span for agent actions with standard attribute keys.
+     *
+     * Standard keys (omitted when undefined):
+     *   agent.intent   — goal the agent is working toward
+     *   agent.trigger  — what caused this action (user_message | tool_result | <span_id>)
+     *   agent.model    — LLM that made the decision
+     *   agent.tool     — tool being invoked
+     */
+    agentSpan(name: string, options?: {
+        intent?: string;
+        trigger?: string;
+        model?: string;
+        tool?: string;
+        [key: string]: unknown;
+    }): Span;
     shutdown(): Promise<void>;
     private _autoInstrument;
     private _instrumentExpress;

package/dist/index.d.ts

@@ -60,6 +60,22 @@ declare class ObservrClient {
     start(): void;
     /** Wrap an async function in a named span. */
     span(name: string, attributes?: Record<string, unknown>): Span;
+    /**
+     * Span for agent actions with standard attribute keys.
+     *
+     * Standard keys (omitted when undefined):
+     *   agent.intent   — goal the agent is working toward
+     *   agent.trigger  — what caused this action (user_message | tool_result | <span_id>)
+     *   agent.model    — LLM that made the decision
+     *   agent.tool     — tool being invoked
+     */
+    agentSpan(name: string, options?: {
+        intent?: string;
+        trigger?: string;
+        model?: string;
+        tool?: string;
+        [key: string]: unknown;
+    }): Span;
     shutdown(): Promise<void>;
     private _autoInstrument;
     private _instrumentExpress;

package/dist/index.js

@@ -366,6 +366,24 @@ var ObservrClient = class {
   span(name, attributes = {}) {
     return new Span(name, this.transport, attributes);
   }
+  /**
+   * Span for agent actions with standard attribute keys.
+   *
+   * Standard keys (omitted when undefined):
+   *   agent.intent   — goal the agent is working toward
+   *   agent.trigger  — what caused this action (user_message | tool_result | <span_id>)
+   *   agent.model    — LLM that made the decision
+   *   agent.tool     — tool being invoked
+   */
+  agentSpan(name, options = {}) {
+    const { intent, trigger, model, tool, ...extra } = options;
+    const attributes = { ...extra };
+    if (intent !== void 0) attributes["agent.intent"] = intent;
+    if (trigger !== void 0) attributes["agent.trigger"] = trigger;
+    if (model !== void 0) attributes["agent.model"] = model;
+    if (tool !== void 0) attributes["agent.tool"] = tool;
+    return new Span(name, this.transport, attributes);
+  }
   async shutdown() {
     unpatchConsole();
     await this.transport.shutdown();

package/dist/index.mjs

@@ -345,6 +345,24 @@ var ObservrClient = class {
   span(name, attributes = {}) {
     return new Span(name, this.transport, attributes);
   }
+  /**
+   * Span for agent actions with standard attribute keys.
+   *
+   * Standard keys (omitted when undefined):
+   *   agent.intent   — goal the agent is working toward
+   *   agent.trigger  — what caused this action (user_message | tool_result | <span_id>)
+   *   agent.model    — LLM that made the decision
+   *   agent.tool     — tool being invoked
+   */
+  agentSpan(name, options = {}) {
+    const { intent, trigger, model, tool, ...extra } = options;
+    const attributes = { ...extra };
+    if (intent !== void 0) attributes["agent.intent"] = intent;
+    if (trigger !== void 0) attributes["agent.trigger"] = trigger;
+    if (model !== void 0) attributes["agent.model"] = model;
+    if (tool !== void 0) attributes["agent.tool"] = tool;
+    return new Span(name, this.transport, attributes);
+  }
   async shutdown() {
     unpatchConsole();
     await this.transport.shutdown();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ydking0911/observr",
-  "version": "0.4.8",
+  "version": "0.5.0",
   "description": "Zero-config observability for AI agents and developers",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",