@agent-native/core 0.1.0

package/dist/adapters/firestore/config.d.ts

@@ -0,0 +1,20 @@
+export interface SyncConfig {
+    syncFilePatterns: string[];
+    privateSyncFilePatterns: string[];
+}
+/**
+ * Load sync configuration from a JSON file.
+ * Returns empty patterns if the file doesn't exist or is malformed.
+ */
+export declare function loadSyncConfig(configPath?: string): SyncConfig;
+/**
+ * Check if a file path matches the configured sync patterns.
+ * A file matches if it matches at least one positive pattern and no negation patterns.
+ */
+export declare function shouldSyncFile(filePath: string, patterns: string[]): boolean;
+/**
+ * Generate a deterministic Firestore doc ID from a file path.
+ * Prefixed with the app ID, path separators replaced with `__`.
+ */
+export declare function getDocId(appId: string, filePath: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/adapters/firestore/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/adapters/firestore/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,uBAAuB,EAAE,MAAM,EAAE,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,CAiB9D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAiB5E;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/dist/adapters/firestore/config.js

@@ -0,0 +1,50 @@
+import fs from "fs";
+import path from "path";
+import { minimatch } from "minimatch";
+/**
+ * Load sync configuration from a JSON file.
+ * Returns empty patterns if the file doesn't exist or is malformed.
+ */
+export function loadSyncConfig(configPath) {
+    const resolved = configPath ?? path.resolve(process.cwd(), "content/sync-config.json");
+    try {
+        const raw = fs.readFileSync(resolved, "utf-8");
+        const parsed = JSON.parse(raw);
+        return {
+            syncFilePatterns: Array.isArray(parsed.syncFilePatterns)
+                ? parsed.syncFilePatterns
+                : [],
+            privateSyncFilePatterns: Array.isArray(parsed.privateSyncFilePatterns)
+                ? parsed.privateSyncFilePatterns
+                : [],
+        };
+    }
+    catch {
+        return { syncFilePatterns: [], privateSyncFilePatterns: [] };
+    }
+}
+/**
+ * Check if a file path matches the configured sync patterns.
+ * A file matches if it matches at least one positive pattern and no negation patterns.
+ */
+export function shouldSyncFile(filePath, patterns) {
+    if (patterns.length === 0)
+        return false;
+    const negations = patterns.filter((p) => p.startsWith("!"));
+    const positives = patterns.filter((p) => !p.startsWith("!"));
+    const matchesPositive = positives.some((p) => minimatch(filePath, p, { dot: true }));
+    if (!matchesPositive)
+        return false;
+    const matchesNegation = negations.some((p) => minimatch(filePath, p.slice(1), { dot: true }));
+    if (matchesNegation)
+        return false;
+    return true;
+}
+/**
+ * Generate a deterministic Firestore doc ID from a file path.
+ * Prefixed with the app ID, path separators replaced with `__`.
+ */
+export function getDocId(appId, filePath) {
+    return `${appId}__${filePath.replace(/\//g, "__")}`;
+}
+//# sourceMappingURL=config.js.map

package/dist/adapters/firestore/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/adapters/firestore/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAOtC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,UAAmB;IAChD,MAAM,QAAQ,GACZ,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,0BAA0B,CAAC,CAAC;IACxE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,OAAO;YACL,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC;gBACtD,CAAC,CAAC,MAAM,CAAC,gBAAgB;gBACzB,CAAC,CAAC,EAAE;YACN,uBAAuB,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAC;gBACpE,CAAC,CAAC,MAAM,CAAC,uBAAuB;gBAChC,CAAC,CAAC,EAAE;SACP,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,gBAAgB,EAAE,EAAE,EAAE,uBAAuB,EAAE,EAAE,EAAE,CAAC;IAC/D,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,QAAkB;IACjE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAExC,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAE7D,MAAM,eAAe,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3C,SAAS,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CACtC,CAAC;IACF,IAAI,CAAC,eAAe;QAAE,OAAO,KAAK,CAAC;IAEnC,MAAM,eAAe,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3C,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAC/C,CAAC;IACF,IAAI,eAAe;QAAE,OAAO,KAAK,CAAC;IAElC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,QAAgB;IACtD,OAAO,GAAG,KAAK,KAAK,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;AACtD,CAAC"}

package/dist/adapters/firestore/index.d.ts

@@ -0,0 +1,4 @@
+export { FileSync, type FileSyncOptions, type SyncEvent } from "./sync.js";
+export { threeWayMerge, type MergeResult } from "./merge.js";
+export { loadSyncConfig, shouldSyncFile, getDocId, type SyncConfig, } from "./config.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/firestore/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/firestore/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EACL,cAAc,EACd,cAAc,EACd,QAAQ,EACR,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC"}

