/**
 * Sandbox Helpers - Generate files for deploying a cross-origin sandbox
 *
 * The sandbox runs on a different origin (e.g., myapp-sandbox.vercel.app)
 * to provide browser-enforced isolation from the main application.
 */
export interface SandboxHtmlOptions {
    /**
     * URL to load almostnode from (e.g., unpkg, jsdelivr, or your CDN)
     * @default 'https://unpkg.com/almostnode/dist/index.js'
     */
    almostnodeUrl?: string;
    /**
     * Whether to include service worker registration for dev server support.
     * When true, the sandbox can run ViteDevServer/NextDevServer with URL access.
     * @default true
     */
    includeServiceWorker?: boolean;
}
/**
 * HTML template for the sandbox page.
 * This loads almostnode and handles postMessage communication with the parent.
 *
 * @param options - Configuration options or legacy URL string
 */
export declare function getSandboxHtml(options?: SandboxHtmlOptions | string): string;
/**
 * Get vercel.json configuration for the sandbox.
 * Sets up CORS headers to allow embedding as a cross-origin iframe.
 */
export declare function getSandboxVercelConfig(): object;
export interface GenerateSandboxFilesOptions extends SandboxHtmlOptions {
}
/**
 * Generate all files needed for deploying a sandbox to Vercel or other platforms.
 *
 * @param options - Configuration options or legacy URL string
 * @returns Object with file names as keys and content as values
 *
 * @example
 * ```typescript
 * import { generateSandboxFiles } from '@agent-wasm/core';
 * import fs from 'fs';
 *
 * const files = generateSandboxFiles();
 *
 * // Write files to sandbox/ directory
 * fs.mkdirSync('sandbox', { recursive: true });
 * for (const [filename, content] of Object.entries(files)) {
 *   fs.writeFileSync(`sandbox/${filename}`, content);
 * }
 *
 * // Deploy to Vercel: cd sandbox && vercel --prod
 * ```
 */
export declare function generateSandboxFiles(options?: GenerateSandboxFilesOptions | string): {
    'index.html': string;
    'vercel.json': string;
    '__sw__.js'?: string;
};
/**
 * Instructions for setting up a sandbox on Vercel.
 * Useful for documentation or CLI output.
 */
export declare const SANDBOX_SETUP_INSTRUCTIONS: string;
//# sourceMappingURL=sandbox-helpers.d.ts.map