@noetic-tools/core 0.0.1 → 0.1.1

package/dist/patterns/interview.d.ts

@@ -1,6 +1,6 @@
 import type { ZodType } from 'zod';
-import type { ContextMemory } from '../types/memory';
-import type { Step } from '../types/step';
+import type { ContextMemory } from '../types/memory.js';
+import type { Step } from '../types/step.js';
 /** @public Answer captured by the host for a single interview question. */
 export interface InterviewQuestionAnswer {
     questionId: string;

package/dist/patterns/interview.js

@@ -1,9 +1,9 @@
 import { z } from 'zod';
-import { loop } from '../builders/loop-builder';
-import { step } from '../builders/step-builders';
-import { frameworkCast } from '../interpreter/framework-cast';
-import { any } from '../until/combinators';
-import { until } from '../until/predicates';
+import { loop } from '../builders/loop-builder.js';
+import { step } from '../builders/step-builders.js';
+import { any } from '../until/combinators.js';
+import { until } from '../until/predicates.js';
+import { frameworkCast } from '../util/framework-cast.js';
 //#endregion
 //#region Helpers
 const DEFAULT_MAX_QUESTIONS = 8;

package/dist/patterns/plans.d.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
-import type { Context } from '../types/context';
-import type { ContextMemory } from '../types/memory';
-import type { ExecuteStepFn, Step } from '../types/step';
+import type { Context } from '../types/context.js';
+import type { ContextMemory } from '../types/memory.js';
+import type { ExecuteStepFn, Step } from '../types/step.js';
 export interface PlanNode {
     id: string;
     description: string;
@@ -27,7 +27,7 @@ export interface PlanConstraints {
  * @param executeStep - Optional step executor for non-run step kinds.
  * @returns A compiled `Step` ready for execution.
  */
-export declare function compilePlan<O>(plan: PlanNode, agents: Record<string, (prompt: string) => Step<ContextMemory, string, unknown>>, constraints?: PlanConstraints, executeStep?: ExecuteStepFn): Step<ContextMemory, string, O>;
+export declare function compilePlan<O, A = unknown>(plan: PlanNode, agents: Record<string, (prompt: string) => Step<ContextMemory, string, A>>, constraints?: PlanConstraints, executeStep?: ExecuteStepFn): Step<ContextMemory, string, O>;
 /**
  * Creates a step that dynamically generates a plan via a planner step and executes it,
  * retrying with error feedback up to `maxRevisions` times on failure.
@@ -36,9 +36,9 @@ export declare function compilePlan<O>(plan: PlanNode, agents: Record<string, (p
  * @param opts - Planner step, agent factories, optional constraints, max revision count, and step executor.
  * @returns A `Step` that adaptively plans and executes.
  */
-export declare function adaptivePlan<O>(opts: {
+export declare function adaptivePlan<O, A = unknown>(opts: {
     planner: Step<ContextMemory, string, PlanNode>;
-    agents: Record<string, (prompt: string) => Step<ContextMemory, string, unknown>>;
+    agents: Record<string, (prompt: string) => Step<ContextMemory, string, A>>;
     constraints?: PlanConstraints;
     maxRevisions: number;
     executeStep?: ExecuteStepFn;

package/dist/patterns/plans.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { fork } from '../builders/control-flow-builders';
-import { frameworkCast } from '../interpreter/framework-cast';
+import { fork } from '../builders/control-flow-builders.js';
+import { frameworkCast } from '../util/framework-cast.js';
 // PlanNode schema — the variable annotation provides the recursive type;
 // z.lazy() returns a compatible type that TypeScript checks against it.
 /** @public Zod schema for recursive `PlanNode` validation. */
@@ -47,7 +47,7 @@ function compileNode(node, opts) {
             id: `plan-fork-${node.id}`,
             mode: 'all',
             paths: () => childSteps,
-            merge: (results) => results[results.length - 1],
+            merge: (results) => frameworkCast(results[results.length - 1]),
         });
     }
     // Sequential - chain steps via a run step that uses executeStep
@@ -68,7 +68,7 @@ function compileNode(node, opts) {
                     throw new Error(`No executeStep provided and child step kind '${child.kind}' cannot be executed directly`);
                 }
             }
-            return currentOutput;
+            return frameworkCast(currentOutput);
         },
     };
 }

package/dist/patterns/ralph-wiggum.d.ts

@@ -1,7 +1,7 @@
-import type { Tool } from '../types/common';
-import type { ContextMemory } from '../types/memory';
-import type { StepLoop } from '../types/step';
-import type { VerifyFn } from '../until/predicates';
+import type { ContextMemory } from '../types/memory.js';
+import type { StepLoop } from '../types/step.js';
+import type { Tool } from '../types/tool.js';
+import type { VerifyFn } from '../until/predicates.js';
 /**
  * Creates a retry-with-feedback loop wrapping a ReAct agent. Each iteration spawns an inner agent
  * and retries with verification feedback until the verifier passes or max iterations is reached.

package/dist/patterns/ralph-wiggum.js

@@ -1,8 +1,8 @@
-import { loop } from '../builders/loop-builder';
-import { spawn } from '../builders/spawn-builder';
-import { any } from '../until/combinators';
-import { until } from '../until/predicates';
-import { react } from './react';
+import { loop } from '../builders/loop-builder.js';
+import { spawn } from '../builders/spawn-builder.js';
+import { any } from '../until/combinators.js';
+import { until } from '../until/predicates.js';
+import { react } from './react.js';
 /**
  * Creates a retry-with-feedback loop wrapping a ReAct agent. Each iteration spawns an inner agent
  * and retries with verification feedback until the verifier passes or max iterations is reached.

package/dist/patterns/react.d.ts

@@ -1,6 +1,6 @@
-import type { Tool } from '../types/common';
-import type { ContextMemory, MemoryConfig, MemoryLayer } from '../types/memory';
-import type { StepLoop, StepSpawn } from '../types/step';
+import type { ContextMemory, MemoryConfig, MemoryLayer } from '../types/memory.js';
+import type { StepLoop, StepSpawn } from '../types/step.js';
+import type { Tool } from '../types/tool.js';
 /**
  * Creates a ReAct (Reason + Act) agent loop: an LLM step with tools iterated until no tool calls or limits are hit.
  *

package/dist/patterns/react.js

@@ -1,8 +1,8 @@
-import { loop } from '../builders/loop-builder';
-import { spawn } from '../builders/spawn-builder';
-import { step } from '../builders/step-builders';
-import { any } from '../until/combinators';
-import { until } from '../until/predicates';
+import { loop } from '../builders/loop-builder.js';
+import { spawn } from '../builders/spawn-builder.js';
+import { step } from '../builders/step-builders.js';
+import { any } from '../until/combinators.js';
+import { until } from '../until/predicates.js';
 /**
  * Creates a ReAct (Reason + Act) agent loop: an LLM step with tools iterated until no tool calls or limits are hit.
  *

package/dist/portable/adapters.d.ts

@@ -0,0 +1,6 @@
+/** @public */
+export { createInMemoryFsAdapter } from '../adapters/in-memory-fs-adapter.js';
+/** @public */
+export { createInMemoryShellAdapter } from '../adapters/in-memory-shell-adapter.js';
+/** @public */
+export { createInMemorySubprocessAdapter } from '../adapters/in-memory-subprocess-adapter.js';

package/dist/portable/adapters.js

@@ -0,0 +1,6 @@
+/** @public */
+export { createInMemoryFsAdapter } from '../adapters/in-memory-fs-adapter.js';
+/** @public */
+export { createInMemoryShellAdapter } from '../adapters/in-memory-shell-adapter.js';
+/** @public */
+export { createInMemorySubprocessAdapter } from '../adapters/in-memory-subprocess-adapter.js';

package/dist/portable/ask-user.d.ts

@@ -0,0 +1,4 @@
+/** @public */
+export type { AskUserAnnotation, AskUserInput, AskUserOption, AskUserOutput, AskUserQuestion, } from '../types/ask-user-types.js';
+/** @public */
+export { AskUserAnnotationSchema, AskUserInputSchema, AskUserOptionSchema, AskUserOutputSchema, AskUserQuestionSchema, } from '../types/ask-user-types.js';

package/dist/portable/ask-user.js

@@ -0,0 +1,2 @@
+/** @public */
+export { AskUserAnnotationSchema, AskUserInputSchema, AskUserOptionSchema, AskUserOutputSchema, AskUserQuestionSchema, } from '../types/ask-user-types.js';

package/dist/portable/builders.d.ts

@@ -0,0 +1,12 @@
+/** @public */
+export { branch, fork } from '../builders/control-flow-builders.js';
+/** @public */
+export { layerData, layerFn } from '../builders/layer-provides-builders.js';
+/** @public */
+export { loop } from '../builders/loop-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';

package/dist/portable/builders.js

@@ -0,0 +1,12 @@
+/** @public */
+export { branch, fork } from '../builders/control-flow-builders.js';
+/** @public */
+export { layerData, layerFn } from '../builders/layer-provides-builders.js';
+/** @public */
+export { loop } from '../builders/loop-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';

package/dist/portable/memory-layers.d.ts

@@ -0,0 +1,12 @@
+/** @public */
+export { durableTaskState } from '../memory/layers/durable-task-state.js';
+/** @public */
+export { historyWindow } from '../memory/layers/history-window.js';
+/** @public */
+export { observationalMemory } from '../memory/layers/observational-memory.js';
+/** @public */
+export { planMemory } from '../memory/layers/plan.js';
+/** @public */
+export { toolMemoryLayer } from '../memory/layers/tool-memory-layer.js';
+/** @public */
+export { workingMemory } from '../memory/layers/working-memory.js';

package/dist/portable/memory-layers.js

@@ -0,0 +1,12 @@
+/** @public */
+export { durableTaskState } from '../memory/layers/durable-task-state.js';
+/** @public */
+export { historyWindow } from '../memory/layers/history-window.js';
+/** @public */
+export { observationalMemory } from '../memory/layers/observational-memory.js';
+/** @public */
+export { planMemory } from '../memory/layers/plan.js';
+/** @public */
+export { toolMemoryLayer } from '../memory/layers/tool-memory-layer.js';
+/** @public */
+export { workingMemory } from '../memory/layers/working-memory.js';

package/dist/portable/runtime.d.ts

@@ -0,0 +1,4 @@
+/** @public */
+export { AgentHarness } from '../harness/agent-harness.js';
+/** @public */
+export { createInMemoryStorage } from '../runtime/in-memory-storage.js';

package/dist/portable/runtime.js

@@ -0,0 +1,4 @@
+/** @public */
+export { AgentHarness } from '../harness/agent-harness.js';
+/** @public */
+export { createInMemoryStorage } from '../runtime/in-memory-storage.js';

package/dist/portable/until.d.ts

@@ -0,0 +1,4 @@
+/** @public */
+export { all, any } from '../until/combinators.js';
+/** @public */
+export { until } from '../until/predicates.js';

package/dist/portable/until.js

@@ -0,0 +1,4 @@
+/** @public */
+export { all, any } from '../until/combinators.js';
+/** @public */
+export { until } from '../until/predicates.js';

package/dist/portable.d.ts

@@ -1,26 +1,8 @@
-/** @public */
-export { createInMemoryFsAdapter } from './adapters/in-memory-fs-adapter';
-/** @public */
-export { createInMemoryShellAdapter } from './adapters/in-memory-shell-adapter';
-/** @public */
-export { createInMemorySubprocessAdapter } from './adapters/in-memory-subprocess-adapter';
-/** @public */
-export { step } from './builders/step-builders';
-/** @public */
-export { tool, toolWithGenerator } from './builders/tool-builder';
-/** @public */
-export { durableTaskState } from './memory/layers/durable-task-state';
-/** @public */
-export { historyWindow } from './memory/layers/history-window';
-/** @public */
-export { observationalMemory } from './memory/layers/observational-memory';
-/** @public */
-export { planMemory } from './memory/layers/plan';
-/** @public */
-export { toolMemoryLayer } from './memory/layers/tool-memory-layer';
-/** @public */
-export { workingMemory } from './memory/layers/working-memory';
-/** @public */
-export { AgentHarness } from './runtime/agent-harness';
-/** @public */
-export { createInMemoryStorage } from './runtime/in-memory-storage';
+export * from './portable/adapters.js';
+export * from './portable/ask-user.js';
+export * from './portable/builders.js';
+export * from './portable/memory-layers.js';
+export * from './portable/runtime.js';
+export * from './portable/until.js';
+/** @public */
+export { Slot } from './types/memory.js';

package/dist/portable.js

@@ -1,34 +1,8 @@
-//#region Portable Adapters
-/** @public */
-export { createInMemoryFsAdapter } from './adapters/in-memory-fs-adapter';
-/** @public */
-export { createInMemoryShellAdapter } from './adapters/in-memory-shell-adapter';
-/** @public */
-export { createInMemorySubprocessAdapter } from './adapters/in-memory-subprocess-adapter';
-//#endregion
-//#region Builders
-/** @public */
-export { step } from './builders/step-builders';
-/** @public */
-export { tool, toolWithGenerator } from './builders/tool-builder';
-//#endregion
-//#region Memory Layers
-/** @public */
-export { durableTaskState } from './memory/layers/durable-task-state';
-/** @public */
-export { historyWindow } from './memory/layers/history-window';
-/** @public */
-export { observationalMemory } from './memory/layers/observational-memory';
-/** @public */
-export { planMemory } from './memory/layers/plan';
-/** @public */
-export { toolMemoryLayer } from './memory/layers/tool-memory-layer';
-/** @public */
-export { workingMemory } from './memory/layers/working-memory';
-//#endregion
-//#region Runtime
-/** @public */
-export { AgentHarness } from './runtime/agent-harness';
-/** @public */
-export { createInMemoryStorage } from './runtime/in-memory-storage';
-//#endregion
+export * from './portable/adapters.js';
+export * from './portable/ask-user.js';
+export * from './portable/builders.js';
+export * from './portable/memory-layers.js';
+export * from './portable/runtime.js';
+export * from './portable/until.js';
+/** @public */
+export { Slot } from './types/memory.js';

package/dist/runtime/broadcaster-utils.d.ts

@@ -1,5 +1,5 @@
-import type { Context } from '../types/context';
-import type { EventBroadcaster } from './event-broadcaster';
+import type { Context } from '../types/context.js';
+import type { EventBroadcaster } from './event-broadcaster.js';
 /** @internal Option controlling framework event emission on a step or callModel request. */
 export type EmitOption = boolean | ((eventType: string, data: Record<string, unknown>) => boolean);
 /**
@@ -13,7 +13,11 @@ export type EmitOption = boolean | ((eventType: string, data: Record<string, unk
  */
 export declare function shouldEmit(emit: EmitOption | undefined, eventType: string, data: Record<string, unknown>): boolean;
 /**
- * Get the EventBroadcaster from a context if available.
+ * Get the EventBroadcaster from a context if available. Walks up the parent
+ * chain so spawned child contexts inherit the session-level broadcaster — the
+ * interpreter never re-installs `_broadcaster` on spawn children, so without
+ * this traversal every LLM call inside a `spawn()` step would be invisible to
+ * the UI stream.
  * Uses property check rather than instanceof to support mock contexts in tests.
  * @internal
  */

package/dist/runtime/broadcaster-utils.js

@@ -26,16 +26,21 @@ function hasBroadcaster(ctx) {
     return typeof ctx._broadcaster === 'object' && ctx._broadcaster !== null;
 }
 /**
- * Get the EventBroadcaster from a context if available.
+ * Get the EventBroadcaster from a context if available. Walks up the parent
+ * chain so spawned child contexts inherit the session-level broadcaster — the
+ * interpreter never re-installs `_broadcaster` on spawn children, so without
+ * this traversal every LLM call inside a `spawn()` step would be invisible to
+ * the UI stream.
  * Uses property check rather than instanceof to support mock contexts in tests.
  * @internal
  */
 export function getBroadcaster(ctx) {
-    if (!ctx) {
-        return undefined;
-    }
-    if (hasBroadcaster(ctx)) {
-        return ctx._broadcaster;
+    let current = ctx;
+    while (current) {
+        if (hasBroadcaster(current)) {
+            return current._broadcaster;
+        }
+        current = current.parent ?? null;
     }
     return undefined;
 }

package/dist/runtime/channel-store.d.ts

@@ -1,4 +1,4 @@
-import type { Channel, ChannelHandle, ExternalChannel } from '../types/channel';
+import type { Channel, ChannelHandle, ExternalChannel } from '../types/channel.js';
 export declare class ChannelStore {
     private channels;
     private closedExecutions;

package/dist/runtime/channel-store.js

@@ -1,5 +1,5 @@
-import { NoeticErrorImpl } from '../errors/noetic-error';
-import { frameworkCast } from '../interpreter/framework-cast';
+import { NoeticErrorImpl } from '../errors/noetic-error.js';
+import { frameworkCast } from '../util/framework-cast.js';
 function isExternalChannel(ch) {
     return 'external' in ch && ch.external === true;
 }

package/dist/runtime/context-deps.d.ts

@@ -0,0 +1,4 @@
+export { buildContextMemory } from '../memory/layer-api.js';
+export type { ItemSchemaRegistry } from '../schemas/item.js';
+export { defaultItemSchemaRegistry } from '../schemas/item.js';
+export type { AgentHarnessContract, Channel, ChannelStore, Context, ContextMemory, CwdState, EventBroadcaster, FrontierFrame, FsAdapter, Item, ItemLog, LastLayerUsage, MemoryLayer, Span, StepMeta, TokenUsage, Tool, } from './context-type-deps.js';

package/dist/runtime/context-deps.js

@@ -0,0 +1,2 @@
+export { buildContextMemory } from '../memory/layer-api.js';
+export { defaultItemSchemaRegistry } from '../schemas/item.js';

package/dist/runtime/context-impl.d.ts

@@ -1,14 +1,4 @@
-import type { ItemSchemaRegistry } from '../schemas/item';
-import type { Channel } from '../types/channel';
-import type { StepMeta, TokenUsage, Tool } from '../types/common';
-import type { Context, CwdState, ItemLog, LastLayerUsage } from '../types/context';
-import type { FsAdapter } from '../types/fs-adapter';
-import type { Item } from '../types/items';
-import type { ContextMemory, MemoryLayer } from '../types/memory';
-import type { Span } from '../types/observability';
-import type { AgentHarnessContract } from '../types/runtime';
-import type { ChannelStore } from './channel-store';
-import type { EventBroadcaster } from './event-broadcaster';
+import type { AgentHarnessContract, Channel, ChannelStore, Context, ContextMemory, CwdState, EventBroadcaster, FrontierFrame, FsAdapter, Item, ItemLog, ItemSchemaRegistry, LastLayerUsage, MemoryLayer, Span, StepMeta, TokenUsage, Tool } from './context-deps.js';
 export declare class ContextImpl implements Context<ContextMemory> {
     readonly id: string;
     stepCount: number;
@@ -34,7 +24,8 @@ export declare class ContextImpl implements Context<ContextMemory> {
     /**
      * Shared channel store for cross-context communication. Inherited by
      * `fork` / `spawn` children so channels published by a sibling are visible
-     * to peers — see `interpreter/execute-fork.ts` and `interpreter/execute-spawn.ts`.
+     * to peers — see `executeFork` and `executeSpawn` in `interpreter/execute-action.ts`
+     * and `interpreter/execute-control.ts`.
      * @internal
      */
     readonly channelStore?: ChannelStore;
@@ -44,6 +35,15 @@ export declare class ContextImpl implements Context<ContextMemory> {
     private _aborted;
     private _abortReason?;
     private _memory?;
+    /**
+     * Stack of steps currently in flight on this context, most-recent last.
+     * Pushed by `enterStep` at the top of `execute()` and popped by
+     * `leaveStep` when the step resolves (success or failure). The harness'
+     * checkpoint writer serialises this stack as the execution frontier so
+     * a restart can identify which step the context was paused inside.
+     * @internal
+     */
+    private readonly _frontier;
     constructor(opts: {
         harness: AgentHarnessContract;
         parent?: Context;
@@ -59,6 +59,14 @@ export declare class ContextImpl implements Context<ContextMemory> {
         itemSchemas?: ItemSchemaRegistry;
         cwdState?: CwdState;
         _broadcaster?: EventBroadcaster;
+        /**
+         * Pre-chosen context id. When set, the ContextImpl adopts this id instead
+         * of generating a fresh UUID. Used by `executeSpawn` so the child's
+         * `ctx.id` matches the `executionId` keyed into the layer-state store —
+         * otherwise writes via `ctx.memory[layerId].state` land on one id while
+         * spawn's `onReturn` reads from another, silently losing the update.
+         */
+        id?: string;
     });
     get elapsed(): number;
     get aborted(): boolean;
@@ -77,4 +85,26 @@ export declare class ContextImpl implements Context<ContextMemory> {
     get completionValue(): unknown;
     get abortReason(): string | undefined;
     abort(reason?: string): void;
+    /**
+     * @internal
+     * Push a frame onto the execution frontier. Called by `execute()` at the
+     * top of every step dispatch so that the frontier reflects exactly the
+     * stack of steps currently in-flight on this context.
+     */
+    enterStep(frame: FrontierFrame): void;
+    /**
+     * @internal
+     * Pop the top frame. Called when a step resolves (success or failure)
+     * so that the frontier unwinds cleanly. The value of `expectedStepId`
+     * is used as a consistency check — if it does not match the top frame
+     * the pop is still performed, but a best-effort warning is surfaced to
+     * stderr rather than swallowed silently.
+     */
+    leaveStep(expectedStepId: string): void;
+    /**
+     * @internal
+     * Return a defensive copy of the current frontier. Consumed by the
+     * checkpoint writer — see `AgentHarness.checkpoint`.
+     */
+    serialiseFrontier(): FrontierFrame[];
 }

package/dist/runtime/context-impl.js

@@ -1,6 +1,5 @@
-import { buildContextMemory } from '../memory/layer-api';
-import { defaultItemSchemaRegistry } from '../schemas/item';
-import { ItemLogImpl } from './item-log-impl';
+import { buildContextMemory, defaultItemSchemaRegistry } from './context-deps.js';
+import { ItemLogImpl } from './item-log-impl.js';
 const EMPTY_MEMORY = Object.freeze({});
 class NoopSpan {
     traceId = crypto.randomUUID();
@@ -39,7 +38,8 @@ export class ContextImpl {
     /**
      * Shared channel store for cross-context communication. Inherited by
      * `fork` / `spawn` children so channels published by a sibling are visible
-     * to peers — see `interpreter/execute-fork.ts` and `interpreter/execute-spawn.ts`.
+     * to peers — see `executeFork` and `executeSpawn` in `interpreter/execute-action.ts`
+     * and `interpreter/execute-control.ts`.
      * @internal
      */
     channelStore;
@@ -49,8 +49,17 @@ export class ContextImpl {
     _aborted = false;
     _abortReason;
     _memory;
+    /**
+     * Stack of steps currently in flight on this context, most-recent last.
+     * Pushed by `enterStep` at the top of `execute()` and popped by
+     * `leaveStep` when the step resolves (success or failure). The harness'
+     * checkpoint writer serialises this stack as the execution frontier so
+     * a restart can identify which step the context was paused inside.
+     * @internal
+     */
+    _frontier = [];
     constructor(opts) {
-        this.id = crypto.randomUUID();
+        this.id = opts.id ?? crypto.randomUUID();
         this._createdAt = Date.now();
         this.harness = opts.harness;
         this.state = opts.state ?? {};
@@ -137,4 +146,42 @@ export class ContextImpl {
         this._aborted = true;
         this._abortReason = reason;
     }
+    /**
+     * @internal
+     * Push a frame onto the execution frontier. Called by `execute()` at the
+     * top of every step dispatch so that the frontier reflects exactly the
+     * stack of steps currently in-flight on this context.
+     */
+    enterStep(frame) {
+        this._frontier.push(frame);
+    }
+    /**
+     * @internal
+     * Pop the top frame. Called when a step resolves (success or failure)
+     * so that the frontier unwinds cleanly. The value of `expectedStepId`
+     * is used as a consistency check — if it does not match the top frame
+     * the pop is still performed, but a best-effort warning is surfaced to
+     * stderr rather than swallowed silently.
+     */
+    leaveStep(expectedStepId) {
+        const top = this._frontier[this._frontier.length - 1];
+        if (top && top.stepId !== expectedStepId) {
+            // A mismatch indicates bookkeeping drift. We unwind best-effort and
+            // let the caller observe via `serialiseFrontier()` if needed.
+            console.warn(`ContextImpl.leaveStep: expected "${expectedStepId}" on top of frontier but saw "${top.stepId}".`);
+        }
+        this._frontier.pop();
+    }
+    /**
+     * @internal
+     * Return a defensive copy of the current frontier. Consumed by the
+     * checkpoint writer — see `AgentHarness.checkpoint`.
+     */
+    serialiseFrontier() {
+        return this._frontier.map((frame) => ({
+            stepId: frame.stepId,
+            input: frame.input,
+            state: frame.state,
+        }));
+    }
 }

package/dist/runtime/context-type-deps.d.ts

@@ -0,0 +1,14 @@
+export type { Channel } from '../types/channel.js';
+export type { FrontierFrame } from '../types/checkpoint.js';
+export type { StepMeta, TokenUsage } from '../types/common.js';
+export type { Context, CwdState } from '../types/context.js';
+export type { ItemLog } from '../types/context-parts/item-log.js';
+export type { LastLayerUsage } from '../types/context-parts/layer-usage.js';
+export type { FsAdapter } from '../types/fs-adapter.js';
+export type { Item } from '../types/items.js';
+export type { ContextMemory, MemoryLayer } from '../types/memory.js';
+export type { Span } from '../types/observability.js';
+export type { AgentHarnessContract } from '../types/runtime.js';
+export type { Tool } from '../types/tool.js';
+export type { ChannelStore } from './channel-store.js';
+export type { EventBroadcaster } from './event-broadcaster.js';

package/dist/runtime/context-type-deps.js

@@ -0,0 +1 @@
+export {};

package/dist/runtime/cwd-helpers.d.ts

@@ -1,4 +1,4 @@
-import type { Context, CwdState } from '../types/context';
+import type { Context, CwdState } from '../types/context.js';
 /**
  * @public Resolve the live cwd for a tool execution. Falls back to the
  * tool's factory-time cwd (then `process.cwd()`) so partial test contexts