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

package/dist/shared/hyde/hyde.strategies.d.ts

@@ -6,6 +6,7 @@
  * infers free-text "lenses" dynamically. This file re-exports the lens
  * types and provides constants for the HyDE pipeline.
  */
+import type { HydeTargetCorpus } from './lens.inferrer.js';
 export type { Lens, HydeTargetCorpus, LensInferenceInput, LensInferenceOutput } from './lens.inferrer.js';
 /** Default cache TTL for ephemeral HyDE documents (1 hour). */
 export declare const HYDE_DEFAULT_CACHE_TTL = 3600;
@@ -13,5 +14,5 @@ export declare const HYDE_DEFAULT_CACHE_TTL = 3600;
  * Prompt templates for HyDE document generation.
  * Keyed by target corpus — the lens label provides the semantic specificity.
  */
-export declare const HYDE_CORPUS_PROMPTS: Record<'profiles' | 'intents' | 'premises', (sourceText: string, lens: string) => string>;
+export declare const HYDE_CORPUS_PROMPTS: Record<HydeTargetCorpus, (sourceText: string, lens: string) => string>;
 //# sourceMappingURL=hyde.strategies.d.ts.map

package/dist/shared/hyde/hyde.strategies.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hyde.strategies.d.ts","sourceRoot":"/","sources":["shared/hyde/hyde.strategies.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EAAE,IAAI,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE1G,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,GAAG,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAmBzH,CAAC"}
+{"version":3,"file":"hyde.strategies.d.ts","sourceRoot":"/","sources":["shared/hyde/hyde.strategies.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,YAAY,EAAE,IAAI,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE1G,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAmBtG,CAAC"}

package/dist/shared/hyde/hyde.strategies.js.map

@@ -1 +1 @@
-{"version":3,"file":"hyde.strategies.js","sourceRoot":"/","sources":["shared/hyde/hyde.strategies.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8F;IAC5H,QAAQ,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;+EAC6C,UAAU;0EACf,IAAI;;;GAG3E;IACD,OAAO,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;+DAC8B,IAAI;6CACtB,UAAU;;;GAGpD;IACD,QAAQ,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;oGACkE,UAAU;0CACpE,IAAI;;;GAG3C;CACF,CAAC","sourcesContent":["/**\n * HyDE (Hypothetical Document Embeddings) type definitions.\n *\n * The system is now role-agnostic: instead of hardcoded strategy names\n * (mirror, reciprocal, mentor, investor, collaborator, hiree), an LLM\n * infers free-text \"lenses\" dynamically. This file re-exports the lens\n * types and provides constants for the HyDE pipeline.\n */\n\nexport type { Lens, HydeTargetCorpus, LensInferenceInput, LensInferenceOutput } from './lens.inferrer.js';\n\n/** Default cache TTL for ephemeral HyDE documents (1 hour). */\nexport const HYDE_DEFAULT_CACHE_TTL = 3600;\n\n/**\n * Prompt templates for HyDE document generation.\n * Keyed by target corpus — the lens label provides the semantic specificity.\n */\nexport const HYDE_CORPUS_PROMPTS: Record<'profiles' | 'intents' | 'premises', (sourceText: string, lens: string) => string> = {\n  profiles: (sourceText, lens) => `\n    Write a professional biography for someone who could fulfill this need: \"${sourceText}\".\n    Focus on the specific expertise, background, and role described by: ${lens}.\n\n    Write in first person. Include concrete skills, domain experience, and current professional focus that would make them a strong match.\n  `,\n  intents: (sourceText, lens) => `\n    Write a goal or aspiration statement for someone who is: ${lens}.\n    This person's needs would complement: \"${sourceText}\".\n\n    Write in first person as if stating their own goal.\n  `,\n  premises: (sourceText, lens) => `\n    Write a short self-description for someone whose identity, values, or worldview aligns with: \"${sourceText}\".\n    Reflect the character described by: ${lens}.\n\n    Write in first person as a stable statement of who this person is, not what they want.\n  `,\n};\n"]}
+{"version":3,"file":"hyde.strategies.js","sourceRoot":"/","sources":["shared/hyde/hyde.strategies.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA2E;IACzG,QAAQ,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;+EAC6C,UAAU;0EACf,IAAI;;;GAG3E;IACD,OAAO,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;+DAC8B,IAAI;6CACtB,UAAU;;;GAGpD;IACD,QAAQ,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;oGACkE,UAAU;0CACpE,IAAI;;;GAG3C;CACF,CAAC","sourcesContent":["/**\n * HyDE (Hypothetical Document Embeddings) type definitions.\n *\n * The system is now role-agnostic: instead of hardcoded strategy names\n * (mirror, reciprocal, mentor, investor, collaborator, hiree), an LLM\n * infers free-text \"lenses\" dynamically. This file re-exports the lens\n * types and provides constants for the HyDE pipeline.\n */\n\nimport type { HydeTargetCorpus } from './lens.inferrer.js';\n\nexport type { Lens, HydeTargetCorpus, LensInferenceInput, LensInferenceOutput } from './lens.inferrer.js';\n\n/** Default cache TTL for ephemeral HyDE documents (1 hour). */\nexport const HYDE_DEFAULT_CACHE_TTL = 3600;\n\n/**\n * Prompt templates for HyDE document generation.\n * Keyed by target corpus — the lens label provides the semantic specificity.\n */\nexport const HYDE_CORPUS_PROMPTS: Record<HydeTargetCorpus, (sourceText: string, lens: string) => string> = {\n  profiles: (sourceText, lens) => `\n    Write a professional biography for someone who could fulfill this need: \"${sourceText}\".\n    Focus on the specific expertise, background, and role described by: ${lens}.\n\n    Write in first person. Include concrete skills, domain experience, and current professional focus that would make them a strong match.\n  `,\n  intents: (sourceText, lens) => `\n    Write a goal or aspiration statement for someone who is: ${lens}.\n    This person's needs would complement: \"${sourceText}\".\n\n    Write in first person as if stating their own goal.\n  `,\n  premises: (sourceText, lens) => `\n    Write a short self-description for someone whose identity, values, or worldview aligns with: \"${sourceText}\".\n    Reflect the character described by: ${lens}.\n\n    Write in first person as a stable statement of who this person is, not what they want.\n  `,\n};\n"]}

package/dist/shared/observability/trace.d.ts

@@ -34,7 +34,7 @@ export declare function traceAgent<T>(name: string, fn: () => Promise<T>, summar
  *   async run() { ... }
  * }
  */
-export declare function TraceGraph(name: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
+export declare const TraceGraph: (name: string) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
 /**
  * Method decorator. Wraps the decorated async method in `traceAgent(name, ...)`.
  * Use on class methods that represent a single agent step (one LLM call,
@@ -46,7 +46,7 @@ export declare function TraceGraph(name: string): (target: any, propertyKey: str
  *   async run() { ... }
  * }
  */
-export declare function TraceAgent(name: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
+export declare const TraceAgent: (name: string) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
 /**
  * Method decorator. Wraps the decorated async method in `tracePhase(name, ...)`.
  * Use for logical groupings of inline work that aren't LangGraph state machines.
@@ -57,5 +57,5 @@ export declare function TraceAgent(name: string): (target: any, propertyKey: str
  *   async run() { ... }
  * }
  */
-export declare function TracePhase(name: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
+export declare const TracePhase: (name: string) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
 //# sourceMappingURL=trace.d.ts.map

package/dist/shared/observability/trace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace.d.ts","sourceRoot":"/","sources":["shared/observability/trace.ts"],"names":[],"mappings":"AAuBA;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CASlF;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CASlF;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,GAC3C,OAAO,CAAC,CAAC,CAAC,CAeZ;AAED;;;;;;;;;;GAUG;AAEH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,KAAK,IAAI,CASnH;AAED;;;;;;;;;;GAUG;AAEH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,KAAK,IAAI,CASnH;AAED;;;;;;;;;GASG;AAEH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,KAAK,IAAI,CASnH"}
+{"version":3,"file":"trace.d.ts","sourceRoot":"/","sources":["shared/observability/trace.ts"],"names":[],"mappings":"AAuBA;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CASlF;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CASlF;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,GAC3C,OAAO,CAAC,CAAC,CAAC,CAeZ;AAsBD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,SAvBb,MAAM,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,KAAK,IAuBvC,CAAC;AAErD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,SApCb,MAAM,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,KAAK,IAoCvC,CAAC;AAErD;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,SAhDb,MAAM,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,KAAK,IAgDvC,CAAC"}

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.278.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",