@contractspec/lib.knowledge 1.56.1 → 1.58.0

package/dist/node/retriever/vector-retriever.js

@@ -0,0 +1,58 @@
+// src/retriever/vector-retriever.ts
+class VectorRetriever {
+  config;
+  spaceCollections;
+  staticContent;
+  constructor(config) {
+    this.config = config;
+    this.spaceCollections = config.spaceCollections instanceof Map ? config.spaceCollections : new Map(Object.entries(config.spaceCollections));
+    this.staticContent = config.staticContent ? config.staticContent instanceof Map ? config.staticContent : new Map(Object.entries(config.staticContent)) : new Map;
+  }
+  async retrieve(query, options) {
+    const collection = this.spaceCollections.get(options.spaceKey);
+    if (!collection) {
+      return [];
+    }
+    const embedding = await this.config.embeddings.embedQuery(query);
+    const results = await this.config.vectorStore.search({
+      collection,
+      vector: embedding.vector,
+      topK: options.topK ?? this.config.defaultTopK ?? 5,
+      namespace: options.tenantId,
+      filter: options.filter
+    });
+    const minScore = options.minScore ?? this.config.defaultMinScore ?? 0;
+    const filtered = results.filter((r) => r.score >= minScore);
+    return filtered.map((result) => ({
+      content: this.extractContent(result.payload),
+      source: result.id,
+      score: result.score,
+      metadata: result.payload
+    }));
+  }
+  async getStatic(spaceKey) {
+    return this.staticContent.get(spaceKey) ?? null;
+  }
+  supportsSpace(spaceKey) {
+    return this.spaceCollections.has(spaceKey);
+  }
+  listSpaces() {
+    return [...this.spaceCollections.keys()];
+  }
+  extractContent(payload) {
+    if (!payload)
+      return "";
+    if (typeof payload.text === "string")
+      return payload.text;
+    if (typeof payload.content === "string")
+      return payload.content;
+    return JSON.stringify(payload);
+  }
+}
+function createVectorRetriever(config) {
+  return new VectorRetriever(config);
+}
+export {
+  createVectorRetriever,
+  VectorRetriever
+};

package/dist/query/index.d.ts

@@ -1,2 +1,2 @@
-import { KnowledgeAnswer, KnowledgeQueryConfig, KnowledgeQueryService } from "./service.js";
-export { KnowledgeAnswer, KnowledgeQueryConfig, KnowledgeQueryService };
+export * from './service';
+//# sourceMappingURL=index.d.ts.map

package/dist/query/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}

package/dist/query/index.js

@@ -1,3 +1,80 @@
-import { KnowledgeQueryService } from "./service.js";
+// @bun
+// src/query/service.ts
+class KnowledgeQueryService {
+  embeddings;
+  vectorStore;
+  llm;
+  config;
+  constructor(embeddings, vectorStore, llm, config) {
+    this.embeddings = embeddings;
+    this.vectorStore = vectorStore;
+    this.llm = llm;
+    this.config = config;
+  }
+  async query(question) {
+    const embedding = await this.embeddings.embedQuery(question);
+    const results = await this.vectorStore.search({
+      collection: this.config.collection,
+      vector: embedding.vector,
+      topK: this.config.topK ?? 5,
+      namespace: this.config.namespace,
+      filter: undefined
+    });
+    const context = buildContext(results);
+    const messages = this.buildMessages(question, context);
+    const response = await this.llm.chat(messages);
+    return {
+      answer: response.message.content.map((part) => ("text" in part) ? part.text : "").join(""),
+      references: results.map((result) => ({
+        ...result,
+        text: extractText(result)
+      })),
+      usage: response.usage
+    };
+  }
+  buildMessages(question, context) {
+    const systemPrompt = this.config.systemPrompt ?? "You are a knowledge assistant that answers questions using the provided context. Cite relevant sources if possible.";
+    return [
+      {
+        role: "system",
+        content: [{ type: "text", text: systemPrompt }]
+      },
+      {
+        role: "user",
+        content: [
+          {
+            type: "text",
+            text: `Question:
+${question}
 
-export { KnowledgeQueryService };
+Context:
+${context}`
+          }
+        ]
+      }
+    ];
+  }
+}
+function buildContext(results) {
+  if (results.length === 0) {
+    return "No relevant documents found.";
+  }
+  return results.map((result, index) => {
+    const text = extractText(result);
+    return `Source ${index + 1} (score: ${result.score.toFixed(3)}):
+${text}`;
+  }).join(`
+
+`);
+}
+function extractText(result) {
+  const payload = result.payload ?? {};
+  if (typeof payload.text === "string")
+    return payload.text;
+  if (typeof payload.content === "string")
+    return payload.content;
+  return JSON.stringify(payload);
+}
+export {
+  KnowledgeQueryService
+};

