@kuralle-agents/hono-server 0.12.0 → 0.14.0

package/README.md

@@ -14,7 +14,7 @@ Peers: `@kuralle-agents/core`, `ai@^6`.
 
 `createKuralleChatRouter` mounts a complete set of endpoints onto a Hono app — HTTP chat, SSE streaming, WebSocket widget, session management, audit, CSAT, and a manual compression trigger — wired to any `RuntimeLike` instance.
 
-**As of 0.5.0, `POST /api/chat/sse` defaults to an AI SDK `UIMessageStream`** — a `useChat` client works with zero bridge code. Raw `HarnessStreamPart` JSON-SSE is opt-in via `?format=raw`.
+**As of 0.5.0, `POST /api/chat/sse` defaults to an AI SDK `UIMessageStream`** — a `useChat` client works with zero bridge code. Raw `StreamPart` JSON-SSE is opt-in via `?format=raw`.
 
 **Key exports:**
 
@@ -98,11 +98,11 @@ const server = serve({ fetch: app.fetch, port: 3000 });
 injectWebSocket(server);
 ```
 
-`POST /api/chat/sse` accepts `useChat`-shaped bodies (`{ messages: UIMessage[] }`) and returns a native `UIMessageStream`. No `HarnessStreamPart` → `UIMessageChunk` bridge required.
+`POST /api/chat/sse` accepts `useChat`-shaped bodies (`{ messages: UIMessage[] }`) and returns a native `UIMessageStream`. No `StreamPart` → `UIMessageChunk` bridge required.
 
 ## Raw JSON-SSE (`?format=raw`)
 
-Non-UI consumers (curl, Studio, custom transports) that parsed raw `HarnessStreamPart` JSON from 0.4.x should append `?format=raw`:
+Non-UI consumers (curl, Studio, custom transports) that parsed raw `StreamPart` JSON from 0.4.x should append `?format=raw`:
 
 ```bash
 curl -N -X POST 'http://localhost:3000/api/chat/sse?format=raw' \
@@ -117,7 +117,7 @@ Or use `createKuralleSseChatRouter` for a router that always emits raw JSON-SSE
 | Method | Path | Description |
 |--------|------|-------------|
 | `POST` | `/api/chat` | Single-turn JSON response |
-| `POST` | `/api/chat/sse` | **Default:** AI SDK `UIMessageStream` (`useChat`). **`?format=raw`:** legacy `HarnessStreamPart` JSON-SSE |
+| `POST` | `/api/chat/sse` | **Default:** AI SDK `UIMessageStream` (`useChat`). **`?format=raw`:** legacy `StreamPart` JSON-SSE |
 | `POST` | `/api/chat/stream` | Chunked plain-text stream |
 | `GET`  | `/agents/chat/:sessionId` | WebSocket widget endpoint |
 | `GET`  | `/ws/:sessionId` | WebSocket turn endpoint |
