@xyne/workflow-sdk 1.0.0

package/README.md

@@ -0,0 +1,36 @@
+# @xyne/workflow-sdk
+
+Workflow engine SDK — build, validate, and execute workflows composed of triggers, steps, and control-flow primitives, with a framework-agnostic HTTP router and an optional LLM-agent system.
+
+## Install
+
+```bash
+npm install @xyne/workflow-sdk
+```
+
+The agent system (`@xyne/workflow-sdk/agents`) additionally requires the pi-mono peer dependencies:
+
+```bash
+npm install @earendil-works/pi-agent-core @earendil-works/pi-ai typebox
+```
+
+## Entry points
+
+| Import | Contents |
+| --- | --- |
+| `@xyne/workflow-sdk` | Core: registries, executor, runtime, types |
+| `@xyne/workflow-sdk/builder` | `WorkflowConfig` / step / trigger config types for building workflows |
+| `@xyne/workflow-sdk/client` | Typed HTTP client for the workflow router |
+| `@xyne/workflow-sdk/router` | Framework-agnostic route definitions |
+| `@xyne/workflow-sdk/runtime` | Runtime wiring types |
+| `@xyne/workflow-sdk/agents` | LLM agent step + tool registry (requires pi-mono peers) |
+| `@xyne/workflow-sdk/testing` | Mock contexts + test helpers |
+| `@xyne/workflow-sdk/common` | Shared utilities |
+
+## Built-in steps
+
+`CODE`, `HTTP_REQUEST`, `CONDITIONAL`, `SWITCH`, `LOOP`, `PARALLEL`, `WAIT`, `DEDUP`, plus the agent step (`RUN_AGENT`).
+
+## License
+
+UNLICENSED — © Xyne. All rights reserved.

package/dist/agents/agent-step.d.ts

