@sema-agent/core 1.279.0

package/dist/core/memory-engine/scope-contract.js

@@ -0,0 +1,205 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+export const SCOPE_SEGMENT_MAX_ENCODED = 64;
+const SEGMENT_SAFE = /^[A-Za-z0-9._-]$/;
+export function encodeScopeSegment(raw) {
+    if (raw.length === 0)
+        throw new Error("scope segment must be non-empty");
+    if (!isWellFormedString(raw))
+        throw new Error("scope segment is not well-formed Unicode (lone surrogate)");
+    let out = "";
+    for (const ch of raw) {
+        if (SEGMENT_SAFE.test(ch)) {
+            out += ch;
+        }
+        else {
+            for (const byte of Buffer.from(ch, "utf8"))
+                out += `%${byte.toString(16).toUpperCase().padStart(2, "0")}`;
+        }
+    }
+    if (out.length > SCOPE_SEGMENT_MAX_ENCODED) {
+        throw new Error(`scope segment exceeds ${SCOPE_SEGMENT_MAX_ENCODED} encoded chars (${out.length}): ${out.slice(0, 24)}…`);
+    }
+    return out;
+}
+function isWellFormedString(s) {
+    const anyS = s;
+    if (typeof anyS.isWellFormed === "function")
+        return anyS.isWellFormed();
+    for (let i = 0; i < s.length; i++) {
+        const c = s.charCodeAt(i);
+        if (c >= 0xd800 && c <= 0xdbff) {
+            const n = s.charCodeAt(i + 1);
+            if (!(n >= 0xdc00 && n <= 0xdfff))
+                return false;
+            i++;
+        }
+        else if (c >= 0xdc00 && c <= 0xdfff)
+            return false;
+    }
+    return true;
+}
+const FATAL_UTF8 = new TextDecoder("utf-8", { fatal: true });
+export function decodeScopeSegment(encoded) {
+    if (encoded.length > SCOPE_SEGMENT_MAX_ENCODED) {
+        throw new Error(`scope segment exceeds ${SCOPE_SEGMENT_MAX_ENCODED} encoded chars (${encoded.length})`);
+    }
+    if (!/^(?:[A-Za-z0-9._-]|%[0-9A-F]{2})*$/.test(encoded)) {
+        throw new Error(`malformed scope segment: ${encoded}`);
+    }
+    const bytes = [];
+    for (let i = 0; i < encoded.length; i++) {
+        if (encoded[i] === "%") {
+            bytes.push(parseInt(encoded.slice(i + 1, i + 3), 16));
+            i += 2;
+        }
+        else {
+            bytes.push(encoded.charCodeAt(i));
+        }
+    }
+    let decoded;
+    try {
+        decoded = FATAL_UTF8.decode(Uint8Array.from(bytes));
+    }
+    catch {
+        throw new Error(`malformed scope segment (invalid UTF-8 in %XX sequence): ${encoded}`);
+    }
+    if (encodeScopeSegment(decoded) !== encoded) {
+        throw new Error(`non-canonical scope segment (re-encode mismatch): ${encoded}`);
+    }
+    return decoded;
+}
+export function formatUserScope(principal) {
+    return `user:${encodeScopeSegment(principal)}`;
+}
+export function formatOrgScope(tenant) {
+    return `org:${encodeScopeSegment(tenant)}`;
+}
+export function formatProjScope(tenant, projectId) {
+    return `proj:${encodeScopeSegment(tenant)}/${encodeScopeSegment(projectId)}`;
+}
+export function formatUserProjScope(principal, projectId) {
+    return `userproj:${encodeScopeSegment(principal)}/${encodeScopeSegment(projectId)}`;
+}
+const ONE_SEGMENT = /^(user|org):((?:[A-Za-z0-9._-]|%[0-9A-F]{2})+)$/;
+const TWO_SEGMENT = /^(proj|userproj):((?:[A-Za-z0-9._-]|%[0-9A-F]{2})+)\/((?:[A-Za-z0-9._-]|%[0-9A-F]{2})+)$/;
+export function parseScopeKey(key) {
+    const m1 = ONE_SEGMENT.exec(key);
+    if (m1) {
+        const seg = decodeScopeSegment(m1[2]);
+        return m1[1] === "user" ? { kind: "user", principal: seg } : { kind: "org", tenant: seg };
+    }
+    const m2 = TWO_SEGMENT.exec(key);
+    if (m2) {
+        const a = decodeScopeSegment(m2[2]);
+        const b = decodeScopeSegment(m2[3]);
+        return m2[1] === "proj" ? { kind: "proj", tenant: a, projectId: b } : { kind: "userproj", principal: a, projectId: b };
+    }
+    const prefix = /^(user|org|proj|userproj):/.exec(key);
+    if (prefix) {
+        const e = new Error(`malformed v2 scope key "${key}": prefix "${prefix[1]}:" is reserved by the scope contract ` +
+            `(design/142 §1.2) — segments must be encoded with encodeScopeSegment (charset [A-Za-z0-9._-] + %XX), ` +
+            `"${prefix[1]}" takes ${prefix[1] === "proj" || prefix[1] === "userproj" ? "two segments (a/b)" : "one segment"}.`);
+        e.code = "config.memory_scope_key";
+        throw e;
+    }
+    return { kind: "legacy", raw: key };
+}
+export function isPersonalScope(parsed) {
+    return parsed.kind === "user" || parsed.kind === "userproj";
+}
+export function isCentralAuthorityScope(parsed) {
+    return isPersonalScope(parsed) || parsed.kind === "org";
+}
+export function assertScopeContractPlacement(args) {
+    if (!args.repoRoot)
+        return;
+    const personal = args.parsedScopes.filter(isCentralAuthorityScope);
+    if (personal.length === 0)
+        return;
+    const root = resolve(args.repoRoot);
+    const dir = resolve(args.memoryDir);
+    if (dir === root || dir.startsWith(root + "/")) {
+        const e = new Error(`memory scope contract v2: central-authority scope(s) ${personal
+            .map((p) => `"${p.kind}"`)
+            .join(", ")} cannot materialize into an IN-REPO memory dir (${args.memoryDir}) — ` +
+            `a user/userproj/org layer projected under the repo root would leak non-repo memory to every ` +
+            `collaborator (and into commit history). Move the memory dir out of the repo, or drop those scopes.`);
+        e.code = "config.memory_scope_placement";
+        throw e;
+    }
+}
+export const PROJECT_MARKER_PATH = ".sema/project";
+export const PROJECT_ID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const UUID_RE = PROJECT_ID_REGEX;
+export function formatProjectMarker(projectId) {
+    if (!UUID_RE.test(projectId))
+        throw new Error(`projectId must be a UUID, got: ${projectId}`);
+    return `projectId = ${projectId.toLowerCase()}\n`;
+}
+export function parseProjectMarker(body) {
+    const corrupt = (detail) => {
+        const e = new Error(`corrupt project marker: ${detail}`);
+        e.code = "config.memory_project_marker";
+        throw e;
+    };
+    let projectId;
+    for (const line of body.split(/\r?\n/)) {
+        const t = line.trim();
+        if (!t || t.startsWith("#"))
+            continue;
+        if (!/^projectId\b/.test(t))
+            continue;
+        const m = /^projectId\s*=\s*(?:"([^"]*)"|([^"\s]+))\s*$/.exec(t);
+        if (!m)
+            corrupt(`unparseable projectId line (${t.slice(0, 48)})`);
+        const value = m[1] ?? m[2] ?? "";
+        if (!UUID_RE.test(value))
+            corrupt(`projectId is not a UUID (${value.slice(0, 48) || "<empty>"})`);
+        if (projectId !== undefined && projectId !== value.toLowerCase())
+            corrupt("duplicate conflicting projectId lines");
+        projectId = value.toLowerCase();
+    }
+    if (projectId === undefined)
+        return null;
+    return { projectId };
+}
+function gitRootOf(dir) {
+    let cur = resolve(dir);
+    for (;;) {
+        if (existsSync(join(cur, ".git")))
+            return cur;
+        const parent = dirname(cur);
+        if (parent === cur)
+            return undefined;
+        cur = parent;
+    }
+}
+export function resolveProjectId(rootDir) {
+    const dir = resolve(rootDir);
+    const gitRoot = gitRootOf(dir);
+    const projectRoot = gitRoot ?? dir;
+    if (gitRoot !== undefined) {
+        let cur = dir;
+        while (cur !== gitRoot) {
+            if (existsSync(join(cur, PROJECT_MARKER_PATH))) {
+                const e = new Error(`nested project marker: ${join(cur, PROJECT_MARKER_PATH)} sits below the repo root (${gitRoot}) — ` +
+                    `v1 supports ONE marker at the repo root (design/142 §1.1); remove the nested marker or split the repo.`);
+                e.code = "config.memory_project_marker_nested";
+                throw e;
+            }
+            const parent = dirname(cur);
+            if (parent === cur)
+                break;
+            cur = parent;
+        }
+    }
+    const markerFile = join(projectRoot, PROJECT_MARKER_PATH);
+    if (!existsSync(markerFile))
+        return null;
+    const parsed = parseProjectMarker(readFileSync(markerFile, "utf8"));
+    if (!parsed)
+        return null;
+    return { projectId: parsed.projectId, markerDir: projectRoot };
+}
+//# sourceMappingURL=scope-contract.js.map