@@ -139,7 +139,6 @@ createKuralleChatRouter({
   upgradeWebSocket,
   widgetWelcomeMode: 'static',
   widgetWelcomeMessage: "Hello, how can I help you today?",
-  widgetWelcomeSuggestions: ['Check order status', 'Request a refund'],
 });
 ```
 

package/dist/chatRouter.js

@@ -23,45 +23,29 @@ export function createKuralleSseChatRouter({ runtime, streamFilter: streamFilter
             input: body.message,
             userId: body.userId,
         });
-        const responseStream = handle.toResponseStream('sse');
-        const reader = responseStream.getReader();
         const encoder = new TextEncoder();
         const filtered = new ReadableStream({
             async start(controller) {
                 try {
-                    while (true) {
-                        const { done, value } = await reader.read();
-                        if (done)
-                            break;
-                        const chunk = new TextDecoder().decode(value);
-                        for (const line of chunk.split('\n\n')) {
-                            if (!line.startsWith('data: '))
-                                continue;
-                            const raw = line.slice('data: '.length);
-                            if (!raw.trim())
-                                continue;
-                            let part;
-                            try {
-                                part = JSON.parse(raw);
-                            }
-                            catch {
-                                controller.enqueue(value);
-                                continue;
-                            }
-                            if (!shouldEmit(part, streamFilter))
-                                continue;
-                            const safe = sanitizeForClient(part);
-                            const payload = `data: ${JSON.stringify(safe)}\n\n`;
-                            controller.enqueue(encoder.encode(payload));
-                        }
+                    for await (const part of handle.events) {
+                        if (!shouldEmit(part, streamFilter))
+                            continue;
+                        const safe = sanitizeForClient(part);
+                        const payload = `data: ${JSON.stringify(safe)}\n\n`;
+                        controller.enqueue(encoder.encode(payload));
                     }
+                    await handle;
                     controller.close();
                 }
                 catch (error) {
                     const message = streamFilter === 'all'
                         ? error.message
                         : 'An error occurred. Please try again.';
-                    controller.enqueue(encoder.encode(`data: ${JSON.stringify({ type: 'error', error: message })}\n\n`));
+                    controller.enqueue(encoder.encode(`data: ${JSON.stringify({
+                        channel: 'client',
+                        type: 'error',
+                        payload: { error: message },
+                    })}\n\n`));
                     controller.close();
                 }
                 finally {

package/dist/index.d.ts

@@ -1,18 +1,12 @@
 import { Hono } from 'hono';
 import type { Context, Handler } from 'hono';
-import type { HarnessStreamPart, RuntimeLike } from '@kuralle-agents/core';
+import type { StreamPart, RuntimeLike } from '@kuralle-agents/core';
 export { createOpenAICompatRouter, type OpenAICompatRuntime, type CreateOpenAICompatRouterOptions, type ChatCompletionsRequest, } from './openaiCompat.js';
 export { shouldEmit, sanitizeForClient, type StreamEventFilter, } from './streamFilter.js';
 export { createKuralleSseChatRouter, type KuralleSseChatRouterOptions } from './chatRouter.js';
 import { type StreamEventFilter } from './streamFilter.js';
-type FlowStreamPart = {
-    type: string;
-    id?: string;
-    delta?: string;
-    error?: string;
-};
 type FlowRouterManager = {
-    process: (input: string) => AsyncGenerator<FlowStreamPart>;
+    process: (input: string) => AsyncGenerator<StreamPart>;
     currentNodeName: string;
     nodeHistory: string[];
     hasEnded: boolean;
@@ -57,6 +51,17 @@ export type FlowResponse = {
 export type KuralleWebSocket = {
     send: (data: string) => void;
 };
+export type WebSocketTransportFrame = {
+    type: 'connected';
+    sessionId: string;
+    timestamp: string;
+} | {
+    type: 'cancelled';
+    sessionId: string;
+    timestamp: string;
+} | {
+    type: 'pong';
+};
 export type WebSocketEvent = {
     data?: unknown;
 };
@@ -92,12 +97,8 @@ export type KuralleChatRouterOptions = {
      */
     widgetWelcomeMessage?: string;
     /**
-     * Optional static quick-reply suggestions for the initial widget state.
-     */
-    widgetWelcomeSuggestions?: string[];
-    /**
-     * Controls which HarnessStreamPart events are sent to external clients (SSE + widget/flow WebSockets).
-     * - `'safe'`: only user-facing events (text-delta, done, sanitized error, suggested-questions, input).
+     * Controls which StreamPart events are sent to external clients (SSE + widget/flow WebSockets).
+     * - `'safe'`: events classified as `client` by core, with errors sanitized.
      * - `'all'`: full stream (Studio / dev tooling).
      * - function: custom predicate; return true to emit.
      * @default 'safe'
@@ -108,7 +109,8 @@ export type KuralleRouterOptions = {
     flowManager: FlowRouterManager;
     sessionId: string;
     upgradeWebSocket?: UpgradeWebSocket;
+    streamFilter?: StreamEventFilter;
 };
-export declare const createKuralleChatRouter: ({ runtime, upgradeWebSocket, widgetWelcomeMode, sendWidgetWelcomeMessage, widgetWelcomeMessage, widgetWelcomeSuggestions, streamFilter: streamFilterOption, }: KuralleChatRouterOptions) => Hono;
-export type { HarnessStreamPart };
-export declare const createKuralleRouter: ({ flowManager, sessionId, upgradeWebSocket, }: KuralleRouterOptions) => Hono;
+export declare const createKuralleChatRouter: ({ runtime, upgradeWebSocket, widgetWelcomeMode, sendWidgetWelcomeMessage, widgetWelcomeMessage, streamFilter: streamFilterOption, }: KuralleChatRouterOptions) => Hono;
+export type { StreamPart };
+export declare const createKuralleRouter: ({ flowManager, sessionId, upgradeWebSocket, streamFilter: streamFilterOption, }: KuralleRouterOptions) => Hono;

package/dist/index.js

@@ -84,13 +84,13 @@ const collectResponse = async (runtime, message, sessionId, userId) => {
     let resolvedSessionId = sessionId ?? '';
     for await (const part of iterateRuntimeParts(runtime, { input: message, sessionId, userId })) {
         if (part.type === 'text-delta') {
-            response += part.delta;
+            response += part.payload.delta;
         }
         if (part.type === 'error') {
-            throw new Error(part.error);
+            throw new Error(part.payload.error);
         }
         if (part.type === 'done') {
-            resolvedSessionId = part.sessionId;
+            resolvedSessionId = part.payload.sessionId;
         }
     }
     return {
@@ -104,6 +104,19 @@ const sendSSEPart = async (stream, part, filter) => {
     const safe = sanitizeForClient(part);
     await stream.writeSSE({ event: safe.type, data: JSON.stringify(safe) });
 };
+const sendStreamPartToWs = (ws, part, filter) => {
+    if (!shouldEmit(part, filter))
+        return;
+    ws.send(JSON.stringify(sanitizeForClient(part)));
+};
+const sendTransportFrameToWs = (ws, frame) => {
+    ws.send(JSON.stringify(frame));
+};
+const errorPart = (message) => ({
+    channel: 'client',
+    type: 'error',
+    payload: { error: message },
+});
 const formatSessionResponse = (session) => ({
     sessionId: session.id,
     currentAgent: session.currentAgent ?? session.activeAgentId,
@@ -165,15 +178,11 @@ const resolveWidgetWelcomeMode = (mode, sendWidgetWelcomeMessage, widgetWelcomeM
         return 'static';
     return 'model';
 };
-export const createKuralleChatRouter = ({ runtime, upgradeWebSocket, widgetWelcomeMode, sendWidgetWelcomeMessage = true, widgetWelcomeMessage, widgetWelcomeSuggestions, streamFilter: streamFilterOption, }) => {
+export const createKuralleChatRouter = ({ runtime, upgradeWebSocket, widgetWelcomeMode, sendWidgetWelcomeMessage = true, widgetWelcomeMessage, streamFilter: streamFilterOption, }) => {
     const streamFilter = streamFilterOption ?? 'safe';
     const app = new Hono();
     const effectiveWelcomeMode = resolveWidgetWelcomeMode(widgetWelcomeMode, sendWidgetWelcomeMessage, widgetWelcomeMessage);
-    const sendHarnessPartToWs = (ws, part) => {
-        if (!shouldEmit(part, streamFilter))
-            return;
-        ws.send(JSON.stringify(sanitizeForClient(part)));
-    };
+    const sendHarnessPartToWs = (ws, part) => sendStreamPartToWs(ws, part, streamFilter);
     app.get('/health', (c) => c.json({ status: 'ok' }));
     app.post('/api/chat', async (c) => {
         const body = await parseJsonBody(c);
@@ -211,7 +220,7 @@ export const createKuralleChatRouter = ({ runtime, upgradeWebSocket, widgetWelco
                         userId: body.userId,
                     })) {
                         if (part.type === 'text-delta') {
-                            controller.enqueue(encoder.encode(part.delta));
+                            controller.enqueue(encoder.encode(part.payload.delta));
                         }
                     }
                 }
@@ -441,39 +450,38 @@ export const createKuralleChatRouter = ({ runtime, upgradeWebSocket, widgetWelco
                 onOpen: async (_event, ws) => {
                     debug(`[Kuralle] New widget connection: ${sessionId}`);
                     // Send connected message
-                    ws.send(JSON.stringify({
+                    sendTransportFrameToWs(ws, {
                         type: 'connected',
                         sessionId,
                         timestamp: new Date().toISOString(),
-                    }));
+                    });
                     if (effectiveWelcomeMode !== 'off') {
                         const staticWelcome = widgetWelcomeMessage?.trim();
                         if (effectiveWelcomeMode === 'static') {
                             const welcomeId = crypto.randomUUID();
-                            ws.send(JSON.stringify({ type: 'text-start', id: welcomeId }));
-                            ws.send(JSON.stringify({
+                            sendHarnessPartToWs(ws, {
+                                channel: 'client',
+                                type: 'text-start',
+                                payload: { id: welcomeId },
+                            });
+                            sendHarnessPartToWs(ws, {
+                                channel: 'client',
                                 type: 'text-delta',
-                                id: welcomeId,
-                                delta: staticWelcome || 'Hello! How can I help you today?',
-                            }));
-                            ws.send(JSON.stringify({ type: 'text-end', id: welcomeId }));
-                            const suggestions = (widgetWelcomeSuggestions ?? [])
-                                .filter((item) => typeof item === 'string')
-                                .map((item) => item.trim())
-                                .filter(Boolean)
-                                .slice(0, 3);
-                            if (suggestions.length > 0) {
-                                ws.send(JSON.stringify({
-                                    type: 'suggested-questions',
-                                    suggestions,
-                                    isPartial: false,
-                                }));
-                            }
-                            ws.send(JSON.stringify({
+                                payload: {
+                                    id: welcomeId,
+                                    delta: staticWelcome || 'Hello! How can I help you today?',
+                                },
+                            });
+                            sendHarnessPartToWs(ws, {
+                                channel: 'client',
+                                type: 'text-end',
+                                payload: { id: welcomeId },
+                            });
+                            sendHarnessPartToWs(ws, {
+                                channel: 'client',
                                 type: 'done',
-                                sessionId,
-                                timestamp: new Date().toISOString(),
-                            }));
+                                payload: { sessionId },
+                            });
                         }
                         else {
                             // Optionally start conversation with a generated greeting.
@@ -491,18 +499,29 @@ export const createKuralleChatRouter = ({ runtime, upgradeWebSocket, widgetWelco
                                 console.error(`[Kuralle] Failed to send greeting for session ${sessionId}:`, error);
                                 // Send a simple greeting if streaming fails
                                 const fallbackId = crypto.randomUUID();
-                                ws.send(JSON.stringify({ type: 'text-start', id: fallbackId }));
-                                ws.send(JSON.stringify({
+                                sendHarnessPartToWs(ws, {
+                                    channel: 'client',
+                                    type: 'text-start',
+                                    payload: { id: fallbackId },
+                                });
+                                sendHarnessPartToWs(ws, {
+                                    channel: 'client',
                                     type: 'text-delta',
-                                    id: fallbackId,
-                                    delta: 'Hello! How can I help you today?',
-                                }));
-                                ws.send(JSON.stringify({ type: 'text-end', id: fallbackId }));
-                                ws.send(JSON.stringify({
+                                    payload: {
+                                        id: fallbackId,
+                                        delta: 'Hello! How can I help you today?',
+                                    },
+                                });
+                                sendHarnessPartToWs(ws, {
+                                    channel: 'client',
+                                    type: 'text-end',
+                                    payload: { id: fallbackId },
+                                });
+                                sendHarnessPartToWs(ws, {
+                                    channel: 'client',
                                     type: 'done',
-                                    sessionId,
-                                    timestamp: new Date().toISOString(),
-                                }));
+                                    payload: { sessionId },
+                                });
                             }
                         }
                     }
@@ -513,7 +532,7 @@ export const createKuralleChatRouter = ({ runtime, upgradeWebSocket, widgetWelco
                         // Handle the widget's message format
                         const input = payload.message;
                         if (typeof input !== 'string' || !input.trim()) {
-                            ws.send(JSON.stringify({ type: 'error', error: 'message content required' }));
+                            sendHarnessPartToWs(ws, errorPart('message content required'));
                             return;
                         }
                         for await (const part of iterateRuntimeParts(runtime, {
@@ -526,12 +545,9 @@ export const createKuralleChatRouter = ({ runtime, upgradeWebSocket, widgetWelco
                     }
                     catch (error) {
                         console.error('[Kuralle] Widget WebSocket error:', error);
-                        ws.send(JSON.stringify({
-                            type: 'error',
-                            error: streamFilter === 'all'
-                                ? error.message
-                                : 'An error occurred. Please try again.',
-                        }));
+                        sendHarnessPartToWs(ws, errorPart(streamFilter === 'all'
+                            ? error.message
+                            : 'An error occurred. Please try again.'));
                     }
                 },
             };
@@ -542,11 +558,11 @@ export const createKuralleChatRouter = ({ runtime, upgradeWebSocket, widgetWelco
             const sessionId = c.req.param('sessionId') ?? '';
             return {
                 onOpen(_event, ws) {
-                    ws.send(JSON.stringify({
+                    sendTransportFrameToWs(ws, {
                         type: 'connected',
                         sessionId,
                         timestamp: new Date().toISOString(),
-                    }));
+                    });
                 },
                 async onMessage(event, ws) {
                     try {
@@ -554,17 +570,17 @@ export const createKuralleChatRouter = ({ runtime, upgradeWebSocket, widgetWelco
                         // Handle cancellation (barge-in)
                         if (payload.type === 'cancel') {
                             runtime.abortSession(sessionId, payload.reason ?? 'User interrupted');
-                            ws.send(JSON.stringify({
+                            sendTransportFrameToWs(ws, {
                                 type: 'cancelled',
                                 sessionId,
                                 timestamp: new Date().toISOString(),
-                            }));
+                            });
                             return;
                         }
                         const input = payload.content ?? payload.message;
                         if (payload.type === 'message') {
                             if (typeof input !== 'string' || !input.trim()) {
-                                ws.send(JSON.stringify({ type: 'error', error: 'message content required' }));
+                                sendHarnessPartToWs(ws, errorPart('message content required'));
                                 return;
                             }
                             for await (const part of iterateRuntimeParts(runtime, {
@@ -577,17 +593,14 @@ export const createKuralleChatRouter = ({ runtime, upgradeWebSocket, widgetWelco
                             return;
                         }
                         if (payload.type === 'ping') {
-                            ws.send(JSON.stringify({ type: 'pong' }));
+                            sendTransportFrameToWs(ws, { type: 'pong' });
                         }
                     }
                     catch (error) {
                         console.error('[Kuralle] Flow WebSocket error:', error);
-                        ws.send(JSON.stringify({
-                            type: 'error',
-                            error: streamFilter === 'all'
-                                ? error.message
-                                : 'An error occurred. Please try again.',
-                        }));
+                        sendHarnessPartToWs(ws, errorPart(streamFilter === 'all'
+                            ? error.message
+                            : 'An error occurred. Please try again.'));
                     }
                 },
             };
@@ -605,10 +618,10 @@ const collectFlowResponse = async (flowManager, message) => {
     let response = '';
     for await (const part of flowManager.process(message)) {
         if (part.type === 'text-delta') {
-            response += part.delta;
+            response += part.payload.delta;
         }
         if (part.type === 'error') {
-            throw new Error(part.error);
+            throw new Error(part.payload.error);
         }
     }
     return {
@@ -616,8 +629,9 @@ const collectFlowResponse = async (flowManager, message) => {
         hasEnded: flowManager.hasEnded,
     };
 };
-export const createKuralleRouter = ({ flowManager, sessionId, upgradeWebSocket, }) => {
+export const createKuralleRouter = ({ flowManager, sessionId, upgradeWebSocket, streamFilter: streamFilterOption, }) => {
     const app = new Hono();
+    const streamFilter = streamFilterOption ?? 'safe';
     app.get('/health', (c) => c.json({ status: 'ok' }));
     app.get('/info', (c) => c.json({
         sessionId,
@@ -670,7 +684,7 @@ export const createKuralleRouter = ({ flowManager, sessionId, upgradeWebSocket,
                 try {
                     for await (const part of flowManager.process(input)) {
                         if (part.type === 'text-delta') {
-                            controller.enqueue(encoder.encode(part.delta));
+                            controller.enqueue(encoder.encode(part.payload.delta));
                         }
                     }
                 }
@@ -713,36 +727,8 @@ export const createKuralleRouter = ({ flowManager, sessionId, upgradeWebSocket,
                 }
             });
         }
-        async function* flowHarnessParts() {
-            for await (const part of flowManager.process(input)) {
-                if (part.type === 'text-start' ||
-                    part.type === 'text-delta' ||
-                    part.type === 'text-end' ||
-                    part.type === 'text-cancel' ||
-                    part.type === 'tool-call' ||
-                    part.type === 'tool-result' ||
-                    part.type === 'node-enter' ||
-                    part.type === 'node-exit' ||
-                    part.type === 'flow-enter' ||
-                    part.type === 'flow-transition' ||
-                    part.type === 'flow-end' ||
-                    part.type === 'handoff' ||
-                    part.type === 'interactive' ||
-                    part.type === 'safety-blocked' ||
-                    part.type === 'pipeline-validation-block' ||
-                    part.type === 'conversation-outcome' ||
-                    part.type === 'interrupted' ||
-                    part.type === 'paused' ||
-                    part.type === 'custom' ||
-                    part.type === 'error' ||
-                    part.type === 'done' ||
-                    part.type === 'turn-end') {
-                    yield part;
-                }
-            }
-        }
         return createUIMessageStreamResponse({
-            stream: harnessToUIMessageStream(flowHarnessParts(), {
+            stream: harnessToUIMessageStream(flowManager.process(input), {
                 sessionId: bodySessionId ?? sessionId,
             }),
         });
@@ -752,11 +738,11 @@ export const createKuralleRouter = ({ flowManager, sessionId, upgradeWebSocket,
             onOpen(_event, ws) {
                 // Generate sessionId for this connection
                 const sessionId = `session_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
