@agentuity/runtime 0.0.104 → 0.0.106

package/dist/handlers/sse.d.ts

@@ -0,0 +1,74 @@
+import type { Context, Handler } from 'hono';
+import type { Env } from '../app';
+/**
+ * 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.
+ *
+ * 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
+ */
+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

@@ -0,0 +1 @@
+{"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;AAG7C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAElC;;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;AAE1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAoC3E"}

package/dist/handlers/sse.js

@@ -0,0 +1,70 @@
+import { streamSSE as honoStreamSSE } from 'hono/streaming';
+import { getAgentAsyncLocalStorage } from '../_context';
+/**
+ * Creates an SSE (Server-Sent Events) middleware for streaming updates to clients.
+ *
+ * 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
+ */
+export function sse(handler) {
+    return (c) => {
+        const asyncLocalStorage = getAgentAsyncLocalStorage();
+        const capturedContext = asyncLocalStorage.getStore();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return honoStreamSSE(c, async (stream) => {
+            const wrappedStream = {
+                write: async (data) => {
+                    if (typeof data === 'string' ||
+                        typeof data === 'number' ||
+                        typeof data === 'boolean') {
+                        return stream.writeSSE({ data: String(data) });
+                    }
+                    else if (typeof data === 'object' && data !== null) {
+                        return stream.writeSSE(data);
+                    }
+                    return stream.writeSSE({ data: String(data) });
+                },
+                writeSSE: stream.writeSSE.bind(stream),
+                onAbort: stream.onAbort.bind(stream),
+                close: stream.close?.bind(stream) ?? (() => { }),
+            };
+            const runInContext = async () => {
+                await handler(c, wrappedStream);
+            };
+            if (capturedContext) {
+                await asyncLocalStorage.run(capturedContext, runInContext);
+            }
+            else {
+                await runInContext();
+            }
+        });
+    };
+}
+//# sourceMappingURL=sse.js.map

package/dist/handlers/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/handlers/sse.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AA8CxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,GAAG,CAAsB,OAAsB;IAC9D,OAAO,CAAC,CAAa,EAAE,EAAE;QACxB,MAAM,iBAAiB,GAAG,yBAAyB,EAAE,CAAC;QACtD,MAAM,eAAe,GAAG,iBAAiB,CAAC,QAAQ,EAAE,CAAC;QAErD,8DAA8D;QAC9D,OAAO,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,MAAW,EAAE,EAAE;YAC7C,MAAM,aAAa,GAAc;gBAChC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;oBACrB,IACC,OAAO,IAAI,KAAK,QAAQ;wBACxB,OAAO,IAAI,KAAK,QAAQ;wBACxB,OAAO,IAAI,KAAK,SAAS,EACxB,CAAC;wBACF,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBAChD,CAAC;yBAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;wBACtD,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;oBAC9B,CAAC;oBACD,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAChD,CAAC;gBACD,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;gBACtC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;gBACpC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;aAC/C,CAAC;YAEF,MAAM,YAAY,GAAG,KAAK,IAAI,EAAE;gBAC/B,MAAM,OAAO,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;YACjC,CAAC,CAAC;YAEF,IAAI,eAAe,EAAE,CAAC;gBACrB,MAAM,iBAAiB,CAAC,GAAG,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;YAC5D,CAAC;iBAAM,CAAC;gBACP,MAAM,YAAY,EAAE,CAAC;YACtB,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC;AACH,CAAC"}

package/dist/handlers/stream.d.ts

@@ -0,0 +1,52 @@
+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

@@ -0,0 +1 @@
+{"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;AAG7C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAElC;;;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,CA6BjF"}

package/dist/handlers/stream.js

