@agentuity/runtime 0.1.13 → 0.1.14

package/dist/handlers/cron.js

@@ -1,49 +0,0 @@
-import { returnResponse } from '../_util';
-/**
- * Creates a cron middleware for scheduled task endpoints.
- *
- * **Important:** Cron endpoints must use POST method. The middleware will throw
- * an error if called with any other HTTP method.
- *
- * Use with router.post() to create a cron endpoint:
- *
- * @example
- * ```typescript
- * import { createRouter, cron } from '@agentuity/runtime';
- *
- * const router = createRouter();
- *
- * // Daily cleanup at midnight
- * router.post('/daily-cleanup', cron('0 0 * * *', (c) => {
- *   c.var.logger.info('Running daily cleanup');
- *   return { status: 'cleanup complete' };
- * }));
- *
- * // Hourly health check
- * router.post('/health-check', cron('0 * * * *', (c) => {
- *   c.var.logger.info('Running hourly health check');
- *   return c.text('OK');
- * }));
- * ```
- *
- * @param schedule - Cron expression (e.g., '0 0 * * *' for daily at midnight)
- * @param handler - Handler function to run on schedule
- * @returns Hono handler for cron endpoint
- */
-export function cron(schedule, handler) {
-    return async (c) => {
-        if (c.req.method !== 'POST') {
-            throw new Error(`Cron endpoint must use POST method, but received ${c.req.method}. ` +
-                `Use router.post() instead of router.${c.req.method.toLowerCase()}().`);
-        }
-        let result = handler(c);
-        if (result instanceof Promise) {
-            result = await result;
-        }
-        if (result instanceof Response) {
-            return result;
-        }
-        return returnResponse(c, result);
-    };
-}
-//# sourceMappingURL=cron.js.map

package/dist/handlers/cron.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cron.js","sourceRoot":"","sources":["../../src/handlers/cron.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAS1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,IAAI,CAAsB,QAAgB,EAAE,OAAuB;IAClF,OAAO,KAAK,EAAE,CAAa,EAAE,EAAE;QAC9B,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACd,oDAAoD,CAAC,CAAC,GAAG,CAAC,MAAM,IAAI;gBACnE,uCAAuC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CACvE,CAAC;QACH,CAAC;QAED,IAAI,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC/B,MAAM,GAAG,MAAM,MAAM,CAAC;QACvB,CAAC;QAED,IAAI,MAAM,YAAY,QAAQ,EAAE,CAAC;YAChC,OAAO,MAAM,CAAC;QACf,CAAC;QAED,OAAO,cAAc,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC,CAAC;AACH,CAAC"}

package/dist/handlers/index.d.ts

@@ -1,5 +0,0 @@
-export { websocket, type WebSocketConnection, type WebSocketHandler } from './websocket';
-export { sse, type SSEMessage, type SSEStream, type SSEHandler, STREAM_DONE_PROMISE_KEY, IS_STREAMING_RESPONSE_KEY, } from './sse';
-export { stream, type StreamHandler } from './stream';
-export { cron, type CronHandler, type CronMetadata } from './cron';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EACN,GAAG,EACH,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,UAAU,EACf,uBAAuB,EACvB,yBAAyB,GACzB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC"}

package/dist/handlers/index.js

@@ -1,5 +0,0 @@
-export { websocket } from './websocket';
-export { sse, STREAM_DONE_PROMISE_KEY, IS_STREAMING_RESPONSE_KEY, } from './sse';
-export { stream } from './stream';
-export { cron } from './cron';
-//# sourceMappingURL=index.js.map

package/dist/handlers/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAmD,MAAM,aAAa,CAAC;AACzF,OAAO,EACN,GAAG,EAIH,uBAAuB,EACvB,yBAAyB,GACzB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,MAAM,EAAsB,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,IAAI,EAAuC,MAAM,QAAQ,CAAC"}

package/dist/handlers/sse.d.ts

