@noetic-tools/core 0.0.1 → 0.1.0

package/dist/harness/model-schema.js

@@ -0,0 +1,46 @@
+import { mergeExtensions } from '../schemas/item';
+function mergeItemSchemaExtensions(extensions) {
+    let result = {
+        items: [],
+        developerMessages: [],
+        toolCalls: [],
+        toolResults: [],
+    };
+    for (const ext of extensions) {
+        if (ext) {
+            result = mergeExtensions(result, ext);
+        }
+    }
+    return result;
+}
+function collectLayerItemSchemaExtensions(layers) {
+    return mergeItemSchemaExtensions(layers?.map((layer) => layer.itemSchemas) ?? []);
+}
+function collectToolItemSchemaExtensions(tools) {
+    return mergeItemSchemaExtensions(tools?.map((tool) => tool.itemSchemas) ?? []);
+}
+export function buildItemSchemaRegistry({ base, layers, tools, }) {
+    return base
+        .extend(collectLayerItemSchemaExtensions(layers))
+        .extend(collectToolItemSchemaExtensions(tools));
+}
+export function createToolResultItem({ output, callId, roundItemSchemas, tool, callItem, args, result, error, }) {
+    const baseItem = {
+        id: crypto.randomUUID(),
+        status: 'completed',
+        type: 'function_call_output',
+        callId,
+        output,
+    };
+    const decorated = tool?.decorateResultItem && callItem?.type === 'function_call'
+        ? tool.decorateResultItem({
+            baseItem,
+            callItem,
+            args,
+            result,
+            output,
+            error,
+        })
+        : baseItem;
+    return roundItemSchemas.parseWithCategory(decorated, 'toolResults');
+}

package/dist/harness/step-bootstrap.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Step-bootstrap child entrypoint for the local subprocess adapter.
+ *
+ * The parent adapter spawns this module with `bun run <step-bootstrap.ts>`.
+ * It:
+ *
+ *   1. Reads a single JSON envelope from stdin (one frame, newline-terminated).
+ *   2. Dynamically imports the registry entry module so its module-level
+ *      `registerStep` side effects populate the registry in this process.
+ *   3. Looks up the requested step by id.
+ *   4. Constructs a minimal harness (in-memory adapters, no nested
+ *      subprocess) and runs the step.
+ *   5. Serialises the result (or error) as a JSON envelope on stdout.
+ *
+ * Protocol: the parent reads **exactly one JSON line** from stdout on child
+ * exit:
+ *
+ *   - Success: `{"kind":"ok","result":<value>}`
+ *   - Failure: `{"kind":"error","error":{"message":"...","name":"...","stack":"...","noeticError":...}}`
+ *
+ * On failure the process exits with code 1; on success, code 0. Uncaught
+ * errors are caught and reported through the same envelope so the parent
+ * never sees a silent crash.
+ */
+export {};

package/dist/harness/step-bootstrap.js

