declare type AppModule = Record<string, unknown>;

/** A lazy loader — used by the serve bundle so an app module is EVALUATED on
 *  first `importAppModule` (i.e. during `runServe`, AFTER `registerCoreTables`),
 *  not eagerly at bundle-import time (which would run before the core-table
 *  registration and blow up store construction). esbuild code-splitting keeps the
 *  loaded chunk on the SAME framework/effect instance as the bundle. */
declare type LazyAppModule = () => Promise<AppModule>;

export declare const loadDotEnv: (argv: ReadonlyArray<string>) => void;

/** Register prebuilt app modules keyed by ABSOLUTE source path. Values may be the
 *  module namespace directly (the eager `apiEntry.js` bundle) OR a lazy
 *  `() => import(...)` loader (the serve bundle). Called once by `voltro serve`. */
export declare const registerAppModules: (mods: Readonly<Record<string, AppModule | LazyAppModule>>) => void;

/** Register a driver module pre-bundled by `voltro build` (keyed by package spec). */
export declare const registerDriver: (spec: string, mod: Record<string, unknown>) => void;

export declare const runServe: (args: ReadonlyArray<string>) => Promise<number>;

export { }


declare module '@voltro/protocol' {
    interface VoltroTableNames {
        'tasks': true;
        'task_sub_tasks': true;
        '_voltro_workflow_runs': true;
        '_voltro_workflow_run_steps': true;
        '_voltro_workflow_run_events': true;
        '_voltro_workflow_events': true;
        '_voltro_workflow_event_deliveries': true;
        '_voltro_approvals': true;
        '_voltro_connections': true;
        '_voltro_undo_log': true;
    }
}


declare module '@voltro/protocol' {
    interface VoltroTableNames {
        'invoices': true;
        'invoice_lines': true;
    }
}