@noetic-tools/core 5.3.0 → 5.4.1

package/dist/builders/every.d.ts

@@ -1,44 +1,44 @@
 import type { ContextData } from '@noetic-tools/context';
-import type { Channel, EveryErrorPolicy, Step, StepEvery } from '@noetic-tools/types';
+import type { Channel, ScheduleErrorPolicy, Step, StepSchedule } from '@noetic-tools/types';
 /**
- * Configuration options accepted by the `every()` builder, excluding the `kind`
- * discriminant. `every()` schedules a body step on a fixed-interval, optionally
+ * Configuration options accepted by the `schedule()` builder, excluding the `kind`
+ * discriminant. `schedule()` schedules a body step on a fixed-interval, optionally
  * woken early by a channel, and runs until the executing context is cancelled.
  *
  * @public
  */
-export interface EveryOptions<TContext = ContextData, I = unknown, O = unknown> {
+export interface ScheduleOptions<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<TContext, I, O>;
     /** Park duration between iterations in milliseconds. Must be >= 0. */
-    ms: number;
+    interval: number;
     /** Optional channel that wakes the parking interval when any value arrives. */
-    wakeOn?: Channel<unknown>;
+    inbox?: Channel<unknown>;
     /** Behavior when `step` throws. Defaults to `'continue'`. */
-    onError?: EveryErrorPolicy;
+    onError?: ScheduleErrorPolicy;
     /** Random jitter applied to the park duration in milliseconds. Must be >= 0. Default 0. */
     jitter?: number;
 }
 /**
- * Creates an `every` step that runs a body step on a fixed-interval schedule.
+ * Creates a `schedule` step that runs a body step on a fixed-interval schedule.
  *
  * The operator runs forever until the executing context is cancelled. After each
- * iteration it parks for `ms ± jitter` milliseconds (or until `wakeOn` receives
+ * iteration it parks for `interval ± jitter` milliseconds (or until `inbox` receives
  * a message, whichever comes first).
  *
  * @public
  * @param opts.id - Unique step identifier used in traces and error messages.
  * @param opts.step - Body step executed on each iteration.
- * @param opts.ms - Park duration between iterations in milliseconds.
- * @param opts.wakeOn - Optional channel that wakes the parking interval when any value arrives.
+ * @param opts.interval - Park duration between iterations in milliseconds.
+ * @param opts.inbox - Optional channel that wakes the parking interval when any value arrives.
  * @param opts.onError - Error policy. `'continue'` (default) records a span event and continues; `'fail'` re-throws.
  * @param opts.jitter - Random jitter in ms applied to the park duration. Default 0.
- * @returns A `StepEvery` step.
+ * @returns A `StepSchedule` step.
  * @throws `NoeticConfigError` with code `EMPTY_STEP_ID` if `id` is empty.
  * @throws `NoeticConfigError` with code `MISSING_BODY_STEP` if `step` is not provided.
- * @throws `NoeticConfigError` with code `INVALID_INTERVAL_MS` if `ms` is negative or not finite.
+ * @throws `NoeticConfigError` with code `INVALID_INTERVAL_MS` if `interval` is negative or not finite.
  * @throws `NoeticConfigError` with code `INVALID_JITTER` if `jitter` is negative or not finite.
  */
-export declare function every<TContext = ContextData, I = unknown, O = unknown>(opts: EveryOptions<TContext, I, O>): StepEvery<TContext, I, O>;
+export declare function schedule<TContext = ContextData, I = unknown, O = unknown>(opts: ScheduleOptions<TContext, I, O>): StepSchedule<TContext, I, O>;

package/dist/builders/every.js

@@ -1,60 +1,60 @@
 import { NoeticConfigError } from '@noetic-tools/types';
 import { getDefaultRegistrar } from '../types/step-registrar.js';
 /**
- * Creates an `every` step that runs a body step on a fixed-interval schedule.
+ * Creates a `schedule` step that runs a body step on a fixed-interval schedule.
  *
  * The operator runs forever until the executing context is cancelled. After each
- * iteration it parks for `ms ± jitter` milliseconds (or until `wakeOn` receives
+ * iteration it parks for `interval ± jitter` milliseconds (or until `inbox` receives
  * a message, whichever comes first).
  *
  * @public
  * @param opts.id - Unique step identifier used in traces and error messages.
  * @param opts.step - Body step executed on each iteration.
- * @param opts.ms - Park duration between iterations in milliseconds.
- * @param opts.wakeOn - Optional channel that wakes the parking interval when any value arrives.
+ * @param opts.interval - Park duration between iterations in milliseconds.
+ * @param opts.inbox - Optional channel that wakes the parking interval when any value arrives.
  * @param opts.onError - Error policy. `'continue'` (default) records a span event and continues; `'fail'` re-throws.
  * @param opts.jitter - Random jitter in ms applied to the park duration. Default 0.
- * @returns A `StepEvery` step.
+ * @returns A `StepSchedule` step.
  * @throws `NoeticConfigError` with code `EMPTY_STEP_ID` if `id` is empty.
  * @throws `NoeticConfigError` with code `MISSING_BODY_STEP` if `step` is not provided.
- * @throws `NoeticConfigError` with code `INVALID_INTERVAL_MS` if `ms` is negative or not finite.
+ * @throws `NoeticConfigError` with code `INVALID_INTERVAL_MS` if `interval` is negative or not finite.
  * @throws `NoeticConfigError` with code `INVALID_JITTER` if `jitter` is negative or not finite.
  */