package/dist/core/memory-engine/scope-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-contract.js","sourceRoot":"","sources":["../../../src/core/memory-engine/scope-contract.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQnD,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAE5C,MAAM,YAAY,GAAG,kBAAkB,CAAC;AASxC,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAGzE,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC3G,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1B,GAAG,IAAI,EAAE,CAAC;QACZ,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC;gBAAE,GAAG,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QAC5G,CAAC;IACH,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,GAAG,yBAAyB,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,yBAAyB,yBAAyB,mBAAmB,GAAG,CAAC,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CACzG,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,kBAAkB,CAAC,CAAS;IAEnC,MAAM,IAAI,GAAG,CAA8C,CAAC;IAC5D,IAAI,OAAO,IAAI,CAAC,YAAY,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;IACxE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;YAC/B,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9B,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC;gBAAE,OAAO,KAAK,CAAC;YAChD,CAAC,EAAE,CAAC;QACN,CAAC;aAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM;YAAE,OAAO,KAAK,CAAC;IACtD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAS7D,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,IAAI,OAAO,CAAC,MAAM,GAAG,yBAAyB,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,yBAAyB,yBAAyB,mBAAmB,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1G,CAAC;IACD,IAAI,CAAC,oCAAoC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACtD,CAAC,IAAI,CAAC,CAAC;QACT,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IACD,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,4DAA4D,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAGD,IAAI,kBAAkB,CAAC,OAAO,CAAC,KAAK,OAAO,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,qDAAqD,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAcD,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,QAAQ,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;AACjD,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,OAAO,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;AAC7C,CAAC;AACD,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,SAAiB;IAC/D,OAAO,QAAQ,kBAAkB,CAAC,MAAM,CAAC,IAAI,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;AAC/E,CAAC;AACD,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,SAAiB;IACtE,OAAO,YAAY,kBAAkB,CAAC,SAAS,CAAC,IAAI,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;AACtF,CAAC;AAED,MAAM,WAAW,GAAG,iDAAiD,CAAC;AACtE,MAAM,WAAW,GAAG,0FAA0F,CAAC;AAQ/G,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,EAAE,EAAE,CAAC;QACP,MAAM,GAAG,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC;QACvC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC5F,CAAC;IACD,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,EAAE,EAAE,CAAC;QACP,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC;QACrC,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC;QACrC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACzH,CAAC;IACD,MAAM,MAAM,GAAG,4BAA4B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtD,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,GAAG,IAAI,KAAK,CACjB,2BAA2B,GAAG,cAAc,MAAM,CAAC,CAAC,CAAC,uCAAuC;YAC1F,uGAAuG;YACvG,IAAI,MAAM,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,aAAa,GAAG,CACzF,CAAC;QAC9B,CAAC,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACnC,MAAM,CAAC,CAAC;IACV,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACtC,CAAC;AAGD,MAAM,UAAU,eAAe,CAAC,MAAsB;IACpD,OAAO,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC;AAC9D,CAAC;AAMD,MAAM,UAAU,uBAAuB,CAAC,MAAsB;IAC5D,OAAO,eAAe,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC;AAC1D,CAAC;AASD,MAAM,UAAU,4BAA4B,CAAC,IAK5C;IACC,IAAI,CAAC,IAAI,CAAC,QAAQ;QAAE,OAAO;IAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;IACnE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAClC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,IAAI,KAAK,CACjB,wDAAwD,QAAQ;aAC7D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC;aACzB,IAAI,CAAC,IAAI,CAAC,mDAAmD,IAAI,CAAC,SAAS,MAAM;YAClF,8FAA8F;YAC9F,oGAAoG,CAC3E,CAAC;QAC9B,CAAC,CAAC,IAAI,GAAG,+BAA+B,CAAC;QACzC,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC;AAQD,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAC;AAKnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,iEAAiE,CAAC;AAClG,MAAM,OAAO,GAAG,gBAAgB,CAAC;AAGjC,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,SAAS,EAAE,CAAC,CAAC;IAC7F,OAAO,eAAe,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC;AACpD,CAAC;AAQD,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,OAAO,GAAG,CAAC,MAAc,EAAS,EAAE;QACxC,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,2BAA2B,MAAM,EAAE,CAA6B,CAAC;QACrF,CAAC,CAAC,IAAI,GAAG,8BAA8B,CAAC;QACxC,MAAM,CAAC,CAAC;IACV,CAAC,CAAC;IACF,IAAI,SAA6B,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACtC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,SAAS;QACtC,MAAM,CAAC,GAAG,8CAA8C,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,CAAC;YAAE,OAAO,CAAC,+BAA+B,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,CAAE,CAAC,CAAC,CAAC,IAAI,CAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,4BAA4B,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC;QAClG,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,KAAK,CAAC,WAAW,EAAE;YAAE,OAAO,CAAC,uCAAuC,CAAC,CAAC;QACnH,SAAS,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,CAAC;IACD,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACvB,SAAS,CAAC;QACR,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,SAAS,CAAC;QACrC,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAaD,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,WAAW,GAAG,OAAO,IAAI,GAAG,CAAC;IAInC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,IAAI,GAAG,GAAG,GAAG,CAAC;QACd,OAAO,GAAG,KAAK,OAAO,EAAE,CAAC;YACvB,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC;gBAC/C,MAAM,CAAC,GAAG,IAAI,KAAK,CACjB,0BAA0B,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,8BAA8B,OAAO,MAAM;oBACjG,wGAAwG,CAC/E,CAAC;gBAC9B,CAAC,CAAC,IAAI,GAAG,qCAAqC,CAAC;gBAC/C,MAAM,CAAC,CAAC;YACV,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,MAAM,KAAK,GAAG;gBAAE,MAAM;YAC1B,GAAG,GAAG,MAAM,CAAC;QACf,CAAC;IACH,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;IAC1D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,MAAM,GAAG,kBAAkB,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IACpE,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;AACjE,CAAC"}

