@fungi.computer/agar 0.0.0-stage → 0.0.1

package/dist/git-steps.d.ts

@@ -0,0 +1,579 @@
+import * as z from "zod";
+import type { CommitFilesRequest, MergeBranchRequest, GitCommitStore, GitWriteOutcome, GitMergeOutcome } from "./git-commit.js";
+/** Permanent continuation failure: background owners settle their lane instead of retrying it. */
+export declare class GitStepMaterialError extends Error {
+    /** Invalid material, unavailable atomic support, or an exhausted unchanged-head push refusal. */
+    readonly code: "unavailable" | "conflict" | "digest_mismatch" | "atomic_unavailable" | "push_refused";
+    /** Construct the canonical permanent continuation error.
+     * @param code - Permanent continuation failure reason.
+     */
+    constructor(code: GitStepMaterialError["code"]);
+}
+/** Facet-owned immutable material, split into individually bounded rows. */
+export type GitStepMaterial = Readonly<{
+    /** Retain one immutable row; an exact replay succeeds and conflicting bytes refuse. */
+    put(key: string, seq: number, bytes: Uint8Array): Promise<void>;
+    /** Restore ordered material from bounded rows, refusing missing rows. */
+    read(key: string): Promise<Uint8Array>;
+    /** Delete a literal owner prefix after durable terminal settlement, including orphaned rows. */
+    drop(prefix: string): Promise<void>;
+}>;
+/** Existing facet SQLite owner; no transaction or scheduler is introduced here. */
+export type GitStepSql = Readonly<{
+    /** Execute a statement in the existing facet database; its owner controls transactions. */
+    exec(query: string, ...bindings: (string | number | ArrayBuffer)[]): {
+        /** Read the native SQLite cursor rows. */
+        toArray(): readonly Readonly<Record<string, string | number | ArrayBuffer | null>>[];
+    };
+}>;
+/** One-MiB material rows; exact replays are idempotent, conflicting material refuses. */
+export declare function sqliteGitStepMaterial(sql: GitStepSql): GitStepMaterial;
+/** Volatile foreground driver material; background callers use the facet owner. */
+export declare function memoryGitStepMaterial(): GitStepMaterial;
+/** Strict, JSON-only continuation grammar; material and authority are not stored in it. */
+export declare const gitStepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    phase: z.ZodLiteral<"fetch-base">;
+    base: z.ZodNullable<z.ZodString>;
+    key: z.ZodString;
+    timestamp: z.ZodNumber;
+    operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"commit">;
+        request: z.ZodObject<{
+            repository: z.ZodString;
+            branch: z.ZodString;
+            expectedHead: z.ZodNullable<z.ZodString>;
+            startFrom: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        changesDigest: z.ZodCustomStringFormat<"sha256_hex">;
+        tags: z.ZodArray<z.ZodObject<{
+            ref: z.ZodString;
+            expected: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"merge">;
+        request: z.ZodObject<{
+            target: z.ZodString;
+            source: z.ZodString;
+            branch: z.ZodString;
+            sourceBranch: z.ZodString;
+            expectedSource: z.ZodString;
+            expectedTarget: z.ZodOptional<z.ZodString>;
+            behind: z.ZodOptional<z.ZodNumber>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>, z.ZodObject<{
+    phase: z.ZodLiteral<"too-large">;
+    key: z.ZodString;
+    timestamp: z.ZodNumber;
+    operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"commit">;
+        request: z.ZodObject<{
+            repository: z.ZodString;
+            branch: z.ZodString;
+            expectedHead: z.ZodNullable<z.ZodString>;
+            startFrom: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        changesDigest: z.ZodCustomStringFormat<"sha256_hex">;
+        tags: z.ZodArray<z.ZodObject<{
+            ref: z.ZodString;
+            expected: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"merge">;
+        request: z.ZodObject<{
+            target: z.ZodString;
+            source: z.ZodString;
+            branch: z.ZodString;
+            sourceBranch: z.ZodString;
+            expectedSource: z.ZodString;
+            expectedTarget: z.ZodOptional<z.ZodString>;
+            behind: z.ZodOptional<z.ZodNumber>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>, z.ZodObject<{
+    phase: z.ZodLiteral<"inspect-base">;
+    key: z.ZodString;
+    timestamp: z.ZodNumber;
+    operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"commit">;
+        request: z.ZodObject<{
+            repository: z.ZodString;
+            branch: z.ZodString;
+            expectedHead: z.ZodNullable<z.ZodString>;
+            startFrom: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        changesDigest: z.ZodCustomStringFormat<"sha256_hex">;
+        tags: z.ZodArray<z.ZodObject<{
+            ref: z.ZodString;
+            expected: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"merge">;
+        request: z.ZodObject<{
+            target: z.ZodString;
+            source: z.ZodString;
+            branch: z.ZodString;
+            sourceBranch: z.ZodString;
+            expectedSource: z.ZodString;
+            expectedTarget: z.ZodOptional<z.ZodString>;
+            behind: z.ZodOptional<z.ZodNumber>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>, z.ZodObject<{
+    phase: z.ZodLiteral<"inspect-source">;
+    key: z.ZodString;
+    timestamp: z.ZodNumber;
+    operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"commit">;
+        request: z.ZodObject<{
+            repository: z.ZodString;
+            branch: z.ZodString;
+            expectedHead: z.ZodNullable<z.ZodString>;
+            startFrom: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        changesDigest: z.ZodCustomStringFormat<"sha256_hex">;
+        tags: z.ZodArray<z.ZodObject<{
+            ref: z.ZodString;
+            expected: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"merge">;
+        request: z.ZodObject<{
+            target: z.ZodString;
+            source: z.ZodString;
+            branch: z.ZodString;
+            sourceBranch: z.ZodString;
+            expectedSource: z.ZodString;
+            expectedTarget: z.ZodOptional<z.ZodString>;
+            behind: z.ZodOptional<z.ZodNumber>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>, z.ZodObject<{
+    phase: z.ZodLiteral<"fetch-source">;
+    target: z.ZodOptional<z.ZodString>;
+    key: z.ZodString;
+    timestamp: z.ZodNumber;
+    operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"commit">;
+        request: z.ZodObject<{
+            repository: z.ZodString;
+            branch: z.ZodString;
+            expectedHead: z.ZodNullable<z.ZodString>;
+            startFrom: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        changesDigest: z.ZodCustomStringFormat<"sha256_hex">;
+        tags: z.ZodArray<z.ZodObject<{
+            ref: z.ZodString;
+            expected: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"merge">;
+        request: z.ZodObject<{
+            target: z.ZodString;
+            source: z.ZodString;
+            branch: z.ZodString;
+            sourceBranch: z.ZodString;
+            expectedSource: z.ZodString;
+            expectedTarget: z.ZodOptional<z.ZodString>;
+            behind: z.ZodOptional<z.ZodNumber>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>, z.ZodObject<{
+    phase: z.ZodLiteral<"inspect-target">;
+    sourceDigest: z.ZodCustomStringFormat<"sha256_hex">;
+    key: z.ZodString;
+    timestamp: z.ZodNumber;
+    operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"commit">;
+        request: z.ZodObject<{
+            repository: z.ZodString;
+            branch: z.ZodString;
+            expectedHead: z.ZodNullable<z.ZodString>;
+            startFrom: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        changesDigest: z.ZodCustomStringFormat<"sha256_hex">;
+        tags: z.ZodArray<z.ZodObject<{
+            ref: z.ZodString;
+            expected: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"merge">;
+        request: z.ZodObject<{
+            target: z.ZodString;
+            source: z.ZodString;
+            branch: z.ZodString;
+            sourceBranch: z.ZodString;
+            expectedSource: z.ZodString;
+            expectedTarget: z.ZodOptional<z.ZodString>;
+            behind: z.ZodOptional<z.ZodNumber>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>, z.ZodObject<{
+    phase: z.ZodLiteral<"fetch-target">;
+    sourceDigest: z.ZodCustomStringFormat<"sha256_hex">;
+    target: z.ZodString;
+    key: z.ZodString;
+    timestamp: z.ZodNumber;
+    operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"commit">;
+        request: z.ZodObject<{
+            repository: z.ZodString;
+            branch: z.ZodString;
+            expectedHead: z.ZodNullable<z.ZodString>;
+            startFrom: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        changesDigest: z.ZodCustomStringFormat<"sha256_hex">;
+        tags: z.ZodArray<z.ZodObject<{
+            ref: z.ZodString;
+            expected: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"merge">;
+        request: z.ZodObject<{
+            target: z.ZodString;
+            source: z.ZodString;
+            branch: z.ZodString;
+            sourceBranch: z.ZodString;
+            expectedSource: z.ZodString;
+            expectedTarget: z.ZodOptional<z.ZodString>;
+            behind: z.ZodOptional<z.ZodNumber>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>, z.ZodObject<{
+    phase: z.ZodLiteral<"inspect-merge-push">;
+    old: z.ZodNullable<z.ZodString>;
+    built: z.ZodString;
+    packDigest: z.ZodCustomStringFormat<"sha256_hex">;
+    attempt: z.ZodNumber;
+    pushBefore: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    atomic: z.ZodOptional<z.ZodLiteral<true>>;
+    key: z.ZodString;
+    timestamp: z.ZodNumber;
+    operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"commit">;
+        request: z.ZodObject<{
+            repository: z.ZodString;
+            branch: z.ZodString;
+            expectedHead: z.ZodNullable<z.ZodString>;
+            startFrom: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        changesDigest: z.ZodCustomStringFormat<"sha256_hex">;
+        tags: z.ZodArray<z.ZodObject<{
+            ref: z.ZodString;
+            expected: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"merge">;
+        request: z.ZodObject<{
+            target: z.ZodString;
+            source: z.ZodString;
+            branch: z.ZodString;
+            sourceBranch: z.ZodString;
+            expectedSource: z.ZodString;
+            expectedTarget: z.ZodOptional<z.ZodString>;
+            behind: z.ZodOptional<z.ZodNumber>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>, z.ZodObject<{
+    phase: z.ZodLiteral<"inspect-atomic">;
+    old: z.ZodNullable<z.ZodString>;
+    built: z.ZodString;
+    packDigest: z.ZodCustomStringFormat<"sha256_hex">;
+    attempt: z.ZodNumber;
+    pushBefore: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    atomic: z.ZodOptional<z.ZodLiteral<true>>;
+    key: z.ZodString;
+    timestamp: z.ZodNumber;
+    operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"commit">;
+        request: z.ZodObject<{
+            repository: z.ZodString;
+            branch: z.ZodString;
+            expectedHead: z.ZodNullable<z.ZodString>;
+            startFrom: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        changesDigest: z.ZodCustomStringFormat<"sha256_hex">;
+        tags: z.ZodArray<z.ZodObject<{
+            ref: z.ZodString;
+            expected: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"merge">;
+        request: z.ZodObject<{
+            target: z.ZodString;
+            source: z.ZodString;
+            branch: z.ZodString;
+            sourceBranch: z.ZodString;
+            expectedSource: z.ZodString;
+            expectedTarget: z.ZodOptional<z.ZodString>;
+            behind: z.ZodOptional<z.ZodNumber>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>, z.ZodObject<{
+    phase: z.ZodLiteral<"push">;
+    old: z.ZodNullable<z.ZodString>;
+    built: z.ZodString;
+    packDigest: z.ZodCustomStringFormat<"sha256_hex">;
+    attempt: z.ZodNumber;
+    pushBefore: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    atomic: z.ZodOptional<z.ZodLiteral<true>>;
+    key: z.ZodString;
+    timestamp: z.ZodNumber;
+    operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"commit">;
+        request: z.ZodObject<{
+            repository: z.ZodString;
+            branch: z.ZodString;
+            expectedHead: z.ZodNullable<z.ZodString>;
+            startFrom: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        changesDigest: z.ZodCustomStringFormat<"sha256_hex">;
+        tags: z.ZodArray<z.ZodObject<{
+            ref: z.ZodString;
+            expected: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"merge">;
+        request: z.ZodObject<{
+            target: z.ZodString;
+            source: z.ZodString;
+            branch: z.ZodString;
+            sourceBranch: z.ZodString;
+            expectedSource: z.ZodString;
+            expectedTarget: z.ZodOptional<z.ZodString>;
+            behind: z.ZodOptional<z.ZodNumber>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>, z.ZodObject<{
+    phase: z.ZodLiteral<"confirm">;
+    old: z.ZodNullable<z.ZodString>;
+    built: z.ZodString;
+    packDigest: z.ZodCustomStringFormat<"sha256_hex">;
+    attempt: z.ZodNumber;
+    pushBefore: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    atomic: z.ZodOptional<z.ZodLiteral<true>>;
+    key: z.ZodString;
+    timestamp: z.ZodNumber;
+    operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"commit">;
+        request: z.ZodObject<{
+            repository: z.ZodString;
+            branch: z.ZodString;
+            expectedHead: z.ZodNullable<z.ZodString>;
+            startFrom: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        changesDigest: z.ZodCustomStringFormat<"sha256_hex">;
+        tags: z.ZodArray<z.ZodObject<{
+            ref: z.ZodString;
+            expected: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"merge">;
+        request: z.ZodObject<{
+            target: z.ZodString;
+            source: z.ZodString;
+            branch: z.ZodString;
+            sourceBranch: z.ZodString;
+            expectedSource: z.ZodString;
+            expectedTarget: z.ZodOptional<z.ZodString>;
+            behind: z.ZodOptional<z.ZodNumber>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>, z.ZodObject<{
+    phase: z.ZodLiteral<"confirm-ancestry">;
+    head: z.ZodString;
+    old: z.ZodNullable<z.ZodString>;
+    built: z.ZodString;
+    packDigest: z.ZodCustomStringFormat<"sha256_hex">;
+    attempt: z.ZodNumber;
+    pushBefore: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    atomic: z.ZodOptional<z.ZodLiteral<true>>;
+    key: z.ZodString;
+    timestamp: z.ZodNumber;
+    operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"commit">;
+        request: z.ZodObject<{
+            repository: z.ZodString;
+            branch: z.ZodString;
+            expectedHead: z.ZodNullable<z.ZodString>;
+            startFrom: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        changesDigest: z.ZodCustomStringFormat<"sha256_hex">;
+        tags: z.ZodArray<z.ZodObject<{
+            ref: z.ZodString;
+            expected: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"merge">;
+        request: z.ZodObject<{
+            target: z.ZodString;
+            source: z.ZodString;
+            branch: z.ZodString;
+            sourceBranch: z.ZodString;
+            expectedSource: z.ZodString;
+            expectedTarget: z.ZodOptional<z.ZodString>;
+            behind: z.ZodOptional<z.ZodNumber>;
+            message: z.ZodString;
+            author: z.ZodObject<{
+                name: z.ZodString;
+                email: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>], "phase">;
+/** Durable checkpoint, suitable for a Watchdog payload and fresh-frame re-admission. */
+export type GitStep = z.output<typeof gitStepSchema>;
+/** Caller-owned operation; begin fixes the timestamp and stores file bytes outside the checkpoint. */
+export type GitStepOperation = Readonly<{
+    kind: "commit";
+    requestKey: string;
+    request: CommitFilesRequest;
+    tags?: readonly Readonly<{
+        ref: string;
+        expected: string | null;
+    }>[];
+    timestamp?: number;
+}> | Readonly<{
+    kind: "merge";
+    requestKey: string;
+    request: MergeBranchRequest;
+    timestamp?: number;
+}>;
+/** Final Git outcome; oversize material refuses before any receive-pack. */
+export type GitStepOutcome = GitWriteOutcome | GitMergeOutcome | Readonly<{
+    kind: "too_large";
+}>;
+/** One step either checkpoints, settles, or yields before transport. */
+export type GitStepResult = Readonly<{
+    next: GitStep;
+}> | Readonly<{
+    done: GitStepOutcome;
+}> | Readonly<{
+    yield: true;
+}>;
+/** Per-frame transport plus the existing facet's durable material owner. */
+export type GitStepPorts = Readonly<{
+    git: GitCommitStore;
+    material: GitStepMaterial;
+}>;
+/** Prepare immutable request material before atomically enqueueing the first checkpoint. */
+export declare function begin(input: GitStepOperation, material: GitStepMaterial): Promise<GitStep>;
+/** Execute one fresh-admitted frame; the caller persists next and its successor job atomically. */
+export declare function runStep(raw: GitStep, ports: GitStepPorts, signal: AbortSignal): Promise<GitStepResult>;
+/** Drop material only after the owner has durably recorded the terminal outcome. */
+export declare function dropMaterial(step: GitStep, material: GitStepMaterial): Promise<void>;