/**
 * Zoe Remote Server — Entry Point
 *
 * Creates an HTTP server with REST endpoints and WebSocket support
 * for real-time streaming conversations with LLM providers.
 *
 * Default port: 7337
 */
import * as http from "http";
import type { PermissionLevel } from "../../core/types.js";
export interface ServerOptions {
    /** Port to listen on (default: ZOE_PORT, PORT, or 7337) */
    port?: number;
    /** Host to bind to (default: "0.0.0.0") */
    host?: string;
    /** Enable CORS headers (default: true) */
    cors?: boolean;
    /** Session TTL in seconds (default: 86400 = 24 hours) */
    sessionTTL?: number;
    /** Default permission level for REST endpoints (default: "moderate") */
    permissionLevel?: PermissionLevel;
    /** Maximum permission level clients can request (caps WebSocket messages) */
    maxPermissionLevel?: PermissionLevel;
}
/**
 * Initialize the skill registry and cache the skill metadata list.
 * Called once during server startup.
 */
export declare function initializeSkills(): Promise<void>;
/**
 * Create and return the Zoe HTTP server (not yet listening).
 *
 * This sets up REST endpoints, WebSocket upgrade handling,
 * session management, and CORS support.
 */
export declare function createServer(options?: ServerOptions): Promise<http.Server>;
/**
 * Create and start listening. Returns the running server.
 */
export declare function startServer(options?: ServerOptions): Promise<http.Server>;