@opendatalabs/personal-server-ts-server 0.0.1-canary.de6bc6f → 0.0.1-canary.dfa1648

package/dist/schema-registrar.d.ts

@@ -1,26 +1,8 @@
-import type { SchemaRegistrarPort } from "@opendatalabs/personal-server-ts-core/ports";
-import type { ServerSigner } from "@opendatalabs/personal-server-ts-core/signing";
-import type { Logger } from "pino";
 /**
- * Definition used for scopes that carry unstructured/binary data. Nothing in
- * this stack fetches the definitionUrl — it only needs to be a stable string —
- * but consuming builders may dereference it, so it points at a permissive doc.
+ * The no-schema registrar now lives in core so the in-browser PS-Lite runtime
+ * can register schemas for binary uploads too (see
+ * `packages/core/src/api/schema-registrar.ts`). Re-exported here for backwards
+ * compatibility with existing server imports.
  */
-export declare const NO_SCHEMA_NAME = "No Schema";
-export declare const NO_SCHEMA_DEFINITION_URL = "https://schemas.vana.org/no-schema/v1.json";
-export declare const NO_SCHEMA_DIALECT = "none";
-export interface SchemaRegistrarDeps {
-    gatewayUrl: string;
-    signer: ServerSigner;
-    logger?: Logger;
-}
-/**
- * Registers (idempotently, by scope) a permissive "no-schema" schema with the
- * gateway via POST /v1/schemas, signing an EIP-712 SchemaRegistration message.
- *
- * The gateway requires the EIP-712 signer to equal the registered ownerAddress
- * (no server-delegation branch for schemas), so the schema is owned by the
- * server signing account.
- */
-export declare function createSchemaRegistrar(deps: SchemaRegistrarDeps): SchemaRegistrarPort;
+export { createSchemaRegistrar, NO_SCHEMA_DEFINITION_URL, NO_SCHEMA_DIALECT, NO_SCHEMA_NAME, type SchemaRegistrarDeps, } from "@opendatalabs/personal-server-ts-core/api";
 //# sourceMappingURL=schema-registrar.d.ts.map

