@lssm/lib.contracts 1.11.0 → 1.41.0

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

@@ -1 +0,0 @@
-{"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,EAAb,KAAmC,CACjC,YACE,EACA,EACA,EACA,EACA,CAJiB,KAAA,MAAA,EACA,KAAA,UAAA,EACA,KAAA,WAAA,EACA,KAAA,QAAA,EAGnB,MAAM,YACJ,EACA,CACA,IAAM,EAAU,MAAM,KAAK,MAAM,YAAY,EAAM,CACnD,IAAK,IAAM,KAAU,EACnB,MAAM,KAAK,aAAa,EAAO,CAInC,MAAM,aAAa,EAAqB,CACtC,IAAM,EAAW,KAAK,cAAc,EAAO,CACrC,EAAY,MAAM,KAAK,UAAU,QAAQ,EAAS,CAClD,EAAa,MAAM,KAAK,WAAW,eAAe,EAAU,CAClE,MAAM,KAAK,QAAQ,OAAO,EAAW,EAAW,CAGlD,cAAsB,EAAkC,CACtD,IAAM,EAAU,EAAkB,EAAO,CACzC,MAAO,CACL,GAAI,EAAO,GACX,SAAU,aACV,KAAM,OAAO,KAAK,EAAS,QAAQ,CACnC,SAAU,CACR,QAAS,EAAO,SAAW,GAC3B,aAAc,EAAO,aAAa,IAAK,GAAM,EAAE,MAAM,CAAC,KAAK,KAAK,CAChE,UAAW,EAAO,UAAU,aAAa,CAC1C,CACF,GAIL,SAAS,EAAkB,EAA6B,CACtD,IAAM,EAAS,CACb,YAAY,EAAO,SAAW,KAC9B,YAAY,EAAO,SAAW,KAC/B,CACK,EAAe,EAAO,SAAS,IAAK,GAAY,CACpD,IAAM,EAAQ,CACZ,SAAS,EAAc,EAAQ,KAAK,GACpC,OAAO,EAAQ,GAAG,IAAI,EAAc,CAAC,KAAK,KAAK,GAChD,CACG,EAAQ,QACV,EAAM,KAAK,SAAS,EAAQ,OAAO,aAAa,GAAG,CAErD,IAAM,EAAO,EAAQ,UAAY,EAAU,EAAQ,UAAY,GAAG,CAClE,MAAO,GAAG,EAAM,KAAK;EAAK,CAAC,MAAM,GAAQ,MACzC,CACF,MAAO,CAAC,GAAG,EAAQ,GAAG,EAAa,CAAC,KAAK;;;;EAAc,CAGzD,SAAS,EAAc,EAAmD,CACxE,OAAO,EAAQ,KAAO,GAAG,EAAQ,KAAK,IAAI,EAAQ,MAAM,GAAK,EAAQ,MAGvE,SAAS,EAAU,EAAsB,CACvC,OAAO,EAAK,QAAQ,WAAY,IAAI"}

package/dist/knowledge/ingestion/index.d.ts

@@ -1,6 +0,0 @@
-import { DocumentFragment, DocumentProcessor, RawDocument } from "./document-processor.js";
-import { EmbeddingService } from "./embedding-service.js";
-import { VectorIndexConfig, VectorIndexer } from "./vector-indexer.js";
-import { GmailIngestionAdapter } from "./gmail-adapter.js";
-import { StorageIngestionAdapter } from "./storage-adapter.js";
-export { DocumentFragment, DocumentProcessor, EmbeddingService, GmailIngestionAdapter, RawDocument, StorageIngestionAdapter, VectorIndexConfig, VectorIndexer };

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

@@ -1,16 +0,0 @@
-import { GetObjectResult } from "../../integrations/providers/storage.js";
-import { DocumentProcessor } from "./document-processor.js";
-import { EmbeddingService } from "./embedding-service.js";
-import { VectorIndexer } from "./vector-indexer.js";
-
-//#region src/knowledge/ingestion/storage-adapter.d.ts
-declare class StorageIngestionAdapter {
-  private readonly processor;
-  private readonly embeddings;
-  private readonly indexer;
-  constructor(processor: DocumentProcessor, embeddings: EmbeddingService, indexer: VectorIndexer);
-  ingestObject(object: GetObjectResult): Promise<void>;
-}
-//#endregion
-export { StorageIngestionAdapter };
-//# sourceMappingURL=storage-adapter.d.ts.map

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

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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,EAAb,KAAqC,CACnC,YACE,EACA,EACA,EACA,CAHiB,KAAA,UAAA,EACA,KAAA,WAAA,EACA,KAAA,QAAA,EAGnB,MAAM,aAAa,EAAwC,CACzD,GAAI,EAAE,SAAU,IAAW,CAAC,EAAO,KACjC,MAAU,MAAM,yCAAyC,CAG3D,IAAM,EAAM,CACV,GAAI,EAAO,IACX,SAAU,EAAO,aAAe,2BAChC,KAAM,EAAO,KACb,SAAU,CACR,OAAQ,EAAO,OACf,SAAU,EAAO,UAAY,GAC9B,CACF,CAEK,EAAY,MAAM,KAAK,UAAU,QAAQ,EAAI,CAC7C,EAAa,MAAM,KAAK,WAAW,eAAe,EAAU,CAClE,MAAM,KAAK,QAAQ,OAAO,EAAW,EAAW"}

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