package/dist/core/memory-engine/sync-client.d.ts

@@ -0,0 +1,57 @@
+import { type MemorySyncCursor } from "./sync.js";
+import type { MemoryBackend, MemoryEntry, PatchReport } from "./types.js";
+export type MemorySyncTransport = (path: string, body: unknown) => Promise<unknown>;
+export interface MemorySyncRequestBody {
+    peer: string;
+    baseRevs: Record<string, string>;
+    entries: MemoryEntry[];
+    deletes: string[];
+}
+export interface MemorySyncResponseBody {
+    applied: PatchReport["applied"];
+    conflicts: Array<{
+        id: string;
+        reason: string;
+        baseRev?: string;
+        currentRev?: string;
+    }>;
+    serverEntries: MemoryEntry[];
+    serverDeletes: Array<{
+        id: string;
+        baseRev: string;
+    }>;
+    cursor: {
+        peer: string;
+        baseRevs: Record<string, string>;
+        updatedAtMs: number;
+    };
+}
+export interface MemorySyncClientConflict {
+    side: "server" | "local";
+    id: string;
+    reason: string;
+    baseRev?: string;
+    currentRev?: string;
+}
+export interface SyncMemoryScopeOptions {
+    backend: MemoryBackend;
+    scope: string;
+    transport: MemorySyncTransport;
+    cursor?: MemorySyncCursor;
+    peer?: string;
+    now?: () => number;
+}
+export interface MemorySyncClientResult {
+    ok: boolean;
+    pushed: {
+        entries: string[];
+        deletes: string[];
+    };
+    serverApplied: PatchReport["applied"];
+    localApplied: PatchReport["applied"];
+    conflicts: MemorySyncClientConflict[];
+    cursorAdvanced: boolean;
+    cursor: MemorySyncCursor | undefined;
+}
+export declare function syncMemoryScope(opts: SyncMemoryScopeOptions): Promise<MemorySyncClientResult>;
+//# sourceMappingURL=sync-client.d.ts.map

