@noetic-tools/core 3.2.0 → 4.0.0

package/dist/harness/agent-harness.js

@@ -2,12 +2,13 @@ import { frameworkCast, ItemSchemaRegistry, NoeticConfigError } from '@noetic-to
 import { SpanImpl } from '../observability/span-impl.js';
 import { NoopExporter } from '../observability/trace-exporter.js';
 import { createInMemoryFsAdapter, createInMemoryShellAdapter, createInMemorySubprocessAdapter, OpenRouter, } from './deps/adapters.js';
+import { afterModelCallLayers, allocateBudgets, assembleView, beforeToolCallLayers, completeLayers, contextToExecCtx, createLayerStateStore, createRecallCache, DEFAULT_PROJECTION, disposeLayers, executeRerender, initLayers, projectHistoryLayers, recallLayers, recallLayersAtomic, recallLayersEventual, resolveLayerTools, runAppendPipeline, storeLayers, } from './deps/context.js';
 import { collectAllTools, deduplicateTools, dispatchStepThroughAdapter, execute, } from './deps/interpreter.js';
-import { afterModelCallLayers, allocateBudgets, assembleView, beforeToolCallLayers, completeLayers, contextToExecCtx, createLayerStateStore, createRecallCache, DEFAULT_PROJECTION, disposeLayers, executeRerender, initLayers, projectHistoryLayers, recallLayers, recallLayersAtomic, recallLayersEventual, resolveLayerTools, runAppendPipeline, storeLayers, } from './deps/memory.js';
 import { buildItemStream, ChannelStore, ContextImpl, captureCheckpoint, clearCheckpoint, collectContextTree, createInMemoryStorage, createStepLedgerStore, filterReasoningStream, filterTextStream, resolveStepLedgerRetention, restoreFromCheckpoint, SessionRunner, StepLedger, snapshotCwdState, } from './deps/runtime.js';
 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__';
@@ -104,8 +105,8 @@ function createClient(config) {
 }
 //#region AgentHarness
 /**
- * Default agent harness for executing agent steps with built-in channel, memory, and trace support.
- * Provides channel store, memory layer lifecycle, and trace export with no external dependencies.
+ * Default agent harness for executing agent steps with built-in channel, context, and trace support.
+ * Provides channel store, context layer lifecycle, and trace export with no external dependencies.
  *
  * Messages submitted via `execute()` are enqueued on a per-thread session and
  * processed by a `SessionRunner`. Consumers observe responses via the session-
@@ -139,10 +140,10 @@ export class AgentHarness {
     initialStep;
     /** Harness-wide tool pool merged into every context's `unifiedTools`. */
     harnessTools;
-    /** @internal Memory layers configured for this harness. Exposed non-private
+    /** @internal Context layers configured for this harness. Exposed non-private
      *  so free functions in `runtime/durable/` (checkpoint/restore) can read it
      *  without friend-class gymnastics. Do not access from outside core. */
-    _memory;
+    _contextLayers;
     client;
     channelStore;
     callModelOverride;
@@ -201,7 +202,7 @@ export class AgentHarness {
         this.stepLedgerRetention = resolveStepLedgerRetention(opts.stepLedgerRetention);
         this.initialStep = opts.initialStep;
         this.harnessTools = opts.tools ?? [];
-        this._memory = opts.memory;
+        this._contextLayers = resolveContextOption(opts);
         this.callModelOverride = opts._testCallModel;
         this.client = opts._testCallModel ? undefined : createClient(opts.llm);
         this.channelStore = new ChannelStore();
@@ -209,7 +210,7 @@ export class AgentHarness {
         this.layerStateStore =
             opts.layerStateStore ??
                 createLayerStateStore((layerId, hook, error) => {
-                    console.warn(`[noetic] memory layer '${layerId}' ${hook} error:`, error);
+                    console.warn(`[noetic] context layer '${layerId}' ${hook} error:`, error);
                 });
         this.recallCache = createRecallCache();
         this.defaultDeliveryMode = opts.defaultDeliveryMode ?? 'next-turn';
@@ -322,7 +323,7 @@ export class AgentHarness {
                 threadId,
                 agentName: this.config.name,
                 // The first queued message in a batch establishes `resourceId` /
-                // `state` / `memory` for the turn. If multiple messages are drained
+                // `state` / `context` for the turn. If multiple messages are drained
                 // together (queue flush), later messages' values for these fields
                 // are ignored. `deliveryMode` is resolved per-message at enqueue
                 // time and doesn't apply here.
@@ -337,7 +338,7 @@ export class AgentHarness {
                         threadId,
                         resourceId: perTurnOptions.resourceId,
                         state: perTurnOptions.state,
-                        memory: perTurnOptions.memory,
+                        context: resolveContextOption(perTurnOptions),
                         _broadcaster: session.runner.broadcaster,
                     });
                     const ext = frameworkCast(ctx);
@@ -419,8 +420,8 @@ export class AgentHarness {
                 ...this.harnessTools,
             ]);
         }
