@kortyx/hooks 0.3.0 → 0.4.1

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [0.4.1](https://github.com/kortyx-io/kortyx/compare/hooks-v0.4.0...hooks-v0.4.1) (2026-02-17)
+
+
+### Bug Fixes
+
+* **build:** align package tsconfig with shared lib baseline ([48d2b57](https://github.com/kortyx-io/kortyx/commit/48d2b5765fefbb5fcbbe548e749e7b5f51b450b9))
+* **build:** wire tsup for publishable packages ([e7b1b5c](https://github.com/kortyx-io/kortyx/commit/e7b1b5c28af55becffc137233dd92d8953d7cb8e))
+* **dev:** restore tsc watch flow for local workspace ([4305823](https://github.com/kortyx-io/kortyx/commit/430582372cad466bf28af554042aa11bdb8bf027))
+
+## [0.4.0](https://github.com/kortyx-io/kortyx/compare/hooks-v0.3.0...hooks-v0.4.0) (2026-02-17)
+
+
+### Features
+
+* **agent:** strict createAgent and unify useReason streaming ([6725f97](https://github.com/kortyx-io/kortyx/commit/6725f976fc32083fb7d2590f1353d16a99afb46f))
+
+
+### Bug Fixes
+
+* **hooks:** move reason engine to internal subpath export ([b82f2f2](https://github.com/kortyx-io/kortyx/commit/b82f2f2a93067f91dd010334486eb0f3a3a547b8))
+
 ## [0.3.0](https://github.com/kortyx-io/Kortyx/compare/hooks-v0.2.3...hooks-v0.3.0) (2026-02-07)
 
 

package/dist/index.d.ts

@@ -1,4 +1,41 @@
-export type { HookRuntimeContext } from "./context";
-export { runWithHookContext } from "./context";
-export { useAiInterrupt, useAiMemory, useAiProvider, useEmit, useNodeState, useStructuredData, useWorkflowState, } from "./hooks";
-//# sourceMappingURL=index.d.ts.map
+import { NodeContext, GraphState, InterruptInput, InterruptResult } from '@kortyx/core';
+import { MemoryAdapter } from '@kortyx/memory';
+import { GetProviderFn, ProviderModelRef } from '@kortyx/providers';
+
+type HookRuntimeContext = {
+    node: NodeContext;
+    state: GraphState;
+    getProvider?: GetProviderFn;
+    memoryAdapter?: MemoryAdapter;
+};
+declare function runWithHookContext<T>(ctx: HookRuntimeContext, fn: () => Promise<T>): Promise<{
+    result: T;
+    memoryUpdates: Record<string, unknown> | null;
+}>;
+
+type StateSetter<T> = (next: T | ((prev: T) => T)) => void;
+type UseReasonArgs = {
+    model: ProviderModelRef;
+    input: string;
+    system?: string | undefined;
+    temperature?: number | undefined;
+    emit?: boolean | undefined;
+    stream?: boolean | undefined;
+};
+type UseReasonResult = {
+    text: string;
+    raw?: unknown;
+};
+declare function useEmit(): NodeContext["emit"];
+declare function useStructuredData(args: {
+    data: unknown;
+    dataType?: string | undefined;
+}): void;
+declare function useReason(args: UseReasonArgs): Promise<UseReasonResult>;
+declare function useAiMemory(): MemoryAdapter;
+declare function useAiInterrupt(input: InterruptInput): Promise<InterruptResult>;
+declare function useNodeState<T>(initialValue: T): [T, StateSetter<T>];
+declare function useNodeState<T>(key: string, initialValue?: T): [T, StateSetter<T>];
+declare function useWorkflowState<T>(key: string, initialValue?: T): [T, StateSetter<T>];
+
+export { type HookRuntimeContext, type UseReasonArgs, type UseReasonResult, runWithHookContext, useAiInterrupt, useAiMemory, useEmit, useNodeState, useReason, useStructuredData, useWorkflowState };

package/dist/index.js

@@ -1,13 +1,284 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useWorkflowState = exports.useStructuredData = exports.useNodeState = exports.useEmit = exports.useAiProvider = exports.useAiMemory = exports.useAiInterrupt = exports.runWithHookContext = void 0;
-var context_1 = require("./context");
-Object.defineProperty(exports, "runWithHookContext", { enumerable: true, get: function () { return context_1.runWithHookContext; } });
-var hooks_1 = require("./hooks");
-Object.defineProperty(exports, "useAiInterrupt", { enumerable: true, get: function () { return hooks_1.useAiInterrupt; } });
-Object.defineProperty(exports, "useAiMemory", { enumerable: true, get: function () { return hooks_1.useAiMemory; } });
-Object.defineProperty(exports, "useAiProvider", { enumerable: true, get: function () { return hooks_1.useAiProvider; } });
-Object.defineProperty(exports, "useEmit", { enumerable: true, get: function () { return hooks_1.useEmit; } });
-Object.defineProperty(exports, "useNodeState", { enumerable: true, get: function () { return hooks_1.useNodeState; } });
-Object.defineProperty(exports, "useStructuredData", { enumerable: true, get: function () { return hooks_1.useStructuredData; } });
-Object.defineProperty(exports, "useWorkflowState", { enumerable: true, get: function () { return hooks_1.useWorkflowState; } });
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  runWithHookContext: () => runWithHookContext,
+  useAiInterrupt: () => useAiInterrupt,
+  useAiMemory: () => useAiMemory,
+  useEmit: () => useEmit,
+  useNodeState: () => useNodeState,
+  useReason: () => useReason,
+  useStructuredData: () => useStructuredData,
+  useWorkflowState: () => useWorkflowState
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/context.ts
+var import_node_async_hooks = require("async_hooks");
+var storage = new import_node_async_hooks.AsyncLocalStorage();
+var isRecord = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
+var normalizeNodeState = (value) => {
+  if (Array.isArray(value)) {
+    return { byIndex: [...value], byKey: {} };
+  }
+  if (isRecord(value)) {
+    const byIndex = Array.isArray(value.byIndex) ? [...value.byIndex] : [];
+    const byKey = isRecord(value.byKey) ? { ...value.byKey } : {};
+    return { byIndex, byKey };
+  }
+  return { byIndex: [], byKey: {} };
+};
+var cloneWorkflowState = (value) => isRecord(value) ? { ...value } : {};
+var getHookMemory = (state) => {
+  const memory = state.memory ?? {};
+  const internal = isRecord(memory.__kortyx) ? memory.__kortyx : void 0;
+  const result = {};
+  if (isRecord(internal?.nodeState)) result.nodeState = internal?.nodeState;
+  if (isRecord(internal?.workflowState)) {
+    result.workflowState = internal?.workflowState;
+  }
+  return result;
+};
+var createInternalContext = (ctx) => {
+  const hookMemory = getHookMemory(ctx.state);
+  const nodeId = ctx.node.graph.node;
+  const storedNodeId = typeof hookMemory.nodeState?.nodeId === "string" ? String(hookMemory.nodeState?.nodeId) : "";
+  const storedState = hookMemory.nodeState?.state;
+  const currentNodeState = storedNodeId && storedNodeId === nodeId ? normalizeNodeState(storedState) : { byIndex: [], byKey: {} };
+  return {
+    ...ctx,
+    nodeStateIndex: 0,
+    currentNodeState,
+    workflowState: cloneWorkflowState(hookMemory.workflowState),
+    dirty: false
+  };
+};
+var buildMemoryUpdates = (ctx) => {
+  if (!ctx.dirty) return null;
+  return {
+    __kortyx: {
+      nodeState: {
+        nodeId: ctx.node.graph.node,
+        state: ctx.currentNodeState
+      },
+      workflowState: ctx.workflowState
+    }
+  };
+};
+async function runWithHookContext(ctx, fn) {
+  const internal = createInternalContext(ctx);
+  try {
+    const result = await storage.run(internal, fn);
+    return { result, memoryUpdates: buildMemoryUpdates(internal) };
+  } catch (err) {
+    const memoryUpdates = buildMemoryUpdates(internal);
+    if (memoryUpdates && err && typeof err === "object") {
+      err.__kortyxMemoryUpdates = memoryUpdates;
+    }
+    throw err;
+  }
+}
+function getHookContext() {
+  const ctx = storage.getStore();
+  if (!ctx) {
+    throw new Error("Hooks can only be used while a node is executing.");
+  }
+  return ctx;
+}
+
+// src/reason-engine.ts
+var chunkToText = (chunk) => {
+  if (typeof chunk === "string") return chunk;
+  if (typeof chunk.text === "string") return chunk.text;
+  if (typeof chunk.content === "string") return chunk.content;
+  return "";
+};
+var emitNodeEvent = (emitEvent, nodeId, event, payload) => {
+  if (!emitEvent) return;
+  emitEvent(event, {
+    ...payload,
+    ...typeof nodeId === "string" && nodeId.length > 0 ? { node: nodeId } : {}
+  });
+};
+async function runReasonEngine(args) {
+  const stream = args.stream ?? args.model.options?.streaming ?? true;
+  const emit = args.emit ?? true;
+  const temperature = args.temperature ?? args.model.options?.temperature ?? args.defaultTemperature;
+  const model = args.getProvider(args.model.providerId, args.model.modelId, {
+    ...temperature !== void 0 ? { temperature } : {},
+    streaming: stream
+  });
+  const messages = [];
+  if (typeof args.system === "string" && args.system.length > 0) {
+    messages.push({ role: "system", content: args.system });
+  }
+  messages.push({ role: "user", content: String(args.input ?? "") });
+  if (stream) {
+    let final = "";
+    let raw;
+    if (emit) {
+      emitNodeEvent(args.emitEvent, args.nodeId, "text-start", {});
+    }
+    const response2 = await model.stream(messages);
+    for await (const chunk of response2) {
+      const text = chunkToText(chunk);
+      if (!text) continue;
+      final += text;
+      if (typeof chunk === "object" && chunk && "raw" in chunk) {
+        raw = chunk.raw;
+      }
+      if (emit) {
+        emitNodeEvent(args.emitEvent, args.nodeId, "text-delta", {
+          delta: text
+        });
+      }
+    }
+    if (emit) {
+      emitNodeEvent(args.emitEvent, args.nodeId, "text-end", {});
+    }
+    return {
+      text: final,
+      ...raw !== void 0 ? { raw } : {}
+    };
+  }
+  const response = await model.invoke(messages);
+  if (emit) {
+    emitNodeEvent(args.emitEvent, args.nodeId, "text-start", {});
+    if (response.content) {
+      emitNodeEvent(args.emitEvent, args.nodeId, "text-delta", {
+        delta: response.content
+      });
+    }
+    emitNodeEvent(args.emitEvent, args.nodeId, "text-end", {});
+  }
+  return {
+    text: response.content,
+    ...response.raw !== void 0 ? { raw: response.raw } : {}
+  };
+}
+
+// src/hooks.ts
+function useEmit() {
+  const ctx = getHookContext();
+  return ctx.node.emit;
+}
+function useStructuredData(args) {
+  const ctx = getHookContext();
+  ctx.node.emit("structured_data", {
+    node: ctx.node.graph.node,
+    ...typeof args.dataType === "string" && args.dataType.length > 0 ? { dataType: args.dataType } : {},
+    data: args.data
+  });
+}
+async function reasonEngine(args) {
+  const ctx = getHookContext();
+  const getProvider = ctx.getProvider;
+  if (!getProvider) {
+    throw new Error("useReason requires a provider factory in runtime config.");
+  }
+  return runReasonEngine({
+    getProvider,
+    model: args.model,
+    input: args.input,
+    system: args.system,
+    temperature: args.temperature,
+    defaultTemperature: ctx.node.config?.model?.temperature,
+    stream: args.stream,
+    emit: args.emit,
+    nodeId: ctx.node.graph.node,
+    emitEvent: ctx.node.emit
+  });
+}
+function useReason(args) {
+  return reasonEngine(args);
+}
+function useAiMemory() {
+  const ctx = getHookContext();
+  if (!ctx.memoryAdapter) {
+    throw new Error("useAiMemory requires a memory adapter in runtime config.");
+  }
+  return ctx.memoryAdapter;
+}
+function useAiInterrupt(input) {
+  const ctx = getHookContext();
+  return Promise.resolve(ctx.node.awaitInterrupt(input));
+}
+function useNodeState(keyOrInitial, initialValue) {
+  const ctx = getHookContext();
+  const nodeState = ctx.currentNodeState;
+  if (typeof keyOrInitial === "string") {
+    const key = keyOrInitial;
+    const hasInitial = arguments.length > 1;
+    if (!Object.hasOwn(nodeState.byKey, key) && hasInitial) {
+      nodeState.byKey[key] = initialValue;
+      ctx.dirty = true;
+    }
+    const getValue2 = () => nodeState.byKey[key];
+    const setValue2 = (next) => {
+      const prev = getValue2();
+      const resolved = typeof next === "function" ? next(prev) : next;
+      nodeState.byKey[key] = resolved;
+      ctx.dirty = true;
+    };
+    return [getValue2(), setValue2];
+  }
+  const index = ctx.nodeStateIndex++;
+  if (index >= nodeState.byIndex.length) {
+    nodeState.byIndex[index] = keyOrInitial;
+    ctx.dirty = true;
+  }
+  const getValue = () => nodeState.byIndex[index];
+  const setValue = (next) => {
+    const prev = getValue();
+    const resolved = typeof next === "function" ? next(prev) : next;
+    nodeState.byIndex[index] = resolved;
+    ctx.dirty = true;
+  };
+  return [getValue(), setValue];
+}
+function useWorkflowState(key, initialValue) {
+  const ctx = getHookContext();
+  const workflowState = ctx.workflowState;
+  const hasInitial = arguments.length > 1;
+  if (!Object.hasOwn(workflowState, key) && hasInitial) {
+    workflowState[key] = initialValue;
+    ctx.dirty = true;
+  }
+  const getValue = () => workflowState[key];
+  const setValue = (next) => {
+    const prev = getValue();
+    const resolved = typeof next === "function" ? next(prev) : next;
+    workflowState[key] = resolved;
+    ctx.dirty = true;
+  };
+  return [getValue(), setValue];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  runWithHookContext,
+  useAiInterrupt,
+  useAiMemory,
+  useEmit,
+  useNodeState,
+  useReason,
+  useStructuredData,
+  useWorkflowState
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/context.ts","../src/reason-engine.ts","../src/hooks.ts"],"sourcesContent":["// release-test: 2026-01-22\n/**\n * @kortyx/hooks\n *\n * Internal hook implementations resolved via async-local context.\n */\n\nexport type { HookRuntimeContext } from \"./context\";\nexport { runWithHookContext } from \"./context\";\nexport type { UseReasonArgs, UseReasonResult } from \"./hooks\";\nexport {\n  useAiInterrupt,\n  useAiMemory,\n  useEmit,\n  useNodeState,\n  useReason,\n  useStructuredData,\n  useWorkflowState,\n} from \"./hooks\";\n","import { AsyncLocalStorage } from \"node:async_hooks\";\nimport type { GraphState, NodeContext } from \"@kortyx/core\";\nimport type { MemoryAdapter } from \"@kortyx/memory\";\nimport type { GetProviderFn } from \"@kortyx/providers\";\n\ntype NodeStateStore = {\n  byIndex: unknown[];\n  byKey: Record<string, unknown>;\n};\n\ntype HookMemory = {\n  nodeState?: Record<string, unknown>;\n  workflowState?: Record<string, unknown>;\n};\n\nexport type HookRuntimeContext = {\n  node: NodeContext;\n  state: GraphState;\n  getProvider?: GetProviderFn;\n  memoryAdapter?: MemoryAdapter;\n};\n\ntype HookInternalContext = HookRuntimeContext & {\n  nodeStateIndex: number;\n  currentNodeState: NodeStateStore;\n  workflowState: Record<string, unknown>;\n  dirty: boolean;\n};\n\nconst storage = new AsyncLocalStorage<HookInternalContext>();\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  Boolean(value) && typeof value === \"object\" && !Array.isArray(value);\n\nconst normalizeNodeState = (value: unknown): NodeStateStore => {\n  if (Array.isArray(value)) {\n    return { byIndex: [...value], byKey: {} };\n  }\n\n  if (isRecord(value)) {\n    const byIndex = Array.isArray(value.byIndex) ? [...value.byIndex] : [];\n    const byKey = isRecord(value.byKey) ? { ...value.byKey } : {};\n    return { byIndex, byKey };\n  }\n\n  return { byIndex: [], byKey: {} };\n};\n\nconst cloneWorkflowState = (value: unknown): Record<string, unknown> =>\n  isRecord(value) ? { ...value } : {};\n\nconst getHookMemory = (state: GraphState): HookMemory => {\n  const memory = (state.memory ?? {}) as Record<string, unknown>;\n  const internal = isRecord(memory.__kortyx) ? memory.__kortyx : undefined;\n  const result: HookMemory = {};\n  if (isRecord(internal?.nodeState)) result.nodeState = internal?.nodeState;\n  if (isRecord(internal?.workflowState)) {\n    result.workflowState = internal?.workflowState;\n  }\n  return result;\n};\n\nconst createInternalContext = (\n  ctx: HookRuntimeContext,\n): HookInternalContext => {\n  const hookMemory = getHookMemory(ctx.state);\n  const nodeId = ctx.node.graph.node;\n  const storedNodeId =\n    typeof (hookMemory.nodeState as any)?.nodeId === \"string\"\n      ? String((hookMemory.nodeState as any)?.nodeId)\n      : \"\";\n  const storedState = (hookMemory.nodeState as any)?.state;\n  const currentNodeState =\n    storedNodeId && storedNodeId === nodeId\n      ? normalizeNodeState(storedState)\n      : { byIndex: [], byKey: {} };\n\n  return {\n    ...ctx,\n    nodeStateIndex: 0,\n    currentNodeState,\n    workflowState: cloneWorkflowState(hookMemory.workflowState),\n    dirty: false,\n  };\n};\n\nconst buildMemoryUpdates = (ctx: HookInternalContext) => {\n  if (!ctx.dirty) return null;\n  return {\n    __kortyx: {\n      nodeState: {\n        nodeId: ctx.node.graph.node,\n        state: ctx.currentNodeState,\n      },\n      workflowState: ctx.workflowState,\n    },\n  } as Record<string, unknown>;\n};\n\nexport async function runWithHookContext<T>(\n  ctx: HookRuntimeContext,\n  fn: () => Promise<T>,\n): Promise<{ result: T; memoryUpdates: Record<string, unknown> | null }> {\n  const internal = createInternalContext(ctx);\n  try {\n    const result = await storage.run(internal, fn);\n    return { result, memoryUpdates: buildMemoryUpdates(internal) };\n  } catch (err) {\n    const memoryUpdates = buildMemoryUpdates(internal);\n    if (memoryUpdates && err && typeof err === \"object\") {\n      (err as any).__kortyxMemoryUpdates = memoryUpdates;\n    }\n    throw err;\n  }\n}\n\nexport function getHookContext(): HookInternalContext {\n  const ctx = storage.getStore();\n  if (!ctx) {\n    throw new Error(\"Hooks can only be used while a node is executing.\");\n  }\n  return ctx;\n}\n","import type {\n  GetProviderFn,\n  KortyxPromptMessage,\n  KortyxStreamChunk,\n  ProviderModelRef,\n} from \"@kortyx/providers\";\n\nexport interface RunReasonEngineArgs {\n  getProvider: GetProviderFn;\n  model: ProviderModelRef;\n  input: string;\n  system?: string | undefined;\n  temperature?: number | 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}\n\nexport interface RunReasonEngineResult {\n  text: string;\n  raw?: unknown;\n}\n\nconst chunkToText = (chunk: KortyxStreamChunk | string): string => {\n  if (typeof chunk === \"string\") return chunk;\n  if (typeof chunk.text === \"string\") return chunk.text;\n  if (typeof chunk.content === \"string\") return chunk.content;\n  return \"\";\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\n  const model = args.getProvider(args.model.providerId, args.model.modelId, {\n    ...(temperature !== undefined ? { temperature } : {}),\n    streaming: stream,\n  });\n\n  const messages: KortyxPromptMessage[] = [];\n  if (typeof args.system === \"string\" && args.system.length > 0) {\n    messages.push({ role: \"system\", content: args.system });\n  }\n  messages.push({ role: \"user\", content: String(args.input ?? \"\") });\n\n  if (stream) {\n    let final = \"\";\n    let raw: unknown;\n\n    if (emit) {\n      emitNodeEvent(args.emitEvent, args.nodeId, \"text-start\", {});\n    }\n\n    const response = await model.stream(messages);\n    for await (const chunk of response) {\n      const text = chunkToText(chunk);\n      if (!text) continue;\n      final += text;\n      if (typeof chunk === \"object\" && chunk && \"raw\" in chunk) {\n        raw = (chunk as KortyxStreamChunk).raw;\n      }\n      if (emit) {\n        emitNodeEvent(args.emitEvent, args.nodeId, \"text-delta\", {\n          delta: text,\n        });\n      }\n    }\n\n    if (emit) {\n      emitNodeEvent(args.emitEvent, args.nodeId, \"text-end\", {});\n    }\n\n    return {\n      text: final,\n      ...(raw !== undefined ? { raw } : {}),\n    };\n  }\n\n  const response = await model.invoke(messages);\n\n  if (emit) {\n    emitNodeEvent(args.emitEvent, args.nodeId, \"text-start\", {});\n    if (response.content) {\n      emitNodeEvent(args.emitEvent, args.nodeId, \"text-delta\", {\n        delta: response.content,\n      });\n    }\n    emitNodeEvent(args.emitEvent, args.nodeId, \"text-end\", {});\n  }\n\n  return {\n    text: response.content,\n    ...(response.raw !== undefined ? { raw: response.raw } : {}),\n  };\n}\n","import type {\n  InterruptInput,\n  InterruptResult,\n  NodeContext,\n} from \"@kortyx/core\";\nimport type { MemoryAdapter } from \"@kortyx/memory\";\nimport type { ProviderModelRef } from \"@kortyx/providers\";\nimport { getHookContext } from \"./context\";\nimport type { RunReasonEngineResult } from \"./reason-engine\";\nimport { runReasonEngine } from \"./reason-engine\";\n\ntype StateSetter<T> = (next: T | ((prev: T) => T)) => void;\n\nexport type UseReasonArgs = {\n  model: ProviderModelRef;\n  input: string;\n  system?: string | undefined;\n  temperature?: number | undefined;\n  emit?: boolean | undefined;\n  stream?: boolean | undefined;\n};\n\nexport type UseReasonResult = {\n  text: string;\n  raw?: unknown;\n};\n\nexport function useEmit(): NodeContext[\"emit\"] {\n  const ctx = getHookContext();\n  return ctx.node.emit;\n}\n\nexport function useStructuredData(args: {\n  data: unknown;\n  dataType?: string | undefined;\n}): void {\n  const ctx = getHookContext();\n  ctx.node.emit(\"structured_data\", {\n    node: ctx.node.graph.node,\n    ...(typeof args.dataType === \"string\" && args.dataType.length > 0\n      ? { dataType: args.dataType }\n      : {}),\n    data: args.data,\n  });\n}\n\nasync function reasonEngine(\n  args: UseReasonArgs,\n): Promise<RunReasonEngineResult> {\n  const ctx = getHookContext();\n  const getProvider = ctx.getProvider;\n  if (!getProvider) {\n    throw new Error(\"useReason requires a provider factory in runtime config.\");\n  }\n\n  return runReasonEngine({\n    getProvider,\n    model: args.model,\n    input: args.input,\n    system: args.system,\n    temperature: args.temperature,\n    defaultTemperature: ctx.node.config?.model?.temperature,\n    stream: args.stream,\n    emit: args.emit,\n    nodeId: ctx.node.graph.node,\n    emitEvent: ctx.node.emit,\n  });\n}\n\nexport function useReason(args: UseReasonArgs): Promise<UseReasonResult> {\n  return reasonEngine(args);\n}\n\nexport function useAiMemory(): MemoryAdapter {\n  const ctx = getHookContext();\n  if (!ctx.memoryAdapter) {\n    throw new Error(\"useAiMemory requires a memory adapter in runtime config.\");\n  }\n  return ctx.memoryAdapter;\n}\n\nexport function useAiInterrupt(\n  input: InterruptInput,\n): Promise<InterruptResult> {\n  const ctx = getHookContext();\n  return Promise.resolve(ctx.node.awaitInterrupt(input));\n}\n\nexport function useNodeState<T>(initialValue: T): [T, StateSetter<T>];\nexport function useNodeState<T>(\n  key: string,\n  initialValue?: T,\n): [T, StateSetter<T>];\nexport function useNodeState<T>(\n  keyOrInitial: string | T,\n  initialValue?: T,\n): [T, StateSetter<T>] {\n  const ctx = getHookContext();\n  const nodeState = ctx.currentNodeState;\n\n  if (typeof keyOrInitial === \"string\") {\n    const key = keyOrInitial;\n    const hasInitial = arguments.length > 1;\n\n    if (!Object.hasOwn(nodeState.byKey, key) && hasInitial) {\n      nodeState.byKey[key] = initialValue as T;\n      ctx.dirty = true;\n    }\n\n    const getValue = () => nodeState.byKey[key] as T;\n    const setValue: StateSetter<T> = (next) => {\n      const prev = getValue();\n      const resolved =\n        typeof next === \"function\" ? (next as (p: T) => T)(prev) : next;\n      nodeState.byKey[key] = resolved;\n      ctx.dirty = true;\n    };\n\n    return [getValue(), setValue];\n  }\n\n  const index = ctx.nodeStateIndex++;\n  if (index >= nodeState.byIndex.length) {\n    nodeState.byIndex[index] = keyOrInitial as T;\n    ctx.dirty = true;\n  }\n\n  const getValue = () => nodeState.byIndex[index] as T;\n  const setValue: StateSetter<T> = (next) => {\n    const prev = getValue();\n    const resolved =\n      typeof next === \"function\" ? (next as (p: T) => T)(prev) : next;\n    nodeState.byIndex[index] = resolved;\n    ctx.dirty = true;\n  };\n\n  return [getValue(), setValue];\n}\n\nexport function useWorkflowState<T>(\n  key: string,\n  initialValue?: T,\n): [T, StateSetter<T>] {\n  const ctx = getHookContext();\n  const workflowState = ctx.workflowState;\n  const hasInitial = arguments.length > 1;\n\n  if (!Object.hasOwn(workflowState, key) && hasInitial) {\n    workflowState[key] = initialValue as T;\n    ctx.dirty = true;\n  }\n\n  const getValue = () => workflowState[key] as T;\n  const setValue: StateSetter<T> = (next) => {\n    const prev = getValue();\n    const resolved =\n      typeof next === \"function\" ? (next as (p: T) => T)(prev) : next;\n    workflowState[key] = resolved;\n    ctx.dirty = true;\n  };\n\n  return [getValue(), setValue];\n}\n"],"mappings":"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","names":["response","getValue","setValue"]}

package/dist/internal.d.ts

@@ -0,0 +1,21 @@
+import { GetProviderFn, ProviderModelRef } from '@kortyx/providers';
+
+interface RunReasonEngineArgs {
+    getProvider: GetProviderFn;
+    model: ProviderModelRef;
+    input: string;
+    system?: string | undefined;
+    temperature?: number | undefined;
+    defaultTemperature?: number | undefined;
+    stream?: boolean | undefined;
+    emit?: boolean | undefined;
+    nodeId?: string | undefined;
+    emitEvent?: ((event: string, payload: unknown) => void) | undefined;
+}
+interface RunReasonEngineResult {
+    text: string;
+    raw?: unknown;
+}
+declare function runReasonEngine(args: RunReasonEngineArgs): Promise<RunReasonEngineResult>;
+
+export { type RunReasonEngineArgs, type RunReasonEngineResult, runReasonEngine };

package/dist/internal.js

@@ -0,0 +1,100 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/internal.ts
+var internal_exports = {};
+__export(internal_exports, {
+  runReasonEngine: () => runReasonEngine
+});
+module.exports = __toCommonJS(internal_exports);
+
+// src/reason-engine.ts
+var chunkToText = (chunk) => {
+  if (typeof chunk === "string") return chunk;
+  if (typeof chunk.text === "string") return chunk.text;
+  if (typeof chunk.content === "string") return chunk.content;
+  return "";
+};
+var emitNodeEvent = (emitEvent, nodeId, event, payload) => {
+  if (!emitEvent) return;
+  emitEvent(event, {
+    ...payload,
+    ...typeof nodeId === "string" && nodeId.length > 0 ? { node: nodeId } : {}
+  });
+};
+async function runReasonEngine(args) {
+  const stream = args.stream ?? args.model.options?.streaming ?? true;
+  const emit = args.emit ?? true;
+  const temperature = args.temperature ?? args.model.options?.temperature ?? args.defaultTemperature;
+  const model = args.getProvider(args.model.providerId, args.model.modelId, {
+    ...temperature !== void 0 ? { temperature } : {},
+    streaming: stream
+  });
+  const messages = [];
+  if (typeof args.system === "string" && args.system.length > 0) {
+    messages.push({ role: "system", content: args.system });
+  }
+  messages.push({ role: "user", content: String(args.input ?? "") });
+  if (stream) {
+    let final = "";
+    let raw;
+    if (emit) {
+      emitNodeEvent(args.emitEvent, args.nodeId, "text-start", {});
+    }
+    const response2 = await model.stream(messages);
+    for await (const chunk of response2) {
+      const text = chunkToText(chunk);
+      if (!text) continue;
+      final += text;
+      if (typeof chunk === "object" && chunk && "raw" in chunk) {
+        raw = chunk.raw;
+      }
+      if (emit) {
+        emitNodeEvent(args.emitEvent, args.nodeId, "text-delta", {
+          delta: text
+        });
+      }
+    }
+    if (emit) {
+      emitNodeEvent(args.emitEvent, args.nodeId, "text-end", {});
+    }
+    return {
+      text: final,
+      ...raw !== void 0 ? { raw } : {}
+    };
+  }
+  const response = await model.invoke(messages);
+  if (emit) {
+    emitNodeEvent(args.emitEvent, args.nodeId, "text-start", {});
+    if (response.content) {
+      emitNodeEvent(args.emitEvent, args.nodeId, "text-delta", {
+        delta: response.content
+      });
+    }
+    emitNodeEvent(args.emitEvent, args.nodeId, "text-end", {});
+  }
+  return {
+    text: response.content,
+    ...response.raw !== void 0 ? { raw: response.raw } : {}
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  runReasonEngine
+});
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +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\";\n","import type {\n  GetProviderFn,\n  KortyxPromptMessage,\n  KortyxStreamChunk,\n  ProviderModelRef,\n} from \"@kortyx/providers\";\n\nexport interface RunReasonEngineArgs {\n  getProvider: GetProviderFn;\n  model: ProviderModelRef;\n  input: string;\n  system?: string | undefined;\n  temperature?: number | 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}\n\nexport interface RunReasonEngineResult {\n  text: string;\n  raw?: unknown;\n}\n\nconst chunkToText = (chunk: KortyxStreamChunk | string): string => {\n  if (typeof chunk === \"string\") return chunk;\n  if (typeof chunk.text === \"string\") return chunk.text;\n  if (typeof chunk.content === \"string\") return chunk.content;\n  return \"\";\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\n  const model = args.getProvider(args.model.providerId, args.model.modelId, {\n    ...(temperature !== undefined ? { temperature } : {}),\n    streaming: stream,\n  });\n\n  const messages: KortyxPromptMessage[] = [];\n  if (typeof args.system === \"string\" && args.system.length > 0) {\n    messages.push({ role: \"system\", content: args.system });\n  }\n  messages.push({ role: \"user\", content: String(args.input ?? \"\") });\n\n  if (stream) {\n    let final = \"\";\n    let raw: unknown;\n\n    if (emit) {\n      emitNodeEvent(args.emitEvent, args.nodeId, \"text-start\", {});\n    }\n\n    const response = await model.stream(messages);\n    for await (const chunk of response) {\n      const text = chunkToText(chunk);\n      if (!text) continue;\n      final += text;\n      if (typeof chunk === \"object\" && chunk && \"raw\" in chunk) {\n        raw = (chunk as KortyxStreamChunk).raw;\n      }\n      if (emit) {\n        emitNodeEvent(args.emitEvent, args.nodeId, \"text-delta\", {\n          delta: text,\n        });\n      }\n    }\n\n    if (emit) {\n      emitNodeEvent(args.emitEvent, args.nodeId, \"text-end\", {});\n    }\n\n    return {\n      text: final,\n      ...(raw !== undefined ? { raw } : {}),\n    };\n  }\n\n  const response = await model.invoke(messages);\n\n  if (emit) {\n    emitNodeEvent(args.emitEvent, args.nodeId, \"text-start\", {});\n    if (response.content) {\n      emitNodeEvent(args.emitEvent, args.nodeId, \"text-delta\", {\n        delta: response.content,\n      });\n    }\n    emitNodeEvent(args.emitEvent, args.nodeId, \"text-end\", {});\n  }\n\n  return {\n    text: response.content,\n    ...(response.raw !== undefined ? { raw: response.raw } : {}),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACyBA,IAAM,cAAc,CAAC,UAA8C;AACjE,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI,OAAO,MAAM,SAAS,SAAU,QAAO,MAAM;AACjD,MAAI,OAAO,MAAM,YAAY,SAAU,QAAO,MAAM;AACpD,SAAO;AACT;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;AAEP,QAAM,QAAQ,KAAK,YAAY,KAAK,MAAM,YAAY,KAAK,MAAM,SAAS;AAAA,IACxE,GAAI,gBAAgB,SAAY,EAAE,YAAY,IAAI,CAAC;AAAA,IACnD,WAAW;AAAA,EACb,CAAC;AAED,QAAM,WAAkC,CAAC;AACzC,MAAI,OAAO,KAAK,WAAW,YAAY,KAAK,OAAO,SAAS,GAAG;AAC7D,aAAS,KAAK,EAAE,MAAM,UAAU,SAAS,KAAK,OAAO,CAAC;AAAA,EACxD;AACA,WAAS,KAAK,EAAE,MAAM,QAAQ,SAAS,OAAO,KAAK,SAAS,EAAE,EAAE,CAAC;AAEjE,MAAI,QAAQ;AACV,QAAI,QAAQ;AACZ,QAAI;AAEJ,QAAI,MAAM;AACR,oBAAc,KAAK,WAAW,KAAK,QAAQ,cAAc,CAAC,CAAC;AAAA,IAC7D;AAEA,UAAMA,YAAW,MAAM,MAAM,OAAO,QAAQ;AAC5C,qBAAiB,SAASA,WAAU;AAClC,YAAM,OAAO,YAAY,KAAK;AAC9B,UAAI,CAAC,KAAM;AACX,eAAS;AACT,UAAI,OAAO,UAAU,YAAY,SAAS,SAAS,OAAO;AACxD,cAAO,MAA4B;AAAA,MACrC;AACA,UAAI,MAAM;AACR,sBAAc,KAAK,WAAW,KAAK,QAAQ,cAAc;AAAA,UACvD,OAAO;AAAA,QACT,CAAC;AAAA,MACH;AAAA,IACF;AAEA,QAAI,MAAM;AACR,oBAAc,KAAK,WAAW,KAAK,QAAQ,YAAY,CAAC,CAAC;AAAA,IAC3D;AAEA,WAAO;AAAA,MACL,MAAM;AAAA,MACN,GAAI,QAAQ,SAAY,EAAE,IAAI,IAAI,CAAC;AAAA,IACrC;AAAA,EACF;AAEA,QAAM,WAAW,MAAM,MAAM,OAAO,QAAQ;AAE5C,MAAI,MAAM;AACR,kBAAc,KAAK,WAAW,KAAK,QAAQ,cAAc,CAAC,CAAC;AAC3D,QAAI,SAAS,SAAS;AACpB,oBAAc,KAAK,WAAW,KAAK,QAAQ,cAAc;AAAA,QACvD,OAAO,SAAS;AAAA,MAClB,CAAC;AAAA,IACH;AACA,kBAAc,KAAK,WAAW,KAAK,QAAQ,YAAY,CAAC,CAAC;AAAA,EAC3D;AAEA,SAAO;AAAA,IACL,MAAM,SAAS;AAAA,IACf,GAAI,SAAS,QAAQ,SAAY,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC;AAAA,EAC5D;AACF;","names":["response"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kortyx/hooks",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "private": false,
   "description": "Lifecycle hooks and extension points for Kortyx.",
   "keywords": [
@@ -13,7 +13,7 @@
     "kortyx"
   ],
   "license": "Apache-2.0",
-  "homepage": "https://github.com/kortyx-io/kortyx/tree/main/packages/hooks#readme",
+  "homepage": "https://kortyx.io/",
   "bugs": {
     "url": "https://github.com/kortyx-io/kortyx/issues"
   },
@@ -24,6 +24,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "default": "./dist/internal.js"
     }
   },
   "files": [
@@ -32,7 +36,7 @@
     "CHANGELOG.md"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
+    "build": "tsup",
     "predev": "tsc -p tsconfig.build.json",
     "dev": "tsc --watch",
     "lint": "biome check src",
@@ -46,12 +50,13 @@
   },
   "devDependencies": {
     "turbo": "^2.5.4",
-    "typescript": "5.7.2"
+    "typescript": "5.7.2",
+    "tsup": "^8.5.1"
   },
   "sideEffects": false,
   "repository": {
     "type": "git",
-    "url": "https://github.com/kortyx-io/kortyx",
+    "url": "https://github.com/kortyx-io/kortyx.git",
     "directory": "packages/hooks"
   }
 }

package/dist/context.d.ts

@@ -1,26 +0,0 @@
-import type { GraphState, NodeContext } from "@kortyx/core";
-import type { MemoryAdapter } from "@kortyx/memory";
-import type { GetProviderFn } from "@kortyx/providers";
-type NodeStateStore = {
-    byIndex: unknown[];
-    byKey: Record<string, unknown>;
-};
-export type HookRuntimeContext = {
-    node: NodeContext;
-    state: GraphState;
-    getProvider?: GetProviderFn;
-    memoryAdapter?: MemoryAdapter;
-};
-type HookInternalContext = HookRuntimeContext & {
-    nodeStateIndex: number;
-    currentNodeState: NodeStateStore;
-    workflowState: Record<string, unknown>;
-    dirty: boolean;
-};
-export declare function runWithHookContext<T>(ctx: HookRuntimeContext, fn: () => Promise<T>): Promise<{
-    result: T;
-    memoryUpdates: Record<string, unknown> | null;
-}>;
-export declare function getHookContext(): HookInternalContext;
-export {};
-//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,KAAK,cAAc,GAAG;IACpB,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAOF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,CAAC;AAEF,KAAK,mBAAmB,GAAG,kBAAkB,GAAG;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,cAAc,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAwEF,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,GAAG,EAAE,kBAAkB,EACvB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAAE,CAAC,CAYvE;AAED,wBAAgB,cAAc,IAAI,mBAAmB,CAMpD"}

package/dist/context.js

@@ -1,82 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runWithHookContext = runWithHookContext;
-exports.getHookContext = getHookContext;
-const node_async_hooks_1 = require("node:async_hooks");
-const storage = new node_async_hooks_1.AsyncLocalStorage();
-const isRecord = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
-const normalizeNodeState = (value) => {
-    if (Array.isArray(value)) {
-        return { byIndex: [...value], byKey: {} };
-    }
-    if (isRecord(value)) {
-        const byIndex = Array.isArray(value.byIndex) ? [...value.byIndex] : [];
-        const byKey = isRecord(value.byKey) ? { ...value.byKey } : {};
-        return { byIndex, byKey };
-    }
-    return { byIndex: [], byKey: {} };
-};
-const cloneWorkflowState = (value) => isRecord(value) ? { ...value } : {};
-const getHookMemory = (state) => {
-    const memory = (state.memory ?? {});
-    const internal = isRecord(memory.__kortyx) ? memory.__kortyx : undefined;
-    const result = {};
-    if (isRecord(internal?.nodeState))
-        result.nodeState = internal?.nodeState;
-    if (isRecord(internal?.workflowState)) {
-        result.workflowState = internal?.workflowState;
-    }
-    return result;
-};
-const createInternalContext = (ctx) => {
-    const hookMemory = getHookMemory(ctx.state);
-    const nodeId = ctx.node.graph.node;
-    const storedNodeId = typeof hookMemory.nodeState?.nodeId === "string"
-        ? String(hookMemory.nodeState?.nodeId)
-        : "";
-    const storedState = hookMemory.nodeState?.state;
-    const currentNodeState = storedNodeId && storedNodeId === nodeId
-        ? normalizeNodeState(storedState)
-        : { byIndex: [], byKey: {} };
-    return {
-        ...ctx,
-        nodeStateIndex: 0,
-        currentNodeState,
-        workflowState: cloneWorkflowState(hookMemory.workflowState),
-        dirty: false,
-    };
-};
-const buildMemoryUpdates = (ctx) => {
-    if (!ctx.dirty)
-        return null;
-    return {
-        __kortyx: {
-            nodeState: {
-                nodeId: ctx.node.graph.node,
-                state: ctx.currentNodeState,
-            },
-            workflowState: ctx.workflowState,
-        },
-    };
-};
-async function runWithHookContext(ctx, fn) {
-    const internal = createInternalContext(ctx);
-    try {
-        const result = await storage.run(internal, fn);
-        return { result, memoryUpdates: buildMemoryUpdates(internal) };
-    }
-    catch (err) {
-        const memoryUpdates = buildMemoryUpdates(internal);
-        if (memoryUpdates && err && typeof err === "object") {
-            err.__kortyxMemoryUpdates = memoryUpdates;
-        }
-        throw err;
-    }
-}
-function getHookContext() {
-    const ctx = storage.getStore();
-    if (!ctx) {
-        throw new Error("Hooks can only be used while a node is executing.");
-    }
-    return ctx;
-}

package/dist/hooks.d.ts

@@ -1,29 +0,0 @@
-import type { InterruptInput, InterruptResult, NodeContext } from "@kortyx/core";
-import type { MemoryAdapter } from "@kortyx/memory";
-type StateSetter<T> = (next: T | ((prev: T) => T)) => void;
-export type AiCallArgs = {
-    prompt: string;
-    system?: string | undefined;
-    temperature?: number | undefined;
-    emit?: boolean | undefined;
-    stream?: boolean | undefined;
-};
-export type AiCallResult = {
-    text: string;
-};
-export type AiModel = {
-    call: (args: AiCallArgs) => Promise<AiCallResult>;
-};
-export declare function useEmit(): NodeContext["emit"];
-export declare function useStructuredData(args: {
-    data: unknown;
-    dataType?: string | undefined;
-}): void;
-export declare function useAiProvider(modelId?: string): AiModel;
-export declare function useAiMemory(): MemoryAdapter;
-export declare function useAiInterrupt(input: InterruptInput): Promise<InterruptResult>;
-export declare function useNodeState<T>(initialValue: T): [T, StateSetter<T>];
-export declare function useNodeState<T>(key: string, initialValue?: T): [T, StateSetter<T>];
-export declare function useWorkflowState<T>(key: string, initialValue?: T): [T, StateSetter<T>];
-export {};
-//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAEf,WAAW,EACZ,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC;AA6C3D,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;CACnD,CAAC;AAEF,wBAAgB,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAG7C;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B,GAAG,IAAI,CASP;AAED,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAoCvD;AAED,wBAAgB,WAAW,IAAI,aAAa,CAM3C;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,eAAe,CAAC,CAG1B;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AACtE,wBAAgB,YAAY,CAAC,CAAC,EAC5B,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,CAAC,GACf,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AA+CvB,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,CAAC,GACf,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAoBrB"}

package/dist/hooks.js

@@ -1,143 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useEmit = useEmit;
-exports.useStructuredData = useStructuredData;
-exports.useAiProvider = useAiProvider;
-exports.useAiMemory = useAiMemory;
-exports.useAiInterrupt = useAiInterrupt;
-exports.useNodeState = useNodeState;
-exports.useWorkflowState = useWorkflowState;
-const context_1 = require("./context");
-const DEFAULT_PROVIDER = "google";
-const DEFAULT_MODEL = "gemini-2.5-flash";
-const resolveModel = (modelId, config) => {
-    const defaultProvider = config?.provider ?? DEFAULT_PROVIDER;
-    const defaultModel = config?.name ?? DEFAULT_MODEL;
-    if (!modelId) {
-        return {
-            provider: defaultProvider,
-            name: defaultModel,
-            temperature: config?.temperature,
-        };
-    }
-    const separatorIndex = modelId.indexOf(":");
-    if (separatorIndex === -1) {
-        return {
-            provider: defaultProvider,
-            name: modelId,
-            temperature: config?.temperature,
-        };
-    }
-    const provider = modelId.slice(0, separatorIndex) || defaultProvider;
-    const name = modelId.slice(separatorIndex + 1) || defaultModel;
-    return {
-        provider,
-        name,
-        temperature: config?.temperature,
-    };
-};
-function useEmit() {
-    const ctx = (0, context_1.getHookContext)();
-    return ctx.node.emit;
-}
-function useStructuredData(args) {
-    const ctx = (0, context_1.getHookContext)();
-    ctx.node.emit("structured_data", {
-        node: ctx.node.graph.node,
-        ...(typeof args.dataType === "string" && args.dataType.length > 0
-            ? { dataType: args.dataType }
-            : {}),
-        data: args.data,
-    });
-}
-function useAiProvider(modelId) {
-    const ctx = (0, context_1.getHookContext)();
-    const getProvider = ctx.getProvider;
-    if (!getProvider) {
-        throw new Error("useAiProvider requires a provider factory in runtime config.");
-    }
-    const { provider, name, temperature } = resolveModel(modelId, ctx.node.config?.model);
-    return {
-        call: async ({ prompt, system, temperature: overrideTemperature }) => {
-            if (!ctx.node.speak) {
-                throw new Error("useAiProvider requires ctx.speak in NodeContext.");
-            }
-            const text = await ctx.node.speak({
-                ...(typeof system === "string" && system.length > 0 ? { system } : {}),
-                user: prompt,
-                model: {
-                    provider,
-                    name,
-                    ...(overrideTemperature !== undefined
-                        ? { temperature: overrideTemperature }
-                        : temperature !== undefined
-                            ? { temperature }
-                            : {}),
-                },
-                stream: { minChars: 12, flushMs: 50, segmentChars: 48 },
-            });
-            return { text };
-        },
-    };
-}
-function useAiMemory() {
-    const ctx = (0, context_1.getHookContext)();
-    if (!ctx.memoryAdapter) {
-        throw new Error("useAiMemory requires a memory adapter in runtime config.");
-    }
-    return ctx.memoryAdapter;
-}
-function useAiInterrupt(input) {
-    const ctx = (0, context_1.getHookContext)();
-    return Promise.resolve(ctx.node.awaitInterrupt(input));
-}
-function useNodeState(keyOrInitial, initialValue) {
-    const ctx = (0, context_1.getHookContext)();
-    const nodeState = ctx.currentNodeState;
-    if (typeof keyOrInitial === "string") {
-        const key = keyOrInitial;
-        const hasInitial = arguments.length > 1;
-        if (!Object.hasOwn(nodeState.byKey, key) && hasInitial) {
-            nodeState.byKey[key] = initialValue;
-            ctx.dirty = true;
-        }
-        const getValue = () => nodeState.byKey[key];
-        const setValue = (next) => {
-            const prev = getValue();
-            const resolved = typeof next === "function" ? next(prev) : next;
-            nodeState.byKey[key] = resolved;
-            ctx.dirty = true;
-        };
-        return [getValue(), setValue];
-    }
-    const index = ctx.nodeStateIndex++;
-    if (index >= nodeState.byIndex.length) {
-        nodeState.byIndex[index] = keyOrInitial;
-        ctx.dirty = true;
-    }
-    const getValue = () => nodeState.byIndex[index];
-    const setValue = (next) => {
-        const prev = getValue();
-        const resolved = typeof next === "function" ? next(prev) : next;
-        nodeState.byIndex[index] = resolved;
-        ctx.dirty = true;
-    };
-    return [getValue(), setValue];
-}
-function useWorkflowState(key, initialValue) {
-    const ctx = (0, context_1.getHookContext)();
-    const workflowState = ctx.workflowState;
-    const hasInitial = arguments.length > 1;
-    if (!Object.hasOwn(workflowState, key) && hasInitial) {
-        workflowState[key] = initialValue;
-        ctx.dirty = true;
-    }
-    const getValue = () => workflowState[key];
-    const setValue = (next) => {
-        const prev = getValue();
-        const resolved = typeof next === "function" ? next(prev) : next;
-        workflowState[key] = resolved;
-        ctx.dirty = true;
-    };
-    return [getValue(), setValue];
-}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EACL,cAAc,EACd,WAAW,EACX,aAAa,EACb,OAAO,EACP,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,SAAS,CAAC"}