@intentic/machine 1.317.0 → 1.319.0

package/dist/sync/project-local.js

@@ -0,0 +1,217 @@
+import { createHash } from "node:crypto";
+import { createReadStream } from "node:fs";
+import { chmod, lstat, mkdir, open, readdir, readFile, rename, rm, rmdir, stat } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+import { pipeline } from "node:stream/promises";
+import { setTimeout as sleep } from "node:timers/promises";
+import { errnoCode, undefinedIfMissing } from "@intentic/base/errors";
+import { writeFileAtomic } from "@intentic/base/fs";
+import { z } from "zod";
+import { isPortablePath } from "./project-files.js";
+export const hashFile = async (path, algorithm = "sha256") => {
+    const digest = createHash(algorithm);
+    for await (const chunk of createReadStream(path)) {
+        digest.update(chunk);
+    }
+    return digest.digest("hex");
+};
+const flushed = async (path, flags) => {
+    const handle = await open(path, flags);
+    try {
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+};
+export const realDurability = {
+    file: async (path) => await flushed(path, "r+"),
+    folder: async (path) => {
+        if (process.platform !== "win32") {
+            await flushed(path, "r");
+        }
+    },
+};
+const RecordSchema = z.object({
+    localDir: z.string(),
+    remoteDir: z.string(),
+    files: z.record(z.string(), z.tuple([z.number(), z.number(), z.number(), z.string()])),
+    agreed: z.record(z.string(), z.string()),
+});
+export const listingRecordPath = (stateDir, sandboxId) => join(stateDir, "hashes", `${encodeURIComponent(sandboxId)}.json`);
+export const readListingRecord = async (path, localDir, remoteDir) => {
+    const raw = await readFile(path, "utf8").catch(undefinedIfMissing);
+    const parsed = raw === undefined ? undefined : parseRecord(raw);
+    if (parsed === undefined || parsed.localDir !== localDir || parsed.remoteDir !== remoteDir) {
+        return { files: new Map(), agreed: new Map() };
+    }
+    const files = Object.entries(parsed.files).map(([file, [size, mtimeMs, ctimeMs, hash]]) => [file, { size, mtimeMs, ctimeMs, hash }]);
+    return { files: new Map(files), agreed: new Map(Object.entries(parsed.agreed)) };
+};
+const parseRecord = (raw) => {
+    try {
+        return RecordSchema.safeParse(JSON.parse(raw)).data;
+    }
+    catch {
+        return undefined;
+    }
+};
+export const writeListingRecord = async (path, localDir, remoteDir, record) => {
+    const files = Object.fromEntries([...record.files].map(([file, held]) => [file, [held.size, held.mtimeMs, held.ctimeMs, held.hash]]));
+    await writeFileAtomic(path, JSON.stringify({ localDir, remoteDir, files, agreed: Object.fromEntries(record.agreed) }), 0o600);
+};
+export const assertFolder = async (root) => {
+    const info = await stat(root).catch(undefinedIfMissing);
+    if (info?.isDirectory() !== true) {
+        throw new Error(`${root} is not there (moved, deleted, or on a disk that is not connected)`);
+    }
+};
+export const walkLocal = async (walk) => {
+    await assertFolder(walk.root);
+    const listing = new Map();
+    const hashes = new Map();
+    const hashOf = async (path, info) => {
+        const held = walk.cached.get(path);
+        if (held !== undefined && held.size === info.size && held.mtimeMs === info.mtimeMs && held.ctimeMs === info.ctimeMs) {
+            return held.hash;
+        }
+        return walk.wantsHash(path, info.size)
+            ? await hashFile(join(walk.root, path)).then((hash) => hash, () => null)
+            : undefined;
+    };
+    const entryOf = async (path, isFile) => {
+        const info = isFile ? await lstat(join(walk.root, path)).catch(undefinedIfMissing) : undefined;
+        if (info === undefined) {
+            return isFile ? undefined : "other";
+        }
+        const hash = info.isFile() ? await hashOf(path, info) : null;
+        if (hash === null) {
+            return "other";
+        }
+        if (hash !== undefined) {
+            hashes.set(path, { size: info.size, mtimeMs: info.mtimeMs, ctimeMs: info.ctimeMs, hash });
+        }
+        return { size: info.size, hash };
+    };
+    const visit = async (relative) => {
+        const entries = (await readdir(join(walk.root, relative), { withFileTypes: true }).catch(undefinedIfMissing)) ?? [];
+        for (const entry of entries) {
+            const path = relative === "" ? entry.name : `${relative}/${entry.name}`;
+            if (!isPortablePath(path) || walk.ignored(path)) {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                await visit(path);
+                continue;
+            }
+            const listed = await entryOf(path, entry.isFile());
+            if (listed !== undefined) {
+                listing.set(path, listed);
+            }
+        }
+    };
+    await visit("");
+    return { listing, hashes };
+};
+export const localTarget = async (root, path) => {
+    if (!isPortablePath(path)) {
+        throw new Error(`${JSON.stringify(path)} is not a path inside the folder`);
+    }
+    const parts = path.split("/");
+    let target = root;
+    for (const [at, part] of parts.entries()) {
+        target = join(target, part);
+        const info = await lstat(target).catch(undefinedIfMissing);
+        if (info === undefined) {
+            break;
+        }
+        const last = at === parts.length - 1;
+        if (info.isSymbolicLink() || (last ? !info.isFile() : !info.isDirectory())) {
+            throw new Error(last ? "something other than a regular file is here" : `${parts.slice(0, at + 1).join("/")} is not a plain folder here`);
+        }
+    }
+    return join(root, ...parts);
+};
+export const localFile = async (root, path) => {
+    const target = await localTarget(root, path);
+    const info = await lstat(target).catch(undefinedIfMissing);
+    return info === undefined ? undefined : { size: info.size, hash: await hashFile(target), mode: info.mode & 0o7777 };
+};
+const TRANSIENT_RENAME = new Set(["EPERM", "EACCES", "EBUSY"]);
+const renameInto = async (from, to) => {
+    for (let attempt = 1;; attempt += 1) {
+        try {
+            await rename(from, to);
+            return;
+        }
+        catch (error) {
+            if (process.platform !== "win32" || attempt >= 10 || !TRANSIENT_RENAME.has(errnoCode(error) ?? "")) {
+                throw error;
+            }
+            await sleep(50);
+        }
+    }
+};
+let installs = 0;
+export const installFile = async (root, path, source, mode) => {
+    const target = await localTarget(root, path);
+    await mkdirPlain(root, dirname(path));
+    installs += 1;
+    const temporary = join(dirname(target), `.${basename(target)}.intentic-${process.pid}-${installs}.tmp`);
+    try {
+        const handle = await open(temporary, "wx", "exact" in mode || !mode.executable ? 0o666 : 0o777);
+        try {
+            await pipeline(createReadStream(source), handle.createWriteStream());
+        }
+        finally {
+            await handle.close().catch(() => undefined);
+        }
+        if ("exact" in mode) {
+            await chmod(temporary, mode.exact);
+        }
+        await realDurability.file(temporary);
+        await localTarget(root, path);
+        await renameInto(temporary, target);
+    }
+    finally {
+        await rm(temporary, { force: true });
+    }
+};
+const mkdirPlain = async (root, relative) => {
+    if (relative === "." || relative === "") {
+        return;
+    }
+    let at = root;
+    for (const part of relative.split("/")) {
+        at = join(at, part);
+        const info = await lstat(at).catch(undefinedIfMissing);
+        if (info === undefined) {
+            await mkdirOne(at);
+        }
+        else if (info.isSymbolicLink() || !info.isDirectory()) {
+            throw new Error(`${relative} is not a plain folder here`);
+        }
+    }
+};
+const mkdirOne = async (path) => {
+    try {
+        await mkdir(path);
+    }
+    catch (error) {
+        if (errnoCode(error) !== "EEXIST") {
+            throw error;
+        }
+    }
+};
+export const removeFile = async (root, path) => {
+    await rm(await localTarget(root, path));
+    const parts = path.split("/").slice(0, -1);
+    while (parts.length > 0) {
+        const emptied = await rmdir(join(root, ...parts)).then(() => true, () => false);
+        if (!emptied) {
+            return;
+        }
+        parts.pop();
+    }
+};
+//# sourceMappingURL=project-local.js.map

package/dist/sync/project-local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-local.js","sourceRoot":"","sources":["../../src/sync/project-local.ts"],"names":[],"mappings":"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"}

package/dist/sync/project-remote.d.ts

@@ -0,0 +1,55 @@
+import { type Listing } from "./project-files.js";
+export interface Exited {
+    readonly status: number | null;
+    readonly stderr: string;
+}
+export interface Spawned {
+    readonly stdout: AsyncIterable<Buffer>;
+    readonly exit: Promise<Exited>;
+}
+export interface SpawnOptions {
+    readonly input?: string;
+    readonly timeoutMs: number;
+}
+export interface ProjectRunner {
+    readonly spawn: (command: string, args: readonly string[], options: SpawnOptions) => Spawned;
+}
+export declare const realProjectRunner: ProjectRunner;
+export interface Collected extends Exited {
+    readonly stdout: Buffer;
+}
+export declare const collect: (spawned: Spawned) => Promise<Collected>;
+export declare const remoteNodeCommand: (program: string, input: string) => string;
+export declare const LISTING_PROGRAM: string;
+export declare const FETCH_PROGRAM: string;
+export interface Fetched {
+    readonly staged: string;
+    readonly size: number;
+    readonly hash: string;
+    readonly executable: boolean;
+}
+export interface NotFetched {
+    readonly skipped: string;
+}
+export declare const receiveFiles: (stdout: AsyncIterable<Buffer>, paths: readonly string[], staging: string) => Promise<Map<string, Fetched | NotFetched>>;
+export interface SandboxCopy {
+    readonly list: (ignoreExpressions: readonly string[]) => Promise<Listing>;
+    readonly fetch: (paths: readonly string[], staging: string) => Promise<ReadonlyMap<string, Fetched | NotFetched>>;
+}
+export declare const sandboxCopy: (runner: ProjectRunner, ssh: string, alias: string, remoteDir: string) => SandboxCopy;
+export interface ReportedConflict {
+    readonly agreed?: string | undefined;
+    readonly here?: string | undefined;
+}
+export interface SessionView {
+    readonly state: "absent" | "paused" | "running";
+    readonly conflicts: ReadonlyMap<string, ReportedConflict>;
+}
+export interface SessionControl {
+    readonly inspect: () => Promise<SessionView>;
+    readonly flush: () => Promise<boolean>;
+    readonly pause: () => Promise<void>;
+    readonly resume: () => Promise<void>;
+}
+export declare const mutagenSession: (runner: ProjectRunner, mutagen: string, name: string) => SessionControl;
+//# sourceMappingURL=project-remote.d.ts.map

package/dist/sync/project-remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-remote.d.ts","sourceRoot":"","sources":["../../src/sync/project-remote.ts"],"names":[],"mappings":"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"}

package/dist/sync/project-remote.js

@@ -0,0 +1,261 @@
+import { spawn } from "node:child_process";
+import { createHash } from "node:crypto";
+import { open } from "node:fs/promises";
+import { join } from "node:path";
+import { z } from "zod";
+import { parseListing } from "./project-files.js";
+const STDERR_TAIL = 4096;
+export const realProjectRunner = {
+    spawn: (command, args, options) => {
+        const child = spawn(command, [...args], { stdio: ["pipe", "pipe", "pipe"], windowsHide: true });
+        let stderr = "";
+        child.stderr.setEncoding("utf8");
+        child.stderr.on("data", (chunk) => {
+            stderr = `${stderr}${chunk}`.slice(-STDERR_TAIL);
+        });
+        child.stdin.on("error", () => undefined);
+        child.stdin.end(options.input ?? "");
+        const timer = setTimeout(() => child.kill("SIGKILL"), options.timeoutMs);
+        const exit = new Promise((resolve) => {
+            child.on("error", (error) => {
+                clearTimeout(timer);
+                resolve({ status: null, stderr: `${stderr}${error.message}` });
+            });
+            child.on("close", (status) => {
+                clearTimeout(timer);
+                resolve({ status, stderr });
+            });
+        });
+        return { stdout: child.stdout, exit };
+    },
+};
+export const collect = async (spawned) => {
+    const chunks = [];
+    for await (const chunk of spawned.stdout) {
+        chunks.push(chunk);
+    }
+    return { ...(await spawned.exit), stdout: Buffer.concat(chunks) };
+};
+export const remoteNodeCommand = (program, input) => `node -e 'eval(Buffer.from("${Buffer.from(program).toString("base64")}","base64").toString())' ${Buffer.from(input).toString("base64")}`;
+export const LISTING_PROGRAM = String.raw `
+const fs = require("fs");
+const path = require("path");
+const crypto = require("crypto");
+const { root, ignore } = JSON.parse(Buffer.from(process.argv[1], "base64").toString());
+const rules = ignore.map((source) => new RegExp(source));
+const fields = [];
+const hashed = (file) => new Promise((resolve, reject) => {
+    const digest = crypto.createHash("sha256");
+    let size = 0;
+    fs.createReadStream(file)
+        .on("data", (chunk) => { digest.update(chunk); size += chunk.length; })
+        .on("error", reject)
+        .on("end", () => resolve([String(size), digest.digest("hex")]));
+});
+const walk = async (relative) => {
+    for (const entry of await fs.promises.readdir(path.join(root, relative), { withFileTypes: true })) {
+        const name = relative === "" ? entry.name : relative + "/" + entry.name;
+        if (rules.some((rule) => rule.test(name))) continue;
+        if (entry.isDirectory()) { await walk(name); continue; }
+        if (!entry.isFile()) { fields.push(name, "-", "-"); continue; }
+        try { fields.push(name, ...(await hashed(path.join(root, name)))); }
+        catch (error) { if (error.code !== "ENOENT") fields.push(name, "-", "-"); }
+    }
+};
+fs.promises.stat(root).then(
+    (info) => info.isDirectory() ? walk("").then(() => process.stdout.write(fields.map((field) => field + "\0").join(""))) : Promise.reject(new Error(root + " is not a folder")),
+    (error) => { if (error.code === "ENOENT") process.exitCode = 3; else throw error; },
+).catch((error) => { process.stderr.write(error.message + "\n"); process.exitCode = 1; });
+`;
+export const FETCH_PROGRAM = String.raw `
+const fs = require("fs");
+const path = require("path");
+const { root } = JSON.parse(Buffer.from(process.argv[1], "base64").toString());
+const write = (data) => new Promise((resolve, reject) => process.stdout.write(data, (error) => (error ? reject(error) : resolve())));
+const header = (frame) => write(JSON.stringify(frame) + "\n");
+const plainFolders = async (name) => {
+    let at = root;
+    for (const part of name.split("/").slice(0, -1)) {
+        at = path.join(at, part);
+        if (!(await fs.promises.lstat(at)).isDirectory()) return false;
+    }
+    return true;
+};
+const send = async (i, name) => {
+    let handle;
+    try {
+        if (!(await plainFolders(name))) return header({ i, skip: "a folder on its way in the sandbox is not a plain folder" });
+        handle = await fs.promises.open(path.join(root, name), fs.constants.O_RDONLY | fs.constants.O_NOFOLLOW | fs.constants.O_NONBLOCK);
+    } catch (error) {
+        return header({ i, skip: error.code === "ENOENT" ? "it is no longer in the sandbox" : error.code === "ELOOP" ? "it is a link in the sandbox" : String(error.code || error.message) });
+    }
+    try {
+        const info = await handle.stat();
+        if (!info.isFile()) return header({ i, skip: "it is not a regular file in the sandbox" });
+        await header({ i, size: info.size, x: (info.mode & 0o111) !== 0 });
+        let sent = 0;
+        while (sent < info.size) {
+            const buffer = Buffer.alloc(Math.min(1 << 20, info.size - sent));
+            const { bytesRead } = await handle.read(buffer, 0, buffer.length, sent);
+            if (bytesRead === 0) { await write(Buffer.alloc(info.size - sent)); break; }
+            await write(buffer.subarray(0, bytesRead));
+            sent += bytesRead;
+        }
+    } finally {
+        await handle.close();
+    }
+};
+const input = [];
+process.stdin.on("data", (chunk) => input.push(chunk));
+process.stdin.on("end", () => {
+    const names = Buffer.concat(input).toString().split("\0").filter((name) => name !== "");
+    (async () => { for (const [i, name] of names.entries()) await send(i, name); })()
+        .catch((error) => { process.stderr.write(error.message + "\n"); process.exitCode = 1; });
+});
+`;
+const FrameSchema = z.union([
+    z.object({ i: z.number().int().nonnegative(), size: z.number().int().nonnegative(), x: z.boolean() }),
+    z.object({ i: z.number().int().nonnegative(), skip: z.string() }),
+]);
+const HEADER_MAX = 64 * 1024;
+const writeAll = async (handle, data) => {
+    for (let offset = 0; offset < data.length;) {
+        const { bytesWritten } = await handle.write(data, offset);
+        offset += bytesWritten;
+    }
+};
+export const receiveFiles = async (stdout, paths, staging) => {
+    const answers = new Map();
+    let pending = Buffer.alloc(0);
+    let body;
+    const finish = async (file) => {
+        await file.handle.close();
+        answers.set(paths[file.at] ?? "", { staged: file.staged, size: file.size, hash: file.digest.digest("hex"), executable: file.executable });
+        body = undefined;
+    };
+    const begin = async (line) => {
+        const frame = FrameSchema.parse(JSON.parse(line));
+        if (frame.i !== answers.size || frame.i >= paths.length) {
+            throw new Error("the sandbox answered the fetch out of order");
+        }
+        if ("skip" in frame) {
+            answers.set(paths[frame.i] ?? "", { skipped: frame.skip });
+            return;
+        }
+        const staged = join(staging, String(frame.i));
+        const file = { at: frame.i, staged, handle: await open(staged, "wx", 0o600), digest: createHash("sha256"), size: frame.size, executable: frame.x, remaining: frame.size };
+        body = file;
+        if (file.remaining === 0) {
+            await finish(file);
+        }
+    };
+    for await (const chunk of stdout) {
+        pending = Buffer.concat([pending, chunk]);
+        while (pending.length > 0) {
+            if (body !== undefined) {
+                const piece = pending.subarray(0, body.remaining);
+                await writeAll(body.handle, piece);
+                body.digest.update(piece);
+                body.remaining -= piece.length;
+                pending = pending.subarray(piece.length);
+                if (body.remaining === 0) {
+                    await finish(body);
+                }
+                continue;
+            }
+            const newline = pending.indexOf(10);
+            if (newline === -1) {
+                if (pending.length > HEADER_MAX) {
+                    throw new Error("the sandbox's answer to the fetch is not one this agent asked for");
+                }
+                break;
+            }
+            await begin(pending.subarray(0, newline).toString("utf8"));
+            pending = pending.subarray(newline + 1);
+        }
+    }
+    await body?.handle.close();
+    return answers;
+};
+const SSH_OPTIONS = ["-o", "BatchMode=yes", "-o", "ConnectTimeout=20", "-o", "ServerAliveInterval=15", "-o", "ServerAliveCountMax=4"];
+const TRANSFER_TIMEOUT_MS = 60 * 60_000;
+const failure = (what, exited) => {
+    const said = exited.stderr.trim().split("\n").at(-1) ?? "";
+    const why = exited.status === 255 ? "ssh could not reach the sandbox" : exited.status === null ? "it did not finish in time" : `it exited with ${exited.status}`;
+    return new Error(`${what} failed: ${why}${said === "" ? "" : ` (${said})`}`);
+};
+export const sandboxCopy = (runner, ssh, alias, remoteDir) => {
+    const command = (program, input) => [...SSH_OPTIONS, alias, remoteNodeCommand(program, input)];
+    return {
+        list: async (ignoreExpressions) => {
+            const listed = await collect(runner.spawn(ssh, command(LISTING_PROGRAM, JSON.stringify({ root: remoteDir, ignore: ignoreExpressions })), { timeoutMs: TRANSFER_TIMEOUT_MS }));
+            if (listed.status === 3) {
+                throw new Error(`the sandbox has no ${remoteDir}: its copy of this folder is gone`);
+            }
+            if (listed.status !== 0) {
+                throw failure(`listing the sandbox's copy (${remoteDir})`, listed);
+            }
+            return parseListing(listed.stdout.toString("utf8"));
+        },
+        fetch: async (paths, staging) => {
+            if (paths.length === 0) {
+                return new Map();
+            }
+            const spawned = runner.spawn(ssh, command(FETCH_PROGRAM, JSON.stringify({ root: remoteDir })), {
+                input: paths.map((path) => `${path}\0`).join(""),
+                timeoutMs: TRANSFER_TIMEOUT_MS,
+            });
+            const answers = await receiveFiles(spawned.stdout, paths, staging);
+            const exited = await spawned.exit;
+            const stopped = exited.status === 0 ? "the sandbox did not send it" : failure("fetching from the sandbox", exited).message;
+            return new Map(paths.map((path) => [path, answers.get(path) ?? { skipped: stopped }]));
+        },
+    };
+};
+const EntrySchema = z.object({ kind: z.string().optional(), digest: z.string().optional() }).nullable().optional();
+const SessionListSchema = z
+    .array(z.object({
+    paused: z.boolean().optional(),
+    conflicts: z
+        .array(z.object({ root: z.string().optional(), alphaChanges: z.array(z.object({ path: z.string().optional(), old: EntrySchema, new: EntrySchema })).nullable().optional() }))
+        .nullable()
+        .optional(),
+}))
+    .nullable();
+const sessionsIn = (listed) => {
+    try {
+        return SessionListSchema.safeParse(JSON.parse(listed)).data ?? [];
+    }
+    catch {
+        return [];
+    }
+};
+const fileDigest = (entry) => (entry?.kind === "file" ? entry.digest : undefined);
+const reportedConflicts = (session) => new Map((session?.conflicts ?? []).flatMap((conflict) => {
+    const root = conflict.root ?? "";
+    const change = conflict.alphaChanges?.find((candidate) => (candidate.path ?? "") === root);
+    return root === "" || change === undefined ? [] : [[root, { agreed: fileDigest(change.old), here: fileDigest(change.new) }]];
+}));
+const SESSION_TIMEOUT_MS = 2 * 60_000;
+const FLUSH_TIMEOUT_MS = 30_000;
+export const mutagenSession = (runner, mutagen, name) => {
+    const run = async (args, timeoutMs = SESSION_TIMEOUT_MS) => await collect(runner.spawn(mutagen, ["sync", ...args, name], { timeoutMs }));
+    const must = async (verb) => {
+        const done = await run([verb]);
+        if (done.status !== 0) {
+            throw failure(`${verb === "pause" ? "pausing" : "resuming"} the file sync of this folder`, done);
+        }
+    };
+    return {
+        inspect: async () => {
+            const listed = await run(["list", "--template", "{{json .}}"]);
+            const sessions = listed.status === 0 ? sessionsIn(listed.stdout.toString("utf8")) : [];
+            const state = sessions.length === 0 ? "absent" : sessions.every((session) => session.paused === true) ? "paused" : "running";
+            return { state, conflicts: reportedConflicts(sessions[0]) };
+        },
+        flush: async () => (await run(["flush"], FLUSH_TIMEOUT_MS)).status === 0,
+        pause: async () => await must("pause"),
+        resume: async () => await must("resume"),
+    };
+};
+//# sourceMappingURL=project-remote.js.map

package/dist/sync/project-remote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-remote.js","sourceRoot":"","sources":["../../src/sync/project-remote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAa,MAAM,aAAa,CAAC;AACpD,OAAO,EAAmB,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAgB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AA6BhE,MAAM,WAAW,GAAG,IAAI,CAAC;AAEzB,MAAM,CAAC,MAAM,iBAAiB,GAAkB;IAC5C,KAAK,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAE9B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAChG,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACjC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACtC,MAAM,GAAG,GAAG,MAAM,GAAG,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QAGH,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACzC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACzE,MAAM,IAAI,GAAG,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;YACzC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBACxB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACnE,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;gBACzB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAChC,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;CACJ,CAAC;AAMF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,OAAgB,EAAsB,EAAE;IAClE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AACtE,CAAC,CAAC;AAKF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAE,KAAa,EAAU,EAAE,CACxE,8BAA8B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,4BAA4B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;AAK7I,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BxC,CAAC;AAMF,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6CtC,CAAC;AAeF,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC;IACxB,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;IACrG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;CACpE,CAAC,CAAC;AAGH,MAAM,UAAU,GAAG,EAAE,GAAG,IAAI,CAAC;AAE7B,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAkB,EAAE,IAAY,EAAiB,EAAE;IACvE,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,MAAM,GAAI,CAAC;QAE1C,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1D,MAAM,IAAI,YAAY,CAAC;IAC3B,CAAC;AACL,CAAC,CAAC;AAcF,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,MAA6B,EAAE,KAAwB,EAAE,OAAe,EAA8C,EAAE;IACvJ,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgC,CAAC;IACxD,IAAI,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,IAA2B,CAAC;IAChC,MAAM,MAAM,GAAG,KAAK,EAAE,IAAe,EAAiB,EAAE;QACpD,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAC1I,IAAI,GAAG,SAAS,CAAC;IACrB,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,KAAK,EAAE,IAAY,EAAiB,EAAE;QAChD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAClD,IAAI,KAAK,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3D,OAAO;QACX,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAc,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QACrL,IAAI,GAAG,IAAI,CAAC;QACZ,IAAI,IAAI,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACL,CAAC,CAAC;IACF,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC/B,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QAC1C,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACrB,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;gBAElD,MAAM,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;gBACnC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC1B,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC;gBAC/B,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACzC,IAAI,IAAI,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;oBAEvB,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;gBACvB,CAAC;gBACD,SAAS;YACb,CAAC;YACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACpC,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,IAAI,OAAO,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;oBAC9B,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;gBACzF,CAAC;gBACD,MAAM;YACV,CAAC;YAED,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;YAC3D,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;QAC5C,CAAC;IACL,CAAC;IAED,MAAM,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAC3B,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAIF,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,wBAAwB,EAAE,IAAI,EAAE,uBAAuB,CAAC,CAAC;AAItI,MAAM,mBAAmB,GAAG,EAAE,GAAG,MAAM,CAAC;AAQxC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,MAAc,EAAS,EAAE;IACpD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3D,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,kBAAkB,MAAM,CAAC,MAAM,EAAE,CAAC;IACjK,OAAO,IAAI,KAAK,CAAC,GAAG,IAAI,YAAY,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;AACjF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAqB,EAAE,GAAW,EAAE,KAAa,EAAE,SAAiB,EAAe,EAAE;IAC7G,MAAM,OAAO,GAAG,CAAC,OAAe,EAAE,KAAa,EAAY,EAAE,CAAC,CAAC,GAAG,WAAW,EAAE,KAAK,EAAE,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IACzH,OAAO;QACH,IAAI,EAAE,KAAK,EAAE,iBAAiB,EAAE,EAAE;YAC9B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC,CAAC,CAAC;YAC9K,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,mCAAmC,CAAC,CAAC;YACxF,CAAC;YACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,MAAM,OAAO,CAAC,+BAA+B,SAAS,GAAG,EAAE,MAAM,CAAC,CAAC;YACvE,CAAC;YACD,OAAO,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACxD,CAAC;QACD,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC5B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrB,OAAO,IAAI,GAAG,EAAE,CAAC;YACrB,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE;gBAC3F,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChD,SAAS,EAAE,mBAAmB;aACjC,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YACnE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YAElC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,OAAO,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC;YAC3H,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3F,CAAC;KACJ,CAAC;AACN,CAAC,CAAC;AA2BF,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC;AACnH,MAAM,iBAAiB,GAAG,CAAC;KACtB,KAAK,CACF,CAAC,CAAC,MAAM,CAAC;IACL,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;SAC5K,QAAQ,EAAE;SACV,QAAQ,EAAE;CAClB,CAAC,CACL;KACA,QAAQ,EAAE,CAAC;AAIhB,MAAM,UAAU,GAAG,CAAC,MAAc,EAA4B,EAAE;IAC5D,IAAI,CAAC;QACD,OAAO,iBAAiB,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QAEL,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,KAAkC,EAAsB,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAGnI,MAAM,iBAAiB,GAAG,CAAC,OAAkC,EAAiC,EAAE,CAC5F,IAAI,GAAG,CACH,CAAC,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;IAC5C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC;IAC3F,OAAO,IAAI,KAAK,EAAE,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAU,CAAC,CAAC;AAC1I,CAAC,CAAC,CACL,CAAC;AAGN,MAAM,kBAAkB,GAAG,CAAC,GAAG,MAAM,CAAC;AAKtC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAqB,EAAE,OAAe,EAAE,IAAY,EAAkB,EAAE;IACnG,MAAM,GAAG,GAAG,KAAK,EAAE,IAAuB,EAAE,SAAS,GAAG,kBAAkB,EAAsB,EAAE,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;IAChL,MAAM,IAAI,GAAG,KAAK,EAAE,IAAwB,EAAiB,EAAE;QAC3D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpB,MAAM,OAAO,CAAC,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,+BAA+B,EAAE,IAAI,CAAC,CAAC;QACrG,CAAC;IACL,CAAC,CAAC;IACF,OAAO;QACH,OAAO,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC;YAE/D,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACvF,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;YAC7H,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,CAAC;QACD,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC;QACxE,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC;QACtC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC;KAC3C,CAAC;AACN,CAAC,CAAC"}

package/dist/sync/project-transfer.d.ts

@@ -0,0 +1,52 @@
+import { type Pairing, type ProjectDirection } from "./config.js";
+import { type ChangeKind } from "./project-files.js";
+import { type Durability } from "./project-local.js";
+import type { SandboxCopy, SessionControl } from "./project-remote.js";
+import { type PointSummary, type Skipped } from "./restore-points.js";
+export type ProjectPairing = Pairing & {
+    readonly localDir: string;
+};
+export interface ProjectContext {
+    readonly pairing: ProjectPairing;
+    readonly stateDir: string;
+    readonly sandbox: SandboxCopy;
+    readonly session: SessionControl;
+    readonly durability?: Durability;
+}
+export interface ListedChange {
+    readonly path: string;
+    readonly kind: ChangeKind;
+    readonly size?: number;
+    readonly conflict?: true;
+}
+export interface ChangesResult {
+    readonly ok: true;
+    readonly pairing: string;
+    readonly direction: ProjectDirection;
+    readonly changes: readonly ListedChange[];
+    readonly truncated?: true;
+}
+export interface Applied {
+    readonly path: string;
+    readonly kind: ChangeKind;
+}
+export interface BringBackResult {
+    readonly ok: true;
+    readonly point: string;
+    readonly applied: readonly Applied[];
+    readonly skipped: readonly Skipped[];
+}
+export interface RestorePointsResult {
+    readonly ok: true;
+    readonly points: readonly PointSummary[];
+}
+export interface RestoreResult {
+    readonly ok: true;
+    readonly restored: number;
+    readonly skipped: readonly Skipped[];
+}
+export declare const projectChanges: (context: ProjectContext) => Promise<ChangesResult>;
+export declare const bringBack: (context: ProjectContext, paths: readonly string[]) => Promise<BringBackResult>;
+export declare const restorePoints: (context: Pick<ProjectContext, "pairing" | "stateDir">) => Promise<RestorePointsResult>;
+export declare const restorePoint: (context: ProjectContext, id: string) => Promise<RestoreResult>;
+//# sourceMappingURL=project-transfer.d.ts.map

package/dist/sync/project-transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-transfer.d.ts","sourceRoot":"","sources":["../../src/sync/project-transfer.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,OAAO,EAAsC,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACtG,OAAO,EAEH,KAAK,UAAU,EAQlB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEH,KAAK,UAAU,EAWlB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAyC,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC9G,OAAO,EAIH,KAAK,YAAY,EAOjB,KAAK,OAAO,EAEf,MAAM,qBAAqB,CAAC;AAkB7B,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAErE,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;CACpC;AAGD,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,OAAO;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAGlB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;CACxC;AAwLD,eAAO,MAAM,cAAc,YAAmB,cAAc,KAAG,OAAO,CAAC,aAAa,CAcnF,CAAC;AAkHF,eAAO,MAAM,SAAS,YAAmB,cAAc,SAAS,SAAS,MAAM,EAAE,KAAG,OAAO,CAAC,eAAe,CAmBrG,CAAC;AAGP,eAAO,MAAM,aAAa,YAAmB,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,UAAU,CAAC,KAAG,OAAO,CAAC,mBAAmB,CAGrH,CAAC;AAIH,eAAO,MAAM,YAAY,YAAmB,cAAc,MAAM,MAAM,KAAG,OAAO,CAAC,aAAa,CAwBxF,CAAC"}