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

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"}

package/dist/knowledge/spaces/product-canon.d.ts

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

package/dist/knowledge/spaces/product-canon.d.ts.map

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

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

@@ -35,4 +35,5 @@ function registerProductCanonKnowledgeSpace(registry) {
 }
 
 //#endregion
-export { productCanonKnowledgeSpace, registerProductCanonKnowledgeSpace };
+export { productCanonKnowledgeSpace, registerProductCanonKnowledgeSpace };
+//# sourceMappingURL=product-canon.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"product-canon.js","names":["productCanonKnowledgeSpace: KnowledgeSpaceSpec"],"sources":["../../../src/knowledge/spaces/product-canon.ts"],"sourcesContent":["import { StabilityEnum } from '../../ownership';\nimport type { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from '../spec';\n\nexport const productCanonKnowledgeSpace: KnowledgeSpaceSpec = {\n  meta: {\n    key: 'knowledge.product-canon',\n    version: 1,\n    category: 'canonical',\n    displayName: 'Product Canon',\n    title: 'Product Canon Knowledge Space',\n    description:\n      'Authoritative product knowledge covering strategy, roadmap, and delivery canon.',\n    domain: 'product',\n    owners: ['platform.product'],\n    tags: ['knowledge', 'product'],\n    stability: StabilityEnum.Stable,\n  },\n  retention: {\n    ttlDays: null,\n  },\n  access: {\n    policy: { name: 'knowledge.access.product-canon', version: 1 },\n    trustLevel: 'high',\n    automationWritable: false,\n  },\n  indexing: {\n    embeddingModel: 'text-embedding-3-large',\n    chunkSize: 800,\n    vectorDbIntegration: 'vectordb.qdrant',\n  },\n  description:\n    'Single source of truth for product canon, principles, and strategic narratives.',\n};\n\nexport function registerProductCanonKnowledgeSpace(\n  registry: KnowledgeSpaceRegistry\n): KnowledgeSpaceRegistry {\n  return registry.register(productCanonKnowledgeSpace);\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,mBAAmB;EAC5B,MAAM,CAAC,aAAa,UAAU;EAC9B,WAAW,cAAc;EAC1B;CACD,WAAW,EACT,SAAS,MACV;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/support-faq.d.ts

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

package/dist/knowledge/spaces/support-faq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-faq.d.ts","names":[],"sources":["../../../src/knowledge/spaces/support-faq.ts"],"sourcesContent":[],"mappings":";;;cAGa,0BAA0B;iBA+BvB,gCAAA,WACJ,yBACT"}

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

@@ -38,4 +38,5 @@ function registerSupportFaqKnowledgeSpace(registry) {
 }
 
 //#endregion