@@ -0,0 +1,75 @@
+import { stream as honoStream } from 'hono/streaming';
+import { getAgentAsyncLocalStorage } from '../_context';
+/**
+ * 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();
+        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);
+                }
+                catch (err) {
+                    c.var.logger?.error('Stream error:', err);
+                    throw err;
+                }
+            };
+            if (capturedContext) {
+                await asyncLocalStorage.run(capturedContext, runInContext);
+            }
+            else {
+                await runInContext();
+            }
+        });
+    };
+}
+//# sourceMappingURL=stream.js.map

package/dist/handlers/stream.js.map

@@ -0,0 +1 @@
+{"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,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAWxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,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;gBAC5B,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACd,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;oBAC1C,MAAM,GAAG,CAAC;gBACX,CAAC;YACF,CAAC,CAAC;YAEF,IAAI,eAAe,EAAE,CAAC;gBACrB,MAAM,iBAAiB,CAAC,GAAG,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;YAC5D,CAAC;iBAAM,CAAC;gBACP,MAAM,YAAY,EAAE,CAAC;YACtB,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC;AACH,CAAC"}

package/dist/handlers/websocket.d.ts

@@ -0,0 +1,49 @@
+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

@@ -0,0 +1 @@
+{"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;AAGvD,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,CAiGjG"}

package/dist/handlers/websocket.js

@@ -0,0 +1,130 @@
+import { upgradeWebSocket } from 'hono/bun';
+import { getAgentAsyncLocalStorage } from '../_context';
+/**
+ * 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 function websocket(handler) {
+    const wsHandler = upgradeWebSocket((c) => {
+        let openHandler;
+        let messageHandler;
+        let closeHandler;
+        let initialized = false;
+        const asyncLocalStorage = getAgentAsyncLocalStorage();
+        const capturedContext = asyncLocalStorage.getStore();
+        const wsConnection = {
+            onOpen: (h) => {
+                openHandler = h;
+            },
+            onMessage: (h) => {
+                messageHandler = h;
+            },
+            onClose: (h) => {
+                closeHandler = h;
+            },
+            send: (_data) => {
+                // This will be bound to the actual ws in the handlers
+            },
+        };
+        const runHandler = () => {
+            if (capturedContext) {
+                asyncLocalStorage.run(capturedContext, () => handler(c, wsConnection));
+            }
+            else {
+                handler(c, wsConnection);
+            }
+            initialized = true;
+        };
+        runHandler();
+        return {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            onOpen: async (event, ws) => {
+                try {
+                    wsConnection.send = (data) => ws.send(data);
+                    if (openHandler) {
+                        const h = openHandler;
+                        if (capturedContext) {
+                            await asyncLocalStorage.run(capturedContext, () => h(event));
+                        }
+                        else {
+                            await h(event);
+                        }
+                    }
+                }
+                catch (err) {
+                    c.var.logger?.error('WebSocket onOpen error:', err);
+                    throw err;
+                }
+            },
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            onMessage: async (event, ws) => {
+                try {
+                    if (!initialized) {
+                        wsConnection.send = (data) => ws.send(data);
+                        runHandler();
+                    }
+                    if (messageHandler) {
+                        const h = messageHandler;
+                        if (capturedContext) {
+                            await asyncLocalStorage.run(capturedContext, () => h(event));
+                        }
+                        else {
+                            await h(event);
+                        }
+                    }
+                }
+                catch (err) {
+                    c.var.logger?.error('WebSocket onMessage error:', err);
+                    throw err;
+                }
+            },
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            onClose: async (event, _ws) => {
+                try {
+                    if (closeHandler) {
+                        const h = closeHandler;
+                        if (capturedContext) {
+                            await asyncLocalStorage.run(capturedContext, () => h(event));
+                        }
+                        else {
+                            await h(event);
+                        }
+                    }
+                }
+                catch (err) {
+                    c.var.logger?.error('WebSocket onClose error:', err);
+                }
+            },
+        };
+    });
+    const middleware = (c, next) => wsHandler(c, next);
+    return middleware;
+}
+//# sourceMappingURL=websocket.js.map

package/dist/handlers/websocket.js.map

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

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export { enableProcessExitProtection } from './_process-protection';
 export { internalExit } from './_process-protection';
 export { registerDevModeRoutes } from './devmode';
 export { type HonoEnv, type WebSocketConnection, createRouter } from './router';
+export { websocket, type WebSocketHandler, sse, type SSEMessage, type SSEStream, type SSEHandler, stream, type StreamHandler, cron, type CronHandler, type CronMetadata, } from './handlers';
 export { EvalHandlerResultSchema, type EvalContext, type EvalRunResultMetadata, type EvalHandlerResult, type EvalRunResultSuccess, type EvalRunResultError, type EvalRunResult, type CreateEvalRunRequest, type ExternalEvalMetadata, type EvalMetadata, type EvalFunction, type Eval, } from './eval';
 export { type ThreadEventName, type SessionEventName, type Thread, type Session, type ThreadIDProvider, type ThreadProvider, type SessionProvider, generateId, DefaultThreadIDProvider, DefaultThread, } from './session';
 export { LocalThreadProvider } from './services/thread/local';
@@ -18,7 +19,6 @@ export type { Logger } from './logger';
 export { getRouter, setGlobalRouter, createLogger, getLogger, setGlobalLogger, getTracer, setGlobalTracer, addSpanProcessor, getSpanProcessors, privateContext, notifyReady, getServer, AGENT_CONTEXT_PROPERTIES, } from './_server';
 export { hasWaitUntilPending } from './_waituntil';
 export { createAgentContext, StandaloneAgentContext, type StandaloneContextOptions, type InvokeOptions, } from './_standalone';
-export { Email, parseEmail } from './io/email';
 export { HTTPEvalRunEventProvider, LocalEvalRunEventProvider, JSONEvalRunEventProvider, CompositeEvalRunEventProvider, } from './services/evalrun';
 export { getEvalRunEventProvider, getThreadProvider, getSessionProvider } from './_services';
 export type { RouteSchema, GetRouteSchema } from './_validation';
@@ -62,4 +62,5 @@ export type { RouteSchema, GetRouteSchema } from './_validation';
 export interface AppState {
 }
 export { bootstrapRuntimeEnv, type RuntimeBootstrapOptions } from '@agentuity/server';
+export { patchBunS3ForStorageDev, isAgentuityStorageEndpoint } from './bun-s3-patch';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -15,6 +15,8 @@ export { internalExit } from './_process-protection';
 export { registerDevModeRoutes } from './devmode';
 // router.ts exports
 export { createRouter } from './router';
+// protocol handler exports (websocket, sse, stream, cron)
+export { websocket, sse, stream, cron, } from './handlers';
 // eval.ts exports
 export { EvalHandlerResultSchema, } from './eval';
 // session.ts exports
@@ -33,8 +35,6 @@ export { getRouter, setGlobalRouter, createLogger, getLogger, setGlobalLogger, g
 export { hasWaitUntilPending } from './_waituntil';
 // _standalone.ts exports
 export { createAgentContext, StandaloneAgentContext, } from './_standalone';
-// io/email exports
-export { Email, parseEmail } from './io/email';
 // services/evalrun exports
 export { HTTPEvalRunEventProvider, LocalEvalRunEventProvider, JSONEvalRunEventProvider, CompositeEvalRunEventProvider, } from './services/evalrun';
 // _services.ts exports
@@ -43,4 +43,6 @@ export { getEvalRunEventProvider, getThreadProvider, getSessionProvider } from '
 // This allows generated code to import from @agentuity/runtime instead of having
 // a direct dependency on @agentuity/server
 export { bootstrapRuntimeEnv } from '@agentuity/server';
+// bun-s3-patch.ts exports
+export { patchBunS3ForStorageDev, isAgentuityStorageEndpoint } from './bun-s3-patch';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,OAAO,EASN,qBAAqB,EACrB,eAAe,EAGf,aAAa,EACb,cAAc,EACd,cAAc,EAEd,WAAW,EACX,sBAAsB,EACtB,qBAAqB,EACrB,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GACjB,MAAM,SAAS,CAAC;AAEjB,iDAAiD;AACjD,OAAO,EAQN,SAAS,EACT,MAAM,EACN,WAAW,EACX,YAAY,EACZ,WAAW,EACX,SAAS,GACT,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAElE,sCAAsC;AACtC,OAAO,EACN,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,GAC3B,MAAM,cAAc,CAAC;AAEtB,mDAAmD;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAEpE,6DAA6D;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,qBAAqB;AACrB,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElD,oBAAoB;AACpB,OAAO,EAA0C,YAAY,EAAE,MAAM,UAAU,CAAC;AAEhF,kBAAkB;AAClB,OAAO,EACN,uBAAuB,GAYvB,MAAM,QAAQ,CAAC;AAEhB,qBAAqB;AACrB,OAAO,EAQN,UAAU,EACV,uBAAuB,EACvB,aAAa,GACb,MAAM,WAAW,CAAC;AAEnB,gCAAgC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,uBAAuB;AACvB,OAAO,EACN,6BAA6B,EAC7B,qBAAqB,EACrB,4BAA4B,EAC5B,6BAA6B,GAC7B,MAAM,aAAa,CAAC;AAErB,iBAAiB;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAExC,uBAAuB;AACvB,OAAO,EAAuB,SAAS,EAAE,MAAM,aAAa,CAAC;AAK7D,qBAAqB;AACrB,OAAO,EACN,SAAS,EACT,eAAe,EACf,YAAY,EACZ,SAAS,EACT,eAAe,EACf,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,SAAS,EACT,wBAAwB,GACxB,MAAM,WAAW,CAAC;AAEnB,wBAAwB;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,yBAAyB;AACzB,OAAO,EACN,kBAAkB,EAClB,sBAAsB,GAGtB,MAAM,eAAe,CAAC;AAEvB,mBAAmB;AACnB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE/C,2BAA2B;AAC3B,OAAO,EACN,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,GAC7B,MAAM,oBAAoB,CAAC;AAE5B,uBAAuB;AACvB,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AA6C7F,uEAAuE;AACvE,iFAAiF;AACjF,2CAA2C;AAC3C,OAAO,EAAE,mBAAmB,EAAgC,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,OAAO,EASN,qBAAqB,EACrB,eAAe,EAGf,aAAa,EACb,cAAc,EACd,cAAc,EAEd,WAAW,EACX,sBAAsB,EACtB,qBAAqB,EACrB,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GACjB,MAAM,SAAS,CAAC;AAEjB,iDAAiD;AACjD,OAAO,EAQN,SAAS,EACT,MAAM,EACN,WAAW,EACX,YAAY,EACZ,WAAW,EACX,SAAS,GACT,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAElE,sCAAsC;AACtC,OAAO,EACN,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,GAC3B,MAAM,cAAc,CAAC;AAEtB,mDAAmD;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAEpE,6DAA6D;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,qBAAqB;AACrB,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElD,oBAAoB;AACpB,OAAO,EAA0C,YAAY,EAAE,MAAM,UAAU,CAAC;AAEhF,0DAA0D;AAC1D,OAAO,EACN,SAAS,EAET,GAAG,EAIH,MAAM,EAEN,IAAI,GAGJ,MAAM,YAAY,CAAC;AAEpB,kBAAkB;AAClB,OAAO,EACN,uBAAuB,GAYvB,MAAM,QAAQ,CAAC;AAEhB,qBAAqB;AACrB,OAAO,EAQN,UAAU,EACV,uBAAuB,EACvB,aAAa,GACb,MAAM,WAAW,CAAC;AAEnB,gCAAgC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,uBAAuB;AACvB,OAAO,EACN,6BAA6B,EAC7B,qBAAqB,EACrB,4BAA4B,EAC5B,6BAA6B,GAC7B,MAAM,aAAa,CAAC;AAErB,iBAAiB;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAExC,uBAAuB;AACvB,OAAO,EAAuB,SAAS,EAAE,MAAM,aAAa,CAAC;AAK7D,qBAAqB;AACrB,OAAO,EACN,SAAS,EACT,eAAe,EACf,YAAY,EACZ,SAAS,EACT,eAAe,EACf,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,SAAS,EACT,wBAAwB,GACxB,MAAM,WAAW,CAAC;AAEnB,wBAAwB;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,yBAAyB;AACzB,OAAO,EACN,kBAAkB,EAClB,sBAAsB,GAGtB,MAAM,eAAe,CAAC;AAEvB,2BAA2B;AAC3B,OAAO,EACN,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,GAC7B,MAAM,oBAAoB,CAAC;AAE5B,uBAAuB;AACvB,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AA6C7F,uEAAuE;AACvE,iFAAiF;AACjF,2CAA2C;AAC3C,OAAO,EAAE,mBAAmB,EAAgC,MAAM,mBAAmB,CAAC;AAEtF,0BAA0B;AAC1B,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/middleware.d.ts

@@ -6,7 +6,7 @@ import { cors } from 'hono/cors';
 import type { Env, CompressionConfig } from './app';
 import type { Logger } from './logger';
 import { Meter, Tracer } from '@opentelemetry/api';
-export declare const AGENT_CONTEXT_PROPERTIES: readonly ["logger", "tracer", "sessionId", "kv", "stream", "vector", "state", "thread", "session", "config", "app", "waitUntil"];
+export declare const AGENT_CONTEXT_PROPERTIES: readonly ["logger", "tracer", "sessionId", "kv", "stream", "vector", "sandbox", "state", "thread", "session", "config", "app", "waitUntil"];
 export interface MiddlewareConfig {
     logger: Logger;
     tracer: Tracer;

package/dist/middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,KAAK,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAMvC,OAAO,EAMN,KAAK,EACL,MAAM,EACN,MAAM,oBAAoB,CAAC;AAU5B,eAAO,MAAM,wBAAwB,kIAa3B,CAAC;AAuBX,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,CAAC,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,oEA8C5D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,CAAC,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,oEAoC9E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,qEAoKnC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,CAAC,EAAE,iBAAiB,oEAkD3E"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,KAAK,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAMvC,OAAO,EAMN,KAAK,EACL,MAAM,EACN,MAAM,oBAAoB,CAAC;AAU5B,eAAO,MAAM,wBAAwB,6IAc3B,CAAC;AAuBX,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,CAAC,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,oEA+C5D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,CAAC,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,oEAoC9E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,qEAgKnC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,CAAC,EAAE,iBAAiB,oEAkD3E"}

package/dist/middleware.js

@@ -25,6 +25,7 @@ export const AGENT_CONTEXT_PROPERTIES = [
     'kv',
     'stream',
     'vector',
+    'sandbox',
     'state',
     'thread',
     'session',
@@ -66,6 +67,7 @@ export function createBaseMiddleware(config) {
         c.set('kv', services.kv);
         c.set('stream', services.stream);
         c.set('vector', services.vector);
+        c.set('sandbox', services.sandbox);
         installContextPropertyHelpers(c);
         const isWebSocket = c.req.header('upgrade')?.toLowerCase() === 'websocket';
         const skipLogging = c.req.path.startsWith('/_agentuity/');
@@ -216,17 +218,17 @@ export function createOtelMiddleware() {
                 // eslint-disable-next-line @typescript-eslint/no-explicit-any
                 c.set('trigger', 'api');
                 // Send session start event (so evalruns can reference this session)
+                // The provider decides whether to send based on available data (orgId, projectId, etc.)
                 const sessionEventProvider = getSessionEventProvider();
-                const shouldSendSession = !!(orgId && projectId);
-                if (shouldSendSession && sessionEventProvider) {
+                if (sessionEventProvider) {
                     try {
                         // eslint-disable-next-line @typescript-eslint/no-explicit-any
                         const routeId = c.var?.routeId || '';
                         await sessionEventProvider.start({
                             id: sessionId,
                             threadId: thread.id,
-                            orgId,
-                            projectId,
+                            orgId: orgId || '',
+                            projectId: projectId || '',
                             deploymentId: deploymentId || undefined,
                             devmode: isDevMode,
                             trigger: 'api',
@@ -262,8 +264,8 @@ export function createOtelMiddleware() {
                 }
                 finally {
                     // Send session complete event
-                    internal.info('[session] shouldSendSession: %s, hasSessionEventProvider: %s', shouldSendSession, !!sessionEventProvider);
-                    if (shouldSendSession && sessionEventProvider) {
+                    // The provider decides whether to actually send based on its requirements
+                    if (sessionEventProvider) {
                         try {
                             const userData = session.serializeUserData();
                             internal.info('[session] sending session complete event, userData: %s', userData ? `${userData.length} bytes` : 'none');