@@ -0,0 +1,152 @@
+/**
+ * AgentStep — orchestrator step that runs an LLM agent within a workflow.
+ *
+ * Extends BaseActionStep. Receives a BaseAgentRuntime via composition (not
+ * inheritance). Handles tool resolution, interceptor chain, event
+ * consumption, pause/resume, and capability-based degradation.
+ *
+ * All configuration (tools, model, system prompt, MCP servers) comes from
+ * per-workflow config — nothing is baked in at registration.
+ */
+import { z } from 'zod';
+import { BaseActionStep } from '../steps/base-step.js';
+import type { StepExecutionContext } from '../steps/base-step.js';
+import type { StepType } from '../types/step-types.js';
+import type { StepCategory } from '../types/categories.js';
+import type { BaseAgentRuntime } from './base-runtime.js';
+import type { AgentToolRegistry } from './tool-registry.js';
+import type { AgentResult } from './types.js';
+export declare const AgentStepConfigSchema: z.ZodObject<{
+    systemPrompt: z.ZodString;
+    userMessage: z.ZodString;
+    tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    requireApproval: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    maxTurns: z.ZodDefault<z.ZodNumber>;
+    toolTimeout: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    systemPrompt: string;
+    userMessage: string;
+    maxTurns: number;
+    toolTimeout: number;
+    tools?: string[] | undefined;
+    requireApproval?: string[] | undefined;
+}, {
+    systemPrompt: string;
+    userMessage: string;
+    tools?: string[] | undefined;
+    requireApproval?: string[] | undefined;
+    maxTurns?: number | undefined;
+    toolTimeout?: number | undefined;
+}>;
+export type AgentStepConfig = z.infer<typeof AgentStepConfigSchema>;
+export declare class AgentStep extends BaseActionStep<typeof AgentStepConfigSchema, AgentResult> {
+    private readonly runtime;
+    private readonly toolRegistry;
+    readonly type: StepType;
+    readonly name = "Run Agent";
+    readonly description = "Execute an LLM agent with tools";
+    readonly configSchema: z.ZodObject<{
+        systemPrompt: z.ZodString;
+        userMessage: z.ZodString;
+        tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        requireApproval: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        maxTurns: z.ZodDefault<z.ZodNumber>;
+        toolTimeout: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        systemPrompt: string;
+        userMessage: string;
+        maxTurns: number;
+        toolTimeout: number;
+        tools?: string[] | undefined;
+        requireApproval?: string[] | undefined;
+    }, {
+        systemPrompt: string;
+        userMessage: string;
+        tools?: string[] | undefined;
+        requireApproval?: string[] | undefined;
+        maxTurns?: number | undefined;
+        toolTimeout?: number | undefined;
+    }>;
+    readonly outputSchema: z.ZodObject<{
+        response: z.ZodString;
+        toolCalls: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            result: z.ZodUnknown;
+            durationMs: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            args: Record<string, unknown>;
+            durationMs: number;
+            result?: unknown;
+        }, {
+            name: string;
+            args: Record<string, unknown>;
+            durationMs: number;
+            result?: unknown;
+        }>, "many">;
+        turnCount: z.ZodNumber;
+        usage: z.ZodObject<{
+            inputTokens: z.ZodNumber;
+            outputTokens: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            inputTokens: number;
+            outputTokens: number;
+        }, {
+            inputTokens: number;
+            outputTokens: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        response: string;
+        toolCalls: {
+            name: string;
+            args: Record<string, unknown>;
+            durationMs: number;
+            result?: unknown;
+        }[];
+        turnCount: number;
+        usage: {
+            inputTokens: number;
+            outputTokens: number;
+        };
+    }, {
+        response: string;
+        toolCalls: {
+            name: string;
+            args: Record<string, unknown>;
+            durationMs: number;
+            result?: unknown;
+        }[];
+        turnCount: number;
+        usage: {
+            inputTokens: number;
+            outputTokens: number;
+        };
+    }>;
+    readonly category: StepCategory;
+    constructor(runtime: BaseAgentRuntime, toolRegistry: AgentToolRegistry);
+    decorateConfigSchema(jsonSchema: Record<string, unknown>): Record<string, unknown>;
+    execute(config: AgentStepConfig, ctx: StepExecutionContext): Promise<AgentResult>;
+    /**
+     * Continue a prior conversation. Called from `execute()` when
+     * `ctx.priorState.messages` is present (review-gate retry or rerunFromStep).
+     *
+     * Reconstructs the agent input with the full prior conversation and the
+     * current `config.userMessage` as the new user turn. The runtime decides
+     * how to inject the new message into the message stream.
+     */
+    private continueConversation;
+    onResume(rowData: Record<string, unknown>, config: AgentStepConfig, ctx: StepExecutionContext): Promise<AgentResult>;
+    private convertTools;
+    /**
+     * Convert a Zod schema to a JSON Schema object for pi-mono tool parameters.
+     * Uses Zod's built-in JSON Schema support when available, falls back to
+     * a basic type: "object" wrapper.
+     */
+    private zodToJsonSchema;
+    private buildInterceptors;
+    private buildHooks;
+    private consumeEvents;
+    private buildResult;
+}
+//# sourceMappingURL=agent-step.d.ts.map

package/dist/agents/agent-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-step.d.ts","sourceRoot":"","sources":["../../src/agents/agent-step.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAQ5D,OAAO,KAAK,EACV,WAAW,EAKZ,MAAM,YAAY,CAAC;AAIpB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;EAOhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAiDpE,qBAAa,SAAU,SAAQ,cAAc,CAC3C,OAAO,qBAAqB,EAC5B,WAAW,CACZ;IASG,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAT/B,SAAkB,IAAI,EAAE,QAAQ,CAAe;IAC/C,SAAkB,IAAI,eAAe;IACrC,SAAkB,WAAW,qCAAqC;IAClE,SAAkB,YAAY;;;;;;;;;;;;;;;;;;;;;OAAyB;IACvD,SAAkB,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAAqB;IACnD,SAAkB,QAAQ,EAAE,YAAY,CAAQ;gBAG7B,OAAO,EAAE,gBAAgB,EACzB,YAAY,EAAE,iBAAiB;IAKzC,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAyB5E,OAAO,CACpB,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,WAAW,CAAC;IA2CvB;;;;;;;OAOG;YACW,oBAAoB;IAkDnB,QAAQ,CACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,WAAW,CAAC;IAiDvB,OAAO,CAAC,YAAY;IA8BpB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,UAAU;YAmBJ,aAAa;IAkI3B,OAAO,CAAC,WAAW;CAkBpB"}

package/dist/agents/agent-step.js

