@agentuity/runtime 2.0.11 → 3.0.0-alpha.1

package/src/devmode.ts

@@ -1,171 +0,0 @@
-import { Hono } from 'hono';
-
-const overlay = `
-<div id="__dev_overlay">
-	<svg
-		aria-hidden="true"
-		aria-label="Agentuity Logo"
-		id="__dev_agentuity_logo"
-		fill="none"
-		height="191"
-		viewBox="0 0 220 191"
-		width="220"
-		xmlns="http://www.w3.org/2000/svg"
-	>
-		<path
-			clip-rule="evenodd"
-			d="M220 191H0L31.427 136.5H0L8 122.5H180.5L220 191ZM47.5879 136.5L24.2339 177H195.766L172.412 136.5H47.5879Z"
-			fill="#0FF"
-			fill-rule="evenodd"
-		/>
-		<path
-			clip-rule="evenodd"
-			d="M110 0L157.448 82.5H189L197 96.5H54.5L110 0ZM78.7021 82.5L110 28.0811L141.298 82.5H78.7021Z"
-			fill="#0FF"
-			fill-rule="evenodd"
-		/>
-	</svg>
-
-	<svg
-		aria-hidden="true"
-		aria-label="Loading"
-		id="__dev_loading_icon"
-		fill="none"
-		height="20"
-		stroke="#FFF"
-		stroke-linecap="round"
-		stroke-linejoin="round"
-		stroke-width="2"
-		viewBox="0 0 24 24"
-		width="20"
-		xmlns="http://www.w3.org/2000/svg"
-	>
-		<path d="M21 12a9 9 0 1 1-6.219-8.56" />
-	</svg>
-</div>
-
-<style>
-	@keyframes animate-in {
-		from { opacity: 0; transform: translateY(10px); }
-		to { opacity: 1; transform: translateY(0); }
-	}
-	@keyframes spin {
-		from { transform: rotate(0deg); }
-		to { transform: rotate(360deg); }
-	}
-	#__dev_overlay {
-		align-items: center;
-		animation: animate-in 0.5s ease-in-out;
-		background-color: #000;
-		border: 1px solid #18181B;
-		border-radius: 0.5rem;
-		bottom: 1rem;
-		box-shadow: 0 1.5rem 3rem -0.75rem #00000040;
-		display: none;
-		gap: 0.5rem;
-		padding: 0.5rem;
-		position: fixed;
-		right: 1rem;
-		z-index: 1000;
-	}
-	#__dev_overlay #__dev_agentuity_logo {
-		height: auto;
-		width: 1.5rem;
-	}
-	#__dev_overlay #__dev_loading_icon {
-		animation: spin 1s linear infinite;
-	}
-</style>
-`;
-
-// Global controller to avoid registering multiple SIGINT listeners
-let globalController: AbortController | undefined;
-let globalSigintHandler: (() => void) | undefined;
-
-export function registerDevModeRoutes(router: Hono) {
-	// Reuse existing controller or create new one
-	if (!globalController) {
-		globalController = new AbortController();
-
-		// Only register SIGINT handler once
-		globalSigintHandler = () => {
-			globalController?.abort();
-		};
-		process.on('SIGINT', globalSigintHandler);
-	}
-
-	const signal = globalController.signal;
-	router.get('/__dev__/reload', () => {
-		const stream = new ReadableStream({
-			start(controller): void {
-				signal.addEventListener('abort', () => {
-					try {
-						controller.enqueue('data: RELOAD\n\n');
-					} catch {
-						/* this is ok */
-					}
-					try {
-						controller.close();
-					} catch {
-						/* this is ok */
-					}
-				});
-			},
-		});
-		return new Response(stream, {
-			headers: {
-				'Content-Type': 'text/event-stream',
-				'Cache-Control': 'no-cache',
-			},
-		});
-	});
-	router.get('/__dev__/reload.js', (c) => {
-		const body = `(() => {
-    let reloading = false;
-	const sleep = (t) => new Promise(resolve => setTimeout(resolve, t));
-	const tryReload = () => {
-		return new Promise(async (resolve) => {
-			for (;;) {
-				try {
-					const res = await fetch('/');
-					if (res.ok) {
-						resolve();
-						return;
-					}
-				} catch {
-				}
-				await sleep(250);
-			}
-		});
-	};
-	const showReload = () => {
-        reloading = true;
-		document.getElementById('__dev_overlay').style.display = 'flex';
-	};
-	const reloadPage = () => {
-		reloading = false;
-		tryReload().then(() => {
-			location.reload();
-			document.getElementById('__dev_overlay').style.display = 'none';
-		});
-	};
-    const sse = new EventSource('/__dev__/reload');
-    sse.onmessage = function(msg) {
-		showReload();
-        reloadPage();
-    };
-    sse.onopen = function() {
-		showReload();
-        reloadPage();
-    };
-	sse.onclose = function() {
-		showReload();
-	};
-    window.addEventListener('beforeunload', () => sse.close());
-})();
-        `;
-		return c.body(body, 200, { 'Content-Type': 'text/javascript' });
-	});
-
-	return overlay + '<script type="module" src="/__dev__/reload.js"></script>';
-}

package/src/eval.ts