@@ -0,0 +1,170 @@
+/**
+ * Step-bootstrap child entrypoint for the local subprocess adapter.
+ *
+ * The parent adapter spawns this module with `bun run <step-bootstrap.ts>`.
+ * It:
+ *
+ *   1. Reads a single JSON envelope from stdin (one frame, newline-terminated).
+ *   2. Dynamically imports the registry entry module so its module-level
+ *      `registerStep` side effects populate the registry in this process.
+ *   3. Looks up the requested step by id.
+ *   4. Constructs a minimal harness (in-memory adapters, no nested
+ *      subprocess) and runs the step.
+ *   5. Serialises the result (or error) as a JSON envelope on stdout.
+ *
+ * Protocol: the parent reads **exactly one JSON line** from stdout on child
+ * exit:
+ *
+ *   - Success: `{"kind":"ok","result":<value>}`
+ *   - Failure: `{"kind":"error","error":{"message":"...","name":"...","stack":"...","noeticError":...}}`
+ *
+ * On failure the process exits with code 1; on success, code 0. Uncaught
+ * errors are caught and reported through the same envelope so the parent
+ * never sees a silent crash.
+ */
+import { lookupStep } from '../runtime/step-registry';
+import { AgentHarness } from './agent-harness';
+//#endregion
+//#region Helpers
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function isEnvelope(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    if (typeof value.stepId !== 'string' || typeof value.executionId !== 'string') {
+        return false;
+    }
+    if (typeof value.registryEntry !== 'string') {
+        return false;
+    }
+    if (!isRecord(value.overrides)) {
+        return false;
+    }
+    return true;
+}
+function readStdinFrame() {
+    return new Promise((resolve, reject) => {
+        let buf = '';
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', (chunk) => {
+            buf += chunk;
+            const nl = buf.indexOf('\n');
+            if (nl === -1) {
+                return;
+            }
+            process.stdin.pause();
+            resolve(buf.slice(0, nl));
+        });
+        process.stdin.on('end', () => {
+            if (buf.length > 0) {
+                resolve(buf);
+                return;
+            }
+            reject(new Error('step-bootstrap: stdin closed before an envelope was received'));
+        });
+        process.stdin.on('error', reject);
+    });
+}
+function serializeErrorFor(err) {
+    if (err instanceof Error) {
+        const payload = {
+            message: err.message,
+            name: err.name,
+            stack: err.stack,
+        };
+        if (isRecord(err) && 'noeticError' in err) {
+            payload.noeticError = err.noeticError;
+        }
+        return payload;
+    }
+    return {
+        message: typeof err === 'string' ? err : String(err),
+    };
+}
+function writeEnvelope(payload) {
+    // A single newline-terminated JSON line — matches the parent parser's
+    // contract in `local-subprocess-adapter.ts`.
+    process.stdout.write(`${JSON.stringify(payload)}\n`);
+}
+//#endregion
+//#region Main
+async function main() {
+    const raw = await readStdinFrame();
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        writeEnvelope({
+            kind: 'error',
+            error: serializeErrorFor(err),
+        });
+        return 1;
+    }
+    if (!isEnvelope(parsed)) {
+        writeEnvelope({
+            kind: 'error',
+            error: {
+                message: 'step-bootstrap: stdin envelope failed structural validation',
+            },
+        });
+        return 1;
+    }
+    // Import the registry entry so module-level `registerStep` side effects
+    // populate our registry before lookup. The parent guarantees the path is
+    // absolute (see `local-subprocess-adapter.ts:spawnStepHandle`).
+    await import(parsed.registryEntry);
+    const step = lookupStep(parsed.stepId);
+    if (!step) {
+        writeEnvelope({
+            kind: 'error',
+            error: {
+                message: `step-bootstrap: step "${parsed.stepId}" is not registered in the child runtime`,
+            },
+        });
+        return 1;
+    }
+    const harness = new AgentHarness({
+        name: `step-bootstrap-${parsed.stepId}`,
+        params: {},
+    });
+    const ctx = harness.createContext({
+        threadId: parsed.overrides.threadId,
+        resourceId: parsed.overrides.resourceId,
+        cwdInit: parsed.overrides.cwdInit,
+    });
+    try {
+        const result = await harness.run(step, parsed.serializedInput, ctx);
+        writeEnvelope({
+            kind: 'ok',
+            result,
+        });
+        return 0;
+    }
+    catch (err) {
+        writeEnvelope({
+            kind: 'error',
+            error: serializeErrorFor(err),
+        });
+        return 1;
+    }
+}
+void main()
+    .then((code) => {
+    // Flush before exit — `process.stdout.write` is async on some platforms
+    // (block devices, sockets) and an immediate `process.exit` can truncate.
+    process.stdout.once('drain', () => process.exit(code));
+    if (process.stdout.writableLength === 0) {
+        process.exit(code);
+    }
+})
+    .catch((err) => {
+    writeEnvelope({
+        kind: 'error',
+        error: serializeErrorFor(err),
+    });
+    process.exit(1);
+});
+//#endregion

