@kortyx/hooks 0.17.0 → 0.18.0

package/dist/internal.d.ts

@@ -1,6 +1,7 @@
 import { ProviderModelRef, KortyxReasoningOptions, KortyxResponseFormat, KortyxToolDefinition, KortyxPromptMessage, KortyxUsage, KortyxFinishReason, KortyxToolCall, KortyxProviderMetadata, KortyxWarning } from '@kortyx/providers';
-import { K as KortyxTraceMetadata, R as ReasonTraceAdapter } from './tracing-DhjgeiDS.js';
-export { a as KortyxTelemetryConfig, d as KortyxTraceAdapter } from './tracing-DhjgeiDS.js';
+import { K as KortyxTraceMetadata, R as ReasonTraceAdapter } from './tracing-DeYHBpY1.js';
+export { b as KortyxTelemetryConfig, j as KortyxTraceAdapter } from './tracing-DeYHBpY1.js';
+import '@kortyx/telemetry-contracts';
 
 interface RunReasonEngineArgs {
     model: ProviderModelRef;

package/dist/internal.js

@@ -92,6 +92,17 @@ async function runReasonEngine(args) {
       input: args.telemetry?.input ?? messages
     }
   });
+  const modelRequestStartedAt = Date.now();
+  let firstTextTokenAt;
+  let lastTextTokenAt;
+  const generationTimingAttributes = () => firstTextTokenAt === void 0 || lastTextTokenAt === void 0 ? {} : {
+    ttftMs: Math.max(0, firstTextTokenAt - modelRequestStartedAt),
+    streamDurationMs: Math.max(0, lastTextTokenAt - firstTextTokenAt),
+    timeToLastTokenMs: Math.max(
+      0,
+      lastTextTokenAt - modelRequestStartedAt
+    )
+  };
   const endTrace = (span, result) => {
     span?.end?.({
       ...result.usage !== void 0 ? { usage: result.usage } : {},
@@ -99,7 +110,8 @@ async function runReasonEngine(args) {
       ...result.providerMetadata !== void 0 ? { providerMetadata: result.providerMetadata } : {},
       ...result.warnings !== void 0 ? { warnings: result.warnings } : {},
       attributes: {
-        textLength: result.text.length
+        textLength: result.text.length,
+        ...generationTimingAttributes()
       },
       telemetry: {
         ...args.telemetry ?? {},
@@ -134,6 +146,9 @@ async function runReasonEngine(args) {
         switch (chunk.type) {
           case "text-delta": {
             if (chunk.delta.length === 0) break;
+            const tokenAt = Date.now();
+            firstTextTokenAt ??= tokenAt;
+            lastTextTokenAt = tokenAt;
             final += chunk.delta;
             args.onTextChunk?.(chunk.delta);
             if (chunk.raw !== void 0) {

package/dist/internal.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/internal.ts","../src/reason-engine.ts"],"sourcesContent":["export type {\n  RunReasonEngineArgs,\n  RunReasonEngineResult,\n} from \"./reason-engine\";\nexport { runReasonEngine } from \"./reason-engine\";\nexport type {\n  KortyxTelemetryConfig,\n  KortyxTraceAdapter,\n  KortyxTraceMetadata,\n  ReasonTraceAdapter,\n} from \"./tracing\";\n","import { randomUUID } from \"node:crypto\";\nimport type {\n  KortyxFinishReason,\n  KortyxPromptMessage,\n  KortyxProviderMetadata,\n  KortyxReasoningOptions,\n  KortyxResponseFormat,\n  KortyxToolCall,\n  KortyxToolDefinition,\n  KortyxUsage,\n  KortyxWarning,\n  ProviderModelRef,\n} from \"@kortyx/providers\";\nimport type {\n  KortyxTraceMetadata,\n  ReasonTraceAdapter,\n  ReasonTraceSpan,\n} from \"./tracing\";\n\nexport interface RunReasonEngineArgs {\n  model: ProviderModelRef;\n  input: string;\n  system?: string | undefined;\n  temperature?: number | undefined;\n  maxOutputTokens?: number | undefined;\n  stopSequences?: string[] | undefined;\n  abortSignal?: AbortSignal | undefined;\n  reasoning?: KortyxReasoningOptions | undefined;\n  responseFormat?: KortyxResponseFormat | undefined;\n  providerOptions?: Record<string, unknown> | undefined;\n  tools?: KortyxToolDefinition[] | undefined;\n  messages?: KortyxPromptMessage[] | undefined;\n  defaultTemperature?: number | undefined;\n  stream?: boolean | undefined;\n  emit?: boolean | undefined;\n  nodeId?: string | undefined;\n  emitEvent?: ((event: string, payload: unknown) => void) | undefined;\n  onTextChunk?: ((text: string) => void) | undefined;\n  id?: string | undefined;\n  opId?: string | undefined;\n  segmentId?: string | undefined;\n  telemetry?: KortyxTraceMetadata | undefined;\n  reasonTrace?: ReasonTraceAdapter | undefined;\n}\n\nexport interface RunReasonEngineResult {\n  text: string;\n  raw?: unknown;\n  usage?: KortyxUsage;\n  finishReason?: KortyxFinishReason;\n  toolCalls?: KortyxToolCall[];\n  providerMetadata?: KortyxProviderMetadata;\n  warnings?: KortyxWarning[];\n}\n\nconst toError = (value: unknown): Error =>\n  value instanceof Error ? value : new Error(String(value));\n\nconst createRuntimeId = (): string => {\n  try {\n    return randomUUID();\n  } catch {\n    return `${Date.now()}-${Math.random().toString(36).slice(2)}`;\n  }\n};\n\nconst emitNodeEvent = (\n  emitEvent: RunReasonEngineArgs[\"emitEvent\"],\n  nodeId: string | undefined,\n  event: string,\n  payload: Record<string, unknown>,\n): void => {\n  if (!emitEvent) return;\n  emitEvent(event, {\n    ...payload,\n    ...(typeof nodeId === \"string\" && nodeId.length > 0\n      ? { node: nodeId }\n      : {}),\n  });\n};\n\nexport async function runReasonEngine(\n  args: RunReasonEngineArgs,\n): Promise<RunReasonEngineResult> {\n  const stream = args.stream ?? args.model.options?.streaming ?? true;\n  const emit = args.emit ?? true;\n  const temperature =\n    args.temperature ??\n    args.model.options?.temperature ??\n    args.defaultTemperature;\n  const maxOutputTokens =\n    args.maxOutputTokens ?? args.model.options?.maxOutputTokens;\n  const stopSequences = args.stopSequences ?? args.model.options?.stopSequences;\n  const abortSignal = args.abortSignal ?? args.model.options?.abortSignal;\n  const reasoning = args.reasoning ?? args.model.options?.reasoning;\n  const responseFormat =\n    args.responseFormat ?? args.model.options?.responseFormat;\n  const providerOptions =\n    args.providerOptions ?? args.model.options?.providerOptions;\n  const tools = args.tools ?? args.model.options?.tools;\n\n  const model = args.model.provider.getModel(args.model.modelId, {\n    ...(temperature !== undefined ? { temperature } : {}),\n    streaming: stream,\n    ...(maxOutputTokens !== undefined ? { maxOutputTokens } : {}),\n    ...(stopSequences !== undefined ? { stopSequences } : {}),\n    ...(abortSignal !== undefined ? { abortSignal } : {}),\n    ...(reasoning !== undefined ? { reasoning } : {}),\n    ...(responseFormat !== undefined ? { responseFormat } : {}),\n    ...(tools !== undefined ? { tools } : {}),\n    ...(providerOptions !== undefined ? { providerOptions } : {}),\n  });\n\n  const messages: KortyxPromptMessage[] =\n    args.messages !== undefined\n      ? args.messages\n      : [\n          ...(typeof args.system === \"string\" && args.system.length > 0\n            ? [{ role: \"system\" as const, content: args.system }]\n            : []),\n          { role: \"user\" as const, content: String(args.input ?? \"\") },\n        ];\n\n  const opId =\n    typeof args.opId === \"string\" && args.opId.length > 0\n      ? args.opId\n      : createRuntimeId();\n  const segmentId =\n    typeof args.segmentId === \"string\" && args.segmentId.length > 0\n      ? args.segmentId\n      : createRuntimeId();\n\n  const commonMeta: Record<string, unknown> = {\n    ...(typeof args.id === \"string\" && args.id.length > 0\n      ? { id: args.id }\n      : {}),\n    opId,\n    segmentId,\n  };\n  const traceSpan = args.reasonTrace?.startSpan({\n    name: \"runReasonEngine\",\n    attributes: {\n      ...commonMeta,\n      providerId: args.model.provider.id,\n      modelId: args.model.modelId,\n      stream,\n      emit,\n      ...(args.telemetry?.operation\n        ? { operation: args.telemetry.operation }\n        : {}),\n      ...(args.telemetry?.prompt?.name\n        ? { promptName: args.telemetry.prompt.name }\n        : {}),\n      ...(args.telemetry?.prompt?.version !== undefined\n        ? { promptVersion: args.telemetry.prompt.version }\n        : {}),\n      ...(args.telemetry?.prompt?.type\n        ? { promptType: args.telemetry.prompt.type }\n        : {}),\n      ...(typeof args.nodeId === \"string\" && args.nodeId.length > 0\n        ? { nodeId: args.nodeId }\n        : {}),\n    },\n    telemetry: {\n      ...(args.telemetry ?? {}),\n      input: args.telemetry?.input ?? messages,\n    },\n  });\n\n  const endTrace = (\n    span: ReasonTraceSpan | undefined,\n    result: RunReasonEngineResult,\n  ): void => {\n    span?.end?.({\n      ...(result.usage !== undefined ? { usage: result.usage } : {}),\n      ...(result.finishReason !== undefined\n        ? { finishReason: result.finishReason }\n        : {}),\n      ...(result.providerMetadata !== undefined\n        ? { providerMetadata: result.providerMetadata }\n        : {}),\n      ...(result.warnings !== undefined ? { warnings: result.warnings } : {}),\n      attributes: {\n        textLength: result.text.length,\n      },\n      telemetry: {\n        ...(args.telemetry ?? {}),\n        output: args.telemetry?.output ?? result.text,\n      },\n    });\n  };\n\n  const failTrace = (\n    span: ReasonTraceSpan | undefined,\n    error: unknown,\n  ): void => {\n    span?.fail?.(error, {\n      attributes: {\n        providerId: args.model.provider.id,\n        modelId: args.model.modelId,\n      },\n    });\n  };\n\n  try {\n    if (stream) {\n      let final = \"\";\n      let raw: unknown;\n      let usage: KortyxUsage | undefined;\n      let finishReason: KortyxFinishReason | undefined;\n      let toolCalls: KortyxToolCall[] | undefined;\n      let providerMetadata: KortyxProviderMetadata | undefined;\n      let warnings: KortyxWarning[] | undefined;\n\n      if (emit) {\n        emitNodeEvent(args.emitEvent, args.nodeId, \"text-start\", {\n          ...commonMeta,\n        });\n      }\n\n      const response = await model.stream(messages);\n      for await (const chunk of response) {\n        switch (chunk.type) {\n          case \"text-delta\": {\n            if (chunk.delta.length === 0) break;\n            final += chunk.delta;\n            args.onTextChunk?.(chunk.delta);\n            if (chunk.raw !== undefined) {\n              raw = chunk.raw;\n            }\n            if (chunk.providerMetadata !== undefined) {\n              providerMetadata = chunk.providerMetadata;\n            }\n            if (emit) {\n              emitNodeEvent(args.emitEvent, args.nodeId, \"text-delta\", {\n                ...commonMeta,\n                delta: chunk.delta,\n              });\n            }\n            break;\n          }\n          case \"finish\": {\n            if (chunk.raw !== undefined) {\n              raw = chunk.raw;\n            }\n            if (chunk.usage !== undefined) {\n              usage = chunk.usage;\n            }\n            if (chunk.finishReason !== undefined) {\n              finishReason = chunk.finishReason;\n            }\n            if (chunk.toolCalls !== undefined) {\n              toolCalls = chunk.toolCalls;\n            }\n            if (chunk.providerMetadata !== undefined) {\n              providerMetadata = chunk.providerMetadata;\n            }\n            if (chunk.warnings !== undefined) {\n              warnings = chunk.warnings;\n            }\n            break;\n          }\n          case \"raw\": {\n            raw = chunk.raw;\n            if (chunk.providerMetadata !== undefined) {\n              providerMetadata = chunk.providerMetadata;\n            }\n            break;\n          }\n          case \"error\": {\n            if (chunk.raw !== undefined) {\n              raw = chunk.raw;\n            }\n            if (chunk.providerMetadata !== undefined) {\n              providerMetadata = chunk.providerMetadata;\n            }\n            if (chunk.warnings !== undefined) {\n              warnings = chunk.warnings;\n            }\n            throw toError(chunk.error);\n          }\n        }\n      }\n\n      if (emit) {\n        emitNodeEvent(args.emitEvent, args.nodeId, \"text-end\", {\n          ...commonMeta,\n        });\n      }\n\n      const result = {\n        text: final,\n        ...(raw !== undefined ? { raw } : {}),\n        ...(usage !== undefined ? { usage } : {}),\n        ...(finishReason !== undefined ? { finishReason } : {}),\n        ...(toolCalls !== undefined ? { toolCalls } : {}),\n        ...(providerMetadata !== undefined ? { providerMetadata } : {}),\n        ...(warnings !== undefined ? { warnings } : {}),\n      };\n      endTrace(traceSpan, result);\n      return result;\n    }\n\n    const response = await model.invoke(messages);\n\n    if (emit) {\n      emitNodeEvent(args.emitEvent, args.nodeId, \"text-start\", {\n        ...commonMeta,\n      });\n      if (response.content) {\n        emitNodeEvent(args.emitEvent, args.nodeId, \"text-delta\", {\n          ...commonMeta,\n          delta: response.content,\n        });\n      }\n      emitNodeEvent(args.emitEvent, args.nodeId, \"text-end\", {\n        ...commonMeta,\n      });\n    }\n\n    const result = {\n      text: response.content,\n      ...(response.raw !== undefined ? { raw: response.raw } : {}),\n      ...(response.usage !== undefined ? { usage: response.usage } : {}),\n      ...(response.finishReason !== undefined\n        ? { finishReason: response.finishReason }\n        : {}),\n      ...(response.toolCalls !== undefined\n        ? { toolCalls: response.toolCalls }\n        : {}),\n      ...(response.providerMetadata !== undefined\n        ? { providerMetadata: response.providerMetadata }\n        : {}),\n      ...(response.warnings !== undefined\n        ? { warnings: response.warnings }\n        : {}),\n    };\n    endTrace(traceSpan, result);\n    return result;\n  } catch (error) {\n    failTrace(traceSpan, error);\n    throw error;\n  }\n}\n"],"mappings":"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","names":["response","result"]}
+{"version":3,"sources":["../src/internal.ts","../src/reason-engine.ts"],"sourcesContent":["export type {\n  RunReasonEngineArgs,\n  RunReasonEngineResult,\n} from \"./reason-engine\";\nexport { runReasonEngine } from \"./reason-engine\";\nexport type {\n  KortyxTelemetryConfig,\n  KortyxTraceAdapter,\n  KortyxTraceMetadata,\n  ReasonTraceAdapter,\n} from \"./tracing\";\n","import { randomUUID } from \"node:crypto\";\nimport type {\n  KortyxFinishReason,\n  KortyxPromptMessage,\n  KortyxProviderMetadata,\n  KortyxReasoningOptions,\n  KortyxResponseFormat,\n  KortyxToolCall,\n  KortyxToolDefinition,\n  KortyxUsage,\n  KortyxWarning,\n  ProviderModelRef,\n} from \"@kortyx/providers\";\nimport type {\n  KortyxTraceMetadata,\n  ReasonTraceAdapter,\n  ReasonTraceSpan,\n} from \"./tracing\";\n\nexport interface RunReasonEngineArgs {\n  model: ProviderModelRef;\n  input: string;\n  system?: string | undefined;\n  temperature?: number | undefined;\n  maxOutputTokens?: number | undefined;\n  stopSequences?: string[] | undefined;\n  abortSignal?: AbortSignal | undefined;\n  reasoning?: KortyxReasoningOptions | undefined;\n  responseFormat?: KortyxResponseFormat | undefined;\n  providerOptions?: Record<string, unknown> | undefined;\n  tools?: KortyxToolDefinition[] | undefined;\n  messages?: KortyxPromptMessage[] | undefined;\n  defaultTemperature?: number | undefined;\n  stream?: boolean | undefined;\n  emit?: boolean | undefined;\n  nodeId?: string | undefined;\n  emitEvent?: ((event: string, payload: unknown) => void) | undefined;\n  onTextChunk?: ((text: string) => void) | undefined;\n  id?: string | undefined;\n  opId?: string | undefined;\n  segmentId?: string | undefined;\n  telemetry?: KortyxTraceMetadata | undefined;\n  reasonTrace?: ReasonTraceAdapter | undefined;\n}\n\nexport interface RunReasonEngineResult {\n  text: string;\n  raw?: unknown;\n  usage?: KortyxUsage;\n  finishReason?: KortyxFinishReason;\n  toolCalls?: KortyxToolCall[];\n  providerMetadata?: KortyxProviderMetadata;\n  warnings?: KortyxWarning[];\n}\n\nconst toError = (value: unknown): Error =>\n  value instanceof Error ? value : new Error(String(value));\n\nconst createRuntimeId = (): string => {\n  try {\n    return randomUUID();\n  } catch {\n    return `${Date.now()}-${Math.random().toString(36).slice(2)}`;\n  }\n};\n\nconst emitNodeEvent = (\n  emitEvent: RunReasonEngineArgs[\"emitEvent\"],\n  nodeId: string | undefined,\n  event: string,\n  payload: Record<string, unknown>,\n): void => {\n  if (!emitEvent) return;\n  emitEvent(event, {\n    ...payload,\n    ...(typeof nodeId === \"string\" && nodeId.length > 0\n      ? { node: nodeId }\n      : {}),\n  });\n};\n\nexport async function runReasonEngine(\n  args: RunReasonEngineArgs,\n): Promise<RunReasonEngineResult> {\n  const stream = args.stream ?? args.model.options?.streaming ?? true;\n  const emit = args.emit ?? true;\n  const temperature =\n    args.temperature ??\n    args.model.options?.temperature ??\n    args.defaultTemperature;\n  const maxOutputTokens =\n    args.maxOutputTokens ?? args.model.options?.maxOutputTokens;\n  const stopSequences = args.stopSequences ?? args.model.options?.stopSequences;\n  const abortSignal = args.abortSignal ?? args.model.options?.abortSignal;\n  const reasoning = args.reasoning ?? args.model.options?.reasoning;\n  const responseFormat =\n    args.responseFormat ?? args.model.options?.responseFormat;\n  const providerOptions =\n    args.providerOptions ?? args.model.options?.providerOptions;\n  const tools = args.tools ?? args.model.options?.tools;\n\n  const model = args.model.provider.getModel(args.model.modelId, {\n    ...(temperature !== undefined ? { temperature } : {}),\n    streaming: stream,\n    ...(maxOutputTokens !== undefined ? { maxOutputTokens } : {}),\n    ...(stopSequences !== undefined ? { stopSequences } : {}),\n    ...(abortSignal !== undefined ? { abortSignal } : {}),\n    ...(reasoning !== undefined ? { reasoning } : {}),\n    ...(responseFormat !== undefined ? { responseFormat } : {}),\n    ...(tools !== undefined ? { tools } : {}),\n    ...(providerOptions !== undefined ? { providerOptions } : {}),\n  });\n\n  const messages: KortyxPromptMessage[] =\n    args.messages !== undefined\n      ? args.messages\n      : [\n          ...(typeof args.system === \"string\" && args.system.length > 0\n            ? [{ role: \"system\" as const, content: args.system }]\n            : []),\n          { role: \"user\" as const, content: String(args.input ?? \"\") },\n        ];\n\n  const opId =\n    typeof args.opId === \"string\" && args.opId.length > 0\n      ? args.opId\n      : createRuntimeId();\n  const segmentId =\n    typeof args.segmentId === \"string\" && args.segmentId.length > 0\n      ? args.segmentId\n      : createRuntimeId();\n\n  const commonMeta: Record<string, unknown> = {\n    ...(typeof args.id === \"string\" && args.id.length > 0\n      ? { id: args.id }\n      : {}),\n    opId,\n    segmentId,\n  };\n  const traceSpan = args.reasonTrace?.startSpan({\n    name: \"runReasonEngine\",\n    attributes: {\n      ...commonMeta,\n      providerId: args.model.provider.id,\n      modelId: args.model.modelId,\n      stream,\n      emit,\n      ...(args.telemetry?.operation\n        ? { operation: args.telemetry.operation }\n        : {}),\n      ...(args.telemetry?.prompt?.name\n        ? { promptName: args.telemetry.prompt.name }\n        : {}),\n      ...(args.telemetry?.prompt?.version !== undefined\n        ? { promptVersion: args.telemetry.prompt.version }\n        : {}),\n      ...(args.telemetry?.prompt?.type\n        ? { promptType: args.telemetry.prompt.type }\n        : {}),\n      ...(typeof args.nodeId === \"string\" && args.nodeId.length > 0\n        ? { nodeId: args.nodeId }\n        : {}),\n    },\n    telemetry: {\n      ...(args.telemetry ?? {}),\n      input: args.telemetry?.input ?? messages,\n    },\n  });\n  const modelRequestStartedAt = Date.now();\n  let firstTextTokenAt: number | undefined;\n  let lastTextTokenAt: number | undefined;\n\n  const generationTimingAttributes = (): Record<string, number> =>\n    firstTextTokenAt === undefined || lastTextTokenAt === undefined\n      ? {}\n      : {\n          ttftMs: Math.max(0, firstTextTokenAt - modelRequestStartedAt),\n          streamDurationMs: Math.max(0, lastTextTokenAt - firstTextTokenAt),\n          timeToLastTokenMs: Math.max(\n            0,\n            lastTextTokenAt - modelRequestStartedAt,\n          ),\n        };\n\n  const endTrace = (\n    span: ReasonTraceSpan | undefined,\n    result: RunReasonEngineResult,\n  ): void => {\n    span?.end?.({\n      ...(result.usage !== undefined ? { usage: result.usage } : {}),\n      ...(result.finishReason !== undefined\n        ? { finishReason: result.finishReason }\n        : {}),\n      ...(result.providerMetadata !== undefined\n        ? { providerMetadata: result.providerMetadata }\n        : {}),\n      ...(result.warnings !== undefined ? { warnings: result.warnings } : {}),\n      attributes: {\n        textLength: result.text.length,\n        ...generationTimingAttributes(),\n      },\n      telemetry: {\n        ...(args.telemetry ?? {}),\n        output: args.telemetry?.output ?? result.text,\n      },\n    });\n  };\n\n  const failTrace = (\n    span: ReasonTraceSpan | undefined,\n    error: unknown,\n  ): void => {\n    span?.fail?.(error, {\n      attributes: {\n        providerId: args.model.provider.id,\n        modelId: args.model.modelId,\n      },\n    });\n  };\n\n  try {\n    if (stream) {\n      let final = \"\";\n      let raw: unknown;\n      let usage: KortyxUsage | undefined;\n      let finishReason: KortyxFinishReason | undefined;\n      let toolCalls: KortyxToolCall[] | undefined;\n      let providerMetadata: KortyxProviderMetadata | undefined;\n      let warnings: KortyxWarning[] | undefined;\n\n      if (emit) {\n        emitNodeEvent(args.emitEvent, args.nodeId, \"text-start\", {\n          ...commonMeta,\n        });\n      }\n\n      const response = await model.stream(messages);\n      for await (const chunk of response) {\n        switch (chunk.type) {\n          case \"text-delta\": {\n            if (chunk.delta.length === 0) break;\n            const tokenAt = Date.now();\n            firstTextTokenAt ??= tokenAt;\n            lastTextTokenAt = tokenAt;\n            final += chunk.delta;\n            args.onTextChunk?.(chunk.delta);\n            if (chunk.raw !== undefined) {\n              raw = chunk.raw;\n            }\n            if (chunk.providerMetadata !== undefined) {\n              providerMetadata = chunk.providerMetadata;\n            }\n            if (emit) {\n              emitNodeEvent(args.emitEvent, args.nodeId, \"text-delta\", {\n                ...commonMeta,\n                delta: chunk.delta,\n              });\n            }\n            break;\n          }\n          case \"finish\": {\n            if (chunk.raw !== undefined) {\n              raw = chunk.raw;\n            }\n            if (chunk.usage !== undefined) {\n              usage = chunk.usage;\n            }\n            if (chunk.finishReason !== undefined) {\n              finishReason = chunk.finishReason;\n            }\n            if (chunk.toolCalls !== undefined) {\n              toolCalls = chunk.toolCalls;\n            }\n            if (chunk.providerMetadata !== undefined) {\n              providerMetadata = chunk.providerMetadata;\n            }\n            if (chunk.warnings !== undefined) {\n              warnings = chunk.warnings;\n            }\n            break;\n          }\n          case \"raw\": {\n            raw = chunk.raw;\n            if (chunk.providerMetadata !== undefined) {\n              providerMetadata = chunk.providerMetadata;\n            }\n            break;\n          }\n          case \"error\": {\n            if (chunk.raw !== undefined) {\n              raw = chunk.raw;\n            }\n            if (chunk.providerMetadata !== undefined) {\n              providerMetadata = chunk.providerMetadata;\n            }\n            if (chunk.warnings !== undefined) {\n              warnings = chunk.warnings;\n            }\n            throw toError(chunk.error);\n          }\n        }\n      }\n\n      if (emit) {\n        emitNodeEvent(args.emitEvent, args.nodeId, \"text-end\", {\n          ...commonMeta,\n        });\n      }\n\n      const result = {\n        text: final,\n        ...(raw !== undefined ? { raw } : {}),\n        ...(usage !== undefined ? { usage } : {}),\n        ...(finishReason !== undefined ? { finishReason } : {}),\n        ...(toolCalls !== undefined ? { toolCalls } : {}),\n        ...(providerMetadata !== undefined ? { providerMetadata } : {}),\n        ...(warnings !== undefined ? { warnings } : {}),\n      };\n      endTrace(traceSpan, result);\n      return result;\n    }\n\n    const response = await model.invoke(messages);\n\n    if (emit) {\n      emitNodeEvent(args.emitEvent, args.nodeId, \"text-start\", {\n        ...commonMeta,\n      });\n      if (response.content) {\n        emitNodeEvent(args.emitEvent, args.nodeId, \"text-delta\", {\n          ...commonMeta,\n          delta: response.content,\n        });\n      }\n      emitNodeEvent(args.emitEvent, args.nodeId, \"text-end\", {\n        ...commonMeta,\n      });\n    }\n\n    const result = {\n      text: response.content,\n      ...(response.raw !== undefined ? { raw: response.raw } : {}),\n      ...(response.usage !== undefined ? { usage: response.usage } : {}),\n      ...(response.finishReason !== undefined\n        ? { finishReason: response.finishReason }\n        : {}),\n      ...(response.toolCalls !== undefined\n        ? { toolCalls: response.toolCalls }\n        : {}),\n      ...(response.providerMetadata !== undefined\n        ? { providerMetadata: response.providerMetadata }\n        : {}),\n      ...(response.warnings !== undefined\n        ? { warnings: response.warnings }\n        : {}),\n    };\n    endTrace(traceSpan, result);\n    return result;\n  } catch (error) {\n    failTrace(traceSpan, error);\n    throw error;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,yBAA2B;AAuD3B,IAAM,UAAU,CAAC,UACf,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAE1D,IAAM,kBAAkB,MAAc;AACpC,MAAI;AACF,eAAO,+BAAW;AAAA,EACpB,QAAQ;AACN,WAAO,GAAG,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;AAAA,EAC7D;AACF;AAEA,IAAM,gBAAgB,CACpB,WACA,QACA,OACA,YACS;AACT,MAAI,CAAC,UAAW;AAChB,YAAU,OAAO;AAAA,IACf,GAAG;AAAA,IACH,GAAI,OAAO,WAAW,YAAY,OAAO,SAAS,IAC9C,EAAE,MAAM,OAAO,IACf,CAAC;AAAA,EACP,CAAC;AACH;AAEA,eAAsB,gBACpB,MACgC;AAChC,QAAM,SAAS,KAAK,UAAU,KAAK,MAAM,SAAS,aAAa;AAC/D,QAAM,OAAO,KAAK,QAAQ;AAC1B,QAAM,cACJ,KAAK,eACL,KAAK,MAAM,SAAS,eACpB,KAAK;AACP,QAAM,kBACJ,KAAK,mBAAmB,KAAK,MAAM,SAAS;AAC9C,QAAM,gBAAgB,KAAK,iBAAiB,KAAK,MAAM,SAAS;AAChE,QAAM,cAAc,KAAK,eAAe,KAAK,MAAM,SAAS;AAC5D,QAAM,YAAY,KAAK,aAAa,KAAK,MAAM,SAAS;AACxD,QAAM,iBACJ,KAAK,kBAAkB,KAAK,MAAM,SAAS;AAC7C,QAAM,kBACJ,KAAK,mBAAmB,KAAK,MAAM,SAAS;AAC9C,QAAM,QAAQ,KAAK,SAAS,KAAK,MAAM,SAAS;AAEhD,QAAM,QAAQ,KAAK,MAAM,SAAS,SAAS,KAAK,MAAM,SAAS;AAAA,IAC7D,GAAI,gBAAgB,SAAY,EAAE,YAAY,IAAI,CAAC;AAAA,IACnD,WAAW;AAAA,IACX,GAAI,oBAAoB,SAAY,EAAE,gBAAgB,IAAI,CAAC;AAAA,IAC3D,GAAI,kBAAkB,SAAY,EAAE,cAAc,IAAI,CAAC;AAAA,IACvD,GAAI,gBAAgB,SAAY,EAAE,YAAY,IAAI,CAAC;AAAA,IACnD,GAAI,cAAc,SAAY,EAAE,UAAU,IAAI,CAAC;AAAA,IAC/C,GAAI,mBAAmB,SAAY,EAAE,eAAe,IAAI,CAAC;AAAA,IACzD,GAAI,UAAU,SAAY,EAAE,MAAM,IAAI,CAAC;AAAA,IACvC,GAAI,oBAAoB,SAAY,EAAE,gBAAgB,IAAI,CAAC;AAAA,EAC7D,CAAC;AAED,QAAM,WACJ,KAAK,aAAa,SACd,KAAK,WACL;AAAA,IACE,GAAI,OAAO,KAAK,WAAW,YAAY,KAAK,OAAO,SAAS,IACxD,CAAC,EAAE,MAAM,UAAmB,SAAS,KAAK,OAAO,CAAC,IAClD,CAAC;AAAA,IACL,EAAE,MAAM,QAAiB,SAAS,OAAO,KAAK,SAAS,EAAE,EAAE;AAAA,EAC7D;AAEN,QAAM,OACJ,OAAO,KAAK,SAAS,YAAY,KAAK,KAAK,SAAS,IAChD,KAAK,OACL,gBAAgB;AACtB,QAAM,YACJ,OAAO,KAAK,cAAc,YAAY,KAAK,UAAU,SAAS,IAC1D,KAAK,YACL,gBAAgB;AAEtB,QAAM,aAAsC;AAAA,IAC1C,GAAI,OAAO,KAAK,OAAO,YAAY,KAAK,GAAG,SAAS,IAChD,EAAE,IAAI,KAAK,GAAG,IACd,CAAC;AAAA,IACL;AAAA,IACA;AAAA,EACF;AACA,QAAM,YAAY,KAAK,aAAa,UAAU;AAAA,IAC5C,MAAM;AAAA,IACN,YAAY;AAAA,MACV,GAAG;AAAA,MACH,YAAY,KAAK,MAAM,SAAS;AAAA,MAChC,SAAS,KAAK,MAAM;AAAA,MACpB;AAAA,MACA;AAAA,MACA,GAAI,KAAK,WAAW,YAChB,EAAE,WAAW,KAAK,UAAU,UAAU,IACtC,CAAC;AAAA,MACL,GAAI,KAAK,WAAW,QAAQ,OACxB,EAAE,YAAY,KAAK,UAAU,OAAO,KAAK,IACzC,CAAC;AAAA,MACL,GAAI,KAAK,WAAW,QAAQ,YAAY,SACpC,EAAE,eAAe,KAAK,UAAU,OAAO,QAAQ,IAC/C,CAAC;AAAA,MACL,GAAI,KAAK,WAAW,QAAQ,OACxB,EAAE,YAAY,KAAK,UAAU,OAAO,KAAK,IACzC,CAAC;AAAA,MACL,GAAI,OAAO,KAAK,WAAW,YAAY,KAAK,OAAO,SAAS,IACxD,EAAE,QAAQ,KAAK,OAAO,IACtB,CAAC;AAAA,IACP;AAAA,IACA,WAAW;AAAA,MACT,GAAI,KAAK,aAAa,CAAC;AAAA,MACvB,OAAO,KAAK,WAAW,SAAS;AAAA,IAClC;AAAA,EACF,CAAC;AACD,QAAM,wBAAwB,KAAK,IAAI;AACvC,MAAI;AACJ,MAAI;AAEJ,QAAM,6BAA6B,MACjC,qBAAqB,UAAa,oBAAoB,SAClD,CAAC,IACD;AAAA,IACE,QAAQ,KAAK,IAAI,GAAG,mBAAmB,qBAAqB;AAAA,IAC5D,kBAAkB,KAAK,IAAI,GAAG,kBAAkB,gBAAgB;AAAA,IAChE,mBAAmB,KAAK;AAAA,MACtB;AAAA,MACA,kBAAkB;AAAA,IACpB;AAAA,EACF;AAEN,QAAM,WAAW,CACf,MACA,WACS;AACT,UAAM,MAAM;AAAA,MACV,GAAI,OAAO,UAAU,SAAY,EAAE,OAAO,OAAO,MAAM,IAAI,CAAC;AAAA,MAC5D,GAAI,OAAO,iBAAiB,SACxB,EAAE,cAAc,OAAO,aAAa,IACpC,CAAC;AAAA,MACL,GAAI,OAAO,qBAAqB,SAC5B,EAAE,kBAAkB,OAAO,iBAAiB,IAC5C,CAAC;AAAA,MACL,GAAI,OAAO,aAAa,SAAY,EAAE,UAAU,OAAO,SAAS,IAAI,CAAC;AAAA,MACrE,YAAY;AAAA,QACV,YAAY,OAAO,KAAK;AAAA,QACxB,GAAG,2BAA2B;AAAA,MAChC;AAAA,MACA,WAAW;AAAA,QACT,GAAI,KAAK,aAAa,CAAC;AAAA,QACvB,QAAQ,KAAK,WAAW,UAAU,OAAO;AAAA,MAC3C;AAAA,IACF,CAAC;AAAA,EACH;AAEA,QAAM,YAAY,CAChB,MACA,UACS;AACT,UAAM,OAAO,OAAO;AAAA,MAClB,YAAY;AAAA,QACV,YAAY,KAAK,MAAM,SAAS;AAAA,QAChC,SAAS,KAAK,MAAM;AAAA,MACtB;AAAA,IACF,CAAC;AAAA,EACH;AAEA,MAAI;AACF,QAAI,QAAQ;AACV,UAAI,QAAQ;AACZ,UAAI;AACJ,UAAI;AACJ,UAAI;AACJ,UAAI;AACJ,UAAI;AACJ,UAAI;AAEJ,UAAI,MAAM;AACR,sBAAc,KAAK,WAAW,KAAK,QAAQ,cAAc;AAAA,UACvD,GAAG;AAAA,QACL,CAAC;AAAA,MACH;AAEA,YAAMA,YAAW,MAAM,MAAM,OAAO,QAAQ;AAC5C,uBAAiB,SAASA,WAAU;AAClC,gBAAQ,MAAM,MAAM;AAAA,UAClB,KAAK,cAAc;AACjB,gBAAI,MAAM,MAAM,WAAW,EAAG;AAC9B,kBAAM,UAAU,KAAK,IAAI;AACzB,iCAAqB;AACrB,8BAAkB;AAClB,qBAAS,MAAM;AACf,iBAAK,cAAc,MAAM,KAAK;AAC9B,gBAAI,MAAM,QAAQ,QAAW;AAC3B,oBAAM,MAAM;AAAA,YACd;AACA,gBAAI,MAAM,qBAAqB,QAAW;AACxC,iCAAmB,MAAM;AAAA,YAC3B;AACA,gBAAI,MAAM;AACR,4BAAc,KAAK,WAAW,KAAK,QAAQ,cAAc;AAAA,gBACvD,GAAG;AAAA,gBACH,OAAO,MAAM;AAAA,cACf,CAAC;AAAA,YACH;AACA;AAAA,UACF;AAAA,UACA,KAAK,UAAU;AACb,gBAAI,MAAM,QAAQ,QAAW;AAC3B,oBAAM,MAAM;AAAA,YACd;AACA,gBAAI,MAAM,UAAU,QAAW;AAC7B,sBAAQ,MAAM;AAAA,YAChB;AACA,gBAAI,MAAM,iBAAiB,QAAW;AACpC,6BAAe,MAAM;AAAA,YACvB;AACA,gBAAI,MAAM,cAAc,QAAW;AACjC,0BAAY,MAAM;AAAA,YACpB;AACA,gBAAI,MAAM,qBAAqB,QAAW;AACxC,iCAAmB,MAAM;AAAA,YAC3B;AACA,gBAAI,MAAM,aAAa,QAAW;AAChC,yBAAW,MAAM;AAAA,YACnB;AACA;AAAA,UACF;AAAA,UACA,KAAK,OAAO;AACV,kBAAM,MAAM;AACZ,gBAAI,MAAM,qBAAqB,QAAW;AACxC,iCAAmB,MAAM;AAAA,YAC3B;AACA;AAAA,UACF;AAAA,UACA,KAAK,SAAS;AACZ,gBAAI,MAAM,QAAQ,QAAW;AAC3B,oBAAM,MAAM;AAAA,YACd;AACA,gBAAI,MAAM,qBAAqB,QAAW;AACxC,iCAAmB,MAAM;AAAA,YAC3B;AACA,gBAAI,MAAM,aAAa,QAAW;AAChC,yBAAW,MAAM;AAAA,YACnB;AACA,kBAAM,QAAQ,MAAM,KAAK;AAAA,UAC3B;AAAA,QACF;AAAA,MACF;AAEA,UAAI,MAAM;AACR,sBAAc,KAAK,WAAW,KAAK,QAAQ,YAAY;AAAA,UACrD,GAAG;AAAA,QACL,CAAC;AAAA,MACH;AAEA,YAAMC,UAAS;AAAA,QACb,MAAM;AAAA,QACN,GAAI,QAAQ,SAAY,EAAE,IAAI,IAAI,CAAC;AAAA,QACnC,GAAI,UAAU,SAAY,EAAE,MAAM,IAAI,CAAC;AAAA,QACvC,GAAI,iBAAiB,SAAY,EAAE,aAAa,IAAI,CAAC;AAAA,QACrD,GAAI,cAAc,SAAY,EAAE,UAAU,IAAI,CAAC;AAAA,QAC/C,GAAI,qBAAqB,SAAY,EAAE,iBAAiB,IAAI,CAAC;AAAA,QAC7D,GAAI,aAAa,SAAY,EAAE,SAAS,IAAI,CAAC;AAAA,MAC/C;AACA,eAAS,WAAWA,OAAM;AAC1B,aAAOA;AAAA,IACT;AAEA,UAAM,WAAW,MAAM,MAAM,OAAO,QAAQ;AAE5C,QAAI,MAAM;AACR,oBAAc,KAAK,WAAW,KAAK,QAAQ,cAAc;AAAA,QACvD,GAAG;AAAA,MACL,CAAC;AACD,UAAI,SAAS,SAAS;AACpB,sBAAc,KAAK,WAAW,KAAK,QAAQ,cAAc;AAAA,UACvD,GAAG;AAAA,UACH,OAAO,SAAS;AAAA,QAClB,CAAC;AAAA,MACH;AACA,oBAAc,KAAK,WAAW,KAAK,QAAQ,YAAY;AAAA,QACrD,GAAG;AAAA,MACL,CAAC;AAAA,IACH;AAEA,UAAM,SAAS;AAAA,MACb,MAAM,SAAS;AAAA,MACf,GAAI,SAAS,QAAQ,SAAY,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC;AAAA,MAC1D,GAAI,SAAS,UAAU,SAAY,EAAE,OAAO,SAAS,MAAM,IAAI,CAAC;AAAA,MAChE,GAAI,SAAS,iBAAiB,SAC1B,EAAE,cAAc,SAAS,aAAa,IACtC,CAAC;AAAA,MACL,GAAI,SAAS,cAAc,SACvB,EAAE,WAAW,SAAS,UAAU,IAChC,CAAC;AAAA,MACL,GAAI,SAAS,qBAAqB,SAC9B,EAAE,kBAAkB,SAAS,iBAAiB,IAC9C,CAAC;AAAA,MACL,GAAI,SAAS,aAAa,SACtB,EAAE,UAAU,SAAS,SAAS,IAC9B,CAAC;AAAA,IACP;AACA,aAAS,WAAW,MAAM;AAC1B,WAAO;AAAA,EACT,SAAS,OAAO;AACd,cAAU,WAAW,KAAK;AAC1B,UAAM;AAAA,EACR;AACF;","names":["response","result"]}

package/dist/tracing-DeYHBpY1.d.ts

@@ -0,0 +1,91 @@
+import { KortyxUsage, KortyxFinishReason, KortyxProviderMetadata, KortyxWarning } from '@kortyx/providers';
+import { EnsureWorkflowTopologyRequest as EnsureWorkflowTopologyRequest$1, EnsureWorkflowTopologyResponse as EnsureWorkflowTopologyResponse$1, KortyxTelemetryEvent as KortyxTelemetryEvent$1, KortyxTelemetryService as KortyxTelemetryService$1, KortyxTelemetryEventType as KortyxTelemetryEventType$1 } from '@kortyx/telemetry-contracts';
+
+type ReasonTraceAttributes = Record<string, unknown>;
+type KortyxTelemetryPrompt = {
+    name?: string | undefined;
+    version?: string | number | undefined;
+    type?: "text" | "chat" | (string & {}) | undefined;
+    source?: string | undefined;
+    metadata?: unknown;
+};
+type KortyxTelemetryContentCapture = boolean | {
+    input?: boolean | undefined;
+    output?: boolean | undefined;
+};
+type KortyxTraceMetadata = {
+    operation?: string | undefined;
+    prompt?: KortyxTelemetryPrompt | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    tags?: string[] | undefined;
+    input?: unknown;
+    output?: unknown;
+    captureContent?: KortyxTelemetryContentCapture | undefined;
+};
+interface ReasonTraceSpanStartArgs {
+    name: string;
+    attributes?: ReasonTraceAttributes;
+    telemetry?: KortyxTraceMetadata | undefined;
+}
+interface ReasonTraceSpanEndArgs {
+    attributes?: ReasonTraceAttributes;
+    telemetry?: KortyxTraceMetadata | undefined;
+    usage?: KortyxUsage;
+    finishReason?: KortyxFinishReason;
+    providerMetadata?: KortyxProviderMetadata;
+    warnings?: KortyxWarning[];
+}
+interface ReasonTraceSpan {
+    setAttributes?: (attributes: ReasonTraceAttributes) => void;
+    addEvent?: (name: string, attributes?: ReasonTraceAttributes) => void;
+    end?: (args?: ReasonTraceSpanEndArgs) => void;
+    fail?: (error: unknown, args?: ReasonTraceSpanEndArgs) => void;
+}
+interface ReasonTraceAdapter {
+    startSpan: (args: ReasonTraceSpanStartArgs) => ReasonTraceSpan | undefined;
+    withSpan?: <T>(args: ReasonTraceSpanStartArgs, fn: (span: ReasonTraceSpan) => T | Promise<T>) => Promise<T>;
+    getActiveContext?: () => {
+        traceId: string;
+        spanId: string;
+    } | undefined;
+}
+type KortyxTraceAdapter = ReasonTraceAdapter;
+type KortyxTelemetryService = KortyxTelemetryService$1;
+type EnsureWorkflowTopologyRequest = EnsureWorkflowTopologyRequest$1;
+type EnsureWorkflowTopologyResponse = EnsureWorkflowTopologyResponse$1;
+type KortyxTelemetryEventType = KortyxTelemetryEventType$1;
+type KortyxTelemetryEvent = KortyxTelemetryEvent$1;
+/**
+ * The transport boundary used by the runtime. It deliberately contains only
+ * wire contracts so applications can provide a custom transport without
+ * coupling the SDK to a particular HTTP client or queue.
+ */
+interface KortyxTelemetryReporter {
+    ensureWorkflowTopology: (snapshot: EnsureWorkflowTopologyRequest) => Promise<EnsureWorkflowTopologyResponse>;
+    emit: (events: KortyxTelemetryEvent[]) => Promise<void>;
+    getWorkflowRevisionId?: (args: Pick<EnsureWorkflowTopologyRequest, "environment"> & {
+        workflowId: string;
+        topologyHash: string;
+    }) => string | undefined;
+}
+type KortyxTelemetryCorrelation = {
+    runId?: string | undefined;
+    sessionId?: string | undefined;
+    workflowId?: string | undefined;
+    workflowRevisionId?: string | undefined;
+    topologyHash?: string | undefined;
+    nodeId?: string | undefined;
+};
+type KortyxTelemetryConfig = {
+    trace?: KortyxTraceAdapter | undefined;
+    reporter?: KortyxTelemetryReporter | undefined;
+    environment?: string | undefined;
+    service?: KortyxTelemetryService | undefined;
+    /** Runtime-owned correlation populated while a workflow is resolved. */
+    correlation?: KortyxTelemetryCorrelation | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    tags?: string[] | undefined;
+    captureContent?: KortyxTelemetryContentCapture | undefined;
+};
+
+export type { EnsureWorkflowTopologyRequest as E, KortyxTraceMetadata as K, ReasonTraceAdapter as R, EnsureWorkflowTopologyResponse as a, KortyxTelemetryConfig as b, KortyxTelemetryContentCapture as c, KortyxTelemetryCorrelation as d, KortyxTelemetryEvent as e, KortyxTelemetryEventType as f, KortyxTelemetryPrompt as g, KortyxTelemetryReporter as h, KortyxTelemetryService as i, KortyxTraceAdapter as j, ReasonTraceAttributes as k, ReasonTraceSpan as l, ReasonTraceSpanEndArgs as m, ReasonTraceSpanStartArgs as n };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kortyx/hooks",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "private": false,
   "description": "Lifecycle hooks and extension points for Kortyx.",
   "keywords": [
@@ -38,7 +38,8 @@
   "dependencies": {
     "zod": "^4.3.6",
     "@kortyx/core": "0.5.3",
-    "@kortyx/providers": "0.5.0"
+    "@kortyx/providers": "0.5.0",
+    "@kortyx/telemetry-contracts": "0.2.0"
   },
   "devDependencies": {
     "turbo": "2.6.1",

package/dist/tracing-DhjgeiDS.d.ts

@@ -1,59 +0,0 @@
-import { KortyxUsage, KortyxFinishReason, KortyxProviderMetadata, KortyxWarning } from '@kortyx/providers';
-
-type ReasonTraceAttributes = Record<string, unknown>;
-type KortyxTelemetryPrompt = {
-    name?: string | undefined;
-    version?: string | number | undefined;
-    type?: "text" | "chat" | (string & {}) | undefined;
-    source?: string | undefined;
-    metadata?: unknown;
-};
-type KortyxTelemetryContentCapture = boolean | {
-    input?: boolean | undefined;
-    output?: boolean | undefined;
-};
-type KortyxTraceMetadata = {
-    operation?: string | undefined;
-    prompt?: KortyxTelemetryPrompt | undefined;
-    metadata?: Record<string, unknown> | undefined;
-    tags?: string[] | undefined;
-    input?: unknown;
-    output?: unknown;
-    captureContent?: KortyxTelemetryContentCapture | undefined;
-};
-interface ReasonTraceSpanStartArgs {
-    name: string;
-    attributes?: ReasonTraceAttributes;
-    telemetry?: KortyxTraceMetadata | undefined;
-}
-interface ReasonTraceSpanEndArgs {
-    attributes?: ReasonTraceAttributes;
-    telemetry?: KortyxTraceMetadata | undefined;
-    usage?: KortyxUsage;
-    finishReason?: KortyxFinishReason;
-    providerMetadata?: KortyxProviderMetadata;
-    warnings?: KortyxWarning[];
-}
-interface ReasonTraceSpan {
-    setAttributes?: (attributes: ReasonTraceAttributes) => void;
-    addEvent?: (name: string, attributes?: ReasonTraceAttributes) => void;
-    end?: (args?: ReasonTraceSpanEndArgs) => void;
-    fail?: (error: unknown, args?: ReasonTraceSpanEndArgs) => void;
-}
-interface ReasonTraceAdapter {
-    startSpan: (args: ReasonTraceSpanStartArgs) => ReasonTraceSpan | undefined;
-    withSpan?: <T>(args: ReasonTraceSpanStartArgs, fn: (span: ReasonTraceSpan) => T | Promise<T>) => Promise<T>;
-    getActiveContext?: () => {
-        traceId: string;
-        spanId: string;
-    } | undefined;
-}
-type KortyxTraceAdapter = ReasonTraceAdapter;
-type KortyxTelemetryConfig = {
-    trace?: KortyxTraceAdapter | undefined;
-    metadata?: Record<string, unknown> | undefined;
-    tags?: string[] | undefined;
-    captureContent?: KortyxTelemetryContentCapture | undefined;
-};
-
-export type { KortyxTraceMetadata as K, ReasonTraceAdapter as R, KortyxTelemetryConfig as a, KortyxTelemetryContentCapture as b, KortyxTelemetryPrompt as c, KortyxTraceAdapter as d, ReasonTraceAttributes as e, ReasonTraceSpan as f, ReasonTraceSpanEndArgs as g, ReasonTraceSpanStartArgs as h };