@noetic-tools/core 1.2.2 → 1.3.0

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,14 @@ 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";
+    /**
+     * Conversation/session this run belongs to (the run's `ctx.threadId`). Stamped
+     * on the root `workflow.run` span so every turn of a multi-turn session shares
+     * one id, letting a consumer group per-run traces back into their session.
+     */
+    readonly SESSION_ID: "noetic.session.id";
+    /** Resource the session is scoped to (the run's `ctx.resourceId`), when set. */
+    readonly RESOURCE_ID: "noetic.resource.id";
 };

package/dist/observability/genai-attributes.js

@@ -23,4 +23,14 @@ 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',
+    /**
+     * Conversation/session this run belongs to (the run's `ctx.threadId`). Stamped
+     * on the root `workflow.run` span so every turn of a multi-turn session shares
+     * one id, letting a consumer group per-run traces back into their session.
+     */
+    SESSION_ID: 'noetic.session.id',
+    /** Resource the session is scoped to (the run's `ctx.resourceId`), when set. */
+    RESOURCE_ID: 'noetic.resource.id',
 };

package/dist/patterns/dynamic-workflow.js

@@ -158,9 +158,12 @@ export async function parseAndRunWorkflow(opts) {
 }
 /**
  * Open the root `workflow.run` span and stamp the static DAG onto it (document,
- * version, node/edge graph). The span is installed on `ctx.span` so the LLM
- * step's model/tool spans nest under it — the trace tree then mirrors the
- * declared workflow graph, with the executed path overlaid (issue #50 follow-up).
+ * version, node/edge graph) plus the session/resource the run belongs to. The
+ * span is installed on `ctx.span` so the LLM step's model/tool spans nest under
+ * it — the trace tree then mirrors the declared workflow graph, with the
+ * executed path overlaid (issue #50 follow-up). The session id (`ctx.threadId`)
+ * is shared by every turn of a conversation, so consumers can group the per-run
+ * traces of one session back together.
  */
 function beginWorkflowRunSpan(harness, ctx, doc) {
     const span = harness.createSpan('workflow.run', null);
@@ -170,6 +173,10 @@ function beginWorkflowRunSpan(harness, ctx, doc) {
     span.setAttribute(NoeticAttr.WORKFLOW_NODE_COUNT, graph.nodes.length);
     span.setAttribute(NoeticAttr.WORKFLOW_NODES, JSON.stringify(graph.nodes));
     span.setAttribute(NoeticAttr.WORKFLOW_EDGES, JSON.stringify(graph.edges));
+    span.setAttribute(NoeticAttr.SESSION_ID, ctx.threadId);
+    if (ctx.resourceId !== undefined) {
+        span.setAttribute(NoeticAttr.RESOURCE_ID, ctx.resourceId);
+    }
     installRunSpan(ctx, span);
     return span;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noetic-tools/core",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "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"
   },