-                ws.send(JSON.stringify({
+                sendTransportFrameToWs(ws, {
                     type: 'connected',
                     sessionId,
                     timestamp: new Date().toISOString(),
-                }));
+                });
                 // Note: Automatic greeting would require async, but this is sync
                 // The greeting will be sent on first message instead
             },
@@ -766,7 +752,7 @@ export const createKuralleRouter = ({ flowManager, sessionId, upgradeWebSocket,
                     const input = payload.content ?? payload.message;
                     if (payload.type === 'message') {
                         if (typeof input !== 'string' || !input.trim()) {
-                            ws.send(JSON.stringify({ type: 'error', error: 'message content required' }));
+                            sendStreamPartToWs(ws, errorPart('message content required'), streamFilter);
                             return;
                         }
                         // For the first message, prepend a greeting
@@ -776,19 +762,16 @@ export const createKuralleRouter = ({ flowManager, sessionId, upgradeWebSocket,
                             fullInput = greeting + input;
                         }
                         for await (const part of flowManager.process(fullInput)) {
-                            ws.send(JSON.stringify(part));
+                            sendStreamPartToWs(ws, part, streamFilter);
                         }
                         return;
                     }
                     if (payload.type === 'ping') {
-                        ws.send(JSON.stringify({ type: 'pong' }));
+                        sendTransportFrameToWs(ws, { type: 'pong' });
                     }
                 }
                 catch (error) {
-                    ws.send(JSON.stringify({
-                        type: 'error',
-                        error: error.message,
-                    }));
+                    sendStreamPartToWs(ws, errorPart(error.message), streamFilter);
                 }
             }
         })));

