import { type ViewerThresholds } from './render-router.js';
export type ViewerTunnelMode = 'off' | 'quick';
/**
 * v1.2.42 (#viewer-3-mode) — three ways agim can produce a public URL
 * for long markdown:
 *   - 'remote' : POST to an external paste server that returns the URL
 *                (good for users without their own domain — operator
 *                ships agim-cli with a hosted endpoint preconfigured).
 *   - 'local'  : keep the markdown in this host's viewer.db, serve it
 *                from the web server, and rely on an operator-managed
 *                reverse proxy / public DNS (publicBaseUrl).
 *   - 'tunnel' : same as 'local' for storage; URL comes from
 *                cloudflared quick tunnel. Cloudflared may be blocked
 *                in mainland China (DNS) — we surface that as a setup
 *                hint, not a hard failure.
 *   - 'none'   : nothing usable; sink degrades to inline summary.
 *
 * Mode picker order (first non-empty wins):
 *   remote-paste url → public base url → quick tunnel → none
 */
export type ViewerMode = 'remote' | 'local' | 'tunnel' | 'none';
/**
 * Whether long-reply viewer routing may apply to this delivery platform.
 *
 * IM messengers (WeChat / Feishu / DingTalk / Telegram / Discord / Email / …)
 * return true. Browser, Mac/iOS Portal shells (`platform=web`), and the local
 * TUI return false — they show full markdown inline.
 */
export declare function isViewerApplicablePlatform(platform: string): boolean;
/**
 * Effective viewer switch for a delivery: env master ON **and** the
 * platform is an IM channel. Non-IM surfaces always get inline full text.
 */
export declare function isViewerEnabledForPlatform(platform: string, cfg?: ViewerConfig): boolean;
export interface ViewerConfig {
    /**
     * Master switch for IM long-reply viewer routing.
     * Only takes effect for IM platforms (`isViewerApplicablePlatform`);
     * browser / app / mac / TUI ignore this flag and always stay inline.
     */
    enabled: boolean;
    /**
     * Public-facing base URL of THIS host's agim web console. Used to build the
     * link returned in IM (`<base>/v/<id>`). When empty we fall back to
     * `http://127.0.0.1:<web_port>` — fine for testing on the same machine, but
     * IM clients on phones will obviously not be able to open it.
     */
    publicBaseUrl: string;
    /**
     * Auto-tunnel mode for operators without a public URL.
     *   - 'off'   (default): use publicBaseUrl as-is.
     *   - 'quick': launch cloudflared quick tunnel on startup; URL is
     *              `https://*.trycloudflare.com` and changes per agim restart.
     */
    tunnelMode: ViewerTunnelMode;
    /**
     * v1.2.42 — Remote paste-server endpoint. When set, message-sink
     * uploads the full markdown to this URL via HTTP POST instead of
     * storing it in viewer.db, and uses the URL returned by the server
     * for the IM link. Lets users without their own domain still get
     * working viewer links (the operator runs a single hosted paste
     * server for everyone).
     *
     * Wire contract (server side): receive `POST <url>`, body =
     * markdown (text/markdown or application/json {markdown}), respond
     * with JSON `{ url: "https://..." }` for the public link. See
     * `services/viewer-paste/README.md` for a reference implementation.
     */
    remotePasteUrl: string;
    /** Optional Bearer token forwarded to the remote paste server. */
    remotePasteToken: string;
    /** Char / line / code-block thresholds for routing to web. */
    thresholds: ViewerThresholds;
}
/**
 * v1.2.43 — community-hosted default paste server.
 *
 * Operators who don't have a domain or working tunnel still get usable
 * viewer links out of the box by routing through this public service.
 * Users can:
 *   - Override by setting their own AGIM_VIEWER_REMOTE_PASTE_URL
 *   - Opt back into a local-only path by setting AGIM_VIEWER_PUBLIC_BASE_URL
 *   - Disable the default entirely with AGIM_VIEWER_NO_DEFAULT_REMOTE=1
 *
 * IMPORTANT — privacy: with the default on, any markdown long enough
 * to exit the inline path is uploaded to viewer.iclaw.host over HTTPS.
 * agim's CLI wizard surfaces this trade-off on first run; deployment
 * docs (`docs/viewer-modes.md`) cover it too.
 */
export declare const DEFAULT_REMOTE_PASTE_URL = "https://viewer.iclaw.host/paste";
export declare function getViewerConfig(): ViewerConfig;
/**
 * v1.2.45 — pick the active viewer mode.
 *
 * Operator-visible knobs (CLI + Web admin):
 *   - Public base URL  → run agim behind your own domain (local mode)
 *   - Tunnel mode      → cloudflared quick tunnel (tunnel mode)
 *   - Disable default  → opt out of the community paste server fallback
 *
 * Hidden env override (advanced, not surfaced in UI):
 *   - AGIM_VIEWER_REMOTE_PASTE_URL — point to a different paste
 *     server (e.g. your own self-hosted clone of viewer-paste). Only
 *     kicks in when neither public base nor tunnel is configured.
 *
 * Order:
 *   1. Public base URL                          → local
 *   2. Tunnel mode = quick                      → tunnel
 *   3. user-set AGIM_VIEWER_REMOTE_PASTE_URL   → remote (custom server)
 *   4. community default viewer.iclaw.host       → remote (default-on)
 *   5. nothing                                   → none (inline degrade)
 *
 * Set AGIM_VIEWER_NO_DEFAULT_REMOTE=1 to skip steps 3-4 entirely.
 */
export declare function resolveViewerMode(cfg?: ViewerConfig): ViewerMode;
/**
 * Resolve the effective remote paste URL the sink should POST to.
 * Honours user-set value first, then the community default unless
 * the operator opted out via AGIM_VIEWER_NO_DEFAULT_REMOTE=1.
 * Returns null when no usable URL is available.
 */
export declare function getEffectiveRemotePasteUrl(cfg?: ViewerConfig): string | null;
/**
 * Resolve the effective public base URL. Order of preference:
 *   1. Explicit AGIM_VIEWER_PUBLIC_BASE_URL (operator-managed reverse proxy)
 *   2. Auto-tunnel URL if tunnel_mode=quick and cloudflared has acquired a URL
 *   3. Caller-supplied fallback
 *
 * Returns empty string when nothing usable is available.
 */
export declare function getEffectivePublicBaseUrl(fallback?: string): string;
/**
 * Build the URL placed in the IM reply for a saved paste. Returns null if
 * no public base URL is configured AND no fallback was provided. Caller
 * should treat null as "viewer can't produce a usable link — degrade".
 */
export declare function buildPasteUrl(id: string, fallbackBaseUrl?: string): string | null;
//# sourceMappingURL=viewer-config.d.ts.map