@@ -1,91 +0,0 @@
-import type { Context, Handler } from 'hono';
-import type { Env } from '../app';
-/**
- * Context variable key for stream completion promise.
- * Used by middleware to defer session/thread saving until stream completes.
- * @internal
- */
-export declare const STREAM_DONE_PROMISE_KEY = "_streamDonePromise";
-/**
- * Context variable key to indicate this is a streaming response.
- * @internal
- */
-export declare const IS_STREAMING_RESPONSE_KEY = "_isStreamingResponse";
-/**
- * SSE message format for Server-Sent Events.
- */
-export interface SSEMessage {
-    data: string;
-    event?: string;
-    id?: string;
-    retry?: number;
-}
-/**
- * SSE stream interface for writing Server-Sent Events.
- */
-export interface SSEStream {
-    /**
-     * Write a simple value as SSE data.
-     * Strings, numbers, and booleans are converted to string data.
-     * Objects are passed through as SSE message format.
-     */
-    write: (data: string | number | boolean | SSEMessage) => Promise<void>;
-    /**
-     * Write a properly formatted SSE message.
-     */
-    writeSSE: (message: SSEMessage) => Promise<void>;
-    /**
-     * Register a callback for when the client aborts the connection.
-     */
-    onAbort: (callback: () => void) => void;
-    /**
-     * Close the SSE stream.
-     */
-    close: () => void;
-}
-/**
- * Handler function for SSE connections.
- * Receives the Hono context and SSE stream with a flattened signature.
- */
-export type SSEHandler<E extends Env = Env> = (c: Context<E>, stream: SSEStream) => void | Promise<void>;
-/**
- * Creates an SSE (Server-Sent Events) middleware for streaming updates to clients.
- *
- * This implementation uses Hono's stream() helper instead of streamSSE() to ensure
- * compatibility with async operations that consume ReadableStreams internally
- * (like AI SDK's generateText/generateObject). The stream() helper uses a fire-and-forget
- * pattern that avoids "ReadableStream has already been used" errors.
- *
- * Use with router.get() to create an SSE endpoint:
- *
- * @example
- * ```typescript
- * import { createRouter, sse } from '@agentuity/runtime';
- *
- * const router = createRouter();
- *
- * router.get('/events', sse((c, stream) => {
- *   let count = 0;
- *   const interval = setInterval(() => {
- *     stream.writeSSE({
- *       data: `Event ${++count}`,
- *       event: 'update'
- *     });
- *     if (count >= 10) {
- *       clearInterval(interval);
- *       stream.close();
- *     }
- *   }, 1000);
- *
- *   stream.onAbort(() => {
- *     clearInterval(interval);
- *   });
- * }));
- * ```
- *
- * @param handler - Handler function receiving context and SSE stream
- * @returns Hono handler for SSE streaming
- * @see https://github.com/agentuity/sdk/issues/471
- */
-export declare function sse<E extends Env = Env>(handler: SSEHandler<E>): Handler<E>;
-//# sourceMappingURL=sse.d.ts.map

package/dist/handlers/sse.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/handlers/sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAI7C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAElC;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB;;;;OAIG;IACH,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE;;OAEG;IACH,QAAQ,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD;;OAEG;IACH,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACxC;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,IAAI,CAC7C,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EACb,MAAM,EAAE,SAAS,KACb,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AA2B1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CA8I3E"}

package/dist/handlers/sse.js

