@contractspec/lib.knowledge 1.56.1 → 1.58.0

package/dist/access/guard.d.ts

@@ -1,20 +1,16 @@
-import { KnowledgeAccessContext, KnowledgeAccessResult } from "../types.js";
-import { KnowledgeCategory, ResolvedAppConfig, ResolvedKnowledge } from "@contractspec/lib.contracts";
-
-//#region src/access/guard.d.ts
-interface KnowledgeAccessGuardOptions {
-  disallowWriteCategories?: KnowledgeCategory[];
-  requireWorkflowBinding?: boolean;
-  requireAgentBinding?: boolean;
+import type { ResolvedAppConfig, ResolvedKnowledge, KnowledgeCategory } from '@contractspec/lib.contracts';
+import type { KnowledgeAccessContext, KnowledgeAccessResult } from '../types';
+export interface KnowledgeAccessGuardOptions {
+    disallowWriteCategories?: KnowledgeCategory[];
+    requireWorkflowBinding?: boolean;
+    requireAgentBinding?: boolean;
 }
-declare class KnowledgeAccessGuard {
-  private readonly disallowedWrite;
-  private readonly requireWorkflowBinding;
-  private readonly requireAgentBinding;
-  constructor(options?: KnowledgeAccessGuardOptions);
-  checkAccess(spaceBinding: ResolvedKnowledge, context: KnowledgeAccessContext, appConfig: ResolvedAppConfig): KnowledgeAccessResult;
-  private isSpaceBound;
+export declare class KnowledgeAccessGuard {
+    private readonly disallowedWrite;
+    private readonly requireWorkflowBinding;
+    private readonly requireAgentBinding;
+    constructor(options?: KnowledgeAccessGuardOptions);
+    checkAccess(spaceBinding: ResolvedKnowledge, context: KnowledgeAccessContext, appConfig: ResolvedAppConfig): KnowledgeAccessResult;
+    private isSpaceBound;
 }
-//#endregion
-export { KnowledgeAccessGuard, KnowledgeAccessGuardOptions };
 //# sourceMappingURL=guard.d.ts.map

package/dist/access/guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guard.d.ts","names":[],"sources":["../../src/access/guard.ts"],"sourcesContent":[],"mappings":";;;;UAOiB,2BAAA;4BACW;EADX,sBAAA,CAAA,EAAA,OAA2B;EAQ/B,mBAAA,CAAA,EAAA,OAAoB;;AAcf,cAdL,oBAAA,CAcK;EACL,iBAAA,eAAA;EACE,iBAAA,sBAAA;EACV,iBAAA,mBAAA;EAAqB,WAAA,CAAA,OAAA,CAAA,EAZH,2BAYG;4BAHR,4BACL,mCACE,oBACV"}
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../src/access/guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAE9E,MAAM,WAAW,2BAA2B;IAC1C,uBAAuB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC9C,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAID,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IACzD,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAU;IACjD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAU;gBAElC,OAAO,GAAE,2BAAgC;IAQrD,WAAW,CACT,YAAY,EAAE,iBAAiB,EAC/B,OAAO,EAAE,sBAAsB,EAC/B,SAAS,EAAE,iBAAiB,GAC3B,qBAAqB;IAyDxB,OAAO,CAAC,YAAY;CAWrB"}

package/dist/access/guard.js

@@ -1,50 +1,61 @@
-//#region src/access/guard.ts
-const DEFAULT_DISALLOWED_WRITE = ["external", "ephemeral"];
-var KnowledgeAccessGuard = class {
-	disallowedWrite;
-	requireWorkflowBinding;
-	requireAgentBinding;
-	constructor(options = {}) {
-		this.disallowedWrite = new Set(options.disallowWriteCategories ?? DEFAULT_DISALLOWED_WRITE);
-		this.requireWorkflowBinding = options.requireWorkflowBinding ?? true;
-		this.requireAgentBinding = options.requireAgentBinding ?? false;
-	}
-	checkAccess(spaceBinding, context, appConfig) {
-		const { binding, space } = spaceBinding;
-		if (binding.required !== false && !this.isSpaceBound(spaceBinding, appConfig)) return {
-			allowed: false,
-			reason: `Knowledge space "${space.meta.key}" is not bound in the resolved app config.`
-		};
-		if (context.operation === "write" && this.disallowedWrite.has(space.meta.category)) return {
-			allowed: false,
-			reason: `Knowledge space "${space.meta.key}" is category "${space.meta.category}" and is read-only.`
-		};
-		if (this.requireWorkflowBinding && context.workflowName) {
-			const allowedWorkflows = binding.scope?.workflows;
-			if (allowedWorkflows && !allowedWorkflows.includes(context.workflowName)) return {
-				allowed: false,
-				reason: `Workflow "${context.workflowName}" is not authorized to access knowledge space "${space.meta.key}".`
-			};
-		}
-		if (this.requireAgentBinding && context.agentName) {
-			const allowedAgents = binding.scope?.agents;
-			if (allowedAgents && !allowedAgents.includes(context.agentName)) return {
-				allowed: false,
-				reason: `Agent "${context.agentName}" is not authorized to access knowledge space "${space.meta.key}".`
-			};
-		}
-		if (space.meta.category === "ephemeral") return {
-			allowed: true,
-			severity: "warning",
-			reason: `Knowledge space "${space.meta.key}" is ephemeral; results may be transient.`
-		};
-		return { allowed: true };
-	}
-	isSpaceBound(resolved, appConfig) {
-		return appConfig.knowledge.some((entry) => entry.space.meta.key === resolved.space.meta.key && (resolved.space.meta.version == null || entry.space.meta.version === resolved.space.meta.version));
-	}
-};
+// @bun
+// src/access/guard.ts
+var DEFAULT_DISALLOWED_WRITE = ["external", "ephemeral"];
 
-//#endregion
-export { KnowledgeAccessGuard };
-//# sourceMappingURL=guard.js.map
+class KnowledgeAccessGuard {
+  disallowedWrite;
+  requireWorkflowBinding;
+  requireAgentBinding;
+  constructor(options = {}) {
+    this.disallowedWrite = new Set(options.disallowWriteCategories ?? DEFAULT_DISALLOWED_WRITE);
+    this.requireWorkflowBinding = options.requireWorkflowBinding ?? true;
+    this.requireAgentBinding = options.requireAgentBinding ?? false;
+  }
+  checkAccess(spaceBinding, context, appConfig) {
+    const { binding, space } = spaceBinding;
+    if (binding.required !== false && !this.isSpaceBound(spaceBinding, appConfig)) {
+      return {
+        allowed: false,
+        reason: `Knowledge space "${space.meta.key}" is not bound in the resolved app config.`
+      };
+    }
+    if (context.operation === "write" && this.disallowedWrite.has(space.meta.category)) {
+      return {
+        allowed: false,
+        reason: `Knowledge space "${space.meta.key}" is category "${space.meta.category}" and is read-only.`
+      };
+    }
+    if (this.requireWorkflowBinding && context.workflowName) {
+      const allowedWorkflows = binding.scope?.workflows;
+      if (allowedWorkflows && !allowedWorkflows.includes(context.workflowName)) {
+        return {
+          allowed: false,
+          reason: `Workflow "${context.workflowName}" is not authorized to access knowledge space "${space.meta.key}".`
+        };
+      }
+    }
+    if (this.requireAgentBinding && context.agentName) {
+      const allowedAgents = binding.scope?.agents;
+      if (allowedAgents && !allowedAgents.includes(context.agentName)) {
+        return {
+          allowed: false,
+          reason: `Agent "${context.agentName}" is not authorized to access knowledge space "${space.meta.key}".`
+        };
+      }
+    }
+    if (space.meta.category === "ephemeral") {
+      return {
+        allowed: true,
+        severity: "warning",
+        reason: `Knowledge space "${space.meta.key}" is ephemeral; results may be transient.`
+      };
+    }
+    return { allowed: true };
+  }
+  isSpaceBound(resolved, appConfig) {
+    return appConfig.knowledge.some((entry) => entry.space.meta.key === resolved.space.meta.key && (resolved.space.meta.version == null || entry.space.meta.version === resolved.space.meta.version));
+  }
+}
+export {
+  KnowledgeAccessGuard
+};

package/dist/access/index.d.ts

@@ -1,2 +1,2 @@
-import { KnowledgeAccessGuard, KnowledgeAccessGuardOptions } from "./guard.js";
-export { KnowledgeAccessGuard, KnowledgeAccessGuardOptions };
+export * from './guard';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/access/index.js

@@ -1,3 +1,61 @@
-import { KnowledgeAccessGuard } from "./guard.js";
+// @bun
+// src/access/guard.ts
+var DEFAULT_DISALLOWED_WRITE = ["external", "ephemeral"];
 
-export { KnowledgeAccessGuard };
+class KnowledgeAccessGuard {
+  disallowedWrite;
+  requireWorkflowBinding;
+  requireAgentBinding;
+  constructor(options = {}) {
+    this.disallowedWrite = new Set(options.disallowWriteCategories ?? DEFAULT_DISALLOWED_WRITE);
+    this.requireWorkflowBinding = options.requireWorkflowBinding ?? true;
+    this.requireAgentBinding = options.requireAgentBinding ?? false;
+  }
+  checkAccess(spaceBinding, context, appConfig) {
+    const { binding, space } = spaceBinding;
+    if (binding.required !== false && !this.isSpaceBound(spaceBinding, appConfig)) {
+      return {
+        allowed: false,
+        reason: `Knowledge space "${space.meta.key}" is not bound in the resolved app config.`
+      };
+    }
+    if (context.operation === "write" && this.disallowedWrite.has(space.meta.category)) {
+      return {
+        allowed: false,
+        reason: `Knowledge space "${space.meta.key}" is category "${space.meta.category}" and is read-only.`
+      };
+    }
+    if (this.requireWorkflowBinding && context.workflowName) {
+      const allowedWorkflows = binding.scope?.workflows;
+      if (allowedWorkflows && !allowedWorkflows.includes(context.workflowName)) {
+        return {
+          allowed: false,
+          reason: `Workflow "${context.workflowName}" is not authorized to access knowledge space "${space.meta.key}".`
+        };
+      }
+    }
+    if (this.requireAgentBinding && context.agentName) {
+      const allowedAgents = binding.scope?.agents;
+      if (allowedAgents && !allowedAgents.includes(context.agentName)) {
+        return {
+          allowed: false,
+          reason: `Agent "${context.agentName}" is not authorized to access knowledge space "${space.meta.key}".`
+        };
+      }
+    }
+    if (space.meta.category === "ephemeral") {
+      return {
+        allowed: true,
+        severity: "warning",
+        reason: `Knowledge space "${space.meta.key}" is ephemeral; results may be transient.`
+      };
+    }
+    return { allowed: true };
+  }
+  isSpaceBound(resolved, appConfig) {
+    return appConfig.knowledge.some((entry) => entry.space.meta.key === resolved.space.meta.key && (resolved.space.meta.version == null || entry.space.meta.version === resolved.space.meta.version));
+  }
+}
+export {
+  KnowledgeAccessGuard
+};

package/dist/index.d.ts

@@ -1,12 +1,6 @@
-import { KnowledgeAccessContext, KnowledgeAccessResult, RetrievalOptions, RetrievalResult } from "./types.js";
-import { KnowledgeAccessGuard, KnowledgeAccessGuardOptions } from "./access/guard.js";
-import { KnowledgeRetriever, RetrieverConfig } from "./retriever/interface.js";
-import { StaticRetriever, StaticRetrieverConfig, createStaticRetriever } from "./retriever/static-retriever.js";
-import { VectorRetriever, VectorRetrieverConfig, createVectorRetriever } from "./retriever/vector-retriever.js";
-import { KnowledgeAnswer, KnowledgeQueryConfig, KnowledgeQueryService } from "./query/service.js";
-import { DocumentFragment, DocumentProcessor, RawDocument } from "./ingestion/document-processor.js";
-import { EmbeddingService } from "./ingestion/embedding-service.js";
-import { VectorIndexConfig, VectorIndexer } from "./ingestion/vector-indexer.js";
-import { GmailIngestionAdapter } from "./ingestion/gmail-adapter.js";
-import { StorageIngestionAdapter } from "./ingestion/storage-adapter.js";
-export { DocumentFragment, DocumentProcessor, EmbeddingService, GmailIngestionAdapter, KnowledgeAccessContext, KnowledgeAccessGuard, KnowledgeAccessGuardOptions, KnowledgeAccessResult, KnowledgeAnswer, KnowledgeQueryConfig, KnowledgeQueryService, KnowledgeRetriever, RawDocument, RetrievalOptions, RetrievalResult, RetrieverConfig, StaticRetriever, StaticRetrieverConfig, StorageIngestionAdapter, VectorIndexConfig, VectorIndexer, VectorRetriever, VectorRetrieverConfig, createStaticRetriever, createVectorRetriever };
+export * from './types';
+export * from './retriever';
+export * from './query';
+export * from './ingestion';
+export * from './access';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AAGxB,cAAc,aAAa,CAAC;AAG5B,cAAc,SAAS,CAAC;AAGxB,cAAc,aAAa,CAAC;AAG5B,cAAc,UAAU,CAAC"}