@noetic-tools/core 3.2.0 → 5.0.0

package/dist/adapters/in-memory-subprocess/manifest-persistence.d.ts

@@ -1,4 +1,4 @@
-import type { StorageAdapter } from '@noetic-tools/memory';
+import type { StorageAdapter } from '@noetic-tools/context';
 import type { StepSubprocessRequest, SubprocessHandle } from '@noetic-tools/types';
 import type { InMemoryStepManifest } from './types.js';
 export declare function isStepManifest(value: unknown): value is InMemoryStepManifest;

package/dist/adapters/in-memory-subprocess/types.d.ts

@@ -1,4 +1,4 @@
-import type { StorageAdapter } from '@noetic-tools/memory';
+import type { StorageAdapter } from '@noetic-tools/context';
 import type { ProcessSubprocessRequest, StepSubprocessRequest, SubprocessHandle, SubprocessHandleMetadata, SubprocessRequest } from '@noetic-tools/types';
 /**
  * @public

package/dist/adapters/openrouter.d.ts

@@ -1,4 +1,4 @@
-import type { MemoryLayer } from '@noetic-tools/memory';
+import type { ContextLayer } from '@noetic-tools/context';
 import type { AgentHarnessContract, Context, Item, LLMResponse, Tool } from '@noetic-tools/types';
 import type * as OpenRouterAgent from '@openrouter/agent';
 import type { EmbedFn } from '../types/embed.js';
@@ -42,7 +42,7 @@ export interface ExecuteToolCallParams {
     tools: ReadonlyArray<Tool>;
     context: Context;
     harness: AgentHarnessContract;
-    layers?: MemoryLayer[];
+    layers?: ContextLayer[];
     /** The model's `function_call` id — keys this call's tool-UI region. */
     callId?: string;
 }

package/dist/adapters/openrouter.js

@@ -1,6 +1,6 @@
 import { frameworkCast, isAssistantMessage, NoeticConfigError, SteeringAction, } from '@noetic-tools/types';
 import { z } from 'zod';
