/**
 * synap doc create / synap doc update
 *
 * Manage markdown documents on the pod.
 *
 * Usage:
 *   synap doc create --title "My Doc" --content "# Hello" [--workspace <id>] [--open]
 *   synap doc create --title "My Doc" --file ./notes.md [--open]
 *   echo "# Hello" | synap doc create --title "My Doc"
 *
 *   synap doc update <id> --content "new body" [--title "New Title"]
 *   synap doc update <id> --file ./notes.md
 *   echo "updated" | synap doc update <id>
 *
 * API:
 *   POST  /api/hub/documents        — { userId, workspaceId?, title, content?, type? }
 *   PATCH /api/hub/documents/:id    — { userId, content } (full-replace, proposal-gated)
 */
export interface DocCreateOpts {
    title: string;
    content?: string;
    file?: string;
    workspace?: string;
    open?: boolean;
    json?: boolean;
    podUrl?: string;
    apiKey?: string;
}
export interface DocUpdateOpts {
    content?: string;
    file?: string;
    title?: string;
    open?: boolean;
    json?: boolean;
    podUrl?: string;
    apiKey?: string;
}
export interface DocReferenceOpts {
    title: string;
    workspace?: string;
    open?: boolean;
    json?: boolean;
    podUrl?: string;
    apiKey?: string;
}
export declare function docCreate(opts: DocCreateOpts): Promise<void>;
/**
 * synap doc reference <url> — create an external reference document (no bytes).
 * Reuses the same POST /api/hub/documents door as `doc create`, sending a `url`
 * field instead of `content`.
 */
export declare function docReference(url: string, opts: DocReferenceOpts): Promise<void>;
export declare function docUpdate(documentId: string, opts: DocUpdateOpts): Promise<void>;