Application Entry Point

interface AppResult<TAppState> {
  state: TAppState;                      // Value returned from setup()
  router: Hono;                          // The main application router
  server: Server;                        // Server instance with .url property
  logger: Logger;                        // Application-level logger
  addEventListener(event, handler): void;   // Subscribe to app events
  removeEventListener(event, handler): void; // Unsubscribe from app events
}

// app.ts
import { createApp } from '@agentuity/runtime';
 
// Create the application instance (async)
const { server, logger } = await createApp();
 
// The application will automatically discover and mount agents
// from the agents directory specified in your agentuity.json
 
// Access application properties
logger.info(`Server running at ${server.url}`);

import { createApp } from '@agentuity/runtime';
 
const { server, logger } = await createApp({
  // Custom CORS settings
  cors: {
    origin: ['https://example.com'],
    credentials: true
  },
  // Use local services for development
  services: {
    useLocal: true
  }
});

import { createApp } from '@agentuity/runtime';
 
const { server, logger } = await createApp({
  // Initialize shared resources
  setup: async () => {
    const db = await connectDatabase();
    const redis = await connectRedis();
    return { db, redis };
  },
  // Clean up on shutdown
  shutdown: async (state) => {
    await state.db.close();
    await state.redis.quit();
  },
});
 
// In agents, access via ctx.app:
// ctx.app.db.query('SELECT * FROM users')

import { createApp } from '@agentuity/runtime';
 
const app = await createApp({
  cors: {
    sameOrigin: true,
    allowedOrigins: ['https://admin.myapp.com'],
  }
});

import { createApp } from '@agentuity/runtime';
 
const app = await createApp({
  compression: {
    threshold: 2048,
    // Skip compression for internal endpoints
    filter: (c) => !c.req.path.startsWith('/internal'),
  }
});
 
// Or disable compression entirely
const app2 = await createApp({ compression: false });

import { createApp, createRouter } from '@agentuity/runtime';
 
// Single router mounted at /api (default)
const router = createRouter();
router.get('/users', (c) => c.json({ users: [] }));
 
const app = await createApp({ router });

// A Hono instance (mounted at /api)
router: myRouter
 
// A { path, router } object (mounted at the specified path)
router: { path: '/v1', router: myRouter }
 
// An array of mounts
router: [
  { path: '/api/v1', router: v1Router },
  { path: '/api/v2', router: v2Router },
]

import { getAppState } from '@agentuity/runtime';
 
const state = getAppState<{ db: Database }>();
state.db.query('SELECT 1');

import { getAppConfig } from '@agentuity/runtime';
 
const config = getAppConfig();
if (config?.requestTimeout) {
  // timeout was configured
}

import { isDevMode } from '@agentuity/runtime';
 
if (isDevMode()) {
  // Enable verbose logging in development
}

import { isInsideAgentRuntime } from '@agentuity/runtime';
 
if (!isInsideAgentRuntime()) {
  // Running standalone: initialize services manually
}

import { registerShutdownHook } from '@agentuity/runtime';
 
// Register a cleanup function
const unregister = registerShutdownHook(async () => {
  await pool.end();
});
 
// Later, if needed, remove the hook
unregister();

registerShutdownHook(hook: () => Promise<void> | void): () => void

// app.ts
import { createApp } from '@agentuity/runtime';
 
if (!process.env.AGENTUITY_SDK_KEY) {
  console.error('Missing AGENTUITY_SDK_KEY environment variable');
  process.exit(1);
}
 
const { server, logger } = await createApp();
 
// Access other environment variables
const apiEndpoint = process.env.API_ENDPOINT || 'https://api.example.com';
const openaiKey = process.env.OPENAI_API_KEY;
// Optional: you can use the AI Gateway to access OpenAI, Anthropic, etc without needing to set various API keys.