@agentuity/runtime 2.0.11 → 3.0.0-alpha.1

package/dist/eval.js

@@ -1,16 +0,0 @@
-import { z } from 'zod';
-export const EvalHandlerResultSchema = z.object({
-    passed: z.boolean(),
-    score: z.number().min(0).max(1).optional(),
-    reason: z.string().optional(),
-    metadata: z.record(z.string(), z.any()).optional(),
-});
-// Internal types for catalyst (include success field)
-export const EvalRunResultSuccessSchema = z.object({
-    success: z.literal(true),
-    passed: z.boolean(),
-    score: z.number().min(0).max(1).optional(),
-    reason: z.string().optional(),
-    metadata: z.record(z.string(), z.any()).optional(),
-});
-//# sourceMappingURL=eval.js.map

package/dist/eval.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"eval.js","sourceRoot":"","sources":["../src/eval.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC;AAIH,sDAAsD;AACtD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACxB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC"}

package/dist/handlers/_route-meta.d.ts

@@ -1,22 +0,0 @@
-/**
- * Route metadata tagging for build-time route type discovery.
- *
- * Handler wrappers (websocket, sse, stream, cron) stamp this symbol on
- * the returned middleware so the build tool can detect the route type
- * from `router.routes` without AST parsing.
- */
-export declare const ROUTE_META: unique symbol;
-export interface RouteMeta {
-    type: 'websocket' | 'sse' | 'stream' | 'cron';
-    /** Cron schedule expression (only for type: 'cron') */
-    schedule?: string;
-}
-/**
- * Tag a handler/middleware with route metadata.
- */
-export declare function tagRoute<T extends (...args: any[]) => any>(handler: T, meta: RouteMeta): T;
-/**
- * Read route metadata from a handler/middleware.
- */
-export declare function getRouteMeta(handler: unknown): RouteMeta | undefined;
-//# sourceMappingURL=_route-meta.d.ts.map

package/dist/handlers/_route-meta.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"_route-meta.d.ts","sourceRoot":"","sources":["../../src/handlers/_route-meta.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,UAAU,eAAqC,CAAC;AAE7D,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC9C,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,GAAG,CAAC,CAG1F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAKpE"}

package/dist/handlers/_route-meta.js

@@ -1,25 +0,0 @@
-/**
- * Route metadata tagging for build-time route type discovery.
- *
- * Handler wrappers (websocket, sse, stream, cron) stamp this symbol on
- * the returned middleware so the build tool can detect the route type
- * from `router.routes` without AST parsing.
- */
-export const ROUTE_META = Symbol.for('agentuity:route-meta');
-/**
- * Tag a handler/middleware with route metadata.
- */
-export function tagRoute(handler, meta) {
-    handler[ROUTE_META] = meta;
-    return handler;
-}
-/**
- * Read route metadata from a handler/middleware.
- */
-export function getRouteMeta(handler) {
-    if (typeof handler === 'function') {
-        return handler[ROUTE_META];
-    }
-    return undefined;
-}
-//# sourceMappingURL=_route-meta.js.map

