@dudamel/mcp-context 0.1.0 → 2026.917.2

package/dist/annotations.test.d.ts

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

package/dist/annotations.test.d.ts.map

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

package/dist/cache-dir.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Where the local VFS mirror lives (Plan 52 Parte B).
+ *
+ * Keyed by the base URL so two Dudamel deployments don't share a mirror, AND by the agent
+ * name: since Plan 52 A.3 a Claude Code session runs one context server per installed agent,
+ * all pointing at the same instance. Without the agent in the key they would race over one
+ * mirror's `state.json`. It is also the right key for what comes next — per-agent/role path
+ * scoping would make those mirrors genuinely different VFSs.
+ *
+ * Honors DUDAMEL_CONTEXT_CACHE_DIR, else XDG cache home, else the OS temp dir (Windows /
+ * locked-down homes).
+ */
+export declare function resolveCacheDir(baseUrl: string, agentName?: string): string;
+//# sourceMappingURL=cache-dir.d.ts.map

package/dist/cache-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-dir.d.ts","sourceRoot":"","sources":["../src/cache-dir.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ3E"}

package/dist/cache-dir.test.d.ts

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

package/dist/cache-dir.test.d.ts.map

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

package/dist/context-backend.d.ts

@@ -0,0 +1,36 @@
+import type { GrepRequest, FindRequest } from './context-client.js';
+import type { ContextManifest, DirectoryCatalog, FileReadResponse, GrepHit, ReadCsvResponse, ReadSectionResponse, ReadYamlResponse, SearchResult, StatResponse, TailResponse, TreeResponse } from './types.js';
+/**
+ * The read surface the MCP tools depend on. Two implementations:
+ *   - {@link ContextServerClient} — talks to the context-server over HTTP.
+ *   - MirrorContextBackend — answers from a local on-disk mirror (proxy mode,
+ *     `cache: local`), falling back to the HTTP client when a source isn't
+ *     mirrored yet. Both return byte-identical shapes because the local one
+ *     runs the same @dudamel/vfs-search primitives the context-server runs.
+ */
+export interface ContextBackend {
+    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>;
+}
+/**
+ * The HTTP backend the local mirror sits in front of: the full read surface plus
+ * the manifest fetch it polls to detect changes. {@link ContextServerClient}
+ * implements it; tests supply a fake.
+ */
+export interface ContextHttpBackend extends ContextBackend {
+    getManifest(): Promise<ContextManifest>;
+}
+//# sourceMappingURL=context-backend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context-backend.d.ts","sourceRoot":"","sources":["../src/context-backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IACtD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1D,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACpE,OAAO,CACL,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,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrD,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAClE;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;CACzC"}

package/dist/context-client.d.ts

@@ -1,4 +1,5 @@
-import type { DirectoryCatalog, FileReadResponse, GrepHit, ReadCsvResponse, ReadSectionResponse, ReadYamlResponse, SearchResult, StatResponse, TailResponse, TreeResponse } from './types.js';
+import type { ContextBackend } from './context-backend.js';
+import type { ContextManifest, DirectoryCatalog, FileReadResponse, GrepHit, ReadCsvResponse, ReadSectionResponse, ReadYamlResponse, SearchResult, StatResponse, TailResponse, TreeResponse } from './types.js';
 export interface GrepRequest {
     pattern: string;
     path?: string;
@@ -33,7 +34,7 @@ export interface ContextServerClientOptions {
     /** When set, switches to proxy mode and adds Authorization: ApiKey <apiKey>. */
     apiKey?: string;
 }
-export declare class ContextServerClient {
+export declare class ContextServerClient implements ContextBackend {
     private readonly baseUrl;
     private readonly apiKey?;
     private readonly pathPrefix;
@@ -42,6 +43,8 @@ export declare class ContextServerClient {
     private headers;
     private get;
     private post;
+    /** Cheap change-detection digest of the whole VFS (used by the local mirror). */
+    getManifest(): Promise<ContextManifest>;
     grep(req: GrepRequest): Promise<SearchResult<GrepHit>>;
     find(req: FindRequest): Promise<SearchResult<string>>;
     stat(path: string): Promise<StatResponse>;

package/dist/context-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-client.d.ts","sourceRoot":"","sources":["../src/context-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;CAClB;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAGzC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM;gBAFpB,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM;CAKvB;AAED,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,OAAO,EAAE,0BAA0B;IAM/C,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,OAAO;YAMD,GAAG;YAcH,IAAI;IAkBlB,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAItD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAIrD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAIzC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI7D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAIzD,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIzE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAInE,OAAO,CACL,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;IAI3B;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAY1D;;;OAGG;IACG,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAMvE"}
+{"version":3,"file":"context-client.d.ts","sourceRoot":"","sources":["../src/context-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;CAClB;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAGzC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM;gBAFpB,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM;CAKvB;AAED,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,mBAAoB,YAAW,cAAc;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,OAAO,EAAE,0BAA0B;IAM/C,OAAO,CAAC,GAAG;IAMX,OAAO,CAAC,OAAO;YAMD,GAAG;YAcH,IAAI;IAkBlB,iFAAiF;IACjF,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC;IAIvC,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAItD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAIrD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAIzC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI7D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAIzD,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIzE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAInE,OAAO,CACL,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;IAI3B;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAY1D;;;OAGG;IACG,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAMvE"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { createContextServer } from './server.js';
 export { ContextServerClient, ContextServerError } from './context-client.js';
-export type { McpContextConfig, CatalogEntry, DirectoryCatalog, FileReadResponse } from './types.js';
+export type { McpContextConfig, CatalogEntry, DirectoryCatalog, FileReadResponse, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}