@@ -1,213 +0,0 @@
-import { stream as honoStream } from 'hono/streaming';
-import { context as otelContext, ROOT_CONTEXT } from '@opentelemetry/api';
-import { getAgentAsyncLocalStorage } from '../_context';
-/**
- * Context variable key for stream completion promise.
- * Used by middleware to defer session/thread saving until stream completes.
- * @internal
- */
-export const STREAM_DONE_PROMISE_KEY = '_streamDonePromise';
-/**
- * Context variable key to indicate this is a streaming response.
- * @internal
- */
-export const IS_STREAMING_RESPONSE_KEY = '_isStreamingResponse';
-/**
- * Format an SSE message according to the SSE specification.
- * @see https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events
- */
-function formatSSEMessage(message) {
-    let text = '';
-    if (message.event) {
-        text += `event: ${message.event}\n`;
-    }
-    if (message.id) {
-        text += `id: ${message.id}\n`;
-    }
-    if (typeof message.retry === 'number') {
-        text += `retry: ${message.retry}\n`;
-    }
-    // Data can be multiline - each line needs its own "data:" prefix
-    const dataLines = message.data.split(/\r?\n/);
-    for (const line of dataLines) {
-        text += `data: ${line}\n`;
-    }
-    // SSE messages are terminated by a blank line
-    text += '\n';
-    return text;
-}
-/**
- * Creates an SSE (Server-Sent Events) middleware for streaming updates to clients.
- *
- * This implementation uses Hono's stream() helper instead of streamSSE() to ensure
- * compatibility with async operations that consume ReadableStreams internally
- * (like AI SDK's generateText/generateObject). The stream() helper uses a fire-and-forget
- * pattern that avoids "ReadableStream has already been used" errors.
- *
- * Use with router.get() to create an SSE endpoint:
- *
- * @example
- * ```typescript
- * import { createRouter, sse } from '@agentuity/runtime';
- *
- * const router = createRouter();
- *
- * router.get('/events', sse((c, stream) => {
- *   let count = 0;
- *   const interval = setInterval(() => {
- *     stream.writeSSE({
- *       data: `Event ${++count}`,
- *       event: 'update'
- *     });
- *     if (count >= 10) {
- *       clearInterval(interval);
- *       stream.close();
- *     }
- *   }, 1000);
- *
- *   stream.onAbort(() => {
- *     clearInterval(interval);
- *   });
- * }));
- * ```
- *
- * @param handler - Handler function receiving context and SSE stream
- * @returns Hono handler for SSE streaming
- * @see https://github.com/agentuity/sdk/issues/471
- */
-export function sse(handler) {
-    return (c) => {
-        const asyncLocalStorage = getAgentAsyncLocalStorage();
-        const capturedContext = asyncLocalStorage.getStore();
-        // Track stream completion for deferred session/thread saving
-        // This promise resolves when the stream closes (normally or via abort)
-        let resolveDone;
-        let rejectDone;
-        const donePromise = new Promise((resolve, reject) => {
-            resolveDone = resolve;
-            rejectDone = reject;
-        });
-        // Prevent unhandled rejection warnings if no middleware consumes donePromise.
-        // The error is still propagated via the rejection for middleware that awaits it.
-        donePromise.catch(() => {
-            // Intentionally empty - error is logged in runInContext catch block
-        });
-        // Idempotent function to mark stream as completed
-        let isDone = false;
-        const markDone = (error) => {
-            if (isDone)
-                return;
-            isDone = true;
-            if (error && rejectDone) {
-                rejectDone(error);
-            }
-            else if (resolveDone) {
-                resolveDone();
-            }
-        };
-        // Expose completion tracking to middleware
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        c.set(STREAM_DONE_PROMISE_KEY, donePromise);
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        c.set(IS_STREAMING_RESPONSE_KEY, true);
-        // Set SSE-specific headers
-        c.header('Content-Type', 'text/event-stream');
-        c.header('Cache-Control', 'no-cache');
-        c.header('Connection', 'keep-alive');
-        // Use honoStream instead of honoStreamSSE.
-        // honoStream uses a fire-and-forget async IIFE pattern that returns the Response
-        // immediately while the handler runs in the background. This is critical for
-        // compatibility with AI SDK's generateText/generateObject which use fetch()
-        // internally. With honoStreamSSE, the callback is awaited before returning,
-        // which causes "ReadableStream has already been used" errors when fetch
-        // response streams are consumed in the same async chain.
-        // See: https://github.com/agentuity/sdk/issues/471
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        return honoStream(c, async (s) => {
-            const encoder = new TextEncoder();
-            // Track if user registered an onAbort callback
-            let userAbortCallback;
-            // Internal function to write an SSE message
-            const writeSSEInternal = async (message) => {
-                const formatted = formatSSEMessage(message);
-                await s.write(encoder.encode(formatted));
-            };
-            const wrappedStream = {
-                write: async (data) => {
-                    if (typeof data === 'string' ||
-                        typeof data === 'number' ||
-                        typeof data === 'boolean') {
-                        return writeSSEInternal({ data: String(data) });
-                    }
-                    else if (typeof data === 'object' && data !== null) {
-                        return writeSSEInternal(data);
-                    }
-                    return writeSSEInternal({ data: String(data) });
-                },
-                writeSSE: writeSSEInternal,
-                onAbort: (callback) => {
-                    userAbortCallback = callback;
-                    s.onAbort(() => {
-                        try {
-                            callback();
-                        }
-                        finally {
-                            // Mark stream as done on abort
-                            markDone();
-                        }
-                    });
-                },
-                close: () => {
-                    try {
-                        s.close?.();
-                    }
-                    finally {
-                        // Mark stream as done on close
-                        markDone();
-                    }
-                },
-            };
-            // Always register internal abort handler if user doesn't register one
-            // This ensures we track completion even if user doesn't call onAbort
-            s.onAbort(() => {
-                if (!userAbortCallback) {
-                    // Only mark done if user didn't register their own handler
-                    // (their handler wrapper already calls markDone)
-                    markDone();
-                }
-            });
-            const runInContext = async () => {
-                try {
-                    await handler(c, wrappedStream);
-                    markDone();
-                }
-                catch (err) {
-                    // Log error but don't rethrow - would be unhandled rejection
-                    c.var.logger?.error?.('SSE handler error:', err);
-                    markDone(err);
-                }
-            };
-            // Run handler with AsyncLocalStorage context propagation.
-            // honoStream already uses a fire-and-forget pattern internally,
-            // so we can safely await here - the response is already being sent.
-            //
-            // IMPORTANT: We run in ROOT_CONTEXT (no active OTEL span) to avoid a Bun bug
-            // where OTEL-instrumented fetch conflicts with streaming responses.
-            // This causes "ReadableStream has already been used" errors when AI SDK's
-            // generateText/generateObject (which use fetch + stream.tee() internally)
-            // are called inside SSE handlers. Running without an active span makes
-            // our OTEL fetch wrapper use the original unpatched fetch.
-            // See: https://github.com/agentuity/sdk/issues/471
-            // See: https://github.com/oven-sh/bun/issues/24766
-            await otelContext.with(ROOT_CONTEXT, async () => {
-                if (capturedContext) {
-                    await asyncLocalStorage.run(capturedContext, runInContext);
-                }
-                else {
-                    await runInContext();
-                }
-            });
-        });
-    };
-}
-//# sourceMappingURL=sse.js.map

