@opendatalabs/personal-server-ts-core 0.2.0 → 1.1.0

package/dist/storage/index/manager.js

@@ -1,132 +1,2 @@
-function rowToEntry(row) {
-    return {
-        id: row.id,
-        fileId: row.file_id,
-        path: row.path,
-        scope: row.scope,
-        collectedAt: row.collected_at,
-        createdAt: row.created_at,
-        sizeBytes: row.size_bytes,
-    };
-}
-export function createIndexManager(db) {
-    const insertStmt = db.prepare(`INSERT INTO data_files (file_id, path, scope, collected_at, size_bytes)
-     VALUES (@file_id, @path, @scope, @collected_at, @size_bytes)`);
-    const findByPathStmt = db.prepare("SELECT * FROM data_files WHERE path = @path");
-    const findLatestByScopeStmt = db.prepare("SELECT * FROM data_files WHERE scope = @scope ORDER BY collected_at DESC LIMIT 1");
-    const countByScopeStmt = db.prepare("SELECT COUNT(*) AS cnt FROM data_files WHERE scope = @scope");
-    const deleteByPathStmt = db.prepare("DELETE FROM data_files WHERE path = @path");
-    const findClosestByScopeStmt = db.prepare("SELECT * FROM data_files WHERE scope = @scope AND collected_at <= @at ORDER BY collected_at DESC LIMIT 1");
-    const findByFileIdStmt = db.prepare("SELECT * FROM data_files WHERE file_id = @file_id");
-    const findUnsyncedStmt = db.prepare("SELECT * FROM data_files WHERE file_id IS NULL ORDER BY created_at ASC");
-    const findUnsyncedLimitStmt = db.prepare("SELECT * FROM data_files WHERE file_id IS NULL ORDER BY created_at ASC LIMIT @limit");
-    const updateFileIdStmt = db.prepare("UPDATE data_files SET file_id = @file_id WHERE path = @path");
-    const deleteByScopeStmt = db.prepare("DELETE FROM data_files WHERE scope = @scope");
-    return {
-        insert(entry) {
-            const result = insertStmt.run({
-                file_id: entry.fileId,
-                path: entry.path,
-                scope: entry.scope,
-                collected_at: entry.collectedAt,
-                size_bytes: entry.sizeBytes,
-            });
-            const row = db
-                .prepare("SELECT * FROM data_files WHERE id = ?")
-                .get(result.lastInsertRowid);
-            return rowToEntry(row);
-        },
-        findByPath(path) {
-            const row = findByPathStmt.get({ path });
-            return row ? rowToEntry(row) : undefined;
-        },
-        findByScope(options) {
-            let sql = "SELECT * FROM data_files";
-            const params = {};
-            if (options.scope) {
-                sql += " WHERE scope = @scope";
-                params.scope = options.scope;
-            }
-            sql += " ORDER BY collected_at DESC";
-            if (options.limit !== undefined) {
-                sql += " LIMIT @limit";
-                params.limit = options.limit;
-            }
-            if (options.offset !== undefined) {
-                sql += " OFFSET @offset";
-                params.offset = options.offset;
-            }
-            const rows = db.prepare(sql).all(params);
-            return rows.map(rowToEntry);
-        },
-        findLatestByScope(scope) {
-            const row = findLatestByScopeStmt.get({ scope });
-            return row ? rowToEntry(row) : undefined;
-        },
-        countByScope(scope) {
-            const row = countByScopeStmt.get({ scope });
-            return row.cnt;
-        },
-        deleteByPath(path) {
-            const result = deleteByPathStmt.run({ path });
-            return result.changes > 0;
-        },
-        listDistinctScopes(options) {
-            const hasPrefix = options?.scopePrefix !== undefined && options.scopePrefix !== "";
-            const prefix = hasPrefix ? options.scopePrefix + "%" : "%";
-            const countRow = db
-                .prepare("SELECT COUNT(DISTINCT scope) AS cnt FROM data_files WHERE scope LIKE @prefix")
-                .get({ prefix });
-            const total = countRow.cnt;
-            let sql = "SELECT scope, MAX(collected_at) AS latest_collected_at, COUNT(*) AS version_count FROM data_files WHERE scope LIKE @prefix GROUP BY scope ORDER BY scope ASC";
-            const params = { prefix };
-            if (options?.limit !== undefined) {
-                sql += " LIMIT @limit";
-                params.limit = options.limit;
-            }
-            if (options?.offset !== undefined) {
-                sql += " OFFSET @offset";
-                params.offset = options.offset;
-            }
-            const rows = db.prepare(sql).all(params);
-            return {
-                scopes: rows.map((r) => ({
-                    scope: r.scope,
-                    latestCollectedAt: r.latest_collected_at,
-                    versionCount: r.version_count,
-                })),
-                total,
-            };
-        },
-        findClosestByScope(scope, at) {
-            const row = findClosestByScopeStmt.get({ scope, at });
-            return row ? rowToEntry(row) : undefined;
-        },
-        findByFileId(fileId) {
-            const row = findByFileIdStmt.get({ file_id: fileId });
-            return row ? rowToEntry(row) : undefined;
-        },
-        findUnsynced(options) {
-            if (options?.limit !== undefined) {
-                const rows = findUnsyncedLimitStmt.all({
-                    limit: options.limit,
-                });
-                return rows.map(rowToEntry);
-            }
-            const rows = findUnsyncedStmt.all();
-            return rows.map(rowToEntry);
-        },
-        updateFileId(path, fileId) {
-            const result = updateFileIdStmt.run({ file_id: fileId, path });
-            return result.changes > 0;
-        },
-        deleteByScope(scope) {
-            const result = deleteByScopeStmt.run({ scope });
-            return result.changes;
-        },
-        close() {
-            db.close();
-        },
-    };
-}
+export {};
 //# sourceMappingURL=manager.js.map