-        // Hydrate/recall/persist memory on the bare `run()` path too (issue #48):
-        // configuring `memory` + `storage` must "just work" without going through
+        // Hydrate/recall/persist context on the bare `run()` path too (issue #48):
+        // configuring `context` + `storage` must "just work" without going through
         // `execute()`/`seedSessionHistory`. Idempotent — see `ensureLayersInit`.
         await this.ensureLayersInit(ctx);
         return execute(s, input, ctx);
@@ -458,11 +459,14 @@ export class AgentHarness {
         return dispatchStepThroughAdapter(this, s, input, parentCtx, overrides);
     }
     createContext(opts) {
-        const { memory: memoryLayers, cwdInit, ...rest } = opts ?? {};
-        const effectiveMemory = memoryLayers ?? this._memory;
+        const resolved = opts ?? {};
+        // `ContextImpl` takes the layers as `layers`, so both option spellings are
+        // 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 itemSchemas = buildItemSchemaRegistry({
             base: this.itemSchemas,
-            layers: effectiveMemory,
+            layers: effectiveLayers,
         });
         /* The execution id is chosen here rather than inside ContextImpl so the ledger
          * can be keyed to it — the ledger's storage keys and `ctx.id` must agree for a
@@ -473,7 +477,7 @@ export class AgentHarness {
             id: executionId,
             harness: this,
             channelStore: this.channelStore,
-            layers: effectiveMemory,
+            layers: effectiveLayers,
             itemSchemas,
             cwdState: resolveContextCwdState(this.rootCwdState, opts?.parent, cwdInit),
             // Without this `ctx.checkpoint()` is inert, and the boundaries below never
@@ -586,7 +590,7 @@ export class AgentHarness {
     }
     /**
      * Compute the items array that would be sent to the model on the next turn —
-     * the same arrangement `executeLLM` builds: harness-level memory layers'
+     * the same arrangement `executeLLM` builds: harness-level context layers'
      * recall outputs concatenated with the session's accumulated history.
      *
      * Read-mostly: `recallLayers` writes layer-state snapshots to
@@ -606,7 +610,7 @@ export class AgentHarness {
         const ctx = this.createContext({
             items: historyItems,
             threadId,
-            memory: this._memory,
+            context: this._contextLayers,
         });
         const layers = ctx.layers ?? [];
         if (layers.length === 0) {
@@ -679,7 +683,7 @@ export class AgentHarness {
      * checkpoint via `CheckpointStore.clear()` and start a fresh execution.
      *
      * `opts` is the `createContext`-shaped wiring the host attached to the
-     * original context (broadcaster, parent, state, memory overrides). A
+     * original context (broadcaster, parent, state, context overrides). A
      * snapshot recovers data, not live objects — pass the same wiring here or
      * the resumed run gets an undecorated context and whatever depended on that
      * wiring (event streaming, mid-turn injection) stops working without
@@ -712,7 +716,7 @@ export class AgentHarness {
     //#endregion
     /**
      * Cancel an execution: abort `ctx` and every live descendant context, then
-     * run the memory-layer teardown for each (spec 09, Cancellation).
+     * run the context-layer teardown for each (spec 09, Cancellation).
      *
      * The abort itself fans out top-down and synchronously — `ctx.abort()`
      * cascades into every live fork path and spawn child, so no corner of the

package/dist/harness/deps/{memory.d.ts → context.d.ts}

@@ -1,2 +1,2 @@
-export type { LayerStateStore, RecallCache } from '@noetic-tools/memory';
-export { afterModelCallLayers, allocateBudgets, assembleView, beforeToolCallLayers, completeLayers, contextToExecCtx, createLayerStateStore, createRecallCache, DEFAULT_PROJECTION, disposeLayers, executeRerender, initLayers, projectHistoryLayers, recallLayers, recallLayersAtomic, recallLayersEventual, resolveLayerTools, runAppendPipeline, storeLayers, } from '@noetic-tools/memory';
+export type { LayerStateStore, RecallCache } from '@noetic-tools/context';
+export { afterModelCallLayers, allocateBudgets, assembleView, beforeToolCallLayers, completeLayers, contextToExecCtx, createLayerStateStore, createRecallCache, DEFAULT_PROJECTION, disposeLayers, executeRerender, initLayers, projectHistoryLayers, recallLayers, recallLayersAtomic, recallLayersEventual, resolveLayerTools, runAppendPipeline, storeLayers, } from '@noetic-tools/context';

package/dist/harness/deps/{memory.js → context.js}

@@ -1 +1 @@
-export { afterModelCallLayers, allocateBudgets, assembleView, beforeToolCallLayers, completeLayers, contextToExecCtx, createLayerStateStore, createRecallCache, DEFAULT_PROJECTION, disposeLayers, executeRerender, initLayers, projectHistoryLayers, recallLayers, recallLayersAtomic, recallLayersEventual, resolveLayerTools, runAppendPipeline, storeLayers, } from '@noetic-tools/memory';
+export { afterModelCallLayers, allocateBudgets, assembleView, beforeToolCallLayers, completeLayers, contextToExecCtx, createLayerStateStore, createRecallCache, DEFAULT_PROJECTION, disposeLayers, executeRerender, initLayers, projectHistoryLayers, recallLayers, recallLayersAtomic, recallLayersEventual, resolveLayerTools, runAppendPipeline, storeLayers, } from '@noetic-tools/context';

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

@@ -1,4 +1,4 @@
-export type { ContextMemory, ExecutionContext, MemoryLayer, ProjectionPolicy, StorageAdapter, } from '@noetic-tools/memory';
+export type { 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 { SteeringAction } from '@noetic-tools/types';
 export type { ZodType } from 'zod';

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

@@ -1,8 +1,8 @@
-import type { MemoryLayer } from '@noetic-tools/memory';
+import type { ContextLayer } from '@noetic-tools/context';
 import type { Item, ItemSchemaRegistry, Tool } from '@noetic-tools/types';
 export declare function buildItemSchemaRegistry({ base, layers, tools, }: {
     base: ItemSchemaRegistry;
-    layers?: ReadonlyArray<MemoryLayer>;
+    layers?: ReadonlyArray<ContextLayer>;
     tools?: ReadonlyArray<Tool>;
 }): ItemSchemaRegistry;
 /**

package/dist/index.d.ts

@@ -9,6 +9,8 @@ export { createOpenRouterEmbed } from './adapters/openrouter.js';
 /** @public */
 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';
 /** @public */
 export type { EveryOptions } from './builders/every.js';
