@noetic-tools/core 5.2.0 → 5.4.0

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);
@@ -272,6 +275,12 @@ class CallSpanCollector {
     finishModelSpan(span, usage, cost) {
         span.setAttribute(GenAI.USAGE_INPUT_TOKENS, usage.inputTokens);
         span.setAttribute(GenAI.USAGE_OUTPUT_TOKENS, usage.outputTokens);
+        if (usage.cachedTokens !== undefined) {
+            span.setAttribute(GenAI.USAGE_CACHED_INPUT_TOKENS, usage.cachedTokens);
+        }
+        if (usage.cacheWriteTokens !== undefined) {
+            span.setAttribute(GenAI.USAGE_CACHE_WRITE_TOKENS, usage.cacheWriteTokens);
+        }
         if (cost !== undefined) {
             span.setAttribute(GenAI.COST, cost);
         }
@@ -348,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) {
@@ -372,9 +381,15 @@ export class AgentHarnessModelCaller {
             outputTokens: 0,
             cachedTokens: 0,
         };
+        // Rounds after the first replay the same prefix and so hit the prompt cache
+        // whatever the first round did. Keep them apart: only round 0 says whether
+        // the assembled view was cached (see `noteCacheOutcome`).
+        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;
@@ -396,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,
                 });
@@ -404,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,
@@ -436,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,
                         });
                     }
@@ -452,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;
@@ -497,16 +512,14 @@ export class AgentHarnessModelCaller {
                 continue;
             }
             invalidRecoveryContinuations = 0;