package/dist/index.d.ts

@@ -5,12 +5,6 @@ export { createInMemoryShellAdapter } from './adapters/in-memory-shell-adapter';
 /** @public */
 export { createInMemorySubprocessAdapter } from './adapters/in-memory-subprocess-adapter';
 /** @public */
-export { createLocalFsAdapter } from './adapters/local-fs-adapter';
-/** @public */
-export { type CreateLocalShellAdapterOptions, createLocalShellAdapter, type LocalShellAdapter, } from './adapters/local-shell-adapter';
-/** @public */
-export { type CreateLocalSubprocessAdapterOptions, createLocalSubprocessAdapter, defaultProcessSignaller, type ProcessSignaller, type SubprocessSignal, } from './adapters/local-subprocess-adapter';
-/** @public */
 export { createOpenRouterEmbed } from './adapters/openrouter';
 /** @public */
 export { channel } from './builders/channel-builder';
@@ -37,6 +31,10 @@ export { step } from './builders/step-builders';
 /** @public */
 export { tool, toolWithGenerator } from './builders/tool-builder';
 /** @public */
+export type { HydrationContext } from './builders/workflow-hydrator';
+/** @public */
+export { hydrateNode, hydrateWorkflow } from './builders/workflow-hydrator';
+/** @public */
 export type { Condition, OtherwiseClause, WhenClause } from './conditions';
 /** @public */
 export { aiCondition, allCondition, anyCondition, cosineSimilarity, embeddingMatch, otherwise, semanticRoute, semanticSwitch, when, } from './conditions';
@@ -45,8 +43,14 @@ export { isNoeticConfigError, NoeticConfigError } from './errors/noetic-config-e
 /** @public */
 export { isNoeticError, NoeticErrorImpl } from './errors/noetic-error';
 /** @public */
+export type { AskUserAnnotation, AskUserInput, AskUserOption, AskUserOutput, AskUserQuestion, } from './types/ask-user-types';
+/** @public */
+export { AskUserAnnotationSchema, AskUserInputSchema, AskUserOptionSchema, AskUserOutputSchema, AskUserQuestionSchema, } from './types/ask-user-types';
+/** @public */
 export { execute } from './interpreter/execute';
 /** @public */
+export { findFunctionCall } from './memory/function-call-utils';
+/** @public */
 export type { DurableTaskState, DurableTaskStateConfig } from './memory/layers/durable-task-state';
 /** @public */
 export { durableTaskState } from './memory/layers/durable-task-state';
@@ -77,10 +81,18 @@ export { workingMemory } from './memory/layers/working-memory';
 /** @public */
 export { stripUnresolvedToolCalls } from './memory/strip-unresolved';
 /** @public */
+export { createMessage, estimateTokens } from './util/message-helpers';
+/** @public */
+export { GenAI, ToolAttr } from './observability/genai-attributes';
+/** @public */
 export { InMemoryExporter, NoopExporter } from './observability/trace-exporter';
 /** @public */
 export { createInMemoryStorage } from './runtime/in-memory-storage';
 /** @public */
+export type { DynamicWorkflowOpts, ParseAndRunWorkflowOpts } from './patterns/dynamic-workflow';
+/** @public */
+export { dynamicWorkflow, parseAndRunWorkflow } from './patterns/dynamic-workflow';
+/** @public */
 export type { FlowNode, ForkFlowNode, LlmFlowNode, SequenceFlowNode, SpawnFlowNode, SubagentFlowNode, } from './patterns/flow';
 /** @public */
 export { FlowSchema, flowDepth, validateFlow, walkFlow } from './patterns/flow';
@@ -97,17 +109,33 @@ export { ralphWiggum } from './patterns/ralph-wiggum';
 /** @public */
 export { react } from './patterns/react';
 /** @public */