@@ -1,109 +0,0 @@
-/* eslint-disable @typescript-eslint/no-explicit-any */
-import type { InferInput, InferOutput, StandardSchemaV1 } from '@agentuity/core';
-import { z } from 'zod';
-import type { AgentContext } from './agent';
-
-// Eval SDK types
-export type EvalContext = AgentContext<any, any, any>;
-
-export type EvalRunResultMetadata = {
-	[key: string]: any;
-};
-
-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(),
-});
-
-export type EvalHandlerResult = z.infer<typeof EvalHandlerResultSchema>;
-
-// 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(),
-});
-
-export type EvalRunResultSuccess = z.infer<typeof EvalRunResultSuccessSchema>;
-
-export type EvalRunResultError = {
-	success: false;
-	passed: false;
-	error: string;
-	reason?: string;
-	metadata?: EvalRunResultMetadata;
-};
-
-export type EvalRunResult = EvalRunResultSuccess | EvalRunResultError;
-
-export type CreateEvalRunRequest = {
-	projectId: string;
-	sessionId: string;
-	result: EvalRunResult;
-	evalId: string;
-	promptHash?: string;
-	deploymentId?: string;
-};
-
-type InternalEvalMetadata = {
-	/**
-	 * the unique deployment-specific id for this eval (evalid_...)
-	 */
-	id: string;
-	/**
-	 * the stable identifier for this project and eval across multiple deployments (eval_...)
-	 */
-	identifier: string;
-	/**
-	 * the human readable name for the eval
-	 */
-	name: string;
-	/**
-	 * the relative path to the eval from the root project directory
-	 */
-	filename: string;
-	/**
-	 * a unique version for the eval. computed as the SHA256 contents of the file.
-	 */
-	version: string;
-};
-
-export type ExternalEvalMetadata = {
-	/**
-	 * the human readable name for the eval (identifier is used if not specified)
-	 */
-	name: string;
-	/**
-	 * the human readable description for the eval (empty if not provided)
-	 */
-	description: string;
-};
-
-export type EvalMetadata = InternalEvalMetadata & ExternalEvalMetadata;
-
-type InferSchemaInput<T> = T extends StandardSchemaV1 ? InferInput<T> : any;
-type InferSchemaOutput<T> = T extends StandardSchemaV1 ? InferOutput<T> : any;
-
-export type EvalFunction<TInput = any, TOutput = any> = [TInput] extends [undefined]
-	? [TOutput] extends [undefined]
-		? (ctx: EvalContext) => Promise<EvalHandlerResult>
-		: (ctx: EvalContext, output: TOutput) => Promise<EvalHandlerResult>
-	: [TOutput] extends [undefined]
-		? (ctx: EvalContext, input: TInput) => Promise<EvalHandlerResult>
-		: (ctx: EvalContext, input: TInput, output: TOutput) => Promise<EvalHandlerResult>;
-
-/**
- * The Eval handler interface.
- */
-export type Eval<
-	TInput extends StandardSchemaV1 | undefined = any,
-	TOutput extends StandardSchemaV1 | undefined = any,
-> = {
-	metadata: EvalMetadata;
-	handler: EvalFunction<InferSchemaInput<TInput>, InferSchemaOutput<TOutput>>;
-} & (TInput extends StandardSchemaV1 ? { inputSchema: TInput } : { inputSchema?: never }) &
-	(TOutput extends StandardSchemaV1 ? { outputSchema: TOutput } : { outputSchema?: never });

package/src/globals.d.ts

@@ -1,28 +0,0 @@
-/**
- * Type-safe globalThis declarations for Agentuity runtime.
- *
- * String-keyed globals that persist across bun --hot reloads.
- * Symbol-keyed globals are accessed via the typed helpers in _globals.ts.
- */
-
-declare global {
-	// eslint-disable-next-line no-var
-	var __AGENTUITY_SERVER__:
-		| {
-				stop: (closeActiveConnections?: boolean) => void;
-				port: number | undefined;
-				pendingRequests: number;
-				pendingWebSockets: number;
-		  }
-		| undefined;
-
-	// eslint-disable-next-line no-var
-	var __AGENTUITY_BUN_SUBPROCESS__:
-		| {
-				kill: (signal?: number | NodeJS.Signals) => void;
-				exitCode: number | null;
-		  }
-		| undefined;
-}
-
-export {};

package/src/handlers/_route-meta.ts

@@ -1,33 +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');
-
-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 function tagRoute<T extends (...args: any[]) => any>(handler: T, meta: RouteMeta): T {
-	(handler as any)[ROUTE_META] = meta;
-	return handler;
-}
-
-/**
- * Read route metadata from a handler/middleware.
- */
-export function getRouteMeta(handler: unknown): RouteMeta | undefined {
-	if (typeof handler === 'function') {
-		return (handler as any)[ROUTE_META];
-	}
-	return undefined;
-}

package/src/handlers/cron.ts

@@ -1,141 +0,0 @@
-import type { Context, Handler } from 'hono';
-import { returnResponse } from '../_util';
-import type { Env } from '../app';
-import { verifySignature } from '../signature';
-import { tagRoute } from './_route-meta';
-
-/**
- * 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 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 function cron<E extends Env = Env>(schedule: string, handler: CronHandler<E>): Handler<E>;
-
-export function cron<E extends Env = Env>(
-	_schedule: string,
-	optionsOrHandler: CronOptions | CronHandler<E>,
-	maybeHandler?: CronHandler<E>
-): Handler<E> {
-	let options: CronOptions;
-	let handler: CronHandler<E>;
-
-	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: Handler<E> = async (c: Context<E>) => {
-		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 });
-}
-
-/**
- * Metadata interface for cron jobs (can be used for registration/discovery).
- */
-export interface CronMetadata {
-	schedule: string;
-	path: string;
-}

package/src/handlers/index.ts

@@ -1,18 +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';