@@ -0,0 +1,403 @@
+/**
+ * AgentStep — orchestrator step that runs an LLM agent within a workflow.
+ *
+ * Extends BaseActionStep. Receives a BaseAgentRuntime via composition (not
+ * inheritance). Handles tool resolution, interceptor chain, event
+ * consumption, pause/resume, and capability-based degradation.
+ *
+ * All configuration (tools, model, system prompt, MCP servers) comes from
+ * per-workflow config — nothing is baked in at registration.
+ */
+import { z } from 'zod';
+import { BaseActionStep } from '../steps/base-step.js';
+import { runInterceptorChain, } from './interceptor.js';
+import { ApprovalGateInterceptor } from './interceptors/approval-gate.js';
+import { ToolLoggingInterceptor } from './interceptors/tool-logger.js';
+// ─── Config Schema ───
+export const AgentStepConfigSchema = z.object({
+    systemPrompt: z.string().describe('Instructions that define the agent\'s behavior and capabilities'),
+    userMessage: z.string().describe('The user message or task prompt sent to the agent'),
+    tools: z.array(z.string()).optional().describe('Tool names the agent is allowed to use'),
+    requireApproval: z.array(z.string()).optional().describe('Tool names that require human approval before execution'),
+    maxTurns: z.number().int().min(1).default(10).describe('Maximum number of agent reasoning turns'),
+    toolTimeout: z.number().int().positive().default(30_000).describe('Timeout per tool call in milliseconds'),
+});
+// ─── Result Schema ───
+const AgentResultSchema = z.object({
+    response: z.string(),
+    toolCalls: z.array(z.object({
+        name: z.string(),
+        args: z.record(z.unknown()),
+        result: z.unknown(),
+        durationMs: z.number(),
+    })),
+    turnCount: z.number(),
+    usage: z.object({
+        inputTokens: z.number(),
+        outputTokens: z.number(),
+    }),
+});
+// ─── Utility ───
+function withTimeout(promise, timeoutMs) {
+    return Promise.race([
+        promise,
+        new Promise((_resolve, reject) => {
+            const timer = setTimeout(() => { reject(new Error(`Tool execution timed out after ${timeoutMs}ms`)); }, timeoutMs);
+            // Don't block Node from exiting
+            if (typeof timer === 'object' && 'unref' in timer) {
+                timer.unref();
+            }
+        }),
+    ]);
+}
+/** Extract text content from an AssistantMessage. */
+function extractResponseText(message) {
+    return message.content
+        .filter((c) => c.type === 'text')
+        .map((c) => c.text)
+        .join('');
+}
+// ─── AgentStep ───
+export class AgentStep extends BaseActionStep {
+    runtime;
+    toolRegistry;
+    type = 'RUN_AGENT';
+    name = 'Run Agent';
+    description = 'Execute an LLM agent with tools';
+    configSchema = AgentStepConfigSchema;
+    outputSchema = AgentResultSchema;
+    category = 'ai';
+    constructor(runtime, toolRegistry) {
+        super();
+        this.runtime = runtime;
+        this.toolRegistry = toolRegistry;
+    }
+    decorateConfigSchema(jsonSchema) {
+        const toolNames = this.toolRegistry.getNames();
+        if (toolNames.length === 0)
+            return jsonSchema;
+        const props = jsonSchema['properties'];
+        if (!props)
+            return jsonSchema;
+        // Inject enum into tools array items so the generic renderer shows multi-select
+        if (props['tools']?.['items']) {
+            props['tools'] = {
+                ...props['tools'],
+                items: { ...props['tools']['items'], enum: toolNames },
+            };
+        }
+        // Same for requireApproval
+        if (props['requireApproval']?.['items']) {
+            props['requireApproval'] = {
+                ...props['requireApproval'],
+                items: { ...props['requireApproval']['items'], enum: toolNames },
+            };
+        }
+        return jsonSchema;
+    }
+    async execute(config, ctx) {
+        // Conversation continuity: when a prior run left messages (review-gate
+        // retry or rerunFromStep), continue the conversation with the new
+        // userMessage as additional context. The agent sees the full history.
+        const priorMessages = extractPriorMessages(ctx.priorState);
+        if (priorMessages && priorMessages.length > 0) {
+            return this.continueConversation(priorMessages, config, ctx);
+        }
+        // 1. Resolve tools from registry
+        const workflowTools = config.tools
+            ? this.toolRegistry.resolve(config.tools)
+            : [];
+        // 2. Convert WorkflowTools → pi-mono AgentTools
+        const piTools = this.convertTools(workflowTools, config.toolTimeout, ctx);
+        // 3. Clamp maxTurns if runtime doesn't support multi-turn
+        const effectiveMaxTurns = this.runtime.capabilities.multiTurn
+            ? config.maxTurns
+            : 1;
+        // 4. Build interceptor chain
+        const interceptors = this.buildInterceptors(config, ctx);
+        // 5. Map interceptors → AgentHooks
+        const hooks = this.buildHooks(interceptors, ctx);
+        // 6. Execute runtime
+        const events = this.runtime.execute(config, {
+            tools: this.runtime.capabilities.toolUse ? piTools : [],
+            hooks: this.runtime.capabilities.hooks ? hooks : {},
+            signal: ctx.runtime.metadata['signal'] ?? new AbortController().signal,
+        }, ctx);
+        // 7. Consume event stream
+        return this.consumeEvents(events, ctx, effectiveMaxTurns);
+    }
+    /**
+     * Continue a prior conversation. Called from `execute()` when
+     * `ctx.priorState.messages` is present (review-gate retry or rerunFromStep).
+     *
+     * Reconstructs the agent input with the full prior conversation and the
+     * current `config.userMessage` as the new user turn. The runtime decides
+     * how to inject the new message into the message stream.
+     */
+    async continueConversation(priorMessages, config, ctx) {
+        const priorState = (ctx.priorState ?? {});
+        const workflowTools = config.tools
+            ? this.toolRegistry.resolve(config.tools)
+            : [];
+        const piTools = this.convertTools(workflowTools, config.toolTimeout, ctx);
+        const interceptors = this.buildInterceptors(config, ctx);
+        const hooks = this.buildHooks(interceptors, ctx);
+        const effectiveMaxTurns = this.runtime.capabilities.multiTurn
+            ? config.maxTurns
+            : 1;
+        const completedToolCalls = priorState.completedToolCalls ?? [];
+        const usage = priorState.usage ?? { inputTokens: 0, outputTokens: 0 };
+        const currentTurn = priorState.currentTurn ?? 0;
+        const input = {
+            tools: this.runtime.capabilities.toolUse ? piTools : [],
+            hooks: this.runtime.capabilities.hooks ? hooks : {},
+            signal: ctx.runtime.metadata['signal'] ?? new AbortController().signal,
+            resume: {
+                messages: priorMessages,
+                payload: { action: 'approve', feedback: config.userMessage },
+                pauseState: {
+                    type: 'awaiting_feedback',
+                    reason: 'Continuing prior conversation',
+                    prompt: config.userMessage,
+                    state: {
+                        messages: priorMessages,
+                        currentTurn,
+                        completedToolCalls,
+                        usage,
+                    },
+                },
+            },
+        };
+        const events = this.runtime.execute(config, input, ctx);
+        return this.consumeEvents(events, ctx, effectiveMaxTurns, {
+            messages: priorMessages,
+            currentTurn,
+            completedToolCalls,
+            usage,
+        });
+    }
+    async onResume(rowData, config, ctx) {
+        const pauseState = rowData;
+        const resumePayload = ctx.runtime.metadata['resumePayload'];
+        const pauseRequest = ctx.runtime.metadata['pauseRequest'];
+        if (resumePayload?.action === 'abort') {
+            return {
+                response: pauseState.messages.length > 0
+                    ? 'Agent execution aborted by user.'
+                    : '',
+                toolCalls: pauseState.completedToolCalls,
+                turnCount: pauseState.currentTurn,
+                usage: pauseState.usage,
+            };
+        }
+        // Resolve tools again (MCP tools may have changed)
+        const workflowTools = config.tools
+            ? this.toolRegistry.resolve(config.tools)
+            : [];
+        const piTools = this.convertTools(workflowTools, config.toolTimeout, ctx);
+        const interceptors = this.buildInterceptors(config, ctx);
+        const hooks = this.buildHooks(interceptors, ctx);
+        const effectiveMaxTurns = this.runtime.capabilities.multiTurn
+            ? config.maxTurns
+            : 1;
+        const input = {
+            tools: this.runtime.capabilities.toolUse ? piTools : [],
+            hooks: this.runtime.capabilities.hooks ? hooks : {},
+            signal: ctx.runtime.metadata['signal'] ?? new AbortController().signal,
+        };
+        if (pauseRequest) {
+            input.resume = {
+                messages: pauseState.messages,
+                payload: resumePayload ?? { action: 'approve' },
+                pauseState: pauseRequest,
+            };
+        }
+        const events = this.runtime.execute(config, input, ctx);
+        // Consume events, carrying over state from before pause
+        return this.consumeEvents(events, ctx, effectiveMaxTurns, pauseState);
+    }
+    // ─── Private: Tool conversion ───
+    convertTools(tools, timeoutMs, ctx) {
+        return tools.map((tool) => ({
+            name: tool.name,
+            label: tool.name,
+            description: tool.description,
+            parameters: this.zodToJsonSchema(tool.inputSchema),
+            execute: async (_toolCallId, params, signal) => {
+                const result = await withTimeout(tool.execute(params, {
+                    signal: signal ?? new AbortController().signal,
+                    log: ctx.log,
+                }), timeoutMs);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result) }],
+                    details: result,
+                };
+            },
+        }));
+    }
+    /**
+     * Convert a Zod schema to a JSON Schema object for pi-mono tool parameters.
+     * Uses Zod's built-in JSON Schema support when available, falls back to
+     * a basic type: "object" wrapper.
+     */
+    zodToJsonSchema(schema) {
+        // Zod v3.25+ has a built-in jsonSchema() method
+        if ('jsonSchema' in schema && typeof schema.jsonSchema === 'function') {
+            return schema.jsonSchema();
+        }
+        // Fallback: opaque object schema
+        return { type: 'object' };
+    }
+    // ─── Private: Interceptors ───
+    buildInterceptors(config, ctx) {
+        const interceptors = [
+            new ToolLoggingInterceptor(ctx.emit.bind(ctx)),
+        ];
+        if (config.requireApproval && config.requireApproval.length > 0) {
+            interceptors.push(new ApprovalGateInterceptor(config.requireApproval));
+        }
+        return interceptors;
+    }
+    buildHooks(interceptors, ctx) {
+        return {
+            async beforeToolCall(tool, args) {
+                return runInterceptorChain(interceptors, tool, args);
+            },
+            async afterToolCall(tool, args, result) {
+                ctx.emit({
+                    type: 'tool_call',
+                    data: { tool, args, result, phase: 'end' },
+                });
+            },
+        };
+    }
+    // ─── Private: Event consumption ───
+    async consumeEvents(events, ctx, maxTurns, initialState) {
+        const state = initialState ?? {
+            messages: [],
+            currentTurn: 0,
+            completedToolCalls: [],
+            usage: { inputTokens: 0, outputTokens: 0 },
+        };
+        // Track args from tool_execution_start for use in tool_execution_end
+        const pendingToolArgs = new Map();
+        for await (const event of events) {
+            switch (event.type) {
+                case 'turn_start':
+                    state.currentTurn++;
+                    if (state.currentTurn > maxTurns) {
+                        ctx.log.warn(`Agent exceeded maxTurns (${maxTurns}), stopping`);
+                        return this.buildResult(state);
+                    }
+                    break;
+                case 'message_start':
+                    ctx.emit({ type: 'thinking', data: { phase: 'start' } });
+                    break;
+                case 'message_update': {
+                    const updateMsg = event.message;
+                    const partialText = extractResponseText(updateMsg);
+                    ctx.emit({
+                        type: 'progress',
+                        data: { content: partialText },
+                    });
+                    break;
+                }
+                case 'message_end': {
+                    const endMsg = event.message;
+                    state.messages.push(endMsg);
+                    // Accumulate usage from assistant messages
+                    if (endMsg.role === 'assistant' && endMsg.usage) {
+                        state.usage.inputTokens += endMsg.usage.input;
+                        state.usage.outputTokens += endMsg.usage.output;
+                    }
+                    ctx.emit({
+                        type: 'substep',
+                        data: { type: 'message', content: extractResponseText(endMsg) },
+                    });
+                    break;
+                }
+                case 'tool_execution_start': {
+                    const startEvt = event;
+                    pendingToolArgs.set(startEvt.toolCallId, startEvt.args ?? {});
+                    ctx.emit({
+                        type: 'tool_call',
+                        data: {
+                            tool: startEvt.toolName,
+                            args: startEvt.args,
+                            phase: 'start',
+                            toolCallId: startEvt.toolCallId,
+                        },
+                    });
+                    break;
+                }
+                case 'tool_execution_end': {
+                    const endEvt = event;
+                    const toolArgs = pendingToolArgs.get(endEvt.toolCallId) ?? {};
+                    pendingToolArgs.delete(endEvt.toolCallId);
+                    state.completedToolCalls.push({
+                        name: endEvt.toolName,
+                        args: toolArgs,
+                        result: endEvt.result,
+                        durationMs: 0, // pi-mono doesn't provide timing; host can enrich
+                    });
+                    ctx.emit({
+                        type: 'tool_call',
+                        data: {
+                            tool: endEvt.toolName,
+                            result: endEvt.result,
+                            phase: 'end',
+                            toolCallId: endEvt.toolCallId,
+                            isError: endEvt.isError,
+                        },
+                    });
+                    break;
+                }
+                case 'turn_end': {
+                    const turnEvt = event;
+                    // Store tool result messages in state for resume
+                    for (const tr of turnEvt.toolResults) {
+                        state.messages.push(tr);
+                    }
+                    break;
+                }
+                case 'agent_end':
+                    // Final event — loop will exit naturally
+                    break;
+                default:
+                    // agent_start, tool_execution_update, etc. — ignore
+                    break;
+            }
+        }
+        return this.buildResult(state);
+    }
+    buildResult(state) {
+        // Find the last assistant message for the response text
+        let response = '';
+        for (let i = state.messages.length - 1; i >= 0; i--) {
+            const msg = state.messages[i];
+            if (msg && 'role' in msg && msg.role === 'assistant') {
+                response = extractResponseText(msg);
+                break;
+            }
+        }
+        return {
+            response,
+            toolCalls: state.completedToolCalls,
+            turnCount: state.currentTurn,
+            usage: state.usage,
+        };
+    }
+}
+/**
+ * Pull prior conversation messages out of an opaque `priorState` blob.
+ * Returns null if the shape doesn't match a serialized `AgentPauseState`.
+ */
+function extractPriorMessages(priorState) {
+    if (!priorState)
+        return null;
+    const candidate = priorState['messages'];
+    if (!Array.isArray(candidate))
+        return null;
+    return candidate;
+}
+//# sourceMappingURL=agent-step.js.map