-export { AgentHarness } from './runtime/agent-harness';
+export { AgentHarness } from './harness/agent-harness';
+/** @public */
+export type { AfterFirstTurnContext, CheckpointStore, CreateCheckpointStoreOptions, CreateNudgeMessageOpts, DetachedSignal, RunnableLoopHarness, RunnableLoopOpts, SessionSeedHarness, StallNudgeOpts, } from './runtime/durable';
+/** @public */
+export { CheckpointKeys, createCheckpointStore, createDetachedSignal, createNudgeMessage, createStallNudgeHook, DEFAULT_NUDGE_MESSAGE_TEXT, runnableLoop, seedFromItems, } from './runtime/durable';
+/** @public */
+export { getRegistry, lookupStep, registerStep } from './runtime/step-registry';
 /** @public */
 export { defaultItemSchemaRegistry, ItemSchema, ItemSchemaRegistry } from './schemas/item';
 /** @public */
+export type { BranchRoute, BranchWorkflowNode, EveryWorkflowNode, ForkWorkflowNode, LlmWorkflowNode, LoopWorkflowNode, MergeStrategy, ProvideWorkflowNode, SequenceWorkflowNode, SpawnWorkflowNode, ToolWorkflowNode, UntilPredicate, WorkflowDocument, WorkflowNode, } from './schemas/workflow';
+/** @public */
+export { MergeStrategySchema, UntilPredicateSchema, validateWorkflow, WorkflowDocumentSchema, WorkflowNodeSchema, walkWorkflow, workflowDepth, } from './schemas/workflow';
+/** @public */
 export type { Channel, ChannelHandle, ExternalChannel } from './types/channel';
 /** @public */
-export type { LLMResponse, LlmProviderConfig, ModelParams, RetryPolicy, StepMeta, TokenUsage, Tool, ToolMemoryDeclaration, } from './types/common';
+export type { LLMResponse, LlmProviderConfig, ModelParams, RetryPolicy, StepMeta, TokenUsage, } from './types/common';
+/** @public */
+export type { Tool, ToolMemoryDeclaration } from './types/tool';
 /** @public */
 export { getToolCwd, setToolCwd, snapshotCwdState } from './runtime/cwd-helpers';
 /** @public */
-export type { Context, CwdState, ItemLog, LastLayerUsage, LayerUsageEntry, } from './types/context';
+export type { Context, ContextHarness, CwdState, } from './types/context';
+/** @public */
+export type { ItemLog } from './types/context-parts/item-log';
+/** @public */
+export type { LastLayerUsage, LayerUsageEntry } from './types/context-parts/layer-usage';
 /** @public */
 export type { DetachedHandle } from './types/detached';
 /** @public */
@@ -115,14 +143,20 @@ export { DetachedStatus } from './types/detached';
 /** @public */
 export type { EmbedFn } from './types/embed';
 /** @public */
+export type { CheckpointSnapshot, CwdSnapshot, FrontierFrame, ItemLogSnapshot, PendingAskUserSnapshot, } from './types/checkpoint';
+/** @public */
+export { CheckpointSchemaVersion, CheckpointSnapshotSchema, CwdSnapshotSchema, FrontierFrameSchema, ItemLogSnapshotSchema, PendingAskUserSnapshotSchema, } from './types/checkpoint';
+/** @public */
 export type { NoeticError } from './types/error';
 /** @public */
-export type { ContentPart, DeveloperMessageExtensionItem, ExecuteInput, ExtendedItem, ExtensionItem, FileSearchItem, FunctionCallItem, FunctionCallOutputItem, ImageGenerationItem, InferExtendedItem, InputMessageItem, InputTextPart, Item, ItemBase, ItemSchemaExtensions, MessageItem, OutputItem, OutputTextPart, ReasoningItem, ReasoningTextPart, RefusalPart, ServerToolItem, SummaryTextPart, WebSearchItem, } from './types/items';
+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 './types/items';
 /** @public */