@@ -21,20 +23,20 @@ export type { LoopConfig } from './builders/loop-builder.js';
 /** @public */
 export { loop } from './builders/loop-builder.js';
 /** @public */
-export { memory } from './builders/memory-builder.js';
-/** @public */
 export { provide } from './builders/provide-builder.js';
 /** @public */
 export { spawn } from './builders/spawn-builder.js';
 /** @public */
-export { 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';
+/** @public */
+export { step } from './builders/workflow-step.js';
+/** @public */
 export type { Condition, OtherwiseClause, WhenClause } from './conditions/conditions.js';
 /** @public */
 export { aiCondition, allCondition, anyCondition, embeddingMatch, otherwise, semanticRoute, semanticSwitch, when, } from './conditions/conditions.js';
@@ -55,7 +57,7 @@ export { execute } from './interpreter/execute.js';
 /** @public */
 /** @public */
 /** @public */
-export type { DurableTaskState, FactExtractor, FactSearcher, HistoryWindowConfig, ObservationalMemoryConfig, ObservationalState, PlanEnterSessionCallback, PlanExecutionEntry, PlanExitCallback, PlanMemoryConfig, PlanState, TemporalFact, TemporalMemoryConfig, TemporalSearchResult, WorkingMemoryConfig, WorkingMemoryState, } from '@noetic-tools/memory';
+export type { DurableTaskState, FactExtractor, FactSearcher, HistoryWindowConfig, ObservationalContextConfig, ObservationalState, PlanContextConfig, PlanEnterSessionCallback, PlanExecutionEntry, PlanExitCallback, PlanState, TemporalContextConfig, TemporalFact, TemporalSearchResult, WorkingMemoryContextConfig, WorkingMemoryContextState, } from '@noetic-tools/context';
 /** @public */
 /** @public */
 /** @public */
@@ -68,7 +70,7 @@ export type { DurableTaskState, FactExtractor, FactSearcher, HistoryWindowConfig
 /** @public */
 /** @public */
 /** @public */
-export { durableTaskState, fileReference, findFunctionCall, historyWindow, observationalMemory, PlanPhase, planMemory, staticContent, steering, storageGetMany, stripUnresolvedToolCalls, temporalMemory, toolMemoryLayer, workingMemory, } from '@noetic-tools/memory';
+export { durableTaskState, fileReference, findFunctionCall, historyWindow, observationalContext, PlanPhase, planContext, staticContent, steering, storageGetMany, stripUnresolvedToolCalls, temporalContext, toolContextLayer, workingMemoryContext, } from '@noetic-tools/context';
 /** @public */
 export { createMessage, estimateTokens } from '@noetic-tools/types';
 /** @public */
@@ -82,10 +84,6 @@ export type { DynamicWorkflowOpts, ParseAndRunWorkflowOpts } from './patterns/dy
 /** @public */
 export { dynamicWorkflow, parseAndRunWorkflow } from './patterns/dynamic-workflow.js';
 /** @public */
-export type { FlowNode, ForkFlowNode, LlmFlowNode, SequenceFlowNode, SpawnFlowNode, SubagentFlowNode, } from './patterns/flow.js';
-/** @public */
-export { FlowSchema, flowDepth, validateFlow, walkFlow } from './patterns/flow.js';
-/** @public */
 export type { InterviewOpts, InterviewQuestionAnswer, InterviewResult } from './patterns/interview.js';
 /** @public */
 export { interview } from './patterns/interview.js';
@@ -108,14 +106,14 @@ 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, SubHarnessWorkflowNode, ToolWorkflowNode, UntilPredicate, WorkflowDocument, WorkflowNode, } from './schemas/workflow.js';
+export type { BranchRoute, BranchWorkflowNode, EveryWorkflowNode, ForkWorkflowNode, LlmWorkflowNode, LoopWorkflowNode, MergeStrategy, ProvideWorkflowNode, SequenceWorkflowNode, SpawnWorkflowNode, SubflowWorkflowNode, SubHarnessWorkflowNode, ToolWorkflowNode, UntilPredicate, 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, ToolMemoryDeclaration, } from '@noetic-tools/types';
+export type { LLMResponse, LlmProviderConfig, ModelParams, RetryPolicy, ServerToolSpec, StepMeta, TokenUsage, Tool, ToolContextDeclaration, } from '@noetic-tools/types';
 /** @public */
 export { isServerToolSpec } from '@noetic-tools/types';
 /** @public */
@@ -139,13 +137,13 @@ 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, ContextMemory, DisposeParams, InferMemory, InferMemoryShape, InitParams, InitResult, LayerDataDecl, LayerFunctionDecl, LayerProvides, LayerTimeouts, MemoryConfig, MemoryHooks, MemoryLayer, ProjectionPolicy, RecallParams, RecallResult, ReturnParams, ReturnResult, ScopedStorage, SpawnParams, SpawnResult, StorageAdapter, StoreParams, StoreResult, } from '@noetic-tools/memory';
+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';
 /** @public */
