@noetic-tools/types 3.7.0 → 3.8.0

package/dist/types/common.d.ts

@@ -63,7 +63,12 @@ export interface ModelParams {
     topP?: number;
     /** Maximum number of tokens the model may generate. */
     maxTokens?: number;
-    /** Sequences that cause the model to stop generating. */
+    /**
+     * Sequences that would cause the model to stop generating.
+     * @deprecated Not sent to the model: the OpenRouter Responses API that
+     * `callModel` uses has no stop parameter. Accepted so existing steps and
+     * workflow documents still parse; it will be removed in the next major.
+     */
     stopSequences?: string[];
     /** OpenRouter service tier to request. Omit to use the provider default. */
     serviceTier?: ServiceTier;

package/dist/types/runtime.d.ts

@@ -94,6 +94,12 @@ interface CallModelRequestBase {
      * each span back to its node in the declared DAG.
      */
     nodeId?: string;
+    /**
+     * @internal Attributes for the first `llm.call` span this request opens. Set
+     * by `callModel` steps to record how the view was banded (the
+     * `noetic.context.*` anchoring attributes).
+     */
+    spanAttributes?: Record<string, string | number | boolean>;
 }
 /** @public Request shape when tools are provided — ctx is required for tool execution callbacks. */
 interface CallModelRequestWithTools extends CallModelRequestBase {

package/dist/types/subprocess-adapter.d.ts

@@ -66,6 +66,13 @@ export interface StepSubprocessRequest extends SubprocessRequestBase {
     serializedInput: unknown;
     /** Stable id for the execution — used for handle lookup and durable checkpointing. */
     executionId: string;
+    /**
+     * Id of the context that created this child (`spawn`, `detachedSpawn`).
+     * Durable adapters persist it so a host can `harness.restore()` the parent
+     * after a restart. Absent for a `runCode`, which runs on the dispatching
+     * context itself.
+     */
+    parentExecutionId?: string;
     /** Child-context overrides (thread, resource, cwd). */
     overrides: StepSubprocessOverrides;
     /**
@@ -92,6 +99,8 @@ export interface SubprocessHandleMetadata extends Record<string, unknown> {
     error?: SerializedError;
     /** Execution id echoed from the originating `StepSubprocessRequest`. */
     executionId?: string;
+    /** Parent execution id echoed from the originating `StepSubprocessRequest`. */
+    parentExecutionId?: string;
 }
 /** @public Handle returned by `SubprocessAdapter.spawn()` — a durable reference to a child. */
 export interface SubprocessHandle {

package/dist/types/tool.d.ts

@@ -127,7 +127,11 @@ export interface Tool<I extends StandardSchemaV1 = StandardSchemaV1, O extends S
      * the call site to get a typed handle.
      */
     execute(args: InferSchemaOutput<I>, toolCtx: unknown): ToolExecutionResult<O>;
-    /** When true, execution pauses for human approval before running. */
+    /**
+     * Declares that a call needs human approval before it runs. Core records the
+     * flag on `tool.call` spans but does not pause on it: a `beforeToolCall`
+     * gating layer or the tool's own integration must enforce it.
+     */
     needsApproval?: boolean;
     /** Optional context declaration — the runtime generates a ContextLayer from this. */
     context?: ToolContextDeclaration;

package/package.json

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