modular-voice-agent-sdk 2.4.0 → 2.5.1

package/README.md

@@ -53,6 +53,9 @@ Each component can run in the browser, on a server, or in the cloud. Pick any fr
               N/A                         ☁️ Cloud Audio LLM                         N/A
                                             (GPT Audio, multimodal)
 
+              N/A                         🤖 Agent SDK                               N/A
+                                            (OpenCode, Pi Agent)
+
 ```
 
 Want browser speech recognition + a cloud LLM + browser speech synthesis? Done. Want everything running locally on your server with native binaries? Also done. Same code structure, same events, different backends.
@@ -61,6 +64,7 @@ Want browser speech recognition + a cloud LLM + browser speech synthesis? Done.
 
 - **Streaming** — responses stream token-by-token to TTS
 - **Function calling** — tools work across all LLM backends (cloud, native, transformers)
+- **Agent SDK support** — wrap coding agents (OpenCode, Pi Agent) as voice-controlled backends
 - **Conversation history** — automatic context management
 - **Hybrid configs** — mix browser and server components freely
 

package/dist/backends/agent/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Agent Backend - Agent SDK support
+ * Wraps coding agent SDKs (OpenCode, Pi Agent, Pi Coding Agent, etc.) as LLM backends.
+ *
+ * The agent handles tool execution internally — the voice pipeline
+ * only receives text responses and tool activity notifications.
+ */
+export { AgentLLM } from './llm';
+export type { AgentProvider, AgentSession, AgentStreamEvent } from './provider';
+export { OpenCodeAgentProvider } from './opencode-provider';
+export type { OpenCodeAgentProviderConfig, OpenCodeClient } from './opencode-provider';
+export { PiAgentProvider } from './pi-agent-provider';
+export type { PiAgentProviderConfig, PiAgent } from './pi-agent-provider';
+export { PiCodingAgentProvider } from './pi-coding-agent-provider';
+export type { PiCodingAgentProviderConfig, PiCodingAgentSession } from './pi-coding-agent-provider';
+//# sourceMappingURL=index.d.ts.map

package/dist/backends/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/backends/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGhF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EAAE,2BAA2B,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEvF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/backends/agent/index.js

@@ -0,0 +1,14 @@
+/**
+ * Agent Backend - Agent SDK support
+ * Wraps coding agent SDKs (OpenCode, Pi Agent, Pi Coding Agent, etc.) as LLM backends.
+ *
+ * The agent handles tool execution internally — the voice pipeline
+ * only receives text responses and tool activity notifications.
+ */
+// Core
+export { AgentLLM } from './llm';
+// Providers
+export { OpenCodeAgentProvider } from './opencode-provider';
+export { PiAgentProvider } from './pi-agent-provider';
+export { PiCodingAgentProvider } from './pi-coding-agent-provider';
+//# sourceMappingURL=index.js.map

package/dist/backends/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/backends/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO;AACP,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGjC,YAAY;AACZ,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/backends/agent/llm.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Agent LLM Pipeline
+ * Wraps agent SDKs (OpenCode, Pi Agent, etc.) as an LLMPipeline backend.
+ *
+ * Unlike CloudLLM which makes raw API calls and lets the voice pipeline handle
+ * tool execution, AgentLLM delegates to an agent SDK that manages its own
+ * tool execution loop internally. From the voice pipeline's perspective,
+ * this backend always returns finishReason: 'stop' — the tool loop is
+ * handled entirely within the agent.
+ *
+ * Tool activity events are forwarded via onToolCall callbacks so the UI
+ * can display "Reading file...", "Writing code...", etc.
+ */
+import type { LLMPipeline, ProgressCallback, Message, LLMGenerateOptions, LLMGenerateResult } from '../../types';
+import type { AgentProvider } from './provider';
+export declare class AgentLLM implements LLMPipeline {
+    private provider;
+    private session;
+    private ready;
+    constructor(provider: AgentProvider);
+    initialize(_onProgress?: ProgressCallback): Promise<void>;
+    /**
+     * Agent backends handle tools internally — the voice pipeline
+     * should not pass tool definitions or expect tool_calls back.
+     */
+    supportsTools(): boolean;
+    generate(messages: Message[], options?: LLMGenerateOptions): Promise<LLMGenerateResult>;
+    isReady(): boolean;
+    /**
+     * Destroy the current session and release resources.
+     * A new session will be created on the next generate() call.
+     */
+    destroySession(): Promise<void>;
+    /**
+     * Extract the latest user message from the conversation history.
+     * We walk backwards to find the most recent 'user' role message.
+     */
+    private extractLatestUserMessage;
+}
+//# sourceMappingURL=llm.d.ts.map

package/dist/backends/agent/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../../src/backends/agent/llm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,OAAO,EACP,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,YAAY,CAAC;AAE9D,qBAAa,QAAS,YAAW,WAAW;IAC1C,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,KAAK,CAAS;gBAEV,QAAQ,EAAE,aAAa;IAI7B,UAAU,CAAC,WAAW,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/D;;;OAGG;IACH,aAAa,IAAI,OAAO;IAIlB,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA6D7F,OAAO,IAAI,OAAO;IAIlB;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrC;;;OAGG;IACH,OAAO,CAAC,wBAAwB;CAQjC"}

package/dist/backends/agent/llm.js

@@ -0,0 +1,110 @@
+/**
+ * Agent LLM Pipeline
+ * Wraps agent SDKs (OpenCode, Pi Agent, etc.) as an LLMPipeline backend.
+ *
+ * Unlike CloudLLM which makes raw API calls and lets the voice pipeline handle
+ * tool execution, AgentLLM delegates to an agent SDK that manages its own
+ * tool execution loop internally. From the voice pipeline's perspective,
+ * this backend always returns finishReason: 'stop' — the tool loop is
+ * handled entirely within the agent.
+ *
+ * Tool activity events are forwarded via onToolCall callbacks so the UI
+ * can display "Reading file...", "Writing code...", etc.
+ */
+export class AgentLLM {
+    provider;
+    session = null;
+    ready = false;
+    constructor(provider) {
+        this.provider = provider;
+    }
+    async initialize(_onProgress) {
+        console.log('Initializing Agent LLM...');
+        this.ready = true;
+        console.log('Agent LLM ready (session will be created on first message).');
+    }
+    /**
+     * Agent backends handle tools internally — the voice pipeline
+     * should not pass tool definitions or expect tool_calls back.
+     */
+    supportsTools() {
+        return false;
+    }
+    async generate(messages, options) {
+        if (!this.ready) {
+            throw new Error('Agent LLM pipeline not initialized');
+        }
+        // Lazily create the agent session on first generate() call
+        if (!this.session) {
+            console.log('Creating agent session...');
+            this.session = await this.provider.createSession();
+            console.log('Agent session created.');
+        }
+        // Extract the latest user message from the conversation history.
+        // The agent SDK maintains its own history, so we only need the new message.
+        const latestUserMessage = this.extractLatestUserMessage(messages);
+        if (!latestUserMessage) {
+            return { content: '', finishReason: 'stop' };
+        }
+        // Stream the response from the agent
+        let fullContent = '';
+        for await (const event of this.session.sendMessage(latestUserMessage)) {
+            switch (event.type) {
+                case 'text_delta':
+                    if (event.content) {
+                        fullContent += event.content;
+                        options?.onToken?.(event.content);
+                    }
+                    break;
+                case 'tool_call_start':
+                    if (event.toolCall) {
+                        options?.onToolCall?.({
+                            id: event.toolCall.id,
+                            name: event.toolCall.name,
+                            arguments: event.toolCall.arguments ?? {},
+                        });
+                    }
+                    break;
+                case 'tool_call_end':
+                    // Tool results are informational only — the agent already handled them.
+                    break;
+                case 'error':
+                    throw new Error(`Agent error: ${event.error ?? 'Unknown error'}`);
+                case 'done':
+                    break;
+            }
+        }
+        // Always return 'stop' — the agent handles its own tool loop.
+        // The voice pipeline's tool loop will exit on the first iteration.
+        return {
+            content: fullContent,
+            finishReason: 'stop',
+        };
+    }
+    isReady() {
+        return this.ready;
+    }
+    /**
+     * Destroy the current session and release resources.
+     * A new session will be created on the next generate() call.
+     */
+    async destroySession() {
+        if (this.session) {
+            await this.session.destroy();
+            this.session = null;
+        }
+    }
+    /**
+     * Extract the latest user message from the conversation history.
+     * We walk backwards to find the most recent 'user' role message.
+     */
+    extractLatestUserMessage(messages) {
+        for (let i = messages.length - 1; i >= 0; i--) {
+            if (messages[i].role === 'user') {
+                return messages[i].content;
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=llm.js.map

package/dist/backends/agent/llm.js.map

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

package/dist/backends/agent/opencode-provider.d.ts

@@ -0,0 +1,94 @@
+/**
+ * OpenCode Agent Provider
+ * Wraps an OpenCode SDK session as an AgentProvider.
+ *
+ * The user creates the OpenCode client externally and passes in
+ * the session API. This provider handles creating sessions and
+ * mapping SSE events to AgentStreamEvents.
+ *
+ * @example
+ * ```typescript
+ * import { createOpencode } from '@opencode-ai/sdk';
+ *
+ * const opencode = await createOpencode({ ... });
+ *
+ * const pipeline = createVoicePipeline({
+ *   create: () => ({
+ *     stt: new CloudSTT({ ... }),
+ *     llm: new AgentLLM(new OpenCodeAgentProvider({
+ *       client: opencode.client,
+ *     })),
+ *     tts: null,
+ *     systemPrompt: 'You are a coding assistant.',
+ *   }),
+ * });
+ * ```
+ */
+import type { AgentProvider, AgentSession } from './provider';
+/**
+ * Configuration for the OpenCode agent provider.
+ */
+export interface OpenCodeAgentProviderConfig {
+    /**
+     * The OpenCode SDK client instance.
+     * Created externally via createOpencode() or createOpencodeClient().
+     */
+    client: OpenCodeClient;
+    /**
+     * Model override (e.g., { providerID: 'anthropic', modelID: 'claude-sonnet-4-20250514' }).
+     * If omitted, uses the server's default model.
+     */
+    model?: {
+        providerID: string;
+        modelID: string;
+    };
+}
+/**
+ * OpenCode Agent Provider
+ * Wraps an externally-created OpenCode client.
+ */
+export declare class OpenCodeAgentProvider implements AgentProvider {
+    private config;
+    constructor(config: OpenCodeAgentProviderConfig);
+    createSession(): Promise<AgentSession>;
+}
+/**
+ * Minimal type definitions for the OpenCode SDK client.
+ * These match the SDK's API surface without requiring the SDK at build time.
+ * The user passes in the real SDK client which satisfies this interface.
+ */
+interface OpenCodePromptBody {
+    parts: Array<{
+        type: string;
+        text: string;
+    }>;
+    model?: {
+        providerID: string;
+        modelID: string;
+    };
+}
+export interface OpenCodeClient {
+    session: {
+        create(opts: {
+            body: Record<string, unknown>;
+        }): Promise<any>;
+        prompt(opts: {
+            path: {
+                id: string;
+            };
+            body: OpenCodePromptBody;
+        }): Promise<any>;
+        delete(opts: {
+            path: {
+                id: string;
+            };
+        }): Promise<any>;
+    };
+    event: {
+        subscribe(): Promise<{
+            stream: AsyncIterable<any>;
+        }>;
+    };
+}
+export {};
+//# sourceMappingURL=opencode-provider.d.ts.map

package/dist/backends/agent/opencode-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-provider.d.ts","sourceRoot":"","sources":["../../../src/backends/agent/opencode-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAoB,MAAM,YAAY,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,MAAM,EAAE,cAAc,CAAC;IACvB;;;OAGG;IACH,KAAK,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AAED;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,aAAa;IACzD,OAAO,CAAC,MAAM,CAA8B;gBAEhC,MAAM,EAAE,2BAA2B;IAIzC,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC;CAY7C;AAoID;;;;GAIG;AAGH,UAAU,kBAAkB;IAC1B,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,KAAK,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE;QACP,MAAM,CAAC,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9D,MAAM,CAAC,IAAI,EAAE;YAAE,IAAI,EAAE;gBAAE,EAAE,EAAE,MAAM,CAAA;aAAE,CAAC;YAAC,IAAI,EAAE,kBAAkB,CAAA;SAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC/E,MAAM,CAAC,IAAI,EAAE;YAAE,IAAI,EAAE;gBAAE,EAAE,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;KACtD,CAAC;IACF,KAAK,EAAE;QACL,SAAS,IAAI,OAAO,CAAC;YAAE,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,CAAA;SAAE,CAAC,CAAC;KACtD,CAAC;CACH"}

package/dist/backends/agent/opencode-provider.js

@@ -0,0 +1,169 @@
+/**
+ * OpenCode Agent Provider
+ * Wraps an OpenCode SDK session as an AgentProvider.
+ *
+ * The user creates the OpenCode client externally and passes in
+ * the session API. This provider handles creating sessions and
+ * mapping SSE events to AgentStreamEvents.
+ *
+ * @example
+ * ```typescript
+ * import { createOpencode } from '@opencode-ai/sdk';
+ *
+ * const opencode = await createOpencode({ ... });
+ *
+ * const pipeline = createVoicePipeline({
+ *   create: () => ({
+ *     stt: new CloudSTT({ ... }),
+ *     llm: new AgentLLM(new OpenCodeAgentProvider({
+ *       client: opencode.client,
+ *     })),
+ *     tts: null,
+ *     systemPrompt: 'You are a coding assistant.',
+ *   }),
+ * });
+ * ```
+ */
+/**
+ * OpenCode Agent Provider
+ * Wraps an externally-created OpenCode client.
+ */
+export class OpenCodeAgentProvider {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async createSession() {
+        const client = this.config.client;
+        // Create a new session on the OpenCode server
+        const session = await client.session.create({ body: {} });
+        const sessionId = session.id ?? session.data?.id;
+        if (!sessionId) {
+            throw new Error('OpenCode: Failed to create session — no session ID returned');
+        }
+        return new OpenCodeAgentSession(client, sessionId, this.config.model);
+    }
+}
+/**
+ * Active OpenCode agent session.
+ * Manages the SSE event subscription and prompt sending.
+ */
+class OpenCodeAgentSession {
+    client;
+    sessionId;
+    model;
+    constructor(client, sessionId, model) {
+        this.client = client;
+        this.sessionId = sessionId;
+        this.model = model;
+    }
+    async *sendMessage(text) {
+        // Subscribe to SSE events before sending the prompt.
+        // This ensures we capture all events including the first ones.
+        const events = await this.client.event.subscribe();
+        // Build prompt body
+        const promptBody = {
+            parts: [{ type: 'text', text }],
+        };
+        if (this.model) {
+            promptBody.model = this.model;
+        }
+        // Send the prompt (don't await — we process events as they stream)
+        const promptPromise = this.client.session.prompt({
+            path: { id: this.sessionId },
+            body: promptBody,
+        });
+        // Track text we've already emitted to compute deltas.
+        // OpenCode message.part.updated events contain the full accumulated text,
+        // so we diff against what we've sent to produce incremental deltas.
+        let emittedTextLength = 0;
+        let done = false;
+        try {
+            for await (const event of events.stream) {
+                // Filter events for our session
+                const props = event.properties ?? event;
+                const eventSessionId = props.sessionID ?? props.session_id;
+                if (eventSessionId !== this.sessionId) {
+                    continue;
+                }
+                const eventType = event.type ?? event.event ?? '';
+                if (eventType === 'message.part.updated') {
+                    const part = props.part ?? props;
+                    const partType = part?.type ?? '';
+                    if (partType === 'text') {
+                        // Text delta — OpenCode sends cumulative text, so compute the delta
+                        const fullText = part.text ?? part.content ?? '';
+                        if (fullText.length > emittedTextLength) {
+                            const delta = fullText.slice(emittedTextLength);
+                            emittedTextLength = fullText.length;
+                            yield { type: 'text_delta', content: delta };
+                        }
+                    }
+                    else if (partType === 'tool-invocation' || partType === 'tool_use') {
+                        const toolInvocation = part.toolInvocation ?? part;
+                        const state = toolInvocation.state ?? '';
+                        const toolName = toolInvocation.toolName ?? part.name ?? 'unknown';
+                        const toolCallId = toolInvocation.toolCallId ?? part.id ?? '';
+                        if (state === 'calling' || state === 'partial-call') {
+                            yield {
+                                type: 'tool_call_start',
+                                toolCall: {
+                                    id: toolCallId,
+                                    name: toolName,
+                                    arguments: toolInvocation.args ?? {},
+                                },
+                            };
+                        }
+                        else if (state === 'result') {
+                            yield {
+                                type: 'tool_call_end',
+                                toolCall: {
+                                    id: toolCallId,
+                                    name: toolName,
+                                    result: toolInvocation.result,
+                                },
+                            };
+                        }
+                    }
+                }
+                else if (eventType === 'session.error') {
+                    yield {
+                        type: 'error',
+                        error: props.error ?? props.message ?? 'Unknown OpenCode error',
+                    };
+                    done = true;
+                    break;
+                }
+                else if (eventType === 'session.idle') {
+                    // Reset text tracking for next message in this session
+                    emittedTextLength = 0;
+                    done = true;
+                    yield { type: 'done' };
+                    break;
+                }
+            }
+        }
+        finally {
+            if (!done) {
+                yield { type: 'done' };
+            }
+            // Wait for the prompt to resolve to catch any errors
+            try {
+                await promptPromise;
+            }
+            catch (err) {
+                console.warn('OpenCode prompt error:', err);
+            }
+        }
+    }
+    async destroy() {
+        try {
+            await this.client.session.delete({ path: { id: this.sessionId } });
+        }
+        catch {
+            // Session may already be cleaned up
+        }
+    }
+}
+/* eslint-enable @typescript-eslint/no-explicit-any */
+//# sourceMappingURL=opencode-provider.js.map

package/dist/backends/agent/opencode-provider.js.map

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

package/dist/backends/agent/pi-agent-provider.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Pi Agent Provider
+ * Wraps a Pi Agent instance (@mariozechner/pi-agent-core) as an AgentProvider.
+ *
+ * The user creates the Agent externally with their own model, tools, and config.
+ * This provider wraps it and maps its event stream to AgentStreamEvents.
+ *
+ * @example
+ * ```typescript
+ * import { Agent } from '@mariozechner/pi-agent-core';
+ * import { getModel } from '@mariozechner/pi-ai';
+ * import { codingTools } from '@mariozechner/pi-coding-agent';
+ *
+ * const agent = new Agent({
+ *   initialState: {
+ *     systemPrompt: 'You are a coding assistant.',
+ *     model: getModel('anthropic', 'claude-sonnet-4-20250514'),
+ *     thinkingLevel: 'medium',
+ *     tools: codingTools,
+ *   },
+ * });
+ *
+ * const pipeline = createVoicePipeline({
+ *   create: () => ({
+ *     stt: new CloudSTT({ ... }),
+ *     llm: new AgentLLM(new PiAgentProvider({ agent })),
+ *     tts: null,
+ *     systemPrompt: 'You are a coding assistant.',
+ *   }),
+ * });
+ * ```
+ */
+import type { AgentProvider, AgentSession } from './provider';
+/**
+ * Configuration for the Pi Agent provider.
+ */
+export interface PiAgentProviderConfig {
+    /**
+     * A pre-created Pi Agent instance.
+     * Created externally with your own model, tools, and configuration.
+     */
+    agent: PiAgent;
+}
+/**
+ * Pi Agent Provider
+ * Wraps an externally-created Pi Agent instance.
+ */
+export declare class PiAgentProvider implements AgentProvider {
+    private agent;
+    constructor(config: PiAgentProviderConfig);
+    createSession(): Promise<AgentSession>;
+}
+/**
+ * Minimal type definitions for the Pi Agent SDK.
+ * These match the SDK's API surface without requiring the SDK at build time.
+ * The user passes in the real Agent instance which satisfies this interface.
+ */
+interface PiAgentEvent {
+    type: string;
+    assistantMessageEvent?: {
+        type: string;
+        delta?: string;
+    };
+    toolCallId?: string;
+    toolName?: string;
+    args?: Record<string, unknown>;
+    result?: any;
+    isError?: boolean;
+}
+export interface PiAgent {
+    prompt(text: string | any, images?: any[]): Promise<void>;
+    subscribe(listener: (event: PiAgentEvent) => void): () => void;
+    abort(): void;
+}
+export {};
+//# sourceMappingURL=pi-agent-provider.d.ts.map

package/dist/backends/agent/pi-agent-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-agent-provider.d.ts","sourceRoot":"","sources":["../../../src/backends/agent/pi-agent-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAoB,MAAM,YAAY,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,eAAgB,YAAW,aAAa;IACnD,OAAO,CAAC,KAAK,CAAU;gBAEX,MAAM,EAAE,qBAAqB;IAInC,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC;CAG7C;AA+GD;;;;GAIG;AAGH,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IAEb,qBAAqB,CAAC,EAAE;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC/D,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/backends/agent/pi-agent-provider.js

@@ -0,0 +1,149 @@
+/**
+ * Pi Agent Provider
+ * Wraps a Pi Agent instance (@mariozechner/pi-agent-core) as an AgentProvider.
+ *
+ * The user creates the Agent externally with their own model, tools, and config.
+ * This provider wraps it and maps its event stream to AgentStreamEvents.
+ *
+ * @example
+ * ```typescript
+ * import { Agent } from '@mariozechner/pi-agent-core';
+ * import { getModel } from '@mariozechner/pi-ai';
+ * import { codingTools } from '@mariozechner/pi-coding-agent';
+ *
+ * const agent = new Agent({
+ *   initialState: {
+ *     systemPrompt: 'You are a coding assistant.',
+ *     model: getModel('anthropic', 'claude-sonnet-4-20250514'),
+ *     thinkingLevel: 'medium',
+ *     tools: codingTools,
+ *   },
+ * });
+ *
+ * const pipeline = createVoicePipeline({
+ *   create: () => ({
+ *     stt: new CloudSTT({ ... }),
+ *     llm: new AgentLLM(new PiAgentProvider({ agent })),
+ *     tts: null,
+ *     systemPrompt: 'You are a coding assistant.',
+ *   }),
+ * });
+ * ```
+ */
+/**
+ * Pi Agent Provider
+ * Wraps an externally-created Pi Agent instance.
+ */
+export class PiAgentProvider {
+    agent;
+    constructor(config) {
+        this.agent = config.agent;
+    }
+    async createSession() {
+        return new PiAgentSession(this.agent);
+    }
+}
+/**
+ * Active Pi Agent session.
+ * Wraps a Pi Agent instance and maps its event stream to AgentStreamEvents.
+ */
+class PiAgentSession {
+    agent;
+    constructor(agent) {
+        this.agent = agent;
+    }
+    async *sendMessage(text) {
+        // Use a queue to bridge the callback-based event system to an async iterable.
+        // The agent emits events via subscribe(), and we yield them from the generator.
+        const eventQueue = [];
+        let resolve = null;
+        let done = false;
+        const waitForEvent = () => new Promise((r) => {
+            if (eventQueue.length > 0) {
+                r();
+            }
+            else {
+                resolve = r;
+            }
+        });
+        const pushEvent = (event) => {
+            eventQueue.push(event);
+            if (resolve) {
+                const r = resolve;
+                resolve = null;
+                r();
+            }
+        };
+        // Subscribe to agent events
+        const unsubscribe = this.agent.subscribe((event) => {
+            const eventType = event.type;
+            if (eventType === 'message_update') {
+                // Streaming text delta from assistant
+                const assistantEvent = event.assistantMessageEvent;
+                if (assistantEvent?.type === 'text_delta' && assistantEvent.delta) {
+                    pushEvent({
+                        type: 'text_delta',
+                        content: assistantEvent.delta,
+                    });
+                }
+            }
+            else if (eventType === 'tool_execution_start') {
+                pushEvent({
+                    type: 'tool_call_start',
+                    toolCall: {
+                        id: event.toolCallId ?? '',
+                        name: event.toolName ?? 'unknown',
+                        arguments: event.args ?? {},
+                    },
+                });
+            }
+            else if (eventType === 'tool_execution_end') {
+                pushEvent({
+                    type: 'tool_call_end',
+                    toolCall: {
+                        id: event.toolCallId ?? '',
+                        name: event.toolName ?? 'unknown',
+                        result: event.result,
+                        isError: event.isError,
+                    },
+                });
+            }
+            else if (eventType === 'agent_end') {
+                pushEvent({ type: 'done' });
+                done = true;
+            }
+        });
+        try {
+            // Start the agent prompt (runs asynchronously, events come via subscribe)
+            const promptPromise = this.agent.prompt(text).catch((err) => {
+                pushEvent({
+                    type: 'error',
+                    error: err.message ?? 'Pi Agent error',
+                });
+                done = true;
+            });
+            // Yield events as they arrive
+            while (!done) {
+                await waitForEvent();
+                while (eventQueue.length > 0) {
+                    const event = eventQueue.shift();
+                    yield event;
+                    if (event.type === 'done' || event.type === 'error') {
+                        done = true;
+                        break;
+                    }
+                }
+            }
+            // Wait for prompt to fully complete
+            await promptPromise;
+        }
+        finally {
+            unsubscribe();
+        }
+    }
+    async destroy() {
+        this.agent.abort();
+    }
+}
+/* eslint-enable @typescript-eslint/no-explicit-any */
+//# sourceMappingURL=pi-agent-provider.js.map

package/dist/backends/agent/pi-agent-provider.js.map

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

package/dist/backends/agent/pi-coding-agent-provider.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Pi Coding Agent Provider
+ * Wraps a Pi Coding Agent session (@mariozechner/pi-coding-agent) as an AgentProvider.
+ *
+ * This is the higher-level wrapper compared to PiAgentProvider. The Pi Coding Agent
+ * adds session management, auto-compaction, retries, skill expansion, prompt templates,
+ * and built-in coding tools (read, write, edit, bash, grep, find, ls) on top of the
+ * raw Pi Agent runtime.
+ *
+ * The user creates the session externally via createAgentSession() and passes it in.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createAgentSession,
+ *   SessionManager,
+ *   AuthStorage,
+ *   ModelRegistry,
+ * } from '@mariozechner/pi-coding-agent';
+ *
+ * const authStorage = new AuthStorage();
+ * const { session } = await createAgentSession({
+ *   sessionManager: SessionManager.inMemory(),
+ *   authStorage,
+ *   modelRegistry: new ModelRegistry(authStorage),
+ * });
+ *
+ * const pipeline = createVoicePipeline({
+ *   create: () => ({
+ *     stt: new CloudSTT({ ... }),
+ *     llm: new AgentLLM(new PiCodingAgentProvider({ session })),
+ *     tts: null,
+ *     systemPrompt: 'You are a coding assistant.',
+ *   }),
+ * });
+ * ```
+ */
+import type { AgentProvider, AgentSession as VoiceAgentSession } from './provider';
+/**
+ * Configuration for the Pi Coding Agent provider.
+ */
+export interface PiCodingAgentProviderConfig {
+    /**
+     * A pre-created Pi Coding Agent session.
+     * Created externally via createAgentSession() from @mariozechner/pi-coding-agent.
+     */
+    session: PiCodingAgentSession;
+}
+/**
+ * Pi Coding Agent Provider
+ * Wraps an externally-created Pi Coding Agent session.
+ */
+export declare class PiCodingAgentProvider implements AgentProvider {
+    private session;
+    constructor(config: PiCodingAgentProviderConfig);
+    createSession(): Promise<VoiceAgentSession>;
+}
+/**
+ * Minimal type definitions for the Pi Coding Agent session.
+ * These match the AgentSession API surface from @mariozechner/pi-coding-agent
+ * without requiring the SDK at build time.
+ */
+interface PiAgentSessionEvent {
+    type: string;
+    assistantMessageEvent?: {
+        type: string;
+        delta?: string;
+    };
+    toolCallId?: string;
+    toolName?: string;
+    args?: Record<string, unknown>;
+    result?: any;
+    isError?: boolean;
+    messages?: any[];
+}
+export interface PiCodingAgentSession {
+    /** Send a prompt to the agent (handles skills, templates, validation, etc.) */
+    prompt(text: string, options?: any): Promise<void>;
+    /** Subscribe to session events. Returns unsubscribe function. */
+    subscribe(listener: (event: PiAgentSessionEvent) => void): () => void;
+    /** Clean up the session */
+    dispose(): void;
+    /** The underlying Agent instance */
+    agent: any;
+}
+export {};
+//# sourceMappingURL=pi-coding-agent-provider.d.ts.map