package/dist/core/memory-engine/sync-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-client.d.ts","sourceRoot":"","sources":["../../../src/core/memory-engine/sync-client.ts"],"names":[],"mappings":"AA0CA,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAa,WAAW,EAAE,MAAM,YAAY,CAAC;AAMrF,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAKpF,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IAEb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,OAAO,EAAE,WAAW,EAAE,CAAC;IAEvB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAMD,MAAM,WAAW,sBAAsB;IAErC,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IAGhC,SAAS,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAExF,aAAa,EAAE,WAAW,EAAE,CAAC;IAE7B,aAAa,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAKtD,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CACjF;AAKD,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IAErC,OAAO,EAAE,aAAa,CAAC;IAEvB,KAAK,EAAE,MAAM,CAAC;IAEd,SAAS,EAAE,mBAAmB,CAAC;IAE/B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAE1B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IAErC,EAAE,EAAE,OAAO,CAAC;IAEZ,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAEjD,aAAa,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IAEtC,YAAY,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IAErC,SAAS,EAAE,wBAAwB,EAAE,CAAC;IAEtC,cAAc,EAAE,OAAO,CAAC;IAGxB,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC;CACtC;AA+GD,wBAAsB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAoMnG"}

package/dist/core/memory-engine/sync-client.js

@@ -0,0 +1,257 @@
+import { computeEntryRev } from "./frontmatter.js";
+import { screenInboundEntries } from "./data-plane.js";
+import { reconcileMemoryEntries } from "./sync.js";
+function memorySyncPath(scope) {
+    return `/v1/memory/sync/${encodeURIComponent(scope)}`;
+}
+function baselineStub(id, rev, scope) {
+    return { id, rev, scope, slug: `sync-baseline-stub/${id}`, frontmatter: {}, body: "" };
+}
+const isRecord = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+const isNonEmptyString = (v) => typeof v === "string" && v.length > 0;
+function parseMemorySyncResponse(raw, scope, peer) {
+    const fail = (why) => {
+        throw new Error(`memory sync: transport response is not a valid sync response (${why})`);
+    };
+    if (!isRecord(raw))
+        fail("body must be a JSON object { applied, conflicts, serverEntries, serverDeletes, cursor }");
+    const b = raw;
+    const applied = [];
+    if (!Array.isArray(b["applied"]))
+        fail("applied must be an array");
+    for (const a of b["applied"]) {
+        if (!isRecord(a) || (a["op"] !== "add" && a["op"] !== "update" && a["op"] !== "delete") || !isNonEmptyString(a["id"])) {
+            fail("each applied item must be { op: add|update|delete, id }");
+        }
+        const rec = a;
+        applied.push({ op: rec["op"], id: rec["id"], ...(isNonEmptyString(rec["slug"]) ? { slug: rec["slug"] } : {}) });
+    }
+    const conflicts = [];
+    if (!Array.isArray(b["conflicts"]))
+        fail("conflicts must be an array");
+    for (const c of b["conflicts"]) {
+        if (!isRecord(c) || !isNonEmptyString(c["id"]) || typeof c["reason"] !== "string")
+            fail("each conflict must be { id, reason }");
+        const rec = c;
+        conflicts.push({
+            id: rec["id"],
+            reason: rec["reason"],
+            ...(isNonEmptyString(rec["baseRev"]) ? { baseRev: rec["baseRev"] } : {}),
+            ...(isNonEmptyString(rec["currentRev"]) ? { currentRev: rec["currentRev"] } : {}),
+        });
+    }
+    const serverEntries = [];
+    if (!Array.isArray(b["serverEntries"]))
+        fail("serverEntries must be an array");
+    for (const raw2 of b["serverEntries"]) {
+        if (!isRecord(raw2))
+            fail("each server entry must be an object { id, slug, frontmatter, body, rev, scope }");
+        const e = raw2;
+        if (!isNonEmptyString(e["id"]) || !isNonEmptyString(e["slug"]) || typeof e["body"] !== "string" || !isNonEmptyString(e["rev"])) {
+            fail("each server entry must carry non-empty id/slug/rev and a string body");
+        }
+        if (e["scope"] !== scope)
+            fail(`server entry ${JSON.stringify(e["id"])} has scope ${JSON.stringify(e["scope"])} — must equal the synced scope`);
+        const fmRaw = e["frontmatter"] ?? {};
+        if (!isRecord(fmRaw))
+            fail("entry.frontmatter must be an object");
+        const fm = fmRaw;
+        for (const k of ["name", "description", "type"]) {
+            if (fm[k] !== undefined && typeof fm[k] !== "string")
+                fail(`entry.frontmatter.${k} must be a string when present`);
+        }
+        if (fm["deleted"] !== undefined && typeof fm["deleted"] !== "boolean")
+            fail("entry.frontmatter.deleted must be a boolean when present");
+        if (fm["extra"] !== undefined && !(Array.isArray(fm["extra"]) && fm["extra"].every((s) => typeof s === "string"))) {
+            fail("entry.frontmatter.extra must be an array of strings when present");
+        }
+        serverEntries.push({
+            id: e["id"],
+            slug: e["slug"],
+            body: e["body"],
+            rev: e["rev"],
+            scope,
+            frontmatter: {
+                ...(fm["name"] !== undefined ? { name: fm["name"] } : {}),
+                ...(fm["description"] !== undefined ? { description: fm["description"] } : {}),
+                ...(fm["type"] !== undefined ? { type: fm["type"] } : {}),
+                ...(fm["deleted"] !== undefined ? { deleted: fm["deleted"] } : {}),
+                ...(fm["extra"] !== undefined ? { extra: [...fm["extra"]] } : {}),
+            },
+        });
+    }
+    const serverDeletes = [];
+    if (!Array.isArray(b["serverDeletes"]))
+        fail("serverDeletes must be an array");
+    for (const d of b["serverDeletes"]) {
+        if (!isRecord(d) || !isNonEmptyString(d["id"]) || !isNonEmptyString(d["baseRev"]))
+            fail("each server delete must be { id, baseRev }");
+        const rec = d;
+        serverDeletes.push({ id: rec["id"], baseRev: rec["baseRev"] });
+    }
+    const cur = b["cursor"];
+    if (!isRecord(cur))
+        fail("cursor must be an object { peer, baseRevs, updatedAtMs }");
+    const curRec = cur;
+    if (curRec["peer"] !== peer)
+        fail(`cursor.peer ${JSON.stringify(curRec["peer"])} does not match the requested peer ${JSON.stringify(peer)}`);
+    if (!isRecord(curRec["baseRevs"]))
+        fail("cursor.baseRevs must be an object mapping id → rev");
+    const baseRevs = {};
+    for (const [id, rev] of Object.entries(curRec["baseRevs"])) {
+        if (!isNonEmptyString(rev))
+            fail(`cursor.baseRevs[${JSON.stringify(id)}] must be a non-empty rev string`);
+        baseRevs[id] = rev;
+    }
+    const updatedAtMs = curRec["updatedAtMs"];
+    if (typeof updatedAtMs !== "number" || !Number.isFinite(updatedAtMs))
+        fail("cursor.updatedAtMs must be a finite number");
+    return { applied, conflicts, serverEntries, serverDeletes, cursor: { peer, baseRevs, updatedAtMs: updatedAtMs } };
+}
+export async function syncMemoryScope(opts) {
+    const { backend, scope, transport, cursor } = opts;
+    if (!isNonEmptyString(scope))
+        throw new Error("memory sync: scope must be a non-empty string");
+    const peer = opts.peer ?? cursor?.peer ?? "central";
+    const now = opts.now ?? Date.now;
+    if (cursor !== undefined && cursor.scope !== scope) {
+        throw new Error(`memory sync: cursor is for scope ${JSON.stringify(cursor.scope)}, not ${JSON.stringify(scope)}`);
+    }
+    if (cursor !== undefined && cursor.peer !== peer) {
+        throw new Error(`memory sync: cursor is for peer ${JSON.stringify(cursor.peer)}, not ${JSON.stringify(peer)}`);
+    }
+    const baseRevs = { ...(cursor?.baseRevs ?? {}) };
+    const headers = (await backend.listHeaders([scope])).filter((h) => h.scope === scope);
+    const fetched = (await backend.getByIds(headers.map((h) => h.id))).filter((e) => e.scope === scope);
+    const local = fetched.filter((e) => e.frontmatter.deleted !== true);
+    const stubs = Object.entries(baseRevs).map(([id, rev]) => baselineStub(id, rev, scope));
+    const plan = reconcileMemoryEntries(baseRevs, local, stubs);
+    if (plan.pull.length > 0 || plan.deleteLocal.length > 0 || plan.conflicts.length > 0 || plan.cleared.length > 0) {
+        throw new Error("memory sync: internal invariant violated — a baseline-stub peer produced pull/deleteLocal/conflict/cleared legs");
+    }
+    const request = {
+        peer,
+        baseRevs,
+        entries: plan.push,
+        deletes: plan.deleteRemote.map((d) => d.id),
+    };
+    const resp = parseMemorySyncResponse(await transport(memorySyncPath(scope), request), scope, peer);
+    const conflicts = resp.conflicts.map((c) => ({ side: "server", ...c }));
+    const rejected = new Set();
+    const localIds = new Set(local.map((e) => e.id));
+    const serverEntryIds = new Set(resp.serverEntries.map((e) => e.id));
+    for (const e of resp.serverEntries) {
+        const computed = computeEntryRev(e);
+        if (computed !== e.rev) {
+            rejected.add(e.id);
+            conflicts.push({
+                side: "local",
+                id: e.id,
+                reason: `rev_mismatch: server claimed ${JSON.stringify(e.rev)} but the content hashes to ${JSON.stringify(computed)} (rev is core's computeEntryRev content-hash contract)`,
+                ...(baseRevs[e.id] !== undefined ? { baseRev: baseRevs[e.id] } : {}),
+            });
+            continue;
+        }
+        if (baseRevs[e.id] === undefined && localIds.has(e.id)) {
+            rejected.add(e.id);
+            conflicts.push({
+                side: "local",
+                id: e.id,
+                reason: `untracked_local_exists: server offers ${JSON.stringify(e.id)} as a first-round add, but an entry with that id already exists locally (concurrent create the server had not observed) — not overwritten`,
+            });
+        }
+    }
+    for (const f of screenInboundEntries(resp.serverEntries.filter((e) => !rejected.has(e.id)))) {
+        rejected.add(f.id);
+        conflicts.push({
+            side: "local",
+            id: f.id,
+            reason: `inbound_gate: ${f.findings.map((x) => `${x.code}: ${x.reason}`).join("; ")}`,
+            ...(baseRevs[f.id] !== undefined ? { baseRev: baseRevs[f.id] } : {}),
+        });
+    }
+    const deletePatches = [];
+    for (const d of resp.serverDeletes) {
+        if (serverEntryIds.has(d.id)) {
+            rejected.add(d.id);
+            conflicts.push({
+                side: "local",
+                id: d.id,
+                reason: `server_delete_and_entry: ${JSON.stringify(d.id)} appears in both serverEntries and serverDeletes of one response — the server cannot both push and delete it in one round`,
+                baseRev: d.baseRev,
+            });
+            continue;
+        }
+        const base = baseRevs[d.id];
+        if (base === undefined) {
+            rejected.add(d.id);
+            conflicts.push({
+                side: "local",
+                id: d.id,
+                reason: `server_delete_not_in_baseline: server asked to delete ${JSON.stringify(d.id)} but it is absent from our input baseline (never synced here — a delete may not cross onto an id the server has never seen from us)`,
+                baseRev: d.baseRev,
+            });
+            continue;
+        }
+        if (base !== d.baseRev) {
+            rejected.add(d.id);
+            conflicts.push({
+                side: "local",
+                id: d.id,
+                reason: `server_delete_baserev_mismatch: server delete claims baseRev ${JSON.stringify(d.baseRev)} but our baseline holds ${JSON.stringify(base)} — refused (concurrent local change since the baseline)`,
+                baseRev: base,
+                currentRev: d.baseRev,
+            });
+            continue;
+        }
+        deletePatches.push({ op: "delete", id: d.id, baseRev: base });
+    }
+    const patches = [
+        ...resp.serverEntries
+            .filter((e) => !rejected.has(e.id))
+            .map((e) => {
+            const base = baseRevs[e.id];
+            return base !== undefined
+                ? { op: "update", id: e.id, entry: e, baseRev: base }
+                : { op: "add", id: e.id, entry: e, guard: "absent" };
+        }),
+        ...deletePatches,
+    ];
+    const report = patches.length > 0 ? await backend.applyPatches(patches) : { applied: [], conflicts: [] };
+    for (const c of report.conflicts) {
+        conflicts.push({
+            side: "local",
+            id: c.id,
+            reason: c.reason,
+            ...(c.baseRev !== undefined ? { baseRev: c.baseRev } : {}),
+            ...(c.currentRev !== undefined ? { currentRev: c.currentRev } : {}),
+        });
+    }
+    const cursorAdvanced = rejected.size === 0 && report.conflicts.length === 0;
+    let nextCursor = cursor;
+    if (cursorAdvanced) {
+        const nextBaseRevs = { ...resp.cursor.baseRevs };
+        const pulledRevById = new Map(resp.serverEntries.map((e) => [e.id, e.rev]));
+        for (const op of report.applied) {
+            if (op.op === "delete") {
+                delete nextBaseRevs[op.id];
+            }
+            else {
+                const landedRev = pulledRevById.get(op.id);
+                if (landedRev !== undefined)
+                    nextBaseRevs[op.id] = landedRev;
+            }
+        }
+        nextCursor = { scope, peer, baseRevs: nextBaseRevs, updatedAtMs: now() };
+    }
+    return {
+        ok: cursorAdvanced && conflicts.length === 0,
+        pushed: { entries: request.entries.map((e) => e.id), deletes: [...request.deletes] },
+        serverApplied: resp.applied,
+        localApplied: report.applied,
+        conflicts,
+        cursorAdvanced,
+        cursor: nextCursor,
+    };
+}
+//# sourceMappingURL=sync-client.js.map

