@agentuity/runtime 1.0.48 → 2.0.0-beta.0

package/dist/app.js

@@ -7,137 +7,134 @@ export function getApp() {
 }
 // Re-export event functions from _events
 export { fireEvent } from './_events';
-import { addEventListener as globalAddEventListener, removeEventListener as globalRemoveEventListener, } from './_events';
-import { getLogger, getRouter } from './_server';
 /**
- * Create an Agentuity application with lifecycle management.
+ * Create and start an Agentuity application.
  *
- * In Vite-native architecture:
- * - This only handles setup/shutdown lifecycle
- * - Router creation and middleware are handled by the generated entry file
- * - Server is managed by Vite (dev) or Bun.serve (prod)
- *
- * @template TAppState - Type of application state from setup()
+ * This is the single entry point for the entire server lifecycle:
+ * OTel, middleware, route mounting, services, and Bun.serve().
  *
  * @example
  * ```typescript
- * // app.ts
  * import { createApp } from '@agentuity/runtime';
+ * import router from './src/api/router';
+ * import agents from './src/agent';
  *
- * const app = await createApp({
- *   setup: async () => {
- *     const db = await connectDB();
- *     return { db };
- *   },
- *   shutdown: async (state) => {
- *     await state.db.close();
- *   }
+ * export default await createApp({
+ *   router: { path: '/api', router },
+ *   agents,
  * });
- *
- * // Access state in agents via ctx.app.db
  * ```
  */
 export async function createApp(config) {
-    // Run setup to get app state
-    const state = config?.setup ? await config.setup() : {};
-    // Store state and config globally for generated entry file to access
-    globalThis.__AGENTUITY_APP_STATE__ = state;
-    globalThis.__AGENTUITY_APP_CONFIG__ = config;
-    // Store user-provided router(s) normalized as RouteMount[] for the entry file.
-    // When set, the entry file mounts these instead of auto-discovered route files.
-    if (config?.router) {
-        globalThis.__AGENTUITY_USER_ROUTER__ = normalizeRouterConfig(config.router);
+    // --- Imports (lazy to avoid circular deps) ---
+    const { bootstrapRuntimeEnv } = await import('@agentuity/server');
+    const { register } = await import('./otel/config');
+    const { setGlobalLogger, setGlobalTracer, setGlobalRouter, getSpanProcessors } = await import('./_server');
+    const { createServices, getThreadProvider, getSessionProvider } = await import('./_services');
+    const { createBaseMiddleware, createCorsMiddleware, createOtelMiddleware, createCompressionMiddleware, } = await import('./middleware');
+    const { runAgentSetups, createAgentMiddleware } = await import('./agent');
+    const { loadBuildMetadata } = await import('./_metadata');
+    const { patchBunS3ForStorageDev } = await import('./bun-s3-patch');
+    const { createWorkbenchRouter } = await import('./workbench');
+    const { isDevelopment, resolveAnalyticsConfig, resolveWorkbenchConfig, registerHealthRoutes, registerAnalyticsRoutes, registerWebRoutes, registerWorkbenchUI, startServer, } = await import('./bootstrap');
+    const { websocket } = await import('hono/bun');
+    // --- Step 0: Environment ---
+    if (isDevelopment()) {
+        bootstrapRuntimeEnv();
     }
-    // Store shutdown function for cleanup
-    const shutdown = config?.shutdown;
-    if (shutdown) {
-        globalThis.__AGENTUITY_SHUTDOWN__ = shutdown;
+    if (isDevelopment() && process.env.AGENTUITY_NO_BUNDLE === 'true') {
+        const { applyDevPatches } = await import('./dev-patches');
+        await applyDevPatches();
     }
-    // Return a logger proxy that lazily resolves to the global logger
-    // This is necessary because Vite bundling inlines and reorders module code,
-    // causing app.ts to execute before entry file sets the global logger.
-    // The proxy ensures logger works correctly when actually used (in handlers/callbacks).
-    const logger = {
-        trace: (...args) => {
-            const gl = getLogger();
-            if (gl)
-                gl.trace(...args);
-        },
-        debug: (...args) => {
-            const gl = getLogger();
-            if (gl)
-                gl.debug(...args);
-        },
-        info: (...args) => {
-            const gl = getLogger();
-            if (gl)
-                gl.info(...args);
-            else
-                console.log('[INFO]', ...args);
-        },
-        warn: (...args) => {
-            const gl = getLogger();
-            if (gl)
-                gl.warn(...args);
-            else
-                console.warn('[WARN]', ...args);
-        },
-        error: (...args) => {
-            const gl = getLogger();
-            if (gl)
-                gl.error(...args);
-            else
-                console.error('[ERROR]', ...args);
-        },
-        fatal: (...args) => {
-            const gl = getLogger();
-            if (gl)
-                return gl.fatal(...args);
-            // Fallback: log to console but let the real logger handle exit
-            console.error('[FATAL]', ...args);
-            throw new Error('Fatal error');
-        },
-        child: (bindings) => {
-            const gl = getLogger();
-            return gl ? gl.child(bindings) : logger;
-        },
-    };
-    // Create server info from environment
+    loadBuildMetadata();
+    patchBunS3ForStorageDev();
+    // --- Step 1: Telemetry ---
+    const otel = register({
+        processors: getSpanProcessors(),
+        logLevel: (process.env.AGENTUITY_LOG_LEVEL || 'info'),
+    });
+    setGlobalLogger(otel.logger);
+    setGlobalTracer(otel.tracer);
+    // --- Step 2: Router + middleware ---
+    const { createRouter } = await import('./router');
+    const app = createRouter();
+    setGlobalRouter(app);
+    app.use('*', createCompressionMiddleware(config?.compression));
+    app.use('*', createBaseMiddleware({
+        logger: otel.logger,
+        tracer: otel.tracer,
+        meter: otel.meter,
+    }));
+    app.use('/_agentuity/workbench/*', createOtelMiddleware());
+    // --- Step 3: Services ---
     const port = process.env.PORT || '3500';
-    const server = {
-        url: `http://127.0.0.1:${port}`,
-    };
-    // Get router from global (set by entry file before app.ts import)
-    // In dev mode, router may not be available during bundling
-    const globalRouter = getRouter();
-    if (!globalRouter) {
-        throw new Error('Router is not available. Ensure router is initialized before calling createApp(). This typically happens during bundling or when the entry file has not properly set up the router.');
+    const serverUrl = `http://127.0.0.1:${port}`;
+    createServices(otel.logger, config, serverUrl);
+    const threadProvider = getThreadProvider();
+    const sessionProvider = getSessionProvider();
+    await threadProvider.initialize({});
+    await sessionProvider.initialize({});
+    // --- Step 4: Routes ---
+    const analyticsConfig = resolveAnalyticsConfig(config?.analytics);
+    const workbenchConfig = resolveWorkbenchConfig(config?.workbench);
+    registerHealthRoutes(app);
+    if (analyticsConfig.enabled) {
+        registerAnalyticsRoutes(app, analyticsConfig);
+    }
+    // Mount user routers
+    if (config?.router) {
+        const mounts = normalizeRouterConfig(config.router);
+        for (const mount of mounts) {
+            const prefix = mount.path.endsWith('/') ? mount.path + '*' : mount.path + '/*';
+            app.use(prefix, createCorsMiddleware(config?.cors));
+            app.use(prefix, createOtelMiddleware());
+            app.use(prefix, createAgentMiddleware(''));
+            app.route(mount.path, mount.router);
+        }
     }
-    const router = globalRouter;
-    return {
-        state,
-        shutdown,
+    // Workbench
+    const workbenchRouter = createWorkbenchRouter();
+    app.route('/', workbenchRouter);
+    registerWorkbenchUI(app, workbenchConfig);
+    // Web (production static serving)
+    registerWebRoutes(app, analyticsConfig);
+    // --- Step 5: Agent lifecycle + server ---
+    await runAgentSetups({});
+    // In dev mode with --hot, Bun manages the server via the default export's
+    // `fetch` property. In production, we start Bun.serve() explicitly.
+    if (!isDevelopment()) {
+        startServer(app, { requestTimeout: config?.requestTimeout });
+    }
+    // Only log on first startup, not on --hot reloads
+    const { serverStarted } = await import('./_globals');
+    if (!serverStarted.get()) {
+        serverStarted.set(true);
+        otel.logger.debug('Server listening on %s', serverUrl);
+    }
+    const portNumber = parseInt(port, 10);
+    const result = {
         config,
-        router,
-        server,
-        logger,
-        addEventListener: globalAddEventListener,
-        removeEventListener: globalRemoveEventListener,
+        router: app,
+        server: { url: serverUrl },
+        logger: otel.logger,
+        // Bun --hot picks up `fetch` and `port` on the default export to
+        // hot-swap the running server's request handler without restarting.
+        fetch: app.fetch,
+        port: portNumber,
+        hostname: '127.0.0.1',
+        websocket,
     };
-}
-/**
- * Get the global app state
- * Used by generated entry file and middleware
- */
-export function getAppState() {
-    return globalThis.__AGENTUITY_APP_STATE__ || {};
-}
-/**
- * Get the global app config
- * Used by generated entry file for middleware setup
- */
-export function getAppConfig() {
-    return globalThis.__AGENTUITY_APP_CONFIG__;
+    // In production, startServer() already called Bun.serve(). If we leave
+    // `fetch` + `port` on the default export, Bun v1.2+ auto-serves from it
+    // too — causing EADDRINUSE. Strip those properties so only the explicit
+    // Bun.serve() is active.
+    if (!isDevelopment()) {
+        delete result.fetch;
+        delete result.port;
+        delete result.hostname;
+        delete result.websocket;
+    }
+    return result;
 }
 /**
  * Normalize the router config into a consistent RouteMount[] form.
@@ -146,7 +143,7 @@ export function getAppConfig() {
  * - [{ path, router }, ...] → as-is
  * @internal
  */
-function normalizeRouterConfig(
+export function normalizeRouterConfig(
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 router) {
     if (Array.isArray(router)) {
@@ -158,40 +155,17 @@ router) {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     return [{ path: '/api', router: router }];
 }
-/**
- * Get the user-provided router mounts from createApp({ router }).
- * Returns undefined if no user router was provided (file-based routing).
- * Used by generated entry file to skip file-based route discovery.
- * @internal
- */
-export function getUserRouter() {
-    return globalThis.__AGENTUITY_USER_ROUTER__;
-}
-/**
- * Set the global app config (for testing purposes)
- * @internal
- */
-export function setAppConfig(config) {
-    if (config === undefined) {
-        delete globalThis.__AGENTUITY_APP_CONFIG__;
-    }
-    else {
-        globalThis.__AGENTUITY_APP_CONFIG__ = config;
-    }
-}
-/**
- * Symbol used to store shutdown hooks in globalThis.
- */
-const SHUTDOWN_HOOKS_KEY = Symbol.for('@agentuity/runtime:shutdown-hooks');
 /**
  * Gets the global shutdown hooks registry.
  */
 function getShutdownHooks() {
-    const global = globalThis;
-    if (!global[SHUTDOWN_HOOKS_KEY]) {
-        global[SHUTDOWN_HOOKS_KEY] = [];
+    const key = Symbol.for('@agentuity/runtime:shutdown-hooks');
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const g = globalThis;
+    if (!g[key]) {
+        g[key] = [];
     }
-    return global[SHUTDOWN_HOOKS_KEY];
+    return g[key];
 }
 /**
  * Registers a shutdown hook to be called during graceful shutdown.
@@ -229,21 +203,12 @@ export function registerShutdownHook(hook) {
     };
 }
 /**
- * Run the global shutdown function and all registered shutdown hooks.
- * Called by generated entry file on cleanup.
+ * Run all registered shutdown hooks.
+ * Called during graceful shutdown (SIGTERM/SIGINT).
  *
- * Shutdown order:
- * 1. App's shutdown callback (if defined)
- * 2. Registered shutdown hooks (in reverse order - LIFO)
+ * Hooks are called in reverse order of registration (LIFO).
  */
 export async function runShutdown() {
-    // Run app's shutdown callback first
-    const shutdown = globalThis.__AGENTUITY_SHUTDOWN__;
-    if (shutdown) {
-        const state = getAppState();
-        await shutdown(state);
-    }
-    // Run registered shutdown hooks in reverse order (LIFO)
     const hooks = getShutdownHooks();
     for (let i = hooks.length - 1; i >= 0; i--) {
         const hook = hooks[i];

package/dist/app.js.map

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

package/dist/bootstrap.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Server lifecycle helpers.
+ *
+ * These functions are called by createApp() to set up routes, middleware,
+ * and the Bun HTTP server. They're kept separate to keep createApp() focused
+ * on orchestration while these handle the details.
+ */
+import type { AnalyticsOptions, WorkbenchOptions } from './app';
+import { createRouter } from './router';
+/**
+ * Check if running in development mode.
+ *
+ * The CLI dev server explicitly sets NODE_ENV='development'. In production
+ * (cloud deployment, CI integration test running a built app.js), NODE_ENV
+ * may be 'production' or unset entirely. When unset, we assume production
+ * — the dev server always sets it, so absence means production.
+ */
+export declare const isDevelopment: () => boolean;
+/** Resolve analytics config with defaults */
+export declare function resolveAnalyticsConfig(analytics: boolean | AnalyticsOptions | undefined): AnalyticsOptions & {
+    enabled: boolean;
+};
+/** Resolve workbench config */
+export declare function resolveWorkbenchConfig(workbench: boolean | string | WorkbenchOptions | undefined): {
+    enabled: boolean;
+    route: string;
+    headers: Record<string, string>;
+};
+/** Register analytics routes on the app */
+export declare function registerAnalyticsRoutes(app: ReturnType<typeof createRouter>, _analyticsConfig: AnalyticsOptions & {
+    enabled: boolean;
+}): void;
+export declare function registerHealthRoutes(app: ReturnType<typeof createRouter>): void;
+export declare function registerWebRoutes(app: ReturnType<typeof createRouter>, analyticsConfig: AnalyticsOptions & {
+    enabled: boolean;
+}): void;
+export declare function registerWorkbenchUI(app: ReturnType<typeof createRouter>, workbenchConfig: {
+    enabled: boolean;
+    route: string;
+}): void;
+export declare function startServer(app: ReturnType<typeof createRouter>, options?: {
+    requestTimeout?: number;
+}): void;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAiBxC;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,eAAuD,CAAC;AAMlF,6CAA6C;AAC7C,wBAAgB,sBAAsB,CACrC,SAAS,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,GAC/C,gBAAgB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAmBzC;AAED,+BAA+B;AAC/B,wBAAgB,sBAAsB,CACrC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,gBAAgB,GAAG,SAAS,GACxD;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAetE;AA2CD,2CAA2C;AAC3C,wBAAgB,uBAAuB,CACtC,GAAG,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,EACpC,gBAAgB,EAAE,gBAAgB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GACvD,IAAI,CA2BN;AAMD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,GAAG,IAAI,CA2B/E;AAMD,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,EACpC,eAAe,EAAE,gBAAgB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GACtD,IAAI,CA6CN;AAMD,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,EACpC,eAAe,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClD,IAAI,CAaN;AAMD,wBAAgB,WAAW,CAC1B,GAAG,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,EACpC,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC,IAAI,CAkCN"}