package/dist/backends/agent/pi-coding-agent-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-coding-agent-provider.d.ts","sourceRoot":"","sources":["../../../src/backends/agent/pi-coding-agent-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,IAAI,iBAAiB,EAAoB,MAAM,YAAY,CAAC;AAErG;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAED;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,aAAa;IACzD,OAAO,CAAC,OAAO,CAAuB;gBAE1B,MAAM,EAAE,2BAA2B;IAIzC,aAAa,IAAI,OAAO,CAAC,iBAAiB,CAAC;CAGlD;AAiHD;;;;GAIG;AAGH,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IAEb,qBAAqB,CAAC,EAAE;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,+EAA+E;IAC/E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,iEAAiE;IACjE,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACtE,2BAA2B;IAC3B,OAAO,IAAI,IAAI,CAAC;IAChB,oCAAoC;IACpC,KAAK,EAAE,GAAG,CAAC;CACZ"}

package/dist/backends/agent/pi-coding-agent-provider.js

@@ -0,0 +1,156 @@
+/**
+ * Pi Coding Agent Provider
+ * Wraps a Pi Coding Agent session (@mariozechner/pi-coding-agent) as an AgentProvider.
+ *
+ * This is the higher-level wrapper compared to PiAgentProvider. The Pi Coding Agent
+ * adds session management, auto-compaction, retries, skill expansion, prompt templates,
+ * and built-in coding tools (read, write, edit, bash, grep, find, ls) on top of the
+ * raw Pi Agent runtime.
+ *
+ * The user creates the session externally via createAgentSession() and passes it in.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createAgentSession,
+ *   SessionManager,
+ *   AuthStorage,
+ *   ModelRegistry,
+ * } from '@mariozechner/pi-coding-agent';
+ *
+ * const authStorage = new AuthStorage();
+ * const { session } = await createAgentSession({
+ *   sessionManager: SessionManager.inMemory(),
+ *   authStorage,
+ *   modelRegistry: new ModelRegistry(authStorage),
+ * });
+ *
+ * const pipeline = createVoicePipeline({
+ *   create: () => ({
+ *     stt: new CloudSTT({ ... }),
+ *     llm: new AgentLLM(new PiCodingAgentProvider({ session })),
+ *     tts: null,
+ *     systemPrompt: 'You are a coding assistant.',
+ *   }),
+ * });
+ * ```
+ */
+/**
+ * Pi Coding Agent Provider
+ * Wraps an externally-created Pi Coding Agent session.
+ */
+export class PiCodingAgentProvider {
+    session;
+    constructor(config) {
+        this.session = config.session;
+    }
+    async createSession() {
+        return new PiCodingAgentSessionAdapter(this.session);
+    }
+}
+/**
+ * Adapts a Pi Coding Agent session to the VoiceAgentSession interface.
+ * Maps AgentSessionEvents to AgentStreamEvents.
+ */
+class PiCodingAgentSessionAdapter {
+    session;
+    constructor(session) {
+        this.session = session;
+    }
+    async *sendMessage(text) {
+        // Use a queue to bridge the callback-based event system to an async iterable.
+        const eventQueue = [];
+        let resolve = null;
+        let done = false;
+        const waitForEvent = () => new Promise((r) => {
+            if (eventQueue.length > 0) {
+                r();
+            }
+            else {
+                resolve = r;
+            }
+        });
+        const pushEvent = (event) => {
+            eventQueue.push(event);
+            if (resolve) {
+                const r = resolve;
+                resolve = null;
+                r();
+            }
+        };
+        // Subscribe to session events.
+        // AgentSessionEvent extends AgentEvent, so we get all the core events
+        // plus session-level events (auto_compaction, auto_retry, etc.)
+        const unsubscribe = this.session.subscribe((event) => {
+            const eventType = event.type;
+            if (eventType === 'message_update') {
+                const assistantEvent = event.assistantMessageEvent;
+                if (assistantEvent?.type === 'text_delta' && assistantEvent.delta) {
+                    pushEvent({
+                        type: 'text_delta',
+                        content: assistantEvent.delta,
+                    });
+                }
+            }
+            else if (eventType === 'tool_execution_start') {
+                pushEvent({
+                    type: 'tool_call_start',
+                    toolCall: {
+                        id: event.toolCallId ?? '',
+                        name: event.toolName ?? 'unknown',
+                        arguments: event.args ?? {},
+                    },
+                });
+            }
+            else if (eventType === 'tool_execution_end') {
+                pushEvent({
+                    type: 'tool_call_end',
+                    toolCall: {
+                        id: event.toolCallId ?? '',
+                        name: event.toolName ?? 'unknown',
+                        result: event.result,
+                        isError: event.isError,
+                    },
+                });
+            }
+            else if (eventType === 'agent_end') {
+                pushEvent({ type: 'done' });
+                done = true;
+            }
+            // We silently ignore session-level events like auto_compaction_start/end,
+            // auto_retry_start/end — the session handles them internally.
+        });
+        try {
+            // Use session.prompt() which handles skill expansion, prompt templates,
+            // validation, auto-compaction, retries, etc.
+            const promptPromise = this.session.prompt(text).catch((err) => {
+                pushEvent({
+                    type: 'error',
+                    error: err.message ?? 'Pi Coding Agent error',
+                });
+                done = true;
+            });
+            // Yield events as they arrive
+            while (!done) {
+                await waitForEvent();
+                while (eventQueue.length > 0) {
+                    const event = eventQueue.shift();
+                    yield event;
+                    if (event.type === 'done' || event.type === 'error') {
+                        done = true;
+                        break;
+                    }
+                }
+            }
+            await promptPromise;
+        }
+        finally {
+            unsubscribe();
+        }
+    }
+    async destroy() {
+        this.session.dispose();
+    }
+}
+/* eslint-enable @typescript-eslint/no-explicit-any */
+//# sourceMappingURL=pi-coding-agent-provider.js.map