-export type { BudgetConfig, CompleteParams, ContextMemory, DisposeParams, ExecutionContext, ExecutionOutcome, InferMemory, InferMemoryShape, InitParams, InitResult, LayerDataDecl, LayerFunctionDecl, LayerProvides, LayerTimeouts, MemoryConfig, MemoryHooks, MemoryLayer, MemoryScope, ProjectionPolicy, RecallParams, RecallResult, ReturnParams, ReturnResult, ScopedStorage, SpawnParams, SpawnResult, StorageAdapter, StoreParams, StoreResult, } from './types/memory';
+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 './types/memory';
 /** @public */
 export { Slot } from './types/memory';
 /** @public */
+export type { ExecutionContext, ExecutionOutcome, MemoryCallModelRequest, MemoryScope, } from './types/memory-context';
+/** @public */
 export type { MemoryTraceSpan, Span, TraceExporter } from './types/observability';
 /** @public */
 export type { FrameworkStreamEvent, HarnessResponse, SdkStreamEvent, StreamEvent, StreamingItem, } from './types/harness-result';
@@ -136,12 +170,14 @@ export { LedgerEntryKind, SteeringAction } from './types/steering';
 export type { ExecuteStepFn, SettleResult, Snapshot, Step, StepBranch, StepFork, StepForkAll, StepForkRace, StepForkSettle, StepLLM, StepLoop, StepProvide, StepRun, StepSpawn, StepTool, Until, Verdict, } from './types/step';
 /** @public */
 export type { FsAdapter, FsStats } from './types/fs-adapter';
+/** @public Reusable error-serialiser used by custom SubprocessAdapter implementations. */
+export { serializeError } from './adapters/in-memory-subprocess/metadata';
 /** @public */
 export type { ShellAdapter, ShellExecOptions, ShellExecResult } from './types/shell-adapter';
 /** @public */
 export { TIMEOUT_ERROR_PREFIX } from './types/shell-adapter';
 /** @public */
-export type { SubprocessAdapter, SubprocessControlResult, SubprocessHandle, SubprocessRequest, SubprocessStatus, SubprocessStopResult, } from './types/subprocess-adapter';
+export type { ProcessSubprocessRequest, SerializedError, StepSubprocessOverrides, StepSubprocessRequest, SubprocessAdapter, SubprocessControlResult, SubprocessHandle, SubprocessHandleMetadata, SubprocessRequest, SubprocessStatus, SubprocessStopResult, } from './types/subprocess-adapter';
 /** @public */
 export type { ToolExecutionContext, ToolMemory } from './types/tool-context';
 /** @public */

package/dist/index.js

@@ -6,12 +6,6 @@ export { createInMemoryShellAdapter } from './adapters/in-memory-shell-adapter';
 /** @public */
 export { createInMemorySubprocessAdapter } from './adapters/in-memory-subprocess-adapter';
 /** @public */
-export { createLocalFsAdapter } from './adapters/local-fs-adapter';
-/** @public */
-export { createLocalShellAdapter, } from './adapters/local-shell-adapter';
-/** @public */
-export { createLocalSubprocessAdapter, defaultProcessSignaller, } from './adapters/local-subprocess-adapter';
-/** @public */
 export { createOpenRouterEmbed } from './adapters/openrouter';
 //#endregion
 //#region Builders
@@ -36,6 +30,8 @@ export { step } from './builders/step-builders';
 /** @public */
 export { tool, toolWithGenerator } from './builders/tool-builder';
 /** @public */
+export { hydrateNode, hydrateWorkflow } from './builders/workflow-hydrator';
+/** @public */
 export { aiCondition, allCondition, anyCondition, cosineSimilarity, embeddingMatch, otherwise, semanticRoute, semanticSwitch, when, } from './conditions';
 //#endregion
 //#region Errors