package/dist/schema-registrar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-registrar.d.ts","sourceRoot":"","sources":["../src/schema-registrar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,mBAAmB,EACpB,MAAM,6CAA6C,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAC;AAClF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC;;;;GAIG;AACH,eAAO,MAAM,cAAc,cAAc,CAAC;AAC1C,eAAO,MAAM,wBAAwB,+CACS,CAAC;AAC/C,eAAO,MAAM,iBAAiB,SAAS,CAAC;AAExC,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAoBD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,mBAAmB,GACxB,mBAAmB,CA8CrB"}
+{"version":3,"file":"schema-registrar.d.ts","sourceRoot":"","sources":["../src/schema-registrar.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,cAAc,EACd,KAAK,mBAAmB,GACzB,MAAM,2CAA2C,CAAC"}

package/dist/schema-registrar.js

@@ -1,61 +1,8 @@
 /**
- * Definition used for scopes that carry unstructured/binary data. Nothing in
- * this stack fetches the definitionUrl — it only needs to be a stable string —
- * but consuming builders may dereference it, so it points at a permissive doc.
+ * The no-schema registrar now lives in core so the in-browser PS-Lite runtime
+ * can register schemas for binary uploads too (see
+ * `packages/core/src/api/schema-registrar.ts`). Re-exported here for backwards
+ * compatibility with existing server imports.
  */
-export const NO_SCHEMA_NAME = "No Schema";
-export const NO_SCHEMA_DEFINITION_URL = "https://schemas.vana.org/no-schema/v1.json";
-export const NO_SCHEMA_DIALECT = "none";
-function extractSchemaId(body) {
-    return (body.schemaId ??
-        body.id ??
-        body.data?.schemaId ??
-        body.data?.id ??
-        undefined);
-}
-/**
- * Registers (idempotently, by scope) a permissive "no-schema" schema with the
- * gateway via POST /v1/schemas, signing an EIP-712 SchemaRegistration message.
- *
- * The gateway requires the EIP-712 signer to equal the registered ownerAddress
- * (no server-delegation branch for schemas), so the schema is owned by the
- * server signing account.
- */
-export function createSchemaRegistrar(deps) {
-    const base = deps.gatewayUrl.replace(/\/+$/, "");
-    return {
-        async registerNoSchema(scope) {
-            const ownerAddress = deps.signer.address;
-            const message = {
-                ownerAddress,
-                name: NO_SCHEMA_NAME,
-                definitionUrl: NO_SCHEMA_DEFINITION_URL,
-                scope,
-                dialect: NO_SCHEMA_DIALECT,
-            };
-            const signature = await deps.signer.signSchemaRegistration(message);
-            const res = await fetch(`${base}/v1/schemas`, {
-                method: "POST",
-                headers: {
-                    "Content-Type": "application/json",
-                    Authorization: `Web3Signed ${signature}`,
-                },
-                body: JSON.stringify(message),
-            });
-            if (!res.ok) {
-                const detail = await res.text().catch(() => res.statusText);
-                throw new Error(`Schema registration failed: ${res.status} ${detail}`);
-            }
-            const body = (await res
-                .json()
-                .catch(() => ({})));
-            const schemaId = extractSchemaId(body);
-            if (!schemaId) {
-                throw new Error(`Schema registration for "${scope}" did not return a schemaId`);
-            }
-            deps.logger?.info({ scope, schemaId }, "Registered no-schema schema with gateway");
-            return { schemaId, definitionUrl: NO_SCHEMA_DEFINITION_URL };
-        },
-    };
-}
+export { createSchemaRegistrar, NO_SCHEMA_DEFINITION_URL, NO_SCHEMA_DIALECT, NO_SCHEMA_NAME, } from "@opendatalabs/personal-server-ts-core/api";
 //# sourceMappingURL=schema-registrar.js.map

package/dist/schema-registrar.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema-registrar.js","sourceRoot":"","sources":["../src/schema-registrar.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC;AAC1C,MAAM,CAAC,MAAM,wBAAwB,GACnC,4CAA4C,CAAC;AAC/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAcxC,SAAS,eAAe,CACtB,IAAoC;IAEpC,OAAO,CACL,IAAI,CAAC,QAAQ;QACb,IAAI,CAAC,EAAE;QACP,IAAI,CAAC,IAAI,EAAE,QAAQ;QACnB,IAAI,CAAC,IAAI,EAAE,EAAE;QACb,SAAS,CACV,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAyB;IAEzB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEjD,OAAO;QACL,KAAK,CAAC,gBAAgB,CAAC,KAAa;YAClC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YACzC,MAAM,OAAO,GAAG;gBACd,YAAY;gBACZ,IAAI,EAAE,cAAc;gBACpB,aAAa,EAAE,wBAAwB;gBACvC,KAAK;gBACL,OAAO,EAAE,iBAAiB;aAC3B,CAAC;YACF,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;YAEpE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,aAAa,EAAE;gBAC5C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,aAAa,EAAE,cAAc,SAAS,EAAE;iBACzC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;aAC9B,CAAC,CAAC;YAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBAC5D,MAAM,IAAI,KAAK,CAAC,+BAA+B,GAAG,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC;YACzE,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG;iBACpB,IAAI,EAAE;iBACN,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAmC,CAAC;YACxD,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CACb,4BAA4B,KAAK,6BAA6B,CAC/D,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,MAAM,EAAE,IAAI,CACf,EAAE,KAAK,EAAE,QAAQ,EAAE,EACnB,0CAA0C,CAC3C,CAAC;YACF,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,wBAAwB,EAAE,CAAC;QAC/D,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"schema-registrar.js","sourceRoot":"","sources":["../src/schema-registrar.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,cAAc,GAEf,MAAM,2CAA2C,CAAC"}

package/dist/ui/ps-lite-debug.js

@@ -105446,6 +105446,12 @@ function deleteMapPrefix(map2, pathPrefix) {
     }
   }
 }
