@lssm/lib.contracts 0.0.0-canary-20251217062943 → 0.0.0-canary-20251217072406

package/dist/knowledge/ingestion/storage-adapter.js

@@ -1 +1,26 @@
-var e=class{constructor(e,t,n){this.processor=e,this.embeddings=t,this.indexer=n}async ingestObject(e){if(!(`data`in e)||!e.data)throw Error(`Storage ingestion requires object data`);let t={id:e.key,mimeType:e.contentType??`application/octet-stream`,data:e.data,metadata:{bucket:e.bucket,checksum:e.checksum??``}},n=await this.processor.process(t),r=await this.embeddings.embedFragments(n);await this.indexer.upsert(n,r)}};export{e as StorageIngestionAdapter};
+//#region src/knowledge/ingestion/storage-adapter.ts
+var StorageIngestionAdapter = class {
+	constructor(processor, embeddings, indexer) {
+		this.processor = processor;
+		this.embeddings = embeddings;
+		this.indexer = indexer;
+	}
+	async ingestObject(object) {
+		if (!("data" in object) || !object.data) throw new Error("Storage ingestion requires object data");
+		const raw = {
+			id: object.key,
+			mimeType: object.contentType ?? "application/octet-stream",
+			data: object.data,
+			metadata: {
+				bucket: object.bucket,
+				checksum: object.checksum ?? ""
+			}
+		};
+		const fragments = await this.processor.process(raw);
+		const embeddings = await this.embeddings.embedFragments(fragments);
+		await this.indexer.upsert(fragments, embeddings);
+	}
+};
+
+//#endregion
+export { StorageIngestionAdapter };

package/dist/knowledge/ingestion/vector-indexer.js

@@ -1 +1,32 @@
-var e=class{provider;config;constructor(e,t){this.provider=e,this.config=t}async upsert(e,t){let n=t.map(t=>{let n=e.find(e=>e.id===t.id);return{id:t.id,vector:t.vector,payload:{...this.config.metadata,...n?.metadata??{},documentId:n?.documentId},namespace:this.config.namespace}}),r={collection:this.config.collection,documents:n};await this.provider.upsert(r)}};export{e as VectorIndexer};
+//#region src/knowledge/ingestion/vector-indexer.ts
+var VectorIndexer = class {
+	provider;
+	config;
+	constructor(provider, config) {
+		this.provider = provider;
+		this.config = config;
+	}
+	async upsert(fragments, embeddings) {
+		const documents = embeddings.map((embedding) => {
+			const fragment = fragments.find((f) => f.id === embedding.id);
+			return {
+				id: embedding.id,
+				vector: embedding.vector,
+				payload: {
+					...this.config.metadata,
+					...fragment?.metadata ?? {},
+					documentId: fragment?.documentId
+				},
+				namespace: this.config.namespace
+			};
+		});
+		const request = {
+			collection: this.config.collection,
+			documents
+		};
+		await this.provider.upsert(request);
+	}
+};
+
+//#endregion
+export { VectorIndexer };

package/dist/knowledge/query/index.js

@@ -1 +1,3 @@
-import{KnowledgeQueryService as e}from"./service.js";export{e as KnowledgeQueryService};
+import { KnowledgeQueryService } from "./service.js";
+
+export { KnowledgeQueryService };

package/dist/knowledge/query/service.js

@@ -1,3 +1,65 @@
-var e=class{embeddings;vectorStore;llm;config;constructor(e,t,n,r){this.embeddings=e,this.vectorStore=t,this.llm=n,this.config=r}async query(e){let r=await this.embeddings.embedQuery(e),i=await this.vectorStore.search({collection:this.config.collection,vector:r.vector,topK:this.config.topK??5,namespace:this.config.namespace,filter:void 0}),a=t(i),o=this.buildMessages(e,a),s=await this.llm.chat(o);return{answer:s.message.content.map(e=>`text`in e?e.text:``).join(``),references:i.map(e=>({...e,text:n(e)})),usage:s.usage}}buildMessages(e,t){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${e}\n\nContext:\n${t}`}]}]}};function t(e){return e.length===0?`No relevant documents found.`:e.map((e,t)=>{let r=n(e);return`Source ${t+1} (score: ${e.score.toFixed(3)}):\n${r}`}).join(`
+//#region src/knowledge/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}`
+			}]
+		}];
+	}
+};
+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");
+}
+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);
+}
 