-export { Slot } from '@noetic-tools/memory';
+export { Slot } from '@noetic-tools/context';
 /** @public */
-export type { ExecutionContext, ExecutionOutcome, MemoryCallModelRequest, MemoryScope, } from '@noetic-tools/types';
+export type { ContextScope, ExecutionContext, ExecutionOutcome, LayerCallModelRequest, } from '@noetic-tools/types';
 /** @public */
-export type { MemoryTraceSpan, Span, TraceExporter } from '@noetic-tools/types';
+export type { LayerTraceSpan, Span, TraceExporter } from '@noetic-tools/types';
 /** @public */
 export type { FrameworkStreamEvent, HarnessResponse, SdkStreamEvent, StreamEvent, StreamingItem, } from '@noetic-tools/types';
 /** @public */
@@ -170,10 +168,16 @@ export { TIMEOUT_ERROR_PREFIX } from '@noetic-tools/types';
 /** @public Reusable error-serialiser used by custom SubprocessAdapter implementations. */
 export { serializeError } from './adapters/in-memory-subprocess/metadata.js';
 /** @public */
-export type { ToolExecutionContext, ToolMemory } from '@noetic-tools/types';
+export type { ToolContext, ToolExecutionContext } from '@noetic-tools/types';
 /** @public */
 export { all, any } from './until/combinators.js';
 /** @public */
 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

@@ -12,6 +12,8 @@ export { createOpenRouterEmbed } from './adapters/openrouter.js';
 /** @public */
 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';
 /** @public */
 export { every } from './builders/every.js';
