@indexnetwork/protocol 3.7.0-rc.277.1 → 3.7.1-rc.279.1

package/dist/shared/observability/trace.js

@@ -78,6 +78,22 @@ export async function traceAgent(name, fn, summarize) {
     emit?.({ type: "agent_end", name, durationMs, ...(summary ? { summary } : {}) });
     return value;
 }
+/**
+ * Builds a method decorator that wraps the decorated async method in the given
+ * trace wrapper (`traceGraph` / `traceAgent` / `tracePhase`). Uses the legacy
+ * decorator shape already adopted by `@Timed()`.
+ */
+function traceDecorator(wrap) {
+    return (name) => 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    function (_target, _propertyKey, descriptor) {
+        const original = descriptor.value;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        descriptor.value = function (...args) {
+            return wrap(name, () => original.apply(this, args));
+        };
+    };
+}
 /**
  * Method decorator. Wraps the decorated async method in `traceGraph(name, ...)`.
  * Use on class methods that represent a logical "graph" (a sub-flow with
@@ -89,17 +105,7 @@ export async function traceAgent(name, fn, summarize) {
  *   async run() { ... }
  * }
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function TraceGraph(name) {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    return function (_target, _propertyKey, descriptor) {
-        const original = descriptor.value;
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        descriptor.value = function (...args) {
-            return traceGraph(name, () => original.apply(this, args));
-        };
-    };
-}
+export const TraceGraph = traceDecorator(traceGraph);
 /**
  * Method decorator. Wraps the decorated async method in `traceAgent(name, ...)`.
  * Use on class methods that represent a single agent step (one LLM call,
@@ -111,17 +117,7 @@ export function TraceGraph(name) {
  *   async run() { ... }
  * }
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function TraceAgent(name) {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    return function (_target, _propertyKey, descriptor) {
-        const original = descriptor.value;
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        descriptor.value = function (...args) {
-            return traceAgent(name, () => original.apply(this, args));
-        };
-    };
-}
+export const TraceAgent = traceDecorator(traceAgent);
 /**
  * Method decorator. Wraps the decorated async method in `tracePhase(name, ...)`.
  * Use for logical groupings of inline work that aren't LangGraph state machines.
@@ -132,15 +128,5 @@ export function TraceAgent(name) {
  *   async run() { ... }
  * }
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function TracePhase(name) {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    return function (_target, _propertyKey, descriptor) {
-        const original = descriptor.value;
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        descriptor.value = function (...args) {
-            return tracePhase(name, () => original.apply(this, args));
-        };
-    };
-}
+export const TracePhase = traceDecorator(tracePhase);
 //# sourceMappingURL=trace.js.map

package/dist/shared/observability/trace.js.map

@@ -1 +1 @@
-{"version":3,"file":"trace.js","sourceRoot":"/","sources":["shared/observability/trace.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Trace helpers — wrap async work in `graph_start`/`graph_end` or\n * `agent_start`/`agent_end` events automatically. Pulls the emitter from the\n * ambient request context so callers don't pass it manually.\n *\n * Available in two flavours:\n *  - Functional: `traceGraph(name, fn)` / `traceAgent(name, fn)` — for inline\n *    blocks. Returns whatever the wrapped function returns.\n *  - Decorator: `@TraceGraph(name)` / `@TraceAgent(name)` — for class methods.\n *    Uses the legacy decorator shape already adopted by `@Timed()`.\n */\nimport { requestContext } from \"./request-context.js\";\n\ntype Emitter = (event: Record<string, unknown>) => void;\n\nfunction getEmitter(): Emitter | undefined {\n  const raw = requestContext.getStore()?.traceEmitter;\n  // The ambient TraceEmitter is typed against a constrained event union; we\n  // emit a broader shape here. Same wide-cast pattern used elsewhere\n  // (see opportunity.graph.ts, opportunity.discover.ts).\n  return raw as unknown as Emitter | undefined;\n}\n\n/**\n * Wrap an async function so it emits `graph_start` / `graph_end` events around\n * its execution. `durationMs` is measured in wall time. If the wrapped\n * function throws, `graph_end` still fires before the error propagates.\n *\n * Use ONLY for actual LangGraph compiled state machines (Opportunity graph,\n * Negotiation graph, etc). For logical groupings of inline work, use\n * `tracePhase` — it has a distinct visual in the trace UI so users can tell\n * \"this is a graph\" from \"this is a phase\".\n */\nexport async function traceGraph<T>(name: string, fn: () => Promise<T>): Promise<T> {\n  const emit = getEmitter();\n  emit?.({ type: \"graph_start\", name });\n  const start = Date.now();\n  try {\n    return await fn();\n  } finally {\n    emit?.({ type: \"graph_end\", name, durationMs: Date.now() - start });\n  }\n}\n\n/**\n * Wrap an async function so it emits `phase_start` / `phase_end` events around\n * its execution. Phases are logical groupings of inline async work — they\n * share container semantics with graphs (they can host agents) but render\n * differently in the trace UI to make it clear they're NOT LangGraph state\n * machines.\n */\nexport async function tracePhase<T>(name: string, fn: () => Promise<T>): Promise<T> {\n  const emit = getEmitter();\n  emit?.({ type: \"phase_start\", name });\n  const start = Date.now();\n  try {\n    return await fn();\n  } finally {\n    emit?.({ type: \"phase_end\", name, durationMs: Date.now() - start });\n  }\n}\n\n/**\n * Wrap an async function so it emits `agent_start` / `agent_end` events. The\n * optional `summarize` callback produces a short string shown in the trace\n * panel; receives the wrapped function's resolved value.\n */\nexport async function traceAgent<T>(\n  name: string,\n  fn: () => Promise<T>,\n  summarize?: (value: T) => string | undefined,\n): Promise<T> {\n  const emit = getEmitter();\n  emit?.({ type: \"agent_start\", name });\n  const start = Date.now();\n  let value: T;\n  try {\n    value = await fn();\n  } catch (err) {\n    emit?.({ type: \"agent_end\", name, durationMs: Date.now() - start });\n    throw err;\n  }\n  const durationMs = Date.now() - start;\n  const summary = summarize?.(value);\n  emit?.({ type: \"agent_end\", name, durationMs, ...(summary ? { summary } : {}) });\n  return value;\n}\n\n/**\n * Method decorator. Wraps the decorated async method in `traceGraph(name, ...)`.\n * Use on class methods that represent a logical \"graph\" (a sub-flow with\n * internal agent calls).\n *\n * @example\n * class RefinePhase {\n *   @TraceGraph(\"Refine\")\n *   async run() { ... }\n * }\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function TraceGraph(name: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  return function (_target: any, _propertyKey: string, descriptor: PropertyDescriptor) {\n    const original = descriptor.value;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    descriptor.value = function (this: any, ...args: any[]) {\n      return traceGraph(name, () => original.apply(this, args));\n    };\n  };\n}\n\n/**\n * Method decorator. Wraps the decorated async method in `traceAgent(name, ...)`.\n * Use on class methods that represent a single agent step (one LLM call,\n * one summarization, etc).\n *\n * @example\n * class ChatSummary {\n *   @TraceAgent(\"Chat summary\")\n *   async run() { ... }\n * }\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function TraceAgent(name: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  return function (_target: any, _propertyKey: string, descriptor: PropertyDescriptor) {\n    const original = descriptor.value;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    descriptor.value = function (this: any, ...args: any[]) {\n      return traceAgent(name, () => original.apply(this, args));\n    };\n  };\n}\n\n/**\n * Method decorator. Wraps the decorated async method in `tracePhase(name, ...)`.\n * Use for logical groupings of inline work that aren't LangGraph state machines.\n *\n * @example\n * class RefinePhase {\n *   @TracePhase(\"Refine\")\n *   async run() { ... }\n * }\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function TracePhase(name: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  return function (_target: any, _propertyKey: string, descriptor: PropertyDescriptor) {\n    const original = descriptor.value;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    descriptor.value = function (this: any, ...args: any[]) {\n      return tracePhase(name, () => original.apply(this, args));\n    };\n  };\n}\n"]}
+{"version":3,"file":"trace.js","sourceRoot":"/","sources":["shared/observability/trace.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Trace helpers — wrap async work in `graph_start`/`graph_end` or\n * `agent_start`/`agent_end` events automatically. Pulls the emitter from the\n * ambient request context so callers don't pass it manually.\n *\n * Available in two flavours:\n *  - Functional: `traceGraph(name, fn)` / `traceAgent(name, fn)` — for inline\n *    blocks. Returns whatever the wrapped function returns.\n *  - Decorator: `@TraceGraph(name)` / `@TraceAgent(name)` — for class methods.\n *    Uses the legacy decorator shape already adopted by `@Timed()`.\n */\nimport { requestContext } from \"./request-context.js\";\n\ntype Emitter = (event: Record<string, unknown>) => void;\n\nfunction getEmitter(): Emitter | undefined {\n  const raw = requestContext.getStore()?.traceEmitter;\n  // The ambient TraceEmitter is typed against a constrained event union; we\n  // emit a broader shape here. Same wide-cast pattern used elsewhere\n  // (see opportunity.graph.ts, opportunity.discover.ts).\n  return raw as unknown as Emitter | undefined;\n}\n\n/**\n * Wrap an async function so it emits `graph_start` / `graph_end` events around\n * its execution. `durationMs` is measured in wall time. If the wrapped\n * function throws, `graph_end` still fires before the error propagates.\n *\n * Use ONLY for actual LangGraph compiled state machines (Opportunity graph,\n * Negotiation graph, etc). For logical groupings of inline work, use\n * `tracePhase` — it has a distinct visual in the trace UI so users can tell\n * \"this is a graph\" from \"this is a phase\".\n */\nexport async function traceGraph<T>(name: string, fn: () => Promise<T>): Promise<T> {\n  const emit = getEmitter();\n  emit?.({ type: \"graph_start\", name });\n  const start = Date.now();\n  try {\n    return await fn();\n  } finally {\n    emit?.({ type: \"graph_end\", name, durationMs: Date.now() - start });\n  }\n}\n\n/**\n * Wrap an async function so it emits `phase_start` / `phase_end` events around\n * its execution. Phases are logical groupings of inline async work — they\n * share container semantics with graphs (they can host agents) but render\n * differently in the trace UI to make it clear they're NOT LangGraph state\n * machines.\n */\nexport async function tracePhase<T>(name: string, fn: () => Promise<T>): Promise<T> {\n  const emit = getEmitter();\n  emit?.({ type: \"phase_start\", name });\n  const start = Date.now();\n  try {\n    return await fn();\n  } finally {\n    emit?.({ type: \"phase_end\", name, durationMs: Date.now() - start });\n  }\n}\n\n/**\n * Wrap an async function so it emits `agent_start` / `agent_end` events. The\n * optional `summarize` callback produces a short string shown in the trace\n * panel; receives the wrapped function's resolved value.\n */\nexport async function traceAgent<T>(\n  name: string,\n  fn: () => Promise<T>,\n  summarize?: (value: T) => string | undefined,\n): Promise<T> {\n  const emit = getEmitter();\n  emit?.({ type: \"agent_start\", name });\n  const start = Date.now();\n  let value: T;\n  try {\n    value = await fn();\n  } catch (err) {\n    emit?.({ type: \"agent_end\", name, durationMs: Date.now() - start });\n    throw err;\n  }\n  const durationMs = Date.now() - start;\n  const summary = summarize?.(value);\n  emit?.({ type: \"agent_end\", name, durationMs, ...(summary ? { summary } : {}) });\n  return value;\n}\n\n/**\n * Builds a method decorator that wraps the decorated async method in the given\n * trace wrapper (`traceGraph` / `traceAgent` / `tracePhase`). Uses the legacy\n * decorator shape already adopted by `@Timed()`.\n */\nfunction traceDecorator(\n  wrap: <T>(name: string, fn: () => Promise<T>) => Promise<T>,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): (name: string) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void {\n  return (name: string) =>\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    function (_target: any, _propertyKey: string, descriptor: PropertyDescriptor) {\n      const original = descriptor.value;\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      descriptor.value = function (this: any, ...args: any[]) {\n        return wrap(name, () => original.apply(this, args));\n      };\n    };\n}\n\n/**\n * Method decorator. Wraps the decorated async method in `traceGraph(name, ...)`.\n * Use on class methods that represent a logical \"graph\" (a sub-flow with\n * internal agent calls).\n *\n * @example\n * class RefinePhase {\n *   @TraceGraph(\"Refine\")\n *   async run() { ... }\n * }\n */\nexport const TraceGraph = traceDecorator(traceGraph);\n\n/**\n * Method decorator. Wraps the decorated async method in `traceAgent(name, ...)`.\n * Use on class methods that represent a single agent step (one LLM call,\n * one summarization, etc).\n *\n * @example\n * class ChatSummary {\n *   @TraceAgent(\"Chat summary\")\n *   async run() { ... }\n * }\n */\nexport const TraceAgent = traceDecorator(traceAgent);\n\n/**\n * Method decorator. Wraps the decorated async method in `tracePhase(name, ...)`.\n * Use for logical groupings of inline work that aren't LangGraph state machines.\n *\n * @example\n * class RefinePhase {\n *   @TracePhase(\"Refine\")\n *   async run() { ... }\n * }\n */\nexport const TracePhase = traceDecorator(tracePhase);\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "3.7.0-rc.277.1",
+  "version": "3.7.1-rc.279.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",