/**
 * The structured apply_patch envelope: parser and applier for the
 * `*** Begin Patch` multi-file dialect.
 *
 * @remarks
 * Shared structured-patch primitives for workspace-shaped batteries. This dialect derives from the
 * GitHub Copilot apply_patch format — one of the most robust and battle-tested patch formats
 * in production use, which is also why models already know how to write it. The grammar
 * (`*** Begin Patch` … `*** End Patch`, `*** Add File:` / `*** Delete File:` /
 * `*** Update File:` (+ `*** Move to:`), `@@` context hunks with `+`/`-`/space lines) is
 * preserved exactly — inventing a "better" variation would forfeit the pretraining. Ported
 * from the source server's `doc.apply_patch` adapter (its green e2e suite informs the spec
 * coverage); the context matcher rejects ambiguity (a hunk whose context matches more than
 * one location fails rather than guessing).
 */
/** One parsed `@@` hunk: the context+removal lines and their replacement. */
export interface ParsedHunk {
    oldLines: string[];
    newLines: string[];
    added: number;
    removed: number;
}
/** `*** Add File:` — create a new file from `+` lines. */
export interface AddOperation {
    type: 'add';
    path: string;
    content: string;
    added: number;
}
/** `*** Delete File:` — remove a file. */
export interface DeleteOperation {
    type: 'delete';
    path: string;
}
/** `*** Update File:` (+ optional `*** Move to:`) — apply hunks, optionally rename. */
export interface UpdateOperation {
    type: 'update';
    path: string;
    movePath?: string;
    hunks: ParsedHunk[];
    added: number;
    removed: number;
}
/** Any one operation of a structured patch. */
export type PatchOperation = AddOperation | DeleteOperation | UpdateOperation;
/** The parsed envelope: ordered operations plus totals. */
export interface ParsedApplyPatch {
    operations: PatchOperation[];
    added: number;
    removed: number;
}
/** `true` when `patch` is the structured envelope rather than a unified diff. */
export declare const isStructuredPatch: (patch: string) => boolean;
/** Normalize a workspace path: relative, no `.`/`..`/empty segments, forward slashes. */
export declare const normalizeWorkspacePath: (path: string) => string;
/**
 * Parse a structured `*** Begin Patch` envelope.
 *
 * @param patch - The raw patch text.
 * @returns The parsed operations.
 */
export declare const parseStructuredPatch: (patch: string) => ParsedApplyPatch;
/**
 * Apply an update operation's hunks to `inputText`. Context matching is exact and rejects
 * ambiguity: a hunk whose old-lines match more than one location past the cursor fails
 * rather than guessing.
 *
 * The input's line-ending convention is preserved: a file containing CRLF is rejoined with CRLF,
 * so a one-line edit stays a one-line diff rather than a whole-file newline rewrite.
 *
 * @param inputText - The file's current text.
 * @param hunks - The parsed hunks, in order.
 * @returns The patched text, using the input's dominant line terminator.
 */
export declare const applyUpdateHunks: (inputText: string, hunks: ParsedHunk[]) => string;
/** One file in the virtual workspace a structured patch operates over. */
export interface WorkspaceFile {
    text: string;
    mimeType: string;
}
/**
 * Apply a parsed structured patch to a virtual workspace of files keyed by normalized path.
 *
 * @param files - The workspace (mutated in place).
 * @param patch - The parsed envelope.
 * @returns The workspace and the number of files touched.
 */
export declare const applyOperations: (files: Map<string, WorkspaceFile>, patch: ParsedApplyPatch) => {
    files: Map<string, WorkspaceFile>;
    modifiedFiles: number;
};
/** Infer a text MIME from a workspace path's extension (Add File outputs). */
export declare const inferTextMimeFromPath: (path: string) => string;