@noetic-tools/types 3.2.1 → 3.3.0

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export * from './errors/noetic-config-error.js';
 export * from './errors/noetic-error.js';
 export * from './schemas/item.js';
 export * from './schemas/workflow.js';
+export * from './types/acp.js';
 export * from './types/channel.js';
 export * from './types/common.js';
 export * from './types/context.js';
@@ -27,7 +28,6 @@ export * from './types/schema.js';
 export * from './types/shell-adapter.js';
 export * from './types/steering.js';
 export * from './types/step.js';
-export * from './types/sub-harness.js';
 export * from './types/subprocess-adapter.js';
 export * from './types/tool.js';
 export * from './types/tool-context.js';

package/dist/index.js

@@ -6,6 +6,7 @@ export * from './errors/noetic-config-error.js';
 export * from './errors/noetic-error.js';
 export * from './schemas/item.js';
 export * from './schemas/workflow.js';
+export * from './types/acp.js';
 export * from './types/channel.js';
 export * from './types/common.js';
 export * from './types/context.js';
@@ -27,7 +28,6 @@ export * from './types/schema.js';
 export * from './types/shell-adapter.js';
 export * from './types/steering.js';
 export * from './types/step.js';
-export * from './types/sub-harness.js';
 export * from './types/subprocess-adapter.js';
 export * from './types/tool.js';
 export * from './types/tool-context.js';

package/dist/schemas/workflow.d.ts

@@ -9,7 +9,6 @@
  * document back into live `Step` objects via the existing builders.
  */
 import { z } from 'zod';
