@contractspec/lib.knowledge 1.56.1 → 1.58.0

package/dist/retriever/static-retriever.js

@@ -1,48 +1,44 @@
-//#region src/retriever/static-retriever.ts
-/**
-* A simple in-memory retriever for static knowledge content.
-*
-* Useful for:
-* - Required knowledge that doesn't need semantic search
-* - Testing and development
-* - Small knowledge bases that fit in memory
-*/
-var StaticRetriever = class {
-	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("\n").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()];
-	}
-};
-/**
-* Create a static retriever from a content map.
-*/
+// @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 });
+  return new StaticRetriever({ content });
 }
-
-//#endregion
-export { StaticRetriever, createStaticRetriever };
-//# sourceMappingURL=static-retriever.js.map
+export {
+  createStaticRetriever,
+  StaticRetriever
+};

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

@@ -1,21 +1,18 @@
-import { RetrievalOptions, RetrievalResult } from "../types.js";
-import { KnowledgeRetriever, RetrieverConfig } from "./interface.js";
-import { EmbeddingProvider, VectorStoreProvider } from "@contractspec/lib.contracts";
-
-//#region src/retriever/vector-retriever.d.ts
-
+import type { EmbeddingProvider, VectorStoreProvider } from '@contractspec/lib.contracts';
+import type { RetrievalResult, RetrievalOptions } from '../types';
+import type { KnowledgeRetriever, RetrieverConfig } from './interface';
 /**
  * Configuration for the vector retriever.
  */
-interface VectorRetrieverConfig extends RetrieverConfig {
-  /** Embedding provider for query vectorization */
-  embeddings: EmbeddingProvider;
-  /** Vector store provider for similarity search */
-  vectorStore: VectorStoreProvider;
-  /** Map of space key to collection name */
-  spaceCollections: Map<string, string> | Record<string, string>;
-  /** Optional static content for getStatic() calls */
-  staticContent?: Map<string, string> | Record<string, string>;
+export interface VectorRetrieverConfig extends RetrieverConfig {
+    /** Embedding provider for query vectorization */
+    embeddings: EmbeddingProvider;
+    /** Vector store provider for similarity search */
+    vectorStore: VectorStoreProvider;
+    /** Map of space key to collection name */
+    spaceCollections: Map<string, string> | Record<string, string>;
+    /** Optional static content for getStatic() calls */
+    staticContent?: Map<string, string> | Record<string, string>;
 }
 /**
  * A retriever that uses vector similarity search.
@@ -23,21 +20,19 @@ interface VectorRetrieverConfig extends RetrieverConfig {
  * Uses embedding provider to vectorize queries and vector store
  * provider to perform similarity search.
  */
-declare class VectorRetriever implements KnowledgeRetriever {
-  private readonly config;
-  private readonly spaceCollections;
-  private readonly staticContent;
-  constructor(config: VectorRetrieverConfig);
-  retrieve(query: string, options: RetrievalOptions): Promise<RetrievalResult[]>;
-  getStatic(spaceKey: string): Promise<string | null>;
-  supportsSpace(spaceKey: string): boolean;
-  listSpaces(): string[];
-  private extractContent;
+export declare class VectorRetriever implements KnowledgeRetriever {
+    private readonly config;
+    private readonly spaceCollections;
+    private readonly staticContent;
+    constructor(config: VectorRetrieverConfig);
+    retrieve(query: string, options: RetrievalOptions): Promise<RetrievalResult[]>;
+    getStatic(spaceKey: string): Promise<string | null>;
+    supportsSpace(spaceKey: string): boolean;
+    listSpaces(): string[];
+    private extractContent;
 }
 /**
  * Create a vector retriever from configuration.
  */
-declare function createVectorRetriever(config: VectorRetrieverConfig): VectorRetriever;
-//#endregion
-export { VectorRetriever, VectorRetrieverConfig, createVectorRetriever };
+export declare function createVectorRetriever(config: VectorRetrieverConfig): VectorRetriever;
 //# sourceMappingURL=vector-retriever.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"vector-retriever.d.ts","names":[],"sources":["../../src/retriever/vector-retriever.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAUA;AAEc,UAFG,qBAAA,SAA8B,eAEjC,CAAA;EAEC;EAEK,UAAA,EAJN,iBAIM;EAAsB;EAExB,WAAA,EAJH,mBAIG;EAAsB;EARO,gBAAA,EAM3B,GAN2B,CAAA,MAAA,EAAA,MAAA,CAAA,GAML,MANK,CAAA,MAAA,EAAA,MAAA,CAAA;EAAe;EAiBjD,aAAA,CAAA,EATK,GASW,CAAA,MAAA,EAAA,MAAA,CAAA,GATW,MASX,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;AA2Eb,cA3EH,eAAA,YAA2B,kBA6ErC,CAAA;;;;sBAxEmB;mCAeT,mBACR,QAAQ;+BA+BwB;;;;;;;;iBAuBrB,qBAAA,SACN,wBACP"}
+{"version":3,"file":"vector-retriever.d.ts","sourceRoot":"","sources":["../../src/retriever/vector-retriever.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,6BAA6B,CAAC;AACrC,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,iDAAiD;IACjD,UAAU,EAAE,iBAAiB,CAAC;IAC9B,kDAAkD;IAClD,WAAW,EAAE,mBAAmB,CAAC;IACjC,0CAA0C;IAC1C,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/D,oDAAoD;IACpD,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9D;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,kBAAkB;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsB;IACvD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;gBAExC,MAAM,EAAE,qBAAqB;IAanC,QAAQ,CACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,EAAE,CAAC;IA+BvB,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;IAItB,OAAO,CAAC,cAAc;CAMvB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,qBAAqB,GAC5B,eAAe,CAEjB"}

package/dist/retriever/vector-retriever.js

@@ -1,61 +1,59 @@
-//#region src/retriever/vector-retriever.ts
-/**
-* A retriever that uses vector similarity search.
-*
-* Uses embedding provider to vectorize queries and vector store
-* provider to perform similarity search.
-*/
-var VectorRetriever = class {
-	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)) : /* @__PURE__ */ 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;
-		return results.filter((r) => r.score >= minScore).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);
-	}
-};
-/**
-* Create a vector retriever from configuration.
-*/
+// @bun
+// 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);
+  return new VectorRetriever(config);
 }
