@contractspec/lib.contracts 1.62.0 → 1.64.0

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

@@ -1,103 +0,0 @@
-// @bun
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __moduleCache = /* @__PURE__ */ new WeakMap;
-var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
-  if (entry)
-    return entry;
-  entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
-  __moduleCache.set(from, entry);
-  return entry;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-var __require = import.meta.require;
-
-// src/knowledge/ingestion/gmail-adapter.ts
-class GmailIngestionAdapter {
-  gmail;
-  processor;
-  embeddings;
-  indexer;
-  constructor(gmail, processor, embeddings, indexer) {
-    this.gmail = gmail;
-    this.processor = processor;
-    this.embeddings = embeddings;
-    this.indexer = indexer;
-  }
-  async syncThreads(query) {
-    const threads = await this.gmail.listThreads(query);
-    for (const thread of threads) {
-      await this.ingestThread(thread);
-    }
-  }
-  async ingestThread(thread) {
-    const document = this.toRawDocument(thread);
-    const fragments = await this.processor.process(document);
-    const embeddings = await this.embeddings.embedFragments(fragments);
-    await this.indexer.upsert(fragments, embeddings);
-  }
-  toRawDocument(thread) {
-    const content = composeThreadText(thread);
-    return {
-      id: thread.id,
-      mimeType: "text/plain",
-      data: Buffer.from(content, "utf-8"),
-      metadata: {
-        subject: thread.subject ?? "",
-        participants: thread.participants.map((p) => p.email).join(", "),
-        updatedAt: thread.updatedAt.toISOString()
-      }
-    };
-  }
-}
-function composeThreadText(thread) {
-  const header = [
-    `Subject: ${thread.subject ?? ""}`,
-    `Snippet: ${thread.snippet ?? ""}`
-  ];
-  const messageTexts = thread.messages.map((message) => {
-    const parts = [
-      `From: ${formatAddress(message.from)}`,
-      `To: ${message.to.map(formatAddress).join(", ")}`
-    ];
-    if (message.sentAt) {
-      parts.push(`Date: ${message.sentAt.toISOString()}`);
-    }
-    const body = message.textBody ?? stripHtml(message.htmlBody ?? "");
-    return `${parts.join(`
-`)}
-
-${body ?? ""}`;
-  });
-  return [...header, ...messageTexts].join(`
-
----
-
-`);
-}
-function formatAddress(address) {
-  return address.name ? `${address.name} <${address.email}>` : address.email;
-}
-function stripHtml(html) {
-  return html.replace(/<[^>]+>/g, " ");
-}
-export {
-  GmailIngestionAdapter
-};

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

@@ -1,6 +0,0 @@
-export * from './document-processor';
-export * from './embedding-service';
-export * from './vector-indexer';
-export * from './gmail-adapter';
-export * from './storage-adapter';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/knowledge/ingestion/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/knowledge/ingestion/index.js