-            prepared.emitIfAllowed('llm_call_completed', {
+            prepared.emitIfAllowed('model_call_completed', {
                 round,
                 itemCount: sdkResponse.output?.length ?? 0,
             });
             const roundUsage = extractUsage(sdkResponse.usage);
             const roundCost = sdkResponse.usage?.cost ?? 0;
-            spans.finishModelSpan(modelSpan, {
-                inputTokens: roundUsage.inputTokens,
-                outputTokens: roundUsage.outputTokens,
-            }, roundCost > 0 ? roundCost : undefined);
+            spans.finishModelSpan(modelSpan, roundUsage, roundCost > 0 ? roundCost : undefined);
+            rounds.push(roundUsage);
             totalUsage.inputTokens += roundUsage.inputTokens;
             totalUsage.outputTokens += roundUsage.outputTokens;
             totalUsage.cachedTokens += roundUsage.cachedTokens ?? 0;
@@ -539,7 +552,16 @@ export class AgentHarnessModelCaller {
         }
         return {
             items: allItems,
-            usage: totalUsage,
+            usage: {
+                inputTokens: totalUsage.inputTokens,
+                outputTokens: totalUsage.outputTokens,
+                // Stay `undefined` when no round reported a figure, so callers can tell
+                // "this provider says nothing about caching" from "nothing was cached".
+                cachedTokens: rounds.some((r) => r.cachedTokens !== undefined)
+                    ? totalUsage.cachedTokens
+                    : undefined,
+            },
+            rounds,
             cost: totalCost > 0 ? totalCost : undefined,
         };
     }
@@ -588,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,
@@ -598,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,
@@ -616,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,
@@ -626,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,
@@ -733,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,20 +100,20 @@ 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, 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 */
-export type { Context, ContextHarness, CwdState, ItemLog, LastLayerUsage, LayerUsageEntry, RestoreContextOptions, } from '@noetic-tools/types';
+export type { Context, ContextHarness, CwdState, EpochUsage, ItemLog, LastLayerUsage, LayerUsageEntry, RestoreContextOptions, } from '@noetic-tools/types';
 /** @public */
 export { getToolCwd, setToolCwd, snapshotCwdState } from './runtime/cwd-helpers.js';
 /** @public */
@@ -137,7 +131,7 @@ export type { NoeticError } from '@noetic-tools/types';
 /** @public */
 export type { ContentPart, DeveloperMessageExtensionItem, ExecuteInput, ExtendedItem, ExtensionItem, FileSearchItem, FunctionCallItem, FunctionCallOutputItem, ImageGenerationItem, InferExtendedItem, InputContentPart, InputFilePart, InputImagePart, InputMessageItem, InputTextPart, Item, ItemBase, ItemSchemaExtensions, MessageItem, OutputItem, OutputTextPart, ReasoningItem, ReasoningTextPart, RefusalPart, ServerToolItem, SummaryTextPart, WebSearchItem, } from '@noetic-tools/types';
 /** @public */
-export type { BudgetConfig, CompleteParams, ContextConfig, ContextData, ContextLayer, ContextLayerHooks, DisposeParams, InferContext, InferContextShape, InitParams, InitResult, LayerDataDecl, LayerFunctionDecl, LayerProvides, LayerTimeouts, ProjectionPolicy, RecallParams, RecallResult, ReturnParams, ReturnResult, ScopedStorage, SpawnParams, SpawnResult, StorageAdapter, StoreParams, StoreResult, } from '@noetic-tools/context';
+export type { BudgetConfig, CompleteParams, ContextConfig, ContextData, ContextLayer, ContextLayerHooks, DisposeParams, InferContext, InferContextShape, InitParams, InitResult, LayerDataDecl, LayerFunctionDecl, LayerPlacement, LayerProvides, LayerTimeouts, ProjectionPolicy, RecallParams, RecallResult, RenderDeltaParams, ReturnParams, ReturnResult, ScopedStorage, SpawnParams, SpawnResult, StorageAdapter, StoreParams, StoreResult, } from '@noetic-tools/context';
 /** @public */
 export { Slot } from '@noetic-tools/context';
 /** @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, DeliveryMode, ExecuteOptions, HarnessStatus, 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';

package/dist/index.js

@@ -14,23 +14,25 @@ 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 { 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 { 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 { callModel, invokeTool, runCode, step } from './builders/step-builders.js';
+/** @public */
 export { tool, toolWithGenerator } from './builders/tool-builder.js';
 /** @public */
 export { hydrateNode, hydrateWorkflow } from './builders/workflow-hydrator.js';
 /** @public */
-export { step } from './builders/workflow-step.js';
+export { workflow } from './builders/workflow-step.js';
 /** @public */
 export { aiCondition, allCondition, anyCondition, embeddingMatch, otherwise, semanticRoute, semanticSwitch, when, } from './conditions/conditions.js';
 /** @public */
@@ -58,7 +60,7 @@ export { execute } from './interpreter/execute.js';
 /** @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';
 //#endregion
 //#region Message Utilities
 /** @public */
@@ -72,17 +74,7 @@ export { InMemoryExporter, NoopExporter } from './observability/trace-exporter.j
 /** @public */
 export { createInMemoryStorage } from './runtime/in-memory-storage.js';
 /** @public */
-export { dynamicWorkflow, parseAndRunWorkflow } from './patterns/dynamic-workflow.js';
-/** @public */
-export { interview } from './patterns/interview.js';
-/** @public */
-export { adaptivePlan, compilePlan, PlanNodeSchema } from './patterns/plans.js';
-/** @public */
-export { ralphWiggum } from './patterns/ralph-wiggum.js';
-/** @public */
-export { react } from './patterns/react.js';
-//#endregion
-//#region Runtime
+export { dynamicWorkflow, parseAndRunWorkflow } from './builders/dynamic-workflow.js';
 /** @public */
 export { AgentHarness } from './harness/agent-harness.js';
 /** @public */
@@ -96,7 +88,7 @@ export { defaultItemSchemaRegistry, ItemSchema, ItemSchemaRegistry } from '@noet
 /** @public */
 export { MergeStrategySchema, UntilPredicateSchema, validateWorkflow, WorkflowDocumentSchema, WorkflowNodeSchema, walkWorkflow, workflowDepth, } from './schemas/workflow.js';
 /** @public */
-export { isServerToolSpec } from '@noetic-tools/types';
+export { isServerToolSpec, isStandardJsonSchema, isZodSchema, standardIssuesToZodError, validateSchema, } from '@noetic-tools/types';
 /** @public */
 export { getToolCwd, setToolCwd, snapshotCwdState } from './runtime/cwd-helpers.js';
 /** @public */
@@ -120,11 +112,3 @@ export { all, any } from './until/combinators.js';
 /** @public */
 export { until } from './until/predicates.js';
 //#endregion
-//#region Deprecated aliases
-/**
- * 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';
-//#endregion

package/dist/interpreter/action-deps.d.ts

@@ -1,5 +1,5 @@
-export type { LayerStateStore } from '@noetic-tools/context';
-export { allocateBudgets, assembleView, commitLayerUsage, computeLayerUsage, contextToExecCtx, DEFAULT_PROJECTION, resolveLayerTools, returnLayers, spawnLayers, } from '@noetic-tools/context';
+export type { LayerServeInfo, LayerStateStore } from '@noetic-tools/context';
+export { allocateBudgets, assembleView, churnFor, churnRate, commitLayerUsage, computeLayerUsage, contextToExecCtx, createContextCacheStore, DEFAULT_PROJECTION, lineageKey, noteCacheOutcome, openEpoch, pin, pinKey, reanchorReason, resolveCacheConfig, resolveLayerTools, returnLayers, spawnLayers, } from '@noetic-tools/context';
 export type { ItemSchemaRegistry } from '@noetic-tools/types';
 export { defaultItemSchemaRegistry } from '@noetic-tools/types';
 export { emitFrameworkEvent, getBroadcaster, shouldEmit } from '../runtime/broadcaster-utils.js';

package/dist/interpreter/action-deps.js

@@ -1,4 +1,4 @@
-export { allocateBudgets, assembleView, commitLayerUsage, computeLayerUsage, contextToExecCtx, DEFAULT_PROJECTION, resolveLayerTools, returnLayers, spawnLayers, } from '@noetic-tools/context';
+export { allocateBudgets, assembleView, churnFor, churnRate, commitLayerUsage, computeLayerUsage, contextToExecCtx, createContextCacheStore, DEFAULT_PROJECTION, lineageKey, noteCacheOutcome, openEpoch, pin, pinKey, reanchorReason, resolveCacheConfig, resolveLayerTools, returnLayers, spawnLayers, } from '@noetic-tools/context';
 export { defaultItemSchemaRegistry } from '@noetic-tools/types';
 export { emitFrameworkEvent, getBroadcaster, shouldEmit } from '../runtime/broadcaster-utils.js';
 export { ContextImpl } from '../runtime/context-impl.js';

package/dist/interpreter/action-types.d.ts

@@ -1,3 +1,3 @@
 export type { ContextConfig, ContextData, ContextLayer, ExecutionContext, } from '@noetic-tools/context';
-export type { AgentHarnessContract, Context, ContextRerenderRequest, ExecuteStepFn, FunctionCallItem, Item, ProjectionPolicy, RecallLayerOutput, RetryPolicy, ServerToolSpec, StepLLM, StepMeta, StepProvide, StepRun, StepSpawn, StepTool, Tool, } from '@noetic-tools/types';
+export type { AgentHarnessContract, CallModelRequest, Context, ContextRerenderRequest, ExecuteStepFn, FunctionCallItem, InputMessageItem, Item, LLMResponse, ProjectionPolicy, RecallLayerOutput, RetryPolicy, ServerToolSpec, StepCallModel, StepInvokeTool, StepMeta, StepRunCode, StepSpawn, StepWithContext, Tool, } from '@noetic-tools/types';
 export { isServerToolSpec, SteeringAction } from '@noetic-tools/types';

package/dist/interpreter/collect-tools.js

@@ -27,7 +27,7 @@ export function deduplicateTools(tools) {
 }
 function walkStep(step, out) {
     switch (step.kind) {
-        case 'llm':
+        case 'callModel':
             // Skip function-form tools: they're resolved per execution from `ctx`
             // and cannot contribute to the pre-computed unified set. Consumers that
             // need those tools in the pool should register them via
@@ -41,8 +41,8 @@ function walkStep(step, out) {
                 }
             }
             return;
-        case 'run':
-        case 'tool':
+        case 'runCode':
+        case 'invokeTool':
         // SubHarness steps run their own built-in tools inside the external agent;
         // they contribute nothing to the host unified tool set.
         case 'claude-code':
@@ -50,21 +50,21 @@ function walkStep(step, out) {
         case 'opencode':
         case 'pi':
             return;
-        case 'branch':
+        case 'conditional':
             if (step._optimizable) {
                 for (const child of step._optimizable) {
                     walkStep(child, out);
                 }
             }
             return;
-        case 'fork':
+        case 'inParallel':
             if (step._optimizable) {
                 for (const child of step._optimizable) {
                     walkStep(child, out);
                 }
             }
             return;
-        case 'provide':
+        case 'withContext':
             walkStep(step.child, out);
             return;
         case 'spawn':
@@ -75,7 +75,7 @@ function walkStep(step, out) {
                 walkStep(child, out);
             }
             return;
-        case 'every':
+        case 'schedule':
             walkStep(step.step, out);
             return;
         default:

package/dist/interpreter/context-assembly.d.ts

@@ -0,0 +1,50 @@
+import type { ContextCacheConfig, ContextCacheStore, ContextLayer, EpochUsage, ExecutionContext, Item, ProjectionPolicy, RecallLayerOutput, Span } from '@noetic-tools/types';
+import type { LayerServeInfo } from './action-deps.js';
+/** What the layer bands contributed to one assembly, and how the epoch fared. */
+export interface BandedView {
+    /** Layer output rendered before history — pinned bytes where a pin exists. */
+    anchorItems: Item[];
+    /** Layer output rendered after history. */
+    liveItems: Item[];
+    /** At most one developer message superseding stale anchors. */
+    deltaItems: Item[];
+    /** Per-layer output as actually served, for the usage breakdown. */
+    servedPerLayer: RecallLayerOutput[];
+    serveInfo: Map<string, LayerServeInfo>;
+    epoch: EpochUsage | undefined;
+}
+interface PrepareBandedViewParams {
+    /** Recall output, already slot-sorted and merged with any re-render. */
+    recallResults: ReadonlyArray<RecallLayerOutput>;
+    layers: ReadonlyArray<ContextLayer>;
+    execCtx: ExecutionContext;
+    store: ContextCacheStore;
+    config?: ContextCacheConfig;
+    /** Resolved instructions — a change to them invalidates the prefix anyway. */
+    instructions: string | undefined;
+    policy: ProjectionPolicy;
+    systemPromptItems: ReadonlyArray<Item>;
+    /** Budget per layer id, used to size a `renderDelta`. */
+    budgets: ReadonlyMap<string, number>;
+    /**
+     * When true, read pins without writing: no new pins, no churn, no epoch
+     * ageing. For preview paths that must not disturb a live conversation.
+     */
+    readOnly?: boolean;
+}
+/**
+ * Split recall output into the anchor and live bands, replay pinned anchors, and
+ * gather everything that changed into a single supersede message.
+ *
+ * Runs once per LLM step, before the steering retry loop — a retry replays the
+ * same view, so re-pinning or re-counting churn there would distort both.
+ */
+export declare function prepareBandedView(params: PrepareBandedViewParams): Promise<BandedView>;
+/**
+ * Record how the view was banded on the step's span, so a slow or expensive run
+ * can be traced back to the layer that keeps invalidating the prefix.
+ */
+export declare function stampAnchoringAttributes(span: Span | undefined, view: BandedView): void;
+/** Tokens the prompt prefix was expected to have cached — what `noteCacheOutcome` judges against. */
+export declare function expectedCachedTokens(systemPromptItems: ReadonlyArray<Item>, view: BandedView): number;
+export {};