+function describeStorageError(error51) {
+  if (error51 instanceof Error) {
+    return { errorClass: error51.name, message: error51.message };
+  }
+  return { errorClass: typeof error51, message: String(error51) };
+}
 async function getOrCreateOpfsDirectory(root, parts) {
   let dir = root;
   for (const part of parts) {
@@ -105640,8 +105646,8 @@ async function createPersistentPsLiteStorage(adapter, persistence = createIndexe
     const snapshot = {
       ...state,
       envelopes: fileStore.kind === "indexeddb" ? Array.from(fallbackEnvelopes.values()) : [],
-      blockManifests: fileStore.kind === "indexeddb" ? Array.from(fallbackBlockManifests.entries()).map(([path, manifest]) => ({ path, manifest })) : [],
-      blockPayloads: fileStore.kind === "indexeddb" ? Array.from(fallbackBlockPayloads.entries()).map(([path, block]) => ({ path, block })) : []
+      blockManifests: Array.from(fallbackBlockManifests.entries()).map(([path, manifest]) => ({ path, manifest })),
+      blockPayloads: Array.from(fallbackBlockPayloads.entries()).map(([path, block]) => ({ path, block }))
     };
     const write = persistQueue.then(() => persistence.write(snapshot));
     persistQueue = write.catch(() => void 0);
@@ -105749,15 +105755,34 @@ async function createPersistentPsLiteStorage(adapter, persistence = createIndexe
       return Boolean(manifest);
     },
     async writeBlockManifest(scope, collectedAt2, manifest, blocks) {
-      if (!fileStore.writeBlockManifest || !fileStore.writeBlockPayload) {
-        throw new Error("Block sidecar storage is not available");
-      }
-      await fileStore.deleteBlockTree?.(blockTreePath(scope, collectedAt2));
-      for (const block of blocks) {
-        await fileStore.writeBlockPayload(blockPayloadPath(scope, collectedAt2, block.id), block);
-      }
-      await fileStore.writeBlockManifest(blockManifestPath(scope, collectedAt2), manifest);
-      if (fileStore.kind !== "indexeddb") {
+      const writeTree = async (store) => {
+        if (!store.writeBlockManifest || !store.writeBlockPayload) {
+          throw new Error("Block sidecar storage is not available");
+        }
+        await store.deleteBlockTree?.(blockTreePath(scope, collectedAt2));
+        for (const block of blocks) {
+          await store.writeBlockPayload(blockPayloadPath(scope, collectedAt2, block.id), block);
+        }
+        await store.writeBlockManifest(blockManifestPath(scope, collectedAt2), manifest);
+      };
+      let wrotePrimary = false;
+      try {
+        await writeTree(fileStore);
+        wrotePrimary = true;
+      } catch (error51) {
+        if (fileStore === fallbackStore) {
+          throw error51;
+        }
+        console.warn({
+          scope,
+          collectedAt: collectedAt2,
+          fileStoreKind: fileStore.kind,
+          fallbackStoreKind: fallbackStore.kind,
+          ...describeStorageError(error51)
+        }, "Primary block sidecar write failed; using IndexedDB fallback");
+        await writeTree(fallbackStore);
+      }
+      if (wrotePrimary && fileStore.kind !== "indexeddb") {
         await fallbackStore.deleteBlockTree?.(blockTreePath(scope, collectedAt2));
       }
       await persist();
@@ -107803,6 +107828,49 @@ async function syncFileContract(input) {
   return contractOk({ fileId: input.fileId, status: "started" }, 202);
 }
 
+// ../core/dist/api/schema-registrar.js
+var NO_SCHEMA_NAME = "No Schema";
+var NO_SCHEMA_DEFINITION_URL = "https://schemas.vana.org/no-schema/v1.json";
+var NO_SCHEMA_DIALECT = "none";
+function extractSchemaId(body) {
+  return body.schemaId ?? body.id ?? body.data?.schemaId ?? body.data?.id ?? void 0;
+}
+function createSchemaRegistrar(deps) {
+  const base = deps.gatewayUrl.replace(/\/+$/, "");
+  return {
+    async registerNoSchema(scope) {
+      const ownerAddress = deps.signer.address;
+      const message = {
+        ownerAddress,
+        name: NO_SCHEMA_NAME,
+        definitionUrl: NO_SCHEMA_DEFINITION_URL,
+        scope,
+        dialect: NO_SCHEMA_DIALECT
+      };
+      const signature = await deps.signer.signSchemaRegistration(message);
+      const res = await fetch(`${base}/v1/schemas`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Web3Signed ${signature}`
+        },
+        body: JSON.stringify(message)
+      });
+      if (!res.ok) {
+        const detail = await res.text().catch(() => res.statusText);
+        throw new Error(`Schema registration failed: ${res.status} ${detail}`);
+      }
+      const body = await res.json().catch(() => ({}));
+      const schemaId = extractSchemaId(body);
+      if (!schemaId) {
+        throw new Error(`Schema registration for "${scope}" did not return a schemaId`);
+      }
+      deps.logger?.info({ scope, schemaId }, "Registered no-schema schema with gateway");
+      return { schemaId, definitionUrl: NO_SCHEMA_DEFINITION_URL };
+    }
+  };
+}
+
 // ../core/dist/api/index.js
 function jsonResponse(body, init) {
   const headers = new Headers(init?.headers);
@@ -110827,6 +110895,23 @@ function uniqueSources(connection) {
   }
   return Array.from(set2).sort();
 }
+function normalizeScopeListInput(value) {
+  if (!Array.isArray(value))
+    return [];
+  const scopes = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const raw of value) {
+    if (typeof raw !== "string")
+      continue;
+    const scope = raw.trim();
+    if (!scope || scope.length > SEARCH_SCOPE_MAX_CHARS || seen.has(scope)) {
+      continue;
+    }
+    seen.add(scope);
+    scopes.push(scope);
+  }
+  return scopes;
+}
 var DEFAULT_SEARCH_LIMIT = 5;
 var MAX_SEARCH_LIMIT = 50;
 var MAX_SEARCH_SCOPES = 200;
@@ -111189,6 +111274,36 @@ var listGrantedScopes = {
     return textResult({ scopes: scopeEntries });
   }
 };
+var requestScopeAccess = {
+  name: "request_scope_access",
+  title: "Request scope access",
+  description: "Check which requested scopes are missing from this MCP grant and tell the user to approve them in Vana.",
+  inputSchema: {
+    scopes: external_exports.array(external_exports.string().min(1).max(SEARCH_SCOPE_MAX_CHARS)).min(1).max(SEARCH_REQUESTED_SCOPES_LIMIT).describe("Exact scope ids the MCP client wants to read."),
+    reason: external_exports.string().max(500).optional().describe("Brief reason to show the user.")
+  },
+  async handler(args, { connection }) {
+    const requestedScopes = normalizeScopeListInput(args.scopes);
+    const grantedRequestedScopes = requestedScopes.filter((scope) => Boolean(resolveGrantForScope(connection, scope)));
+    const missingScopes = requestedScopes.filter((scope) => !resolveGrantForScope(connection, scope));
+    const reason = typeof args.reason === "string" ? args.reason.trim() : "";
+    const approvalRequired = missingScopes.length > 0;
+    return textResult({
+      approvalRequired,
+      client: {
+        id: connection.id,
+        displayName: connection.displayName,
+        status: connection.status
+      },
+      requestedScopes,
+      grantedRequestedScopes,
+      missingScopes,
+      grantedScopes: uniqueScopes(connection),
+      reason: reason || void 0,
+      nextAction: approvalRequired ? "Ask the user to open Vana's Personal Server page and add the missing scopes to this MCP client. This tool cannot grant access by itself." : "No new grant is needed for the requested scopes."
+    });
+  }
+};
 var readScope = {
   name: "read_scope",
   title: "Read scope",
@@ -111661,6 +111776,7 @@ var getScopeFile = {
 var MCP_TOOLS = [
   listGrantedSources,
   listGrantedScopes,
+  requestScopeAccess,
   readScope,
   getScopeFile,
   searchPersonalContext
@@ -123177,6 +123293,15 @@ function createPsLiteRuntime(options) {
   }
   const tokenStore = options.tokenStore ?? createDefaultTokenStore();
   const saveConfig = options.saveConfig ?? createDefaultSaveConfig();
+  const schemaRegistrarSigner = options.serverSigner;
+  const schemaRegistrarGatewayUrl = options.config?.gateway?.url;
+  const schemaRegistrar = schemaRegistrarSigner?.signSchemaRegistration && schemaRegistrarSigner.address && schemaRegistrarGatewayUrl ? createSchemaRegistrar({
+    gatewayUrl: schemaRegistrarGatewayUrl,
+    signer: {
+      address: schemaRegistrarSigner.address,
+      signSchemaRegistration: schemaRegistrarSigner.signSchemaRegistration
+    }
+  }) : void 0;
   const deviceSessions = createMemoryDeviceSessionStore();
   const mcpOAuthAuthorizationStore = options.mcpOAuthAuthorizationStore ?? createInMemoryMcpOAuthAuthorizationStore();
   const activityRecorder = options.mcpConnectionStore ? new McpActivityRecorder() : void 0;
@@ -123389,6 +123514,7 @@ function createPsLiteRuntime(options) {
             storage: dataStorage,
             auth,
             schemaResolver: options.gateway,
+            schemaRegistrar,
             accessLogWriter,
             syncManager: options.syncManager ?? null,
             now,
@@ -124043,9 +124169,17 @@ async function downloadOne(deps, record2) {
   const { storage, storageAdapter, gateway, masterKey, logger, diagnostics } = deps;
   const existing = storage.findByFileId(record2.fileId);
   if (existing) {
-    await repairMissingBlockSidecars(storage, logger, record2, existing, diagnostics);
-    logger.debug({ fileId: record2.fileId }, "File already in index, skipping");
-    return null;
+    const repairResult = await repairMissingBlockSidecars(storage, logger, record2, existing, diagnostics);
+    if (repairResult === "missing-envelope") {
+      logger.warn({
+        fileId: record2.fileId,
+        scope: existing.scope,
+        collectedAt: existing.collectedAt
+      }, "Local index entry was missing its envelope; re-downloading file");
+    } else {
+      logger.debug({ fileId: record2.fileId }, "File already in index, skipping");
+      return null;
+    }
   }
   diagnostics?.onDownloadStart(record2.fileId);
   let encrypted;
@@ -124101,17 +124235,24 @@ async function downloadOne(deps, record2) {
     if (existingByVersion.fileId !== record2.fileId) {
       await storage.updateFileId(existingByVersion.path, record2.fileId);
     }
-    await repairMissingBlockSidecars(storage, logger, record2, {
+    const repairResult = await repairMissingBlockSidecars(storage, logger, record2, {
       ...existingByVersion,
       fileId: record2.fileId,
       schemaId: existingByVersion.schemaId ?? record2.schemaId
     }, diagnostics);
-    logger.debug({
+    if (repairResult !== "missing-envelope") {
+      logger.debug({
+        fileId: record2.fileId,
+        scope: envelope.scope,
+        collectedAt: envelope.collectedAt
+      }, "File version already exists locally, skipping");
+      return null;
+    }
+    logger.warn({
       fileId: record2.fileId,
       scope: envelope.scope,
       collectedAt: envelope.collectedAt
-    }, "File version already exists locally, skipping");
-    return null;
+    }, "Local version entry was missing its envelope; rewriting downloaded file");
   }
   diagnostics?.onIndexStart(record2.fileId, envelope.scope);
   let relativePath;
@@ -124150,8 +124291,11 @@ async function downloadOne(deps, record2) {
 async function downloadAll(deps) {
   const { gateway, cursor, serverOwner, logger } = deps;
   const syncRunId = createSyncRunId();
-  await repairLocalMissingBlockSidecars(deps);
-  const lastProcessedTimestamp = await cursor.read();
+  const repairSummary = await repairLocalMissingBlockSidecars(deps);
+  const lastProcessedTimestamp = repairSummary.missingEnvelopeEntries > 0 ? null : await cursor.read();
+  if (repairSummary.missingEnvelopeEntries > 0) {
+    logger.warn({ missingEnvelopeEntries: repairSummary.missingEnvelopeEntries }, "Resetting this sync listing to repair stale local index entries");
+  }
   const { files, cursor: nextCursor } = await gateway.listFilesSince(serverOwner, lastProcessedTimestamp, { includeDeleted: true });
   const results = [];
   let failed = false;
@@ -124210,13 +124354,16 @@ async function downloadAll(deps) {
 }
 async function repairLocalMissingBlockSidecars(deps) {
   const { storage, logger, diagnostics } = deps;
-  if (!storage.writeBlockManifest || !storage.hasScopeBlocks)
-    return 0;
+  if (!storage.writeBlockManifest || !storage.hasScopeBlocks) {
+    return { repaired: 0, missingEnvelopeEntries: 0 };
+  }
   let repaired = 0;
+  let missingEnvelopeEntries = 0;
   let offset = 0;
   const limit = 100;
   while (true) {
     const page = storage.listScopes({ limit, offset });
+    let deletedEntryInPage = false;
     for (const scopeSummary of page.scopes) {
       const entry = storage.findEntry({
         scope: scopeSummary.scope,
@@ -124224,24 +124371,33 @@ async function repairLocalMissingBlockSidecars(deps) {
       });
       if (!entry)
         continue;
-      const repairedScope = await repairMissingBlockSidecars(storage, logger, {
+      const repairResult = await repairMissingBlockSidecars(storage, logger, {
         fileId: entry.fileId ?? entry.path,
         owner: "",
         url: "",
         schemaId: entry.schemaId ?? "",
         createdAt: entry.createdAt
       }, entry, diagnostics);
-      if (repairedScope)
+      if (repairResult === "repaired")
         repaired += 1;
+      if (repairResult === "missing-envelope") {
+        missingEnvelopeEntries += 1;
+        deletedEntryInPage = true;
+      }
+    }
+    if (!deletedEntryInPage) {
+      offset += page.scopes.length;
     }
-    offset += page.scopes.length;
     if (offset >= page.total || page.scopes.length === 0)
       break;
   }
   if (repaired > 0) {
     logger.info({ repaired }, "Repaired missing bounded block sidecars for local indexed data");
   }
-  return repaired;
+  if (missingEnvelopeEntries > 0) {
+    logger.warn({ missingEnvelopeEntries }, "Removed stale local index entries missing local envelopes");
+  }
+  return { repaired, missingEnvelopeEntries };
 }
 function createSyncRunId() {
   return typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `download-${Date.now().toString(36)}`;
@@ -124299,8 +124455,9 @@ async function writeBlockSidecars2(storage, envelope, logger, record2, relativeP
   }
 }
 async function repairMissingBlockSidecars(storage, logger, record2, entry, diagnostics) {
-  if (!storage.writeBlockManifest || !storage.hasScopeBlocks)
-    return false;
+  if (!storage.writeBlockManifest || !storage.hasScopeBlocks) {
+    return "not-repaired";
+  }
   let hasBlocks = false;
   try {
     hasBlocks = await storage.hasScopeBlocks(entry.scope, entry.collectedAt);
@@ -124311,10 +124468,10 @@ async function repairMissingBlockSidecars(storage, logger, record2, entry, diagn
       collectedAt: entry.collectedAt,
       error: error51.message
     }, "Bounded block sidecar repair skipped after readiness check failed");
-    return false;
+    return "not-repaired";
   }
   if (hasBlocks)
-    return false;
+    return "already-ready";
   diagnostics?.onRepair(entry.scope, "indexed entry missing block manifest; rebuilding from local envelope");
   let envelope;
   try {
@@ -124326,7 +124483,18 @@ async function repairMissingBlockSidecars(storage, logger, record2, entry, diagn
       collectedAt: entry.collectedAt,
       error: error51.message
     }, "Bounded block sidecar repair skipped because local envelope is unavailable");
-    return false;
+    if (entry.fileId) {
+      diagnostics?.onRepair(entry.scope, "index exists without local payload; removing stale local index entry");
+      const removed = await storage.deleteByFileId(entry.fileId);
+      logger.warn({
+        fileId: entry.fileId,
+        scope: entry.scope,
+        collectedAt: entry.collectedAt,
+        removed
+      }, "Removed stale local index entry missing local envelope");
+      return removed ? "missing-envelope" : "not-repaired";
+    }
+    return "not-repaired";
   }
   await writeBlockSidecars2(storage, envelope, logger, {
     ...record2,
@@ -124334,7 +124502,7 @@ async function repairMissingBlockSidecars(storage, logger, record2, entry, diagn
     schemaId: entry.schemaId ?? record2.schemaId
   }, entry.path, diagnostics);
   try {
-    return await storage.hasScopeBlocks(entry.scope, entry.collectedAt);
+    return await storage.hasScopeBlocks(entry.scope, entry.collectedAt) ? "repaired" : "not-repaired";
   } catch (error51) {
     logger.warn({
       fileId: entry.fileId ?? record2.fileId,
@@ -124342,7 +124510,7 @@ async function repairMissingBlockSidecars(storage, logger, record2, entry, diagn
       collectedAt: entry.collectedAt,
       error: error51.message
     }, "Bounded block sidecar repair completed but readiness could not be verified");
-    return false;
+    return "not-repaired";
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opendatalabs/personal-server-ts-server",
-  "version": "0.0.1-canary.de6bc6f",
+  "version": "0.0.1-canary.dfa1648",
   "description": "Hono HTTP server for the Vana Personal Server — routes, middleware, composition root",
   "license": "MIT",
   "repository": {
@@ -44,8 +44,8 @@
   },
   "dependencies": {
     "@hono/node-server": "^1.19.13",
-    "@opendatalabs/personal-server-ts-core": "0.0.1-canary.de6bc6f",
-    "@opendatalabs/personal-server-ts-lite": "0.0.1-canary.de6bc6f",
+    "@opendatalabs/personal-server-ts-core": "0.0.1-canary.dfa1648",
+    "@opendatalabs/personal-server-ts-lite": "0.0.1-canary.dfa1648",
     "@opendatalabs/vana-sdk": "^3.4.1",
     "better-sqlite3": "^12.9.0",
     "hono": "^4.12.18",