-`)}function n(e){let t=e.payload??{};return typeof t.text==`string`?t.text:typeof t.content==`string`?t.content:JSON.stringify(t)}export{e as KnowledgeQueryService};
+//#endregion
+export { KnowledgeQueryService };

package/dist/knowledge/runtime.js

@@ -1 +1,49 @@
-const e=[`external`,`ephemeral`];var t=class{disallowedWrite;requireWorkflowBinding;requireAgentBinding;constructor(t={}){this.disallowedWrite=new Set(t.disallowWriteCategories??e),this.requireWorkflowBinding=t.requireWorkflowBinding??!0,this.requireAgentBinding=t.requireAgentBinding??!1}checkAccess(e,t,n){let{binding:r,space:i}=e;if(r.required!==!1&&!this.isSpaceBound(e,n))return{allowed:!1,reason:`Knowledge space "${i.meta.key}" is not bound in the resolved app config.`};if(t.operation===`write`&&this.disallowedWrite.has(i.meta.category))return{allowed:!1,reason:`Knowledge space "${i.meta.key}" is category "${i.meta.category}" and is read-only.`};if(this.requireWorkflowBinding&&t.workflowName){let e=r.scope?.workflows;if(e&&!e.includes(t.workflowName))return{allowed:!1,reason:`Workflow "${t.workflowName}" is not authorized to access knowledge space "${i.meta.key}".`}}if(this.requireAgentBinding&&t.agentName){let e=r.scope?.agents;if(e&&!e.includes(t.agentName))return{allowed:!1,reason:`Agent "${t.agentName}" is not authorized to access knowledge space "${i.meta.key}".`}}return i.meta.category===`ephemeral`?{allowed:!0,severity:`warning`,reason:`Knowledge space "${i.meta.key}" is ephemeral; results may be transient.`}:{allowed:!0}}isSpaceBound(e,t){return t.knowledge.some(t=>t.space.meta.key===e.space.meta.key&&(e.space.meta.version==null||t.space.meta.version===e.space.meta.version))}};export{t as KnowledgeAccessGuard};
+//#region src/knowledge/runtime.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));
+	}
+};
+
+//#endregion
+export { KnowledgeAccessGuard };

package/dist/knowledge/spaces/email-threads.js

@@ -1 +1,38 @@
-import{StabilityEnum as e}from"../../ownership.js";const t={meta:{key:`knowledge.email-threads`,version:1,category:`operational`,displayName:`Email Threads`,title:`Operational Email Threads`,description:`Indexed copies of operational email threads used for support, onboarding, and workflows.`,domain:`operations`,owners:[`platform.operations`],tags:[`email`,`operations`],stability:e.Beta},retention:{ttlDays:365},access:{policy:{name:`knowledge.access.email-threads`,version:1},trustLevel:`medium`,automationWritable:!0},indexing:{embeddingModel:`mistral-embed`,chunkSize:600,vectorDbIntegration:`vectordb.qdrant`},description:`Operational email threads synchronized from Gmail to support automations and contextual assistance.`};function n(e){return e.register(t)}export{t as emailThreadsKnowledgeSpace,n as registerEmailThreadsKnowledgeSpace};
+import { StabilityEnum } from "../../ownership.js";
+
+//#region src/knowledge/spaces/email-threads.ts
+const emailThreadsKnowledgeSpace = {
+	meta: {
+		key: "knowledge.email-threads",
+		version: 1,
+		category: "operational",
+		displayName: "Email Threads",
+		title: "Operational Email Threads",
+		description: "Indexed copies of operational email threads used for support, onboarding, and workflows.",
+		domain: "operations",
+		owners: ["platform.operations"],
+		tags: ["email", "operations"],
+		stability: StabilityEnum.Beta
+	},
+	retention: { ttlDays: 365 },
+	access: {
+		policy: {
+			name: "knowledge.access.email-threads",
+			version: 1
+		},
+		trustLevel: "medium",
+		automationWritable: true
+	},
+	indexing: {
+		embeddingModel: "mistral-embed",
+		chunkSize: 600,
+		vectorDbIntegration: "vectordb.qdrant"
+	},
+	description: "Operational email threads synchronized from Gmail to support automations and contextual assistance."
+};
+function registerEmailThreadsKnowledgeSpace(registry) {
+	return registry.register(emailThreadsKnowledgeSpace);
+}
+
+//#endregion
+export { emailThreadsKnowledgeSpace, registerEmailThreadsKnowledgeSpace };

package/dist/knowledge/spaces/financial-docs.js

@@ -1 +1,38 @@
-import{StabilityEnum as e}from"../../ownership.js";const t={meta:{key:`knowledge.financial-docs`,version:1,category:`canonical`,displayName:`Financial Documents`,title:`Household Financial Documents`,description:`Invoices, bills, and contracts powering Pocket Family Office financial automation.`,domain:`finance`,owners:[`platform.finance`],tags:[`finance`,`documents`],stability:e.Beta},retention:{ttlDays:null},access:{policy:{name:`knowledge.access.financial-docs`,version:1},trustLevel:`high`,automationWritable:!0},indexing:{embeddingModel:`mistral-embed`,chunkSize:700,vectorDbIntegration:`vectordb.qdrant`},description:`Normalized financial documents enabling bill pay automation, reminders, and summaries.`};function n(e){return e.register(t)}export{t as financialDocsKnowledgeSpace,n as registerFinancialDocsKnowledgeSpace};
+import { StabilityEnum } from "../../ownership.js";
+
+//#region src/knowledge/spaces/financial-docs.ts
+const financialDocsKnowledgeSpace = {
+	meta: {
+		key: "knowledge.financial-docs",
+		version: 1,
+		category: "canonical",
+		displayName: "Financial Documents",
+		title: "Household Financial Documents",
+		description: "Invoices, bills, and contracts powering Pocket Family Office financial automation.",
+		domain: "finance",
+		owners: ["platform.finance"],
+		tags: ["finance", "documents"],
+		stability: StabilityEnum.Beta
+	},
+	retention: { ttlDays: null },
+	access: {
+		policy: {
+			name: "knowledge.access.financial-docs",
+			version: 1
+		},
+		trustLevel: "high",
+		automationWritable: true
+	},
+	indexing: {
+		embeddingModel: "mistral-embed",
+		chunkSize: 700,
+		vectorDbIntegration: "vectordb.qdrant"
+	},
+	description: "Normalized financial documents enabling bill pay automation, reminders, and summaries."
+};
+function registerFinancialDocsKnowledgeSpace(registry) {
+	return registry.register(financialDocsKnowledgeSpace);
+}
+
+//#endregion
+export { financialDocsKnowledgeSpace, registerFinancialDocsKnowledgeSpace };

package/dist/knowledge/spaces/financial-overview.js

@@ -1 +1,42 @@
-import{StabilityEnum as e}from"../../ownership.js";const t={meta:{key:`knowledge.financial-overview`,version:1,category:`operational`,displayName:`Financial Overview Summaries`,title:`Derived Financial Summaries`,description:`Aggregated cashflow summaries, category breakdowns, and balance trends derived from open banking data.`,domain:`finance`,owners:[`platform.finance`],tags:[`open-banking`,`summaries`,`cashflow`],stability:e.Experimental},retention:{ttlDays:180},access:{policy:{name:`knowledge.access.financial-overview`,version:1},trustLevel:`medium`,automationWritable:!0},indexing:{embeddingModel:`mistral-embed`,chunkSize:600,vectorDbIntegration:`vectordb.qdrant`},description:`Derived knowledge space containing weekly/monthly cashflow rollups and account health summaries. Raw transactions are excluded to respect privacy guardrails.`};function n(e){return e.register(t)}export{t as financialOverviewKnowledgeSpace,n as registerFinancialOverviewKnowledgeSpace};
+import { StabilityEnum } from "../../ownership.js";
+
+//#region src/knowledge/spaces/financial-overview.ts
+const financialOverviewKnowledgeSpace = {
+	meta: {
+		key: "knowledge.financial-overview",
+		version: 1,
+		category: "operational",
+		displayName: "Financial Overview Summaries",
+		title: "Derived Financial Summaries",
+		description: "Aggregated cashflow summaries, category breakdowns, and balance trends derived from open banking data.",
+		domain: "finance",
+		owners: ["platform.finance"],
+		tags: [
+			"open-banking",
+			"summaries",
+			"cashflow"
+		],
+		stability: StabilityEnum.Experimental
+	},
+	retention: { ttlDays: 180 },
+	access: {
+		policy: {
+			name: "knowledge.access.financial-overview",
+			version: 1
+		},
+		trustLevel: "medium",
+		automationWritable: true
+	},
+	indexing: {
+		embeddingModel: "mistral-embed",
+		chunkSize: 600,
+		vectorDbIntegration: "vectordb.qdrant"
+	},
+	description: "Derived knowledge space containing weekly/monthly cashflow rollups and account health summaries. Raw transactions are excluded to respect privacy guardrails."
+};
+function registerFinancialOverviewKnowledgeSpace(registry) {
+	return registry.register(financialOverviewKnowledgeSpace);
+}
+
+//#endregion
+export { financialOverviewKnowledgeSpace, registerFinancialOverviewKnowledgeSpace };

package/dist/knowledge/spaces/index.js

@@ -1 +1,8 @@
-import{productCanonKnowledgeSpace as e,registerProductCanonKnowledgeSpace as t}from"./product-canon.js";import{registerSupportFaqKnowledgeSpace as n,supportFaqKnowledgeSpace as r}from"./support-faq.js";import{emailThreadsKnowledgeSpace as i,registerEmailThreadsKnowledgeSpace as a}from"./email-threads.js";import{registerUploadedDocsKnowledgeSpace as o,uploadedDocsKnowledgeSpace as s}from"./uploaded-docs.js";import{financialDocsKnowledgeSpace as c,registerFinancialDocsKnowledgeSpace as l}from"./financial-docs.js";import{financialOverviewKnowledgeSpace as u,registerFinancialOverviewKnowledgeSpace as d}from"./financial-overview.js";export{i as emailThreadsKnowledgeSpace,c as financialDocsKnowledgeSpace,u as financialOverviewKnowledgeSpace,e as productCanonKnowledgeSpace,a as registerEmailThreadsKnowledgeSpace,l as registerFinancialDocsKnowledgeSpace,d as registerFinancialOverviewKnowledgeSpace,t as registerProductCanonKnowledgeSpace,n as registerSupportFaqKnowledgeSpace,o as registerUploadedDocsKnowledgeSpace,r as supportFaqKnowledgeSpace,s as uploadedDocsKnowledgeSpace};
+import { productCanonKnowledgeSpace, registerProductCanonKnowledgeSpace } from "./product-canon.js";
+import { registerSupportFaqKnowledgeSpace, supportFaqKnowledgeSpace } from "./support-faq.js";
+import { emailThreadsKnowledgeSpace, registerEmailThreadsKnowledgeSpace } from "./email-threads.js";
+import { registerUploadedDocsKnowledgeSpace, uploadedDocsKnowledgeSpace } from "./uploaded-docs.js";
+import { financialDocsKnowledgeSpace, registerFinancialDocsKnowledgeSpace } from "./financial-docs.js";
+import { financialOverviewKnowledgeSpace, registerFinancialOverviewKnowledgeSpace } from "./financial-overview.js";
+
+export { emailThreadsKnowledgeSpace, financialDocsKnowledgeSpace, financialOverviewKnowledgeSpace, productCanonKnowledgeSpace, registerEmailThreadsKnowledgeSpace, registerFinancialDocsKnowledgeSpace, registerFinancialOverviewKnowledgeSpace, registerProductCanonKnowledgeSpace, registerSupportFaqKnowledgeSpace, registerUploadedDocsKnowledgeSpace, supportFaqKnowledgeSpace, uploadedDocsKnowledgeSpace };

package/dist/knowledge/spaces/product-canon.js

@@ -1 +1,38 @@
-import{StabilityEnum as e}from"../../ownership.js";const t={meta:{key:`knowledge.product-canon`,version:1,category:`canonical`,displayName:`Product Canon`,title:`Product Canon Knowledge Space`,description:`Authoritative product knowledge covering strategy, roadmap, and delivery canon.`,domain:`product`,owners:[`platform.product`],tags:[`knowledge`,`product`],stability:e.Stable},retention:{ttlDays:null},access:{policy:{name:`knowledge.access.product-canon`,version:1},trustLevel:`high`,automationWritable:!1},indexing:{embeddingModel:`text-embedding-3-large`,chunkSize:800,vectorDbIntegration:`vectordb.qdrant`},description:`Single source of truth for product canon, principles, and strategic narratives.`};function n(e){return e.register(t)}export{t as productCanonKnowledgeSpace,n as registerProductCanonKnowledgeSpace};
+import { StabilityEnum } from "../../ownership.js";
+
+//#region src/knowledge/spaces/product-canon.ts
+const productCanonKnowledgeSpace = {
+	meta: {
+		key: "knowledge.product-canon",
+		version: 1,
+		category: "canonical",
+		displayName: "Product Canon",
+		title: "Product Canon Knowledge Space",
+		description: "Authoritative product knowledge covering strategy, roadmap, and delivery canon.",
+		domain: "product",
+		owners: ["platform.product"],
+		tags: ["knowledge", "product"],
+		stability: StabilityEnum.Stable
+	},
+	retention: { ttlDays: null },
+	access: {
+		policy: {
+			name: "knowledge.access.product-canon",
+			version: 1
+		},
+		trustLevel: "high",
+		automationWritable: false
+	},
+	indexing: {
+		embeddingModel: "text-embedding-3-large",
+		chunkSize: 800,
+		vectorDbIntegration: "vectordb.qdrant"
+	},
+	description: "Single source of truth for product canon, principles, and strategic narratives."
+};
+function registerProductCanonKnowledgeSpace(registry) {
+	return registry.register(productCanonKnowledgeSpace);
+}
+
+//#endregion
+export { productCanonKnowledgeSpace, registerProductCanonKnowledgeSpace };

package/dist/knowledge/spaces/support-faq.js

@@ -1 +1,41 @@
-import{StabilityEnum as e}from"../../ownership.js";const t={meta:{key:`knowledge.support-faq`,version:1,category:`operational`,displayName:`Support FAQ`,title:`Support & Success FAQ`,description:`Operational knowledge base for customer support and success.`,domain:`support`,owners:[`platform.support`],tags:[`knowledge`,`support`],stability:e.Beta},retention:{ttlDays:365,archiveAfterDays:180},access:{policy:{name:`knowledge.access.support`,version:1},trustLevel:`medium`,automationWritable:!0},indexing:{embeddingModel:`text-embedding-3-small`,chunkSize:700,vectorDbIntegration:`vectordb.qdrant`},description:`Operational FAQs, runbooks, and customer success playbooks augmented with automation updates.`};function n(e){return e.register(t)}export{n as registerSupportFaqKnowledgeSpace,t as supportFaqKnowledgeSpace};
+import { StabilityEnum } from "../../ownership.js";
+
+//#region src/knowledge/spaces/support-faq.ts
+const supportFaqKnowledgeSpace = {
+	meta: {
+		key: "knowledge.support-faq",
+		version: 1,
+		category: "operational",
+		displayName: "Support FAQ",
+		title: "Support & Success FAQ",
+		description: "Operational knowledge base for customer support and success.",
+		domain: "support",
+		owners: ["platform.support"],
+		tags: ["knowledge", "support"],
+		stability: StabilityEnum.Beta
+	},
+	retention: {
+		ttlDays: 365,
+		archiveAfterDays: 180
+	},
+	access: {
+		policy: {
+			name: "knowledge.access.support",
+			version: 1
+		},
+		trustLevel: "medium",
+		automationWritable: true
+	},
+	indexing: {
+		embeddingModel: "text-embedding-3-small",
+		chunkSize: 700,
+		vectorDbIntegration: "vectordb.qdrant"
+	},
+	description: "Operational FAQs, runbooks, and customer success playbooks augmented with automation updates."
+};
+function registerSupportFaqKnowledgeSpace(registry) {
+	return registry.register(supportFaqKnowledgeSpace);
+}
+
+//#endregion
+export { registerSupportFaqKnowledgeSpace, supportFaqKnowledgeSpace };

package/dist/knowledge/spaces/uploaded-docs.js

@@ -1 +1,38 @@
-import{StabilityEnum as e}from"../../ownership.js";const t={meta:{key:`knowledge.uploaded-docs`,version:1,category:`external`,displayName:`Uploaded Documents`,title:`Uploaded Knowledge Assets`,description:`Documents uploaded by households, including invoices, contracts, and reference files.`,domain:`operations`,owners:[`platform.operations`],tags:[`documents`,`storage`],stability:e.Beta},retention:{ttlDays:null},access:{policy:{name:`knowledge.access.uploaded-docs`,version:1},trustLevel:`medium`,automationWritable:!0},indexing:{embeddingModel:`mistral-embed`,chunkSize:900,vectorDbIntegration:`vectordb.qdrant`},description:`User-provided documents normalized and embedded for retrieval augmented workflows.`};function n(e){return e.register(t)}export{n as registerUploadedDocsKnowledgeSpace,t as uploadedDocsKnowledgeSpace};
+import { StabilityEnum } from "../../ownership.js";
+
+//#region src/knowledge/spaces/uploaded-docs.ts
+const uploadedDocsKnowledgeSpace = {
+	meta: {
+		key: "knowledge.uploaded-docs",
+		version: 1,
+		category: "external",
+		displayName: "Uploaded Documents",
+		title: "Uploaded Knowledge Assets",
+		description: "Documents uploaded by households, including invoices, contracts, and reference files.",
+		domain: "operations",
+		owners: ["platform.operations"],
+		tags: ["documents", "storage"],
+		stability: StabilityEnum.Beta
+	},
+	retention: { ttlDays: null },
+	access: {
+		policy: {
+			name: "knowledge.access.uploaded-docs",
+			version: 1
+		},
+		trustLevel: "medium",
+		automationWritable: true
+	},
+	indexing: {
+		embeddingModel: "mistral-embed",
+		chunkSize: 900,
+		vectorDbIntegration: "vectordb.qdrant"
+	},
+	description: "User-provided documents normalized and embedded for retrieval augmented workflows."
+};
+function registerUploadedDocsKnowledgeSpace(registry) {
+	return registry.register(uploadedDocsKnowledgeSpace);
+}
+
+//#endregion
+export { registerUploadedDocsKnowledgeSpace, uploadedDocsKnowledgeSpace };

package/dist/knowledge/spec.js

@@ -1 +1,39 @@
-const e=e=>`${e.key}.v${e.version}`;var t=class{items=new Map;register(t){let n=e(t.meta);if(this.items.has(n))throw Error(`Duplicate KnowledgeSpaceSpec ${n}`);return this.items.set(n,t),this}list(){return[...this.items.values()]}get(t,n){if(n!=null)return this.items.get(e({key:t,version:n}));let r,i=-1/0;for(let e of this.items.values())e.meta.key===t&&e.meta.version>i&&(i=e.meta.version,r=e);return r}getByCategory(e){return this.list().filter(t=>t.meta.category===e)}};function n(t){return e(t)}export{t as KnowledgeSpaceRegistry,n as makeKnowledgeSpaceKey};
+//#region src/knowledge/spec.ts
+const knowledgeKey = (meta) => `${meta.key}.v${meta.version}`;
+var KnowledgeSpaceRegistry = class {
+	items = /* @__PURE__ */ new Map();
+	register(spec) {
+		const key = knowledgeKey(spec.meta);
+		if (this.items.has(key)) throw new Error(`Duplicate KnowledgeSpaceSpec ${key}`);
+		this.items.set(key, spec);
+		return this;
+	}
+	list() {
+		return [...this.items.values()];
+	}
+	get(key, version) {
+		if (version != null) return this.items.get(knowledgeKey({
+			key,
+			version
+		}));
+		let latest;
+		let maxVersion = -Infinity;
+		for (const spec of this.items.values()) {
+			if (spec.meta.key !== key) continue;
+			if (spec.meta.version > maxVersion) {
+				maxVersion = spec.meta.version;
+				latest = spec;
+			}
+		}
+		return latest;
+	}
+	getByCategory(category) {
+		return this.list().filter((spec) => spec.meta.category === category);
+	}
+};
+function makeKnowledgeSpaceKey(meta) {
+	return knowledgeKey(meta);
+}
+
+//#endregion
+export { KnowledgeSpaceRegistry, makeKnowledgeSpaceKey };