package/dist/openaiCompat.js

@@ -175,16 +175,18 @@ async function collectTurn(handle, clientTools) {
         if (stopEarly)
             continue;
         if (part.type === 'text-delta') {
-            text += part.delta;
+            text += part.payload.delta;
         }
         else if (part.type === 'tool-call') {
-            if (!clientTools.has(part.toolName))
+            if (!clientTools.has(part.payload.toolName))
                 continue;
-            const argsStr = typeof part.args === 'string' ? part.args : JSON.stringify(part.args ?? {});
+            const argsStr = typeof part.payload.args === 'string'
+                ? part.payload.args
+                : JSON.stringify(part.payload.args ?? {});
             toolCalls.push({
                 index: toolCalls.length,
-                id: part.toolCallId ?? `call_${crypto.randomBytes(6).toString('hex')}`,
-                name: part.toolName,
+                id: part.payload.toolCallId ?? `call_${crypto.randomBytes(6).toString('hex')}`,
+                name: part.payload.toolName,
                 argsBuffer: argsStr,
                 nameSent: false,
                 argsSentLength: 0,
@@ -283,19 +285,21 @@ async function handleChatCompletions(c, body, opts) {
                     if (stopEarly)
                         continue;
                     if (part.type === 'text-delta') {
-                        if (!part.delta)
+                        if (!part.payload.delta)
                             continue;
-                        completionText += part.delta;
-                        await writeChunk({ content: part.delta });
+                        completionText += part.payload.delta;
+                        await writeChunk({ content: part.payload.delta });
                     }
                     else if (part.type === 'tool-call') {
-                        if (!clientToolSet.has(part.toolName))
+                        if (!clientToolSet.has(part.payload.toolName))
                             continue;
-                        const argsStr = typeof part.args === 'string' ? part.args : JSON.stringify(part.args ?? {});
+                        const argsStr = typeof part.payload.args === 'string'
+                            ? part.payload.args
+                            : JSON.stringify(part.payload.args ?? {});
                         const acc = {
                             index: pendingToolCalls.length,
-                            id: part.toolCallId ?? `call_${crypto.randomBytes(6).toString('hex')}`,
-                            name: part.toolName,
+                            id: part.payload.toolCallId ?? `call_${crypto.randomBytes(6).toString('hex')}`,
+                            name: part.payload.toolName,
                             argsBuffer: argsStr,
                             nameSent: false,
                             argsSentLength: 0,

package/dist/streamFilter.d.ts

@@ -1,13 +1,4 @@
-export type StreamEventFilter = 'safe' | 'all' | ((part: {
-    type: string;
-}) => boolean);
-export declare function shouldEmit(part: {
-    type: string;
-}, filter: StreamEventFilter): boolean;
-export declare function sanitizeForClient(part: {
-    type: string;
-    error?: string;
-}): {
-    type: string;
-    error?: string;
-};
+import type { StreamPart } from '@kuralle-agents/core';
+export type StreamEventFilter = 'safe' | 'all' | ((part: StreamPart) => boolean);
+export declare function shouldEmit(part: StreamPart, filter: StreamEventFilter): boolean;
+export declare function sanitizeForClient(part: StreamPart): StreamPart;

package/dist/streamFilter.js

@@ -1,28 +1,18 @@
-const SAFE_EVENT_TYPES = new Set([
-    'text-start',
-    'text-delta',
-    'text-end',
-    'text-cancel',
-    'text-clear',
-    'done',
-    'error',
-    'suggested-questions',
-    'conversation-outcome',
-    'knowledge-citation',
-    'knowledge-no-results',
-    'input',
-]);
+import { PART_CHANNEL } from '@kuralle-agents/core';
 export function shouldEmit(part, filter) {
     if (filter === 'all')
         return true;
     if (typeof filter === 'function')
         return filter(part);
-    return SAFE_EVENT_TYPES.has(part.type);
+    return PART_CHANNEL[part.type] === 'client';
 }
 export function sanitizeForClient(part) {
     if (part.type === 'error') {
-        console.error('[Kuralle] Client-facing error suppressed:', part.error);
-        return { type: 'error', error: 'An error occurred. Please try again.' };
+        console.error('[Kuralle] Client-facing error suppressed:', part.payload.error);
+        return {
+            ...part,
+            payload: { error: 'An error occurred. Please try again.' },
+        };
     }
     return part;
 }

package/package.json

@@ -4,9 +4,9 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/kuralle/kuralle-agents.git",
-    "directory": "packages/kuralle-hono-server"
+    "directory": "packages/hono-server"
   },
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Hono router for hosting Kuralle createRuntime() over HTTP, SSE, and WebSocket",
   "type": "module",
   "main": "dist/index.js",
@@ -20,10 +20,10 @@
   "dependencies": {
     "ai": "^6.0.0",
     "hono": "^4.0.0",
-    "@kuralle-agents/core": "0.12.0"
+    "@kuralle-agents/core": "0.14.0"
   },
   "peerDependencies": {
-    "@kuralle-agents/core": "0.12.0"
+    "@kuralle-agents/core": "0.14.0"
   },
   "devDependencies": {
     "@ai-sdk/openai": "^3.0.0",