@lssm/lib.contracts 0.0.0-canary-20251217083314 → 0.0.0-canary-20251219202229

package/dist/knowledge/contracts.js

@@ -1,51 +1,49 @@
-import { ScalarTypeEnum } from "../schema/dist/ScalarTypeEnum.js";
-import { SchemaModel } from "../schema/dist/SchemaModel.js";
-import "../schema/dist/index.js";
+import { E5, x8 } from "../schema/dist/index.js";
 import { defineCommand, defineQuery } from "../spec.js";
 
 //#region src/knowledge/contracts.ts
-const KnowledgeSyncSchedule = new SchemaModel({
+const KnowledgeSyncSchedule = new x8({
 	name: "KnowledgeSyncSchedule",
 	fields: {
 		enabled: {
-			type: ScalarTypeEnum.Boolean(),
+			type: E5.Boolean(),
 			isOptional: false
 		},
 		cron: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		},
 		intervalMs: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: E5.Int_unsecure(),
 			isOptional: true
 		}
 	}
 });
-const KnowledgeSourceRecord = new SchemaModel({
+const KnowledgeSourceRecord = new x8({
 	name: "KnowledgeSourceRecord",
 	fields: {
 		id: {
-			type: ScalarTypeEnum.ID(),
+			type: E5.ID(),
 			isOptional: false
 		},
 		tenantId: {
-			type: ScalarTypeEnum.ID(),
+			type: E5.ID(),
 			isOptional: false
 		},
 		spaceKey: {
-			type: ScalarTypeEnum.NonEmptyString(),
+			type: E5.NonEmptyString(),
 			isOptional: false
 		},
 		spaceVersion: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: E5.Int_unsecure(),
 			isOptional: false
 		},
 		label: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		sourceType: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		syncSchedule: {
@@ -53,52 +51,52 @@ const KnowledgeSourceRecord = new SchemaModel({
 			isOptional: true
 		},
 		lastSyncStatus: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		},
 		lastSyncAt: {
-			type: ScalarTypeEnum.DateTime(),
+			type: E5.DateTime(),
 			isOptional: true
 		},
 		itemsProcessed: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: E5.Int_unsecure(),
 			isOptional: true
 		},
 		createdAt: {
-			type: ScalarTypeEnum.DateTime(),
+			type: E5.DateTime(),
 			isOptional: true
 		},
 		updatedAt: {
-			type: ScalarTypeEnum.DateTime(),
+			type: E5.DateTime(),
 			isOptional: true
 		}
 	}
 });
-const CreateKnowledgeSourceInput = new SchemaModel({
+const CreateKnowledgeSourceInput = new x8({
 	name: "CreateKnowledgeSourceInput",
 	fields: {
 		tenantId: {
-			type: ScalarTypeEnum.ID(),
+			type: E5.ID(),
 			isOptional: false
 		},
 		spaceKey: {
-			type: ScalarTypeEnum.NonEmptyString(),
+			type: E5.NonEmptyString(),
 			isOptional: false
 		},
 		spaceVersion: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: E5.Int_unsecure(),
 			isOptional: false
 		},
 		label: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		sourceType: {
-			type: ScalarTypeEnum.NonEmptyString(),
+			type: E5.NonEmptyString(),
 			isOptional: false
 		},
 		config: {
-			type: ScalarTypeEnum.JSONObject(),
+			type: E5.JSONObject(),
 			isOptional: false
 		},
 		syncSchedule: {
@@ -107,19 +105,19 @@ const CreateKnowledgeSourceInput = new SchemaModel({
 		}
 	}
 });
-const UpdateKnowledgeSourceInput = new SchemaModel({
+const UpdateKnowledgeSourceInput = new x8({
 	name: "UpdateKnowledgeSourceInput",
 	fields: {
 		sourceId: {
-			type: ScalarTypeEnum.ID(),
+			type: E5.ID(),
 			isOptional: false
 		},
 		label: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		},
 		config: {
-			type: ScalarTypeEnum.JSONObject(),
+			type: E5.JSONObject(),
 			isOptional: true
 		},
 		syncSchedule: {
@@ -128,34 +126,34 @@ const UpdateKnowledgeSourceInput = new SchemaModel({
 		}
 	}
 });
-const DeleteKnowledgeSourceInput = new SchemaModel({
+const DeleteKnowledgeSourceInput = new x8({
 	name: "DeleteKnowledgeSourceInput",
 	fields: { sourceId: {
-		type: ScalarTypeEnum.ID(),
+		type: E5.ID(),
 		isOptional: false
 	} }
 });
-const DeleteKnowledgeSourceOutput = new SchemaModel({
+const DeleteKnowledgeSourceOutput = new x8({
 	name: "DeleteKnowledgeSourceOutput",
 	fields: { success: {
-		type: ScalarTypeEnum.Boolean(),
+		type: E5.Boolean(),
 		isOptional: false
 	} }
 });
-const ListKnowledgeSourcesInput = new SchemaModel({
+const ListKnowledgeSourcesInput = new x8({
 	name: "ListKnowledgeSourcesInput",
 	fields: {
 		tenantId: {
-			type: ScalarTypeEnum.ID(),
+			type: E5.ID(),
 			isOptional: false
 		},
 		spaceKey: {
-			type: ScalarTypeEnum.NonEmptyString(),
+			type: E5.NonEmptyString(),
 			isOptional: true
 		}
 	}
 });
-const ListKnowledgeSourcesOutput = new SchemaModel({
+const ListKnowledgeSourcesOutput = new x8({
 	name: "ListKnowledgeSourcesOutput",
 	fields: { sources: {
 		type: KnowledgeSourceRecord,
@@ -163,26 +161,26 @@ const ListKnowledgeSourcesOutput = new SchemaModel({
 		isArray: true
 	} }
 });
-const TriggerKnowledgeSyncInput = new SchemaModel({
+const TriggerKnowledgeSyncInput = new x8({
 	name: "TriggerKnowledgeSyncInput",
 	fields: { sourceId: {
-		type: ScalarTypeEnum.ID(),
+		type: E5.ID(),
 		isOptional: false
 	} }
 });
-const TriggerKnowledgeSyncOutput = new SchemaModel({
+const TriggerKnowledgeSyncOutput = new x8({
 	name: "TriggerKnowledgeSyncOutput",
 	fields: {
 		success: {
-			type: ScalarTypeEnum.Boolean(),
+			type: E5.Boolean(),
 			isOptional: false
 		},
 		itemsProcessed: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: E5.Int_unsecure(),
 			isOptional: true
 		},
 		error: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		}
 	}
@@ -314,4 +312,5 @@ function registerKnowledgeContracts(registry) {
 }
 
 //#endregion
-export { CreateKnowledgeSource, DeleteKnowledgeSource, ListKnowledgeSources, TriggerKnowledgeSourceSync, UpdateKnowledgeSource, knowledgeContracts, registerKnowledgeContracts };
+export { CreateKnowledgeSource, DeleteKnowledgeSource, ListKnowledgeSources, TriggerKnowledgeSourceSync, UpdateKnowledgeSource, knowledgeContracts, registerKnowledgeContracts };
+//# sourceMappingURL=contracts.js.map

package/dist/knowledge/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","names":["SchemaModel","ScalarTypeEnum","knowledgeContracts: Record<string, ContractSpec<any, any>>"],"sources":["../../src/knowledge/contracts.ts"],"sourcesContent":["import { ScalarTypeEnum, SchemaModel } from '@lssm/lib.schema';\nimport { defineCommand, defineQuery, type ContractSpec } from '../spec';\nimport type { SpecRegistry } from '../registry';\n\nconst KnowledgeSyncSchedule = new SchemaModel({\n  name: 'KnowledgeSyncSchedule',\n  fields: {\n    enabled: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n    cron: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    intervalMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n  },\n});\n\nconst KnowledgeSourceRecord = new SchemaModel({\n  name: 'KnowledgeSourceRecord',\n  fields: {\n    id: { type: ScalarTypeEnum.ID(), isOptional: false },\n    tenantId: { type: ScalarTypeEnum.ID(), isOptional: false },\n    spaceKey: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\n    spaceVersion: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    label: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    sourceType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    syncSchedule: { type: KnowledgeSyncSchedule, isOptional: true },\n    lastSyncStatus: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    lastSyncAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n    itemsProcessed: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n    updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n  },\n});\n\nconst CreateKnowledgeSourceInput = new SchemaModel({\n  name: 'CreateKnowledgeSourceInput',\n  fields: {\n    tenantId: { type: ScalarTypeEnum.ID(), isOptional: false },\n    spaceKey: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\n    spaceVersion: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    label: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    sourceType: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\n    config: { type: ScalarTypeEnum.JSONObject(), isOptional: false },\n    syncSchedule: { type: KnowledgeSyncSchedule, isOptional: true },\n  },\n});\n\nconst UpdateKnowledgeSourceInput = new SchemaModel({\n  name: 'UpdateKnowledgeSourceInput',\n  fields: {\n    sourceId: { type: ScalarTypeEnum.ID(), isOptional: false },\n    label: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    config: { type: ScalarTypeEnum.JSONObject(), isOptional: true },\n    syncSchedule: { type: KnowledgeSyncSchedule, isOptional: true },\n  },\n});\n\nconst DeleteKnowledgeSourceInput = new SchemaModel({\n  name: 'DeleteKnowledgeSourceInput',\n  fields: {\n    sourceId: { type: ScalarTypeEnum.ID(), isOptional: false },\n  },\n});\n\nconst DeleteKnowledgeSourceOutput = new SchemaModel({\n  name: 'DeleteKnowledgeSourceOutput',\n  fields: {\n    success: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n  },\n});\n\nconst ListKnowledgeSourcesInput = new SchemaModel({\n  name: 'ListKnowledgeSourcesInput',\n  fields: {\n    tenantId: { type: ScalarTypeEnum.ID(), isOptional: false },\n    spaceKey: { type: ScalarTypeEnum.NonEmptyString(), isOptional: true },\n  },\n});\n\nconst ListKnowledgeSourcesOutput = new SchemaModel({\n  name: 'ListKnowledgeSourcesOutput',\n  fields: {\n    sources: {\n      type: KnowledgeSourceRecord,\n      isOptional: false,\n      isArray: true,\n    },\n  },\n});\n\nconst TriggerKnowledgeSyncInput = new SchemaModel({\n  name: 'TriggerKnowledgeSyncInput',\n  fields: {\n    sourceId: { type: ScalarTypeEnum.ID(), isOptional: false },\n  },\n});\n\nconst TriggerKnowledgeSyncOutput = new SchemaModel({\n  name: 'TriggerKnowledgeSyncOutput',\n  fields: {\n    success: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n    itemsProcessed: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n    error: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\nexport const CreateKnowledgeSource = defineCommand({\n  meta: {\n    name: 'knowledge.source.create',\n    version: 1,\n    description: 'Create a knowledge source binding for a tenant.',\n    goal: 'Onboard a new knowledge ingestion source such as Notion or uploads.',\n    context:\n      'Used by Ops and App Studio to configure knowledge ingestion per tenant and space.',\n    owners: ['platform.knowledge'],\n    tags: ['knowledge', 'sources'],\n    stability: 'experimental',\n  },\n  io: {\n    input: CreateKnowledgeSourceInput,\n    output: KnowledgeSourceRecord,\n  },\n  policy: {\n    auth: 'admin',\n    policies: [{ name: 'platform.knowledge.manage', version: 1 }],\n  },\n});\n\nexport const UpdateKnowledgeSource = defineCommand({\n  meta: {\n    name: 'knowledge.source.update',\n    version: 1,\n    description: 'Update metadata or configuration for a knowledge source.',\n    goal: 'Allow rotation of credentials, sync schedules, and labels.',\n    context:\n      'Supports editing how a tenant ingests knowledge (e.g., toggling sync cadence).',\n    owners: ['platform.knowledge'],\n    tags: ['knowledge', 'sources'],\n    stability: 'experimental',\n  },\n  io: {\n    input: UpdateKnowledgeSourceInput,\n    output: KnowledgeSourceRecord,\n  },\n  policy: {\n    auth: 'admin',\n    policies: [{ name: 'platform.knowledge.manage', version: 1 }],\n  },\n});\n\nexport const DeleteKnowledgeSource = defineCommand({\n  meta: {\n    name: 'knowledge.source.delete',\n    version: 1,\n    description: 'Delete a knowledge source binding for a tenant.',\n    goal: 'Remove obsolete or compromised knowledge ingestion paths.',\n    context:\n      'Ensures ephemeral or external sources can be removed cleanly without leaving residual bindings.',\n    owners: ['platform.knowledge'],\n    tags: ['knowledge', 'sources'],\n    stability: 'experimental',\n  },\n  io: {\n    input: DeleteKnowledgeSourceInput,\n    output: DeleteKnowledgeSourceOutput,\n  },\n  policy: {\n    auth: 'admin',\n    policies: [{ name: 'platform.knowledge.manage', version: 1 }],\n  },\n});\n\nexport const ListKnowledgeSources = defineQuery({\n  meta: {\n    name: 'knowledge.source.list',\n    version: 1,\n    description: 'List knowledge sources configured for a tenant.',\n    goal: 'Provide visibility into knowledge ingest configuration and schedules.',\n    context:\n      'Used by App Studio and Ops flows to surface knowledge sources and their health.',\n    owners: ['platform.knowledge'],\n    tags: ['knowledge', 'sources'],\n    stability: 'experimental',\n  },\n  io: {\n    input: ListKnowledgeSourcesInput,\n    output: ListKnowledgeSourcesOutput,\n  },\n  policy: {\n    auth: 'admin',\n    policies: [{ name: 'platform.knowledge.read', version: 1 }],\n  },\n});\n\nexport const TriggerKnowledgeSourceSync = defineCommand({\n  meta: {\n    name: 'knowledge.source.triggerSync',\n    version: 1,\n    description: 'Trigger an immediate sync for a knowledge source.',\n    goal: 'Support manual or automated sync retries for knowledge ingestion.',\n    context:\n      'Invoked by Ops tooling or monitors when knowledge content must be refreshed or reprocessed.',\n    owners: ['platform.knowledge'],\n    tags: ['knowledge', 'sources'],\n    stability: 'experimental',\n  },\n  io: {\n    input: TriggerKnowledgeSyncInput,\n    output: TriggerKnowledgeSyncOutput,\n  },\n  policy: {\n    auth: 'admin',\n    policies: [{ name: 'platform.knowledge.manage', version: 1 }],\n  },\n});\n\nexport const knowledgeContracts: Record<string, ContractSpec<any, any>> = {\n  CreateKnowledgeSource,\n  UpdateKnowledgeSource,\n  DeleteKnowledgeSource,\n  ListKnowledgeSources,\n  TriggerKnowledgeSourceSync,\n};\n\nexport function registerKnowledgeContracts(registry: SpecRegistry) {\n  return registry\n    .register(CreateKnowledgeSource)\n    .register(UpdateKnowledgeSource)\n    .register(DeleteKnowledgeSource)\n    .register(ListKnowledgeSources)\n    .register(TriggerKnowledgeSourceSync);\n}\n"],"mappings":"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"}

package/dist/knowledge/docs/knowledge.docblock.d.ts

@@ -3,4 +3,5 @@ import { DocBlock } from "@lssm/lib.contracts/docs";
 //#region src/knowledge/docs/knowledge.docblock.d.ts
 declare const tech_contracts_knowledge_DocBlocks: DocBlock[];
 //#endregion
-export { tech_contracts_knowledge_DocBlocks };
+export { tech_contracts_knowledge_DocBlocks };
+//# sourceMappingURL=knowledge.docblock.d.ts.map

package/dist/knowledge/docs/knowledge.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.docblock.d.ts","names":[],"sources":["../../../src/knowledge/docs/knowledge.docblock.ts"],"sourcesContent":[],"mappings":";;;cAGa,oCAAoC"}

package/dist/knowledge/docs/knowledge.docblock.js

@@ -19,4 +19,5 @@ const tech_contracts_knowledge_DocBlocks = [{
 registerDocBlocks(tech_contracts_knowledge_DocBlocks);
 
 //#endregion
-export { tech_contracts_knowledge_DocBlocks };
+export { tech_contracts_knowledge_DocBlocks };
+//# sourceMappingURL=knowledge.docblock.js.map

package/dist/knowledge/docs/knowledge.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.docblock.js","names":["tech_contracts_knowledge_DocBlocks: DocBlock[]"],"sources":["../../../src/knowledge/docs/knowledge.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@lssm/lib.contracts/docs';\nimport { registerDocBlocks } from '../../registry';\n\nexport const tech_contracts_knowledge_DocBlocks: DocBlock[] = [\n  {\n    id: 'docs.tech.contracts.knowledge',\n    title: 'Knowledge Layer',\n    summary:\n      'The knowledge layer turns unstructured inputs (uploads, email threads,',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/tech/contracts/knowledge',\n    tags: ['tech', 'contracts', 'knowledge'],\n    body: \"# Knowledge Layer\\n\\nThe knowledge layer turns unstructured inputs (uploads, email threads,\\nnotes) into searchable context for agents and workflows. The Pocket\\nFamily Office vertical ships a minimal but production-ready stack that\\ncovers ingestion, indexing, querying, and guardrails.\\n\\n## Knowledge Spaces\\n\\nKnowledge is organised via `KnowledgeSpaceSpec` definitions under\\n`packages/libs/contracts/src/knowledge/spaces`:\\n\\n- `knowledge.financial-docs` \\u2013 canonical invoices, bills, and contracts.\\n- `knowledge.email-threads` \\u2013 operational Gmail threads.\\n- `knowledge.support-faq` / `knowledge.product-canon` \\u2013 reusable shared\\n  spaces available to any vertical.\\n\\nEach space defines:\\n\\n- Ownership metadata (domain, owners, stability tags).\\n- Retention policy (TTL/archival).\\n- Access policy (trust level, automation write permissions).\\n- Indexing configuration (embedding model, chunk size, vector DB slot).\\n\\n## Sources & Bindings\\n\\n- `KnowledgeSourceConfig` records tenant-specific connections (bucket,\\n  Gmail labels, sync cadence). Pocket Family Office provides sample\\n  configs in `knowledge/sources.sample.ts`.\\n- `AppKnowledgeBinding` associates spaces with workflows/agents and adds\\n  per-tenant constraints (rate limits, scopes).\\n\\nValidation ensures that:\\n\\n- All referenced spaces exist in the registry.\\n- At least one source is configured per binding.\\n- External/ephemeral spaces trigger warnings for policy-sensitive flows.\\n\\n## Ingestion Pipeline\\n\\nImplemented in `packages/libs/contracts/src/knowledge/ingestion`:\\n\\n1. **DocumentProcessor** \\u2013 pluggable MIME extractors producing\\n   `DocumentFragment`s.\\n2. **EmbeddingService** \\u2013 batches fragments through an `EmbeddingProvider`\\n   (Mistral in the reference implementation).\\n3. **VectorIndexer** \\u2013 upserts fragments into a `VectorStoreProvider`\\n   (Qdrant in production, with in-memory implementations for tests).\\n4. **Adapters**\\n   - `GmailIngestionAdapter`: list threads \\u2192 convert to raw documents \\u2192\\n     index.\\n   - `StorageIngestionAdapter`: fetch object from storage provider \\u2192\\n     index.\\n\\nBackground jobs (see `jobs/`) orchestrate ingestion via Cloud Tasks /\\nPub/Sub or in-memory workers. Handlers:\\n\\n- `storage-document-handler` \\u2013 resolves storage object + indexes.\\n- `gmail-sync-handler` \\u2013 syncs threads based on label/date filters.\\n\\n## Query Service\\n\\n`KnowledgeQueryService` performs retrieval-augmented generation:\\n\\n1. Embed the user query using the configured provider.\\n2. Search the vector store for top-k matches.\\n3. Compose prompts combining system instructions + contextual snippets.\\n4. Invoke the LLM provider (Mistral) and return the answer plus\\n   references and token usage.\\n\\nThe service is designed for tooling: workflows can execute it directly\\nor through custom operations (see `pfo.summary.generate` contract).\\n\\n## Guardrails\\n\\n- Automation can only write to spaces where `automationWritable` is true.\\n- Canonical spaces default to high trust; external/ephemeral spaces are\\n  flagged during validation.\\n- Telemetry captures query volumes per tenant + space.\\n\\n## Extending\\n\\n1. Define a new `KnowledgeSpaceSpec` with indexing/retention policies.\\n2. Add sources pointing to storage providers or APIs.\\n3. Register adapters if ingestion requires bespoke logic.\\n4. Reference the space in blueprints (`AppKnowledgeBinding`) and update\\n   workflows/agents accordingly.\\n\\nThe Pocket Family Office tests (`tests/pocket-family-office.test.ts`)\\nshow how to wire the ingestion pipeline, index a document, and run an\\nend-to-end knowledge query using in-memory providers.\\n## Knowledge Spaces & Guardrails\\n\\nKnowledge surfaces (`KnowledgeSpaceSpec`) describe curated corpora that agents and workflows can consult. Tenant bindings (`AppKnowledgeBinding`) declare which spaces are active, who can use them, and optional usage constraints.\\n\\n### Binding recap\\n\\n- `spaceKey` / `spaceVersion`: pointer to the `KnowledgeSpaceSpec`\\n- `scope.workflows` / `scope.agents`: explicit allow-lists for consumers\\n- `constraints.maxTokensPerQuery` & `constraints.maxQueriesPerMinute`: throttling knobs for LLM-backed search\\n- `required`: mark the binding as blocking (defaults to `true`)\\n\\nAt runtime, `ResolvedAppConfig.knowledge` contains `ResolvedKnowledge` entries with the bound space, active sources, and the binding metadata above.\\n\\n### KnowledgeAccessGuard\\n\\n`KnowledgeAccessGuard` (`@lssm/lib.contracts/knowledge/runtime`) centralises the access checks that must run before any workflow/agent reads or mutates a knowledge space.\\n\\n```ts\\nimport { KnowledgeAccessGuard } from '@lssm/lib.contracts/knowledge/runtime';\\n\\nconst guard = new KnowledgeAccessGuard({\\n  disallowWriteCategories: ['external', 'ephemeral'], // default\\n  requireWorkflowBinding: true,\\n  requireAgentBinding: false,\\n});\\n\\nconst result = guard.checkAccess(resolvedKnowledge, {\\n  tenantId,\\n  appId,\\n  workflowName: 'order-processing',\\n  operation: 'read', // or 'write' / 'search'\\n}, resolvedAppConfig);\\n\\nif (!result.allowed) {\\n  throw new Error(result.reason);\\n}\\n```\\n\\nKey behaviours:\\n\\n- **Binding**: rejects access when the space is not present in the resolved tenant config.\\n- **Category guardrails**: blocks writes to `external` and `ephemeral` spaces by default; allows reads but emits warnings for `ephemeral`.\\n- **Workflow/agent scoping**: when `requireWorkflowBinding` or `requireAgentBinding` is enabled, only explicitly authorised consumers may access the space.\\n\\nUse the guard inside workflow operations or agent resolvers to guarantee multi-tenant isolation and honour data governance rules.\\n\\n\",\n  },\n];\nregisterDocBlocks(tech_contracts_knowledge_DocBlocks);\n"],"mappings":";;;;AAGA,MAAaA,qCAAiD,CAC5D;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAQ;EAAa;EAAY;CACxC,MAAM;CACP,CACF;AACD,kBAAkB,mCAAmC"}

package/dist/knowledge/ingestion/document-processor.d.ts

@@ -21,4 +21,5 @@ declare class DocumentProcessor {
   private extractJson;
 }
 //#endregion
-export { DocumentFragment, DocumentProcessor, RawDocument };
+export { DocumentFragment, DocumentProcessor, RawDocument };
+//# sourceMappingURL=document-processor.d.ts.map

package/dist/knowledge/ingestion/document-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-processor.d.ts","names":[],"sources":["../../../src/knowledge/ingestion/document-processor.ts"],"sourcesContent":[],"mappings":";UAEiB,WAAA;EAAA,EAAA,EAAA,MAAA;EAOA,QAAA,EAAA,MAAA;EAOZ,IAAA,EAXG,UAWM;EAAW,QAAA,CAAA,EAVZ,MAUY,CAAA,MAAA,EAAA,MAAA,CAAA;;AAAgB,UAPxB,gBAAA,CAOwB;EAAO,EAAA,EAAA,MAAA;EAEnC,UAAA,EAAA,MAAA;EAQoC,IAAA,EAAA,MAAA;EAIvB,QAAA,CAAA,EAjBb,MAiBa,CAAA,MAAA,EAAA,MAAA,CAAA;;KAdrB,SAAA,GAcmC,CAAA,KAAA,EAdf,WAce,EAAA,GAdC,OAcD,CAdS,gBAcT,EAAA,CAAA;AAAO,cAZlC,iBAAA,CAYkC;;;iDAJE;oBAIvB,cAAc,QAAQ"}

package/dist/knowledge/ingestion/document-processor.js

@@ -51,4 +51,5 @@ var DocumentProcessor = class {
 };
 
 //#endregion
-export { DocumentProcessor };
+export { DocumentProcessor };
+//# sourceMappingURL=document-processor.js.map

package/dist/knowledge/ingestion/document-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-processor.js","names":[],"sources":["../../../src/knowledge/ingestion/document-processor.ts"],"sourcesContent":["import { Buffer } from 'node:buffer';\n\nexport interface RawDocument {\n  id: string;\n  mimeType: string;\n  data: Uint8Array;\n  metadata?: Record<string, string>;\n}\n\nexport interface DocumentFragment {\n  id: string;\n  documentId: string;\n  text: string;\n  metadata?: Record<string, string>;\n}\n\ntype Extractor = (input: RawDocument) => Promise<DocumentFragment[]>;\n\nexport class DocumentProcessor {\n  private readonly extractors = new Map<string, Extractor>();\n\n  constructor() {\n    this.registerExtractor('text/plain', this.extractText);\n    this.registerExtractor('application/json', this.extractJson);\n  }\n\n  registerExtractor(mimeType: string, extractor: Extractor): void {\n    this.extractors.set(mimeType.toLowerCase(), extractor);\n  }\n\n  async process(document: RawDocument): Promise<DocumentFragment[]> {\n    const extractor =\n      this.extractors.get(document.mimeType.toLowerCase()) ??\n      this.extractors.get('*/*');\n    if (!extractor) {\n      throw new Error(\n        `No extractor registered for mime type ${document.mimeType}`\n      );\n    }\n    const fragments = await extractor(document);\n    if (fragments.length === 0) {\n      return [\n        {\n          id: `${document.id}:0`,\n          documentId: document.id,\n          text: '',\n          metadata: document.metadata,\n        },\n      ];\n    }\n    return fragments;\n  }\n\n  private async extractText(\n    document: RawDocument\n  ): Promise<DocumentFragment[]> {\n    const text = Buffer.from(document.data).toString('utf-8');\n    return [\n      {\n        id: `${document.id}:0`,\n        documentId: document.id,\n        text,\n        metadata: document.metadata,\n      },\n    ];\n  }\n\n  private async extractJson(\n    document: RawDocument\n  ): Promise<DocumentFragment[]> {\n    const text = Buffer.from(document.data).toString('utf-8');\n    try {\n      const json = JSON.parse(text);\n      return [\n        {\n          id: `${document.id}:0`,\n          documentId: document.id,\n          text: JSON.stringify(json, null, 2),\n          metadata: {\n            ...document.metadata,\n            contentType: 'application/json',\n          },\n        },\n      ];\n    } catch {\n      return this.extractText(document);\n    }\n  }\n}\n"],"mappings":";;;AAkBA,IAAa,oBAAb,MAA+B;CAC7B,AAAiB,6BAAa,IAAI,KAAwB;CAE1D,cAAc;AACZ,OAAK,kBAAkB,cAAc,KAAK,YAAY;AACtD,OAAK,kBAAkB,oBAAoB,KAAK,YAAY;;CAG9D,kBAAkB,UAAkB,WAA4B;AAC9D,OAAK,WAAW,IAAI,SAAS,aAAa,EAAE,UAAU;;CAGxD,MAAM,QAAQ,UAAoD;EAChE,MAAM,YACJ,KAAK,WAAW,IAAI,SAAS,SAAS,aAAa,CAAC,IACpD,KAAK,WAAW,IAAI,MAAM;AAC5B,MAAI,CAAC,UACH,OAAM,IAAI,MACR,yCAAyC,SAAS,WACnD;EAEH,MAAM,YAAY,MAAM,UAAU,SAAS;AAC3C,MAAI,UAAU,WAAW,EACvB,QAAO,CACL;GACE,IAAI,GAAG,SAAS,GAAG;GACnB,YAAY,SAAS;GACrB,MAAM;GACN,UAAU,SAAS;GACpB,CACF;AAEH,SAAO;;CAGT,MAAc,YACZ,UAC6B;EAC7B,MAAM,OAAO,OAAO,KAAK,SAAS,KAAK,CAAC,SAAS,QAAQ;AACzD,SAAO,CACL;GACE,IAAI,GAAG,SAAS,GAAG;GACnB,YAAY,SAAS;GACrB;GACA,UAAU,SAAS;GACpB,CACF;;CAGH,MAAc,YACZ,UAC6B;EAC7B,MAAM,OAAO,OAAO,KAAK,SAAS,KAAK,CAAC,SAAS,QAAQ;AACzD,MAAI;GACF,MAAM,OAAO,KAAK,MAAM,KAAK;AAC7B,UAAO,CACL;IACE,IAAI,GAAG,SAAS,GAAG;IACnB,YAAY,SAAS;IACrB,MAAM,KAAK,UAAU,MAAM,MAAM,EAAE;IACnC,UAAU;KACR,GAAG,SAAS;KACZ,aAAa;KACd;IACF,CACF;UACK;AACN,UAAO,KAAK,YAAY,SAAS"}

package/dist/knowledge/ingestion/embedding-service.d.ts

@@ -9,4 +9,5 @@ declare class EmbeddingService {
   embedFragments(fragments: DocumentFragment[]): Promise<EmbeddingResult[]>;
 }
 //#endregion
-export { EmbeddingService };
+export { EmbeddingService };
+//# sourceMappingURL=embedding-service.d.ts.map

package/dist/knowledge/ingestion/embedding-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-service.d.ts","names":[],"sources":["../../../src/knowledge/ingestion/embedding-service.ts"],"sourcesContent":[],"mappings":";;;;cAOa,gBAAA;;EAAA,iBAAA,SAAgB;EAIL,WAAA,CAAA,QAAA,EAAA,iBAAA,EAAA,SAAA,CAAA,EAAA,MAAA;EAMT,cAAA,CAAA,SAAA,EAAA,gBAAA,EAAA,CAAA,EACV,OADU,CACF,eADE,EAAA,CAAA"}

package/dist/knowledge/ingestion/embedding-service.js

@@ -22,4 +22,5 @@ var EmbeddingService = class {
 };
 
 //#endregion
-export { EmbeddingService };
+export { EmbeddingService };
+//# sourceMappingURL=embedding-service.js.map

package/dist/knowledge/ingestion/embedding-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-service.js","names":["results: EmbeddingResult[]","documents: EmbeddingDocument[]"],"sources":["../../../src/knowledge/ingestion/embedding-service.ts"],"sourcesContent":["import type {\n  EmbeddingDocument,\n  EmbeddingProvider,\n  EmbeddingResult,\n} from '../../integrations/providers/embedding';\nimport type { DocumentFragment } from './document-processor';\n\nexport class EmbeddingService {\n  private readonly provider: EmbeddingProvider;\n  private readonly batchSize: number;\n\n  constructor(provider: EmbeddingProvider, batchSize = 16) {\n    this.provider = provider;\n    this.batchSize = batchSize;\n  }\n\n  async embedFragments(\n    fragments: DocumentFragment[]\n  ): Promise<EmbeddingResult[]> {\n    const results: EmbeddingResult[] = [];\n    for (let i = 0; i < fragments.length; i += this.batchSize) {\n      const slice = fragments.slice(i, i + this.batchSize);\n      const documents: EmbeddingDocument[] = slice.map((fragment) => ({\n        id: fragment.id,\n        text: fragment.text,\n        metadata: fragment.metadata,\n      }));\n      const embeddings = await this.provider.embedDocuments(documents);\n      results.push(...embeddings);\n    }\n    return results;\n  }\n}\n"],"mappings":";AAOA,IAAa,mBAAb,MAA8B;CAC5B,AAAiB;CACjB,AAAiB;CAEjB,YAAY,UAA6B,YAAY,IAAI;AACvD,OAAK,WAAW;AAChB,OAAK,YAAY;;CAGnB,MAAM,eACJ,WAC4B;EAC5B,MAAMA,UAA6B,EAAE;AACrC,OAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK,KAAK,WAAW;GAEzD,MAAMC,YADQ,UAAU,MAAM,GAAG,IAAI,KAAK,UAAU,CACP,KAAK,cAAc;IAC9D,IAAI,SAAS;IACb,MAAM,SAAS;IACf,UAAU,SAAS;IACpB,EAAE;GACH,MAAM,aAAa,MAAM,KAAK,SAAS,eAAe,UAAU;AAChE,WAAQ,KAAK,GAAG,WAAW;;AAE7B,SAAO"}

package/dist/knowledge/ingestion/gmail-adapter.d.ts

@@ -15,4 +15,5 @@ declare class GmailIngestionAdapter {
   private toRawDocument;
 }
 //#endregion
-export { GmailIngestionAdapter };
+export { GmailIngestionAdapter };
+//# sourceMappingURL=gmail-adapter.d.ts.map

package/dist/knowledge/ingestion/gmail-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmail-adapter.d.ts","names":[],"sources":["../../../src/knowledge/ingestion/gmail-adapter.ts"],"sourcesContent":[],"mappings":";;;;;;cAQa,qBAAA;;EAAA,iBAAA,SAAqB;EAEN,iBAAA,UAAA;EACI,iBAAA,OAAA;EACC,WAAA,CAAA,KAAA,EAFL,oBAEK,EAAA,SAAA,EADD,iBACC,EAAA,UAAA,EAAA,gBAAA,EAAA,OAAA,EACH,aADG;EACH,WAAA,CAAA,KAAA,CAAA,EAIlB,UAJkB,CAIP,oBAJO,CAAA,aAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAIgC,OAJhC,CAAA,IAAA,CAAA;EAIP,YAAA,CAAA,MAAA,EAQM,WARN,CAAA,EAQiB,OARjB,CAAA,IAAA,CAAA;EAAX,QAAA,aAAA"}

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

@@ -48,4 +48,5 @@ function stripHtml(html) {
 }
 
 //#endregion
-export { GmailIngestionAdapter };
+export { GmailIngestionAdapter };
+//# sourceMappingURL=gmail-adapter.js.map

package/dist/knowledge/ingestion/gmail-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmail-adapter.js","names":["gmail: EmailInboundProvider","processor: DocumentProcessor","embeddings: EmbeddingService","indexer: VectorIndexer"],"sources":["../../../src/knowledge/ingestion/gmail-adapter.ts"],"sourcesContent":["import type {\n  EmailInboundProvider,\n  EmailThread,\n} from '../../integrations/providers/email';\nimport type { DocumentProcessor, RawDocument } from './document-processor';\nimport type { EmbeddingService } from './embedding-service';\nimport type { VectorIndexer } from './vector-indexer';\n\nexport class GmailIngestionAdapter {\n  constructor(\n    private readonly gmail: EmailInboundProvider,\n    private readonly processor: DocumentProcessor,\n    private readonly embeddings: EmbeddingService,\n    private readonly indexer: VectorIndexer\n  ) {}\n\n  async syncThreads(\n    query?: Parameters<EmailInboundProvider['listThreads']>[0]\n  ) {\n    const threads = await this.gmail.listThreads(query);\n    for (const thread of threads) {\n      await this.ingestThread(thread);\n    }\n  }\n\n  async ingestThread(thread: EmailThread) {\n    const document = this.toRawDocument(thread);\n    const fragments = await this.processor.process(document);\n    const embeddings = await this.embeddings.embedFragments(fragments);\n    await this.indexer.upsert(fragments, embeddings);\n  }\n\n  private toRawDocument(thread: EmailThread): RawDocument {\n    const content = composeThreadText(thread);\n    return {\n      id: thread.id,\n      mimeType: 'text/plain',\n      data: Buffer.from(content, 'utf-8'),\n      metadata: {\n        subject: thread.subject ?? '',\n        participants: thread.participants.map((p) => p.email).join(', '),\n        updatedAt: thread.updatedAt.toISOString(),\n      },\n    };\n  }\n}\n\nfunction composeThreadText(thread: EmailThread): string {\n  const header = [\n    `Subject: ${thread.subject ?? ''}`,\n    `Snippet: ${thread.snippet ?? ''}`,\n  ];\n  const messageTexts = thread.messages.map((message) => {\n    const parts = [\n      `From: ${formatAddress(message.from)}`,\n      `To: ${message.to.map(formatAddress).join(', ')}`,\n    ];\n    if (message.sentAt) {\n      parts.push(`Date: ${message.sentAt.toISOString()}`);\n    }\n    const body = message.textBody ?? stripHtml(message.htmlBody ?? '');\n    return `${parts.join('\\n')}\\n\\n${body ?? ''}`;\n  });\n  return [...header, ...messageTexts].join('\\n\\n---\\n\\n');\n}\n\nfunction formatAddress(address: { email: string; name?: string }): string {\n  return address.name ? `${address.name} <${address.email}>` : address.email;\n}\n\nfunction stripHtml(html: string): string {\n  return html.replace(/<[^>]+>/g, ' ');\n}\n"],"mappings":";AAQA,IAAa,wBAAb,MAAmC;CACjC,YACE,AAAiBA,OACjB,AAAiBC,WACjB,AAAiBC,YACjB,AAAiBC,SACjB;EAJiB;EACA;EACA;EACA;;CAGnB,MAAM,YACJ,OACA;EACA,MAAM,UAAU,MAAM,KAAK,MAAM,YAAY,MAAM;AACnD,OAAK,MAAM,UAAU,QACnB,OAAM,KAAK,aAAa,OAAO;;CAInC,MAAM,aAAa,QAAqB;EACtC,MAAM,WAAW,KAAK,cAAc,OAAO;EAC3C,MAAM,YAAY,MAAM,KAAK,UAAU,QAAQ,SAAS;EACxD,MAAM,aAAa,MAAM,KAAK,WAAW,eAAe,UAAU;AAClE,QAAM,KAAK,QAAQ,OAAO,WAAW,WAAW;;CAGlD,AAAQ,cAAc,QAAkC;EACtD,MAAM,UAAU,kBAAkB,OAAO;AACzC,SAAO;GACL,IAAI,OAAO;GACX,UAAU;GACV,MAAM,OAAO,KAAK,SAAS,QAAQ;GACnC,UAAU;IACR,SAAS,OAAO,WAAW;IAC3B,cAAc,OAAO,aAAa,KAAK,MAAM,EAAE,MAAM,CAAC,KAAK,KAAK;IAChE,WAAW,OAAO,UAAU,aAAa;IAC1C;GACF;;;AAIL,SAAS,kBAAkB,QAA6B;CACtD,MAAM,SAAS,CACb,YAAY,OAAO,WAAW,MAC9B,YAAY,OAAO,WAAW,KAC/B;CACD,MAAM,eAAe,OAAO,SAAS,KAAK,YAAY;EACpD,MAAM,QAAQ,CACZ,SAAS,cAAc,QAAQ,KAAK,IACpC,OAAO,QAAQ,GAAG,IAAI,cAAc,CAAC,KAAK,KAAK,GAChD;AACD,MAAI,QAAQ,OACV,OAAM,KAAK,SAAS,QAAQ,OAAO,aAAa,GAAG;EAErD,MAAM,OAAO,QAAQ,YAAY,UAAU,QAAQ,YAAY,GAAG;AAClE,SAAO,GAAG,MAAM,KAAK,KAAK,CAAC,MAAM,QAAQ;GACzC;AACF,QAAO,CAAC,GAAG,QAAQ,GAAG,aAAa,CAAC,KAAK,cAAc;;AAGzD,SAAS,cAAc,SAAmD;AACxE,QAAO,QAAQ,OAAO,GAAG,QAAQ,KAAK,IAAI,QAAQ,MAAM,KAAK,QAAQ;;AAGvE,SAAS,UAAU,MAAsB;AACvC,QAAO,KAAK,QAAQ,YAAY,IAAI"}

package/dist/knowledge/ingestion/storage-adapter.d.ts

@@ -12,4 +12,5 @@ declare class StorageIngestionAdapter {
   ingestObject(object: GetObjectResult): Promise<void>;
 }
 //#endregion
-export { StorageIngestionAdapter };
+export { StorageIngestionAdapter };
+//# sourceMappingURL=storage-adapter.d.ts.map

package/dist/knowledge/ingestion/storage-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-adapter.d.ts","names":[],"sources":["../../../src/knowledge/ingestion/storage-adapter.ts"],"sourcesContent":[],"mappings":";;;;;;cAKa,uBAAA;;EAAA,iBAAA,UAAuB;EAEJ,iBAAA,OAAA;EACC,WAAA,CAAA,SAAA,EADD,iBACC,EAAA,UAAA,EAAA,gBAAA,EAAA,OAAA,EACH,aADG;EACH,YAAA,CAAA,MAAA,EAGD,eAHC,CAAA,EAGiB,OAHjB,CAAA,IAAA,CAAA"}

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

@@ -23,4 +23,5 @@ var StorageIngestionAdapter = class {
 };
 
 //#endregion
-export { StorageIngestionAdapter };
+export { StorageIngestionAdapter };
+//# sourceMappingURL=storage-adapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-adapter.js","names":["processor: DocumentProcessor","embeddings: EmbeddingService","indexer: VectorIndexer"],"sources":["../../../src/knowledge/ingestion/storage-adapter.ts"],"sourcesContent":["import type { GetObjectResult } from '../../integrations/providers/storage';\nimport type { DocumentProcessor } from './document-processor';\nimport type { EmbeddingService } from './embedding-service';\nimport type { VectorIndexer } from './vector-indexer';\n\nexport class StorageIngestionAdapter {\n  constructor(\n    private readonly processor: DocumentProcessor,\n    private readonly embeddings: EmbeddingService,\n    private readonly indexer: VectorIndexer\n  ) {}\n\n  async ingestObject(object: GetObjectResult): Promise<void> {\n    if (!('data' in object) || !object.data) {\n      throw new Error('Storage ingestion requires object data');\n    }\n\n    const raw = {\n      id: object.key,\n      mimeType: object.contentType ?? 'application/octet-stream',\n      data: object.data,\n      metadata: {\n        bucket: object.bucket,\n        checksum: object.checksum ?? '',\n      },\n    };\n\n    const fragments = await this.processor.process(raw);\n    const embeddings = await this.embeddings.embedFragments(fragments);\n    await this.indexer.upsert(fragments, embeddings);\n  }\n}\n"],"mappings":";AAKA,IAAa,0BAAb,MAAqC;CACnC,YACE,AAAiBA,WACjB,AAAiBC,YACjB,AAAiBC,SACjB;EAHiB;EACA;EACA;;CAGnB,MAAM,aAAa,QAAwC;AACzD,MAAI,EAAE,UAAU,WAAW,CAAC,OAAO,KACjC,OAAM,IAAI,MAAM,yCAAyC;EAG3D,MAAM,MAAM;GACV,IAAI,OAAO;GACX,UAAU,OAAO,eAAe;GAChC,MAAM,OAAO;GACb,UAAU;IACR,QAAQ,OAAO;IACf,UAAU,OAAO,YAAY;IAC9B;GACF;EAED,MAAM,YAAY,MAAM,KAAK,UAAU,QAAQ,IAAI;EACnD,MAAM,aAAa,MAAM,KAAK,WAAW,eAAe,UAAU;AAClE,QAAM,KAAK,QAAQ,OAAO,WAAW,WAAW"}

package/dist/knowledge/ingestion/vector-indexer.d.ts

@@ -15,4 +15,5 @@ declare class VectorIndexer {
   upsert(fragments: DocumentFragment[], embeddings: EmbeddingResult[]): Promise<void>;
 }
 //#endregion
-export { VectorIndexConfig, VectorIndexer };
+export { VectorIndexConfig, VectorIndexer };
+//# sourceMappingURL=vector-indexer.d.ts.map

package/dist/knowledge/ingestion/vector-indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-indexer.d.ts","names":[],"sources":["../../../src/knowledge/ingestion/vector-indexer.ts"],"sourcesContent":[],"mappings":";;;;;UAOiB,iBAAA;;EAAA,SAAA,CAAA,EAAA,MAAA;EAMJ,QAAA,CAAA,EAHA,MAGa,CAAA,MAAA,EAAA,MAAA,CAAA;;AAI2B,cAJxC,aAAA,CAIwC;EAMtC,iBAAA,QAAA;EACC,iBAAA,MAAA;EACX,WAAA,CAAA,QAAA,EARmB,mBAQnB,EAAA,MAAA,EARgD,iBAQhD;EAAO,MAAA,CAAA,SAAA,EAFG,gBAEH,EAAA,EAAA,UAAA,EADI,eACJ,EAAA,CAAA,EAAP,OAAO,CAAA,IAAA,CAAA"}

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

@@ -29,4 +29,5 @@ var VectorIndexer = class {
 };
 
 //#endregion
-export { VectorIndexer };
+export { VectorIndexer };
+//# sourceMappingURL=vector-indexer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vector-indexer.js","names":["request: VectorUpsertRequest"],"sources":["../../../src/knowledge/ingestion/vector-indexer.ts"],"sourcesContent":["import type {\n  VectorStoreProvider,\n  VectorUpsertRequest,\n} from '../../integrations/providers/vector-store';\nimport type { EmbeddingResult } from '../../integrations/providers/embedding';\nimport type { DocumentFragment } from './document-processor';\n\nexport interface VectorIndexConfig {\n  collection: string;\n  namespace?: string;\n  metadata?: Record<string, string>;\n}\n\nexport class VectorIndexer {\n  private readonly provider: VectorStoreProvider;\n  private readonly config: VectorIndexConfig;\n\n  constructor(provider: VectorStoreProvider, config: VectorIndexConfig) {\n    this.provider = provider;\n    this.config = config;\n  }\n\n  async upsert(\n    fragments: DocumentFragment[],\n    embeddings: EmbeddingResult[]\n  ): Promise<void> {\n    const documents = embeddings.map((embedding) => {\n      const fragment = fragments.find((f) => f.id === embedding.id);\n      return {\n        id: embedding.id,\n        vector: embedding.vector,\n        payload: {\n          ...this.config.metadata,\n          ...(fragment?.metadata ?? {}),\n          documentId: fragment?.documentId,\n        },\n        namespace: this.config.namespace,\n      };\n    });\n\n    const request: VectorUpsertRequest = {\n      collection: this.config.collection,\n      documents,\n    };\n\n    await this.provider.upsert(request);\n  }\n}\n"],"mappings":";AAaA,IAAa,gBAAb,MAA2B;CACzB,AAAiB;CACjB,AAAiB;CAEjB,YAAY,UAA+B,QAA2B;AACpE,OAAK,WAAW;AAChB,OAAK,SAAS;;CAGhB,MAAM,OACJ,WACA,YACe;EACf,MAAM,YAAY,WAAW,KAAK,cAAc;GAC9C,MAAM,WAAW,UAAU,MAAM,MAAM,EAAE,OAAO,UAAU,GAAG;AAC7D,UAAO;IACL,IAAI,UAAU;IACd,QAAQ,UAAU;IAClB,SAAS;KACP,GAAG,KAAK,OAAO;KACf,GAAI,UAAU,YAAY,EAAE;KAC5B,YAAY,UAAU;KACvB;IACD,WAAW,KAAK,OAAO;IACxB;IACD;EAEF,MAAMA,UAA+B;GACnC,YAAY,KAAK,OAAO;GACxB;GACD;AAED,QAAM,KAAK,SAAS,OAAO,QAAQ"}

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

@@ -26,4 +26,5 @@ declare class KnowledgeQueryService {
   private buildMessages;
 }
 //#endregion
-export { KnowledgeAnswer, KnowledgeQueryConfig, KnowledgeQueryService };
+export { KnowledgeAnswer, KnowledgeQueryConfig, KnowledgeQueryService };
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","names":[],"sources":["../../../src/knowledge/query/service.ts"],"sourcesContent":[],"mappings":";;;;;UAWiB,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"}

package/dist/knowledge/query/service.js

@@ -62,4 +62,5 @@ function extractText(result) {
 }
 
 //#endregion
-export { KnowledgeQueryService };
+export { KnowledgeQueryService };
+//# sourceMappingURL=service.js.map

package/dist/knowledge/query/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","names":[],"sources":["../../../src/knowledge/query/service.ts"],"sourcesContent":["import type { EmbeddingProvider } from '../../integrations/providers/embedding';\nimport type {\n  VectorStoreProvider,\n  VectorSearchResult,\n} from '../../integrations/providers/vector-store';\nimport type {\n  LLMProvider,\n  LLMMessage,\n  LLMResponse,\n} from '../../integrations/providers/llm';\n\nexport interface KnowledgeQueryConfig {\n  collection: string;\n  namespace?: string;\n  topK?: number;\n  systemPrompt?: string;\n}\n\nexport interface KnowledgeAnswer {\n  answer: string;\n  references: (VectorSearchResult & {\n    text?: string;\n  })[];\n  usage?: LLMResponse['usage'];\n}\n\nexport class KnowledgeQueryService {\n  private readonly embeddings: EmbeddingProvider;\n  private readonly vectorStore: VectorStoreProvider;\n  private readonly llm: LLMProvider;\n  private readonly config: KnowledgeQueryConfig;\n\n  constructor(\n    embeddings: EmbeddingProvider,\n    vectorStore: VectorStoreProvider,\n    llm: LLMProvider,\n    config: KnowledgeQueryConfig\n  ) {\n    this.embeddings = embeddings;\n    this.vectorStore = vectorStore;\n    this.llm = llm;\n    this.config = config;\n  }\n\n  async query(question: string): Promise<KnowledgeAnswer> {\n    const embedding = await this.embeddings.embedQuery(question);\n    const results = await this.vectorStore.search({\n      collection: this.config.collection,\n      vector: embedding.vector,\n      topK: this.config.topK ?? 5,\n      namespace: this.config.namespace,\n      filter: undefined,\n    });\n    const context = buildContext(results);\n    const messages = this.buildMessages(question, context);\n    const response = await this.llm.chat(messages);\n    return {\n      answer: response.message.content\n        .map((part) => ('text' in part ? part.text : ''))\n        .join(''),\n      references: results.map((result) => ({\n        ...result,\n        text: extractText(result),\n      })),\n      usage: response.usage,\n    };\n  }\n\n  private buildMessages(question: string, context: string): LLMMessage[] {\n    const systemPrompt =\n      this.config.systemPrompt ??\n      'You are a knowledge assistant that answers questions using the provided context. Cite relevant sources if possible.';\n    return [\n      {\n        role: 'system',\n        content: [{ type: 'text', text: systemPrompt }],\n      },\n      {\n        role: 'user',\n        content: [\n          {\n            type: 'text',\n            text: `Question:\\n${question}\\n\\nContext:\\n${context}`,\n          },\n        ],\n      },\n    ];\n  }\n}\n\nfunction buildContext(results: VectorSearchResult[]): string {\n  if (results.length === 0) {\n    return 'No relevant documents found.';\n  }\n  return results\n    .map((result, index) => {\n      const text = extractText(result);\n      return `Source ${index + 1} (score: ${result.score.toFixed(3)}):\\n${text}`;\n    })\n    .join('\\n\\n');\n}\n\nfunction extractText(result: VectorSearchResult): string {\n  const payload = result.payload ?? {};\n  if (typeof payload.text === 'string') return payload.text;\n  if (typeof payload.content === 'string') return payload.content;\n  return JSON.stringify(payload);\n}\n"],"mappings":";AA0BA,IAAa,wBAAb,MAAmC;CACjC,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,YACE,YACA,aACA,KACA,QACA;AACA,OAAK,aAAa;AAClB,OAAK,cAAc;AACnB,OAAK,MAAM;AACX,OAAK,SAAS;;CAGhB,MAAM,MAAM,UAA4C;EACtD,MAAM,YAAY,MAAM,KAAK,WAAW,WAAW,SAAS;EAC5D,MAAM,UAAU,MAAM,KAAK,YAAY,OAAO;GAC5C,YAAY,KAAK,OAAO;GACxB,QAAQ,UAAU;GAClB,MAAM,KAAK,OAAO,QAAQ;GAC1B,WAAW,KAAK,OAAO;GACvB,QAAQ;GACT,CAAC;EACF,MAAM,UAAU,aAAa,QAAQ;EACrC,MAAM,WAAW,KAAK,cAAc,UAAU,QAAQ;EACtD,MAAM,WAAW,MAAM,KAAK,IAAI,KAAK,SAAS;AAC9C,SAAO;GACL,QAAQ,SAAS,QAAQ,QACtB,KAAK,SAAU,UAAU,OAAO,KAAK,OAAO,GAAI,CAChD,KAAK,GAAG;GACX,YAAY,QAAQ,KAAK,YAAY;IACnC,GAAG;IACH,MAAM,YAAY,OAAO;IAC1B,EAAE;GACH,OAAO,SAAS;GACjB;;CAGH,AAAQ,cAAc,UAAkB,SAA+B;AAIrE,SAAO,CACL;GACE,MAAM;GACN,SAAS,CAAC;IAAE,MAAM;IAAQ,MAL5B,KAAK,OAAO,gBACZ;IAIgD,CAAC;GAChD,EACD;GACE,MAAM;GACN,SAAS,CACP;IACE,MAAM;IACN,MAAM,cAAc,SAAS,gBAAgB;IAC9C,CACF;GACF,CACF;;;AAIL,SAAS,aAAa,SAAuC;AAC3D,KAAI,QAAQ,WAAW,EACrB,QAAO;AAET,QAAO,QACJ,KAAK,QAAQ,UAAU;EACtB,MAAM,OAAO,YAAY,OAAO;AAChC,SAAO,UAAU,QAAQ,EAAE,WAAW,OAAO,MAAM,QAAQ,EAAE,CAAC,MAAM;GACpE,CACD,KAAK,OAAO;;AAGjB,SAAS,YAAY,QAAoC;CACvD,MAAM,UAAU,OAAO,WAAW,EAAE;AACpC,KAAI,OAAO,QAAQ,SAAS,SAAU,QAAO,QAAQ;AACrD,KAAI,OAAO,QAAQ,YAAY,SAAU,QAAO,QAAQ;AACxD,QAAO,KAAK,UAAU,QAAQ"}

package/dist/knowledge/runtime.d.ts

@@ -29,4 +29,5 @@ declare class KnowledgeAccessGuard {
   private isSpaceBound;
 }
 //#endregion
-export { KnowledgeAccessContext, KnowledgeAccessGuard, KnowledgeAccessGuardOptions, KnowledgeAccessResult };
+export { KnowledgeAccessContext, KnowledgeAccessGuard, KnowledgeAccessGuardOptions, KnowledgeAccessResult };
+//# sourceMappingURL=runtime.d.ts.map

package/dist/knowledge/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","names":[],"sources":["../../src/knowledge/runtime.ts"],"sourcesContent":[],"mappings":";;;;UAMiB,sBAAA;;EAAA,KAAA,EAAA,MAAA;EASA,WAAA,CAAA,EAAA,MAAA;EAMA,YAAA,CAAA,EAAA,MAAA;EAQJ,SAAA,CAAA,EAAA,MAAA;EAKU,SAAA,EAAA,MAAA,GAAA,OAAA,GAAA,QAAA;;AAUV,UA7BI,qBAAA,CA6BJ;EACE,OAAA,EAAA,OAAA;EACV,MAAA,CAAA,EAAA,MAAA;EAAqB,QAAA,CAAA,EAAA,OAAA,GAAA,SAAA;;UAzBT,2BAAA;4BACW;;;;cAOf,oBAAA;;;;wBAKU;4BASL,4BACL,mCACE,oBACV"}

package/dist/knowledge/runtime.js

@@ -46,4 +46,5 @@ var KnowledgeAccessGuard = class {
 };
 
 //#endregion
-export { KnowledgeAccessGuard };
+export { KnowledgeAccessGuard };
+//# sourceMappingURL=runtime.js.map

package/dist/knowledge/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","names":["DEFAULT_DISALLOWED_WRITE: KnowledgeCategory[]"],"sources":["../../src/knowledge/runtime.ts"],"sourcesContent":["import type {\n  ResolvedAppConfig,\n  ResolvedKnowledge,\n} from '../app-config/runtime';\nimport type { KnowledgeCategory } from './spec';\n\nexport interface KnowledgeAccessContext {\n  tenantId: string;\n  appId: string;\n  environment?: string;\n  workflowName?: string;\n  agentName?: string;\n  operation: 'read' | 'write' | 'search';\n}\n\nexport interface KnowledgeAccessResult {\n  allowed: boolean;\n  reason?: string;\n  severity?: 'error' | 'warning';\n}\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":";AA2BA,MAAMA,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"}

package/dist/knowledge/source.d.ts

@@ -29,4 +29,5 @@ interface KnowledgeSourceConfig {
   };
 }
 //#endregion
-export { KnowledgeSourceConfig, KnowledgeSourceMeta, KnowledgeSourceType };
+export { KnowledgeSourceConfig, KnowledgeSourceMeta, KnowledgeSourceType };
+//# sourceMappingURL=source.d.ts.map

package/dist/knowledge/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","names":[],"sources":["../../src/knowledge/source.ts"],"sourcesContent":[],"mappings":";KAAY,mBAAA;AAAA,UAQK,mBAAA,CARc;EAQd,EAAA,EAAA,MAAA;EAMH,QAAA,EAAA,MAAA;EACQ,QAAA,EAAA,MAAA;EACA,YAAA,EAAA,MAAA;EAAI,KAAA,EAAA,MAAA;EAGT,UAAA,EALH,mBAKwB;EAC9B,SAAA,EAAA,MAAA,GALc,IAKd;EAEE,SAAA,EAAA,MAAA,GANY,IAMZ;;AASS,UAZF,qBAAA,CAYE;QAXX;;UAEE;;;;;;;;;eASK"}

package/dist/knowledge/spaces/email-threads.d.ts

@@ -4,4 +4,5 @@ import { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from "../spec.js";
 declare const emailThreadsKnowledgeSpace: KnowledgeSpaceSpec;
 declare function registerEmailThreadsKnowledgeSpace(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry;
 //#endregion
-export { emailThreadsKnowledgeSpace, registerEmailThreadsKnowledgeSpace };
+export { emailThreadsKnowledgeSpace, registerEmailThreadsKnowledgeSpace };
+//# sourceMappingURL=email-threads.d.ts.map

package/dist/knowledge/spaces/email-threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-threads.d.ts","names":[],"sources":["../../../src/knowledge/spaces/email-threads.ts"],"sourcesContent":[],"mappings":";;;cAGa,4BAA4B;iBA+BzB,kCAAA,WACJ,yBACT"}

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

@@ -35,4 +35,5 @@ function registerEmailThreadsKnowledgeSpace(registry) {
 }
 
 //#endregion
-export { emailThreadsKnowledgeSpace, registerEmailThreadsKnowledgeSpace };
+export { emailThreadsKnowledgeSpace, registerEmailThreadsKnowledgeSpace };
+//# sourceMappingURL=email-threads.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"email-threads.js","names":["emailThreadsKnowledgeSpace: KnowledgeSpaceSpec"],"sources":["../../../src/knowledge/spaces/email-threads.ts"],"sourcesContent":["import { StabilityEnum } from '../../ownership';\nimport type { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from '../spec';\n\nexport const emailThreadsKnowledgeSpace: KnowledgeSpaceSpec = {\n  meta: {\n    key: 'knowledge.email-threads',\n    version: 1,\n    category: 'operational',\n    displayName: 'Email Threads',\n    title: 'Operational Email Threads',\n    description:\n      'Indexed copies of operational email threads used for support, onboarding, and workflows.',\n    domain: 'operations',\n    owners: ['platform.operations'],\n    tags: ['email', 'operations'],\n    stability: StabilityEnum.Beta,\n  },\n  retention: {\n    ttlDays: 365,\n  },\n  access: {\n    policy: { name: 'knowledge.access.email-threads', version: 1 },\n    trustLevel: 'medium',\n    automationWritable: true,\n  },\n  indexing: {\n    embeddingModel: 'mistral-embed',\n    chunkSize: 600,\n    vectorDbIntegration: 'vectordb.qdrant',\n  },\n  description:\n    'Operational email threads synchronized from Gmail to support automations and contextual assistance.',\n};\n\nexport function registerEmailThreadsKnowledgeSpace(\n  registry: KnowledgeSpaceRegistry\n): KnowledgeSpaceRegistry {\n  return registry.register(emailThreadsKnowledgeSpace);\n}\n"],"mappings":";;;AAGA,MAAaA,6BAAiD;CAC5D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,UAAU;EACV,aAAa;EACb,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,sBAAsB;EAC/B,MAAM,CAAC,SAAS,aAAa;EAC7B,WAAW,cAAc;EAC1B;CACD,WAAW,EACT,SAAS,KACV;CACD,QAAQ;EACN,QAAQ;GAAE,MAAM;GAAkC,SAAS;GAAG;EAC9D,YAAY;EACZ,oBAAoB;EACrB;CACD,UAAU;EACR,gBAAgB;EAChB,WAAW;EACX,qBAAqB;EACtB;CACD,aACE;CACH;AAED,SAAgB,mCACd,UACwB;AACxB,QAAO,SAAS,SAAS,2BAA2B"}

package/dist/knowledge/spaces/financial-docs.d.ts

@@ -4,4 +4,5 @@ import { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from "../spec.js";
 declare const financialDocsKnowledgeSpace: KnowledgeSpaceSpec;
 declare function registerFinancialDocsKnowledgeSpace(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry;
 //#endregion
-export { financialDocsKnowledgeSpace, registerFinancialDocsKnowledgeSpace };
+export { financialDocsKnowledgeSpace, registerFinancialDocsKnowledgeSpace };
+//# sourceMappingURL=financial-docs.d.ts.map

package/dist/knowledge/spaces/financial-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"financial-docs.d.ts","names":[],"sources":["../../../src/knowledge/spaces/financial-docs.ts"],"sourcesContent":[],"mappings":";;;cAGa,6BAA6B;iBA+B1B,mCAAA,WACJ,yBACT"}

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

@@ -35,4 +35,5 @@ function registerFinancialDocsKnowledgeSpace(registry) {
 }
 
 //#endregion
-export { financialDocsKnowledgeSpace, registerFinancialDocsKnowledgeSpace };
+export { financialDocsKnowledgeSpace, registerFinancialDocsKnowledgeSpace };
+//# sourceMappingURL=financial-docs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"financial-docs.js","names":["financialDocsKnowledgeSpace: KnowledgeSpaceSpec"],"sources":["../../../src/knowledge/spaces/financial-docs.ts"],"sourcesContent":["import { StabilityEnum } from '../../ownership';\nimport type { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from '../spec';\n\nexport const financialDocsKnowledgeSpace: KnowledgeSpaceSpec = {\n  meta: {\n    key: 'knowledge.financial-docs',\n    version: 1,\n    category: 'canonical',\n    displayName: 'Financial Documents',\n    title: 'Household Financial Documents',\n    description:\n      'Invoices, bills, and contracts powering Pocket Family Office financial automation.',\n    domain: 'finance',\n    owners: ['platform.finance'],\n    tags: ['finance', 'documents'],\n    stability: StabilityEnum.Beta,\n  },\n  retention: {\n    ttlDays: null,\n  },\n  access: {\n    policy: { name: 'knowledge.access.financial-docs', version: 1 },\n    trustLevel: 'high',\n    automationWritable: true,\n  },\n  indexing: {\n    embeddingModel: 'mistral-embed',\n    chunkSize: 700,\n    vectorDbIntegration: 'vectordb.qdrant',\n  },\n  description:\n    'Normalized financial documents enabling bill pay automation, reminders, and summaries.',\n};\n\nexport function registerFinancialDocsKnowledgeSpace(\n  registry: KnowledgeSpaceRegistry\n): KnowledgeSpaceRegistry {\n  return registry.register(financialDocsKnowledgeSpace);\n}\n"],"mappings":";;;AAGA,MAAaA,8BAAkD;CAC7D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,UAAU;EACV,aAAa;EACb,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,mBAAmB;EAC5B,MAAM,CAAC,WAAW,YAAY;EAC9B,WAAW,cAAc;EAC1B;CACD,WAAW,EACT,SAAS,MACV;CACD,QAAQ;EACN,QAAQ;GAAE,MAAM;GAAmC,SAAS;GAAG;EAC/D,YAAY;EACZ,oBAAoB;EACrB;CACD,UAAU;EACR,gBAAgB;EAChB,WAAW;EACX,qBAAqB;EACtB;CACD,aACE;CACH;AAED,SAAgB,oCACd,UACwB;AACxB,QAAO,SAAS,SAAS,4BAA4B"}

package/dist/knowledge/spaces/financial-overview.d.ts

@@ -4,4 +4,5 @@ import { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from "../spec.js";
 declare const financialOverviewKnowledgeSpace: KnowledgeSpaceSpec;
 declare function registerFinancialOverviewKnowledgeSpace(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry;
 //#endregion
-export { financialOverviewKnowledgeSpace, registerFinancialOverviewKnowledgeSpace };
+export { financialOverviewKnowledgeSpace, registerFinancialOverviewKnowledgeSpace };
+//# sourceMappingURL=financial-overview.d.ts.map

package/dist/knowledge/spaces/financial-overview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"financial-overview.d.ts","names":[],"sources":["../../../src/knowledge/spaces/financial-overview.ts"],"sourcesContent":[],"mappings":";;;cAGa,iCAAiC;iBA+B9B,uCAAA,WACJ,yBACT"}

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

@@ -39,4 +39,5 @@ function registerFinancialOverviewKnowledgeSpace(registry) {
 }
 
 //#endregion
-export { financialOverviewKnowledgeSpace, registerFinancialOverviewKnowledgeSpace };
+export { financialOverviewKnowledgeSpace, registerFinancialOverviewKnowledgeSpace };
+//# sourceMappingURL=financial-overview.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"financial-overview.js","names":["financialOverviewKnowledgeSpace: KnowledgeSpaceSpec"],"sources":["../../../src/knowledge/spaces/financial-overview.ts"],"sourcesContent":["import { StabilityEnum } from '../../ownership';\nimport type { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from '../spec';\n\nexport const financialOverviewKnowledgeSpace: KnowledgeSpaceSpec = {\n  meta: {\n    key: 'knowledge.financial-overview',\n    version: 1,\n    category: 'operational',\n    displayName: 'Financial Overview Summaries',\n    title: 'Derived Financial Summaries',\n    description:\n      'Aggregated cashflow summaries, category breakdowns, and balance trends derived from open banking data.',\n    domain: 'finance',\n    owners: ['platform.finance'],\n    tags: ['open-banking', 'summaries', 'cashflow'],\n    stability: StabilityEnum.Experimental,\n  },\n  retention: {\n    ttlDays: 180,\n  },\n  access: {\n    policy: { name: 'knowledge.access.financial-overview', version: 1 },\n    trustLevel: 'medium',\n    automationWritable: true,\n  },\n  indexing: {\n    embeddingModel: 'mistral-embed',\n    chunkSize: 600,\n    vectorDbIntegration: 'vectordb.qdrant',\n  },\n  description:\n    'Derived knowledge space containing weekly/monthly cashflow rollups and account health summaries. Raw transactions are excluded to respect privacy guardrails.',\n};\n\nexport function registerFinancialOverviewKnowledgeSpace(\n  registry: KnowledgeSpaceRegistry\n): KnowledgeSpaceRegistry {\n  return registry.register(financialOverviewKnowledgeSpace);\n}\n"],"mappings":";;;AAGA,MAAaA,kCAAsD;CACjE,MAAM;EACJ,KAAK;EACL,SAAS;EACT,UAAU;EACV,aAAa;EACb,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,mBAAmB;EAC5B,MAAM;GAAC;GAAgB;GAAa;GAAW;EAC/C,WAAW,cAAc;EAC1B;CACD,WAAW,EACT,SAAS,KACV;CACD,QAAQ;EACN,QAAQ;GAAE,MAAM;GAAuC,SAAS;GAAG;EACnE,YAAY;EACZ,oBAAoB;EACrB;CACD,UAAU;EACR,gBAAgB;EAChB,WAAW;EACX,qBAAqB;EACtB;CACD,aACE;CACH;AAED,SAAgB,wCACd,UACwB;AACxB,QAAO,SAAS,SAAS,gCAAgC"}