package/dist/handlers/_route-meta.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"_route-meta.js","sourceRoot":"","sources":["../../src/handlers/_route-meta.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAQ7D;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAoC,OAAU,EAAE,IAAe;IACrF,OAAe,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IACpC,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC5C,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QACnC,OAAQ,OAAe,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/dist/handlers/cron.d.ts

@@ -1,73 +0,0 @@
-import type { Context, Handler } from 'hono';
-import type { Env } from '../app';
-/**
- * Handler function for cron jobs.
- * Receives the Hono context and can return any response.
- */
-export type CronHandler<E extends Env = Env> = (c: Context<E>) => unknown | Promise<unknown>;
-/**
- * Options for the cron middleware.
- */
-export interface CronOptions {
-    /**
-     * Whether to require signature authentication for cron requests.
-     * When true, requests must include valid X-Agentuity-Cron-Signature
-     * and X-Agentuity-Cron-Timestamp headers signed with the project's SDK key.
-     * Signatures are valid for 5 minutes.
-     */
-    auth: boolean;
-}
-/**
- * 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.
- *
- * @example
- * ```typescript
- * import { createRouter, cron } from '@agentuity/runtime';
- *
- * const router = createRouter();
- *
- * // With authentication (recommended)
- * router.post('/daily-cleanup', cron('0 0 * * *', { auth: true }, (c) => {
- *   c.var.logger.info('Running daily cleanup');
- *   return { status: 'cleanup complete' };
- * }));
- *
- * // Without authentication (not recommended for production)
- * router.post('/health-check', cron('0 * * * *', { auth: false }, (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 options - Configuration options including auth requirement
- * @param handler - Handler function to run on schedule
- * @returns Hono handler for cron endpoint
- */
-export declare function cron<E extends Env = Env>(schedule: string, options: CronOptions, handler: CronHandler<E>): Handler<E>;
-/**
- * Creates a cron middleware for scheduled task endpoints.
- *
- * @deprecated Use the overload with explicit `options` parameter: `cron(schedule, { auth: true }, handler)`
- *
- * **Important:** Cron endpoints must use POST method. The middleware will throw
- * an error if called with any other HTTP method.
- *
- * This deprecated overload defaults to `auth: false` for backwards compatibility.
- *
- * @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 declare function cron<E extends Env = Env>(schedule: string, handler: CronHandler<E>): Handler<E>;
-/**
- * Metadata interface for cron jobs (can be used for registration/discovery).
- */
-export interface CronMetadata {
-    schedule: string;
-    path: string;
-}
-//# sourceMappingURL=cron.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../../src/handlers/cron.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE7C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAIlC;;;GAGG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAE7F;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B;;;;;OAKG;IACH,IAAI,EAAE,OAAO,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GACrB,OAAO,CAAC,CAAC,CAAC,CAAC;AAEd;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AA2DjG;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACb"}

package/dist/handlers/cron.js

@@ -1,43 +0,0 @@
-import { returnResponse } from '../_util';
-import { verifySignature } from '../signature';
-import { tagRoute } from './_route-meta';
-export function cron(_schedule, optionsOrHandler, maybeHandler) {
-    let options;
-    let handler;
-    if (typeof optionsOrHandler === 'function') {
-        // Deprecated: cron(schedule, handler) - defaults to auth: false
-        options = { auth: false };
-        handler = optionsOrHandler;
-    }
-    else {
-        // New: cron(schedule, options, handler)
-        options = optionsOrHandler;
-        handler = maybeHandler;
-    }
-    const cronHandler = 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()}().`);
-        }
-        if (options.auth) {
-            // Clone the request to read body for signature verification without consuming it
-            const clonedReq = c.req.raw.clone();
-            const body = await clonedReq.text();
-            // Verify the cron signature
-            const isValid = await verifySignature(c.req.header('X-Agentuity-Cron-Signature'), c.req.header('X-Agentuity-Cron-Timestamp'), body);
-            if (!isValid) {
-                return c.json({ error: 'Unauthorized' }, 401);
-            }
-        }
-        let result = handler(c);
-        if (result instanceof Promise) {
-            result = await result;
-        }
-        if (result instanceof Response) {
-            return result;
-        }
-        return returnResponse(c, result);
-    };
-    return tagRoute(cronHandler, { type: 'cron', schedule: _schedule });
-}
-//# 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;AAE1C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAyEzC,MAAM,UAAU,IAAI,CACnB,SAAiB,EACjB,gBAA8C,EAC9C,YAA6B;IAE7B,IAAI,OAAoB,CAAC;IACzB,IAAI,OAAuB,CAAC;IAE5B,IAAI,OAAO,gBAAgB,KAAK,UAAU,EAAE,CAAC;QAC5C,gEAAgE;QAChE,OAAO,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QAC1B,OAAO,GAAG,gBAAgB,CAAC;IAC5B,CAAC;SAAM,CAAC;QACP,wCAAwC;QACxC,OAAO,GAAG,gBAAgB,CAAC;QAC3B,OAAO,GAAG,YAAa,CAAC;IACzB,CAAC;IAED,MAAM,WAAW,GAAe,KAAK,EAAE,CAAa,EAAE,EAAE;QACvD,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,OAAO,CAAC,IAAI,EAAE,CAAC;YAClB,iFAAiF;YACjF,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;YAEpC,4BAA4B;YAC5B,MAAM,OAAO,GAAG,MAAM,eAAe,CACpC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,4BAA4B,CAAC,EAC1C,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,4BAA4B,CAAC,EAC1C,IAAI,CACJ,CAAC;YACF,IAAI,CAAC,OAAO,EAAE,CAAC;gBACd,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,GAAG,CAAC,CAAC;YAC/C,CAAC;QACF,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;IAEF,OAAO,QAAQ,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;AACrE,CAAC"}

package/dist/handlers/index.d.ts

@@ -1,6 +0,0 @@
-export { websocket, type WebSocketConnection, type WebSocketHandler, WS_DONE_PROMISE_KEY, } from './websocket';
-export { sse, type SSEMessage, type SSEStream, type SSEHandler, type SSEOptions, STREAM_DONE_PROMISE_KEY, IS_STREAMING_RESPONSE_KEY, } from './sse';
-export { stream, type StreamHandler } from './stream';
-export { cron, type CronHandler, type CronMetadata } from './cron';
-export { webrtc, type WebRTCHandler, type WebRTCOptions } from './webrtc';
-//# 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,EACN,SAAS,EACT,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,mBAAmB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,GAAG,EACH,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,UAAU,EACf,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;AACnE,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/handlers/index.js

@@ -1,6 +0,0 @@
-export { websocket, WS_DONE_PROMISE_KEY, } from './websocket';
-export { sse, STREAM_DONE_PROMISE_KEY, IS_STREAMING_RESPONSE_KEY, } from './sse';
-export { stream } from './stream';
-export { cron } from './cron';
-export { webrtc } from './webrtc';
-//# 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,EACN,SAAS,EAGT,mBAAmB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,GAAG,EAKH,uBAAuB,EACvB,yBAAyB,GACzB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,MAAM,EAAsB,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,IAAI,EAAuC,MAAM,QAAQ,CAAC;AACnE,OAAO,EAAE,MAAM,EAA0C,MAAM,UAAU,CAAC"}

package/dist/handlers/sse.d.ts

@@ -1,163 +0,0 @@
-import type { Context, Handler } from 'hono';
-import type { Schema } from '@agentuity/schema';
-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>;
-/**
- * Options for configuring SSE middleware.
- *
- * @template TOutput - The type of data that will be sent through the SSE stream.
- *   This is used for type inference in generated route registries and does not
- *   perform runtime validation (SSE data is serialized via JSON.stringify).
- */
-export interface SSEOptions<TOutput = unknown> {
-    /**
-     * Schema defining the output type for SSE events.
-     *
-     * This schema is used for:
-     * - Type inference in generated `routes.ts` registry
-     * - Automatic typing of `EventSource/EventStreamManager` hook's `data` property
-     *
-     * The schema is NOT used for runtime validation - SSE messages are sent
-     * as-is through the stream. Use this for TypeScript type safety only.
-     *
-     * @example
-     * ```typescript
-     * import { s } from '@agentuity/schema';
-     *
-     * const StreamEventSchema = s.object({
-     *   type: s.enum(['token', 'complete', 'error']),
-     *   content: s.optional(s.string()),
-     * });
-     *
-     * router.get('/stream', sse({ output: StreamEventSchema }, async (c, stream) => {
-     *   await stream.writeSSE({ data: JSON.stringify({ type: 'token', content: 'Hello' }) });
-     *   await stream.writeSSE({ data: JSON.stringify({ type: 'complete' }) });
-     *   stream.close();
-     * }));
-     * ```
-     */
-    output: Schema<TOutput, TOutput>;
-}
-/**
- * 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 Basic SSE without typed output
- * ```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);
- *   });
- * }));
- * ```
- *
- * @example SSE with typed output schema
- * ```typescript
- * import { createRouter, sse } from '@agentuity/runtime';
- * import { s } from '@agentuity/schema';
- *
- * // Define your SSE event schema
- * export const outputSchema = s.object({
- *   type: s.enum(['token', 'complete', 'error']),
- *   content: s.optional(s.string()),
- * });
- *
- * const router = createRouter();
- *
- * // Pass schema as first argument for typed SSE routes
- * router.get('/stream', sse({ output: outputSchema }, async (c, stream) => {
- *   await stream.writeSSE({ data: JSON.stringify({ type: 'token', content: 'Hello' }) });
- *   await stream.writeSSE({ data: JSON.stringify({ type: 'complete' }) });
- *   stream.close();
- * }));
- *
- * // On the frontend, EventSource/EventStreamManager will now have typed data:
- * // const { data } = EventSource/EventStreamManager('/api/stream');
- * // data.type is 'token' | 'complete' | 'error'
- * ```
- *
- * @param handler - Handler function receiving context and SSE stream
- * @param options - Optional configuration with output schema for type inference
- * @returns Hono handler for SSE streaming
- * @see https://github.com/agentuity/sdk/issues/471
- * @see https://github.com/agentuity/sdk/issues/855
- */
-export declare function sse<E extends Env = Env>(handler: SSEHandler<E>): Handler<E>;
-/**
- * Creates an SSE middleware with typed output schema.
- *
- * @param options - Configuration object containing the output schema
- * @param handler - Handler function receiving context and SSE stream
- * @returns Hono handler for SSE streaming
- */
-export declare function sse<E extends Env = Env, TOutput = unknown>(options: SSEOptions<TOutput>, 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,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAWlC;;;;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;AAE1B;;;;;;GAMG;AACH,MAAM,WAAW,UAAU,CAAC,OAAO,GAAG,OAAO;IAC5C;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;CACjC;AA2BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAC7E;;;;;;GAMG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,OAAO,GAAG,OAAO,EACzD,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,EAC5B,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/dist/handlers/sse.js

@@ -1,175 +0,0 @@
-import { stream as honoStream } from 'hono/streaming';
-import { context as otelContext, ROOT_CONTEXT } from '@opentelemetry/api';
-import { StructuredError } from '@agentuity/core';
-import { tagRoute } from './_route-meta';
-/**
- * Error thrown when sse() is called without a handler function.
- */
-const SSEHandlerMissingError = StructuredError('SSEHandlerMissingError', 'An SSE handler function is required. Use sse(handler) or sse({ output: schema }, handler).');
-/**
- * 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;
-}
-export function sse(handlerOrOptions, maybeHandler) {
-    // Determine if first arg is options or handler
-    const handler = typeof handlerOrOptions === 'function' ? handlerOrOptions : maybeHandler;
-    // Validate handler is provided - catches sse({ output }) without handler
-    if (!handler) {
-        throw new SSEHandlerMissingError();
-    }
-    // Note: options.output is captured for type inference but not used at runtime
-    // The CLI extracts this during build to generate typed route registries
-    const sseHandler = (c) => {
-        // 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);
-                }
-            };
-            // 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, runInContext);
-        });
-    };
-    return tagRoute(sseHandler, { type: 'sse' });
-}
-//# 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;AAG7C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAIlC;;;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,CA8DjF"}