package/dist/query/service.d.ts

@@ -1,28 +1,24 @@
-import { EmbeddingProvider, LLMProvider, LLMResponse, VectorSearchResult, VectorStoreProvider } from "@contractspec/lib.contracts";
-
-//#region src/query/service.d.ts
-interface KnowledgeQueryConfig {
-  collection: string;
-  namespace?: string;
-  topK?: number;
-  systemPrompt?: string;
+import type { EmbeddingProvider, VectorStoreProvider, VectorSearchResult, LLMProvider, LLMResponse } from '@contractspec/lib.contracts';
+export interface KnowledgeQueryConfig {
+    collection: string;
+    namespace?: string;
+    topK?: number;
+    systemPrompt?: string;
 }
-interface KnowledgeAnswer {
-  answer: string;
-  references: (VectorSearchResult & {
-    text?: string;
-  })[];
-  usage?: LLMResponse['usage'];
+export interface KnowledgeAnswer {
+    answer: string;
+    references: (VectorSearchResult & {
+        text?: string;
+    })[];
+    usage?: LLMResponse['usage'];
 }
-declare class KnowledgeQueryService {
-  private readonly embeddings;
-  private readonly vectorStore;
-  private readonly llm;
-  private readonly config;
-  constructor(embeddings: EmbeddingProvider, vectorStore: VectorStoreProvider, llm: LLMProvider, config: KnowledgeQueryConfig);
-  query(question: string): Promise<KnowledgeAnswer>;
-  private buildMessages;
+export declare class KnowledgeQueryService {
+    private readonly embeddings;
+    private readonly vectorStore;
+    private readonly llm;
+    private readonly config;
+    constructor(embeddings: EmbeddingProvider, vectorStore: VectorStoreProvider, llm: LLMProvider, config: KnowledgeQueryConfig);
+    query(question: string): Promise<KnowledgeAnswer>;
+    private buildMessages;
 }
-//#endregion
-export { KnowledgeAnswer, KnowledgeQueryConfig, KnowledgeQueryService };
 //# sourceMappingURL=service.d.ts.map

package/dist/query/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","names":[],"sources":["../../src/query/service.ts"],"sourcesContent":[],"mappings":";;;UASiB,oBAAA;;EAAA,SAAA,CAAA,EAAA,MAAA;EAOA,IAAA,CAAA,EAAA,MAAA;EAQJ,YAAA,CAAA,EAAA,MAAA;;AAQI,UAhBA,eAAA,CAgBA;EACR,MAAA,EAAA,MAAA;EACG,UAAA,EAAA,CAhBG,kBAgBH,GAAA;IAQ6B,IAAA,CAAA,EAAA,MAAA;EAAR,CAAA,CAAA,EAAA;EAAO,KAAA,CAAA,EArB9B,WAqB8B,CAAA,OAAA,CAAA;;cAlB3B,qBAAA;;;;;0BAOG,gCACC,0BACR,qBACG;2BAQqB,QAAQ"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/query/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EAEX,WAAW,EACZ,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,CAAC,kBAAkB,GAAG;QAChC,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,EAAE,CAAC;IACL,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CAC9B;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAClD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;gBAG5C,UAAU,EAAE,iBAAiB,EAC7B,WAAW,EAAE,mBAAmB,EAChC,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,oBAAoB;IAQxB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAwBvD,OAAO,CAAC,aAAa;CAoBtB"}

package/dist/query/service.js

@@ -1,66 +1,80 @@
-//#region src/query/service.ts
-var KnowledgeQueryService = class {
-	embeddings;
-	vectorStore;
-	llm;
-	config;
-	constructor(embeddings, vectorStore, llm, config) {
-		this.embeddings = embeddings;
-		this.vectorStore = vectorStore;
-		this.llm = llm;
-		this.config = config;
-	}
-	async query(question) {
-		const embedding = await this.embeddings.embedQuery(question);
-		const results = await this.vectorStore.search({
-			collection: this.config.collection,
-			vector: embedding.vector,
-			topK: this.config.topK ?? 5,
-			namespace: this.config.namespace,
-			filter: void 0
-		});
-		const context = buildContext(results);
-		const messages = this.buildMessages(question, context);
-		const response = await this.llm.chat(messages);
-		return {
-			answer: response.message.content.map((part) => "text" in part ? part.text : "").join(""),
-			references: results.map((result) => ({
-				...result,
-				text: extractText(result)
-			})),
-			usage: response.usage
-		};
-	}
-	buildMessages(question, context) {
-		return [{
-			role: "system",
-			content: [{
-				type: "text",
-				text: this.config.systemPrompt ?? "You are a knowledge assistant that answers questions using the provided context. Cite relevant sources if possible."
-			}]
-		}, {
-			role: "user",
-			content: [{
-				type: "text",
-				text: `Question:\n${question}\n\nContext:\n${context}`
-			}]
-		}];
-	}
-};
+// @bun
+// src/query/service.ts
+class KnowledgeQueryService {
+  embeddings;
+  vectorStore;
+  llm;
+  config;
+  constructor(embeddings, vectorStore, llm, config) {
+    this.embeddings = embeddings;
+    this.vectorStore = vectorStore;
+    this.llm = llm;
+    this.config = config;
+  }
+  async query(question) {
+    const embedding = await this.embeddings.embedQuery(question);
+    const results = await this.vectorStore.search({
+      collection: this.config.collection,
+      vector: embedding.vector,
+      topK: this.config.topK ?? 5,
+      namespace: this.config.namespace,
+      filter: undefined
+    });
+    const context = buildContext(results);
+    const messages = this.buildMessages(question, context);
+    const response = await this.llm.chat(messages);
+    return {
+      answer: response.message.content.map((part) => ("text" in part) ? part.text : "").join(""),
+      references: results.map((result) => ({
+        ...result,
+        text: extractText(result)
+      })),
+      usage: response.usage
+    };
+  }
+  buildMessages(question, context) {
+    const systemPrompt = this.config.systemPrompt ?? "You are a knowledge assistant that answers questions using the provided context. Cite relevant sources if possible.";
+    return [
+      {
+        role: "system",
+        content: [{ type: "text", text: systemPrompt }]
+      },
+      {
+        role: "user",
+        content: [
+          {
+            type: "text",
+            text: `Question:
+${question}
+
+Context:
+${context}`
+          }
+        ]
+      }
+    ];
+  }
+}
 function buildContext(results) {
-	if (results.length === 0) return "No relevant documents found.";
-	return results.map((result, index) => {
-		const text = extractText(result);
-		return `Source ${index + 1} (score: ${result.score.toFixed(3)}):\n${text}`;
-	}).join("\n\n");
+  if (results.length === 0) {
+    return "No relevant documents found.";
+  }
+  return results.map((result, index) => {
+    const text = extractText(result);
+    return `Source ${index + 1} (score: ${result.score.toFixed(3)}):
+${text}`;
+  }).join(`
+
+`);
 }
 function extractText(result) {
-	const payload = result.payload ?? {};
-	if (typeof payload.text === "string") return payload.text;
-	if (typeof payload.content === "string") return payload.content;
-	return JSON.stringify(payload);
+  const payload = result.payload ?? {};
+  if (typeof payload.text === "string")
+    return payload.text;
+  if (typeof payload.content === "string")
+    return payload.content;
+  return JSON.stringify(payload);
 }
-
-//#endregion
-export { KnowledgeQueryService };
-//# sourceMappingURL=service.js.map
+export {
+  KnowledgeQueryService
+};

package/dist/retriever/index.d.ts

@@ -1,4 +1,4 @@
-import { KnowledgeRetriever, RetrieverConfig } from "./interface.js";
-import { StaticRetriever, StaticRetrieverConfig, createStaticRetriever } from "./static-retriever.js";
-import { VectorRetriever, VectorRetrieverConfig, createVectorRetriever } from "./vector-retriever.js";
-export { KnowledgeRetriever, RetrieverConfig, StaticRetriever, StaticRetrieverConfig, VectorRetriever, VectorRetrieverConfig, createStaticRetriever, createVectorRetriever };
+export * from './interface';
+export * from './static-retriever';
+export * from './vector-retriever';
+//# sourceMappingURL=index.d.ts.map

package/dist/retriever/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retriever/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

package/dist/retriever/index.js

@@ -1,4 +1,101 @@
-import { StaticRetriever, createStaticRetriever } from "./static-retriever.js";
-import { VectorRetriever, createVectorRetriever } from "./vector-retriever.js";
+// @bun
+// src/retriever/static-retriever.ts
+class StaticRetriever {
+  content;
+  constructor(config) {
+    this.content = config.content instanceof Map ? config.content : new Map(Object.entries(config.content));
+  }
+  async retrieve(query, options) {
+    const content = this.content.get(options.spaceKey);
+    if (!content)
+      return [];
+    const queryLower = query.toLowerCase();
+    const lines = content.split(`
+`).filter((line) => line.trim());
+    const results = [];
+    for (const line of lines) {
+      if (line.toLowerCase().includes(queryLower)) {
+        results.push({
+          content: line,
+          source: options.spaceKey,
+          score: 1,
+          metadata: { type: "static" }
+        });
+      }
+    }
+    return results.slice(0, options.topK ?? 5);
+  }
+  async getStatic(spaceKey) {
+    return this.content.get(spaceKey) ?? null;
+  }
+  supportsSpace(spaceKey) {
+    return this.content.has(spaceKey);
+  }
+  listSpaces() {
+    return [...this.content.keys()];
+  }
+}
+function createStaticRetriever(content) {
+  return new StaticRetriever({ content });
+}
 
-export { StaticRetriever, VectorRetriever, createStaticRetriever, createVectorRetriever };
+// src/retriever/vector-retriever.ts
+class VectorRetriever {
+  config;
+  spaceCollections;
+  staticContent;
+  constructor(config) {
+    this.config = config;
+    this.spaceCollections = config.spaceCollections instanceof Map ? config.spaceCollections : new Map(Object.entries(config.spaceCollections));
+    this.staticContent = config.staticContent ? config.staticContent instanceof Map ? config.staticContent : new Map(Object.entries(config.staticContent)) : new Map;
+  }
+  async retrieve(query, options) {
+    const collection = this.spaceCollections.get(options.spaceKey);
+    if (!collection) {
+      return [];
+    }
+    const embedding = await this.config.embeddings.embedQuery(query);
+    const results = await this.config.vectorStore.search({
+      collection,
+      vector: embedding.vector,
+      topK: options.topK ?? this.config.defaultTopK ?? 5,
+      namespace: options.tenantId,
+      filter: options.filter
+    });
+    const minScore = options.minScore ?? this.config.defaultMinScore ?? 0;
+    const filtered = results.filter((r) => r.score >= minScore);
+    return filtered.map((result) => ({
+      content: this.extractContent(result.payload),
+      source: result.id,
+      score: result.score,
+      metadata: result.payload
+    }));
+  }
+  async getStatic(spaceKey) {
+    return this.staticContent.get(spaceKey) ?? null;
+  }
+  supportsSpace(spaceKey) {
+    return this.spaceCollections.has(spaceKey);
+  }
+  listSpaces() {
+    return [...this.spaceCollections.keys()];
+  }
+  extractContent(payload) {
+    if (!payload)
+      return "";
+    if (typeof payload.text === "string")
+      return payload.text;
+    if (typeof payload.content === "string")
+      return payload.content;
+    return JSON.stringify(payload);
+  }
+}
+function createVectorRetriever(config) {
+  return new VectorRetriever(config);
+}
+export {
+  createVectorRetriever,
+  createStaticRetriever,
+  VectorRetriever,
+  StaticRetriever
+};

package/dist/retriever/interface.d.ts

@@ -1,7 +1,4 @@
-import { RetrievalOptions, RetrievalResult } from "../types.js";
-
-//#region src/retriever/interface.d.ts
-
+import type { RetrievalResult, RetrievalOptions } from '../types';
 /**
  * Unified interface for knowledge retrieval.
  *
@@ -9,48 +6,46 @@ import { RetrievalOptions, RetrievalResult } from "../types.js";
  * This interface is consumed by @contractspec/lib.ai-agent for both static injection
  * and dynamic RAG tool queries.
  */
-interface KnowledgeRetriever {
-  /**
-   * Retrieve relevant content for a query using semantic search.
-   *
-   * @param query - The search query or question
-   * @param options - Retrieval options including space key and filters
-   * @returns Array of retrieval results sorted by relevance
-   */
-  retrieve(query: string, options: RetrievalOptions): Promise<RetrievalResult[]>;
-  /**
-   * Get static content by space key (for required knowledge injection).
-   *
-   * Used for injecting required knowledge into agent system prompts
-   * without performing semantic search.
-   *
-   * @param spaceKey - The knowledge space key
-   * @returns The static content or null if not available
-   */
-  getStatic(spaceKey: string): Promise<string | null>;
-  /**
-   * Check if this retriever supports a given knowledge space.
-   *
-   * @param spaceKey - The knowledge space key to check
-   * @returns True if the space is supported
-   */
-  supportsSpace(spaceKey: string): boolean;
-  /**
-   * List all supported knowledge space keys.
-   *
-   * @returns Array of supported space keys
-   */
-  listSpaces(): string[];
+export interface KnowledgeRetriever {
+    /**
+     * Retrieve relevant content for a query using semantic search.
+     *
+     * @param query - The search query or question
+     * @param options - Retrieval options including space key and filters
+     * @returns Array of retrieval results sorted by relevance
+     */
+    retrieve(query: string, options: RetrievalOptions): Promise<RetrievalResult[]>;
+    /**
+     * Get static content by space key (for required knowledge injection).
+     *
+     * Used for injecting required knowledge into agent system prompts
+     * without performing semantic search.
+     *
+     * @param spaceKey - The knowledge space key
+     * @returns The static content or null if not available
+     */
+    getStatic(spaceKey: string): Promise<string | null>;
+    /**
+     * Check if this retriever supports a given knowledge space.
+     *
+     * @param spaceKey - The knowledge space key to check
+     * @returns True if the space is supported
+     */
+    supportsSpace(spaceKey: string): boolean;
+    /**
+     * List all supported knowledge space keys.
+     *
+     * @returns Array of supported space keys
+     */
+    listSpaces(): string[];
 }
 /**
  * Configuration for creating a retriever.
  */
-interface RetrieverConfig {
-  /** Default number of results to return */
-  defaultTopK?: number;
-  /** Default minimum score threshold */
-  defaultMinScore?: number;
+export interface RetrieverConfig {
+    /** Default number of results to return */
+    defaultTopK?: number;
+    /** Default minimum score threshold */
+    defaultMinScore?: number;
 }
-//#endregion
-export { KnowledgeRetriever, RetrieverConfig };
 //# sourceMappingURL=interface.d.ts.map

package/dist/retriever/interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interface.d.ts","names":[],"sources":["../../src/retriever/interface.ts"],"sourcesContent":[],"mappings":";;;;;;AASA;;;;;AAsBsC,UAtBrB,kBAAA,CAsBqB;EAqBrB;;;;;;;mCAjCJ,mBACR,QAAQ;;;;;;;;;;+BAWkB;;;;;;;;;;;;;;;;;;UAqBd,eAAA"}
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/retriever/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,QAAQ,CACN,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAE9B;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEpD;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAEzC;;;;OAIG;IACH,UAAU,IAAI,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/retriever/interface.js

@@ -0,0 +1 @@
+// @bun

package/dist/retriever/static-retriever.d.ts

@@ -1,14 +1,11 @@
-import { RetrievalOptions, RetrievalResult } from "../types.js";
-import { KnowledgeRetriever, RetrieverConfig } from "./interface.js";
-
-//#region src/retriever/static-retriever.d.ts
-
+import type { RetrievalResult, RetrievalOptions } from '../types';
+import type { KnowledgeRetriever, RetrieverConfig } from './interface';
 /**
  * Configuration for the static retriever.
  */
-interface StaticRetrieverConfig extends RetrieverConfig {
-  /** Map of space key to static content */
-  content: Map<string, string> | Record<string, string>;
+export interface StaticRetrieverConfig extends RetrieverConfig {
+    /** Map of space key to static content */
+    content: Map<string, string> | Record<string, string>;
 }
 /**
  * A simple in-memory retriever for static knowledge content.
@@ -18,18 +15,16 @@ interface StaticRetrieverConfig extends RetrieverConfig {
  * - Testing and development
  * - Small knowledge bases that fit in memory
  */
-declare class StaticRetriever implements KnowledgeRetriever {
-  private readonly content;
-  constructor(config: StaticRetrieverConfig);
-  retrieve(query: string, options: RetrievalOptions): Promise<RetrievalResult[]>;
-  getStatic(spaceKey: string): Promise<string | null>;
-  supportsSpace(spaceKey: string): boolean;
-  listSpaces(): string[];
+export declare class StaticRetriever implements KnowledgeRetriever {
+    private readonly content;
+    constructor(config: StaticRetrieverConfig);
+    retrieve(query: string, options: RetrievalOptions): Promise<RetrievalResult[]>;
+    getStatic(spaceKey: string): Promise<string | null>;
+    supportsSpace(spaceKey: string): boolean;
+    listSpaces(): string[];
 }
 /**
  * Create a static retriever from a content map.
  */
-declare function createStaticRetriever(content: Record<string, string> | Map<string, string>): StaticRetriever;
-//#endregion
-export { StaticRetriever, StaticRetrieverConfig, createStaticRetriever };
+export declare function createStaticRetriever(content: Record<string, string> | Map<string, string>): StaticRetriever;
 //# sourceMappingURL=static-retriever.d.ts.map

package/dist/retriever/static-retriever.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"static-retriever.d.ts","names":[],"sources":["../../src/retriever/static-retriever.ts"],"sourcesContent":[],"mappings":";;;;;;;AAMA;AAEW,UAFM,qBAAA,SAA8B,eAEpC,CAAA;EAAsB;EAFc,OAAA,EAEpC,GAFoC,CAAA,MAAA,EAAA,MAAA,CAAA,GAEd,MAFc,CAAA,MAAA,EAAA,MAAA,CAAA;;AAa/C;;;;;;;;AAoDgB,cApDH,eAAA,YAA2B,kBAoDH,CAAA;EAC1B,iBAAA,OAAA;EAAyB,WAAA,CAAA,MAAA,EAlDd,qBAkDc;EACjC,QAAA,CAAA,KAAA,EAAA,MAAA,EAAA,OAAA,EA1CU,gBA0CV,CAAA,EAzCE,OAyCF,CAzCU,eAyCV,EAAA,CAAA;EAAe,SAAA,CAAA,QAAA,EAAA,MAAA,CAAA,EAlBmB,OAkBnB,CAAA,MAAA,GAAA,IAAA,CAAA;;;;;;;iBAFF,qBAAA,UACL,yBAAyB,sBACjC"}
+{"version":3,"file":"static-retriever.d.ts","sourceRoot":"","sources":["../../src/retriever/static-retriever.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,yCAAyC;IACzC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvD;AAED;;;;;;;GAOG;AACH,qBAAa,eAAgB,YAAW,kBAAkB;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;gBAElC,MAAM,EAAE,qBAAqB;IAOnC,QAAQ,CACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,EAAE,CAAC;IAuBvB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIzD,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIxC,UAAU,IAAI,MAAM,EAAE;CAGvB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACpD,eAAe,CAEjB"}