package/dist/adapters/firestore/index.js

@@ -0,0 +1,4 @@
+export { FileSync } from "./sync.js";
+export { threeWayMerge } from "./merge.js";
+export { loadSyncConfig, shouldSyncFile, getDocId, } from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/firestore/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/firestore/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAwC,MAAM,WAAW,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAoB,MAAM,YAAY,CAAC;AAC7D,OAAO,EACL,cAAc,EACd,cAAc,EACd,QAAQ,GAET,MAAM,aAAa,CAAC"}

package/dist/adapters/firestore/merge.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Simple three-way line-level merge.
+ *
+ * Given a base version, a local version, and a remote version,
+ * attempts to merge non-overlapping changes automatically.
+ */
+export interface MergeResult {
+    merged: string | null;
+    success: boolean;
+}
+/**
+ * Three-way merge using line-level diff.
+ *
+ * Algorithm:
+ * 1. Split base, local, remote into lines
+ * 2. Compute change hunks for each side relative to base
+ * 3. If hunks don't overlap, apply both sets of changes
+ * 4. If hunks overlap, return failure (conflict)
+ */
+export declare function threeWayMerge(base: string, local: string, remote: string): MergeResult;
+//# sourceMappingURL=merge.d.ts.map

package/dist/adapters/firestore/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../../src/adapters/firestore/merge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,WAAW,CAiCb"}

package/dist/adapters/firestore/merge.js

