@kortyx/hooks 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## [0.10.0](https://github.com/kortyx-io/kortyx/compare/hooks-v0.9.1...hooks-v0.10.0) (2026-04-25)
+
+
+### Features
+
+* **google, hooks:** reasoning fallback and structured reason parsing ([b12d404](https://github.com/kortyx-io/kortyx/commit/b12d404d42c184f5dd076d00ccf8af28bb463d45))
+* **hooks:** track reason usage and tracing spans ([7dd9bf1](https://github.com/kortyx-io/kortyx/commit/7dd9bf1a207c7ce127cb64a090cf9b123924d1c6))
+* **providers:** normalize reason model call metadata ([1a59e64](https://github.com/kortyx-io/kortyx/commit/1a59e6438c555a7536128501114a1382e6f90be4))
+* **providers:** use provider instances in model refs ([e6183f0](https://github.com/kortyx-io/kortyx/commit/e6183f06b17c66e35cc336ef05019148ac631390))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @kortyx/providers bumped to 0.4.0
+
+## [0.9.1](https://github.com/kortyx-io/kortyx/compare/hooks-v0.9.0...hooks-v0.9.1) (2026-04-22)
+
+
+### Bug Fixes
+
+* **stream:** enforce structured chunk contract semantics ([bdbc518](https://github.com/kortyx-io/kortyx/commit/bdbc518366baacddb1a2ebb890b19e6564e2bee4))
+* **stream:** enforce structured chunk contract semantics ([249d6e4](https://github.com/kortyx-io/kortyx/commit/249d6e47e1960debb0f396a4e7251bf9df38d7d2))
+
 ## [0.9.0](https://github.com/kortyx-io/kortyx/compare/hooks-v0.8.0...hooks-v0.9.0) (2026-04-17)
 
 

package/dist/index.d.ts

@@ -1,10 +1,12 @@
 import { NodeContext, GraphState, InterruptInput, InterruptResult } from '@kortyx/core';
-import { GetProviderFn, ProviderModelRef } from '@kortyx/providers';
+import { R as ReasonTraceAdapter } from './tracing-BG-j1cer.js';
+export { a as ReasonTraceAttributes, b as ReasonTraceSpan, c as ReasonTraceSpanEndArgs, d as ReasonTraceSpanStartArgs } from './tracing-BG-j1cer.js';
+import { ProviderModelRef, KortyxReasoningOptions, KortyxResponseFormat, KortyxUsage, KortyxFinishReason, KortyxProviderMetadata, KortyxWarning } from '@kortyx/providers';
 
 type HookRuntimeContext = {
     node: NodeContext;
     state: GraphState;
-    getProvider?: GetProviderFn;
+    reasonTrace?: ReasonTraceAdapter | undefined;
 };
 declare function runWithHookContext<T>(ctx: HookRuntimeContext, fn: () => Promise<T>): Promise<{
     result: T;
@@ -22,6 +24,10 @@ type SchemaLike<T> = {
         };
     };
 };
+type StructuredPath = string;
+type UseReasonStructuredFieldMode = "append" | "text-delta" | "set";
+type UseReasonStructuredFieldKey = string;
+type UseReasonStructuredFields = Record<UseReasonStructuredFieldKey, UseReasonStructuredFieldMode>;
 type UseStructuredDataBaseArgs = {
     dataType?: string | undefined;
     schemaId?: string | undefined;
@@ -36,19 +42,19 @@ type UseStructuredDataFinalArgs<TData = unknown> = UseStructuredDataBaseArgs & {
 };
 type UseStructuredDataSetArgs<TValue = unknown> = UseStructuredDataBaseArgs & {
     kind: "set";
-    path: string;
+    path: StructuredPath;
     value: TValue;
     valueSchema?: SchemaLike<TValue> | undefined;
 };
 type UseStructuredDataAppendArgs<TItem = unknown> = UseStructuredDataBaseArgs & {
     kind: "append";
-    path: string;
+    path: StructuredPath;
     items: TItem[];
     itemSchema?: SchemaLike<TItem> | undefined;
 };
 type UseStructuredDataTextDeltaArgs = UseStructuredDataBaseArgs & {
     kind: "text-delta";
-    path: string;
+    path: StructuredPath;
     delta: string;
 };
 type UseStructuredDataArgs<TData = unknown, TValue = unknown, TItem = unknown> = UseStructuredDataFinalArgs<TData> | UseStructuredDataSetArgs<TValue> | UseStructuredDataAppendArgs<TItem> | UseStructuredDataTextDeltaArgs;
@@ -58,7 +64,12 @@ type UseReasonStructuredConfig = {
     dataType?: string | undefined;
     schemaId?: string | undefined;
     schemaVersion?: string | undefined;
-    fields?: Record<string, "append" | "text-delta" | "set"> | undefined;
+    /**
+     * Incremental extraction keys for useReason. These are top-level JSON field
+     * names only; dotted paths are reserved for raw structured chunks and
+     * useStructuredData(...).
+     */
+    fields?: UseReasonStructuredFields | undefined;
 };
 type UseReasonInterruptConfig<TRequest extends InterruptInput = InterruptInput, TResponse = InterruptResult> = {
     requestSchema: SchemaLike<TRequest>;
@@ -71,6 +82,12 @@ type UseReasonArgs<TOutput = unknown, TRequest extends InterruptInput = Interrup
     input: string;
     system?: string | undefined;
     temperature?: number | undefined;
+    maxOutputTokens?: number | undefined;
+    stopSequences?: string[] | undefined;
+    abortSignal?: AbortSignal | undefined;
+    reasoning?: KortyxReasoningOptions | undefined;
+    responseFormat?: KortyxResponseFormat | undefined;
+    providerOptions?: Record<string, unknown> | undefined;
     emit?: boolean | undefined;
     stream?: boolean | undefined;
     id?: string | undefined;
@@ -83,6 +100,10 @@ type UseReasonResult<TOutput = unknown, TResponse = InterruptResult> = {
     opId: string;
     text: string;
     raw?: unknown;
+    usage?: KortyxUsage;
+    finishReason?: KortyxFinishReason;
+    providerMetadata?: KortyxProviderMetadata;
+    warnings?: KortyxWarning[];
     output?: TOutput;
     interruptResponse?: TResponse;
 };
@@ -103,4 +124,4 @@ declare function useInterrupt<TRequest extends InterruptInput = InterruptInput,
 declare function useNodeState<T>(initialValue: T): [T, StateSetter<T>];
 declare function useWorkflowState<T>(key: string, ...rest: [] | [T]): [T, StateSetter<T>];
 
-export { type HookRuntimeContext, type UseInterruptArgs, type UseReasonArgs, type UseReasonResult, type UseStructuredDataArgs, runWithHookContext, useInterrupt, useNodeState, useReason, useStructuredData, useWorkflowState };
+export { type HookRuntimeContext, ReasonTraceAdapter, type UseInterruptArgs, type UseReasonArgs, type UseReasonResult, type UseStructuredDataArgs, runWithHookContext, useInterrupt, useNodeState, useReason, useStructuredData, useWorkflowState };