@kortyx/runtime 0.19.0 → 0.20.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.20.0](https://github.com/kortyx-io/kortyx/compare/runtime-v0.19.0...runtime-v0.20.0) (2026-09-18)
+
+
+### Features
+
+* **tools:** add useTool and first-class Studio observability ([#215](https://github.com/kortyx-io/kortyx/issues/215)) ([224c92d](https://github.com/kortyx-io/kortyx/commit/224c92d73caead320dd14582d8b624efc3252c9f))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @kortyx/hooks bumped to 0.26.0
+    * @kortyx/providers bumped to 0.8.0
+
 ## [0.19.0](https://github.com/kortyx-io/kortyx/compare/runtime-v0.18.0...runtime-v0.19.0) (2026-09-16)
 
 

package/dist/index.js

@@ -2346,6 +2346,7 @@ var import_promises = require("timers/promises");
 var import_core3 = require("@kortyx/core");
 var import_errors13 = require("@kortyx/core/errors");
 var import_hooks2 = require("@kortyx/hooks");
+var import_internal2 = require("@kortyx/hooks/internal");
 var import_utils2 = require("@kortyx/utils");
 var import_langgraph3 = require("@langchain/langgraph");
 
@@ -2433,6 +2434,7 @@ async function resolveNodeHandler(args) {
 var import_core = require("@kortyx/core");
 var import_errors11 = require("@kortyx/core/errors");
 var import_hooks = require("@kortyx/hooks");
+var import_internal = require("@kortyx/hooks/internal");
 var import_singletons = require("@langchain/core/singletons");
 var import_langgraph = require("@langchain/langgraph");
 function createWorkflowCallService(config, _parent, execution = {}) {
@@ -2643,11 +2645,13 @@ function createWorkflowCallService(config, _parent, execution = {}) {
       return {
         status: "completed",
         data,
+        toolObservations: result.runtime.__kortyx?.workflowState?.__kortyxToolObservations ?? [],
         usage: result.runtime.tokenUsage
       };
     };
     const trace = config.telemetry?.trace ?? config.reasonTrace;
-    return trace?.withSpan ? trace.withSpan(
+    return (0, import_internal.withSafeTraceSpan)(
+      trace,
       {
         name: "kortyx.workflow.call",
         attributes: {
@@ -2661,7 +2665,7 @@ function createWorkflowCallService(config, _parent, execution = {}) {
         }
       },
       execute
-    ) : execute();
+    );
   };
 }
 
@@ -2745,6 +2749,20 @@ function addParallelGraphCoordinator(builder, workflow, config, execution, execu
     for (const parent of parents) {
       for (const [key, field] of Object.entries(parent[property])) {
         const previous = Object.hasOwn(merged, key) ? merged[key] : void 0;
+        if (property === "workflowFields" && key === "__kortyxToolObservations" && previous && Array.isArray(previous.value) && Array.isArray(field.value)) {
+          const observations = /* @__PURE__ */ new Map();
+          for (const observation of [...previous.value, ...field.value]) {
+            if (record(observation) && typeof observation.attemptId === "string")
+              observations.set(observation.attemptId, observation);
+          }
+          Object.defineProperty(merged, key, {
+            value: { writer: field.writer, value: [...observations.values()] },
+            enumerable: true,
+            configurable: true,
+            writable: true
+          });
+          continue;
+        }
         if (previous && previous.writer !== field.writer) {
           if (journal.nodes[previous.writer]?.ancestors.includes(field.writer))
             continue;
@@ -3368,15 +3386,18 @@ async function createExecutionGraph(workflow, config, execution = {}) {
               ...typeof context?.tenantId === "string" ? { tenantId: context.tenantId } : {}
             },
             telemetry: {
-              metadata: {
-                ...runtimeConfig.telemetry?.metadata ?? {},
-                ...context ?? {}
-              },
+              metadata: (0, import_internal2.safeTelemetryMetadata)({
+                ...runtimeConfig.telemetry?.metadata ?? {}
+              }),
               tags: runtimeConfig.telemetry?.tags,
               captureContent: runtimeConfig.telemetry?.captureContent
             }
           };
-          const hookRun = activeTrace?.withSpan ? await activeTrace.withSpan(spanArgs, runNode) : await runNode();
+          const hookRun = await (0, import_internal2.withSafeTraceSpan)(
+            activeTrace,
+            spanArgs,
+            runNode
+          );
           nodeResult = hookRun.result;
           hookRuntimeUpdates = hookRun.runtimeUpdates;
           break;