-export { registerSupportFaqKnowledgeSpace, supportFaqKnowledgeSpace };
+export { registerSupportFaqKnowledgeSpace, supportFaqKnowledgeSpace };
+//# sourceMappingURL=support-faq.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"support-faq.js","names":["supportFaqKnowledgeSpace: KnowledgeSpaceSpec"],"sources":["../../../src/knowledge/spaces/support-faq.ts"],"sourcesContent":["import { StabilityEnum } from '../../ownership';\nimport type { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from '../spec';\n\nexport const supportFaqKnowledgeSpace: KnowledgeSpaceSpec = {\n  meta: {\n    key: 'knowledge.support-faq',\n    version: 1,\n    category: 'operational',\n    displayName: 'Support FAQ',\n    title: 'Support & Success FAQ',\n    description: 'Operational knowledge base for customer support and success.',\n    domain: 'support',\n    owners: ['platform.support'],\n    tags: ['knowledge', 'support'],\n    stability: StabilityEnum.Beta,\n  },\n  retention: {\n    ttlDays: 365,\n    archiveAfterDays: 180,\n  },\n  access: {\n    policy: { name: 'knowledge.access.support', version: 1 },\n    trustLevel: 'medium',\n    automationWritable: true,\n  },\n  indexing: {\n    embeddingModel: 'text-embedding-3-small',\n    chunkSize: 700,\n    vectorDbIntegration: 'vectordb.qdrant',\n  },\n  description:\n    'Operational FAQs, runbooks, and customer success playbooks augmented with automation updates.',\n};\n\nexport function registerSupportFaqKnowledgeSpace(\n  registry: KnowledgeSpaceRegistry\n): KnowledgeSpaceRegistry {\n  return registry.register(supportFaqKnowledgeSpace);\n}\n"],"mappings":";;;AAGA,MAAaA,2BAA+C;CAC1D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,UAAU;EACV,aAAa;EACb,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,mBAAmB;EAC5B,MAAM,CAAC,aAAa,UAAU;EAC9B,WAAW,cAAc;EAC1B;CACD,WAAW;EACT,SAAS;EACT,kBAAkB;EACnB;CACD,QAAQ;EACN,QAAQ;GAAE,MAAM;GAA4B,SAAS;GAAG;EACxD,YAAY;EACZ,oBAAoB;EACrB;CACD,UAAU;EACR,gBAAgB;EAChB,WAAW;EACX,qBAAqB;EACtB;CACD,aACE;CACH;AAED,SAAgB,iCACd,UACwB;AACxB,QAAO,SAAS,SAAS,yBAAyB"}

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"uploaded-docs.js","names":["uploadedDocsKnowledgeSpace: KnowledgeSpaceSpec"],"sources":["../../../src/knowledge/spaces/uploaded-docs.ts"],"sourcesContent":["import { StabilityEnum } from '../../ownership';\nimport type { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from '../spec';\n\nexport const uploadedDocsKnowledgeSpace: KnowledgeSpaceSpec = {\n  meta: {\n    key: 'knowledge.uploaded-docs',\n    version: 1,\n    category: 'external',\n    displayName: 'Uploaded Documents',\n    title: 'Uploaded Knowledge Assets',\n    description:\n      'Documents uploaded by households, including invoices, contracts, and reference files.',\n    domain: 'operations',\n    owners: ['platform.operations'],\n    tags: ['documents', 'storage'],\n    stability: StabilityEnum.Beta,\n  },\n  retention: {\n    ttlDays: null,\n  },\n  access: {\n    policy: { name: 'knowledge.access.uploaded-docs', version: 1 },\n    trustLevel: 'medium',\n    automationWritable: true,\n  },\n  indexing: {\n    embeddingModel: 'mistral-embed',\n    chunkSize: 900,\n    vectorDbIntegration: 'vectordb.qdrant',\n  },\n  description:\n    'User-provided documents normalized and embedded for retrieval augmented workflows.',\n};\n\nexport function registerUploadedDocsKnowledgeSpace(\n  registry: KnowledgeSpaceRegistry\n): KnowledgeSpaceRegistry {\n  return registry.register(uploadedDocsKnowledgeSpace);\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,aAAa,UAAU;EAC9B,WAAW,cAAc;EAC1B;CACD,WAAW,EACT,SAAS,MACV;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/spec.d.ts

@@ -49,4 +49,5 @@ declare class KnowledgeSpaceRegistry {
 }
 declare function makeKnowledgeSpaceKey(meta: KnowledgeSpaceMeta): string;
 //#endregion
-export { KnowledgeAccessPolicy, KnowledgeCategory, KnowledgeIndexingConfig, KnowledgeRetentionPolicy, KnowledgeSpaceMeta, KnowledgeSpaceRegistry, KnowledgeSpaceSpec, makeKnowledgeSpaceKey };
+export { KnowledgeAccessPolicy, KnowledgeCategory, KnowledgeIndexingConfig, KnowledgeRetentionPolicy, KnowledgeSpaceMeta, KnowledgeSpaceRegistry, KnowledgeSpaceSpec, makeKnowledgeSpaceKey };
+//# sourceMappingURL=spec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","names":[],"sources":["../../src/knowledge/spec.ts"],"sourcesContent":[],"mappings":";;;;KAGY,iBAAA;UAMK,kBAAA,SAA2B;EANhC;EAMK,GAAA,EAAA,MAAA;EAQA,OAAA,EAAA,MAAA;EAOA,QAAA,EAXL,iBAW0B;EASrB,WAAA,EAAA,MAAA;AAMjB;AACQ,UAvBS,wBAAA,CAuBT;EAEK;EAEH,OAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAEG;EAAuB,gBAAA,CAAA,EAAA,MAAA;AAQpC;AAGiB,UAjCA,qBAAA,CAiCA;EASP;EAI4B,MAAA,CAAA,EA5C3B,SA4C2B;EAgBZ;EAAoB,UAAA,EAAA,MAAA,GAAA,QAAA,GAAA,KAAA;EAAkB;EAKhD,kBAAA,EAAA,OAAqB;;UA1DpB,uBAAA;;;;;UAMA,kBAAA;QACT;;aAEK;;UAEH;;aAEG;;;;cAQA,sBAAA;;iBAGI;UASP;sCAI4B;0BAgBZ,oBAAoB;;iBAK9B,qBAAA,OAA4B"}

package/dist/knowledge/spec.js

@@ -36,4 +36,5 @@ function makeKnowledgeSpaceKey(meta) {
 }
 
 //#endregion
-export { KnowledgeSpaceRegistry, makeKnowledgeSpaceKey };
+export { KnowledgeSpaceRegistry, makeKnowledgeSpaceKey };
+//# sourceMappingURL=spec.js.map

package/dist/knowledge/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","names":["latest: KnowledgeSpaceSpec | undefined"],"sources":["../../src/knowledge/spec.ts"],"sourcesContent":["import type { OwnerShipMeta } from '../ownership';\nimport type { PolicyRef } from '../policy/spec';\n\nexport type KnowledgeCategory =\n  | 'canonical' // Ground truth - product specs, schemas, official policies\n  | 'operational' // Internal docs - support tickets, runbooks, sales materials\n  | 'external' // Third-party - PSP docs, regulations, integration guides\n  | 'ephemeral'; // Temporary - agent scratchpads, session context, drafts\n\nexport interface KnowledgeSpaceMeta extends OwnerShipMeta {\n  /** Stable space identifier (e.g., \"product-canon\", \"support-faq\"). */\n  key: string;\n  version: number;\n  category: KnowledgeCategory;\n  displayName: string;\n}\n\nexport interface KnowledgeRetentionPolicy {\n  /** TTL in days (null = indefinite). */\n  ttlDays?: number | null;\n  /** Auto-archive after inactivity. */\n  archiveAfterDays?: number;\n}\n\nexport interface KnowledgeAccessPolicy {\n  /** Which PolicySpec governs access. */\n  policy?: PolicyRef;\n  /** Trust level for agent/workflow consumption. */\n  trustLevel: 'high' | 'medium' | 'low';\n  /** Can this space be mutated by automation? */\n  automationWritable: boolean;\n}\n\nexport interface KnowledgeIndexingConfig {\n  embeddingModel?: string;\n  chunkSize?: number;\n  vectorDbIntegration?: string;\n}\n\nexport interface KnowledgeSpaceSpec {\n  meta: KnowledgeSpaceMeta;\n  /** Retention and cleanup rules. */\n  retention: KnowledgeRetentionPolicy;\n  /** Access control and trust. */\n  access: KnowledgeAccessPolicy;\n  /** Optional embedding/indexing config. */\n  indexing?: KnowledgeIndexingConfig;\n  /** Documentation. */\n  description?: string;\n}\n\nconst knowledgeKey = (meta: Pick<KnowledgeSpaceMeta, 'key' | 'version'>) =>\n  `${meta.key}.v${meta.version}`;\n\nexport class KnowledgeSpaceRegistry {\n  private readonly items = new Map<string, KnowledgeSpaceSpec>();\n\n  register(spec: KnowledgeSpaceSpec): this {\n    const key = knowledgeKey(spec.meta);\n    if (this.items.has(key)) {\n      throw new Error(`Duplicate KnowledgeSpaceSpec ${key}`);\n    }\n    this.items.set(key, spec);\n    return this;\n  }\n\n  list(): KnowledgeSpaceSpec[] {\n    return [...this.items.values()];\n  }\n\n  get(key: string, version?: number): KnowledgeSpaceSpec | undefined {\n    if (version != null) {\n      return this.items.get(knowledgeKey({ key, version }));\n    }\n    let latest: KnowledgeSpaceSpec | undefined;\n    let maxVersion = -Infinity;\n    for (const spec of this.items.values()) {\n      if (spec.meta.key !== key) continue;\n      if (spec.meta.version > maxVersion) {\n        maxVersion = spec.meta.version;\n        latest = spec;\n      }\n    }\n    return latest;\n  }\n\n  getByCategory(category: KnowledgeCategory): KnowledgeSpaceSpec[] {\n    return this.list().filter((spec) => spec.meta.category === category);\n  }\n}\n\nexport function makeKnowledgeSpaceKey(meta: KnowledgeSpaceMeta) {\n  return knowledgeKey(meta);\n}\n"],"mappings":";AAmDA,MAAM,gBAAgB,SACpB,GAAG,KAAK,IAAI,IAAI,KAAK;AAEvB,IAAa,yBAAb,MAAoC;CAClC,AAAiB,wBAAQ,IAAI,KAAiC;CAE9D,SAAS,MAAgC;EACvC,MAAM,MAAM,aAAa,KAAK,KAAK;AACnC,MAAI,KAAK,MAAM,IAAI,IAAI,CACrB,OAAM,IAAI,MAAM,gCAAgC,MAAM;AAExD,OAAK,MAAM,IAAI,KAAK,KAAK;AACzB,SAAO;;CAGT,OAA6B;AAC3B,SAAO,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC;;CAGjC,IAAI,KAAa,SAAkD;AACjE,MAAI,WAAW,KACb,QAAO,KAAK,MAAM,IAAI,aAAa;GAAE;GAAK;GAAS,CAAC,CAAC;EAEvD,IAAIA;EACJ,IAAI,aAAa;AACjB,OAAK,MAAM,QAAQ,KAAK,MAAM,QAAQ,EAAE;AACtC,OAAI,KAAK,KAAK,QAAQ,IAAK;AAC3B,OAAI,KAAK,KAAK,UAAU,YAAY;AAClC,iBAAa,KAAK,KAAK;AACvB,aAAS;;;AAGb,SAAO;;CAGT,cAAc,UAAmD;AAC/D,SAAO,KAAK,MAAM,CAAC,QAAQ,SAAS,KAAK,KAAK,aAAa,SAAS;;;AAIxE,SAAgB,sBAAsB,MAA0B;AAC9D,QAAO,aAAa,KAAK"}

package/dist/llm/exporters.d.ts

@@ -64,4 +64,5 @@ declare function exportFeature(feature: FeatureModuleSpec, deps?: {
   presentations?: PresentationRegistry;
 }, options?: Partial<FeatureExportOptions>): FeatureExportResult;
 //#endregion
-export { docBlockToMarkdown, eventToMarkdown, exportFeature, exportSpec, featureToMarkdown, presentationToMarkdown, specToAgentPrompt, specToContextMarkdown, specToFullMarkdown };
+export { docBlockToMarkdown, eventToMarkdown, exportFeature, exportSpec, featureToMarkdown, presentationToMarkdown, specToAgentPrompt, specToContextMarkdown, specToFullMarkdown };
+//# sourceMappingURL=exporters.d.ts.map

package/dist/llm/exporters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporters.d.ts","names":[],"sources":["../../src/llm/exporters.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;AAkSA;AA8IA;;AAGY,iBAtYI,qBAAA,CAsYJ,IAAA,EAtYgC,eAsYhC,CAAA,EAAA,MAAA;;;;;AA+HZ;AA2DgB,iBAjhBA,kBAAA,CAihBiC,IAAA,EAhhBzC,eAghBwC,EAAA,OAAA,CAAA,EA/gBrC,OA+gBqC,CA/gB7B,iBA+gB6B,CAAA,CAAA,EAAA,MAAA;AAsChD;AA0CA;;;;AAGG,iBA9Za,iBAAA,CA8Zb,IAAA,EA7ZK,eA6ZL,EAAA,OAkCQ,CAlCR,EAAA;EAAgB,QAAA,CAAA,EAAA,WAAA,GAAA,MAAA,GAAA,UAAA,GAAA,QAAA;EAiCH,YAAA,CAAA,EAAA,MAAa;CAClB,CAAA,EAAA,MAAA;;;;;AAMR,iBAxTa,iBAAA,CAwTb,OAAA,EAvTQ,iBAuTR,EAAA,KAAA,EAAA;EAAmB,KAAA,CAAA,EArTV,YAqTU;kBApTF;aAET,QAAQ;;;;iBA4HH,sBAAA,eACA;;;;iBA0DA,eAAA,QAAuB,UAAU;;;;iBAsCjC,kBAAA,MAAwB;;;;;iBA0CxB,UAAA,OACR,2BACG,QAAQ,qBAChB;;;;iBAiCa,aAAA,UACL;UAEC;kBACQ;aAET,QAAQ,wBAChB"}

package/dist/llm/exporters.js

@@ -538,4 +538,5 @@ function exportFeature(feature, deps, options = {}) {
 }
 
 //#endregion
-export { docBlockToMarkdown, eventToMarkdown, exportFeature, exportSpec, featureToMarkdown, presentationToMarkdown, specToAgentPrompt, specToContextMarkdown, specToFullMarkdown };
+export { docBlockToMarkdown, eventToMarkdown, exportFeature, exportSpec, featureToMarkdown, presentationToMarkdown, specToAgentPrompt, specToContextMarkdown, specToFullMarkdown };
+//# sourceMappingURL=exporters.js.map

package/dist/llm/exporters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporters.js","names":["DEFAULT_SPEC_OPTIONS: SpecExportOptions","DEFAULT_FEATURE_OPTIONS: FeatureExportOptions","lines: string[]","markdown: string"],"sources":["../../src/llm/exporters.ts"],"sourcesContent":["/**\n * LLM Export Functions\n *\n * Provides multi-format markdown export for specs, features, presentations,\n * and other ContractSpec artifacts for LLM consumption.\n */\n\nimport type { AnyContractSpec } from '../spec';\nimport { isEmitDeclRef } from '../spec';\nimport type { FeatureModuleSpec } from '../features';\nimport type { PresentationDescriptorV2 } from '../presentations.v2';\nimport type { EventSpec } from '../events';\nimport type { AnySchemaModel } from '@lssm/lib.schema';\nimport type { DocBlock } from '../docs/types';\nimport type { SpecRegistry } from '../registry';\nimport type { PresentationRegistry } from '../presentations';\nimport { jsonSchemaForSpec } from '../jsonschema';\nimport type {\n  SpecExportOptions,\n  FeatureExportOptions,\n  SpecExportResult,\n  FeatureExportResult,\n} from './types';\n\nconst DEFAULT_SPEC_OPTIONS: SpecExportOptions = {\n  format: 'full',\n  includeSchemas: true,\n  includeScenarios: true,\n  includeExamples: true,\n  includePolicy: true,\n  includeSideEffects: true,\n};\n\nconst DEFAULT_FEATURE_OPTIONS: FeatureExportOptions = {\n  ...DEFAULT_SPEC_OPTIONS,\n  includeRelatedSpecs: true,\n  includeRelatedEvents: true,\n  includeRelatedPresentations: true,\n};\n\n/**\n * Export a single spec to context-focused markdown.\n * Includes: goal, context, description, acceptance scenarios.\n * Best for: Understanding what the spec does, providing context to LLMs.\n */\nexport function specToContextMarkdown(spec: AnyContractSpec): string {\n  const m = spec.meta;\n  const lines: string[] = [];\n\n  lines.push(`# ${m.name} (v${m.version})`);\n  lines.push('');\n  lines.push(`> ${m.description}`);\n  lines.push('');\n  lines.push(`**Type:** ${m.kind} | **Stability:** ${m.stability}`);\n  lines.push('');\n\n  lines.push('## Goal');\n  lines.push('');\n  lines.push(m.goal);\n  lines.push('');\n\n  lines.push('## Context');\n  lines.push('');\n  lines.push(m.context);\n  lines.push('');\n\n  if (spec.acceptance?.scenarios?.length) {\n    lines.push('## Acceptance Criteria');\n    lines.push('');\n    for (const s of spec.acceptance.scenarios) {\n      lines.push(`### ${s.name}`);\n      lines.push('');\n      lines.push('**Given:**');\n      for (const g of s.given) lines.push(`- ${g}`);\n      lines.push('');\n      lines.push('**When:**');\n      for (const w of s.when) lines.push(`- ${w}`);\n      lines.push('');\n      lines.push('**Then:**');\n      for (const t of s.then) lines.push(`- ${t}`);\n      lines.push('');\n    }\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Export a single spec to full markdown with all details.\n * Includes: all fields, I/O schemas, policy, events, examples.\n * Best for: Complete documentation, implementation reference.\n */\nexport function specToFullMarkdown(\n  spec: AnyContractSpec,\n  options: Partial<SpecExportOptions> = {}\n): string {\n  const opts = { ...DEFAULT_SPEC_OPTIONS, ...options };\n  const m = spec.meta;\n  const lines: string[] = [];\n\n  // Header\n  lines.push(`# ${m.name}.v${m.version}`);\n  lines.push('');\n  lines.push(`> ${m.description}`);\n  lines.push('');\n\n  // Metadata table\n  lines.push('## Metadata');\n  lines.push('');\n  lines.push('| Field | Value |');\n  lines.push('|-------|-------|');\n  lines.push(`| Kind | ${m.kind} |`);\n  lines.push(`| Stability | ${m.stability} |`);\n  lines.push(`| Owners | ${m.owners.join(', ')} |`);\n  lines.push(`| Tags | ${m.tags.join(', ')} |`);\n  lines.push('');\n\n  // Goal & Context\n  lines.push('## Goal');\n  lines.push('');\n  lines.push(m.goal);\n  lines.push('');\n\n  lines.push('## Context');\n  lines.push('');\n  lines.push(m.context);\n  lines.push('');\n\n  // I/O Schemas\n  if (opts.includeSchemas) {\n    lines.push('## Input/Output');\n    lines.push('');\n\n    if (spec.io.input) {\n      lines.push('### Input Schema');\n      lines.push('');\n      lines.push('```json');\n      try {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const schema = jsonSchemaForSpec(spec as any) as any;\n        lines.push(JSON.stringify(schema.input ?? {}, null, 2));\n      } catch {\n        lines.push('// Schema generation not available');\n      }\n      lines.push('```');\n      lines.push('');\n    }\n\n    lines.push('### Output Schema');\n    lines.push('');\n    lines.push('```json');\n    try {\n      const schema = jsonSchemaForSpec(spec as any) as any;\n      lines.push(JSON.stringify(schema.output ?? {}, null, 2));\n    } catch {\n      lines.push('// Schema generation not available');\n    }\n    lines.push('```');\n    lines.push('');\n\n    // Errors\n    if (spec.io.errors && Object.keys(spec.io.errors).length) {\n      lines.push('### Error Codes');\n      lines.push('');\n      lines.push('| Code | HTTP | Description | When |');\n      lines.push('|------|------|-------------|------|');\n      for (const [code, err] of Object.entries(spec.io.errors)) {\n        lines.push(\n          `| \\`${code}\\` | ${err.http ?? 400} | ${err.description} | ${err.when} |`\n        );\n      }\n      lines.push('');\n    }\n  }\n\n  // Policy\n  if (opts.includePolicy) {\n    lines.push('## Policy');\n    lines.push('');\n    lines.push(`- **Auth Required:** ${spec.policy.auth}`);\n    lines.push(\n      `- **Idempotent:** ${spec.policy.idempotent ?? m.kind === 'query'}`\n    );\n    if (spec.policy.rateLimit) {\n      lines.push(\n        `- **Rate Limit:** ${spec.policy.rateLimit.rpm} rpm per ${spec.policy.rateLimit.key}`\n      );\n    }\n    if (spec.policy.flags?.length) {\n      lines.push(`- **Feature Flags:** ${spec.policy.flags.join(', ')}`);\n    }\n    if (spec.policy.pii?.length) {\n      lines.push(`- **PII Fields:** ${spec.policy.pii.join(', ')}`);\n    }\n    if (spec.policy.escalate) {\n      lines.push(`- **Escalation:** ${spec.policy.escalate}`);\n    }\n    lines.push('');\n  }\n\n  // Side Effects\n  if (opts.includeSideEffects && spec.sideEffects) {\n    if (spec.sideEffects.emits?.length) {\n      lines.push('## Events Emitted');\n      lines.push('');\n      for (const e of spec.sideEffects.emits) {\n        if (isEmitDeclRef(e)) {\n          lines.push(`- \\`${e.ref.name}.v${e.ref.version}\\` — ${e.when}`);\n        } else {\n          lines.push(`- \\`${e.name}.v${e.version}\\` — ${e.when}`);\n        }\n      }\n      lines.push('');\n    }\n\n    if (spec.sideEffects.analytics?.length) {\n      lines.push('## Analytics Events');\n      lines.push('');\n      for (const a of spec.sideEffects.analytics) {\n        lines.push(`- ${a}`);\n      }\n      lines.push('');\n    }\n  }\n\n  // Acceptance Scenarios\n  if (opts.includeScenarios && spec.acceptance?.scenarios?.length) {\n    lines.push('## Acceptance Scenarios');\n    lines.push('');\n    for (const s of spec.acceptance.scenarios) {\n      lines.push(`### ${s.name}`);\n      lines.push('');\n      lines.push('**Given:**');\n      for (const g of s.given) lines.push(`- ${g}`);\n      lines.push('');\n      lines.push('**When:**');\n      for (const w of s.when) lines.push(`- ${w}`);\n      lines.push('');\n      lines.push('**Then:**');\n      for (const t of s.then) lines.push(`- ${t}`);\n      lines.push('');\n    }\n  }\n\n  // Examples\n  if (opts.includeExamples && spec.acceptance?.examples?.length) {\n    lines.push('## Examples');\n    lines.push('');\n    for (const ex of spec.acceptance.examples) {\n      lines.push(`### ${ex.name}`);\n      lines.push('');\n      lines.push('**Input:**');\n      lines.push('```json');\n      lines.push(JSON.stringify(ex.input, null, 2));\n      lines.push('```');\n      lines.push('');\n      lines.push('**Output:**');\n      lines.push('```json');\n      lines.push(JSON.stringify(ex.output, null, 2));\n      lines.push('```');\n      lines.push('');\n    }\n  }\n\n  // Transport hints\n  if (spec.transport) {\n    lines.push('## Transport Configuration');\n    lines.push('');\n    if (spec.transport.rest) {\n      lines.push(\n        `- **REST:** ${spec.transport.rest.method ?? 'POST'} ${spec.transport.rest.path ?? 'auto'}`\n      );\n    }\n    if (spec.transport.gql) {\n      lines.push(`- **GraphQL:** ${spec.transport.gql.field ?? 'auto'}`);\n    }\n    if (spec.transport.mcp) {\n      lines.push(`- **MCP Tool:** ${spec.transport.mcp.toolName ?? 'auto'}`);\n    }\n    lines.push('');\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Export a single spec as an actionable agent prompt.\n * Includes: instructions, full spec, expected output format.\n * Best for: Directly feeding to coding agents for implementation.\n */\nexport function specToAgentPrompt(\n  spec: AnyContractSpec,\n  options?: {\n    taskType?: 'implement' | 'test' | 'refactor' | 'review';\n    existingCode?: string;\n  }\n): string {\n  const taskType = options?.taskType ?? 'implement';\n  const m = spec.meta;\n  const lines: string[] = [];\n\n  // Task header\n  const taskVerb = {\n    implement: 'Implement',\n    test: 'Write tests for',\n    refactor: 'Refactor',\n    review: 'Review',\n  }[taskType];\n\n  lines.push(`# Task: ${taskVerb} ${m.name}.v${m.version}`);\n  lines.push('');\n\n  // Context\n  lines.push('## Context');\n  lines.push('');\n  lines.push(\n    `You are working on a ContractSpec-driven codebase. This spec defines a ${m.kind} operation.`\n  );\n  lines.push('');\n  lines.push(`**Goal:** ${m.goal}`);\n  lines.push('');\n  lines.push(`**Background:** ${m.context}`);\n  lines.push('');\n\n  // Full spec\n  lines.push('## Specification');\n  lines.push('');\n  lines.push(specToFullMarkdown(spec));\n  lines.push('');\n\n  // Task-specific instructions\n  lines.push('## Instructions');\n  lines.push('');\n\n  if (taskType === 'implement') {\n    lines.push('Implement this specification following these requirements:');\n    lines.push('');\n    lines.push(\n      '1. **Type Safety**: Use TypeScript with strict typing. No `any` types.'\n    );\n    lines.push(\n      '2. **Input Validation**: Validate input against the schema before processing.'\n    );\n    lines.push(\n      '3. **Error Handling**: Implement all error cases defined in the spec.'\n    );\n    lines.push('4. **Events**: Emit events as specified in sideEffects.emits.');\n    lines.push('5. **Policy**: Respect auth, rate limits, and feature flags.');\n    lines.push(\n      '6. **Idempotency**: ' +\n        (spec.policy.idempotent\n          ? 'This operation MUST be idempotent.'\n          : 'This operation may have side effects.')\n    );\n    lines.push('');\n\n    if (spec.policy.pii?.length) {\n      lines.push(\n        '**PII Handling**: The following fields contain PII and must be handled carefully:'\n      );\n      for (const field of spec.policy.pii) {\n        lines.push(`- ${field}`);\n      }\n      lines.push('');\n    }\n  } else if (taskType === 'test') {\n    lines.push('Write comprehensive tests for this specification:');\n    lines.push('');\n    lines.push('1. Test all acceptance scenarios defined in the spec.');\n    lines.push('2. Test all error cases with appropriate assertions.');\n    lines.push('3. Test edge cases and boundary conditions.');\n    lines.push('4. Verify events are emitted correctly.');\n    lines.push(\n      '5. Use descriptive test names following the pattern: \"should [behavior] when [condition]\"'\n    );\n    lines.push('');\n  } else if (taskType === 'refactor') {\n    lines.push('Refactor this implementation while preserving all behavior:');\n    lines.push('');\n    lines.push('1. Maintain compliance with the specification.');\n    lines.push('2. Improve code clarity and maintainability.');\n    lines.push('3. Reduce complexity where possible.');\n    lines.push('4. Ensure all existing tests still pass.');\n    lines.push('');\n  } else if (taskType === 'review') {\n    lines.push('Review this implementation against the specification:');\n    lines.push('');\n    lines.push('1. Verify input/output types match the schema.');\n    lines.push('2. Check all error cases are handled.');\n    lines.push('3. Verify events are emitted as specified.');\n    lines.push('4. Check policy compliance (auth, rate limits).');\n    lines.push('5. Report any deviations from the spec.');\n    lines.push('');\n  }\n\n  // Existing code if provided\n  if (options?.existingCode) {\n    lines.push('## Existing Code');\n    lines.push('');\n    lines.push('```typescript');\n    lines.push(options.existingCode);\n    lines.push('```');\n    lines.push('');\n  }\n\n  // Expected output format\n  lines.push('## Expected Output');\n  lines.push('');\n  if (taskType === 'implement' || taskType === 'refactor') {\n    lines.push('Provide a complete TypeScript implementation. Include:');\n    lines.push('- Type definitions for input/output');\n    lines.push('- Handler function with proper error handling');\n    lines.push('- JSDoc comments explaining the implementation');\n  } else if (taskType === 'test') {\n    lines.push(\n      'Provide a complete test file using the testing framework available (prefer Vitest).'\n    );\n  } else if (taskType === 'review') {\n    lines.push('Provide a structured review with:');\n    lines.push('- Compliance status (pass/fail for each requirement)');\n    lines.push('- Issues found with severity (error/warning/info)');\n    lines.push('- Suggestions for improvement');\n  }\n  lines.push('');\n\n  return lines.join('\\n');\n}\n\n/**\n * Export a feature module to markdown.\n * Includes all related specs, events, and presentations.\n */\nexport function featureToMarkdown(\n  feature: FeatureModuleSpec,\n  deps?: {\n    specs?: SpecRegistry;\n    presentations?: PresentationRegistry;\n  },\n  options: Partial<FeatureExportOptions> = {}\n): string {\n  const opts = { ...DEFAULT_FEATURE_OPTIONS, ...options };\n  const m = feature.meta;\n  const lines: string[] = [];\n\n  // Header\n  lines.push(`# Feature: ${m.title ?? m.key}`);\n  lines.push('');\n  if (m.description) {\n    lines.push(`> ${m.description}`);\n    lines.push('');\n  }\n\n  // Metadata\n  lines.push('## Overview');\n  lines.push('');\n  lines.push(`- **Key:** \\`${m.key}\\``);\n  lines.push(`- **Stability:** ${m.stability}`);\n  lines.push(`- **Owners:** ${m.owners.join(', ')}`);\n  if (m.tags?.length) {\n    lines.push(`- **Tags:** ${m.tags.join(', ')}`);\n  }\n  lines.push('');\n\n  // Operations summary\n  if (feature.operations?.length) {\n    lines.push('## Operations');\n    lines.push('');\n    lines.push('| Name | Version | Type |');\n    lines.push('|------|---------|------|');\n    for (const op of feature.operations) {\n      const spec = deps?.specs?.getSpec(op.name, op.version);\n      const kind = spec?.meta.kind ?? 'unknown';\n      lines.push(`| ${op.name} | v${op.version} | ${kind} |`);\n    }\n    lines.push('');\n\n    // Include full specs if requested\n    if (opts.includeRelatedSpecs && deps?.specs) {\n      lines.push('### Operation Details');\n      lines.push('');\n      for (const op of feature.operations) {\n        const spec = deps.specs.getSpec(op.name, op.version);\n        if (spec) {\n          lines.push(`---`);\n          lines.push('');\n          lines.push(specToFullMarkdown(spec, opts));\n        }\n      }\n    }\n  }\n\n  // Events summary\n  if (feature.events?.length) {\n    lines.push('## Events');\n    lines.push('');\n    lines.push('| Name | Version |');\n    lines.push('|------|---------|');\n    for (const evt of feature.events) {\n      lines.push(`| ${evt.name} | v${evt.version} |`);\n    }\n    lines.push('');\n  }\n\n  // Presentations summary\n  if (feature.presentations?.length) {\n    lines.push('## Presentations');\n    lines.push('');\n    lines.push('| Name | Version |');\n    lines.push('|------|---------|');\n    for (const pres of feature.presentations) {\n      lines.push(`| ${pres.name} | v${pres.version} |`);\n    }\n    lines.push('');\n\n    // Include full presentations if requested\n    if (opts.includeRelatedPresentations && deps?.presentations) {\n      lines.push('### Presentation Details');\n      lines.push('');\n      for (const pres of feature.presentations) {\n        const p = deps.presentations.get(pres.name, pres.version);\n        if (p) {\n          lines.push(`#### ${pres.name}.v${pres.version}`);\n          lines.push('');\n          lines.push(`- **Kind:** ${(p.content as any).kind ?? 'unknown'}`);\n          if ('componentKey' in p.content) {\n            lines.push(`- **Component:** ${(p.content as any).componentKey}`);\n          }\n          lines.push('');\n        }\n      }\n    }\n  }\n\n  // Capabilities\n  if (feature.capabilities) {\n    if (feature.capabilities.provides?.length) {\n      lines.push('## Capabilities Provided');\n      lines.push('');\n      for (const cap of feature.capabilities.provides) {\n        lines.push(`- \\`${cap.key}.v${cap.version}\\``);\n      }\n      lines.push('');\n    }\n\n    if (feature.capabilities.requires?.length) {\n      lines.push('## Capabilities Required');\n      lines.push('');\n      for (const cap of feature.capabilities.requires) {\n        lines.push(\n          `- \\`${cap.key}\\`${cap.version ? `.v${cap.version}` : ''} (${cap.optional ? 'optional' : 'required'})`\n        );\n      }\n      lines.push('');\n    }\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Export a presentation descriptor to markdown.\n */\nexport function presentationToMarkdown(\n  presentation: PresentationDescriptorV2\n): string {\n  const m = presentation.meta;\n  const lines: string[] = [];\n\n  lines.push(`# Presentation: ${m.name}.v${m.version}`);\n  lines.push('');\n\n  if (m.description) {\n    lines.push(`> ${m.description}`);\n    lines.push('');\n  }\n\n  lines.push('## Metadata');\n  lines.push('');\n  lines.push(`- **Name:** ${m.name}`);\n  lines.push(`- **Version:** ${m.version}`);\n  if (m.stability) lines.push(`- **Stability:** ${m.stability}`);\n  if (m.owners?.length) lines.push(`- **Owners:** ${m.owners.join(', ')}`);\n  if (m.tags?.length) lines.push(`- **Tags:** ${m.tags.join(', ')}`);\n  lines.push('');\n\n  lines.push('## Source');\n  lines.push('');\n  lines.push(`- **Type:** ${presentation.source.type}`);\n  if (presentation.source.type === 'component') {\n    lines.push(`- **Framework:** ${presentation.source.framework}`);\n    lines.push(`- **Component Key:** ${presentation.source.componentKey}`);\n  }\n  lines.push('');\n\n  lines.push('## Supported Targets');\n  lines.push('');\n  for (const target of presentation.targets) {\n    lines.push(`- ${target}`);\n  }\n  lines.push('');\n\n  if (presentation.policy) {\n    lines.push('## Policy');\n    lines.push('');\n    if (presentation.policy.flags?.length) {\n      lines.push(\n        `- **Feature Flags:** ${presentation.policy.flags.join(', ')}`\n      );\n    }\n    if (presentation.policy.pii?.length) {\n      lines.push(`- **PII Fields:** ${presentation.policy.pii.join(', ')}`);\n    }\n    lines.push('');\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Export an event spec to markdown.\n */\nexport function eventToMarkdown(event: EventSpec<AnySchemaModel>): string {\n  const lines: string[] = [];\n\n  lines.push(`# Event: ${event.name}.v${event.version}`);\n  lines.push('');\n\n  lines.push('## Metadata');\n  lines.push('');\n  lines.push(`- **Name:** ${event.name}`);\n  lines.push(`- **Version:** ${event.version}`);\n  if (event.description) lines.push(`- **Description:** ${event.description}`);\n  lines.push('');\n\n  lines.push('## Payload Schema');\n  lines.push('');\n  lines.push('```json');\n  try {\n    const zodSchema = event.payload.getZod();\n    // Try to get shape if available\n    if ('shape' in zodSchema && zodSchema.shape) {\n      const shape = zodSchema.shape as Record<string, unknown>;\n      const fields = Object.keys(shape);\n      lines.push(JSON.stringify({ fields }, null, 2));\n    } else {\n      lines.push('// Payload schema available at runtime');\n    }\n  } catch {\n    lines.push('// Schema details available at runtime');\n  }\n  lines.push('```');\n  lines.push('');\n\n  return lines.join('\\n');\n}\n\n/**\n * Export a DocBlock to markdown (already markdown, but formatted consistently).\n */\nexport function docBlockToMarkdown(doc: DocBlock): string {\n  const lines: string[] = [];\n\n  lines.push(`# ${doc.title}`);\n  lines.push('');\n\n  if (doc.summary) {\n    lines.push(`> ${doc.summary}`);\n    lines.push('');\n  }\n\n  lines.push('## Metadata');\n  lines.push('');\n  lines.push(`- **ID:** ${doc.id}`);\n  lines.push(`- **Kind:** ${doc.kind ?? 'reference'}`);\n  lines.push(`- **Visibility:** ${doc.visibility ?? 'public'}`);\n  if (doc.tags?.length) lines.push(`- **Tags:** ${doc.tags.join(', ')}`);\n  if (doc.owners?.length) lines.push(`- **Owners:** ${doc.owners.join(', ')}`);\n  if (doc.domain) lines.push(`- **Domain:** ${doc.domain}`);\n  lines.push('');\n\n  lines.push('## Content');\n  lines.push('');\n  lines.push(doc.body);\n  lines.push('');\n\n  if (doc.links?.length) {\n    lines.push('## Related Links');\n    lines.push('');\n    for (const link of doc.links) {\n      lines.push(`- [${link.label}](${link.href})`);\n    }\n    lines.push('');\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Export a spec with a specific format.\n * Convenience function that wraps the format-specific functions.\n */\nexport function exportSpec(\n  spec: AnyContractSpec,\n  options: Partial<SpecExportOptions> = {}\n): SpecExportResult {\n  const format = options.format ?? 'full';\n\n  let markdown: string;\n  switch (format) {\n    case 'context':\n      markdown = specToContextMarkdown(spec);\n      break;\n    case 'prompt':\n      markdown = specToAgentPrompt(spec);\n      break;\n    case 'full':\n    default:\n      markdown = specToFullMarkdown(spec, options);\n      break;\n  }\n\n  return {\n    spec,\n    markdown,\n    format,\n    meta: {\n      specName: spec.meta.name,\n      specVersion: spec.meta.version,\n      exportedAt: new Date().toISOString(),\n      wordCount: markdown.split(/\\s+/).length,\n    },\n  };\n}\n\n/**\n * Export a feature with a specific format.\n */\nexport function exportFeature(\n  feature: FeatureModuleSpec,\n  deps?: {\n    specs?: SpecRegistry;\n    presentations?: PresentationRegistry;\n  },\n  options: Partial<FeatureExportOptions> = {}\n): FeatureExportResult {\n  const format = options.format ?? 'full';\n  const markdown = featureToMarkdown(feature, deps, options);\n\n  return {\n    feature,\n    markdown,\n    format,\n    includedSpecs:\n      feature.operations?.map((o) => `${o.name}.v${o.version}`) ?? [],\n    includedEvents: feature.events?.map((e) => `${e.name}.v${e.version}`) ?? [],\n    includedPresentations:\n      feature.presentations?.map((p) => `${p.name}.v${p.version}`) ?? [],\n  };\n}\n"],"mappings":"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"}

package/dist/llm/prompts.d.ts

@@ -48,4 +48,5 @@ declare function generateFixViolationsPrompt(spec: AnyContractSpec, implementati
   suggestion?: string;
 }[]): AgentPrompt;
 //#endregion
-export { AGENT_SYSTEM_PROMPTS, formatPlanForAgent, generateFixViolationsPrompt, generateImplementationPlan, generateImplementationPrompt, generateReviewPrompt, generateTestPrompt, generateVerificationPrompt };
+export { AGENT_SYSTEM_PROMPTS, formatPlanForAgent, generateFixViolationsPrompt, generateImplementationPlan, generateImplementationPrompt, generateReviewPrompt, generateTestPrompt, generateVerificationPrompt };
+//# sourceMappingURL=prompts.d.ts.map

package/dist/llm/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","names":[],"sources":["../../src/llm/prompts.ts"],"sourcesContent":[],"mappings":";;;;;;AAoIA;;AAES,cAlHI,oBAkHJ,EAlH0B,MAkH1B,CAlHiC,SAkHjC,EAAA,MAAA,CAAA;;;AAwCT;AACQ,iBAvGQ,4BAAA,CAuGR,IAAA,EAtGA,eAsGA,EAAA,KAAA,EArGC,SAqGD,EAAA,OAGM,CAHN,EAAA;EACC,YAAA,CAAA,EAAA,MAAA;EAEN,UAAA,CAAA,EAAA,MAAA;CAAW,CAAA,EAnGX,WAmGW;AA0Cd;AAkDA;AAgLA;AACQ,iBA3TQ,kBAAA,CA2TR,IAAA,EA1TA,eA0TA,EAAA,KAAA,EAzTC,SAyTD,EAAA,OAEM,CAFN,EAAA;EACC,kBAAA,CAAA,EAAA,MAAA;EACN,aAAA,CAAA,EAAA,QAAA,GAAA,MAAA,GAAA,KAAA;CAAW,CAAA,EAtTX,WAsTW;AAuEd;;;iBA1VgB,oBAAA,OACR,wBACC,wCAEN;;;;iBA0Ca,0BAAA,OACR,8CAEL;;;;iBA+Ca,0BAAA,OACR;;;IAKL;;;;iBA0Ka,kBAAA,OACR,2BACC,YACN;;;;iBAuEa,2BAAA,OACR;;;MAGL"}