@@ -1,19 +0,0 @@
-import { EmbeddingResult } from "../../integrations/providers/embedding.js";
-import { VectorStoreProvider } from "../../integrations/providers/vector-store.js";
-import { DocumentFragment } from "./document-processor.js";
-
-//#region src/knowledge/ingestion/vector-indexer.d.ts
-interface VectorIndexConfig {
-  collection: string;
-  namespace?: string;
-  metadata?: Record<string, string>;
-}
-declare class VectorIndexer {
-  private readonly provider;
-  private readonly config;
-  constructor(provider: VectorStoreProvider, config: VectorIndexConfig);
-  upsert(fragments: DocumentFragment[], embeddings: EmbeddingResult[]): Promise<void>;
-}
-//#endregion
-export { VectorIndexConfig, VectorIndexer };
-//# sourceMappingURL=vector-indexer.d.ts.map

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

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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,EAAb,KAA2B,CACzB,SACA,OAEA,YAAY,EAA+B,EAA2B,CACpE,KAAK,SAAW,EAChB,KAAK,OAAS,EAGhB,MAAM,OACJ,EACA,EACe,CACf,IAAM,EAAY,EAAW,IAAK,GAAc,CAC9C,IAAM,EAAW,EAAU,KAAM,GAAM,EAAE,KAAO,EAAU,GAAG,CAC7D,MAAO,CACL,GAAI,EAAU,GACd,OAAQ,EAAU,OAClB,QAAS,CACP,GAAG,KAAK,OAAO,SACf,GAAI,GAAU,UAAY,EAAE,CAC5B,WAAY,GAAU,WACvB,CACD,UAAW,KAAK,OAAO,UACxB,EACD,CAEIA,EAA+B,CACnC,WAAY,KAAK,OAAO,WACxB,YACD,CAED,MAAM,KAAK,SAAS,OAAO,EAAQ"}

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

@@ -1,2 +0,0 @@
-import { KnowledgeAnswer, KnowledgeQueryConfig, KnowledgeQueryService } from "./service.js";
-export { KnowledgeAnswer, KnowledgeQueryConfig, KnowledgeQueryService };

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

@@ -1,30 +0,0 @@
-import { LLMProvider, LLMResponse } from "../../integrations/providers/llm.js";
-import { EmbeddingProvider } from "../../integrations/providers/embedding.js";
-import { VectorSearchResult, VectorStoreProvider } from "../../integrations/providers/vector-store.js";
-
-//#region src/knowledge/query/service.d.ts
-interface KnowledgeQueryConfig {
-  collection: string;
-  namespace?: string;
-  topK?: number;
-  systemPrompt?: string;
-}
-interface KnowledgeAnswer {
-  answer: string;
-  references: (VectorSearchResult & {
-    text?: string;
-  })[];
-  usage?: LLMResponse['usage'];
-}
-declare class KnowledgeQueryService {
-  private readonly embeddings;
-  private readonly vectorStore;
-  private readonly llm;
-  private readonly config;
-  constructor(embeddings: EmbeddingProvider, vectorStore: VectorStoreProvider, llm: LLMProvider, config: KnowledgeQueryConfig);
-  query(question: string): Promise<KnowledgeAnswer>;
-  private buildMessages;
-}
-//#endregion
-export { KnowledgeAnswer, KnowledgeQueryConfig, KnowledgeQueryService };
-//# sourceMappingURL=service.d.ts.map

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

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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,EAAb,KAAmC,CACjC,WACA,YACA,IACA,OAEA,YACE,EACA,EACA,EACA,EACA,CACA,KAAK,WAAa,EAClB,KAAK,YAAc,EACnB,KAAK,IAAM,EACX,KAAK,OAAS,EAGhB,MAAM,MAAM,EAA4C,CACtD,IAAM,EAAY,MAAM,KAAK,WAAW,WAAW,EAAS,CACtD,EAAU,MAAM,KAAK,YAAY,OAAO,CAC5C,WAAY,KAAK,OAAO,WACxB,OAAQ,EAAU,OAClB,KAAM,KAAK,OAAO,MAAQ,EAC1B,UAAW,KAAK,OAAO,UACvB,OAAQ,IAAA,GACT,CAAC,CACI,EAAU,EAAa,EAAQ,CAC/B,EAAW,KAAK,cAAc,EAAU,EAAQ,CAChD,EAAW,MAAM,KAAK,IAAI,KAAK,EAAS,CAC9C,MAAO,CACL,OAAQ,EAAS,QAAQ,QACtB,IAAK,GAAU,SAAU,EAAO,EAAK,KAAO,GAAI,CAChD,KAAK,GAAG,CACX,WAAY,EAAQ,IAAK,IAAY,CACnC,GAAG,EACH,KAAM,EAAY,EAAO,CAC1B,EAAE,CACH,MAAO,EAAS,MACjB,CAGH,cAAsB,EAAkB,EAA+B,CAIrE,MAAO,CACL,CACE,KAAM,SACN,QAAS,CAAC,CAAE,KAAM,OAAQ,KAL5B,KAAK,OAAO,cACZ,sHAIgD,CAAC,CAChD,CACD,CACE,KAAM,OACN,QAAS,CACP,CACE,KAAM,OACN,KAAM,cAAc,EAAS,gBAAgB,IAC9C,CACF,CACF,CACF,GAIL,SAAS,EAAa,EAAuC,CAI3D,OAHI,EAAQ,SAAW,EACd,+BAEF,EACJ,KAAK,EAAQ,IAAU,CACtB,IAAM,EAAO,EAAY,EAAO,CAChC,MAAO,UAAU,EAAQ,EAAE,WAAW,EAAO,MAAM,QAAQ,EAAE,CAAC,MAAM,KACpE,CACD,KAAK;;EAAO,CAGjB,SAAS,EAAY,EAAoC,CACvD,IAAM,EAAU,EAAO,SAAW,EAAE,CAGpC,OAFI,OAAO,EAAQ,MAAS,SAAiB,EAAQ,KACjD,OAAO,EAAQ,SAAY,SAAiB,EAAQ,QACjD,KAAK,UAAU,EAAQ"}

