import type { DaemonApiRouteHandlers } from './context.js';
/**
 * Optional extension dispatchers injected alongside the standard route set.
 * Each dispatcher is tried in order after the built-in routes; the first
 * non-null result wins. Exceptions thrown by an extension propagate to the
 * caller, matching built-in route behavior. Use this to wire companion-chat,
 * provider, or other feature routes into the standalone daemon without
 * modifying core route files.
 */
export type DaemonApiRouteExtension = (req: Request) => Promise<Response | null> | Response | null;
/**
 * Dispatch an incoming HTTP request against the full daemon API route set.
 *
 * Routes are tried in order: gateway-rest → remote → operator → automation → session → task → extensions.
 * Returns the first non-null `Response`, or `null` if no route matched.
 *
 * @param req - The incoming HTTP request.
 * @param handlers - Object implementing `DaemonApiRouteHandlers`.
 * @param extensions - Optional additional dispatchers tried after built-in routes.
 * @returns The matched route's `Response`, or `null` if unmatched.
 *
 * @example
 * ```ts
 * import { dispatchDaemonApiRoutes } from '@pellux/goodvibes-daemon-sdk';
 *
 * const response = await dispatchDaemonApiRoutes(req, myHandlers);
 * if (response) return response;
 * return new Response('Not found', { status: 404 });
 * ```
 */
export declare function dispatchDaemonApiRoutes(req: Request, handlers: DaemonApiRouteHandlers, extensions?: readonly DaemonApiRouteExtension[]): Promise<Response | null>;
//# sourceMappingURL=api-router.d.ts.map