import type { SessionEvent, WorkspaceCaptureDegradedReason, WorkspaceCaptureManifest } from "@opengeni/sdk";
import { type ClientOverride } from "../provider.js";
export type UseWorkspaceCaptureOptions = ClientOverride & {
    /** Live event log (usually `useSessionEvents().events`) — a
     *  `workspace.revision.captured` for a NEWER revision refreshes the manifest. */
    events?: SessionEvent[] | undefined;
    /** Hold off the mount fetch (e.g. the workbench panel is collapsed). Default true. */
    enabled?: boolean | undefined;
};
export type UseWorkspaceCaptureResult = {
    /** The resolved manifest (tree index + per-repo diffs + file refs), or null when
     *  no capture exists (falls back to the live/wake path — status quo). */
    capture: WorkspaceCaptureManifest | null;
    /** The loaded capture's monotonic revision, or null when unavailable. */
    revision: number | null;
    /** When the loaded capture was taken (ISO), for the "as of <time>" source badge. */
    capturedAt: string | null;
    /** Whether a capture is available at all (the `{available:false}` discriminator). */
    available: boolean;
    /** Why the newest durable revision is unavailable. null means no capture has
     *  been attempted yet; a value means capture explicitly failed closed and
     *  consumers must use the live box rather than trust an incomplete snapshot. */
    degradedReason: WorkspaceCaptureDegradedReason | null;
    /** The changed-file count from the capture's stats, resolved on the FIRST GET
     *  (from the response's top-level `stats`, before any manifest-URL hop). null
     *  until that first resolve; 0 when no capture exists. This is the pre-paint
     *  "changes exist?" signal the dock uses to pick its default tab with no
     *  embedder events-at-mount contract. */
    fileCount: number | null;
    /** A newer revision has been ANNOUNCED than the one currently loaded (a refresh
     *  is in flight or pending). M5's source badge can show a subtle "updating…". */
    isStale: boolean;
    loading: boolean;
    error: Error | null;
    /** Force a re-fetch of the latest capture. */
    refresh: () => Promise<void>;
};
/**
 * The cold-paint data source: fetch the latest turn-end workspace capture with a
 * SINGLE api round-trip on mount (no machine, no Channel-A — this is the <200ms
 * first paint). The manifest is served inline in the common
 * case; a rare >2MB manifest comes back as a short-TTL signed URL we follow.
 *
 * Subscribes to the live event log: a `workspace.revision.captured` for a revision
 * newer than the one loaded triggers a background refresh (stale-while-revalidate).
 * `{available:false}` is a value, never a crash — consumers fall back to the
 * live/wake path exactly as before the capture feature existed.
 */
export declare function useWorkspaceCapture(sessionId: string | null | undefined, options?: UseWorkspaceCaptureOptions): UseWorkspaceCaptureResult;