package/dist/handlers/sse.js.map

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

package/dist/handlers/stream.d.ts

@@ -1,52 +0,0 @@
-import type { Context, Handler } from 'hono';
-import type { Env } from '../app';
-/**
- * Handler function for streaming responses.
- * Returns a ReadableStream that will be piped to the response.
- */
-export type StreamHandler<E extends Env = Env> = (c: Context<E>) => ReadableStream<Uint8Array | string> | Promise<ReadableStream<Uint8Array | string>>;
-/**
- * Creates a streaming middleware for returning ReadableStream responses.
- *
- * Use with router.post() (or any HTTP method) to create a streaming endpoint:
- *
- * @example
- * ```typescript
- * import { createRouter, stream } from '@agentuity/runtime';
- *
- * const router = createRouter();
- *
- * router.post('/events', stream((c) => {
- *   return new ReadableStream({
- *     start(controller) {
- *       controller.enqueue('event 1\n');
- *       controller.enqueue('event 2\n');
- *       controller.close();
- *     }
- *   });
- * }));
- * ```
- *
- * @example
- * ```typescript
- * // Async stream with data from request body
- * router.post('/process', stream(async (c) => {
- *   const body = await c.req.json();
- *
- *   return new ReadableStream({
- *     async start(controller) {
- *       for (const item of body.items) {
- *         controller.enqueue(`Processing: ${item}\n`);
- *         await new Promise(r => setTimeout(r, 100));
- *       }
- *       controller.close();
- *     }
- *   });
- * }));
- * ```
- *
- * @param handler - Handler function returning a ReadableStream
- * @returns Hono handler for streaming response
- */
-export declare function stream<E extends Env = Env>(handler: StreamHandler<E>): Handler<E>;
-//# sourceMappingURL=stream.d.ts.map

package/dist/handlers/stream.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/handlers/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAI7C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAGlC;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,IAAI,CAChD,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,KACT,cAAc,CAAC,UAAU,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC;AAExF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAqEjF"}

package/dist/handlers/stream.js

