@noetic-tools/core 1.2.2 → 1.2.3

package/dist/harness/model-call.js

@@ -2,7 +2,7 @@ import { frameworkCast, NoeticConfigError } from '@noetic-tools/types';
 import { z } from 'zod';
 import { convertTools, executeToolCall, extractOutputItems, extractSystemInstruction, extractUsage, itemsToInput, sanitizeToolNameForWire, } from '../adapters/openrouter.js';
 import { isFunctionCall } from '../interpreter/typeguards.js';
-import { GenAI, ToolAttr } from '../observability/genai-attributes.js';
+import { GenAI, NoeticAttr, ToolAttr } from '../observability/genai-attributes.js';
 import { emitFrameworkEvent, getBroadcaster, shouldEmit } from '../runtime/broadcaster-utils.js';
 import { buildItemSchemaRegistry, createToolResultItem } from './model-schema.js';
 const MAX_TOOL_ROUNDS = 32;
@@ -230,17 +230,26 @@ class CallSpanCollector {
     harness;
     exporter;
     parent;
+    nodeId;
     spans = [];
-    constructor(harness, exporter, parent) {
+    constructor(harness, exporter, parent, nodeId) {
         this.harness = harness;
         this.exporter = exporter;
         this.parent = parent;
+        this.nodeId = nodeId;
+    }
+    /** Link a span back to its declared workflow node, when the call carries one. */
+    stampNode(span) {
+        if (this.nodeId !== undefined) {
+            span.setAttribute(NoeticAttr.NODE_ID, this.nodeId);
+        }
     }
     /** Open a model-call span stamped with GenAI semantic-convention attributes. */
     startModelSpan(model) {
         const span = this.harness.createSpan('llm.call', this.parent);
         span.setAttribute(GenAI.SYSTEM, 'openrouter');
         span.setAttribute(GenAI.REQUEST_MODEL, model);
+        this.stampNode(span);
         this.spans.push(span);
         return span;
     }
@@ -258,6 +267,7 @@ class CallSpanCollector {
         const span = this.harness.createSpan('tool.call', parent);
         span.setAttribute(ToolAttr.NAME, toolName);
         span.setAttribute(ToolAttr.NEEDS_APPROVAL, needsApproval);
+        this.stampNode(span);
         span.end();
         this.spans.push(span);
     }
@@ -275,7 +285,7 @@ export class AgentHarnessModelCaller {
         this.opts = opts;
     }
     newSpanCollector(request) {
-        return new CallSpanCollector(this.opts.harness, this.opts.traceExporter, request.parentSpan ?? request.ctx?.span ?? null);
+        return new CallSpanCollector(this.opts.harness, this.opts.traceExporter, request.parentSpan ?? request.ctx?.span ?? null, request.nodeId);
     }
     async callOverriddenModel(request) {
         if (!this.opts.callModelOverride) {

package/dist/interpreter/execute-action.js

@@ -293,6 +293,7 @@ export async function executeLLM(step, input, ctx, layers) {
                 ctx: baseCtx,
                 layers,
                 allowedToolNames,
+                nodeId: step.id,
                 parentSpan: baseCtx.span,
             }
             : {
@@ -302,6 +303,7 @@ export async function executeLLM(step, input, ctx, layers) {
                 params: step.params,
                 outputSchema: step.output,
                 emit: step.emit,
+                nodeId: step.id,
                 parentSpan: baseCtx.span,
             };
         const response = await baseCtx.harness.callModel(request);

package/dist/observability/genai-attributes.d.ts

@@ -20,4 +20,6 @@ export declare const NoeticAttr: {
     readonly WORKFLOW_NODES: "noetic.workflow.nodes";
     /** JSON array of `{ from, to }` parent→child edges between declared nodes. */
     readonly WORKFLOW_EDGES: "noetic.workflow.edges";
+    /** Id of the declared workflow node an `llm.call`/`tool.call` span belongs to. */
+    readonly NODE_ID: "noetic.node.id";
 };

package/dist/observability/genai-attributes.js

@@ -23,4 +23,6 @@ export const NoeticAttr = {
     WORKFLOW_NODES: 'noetic.workflow.nodes',
     /** JSON array of `{ from, to }` parent→child edges between declared nodes. */
     WORKFLOW_EDGES: 'noetic.workflow.edges',
+    /** Id of the declared workflow node an `llm.call`/`tool.call` span belongs to. */
+    NODE_ID: 'noetic.node.id',
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noetic-tools/core",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "type": "module",
   "description": "Step primitives, interpreter, runtime, and memory layer contract for Noetic agents.",
   "license": "Apache-2.0",
@@ -67,7 +67,7 @@
   },
   "dependencies": {
     "@noetic-tools/memory": "^1.0.1",
-    "@noetic-tools/types": "^1.0.2",
+    "@noetic-tools/types": "^1.0.3",
     "@openrouter/agent": "^0.6.0",
     "zod": "^4.0.0"
   },