@@ -0,0 +1,132 @@
+/**
+ * Simple three-way line-level merge.
+ *
+ * Given a base version, a local version, and a remote version,
+ * attempts to merge non-overlapping changes automatically.
+ */
+/**
+ * Three-way merge using line-level diff.
+ *
+ * Algorithm:
+ * 1. Split base, local, remote into lines
+ * 2. Compute change hunks for each side relative to base
+ * 3. If hunks don't overlap, apply both sets of changes
+ * 4. If hunks overlap, return failure (conflict)
+ */
+export function threeWayMerge(base, local, remote) {
+    // Quick wins
+    if (local === remote)
+        return { merged: local, success: true };
+    if (local === base)
+        return { merged: remote, success: true };
+    if (remote === base)
+        return { merged: local, success: true };
+    const baseLines = base.split("\n");
+    const localLines = local.split("\n");
+    const remoteLines = remote.split("\n");
+    const localHunks = computeHunks(baseLines, localLines);
+    const remoteHunks = computeHunks(baseLines, remoteLines);
+    if (hunksOverlap(localHunks, remoteHunks)) {
+        return { merged: null, success: false };
+    }
+    // Apply both sets of changes to base (sorted descending so indices stay valid)
+    const allHunks = [
+        ...localHunks.map((h) => ({ ...h, source: "local" })),
+        ...remoteHunks.map((h) => ({ ...h, source: "remote" })),
+    ].sort((a, b) => b.baseStart - a.baseStart);
+    const result = [...baseLines];
+    for (const hunk of allHunks) {
+        const replacement = hunk.source === "local"
+            ? localLines.slice(hunk.newStart, hunk.newStart + hunk.newLength)
+            : remoteLines.slice(hunk.newStart, hunk.newStart + hunk.newLength);
+        result.splice(hunk.baseStart, hunk.baseLength, ...replacement);
+    }
+    return { merged: result.join("\n"), success: true };
+}
+function computeHunks(base, modified) {
+    const lcs = longestCommonSubsequence(base, modified);
+    const hunks = [];
+    let bi = 0;
+    let mi = 0;
+    let li = 0;
+    while (bi < base.length || mi < modified.length) {
+        if (li < lcs.length &&
+            bi < base.length &&
+            mi < modified.length &&
+            base[bi] === lcs[li] &&
+            modified[mi] === lcs[li]) {
+            bi++;
+            mi++;
+            li++;
+        }
+        else {
+            const baseStart = bi;
+            const modStart = mi;
+            while (bi < base.length &&
+                (li >= lcs.length || base[bi] !== lcs[li])) {
+                bi++;
+            }
+            while (mi < modified.length &&
+                (li >= lcs.length || modified[mi] !== lcs[li])) {
+                mi++;
+            }
+            if (bi !== baseStart || mi !== modStart) {
+                hunks.push({
+                    baseStart,
+                    baseLength: bi - baseStart,
+                    newStart: modStart,
+                    newLength: mi - modStart,
+                });
+            }
+        }
+    }
+    return hunks;
+}
+function hunksOverlap(a, b) {
+    for (const ha of a) {
+        for (const hb of b) {
+            const aEnd = ha.baseStart + ha.baseLength;
+            const bEnd = hb.baseStart + hb.baseLength;
+            if (ha.baseStart < bEnd && hb.baseStart < aEnd) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+function longestCommonSubsequence(a, b) {
+    const m = a.length;
+    const n = b.length;
+    // For very large files, bail out to avoid memory issues
+    if (m * n > 10_000_000)
+        return [];
+    const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            if (a[i - 1] === b[j - 1]) {
+                dp[i][j] = dp[i - 1][j - 1] + 1;
+            }
+            else {
+                dp[i][j] = Math.max(dp[i - 1][j], dp[i][j - 1]);
+            }
+        }
+    }
+    const result = [];
+    let i = m;
+    let j = n;
+    while (i > 0 && j > 0) {
+        if (a[i - 1] === b[j - 1]) {
+            result.unshift(a[i - 1]);
+            i--;
+            j--;
+        }
+        else if (dp[i - 1][j] > dp[i][j - 1]) {
+            i--;
+        }
+        else {
+            j--;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=merge.js.map

package/dist/adapters/firestore/merge.js.map

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

package/dist/adapters/firestore/sync.d.ts

@@ -0,0 +1,91 @@
+import { EventEmitter } from "events";
+export interface FileSyncOptions {
+    /** Unique app identifier (e.g. "content-workspace") */
+    appId: string;
+    /** Default owner ID for shared sync channel */
+    ownerId: string;
+    /** Root directory for synced content */
+    contentRoot: string;
+    /** Firestore collection reference for app files */
+    getFileCollection: () => FirestoreCollection;
+    /** Path to sync-config.json. Default: <contentRoot>/sync-config.json */
+    syncConfigPath?: string;
+}
+/** Minimal Firestore collection interface (avoids hard firebase-admin dependency) */
+export interface FirestoreCollection {
+    doc(id: string): FirestoreDocRef;
+    where(field: string, op: string, value: any): FirestoreQuery;
+}
+export interface FirestoreDocRef {
+    get(): Promise<FirestoreDocSnapshot>;
+    set(data: any, options?: {
+        merge?: boolean;
+    }): Promise<any>;
+    delete(): Promise<any>;
+    collection(name: string): FirestoreCollection;
+}
+export interface FirestoreQuery {
+    where(field: string, op: string, value: any): FirestoreQuery;
+    get(): Promise<FirestoreQuerySnapshot>;
+    onSnapshot(onNext: (snapshot: FirestoreQuerySnapshot) => void, onError: (error: any) => void): () => void;
+}
+export interface FirestoreDocSnapshot {
+    exists: boolean;
+    id: string;
+    data(): any;
+}
+export interface FirestoreQuerySnapshot {
+    docs: FirestoreDocSnapshot[];
+    size: number;
+    docChanges(): Array<{
+        type: "added" | "modified" | "removed";
+        doc: FirestoreDocSnapshot;
+    }>;
+}
+export type SyncEvent = {
+    type: "conflict-resolved";
+    path: string;
+    strategy: "auto-merge" | "local-wins" | "remote-wins";
+} | {
+    type: "conflict-needs-llm";
+    path: string;
+    localSnippet: string;
+    remoteSnippet: string;
+} | {
+    type: "conflict-saved";
+    path: string;
+    conflictFile: string;
+};
+export declare class FileSync {
+    private options;
+    private recentlyPulled;
+    private recentlyPushed;
+    private lastSyncedContent;
+    private sharedSyncInitialized;
+    private privateSyncInitialized;
+    private purgeTimer;
+    readonly syncEvents: EventEmitter<[never]>;
+    constructor(options: FileSyncOptions);
+    /**
+     * Initialize the shared sync channel.
+     * Runs startup sync, starts Firestore listener, and starts file watcher.
+     */
+    initFileSync(): Promise<void>;
+    /**
+     * Initialize the private sync channel using a per-user UID.
+     */
+    initPrivateSync(userUid: string): Promise<void>;
+    private emitSyncEvent;
+    private markRecent;
+    private wasRecent;
+    private startPurgeTimer;
+    private readLocalFile;
+    private writeSyncedFile;
+    private docId;
+    private collection;
+    private resolveConflict;
+    private initStartupSync;
+    private startFirestoreListener;
+    private startFileWatcher;
+}
+//# sourceMappingURL=sync.d.ts.map

package/dist/adapters/firestore/sync.d.ts.map

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