package/dist/agents/agent-step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-step.js","sourceRoot":"","sources":["../../src/agents/agent-step.ts"],"names":[],"mappings":"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"}

package/dist/agents/base-runtime.d.ts

@@ -0,0 +1,38 @@
+/**
+ * BaseAgentRuntime — abstract class for LLM runtime implementations.
+ *
+ * Returns `AsyncIterable<AgentEvent>` (pi-mono type). Single `execute()`
+ * method — run and resume use the same entry point (resume context is
+ * optional in `AgentInput`).
+ *
+ * **What the runtime does:**
+ * - Sends messages to the LLM
+ * - Yields pi-mono AgentEvent stream
+ * - Calls tools via hooks
+ *
+ * **What the runtime does NOT do:**
+ * - Tool resolution (AgentStep does this)
+ * - HITL / pause decisions (interceptor chain does this)
+ * - MCP connections (host-side adapter does this)
+ * - Event persistence (AgentStep does this via ctx.emit)
+ */
+import type { z } from 'zod';
+import type { AgentEvent } from '@earendil-works/pi-agent-core';
+import type { AgentCapabilities, AgentInput } from './types.js';
+import type { StepExecutionContext } from '../steps/base-step.js';
+export declare abstract class BaseAgentRuntime<TConfig extends z.ZodTypeAny = z.ZodTypeAny> {
+    abstract readonly name: string;
+    abstract readonly capabilities: AgentCapabilities;
+    abstract readonly configSchema: TConfig;
+    /**
+     * Execute the agent. Returns an async iterable of pi-mono AgentEvent.
+     *
+     * - Fresh run: `input.resume` is undefined
+     * - Resuming after pause: `input.resume` contains conversation history + user's response
+     *
+     * The runtime does NOT handle tool execution, HITL, or MCP — AgentStep
+     * orchestrates all of that before calling this method.
+     */
+    abstract execute(config: z.infer<TConfig>, input: AgentInput, ctx: StepExecutionContext): AsyncIterable<AgentEvent>;
+}
+//# sourceMappingURL=base-runtime.d.ts.map

package/dist/agents/base-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-runtime.d.ts","sourceRoot":"","sources":["../../src/agents/base-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,8BAAsB,gBAAgB,CACpC,OAAO,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;IAE3C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IAClD,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAExC;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,CACd,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EACxB,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,oBAAoB,GACxB,aAAa,CAAC,UAAU,CAAC;CAC7B"}