package/dist/storage/index/manager.js.map

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

package/dist/storage/index/schema.d.ts

@@ -1,4 +1,2 @@
-import Database from "better-sqlite3";
-/** Open/create SQLite database, run CREATE TABLE IF NOT EXISTS, set WAL mode */
-export declare function initializeDatabase(dbPath: string): Database.Database;
+export declare const INDEX_SCHEMA_VERSION = 3;
 //# sourceMappingURL=schema.d.ts.map

package/dist/storage/index/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/storage/index/schema.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAmBtC,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAWpE"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/storage/index/schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,IAAI,CAAC"}

package/dist/storage/index/schema.js

@@ -1,27 +1,2 @@
-import Database from "better-sqlite3";
-const CREATE_TABLE_SQL = `
-CREATE TABLE IF NOT EXISTS data_files (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  file_id TEXT,
-  path TEXT NOT NULL UNIQUE,
-  scope TEXT NOT NULL,
-  collected_at TEXT NOT NULL,
-  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
-  size_bytes INTEGER NOT NULL DEFAULT 0
-)`;
-const CREATE_INDEXES_SQL = [
-    "CREATE INDEX IF NOT EXISTS idx_data_files_scope ON data_files (scope)",
-    "CREATE INDEX IF NOT EXISTS idx_data_files_collected_at ON data_files (collected_at)",
-    "CREATE INDEX IF NOT EXISTS idx_data_files_file_id ON data_files (file_id)",
-];
-/** Open/create SQLite database, run CREATE TABLE IF NOT EXISTS, set WAL mode */
-export function initializeDatabase(dbPath) {
-    const db = new Database(dbPath);
-    db.pragma("journal_mode = WAL");
-    db.exec(CREATE_TABLE_SQL);
-    for (const sql of CREATE_INDEXES_SQL) {
-        db.exec(sql);
-    }
-    return db;
-}
+export const INDEX_SCHEMA_VERSION = 3;
 //# sourceMappingURL=schema.js.map

package/dist/storage/index/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/storage/index/schema.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,MAAM,gBAAgB,GAAG;;;;;;;;;EASvB,CAAC;AAEH,MAAM,kBAAkB,GAAG;IACzB,uEAAuE;IACvE,qFAAqF;IACrF,2EAA2E;CAC5E,CAAC;AAEF,gFAAgF;AAChF,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEhC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAEhC,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACrC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/storage/index/schema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC"}

package/dist/storage/index/types.d.ts

@@ -1,12 +1,20 @@
 export interface IndexEntry {
     id: number;
     fileId: string | null;
+    schemaId: string | null;
     path: string;
     scope: string;
     collectedAt: string;
     createdAt: string;
     sizeBytes: number;
+    version: number;
+    dataPointId: string | null;
 }
