@noetic-tools/core 5.3.0 → 5.4.1

package/dist/index.d.ts

@@ -7,35 +7,43 @@ export { createInMemorySubprocessAdapter } from './adapters/in-memory-subprocess
 /** @public */
 export { createOpenRouterEmbed } from './adapters/openrouter.js';
 /** @public */
+export type { AcpAgentToolOptions } from './builders/acp-agent-tool.js';
+/** @public */
+export { acpAgentTool } from './builders/acp-agent-tool.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';
+export { conditional, inParallel } from './builders/control-flow-builders.js';
 /** @public */
-export type { EveryOptions } from './builders/every.js';
+export type { ScheduleOptions } from './builders/every.js';
 /** @public */
-export { every } from './builders/every.js';
+export { schedule } from './builders/every.js';
 /** @public */
-export { layerData, layerFn } from './builders/layer-provides-builders.js';
+export { layerData, layerFunction } from './builders/layer-provides-builders.js';
 /** @public */
 export type { LoopConfig } from './builders/loop-builder.js';
 /** @public */
 export { loop } from './builders/loop-builder.js';
 /** @public */
-export { provide } from './builders/provide-builder.js';
+export { withContext } from './builders/provide-builder.js';
 /** @public */
 export { spawn } from './builders/spawn-builder.js';
 /** @public */
+export type { CallModelOpts, InvokeToolOpts, RunCodeOpts } from './builders/step-builders.js';
+/** @public */
+export { callModel, invokeTool, runCode, step } from './builders/step-builders.js';
+/** @public */
 export { tool, toolWithGenerator } from './builders/tool-builder.js';
 /** @public */
 export type { HydrationContext } from './builders/workflow-hydrator.js';
 /** @public */
 export { hydrateNode, hydrateWorkflow } from './builders/workflow-hydrator.js';
 /** @public */
-export type { StepWorkflowOpts } from './builders/workflow-step.js';
+export type { WorkflowOpts } from './builders/workflow-step.js';
 /** @public */
-export { step } from './builders/workflow-step.js';
+export { workflow } from './builders/workflow-step.js';
 /** @public */
 export type { Condition, OtherwiseClause, WhenClause } from './conditions/conditions.js';
 /** @public */
@@ -57,7 +65,7 @@ export { execute } from './interpreter/execute.js';
 /** @public */
 /** @public */
 /** @public */
-export type { DurableTaskState, FactExtractor, FactSearcher, HistoryWindowConfig, ObservationalContextConfig, ObservationalState, PlanContextConfig, PlanEnterSessionCallback, PlanExecutionEntry, PlanExitCallback, PlanState, TemporalContextConfig, TemporalFact, TemporalSearchResult, WorkingMemoryContextConfig, WorkingMemoryContextState, } from '@noetic-tools/context';
+export type { FactExtractor, FactSearcher, HistoryConfig, ObservationsConfig, ObservationsState, PlanConfig, PlanEnterSessionCallback, PlanExecutionEntry, PlanExitCallback, PlanState, ScratchpadConfig, ScratchpadState, TaskState, TemporalConfig, TemporalFact, TemporalSearchResult, } from '@noetic-tools/context';
 /** @public */
 /** @public */
 /** @public */