package/dist/knowledge/runtime.d.ts

@@ -1,33 +0,0 @@
-import { KnowledgeCategory } from "./spec.js";
-import { ResolvedAppConfig, ResolvedKnowledge } from "../app-config/runtime.js";
-
-//#region src/knowledge/runtime.d.ts
-interface KnowledgeAccessContext {
-  tenantId: string;
-  appId: string;
-  environment?: string;
-  workflowName?: string;
-  agentName?: string;
-  operation: 'read' | 'write' | 'search';
-}
-interface KnowledgeAccessResult {
-  allowed: boolean;
-  reason?: string;
-  severity?: 'error' | 'warning';
-}
-interface KnowledgeAccessGuardOptions {
-  disallowWriteCategories?: KnowledgeCategory[];
-  requireWorkflowBinding?: boolean;
-  requireAgentBinding?: boolean;
-}
-declare class KnowledgeAccessGuard {
-  private readonly disallowedWrite;
-  private readonly requireWorkflowBinding;
-  private readonly requireAgentBinding;
-  constructor(options?: KnowledgeAccessGuardOptions);
-  checkAccess(spaceBinding: ResolvedKnowledge, context: KnowledgeAccessContext, appConfig: ResolvedAppConfig): KnowledgeAccessResult;
-  private isSpaceBound;
-}
-//#endregion
-export { KnowledgeAccessContext, KnowledgeAccessGuard, KnowledgeAccessGuardOptions, KnowledgeAccessResult };
-//# sourceMappingURL=runtime.d.ts.map

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

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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,EAAgD,CAAC,WAAY,YAAY,CAE/E,IAAa,EAAb,KAAkC,CAChC,gBACA,uBACA,oBAEA,YAAY,EAAuC,EAAE,CAAE,CACrD,KAAK,gBAAkB,IAAI,IACzB,EAAQ,yBAA2B,EACpC,CACD,KAAK,uBAAyB,EAAQ,wBAA0B,GAChE,KAAK,oBAAsB,EAAQ,qBAAuB,GAG5D,YACE,EACA,EACA,EACuB,CACvB,GAAM,CAAE,UAAS,SAAU,EAE3B,GACE,EAAQ,WAAa,IACrB,CAAC,KAAK,aAAa,EAAc,EAAU,CAE3C,MAAO,CACL,QAAS,GACT,OAAQ,oBAAoB,EAAM,KAAK,IAAI,4CAC5C,CAGH,GACE,EAAQ,YAAc,SACtB,KAAK,gBAAgB,IAAI,EAAM,KAAK,SAAS,CAE7C,MAAO,CACL,QAAS,GACT,OAAQ,oBAAoB,EAAM,KAAK,IAAI,iBAAiB,EAAM,KAAK,SAAS,qBACjF,CAGH,GAAI,KAAK,wBAA0B,EAAQ,aAAc,CACvD,IAAM,EAAmB,EAAQ,OAAO,UACxC,GACE,GACA,CAAC,EAAiB,SAAS,EAAQ,aAAa,CAEhD,MAAO,CACL,QAAS,GACT,OAAQ,aAAa,EAAQ,aAAa,iDAAiD,EAAM,KAAK,IAAI,IAC3G,CAIL,GAAI,KAAK,qBAAuB,EAAQ,UAAW,CACjD,IAAM,EAAgB,EAAQ,OAAO,OACrC,GAAI,GAAiB,CAAC,EAAc,SAAS,EAAQ,UAAU,CAC7D,MAAO,CACL,QAAS,GACT,OAAQ,UAAU,EAAQ,UAAU,iDAAiD,EAAM,KAAK,IAAI,IACrG,CAYL,OARI,EAAM,KAAK,WAAa,YACnB,CACL,QAAS,GACT,SAAU,UACV,OAAQ,oBAAoB,EAAM,KAAK,IAAI,2CAC5C,CAGI,CAAE,QAAS,GAAM,CAG1B,aACE,EACA,EACS,CACT,OAAO,EAAU,UAAU,KACxB,GACC,EAAM,MAAM,KAAK,MAAQ,EAAS,MAAM,KAAK,MAC5C,EAAS,MAAM,KAAK,SAAW,MAC9B,EAAM,MAAM,KAAK,UAAY,EAAS,MAAM,KAAK,SACtD"}

package/dist/knowledge/source.d.ts