-export function every(opts) {
+export function schedule(opts) {
     if (!opts.id || opts.id.trim() === '') {
         throw new NoeticConfigError({
             code: 'EMPTY_STEP_ID',
-            message: 'every() requires a non-empty id.',
-            hint: 'Pass a unique string as the id field, e.g. every({ id: "my-every", ... }).',
+            message: 'schedule() requires a non-empty id.',
+            hint: 'Pass a unique string as the id field, e.g. schedule({ id: "my-schedule", ... }).',
         });
     }
     if (!opts.step) {
         throw new NoeticConfigError({
             code: 'MISSING_BODY_STEP',
-            message: 'every() requires a body step.',
+            message: 'schedule() requires a body step.',
             hint: 'Provide the step to execute on each scheduled iteration.',
         });
     }
-    if (!Number.isFinite(opts.ms) || opts.ms < 0) {
+    if (!Number.isFinite(opts.interval) || opts.interval < 0) {
         throw new NoeticConfigError({
             code: 'INVALID_INTERVAL_MS',
-            message: `every() requires a non-negative finite ms, got ${opts.ms}.`,
+            message: `schedule() requires a non-negative finite interval, got ${opts.interval}.`,
             hint: 'Pass a non-negative number of milliseconds for the park interval.',
         });
     }
     if (opts.jitter !== undefined && (!Number.isFinite(opts.jitter) || opts.jitter < 0)) {
         throw new NoeticConfigError({
             code: 'INVALID_JITTER',
-            message: `every() requires a non-negative finite jitter, got ${opts.jitter}.`,
+            message: `schedule() requires a non-negative finite jitter, got ${opts.jitter}.`,
             hint: 'Pass a non-negative number of milliseconds for jitter, or omit it.',
         });
     }
     const built = {
-        kind: 'every',
+        kind: 'schedule',
         id: opts.id,
         step: opts.step,
-        ms: opts.ms,
-        wakeOn: opts.wakeOn,
+        interval: opts.interval,
+        inbox: opts.inbox,
         onError: opts.onError ?? 'continue',
         jitter: opts.jitter ?? 0,
     };

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

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

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

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

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

@@ -1,5 +1,5 @@
 import type { ContextConfig, ContextData, ContextLayer } from '@noetic-tools/context';
-import type { Step, StepProvide } from '@noetic-tools/types';
+import type { Step, StepWithContext } from '@noetic-tools/types';
 /**
  * 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.
@@ -9,19 +9,12 @@ import type { Step, StepProvide } from '@noetic-tools/types';
  * @param opts.id - Unique step identifier used in traces and error messages.
  * @param opts.child - Step to execute with the provided layers.
  * @param opts.context - Context layers to provide to descendant steps.
- * @returns A `StepProvide` step.
+ * @returns A `StepWithContext` 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<TContext = ContextData, I = unknown, O = unknown>(opts: {
+export declare function withContext<TContext = ContextData, I = unknown, O = unknown>(opts: {
     id: string;
     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>;
+    context: ContextConfig | ContextLayer[];
+}): StepWithContext<TContext, I, O>;

package/dist/builders/provide-builder.js

@@ -1,6 +1,5 @@
 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 context layers to its child without creating an isolated context.
  * Like React's Context.Provider — layers are available to all descendant steps.
@@ -10,35 +9,35 @@ import { resolveContextOption } from './context-option.js';
  * @param opts.id - Unique step identifier used in traces and error messages.
  * @param opts.child - Step to execute with the provided layers.
  * @param opts.context - Context layers to provide to descendant steps.
- * @returns A `StepProvide` step.
+ * @returns A `StepWithContext` 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 function provide(opts) {
+export function withContext(opts) {
     if (!opts.id?.trim()) {
         throw new NoeticConfigError({
             code: 'EMPTY_STEP_ID',
-            message: 'provide() requires a non-empty id.',
-            hint: 'Pass a unique string as the id field, e.g. provide({ id: "my-provider", ... }).',
+            message: 'withContext() requires a non-empty id.',
+            hint: 'Pass a unique string as the id field, e.g. withContext({ id: "my-provider", ... }).',
         });
     }
     if (!opts.child) {
         throw new NoeticConfigError({
             code: 'MISSING_CHILD_STEP',
-            message: 'provide() requires a child step.',
+            message: 'withContext() requires a child step.',
             hint: 'Provide a child step to execute with the provided context layers.',
         });
     }
-    const layers = resolveContextOption(opts);
+    const layers = opts.context;
     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`.',
+            message: 'withContext() requires context layers.',
+            hint: 'Pass context: [scratchpad()].',
         });
     }
     const built = {
-        kind: 'provide',
+        kind: 'withContext',
         id: opts.id,
         child: opts.child,
         context: layers,

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

@@ -4,8 +4,6 @@ interface SpawnOpts<TContext, I, O> {
     id: string;
     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

package/dist/builders/spawn-builder.js

@@ -1,6 +1,5 @@
 import { NoeticConfigError } from '@noetic-tools/types';
 import { getDefaultRegistrar } from '../types/step-registrar.js';
-import { resolveContextOption } from './context-option.js';
 //#endregion
 //#region Public API
 /**
@@ -38,12 +37,12 @@ export function spawn(opts) {
         kind: 'spawn',
         id: opts.id,
         child: opts.child,
-        context: resolveContextOption(opts),
+        context: opts.context,
         timeout: opts.timeout,
         subprocess: opts.subprocess,
     };
     getDefaultRegistrar().register(built);
-    // Ensure the child is addressable by id — builders for `run`/`llm`/`tool`
+    // Ensure the child is addressable by id — builders for `runCode`/`callModel`/`invokeTool`
     // self-register, but a caller can construct a step literal and pass it as
     // `child` without going through a builder.
     getDefaultRegistrar().register(opts.child);

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

@@ -1,7 +1,6 @@
 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';
-export interface StepRunOpts<TContext, I, O> {
+import type { AcpAgent, AcpClientCapabilityConfig, AcpContentBlock, AcpMcpServer, AcpPermissionHandler, AcpPermissionPolicy, AcpSessionPolicy, Context, Lazy, ModelParams, OutputCodec, RetryPolicy, ServerToolSpec, StandardSchemaV1, StepAcpAgent, StepCallModel, StepInvokeTool, StepRunCode, SubprocessAdapter, Tool } from '@noetic-tools/types';
+export interface RunCodeOpts<TContext, I, O> {
     id: string;
     execute: (input: I, ctx: Context<TContext>) => Promise<O>;
     retry?: RetryPolicy;
@@ -12,7 +11,7 @@ export interface StepRunOpts<TContext, I, O> {
      */
     subprocess?: SubprocessAdapter;
 }
-export interface StepLLMOpts<TContext, O> {
+export interface CallModelOpts<TContext, O> {
     id: string;
     /** Model id. Eager string or `(ctx) => string` getter (resolved at step execution). */
     model: Lazy<string, TContext>;
@@ -24,110 +23,122 @@ export interface StepLLMOpts<TContext, O> {
      * server tool the provider executes, e.g. web search/fetch).
      */
     tools?: Lazy<(Tool | ServerToolSpec)[] | undefined, TContext>;
-    /** Structured output: a Zod schema or a streaming `OutputCodec` (e.g. OpenUI Lang). */
-    output?: ZodType<O> | OutputCodec<O>;
+    /** Structured output: a Standard Schema (Zod, Valibot, …) or a streaming `OutputCodec` (e.g. OpenUI Lang). */
+    output?: StandardSchemaV1<unknown, O> | OutputCodec<O>;
+    /**
+     * Explicit raw JSON Schema override sent to the model. For non-Zod schemas,
+     * it takes precedence over StandardJSONSchemaV1 conversion.
+     */
+    outputJsonSchema?: Record<string, unknown>;
     params?: ModelParams;
     emit?: boolean | ((eventType: string, data: Record<string, unknown>) => boolean);
 }
-export interface StepToolOpts<I, O> {
+export interface InvokeToolOpts<I, O> {
     id: string;
-    tool: Tool<ZodType<I>, ZodType<O>>;
+    tool: Tool<StandardSchemaV1<unknown, I>, StandardSchemaV1<unknown, O>>;
     args?: Partial<I>;
 }
-export interface StepSubHarnessOpts<TContext, O> {
+export interface StepAcpAgentOpts<TContext, O> {
     id: string;
-    /** The harness adapter created by a `@noetic-tools/sub-harness-*` factory. Eager or `(ctx) => SubHarness`. */
-    harness: Lazy<SubHarness, TContext>;
-    /** Turn prompt. Eager string or `(ctx) => string` getter. */
-    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, TContext>;
-    /** Optional Zod schema; when set the assistant text is JSON-parsed and validated. */
-    output?: ZodType<O>;
+    /** An ACP agent adapter, e.g. `claudeCode()` from `@noetic-tools/acp`. Eager or `(ctx) => AcpAgent`. */
+    agent: Lazy<AcpAgent, TContext>;
+    /** Turn prompt as plain text. Eager string or `(ctx) => string` getter. */
+    prompt?: Lazy<string, TContext>;
+    /**
+     * Full ACP prompt content — images, audio, resource links, embedded context.
+     * Appended after `prompt`. Rejected before the turn is sent when the agent
+     * did not advertise the matching prompt capability.
+     */
+    content?: Lazy<ReadonlyArray<AcpContentBlock> | undefined, TContext>;
+    /** MCP servers to expose to the agent for this session. */
+    mcpServers?: Lazy<ReadonlyArray<AcpMcpServer> | undefined, TContext>;
+    /** Working directory for the session. Defaults to `ctx.cwdState.cwd`. */
+    cwd?: Lazy<string | undefined, TContext>;
+    /** Session mode to switch to before prompting (e.g. `'plan'`). */
+    mode?: Lazy<string | undefined, TContext>;
+    /** Model to select before prompting, for agents that expose model selection. */
+    model?: Lazy<string | undefined, TContext>;
+    /** Declarative answer to the agent's permission requests. Defaults to denying. */
+    permissions?: AcpPermissionPolicy;
+    /** Async resolver consulted when the policy and steering both abstain. */
+    onPermissionRequest?: AcpPermissionHandler;
+    /** Which client capabilities to advertise to the agent. */
+    clientCapabilities?: AcpClientCapabilityConfig;
+    /** Optional Standard Schema; when set the assistant text is JSON-parsed and validated. */
+    output?: StandardSchemaV1<unknown, O>;
     /** Session reuse + teardown policy across steps. */
-    session?: SubHarnessSessionPolicy;
+    session?: AcpSessionPolicy;
     emit?: boolean | ((eventType: string, data: Record<string, unknown>) => boolean);
 }
+/**
+ * Creates a pure async computation step.
+ *
+ * @public
+ * @param opts.id - Unique step identifier used in traces and error messages.
+ * @param opts.execute - Async function `(input, ctx) => output` that performs the work.
+ * @param opts.retry - Optional retry policy controlling attempts, backoff, and delay.
+ * @param opts.subprocess - Optional per-step subprocess adapter override.
+ * @returns A `StepRunCode` that can be composed into larger pipelines. The step
+ *   is auto-registered in the shared step registry so the subprocess
+ *   adapter can dispatch it by id.
+ * @throws `NoeticConfigError` with code `EMPTY_STEP_ID` if `id` is empty.
+ * @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.
+ */
+export declare function runCode<TContext = ContextData, I = unknown, O = unknown>(opts: RunCodeOpts<TContext, I, O>): StepRunCode<TContext, I, O>;
+/**
+ * Creates a model call step with optional tools and structured output.
+ *
+ * @public
+ * @param opts.id - Unique step identifier used in traces and error messages.
+ * @param opts.model - Model identifier, eager string or `(ctx) => string` getter (resolved at step execution time).
+ * @param opts.instructions - Optional system prompt; eager string or `(ctx) => string | undefined` getter.
+ * @param opts.tools - Optional tools; eager array or `(ctx) => Tool[] | undefined` getter.
+ * @param opts.output - Optional Zod schema enabling structured output parsing.
+ * @param opts.params - Optional model parameters (temperature, topP, maxTokens, stopSequences).
+ * @returns A `StepCallModel` that can be composed into larger pipelines. The step
+ *   is auto-registered in the shared step registry.
+ * @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.
+ */
+export declare function callModel<TContext = ContextData, I = unknown, O = unknown>(opts: CallModelOpts<TContext, O>): StepCallModel<TContext, I, O>;
+/**
+ * Creates a tool execution step that invokes a typed tool definition.
+ *
+ * @public
+ * @param opts.id - Unique step identifier used in traces and error messages.
+ * @param opts.tool - The tool definition with typed input/output schemas.
+ * @param opts.args - Optional partial args that override or supplement model-provided arguments.
+ * @returns A `StepInvokeTool` that can be composed into larger pipelines. The step
+ *   is auto-registered in the shared step registry.
+ * @throws `NoeticConfigError` with code `EMPTY_STEP_ID` if `id` is empty.
+ * @throws `NoeticConfigError` with code `MISSING_TOOL` if `tool` is not provided.
+ */
+export declare function invokeTool<TContext = ContextData, I = unknown, O = unknown>(opts: InvokeToolOpts<I, O>): StepInvokeTool<TContext, I, O>;
+/**
+ * The ACP step builder namespace. Unlike the flattened base builders
+ * (`runCode`, `callModel`, `invokeTool`), the coding-agent builder stays
+ * grouped under `step`.
+ *
+ * @public
+ */
 export declare const step: {
     /**
-     * Creates a pure async computation step.
+     * Creates a step that delegates a turn to an external coding agent over the
+     * Agent Client Protocol.
      *
-     * @public
-     * @param opts.id - Unique step identifier used in traces and error messages.
-     * @param opts.execute - Async function `(input, ctx) => output` that performs the work.
-     * @param opts.retry - Optional retry policy controlling attempts, backoff, and delay.
-     * @param opts.subprocess - Optional per-step subprocess adapter override.
-     * @returns A `StepRun` that can be composed into larger pipelines. The step
-     *   is auto-registered in the shared step registry so the subprocess
-     *   adapter can dispatch it by id.
-     * @throws `NoeticConfigError` with code `EMPTY_STEP_ID` if `id` is empty.
-     * @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<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.
-     *
-     * @public
-     * @param opts.id - Unique step identifier used in traces and error messages.
-     * @param opts.model - Model identifier, eager string or `(ctx) => string` getter (resolved at step execution time).
-     * @param opts.instructions - Optional system prompt; eager string or `(ctx) => string | undefined` getter.
-     * @param opts.tools - Optional tools; eager array or `(ctx) => Tool[] | undefined` getter.
-     * @param opts.output - Optional Zod schema enabling structured output parsing.
-     * @param opts.params - Optional model parameters (temperature, topP, maxTokens, stopSequences).
-     * @returns A `StepLLM` that can be composed into larger pipelines. The step
-     *   is auto-registered in the shared step registry.
-     * @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<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.
-     *
-     * @public
-     * @param opts.id - Unique step identifier used in traces and error messages.
-     * @param opts.tool - The tool definition with typed input/output schemas.
-     * @param opts.args - Optional partial args that override or supplement LLM-provided arguments.
-     * @returns A `StepTool` that can be composed into larger pipelines. The step
-     *   is auto-registered in the shared step registry.
-     * @throws `NoeticConfigError` with code `EMPTY_STEP_ID` if `id` is empty.
-     * @throws `NoeticConfigError` with code `MISSING_TOOL` if `tool` is not provided.
-     */
-    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.
+     * One builder covers every ACP-speaking agent: the agent itself is supplied
+     * as an adapter, so adding an agent never changes this API or the published
+     * workflow schema.
      *
      * @public
      * @param opts.id - Unique step identifier.
-     * @param opts.harness - A `claudeCode(...)` adapter from `@noetic-tools/sub-harness-claude-code`.
+     * @param opts.agent - An agent adapter, e.g. `claudeCode()` from `@noetic-tools/acp`.
      * @param opts.prompt - The turn prompt; eager string or `(ctx) => string` getter.
-     * @param opts.settings - Shared harness settings (model, permission mode, …).
-     * @param opts.output - Optional Zod schema enabling structured output parsing.
-     * @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<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<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<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`.
+     * @param opts.permissions - Declarative policy answering the agent's permission requests.
+     * @param opts.output - Optional Standard Schema enabling structured output parsing.
+     * @returns A `StepAcpAgent`, auto-registered in the step registry.
+     * @throws `NoeticConfigError` `EMPTY_STEP_ID` / `MISSING_ACP_AGENT` / `MISSING_PROMPT`.
      */
-    pi<TContext = ContextData, I = unknown, O = unknown>(opts: StepSubHarnessOpts<TContext, O>): StepSubHarness<TContext, I, O>;
+    acpAgent<TContext = ContextData, I = unknown, O = unknown>(opts: StepAcpAgentOpts<TContext, O>): StepAcpAgent<TContext, I, O>;
 };