@@ -70,7 +78,7 @@ export type { DurableTaskState, FactExtractor, FactSearcher, HistoryWindowConfig
 /** @public */
 /** @public */
 /** @public */
-export { durableTaskState, fileReference, findFunctionCall, historyWindow, observationalContext, PlanPhase, PlanStyle, planContext, staticContent, steering, storageGetMany, stripUnresolvedToolCalls, temporalContext, toolContextLayer, workingMemoryContext, } from '@noetic-tools/context';
+export { filesystem, findFunctionCall, history, instructions, observations, PlanPhase, PlanStyle, plan, scratchpad, steering, storageGetMany, stripUnresolvedToolCalls, taskState, temporal, toolCalls, } from '@noetic-tools/context';
 /** @public */
 export { createMessage, estimateTokens } from '@noetic-tools/types';
 /** @public */
@@ -80,21 +88,11 @@ export { InMemoryExporter, NoopExporter } from './observability/trace-exporter.j
 /** @public */
 export { createInMemoryStorage } from './runtime/in-memory-storage.js';
 /** @public */
-export type { DynamicWorkflowOpts, ParseAndRunWorkflowOpts } from './patterns/dynamic-workflow.js';
-/** @public */
-export { dynamicWorkflow, parseAndRunWorkflow } from './patterns/dynamic-workflow.js';
-/** @public */
-export type { InterviewOpts, InterviewQuestionAnswer, InterviewResult } from './patterns/interview.js';
-/** @public */
-export { interview } from './patterns/interview.js';
-/** @public */
-export type { PlanConstraints, PlanNode } from './patterns/plans.js';
-/** @public */
-export { adaptivePlan, compilePlan, PlanNodeSchema } from './patterns/plans.js';
+export type { DynamicWorkflowOpts, ParseAndRunWorkflowOpts } from './builders/dynamic-workflow.js';
 /** @public */
-export { ralphWiggum } from './patterns/ralph-wiggum.js';
+export { dynamicWorkflow, parseAndRunWorkflow } from './builders/dynamic-workflow.js';
 /** @public */
-export { react } from './patterns/react.js';
+export type { AgentEnvironmentConfig, StorageEnvironmentConfig, } from './harness/agent-harness.js';
 /** @public */
 export { AgentHarness } from './harness/agent-harness.js';
 /** @public */
@@ -106,16 +104,16 @@ export { getRegistry, lookupStep, registerStep } from './runtime/step-registry.j
 /** @public */
 export { defaultItemSchemaRegistry, ItemSchema, ItemSchemaRegistry } from '@noetic-tools/types';
 /** @public */
-export type { BranchRoute, BranchWorkflowNode, EveryWorkflowNode, ForkWorkflowNode, LlmWorkflowNode, LoopWorkflowNode, MergeStrategy, ProvideWorkflowNode, SequenceWorkflowNode, SpawnWorkflowNode, SubflowWorkflowNode, SubHarnessWorkflowNode, ToolWorkflowNode, UntilPredicate, WorkflowDocument, WorkflowNode, } from './schemas/workflow.js';
+export type { AcpAgentWorkflowNode, CallModelWorkflowNode, ConditionalRoute, ConditionalWorkflowNode, InParallelWorkflowNode, InvokeToolWorkflowNode, LoopWorkflowNode, MergeStrategy, ScheduleWorkflowNode, SequenceWorkflowNode, SpawnWorkflowNode, SubflowWorkflowNode, UntilPredicate, WithContextWorkflowNode, WorkflowDocument, WorkflowNode, } from './schemas/workflow.js';
 /** @public */
 export { MergeStrategySchema, UntilPredicateSchema, validateWorkflow, WorkflowDocumentSchema, WorkflowNodeSchema, walkWorkflow, workflowDepth, } from './schemas/workflow.js';
 /** @public */
 export type { Channel, ChannelHandle, ExternalChannel } from '@noetic-tools/types';
 /** @public */
 /** @public */
-export type { LLMResponse, LlmProviderConfig, ModelParams, RetryPolicy, RoundUsage, ServerToolSpec, StepMeta, TokenUsage, Tool, ToolContextDeclaration, } from '@noetic-tools/types';
+export type { InferSchemaInput, InferSchemaOutput, InputSchemaConfig, LLMResponse, LlmProviderConfig, ModelParams, RetryPolicy, RoundUsage, SchemaValidationFailure, SchemaValidationResult, SchemaValidationSuccess, ServerToolSpec, StandardJSONSchemaV1, StandardSchemaV1, StepMeta, TokenUsage, Tool, ToolContextDeclaration, } from '@noetic-tools/types';
 /** @public */
-export { isServerToolSpec } from '@noetic-tools/types';
+export { isServerToolSpec, isStandardJsonSchema, isZodSchema, standardIssuesToZodError, validateSchema, } from '@noetic-tools/types';
 /** @public */
 /** @public */
 /** @public */
@@ -147,17 +145,17 @@ export type { LayerTraceSpan, Span, TraceExporter } from '@noetic-tools/types';
 /** @public */
 export type { FrameworkStreamEvent, HarnessResponse, SdkStreamEvent, StreamEvent, StreamingItem, } from '@noetic-tools/types';
 /** @public */
-export type { AgentConfig, AgentHarnessContract, AgentHooks, CallModelRequest, ContextCacheConfig, ContextCacheStore, ContextEpoch, DeliveryMode, ExecuteOptions, HarnessStatus, ReanchorReason, RecallLayerOutput, SessionScope, } from '@noetic-tools/types';
+export type { AgentConfig, AgentHarnessContract, AgentHooks, CallModelRequest, ContextCacheConfig, ContextCacheStore, ContextEpoch, DeliveryMode, ExecuteOptions, HarnessStatus, ItemSchemaConfig, ReanchorReason, RecallLayerOutput, SessionScope, SessionUsage, } from '@noetic-tools/types';
 /** @public */
 export type { AfterModelCallParams, AfterModelCallResult, BeforeToolCallParams, BeforeToolCallResult, LedgerEntry, SteeringConfig, SteeringDecision, SteeringRule, SteeringState, } from '@noetic-tools/types';
 /** @public */
 export { LedgerEntryKind, SteeringAction } from '@noetic-tools/types';
 /** @public */
-export type { ExecuteStepFn, SettleResult, Snapshot, Step, StepBranch, StepFork, StepForkAll, StepForkRace, StepForkSettle, StepLLM, StepLoop, StepProvide, StepRun, StepSpawn, StepSubHarness, StepTool, Until, Verdict, } from '@noetic-tools/types';
+export type { ExecuteStepFn, SettleResult, Snapshot, Step, StepAcpAgent, StepCallModel, StepConditional, StepInParallel, StepInParallelAll, StepInParallelRace, StepInParallelSettle, StepInvokeTool, StepLoop, StepRunCode, StepSpawn, StepWithContext, Until, Verdict, } from '@noetic-tools/types';
 /** @public */
-export type { SubHarness, SubHarnessBuiltinTool, SubHarnessContinueState, SubHarnessContinueTurnOptions, SubHarnessFinishReason, SubHarnessPromptTurnOptions, SubHarnessResumeState, SubHarnessRunContext, SubHarnessSession, SubHarnessSessionPolicy, SubHarnessSettings, SubHarnessStartOptions, SubHarnessStreamPart, SubHarnessTurnResult, } from '@noetic-tools/types';
+export type { AcpAgent, AcpAgentCapabilities, AcpAgentConnection, AcpAuthMethod, AcpAvailableCommand, AcpBoundPermissionHandler, AcpClientCapabilityConfig, AcpClientHost, AcpConnectOptions, AcpContentBlock, AcpKeepAlive, AcpLiveSession, AcpLoadSessionOptions, AcpMcpServer, AcpNewSessionOptions, AcpPermissionHandler, AcpPermissionOption, AcpPermissionOutcome, AcpPermissionPolicy, AcpPermissionRequestInfo, AcpPermissionRule, AcpPermissionSteerer, AcpPlanEntry, AcpPromptCapabilities, AcpPromptOptions, AcpRequestPermissionRequest, AcpSession, AcpSessionDisposer, AcpSessionInfo, AcpSessionMode, AcpSessionModeState, AcpSessionNotification, AcpSessionPolicy, AcpStopReason, AcpToolCallContent, AcpToolCallStatus, AcpToolKind, AcpTransport, AcpTransportFactory, AcpTransportOptions, AcpTurnResult, } from '@noetic-tools/types';
 /** @public */
-export { SUB_HARNESS_KINDS, SubHarnessKind, SubHarnessStreamPartSchema } from '@noetic-tools/types';
+export { ACP_AGENT_STEP_KIND, AcpCapabilityError, AcpConnectError, AcpPermissionDecision, isAcpCapabilityError, isAcpConnectError, } from '@noetic-tools/types';
 /** @public */
 export type { FsAdapter, FsStats } from '@noetic-tools/types';
 /** @public */
@@ -175,9 +173,3 @@ export { all, any } from './until/combinators.js';
 export type { ConvergeConfig, VerifyFn } from './until/predicates.js';
 /** @public */
 export { until } from './until/predicates.js';
-/**
- * Pre-rename names for the context layer system — `MemoryLayer`, `memory()`,
- * `workingMemory`, and friends. Each carries its own `@deprecated` pointer to
- * its replacement in `./deprecated`. Removed in the next major.
- */
-export * from './deprecated.js';

package/dist/index.js

@@ -7,30 +7,32 @@ export { createInMemoryShellAdapter } from './adapters/in-memory-shell-adapter.j
 export { createInMemorySubprocessAdapter } from './adapters/in-memory-subprocess-adapter.js';
 /** @public */
 export { createOpenRouterEmbed } from './adapters/openrouter.js';
-//#endregion
-//#region Builders
+/** @public */
+export { acpAgentTool } from './builders/acp-agent-tool.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';
+export { conditional, inParallel } from './builders/control-flow-builders.js';
 /** @public */
-export { every } from './builders/every.js';
+export { schedule } from './builders/every.js';
 /** @public */
-export { layerData, layerFn } from './builders/layer-provides-builders.js';
+export { layerData, layerFunction } from './builders/layer-provides-builders.js';
 /** @public */
 export { loop } from './builders/loop-builder.js';
 /** @public */
-export { provide } from './builders/provide-builder.js';
+export { withContext } from './builders/provide-builder.js';
 /** @public */
 export { spawn } from './builders/spawn-builder.js';
 /** @public */
+export { callModel, invokeTool, runCode, step } from './builders/step-builders.js';
+/** @public */
 export { tool, toolWithGenerator } from './builders/tool-builder.js';
 /** @public */
 export { hydrateNode, hydrateWorkflow } from './builders/workflow-hydrator.js';
 /** @public */
-export { step } from './builders/workflow-step.js';
+export { workflow } from './builders/workflow-step.js';
 /** @public */
 export { aiCondition, allCondition, anyCondition, embeddingMatch, otherwise, semanticRoute, semanticSwitch, when, } from './conditions/conditions.js';
 /** @public */
@@ -58,7 +60,7 @@ export { execute } from './interpreter/execute.js';
 /** @public */
 /** @public */
 /** @public */
-export { durableTaskState, fileReference, findFunctionCall, historyWindow, observationalContext, PlanPhase, PlanStyle, planContext, staticContent, steering, storageGetMany, stripUnresolvedToolCalls, temporalContext, toolContextLayer, workingMemoryContext, } from '@noetic-tools/context';
+export { filesystem, findFunctionCall, history, instructions, observations, PlanPhase, PlanStyle, plan, scratchpad, steering, storageGetMany, stripUnresolvedToolCalls, taskState, temporal, toolCalls, } from '@noetic-tools/context';
 //#endregion
 //#region Message Utilities
 /** @public */
@@ -72,17 +74,7 @@ export { InMemoryExporter, NoopExporter } from './observability/trace-exporter.j
 /** @public */
 export { createInMemoryStorage } from './runtime/in-memory-storage.js';
 /** @public */
-export { dynamicWorkflow, parseAndRunWorkflow } from './patterns/dynamic-workflow.js';
-/** @public */
-export { interview } from './patterns/interview.js';
-/** @public */
-export { adaptivePlan, compilePlan, PlanNodeSchema } from './patterns/plans.js';
-/** @public */
-export { ralphWiggum } from './patterns/ralph-wiggum.js';
-/** @public */
-export { react } from './patterns/react.js';
-//#endregion
-//#region Runtime
+export { dynamicWorkflow, parseAndRunWorkflow } from './builders/dynamic-workflow.js';
 /** @public */
 export { AgentHarness } from './harness/agent-harness.js';
 /** @public */
@@ -96,7 +88,7 @@ export { defaultItemSchemaRegistry, ItemSchema, ItemSchemaRegistry } from '@noet
 /** @public */
 export { MergeStrategySchema, UntilPredicateSchema, validateWorkflow, WorkflowDocumentSchema, WorkflowNodeSchema, walkWorkflow, workflowDepth, } from './schemas/workflow.js';
 /** @public */
-export { isServerToolSpec } from '@noetic-tools/types';
+export { isServerToolSpec, isStandardJsonSchema, isZodSchema, standardIssuesToZodError, validateSchema, } from '@noetic-tools/types';
 /** @public */
 export { getToolCwd, setToolCwd, snapshotCwdState } from './runtime/cwd-helpers.js';
 /** @public */
@@ -108,7 +100,7 @@ export { Slot } from '@noetic-tools/context';
 /** @public */
 export { LedgerEntryKind, SteeringAction } from '@noetic-tools/types';
 /** @public */
-export { SUB_HARNESS_KINDS, SubHarnessKind, SubHarnessStreamPartSchema } from '@noetic-tools/types';
+export { ACP_AGENT_STEP_KIND, AcpCapabilityError, AcpConnectError, AcpPermissionDecision, isAcpCapabilityError, isAcpConnectError, } from '@noetic-tools/types';
 /** @public */
 export { TIMEOUT_ERROR_PREFIX } from '@noetic-tools/types';
 /** @public Reusable error-serialiser used by custom SubprocessAdapter implementations. */
@@ -120,11 +112,3 @@ export { all, any } from './until/combinators.js';
 /** @public */
 export { until } from './until/predicates.js';
 //#endregion
-//#region Deprecated aliases
-/**
- * Pre-rename names for the context layer system — `MemoryLayer`, `memory()`,
- * `workingMemory`, and friends. Each carries its own `@deprecated` pointer to
- * its replacement in `./deprecated`. Removed in the next major.
- */
-export * from './deprecated.js';
-//#endregion

package/dist/interpreter/acp-events.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Maps an ACP turn's `session/update` notifications onto the harness's
+ * observable event surface.
+ *
+ * Every one of the protocol's eight update variants is translated into the same
+ * `source: 'sdk'` broadcaster events the model-call path emits, so a coding
+ * agent's text, reasoning, and tool calls flow through `getTextStream()` /
+ * `getReasoningStream()` / `getItemStream()` / `getFullStream()` exactly like an
+ * LLM step's output. Each notification is *also* re-emitted raw as an
+ * `acp_event` framework event for consumers that want the protocol payload.
+ *
+ * `finalize()` guarantees a turn always emits its output: if an agent returns a
+ * stop reason without streaming any text or tool calls, the result's content is
+ * synthesized into events.
+ */
+import type { AcpClientActivity, AcpSessionNotification, AcpTurnResult, Context, ContextData, StepAcpAgent } from '@noetic-tools/types';
+export declare class AcpEventBridge {
+    private readonly broadcaster?;
+    private readonly agentName;
+    private readonly stepId;
+    private readonly agentId;
+    private readonly emitOption;
+    private started;
+    private completed;
+    private nextOutputIndex;
+    private messageOutputIndex;
+    private sawText;
+    /** Tool call ids already announced, so a `tool_call_update` never re-opens one. */
+    private readonly announcedToolCalls;
+    constructor(step: Pick<StepAcpAgent, 'id' | 'emit'>, agentId: string, ctx: Context<ContextData>);
+    /**
+     * Open the turn on the event surface. Emits `response.created` so every turn
+     * brackets with a lifecycle marker — even an agent that streams nothing.
+     */
+    begin(): void;
+    /**
+     * Record one client-side operation the agent performed. Unlike a `tool_call`
+     * update — which is the agent's own account of what it did — this is what it
+     * actually asked us to do, refusals included.
+     */
+    forwardActivity(activity: AcpClientActivity): void;
+    /** Forward one notification: a structured framework event + the mapped sdk events. */
+    forward(notification: AcpSessionNotification): void;
+    /**
+     * Ensure the turn's output reached the event surface. For an agent that
+     * returns a result without streaming, synthesize events from the result.
+     */
+    finalize(result: AcpTurnResult): void;
+    /**
+     * Close a turn that failed. The bracket a consumer waits on must be honoured
+     * even when the turn dies mid-stream, so an open message is closed and the
+     * response completes with an error rather than the stream simply stopping.
+     */
+    abort(cause: unknown): void;
+    /**
+     * Emit one framework event under this step's envelope. The `sdk` sibling
+     * below does the same job for the model-stream surface; both gate on
+     * `emitOption` so `emit: false` silences every surface at once.
+     */
+    private framework;
+    private sdk;
+    private start;
+    private openMessage;
+    private closeMessage;
+    private emitToolCall;
+    private translate;
+}

package/dist/interpreter/acp-events.js

@@ -0,0 +1,256 @@
+/**
+ * Maps an ACP turn's `session/update` notifications onto the harness's
+ * observable event surface.
+ *
+ * Every one of the protocol's eight update variants is translated into the same
+ * `source: 'sdk'` broadcaster events the model-call path emits, so a coding
+ * agent's text, reasoning, and tool calls flow through `getTextStream()` /
+ * `getReasoningStream()` / `getItemStream()` / `getFullStream()` exactly like an
+ * LLM step's output. Each notification is *also* re-emitted raw as an
+ * `acp_event` framework event for consumers that want the protocol payload.
+ *
+ * `finalize()` guarantees a turn always emits its output: if an agent returns a
+ * stop reason without streaming any text or tool calls, the result's content is
+ * synthesized into events.
+ */
+import { emitFrameworkEvent, getBroadcaster, shouldEmit } from '../runtime/broadcaster-utils.js';
+import { isFunctionCall } from './typeguards.js';
+/** Flatten an ACP content block for the text event surface. */
+function blockText(block) {
+    if (block.type === 'text') {
+        return block.text;
+    }
+    if (block.type === 'resource_link') {
+        return `[resource: ${block.uri}]`;
+    }
+    if (block.type === 'resource') {
+        return 'text' in block.resource ? block.resource.text : `[resource: ${block.resource.uri}]`;
+    }
+    return `[${block.type}: ${block.mimeType}]`;
+}
+export class AcpEventBridge {
+    broadcaster;
+    agentName;
+    stepId;
+    agentId;
+    emitOption;
+    started = false;
+    completed = false;
+    nextOutputIndex = 0;
+    messageOutputIndex = null;
+    sawText = false;
+    /** Tool call ids already announced, so a `tool_call_update` never re-opens one. */
+    announcedToolCalls = new Set();
+    constructor(step, agentId, ctx) {
+        this.broadcaster = getBroadcaster(ctx);
+        this.agentName = ctx.harness.config.name;
+        this.stepId = step.id;
+        this.agentId = agentId;
+        this.emitOption = step.emit;
+    }
+    /**
+     * Open the turn on the event surface. Emits `response.created` so every turn
+     * brackets with a lifecycle marker — even an agent that streams nothing.
+     */
+    begin() {
+        this.start();
+    }
+    /**
+     * Record one client-side operation the agent performed. Unlike a `tool_call`
+     * update — which is the agent's own account of what it did — this is what it
+     * actually asked us to do, refusals included.
+     */
+    forwardActivity(activity) {
+        this.framework('acp_client_activity', {
+            ...activity,
+        });
+    }
+    /** Forward one notification: a structured framework event + the mapped sdk events. */
+    forward(notification) {
+        if (!this.broadcaster) {
+            return;
+        }
+        this.framework('acp_event', {
+            sessionId: notification.sessionId,
+            update: notification.update,
+        });
+        this.translate(notification.update);
+    }
+    /**
+     * Ensure the turn's output reached the event surface. For an agent that
+     * returns a result without streaming, synthesize events from the result.
+     */
+    finalize(result) {
+        if (!this.broadcaster) {
+            return;
+        }
+        if (!this.sawText && result.text.length > 0) {
+            this.openMessage();
+            this.sdk('response.output_text.delta', {
+                delta: result.text,
+            }, this.messageOutputIndex ?? 0);
+            this.sawText = true;
+        }
+        // Close the message before synthesizing tool calls, so output items finish
+        // in index order. Emitting them first left item 0 closing after items 1..n,
+        // which reads as interleaved output to a consumer tracking `outputIndex`.
+        this.closeMessage();
+        for (const item of result.items) {
+            if (isFunctionCall(item) && !this.announcedToolCalls.has(item.callId)) {
+                this.emitToolCall(item.callId, item.name, item.arguments);
+            }
+        }
+        if (!this.completed) {
+            this.start();
+            this.sdk('response.completed', {
+                stopReason: result.stopReason,
+            });
+            this.completed = true;
+        }
+    }
+    /**
+     * Close a turn that failed. The bracket a consumer waits on must be honoured
+     * even when the turn dies mid-stream, so an open message is closed and the
+     * response completes with an error rather than the stream simply stopping.
+     */
+    abort(cause) {
+        if (!this.broadcaster || this.completed) {
+            return;
+        }
+        this.closeMessage();
+        this.start();
+        this.sdk('response.completed', {
+            stopReason: 'error',
+            error: cause instanceof Error ? cause.message : String(cause),
+        });
+        this.completed = true;
+    }
+    //#region internals
+    /**
+     * Emit one framework event under this step's envelope. The `sdk` sibling
+     * below does the same job for the model-stream surface; both gate on
+     * `emitOption` so `emit: false` silences every surface at once.
+     */
+    framework(eventType, payload) {
+        if (!this.broadcaster) {
+            return;
+        }
+        const data = {
+            stepId: this.stepId,
+            agentId: this.agentId,
+            ...payload,
+        };
+        if (!shouldEmit(this.emitOption, eventType, data)) {
+            return;
+        }
+        emitFrameworkEvent({
+            broadcaster: this.broadcaster,
+            agentName: this.agentName,
+            eventType,
+            data,
+        });
+    }
+    sdk(type, data, outputIndex) {
+        if (!this.broadcaster) {
+            return;
+        }
+        if (!shouldEmit(this.emitOption, type, data)) {
+            return;
+        }
+        this.broadcaster.emit({
+            source: 'sdk',
+            type,
+            data,
+            outputIndex,
+        });
+    }
+    start() {
+        if (this.started) {
+            return;
+        }
+        this.started = true;
+        this.sdk('response.created', {});
+    }
+    openMessage() {
+        if (this.messageOutputIndex !== null) {
+            return;
+        }
+        this.start();
+        const id = `acp-msg-${crypto.randomUUID()}`;
+        this.messageOutputIndex = this.nextOutputIndex++;
+        this.sdk('response.output_item.added', {
+            item: {
+                id,
+                type: 'message',
+                role: 'assistant',
+                status: 'in_progress',
+                content: [
+                    {
+                        type: 'output_text',
+                        text: '',
+                    },
+                ],
+            },
+        }, this.messageOutputIndex);
+    }
+    closeMessage() {
+        if (this.messageOutputIndex === null) {
+            return;
+        }
+        const index = this.messageOutputIndex;
+        this.sdk('response.output_text.done', {}, index);
+        this.sdk('response.output_item.done', {}, index);
+        this.messageOutputIndex = null;
+    }
+    emitToolCall(toolCallId, name, input) {
+        this.start();
+        const index = this.nextOutputIndex++;
+        const args = typeof input === 'string' ? input : JSON.stringify(input ?? {});
+        this.sdk('response.output_item.added', {
+            item: {
+                id: toolCallId,
+                type: 'function_call',
+                status: 'in_progress',
+                callId: toolCallId,
+                name,
+                arguments: '',
+            },
+        }, index);
+        this.sdk('response.function_call_arguments.delta', {
+            delta: args,
+        }, index);
+        this.sdk('response.function_call_arguments.done', {
+            arguments: args,
+        }, index);
+        this.sdk('response.output_item.done', {}, index);
+        this.announcedToolCalls.add(toolCallId);
+    }
+    translate(update) {
+        if (update.sessionUpdate === 'agent_message_chunk') {
+            this.openMessage();
+            this.sdk('response.output_text.delta', {
+                delta: blockText(update.content),
+            }, this.messageOutputIndex ?? 0);
+            this.sawText = true;
+            return;
+        }
+        if (update.sessionUpdate === 'agent_thought_chunk') {
+            this.start();
+            this.sdk('response.reasoning.delta', {
+                delta: blockText(update.content),
+            });
+            return;
+        }
+        if (update.sessionUpdate === 'tool_call') {
+            this.closeMessage();
+            this.emitToolCall(update.toolCallId, update.title, update.rawInput);
+            return;
+        }
+        // `user_message_chunk` (replayed history), `tool_call_update`, `plan`,
+        // `available_commands_update`, and `current_mode_update` have no model-stream
+        // analogue; they surface on the full stream under their protocol names.
+        this.sdk(`acp.${update.sessionUpdate}`, {
+            update,
+        });
+    }
+}

package/dist/interpreter/acp-history.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Gives an ACP agent the prior conversation.
+ *
+ * ACP sessions own their own history on the agent side, but a freshly opened
+ * session knows nothing about the Noetic steps that ran before it. Seeding the
+ * first prompt with a transcript of the conversation so far means a coding agent
+ * running after a chain of `callModel` steps understands what was already
+ * established instead of answering out of context.
+ */
+import type { Item } from '@noetic-tools/types';
+/** @public Render conversation history as a plain-text transcript. */
+export declare function formatConversation(items: ReadonlyArray<Item>): string;
+/**
+ * Fold the conversation so far into a turn's prompt. Returns the prompt
+ * unchanged when there is no history, so the very first step of a run is not
+ * padded with an empty preamble.
+ * @public
+ */
+export declare function withHistoryPrompt(input: {
+    prompt: string;
+    history: ReadonlyArray<Item>;
+}): string;

package/dist/interpreter/acp-history.js

@@ -0,0 +1,58 @@
+/**
+ * Gives an ACP agent the prior conversation.
+ *
+ * ACP sessions own their own history on the agent side, but a freshly opened
+ * session knows nothing about the Noetic steps that ran before it. Seeding the
+ * first prompt with a transcript of the conversation so far means a coding agent
+ * running after a chain of `callModel` steps understands what was already
+ * established instead of answering out of context.
+ */
+function roleLabel(role) {
+    if (role === 'assistant') {
+        return 'Assistant';
+    }
+    if (role === 'user') {
+        return 'User';
+    }
+    return 'System';
+}
+function messageText(item) {
+    if (item.type !== 'message') {
+        return null;
+    }
+    const text = item.content
+        .map((part) => ('text' in part && typeof part.text === 'string' ? part.text : ''))
+        .join('');
+    return text.length > 0 ? `${roleLabel(item.role)}: ${text}` : null;
+}
+/** @public Render conversation history as a plain-text transcript. */
+export function formatConversation(items) {
+    const lines = [];
+    for (const item of items) {
+        const line = messageText(item);
+        if (line) {
+            lines.push(line);
+            continue;
+        }
+        if (item.type === 'function_call') {
+            lines.push(`Assistant called ${item.name}(${item.arguments})`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Fold the conversation so far into a turn's prompt. Returns the prompt
+ * unchanged when there is no history, so the very first step of a run is not
+ * padded with an empty preamble.
+ * @public
+ */
+export function withHistoryPrompt(input) {
+    if (input.history.length === 0) {
+        return input.prompt;
+    }
+    const transcript = formatConversation(input.history);
+    if (transcript.length === 0) {
+        return input.prompt;
+    }
+    return `Conversation so far:\n${transcript}\n\nCurrent request:\n${input.prompt}`;
+}

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

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