@@ -1,116 +0,0 @@
-import { stream as honoStream } from 'hono/streaming';
-import { context as otelContext, ROOT_CONTEXT } from '@opentelemetry/api';
-import { getAgentAsyncLocalStorage } from '../_context';
-import { STREAM_DONE_PROMISE_KEY, IS_STREAMING_RESPONSE_KEY } from './sse';
-/**
- * Creates a streaming middleware for returning ReadableStream responses.
- *
- * Use with router.post() (or any HTTP method) to create a streaming endpoint:
- *
- * @example
- * ```typescript
- * import { createRouter, stream } from '@agentuity/runtime';
- *
- * const router = createRouter();
- *
- * router.post('/events', stream((c) => {
- *   return new ReadableStream({
- *     start(controller) {
- *       controller.enqueue('event 1\n');
- *       controller.enqueue('event 2\n');
- *       controller.close();
- *     }
- *   });
- * }));
- * ```
- *
- * @example
- * ```typescript
- * // Async stream with data from request body
- * router.post('/process', stream(async (c) => {
- *   const body = await c.req.json();
- *
- *   return new ReadableStream({
- *     async start(controller) {
- *       for (const item of body.items) {
- *         controller.enqueue(`Processing: ${item}\n`);
- *         await new Promise(r => setTimeout(r, 100));
- *       }
- *       controller.close();
- *     }
- *   });
- * }));
- * ```
- *
- * @param handler - Handler function returning a ReadableStream
- * @returns Hono handler for streaming response
- */
-export function stream(handler) {
-    return (c) => {
-        const asyncLocalStorage = getAgentAsyncLocalStorage();
-        const capturedContext = asyncLocalStorage.getStore();
-        // Track stream completion for deferred session/thread saving
-        // This promise resolves when the stream completes (pipe finishes or errors)
-        let resolveDone;
-        let rejectDone;
-        const donePromise = new Promise((resolve, reject) => {
-            resolveDone = resolve;
-            rejectDone = reject;
-        });
-        // Idempotent function to mark stream as completed
-        let isDone = false;
-        const markDone = (error) => {
-            if (isDone)
-                return;
-            isDone = true;
-            if (error && rejectDone) {
-                rejectDone(error);
-            }
-            else if (resolveDone) {
-                resolveDone();
-            }
-        };
-        // Expose completion tracking to middleware
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        c.set(STREAM_DONE_PROMISE_KEY, donePromise);
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        c.set(IS_STREAMING_RESPONSE_KEY, true);
-        c.header('Content-Type', 'application/octet-stream');
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        return honoStream(c, async (s) => {
-            const runInContext = async () => {
-                try {
-                    let streamResult = handler(c);
-                    if (streamResult instanceof Promise) {
-                        streamResult = await streamResult;
-                    }
-                    await s.pipe(streamResult);
-                    // Stream completed successfully
-                    markDone();
-                }
-                catch (err) {
-                    c.var.logger?.error('Stream error:', err);
-                    markDone(err);
-                    throw err;
-                }
-            };
-            // IMPORTANT: We run in ROOT_CONTEXT (no active OTEL span) to avoid a Bun bug
-            // where OTEL-instrumented fetch conflicts with streaming responses.
-            // This causes "ReadableStream has already been used" errors when AI SDK's
-            // generateText/generateObject (which use fetch + stream.tee() internally)
-            // are called inside stream handlers. Running without an active span makes
-            // our OTEL fetch wrapper use the original unpatched fetch.
-            // See: https://github.com/agentuity/sdk/issues/471
-            // See: https://github.com/oven-sh/bun/issues/24766
-            await otelContext.with(ROOT_CONTEXT, async () => {
-                if (capturedContext) {
-                    await asyncLocalStorage.run(capturedContext, runInContext);
-                }
-                else {
-                    await runInContext();
-                }
-            });
-        });
-    };
-}
-//# sourceMappingURL=stream.js.map