-import { buildToolExecutionContext } from '../runtime/tool-memory.js';
+import { buildToolExecutionContext } from '../runtime/tool-context.js';
 import { emitToolUi } from '../runtime/tool-ui.js';
 const EmbeddingsResponseSchema = z.object({
     data: z.array(z.object({
@@ -210,7 +210,7 @@ export async function executeToolCall(params) {
     // Model sees sanitised tool names (see `sanitizeToolNameForWire`). Match
     // against both the original and sanitised name so internal identity (e.g.
     // `plan/updatePrd` used by steering whitelists, skill docs, and the
-    // `planMemory.beforeToolCall` hook) stays intact while the wire name is
+    // `planContext.beforeToolCall` hook) stays intact while the wire name is
     // provider-compliant.
     const matchedTool = params.tools.find((t) => t.name === params.toolName || sanitizeToolNameForWire(t.name) === params.toolName);
     if (!matchedTool) {

package/dist/builders/context-builder.d.ts

@@ -0,0 +1,11 @@
+import type { ContextConfig, ContextLayer } from '@noetic-tools/context';
+/**
+ * Creates a type-safe context configuration from a tuple of context layers.
+ * The returned config preserves literal layer types for compile-time inference
+ * via `InferContext<typeof config>`.
+ *
+ * @public
+ * @param layers - Tuple of context layers to include in the configuration.
+ * @returns A `ContextConfig` carrying the inferred context shape as a phantom type.
+ */
+export declare function context<const T extends readonly ContextLayer[]>(layers: T): ContextConfig<T>;

package/dist/builders/context-builder.js

@@ -0,0 +1,15 @@
+import { frameworkCast } from '@noetic-tools/types';
+/**
+ * Creates a type-safe context configuration from a tuple of context layers.
+ * The returned config preserves literal layer types for compile-time inference
+ * via `InferContext<typeof config>`.
+ *
+ * @public
+ * @param layers - Tuple of context layers to include in the configuration.
+ * @returns A `ContextConfig` carrying the inferred context shape as a phantom type.
+ */
+export function context(layers) {
+    return frameworkCast({
+        layers,
+    });
+}

package/dist/builders/context-option.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Returns the configured context layers, preferring the current `context` key
+ * and falling back to the pre-rename `memory` key.
+ *
+ * `context` wins when both are set — an explicit new-style key should never be
+ * silently overridden by a stale one left behind mid-migration.
+ *
+ * This is the only place in core that *resolves* `.memory`. Every public entry
+ * point that used to take `memory` — `provide`, `spawn`, `tool`, `react`, the
+ * `AgentHarness` constructor, `createContext`, `execute`, `restore` — declares
+ * the deprecated key alongside its `context` replacement and resolves it
+ * through here.
+ *
+ * Removing the alias at the next major means deleting the `memory?`
+ * declarations, this function, and the one place that destructures the key off
+ * an options bag before forwarding it (`AgentHarness.createContext`).
+ *
+ * @internal
+ */
+export declare function resolveContextOption<T>(opts: {
+    context?: T;
+    memory?: T;
+}): T | undefined;

package/dist/builders/context-option.js

@@ -0,0 +1,22 @@
+/**
+ * Returns the configured context layers, preferring the current `context` key
+ * and falling back to the pre-rename `memory` key.
+ *
+ * `context` wins when both are set — an explicit new-style key should never be
+ * silently overridden by a stale one left behind mid-migration.
+ *
+ * This is the only place in core that *resolves* `.memory`. Every public entry
+ * point that used to take `memory` — `provide`, `spawn`, `tool`, `react`, the
+ * `AgentHarness` constructor, `createContext`, `execute`, `restore` — declares
+ * the deprecated key alongside its `context` replacement and resolves it
+ * through here.
+ *
+ * Removing the alias at the next major means deleting the `memory?`
+ * declarations, this function, and the one place that destructures the key off
+ * an options bag before forwarding it (`AgentHarness.createContext`).
+ *
+ * @internal
+ */
+export function resolveContextOption(opts) {
+    return opts.context ?? opts.memory;
+}

package/dist/builders/control-flow-builders.d.ts

@@ -1,4 +1,4 @@
-import type { ContextMemory } from '@noetic-tools/memory';
+import type { ContextData } from '@noetic-tools/context';
 import type { Context, SettleResult, Step, StepBranch, StepForkAll, StepForkRace, StepForkSettle } from '@noetic-tools/types';
 /**
  * Creates a parallel execution step that races paths and returns the first result.
@@ -11,13 +11,13 @@ import type { Context, SettleResult, Step, StepBranch, StepForkAll, StepForkRace
  * @returns A `StepForkRace` step.
  * @throws `NoeticConfigError` with code `EMPTY_STEP_ID` if `id` is empty.
  */
-export declare function fork<TMemory = ContextMemory, I = unknown, O = unknown>(opts: {
+export declare function fork<TContext = ContextData, I = unknown, O = unknown>(opts: {
     id: string;
     mode: 'race';
-    paths: (input: I, ctx: Context<TMemory>) => Step<TMemory, I, O>[];
+    paths: (input: I, ctx: Context<TContext>) => Step<TContext, I, O>[];
     concurrency?: number;
-    _optimizable?: Step<TMemory>[];
-}): StepForkRace<TMemory, I, O>;
+    _optimizable?: Step<TContext>[];
+}): StepForkRace<TContext, I, O>;
 /**
  * Creates a parallel execution step that waits for all paths and merges results.
  *
@@ -31,14 +31,14 @@ export declare function fork<TMemory = ContextMemory, I = unknown, O = unknown>(
  * @throws `NoeticConfigError` with code `EMPTY_STEP_ID` if `id` is empty.
  * @throws `NoeticConfigError` with code `MISSING_MERGE_FUNCTION` if `merge` is not provided.
  */
-export declare function fork<TMemory = ContextMemory, I = unknown, O = unknown>(opts: {
+export declare function fork<TContext = ContextData, I = unknown, O = unknown>(opts: {
     id: string;
     mode: 'all';
-    paths: (input: I, ctx: Context<TMemory>) => Step<TMemory, I, O>[];
-    merge: (results: O[], ctx: Context<TMemory>) => O;
+    paths: (input: I, ctx: Context<TContext>) => Step<TContext, I, O>[];
+    merge: (results: O[], ctx: Context<TContext>) => O;
     concurrency?: number;
-    _optimizable?: Step<TMemory>[];
-}): StepForkAll<TMemory, I, O>;
+    _optimizable?: Step<TContext>[];
+}): StepForkAll<TContext, I, O>;
 /**
  * Creates a parallel execution step that waits for all paths, collecting errors as results.
  *
@@ -52,14 +52,14 @@ export declare function fork<TMemory = ContextMemory, I = unknown, O = unknown>(
  * @throws `NoeticConfigError` with code `EMPTY_STEP_ID` if `id` is empty.
  * @throws `NoeticConfigError` with code `MISSING_MERGE_FUNCTION` if `merge` is not provided.
  */
-export declare function fork<TMemory = ContextMemory, I = unknown, O = unknown>(opts: {
+export declare function fork<TContext = ContextData, I = unknown, O = unknown>(opts: {
     id: string;
     mode: 'settle';
-    paths: (input: I, ctx: Context<TMemory>) => Step<TMemory, I, O>[];
-    merge: (results: SettleResult<O>[], ctx: Context<TMemory>) => O;
+    paths: (input: I, ctx: Context<TContext>) => Step<TContext, I, O>[];
+    merge: (results: SettleResult<O>[], ctx: Context<TContext>) => O;
     concurrency?: number;
-    _optimizable?: Step<TMemory>[];
-}): StepForkSettle<TMemory, I, O>;
+    _optimizable?: Step<TContext>[];
+}): StepForkSettle<TContext, I, O>;
 /**
  * Creates a conditional routing step that selects the next step at runtime.
  *
@@ -71,8 +71,8 @@ export declare function fork<TMemory = ContextMemory, I = unknown, O = unknown>(
  * @throws `NoeticConfigError` with code `EMPTY_STEP_ID` if `id` is empty.
  * @throws `NoeticConfigError` with code `MISSING_ROUTE_FUNCTION` if `route` is not provided.
  */
-export declare function branch<TMemory = ContextMemory, I = unknown, O = unknown>(opts: {
+export declare function branch<TContext = ContextData, I = unknown, O = unknown>(opts: {
     id: string;
-    route: (input: I, ctx: Context<TMemory>) => Step<TMemory, I, O> | null | Promise<Step<TMemory, I, O> | null>;
-    _optimizable?: Step<TMemory>[];
-}): StepBranch<TMemory, I, O>;
+    route: (input: I, ctx: Context<TContext>) => Step<TContext, I, O> | null | Promise<Step<TContext, I, O> | null>;
+    _optimizable?: Step<TContext>[];
+}): StepBranch<TContext, I, O>;

package/dist/builders/every.d.ts

@@ -1,4 +1,4 @@
-import type { ContextMemory } from '@noetic-tools/memory';
+import type { ContextData } from '@noetic-tools/context';
 import type { Channel, EveryErrorPolicy, Step, StepEvery } from '@noetic-tools/types';
 /**
  * Configuration options accepted by the `every()` builder, excluding the `kind`
@@ -7,11 +7,11 @@ import type { Channel, EveryErrorPolicy, Step, StepEvery } from '@noetic-tools/t
  *
  * @public
  */
-export interface EveryOptions<TMemory = ContextMemory, I = unknown, O = unknown> {
+export interface EveryOptions<TContext = ContextData, I = unknown, O = unknown> {
     /** Unique step identifier used in traces and error messages. */
     id: string;
     /** Body step executed on each iteration. */
-    step: Step<TMemory, I, O>;
+    step: Step<TContext, I, O>;
     /** Park duration between iterations in milliseconds. Must be >= 0. */
     ms: number;
     /** Optional channel that wakes the parking interval when any value arrives. */
@@ -41,4 +41,4 @@ export interface EveryOptions<TMemory = ContextMemory, I = unknown, O = unknown>
  * @throws `NoeticConfigError` with code `INVALID_INTERVAL_MS` if `ms` is negative or not finite.
  * @throws `NoeticConfigError` with code `INVALID_JITTER` if `jitter` is negative or not finite.
  */
-export declare function every<TMemory = ContextMemory, I = unknown, O = unknown>(opts: EveryOptions<TMemory, I, O>): StepEvery<TMemory, I, O>;
+export declare function every<TContext = ContextData, I = unknown, O = unknown>(opts: EveryOptions<TContext, I, O>): StepEvery<TContext, I, O>;

package/dist/builders/layer-provides-builders.d.ts

@@ -1 +1 @@
-export { layerData, layerFn } from '@noetic-tools/memory';
+export { layerData, layerFn } from '@noetic-tools/context';

package/dist/builders/layer-provides-builders.js

@@ -1 +1 @@
-export { layerData, layerFn } from '@noetic-tools/memory';
+export { layerData, layerFn } from '@noetic-tools/context';

package/dist/builders/loop-builder.d.ts

@@ -1,7 +1,7 @@
-import type { ContextMemory } from '@noetic-tools/memory';
+import type { ContextData } from '@noetic-tools/context';
 import type { StepLoop } from '@noetic-tools/types';
 /** @public Configuration options accepted by the `loop()` builder, excluding the `kind` discriminant. */
-export type LoopConfig<TMemory = ContextMemory, I = unknown, O = unknown> = Omit<StepLoop<TMemory, I, O>, 'kind'>;
+export type LoopConfig<TContext = ContextData, I = unknown, O = unknown> = Omit<StepLoop<TContext, I, O>, 'kind'>;
 /**
  * Creates a loop step that iterates a body step until a termination predicate is satisfied.
  *
@@ -20,4 +20,4 @@ export type LoopConfig<TMemory = ContextMemory, I = unknown, O = unknown> = Omit
  * @throws `NoeticConfigError` with code `MISSING_LOOP_BODY` if `steps` is empty.
  * @throws `NoeticConfigError` with code `MISSING_UNTIL_PREDICATE` if `until` is not provided.
  */
-export declare function loop<TMemory = ContextMemory, I = unknown, O = unknown>(opts: LoopConfig<TMemory, I, O>): StepLoop<TMemory, I, O>;
+export declare function loop<TContext = ContextData, I = unknown, O = unknown>(opts: LoopConfig<TContext, I, O>): StepLoop<TContext, I, O>;

package/dist/builders/provide-builder.d.ts

@@ -1,20 +1,27 @@
-import type { ContextMemory, MemoryConfig, MemoryLayer } from '@noetic-tools/memory';
+import type { ContextConfig, ContextData, ContextLayer } from '@noetic-tools/context';
 import type { Step, StepProvide } from '@noetic-tools/types';
 /**
- * Creates a provide step that attaches memory layers to its child without creating an isolated context.
+ * Creates a provide step that attaches context layers to its child without creating an isolated context.
  * Like React's Context.Provider — layers are available to all descendant steps.
  * Spawn and detachedSpawn break the inheritance chain.
  *
  * @public
  * @param opts.id - Unique step identifier used in traces and error messages.
  * @param opts.child - Step to execute with the provided layers.
- * @param opts.memory - Memory layers to provide to descendant steps.
+ * @param opts.context - Context layers to provide to descendant steps.
  * @returns A `StepProvide` step.
  * @throws `NoeticConfigError` with code `EMPTY_STEP_ID` if `id` is empty.
  * @throws `NoeticConfigError` with code `MISSING_CHILD_STEP` if `child` is not provided.
  */
-export declare function provide<TMemory = ContextMemory, I = unknown, O = unknown>(opts: {
+export declare function provide<TContext = ContextData, I = unknown, O = unknown>(opts: {
     id: string;
-    child: Step<TMemory, I, O>;
-    memory: MemoryConfig | MemoryLayer[];
-}): StepProvide<TMemory, I, O>;
+    child: Step<TContext, I, O>;
+    /**
+     * Optional in the type only so the deprecated `memory` spelling remains a
+     * valid way to supply the layers. Exactly one of the two is required — the
+     * runtime enforces it, the same way `id` and `child` are enforced.
+     */
+    context?: ContextConfig | ContextLayer[];
+    /** @deprecated Renamed to `context`. */
+    memory?: ContextConfig | ContextLayer[];
+}): StepProvide<TContext, I, O>;

package/dist/builders/provide-builder.js

@@ -1,14 +1,15 @@
 import { NoeticConfigError } from '@noetic-tools/types';
 import { getDefaultRegistrar } from '../types/step-registrar.js';
+import { resolveContextOption } from './context-option.js';
 /**
- * Creates a provide step that attaches memory layers to its child without creating an isolated context.
+ * Creates a provide step that attaches context layers to its child without creating an isolated context.
  * Like React's Context.Provider — layers are available to all descendant steps.
  * Spawn and detachedSpawn break the inheritance chain.
  *
  * @public
  * @param opts.id - Unique step identifier used in traces and error messages.
  * @param opts.child - Step to execute with the provided layers.
- * @param opts.memory - Memory layers to provide to descendant steps.
+ * @param opts.context - Context layers to provide to descendant steps.
  * @returns A `StepProvide` step.
  * @throws `NoeticConfigError` with code `EMPTY_STEP_ID` if `id` is empty.
  * @throws `NoeticConfigError` with code `MISSING_CHILD_STEP` if `child` is not provided.
@@ -25,12 +26,22 @@ export function provide(opts) {
         throw new NoeticConfigError({
             code: 'MISSING_CHILD_STEP',
             message: 'provide() requires a child step.',
-            hint: 'Provide a child step to execute with the provided memory layers.',
+            hint: 'Provide a child step to execute with the provided context layers.',
+        });
+    }
+    const layers = resolveContextOption(opts);
+    if (!layers) {
+        throw new NoeticConfigError({
+            code: 'MISSING_CONTEXT_LAYERS',
+            message: 'provide() requires context layers.',
+            hint: 'Pass context: [workingMemoryContext()]. The `memory` key is the deprecated spelling of `context`.',
         });
     }
     const built = {
         kind: 'provide',
-        ...opts,
+        id: opts.id,
+        child: opts.child,
+        context: layers,
     };
     getDefaultRegistrar().register(built);
     return built;

package/dist/builders/spawn-builder.d.ts

@@ -1,9 +1,11 @@
-import type { ContextMemory, MemoryConfig, MemoryLayer } from '@noetic-tools/memory';
+import type { ContextConfig, ContextData, ContextLayer } from '@noetic-tools/context';
 import type { Step, StepSpawn, SubprocessAdapter } from '@noetic-tools/types';
-interface SpawnOpts<TMemory, I, O> {
+interface SpawnOpts<TContext, I, O> {
     id: string;
-    child: Step<TMemory, I, O>;
-    memory?: MemoryConfig | MemoryLayer[];
+    child: Step<TContext, I, O>;
+    context?: ContextConfig | ContextLayer[];
+    /** @deprecated Renamed to `context`. */
+    memory?: ContextConfig | ContextLayer[];
     timeout?: number;
     /**
      * Optional per-step subprocess adapter override. The interpreter routes
@@ -18,7 +20,7 @@ interface SpawnOpts<TMemory, I, O> {
  * @public
  * @param opts.id - Unique step identifier used in traces and error messages.
  * @param opts.child - Step to execute in the isolated child context.
- * @param opts.memory - Optional memory config or layers for the child context (replaces parent layers entirely).
+ * @param opts.context - Optional context config or layers for the child context (replaces parent layers entirely).
  * @param opts.timeout - Optional execution timeout in ms; the child is aborted if it exceeds this.
  * @param opts.subprocess - Optional per-step subprocess adapter override.
  * @returns A `StepSpawn` step. The spawn step and its `child` step are both
@@ -28,5 +30,5 @@ interface SpawnOpts<TMemory, I, O> {
  * @throws `NoeticConfigError` with code `MISSING_CHILD_STEP` if `child` is not provided.
  * @throws `NoeticConfigError` with code `DUPLICATE_STEP_ID` if another step with the same id is already registered.
  */
-export declare function spawn<TMemory = ContextMemory, I = unknown, O = unknown>(opts: SpawnOpts<TMemory, I, O>): StepSpawn<TMemory, I, O>;
+export declare function spawn<TContext = ContextData, I = unknown, O = unknown>(opts: SpawnOpts<TContext, I, O>): StepSpawn<TContext, I, O>;
 export {};

package/dist/builders/spawn-builder.js

@@ -1,5 +1,6 @@
 import { NoeticConfigError } from '@noetic-tools/types';
 import { getDefaultRegistrar } from '../types/step-registrar.js';
+import { resolveContextOption } from './context-option.js';
 //#endregion
 //#region Public API
 /**
@@ -8,7 +9,7 @@ import { getDefaultRegistrar } from '../types/step-registrar.js';
  * @public
  * @param opts.id - Unique step identifier used in traces and error messages.
  * @param opts.child - Step to execute in the isolated child context.
- * @param opts.memory - Optional memory config or layers for the child context (replaces parent layers entirely).
+ * @param opts.context - Optional context config or layers for the child context (replaces parent layers entirely).
  * @param opts.timeout - Optional execution timeout in ms; the child is aborted if it exceeds this.
  * @param opts.subprocess - Optional per-step subprocess adapter override.
  * @returns A `StepSpawn` step. The spawn step and its `child` step are both
@@ -35,7 +36,11 @@ export function spawn(opts) {
     }
     const built = {
         kind: 'spawn',
-        ...opts,
+        id: opts.id,
+        child: opts.child,
+        context: resolveContextOption(opts),
+        timeout: opts.timeout,
+        subprocess: opts.subprocess,
     };
     getDefaultRegistrar().register(built);
     // Ensure the child is addressable by id — builders for `run`/`llm`/`tool`

package/dist/builders/step-builders.d.ts

@@ -1,9 +1,9 @@
-import type { ContextMemory } from '@noetic-tools/memory';
+import type { ContextData } from '@noetic-tools/context';
 import type { Context, Lazy, ModelParams, OutputCodec, RetryPolicy, ServerToolSpec, StepLLM, StepRun, StepSubHarness, StepTool, SubHarness, SubHarnessSessionPolicy, SubHarnessSettings, SubprocessAdapter, Tool } from '@noetic-tools/types';
 import type { ZodType } from 'zod';
-interface StepRunOpts<TMemory, I, O> {
+export interface StepRunOpts<TContext, I, O> {
     id: string;
-    execute: (input: I, ctx: Context<TMemory>) => Promise<O>;
+    execute: (input: I, ctx: Context<TContext>) => Promise<O>;
     retry?: RetryPolicy;
     /**
      * Optional subprocess adapter override. When set, `execute()` is routed
@@ -12,38 +12,38 @@ interface StepRunOpts<TMemory, I, O> {
      */
     subprocess?: SubprocessAdapter;
 }
-interface StepLLMOpts<TMemory, O> {
+export interface StepLLMOpts<TContext, O> {
     id: string;
     /** Model id. Eager string or `(ctx) => string` getter (resolved at step execution). */
-    model: Lazy<string, TMemory>;
+    model: Lazy<string, TContext>;
     /** Optional instructions; eager string or `(ctx) => string | undefined` getter. */
-    instructions?: Lazy<string | undefined, TMemory>;
+    instructions?: Lazy<string | undefined, TContext>;
     /**
      * Optional tools; eager array or `(ctx) => (...)[] | undefined` getter. Each
      * entry is either a client `Tool` or an inline `ServerToolSpec` (an OpenRouter
      * server tool the provider executes, e.g. web search/fetch).
      */
-    tools?: Lazy<(Tool | ServerToolSpec)[] | undefined, TMemory>;
+    tools?: Lazy<(Tool | ServerToolSpec)[] | undefined, TContext>;
     /** Structured output: a Zod schema or a streaming `OutputCodec` (e.g. OpenUI Lang). */
     output?: ZodType<O> | OutputCodec<O>;
     params?: ModelParams;
     emit?: boolean | ((eventType: string, data: Record<string, unknown>) => boolean);
 }
-interface StepToolOpts<I, O> {
+export interface StepToolOpts<I, O> {
     id: string;
     tool: Tool<ZodType<I>, ZodType<O>>;
     args?: Partial<I>;
 }
-interface StepSubHarnessOpts<TMemory, O> {
+export interface StepSubHarnessOpts<TContext, O> {
     id: string;
     /** The harness adapter created by a `@noetic-tools/sub-harness-*` factory. Eager or `(ctx) => SubHarness`. */
-    harness: Lazy<SubHarness, TMemory>;
+    harness: Lazy<SubHarness, TContext>;
     /** Turn prompt. Eager string or `(ctx) => string` getter. */
-    prompt: Lazy<string, TMemory>;
+    prompt: Lazy<string, TContext>;
     /** Shared harness settings (model, permission mode, …). */
     settings?: SubHarnessSettings;
     /** System instructions applied on the first message of a fresh session. */
-    instructions?: Lazy<string | undefined, TMemory>;
+    instructions?: Lazy<string | undefined, TContext>;
     /** Optional Zod schema; when set the assistant text is JSON-parsed and validated. */
     output?: ZodType<O>;
     /** Session reuse + teardown policy across steps. */
@@ -66,7 +66,7 @@ export declare const step: {
      * @throws `NoeticConfigError` with code `MISSING_EXECUTE_FUNCTION` if `execute` is not provided.
      * @throws `NoeticConfigError` with code `DUPLICATE_STEP_ID` if another step with the same id is already registered with a different body.
      */
-    run<TMemory = ContextMemory, I = unknown, O = unknown>(opts: StepRunOpts<TMemory, I, O>): StepRun<TMemory, I, O>;
+    run<TContext = ContextData, I = unknown, O = unknown>(opts: StepRunOpts<TContext, I, O>): StepRun<TContext, I, O>;
     /**
      * Creates an LLM model call step with optional tools and structured output.
      *
@@ -82,7 +82,7 @@ export declare const step: {
      * @throws `NoeticConfigError` with code `EMPTY_STEP_ID` if `id` is empty.
      * @throws `NoeticConfigError` with code `MISSING_MODEL` if an eager `model` string is empty. Function-form models are validated at step execution.
      */
-    llm<TMemory = ContextMemory, I = unknown, O = unknown>(opts: StepLLMOpts<TMemory, O>): StepLLM<TMemory, I, O>;
+    llm<TContext = ContextData, I = unknown, O = unknown>(opts: StepLLMOpts<TContext, O>): StepLLM<TContext, I, O>;
     /**
      * Creates a tool execution step that invokes a typed tool definition.
      *
@@ -95,7 +95,7 @@ export declare const step: {
      * @throws `NoeticConfigError` with code `EMPTY_STEP_ID` if `id` is empty.
      * @throws `NoeticConfigError` with code `MISSING_TOOL` if `tool` is not provided.
      */
-    tool<TMemory = ContextMemory, I = unknown, O = unknown>(opts: StepToolOpts<I, O>): StepTool<TMemory, I, O>;
+    tool<TContext = ContextData, I = unknown, O = unknown>(opts: StepToolOpts<I, O>): StepTool<TContext, I, O>;
     /**
      * Creates a step that delegates a turn to the Claude Code harness.
      *
@@ -108,27 +108,26 @@ export declare const step: {
      * @returns A `StepSubHarness` of kind `claude-code`, auto-registered in the step registry.
      * @throws `NoeticConfigError` `EMPTY_STEP_ID` / `MISSING_SUB_HARNESS` / `SUB_HARNESS_KIND_MISMATCH`.
      */
-    claudeCode<TMemory = ContextMemory, I = unknown, O = unknown>(opts: StepSubHarnessOpts<TMemory, O>): StepSubHarness<TMemory, I, O>;
+    claudeCode<TContext = ContextData, I = unknown, O = unknown>(opts: StepSubHarnessOpts<TContext, O>): StepSubHarness<TContext, I, O>;
     /**
      * Creates a step that delegates a turn to the Codex harness.
      * @public
      * @param opts - See {@link step.claudeCode}; `opts.harness` is a `codex(...)` adapter.
      * @returns A `StepSubHarness` of kind `codex`.
      */
-    codex<TMemory = ContextMemory, I = unknown, O = unknown>(opts: StepSubHarnessOpts<TMemory, O>): StepSubHarness<TMemory, I, O>;
+    codex<TContext = ContextData, I = unknown, O = unknown>(opts: StepSubHarnessOpts<TContext, O>): StepSubHarness<TContext, I, O>;
     /**
      * Creates a step that delegates a turn to the opencode harness.
      * @public
      * @param opts - See {@link step.claudeCode}; `opts.harness` is an `opencode(...)` adapter.
      * @returns A `StepSubHarness` of kind `opencode`.
      */
-    opencode<TMemory = ContextMemory, I = unknown, O = unknown>(opts: StepSubHarnessOpts<TMemory, O>): StepSubHarness<TMemory, I, O>;
+    opencode<TContext = ContextData, I = unknown, O = unknown>(opts: StepSubHarnessOpts<TContext, O>): StepSubHarness<TContext, I, O>;
     /**
      * Creates a step that delegates a turn to the pi harness.
      * @public
      * @param opts - See {@link step.claudeCode}; `opts.harness` is a `pi(...)` adapter.
      * @returns A `StepSubHarness` of kind `pi`.
      */
-    pi<TMemory = ContextMemory, I = unknown, O = unknown>(opts: StepSubHarnessOpts<TMemory, O>): StepSubHarness<TMemory, I, O>;
+    pi<TContext = ContextData, I = unknown, O = unknown>(opts: StepSubHarnessOpts<TContext, O>): StepSubHarness<TContext, I, O>;
 };
-export {};

package/dist/builders/tool-builder.d.ts

@@ -1,4 +1,4 @@
-import type { FunctionCallItem, FunctionCallOutputItem, Item, ItemSchemaExtensions, Tool, ToolExecutionContext, ToolMemoryDeclaration, ToolResultExtensionItem, ToolUiDeclaration } from '@noetic-tools/types';
+import type { FunctionCallItem, FunctionCallOutputItem, Item, ItemSchemaExtensions, Tool, ToolContextDeclaration, ToolExecutionContext, ToolResultExtensionItem, ToolUiDeclaration } from '@noetic-tools/types';
 import type { ZodTypeAny, z } from 'zod';
 interface ToolConfig<I extends ZodTypeAny, O extends ZodTypeAny> {
     name: string;
@@ -16,8 +16,10 @@ interface ToolConfig<I extends ZodTypeAny, O extends ZodTypeAny> {
     }) => Item | ToolResultExtensionItem;
     execute: (args: z.infer<I>, toolCtx: ToolExecutionContext) => Promise<z.infer<O>>;
     needsApproval?: boolean;
-    /** Optional memory declaration — the runtime generates a MemoryLayer from this via toolMemoryLayer(). */
-    memory?: ToolMemoryDeclaration;
+    /** Optional context declaration — the runtime generates a ContextLayer from this via toolContextLayer(). */
+    context?: ToolContextDeclaration;
+    /** @deprecated Renamed to `context`. */
+    memory?: ToolContextDeclaration;
     /** Optional UI declaration — the runtime emits the rendered fragments at call/progress/result points. */
     ui?: ToolUiDeclaration<I, O>;
 }
@@ -38,8 +40,10 @@ interface GeneratorToolConfig<I extends ZodTypeAny, E extends ZodTypeAny, O exte
     }) => Item | ToolResultExtensionItem;
     execute: (args: z.infer<I>, toolCtx: ToolExecutionContext) => AsyncGenerator<z.infer<E>, z.infer<O>>;
     needsApproval?: boolean;
-    /** Optional memory declaration — the runtime generates a MemoryLayer from this via toolMemoryLayer(). */
-    memory?: ToolMemoryDeclaration;
+    /** Optional context declaration — the runtime generates a ContextLayer from this via toolContextLayer(). */
+    context?: ToolContextDeclaration;
+    /** @deprecated Renamed to `context`. */
+    memory?: ToolContextDeclaration;
     /** Optional UI declaration — the runtime emits the rendered fragments at call/progress/result points. */
     ui?: ToolUiDeclaration<I, O, z.infer<E>>;
 }

package/dist/builders/tool-builder.js

@@ -1,4 +1,5 @@
 import { NoeticConfigError } from '@noetic-tools/types';
+import { resolveContextOption } from './context-option.js';
 //#endregion
 //#region Helpers
 function validateToolConfig(name, execute) {
@@ -35,7 +36,7 @@ export function tool(config) {
         decorateResultItem: config.decorateResultItem,
         execute: config.execute,
         needsApproval: config.needsApproval,
-        memory: config.memory,
+        context: resolveContextOption(config),
         ui: config.ui,
     };
 }
@@ -56,7 +57,7 @@ export function toolWithGenerator(config) {
         decorateResultItem: config.decorateResultItem,
         execute: config.execute,
         needsApproval: config.needsApproval,
-        memory: config.memory,
+        context: resolveContextOption(config),
         ui: config.ui,
     };
 }

package/dist/builders/workflow-hydrator.d.ts

@@ -5,14 +5,14 @@
  * `loop`, etc.) so hydrated steps are indistinguishable from programmatic
  * ones — they register in the step registry, carry retry policies, etc.
  */
-import type { ContextMemory, MemoryLayer } from '@noetic-tools/memory';
+import type { ContextData, ContextLayer } from '@noetic-tools/context';
 import type { ExecuteStepFn, OutputCodec, Step, SubHarness, SubHarnessKind, SubprocessAdapter, Tool } from '@noetic-tools/types';
 import type { WorkflowDocument, WorkflowNode } from '../schemas/workflow.js';
 /** @public Context required to hydrate a JSON workflow into live steps. */
 export interface HydrationContext {
     tools: ReadonlyMap<string, Tool>;
     executeStep: ExecuteStepFn;
-    layers?: ReadonlyMap<string, MemoryLayer>;
+    layers?: ReadonlyMap<string, ContextLayer>;
     /** SubHarness adapters keyed by harness id, resolving `claude-code`/`codex`/… nodes. */
     subHarnesses?: ReadonlyMap<SubHarnessKind, SubHarness>;
     /**
@@ -28,6 +28,17 @@ export interface HydrationContext {
      * `ctx.subprocess` at execution time.
      */
     resolveSubprocess?: (ref: string) => SubprocessAdapter | undefined;
+    /**
+     * Named sub-workflow documents that `subflow` nodes resolve via `ref`.
+     * Resolution is lazy (first execution), so a live map view may gain
+     * entries after hydration.
+     */
+    workflows?: ReadonlyMap<string, WorkflowDocument>;
+    /**
+     * Ancestor ref chain for cycle detection on named sub-workflow references.
+     * Threaded internally by the subflow hydrator — callers never set it.
+     */
+    subflowAncestry?: ReadonlySet<string>;
 }
 /**
  * Hydrates a single `WorkflowNode` into a live `Step`.
@@ -39,8 +50,10 @@ export interface HydrationContext {
  * @throws `NoeticConfigError` with code `UNKNOWN_NODE_KIND` if the node kind is unrecognised.
  * @throws `NoeticConfigError` with code `UNKNOWN_TOOL_REFERENCE` if a tool name cannot be resolved.
  * @throws `NoeticConfigError` with code `UNKNOWN_UNTIL_PREDICATE` if an until predicate kind is unrecognised.
+ * @throws `NoeticConfigError` with code `UNKNOWN_WORKFLOW_REFERENCE` (at execution time) if a subflow ref names no registered workflow.
+ * @throws `NoeticConfigError` with code `WORKFLOW_CYCLE` (at execution time) if named sub-workflow refs form a cycle.
  */
-export declare function hydrateNode(node: WorkflowNode, ctx: HydrationContext): Step<ContextMemory, string, string>;
+export declare function hydrateNode(node: WorkflowNode, ctx: HydrationContext): Step<ContextData, string, string>;
 /**
  * Hydrates a complete `WorkflowDocument` into a live `Step` tree.
  *
@@ -49,4 +62,4 @@ export declare function hydrateNode(node: WorkflowNode, ctx: HydrationContext):
  * @param ctx - Hydration context with tool registry and step executor.
  * @returns The root `Step` of the hydrated workflow.
  */
-export declare function hydrateWorkflow(doc: WorkflowDocument, ctx: HydrationContext): Step<ContextMemory, string, string>;
+export declare function hydrateWorkflow(doc: WorkflowDocument, ctx: HydrationContext): Step<ContextData, string, string>;