@@ -20,18 +22,16 @@ export { layerData, layerFn } from './builders/layer-provides-builders.js';
 /** @public */
 export { loop } from './builders/loop-builder.js';
 /** @public */
-export { memory } from './builders/memory-builder.js';
-/** @public */
 export { provide } from './builders/provide-builder.js';
 /** @public */
 export { spawn } from './builders/spawn-builder.js';
 /** @public */
-export { 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';
+/** @public */
 export { aiCondition, allCondition, anyCondition, embeddingMatch, otherwise, semanticRoute, semanticSwitch, when, } from './conditions/conditions.js';
 /** @public */
 export { cosineSimilarity } from './conditions/cosine-similarity.js';
@@ -58,7 +58,7 @@ export { execute } from './interpreter/execute.js';
 /** @public */
 /** @public */
 /** @public */
-export { durableTaskState, fileReference, findFunctionCall, historyWindow, observationalMemory, PlanPhase, planMemory, staticContent, steering, storageGetMany, stripUnresolvedToolCalls, temporalMemory, toolMemoryLayer, workingMemory, } from '@noetic-tools/memory';
+export { durableTaskState, fileReference, findFunctionCall, historyWindow, observationalContext, PlanPhase, planContext, staticContent, steering, storageGetMany, stripUnresolvedToolCalls, temporalContext, toolContextLayer, workingMemoryContext, } from '@noetic-tools/context';
 //#endregion
 //#region Message Utilities
 /** @public */
@@ -74,8 +74,6 @@ export { createInMemoryStorage } from './runtime/in-memory-storage.js';
 /** @public */
 export { dynamicWorkflow, parseAndRunWorkflow } from './patterns/dynamic-workflow.js';
 /** @public */
-export { FlowSchema, flowDepth, validateFlow, walkFlow } from './patterns/flow.js';
-/** @public */
 export { interview } from './patterns/interview.js';
 /** @public */
 export { adaptivePlan, compilePlan, PlanNodeSchema } from './patterns/plans.js';
@@ -106,7 +104,7 @@ export { DetachedStatus } from '@noetic-tools/types';
 /** @public */
 export { CheckpointSchemaVersion, CheckpointSnapshotSchema, CwdSnapshotSchema, FrontierFrameSchema, ItemLogSnapshotSchema, PendingAskUserSnapshotSchema, } from './types/checkpoint.js';
 /** @public */
-export { Slot } from '@noetic-tools/memory';
+export { Slot } from '@noetic-tools/context';
 /** @public */
 export { LedgerEntryKind, SteeringAction } from '@noetic-tools/types';
 /** @public */
@@ -122,3 +120,11 @@ 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,8 +1,8 @@
-export type { LayerStateStore } from '@noetic-tools/memory';
-export { allocateBudgets, assembleView, commitLayerUsage, computeLayerUsage, contextToExecCtx, DEFAULT_PROJECTION, resolveLayerTools, returnLayers, spawnLayers, } from '@noetic-tools/memory';
+export type { LayerStateStore } from '@noetic-tools/context';
+export { allocateBudgets, assembleView, commitLayerUsage, computeLayerUsage, contextToExecCtx, DEFAULT_PROJECTION, 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';
 export { ContextImpl } from '../runtime/context-impl.js';
 export { snapshotCwdState } from '../runtime/cwd-helpers.js';
-export { buildToolExecutionContext } from '../runtime/tool-memory.js';
+export { buildToolExecutionContext } from '../runtime/tool-context.js';

package/dist/interpreter/action-deps.js

@@ -1,6 +1,6 @@
-export { allocateBudgets, assembleView, commitLayerUsage, computeLayerUsage, contextToExecCtx, DEFAULT_PROJECTION, resolveLayerTools, returnLayers, spawnLayers, } from '@noetic-tools/memory';
+export { allocateBudgets, assembleView, commitLayerUsage, computeLayerUsage, contextToExecCtx, DEFAULT_PROJECTION, 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';
 export { snapshotCwdState } from '../runtime/cwd-helpers.js';
-export { buildToolExecutionContext } from '../runtime/tool-memory.js';
+export { buildToolExecutionContext } from '../runtime/tool-context.js';

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

@@ -1,3 +1,3 @@
-export type { ContextMemory, ExecutionContext, MemoryConfig, MemoryLayer, } from '@noetic-tools/memory';
+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 { isServerToolSpec, SteeringAction } from '@noetic-tools/types';

package/dist/interpreter/collect-tools.d.ts

@@ -4,7 +4,7 @@ import type { Step, Tool } from '@noetic-tools/types';
  * declared on LLM steps. Used to build the unified tool set
  * that gets sent with every LLM call for prompt cache efficiency.
  */
-export declare function collectAllTools<TMemory = unknown, I = unknown, O = unknown>(step: Step<TMemory, I, O>): Tool[];
+export declare function collectAllTools<TContext = unknown, I = unknown, O = unknown>(step: Step<TContext, I, O>): Tool[];
 /**
  * Deduplicates tools by name, keeping the first occurrence.
  */

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

@@ -2,31 +2,31 @@
  * Action step handlers: run, llm, spawn, provide, tool.
  */
 import type { ItemSchemaRegistry, LayerStateStore } from './action-deps.js';
-import type { AgentHarnessContract, Context, ExecuteStepFn, MemoryLayer, StepLLM, StepProvide, StepRun, StepSpawn, StepTool } from './action-types.js';
-export declare function executeRun<TMemory, I, O>(step: StepRun<TMemory, I, O>, input: I, ctx: Context<TMemory>): Promise<O>;
+import type { AgentHarnessContract, Context, ContextLayer, ExecuteStepFn, StepLLM, StepProvide, StepRun, StepSpawn, StepTool } from './action-types.js';
+export declare function executeRun<TContext, I, O>(step: StepRun<TContext, I, O>, input: I, ctx: Context<TContext>): Promise<O>;
 /**
  * Resolves a `Lazy<T>` step field. If the value is a function, it is invoked
  * with the current context; otherwise the value is returned as-is. Supports
  * both sync and async getters.
  *
  * Lazy fields let a step inspect `ctx.harness.config.params`, `ctx.unifiedTools`,
- * or memory layer state to produce per-execution values (model, instructions,
+ * or context layer state to produce per-execution values (model, instructions,
  * tools) without baking them in at build time.
  */
-export declare function resolveLazy<T, TMemory>(value: T | ((ctx: Context<TMemory>) => T | Promise<T>), ctx: Context<TMemory>): Promise<T>;
-export declare function executeLLM<TMemory, I, O>(step: StepLLM<TMemory, I, O>, input: I, ctx: Context<TMemory>, layers?: MemoryLayer[]): Promise<O>;
+export declare function resolveLazy<T, TContext>(value: T | ((ctx: Context<TContext>) => T | Promise<T>), ctx: Context<TContext>): Promise<T>;
+export declare function executeLLM<TContext, I, O>(step: StepLLM<TContext, I, O>, input: I, ctx: Context<TContext>, layers?: ContextLayer[]): Promise<O>;
 export interface ExecuteSpawnOpts {
     layerStore?: LayerStateStore;
-    parentLayers?: MemoryLayer[];
+    parentLayers?: ContextLayer[];
     itemSchemas?: ItemSchemaRegistry;
 }
-export declare function executeSpawn<TMemory, I, O>(step: StepSpawn<TMemory, I, O>, input: I, ctx: Context<TMemory>, executeStep: ExecuteStepFn, opts?: ExecuteSpawnOpts): Promise<O>;
+export declare function executeSpawn<TContext, I, O>(step: StepSpawn<TContext, I, O>, input: I, ctx: Context<TContext>, executeStep: ExecuteStepFn, opts?: ExecuteSpawnOpts): Promise<O>;
 /**
- * Executes a provide step by attaching memory layers to the current context
+ * Executes a provide step by attaching context layers to the current context
  * without creating an isolated child context.
  *
  * Unlike spawn, provide does not create a new itemLog or clone state.
  * Events flow through to the parent in real-time.
  */
-export declare function executeProvide<TMemory, I, O>(step: StepProvide<TMemory, I, O>, input: I, ctx: Context<TMemory>, executeStep: ExecuteStepFn): Promise<O>;
-export declare function executeTool<TMemory, I, O>(step: StepTool<TMemory, I, O>, input: I, ctx: Context<TMemory>, harness: AgentHarnessContract, layers?: MemoryLayer[]): Promise<O>;
+export declare function executeProvide<TContext, I, O>(step: StepProvide<TContext, I, O>, input: I, ctx: Context<TContext>, executeStep: ExecuteStepFn): Promise<O>;
+export declare function executeTool<TContext, I, O>(step: StepTool<TContext, I, O>, input: I, ctx: Context<TContext>, harness: AgentHarnessContract, layers?: ContextLayer[]): Promise<O>;

package/dist/interpreter/execute-action.js

@@ -93,7 +93,7 @@ function mergeRecallResults(base, overrides, slotOf) {
  * both sync and async getters.
  *
  * Lazy fields let a step inspect `ctx.harness.config.params`, `ctx.unifiedTools`,
- * or memory layer state to produce per-execution values (model, instructions,
+ * or context layer state to produce per-execution values (model, instructions,
  * tools) without baking them in at build time.
  */
 export async function resolveLazy(value, ctx) {
@@ -266,7 +266,7 @@ export async function executeLLM(step, input, ctx, layers) {
     const hasLayers = layers !== undefined && layers.length > 0;
     // Resolve lazy step fields up-front. Function-form getters run once per
     // step execution with the live context, so `ctx.harness.config.params`,
-    // `ctx.unifiedTools`, and memory layer state are all visible at resolution.
+    // `ctx.unifiedTools`, and context layer state are all visible at resolution.
     const resolvedModel = await resolveLazy(step.model, ctx);
     if (!resolvedModel || resolvedModel.trim() === '') {
         throw new NoeticConfigError({
@@ -509,19 +509,19 @@ export async function executeLLM(step, input, ctx, layers) {
         retriesExhausted: true,
     });
 }
-function isMemoryConfig(value) {
+function isContextConfig(value) {
     return typeof value === 'object' && value !== null && 'layers' in value;
 }
 function resolveLayersForSpawn(step, parentLayers) {
-    if (!step.memory) {
+    if (!step.context) {
         return parentLayers ?? [];
     }
-    if (isMemoryConfig(step.memory)) {
+    if (isContextConfig(step.context)) {
         return [
-            ...step.memory.layers,
+            ...step.context.layers,
         ];
     }
-    return step.memory;
+    return step.context;
 }
 async function collectSpawnItems({ layers, parentExecutionCtx, childExecutionCtx, layerStore, itemSchemas = defaultItemSchemaRegistry, }) {
     const spawnResults = await spawnLayers({
@@ -563,7 +563,7 @@ export async function executeSpawn(step, input, ctx, executeStep, opts) {
     });
     const layerStore = opts?.layerStore;
     const hasLayers = layers.length > 0 && layerStore !== undefined;
-    // Collect items from memory layers via onSpawn hooks
+    // Collect items from context layers via onSpawn hooks
     let childItems = [];
     let parentExecutionCtx;
     if (hasLayers) {
@@ -594,7 +594,7 @@ export async function executeSpawn(step, input, ctx, executeStep, opts) {
     // Create child context — empty by default, layers provide items via onSpawn.
     // `id: childId` keeps the ContextImpl's id in sync with the executionId
     // used by spawnLayers/returnLayers in the layer-state store, so writes via
-    // `ctx.memory[layerId]` and spawn-boundary hooks read from the same key.
+    // `ctx.context[layerId]` and spawn-boundary hooks read from the same key.
     const childCtx = new ContextImpl({
         harness: baseCtx.harness,
         parent: baseCtx,
@@ -648,12 +648,12 @@ export async function executeSpawn(step, input, ctx, executeStep, opts) {
 //#endregion
 //#region provide
 function resolveLayers(step) {
-    if (isMemoryConfig(step.memory)) {
+    if (isContextConfig(step.context)) {
         return [
-            ...step.memory.layers,
+            ...step.context.layers,
         ];
     }
-    return step.memory;
+    return step.context;
 }
 function mergeLayers(existing, provided) {
     if (!existing || existing.length === 0) {
@@ -668,7 +668,7 @@ function mergeLayers(existing, provided) {
     ];
 }
 /**
- * Executes a provide step by attaching memory layers to the current context
+ * Executes a provide step by attaching context layers to the current context
  * without creating an isolated child context.
  *
  * Unlike spawn, provide does not create a new itemLog or clone state.

package/dist/interpreter/execute-control.d.ts

@@ -3,14 +3,14 @@
  */
 import type { Context, ExecuteStepFn, StepBranch, StepEvery, StepFork, StepLoop } from '@noetic-tools/types';
 import type { ItemSchemaRegistry, LayerStateStore } from './action-deps.js';
-export declare function executeBranch<TMemory, I, O>(step: StepBranch<TMemory, I, O>, input: I, ctx: Context<TMemory>, executeStep: ExecuteStepFn): Promise<O>;
+export declare function executeBranch<TContext, I, O>(step: StepBranch<TContext, I, O>, input: I, ctx: Context<TContext>, executeStep: ExecuteStepFn): Promise<O>;
 /** Layer-boundary wiring supplied by the interpreter (see `buildSpawnOpts`). */
 export interface ExecuteForkOpts {
     layerStore?: LayerStateStore;
     itemSchemas?: ItemSchemaRegistry;
 }
-export declare function executeFork<TMemory, I, O>(step: StepFork<TMemory, I, O>, input: I, ctx: Context<TMemory>, rawExecuteStep: ExecuteStepFn, opts?: ExecuteForkOpts): Promise<O>;
-export declare function executeLoop<TMemory, I, O>(step: StepLoop<TMemory, I, O>, input: I, ctx: Context<TMemory>, executeStep: ExecuteStepFn): Promise<O>;
+export declare function executeFork<TContext, I, O>(step: StepFork<TContext, I, O>, input: I, ctx: Context<TContext>, rawExecuteStep: ExecuteStepFn, opts?: ExecuteForkOpts): Promise<O>;
+export declare function executeLoop<TContext, I, O>(step: StepLoop<TContext, I, O>, input: I, ctx: Context<TContext>, executeStep: ExecuteStepFn): Promise<O>;
 /**
  * Executes an `every` step: runs the body step forever, paced by `ms ± jitter`,
  * woken early by `wakeOn`. Throws `cancelled` when the context is aborted.
@@ -23,4 +23,4 @@ export declare function executeLoop<TMemory, I, O>(step: StepLoop<TMemory, I, O>
  * The body's output is discarded — `every` runs forever and does not accumulate
  * iteration outputs. Only ever returns by throwing on cancellation or `fail`.
  */
-export declare function executeEvery<TMemory, I, O>(step: StepEvery<TMemory, I, O>, input: I, ctx: Context<TMemory>, executeStep: ExecuteStepFn): Promise<O>;
+export declare function executeEvery<TContext, I, O>(step: StepEvery<TContext, I, O>, input: I, ctx: Context<TContext>, executeStep: ExecuteStepFn): Promise<O>;

package/dist/interpreter/execute-control.js

@@ -44,7 +44,7 @@ function createChildContexts(ctx, count, stepId) {
         channelStore,
         cwdState: snapshotCwdState(ctx),
         // Layers and the harness tool pool cross the fork boundary: without
-        // them an `llm` step inside a path would run with no memory
+        // them an `llm` step inside a path would run with no context
         // projection and no layer tools, and a nested `spawn` would have no
         // parent layers to inherit. Per-path layer STATE is still isolated —
         // see `createForkLayerBridge`.

package/dist/interpreter/execute-sub-harness.d.ts

@@ -5,4 +5,4 @@
  * `executeLLM`.
  */
 import type { Context, StepSubHarness } from '@noetic-tools/types';
-export declare function executeSubHarness<TMemory, I, O>(step: StepSubHarness<TMemory, I, O>, input: I, ctx: Context<TMemory>): Promise<O>;
+export declare function executeSubHarness<TContext, I, O>(step: StepSubHarness<TContext, I, O>, input: I, ctx: Context<TContext>): Promise<O>;

package/dist/interpreter/execute.d.ts

@@ -1,4 +1,4 @@
-import type { ContextMemory } from '@noetic-tools/memory';
+import type { ContextData } from '@noetic-tools/context';
 import type { Context, Step } from '@noetic-tools/types';
 /**
  * @internal
@@ -12,7 +12,7 @@ import type { Context, Step } from '@noetic-tools/types';
  * through the adapter as normal, so per-step overrides on descendants
  * continue to work.
  */
-export declare function executeNoAdapter<TMemory, I, O>(step: Step<TMemory, I, O>, input: I, ctx: Context<TMemory>): Promise<O>;
+export declare function executeNoAdapter<TContext, I, O>(step: Step<TContext, I, O>, input: I, ctx: Context<TContext>): Promise<O>;
 /**
  * Executes a step within the interpreter, dispatching to the appropriate handler by step kind.
  *
@@ -23,4 +23,4 @@ export declare function executeNoAdapter<TMemory, I, O>(step: Step<TMemory, I, O
  * @throws `NoeticError` with kind `step_failed` if max depth is exceeded or an unknown step kind is encountered.
  * @throws `NoeticError` with kind `cancelled` if the context is aborted.
  */
-export declare function execute<TMemory = ContextMemory, I = unknown, O = unknown>(step: Step<TMemory, I, O>, input: I, ctx: Context<TMemory>): Promise<O>;
+export declare function execute<TContext = ContextData, I = unknown, O = unknown>(step: Step<TContext, I, O>, input: I, ctx: Context<TContext>): Promise<O>;