@@ -1,252 +0,0 @@
-// @bun
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __moduleCache = /* @__PURE__ */ new WeakMap;
-var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
-  if (entry)
-    return entry;
-  entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
-  __moduleCache.set(from, entry);
-  return entry;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-var __require = import.meta.require;
-
-// src/knowledge/ingestion/document-processor.ts
-import { Buffer as Buffer2 } from "buffer";
-
-class DocumentProcessor {
-  extractors = new Map;
-  constructor() {
-    this.registerExtractor("text/plain", this.extractText);
-    this.registerExtractor("application/json", this.extractJson);
-  }
-  registerExtractor(mimeType, extractor) {
-    this.extractors.set(mimeType.toLowerCase(), extractor);
-  }
-  async process(document) {
-    const extractor = this.extractors.get(document.mimeType.toLowerCase()) ?? this.extractors.get("*/*");
-    if (!extractor) {
-      throw new Error(`No extractor registered for mime type ${document.mimeType}`);
-    }
-    const fragments = await extractor(document);
-    if (fragments.length === 0) {
-      return [
-        {
-          id: `${document.id}:0`,
-          documentId: document.id,
-          text: "",
-          metadata: document.metadata
-        }
-      ];
-    }
-    return fragments;
-  }
-  async extractText(document) {
-    const text = Buffer2.from(document.data).toString("utf-8");
-    return [
-      {
-        id: `${document.id}:0`,
-        documentId: document.id,
-        text,
-        metadata: document.metadata
-      }
-    ];
-  }
-  async extractJson(document) {
-    const text = Buffer2.from(document.data).toString("utf-8");
-    try {
-      const json = JSON.parse(text);
-      return [
-        {
-          id: `${document.id}:0`,
-          documentId: document.id,
-          text: JSON.stringify(json, null, 2),
-          metadata: {
-            ...document.metadata,
-            contentType: "application/json"
-          }
-        }
-      ];
-    } catch {
-      return this.extractText(document);
-    }
-  }
-}
-
-// src/knowledge/ingestion/embedding-service.ts
-class EmbeddingService {
-  provider;
-  batchSize;
-  constructor(provider, batchSize = 16) {
-    this.provider = provider;
-    this.batchSize = batchSize;
-  }
-  async embedFragments(fragments) {
-    const results = [];
-    for (let i = 0;i < fragments.length; i += this.batchSize) {
-      const slice = fragments.slice(i, i + this.batchSize);
-      const documents = slice.map((fragment) => ({
-        id: fragment.id,
-        text: fragment.text,
-        metadata: fragment.metadata
-      }));
-      const embeddings = await this.provider.embedDocuments(documents);
-      results.push(...embeddings);
-    }
-    return results;
-  }
-}
-
-// src/knowledge/ingestion/gmail-adapter.ts
-class GmailIngestionAdapter {
-  gmail;
-  processor;
-  embeddings;
-  indexer;
-  constructor(gmail, processor, embeddings, indexer) {
-    this.gmail = gmail;
-    this.processor = processor;
-    this.embeddings = embeddings;
-    this.indexer = indexer;
-  }
-  async syncThreads(query) {
-    const threads = await this.gmail.listThreads(query);
-    for (const thread of threads) {
-      await this.ingestThread(thread);
-    }
-  }
-  async ingestThread(thread) {
-    const document = this.toRawDocument(thread);
-    const fragments = await this.processor.process(document);
-    const embeddings = await this.embeddings.embedFragments(fragments);
-    await this.indexer.upsert(fragments, embeddings);
-  }
-  toRawDocument(thread) {
-    const content = composeThreadText(thread);
-    return {
-      id: thread.id,
-      mimeType: "text/plain",
-      data: Buffer.from(content, "utf-8"),
-      metadata: {
-        subject: thread.subject ?? "",
-        participants: thread.participants.map((p) => p.email).join(", "),
-        updatedAt: thread.updatedAt.toISOString()
-      }
-    };
-  }
-}
-function composeThreadText(thread) {
-  const header = [
-    `Subject: ${thread.subject ?? ""}`,
-    `Snippet: ${thread.snippet ?? ""}`
-  ];
-  const messageTexts = thread.messages.map((message) => {
-    const parts = [
-      `From: ${formatAddress(message.from)}`,
-      `To: ${message.to.map(formatAddress).join(", ")}`
-    ];
-    if (message.sentAt) {
-      parts.push(`Date: ${message.sentAt.toISOString()}`);
-    }
-    const body = message.textBody ?? stripHtml(message.htmlBody ?? "");
-    return `${parts.join(`
-`)}
-
-${body ?? ""}`;
-  });
-  return [...header, ...messageTexts].join(`
-
----
-
-`);
-}
-function formatAddress(address) {
-  return address.name ? `${address.name} <${address.email}>` : address.email;
-}
-function stripHtml(html) {
-  return html.replace(/<[^>]+>/g, " ");
-}
-
-// src/knowledge/ingestion/vector-indexer.ts
-class VectorIndexer {
-  provider;
-  config;
-  constructor(provider, config) {
-    this.provider = provider;
-    this.config = config;
-  }
-  async upsert(fragments, embeddings) {
-    const documents = embeddings.map((embedding) => {
-      const fragment = fragments.find((f) => f.id === embedding.id);
-      return {
-        id: embedding.id,
-        vector: embedding.vector,
-        payload: {
-          ...this.config.metadata,
-          ...fragment?.metadata ?? {},
-          documentId: fragment?.documentId
-        },
-        namespace: this.config.namespace
-      };
-    });
-    const request = {
-      collection: this.config.collection,
-      documents
-    };
-    await this.provider.upsert(request);
-  }
-}
-
-// src/knowledge/ingestion/storage-adapter.ts
-class StorageIngestionAdapter {
-  processor;
-  embeddings;
-  indexer;
-  constructor(processor, embeddings, indexer) {
-    this.processor = processor;
-    this.embeddings = embeddings;
-    this.indexer = indexer;
-  }
-  async ingestObject(object) {
-    if (!("data" in object) || !object.data) {
-      throw new Error("Storage ingestion requires object data");
-    }
-    const raw = {
-      id: object.key,
-      mimeType: object.contentType ?? "application/octet-stream",
-      data: object.data,
-      metadata: {
-        bucket: object.bucket,
-        checksum: object.checksum ?? ""
-      }
-    };
-    const fragments = await this.processor.process(raw);
-    const embeddings = await this.embeddings.embedFragments(fragments);
-    await this.indexer.upsert(fragments, embeddings);
-  }
-}
-export {
-  VectorIndexer,
-  StorageIngestionAdapter,
-  GmailIngestionAdapter,
-  EmbeddingService,
-  DocumentProcessor
-};

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

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=ingestion.test.d.ts.map

