@kortyx/hooks 0.25.2 → 0.26.0

package/dist/internal.d.ts

@@ -1,8 +1,15 @@
+import { l as KortyxTraceErrorProjection, a as KortyxTraceMetadata, R as ReasonTraceAdapter, n as ReasonTraceSpan, p as ReasonTraceSpanStartArgs } from './tracing-BUpf8RrV.js';
+export { K as KortyxTelemetryConfig, k as KortyxTraceAdapter } from './tracing-BUpf8RrV.js';
 import { ProviderModelRef, KortyxReasoningOptions, KortyxResponseFormat, KortyxToolDefinition, KortyxPromptMessage, KortyxContinuation, KortyxUsage, KortyxFinishReason, KortyxToolCall, KortyxProviderMetadata, KortyxWarning } from '@kortyx/providers';
-import { a as KortyxTraceMetadata, R as ReasonTraceAdapter } from './tracing-BI6YKHSf.js';
-export { K as KortyxTelemetryConfig, j as KortyxTraceAdapter } from './tracing-BI6YKHSf.js';
 import '@kortyx/telemetry-contracts';
 
+/** Internal tracing diagnostics only; never changes client-facing failure contracts. */
+declare function errorDiagnostics(error: unknown, project?: KortyxTraceErrorProjection): {
+    errorType?: string;
+    errorMessage?: string;
+};
+declare function isModelTraceSpan(name: string): name is "runReasonEngine" | "useReason";
+
 interface RunReasonEngineArgs {
     model: ProviderModelRef;
     input: string;
@@ -40,4 +47,12 @@ interface RunReasonEngineResult {
 }
 declare function runReasonEngine(args: RunReasonEngineArgs): Promise<RunReasonEngineResult>;
 
-export { KortyxTraceMetadata, ReasonTraceAdapter, type RunReasonEngineArgs, type RunReasonEngineResult, runReasonEngine };
+/** Observation callbacks never participate in execution's error path. */
+declare function safeSpan(span: ReasonTraceSpan | undefined): ReasonTraceSpan;
+declare function safeStartSpan(adapter: Partial<ReasonTraceAdapter> | undefined, args: ReasonTraceSpanStartArgs): ReasonTraceSpan;
+/** Retains active adapter context, and never retries a callback if observation fails. */
+declare function withSafeTraceSpan<T>(adapter: Partial<ReasonTraceAdapter> | undefined, args: ReasonTraceSpanStartArgs, fn: (span: ReasonTraceSpan) => Promise<T>): Promise<T>;
+
+declare function safeTelemetryMetadata(value: Record<string, unknown>): Record<string, unknown>;
+
+export { KortyxTraceMetadata, ReasonTraceAdapter, type RunReasonEngineArgs, type RunReasonEngineResult, errorDiagnostics, isModelTraceSpan, runReasonEngine, safeSpan, safeStartSpan, safeTelemetryMetadata, withSafeTraceSpan };

package/dist/internal.js

@@ -19,18 +19,132 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/internal.ts
 var internal_exports = {};
 __export(internal_exports, {
-  runReasonEngine: () => runReasonEngine
+  errorDiagnostics: () => errorDiagnostics,
+  isModelTraceSpan: () => isModelTraceSpan,
+  runReasonEngine: () => runReasonEngine,
+  safeSpan: () => safeSpan,
+  safeStartSpan: () => safeStartSpan,
+  safeTelemetryMetadata: () => safeTelemetryMetadata,
+  withSafeTraceSpan: () => withSafeTraceSpan
 });
 module.exports = __toCommonJS(internal_exports);
 
+// src/error-diagnostics.ts
+var import_errors = require("@kortyx/core/errors");
+function errorDiagnostics(error, project) {
+  try {
+    const name = (0, import_errors.errorProperty)(error, "name") ?? (error instanceof Error ? error.name : void 0);
+    const message = (0, import_errors.errorProperty)(error, "message");
+    const details = project ? project(error) : {
+      type: typeof name === "string" ? name : "Error",
+      message: typeof error === "string" ? error : typeof message === "string" ? message : "Execution reported a fault."
+    };
+    if (!details) return {};
+    const projectedMessage = details.message;
+    const projectedType = details.type;
+    if (typeof projectedMessage !== "string") return {};
+    return {
+      errorMessage: projectedMessage.slice(0, 8192),
+      ...typeof projectedType === "string" ? { errorType: projectedType.slice(0, 256) } : {}
+    };
+  } catch {
+    return {};
+  }
+}
+function isModelTraceSpan(name) {
+  return name === "runReasonEngine" || name === "useReason";
+}
+
 // src/reason-engine.ts
 var import_node_crypto = require("crypto");
 var import_core = require("@kortyx/core");
-var import_errors = require("@kortyx/core/errors");
+var import_errors2 = require("@kortyx/core/errors");
+
+// src/safe-tracing.ts
+function safeSpan(span) {
+  const guard = (fn) => (...args) => {
+    try {
+      fn?.(...args);
+    } catch {
+    }
+  };
+  let ended = false;
+  const finish = (fn) => (...args) => {
+    if (ended) return;
+    ended = true;
+    guard(fn)(...args);
+  };
+  return {
+    addEvent: guard(
+      (name, attributes) => span?.addEvent?.(name, attributes)
+    ),
+    setAttributes: guard(
+      (attributes) => span?.setAttributes?.(attributes)
+    ),
+    end: finish((args) => span?.end?.(args)),
+    fail: finish((error, args) => {
+      if (span?.fail) span.fail(error, args);
+      else span?.end?.(args);
+    })
+  };
+}
+function safeStartSpan(adapter, args) {
+  try {
+    return safeSpan(adapter?.startSpan?.(args));
+  } catch {
+    return safeSpan(void 0);
+  }
+}
+async function withSafeTraceSpan(adapter, args, fn) {
+  let execution;
+  const invoke = (span) => {
+    execution ??= Promise.resolve().then(async () => {
+      const observed = safeSpan(span);
+      try {
+        const result = await fn(observed);
+        observed.end?.();
+        return result;
+      } catch (error) {
+        observed.fail?.(error);
+        throw error;
+      }
+    });
+    return execution;
+  };
+  let activeScope;
+  try {
+    activeScope = adapter?.withSpan?.bind(adapter);
+  } catch {
+  }
+  if (activeScope) {
+    let started;
+    const invoked = new Promise((resolve) => {
+      started = resolve;
+    });
+    const observe = async () => {
+      try {
+        await activeScope(args, (span) => {
+          const result = invoke(span);
+          started?.();
+          return result;
+        });
+      } catch {
+      }
+    };
+    const observation = observe();
+    if (!execution) await Promise.race([invoked, observation]);
+  } else {
+    await invoke(safeStartSpan(adapter, args)).catch(() => {
+    });
+  }
+  return execution ?? invoke(safeSpan(void 0));
+}
+
+// src/reason-engine.ts
 function assertModelFinish(result) {
   if (result.finishReason?.unified !== "content-filter") return;
   throw Object.assign(
-    new import_errors.KortyxError("PROVIDER_REFUSAL", "The provider refused the request.", {
+    new import_errors2.KortyxError("PROVIDER_REFUSAL", "The provider refused the request.", {
       category: "provider",
       retryable: false,
       safeMessage: "The provider refused the request."
@@ -104,7 +218,7 @@ async function runReasonEngine(args) {
     opId,
     segmentId
   };
-  const traceSpan = args.reasonTrace?.startSpan({
+  const traceSpan = safeStartSpan(args.reasonTrace, {
     name: "runReasonEngine",
     attributes: {
       ...commonMeta,
@@ -307,8 +421,39 @@ async function runReasonEngine(args) {
     throw failure;
   }
 }
+
+// src/telemetry-privacy.ts
+var privateField = /^(?:password|passwd|secret|clientsecret|privatekey|credential|credentials|authorization|bearer|bearertoken|jwt|token|accesstoken|refreshtoken|authtoken|apikey|apisecret|cookie|setcookie|resumehandle|resumetoken)$/;
+function safeTelemetryMetadata(value) {
+  const seen = /* @__PURE__ */ new WeakSet();
+  const visit = (input, depth) => {
+    if (depth > 8 || typeof input === "function" || typeof input === "symbol")
+      return void 0;
+    if (!input || typeof input !== "object") return input;
+    if (seen.has(input)) return void 0;
+    seen.add(input);
+    if (Array.isArray(input))
+      return input.map((item) => visit(item, depth + 1));
+    return Object.fromEntries(
+      Object.entries(input).flatMap(
+        ([key, nested]) => privateField.test(key.toLowerCase().replace(/[^a-z0-9]/g, "")) ? [] : [[key, visit(nested, depth + 1)]]
+      )
+    );
+  };
+  try {
+    return visit(value, 0);
+  } catch {
+    return {};
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  runReasonEngine
+  errorDiagnostics,
+  isModelTraceSpan,
+  runReasonEngine,
+  safeSpan,
+  safeStartSpan,
+  safeTelemetryMetadata,
+  withSafeTraceSpan
 });
 //# sourceMappingURL=internal.js.map

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 {\n  createExecutionCancelledError,\n  throwIfExecutionAborted,\n} from \"@kortyx/core\";\nimport { KortyxError } from \"@kortyx/core/errors\";\nimport type {\n  KortyxContinuation,\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\nfunction assertModelFinish(result: {\n  finishReason?: KortyxFinishReason | undefined;\n  usage?: KortyxUsage | undefined;\n}): void {\n  if (result.finishReason?.unified !== \"content-filter\") return;\n  throw Object.assign(\n    new KortyxError(\"PROVIDER_REFUSAL\", \"The provider refused the request.\", {\n      category: \"provider\",\n      retryable: false,\n      safeMessage: \"The provider refused the request.\",\n    }),\n    {\n      ...(result.usage ? { usage: result.usage } : {}),\n      finishReason: result.finishReason,\n    },\n  );\n}\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  continuation?: KortyxContinuation;\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 const resolveProviderOptions = (\n  defaults: Record<string, unknown> | undefined,\n  overrides: Record<string, unknown> | undefined,\n): Record<string, unknown> | undefined => {\n  const providerOptions =\n    defaults || overrides ? { ...defaults, ...overrides } : undefined;\n  // Provider namespaces inherit model defaults (including transport) while\n  // allowing individual call settings to override them.\n  for (const [key, value] of Object.entries(overrides ?? {})) {\n    const previous = defaults?.[key];\n    if (\n      previous &&\n      value &&\n      typeof previous === \"object\" &&\n      typeof value === \"object\" &&\n      !Array.isArray(previous) &&\n      !Array.isArray(value)\n    ) {\n      if (providerOptions) providerOptions[key] = { ...previous, ...value };\n    }\n  }\n  return providerOptions;\n};\n\nexport async function runReasonEngine(\n  args: RunReasonEngineArgs,\n): Promise<RunReasonEngineResult> {\n  let 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 = resolveProviderOptions(\n    args.model.options?.providerOptions,\n    args.providerOptions,\n  );\n  const tools = args.tools ?? args.model.options?.tools;\n\n  throwIfExecutionAborted(abortSignal);\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  if (tools?.length && !model.supportsToolStreaming) stream = false;\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:\n        args.telemetry?.input ??\n        messages.map(\n          ({ continuation: _continuation, raw: _raw, ...message }) => message,\n        ),\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    const detail = error as Partial<RunReasonEngineResult> | undefined;\n    try {\n      span?.fail?.(error, {\n        ...(detail?.usage ? { usage: detail.usage } : {}),\n        ...(detail?.finishReason ? { finishReason: detail.finishReason } : {}),\n        ...(detail?.providerMetadata\n          ? { providerMetadata: detail.providerMetadata }\n          : {}),\n        attributes: {\n          providerId: args.model.provider.id,\n          modelId: args.model.modelId,\n        },\n      });\n    } catch {\n      /* Reporting must not replace the execution failure. */\n    }\n  };\n\n  try {\n    if (stream) {\n      let continuation: KortyxContinuation | undefined;\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        throwIfExecutionAborted(abortSignal);\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            continuation = chunk.continuation;\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      throwIfExecutionAborted(abortSignal);\n      assertModelFinish({ finishReason, usage });\n      if (emit) {\n        emitNodeEvent(args.emitEvent, args.nodeId, \"text-end\", {\n          ...commonMeta,\n        });\n      }\n\n      const result = {\n        text: final,\n        ...(continuation ? { continuation } : {}),\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      throwIfExecutionAborted(abortSignal);\n      endTrace(traceSpan, result);\n      return result;\n    }\n\n    const response = await model.invoke(messages);\n    throwIfExecutionAborted(abortSignal);\n    assertModelFinish(response);\n    if (response.content) args.onTextChunk?.(response.content);\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.continuation ? { continuation: response.continuation } : {}),\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    const failure = abortSignal?.aborted\n      ? createExecutionCancelledError()\n      : error;\n    failTrace(traceSpan, failure);\n    throw failure;\n  }\n}\n"],"mappings":"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","names":["response","result"]}
+{"version":3,"sources":["../src/internal.ts","../src/error-diagnostics.ts","../src/reason-engine.ts","../src/safe-tracing.ts","../src/telemetry-privacy.ts"],"sourcesContent":["export { errorDiagnostics, isModelTraceSpan } from \"./error-diagnostics\";\nexport type {\n  RunReasonEngineArgs,\n  RunReasonEngineResult,\n} from \"./reason-engine\";\nexport { runReasonEngine } from \"./reason-engine\";\nexport { safeSpan, safeStartSpan, withSafeTraceSpan } from \"./safe-tracing\";\nexport { safeTelemetryMetadata } from \"./telemetry-privacy\";\nexport type {\n  KortyxTelemetryConfig,\n  KortyxTraceAdapter,\n  KortyxTraceMetadata,\n  ReasonTraceAdapter,\n} from \"./tracing\";\n","import { errorProperty } from \"@kortyx/core/errors\";\nimport type { KortyxTraceErrorProjection } from \"./tracing\";\n\n/** Internal tracing diagnostics only; never changes client-facing failure contracts. */\nexport function errorDiagnostics(\n  error: unknown,\n  project?: KortyxTraceErrorProjection,\n): { errorType?: string; errorMessage?: string } {\n  try {\n    const name =\n      errorProperty(error, \"name\") ??\n      (error instanceof Error ? error.name : undefined);\n    const message = errorProperty(error, \"message\");\n    const details = project\n      ? project(error)\n      : {\n          type: typeof name === \"string\" ? name : \"Error\",\n          message:\n            typeof error === \"string\"\n              ? error\n              : typeof message === \"string\"\n                ? message\n                : \"Execution reported a fault.\",\n        };\n    if (!details) return {};\n    const projectedMessage = details.message;\n    const projectedType = details.type;\n    if (typeof projectedMessage !== \"string\") return {};\n    return {\n      errorMessage: projectedMessage.slice(0, 8192),\n      ...(typeof projectedType === \"string\"\n        ? { errorType: projectedType.slice(0, 256) }\n        : {}),\n    };\n  } catch {\n    return {};\n  }\n}\nexport function isModelTraceSpan(name: string) {\n  return name === \"runReasonEngine\" || name === \"useReason\";\n}\n","import { randomUUID } from \"node:crypto\";\nimport {\n  createExecutionCancelledError,\n  throwIfExecutionAborted,\n} from \"@kortyx/core\";\nimport { KortyxError } from \"@kortyx/core/errors\";\nimport type {\n  KortyxContinuation,\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 { safeStartSpan } from \"./safe-tracing\";\nimport type {\n  KortyxTraceMetadata,\n  ReasonTraceAdapter,\n  ReasonTraceSpan,\n} from \"./tracing\";\n\nfunction assertModelFinish(result: {\n  finishReason?: KortyxFinishReason | undefined;\n  usage?: KortyxUsage | undefined;\n}): void {\n  if (result.finishReason?.unified !== \"content-filter\") return;\n  throw Object.assign(\n    new KortyxError(\"PROVIDER_REFUSAL\", \"The provider refused the request.\", {\n      category: \"provider\",\n      retryable: false,\n      safeMessage: \"The provider refused the request.\",\n    }),\n    {\n      ...(result.usage ? { usage: result.usage } : {}),\n      finishReason: result.finishReason,\n    },\n  );\n}\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  continuation?: KortyxContinuation;\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 const resolveProviderOptions = (\n  defaults: Record<string, unknown> | undefined,\n  overrides: Record<string, unknown> | undefined,\n): Record<string, unknown> | undefined => {\n  const providerOptions =\n    defaults || overrides ? { ...defaults, ...overrides } : undefined;\n  // Provider namespaces inherit model defaults (including transport) while\n  // allowing individual call settings to override them.\n  for (const [key, value] of Object.entries(overrides ?? {})) {\n    const previous = defaults?.[key];\n    if (\n      previous &&\n      value &&\n      typeof previous === \"object\" &&\n      typeof value === \"object\" &&\n      !Array.isArray(previous) &&\n      !Array.isArray(value)\n    ) {\n      if (providerOptions) providerOptions[key] = { ...previous, ...value };\n    }\n  }\n  return providerOptions;\n};\n\nexport async function runReasonEngine(\n  args: RunReasonEngineArgs,\n): Promise<RunReasonEngineResult> {\n  let 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 = resolveProviderOptions(\n    args.model.options?.providerOptions,\n    args.providerOptions,\n  );\n  const tools = args.tools ?? args.model.options?.tools;\n\n  throwIfExecutionAborted(abortSignal);\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  if (tools?.length && !model.supportsToolStreaming) stream = false;\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 = safeStartSpan(args.reasonTrace, {\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:\n        args.telemetry?.input ??\n        messages.map(\n          ({ continuation: _continuation, raw: _raw, ...message }) => message,\n        ),\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    const detail = error as Partial<RunReasonEngineResult> | undefined;\n    try {\n      span?.fail?.(error, {\n        ...(detail?.usage ? { usage: detail.usage } : {}),\n        ...(detail?.finishReason ? { finishReason: detail.finishReason } : {}),\n        ...(detail?.providerMetadata\n          ? { providerMetadata: detail.providerMetadata }\n          : {}),\n        attributes: {\n          providerId: args.model.provider.id,\n          modelId: args.model.modelId,\n        },\n      });\n    } catch {\n      /* Reporting must not replace the execution failure. */\n    }\n  };\n\n  try {\n    if (stream) {\n      let continuation: KortyxContinuation | undefined;\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        throwIfExecutionAborted(abortSignal);\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            continuation = chunk.continuation;\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      throwIfExecutionAborted(abortSignal);\n      assertModelFinish({ finishReason, usage });\n      if (emit) {\n        emitNodeEvent(args.emitEvent, args.nodeId, \"text-end\", {\n          ...commonMeta,\n        });\n      }\n\n      const result = {\n        text: final,\n        ...(continuation ? { continuation } : {}),\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      throwIfExecutionAborted(abortSignal);\n      endTrace(traceSpan, result);\n      return result;\n    }\n\n    const response = await model.invoke(messages);\n    throwIfExecutionAborted(abortSignal);\n    assertModelFinish(response);\n    if (response.content) args.onTextChunk?.(response.content);\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.continuation ? { continuation: response.continuation } : {}),\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    const failure = abortSignal?.aborted\n      ? createExecutionCancelledError()\n      : error;\n    failTrace(traceSpan, failure);\n    throw failure;\n  }\n}\n","import type {\n  ReasonTraceAdapter,\n  ReasonTraceAttributes,\n  ReasonTraceSpan,\n  ReasonTraceSpanEndArgs,\n  ReasonTraceSpanStartArgs,\n} from \"./tracing\";\n\n/** Observation callbacks never participate in execution's error path. */\nexport function safeSpan(span: ReasonTraceSpan | undefined): ReasonTraceSpan {\n  const guard =\n    <T extends unknown[]>(fn: ((...args: T) => void) | undefined) =>\n    (...args: T) => {\n      try {\n        fn?.(...args);\n      } catch {}\n    };\n  let ended = false;\n  const finish =\n    <T extends unknown[]>(fn: ((...args: T) => void) | undefined) =>\n    (...args: T) => {\n      if (ended) return;\n      ended = true;\n      guard(fn)(...args);\n    };\n  return {\n    addEvent: guard((name: string, attributes?: ReasonTraceAttributes) =>\n      span?.addEvent?.(name, attributes),\n    ),\n    setAttributes: guard((attributes: ReasonTraceAttributes) =>\n      span?.setAttributes?.(attributes),\n    ),\n    end: finish((args?: ReasonTraceSpanEndArgs) => span?.end?.(args)),\n    fail: finish((error: unknown, args?: ReasonTraceSpanEndArgs) => {\n      if (span?.fail) span.fail(error, args);\n      else span?.end?.(args);\n    }),\n  };\n}\n\nexport function safeStartSpan(\n  adapter: Partial<ReasonTraceAdapter> | undefined,\n  args: ReasonTraceSpanStartArgs,\n): ReasonTraceSpan {\n  try {\n    return safeSpan(adapter?.startSpan?.(args));\n  } catch {\n    return safeSpan(undefined);\n  }\n}\n\n/** Retains active adapter context, and never retries a callback if observation fails. */\nexport async function withSafeTraceSpan<T>(\n  adapter: Partial<ReasonTraceAdapter> | undefined,\n  args: ReasonTraceSpanStartArgs,\n  fn: (span: ReasonTraceSpan) => Promise<T>,\n): Promise<T> {\n  let execution: Promise<T> | undefined;\n  const invoke = (span: ReasonTraceSpan) => {\n    execution ??= Promise.resolve().then(async () => {\n      const observed = safeSpan(span);\n      try {\n        const result = await fn(observed);\n        observed.end?.();\n        return result;\n      } catch (error) {\n        observed.fail?.(error);\n        throw error;\n      }\n    });\n    return execution;\n  };\n  let activeScope: ReasonTraceAdapter[\"withSpan\"];\n  try {\n    activeScope = adapter?.withSpan?.bind(adapter);\n  } catch {}\n  if (activeScope) {\n    let started: (() => void) | undefined;\n    const invoked = new Promise<void>((resolve) => {\n      started = resolve;\n    });\n    const observe = async () => {\n      try {\n        await activeScope(args, (span) => {\n          const result = invoke(span);\n          started?.();\n          return result;\n        });\n      } catch {\n        /* The execution promise preserves its own failure. */\n      }\n    };\n    const observation = observe();\n    // Delivery or adapter work after the callback must not hold up execution.\n    if (!execution) await Promise.race([invoked, observation]);\n  } else {\n    await invoke(safeStartSpan(adapter, args)).catch(() => {});\n  }\n  return execution ?? invoke(safeSpan(undefined));\n}\n","/** Strip credential-shaped fields before metadata reaches any adapter/exporter. */\nconst privateField =\n  /^(?:password|passwd|secret|clientsecret|privatekey|credential|credentials|authorization|bearer|bearertoken|jwt|token|accesstoken|refreshtoken|authtoken|apikey|apisecret|cookie|setcookie|resumehandle|resumetoken)$/;\nexport function safeTelemetryMetadata(\n  value: Record<string, unknown>,\n): Record<string, unknown> {\n  const seen = new WeakSet<object>();\n  const visit = (input: unknown, depth: number): unknown => {\n    if (depth > 8 || typeof input === \"function\" || typeof input === \"symbol\")\n      return undefined;\n    if (!input || typeof input !== \"object\") return input;\n    if (seen.has(input)) return undefined;\n    seen.add(input);\n    if (Array.isArray(input))\n      return input.map((item) => visit(item, depth + 1));\n    return Object.fromEntries(\n      Object.entries(input).flatMap(([key, nested]) =>\n        privateField.test(key.toLowerCase().replace(/[^a-z0-9]/g, \"\"))\n          ? []\n          : [[key, visit(nested, depth + 1)]],\n      ),\n    );\n  };\n  try {\n    return visit(value, 0) as Record<string, unknown>;\n  } catch {\n    return {};\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,oBAA8B;AAIvB,SAAS,iBACd,OACA,SAC+C;AAC/C,MAAI;AACF,UAAM,WACJ,6BAAc,OAAO,MAAM,MAC1B,iBAAiB,QAAQ,MAAM,OAAO;AACzC,UAAM,cAAU,6BAAc,OAAO,SAAS;AAC9C,UAAM,UAAU,UACZ,QAAQ,KAAK,IACb;AAAA,MACE,MAAM,OAAO,SAAS,WAAW,OAAO;AAAA,MACxC,SACE,OAAO,UAAU,WACb,QACA,OAAO,YAAY,WACjB,UACA;AAAA,IACV;AACJ,QAAI,CAAC,QAAS,QAAO,CAAC;AACtB,UAAM,mBAAmB,QAAQ;AACjC,UAAM,gBAAgB,QAAQ;AAC9B,QAAI,OAAO,qBAAqB,SAAU,QAAO,CAAC;AAClD,WAAO;AAAA,MACL,cAAc,iBAAiB,MAAM,GAAG,IAAI;AAAA,MAC5C,GAAI,OAAO,kBAAkB,WACzB,EAAE,WAAW,cAAc,MAAM,GAAG,GAAG,EAAE,IACzC,CAAC;AAAA,IACP;AAAA,EACF,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AACO,SAAS,iBAAiB,MAAc;AAC7C,SAAO,SAAS,qBAAqB,SAAS;AAChD;;;ACxCA,yBAA2B;AAC3B,kBAGO;AACP,IAAAA,iBAA4B;;;ACIrB,SAAS,SAAS,MAAoD;AAC3E,QAAM,QACJ,CAAsB,OACtB,IAAI,SAAY;AACd,QAAI;AACF,WAAK,GAAG,IAAI;AAAA,IACd,QAAQ;AAAA,IAAC;AAAA,EACX;AACF,MAAI,QAAQ;AACZ,QAAM,SACJ,CAAsB,OACtB,IAAI,SAAY;AACd,QAAI,MAAO;AACX,YAAQ;AACR,UAAM,EAAE,EAAE,GAAG,IAAI;AAAA,EACnB;AACF,SAAO;AAAA,IACL,UAAU;AAAA,MAAM,CAAC,MAAc,eAC7B,MAAM,WAAW,MAAM,UAAU;AAAA,IACnC;AAAA,IACA,eAAe;AAAA,MAAM,CAAC,eACpB,MAAM,gBAAgB,UAAU;AAAA,IAClC;AAAA,IACA,KAAK,OAAO,CAAC,SAAkC,MAAM,MAAM,IAAI,CAAC;AAAA,IAChE,MAAM,OAAO,CAAC,OAAgB,SAAkC;AAC9D,UAAI,MAAM,KAAM,MAAK,KAAK,OAAO,IAAI;AAAA,UAChC,OAAM,MAAM,IAAI;AAAA,IACvB,CAAC;AAAA,EACH;AACF;AAEO,SAAS,cACd,SACA,MACiB;AACjB,MAAI;AACF,WAAO,SAAS,SAAS,YAAY,IAAI,CAAC;AAAA,EAC5C,QAAQ;AACN,WAAO,SAAS,MAAS;AAAA,EAC3B;AACF;AAGA,eAAsB,kBACpB,SACA,MACA,IACY;AACZ,MAAI;AACJ,QAAM,SAAS,CAAC,SAA0B;AACxC,kBAAc,QAAQ,QAAQ,EAAE,KAAK,YAAY;AAC/C,YAAM,WAAW,SAAS,IAAI;AAC9B,UAAI;AACF,cAAM,SAAS,MAAM,GAAG,QAAQ;AAChC,iBAAS,MAAM;AACf,eAAO;AAAA,MACT,SAAS,OAAO;AACd,iBAAS,OAAO,KAAK;AACrB,cAAM;AAAA,MACR;AAAA,IACF,CAAC;AACD,WAAO;AAAA,EACT;AACA,MAAI;AACJ,MAAI;AACF,kBAAc,SAAS,UAAU,KAAK,OAAO;AAAA,EAC/C,QAAQ;AAAA,EAAC;AACT,MAAI,aAAa;AACf,QAAI;AACJ,UAAM,UAAU,IAAI,QAAc,CAAC,YAAY;AAC7C,gBAAU;AAAA,IACZ,CAAC;AACD,UAAM,UAAU,YAAY;AAC1B,UAAI;AACF,cAAM,YAAY,MAAM,CAAC,SAAS;AAChC,gBAAM,SAAS,OAAO,IAAI;AAC1B,oBAAU;AACV,iBAAO;AAAA,QACT,CAAC;AAAA,MACH,QAAQ;AAAA,MAER;AAAA,IACF;AACA,UAAM,cAAc,QAAQ;AAE5B,QAAI,CAAC,UAAW,OAAM,QAAQ,KAAK,CAAC,SAAS,WAAW,CAAC;AAAA,EAC3D,OAAO;AACL,UAAM,OAAO,cAAc,SAAS,IAAI,CAAC,EAAE,MAAM,MAAM;AAAA,IAAC,CAAC;AAAA,EAC3D;AACA,SAAO,aAAa,OAAO,SAAS,MAAS,CAAC;AAChD;;;ADzEA,SAAS,kBAAkB,QAGlB;AACP,MAAI,OAAO,cAAc,YAAY,iBAAkB;AACvD,QAAM,OAAO;AAAA,IACX,IAAI,2BAAY,oBAAoB,qCAAqC;AAAA,MACvE,UAAU;AAAA,MACV,WAAW;AAAA,MACX,aAAa;AAAA,IACf,CAAC;AAAA,IACD;AAAA,MACE,GAAI,OAAO,QAAQ,EAAE,OAAO,OAAO,MAAM,IAAI,CAAC;AAAA,MAC9C,cAAc,OAAO;AAAA,IACvB;AAAA,EACF;AACF;AAuCA,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;AAEO,IAAM,yBAAyB,CACpC,UACA,cACwC;AACxC,QAAM,kBACJ,YAAY,YAAY,EAAE,GAAG,UAAU,GAAG,UAAU,IAAI;AAG1D,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,aAAa,CAAC,CAAC,GAAG;AAC1D,UAAM,WAAW,WAAW,GAAG;AAC/B,QACE,YACA,SACA,OAAO,aAAa,YACpB,OAAO,UAAU,YACjB,CAAC,MAAM,QAAQ,QAAQ,KACvB,CAAC,MAAM,QAAQ,KAAK,GACpB;AACA,UAAI,gBAAiB,iBAAgB,GAAG,IAAI,EAAE,GAAG,UAAU,GAAG,MAAM;AAAA,IACtE;AAAA,EACF;AACA,SAAO;AACT;AAEA,eAAsB,gBACpB,MACgC;AAChC,MAAI,SAAS,KAAK,UAAU,KAAK,MAAM,SAAS,aAAa;AAC7D,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,kBAAkB;AAAA,IACtB,KAAK,MAAM,SAAS;AAAA,IACpB,KAAK;AAAA,EACP;AACA,QAAM,QAAQ,KAAK,SAAS,KAAK,MAAM,SAAS;AAEhD,2CAAwB,WAAW;AACnC,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,MAAI,OAAO,UAAU,CAAC,MAAM,sBAAuB,UAAS;AAE5D,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,cAAc,KAAK,aAAa;AAAA,IAChD,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,OACE,KAAK,WAAW,SAChB,SAAS;AAAA,QACP,CAAC,EAAE,cAAc,eAAe,KAAK,MAAM,GAAG,QAAQ,MAAM;AAAA,MAC9D;AAAA,IACJ;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,SAAS;AACf,QAAI;AACF,YAAM,OAAO,OAAO;AAAA,QAClB,GAAI,QAAQ,QAAQ,EAAE,OAAO,OAAO,MAAM,IAAI,CAAC;AAAA,QAC/C,GAAI,QAAQ,eAAe,EAAE,cAAc,OAAO,aAAa,IAAI,CAAC;AAAA,QACpE,GAAI,QAAQ,mBACR,EAAE,kBAAkB,OAAO,iBAAiB,IAC5C,CAAC;AAAA,QACL,YAAY;AAAA,UACV,YAAY,KAAK,MAAM,SAAS;AAAA,UAChC,SAAS,KAAK,MAAM;AAAA,QACtB;AAAA,MACF,CAAC;AAAA,IACH,QAAQ;AAAA,IAER;AAAA,EACF;AAEA,MAAI;AACF,QAAI,QAAQ;AACV,UAAI;AACJ,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,YAAMC,YAAW,MAAM,MAAM,OAAO,QAAQ;AAC5C,uBAAiB,SAASA,WAAU;AAClC,iDAAwB,WAAW;AACnC,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,2BAAe,MAAM;AACrB,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,+CAAwB,WAAW;AACnC,wBAAkB,EAAE,cAAc,MAAM,CAAC;AACzC,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,eAAe,EAAE,aAAa,IAAI,CAAC;AAAA,QACvC,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,+CAAwB,WAAW;AACnC,eAAS,WAAWA,OAAM;AAC1B,aAAOA;AAAA,IACT;AAEA,UAAM,WAAW,MAAM,MAAM,OAAO,QAAQ;AAC5C,6CAAwB,WAAW;AACnC,sBAAkB,QAAQ;AAC1B,QAAI,SAAS,QAAS,MAAK,cAAc,SAAS,OAAO;AAEzD,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,eAAe,EAAE,cAAc,SAAS,aAAa,IAAI,CAAC;AAAA,MACvE,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,UAAM,UAAU,aAAa,cACzB,2CAA8B,IAC9B;AACJ,cAAU,WAAW,OAAO;AAC5B,UAAM;AAAA,EACR;AACF;;;AE5bA,IAAM,eACJ;AACK,SAAS,sBACd,OACyB;AACzB,QAAM,OAAO,oBAAI,QAAgB;AACjC,QAAM,QAAQ,CAAC,OAAgB,UAA2B;AACxD,QAAI,QAAQ,KAAK,OAAO,UAAU,cAAc,OAAO,UAAU;AAC/D,aAAO;AACT,QAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAI,KAAK,IAAI,KAAK,EAAG,QAAO;AAC5B,SAAK,IAAI,KAAK;AACd,QAAI,MAAM,QAAQ,KAAK;AACrB,aAAO,MAAM,IAAI,CAAC,SAAS,MAAM,MAAM,QAAQ,CAAC,CAAC;AACnD,WAAO,OAAO;AAAA,MACZ,OAAO,QAAQ,KAAK,EAAE;AAAA,QAAQ,CAAC,CAAC,KAAK,MAAM,MACzC,aAAa,KAAK,IAAI,YAAY,EAAE,QAAQ,cAAc,EAAE,CAAC,IACzD,CAAC,IACD,CAAC,CAAC,KAAK,MAAM,QAAQ,QAAQ,CAAC,CAAC,CAAC;AAAA,MACtC;AAAA,IACF;AAAA,EACF;AACA,MAAI;AACF,WAAO,MAAM,OAAO,CAAC;AAAA,EACvB,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;","names":["import_errors","response","result"]}

package/dist/{tracing-BI6YKHSf.d.ts → tracing-BUpf8RrV.d.ts}

@@ -1,6 +1,12 @@
 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 KortyxErrorDetails = {
+    type?: string | undefined;
+    message: string;
+};
+/** Optional override for automatically captured model fault diagnostics. */
+type KortyxTraceErrorProjection = (error: unknown) => KortyxErrorDetails | null;
 type ReasonTraceAttributes = Record<string, unknown>;
 type KortyxTelemetryPrompt = {
     name?: string | undefined;
@@ -91,4 +97,4 @@ type KortyxTelemetryConfig = {
     captureContent?: KortyxTelemetryContentCapture | undefined;
 };
 
-export type { EnsureWorkflowTopologyRequest as E, KortyxTelemetryConfig as K, ReasonTraceAdapter as R, KortyxTraceMetadata as a, KortyxTelemetryEventType as b, EnsureWorkflowTopologyResponse as c, KortyxTelemetryContentCapture as d, KortyxTelemetryCorrelation as e, KortyxTelemetryEvent 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 };
+export type { EnsureWorkflowTopologyRequest as E, KortyxTelemetryConfig as K, ReasonTraceAdapter as R, KortyxTraceMetadata as a, KortyxTelemetryEventType as b, EnsureWorkflowTopologyResponse as c, KortyxErrorDetails as d, KortyxTelemetryContentCapture as e, KortyxTelemetryCorrelation as f, KortyxTelemetryEvent as g, KortyxTelemetryPrompt as h, KortyxTelemetryReporter as i, KortyxTelemetryService as j, KortyxTraceAdapter as k, KortyxTraceErrorProjection as l, ReasonTraceAttributes as m, ReasonTraceSpan as n, ReasonTraceSpanEndArgs as o, ReasonTraceSpanStartArgs as p };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kortyx/hooks",
-  "version": "0.25.2",
+  "version": "0.26.0",
   "private": false,
   "description": "Lifecycle hooks and extension points for Kortyx.",
   "keywords": [
@@ -38,8 +38,8 @@
   "dependencies": {
     "zod": "^4.3.6",
     "@kortyx/core": "0.9.0",
-    "@kortyx/providers": "0.7.0",
-    "@kortyx/telemetry-contracts": "0.7.0"
+    "@kortyx/providers": "0.8.0",
+    "@kortyx/telemetry-contracts": "0.9.0"
   },
   "devDependencies": {
     "turbo": "2.6.1",