-import type { SubHarnessKind } from '../types/sub-harness.js';
 interface UntilAnyPredicate {
     kind: 'any';
     predicates: UntilPredicate[];
@@ -93,25 +92,83 @@ declare const RetryPolicySchema: z.ZodObject<{
     initialDelay: z.ZodNumber;
     maxDelay: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
-declare const HarnessSettingsSchema: z.ZodObject<{
-    model: z.ZodOptional<z.ZodString>;
-    permissionMode: z.ZodOptional<z.ZodEnum<{
-        acceptEdits: "acceptEdits";
-        bypassPermissions: "bypassPermissions";
-        default: "default";
-        plan: "plan";
+declare const AcpPermissionPolicySchema: z.ZodObject<{
+    default: z.ZodOptional<z.ZodEnum<{
+        allow: "allow";
+        cancel: "cancel";
+        deny: "deny";
     }>>;
-    maxTurns: z.ZodOptional<z.ZodNumber>;
-    allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    allow: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodOptional<z.ZodEnum<{
+            delete: "delete";
+            edit: "edit";
+            execute: "execute";
+            fetch: "fetch";
+            move: "move";
+            other: "other";
+            read: "read";
+            search: "search";
+            switch_mode: "switch_mode";
+            think: "think";
+        }>>;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    deny: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodOptional<z.ZodEnum<{
+            delete: "delete";
+            edit: "edit";
+            execute: "execute";
+            fetch: "fetch";
+            move: "move";
+            other: "other";
+            read: "read";
+            search: "search";
+            switch_mode: "switch_mode";
+            think: "think";
+        }>>;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    persist: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
-declare const HarnessSessionPolicySchema: z.ZodObject<{
+declare const AcpClientCapabilityConfigSchema: z.ZodObject<{
+    readTextFile: z.ZodOptional<z.ZodBoolean>;
+    writeTextFile: z.ZodOptional<z.ZodBoolean>;
+    terminal: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/** ACP `McpServer`. Stdio is untagged and mandatory for every agent; http/sse are capability-gated. */
+declare const AcpMcpServerSchema: z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodLiteral<"http">;
+    name: z.ZodString;
+    url: z.ZodString;
+    headers: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"sse">;
+    name: z.ZodString;
+    url: z.ZodString;
+    headers: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    name: z.ZodString;
+    command: z.ZodString;
+    args: z.ZodArray<z.ZodString>;
+    env: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>]>;
+declare const AcpSessionPolicySchema: z.ZodObject<{
     reuse: z.ZodOptional<z.ZodString>;
-    onComplete: z.ZodOptional<z.ZodEnum<{
-        destroy: "destroy";
-        detach: "detach";
-        stop: "stop";
+    keepAlive: z.ZodOptional<z.ZodEnum<{
+        harness: "harness";
+        run: "run";
+        step: "step";
     }>>;
+    load: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 interface WorkflowNodeBase {
     id: string;
@@ -120,7 +177,7 @@ interface WorkflowNodeBase {
  * A reference to a streaming `OutputCodec` for a `callModel` node's structured
  * output. The hydrator resolves `library` from `HydrationContext.uiLibraries`
  * to a live codec (e.g. `openUi(myLibrary)` from `@noetic-tools/openui`), the
- * same registry-resolution pattern sub-harness nodes use for adapters. Kept a
+ * same registry-resolution pattern `acp-agent` nodes use for adapters. Kept a
  * *reference* because a codec is a runtime object, not JSON-expressible.
  */
 export interface OutputCodecRef {
@@ -233,16 +290,26 @@ export interface ScheduleWorkflowNode extends WorkflowNodeBase {
     onError?: 'continue' | 'fail';
 }
 /**
- * A node that delegates a turn to a coding-agent harness. `kind` is the harness
- * id (e.g. `claude-code`); the hydrator resolves the matching adapter from the
- * workflow's harness registry.
+ * A node that delegates a turn to an external coding agent over the Agent
+ * Client Protocol. `agent` is a registry key resolved from
+ * `HydrationContext.acpAgents` — an OPEN set, so supporting a new agent never
+ * changes this schema.
  */
-export interface SubHarnessWorkflowNode extends WorkflowNodeBase {
-    kind: SubHarnessKind;
+export interface AcpAgentWorkflowNode extends WorkflowNodeBase {
+    kind: 'acp-agent';
+    /** Registry key for the ACP agent adapter (e.g. `claude-code`). */
+    agent: string;
     prompt: string;
-    instructions?: string;
-    settings?: z.infer<typeof HarnessSettingsSchema>;
-    session?: z.infer<typeof HarnessSessionPolicySchema>;
+    /** Absolute working directory for the session. Defaults to the runtime cwd. */
+    cwd?: string;
+    /** Session mode to switch to before prompting. */
+    mode?: string;
+    /** Model to select before prompting. */
+    model?: string;
+    mcpServers?: z.infer<typeof AcpMcpServerSchema>[];
+    permissions?: z.infer<typeof AcpPermissionPolicySchema>;
+    clientCapabilities?: z.infer<typeof AcpClientCapabilityConfigSchema>;
+    session?: z.infer<typeof AcpSessionPolicySchema>;
 }
 /**
  * A node that runs another workflow document as a sub-step. The document is
@@ -259,7 +326,7 @@ export interface SubflowWorkflowNode extends WorkflowNodeBase {
     input?: string;
 }
 /** @public Discriminated union of all JSON-serialisable workflow node kinds. */
-export type WorkflowNode = CallModelWorkflowNode | InvokeToolWorkflowNode | RunCodeWorkflowNode | ConditionalWorkflowNode | InParallelWorkflowNode | SpawnWorkflowNode | WithContextWorkflowNode | LoopWorkflowNode | SequenceWorkflowNode | ScheduleWorkflowNode | SubflowWorkflowNode | SubHarnessWorkflowNode;
+export type WorkflowNode = CallModelWorkflowNode | InvokeToolWorkflowNode | RunCodeWorkflowNode | ConditionalWorkflowNode | InParallelWorkflowNode | SpawnWorkflowNode | WithContextWorkflowNode | LoopWorkflowNode | SequenceWorkflowNode | ScheduleWorkflowNode | SubflowWorkflowNode | AcpAgentWorkflowNode;
 /** @public Zod schema validating a single `WorkflowNode` (any JSON-safe kind). */
 export declare const WorkflowNodeSchema: z.ZodType<WorkflowNode>;
 /** @public Top-level envelope for a JSON workflow definition. */

package/dist/schemas/workflow.js

@@ -124,30 +124,84 @@ const RetryPolicySchema = z.object({
     maxDelay: z.number().nonnegative().optional(),
 });
 //#endregion
-//#region SubHarness Settings
-const HarnessSettingsSchema = z.object({
-    model: z.string().optional(),
-    permissionMode: z
-        .enum([
-        'default',
-        'plan',
-        'acceptEdits',
-        'bypassPermissions',
-    ])
-        .optional(),
-    maxTurns: z.number().int().positive().optional(),
-    allowedTools: z.array(z.string()).optional(),
-    extra: z.record(z.string(), z.unknown()).optional(),
+//#region ACP Agent Settings
+/** ACP `ToolKind` — the agent's own classification of a tool call. */
+const AcpToolKindSchema = z.enum([
+    'read',
+    'edit',
+    'delete',
+    'move',
+    'search',
+    'execute',
+    'think',
+    'fetch',
+    'switch_mode',
+    'other',
+]);
+const AcpPermissionDecisionSchema = z.enum([
+    'allow',
+    'deny',
+    'cancel',
+]);
+/**
+ * A permission rule. Both fields are optional matchers; an omitted field
+ * matches anything. `title` is a case-insensitive substring match here — the
+ * programmatic API additionally accepts a `RegExp`, which JSON cannot express.
+ */
+const AcpPermissionRuleSchema = z.object({
+    kind: AcpToolKindSchema.optional(),
+    title: z.string().min(1).optional(),
 });
-const HarnessSessionPolicySchema = z.object({
+const AcpPermissionPolicySchema = z.object({
+    default: AcpPermissionDecisionSchema.optional(),
+    allow: z.array(AcpPermissionRuleSchema).optional(),
+    deny: z.array(AcpPermissionRuleSchema).optional(),
+    persist: z.boolean().optional(),
+});
+const AcpClientCapabilityConfigSchema = z.object({
+    readTextFile: z.boolean().optional(),
+    writeTextFile: z.boolean().optional(),
+    terminal: z.boolean().optional(),
+});
+const AcpNamedValueSchema = z.object({
+    name: z.string(),
+    value: z.string(),
+});
+/** ACP `McpServer`. Stdio is untagged and mandatory for every agent; http/sse are capability-gated. */
+const AcpMcpServerSchema = z.union([
+    z.object({
+        type: z.literal('http'),
+        name: z.string().min(1),
+        url: z.string(),
+        headers: z.array(AcpNamedValueSchema),
+    }),
+    z.object({
+        type: z.literal('sse'),
+        name: z.string().min(1),
+        url: z.string(),
+        headers: z.array(AcpNamedValueSchema),
+    }),
+    z.object({
+        name: z.string().min(1),
+        command: z.string().min(1),
+        args: z.array(z.string()),
+        env: z.array(AcpNamedValueSchema),
+    }),
+]);
+const AcpSessionPolicySchema = z.object({
     reuse: z.string().min(1).optional(),
-    onComplete: z
+    /**
+     * How long the connection is kept alive. Defaults to `step`; `run` and
+     * `harness` are explicit opt-ins because a connection owns a live agent.
+     */
+    keepAlive: z
         .enum([
-        'stop',
-        'detach',
-        'destroy',
+        'step',
+        'run',
+        'harness',
     ])
         .optional(),
+    load: z.string().min(1).optional(),
 });
 //#endregion
 //#region Workflow Node Schema
@@ -258,21 +312,19 @@ const SubflowNodeSchema = z
     .refine((node) => (node.document === undefined) !== (node.ref === undefined), {
     message: "subflow node requires exactly one of 'document' (inline) or 'ref' (named).",
 });
-/** Builds the schema for a single harness node kind (`claude-code`, `codex`, …). */
-function subHarnessNodeSchema(kind) {
-    return z.object({
-        kind: z.literal(kind),
-        ...SHARED_FIELDS,
-        prompt: z.string().min(1),
-        instructions: z.string().optional(),
-        settings: HarnessSettingsSchema.optional(),
-        session: HarnessSessionPolicySchema.optional(),
-    });
-}
-const ClaudeCodeNodeSchema = subHarnessNodeSchema('claude-code');
-const CodexNodeSchema = subHarnessNodeSchema('codex');
-const OpencodeNodeSchema = subHarnessNodeSchema('opencode');
-const PiNodeSchema = subHarnessNodeSchema('pi');
+const AcpAgentNodeSchema = z.object({
+    kind: z.literal('acp-agent'),
+    ...SHARED_FIELDS,
+    agent: z.string().min(1),
+    prompt: z.string().min(1),
+    cwd: z.string().min(1).optional(),
+    mode: z.string().min(1).optional(),
+    model: z.string().min(1).optional(),
+    mcpServers: z.array(AcpMcpServerSchema).optional(),
+    permissions: AcpPermissionPolicySchema.optional(),
+    clientCapabilities: AcpClientCapabilityConfigSchema.optional(),
+    session: AcpSessionPolicySchema.optional(),
+});
 /** @public Zod schema validating a single `WorkflowNode` (any JSON-safe kind). */
 export const WorkflowNodeSchema = z
     .discriminatedUnion('kind', [
@@ -287,10 +339,7 @@ export const WorkflowNodeSchema = z
     SequenceNodeSchema,
     ScheduleNodeSchema,
     SubflowNodeSchema,
-    ClaudeCodeNodeSchema,
-    CodexNodeSchema,
-    OpencodeNodeSchema,
-    PiNodeSchema,
+    AcpAgentNodeSchema,
 ])
     .meta({
     id: 'WorkflowNode',