@noetic-tools/core 5.3.0 → 5.4.0

package/dist/harness/agent-harness.d.ts

@@ -2,32 +2,19 @@ import { ItemSchemaRegistry } from '@noetic-tools/types';
 import type { LayerStateStore, RecallCache } from './deps/context.js';
 import type { DetachedSpawnOverrides } from './deps/interpreter.js';
 import type { CheckpointStore, EventBroadcaster, RestoreCheckpointOptions, StepLedgerRetention, StepLedgerStore } from './deps/runtime.js';
-import type { AgentConfig, AgentHarnessContract, AgentHooks, CallModelRequest, Channel, ChannelHandle, Context, ContextCacheConfig, ContextCacheStore, ContextData, ContextLayer, CwdState, DeliveryMode, DetachedHandle, ExecuteInput, ExecuteOptions, ExternalChannel, FsAdapter, HarnessResponse, HarnessStatus, Item, ItemSchemaExtensions, LLMResponse, LlmProviderConfig, ProjectionPolicy, RecallLayerOutput, SessionScope, ShellAdapter, Span, SteeringDecision, Step, StorageAdapter, StreamEvent, StreamingItem, SubHarnessSession, SubprocessAdapter, Tool, TraceExporter, ZodType } from './deps/types.js';
+import type { AgentConfig, AgentHarnessContract, AgentHooks, CallModelRequest, Channel, ChannelHandle, Context, ContextCacheConfig, ContextCacheStore, ContextData, ContextLayer, CwdState, DeliveryMode, DetachedHandle, ExecuteInput, ExecuteOptions, ExternalChannel, FsAdapter, HarnessResponse, HarnessStatus, Item, ItemSchemaConfig, LLMResponse, LlmProviderConfig, ProjectionPolicy, RecallLayerOutput, SessionScope, SessionUsage, ShellAdapter, Span, SteeringDecision, Step, StorageAdapter, StreamEvent, StreamingItem, SubHarnessSession, SubprocessAdapter, Tool, TraceExporter, ZodType } from './deps/types.js';
 export { createStreamIdleWatchdog } from './model-call.js';