+export type NewIndexEntry = Omit<IndexEntry, "id" | "createdAt" | "schemaId" | "version" | "dataPointId"> & {
+    schemaId?: string | null;
+    version?: number;
+    dataPointId?: string | null;
+};
 export interface IndexListOptions {
     scope?: string;
     limit?: number;
@@ -16,5 +24,13 @@ export interface ScopeSummary {
     scope: string;
     latestCollectedAt: string;
     versionCount: number;
+    /**
+     * Whether bounded block reads for the latest local version are ready.
+     * Existing data can appear in the index before the block sidecar finishes
+     * indexing; MCP reads require the sidecar.
+     */
+    dataStatus?: "ready" | "indexing";
+    /** Size in bytes of the latest local version. */
+    sizeBytes?: number;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/storage/index/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/storage/index/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/storage/index/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAIlB,OAAO,EAAE,MAAM,CAAC;IAGhB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,MAAM,aAAa,GAAG,IAAI,CAC9B,UAAU,EACV,IAAI,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,CAC5D,GAAG;IACF,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAIzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAClC,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/storage/preview.d.ts

@@ -0,0 +1,12 @@
+export interface EnvelopePreview {
+    text: string;
+    truncated: boolean;
+}
+export declare function previewEnvelopeValue(envelope: unknown, maxBytes: number, options?: {
+    nodeBudget?: number;
+}): EnvelopePreview;
+export declare function previewJsonEnvelopePrefix(jsonText: string, maxBytes: number, options?: {
+    sourceTruncated?: boolean;
+    nodeBudget?: number;
+}): EnvelopePreview;
+//# sourceMappingURL=preview.d.ts.map

package/dist/storage/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/storage/preview.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAoED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACpC,eAAe,CAwDjB;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/D,eAAe,CAiDjB"}

package/dist/storage/preview.js

@@ -0,0 +1,239 @@
+const DEFAULT_PREVIEW_NODE_BUDGET = 15_000;
+const textEncoder = new TextEncoder();
+function utf8Length(text) {
+    return textEncoder.encode(text).byteLength;
+}
+function clipToUtf8Bytes(text, maxBytes) {
+    if (maxBytes <= 0)
+        return "";
+    if (utf8Length(text) <= maxBytes)
+        return text;
+    let low = 0;
+    let high = text.length;
+    while (low < high) {
+        const mid = Math.ceil((low + high) / 2);
+        if (utf8Length(text.slice(0, mid)) <= maxBytes) {
+            low = mid;
+        }
+        else {
+            high = mid - 1;
+        }
+    }
+    let clipped = text.slice(0, low);
+    const last = clipped.charCodeAt(clipped.length - 1);
+    if (last >= 0xd800 && last <= 0xdbff) {
+        clipped = clipped.slice(0, -1);
+    }
+    return clipped;
+}
+function appendPreviewToken(chunks, token, maxBytes, state) {
+    if (!token)
+        return true;
+    const text = chunks.length > 0 ? `\n${token}` : token;
+    const remaining = maxBytes - state.bytes;
+    if (remaining <= 0) {
+        state.truncated = true;
+        return false;
+    }
+    const encodedBytes = utf8Length(text);
+    if (encodedBytes <= remaining) {
+        chunks.push(text);
+        state.bytes += encodedBytes;
+        return true;
+    }
+    const clipped = clipToUtf8Bytes(text, remaining);
+    if (clipped) {
+        chunks.push(clipped);
+        state.bytes += utf8Length(clipped);
+    }
+    state.truncated = true;
+    return false;
+}
+export function previewEnvelopeValue(envelope, maxBytes, options = {}) {
+    const chunks = [];
+    const stack = [envelope];
+    const state = { bytes: 0, truncated: false };
+    const seen = new WeakSet();
+    const nodeBudget = options.nodeBudget ?? DEFAULT_PREVIEW_NODE_BUDGET;
+    let nodes = 0;
+    while (stack.length > 0) {
+        if (nodes >= nodeBudget) {
+            state.truncated = true;
+            break;
+        }
+        const current = stack.pop();
+        nodes += 1;
+        if (typeof current === "string") {
+            if (!appendPreviewToken(chunks, current, maxBytes, state))
+                break;
+            continue;
+        }
+        if (typeof current === "number" ||
+            typeof current === "boolean" ||
+            typeof current === "bigint") {
+            if (!appendPreviewToken(chunks, String(current), maxBytes, state))
+                break;
+            continue;
+        }
+        if (Array.isArray(current)) {
+            if (seen.has(current))
+                continue;
+            seen.add(current);
+            for (let index = current.length - 1; index >= 0; index -= 1) {
+                stack.push(current[index]);
+            }
+            continue;
+        }
+        if (typeof current === "object" && current !== null) {
+            if (seen.has(current))
+                continue;
+            seen.add(current);
+            const entries = Object.entries(current);
+            for (let index = entries.length - 1; index >= 0; index -= 1) {
+                const [key, value] = entries[index];
+                stack.push(value);
+                stack.push(key);
+            }
+        }
+    }
+    return {
+        text: chunks.join(""),
+        truncated: state.truncated,
+    };
+}
+export function previewJsonEnvelopePrefix(jsonText, maxBytes, options = {}) {
+    const chunks = [];
+    const state = {
+        bytes: 0,
+        truncated: options.sourceTruncated ?? false,
+    };
+    const nodeBudget = options.nodeBudget ?? DEFAULT_PREVIEW_NODE_BUDGET;
+    let nodes = 0;
+    let index = 0;
+    while (index < jsonText.length) {
+        if (nodes >= nodeBudget) {
+            state.truncated = true;
+            break;
+        }
+        const char = jsonText[index];
+        if (char === '"') {
+            const token = readJsonStringToken(jsonText, index + 1);
+            nodes += 1;
+            if (!appendPreviewToken(chunks, token.value, maxBytes, state))
+                break;
+            state.truncated = state.truncated || token.truncated;
+            index = token.nextIndex;
+            continue;
+        }
+        if (char && /[-0-9]/u.test(char)) {
+            const token = readJsonNumberToken(jsonText, index);
+            nodes += 1;
+            if (!appendPreviewToken(chunks, token.value, maxBytes, state))
+                break;
+            index = token.nextIndex;
+            continue;
+        }
+        const literal = readJsonLiteralToken(jsonText, index);
+        if (literal) {
+            nodes += 1;
+            if (!appendPreviewToken(chunks, literal.value, maxBytes, state))
+                break;
+            index = literal.nextIndex;
+            continue;
+        }
+        index += 1;
+    }
+    return {
+        text: chunks.join(""),
+        truncated: state.truncated,
+    };
+}
+function readJsonStringToken(text, startIndex) {
+    let value = "";
+    let index = startIndex;
+    let truncated = true;
+    while (index < text.length) {
+        const char = text[index];
+        if (char === '"') {
+            truncated = false;
+            index += 1;
+            break;
+        }
+        if (char !== "\\") {
+            value += char;
+            index += 1;
+            continue;
+        }
+        const escaped = text[index + 1];
+        if (!escaped) {
+            index = text.length;
+            break;
+        }
+        switch (escaped) {
+            case '"':
+            case "\\":
+            case "/":
+                value += escaped;
+                index += 2;
+                break;
+            case "b":
+                value += "\b";
+                index += 2;
+                break;
+            case "f":
+                value += "\f";
+                index += 2;
+                break;
+            case "n":
+                value += "\n";
+                index += 2;
+                break;
+            case "r":
+                value += "\r";
+                index += 2;
+                break;
+            case "t":
+                value += "\t";
+                index += 2;
+                break;
+            case "u": {
+                const hex = text.slice(index + 2, index + 6);
+                if (!/^[0-9a-fA-F]{4}$/u.test(hex)) {
+                    index = text.length;
+                    break;
+                }
+                value += String.fromCharCode(Number.parseInt(hex, 16));
+                index += 6;
+                break;
+            }
+            default:
+                value += escaped;
+                index += 2;
+                break;
+        }
+    }
+    return { value, nextIndex: index, truncated };
+}
+function readJsonNumberToken(text, startIndex) {
+    let index = startIndex;
+    while (index < text.length && /[-+0-9.eE]/u.test(text[index])) {
+        index += 1;
+    }
+    return {
+        value: text.slice(startIndex, index),
+        nextIndex: index,
+    };
+}
+function readJsonLiteralToken(text, startIndex) {
+    if (text.startsWith("true", startIndex)) {
+        return { value: "true", nextIndex: startIndex + 4 };
+    }
+    if (text.startsWith("false", startIndex)) {
+        return { value: "false", nextIndex: startIndex + 5 };
+    }
+    if (text.startsWith("null", startIndex)) {
+        return { value: "null", nextIndex: startIndex + 4 };
+    }
+    return null;
+}
+//# sourceMappingURL=preview.js.map

package/dist/storage/preview.js.map

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

package/dist/sync/cursor.d.ts

@@ -1,12 +1,10 @@
 export interface SyncCursor {
-    /** Read the lastProcessedTimestamp from config.json */
+    /** Read the lastProcessedTimestamp from cursor state. */
     read(): Promise<string | null>;
-    /** Write the lastProcessedTimestamp to config.json */
+    /** Write the lastProcessedTimestamp to cursor state. */
     write(timestamp: string): Promise<void>;
 }
-/**
- * Creates a cursor that reads/writes sync.lastProcessedTimestamp in config.json.
- * Uses loadConfig/saveConfig to preserve other config fields.
- */
-export declare function createSyncCursor(configPath: string): SyncCursor;
+export interface SyncCursorOptions {
+    legacyConfigPath?: string;
+}
 //# sourceMappingURL=cursor.d.ts.map

package/dist/sync/cursor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/sync/cursor.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE/B,sDAAsD;IACtD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAa/D"}
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/sync/cursor.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,yDAAyD;IACzD,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE/B,wDAAwD;IACxD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/dist/sync/cursor.js

@@ -1,19 +1,2 @@
-import { loadConfig, saveConfig } from "../config/index.js";
-/**
- * Creates a cursor that reads/writes sync.lastProcessedTimestamp in config.json.
- * Uses loadConfig/saveConfig to preserve other config fields.
- */
-export function createSyncCursor(configPath) {
-    return {
-        async read() {
-            const config = await loadConfig({ configPath });
-            return config.sync.lastProcessedTimestamp;
-        },
-        async write(timestamp) {
-            const config = await loadConfig({ configPath });
-            config.sync.lastProcessedTimestamp = timestamp;
-            await saveConfig(config, { configPath });
-        },
-    };
-}
+export {};
 //# sourceMappingURL=cursor.js.map

package/dist/sync/cursor.js.map

@@ -1 +1 @@
-{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/sync/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAU5D;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,OAAO;QACL,KAAK,CAAC,IAAI;YACR,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;YAChD,OAAO,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC;QAC5C,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,SAAS;YACnB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;YAChD,MAAM,CAAC,IAAI,CAAC,sBAAsB,GAAG,SAAS,CAAC;YAC/C,MAAM,UAAU,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/sync/cursor.ts"],"names":[],"mappings":""}

package/dist/sync/engine/sync-manager.d.ts

@@ -6,7 +6,18 @@ export interface SyncManagerOptions {
     pollInterval?: number;
     /** Max upload batch size per cycle (default: 50) */
     uploadBatchSize?: number;
+    /** Debounce for immediate sync after local ingest (default: 500ms) */
+    notifyDebounceMs?: number;
+    /** Optional runtime gate. Returning blocked skips upload/download without an error. */
+    canSync?: () => Promise<SyncCanRunResult> | SyncCanRunResult;
 }
+export type SyncCanRunResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+    message: string;
+};
 export interface SyncManager {
     /** Start the background sync loop */
     start(): void;
@@ -18,6 +29,12 @@ export interface SyncManager {
     getStatus(): SyncStatus;
     /** Signal that new data has been ingested (next cycle picks it up) */
     notifyNewData(): void;
+    /**
+     * Propagate a scope deletion to the authoritative stores (R2 blobs + gateway file records).
+     * Call BEFORE deleting the scope locally — it reads the local index to find what to remove.
+     * Best-effort: resolves with a summary; per-file failures are logged, not thrown.
+     */
+    deleteScopeRemote(scope: string): Promise<void>;
     /** Whether the sync manager is currently running */
     readonly running: boolean;
 }

package/dist/sync/engine/sync-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-manager.d.ts","sourceRoot":"","sources":["../../../src/sync/engine/sync-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,aAAa,CAAC;AAIzD,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,KAAK,IAAI,IAAI,CAAC;IAEd,+CAA+C;IAC/C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,mDAAmD;IACnD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB,8BAA8B;IAC9B,SAAS,IAAI,UAAU,CAAC;IAExB,sEAAsE;IACtE,aAAa,IAAI,IAAI,CAAC;IAEtB,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAID,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,gBAAgB,EAC5B,YAAY,EAAE,kBAAkB,EAChC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,WAAW,CA8Jb"}
+{"version":3,"file":"sync-manager.d.ts","sourceRoot":"","sources":["../../../src/sync/engine/sync-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAgC,MAAM,aAAa,CAAC;AAM5E,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAAC;CAC9D;AAED,MAAM,MAAM,gBAAgB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,KAAK,IAAI,IAAI,CAAC;IAEd,+CAA+C;IAC/C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,mDAAmD;IACnD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB,8BAA8B;IAC9B,SAAS,IAAI,UAAU,CAAC;IAExB,sEAAsE;IACtE,aAAa,IAAI,IAAI,CAAC;IAEtB;;;;OAIG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAID,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,gBAAgB,EAC5B,YAAY,EAAE,kBAAkB,EAChC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,WAAW,CA2Nb"}