package/dist/handlers/stream.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/handlers/stream.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,OAAO,CAAC;AAU3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,UAAU,MAAM,CAAsB,OAAyB;IACpE,OAAO,CAAC,CAAa,EAAE,EAAE;QACxB,MAAM,iBAAiB,GAAG,yBAAyB,EAAE,CAAC;QACtD,MAAM,eAAe,GAAG,iBAAiB,CAAC,QAAQ,EAAE,CAAC;QAErD,6DAA6D;QAC7D,4EAA4E;QAC5E,IAAI,WAAqC,CAAC;QAC1C,IAAI,UAAoD,CAAC;QACzD,MAAM,WAAW,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACzD,WAAW,GAAG,OAAO,CAAC;YACtB,UAAU,GAAG,MAAM,CAAC;QACrB,CAAC,CAAC,CAAC;QAEH,kDAAkD;QAClD,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,MAAM,QAAQ,GAAG,CAAC,KAAe,EAAE,EAAE;YACpC,IAAI,MAAM;gBAAE,OAAO;YACnB,MAAM,GAAG,IAAI,CAAC;YACd,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;gBACzB,UAAU,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC;iBAAM,IAAI,WAAW,EAAE,CAAC;gBACxB,WAAW,EAAE,CAAC;YACf,CAAC;QACF,CAAC,CAAC;QAEF,2CAA2C;QAC3C,8DAA8D;QAC7D,CAAS,CAAC,GAAG,CAAC,uBAAuB,EAAE,WAAW,CAAC,CAAC;QACrD,8DAA8D;QAC7D,CAAS,CAAC,GAAG,CAAC,yBAAyB,EAAE,IAAI,CAAC,CAAC;QAEhD,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,0BAA0B,CAAC,CAAC;QAErD,8DAA8D;QAC9D,OAAO,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAM,EAAE,EAAE;YACrC,MAAM,YAAY,GAAG,KAAK,IAAI,EAAE;gBAC/B,IAAI,CAAC;oBACJ,IAAI,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;oBAC9B,IAAI,YAAY,YAAY,OAAO,EAAE,CAAC;wBACrC,YAAY,GAAG,MAAM,YAAY,CAAC;oBACnC,CAAC;oBACD,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;oBAC3B,gCAAgC;oBAChC,QAAQ,EAAE,CAAC;gBACZ,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACd,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;oBAC1C,QAAQ,CAAC,GAAG,CAAC,CAAC;oBACd,MAAM,GAAG,CAAC;gBACX,CAAC;YACF,CAAC,CAAC;YAEF,6EAA6E;YAC7E,oEAAoE;YACpE,0EAA0E;YAC1E,0EAA0E;YAC1E,0EAA0E;YAC1E,2DAA2D;YAC3D,mDAAmD;YACnD,mDAAmD;YACnD,MAAM,WAAW,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE;gBAC/C,IAAI,eAAe,EAAE,CAAC;oBACrB,MAAM,iBAAiB,CAAC,GAAG,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;gBAC5D,CAAC;qBAAM,CAAC;oBACP,MAAM,YAAY,EAAE,CAAC;gBACtB,CAAC;YACF,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC;AACH,CAAC"}

package/dist/handlers/websocket.d.ts

@@ -1,49 +0,0 @@
-import type { Context, MiddlewareHandler } from 'hono';
-import type { Env } from '../app';
-/**
- * WebSocket connection interface for handling WebSocket events.
- */
-export interface WebSocketConnection {
-    onOpen: (handler: (event: Event) => void | Promise<void>) => void;
-    onMessage: (handler: (event: MessageEvent) => void | Promise<void>) => void;
-    onClose: (handler: (event: CloseEvent) => void | Promise<void>) => void;
-    send: (data: string | ArrayBuffer | Uint8Array) => void;
-}
-/**
- * Handler function for WebSocket connections.
- * Receives the Hono context and WebSocket connection with a flattened signature.
- */
-export type WebSocketHandler<E extends Env = Env> = (c: Context<E>, ws: WebSocketConnection) => void | Promise<void>;
-/**
- * Creates a WebSocket middleware for handling WebSocket connections.
- *
- * Use with router.get() to create a WebSocket endpoint:
- *
- * @example
- * ```typescript
- * import { createRouter, websocket } from '@agentuity/runtime';
- *
- * const router = createRouter();
- *
- * router.get('/ws', websocket((c, ws) => {
- *   ws.onOpen(() => {
- *     c.var.logger.info('WebSocket opened');
- *     ws.send('Welcome!');
- *   });
- *
- *   ws.onMessage((event) => {
- *     c.var.logger.info('Received:', event.data);
- *     ws.send('Echo: ' + event.data);
- *   });
- *
- *   ws.onClose(() => {
- *     c.var.logger.info('WebSocket closed');
- *   });
- * }));
- * ```
- *
- * @param handler - Handler function receiving context and WebSocket connection
- * @returns Hono middleware handler for WebSocket upgrade
- */
-export declare function websocket<E extends Env = Env>(handler: WebSocketHandler<E>): MiddlewareHandler<E>;
-//# sourceMappingURL=websocket.d.ts.map

package/dist/handlers/websocket.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/handlers/websocket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAIvD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAClE,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAC5E,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IACxE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,KAAK,IAAI,CAAC;CACxD;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,IAAI,CACnD,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EACb,EAAE,EAAE,mBAAmB,KACnB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CA6GjG"}