package/dist/backends/agent/pi-coding-agent-provider.js.map

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

package/dist/backends/agent/provider.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Agent Provider Interface
+ * Abstracts different agent SDKs (OpenCode, Pi Agent, etc.) behind a common interface.
+ *
+ * Agent SDKs manage their own tool execution loop internally.
+ * The provider streams events back so the voice pipeline can:
+ * - Stream text tokens to the client in real-time
+ * - Show tool activity in the UI (for feedback, not execution)
+ */
+/**
+ * Streaming event from an agent session.
+ * These events are emitted as the agent processes a message,
+ * including tool calls that the agent executes internally.
+ */
+export interface AgentStreamEvent {
+    type: 'text_delta' | 'tool_call_start' | 'tool_call_end' | 'error' | 'done';
+    /** Text content delta (for 'text_delta' events) */
+    content?: string;
+    /** Tool call information (for 'tool_call_start' and 'tool_call_end' events) */
+    toolCall?: {
+        id: string;
+        name: string;
+        arguments?: Record<string, unknown>;
+        result?: unknown;
+        isError?: boolean;
+    };
+    /** Error message (for 'error' events) */
+    error?: string;
+}
+/**
+ * An active agent session.
+ * Wraps the underlying SDK's session/agent instance.
+ * The session maintains its own conversation history internally.
+ */
+export interface AgentSession {
+    /**
+     * Send a message to the agent and stream back events.
+     * The agent handles tool execution internally — the caller
+     * only receives text deltas and tool activity notifications.
+     *
+     * @param text - User message text
+     * @returns Async iterable of stream events
+     */
+    sendMessage(text: string): AsyncIterable<AgentStreamEvent>;
+    /**
+     * Clean up the session and release resources.
+     */
+    destroy(): Promise<void>;
+}
+/**
+ * Provider that creates agent sessions.
+ * Each provider wraps a specific agent SDK.
+ */
+export interface AgentProvider {
+    /**
+     * Create a new agent session.
+     * The session manages its own conversation history, tool execution, etc.
+     */
+    createSession(): Promise<AgentSession>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/backends/agent/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/backends/agent/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,YAAY,GAAG,iBAAiB,GAAG,eAAe,GAAG,OAAO,GAAG,MAAM,CAAC;IAE5E,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE;QACT,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IAEF,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;OAOG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAE3D;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;CACxC"}

package/dist/backends/agent/provider.js

@@ -0,0 +1,11 @@
+/**
+ * Agent Provider Interface
+ * Abstracts different agent SDKs (OpenCode, Pi Agent, etc.) behind a common interface.
+ *
+ * Agent SDKs manage their own tool execution loop internally.
+ * The provider streams events back so the voice pipeline can:
+ * - Stream text tokens to the client in real-time
+ * - Show tool activity in the UI (for feedback, not execution)
+ */
+export {};
+//# sourceMappingURL=provider.js.map

package/dist/backends/agent/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/backends/agent/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/server/index.d.ts

@@ -26,7 +26,7 @@
  */
 export { createPipelineHandler, PipelineHandler, PipelineSession } from './handler';
 export type { PipelineHandlerConfig } from './handler';
-export { float32ToBase64, base64ToFloat32, type ClientMessage, type ServerMessage, type AudioMessage, type EndAudioMessage, type ClearHistoryMessage, type TranscriptMessage, type ResponseChunkMessage, type AudioResponseMessage, type CompleteMessage, type ErrorMessage, } from '../client/protocol';
+export { float32ToBase64, base64ToFloat32, generateId, type IdPrefix, type ClientEnvelope, type ServerEnvelope, type ClientMessage, type ServerMessage, type SessionInitMessage, type AudioMessage, type EndAudioMessage, type ClearHistoryMessage, type TextMessage, type TranscriptMessage, type ResponseChunkMessage, type AudioResponseMessage, type ToolCallMessage, type ToolResultMessage, type CompleteMessage, type ErrorMessage, } from '../client/protocol';
 export { float32ToBase64Node, base64ToFloat32Node } from './encoding';
 export type { Message } from '../types';
 //# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACpF,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAGvD,OAAO,EACL,eAAe,EACf,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGtE,YAAY,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACpF,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAGvD,OAAO,EACL,eAAe,EACf,eAAe,EACf,UAAU,EACV,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGtE,YAAY,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC"}

package/dist/server/index.js

@@ -26,7 +26,7 @@
  */
 export { createPipelineHandler, PipelineHandler, PipelineSession } from './handler';
 // Re-export protocol types for server use
-export { float32ToBase64, base64ToFloat32, } from '../client/protocol';
+export { float32ToBase64, base64ToFloat32, generateId, } from '../client/protocol';
 // Server-side encoding utilities (use Buffer for efficiency in Node.js)
 export { float32ToBase64Node, base64ToFloat32Node } from './encoding';
 //# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAGpF,0CAA0C;AAC1C,OAAO,EACL,eAAe,EACf,eAAe,GAWhB,MAAM,oBAAoB,CAAC;AAE5B,wEAAwE;AACxE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAGpF,0CAA0C;AAC1C,OAAO,EACL,eAAe,EACf,eAAe,EACf,UAAU,GAkBX,MAAM,oBAAoB,CAAC;AAE5B,wEAAwE;AACxE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "modular-voice-agent-sdk",
-  "version": "2.4.0",
+  "version": "2.5.1",
   "description": "Modular isomorphic STT → LLM → TTS pipeline library for AI voice agents and voice assistants",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,6 +26,10 @@
     "./server": {
       "import": "./dist/server/index.js",
       "types": "./dist/server/index.d.ts"
+    },
+    "./agent": {
+      "import": "./dist/backends/agent/index.js",
+      "types": "./dist/backends/agent/index.d.ts"
     }
   },
   "bin": {
@@ -51,11 +55,27 @@
     "ulid": "^3.0.2"
   },
   "peerDependencies": {
-    "ws": "^8.0.0"
+    "ws": "^8.0.0",
+    "@opencode-ai/sdk": "*",
+    "@mariozechner/pi-agent-core": "*",
+    "@mariozechner/pi-ai": "*",
+    "@mariozechner/pi-coding-agent": "*"
   },
   "peerDependenciesMeta": {
     "ws": {
       "optional": true
+    },
+    "@opencode-ai/sdk": {
+      "optional": true
+    },
+    "@mariozechner/pi-agent-core": {
+      "optional": true
+    },
+    "@mariozechner/pi-ai": {
+      "optional": true
+    },
+    "@mariozechner/pi-coding-agent": {
+      "optional": true
     }
   },
   "devDependencies": {