@noetic-tools/types 1.0.1 → 1.0.3

package/dist/types/context.d.ts

@@ -9,7 +9,7 @@ import type { FsAdapter } from './fs-adapter.js';
 import type { HarnessResponse, StreamEvent, StreamingItem } from './harness-result.js';
 import type { ExecuteInput } from './items.js';
 import type { ContextMemory, MemoryLayer, ProjectionPolicy, StorageAdapter } from './memory.js';
-import type { Span } from './observability.js';
+import type { Span, TraceExporter } from './observability.js';
 import type { ShellAdapter } from './shell-adapter.js';
 import type { SteeringDecision } from './steering.js';
 import type { SubprocessAdapter } from './subprocess-adapter.js';
@@ -152,6 +152,8 @@ export interface ContextHarness {
     checkpoint(ctx: Context): Promise<void>;
     restore(executionId: string): Promise<Context | null>;
     cancel(ctx: Context, reason?: string): Promise<void>;
+    /** Trace exporter spans are flushed to. Defaults to a no-op exporter. */
+    readonly traceExporter: TraceExporter;
     createSpan(name: string, parent: Span | null): Span;
     abort(scope?: unknown): Promise<void>;
     getStatus(scope?: unknown): ContextHarnessStatus;

package/dist/types/runtime.d.ts

@@ -7,7 +7,7 @@ import type { FsAdapter } from './fs-adapter.js';
 import type { HarnessResponse, StreamEvent, StreamingItem } from './harness-result.js';
 import type { ExecuteInput, Item, ItemSchemaExtensions } from './items.js';
 import type { ContextMemory, MemoryLayer, ProjectionPolicy, StorageAdapter } from './memory.js';
-import type { Span } from './observability.js';
+import type { Span, TraceExporter } from './observability.js';
 import type { ShellAdapter } from './shell-adapter.js';
 import type { SteeringDecision } from './steering.js';
 import type { Step } from './step.js';
@@ -56,6 +56,19 @@ interface CallModelRequestBase {
     emit?: boolean | ((eventType: string, data: Record<string, unknown>) => boolean);
     /** Optional signal for cancelling the in-flight call (used by session abort). */
     signal?: AbortSignal;
+    /**
+     * @internal Parent span for the model-call spans this request produces. When
+     * omitted, the caller falls back to `ctx.span`. Set by `parseAndRunWorkflow`
+     * so model/tool spans nest under the root `workflow.run` span.
+     */
+    parentSpan?: Span;
+    /**
+     * @internal Id of the workflow node driving this call. Set by
+     * `parseAndRunWorkflow` (from the executing step's id) so the `llm.call` and
+     * `tool.call` spans this request produces carry `NoeticAttr.NODE_ID`, linking
+     * each span back to its node in the declared DAG.
+     */
+    nodeId?: string;
 }
 /** @public Request shape when tools are provided — ctx is required for tool execution callbacks. */
 interface CallModelRequestWithTools extends CallModelRequestBase {
@@ -224,6 +237,8 @@ export interface AgentHarnessContract<TParams extends Record<string, unknown> =
     checkpoint(ctx: Context): Promise<void>;
     restore(executionId: string): Promise<Context | null>;
     cancel(ctx: Context, reason?: string): Promise<void>;
+    /** Trace exporter spans are flushed to. Defaults to a no-op exporter. */
+    readonly traceExporter: TraceExporter;
     createSpan(name: string, parent: Span | null): Span;
     getLayerState<T>(executionId: string, layerId: string): T | undefined;
     setLayerState<T>(executionId: string, layerId: string, state: T): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noetic-tools/types",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "type": "module",
   "description": "Foundational type contracts and primitives shared across the Noetic framework (items, LLM config, adapters, steering, errors).",
   "license": "Apache-2.0",