-interface AgentHarnessOpts<TParams extends Record<string, unknown> = Record<string, unknown>> {
-    name: string;
-    initialStep?: Step<ContextData, string, string>;
-    /** Default context layers applied to every context created via `createContext()` / `execute()`. */
-    context?: ContextLayer[];
-    /** @deprecated Renamed to `context`. */
-    memory?: ContextLayer[];
-    storage?: StorageAdapter;
-    hooks?: AgentHooks;
+/**
+ * Storage-scoped environment configuration for `AgentHarness`.
+ *
+ * @public
+ */
+export interface StorageEnvironmentConfig {
     /**
-     * Harness-wide tool pool. Merged (identity-deduplicated) with tools
-     * collected from `initialStep` to form every context's `unifiedTools`.
-     * Use this when the workflow step tree is static and tools are supplied
-     * per harness instance rather than baked into individual `step.llm` calls.
+     * Key-value storage adapter backing context-layer persistence and the
+     * step-completion ledger. Defaults to an in-memory adapter.
      */
-    tools?: Tool[];
-    params: TParams;
-    paramsSchema?: ZodType<TParams>;
-    /** Filesystem adapter. Defaults to local node:fs when not provided. */
-    fs?: FsAdapter;
-    /** Shell adapter. Defaults to local sh when not provided. */
-    shell?: ShellAdapter;
-    /** Subprocess adapter. Defaults to an in-memory, same-process adapter. */
-    subprocess?: SubprocessAdapter;
+    adapter?: StorageAdapter;
     /**
      * Checkpoint store used by `harness.checkpoint(ctx)` / `harness.restore()`.
      * When absent, checkpoint/restore are no-ops — a zero-config harness keeps
@@ -35,6 +22,8 @@ interface AgentHarnessOpts<TParams extends Record<string, unknown> = Record<stri
      * to enable durable execution.
      */
     checkpointStore?: CheckpointStore;
+    /** Layer-state store override. Defaults to an in-memory store. */
+    layerStateStore?: LayerStateStore;
     /**
      * Bounds on the step-completion ledger that backs step-level resume. Only meaningful
      * alongside a `checkpointStore`. Defaults to `DEFAULT_STEP_LEDGER_RETENTION` — 128 KiB
@@ -43,11 +32,45 @@ interface AgentHarnessOpts<TParams extends Record<string, unknown> = Record<stri
      * never correctness.
      */
     stepLedgerRetention?: StepLedgerRetention;
-    llm?: LlmProviderConfig;
-    /** Harness-wide item schema extensions. */
-    itemSchemas?: ItemSchemaExtensions;
-    /** Whether unknown extension item types must match a registered schema. Defaults to true. */
-    strictItemSchemas?: boolean;
+}
+/**
+ * Execution-environment configuration for `AgentHarness`: the storage,
+ * filesystem, shell, and subprocess surfaces the agent runs against.
+ *
+ * @public
+ */
+export interface AgentEnvironmentConfig {
+    /** Storage configuration: adapter, durability stores, ledger retention. */
+    storage?: StorageEnvironmentConfig;
+    /** Filesystem adapter. Defaults to an in-memory adapter. */
+    fs?: FsAdapter;
+    /** Shell adapter. Defaults to an in-memory adapter. */
+    shell?: ShellAdapter;
+    /** Subprocess adapter. Defaults to an in-memory, same-process adapter. */
+    subprocess?: SubprocessAdapter;
+}
+interface AgentHarnessOpts<TParams extends Record<string, unknown> = Record<string, unknown>> {
+    name: string;
+    /** Root step tree executed for every turn submitted via `execute()`. */
+    agentGraph?: Step<ContextData, string, string>;
+    /** Default context layers applied to every context created via `createContext()` / `execute()`. */
+    contextLayers?: ContextLayer[];
+    hooks?: AgentHooks;
+    /**
+     * Harness-wide tool pool. Merged (identity-deduplicated) with tools
+     * collected from `agentGraph` to form every context's `unifiedTools`.
+     * Use this when the workflow step tree is static and tools are supplied
+     * per harness instance rather than baked into individual `step.callModel` calls.
+     */
+    tools?: Tool[];
+    params: TParams;
+    paramsSchema?: ZodType<TParams>;
+    /** Execution environment: storage, filesystem, shell, subprocess. */
+    environment?: AgentEnvironmentConfig;
+    /** Default provider configuration for model calls made through this harness. */
+    callModelDefaults?: LlmProviderConfig;
+    /** Harness-wide item schema extensions and validation strictness. */
+    itemSchemas?: ItemSchemaConfig;
     /** Default projection policy for all LLM steps. Individual steps override via `step.projection`. */
     projection?: ProjectionPolicy;
     /** When true, every layer is recalled atomically regardless of its `recallMode`. */
@@ -55,15 +78,8 @@ interface AgentHarnessOpts<TParams extends Record<string, unknown> = Record<stri
     /** Tuning for prompt-cache anchoring. See `ContextCacheConfig` for the defaults. */
     contextCache?: ContextCacheConfig;
     traceExporter?: TraceExporter;
-    layerStateStore?: LayerStateStore;
     /** Default delivery mode for messages that don't specify one. Defaults to `next-turn`. */
     defaultDeliveryMode?: DeliveryMode;
-    /**
-     * Abort the in-flight model call if the provider stream emits no events for this
-     * many milliseconds. Defaults to `DEFAULT_STREAM_IDLE_TIMEOUT_MS` (120s).
-     * Pass `0` or a negative number to disable the watchdog.
-     */
-    streamIdleTimeoutMs?: number;
     /**
      * Initial working directory for the harness. Used as the seed value for the
      * shared `cwdState.cwd` on every Context this harness creates, including
@@ -129,7 +145,7 @@ export declare class AgentHarness<TParams extends Record<string, unknown> = Reco
      * @internal
      */
     readonly stepLedgerRetention: Required<StepLedgerRetention>;
-    private readonly initialStep?;
+    private readonly agentGraph?;
     /** Harness-wide tool pool merged into every context's `unifiedTools`. */
     private readonly harnessTools;
     /** @internal Context layers configured for this harness. Exposed non-private
@@ -142,7 +158,6 @@ export declare class AgentHarness<TParams extends Record<string, unknown> = Reco
     private readonly rootRunDepth;
     private readonly callModelOverride?;
     private readonly defaultDeliveryMode;
-    private readonly streamIdleTimeoutMs;
     private readonly sessions;
     /**
      * @internal Cross-step harness sessions keyed by `step.session.reuse`, kept
@@ -193,6 +208,7 @@ export declare class AgentHarness<TParams extends Record<string, unknown> = Reco
     }): Promise<void>;
     getStatus(scope?: SessionScope): HarnessStatus;
     getQueueSize(scope?: SessionScope): number;
+    getUsage(scope?: SessionScope): SessionUsage;
     seedSessionHistory(threadId: string, items: ReadonlyArray<Item>): void;
     private getOrCreateSession;
     private requireSession;
@@ -225,9 +241,7 @@ export declare class AgentHarness<TParams extends Record<string, unknown> = Reco
         state?: unknown;
         threadId?: string;
         resourceId?: string;
-        context?: ContextLayer[];
-        /** @deprecated Renamed to `context`. */
-        memory?: ContextLayer[];
+        contextLayers?: ContextLayer[];
         /**
          * Initial cwd for the new context. When set, takes precedence over both
          * the parent snapshot and the harness root cwd — used by worktree

package/dist/harness/agent-harness.js

@@ -8,7 +8,6 @@ import { buildItemStream, ChannelStore, ContextImpl, captureCheckpoint, clearChe
 import { SteeringAction } from './deps/types.js';
 import { AgentHarnessModelCaller } from './model-call.js';
 export { createStreamIdleWatchdog } from './model-call.js';
-import { resolveContextOption } from '../builders/context-option.js';
 import { buildItemSchemaRegistry } from './model-schema.js';
 //#endregion
 const DEFAULT_THREAD_ID = '__default__';
@@ -178,7 +177,7 @@ export class AgentHarness {
      * @internal
      */
     stepLedgerRetention;
-    initialStep;
+    agentGraph;
     /** Harness-wide tool pool merged into every context's `unifiedTools`. */
     harnessTools;
     /** @internal Context layers configured for this harness. Exposed non-private
@@ -191,7 +190,6 @@ export class AgentHarness {
     rootRunDepth = new Map();
     callModelOverride;
     defaultDeliveryMode;
-    streamIdleTimeoutMs;
     sessions = new Map();
     /**
      * @internal Cross-step harness sessions keyed by `step.session.reuse`, kept
@@ -225,45 +223,47 @@ export class AgentHarness {
     itemSchemas;
     constructor(opts) {
         const validatedParams = opts.paramsSchema ? opts.paramsSchema.parse(opts.params) : opts.params;
+        const environment = opts.environment;
+        const storageEnv = environment?.storage;
         this.config = {
             name: opts.name,
-            storage: opts.storage ?? createInMemoryStorage(),
+            storage: storageEnv?.adapter ?? createInMemoryStorage(),
             hooks: opts.hooks,
             params: validatedParams,
             itemSchemas: opts.itemSchemas,
-            strictItemSchemas: opts.strictItemSchemas ?? true,
             projection: opts.projection,
             forceAtomicRecall: opts.forceAtomicRecall,
             contextCache: opts.contextCache,
         };
-        this.fs = opts.fs ?? createInMemoryFsAdapter();
-        this.shell = opts.shell ?? createInMemoryShellAdapter();
-        this.subprocess = opts.subprocess ?? createInMemorySubprocessAdapter();
-        this.checkpointStore = opts.checkpointStore;
-        this.stepLedgerStore = opts.checkpointStore
+        this.fs = environment?.fs ?? createInMemoryFsAdapter();
+        this.shell = environment?.shell ?? createInMemoryShellAdapter();
+        this.subprocess = environment?.subprocess ?? createInMemorySubprocessAdapter();
+        this.checkpointStore = storageEnv?.checkpointStore;
+        this.stepLedgerStore = storageEnv?.checkpointStore
             ? createStepLedgerStore({
                 storage: this.config.storage ?? createInMemoryStorage(),
             })
             : undefined;
-        this.stepLedgerRetention = resolveStepLedgerRetention(opts.stepLedgerRetention);
-        this.initialStep = opts.initialStep;
+        this.stepLedgerRetention = resolveStepLedgerRetention(storageEnv?.stepLedgerRetention);
+        this.agentGraph = opts.agentGraph;
         this.harnessTools = opts.tools ?? [];
-        this._contextLayers = resolveContextOption(opts);
+        this._contextLayers = opts.contextLayers;
         this.callModelOverride = opts._testCallModel;
-        this.client = opts._testCallModel ? undefined : createClient(opts.llm, opts.contextCache);
+        this.client = opts._testCallModel
+            ? undefined
+            : createClient(opts.callModelDefaults, opts.contextCache);
         this.channelStore = new ChannelStore();
         this.traceExporter = opts.traceExporter ?? new NoopExporter();
         this.layerStateStore =
-            opts.layerStateStore ??
+            storageEnv?.layerStateStore ??
                 createLayerStateStore((layerId, hook, error) => {
                     console.warn(`[noetic] context layer '${layerId}' ${hook} error:`, error);
                 });
         this.recallCache = createRecallCache();
         this.contextCache = createContextCacheStore();
         this.defaultDeliveryMode = opts.defaultDeliveryMode ?? 'next-turn';
-        this.streamIdleTimeoutMs = opts.streamIdleTimeoutMs ?? DEFAULT_STREAM_IDLE_TIMEOUT_MS;
-        this.itemSchemas = new ItemSchemaRegistry(opts.itemSchemas, {
-            strictUnknownExtensions: opts.strictItemSchemas ?? true,
+        this.itemSchemas = new ItemSchemaRegistry(opts.itemSchemas?.schemas, {
+            strictUnknownExtensions: opts.itemSchemas?.strict ?? true,
         });
         this.rootCwdState = {
             cwd: opts.initialCwd ?? '/',
@@ -284,11 +284,11 @@ export class AgentHarness {
     }
     //#region Session Accessors
     execute(input, options) {
-        if (!this.initialStep) {
+        if (!this.agentGraph) {
             return Promise.reject(new NoeticConfigError({
                 code: 'NO_STEP_CONFIGURED',
-                message: 'No initialStep configured on this harness.',
-                hint: 'Pass `initialStep` in constructor options, or use run() directly.',
+                message: 'No agentGraph configured on this harness.',
+                hint: 'Pass `agentGraph` in constructor options, or use run() directly.',
             }));
         }
         const threadId = options?.threadId ?? DEFAULT_THREAD_ID;
@@ -353,6 +353,17 @@ export class AgentHarness {
         const session = this.sessions.get(threadId);
         return session ? session.runner.queue.size : 0;
     }
+    getUsage(scope) {
+        const threadId = scope?.threadId ?? DEFAULT_THREAD_ID;
+        const session = this.sessions.get(threadId);
+        if (!session) {
+            return {
+                inputTokens: 0,
+                outputTokens: 0,
+            };
+        }
+        return session.runner.getUsage();
+    }
     seedSessionHistory(threadId, items) {
         const session = this.getOrCreateSession(threadId);
         session.accumulatedItems = [
@@ -385,15 +396,15 @@ export class AgentHarness {
                         threadId,
                         resourceId: perTurnOptions.resourceId,
                         state: perTurnOptions.state,
-                        context: resolveContextOption(perTurnOptions),
+                        contextLayers: perTurnOptions.contextLayers,
                         _broadcaster: session.runner.broadcaster,
                     });
                     const ext = frameworkCast(ctx);
                     ext._sessionQueue = session.runner.queue;
                     ext._sessionBetweenRounds = true;
                     ext._sessionRunnerAgentName = this.config.name;
-                    if (this.initialStep || this.harnessTools.length > 0) {
-                        const stepTools = this.initialStep ? collectAllTools(this.initialStep) : [];
+                    if (this.agentGraph || this.harnessTools.length > 0) {
+                        const stepTools = this.agentGraph ? collectAllTools(this.agentGraph) : [];
                         this.setUnifiedTools(ctx, [
                             ...stepTools,
                             ...this.harnessTools,
@@ -402,11 +413,11 @@ export class AgentHarness {
                     return ctx;
                 },
                 runTurn: async (ctx, _turn, signal) => {
-                    if (!this.initialStep) {
+                    if (!this.agentGraph) {
                         throw new NoeticConfigError({
                             code: 'NO_STEP_CONFIGURED',
-                            message: 'No initialStep configured on this harness.',
-                            hint: 'Pass `initialStep` in constructor options.',
+                            message: 'No agentGraph configured on this harness.',
+                            hint: 'Pass `agentGraph` in constructor options.',
                         });
                     }
                     // Wire signal-abort to context-abort so the interpreter bails cleanly.
@@ -420,7 +431,7 @@ export class AgentHarness {
                             once: true,
                         });
                     }
-                    const result = await this.initAndRun(this.initialStep, '', ctx);
+                    const result = await this.initAndRun(this.agentGraph, '', ctx);
                     // Snapshot final items into session history for the next turn.
                     session.accumulatedItems = [
                         ...ctx.itemLog.items,
@@ -450,7 +461,7 @@ export class AgentHarness {
             itemSchemas: this.itemSchemas,
             client: this.client,
             callModelOverride: this.callModelOverride,
-            streamIdleTimeoutMs: this.streamIdleTimeoutMs,
+            streamIdleTimeoutMs: DEFAULT_STREAM_IDLE_TIMEOUT_MS,
             harness: this,
             traceExporter: this.traceExporter,
         }).callModel(request);
@@ -540,10 +551,10 @@ export class AgentHarness {
     }
     createContext(opts) {
         const resolved = opts ?? {};
-        // `ContextImpl` takes the layers as `layers`, so both option spellings are
+        // `ContextImpl` takes the layers as `layers`, so the option spelling is
         // dropped from `rest` rather than spread through under the wrong name.
-        const { context: _context, memory: _memory, cwdInit, ...rest } = resolved;
-        const effectiveLayers = resolveContextOption(resolved) ?? this._contextLayers;
+        const { contextLayers, cwdInit, ...rest } = resolved;
+        const effectiveLayers = contextLayers ?? this._contextLayers;
         const itemSchemas = buildItemSchemaRegistry({
             base: this.itemSchemas,
             layers: effectiveLayers,
@@ -696,7 +707,7 @@ export class AgentHarness {
         const ctx = this.createContext({
             items: historyItems,
             threadId,
-            context: this._contextLayers,
+            contextLayers: this._contextLayers,
         });
         const layers = ctx.layers ?? [];
         if (layers.length === 0) {

package/dist/harness/deps/types.d.ts

@@ -1,4 +1,4 @@
 export type { ContextCacheConfig, ContextCacheStore, ContextData, ContextLayer, ExecutionContext, ProjectionPolicy, StorageAdapter, } from '@noetic-tools/context';
-export type { AgentConfig, AgentHarnessContract, AgentHooks, CallModelRequest, Channel, ChannelHandle, Context, CwdState, DeliveryMode, DetachedHandle, ExecuteInput, ExecuteOptions, ExternalChannel, FsAdapter, HarnessResponse, HarnessStatus, Item, ItemSchemaExtensions, LLMResponse, LlmProviderConfig, RecallLayerOutput, SessionScope, ShellAdapter, Span, SteeringDecision, Step, StreamEvent, StreamingItem, SubHarnessSession, SubprocessAdapter, Tool, TraceExporter, } from '@noetic-tools/types';
+export type { AgentConfig, AgentHarnessContract, AgentHooks, CallModelRequest, Channel, ChannelHandle, Context, CwdState, DeliveryMode, DetachedHandle, ExecuteInput, ExecuteOptions, ExternalChannel, FsAdapter, HarnessResponse, HarnessStatus, Item, ItemSchemaConfig, ItemSchemaExtensions, LLMResponse, LlmProviderConfig, RecallLayerOutput, SessionScope, SessionUsage, ShellAdapter, Span, SteeringDecision, Step, StreamEvent, StreamingItem, SubHarnessSession, SubprocessAdapter, Tool, TraceExporter, } from '@noetic-tools/types';
 export { SteeringAction } from '@noetic-tools/types';
 export type { ZodType } from 'zod';

package/dist/harness/model-call.d.ts

@@ -10,7 +10,7 @@ interface StreamIdleWatchdog {
 /** @internal Create a watchdog that aborts `controller` when no
  *  {@link StreamIdleWatchdog.reset reset} is called within `timeoutMs`. When
  *  `timeoutMs <= 0`, returns an inert no-op so callers can always call `.reset()`
- *  / `.stop()` without a branch. Starts armed: the caller is responsible for
+ *  / `.stop()` without branching. Starts armed: the caller is responsible for
  *  `.stop()` in a `finally`. `onTimeout` runs before the abort so observers can
  *  emit a framework event with the original cause. Exported only for unit tests. */
 export declare function createStreamIdleWatchdog(timeoutMs: number, controller: AbortController, onTimeout?: () => void): StreamIdleWatchdog;

package/dist/harness/model-call.js

@@ -1,7 +1,6 @@
 import { frameworkCast, NoeticConfigError } from '@noetic-tools/types';
 import { serverTool } from '@openrouter/agent';
-import { z } from 'zod';
-import { convertTools, executeToolCall, extractOutputItems, extractSystemInstruction, extractUsage, itemsToInput, sanitizeToolNameForWire, } from '../adapters/openrouter.js';
+import { convertTools, executeToolCall, extractOutputItems, extractSystemInstruction, extractUsage, itemsToInput, resolveWireJsonSchema, sanitizeToolNameForWire, } from '../adapters/openrouter.js';
 import { isFunctionCall } from '../interpreter/typeguards.js';
 import { GenAI, NoeticAttr, ToolAttr } from '../observability/genai-attributes.js';
 import { emitFrameworkEvent, getBroadcaster, shouldEmit } from '../runtime/broadcaster-utils.js';
@@ -9,8 +8,12 @@ import { buildItemSchemaRegistry, createToolResultItem } from './model-schema.js
 const MAX_TOOL_ROUNDS = 32;
 const MAX_RECOVERY_CONTINUATIONS = 3;
 const EPHEMERAL_CONTINUE_INPUT = 'continue';
-function buildTextFormat(schema) {
-    const jsonSchema = z.toJSONSchema(schema);
+function buildTextFormat(schema, explicitJsonSchema) {
+    const jsonSchema = resolveWireJsonSchema({
+        schema,
+        explicitJsonSchema,
+        what: 'structured output schema',
+    });
     return {
         format: {
             type: 'json_schema',
@@ -133,7 +136,7 @@ async function pipeStreamEventsToBroadcaster(opts) {
 /** @internal Create a watchdog that aborts `controller` when no
  *  {@link StreamIdleWatchdog.reset reset} is called within `timeoutMs`. When
  *  `timeoutMs <= 0`, returns an inert no-op so callers can always call `.reset()`
- *  / `.stop()` without a branch. Starts armed: the caller is responsible for
+ *  / `.stop()` without branching. Starts armed: the caller is responsible for
  *  `.stop()` in a `finally`. `onTimeout` runs before the abort so observers can
  *  emit a framework event with the original cause. Exported only for unit tests. */
 export function createStreamIdleWatchdog(timeoutMs, controller, onTimeout) {
@@ -150,7 +153,7 @@ export function createStreamIdleWatchdog(timeoutMs, controller, onTimeout) {
             if (stopped) {
                 return;
             }
-            const reason = new Error(`llm stream idle timeout after ${timeoutMs}ms`);
+            const reason = new Error(`model stream idle timeout after ${timeoutMs}ms`);
             onTimeout?.();
             controller.abort(reason);
         }, timeoutMs);
@@ -354,7 +357,7 @@ export class AgentHarnessModelCaller {
         throw new NoeticConfigError({
             code: 'NO_LLM_PROVIDER',
             message: 'No LLM provider configured on this harness.',
-            hint: 'Pass `llm: { apiKey: "..." }` (defaults to the Noetic platform) or set NOETIC_API_KEY. For direct OpenRouter, use `llm: { provider: "openrouter", apiKey: "..." }` or set OPENROUTER_API_KEY.',
+            hint: 'Pass `callModelDefaults: { apiKey: "..." }` (defaults to the Noetic platform) or set NOETIC_API_KEY. For direct OpenRouter, use `callModelDefaults: { provider: "openrouter", apiKey: "..." }` or set OPENROUTER_API_KEY.',
         });
     }
     async callModel(request) {
@@ -384,7 +387,9 @@ export class AgentHarnessModelCaller {
         const rounds = [];
         let totalCost = 0;
         const conversationInput = itemsToInput(prepared.remaining);
-        const textFormat = request.outputSchema ? buildTextFormat(request.outputSchema) : undefined;
+        const textFormat = request.outputSchema
+            ? buildTextFormat(request.outputSchema, request.outputJsonSchema)
+            : undefined;
         let round = 0;
         let invalidRecoveryContinuations = 0;
         let toolLimitRecoveryContinuations = 0;
@@ -406,7 +411,7 @@ export class AgentHarnessModelCaller {
             let idleStalled = false;
             const watchdog = createStreamIdleWatchdog(this.opts.streamIdleTimeoutMs, roundController, () => {
                 idleStalled = true;
-                prepared.emitIfAllowed('llm_call_stalled', {
+                prepared.emitIfAllowed('model_call_stalled', {
                     round,
                     idleTimeoutMs: this.opts.streamIdleTimeoutMs,
                 });
@@ -414,7 +419,7 @@ export class AgentHarnessModelCaller {
             const modelInput = recoveryContinuation
                 ? withEphemeralContinueInput(conversationInput)
                 : frameworkCast(conversationInput);
-            prepared.emitIfAllowed('llm_call_started', {
+            prepared.emitIfAllowed('model_call_started', {
                 round,
                 messageCount: modelInput.length,
                 toolCount: prepared.sdkTools?.length ?? 0,
@@ -446,7 +451,7 @@ export class AgentHarnessModelCaller {
                     watchdog.reset();
                     if (!firstEventSeen) {
                         firstEventSeen = true;
-                        prepared.emitIfAllowed('llm_call_first_event', {
+                        prepared.emitIfAllowed('model_call_first_event', {
                             round,
                         });
                     }
@@ -462,7 +467,7 @@ export class AgentHarnessModelCaller {
                 if (idleStalled) {
                     throw roundSignal.reason instanceof Error
                         ? roundSignal.reason
-                        : new Error(`llm stream idle timeout after ${this.opts.streamIdleTimeoutMs}ms`);
+                        : new Error(`model stream idle timeout after ${this.opts.streamIdleTimeoutMs}ms`);
                 }
                 if (request.signal?.aborted) {
                     break;
@@ -507,7 +512,7 @@ export class AgentHarnessModelCaller {
                 continue;
             }
             invalidRecoveryContinuations = 0;
-            prepared.emitIfAllowed('llm_call_completed', {
+            prepared.emitIfAllowed('model_call_completed', {
                 round,
                 itemCount: sdkResponse.output?.length ?? 0,
             });
@@ -605,7 +610,7 @@ export class AgentHarnessModelCaller {
                 kind: 'ok',
             };
         }
-        params.emitIfAllowed('llm_call_failed', {
+        params.emitIfAllowed('model_call_failed', {
             round: params.round,
             status: terminalError.status,
             error: terminalError.message,
@@ -615,7 +620,7 @@ export class AgentHarnessModelCaller {
             throw new Error(terminalError.message);
         }
         const next = params.invalidRecoveryContinuations + 1;
-        params.emitIfAllowed('llm_call_recovery_continue', {
+        params.emitIfAllowed('model_call_recovery_continue', {
             round: params.round,
             status: terminalError.status,
             attempt: next,
@@ -633,7 +638,7 @@ export class AgentHarnessModelCaller {
             };
         }
         const message = 'LLM response completed with no output items';
-        params.emitIfAllowed('llm_call_failed', {
+        params.emitIfAllowed('model_call_failed', {
             round: params.round,
             status: 'completed',
             error: message,
@@ -643,7 +648,7 @@ export class AgentHarnessModelCaller {
             throw new Error(message);
         }
         const next = params.invalidRecoveryContinuations + 1;
-        params.emitIfAllowed('llm_call_recovery_continue', {
+        params.emitIfAllowed('model_call_recovery_continue', {
             round: params.round,
             status: 'completed',
             attempt: next,
@@ -750,7 +755,7 @@ export class AgentHarnessModelCaller {
     recordMalformedToolCall(params) {
         const { fc, request, allItems, conversationInput } = params;
         const errorOutput = `Error: malformed JSON in tool arguments: ${fc.arguments}`;
-        const toolForCall = request.tools?.find((tool) => tool.name === fc.name);
+        const toolForCall = request.tools?.find((tool) => tool.name === fc.name || sanitizeToolNameForWire(tool.name) === fc.name);
         // Owner-scoped result validation (see executeFunctionCall).
         const outputItem = createToolResultItem({
             output: errorOutput,

package/dist/index.d.ts

@@ -11,31 +11,35 @@ export { channel } from './builders/channel-builder.js';
 /** @public */
 export { context } from './builders/context-builder.js';
 /** @public */
-export { branch, fork } from './builders/control-flow-builders.js';
+export { conditional, inParallel } from './builders/control-flow-builders.js';
 /** @public */
-export type { EveryOptions } from './builders/every.js';
+export type { ScheduleOptions } from './builders/every.js';
 /** @public */
-export { every } from './builders/every.js';
+export { schedule } from './builders/every.js';
 /** @public */
-export { layerData, layerFn } from './builders/layer-provides-builders.js';
+export { layerData, layerFunction } from './builders/layer-provides-builders.js';
 /** @public */
 export type { LoopConfig } from './builders/loop-builder.js';
 /** @public */
 export { loop } from './builders/loop-builder.js';
 /** @public */
-export { provide } from './builders/provide-builder.js';
+export { withContext } from './builders/provide-builder.js';
 /** @public */
 export { spawn } from './builders/spawn-builder.js';
 /** @public */
+export type { CallModelOpts, InvokeToolOpts, RunCodeOpts } from './builders/step-builders.js';
+/** @public */
+export { callModel, invokeTool, runCode, step } from './builders/step-builders.js';
+/** @public */
 export { tool, toolWithGenerator } from './builders/tool-builder.js';
 /** @public */
 export type { HydrationContext } from './builders/workflow-hydrator.js';
 /** @public */
 export { hydrateNode, hydrateWorkflow } from './builders/workflow-hydrator.js';
 /** @public */
-export type { StepWorkflowOpts } from './builders/workflow-step.js';
+export type { WorkflowOpts } from './builders/workflow-step.js';
 /** @public */
-export { step } from './builders/workflow-step.js';
+export { workflow } from './builders/workflow-step.js';
 /** @public */
 export type { Condition, OtherwiseClause, WhenClause } from './conditions/conditions.js';
 /** @public */
@@ -57,7 +61,7 @@ export { execute } from './interpreter/execute.js';
 /** @public */
 /** @public */
 /** @public */
-export type { DurableTaskState, FactExtractor, FactSearcher, HistoryWindowConfig, ObservationalContextConfig, ObservationalState, PlanContextConfig, PlanEnterSessionCallback, PlanExecutionEntry, PlanExitCallback, PlanState, TemporalContextConfig, TemporalFact, TemporalSearchResult, WorkingMemoryContextConfig, WorkingMemoryContextState, } from '@noetic-tools/context';
+export type { FactExtractor, FactSearcher, HistoryConfig, ObservationsConfig, ObservationsState, PlanConfig, PlanEnterSessionCallback, PlanExecutionEntry, PlanExitCallback, PlanState, ScratchpadConfig, ScratchpadState, TaskState, TemporalConfig, TemporalFact, TemporalSearchResult, } from '@noetic-tools/context';
 /** @public */
 /** @public */
 /** @public */
@@ -70,7 +74,7 @@ export type { DurableTaskState, FactExtractor, FactSearcher, HistoryWindowConfig
 /** @public */
 /** @public */
 /** @public */
-export { durableTaskState, fileReference, findFunctionCall, historyWindow, observationalContext, PlanPhase, PlanStyle, planContext, staticContent, steering, storageGetMany, stripUnresolvedToolCalls, temporalContext, toolContextLayer, workingMemoryContext, } from '@noetic-tools/context';
+export { filesystem, findFunctionCall, history, instructions, observations, PlanPhase, PlanStyle, plan, scratchpad, steering, storageGetMany, stripUnresolvedToolCalls, taskState, temporal, toolCalls, } from '@noetic-tools/context';
 /** @public */
 export { createMessage, estimateTokens } from '@noetic-tools/types';
 /** @public */
@@ -80,21 +84,11 @@ export { InMemoryExporter, NoopExporter } from './observability/trace-exporter.j
 /** @public */
 export { createInMemoryStorage } from './runtime/in-memory-storage.js';
 /** @public */
-export type { DynamicWorkflowOpts, ParseAndRunWorkflowOpts } from './patterns/dynamic-workflow.js';
-/** @public */
-export { dynamicWorkflow, parseAndRunWorkflow } from './patterns/dynamic-workflow.js';
-/** @public */
-export type { InterviewOpts, InterviewQuestionAnswer, InterviewResult } from './patterns/interview.js';
-/** @public */
-export { interview } from './patterns/interview.js';
-/** @public */
-export type { PlanConstraints, PlanNode } from './patterns/plans.js';
-/** @public */
-export { adaptivePlan, compilePlan, PlanNodeSchema } from './patterns/plans.js';
+export type { DynamicWorkflowOpts, ParseAndRunWorkflowOpts } from './builders/dynamic-workflow.js';
 /** @public */
-export { ralphWiggum } from './patterns/ralph-wiggum.js';
+export { dynamicWorkflow, parseAndRunWorkflow } from './builders/dynamic-workflow.js';
 /** @public */
-export { react } from './patterns/react.js';
+export type { AgentEnvironmentConfig, StorageEnvironmentConfig, } from './harness/agent-harness.js';
 /** @public */
 export { AgentHarness } from './harness/agent-harness.js';
 /** @public */
@@ -106,16 +100,16 @@ export { getRegistry, lookupStep, registerStep } from './runtime/step-registry.j
 /** @public */
 export { defaultItemSchemaRegistry, ItemSchema, ItemSchemaRegistry } from '@noetic-tools/types';
 /** @public */
-export type { BranchRoute, BranchWorkflowNode, EveryWorkflowNode, ForkWorkflowNode, LlmWorkflowNode, LoopWorkflowNode, MergeStrategy, ProvideWorkflowNode, SequenceWorkflowNode, SpawnWorkflowNode, SubflowWorkflowNode, SubHarnessWorkflowNode, ToolWorkflowNode, UntilPredicate, WorkflowDocument, WorkflowNode, } from './schemas/workflow.js';
+export type { CallModelWorkflowNode, ConditionalRoute, ConditionalWorkflowNode, InParallelWorkflowNode, InvokeToolWorkflowNode, LoopWorkflowNode, MergeStrategy, ScheduleWorkflowNode, SequenceWorkflowNode, SpawnWorkflowNode, SubflowWorkflowNode, SubHarnessWorkflowNode, UntilPredicate, WithContextWorkflowNode, WorkflowDocument, WorkflowNode, } from './schemas/workflow.js';
 /** @public */
 export { MergeStrategySchema, UntilPredicateSchema, validateWorkflow, WorkflowDocumentSchema, WorkflowNodeSchema, walkWorkflow, workflowDepth, } from './schemas/workflow.js';
 /** @public */
 export type { Channel, ChannelHandle, ExternalChannel } from '@noetic-tools/types';
 /** @public */
 /** @public */
-export type { LLMResponse, LlmProviderConfig, ModelParams, RetryPolicy, RoundUsage, ServerToolSpec, StepMeta, TokenUsage, Tool, ToolContextDeclaration, } from '@noetic-tools/types';
+export type { InferSchemaInput, InferSchemaOutput, InputSchemaConfig, LLMResponse, LlmProviderConfig, ModelParams, RetryPolicy, RoundUsage, SchemaValidationFailure, SchemaValidationResult, SchemaValidationSuccess, ServerToolSpec, StandardJSONSchemaV1, StandardSchemaV1, StepMeta, TokenUsage, Tool, ToolContextDeclaration, } from '@noetic-tools/types';
 /** @public */
-export { isServerToolSpec } from '@noetic-tools/types';
+export { isServerToolSpec, isStandardJsonSchema, isZodSchema, standardIssuesToZodError, validateSchema, } from '@noetic-tools/types';
 /** @public */
 /** @public */
 /** @public */
@@ -147,13 +141,13 @@ export type { LayerTraceSpan, Span, TraceExporter } from '@noetic-tools/types';
 /** @public */
 export type { FrameworkStreamEvent, HarnessResponse, SdkStreamEvent, StreamEvent, StreamingItem, } from '@noetic-tools/types';
 /** @public */
-export type { AgentConfig, AgentHarnessContract, AgentHooks, CallModelRequest, ContextCacheConfig, ContextCacheStore, ContextEpoch, DeliveryMode, ExecuteOptions, HarnessStatus, ReanchorReason, RecallLayerOutput, SessionScope, } from '@noetic-tools/types';
+export type { AgentConfig, AgentHarnessContract, AgentHooks, CallModelRequest, ContextCacheConfig, ContextCacheStore, ContextEpoch, DeliveryMode, ExecuteOptions, HarnessStatus, ItemSchemaConfig, ReanchorReason, RecallLayerOutput, SessionScope, SessionUsage, } from '@noetic-tools/types';
 /** @public */
 export type { AfterModelCallParams, AfterModelCallResult, BeforeToolCallParams, BeforeToolCallResult, LedgerEntry, SteeringConfig, SteeringDecision, SteeringRule, SteeringState, } from '@noetic-tools/types';
 /** @public */
 export { LedgerEntryKind, SteeringAction } from '@noetic-tools/types';
 /** @public */
-export type { ExecuteStepFn, SettleResult, Snapshot, Step, StepBranch, StepFork, StepForkAll, StepForkRace, StepForkSettle, StepLLM, StepLoop, StepProvide, StepRun, StepSpawn, StepSubHarness, StepTool, Until, Verdict, } from '@noetic-tools/types';
+export type { ExecuteStepFn, SettleResult, Snapshot, Step, StepCallModel, StepConditional, StepInParallel, StepInParallelAll, StepInParallelRace, StepInParallelSettle, StepInvokeTool, StepLoop, StepRunCode, StepSpawn, StepSubHarness, StepWithContext, Until, Verdict, } from '@noetic-tools/types';
 /** @public */
 export type { SubHarness, SubHarnessBuiltinTool, SubHarnessContinueState, SubHarnessContinueTurnOptions, SubHarnessFinishReason, SubHarnessPromptTurnOptions, SubHarnessResumeState, SubHarnessRunContext, SubHarnessSession, SubHarnessSessionPolicy, SubHarnessSettings, SubHarnessStartOptions, SubHarnessStreamPart, SubHarnessTurnResult, } from '@noetic-tools/types';
 /** @public */
@@ -175,9 +169,3 @@ export { all, any } from './until/combinators.js';
 export type { ConvergeConfig, VerifyFn } from './until/predicates.js';
 /** @public */
 export { until } from './until/predicates.js';
-/**
- * Pre-rename names for the context layer system — `MemoryLayer`, `memory()`,
- * `workingMemory`, and friends. Each carries its own `@deprecated` pointer to
- * its replacement in `./deprecated`. Removed in the next major.
- */
-export * from './deprecated.js';