@@ -1,33 +0,0 @@
-//#region src/knowledge/source.d.ts
-type KnowledgeSourceType = 'notion' | 'url' | 'file_upload' | 'email' | 'api' | 'manual';
-interface KnowledgeSourceMeta {
-  id: string;
-  tenantId: string;
-  spaceKey: string;
-  spaceVersion: number;
-  label: string;
-  sourceType: KnowledgeSourceType;
-  createdAt: string | Date;
-  updatedAt: string | Date;
-}
-interface KnowledgeSourceConfig {
-  meta: KnowledgeSourceMeta;
-  /** Source-specific configuration (URLs, credentials, filters). */
-  config: Record<string, unknown>;
-  /** Sync schedule (cron or interval). */
-  syncSchedule?: {
-    enabled: boolean;
-    cron?: string;
-    intervalMs?: number;
-  };
-  /** Last sync status. */
-  lastSync?: {
-    timestamp: Date;
-    success: boolean;
-    itemsProcessed?: number;
-    error?: string;
-  };
-}
-//#endregion
-export { KnowledgeSourceConfig, KnowledgeSourceMeta, KnowledgeSourceType };
-//# sourceMappingURL=source.d.ts.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,8 +0,0 @@
-import { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from "../spec.js";
-
-//#region src/knowledge/spaces/email-threads.d.ts
-declare const emailThreadsKnowledgeSpace: KnowledgeSpaceSpec;
-declare function registerEmailThreadsKnowledgeSpace(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry;
-//#endregion
-export { emailThreadsKnowledgeSpace, registerEmailThreadsKnowledgeSpace };
-//# sourceMappingURL=email-threads.d.ts.map

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

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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":"mDAGA,MAAaA,EAAiD,CAC5D,KAAM,CACJ,IAAK,0BACL,QAAS,EACT,SAAU,cACV,YAAa,gBACb,MAAO,4BACP,YACE,2FACF,OAAQ,aACR,OAAQ,CAAC,sBAAsB,CAC/B,KAAM,CAAC,QAAS,aAAa,CAC7B,UAAW,EAAc,KAC1B,CACD,UAAW,CACT,QAAS,IACV,CACD,OAAQ,CACN,OAAQ,CAAE,KAAM,iCAAkC,QAAS,EAAG,CAC9D,WAAY,SACZ,mBAAoB,GACrB,CACD,SAAU,CACR,eAAgB,gBAChB,UAAW,IACX,oBAAqB,kBACtB,CACD,YACE,sGACH,CAED,SAAgB,EACd,EACwB,CACxB,OAAO,EAAS,SAAS,EAA2B"}

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

@@ -1,8 +0,0 @@
-import { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from "../spec.js";
-
-//#region src/knowledge/spaces/financial-docs.d.ts
-declare const financialDocsKnowledgeSpace: KnowledgeSpaceSpec;
-declare function registerFinancialDocsKnowledgeSpace(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry;
-//#endregion
-export { financialDocsKnowledgeSpace, registerFinancialDocsKnowledgeSpace };
-//# sourceMappingURL=financial-docs.d.ts.map

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

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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":"mDAGA,MAAaA,EAAkD,CAC7D,KAAM,CACJ,IAAK,2BACL,QAAS,EACT,SAAU,YACV,YAAa,sBACb,MAAO,gCACP,YACE,qFACF,OAAQ,UACR,OAAQ,CAAC,mBAAmB,CAC5B,KAAM,CAAC,UAAW,YAAY,CAC9B,UAAW,EAAc,KAC1B,CACD,UAAW,CACT,QAAS,KACV,CACD,OAAQ,CACN,OAAQ,CAAE,KAAM,kCAAmC,QAAS,EAAG,CAC/D,WAAY,OACZ,mBAAoB,GACrB,CACD,SAAU,CACR,eAAgB,gBAChB,UAAW,IACX,oBAAqB,kBACtB,CACD,YACE,yFACH,CAED,SAAgB,EACd,EACwB,CACxB,OAAO,EAAS,SAAS,EAA4B"}

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

@@ -1,8 +0,0 @@
-import { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from "../spec.js";
-
-//#region src/knowledge/spaces/financial-overview.d.ts
-declare const financialOverviewKnowledgeSpace: KnowledgeSpaceSpec;
-declare function registerFinancialOverviewKnowledgeSpace(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry;
-//#endregion
-export { financialOverviewKnowledgeSpace, registerFinancialOverviewKnowledgeSpace };
-//# sourceMappingURL=financial-overview.d.ts.map

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

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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":"mDAGA,MAAaA,EAAsD,CACjE,KAAM,CACJ,IAAK,+BACL,QAAS,EACT,SAAU,cACV,YAAa,+BACb,MAAO,8BACP,YACE,yGACF,OAAQ,UACR,OAAQ,CAAC,mBAAmB,CAC5B,KAAM,CAAC,eAAgB,YAAa,WAAW,CAC/C,UAAW,EAAc,aAC1B,CACD,UAAW,CACT,QAAS,IACV,CACD,OAAQ,CACN,OAAQ,CAAE,KAAM,sCAAuC,QAAS,EAAG,CACnE,WAAY,SACZ,mBAAoB,GACrB,CACD,SAAU,CACR,eAAgB,gBAChB,UAAW,IACX,oBAAqB,kBACtB,CACD,YACE,gKACH,CAED,SAAgB,EACd,EACwB,CACxB,OAAO,EAAS,SAAS,EAAgC"}

package/dist/knowledge/spaces/index.d.ts

@@ -1,7 +0,0 @@
-import { productCanonKnowledgeSpace, registerProductCanonKnowledgeSpace } from "./product-canon.js";
-import { registerSupportFaqKnowledgeSpace, supportFaqKnowledgeSpace } from "./support-faq.js";
-import { emailThreadsKnowledgeSpace, registerEmailThreadsKnowledgeSpace } from "./email-threads.js";
-import { registerUploadedDocsKnowledgeSpace, uploadedDocsKnowledgeSpace } from "./uploaded-docs.js";
-import { financialDocsKnowledgeSpace, registerFinancialDocsKnowledgeSpace } from "./financial-docs.js";
-import { financialOverviewKnowledgeSpace, registerFinancialOverviewKnowledgeSpace } from "./financial-overview.js";
-export { emailThreadsKnowledgeSpace, financialDocsKnowledgeSpace, financialOverviewKnowledgeSpace, productCanonKnowledgeSpace, registerEmailThreadsKnowledgeSpace, registerFinancialDocsKnowledgeSpace, registerFinancialOverviewKnowledgeSpace, registerProductCanonKnowledgeSpace, registerSupportFaqKnowledgeSpace, registerUploadedDocsKnowledgeSpace, supportFaqKnowledgeSpace, uploadedDocsKnowledgeSpace };

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

@@ -1,8 +0,0 @@
-import { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from "../spec.js";
-
-//#region src/knowledge/spaces/product-canon.d.ts
-declare const productCanonKnowledgeSpace: KnowledgeSpaceSpec;
-declare function registerProductCanonKnowledgeSpace(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry;
-//#endregion
-export { productCanonKnowledgeSpace, registerProductCanonKnowledgeSpace };
-//# sourceMappingURL=product-canon.d.ts.map

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

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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":"mDAGA,MAAaA,EAAiD,CAC5D,KAAM,CACJ,IAAK,0BACL,QAAS,EACT,SAAU,YACV,YAAa,gBACb,MAAO,gCACP,YACE,kFACF,OAAQ,UACR,OAAQ,CAAC,mBAAmB,CAC5B,KAAM,CAAC,YAAa,UAAU,CAC9B,UAAW,EAAc,OAC1B,CACD,UAAW,CACT,QAAS,KACV,CACD,OAAQ,CACN,OAAQ,CAAE,KAAM,iCAAkC,QAAS,EAAG,CAC9D,WAAY,OACZ,mBAAoB,GACrB,CACD,SAAU,CACR,eAAgB,yBAChB,UAAW,IACX,oBAAqB,kBACtB,CACD,YACE,kFACH,CAED,SAAgB,EACd,EACwB,CACxB,OAAO,EAAS,SAAS,EAA2B"}

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

@@ -1,8 +0,0 @@
-import { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from "../spec.js";
-
-//#region src/knowledge/spaces/support-faq.d.ts
-declare const supportFaqKnowledgeSpace: KnowledgeSpaceSpec;
-declare function registerSupportFaqKnowledgeSpace(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry;
-//#endregion
-export { registerSupportFaqKnowledgeSpace, supportFaqKnowledgeSpace };
-//# sourceMappingURL=support-faq.d.ts.map

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

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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":"mDAGA,MAAaA,EAA+C,CAC1D,KAAM,CACJ,IAAK,wBACL,QAAS,EACT,SAAU,cACV,YAAa,cACb,MAAO,wBACP,YAAa,+DACb,OAAQ,UACR,OAAQ,CAAC,mBAAmB,CAC5B,KAAM,CAAC,YAAa,UAAU,CAC9B,UAAW,EAAc,KAC1B,CACD,UAAW,CACT,QAAS,IACT,iBAAkB,IACnB,CACD,OAAQ,CACN,OAAQ,CAAE,KAAM,2BAA4B,QAAS,EAAG,CACxD,WAAY,SACZ,mBAAoB,GACrB,CACD,SAAU,CACR,eAAgB,yBAChB,UAAW,IACX,oBAAqB,kBACtB,CACD,YACE,gGACH,CAED,SAAgB,EACd,EACwB,CACxB,OAAO,EAAS,SAAS,EAAyB"}

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

@@ -1,8 +0,0 @@
-import { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from "../spec.js";
-
-//#region src/knowledge/spaces/uploaded-docs.d.ts
-declare const uploadedDocsKnowledgeSpace: KnowledgeSpaceSpec;
-declare function registerUploadedDocsKnowledgeSpace(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry;
-//#endregion
-export { registerUploadedDocsKnowledgeSpace, uploadedDocsKnowledgeSpace };
-//# sourceMappingURL=uploaded-docs.d.ts.map

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

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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":"mDAGA,MAAaA,EAAiD,CAC5D,KAAM,CACJ,IAAK,0BACL,QAAS,EACT,SAAU,WACV,YAAa,qBACb,MAAO,4BACP,YACE,wFACF,OAAQ,aACR,OAAQ,CAAC,sBAAsB,CAC/B,KAAM,CAAC,YAAa,UAAU,CAC9B,UAAW,EAAc,KAC1B,CACD,UAAW,CACT,QAAS,KACV,CACD,OAAQ,CACN,OAAQ,CAAE,KAAM,iCAAkC,QAAS,EAAG,CAC9D,WAAY,SACZ,mBAAoB,GACrB,CACD,SAAU,CACR,eAAgB,gBAChB,UAAW,IACX,oBAAqB,kBACtB,CACD,YACE,qFACH,CAED,SAAgB,EACd,EACwB,CACxB,OAAO,EAAS,SAAS,EAA2B"}

package/dist/knowledge/spec.d.ts

@@ -1,53 +0,0 @@
-import { OwnerShipMeta } from "../ownership.js";
-import { PolicyRef } from "../policy/spec.js";
-
-//#region src/knowledge/spec.d.ts
-type KnowledgeCategory = 'canonical' | 'operational' | 'external' | 'ephemeral';
-interface KnowledgeSpaceMeta extends OwnerShipMeta {
-  /** Stable space identifier (e.g., "product-canon", "support-faq"). */
-  key: string;
-  version: number;
-  category: KnowledgeCategory;
-  displayName: string;
-}
-interface KnowledgeRetentionPolicy {
-  /** TTL in days (null = indefinite). */
-  ttlDays?: number | null;
-  /** Auto-archive after inactivity. */
-  archiveAfterDays?: number;
-}
-interface KnowledgeAccessPolicy {
-  /** Which PolicySpec governs access. */
-  policy?: PolicyRef;
-  /** Trust level for agent/workflow consumption. */
-  trustLevel: 'high' | 'medium' | 'low';
-  /** Can this space be mutated by automation? */
-  automationWritable: boolean;
-}
-interface KnowledgeIndexingConfig {
-  embeddingModel?: string;
-  chunkSize?: number;
-  vectorDbIntegration?: string;
-}
-interface KnowledgeSpaceSpec {
-  meta: KnowledgeSpaceMeta;
-  /** Retention and cleanup rules. */
-  retention: KnowledgeRetentionPolicy;
-  /** Access control and trust. */
-  access: KnowledgeAccessPolicy;
-  /** Optional embedding/indexing config. */
-  indexing?: KnowledgeIndexingConfig;
-  /** Documentation. */
-  description?: string;
-}
-declare class KnowledgeSpaceRegistry {
-  private readonly items;
-  register(spec: KnowledgeSpaceSpec): this;
-  list(): KnowledgeSpaceSpec[];
-  get(key: string, version?: number): KnowledgeSpaceSpec | undefined;
-  getByCategory(category: KnowledgeCategory): KnowledgeSpaceSpec[];
-}
-declare function makeKnowledgeSpaceKey(meta: KnowledgeSpaceMeta): string;
-//#endregion
-export { KnowledgeAccessPolicy, KnowledgeCategory, KnowledgeIndexingConfig, KnowledgeRetentionPolicy, KnowledgeSpaceMeta, KnowledgeSpaceRegistry, KnowledgeSpaceSpec, makeKnowledgeSpaceKey };
-//# sourceMappingURL=spec.d.ts.map

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

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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,EAAgB,GACpB,GAAG,EAAK,IAAI,IAAI,EAAK,UAEvB,IAAa,EAAb,KAAoC,CAClC,MAAyB,IAAI,IAE7B,SAAS,EAAgC,CACvC,IAAM,EAAM,EAAa,EAAK,KAAK,CACnC,GAAI,KAAK,MAAM,IAAI,EAAI,CACrB,MAAU,MAAM,gCAAgC,IAAM,CAGxD,OADA,KAAK,MAAM,IAAI,EAAK,EAAK,CAClB,KAGT,MAA6B,CAC3B,MAAO,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC,CAGjC,IAAI,EAAa,EAAkD,CACjE,GAAI,GAAW,KACb,OAAO,KAAK,MAAM,IAAI,EAAa,CAAE,MAAK,UAAS,CAAC,CAAC,CAEvD,IAAIA,EACA,EAAa,KACjB,IAAK,IAAM,KAAQ,KAAK,MAAM,QAAQ,CAChC,EAAK,KAAK,MAAQ,GAClB,EAAK,KAAK,QAAU,IACtB,EAAa,EAAK,KAAK,QACvB,EAAS,GAGb,OAAO,EAGT,cAAc,EAAmD,CAC/D,OAAO,KAAK,MAAM,CAAC,OAAQ,GAAS,EAAK,KAAK,WAAa,EAAS,GAIxE,SAAgB,EAAsB,EAA0B,CAC9D,OAAO,EAAa,EAAK"}

package/dist/markdown.d.ts

@@ -1,22 +0,0 @@
-import { PresentationRegistry } from "./presentations.js";
-import { FeatureRegistry } from "./features.js";
-import { SpecRegistry } from "./registry.js";
-
-//#region src/markdown.d.ts
-
-/**
- * Render simple Markdown docs for each spec.
- * Useful for dev portals and repo docs generation.
- */
-declare function specsToMarkdown(reg: SpecRegistry, extras?: {
-  presentations?: PresentationRegistry;
-  features?: FeatureRegistry;
-}): string;
-/** Render presentations and features as additional sections. */
-declare function docsToMarkdown(reg: SpecRegistry, extras: {
-  presentations?: PresentationRegistry;
-  features?: FeatureRegistry;
-}): string;
-//#endregion
-export { docsToMarkdown, specsToMarkdown };
-//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"markdown.d.ts","names":[],"sources":["../src/markdown.ts"],"sourcesContent":[],"mappings":";;;;;;;;AASA;;AAE6B,iBAFb,eAAA,CAEa,GAAA,EADtB,YACsB,EAAA,MA2F7B,CA3F6B,EAAA;EAAiC,aAAA,CAAA,EAAjC,oBAAiC;EAAe,QAAA,CAAA,EAAf,eAAe;AA2F7E,CAAA,CAAA,EAAgB,MAAA;;AAEY,iBAFZ,cAAA,CAEY,GAAA,EADrB,YACqB,EAAA,MAAA,EAAA;EAAiC,aAAA,CAAA,EAAjC,oBAAiC;EAAe,QAAA,CAAA,EAAf,eAAe"}

package/dist/markdown.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"markdown.js","names":["lines: string[]","parts: string[]"],"sources":["../src/markdown.ts"],"sourcesContent":["import type { SpecRegistry } from './registry';\nimport { isEmitDeclRef } from './spec';\nimport type { PresentationRegistry } from './presentations';\nimport type { FeatureRegistry } from './features';\n\n/**\n * Render simple Markdown docs for each spec.\n * Useful for dev portals and repo docs generation.\n */\nexport function specsToMarkdown(\n  reg: SpecRegistry,\n  extras?: { presentations?: PresentationRegistry; features?: FeatureRegistry }\n): string {\n  const lines: string[] = [];\n\n  for (const spec of reg.listSpecs()) {\n    const m = spec.meta;\n    lines.push(`# ${m.name}.v${m.version}`);\n    lines.push('');\n    lines.push(\n      `**Kind:** ${m.kind} | **Stability:** ${m.stability} | **Owners:** ${m.owners.join(', ')}`\n    );\n    lines.push('');\n    lines.push(`**Description:** ${m.description}`);\n    lines.push('');\n    lines.push(`## Goal`);\n    lines.push(m.goal);\n    lines.push('');\n    lines.push(`## Context`);\n    lines.push(m.context);\n    lines.push('');\n\n    lines.push(`## Policy`);\n    lines.push(`- Auth: ${spec.policy.auth}`);\n    lines.push(`- Idempotent: ${!!spec.policy.idempotent}`);\n    if (spec.policy.rateLimit)\n      lines.push(\n        `- Rate Limit: ${spec.policy.rateLimit.rpm}/min by ${spec.policy.rateLimit.key}`\n      );\n    if (spec.policy.flags?.length)\n      lines.push(`- Flags: ${spec.policy.flags.join(', ')}`);\n    if (spec.policy.pii?.length)\n      lines.push(`- PII: ${spec.policy.pii.join(', ')}`);\n    lines.push('');\n\n    if (spec.sideEffects?.emits?.length) {\n      lines.push(`## Emits Events`);\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.io.errors && Object.keys(spec.io.errors).length) {\n      lines.push(`## Errors`);\n      for (const [code, err] of Object.entries(spec.io.errors)) {\n        lines.push(\n          `- \\`${code}\\` (${err.http ?? 400}) — ${err.description} (when: ${err.when})`\n        );\n      }\n      lines.push('');\n    }\n\n    if (spec.acceptance?.scenarios?.length) {\n      lines.push(`## Acceptance Scenarios`);\n      for (const s of spec.acceptance.scenarios) {\n        lines.push(`### ${s.name}`);\n        lines.push(`- **Given:** ${s.given.join('; ')}`);\n        lines.push(`- **When:** ${s.when.join('; ')}`);\n        lines.push(`- **Then:** ${s.then.join('; ')}`);\n        lines.push('');\n      }\n    }\n\n    if (spec.acceptance?.examples?.length) {\n      lines.push(`## Examples`);\n      for (const ex of spec.acceptance.examples) {\n        lines.push(`- **${ex.name}**`);\n        lines.push('  - Input:');\n        lines.push('    ```json');\n        lines.push(JSON.stringify(ex.input, null, 2));\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    lines.push('---');\n    lines.push('');\n  }\n\n  return lines.join('\\n');\n}\n\n/** Render presentations and features as additional sections. */\nexport function docsToMarkdown(\n  reg: SpecRegistry,\n  extras: { presentations?: PresentationRegistry; features?: FeatureRegistry }\n): string {\n  const parts: string[] = [];\n  parts.push(specsToMarkdown(reg, extras));\n\n  if (extras.presentations) {\n    parts.push('# Presentations');\n    parts.push('');\n    for (const p of extras.presentations.list()) {\n      parts.push(`## ${p.meta.name}.v${p.meta.version}`);\n      parts.push('');\n      parts.push(`- Kind: ${(p.content as any).kind}`);\n      if ('framework' in p.content)\n        parts.push(`- Framework: ${p.content.framework}`);\n      if ('componentKey' in p.content)\n        parts.push(`- Component Key: ${(p.content as any).componentKey}`);\n      if ('mimeType' in p.content)\n        parts.push(`- MIME Type: ${(p.content as any).mimeType}`);\n      parts.push('');\n    }\n    parts.push('');\n  }\n\n  if (extras.features) {\n    parts.push('# Features');\n    parts.push('');\n    for (const f of extras.features.list()) {\n      parts.push(`## ${f.meta.title} (${f.meta.key})`);\n      if (f.meta.description) parts.push(f.meta.description);\n      parts.push('');\n      if (f.operations?.length) {\n        parts.push('- Operations:');\n        for (const o of f.operations) parts.push(`  - ${o.name}.v${o.version}`);\n      }\n      if (f.events?.length) {\n        parts.push('- Events:');\n        for (const e of f.events) parts.push(`  - ${e.name}.v${e.version}`);\n      }\n      if (f.presentations?.length) {\n        parts.push('- Presentations:');\n        for (const p of f.presentations)\n          parts.push(`  - ${p.name}.v${p.version}`);\n      }\n      parts.push('');\n    }\n  }\n\n  return parts.join('\\n');\n}\n"],"mappings":"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"}

package/dist/migrations.d.ts

@@ -1,53 +0,0 @@
-import { OwnerShipMeta } from "./ownership.js";
-
-//#region src/migrations.d.ts
-type MigrationStepKind = 'schema' | 'data' | 'validation';
-interface MigrationCheck {
-  description: string;
-  expression: string;
-}
-interface MigrationStepBase {
-  kind: MigrationStepKind;
-  description?: string;
-  timeoutMs?: number;
-  retries?: number;
-  preChecks?: MigrationCheck[];
-  postChecks?: MigrationCheck[];
-}
-interface SchemaMigrationStep extends MigrationStepBase {
-  kind: 'schema';
-  sql: string;
-}
-interface DataMigrationStep extends MigrationStepBase {
-  kind: 'data';
-  script: string;
-}
-interface ValidationMigrationStep extends MigrationStepBase {
-  kind: 'validation';
-  assertion: string;
-}
-type MigrationStep = SchemaMigrationStep | DataMigrationStep | ValidationMigrationStep;
-interface MigrationMeta extends OwnerShipMeta {
-  /** Fully qualified migration name (e.g., "sigil.db.2025_01_add_users"). */
-  name: string;
-  /** Increment when the migration changes. */
-  version: number;
-}
-interface MigrationPlan {
-  up: MigrationStep[];
-  down?: MigrationStep[];
-}
-interface MigrationSpec {
-  meta: MigrationMeta;
-  plan: MigrationPlan;
-  dependencies?: string[];
-}
-declare class MigrationRegistry {
-  private readonly items;
-  register(spec: MigrationSpec): this;
-  list(): MigrationSpec[];
-  get(name: string, version?: number): MigrationSpec | undefined;
-}
-//#endregion
-export { DataMigrationStep, MigrationCheck, MigrationMeta, MigrationPlan, MigrationRegistry, MigrationSpec, MigrationStep, MigrationStepBase, MigrationStepKind, SchemaMigrationStep, ValidationMigrationStep };
-//# sourceMappingURL=migrations.d.ts.map

package/dist/migrations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"migrations.d.ts","names":[],"sources":["../src/migrations.ts"],"sourcesContent":[],"mappings":";;;KAEY,iBAAA;UAEK,cAAA;EAFL,WAAA,EAAA,MAAA;EAEK,UAAA,EAAA,MAAc;AAK/B;AACQ,UADS,iBAAA,CACT;EAIM,IAAA,EAJN,iBAIM;EACC,WAAA,CAAA,EAAA,MAAA;EAAc,SAAA,CAAA,EAAA,MAAA;EAGZ,OAAA,CAAA,EAAA,MAAA;EAKA,SAAA,CAAA,EATH,cASqB,EAAA;EAKlB,UAAA,CAAA,EAbF,cAa0B,EAAA;AAKzC;AACI,UAhBa,mBAAA,SAA4B,iBAgBzC,CAAA;EACA,IAAA,EAAA,QAAA;EACA,GAAA,EAAA,MAAA;;AAEa,UAfA,iBAAA,SAA0B,iBAeS,CAAA;EAOnC,IAAA,EAAA,MAAA;EAKA,MAAA,EAAA,MAAA;AAQjB;AAGiB,UAjCA,uBAAA,SAAgC,iBAiChC,CAAA;EAOP,IAAA,EAAA,YAAA;EAS6B,SAAA,EAAA,MAAA;;KA5C3B,aAAA,GACR,sBACA,oBACA;UAEa,aAAA,SAAsB;;;;;;UAOtB,aAAA;MACX;SACG;;UAGQ,aAAA;QACT;QACA;;;cAMK,iBAAA;;iBAGI;UAOP;uCAS6B"}

package/dist/migrations.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"migrations.js","names":["candidate: MigrationSpec | undefined"],"sources":["../src/migrations.ts"],"sourcesContent":["import type { OwnerShipMeta } from './ownership';\n\nexport type MigrationStepKind = 'schema' | 'data' | 'validation';\n\nexport interface MigrationCheck {\n  description: string;\n  expression: string;\n}\n\nexport interface MigrationStepBase {\n  kind: MigrationStepKind;\n  description?: string;\n  timeoutMs?: number;\n  retries?: number;\n  preChecks?: MigrationCheck[];\n  postChecks?: MigrationCheck[];\n}\n\nexport interface SchemaMigrationStep extends MigrationStepBase {\n  kind: 'schema';\n  sql: string;\n}\n\nexport interface DataMigrationStep extends MigrationStepBase {\n  kind: 'data';\n  script: string;\n}\n\nexport interface ValidationMigrationStep extends MigrationStepBase {\n  kind: 'validation';\n  assertion: string;\n}\n\nexport type MigrationStep =\n  | SchemaMigrationStep\n  | DataMigrationStep\n  | ValidationMigrationStep;\n\nexport interface MigrationMeta extends OwnerShipMeta {\n  /** Fully qualified migration name (e.g., \"sigil.db.2025_01_add_users\"). */\n  name: string;\n  /** Increment when the migration changes. */\n  version: number;\n}\n\nexport interface MigrationPlan {\n  up: MigrationStep[];\n  down?: MigrationStep[];\n}\n\nexport interface MigrationSpec {\n  meta: MigrationMeta;\n  plan: MigrationPlan;\n  dependencies?: string[];\n}\n\nconst migrationKey = (name: string, version: number) => `${name}.v${version}`;\n\nexport class MigrationRegistry {\n  private readonly items = new Map<string, MigrationSpec>();\n\n  register(spec: MigrationSpec): this {\n    const key = migrationKey(spec.meta.name, spec.meta.version);\n    if (this.items.has(key)) throw new Error(`Duplicate migration ${key}`);\n    this.items.set(key, spec);\n    return this;\n  }\n\n  list(): MigrationSpec[] {\n    return [...this.items.values()].sort((a, b) =>\n      compareKey(\n        migrationKey(a.meta.name, a.meta.version),\n        migrationKey(b.meta.name, b.meta.version)\n      )\n    );\n  }\n\n  get(name: string, version?: number): MigrationSpec | undefined {\n    if (version != null) return this.items.get(migrationKey(name, version));\n    let candidate: MigrationSpec | undefined;\n    let max = -Infinity;\n    for (const spec of this.items.values()) {\n      if (spec.meta.name !== name) continue;\n      if (spec.meta.version > max) {\n        max = spec.meta.version;\n        candidate = spec;\n      }\n    }\n    return candidate;\n  }\n}\n\nfunction compareKey(a: string, b: string) {\n  return a < b ? -1 : a > b ? 1 : 0;\n}\n"],"mappings":"AAwDA,MAAM,GAAgB,EAAc,IAAoB,GAAG,EAAK,IAAI,IAEpE,IAAa,EAAb,KAA+B,CAC7B,MAAyB,IAAI,IAE7B,SAAS,EAA2B,CAClC,IAAM,EAAM,EAAa,EAAK,KAAK,KAAM,EAAK,KAAK,QAAQ,CAC3D,GAAI,KAAK,MAAM,IAAI,EAAI,CAAE,MAAU,MAAM,uBAAuB,IAAM,CAEtE,OADA,KAAK,MAAM,IAAI,EAAK,EAAK,CAClB,KAGT,MAAwB,CACtB,MAAO,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC,CAAC,MAAM,EAAG,IACvC,EACE,EAAa,EAAE,KAAK,KAAM,EAAE,KAAK,QAAQ,CACzC,EAAa,EAAE,KAAK,KAAM,EAAE,KAAK,QAAQ,CAC1C,CACF,CAGH,IAAI,EAAc,EAA6C,CAC7D,GAAI,GAAW,KAAM,OAAO,KAAK,MAAM,IAAI,EAAa,EAAM,EAAQ,CAAC,CACvE,IAAIA,EACA,EAAM,KACV,IAAK,IAAM,KAAQ,KAAK,MAAM,QAAQ,CAChC,EAAK,KAAK,OAAS,GACnB,EAAK,KAAK,QAAU,IACtB,EAAM,EAAK,KAAK,QAChB,EAAY,GAGhB,OAAO,IAIX,SAAS,EAAW,EAAW,EAAW,CACxC,OAAO,EAAI,EAAI,GAAK,EAAI,EAAI,EAAI"}