package/dist/core/memory-engine/sync-client.js.map

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

package/dist/core/memory-engine/sync.d.ts

@@ -0,0 +1,37 @@
+import type { MemoryEntry, ScoredMemoryEntry } from "./types.js";
+export interface MemorySyncCursor {
+    scope: string;
+    peer: string;
+    baseRevs: Record<string, string>;
+    updatedAtMs: number;
+}
+export interface MemorySyncConflict {
+    id: string;
+    local?: MemoryEntry;
+    remote?: MemoryEntry;
+    baseRev?: string;
+}
+export interface MemorySyncPlan {
+    push: MemoryEntry[];
+    pull: MemoryEntry[];
+    deleteLocal: Array<{
+        id: string;
+        baseRev: string;
+    }>;
+    deleteRemote: Array<{
+        id: string;
+        baseRev: string;
+    }>;
+    conflicts: MemorySyncConflict[];
+    cleared: string[];
+}
+export declare function reconcileMemoryEntries(baseRevs: Readonly<Record<string, string>>, local: readonly MemoryEntry[], remote: readonly MemoryEntry[]): MemorySyncPlan;
+export declare function nextSyncBaseline(local: readonly MemoryEntry[], remote: readonly MemoryEntry[]): Record<string, string>;
+export interface RecallSource {
+    name: string;
+    search(query: string, scopes: readonly string[], opts?: {
+        limit?: number;
+    }): Promise<ScoredMemoryEntry[]>;
+}
+export declare function mergeRecallHits(hitLists: ReadonlyArray<readonly ScoredMemoryEntry[]>, limit: number): ScoredMemoryEntry[];
+//# sourceMappingURL=sync.d.ts.map

package/dist/core/memory-engine/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/core/memory-engine/sync.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AASjE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IAEd,IAAI,EAAE,MAAM,CAAC;IAEb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IAEX,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAK7B,IAAI,EAAE,WAAW,EAAE,CAAC;IAGpB,IAAI,EAAE,WAAW,EAAE,CAAC;IAKpB,WAAW,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEpD,YAAY,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAIrD,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAEhC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAgBD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC1C,KAAK,EAAE,SAAS,WAAW,EAAE,EAC7B,MAAM,EAAE,SAAS,WAAW,EAAE,GAC7B,cAAc,CAqChB;AAID,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,EAAE,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOtH;AAoBD,MAAM,WAAW,YAAY;IAE3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;CAC3G;AAKD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,CAAC,SAAS,iBAAiB,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAYzH"}