package/dist/knowledge/ingestion/ingestion.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ingestion.test.d.ts","sourceRoot":"","sources":["../../../src/knowledge/ingestion/ingestion.test.ts"],"names":[],"mappings":""}

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

@@ -1,12 +0,0 @@
-import type { GetObjectResult } from '../../integrations/providers/storage';
-import type { DocumentProcessor } from './document-processor';
-import type { EmbeddingService } from './embedding-service';
-import type { VectorIndexer } from './vector-indexer';
-export declare class StorageIngestionAdapter {
-    private readonly processor;
-    private readonly embeddings;
-    private readonly indexer;
-    constructor(processor: DocumentProcessor, embeddings: EmbeddingService, indexer: VectorIndexer);
-    ingestObject(object: GetObjectResult): Promise<void>;
-}
-//# 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","sourceRoot":"","sources":["../../../src/knowledge/ingestion/storage-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,qBAAa,uBAAuB;IAEhC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,SAAS,EAAE,iBAAiB,EAC5B,UAAU,EAAE,gBAAgB,EAC5B,OAAO,EAAE,aAAa;IAGnC,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAmB3D"}

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

@@ -1,62 +0,0 @@
-// @bun
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __moduleCache = /* @__PURE__ */ new WeakMap;
-var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
-  if (entry)
-    return entry;
-  entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
-  __moduleCache.set(from, entry);
-  return entry;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-var __require = import.meta.require;
-
-// src/knowledge/ingestion/storage-adapter.ts
-class StorageIngestionAdapter {
-  processor;
-  embeddings;
-  indexer;
-  constructor(processor, embeddings, indexer) {
-    this.processor = processor;
-    this.embeddings = embeddings;
-    this.indexer = indexer;
-  }
-  async ingestObject(object) {
-    if (!("data" in object) || !object.data) {
-      throw new Error("Storage ingestion requires object data");
-    }
-    const raw = {
-      id: object.key,
-      mimeType: object.contentType ?? "application/octet-stream",
-      data: object.data,
-      metadata: {
-        bucket: object.bucket,
-        checksum: object.checksum ?? ""
-      }
-    };
-    const fragments = await this.processor.process(raw);
-    const embeddings = await this.embeddings.embedFragments(fragments);
-    await this.indexer.upsert(fragments, embeddings);
-  }
-}
-export {
-  StorageIngestionAdapter
-};

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

@@ -1,15 +0,0 @@
-import type { VectorStoreProvider } from '../../integrations/providers/vector-store';
-import type { EmbeddingResult } from '../../integrations/providers/embedding';
-import type { DocumentFragment } from './document-processor';
-export interface VectorIndexConfig {
-    collection: string;
-    namespace?: string;
-    metadata?: Record<string, string>;
-}
-export declare class VectorIndexer {
-    private readonly provider;
-    private readonly config;
-    constructor(provider: VectorStoreProvider, config: VectorIndexConfig);
-    upsert(fragments: DocumentFragment[], embeddings: EmbeddingResult[]): Promise<void>;
-}
-//# 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","sourceRoot":"","sources":["../../../src/knowledge/ingestion/vector-indexer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EAEpB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;gBAE/B,QAAQ,EAAE,mBAAmB,EAAE,MAAM,EAAE,iBAAiB;IAK9D,MAAM,CACV,SAAS,EAAE,gBAAgB,EAAE,EAC7B,UAAU,EAAE,eAAe,EAAE,GAC5B,OAAO,CAAC,IAAI,CAAC;CAsBjB"}

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

@@ -1,63 +0,0 @@
-// @bun
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __moduleCache = /* @__PURE__ */ new WeakMap;
-var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
-  if (entry)
-    return entry;
-  entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
-  __moduleCache.set(from, entry);
-  return entry;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-var __require = import.meta.require;
-
-// src/knowledge/ingestion/vector-indexer.ts
-class VectorIndexer {
-  provider;
-  config;
-  constructor(provider, config) {
-    this.provider = provider;
-    this.config = config;
-  }
-  async upsert(fragments, embeddings) {
-    const documents = embeddings.map((embedding) => {
-      const fragment = fragments.find((f) => f.id === embedding.id);
-      return {
-        id: embedding.id,
-        vector: embedding.vector,
-        payload: {
-          ...this.config.metadata,
-          ...fragment?.metadata ?? {},
-          documentId: fragment?.documentId
-        },
-        namespace: this.config.namespace
-      };
-    });
-    const request = {
-      collection: this.config.collection,
-      documents
-    };
-    await this.provider.upsert(request);
-  }
-}
-export {
-  VectorIndexer
-};

package/dist/knowledge/knowledge.capability.d.ts

@@ -1,2 +0,0 @@
-export declare const KnowledgeCapability: import("..").CapabilitySpec;
-//# sourceMappingURL=knowledge.capability.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"knowledge.capability.d.ts","sourceRoot":"","sources":["../../src/knowledge/knowledge.capability.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB,6BAU9B,CAAC"}