-
-//#endregion
-export { VectorRetriever, createVectorRetriever };
-//# sourceMappingURL=vector-retriever.js.map
+export {
+  createVectorRetriever,
+  VectorRetriever
+};

package/dist/types.d.ts

@@ -1,56 +1,51 @@
-import { KnowledgeCategory } from "@contractspec/lib.contracts";
-
-//#region src/types.d.ts
-
+import type { KnowledgeCategory } from '@contractspec/lib.contracts';
 /**
  * Result from a knowledge retrieval operation.
  */
-interface RetrievalResult {
-  /** The retrieved content/text */
-  content: string;
-  /** Source identifier (document ID, URL, etc.) */
-  source: string;
-  /** Relevance score (0-1, higher is more relevant) */
-  score: number;
-  /** Additional metadata about the result */
-  metadata?: Record<string, unknown>;
+export interface RetrievalResult {
+    /** The retrieved content/text */
+    content: string;
+    /** Source identifier (document ID, URL, etc.) */
+    source: string;
+    /** Relevance score (0-1, higher is more relevant) */
+    score: number;
+    /** Additional metadata about the result */
+    metadata?: Record<string, unknown>;
 }
 /**
  * Options for knowledge retrieval.
  */
-interface RetrievalOptions {
-  /** Knowledge space key to query */
-  spaceKey: string;
-  /** Maximum number of results to return */
-  topK?: number;
-  /** Minimum relevance score threshold */
-  minScore?: number;
-  /** Filter by knowledge category */
-  category?: KnowledgeCategory;
-  /** Tenant-scoped retrieval */
-  tenantId?: string;
-  /** Additional filter criteria */
-  filter?: Record<string, unknown>;
+export interface RetrievalOptions {
+    /** Knowledge space key to query */
+    spaceKey: string;
+    /** Maximum number of results to return */
+    topK?: number;
+    /** Minimum relevance score threshold */
+    minScore?: number;
+    /** Filter by knowledge category */
+    category?: KnowledgeCategory;
+    /** Tenant-scoped retrieval */
+    tenantId?: string;
+    /** Additional filter criteria */
+    filter?: Record<string, unknown>;
 }
 /**
  * Context for knowledge access operations.
  */
-interface KnowledgeAccessContext {
-  tenantId: string;
-  appId: string;
-  environment?: string;
-  workflowName?: string;
-  agentName?: string;
-  operation: 'read' | 'write' | 'search';
+export interface KnowledgeAccessContext {
+    tenantId: string;
+    appId: string;
+    environment?: string;
+    workflowName?: string;
+    agentName?: string;
+    operation: 'read' | 'write' | 'search';
 }
 /**
  * Result of an access check.
  */
-interface KnowledgeAccessResult {
-  allowed: boolean;
-  reason?: string;
-  severity?: 'error' | 'warning';
+export interface KnowledgeAccessResult {
+    allowed: boolean;
+    reason?: string;
+    severity?: 'error' | 'warning';
 }
-//#endregion
-export { KnowledgeAccessContext, KnowledgeAccessResult, RetrievalOptions, RetrievalResult };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;;AAKA;AAciB,UAdA,eAAA,CAcgB;EAkBhB;EAYA,OAAA,EAAA,MAAA;;;;;;aApCJ;;;;;UAMI,gBAAA;;;;;;;;aAQJ;;;;WAIF;;;;;UAMM,sBAAA;;;;;;;;;;;UAYA,qBAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChC"}

package/dist/types.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.knowledge",
-  "version": "1.56.1",
+  "version": "1.58.0",
   "description": "RAG and knowledge base primitives",
   "keywords": [
     "contractspec",
@@ -18,64 +18,171 @@
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
     "publish:pkg:canary": "bun publish:pkg --tag canary",
-    "build": "bun build:types && bun build:bundle",
-    "build:bundle": "tsdown",
-    "build:types": "tsc --noEmit",
-    "dev": "bun build:bundle --watch",
+    "build": "bun run prebuild && bun run build:bundle && bun run build:types",
+    "build:bundle": "contractspec-bun-build transpile",
+    "build:types": "contractspec-bun-build types",
+    "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
     "lint:fix": "eslint src --fix",
     "lint:check": "eslint src",
-    "test": "bun test"
+    "test": "bun test",
+    "prebuild": "contractspec-bun-build prebuild",
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.contracts": "1.56.1"
+    "@contractspec/lib.contracts": "1.58.0"
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.56.1",
-    "@contractspec/tool.typescript": "1.56.1",
-    "tsdown": "^0.19.0",
-    "typescript": "^5.9.3"
+    "@contractspec/tool.typescript": "1.58.0",
+    "typescript": "^5.9.3",
+    "@contractspec/tool.bun": "1.57.0"
   },
   "exports": {
-    ".": "./dist/index.js",
-    "./access": "./dist/access/index.js",
-    "./access/guard": "./dist/access/guard.js",
-    "./ingestion": "./dist/ingestion/index.js",
-    "./ingestion/document-processor": "./dist/ingestion/document-processor.js",
-    "./ingestion/embedding-service": "./dist/ingestion/embedding-service.js",
-    "./ingestion/gmail-adapter": "./dist/ingestion/gmail-adapter.js",
-    "./ingestion/storage-adapter": "./dist/ingestion/storage-adapter.js",
-    "./ingestion/vector-indexer": "./dist/ingestion/vector-indexer.js",
-    "./query": "./dist/query/index.js",
-    "./query/service": "./dist/query/service.js",
-    "./retriever": "./dist/retriever/index.js",
-    "./retriever/interface": "./dist/retriever/interface.js",
-    "./retriever/static-retriever": "./dist/retriever/static-retriever.js",
-    "./retriever/vector-retriever": "./dist/retriever/vector-retriever.js",
-    "./types": "./dist/types.js",
-    "./*": "./*"
+    ".": "./src/index.ts",
+    "./access": "./src/access/index.ts",
+    "./access/guard": "./src/access/guard.ts",
+    "./access/index": "./src/access/index.ts",
+    "./ingestion": "./src/ingestion/index.ts",
+    "./ingestion/document-processor": "./src/ingestion/document-processor.ts",
+    "./ingestion/embedding-service": "./src/ingestion/embedding-service.ts",
+    "./ingestion/gmail-adapter": "./src/ingestion/gmail-adapter.ts",
+    "./ingestion/index": "./src/ingestion/index.ts",
+    "./ingestion/storage-adapter": "./src/ingestion/storage-adapter.ts",
+    "./ingestion/vector-indexer": "./src/ingestion/vector-indexer.ts",
+    "./query": "./src/query/index.ts",
+    "./query/index": "./src/query/index.ts",
+    "./query/service": "./src/query/service.ts",
+    "./retriever": "./src/retriever/index.ts",
+    "./retriever/index": "./src/retriever/index.ts",
+    "./retriever/interface": "./src/retriever/interface.ts",
+    "./retriever/static-retriever": "./src/retriever/static-retriever.ts",
+    "./retriever/vector-retriever": "./src/retriever/vector-retriever.ts",
+    "./types": "./src/types.ts"
   },
   "publishConfig": {
     "access": "public",
     "exports": {
-      ".": "./dist/index.js",
-      "./access": "./dist/access/index.js",
-      "./access/guard": "./dist/access/guard.js",
-      "./ingestion": "./dist/ingestion/index.js",
-      "./ingestion/document-processor": "./dist/ingestion/document-processor.js",
-      "./ingestion/embedding-service": "./dist/ingestion/embedding-service.js",
-      "./ingestion/gmail-adapter": "./dist/ingestion/gmail-adapter.js",
-      "./ingestion/storage-adapter": "./dist/ingestion/storage-adapter.js",
-      "./ingestion/vector-indexer": "./dist/ingestion/vector-indexer.js",
-      "./query": "./dist/query/index.js",
-      "./query/service": "./dist/query/service.js",
-      "./retriever": "./dist/retriever/index.js",
-      "./retriever/interface": "./dist/retriever/interface.js",
-      "./retriever/static-retriever": "./dist/retriever/static-retriever.js",
-      "./retriever/vector-retriever": "./dist/retriever/vector-retriever.js",
-      "./types": "./dist/types.js",
-      "./*": "./*"
+      ".": {
+        "types": "./dist/index.d.ts",
+        "bun": "./dist/index.js",
+        "node": "./dist/node/index.mjs",
+        "default": "./dist/index.js"
+      },
+      "./access": {
+        "types": "./dist/access/index.d.ts",
+        "bun": "./dist/access/index.js",
+        "node": "./dist/node/access/index.mjs",
+        "default": "./dist/access/index.js"
+      },
+      "./access/guard": {
+        "types": "./dist/access/guard.d.ts",
+        "bun": "./dist/access/guard.js",
+        "node": "./dist/node/access/guard.mjs",
+        "default": "./dist/access/guard.js"
+      },
+      "./access/index": {
+        "types": "./dist/access/index.d.ts",
+        "bun": "./dist/access/index.js",
+        "node": "./dist/node/access/index.mjs",
+        "default": "./dist/access/index.js"
+      },
+      "./ingestion": {
+        "types": "./dist/ingestion/index.d.ts",
+        "bun": "./dist/ingestion/index.js",
+        "node": "./dist/node/ingestion/index.mjs",
+        "default": "./dist/ingestion/index.js"
+      },
+      "./ingestion/document-processor": {
+        "types": "./dist/ingestion/document-processor.d.ts",
+        "bun": "./dist/ingestion/document-processor.js",
+        "node": "./dist/node/ingestion/document-processor.mjs",
+        "default": "./dist/ingestion/document-processor.js"
+      },
+      "./ingestion/embedding-service": {
+        "types": "./dist/ingestion/embedding-service.d.ts",
+        "bun": "./dist/ingestion/embedding-service.js",
+        "node": "./dist/node/ingestion/embedding-service.mjs",
+        "default": "./dist/ingestion/embedding-service.js"
+      },
+      "./ingestion/gmail-adapter": {
+        "types": "./dist/ingestion/gmail-adapter.d.ts",
+        "bun": "./dist/ingestion/gmail-adapter.js",
+        "node": "./dist/node/ingestion/gmail-adapter.mjs",
+        "default": "./dist/ingestion/gmail-adapter.js"
+      },
+      "./ingestion/index": {
+        "types": "./dist/ingestion/index.d.ts",
+        "bun": "./dist/ingestion/index.js",
+        "node": "./dist/node/ingestion/index.mjs",
+        "default": "./dist/ingestion/index.js"
+      },
+      "./ingestion/storage-adapter": {
+        "types": "./dist/ingestion/storage-adapter.d.ts",
+        "bun": "./dist/ingestion/storage-adapter.js",
+        "node": "./dist/node/ingestion/storage-adapter.mjs",
+        "default": "./dist/ingestion/storage-adapter.js"
+      },
+      "./ingestion/vector-indexer": {
+        "types": "./dist/ingestion/vector-indexer.d.ts",
+        "bun": "./dist/ingestion/vector-indexer.js",
+        "node": "./dist/node/ingestion/vector-indexer.mjs",
+        "default": "./dist/ingestion/vector-indexer.js"
+      },
+      "./query": {
+        "types": "./dist/query/index.d.ts",
+        "bun": "./dist/query/index.js",
+        "node": "./dist/node/query/index.mjs",
+        "default": "./dist/query/index.js"
+      },
+      "./query/index": {
+        "types": "./dist/query/index.d.ts",
+        "bun": "./dist/query/index.js",
+        "node": "./dist/node/query/index.mjs",
+        "default": "./dist/query/index.js"
+      },
+      "./query/service": {
+        "types": "./dist/query/service.d.ts",
+        "bun": "./dist/query/service.js",
+        "node": "./dist/node/query/service.mjs",
+        "default": "./dist/query/service.js"
+      },
+      "./retriever": {
+        "types": "./dist/retriever/index.d.ts",
+        "bun": "./dist/retriever/index.js",
+        "node": "./dist/node/retriever/index.mjs",
+        "default": "./dist/retriever/index.js"
+      },
+      "./retriever/index": {
+        "types": "./dist/retriever/index.d.ts",
+        "bun": "./dist/retriever/index.js",
+        "node": "./dist/node/retriever/index.mjs",
+        "default": "./dist/retriever/index.js"
+      },
+      "./retriever/interface": {
+        "types": "./dist/retriever/interface.d.ts",
+        "bun": "./dist/retriever/interface.js",
+        "node": "./dist/node/retriever/interface.mjs",
+        "default": "./dist/retriever/interface.js"
+      },
+      "./retriever/static-retriever": {
+        "types": "./dist/retriever/static-retriever.d.ts",
+        "bun": "./dist/retriever/static-retriever.js",
+        "node": "./dist/node/retriever/static-retriever.mjs",
+        "default": "./dist/retriever/static-retriever.js"
+      },
+      "./retriever/vector-retriever": {
+        "types": "./dist/retriever/vector-retriever.d.ts",
+        "bun": "./dist/retriever/vector-retriever.js",
+        "node": "./dist/node/retriever/vector-retriever.mjs",
+        "default": "./dist/retriever/vector-retriever.js"
+      },
+      "./types": {
+        "types": "./dist/types.d.ts",
+        "bun": "./dist/types.js",
+        "node": "./dist/node/types.mjs",
+        "default": "./dist/types.js"
+      }
     },
     "registry": "https://registry.npmjs.org/"
   },

package/dist/access/guard.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"guard.js","names":[],"sources":["../../src/access/guard.ts"],"sourcesContent":["import type {\n  ResolvedAppConfig,\n  ResolvedKnowledge,\n  KnowledgeCategory,\n} from '@contractspec/lib.contracts';\nimport type { KnowledgeAccessContext, KnowledgeAccessResult } from '../types';\n\nexport interface KnowledgeAccessGuardOptions {\n  disallowWriteCategories?: KnowledgeCategory[];\n  requireWorkflowBinding?: boolean;\n  requireAgentBinding?: boolean;\n}\n\nconst DEFAULT_DISALLOWED_WRITE: KnowledgeCategory[] = ['external', 'ephemeral'];\n\nexport class KnowledgeAccessGuard {\n  private readonly disallowedWrite: Set<KnowledgeCategory>;\n  private readonly requireWorkflowBinding: boolean;\n  private readonly requireAgentBinding: boolean;\n\n  constructor(options: KnowledgeAccessGuardOptions = {}) {\n    this.disallowedWrite = new Set(\n      options.disallowWriteCategories ?? DEFAULT_DISALLOWED_WRITE\n    );\n    this.requireWorkflowBinding = options.requireWorkflowBinding ?? true;\n    this.requireAgentBinding = options.requireAgentBinding ?? false;\n  }\n\n  checkAccess(\n    spaceBinding: ResolvedKnowledge,\n    context: KnowledgeAccessContext,\n    appConfig: ResolvedAppConfig\n  ): KnowledgeAccessResult {\n    const { binding, space } = spaceBinding;\n\n    if (\n      binding.required !== false &&\n      !this.isSpaceBound(spaceBinding, appConfig)\n    ) {\n      return {\n        allowed: false,\n        reason: `Knowledge space \"${space.meta.key}\" is not bound in the resolved app config.`,\n      };\n    }\n\n    if (\n      context.operation === 'write' &&\n      this.disallowedWrite.has(space.meta.category)\n    ) {\n      return {\n        allowed: false,\n        reason: `Knowledge space \"${space.meta.key}\" is category \"${space.meta.category}\" and is read-only.`,\n      };\n    }\n\n    if (this.requireWorkflowBinding && context.workflowName) {\n      const allowedWorkflows = binding.scope?.workflows;\n      if (\n        allowedWorkflows &&\n        !allowedWorkflows.includes(context.workflowName)\n      ) {\n        return {\n          allowed: false,\n          reason: `Workflow \"${context.workflowName}\" is not authorized to access knowledge space \"${space.meta.key}\".`,\n        };\n      }\n    }\n\n    if (this.requireAgentBinding && context.agentName) {\n      const allowedAgents = binding.scope?.agents;\n      if (allowedAgents && !allowedAgents.includes(context.agentName)) {\n        return {\n          allowed: false,\n          reason: `Agent \"${context.agentName}\" is not authorized to access knowledge space \"${space.meta.key}\".`,\n        };\n      }\n    }\n\n    if (space.meta.category === 'ephemeral') {\n      return {\n        allowed: true,\n        severity: 'warning',\n        reason: `Knowledge space \"${space.meta.key}\" is ephemeral; results may be transient.`,\n      };\n    }\n\n    return { allowed: true };\n  }\n\n  private isSpaceBound(\n    resolved: ResolvedKnowledge,\n    appConfig: ResolvedAppConfig\n  ): boolean {\n    return appConfig.knowledge.some(\n      (entry) =>\n        entry.space.meta.key === resolved.space.meta.key &&\n        (resolved.space.meta.version == null ||\n          entry.space.meta.version === resolved.space.meta.version)\n    );\n  }\n}\n"],"mappings":";AAaA,MAAM,2BAAgD,CAAC,YAAY,YAAY;AAE/E,IAAa,uBAAb,MAAkC;CAChC,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,YAAY,UAAuC,EAAE,EAAE;AACrD,OAAK,kBAAkB,IAAI,IACzB,QAAQ,2BAA2B,yBACpC;AACD,OAAK,yBAAyB,QAAQ,0BAA0B;AAChE,OAAK,sBAAsB,QAAQ,uBAAuB;;CAG5D,YACE,cACA,SACA,WACuB;EACvB,MAAM,EAAE,SAAS,UAAU;AAE3B,MACE,QAAQ,aAAa,SACrB,CAAC,KAAK,aAAa,cAAc,UAAU,CAE3C,QAAO;GACL,SAAS;GACT,QAAQ,oBAAoB,MAAM,KAAK,IAAI;GAC5C;AAGH,MACE,QAAQ,cAAc,WACtB,KAAK,gBAAgB,IAAI,MAAM,KAAK,SAAS,CAE7C,QAAO;GACL,SAAS;GACT,QAAQ,oBAAoB,MAAM,KAAK,IAAI,iBAAiB,MAAM,KAAK,SAAS;GACjF;AAGH,MAAI,KAAK,0BAA0B,QAAQ,cAAc;GACvD,MAAM,mBAAmB,QAAQ,OAAO;AACxC,OACE,oBACA,CAAC,iBAAiB,SAAS,QAAQ,aAAa,CAEhD,QAAO;IACL,SAAS;IACT,QAAQ,aAAa,QAAQ,aAAa,iDAAiD,MAAM,KAAK,IAAI;IAC3G;;AAIL,MAAI,KAAK,uBAAuB,QAAQ,WAAW;GACjD,MAAM,gBAAgB,QAAQ,OAAO;AACrC,OAAI,iBAAiB,CAAC,cAAc,SAAS,QAAQ,UAAU,CAC7D,QAAO;IACL,SAAS;IACT,QAAQ,UAAU,QAAQ,UAAU,iDAAiD,MAAM,KAAK,IAAI;IACrG;;AAIL,MAAI,MAAM,KAAK,aAAa,YAC1B,QAAO;GACL,SAAS;GACT,UAAU;GACV,QAAQ,oBAAoB,MAAM,KAAK,IAAI;GAC5C;AAGH,SAAO,EAAE,SAAS,MAAM;;CAG1B,AAAQ,aACN,UACA,WACS;AACT,SAAO,UAAU,UAAU,MACxB,UACC,MAAM,MAAM,KAAK,QAAQ,SAAS,MAAM,KAAK,QAC5C,SAAS,MAAM,KAAK,WAAW,QAC9B,MAAM,MAAM,KAAK,YAAY,SAAS,MAAM,KAAK,SACtD"}