@@ -43,10 +39,16 @@ export { aiCondition, allCondition, anyCondition, cosineSimilarity, embeddingMat
 export { isNoeticConfigError, NoeticConfigError } from './errors/noetic-config-error';
 /** @public */
 export { isNoeticError, NoeticErrorImpl } from './errors/noetic-error';
+/** @public */
+export { AskUserAnnotationSchema, AskUserInputSchema, AskUserOptionSchema, AskUserOutputSchema, AskUserQuestionSchema, } from './types/ask-user-types';
 //#endregion
 //#region Execution
 /** @public */
 export { execute } from './interpreter/execute';
+//#endregion
+//#region Memory Layers
+/** @public */
+export { findFunctionCall } from './memory/function-call-utils';
 /** @public */
 export { durableTaskState } from './memory/layers/durable-task-state';
 /** @public */
@@ -68,12 +70,20 @@ export { workingMemory } from './memory/layers/working-memory';
 /** @public */
 export { stripUnresolvedToolCalls } from './memory/strip-unresolved';
 //#endregion
+//#region Message Utilities
+/** @public */
+export { createMessage, estimateTokens } from './util/message-helpers';
+//#endregion
 //#region Observability
 /** @public */
+export { GenAI, ToolAttr } from './observability/genai-attributes';
+/** @public */
 export { InMemoryExporter, NoopExporter } from './observability/trace-exporter';
 /** @public */
 export { createInMemoryStorage } from './runtime/in-memory-storage';
 /** @public */
+export { dynamicWorkflow, parseAndRunWorkflow } from './patterns/dynamic-workflow';
+/** @public */
 export { FlowSchema, flowDepth, validateFlow, walkFlow } from './patterns/flow';
 /** @public */
 export { interview } from './patterns/interview';
@@ -86,11 +96,17 @@ export { react } from './patterns/react';
 //#endregion
 //#region Runtime
 /** @public */
-export { AgentHarness } from './runtime/agent-harness';
+export { AgentHarness } from './harness/agent-harness';
+/** @public */
+export { CheckpointKeys, createCheckpointStore, createDetachedSignal, createNudgeMessage, createStallNudgeHook, DEFAULT_NUDGE_MESSAGE_TEXT, runnableLoop, seedFromItems, } from './runtime/durable';
+/** @public */
+export { getRegistry, lookupStep, registerStep } from './runtime/step-registry';
 //#endregion
 //#region Schemas
 /** @public */
 export { defaultItemSchemaRegistry, ItemSchema, ItemSchemaRegistry } from './schemas/item';
+/** @public */
+export { MergeStrategySchema, UntilPredicateSchema, validateWorkflow, WorkflowDocumentSchema, WorkflowNodeSchema, walkWorkflow, workflowDepth, } from './schemas/workflow';
 //#endregion
 //#region Types — Context
 /** @public */
@@ -98,9 +114,15 @@ export { getToolCwd, setToolCwd, snapshotCwdState } from './runtime/cwd-helpers'
 /** @public */
 export { DetachedStatus } from './types/detached';
 /** @public */
+export { CheckpointSchemaVersion, CheckpointSnapshotSchema, CwdSnapshotSchema, FrontierFrameSchema, ItemLogSnapshotSchema, PendingAskUserSnapshotSchema, } from './types/checkpoint';
+/** @public */
 export { Slot } from './types/memory';
 /** @public */
 export { LedgerEntryKind, SteeringAction } from './types/steering';
+//#endregion
+//#region Types — Shell
+/** @public Reusable error-serialiser used by custom SubprocessAdapter implementations. */
+export { serializeError } from './adapters/in-memory-subprocess/metadata';
 /** @public */
 export { TIMEOUT_ERROR_PREFIX } from './types/shell-adapter';
 //#endregion

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

@@ -0,0 +1,12 @@
+export { contextToExecCtx } from '../memory/exec-context-factory';
+export { resolveLayerTools } from '../memory/layer-api';
+export type { LayerStateStore } from '../memory/layer-lifecycle';
+export { returnLayers, spawnLayers } from '../memory/layer-lifecycle';
+export { commitLayerUsage, computeLayerUsage } from '../memory/layer-usage';
+export { assembleView } from '../memory/projector';
+export { emitFrameworkEvent, getBroadcaster } from '../runtime/broadcaster-utils';
+export { ContextImpl } from '../runtime/context-impl';
+export { snapshotCwdState } from '../runtime/cwd-helpers';
+export { buildToolExecutionContext } from '../runtime/tool-memory';
+export type { ItemSchemaRegistry } from '../schemas/item';
+export { defaultItemSchemaRegistry } from '../schemas/item';

package/dist/interpreter/action-deps.js

@@ -0,0 +1,10 @@
+export { contextToExecCtx } from '../memory/exec-context-factory';
+export { resolveLayerTools } from '../memory/layer-api';
+export { returnLayers, spawnLayers } from '../memory/layer-lifecycle';
+export { commitLayerUsage, computeLayerUsage } from '../memory/layer-usage';
+export { assembleView } from '../memory/projector';
+export { emitFrameworkEvent, getBroadcaster } from '../runtime/broadcaster-utils';
+export { ContextImpl } from '../runtime/context-impl';
+export { snapshotCwdState } from '../runtime/cwd-helpers';
+export { buildToolExecutionContext } from '../runtime/tool-memory';
+export { defaultItemSchemaRegistry } from '../schemas/item';

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

@@ -0,0 +1,8 @@
+export type { RetryPolicy, StepMeta } from '../types/common';
+export type { Context } from '../types/context';
+export type { FunctionCallItem, Item } from '../types/items';
+export type { ContextMemory, ExecutionContext, MemoryConfig, MemoryLayer } from '../types/memory';
+export type { AgentHarnessContract, RecallLayerOutput } from '../types/runtime';
+export { SteeringAction } from '../types/steering';
+export type { ExecuteStepFn, StepLLM, StepProvide, StepRun, StepSpawn, StepTool, } from '../types/step';
+export type { Tool } from '../types/tool';

package/dist/interpreter/action-types.js

@@ -0,0 +1 @@
+export { SteeringAction } from '../types/steering';

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

@@ -1,5 +1,5 @@
-import type { Tool } from '../types/common';
 import type { Step } from '../types/step';
+import type { Tool } from '../types/tool';
 /**
  * Recursively walks a step tree and collects all Tool instances
  * declared on LLM steps. Used to build the unified tool set

package/dist/interpreter/collect-tools.js

@@ -1,4 +1,4 @@
-import { frameworkCast } from './framework-cast';
+import { frameworkCast } from '../util/framework-cast';
 /**
  * Recursively walks a step tree and collects all Tool instances
  * declared on LLM steps. Used to build the unified tool set
@@ -28,7 +28,11 @@ export function deduplicateTools(tools) {
 function walkStep(step, out) {
     switch (step.kind) {
         case 'llm':
-            if (step.tools) {
+            // Skip function-form tools: they're resolved per execution from `ctx`
+            // and cannot contribute to the pre-computed unified set. Consumers that
+            // need those tools in the pool should register them via
+            // `AgentHarness.tools` instead.
+            if (Array.isArray(step.tools)) {
                 out.push(...step.tools);
             }
             return;

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

@@ -0,0 +1,22 @@
+/**
+ * Action step handlers: run, llm, spawn, provide, tool.
+ */
+import type { ItemSchemaRegistry, LayerStateStore } from './action-deps';
+import type { AgentHarnessContract, Context, ExecuteStepFn, MemoryLayer, StepLLM, StepProvide, StepRun, StepSpawn, StepTool } from './action-types';
+export declare function executeRun<TMemory, I, O>(step: StepRun<TMemory, I, O>, input: I, ctx: Context<TMemory>): Promise<O>;
+export declare function executeLLM<TMemory, I, O>(step: StepLLM<TMemory, I, O>, input: I, ctx: Context<TMemory>, layers?: MemoryLayer[]): Promise<O>;
+export interface ExecuteSpawnOpts {
+    layerStore?: LayerStateStore;
+    parentLayers?: MemoryLayer[];
+    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>;
+/**
+ * Executes a provide step by attaching memory 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>;