oscar64-mcp-docs 1.0.3 → 1.0.5

package/dist/stdio.js

@@ -1443,13 +1443,42 @@ async function initState(forceRefresh = false) {
 
 // src/mcp/tools/state-snapshot.ts
 var inFlight = null;
-async function getStateSnapshot() {
+var latestState = null;
+var StateUnavailableError = class extends Error {
+  constructor(message, cause) {
+    super(message);
+    this.name = "StateUnavailableError";
+    if (cause !== void 0) {
+      this.cause = cause;
+    }
+  }
+};
+function isStateUnavailableError(error) {
+  return error instanceof StateUnavailableError;
+}
+function getStateSnapshotSync() {
+  return latestState;
+}
+async function refreshStateSnapshot(forceRefresh = false) {
   if (inFlight) return inFlight;
-  inFlight = initState(false).finally(() => {
+  inFlight = (async () => {
+    try {
+      const state = await initState(forceRefresh);
+      latestState = state;
+      return state;
+    } catch (error) {
+      if (latestState) return latestState;
+      throw new StateUnavailableError("Oscar64 source state unavailable.", error);
+    }
+  })().finally(() => {
     inFlight = null;
   });
   return inFlight;
 }
+async function getStateSnapshot() {
+  if (latestState) return latestState;
+  return refreshStateSnapshot(false);
+}
 
 // src/mcp/tools/list-indexes.tool.ts
 async function executeListIndexes(context) {
@@ -1535,7 +1564,18 @@ var listIndexesTool = createTool({
   execute: async ({ context }) => {
     try {
       return await executeListIndexes(context);
-    } catch {
+    } catch (error) {
+      if (isStateUnavailableError(error)) {
+        return {
+          ok: false,
+          error: {
+            code: "OFFLINE",
+            message: "list_indexes unavailable while sources are offline.",
+            hint: "Ensure network access to GitHub or warm cache under ~/.cache/oscar-mcp, then retry.",
+            recoverable: true
+          }
+        };
+      }
       return {
         ok: false,
         error: {
@@ -1684,7 +1724,18 @@ var readUriTool = createTool2({
   execute: async ({ context }) => {
     try {
       return await executeReadUri(context);
-    } catch {
+    } catch (error) {
+      if (isStateUnavailableError(error)) {
+        return {
+          ok: false,
+          error: {
+            code: "OFFLINE",
+            message: "read_uri unavailable while sources are offline.",
+            hint: "Ensure network access to GitHub or warm cache under ~/.cache/oscar-mcp, then retry.",
+            recoverable: true
+          }
+        };
+      }
       return {
         ok: false,
         error: {
@@ -2089,7 +2140,18 @@ var searchTool = createTool3({
   execute: async ({ context }) => {
     try {
       return await executeSearch(context);
-    } catch {
+    } catch (error) {
+      if (isStateUnavailableError(error)) {
+        return {
+          ok: false,
+          error: {
+            code: "OFFLINE",
+            message: "Search unavailable while sources are offline.",
+            hint: "Ensure network access to GitHub or warm cache under ~/.cache/oscar-mcp, then retry.",
+            recoverable: true
+          }
+        };
+      }
       return {
         ok: false,
         error: {
@@ -2123,10 +2185,14 @@ var PACKAGE_VERSION = (() => {
   return "0.0.0";
 })();
 async function createOscarMcpServer(initialForceRefresh = false) {
-  let state = await initState(initialForceRefresh);
-  const getState = () => state;
+  await refreshStateSnapshot(initialForceRefresh);
+  const getState = () => {
+    const state = getStateSnapshotSync();
+    if (!state) throw new Error("Oscar64 state not initialized.");
+    return state;
+  };
   const refreshState = async (force = false) => {
-    state = await initState(force);
+    await refreshStateSnapshot(force);
   };
   let refreshInFlight = null;
   const scheduleRefresh = () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oscar64-mcp-docs",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "private": false,
   "type": "module",
   "files": [