@dudamel/mcp-context 0.1.0 → 2026.917.2

package/dist/mirror-backend.d.ts

@@ -0,0 +1,61 @@
+import type { GrepRequest, FindRequest } from './context-client.js';
+import type { ContextBackend, ContextHttpBackend } from './context-backend.js';
+import type { DirectoryCatalog, FileReadResponse, GrepHit, LocalCacheConfig, ReadCsvResponse, ReadSectionResponse, ReadYamlResponse, SearchResult, StatResponse, TailResponse, TreeResponse } from './types.js';
+/**
+ * Read-only local mirror of the VFS (proxy mode, `cache: local`). Answers tool
+ * calls from an on-disk copy using the same @dudamel/vfs-search primitives the
+ * context-server runs (so results are byte-identical), and falls back to the HTTP
+ * client for anything not yet mirrored. The mirror is kept fresh by polling
+ * `GET /manifest` and diffing per-file content hashes — downloading only what
+ * changed, deleting what's gone. Stale-while-revalidate: a poll never blocks a
+ * tool call; the current mirror is served while a refresh runs in the background.
+ */
+export declare class MirrorContextBackend implements ContextBackend {
+    private readonly http;
+    private readonly mirrorDir;
+    private readonly statePath;
+    private readonly ttlMs;
+    private readonly maxBytes;
+    /** entry path -> applied digest (files materialized on disk). */
+    private readonly applied;
+    /** entries that contain an un-mirrorable file (>1 MiB) — always served via HTTP for parity. */
+    private readonly proxyOnly;
+    private lastManifest;
+    private lastManifestAt;
+    private refreshing;
+    private disabled;
+    constructor(http: ContextHttpBackend, cache: LocalCacheConfig);
+    private loadState;
+    private saveState;
+    /** Synchronously bring the mirror up to date (pre-warm; also used by tests). */
+    warm(): Promise<void>;
+    /** Kick off a background refresh if the manifest is stale. Never blocks. */
+    private ensureFresh;
+    private refresh;
+    private refreshEntry;
+    private markProxyOnly;
+    /** Fetch one file over HTTP and write it into the mirror atomically. */
+    private downloadFile;
+    /** Top-level entry name for a VFS path ("src/foo/bar.md" -> "src"). */
+    private entryOf;
+    /** Can this path be answered from the mirror? (undefined = whole-VFS op). */
+    private canServe;
+    /** Whole-VFS reads (unscoped grep/find) need every current entry mirrored. */
+    private fullyWarm;
+    grep(req: GrepRequest): Promise<SearchResult<GrepHit>>;
+    find(req: FindRequest): Promise<SearchResult<string>>;
+    stat(path: string): Promise<StatResponse>;
+    tree(path?: string, maxDepth?: number): Promise<TreeResponse>;
+    tail(path: string, lines?: number): Promise<TailResponse>;
+    readSection(path: string, heading?: string): Promise<ReadSectionResponse>;
+    readYaml(path: string, keyPath?: string): Promise<ReadYamlResponse>;
+    readCsv(path: string, opts?: {
+        filterColumn?: string;
+        filterValue?: string;
+        columns?: string[];
+        maxRows?: number;
+    }): Promise<ReadCsvResponse>;
+    readFile(vfsPath: string): Promise<FileReadResponse>;
+    readDirectoryCatalog(dirPath: string): Promise<DirectoryCatalog>;
+}
+//# sourceMappingURL=mirror-backend.d.ts.map

package/dist/mirror-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mirror-backend.d.ts","sourceRoot":"","sources":["../src/mirror-backend.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,KAAK,EAEV,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,gBAAgB,EAEhB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAC;AAiBpB;;;;;;;;GAQG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,iEAAiE;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,+FAA+F;IAC/F,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,QAAQ,CAAS;gBAEb,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,gBAAgB;IAW7D,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,SAAS;IAiBjB,gFAAgF;IAC1E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,4EAA4E;IAC5E,OAAO,CAAC,WAAW;YAcL,OAAO;YA8CP,YAAY;IA2C1B,OAAO,CAAC,aAAa;IAMrB,wEAAwE;YAC1D,YAAY;IAW1B,uEAAuE;IACvE,OAAO,CAAC,OAAO;IAIf,6EAA6E;IAC7E,OAAO,CAAC,QAAQ;IAOhB,8EAA8E;IAC9E,OAAO,CAAC,SAAS;IASX,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAYtD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAWrD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAMzC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAM7D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAMzD,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAMzE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAMnE,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3F,OAAO,CAAC,eAAe,CAAC;IAMrB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkBpD,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAUvE"}

package/dist/mirror-backend.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mirror-backend.test.d.ts.map

package/dist/mirror-backend.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mirror-backend.test.d.ts","sourceRoot":"","sources":["../src/mirror-backend.test.ts"],"names":[],"mappings":""}

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAiEnD,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CA8BtF"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAepE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAoEnD,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CAoCtF"}

package/dist/stdio-server.d.ts

@@ -11,6 +11,18 @@
  *
  *   2. Direct (internal, inside the compose network):
  *        DUDAMEL_CONTEXT_SERVER_URL — defaults to http://context-server:3001
+ *
+ * Local cache (proxy mode only — off by default):
+ *   DUDAMEL_CONTEXT_CACHE=local      — keep a read-only on-disk mirror of the VFS
+ *                                      and answer tool calls from it (grep/read/…
+ *                                      become local instead of a round-trip). Falls
+ *                                      back to HTTP for anything not yet mirrored.
+ *   DUDAMEL_CONTEXT_CACHE_DIR        — mirror location (default: XDG cache home,
+ *                                      keyed by API URL + agent; OS temp as last resort).
+ *   DUDAMEL_CONTEXT_CACHE_TTL_SECONDS   — manifest re-check interval (default 60).
+ *   DUDAMEL_CONTEXT_CACHE_MAX_BYTES     — total mirror size cap (default 512 MiB;
+ *                                      a larger VFS disables the cache).
+ * Ignored in direct mode (in-cluster the context-server is one hop away).
  */
 export {};
 //# sourceMappingURL=stdio-server.d.ts.map

package/dist/stdio-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stdio-server.d.ts","sourceRoot":"","sources":["../src/stdio-server.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG"}
+{"version":3,"file":"stdio-server.d.ts","sourceRoot":"","sources":["../src/stdio-server.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG"}