@yolk-sdk/knowledge 0.1.0-canary.13 → 0.1.0-canary.130

package/dist/store.d.mts

@@ -1,44 +1,107 @@
-import { CreateKnowledgeRecordInput, KnowledgeRecord, KnowledgeScope, UpdateKnowledgeRecordInput } from "./records.mjs";
-import { KnowledgeStoreError } from "./errors.mjs";
-import { KnowledgeArtifact } from "./artifacts.mjs";
-import { KnowledgeRepresentation } from "./representations.mjs";
-import { KnowledgeLink } from "./links.mjs";
-import { KnowledgeProvenance } from "./provenance.mjs";
+import { CreateKnowledgeDocumentInput, IndexedKnowledgeDocument, KnowledgeChunk, KnowledgeDocument, KnowledgeDocumentId, KnowledgeFile, KnowledgeScope, KnowledgeScopeId, KnowledgeSearchScope, UpdateKnowledgeDocumentInput } from "./documents.mjs";
+import { KnowledgeEmbedding } from "./embeddings.mjs";
+import { KnowledgeStoreError, SearchIndexStoreError } from "./errors.mjs";
 import { Context, Effect } from "effect";
-
-//#region src/store.d.ts
-type GetKnowledgeRecordInput = {
+export type GetKnowledgeDocumentInput = {
   readonly scope: KnowledgeScope;
-  readonly id: string;
+  readonly id: KnowledgeDocumentId;
 };
-type ListKnowledgeRecordsInput = {
+export type GetKnowledgeDocumentBySlugInput = {
+  readonly scope: KnowledgeScope;
+  readonly slug: string;
+};
+export type ListKnowledgeDocumentsInput = {
   readonly scope: KnowledgeScope;
   readonly limit: number;
+  readonly availability?: KnowledgeDocument['availability'];
 };
-type ListKnowledgeRecordsResult = {
-  readonly records: ReadonlyArray<KnowledgeRecord>;
+export type ListKnowledgeDocumentsResult = {
+  readonly documents: ReadonlyArray<KnowledgeDocument>;
 };
-type ListPinnedKnowledgeInput = {
+export type ListPinnedKnowledgeInput = {
   readonly scope: KnowledgeScope;
   readonly limit: number;
 };
-type ListPinnedKnowledgeResult = {
-  readonly records: ReadonlyArray<KnowledgeRecord>;
-  readonly representations: ReadonlyArray<KnowledgeRepresentation>;
+export type ListPinnedKnowledgeResult = {
+  readonly documents: ReadonlyArray<KnowledgeDocument>;
 };
-type KnowledgeStoreApi = {
-  readonly createRecord: (input: CreateKnowledgeRecordInput) => Effect.Effect<KnowledgeRecord, KnowledgeStoreError>;
-  readonly updateRecord: (input: UpdateKnowledgeRecordInput) => Effect.Effect<KnowledgeRecord, KnowledgeStoreError>;
-  readonly getRecord: (input: GetKnowledgeRecordInput) => Effect.Effect<KnowledgeRecord, KnowledgeStoreError>;
-  readonly listRecords: (input: ListKnowledgeRecordsInput) => Effect.Effect<ListKnowledgeRecordsResult, KnowledgeStoreError>;
+export type KnowledgeStoreApi = {
+  readonly createDocument: (input: CreateKnowledgeDocumentInput) => Effect.Effect<KnowledgeDocument, KnowledgeStoreError>;
+  readonly updateDocument: (input: UpdateKnowledgeDocumentInput) => Effect.Effect<KnowledgeDocument, KnowledgeStoreError>;
+  readonly getDocument: (input: GetKnowledgeDocumentInput) => Effect.Effect<KnowledgeDocument, KnowledgeStoreError>;
+  readonly getDocumentBySlug: (input: GetKnowledgeDocumentBySlugInput) => Effect.Effect<KnowledgeDocument, KnowledgeStoreError>;
+  readonly listDocuments: (input: ListKnowledgeDocumentsInput) => Effect.Effect<ListKnowledgeDocumentsResult, KnowledgeStoreError>;
   readonly listPinned: (input: ListPinnedKnowledgeInput) => Effect.Effect<ListPinnedKnowledgeResult, KnowledgeStoreError>;
-  readonly deleteRecord: (input: GetKnowledgeRecordInput) => Effect.Effect<void, KnowledgeStoreError>;
-  readonly listArtifacts: (input: GetKnowledgeRecordInput) => Effect.Effect<ReadonlyArray<KnowledgeArtifact>, KnowledgeStoreError>;
-  readonly listProvenance: (input: GetKnowledgeRecordInput) => Effect.Effect<ReadonlyArray<KnowledgeProvenance>, KnowledgeStoreError>;
-  readonly listLinks: (input: GetKnowledgeRecordInput) => Effect.Effect<ReadonlyArray<KnowledgeLink>, KnowledgeStoreError>;
+  readonly deleteDocument: (input: GetKnowledgeDocumentInput) => Effect.Effect<void, KnowledgeStoreError>;
+  readonly listFiles: (input: GetKnowledgeDocumentInput) => Effect.Effect<ReadonlyArray<KnowledgeFile>, KnowledgeStoreError>;
 };
 declare const KnowledgeStore_base: Context.ServiceClass<KnowledgeStore, "@yolk-sdk/knowledge/KnowledgeStore", KnowledgeStoreApi>;
-declare class KnowledgeStore extends KnowledgeStore_base {}
-//#endregion
-export { GetKnowledgeRecordInput, KnowledgeStore, KnowledgeStoreApi, ListKnowledgeRecordsInput, ListKnowledgeRecordsResult, ListPinnedKnowledgeInput, ListPinnedKnowledgeResult };
+export declare class KnowledgeStore extends KnowledgeStore_base {}
+export type UpsertIndexedKnowledgeDocumentInput = {
+  readonly document: IndexedKnowledgeDocument;
+};
+export type ReplaceKnowledgeDocumentChunksInput = {
+  readonly scopeId: KnowledgeScopeId;
+  readonly documentId: KnowledgeDocumentId;
+  readonly chunks: ReadonlyArray<{
+    readonly chunk: KnowledgeChunk;
+    readonly embedding: KnowledgeEmbedding;
+  }>;
+};
+export type MarkKnowledgeDocumentReadyInput = {
+  readonly scopeId: KnowledgeScopeId;
+  readonly documentId: KnowledgeDocumentId;
+  readonly title?: string;
+  readonly summary?: string;
+  readonly contentHash?: string;
+  readonly tokenCount: number;
+  readonly chunkCount: number;
+};
+export type MarkKnowledgeDocumentErrorInput = {
+  readonly scopeId: KnowledgeScopeId;
+  readonly documentId: KnowledgeDocumentId;
+  readonly message: string;
+};
+export type KnowledgeChunkSearchInput = {
+  readonly scope: KnowledgeSearchScope;
+  readonly embedding: KnowledgeEmbedding;
+  readonly limit: number;
+  readonly minScore?: number;
+};
+export type KnowledgeChunkTextSearchInput = {
+  readonly scope: KnowledgeSearchScope;
+  readonly query: string;
+  readonly limit: number;
+};
+export type KnowledgeChunkSearchResult = {
+  readonly chunk: KnowledgeChunk;
+  readonly score: number;
+  readonly document: IndexedKnowledgeDocument;
+};
+export type KnowledgeSearchContextChunksInput = {
+  readonly scopeId: KnowledgeScopeId;
+  readonly documentId: KnowledgeDocumentId;
+  readonly position: number;
+  readonly contextChunks: number;
+};
+export type SearchIndexStoreApi = {
+  readonly upsertDocument: (input: UpsertIndexedKnowledgeDocumentInput) => Effect.Effect<IndexedKnowledgeDocument, SearchIndexStoreError>;
+  readonly markDocumentProcessing: (input: {
+    readonly scopeId: KnowledgeScopeId;
+    readonly documentId: KnowledgeDocumentId;
+  }) => Effect.Effect<IndexedKnowledgeDocument, SearchIndexStoreError>;
+  readonly replaceDocumentChunks: (input: ReplaceKnowledgeDocumentChunksInput) => Effect.Effect<void, SearchIndexStoreError>;
+  readonly markDocumentReady: (input: MarkKnowledgeDocumentReadyInput) => Effect.Effect<IndexedKnowledgeDocument, SearchIndexStoreError>;
+  readonly markDocumentError: (input: MarkKnowledgeDocumentErrorInput) => Effect.Effect<void, SearchIndexStoreError>;
+  readonly deleteDocument: (input: {
+    readonly scopeId: KnowledgeScopeId;
+    readonly documentId: KnowledgeDocumentId;
+  }) => Effect.Effect<void, SearchIndexStoreError>;
+  readonly searchChunks: (input: KnowledgeChunkSearchInput) => Effect.Effect<ReadonlyArray<KnowledgeChunkSearchResult>, SearchIndexStoreError>;
+  readonly searchChunksByText: (input: KnowledgeChunkTextSearchInput) => Effect.Effect<ReadonlyArray<KnowledgeChunkSearchResult>, SearchIndexStoreError>;
+  readonly getContextChunks: (input: KnowledgeSearchContextChunksInput) => Effect.Effect<ReadonlyArray<KnowledgeChunk>, SearchIndexStoreError>;
+};
+declare const SearchIndexStore_base: Context.ServiceClass<SearchIndexStore, "@yolk-sdk/knowledge/SearchIndexStore", SearchIndexStoreApi>;
+export declare class SearchIndexStore extends SearchIndexStore_base {}
+export {};
 //# sourceMappingURL=store.d.mts.map

package/dist/store.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.mts","names":[],"sources":["../src/store.ts"],"mappings":";;;;;;;;;KAcY,uBAAA;EAAA,SACD,KAAA,EAAO,cAAc;EAAA,SACrB,EAAA;AAAA;AAAA,KAGC,yBAAA;EAAA,SACD,KAAA,EAAO,cAAc;EAAA,SACrB,KAAA;AAAA;AAAA,KAGC,0BAAA;EAAA,SACD,OAAA,EAAS,aAAa,CAAC,eAAA;AAAA;AAAA,KAGtB,wBAAA;EAAA,SACD,KAAA,EAAO,cAAc;EAAA,SACrB,KAAA;AAAA;AAAA,KAGC,yBAAA;EAAA,SACD,OAAA,EAAS,aAAA,CAAc,eAAA;EAAA,SACvB,eAAA,EAAiB,aAAA,CAAc,uBAAA;AAAA;AAAA,KAG9B,iBAAA;EAAA,SACD,YAAA,GAAe,KAAA,EAAO,0BAAA,KAA+B,MAAA,CAAO,MAAA,CAAO,eAAA,EAAiB,mBAAA;EAAA,SACpF,YAAA,GAAe,KAAA,EAAO,0BAAA,KAA+B,MAAA,CAAO,MAAA,CAAO,eAAA,EAAiB,mBAAA;EAAA,SACpF,SAAA,GAAY,KAAA,EAAO,uBAAA,KAA4B,MAAA,CAAO,MAAA,CAAO,eAAA,EAAiB,mBAAA;EAAA,SAC9E,WAAA,GAAc,KAAA,EAAO,yBAAA,KAA8B,MAAA,CAAO,MAAA,CAAO,0BAAA,EAA4B,mBAAA;EAAA,SAC7F,UAAA,GAAa,KAAA,EAAO,wBAAA,KAA6B,MAAA,CAAO,MAAA,CAAO,yBAAA,EAA2B,mBAAA;EAAA,SAC1F,YAAA,GAAe,KAAA,EAAO,uBAAA,KAA4B,MAAA,CAAO,MAAA,OAAa,mBAAA;EAAA,SACtE,aAAA,GAAgB,KAAA,EAAO,uBAAA,KAA4B,MAAA,CAAO,MAAA,CAAO,aAAA,CAAc,iBAAA,GAAoB,mBAAA;EAAA,SACnG,cAAA,GAAiB,KAAA,EAAO,uBAAA,KAA4B,MAAA,CAAO,MAAA,CAAO,aAAA,CAAc,mBAAA,GAAsB,mBAAA;EAAA,SACtG,SAAA,GAAY,KAAA,EAAO,uBAAA,KAA4B,MAAA,CAAO,MAAA,CAAO,aAAA,CAAc,aAAA,GAAgB,mBAAA;AAAA;AAAA,cACrG,mBAAA;cAEY,cAAA,SAAuB,mBAEnC"}
+{"version":3,"file":"store.d.mts","names":[],"sources":["../src/store.ts"],"mappings":";;;;YAiBY;WACD,OAAO;WACP,IAAI;;YAGH;WACD,OAAO;WACP;;YAGC;WACD,OAAO;WACP;WACA,eAAe;;YAGd;WACD,WAAW,cAAc;;YAGxB;WACD,OAAO;WACP;;YAGC;WACD,WAAW,cAAc;;YAGxB;WACD,iBACP,OAAO,iCACJ,OAAO,OAAO,mBAAmB;WAC7B,iBACP,OAAO,iCACJ,OAAO,OAAO,mBAAmB;WAC7B,cACP,OAAO,8BACJ,OAAO,OAAO,mBAAmB;WAC7B,oBACP,OAAO,oCACJ,OAAO,OAAO,mBAAmB;WAC7B,gBACP,OAAO,gCACJ,OAAO,OAAO,8BAA8B;WACxC,aACP,OAAO,6BACJ,OAAO,OAAO,2BAA2B;WACrC,iBACP,OAAO,8BACJ,OAAO,aAAa;WAChB,YACP,OAAO,8BACJ,OAAO,OAAO,cAAc,gBAAgB;;;qBAGtC,uBAAuB;YAIxB;WACD,UAAU;;YAGT;WACD,SAAS;WACT,YAAY;WACZ,QAAQ;aACN,OAAO;aACP,WAAW;;;YAIZ;WACD,SAAS;WACT,YAAY;WACZ;WACA;WACA;WACA;WACA;;YAGC;WACD,SAAS;WACT,YAAY;WACZ;;YAGC;WACD,OAAO;WACP,WAAW;WACX;WACA;;YAGC;WACD,OAAO;WACP;WACA;;YAGC;WACD,OAAO;WACP;WACA,UAAU;;YAGT;WACD,SAAS;WACT,YAAY;WACZ;WACA;;YAGC;WACD,iBACP,OAAO,wCACJ,OAAO,OAAO,0BAA0B;WACpC,yBAAyB;aACvB,SAAS;aACT,YAAY;QACjB,OAAO,OAAO,0BAA0B;WACrC,wBACP,OAAO,wCACJ,OAAO,aAAa;WAChB,oBACP,OAAO,oCACJ,OAAO,OAAO,0BAA0B;WACpC,oBACP,OAAO,oCACJ,OAAO,aAAa;WAChB,iBAAiB;aACf,SAAS;aACT,YAAY;QACjB,OAAO,aAAa;WACjB,eACP,OAAO,8BACJ,OAAO,OAAO,cAAc,6BAA6B;WACrD,qBACP,OAAO,kCACJ,OAAO,OAAO,cAAc,6BAA6B;WACrD,mBACP,OAAO,sCACJ,OAAO,OAAO,cAAc,iBAAiB;;;qBAGvC,yBAAyB"}

package/dist/store.mjs

@@ -1,7 +1,7 @@
 import { Context } from "effect";
-//#region src/store.ts
+// src/store.ts
 var KnowledgeStore = class extends Context.Service()("@yolk-sdk/knowledge/KnowledgeStore") {};
-//#endregion
-export { KnowledgeStore };
+var SearchIndexStore = class extends Context.Service()("@yolk-sdk/knowledge/SearchIndexStore") {};
+export { KnowledgeStore, SearchIndexStore };
 
 //# sourceMappingURL=store.mjs.map

package/dist/store.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"store.mjs","names":[],"sources":["../src/store.ts"],"sourcesContent":["import { Context } from 'effect'\nimport type { Effect } from 'effect'\nimport type { KnowledgeArtifact } from './artifacts.ts'\nimport type { KnowledgeStoreError } from './errors.ts'\nimport type { KnowledgeLink } from './links.ts'\nimport type {\n  CreateKnowledgeRecordInput,\n  KnowledgeRecord,\n  KnowledgeScope,\n  UpdateKnowledgeRecordInput\n} from './records.ts'\nimport type { KnowledgeProvenance } from './provenance.ts'\nimport type { KnowledgeRepresentation } from './representations.ts'\n\nexport type GetKnowledgeRecordInput = {\n  readonly scope: KnowledgeScope\n  readonly id: string\n}\n\nexport type ListKnowledgeRecordsInput = {\n  readonly scope: KnowledgeScope\n  readonly limit: number\n}\n\nexport type ListKnowledgeRecordsResult = {\n  readonly records: ReadonlyArray<KnowledgeRecord>\n}\n\nexport type ListPinnedKnowledgeInput = {\n  readonly scope: KnowledgeScope\n  readonly limit: number\n}\n\nexport type ListPinnedKnowledgeResult = {\n  readonly records: ReadonlyArray<KnowledgeRecord>\n  readonly representations: ReadonlyArray<KnowledgeRepresentation>\n}\n\nexport type KnowledgeStoreApi = {\n  readonly createRecord: (input: CreateKnowledgeRecordInput) => Effect.Effect<KnowledgeRecord, KnowledgeStoreError>\n  readonly updateRecord: (input: UpdateKnowledgeRecordInput) => Effect.Effect<KnowledgeRecord, KnowledgeStoreError>\n  readonly getRecord: (input: GetKnowledgeRecordInput) => Effect.Effect<KnowledgeRecord, KnowledgeStoreError>\n  readonly listRecords: (input: ListKnowledgeRecordsInput) => Effect.Effect<ListKnowledgeRecordsResult, KnowledgeStoreError>\n  readonly listPinned: (input: ListPinnedKnowledgeInput) => Effect.Effect<ListPinnedKnowledgeResult, KnowledgeStoreError>\n  readonly deleteRecord: (input: GetKnowledgeRecordInput) => Effect.Effect<void, KnowledgeStoreError>\n  readonly listArtifacts: (input: GetKnowledgeRecordInput) => Effect.Effect<ReadonlyArray<KnowledgeArtifact>, KnowledgeStoreError>\n  readonly listProvenance: (input: GetKnowledgeRecordInput) => Effect.Effect<ReadonlyArray<KnowledgeProvenance>, KnowledgeStoreError>\n  readonly listLinks: (input: GetKnowledgeRecordInput) => Effect.Effect<ReadonlyArray<KnowledgeLink>, KnowledgeStoreError>\n}\n\nexport class KnowledgeStore extends Context.Service<KnowledgeStore, KnowledgeStoreApi>()(\n  '@yolk-sdk/knowledge/KnowledgeStore'\n) {}\n"],"mappings":";;AAkDA,IAAa,iBAAb,cAAoC,QAAQ,QAA2C,EACrF,oCACF,EAAE,CAAC"}
+{"version":3,"file":"store.mjs","names":[],"sources":["../src/store.ts"],"sourcesContent":["import { Context } from 'effect'\nimport type { Effect } from 'effect'\nimport type {\n  CreateKnowledgeDocumentInput,\n  IndexedKnowledgeDocument,\n  KnowledgeChunk,\n  KnowledgeDocument,\n  KnowledgeDocumentId,\n  KnowledgeFile,\n  KnowledgeScope,\n  KnowledgeScopeId,\n  KnowledgeSearchScope,\n  UpdateKnowledgeDocumentInput\n} from './documents.ts'\nimport type { KnowledgeEmbedding } from './embeddings.ts'\nimport type { KnowledgeStoreError, SearchIndexStoreError } from './errors.ts'\n\nexport type GetKnowledgeDocumentInput = {\n  readonly scope: KnowledgeScope\n  readonly id: KnowledgeDocumentId\n}\n\nexport type GetKnowledgeDocumentBySlugInput = {\n  readonly scope: KnowledgeScope\n  readonly slug: string\n}\n\nexport type ListKnowledgeDocumentsInput = {\n  readonly scope: KnowledgeScope\n  readonly limit: number\n  readonly availability?: KnowledgeDocument['availability']\n}\n\nexport type ListKnowledgeDocumentsResult = {\n  readonly documents: ReadonlyArray<KnowledgeDocument>\n}\n\nexport type ListPinnedKnowledgeInput = {\n  readonly scope: KnowledgeScope\n  readonly limit: number\n}\n\nexport type ListPinnedKnowledgeResult = {\n  readonly documents: ReadonlyArray<KnowledgeDocument>\n}\n\nexport type KnowledgeStoreApi = {\n  readonly createDocument: (\n    input: CreateKnowledgeDocumentInput\n  ) => Effect.Effect<KnowledgeDocument, KnowledgeStoreError>\n  readonly updateDocument: (\n    input: UpdateKnowledgeDocumentInput\n  ) => Effect.Effect<KnowledgeDocument, KnowledgeStoreError>\n  readonly getDocument: (\n    input: GetKnowledgeDocumentInput\n  ) => Effect.Effect<KnowledgeDocument, KnowledgeStoreError>\n  readonly getDocumentBySlug: (\n    input: GetKnowledgeDocumentBySlugInput\n  ) => Effect.Effect<KnowledgeDocument, KnowledgeStoreError>\n  readonly listDocuments: (\n    input: ListKnowledgeDocumentsInput\n  ) => Effect.Effect<ListKnowledgeDocumentsResult, KnowledgeStoreError>\n  readonly listPinned: (\n    input: ListPinnedKnowledgeInput\n  ) => Effect.Effect<ListPinnedKnowledgeResult, KnowledgeStoreError>\n  readonly deleteDocument: (\n    input: GetKnowledgeDocumentInput\n  ) => Effect.Effect<void, KnowledgeStoreError>\n  readonly listFiles: (\n    input: GetKnowledgeDocumentInput\n  ) => Effect.Effect<ReadonlyArray<KnowledgeFile>, KnowledgeStoreError>\n}\n\nexport class KnowledgeStore extends Context.Service<KnowledgeStore, KnowledgeStoreApi>()(\n  '@yolk-sdk/knowledge/KnowledgeStore'\n) {}\n\nexport type UpsertIndexedKnowledgeDocumentInput = {\n  readonly document: IndexedKnowledgeDocument\n}\n\nexport type ReplaceKnowledgeDocumentChunksInput = {\n  readonly scopeId: KnowledgeScopeId\n  readonly documentId: KnowledgeDocumentId\n  readonly chunks: ReadonlyArray<{\n    readonly chunk: KnowledgeChunk\n    readonly embedding: KnowledgeEmbedding\n  }>\n}\n\nexport type MarkKnowledgeDocumentReadyInput = {\n  readonly scopeId: KnowledgeScopeId\n  readonly documentId: KnowledgeDocumentId\n  readonly title?: string\n  readonly summary?: string\n  readonly contentHash?: string\n  readonly tokenCount: number\n  readonly chunkCount: number\n}\n\nexport type MarkKnowledgeDocumentErrorInput = {\n  readonly scopeId: KnowledgeScopeId\n  readonly documentId: KnowledgeDocumentId\n  readonly message: string\n}\n\nexport type KnowledgeChunkSearchInput = {\n  readonly scope: KnowledgeSearchScope\n  readonly embedding: KnowledgeEmbedding\n  readonly limit: number\n  readonly minScore?: number\n}\n\nexport type KnowledgeChunkTextSearchInput = {\n  readonly scope: KnowledgeSearchScope\n  readonly query: string\n  readonly limit: number\n}\n\nexport type KnowledgeChunkSearchResult = {\n  readonly chunk: KnowledgeChunk\n  readonly score: number\n  readonly document: IndexedKnowledgeDocument\n}\n\nexport type KnowledgeSearchContextChunksInput = {\n  readonly scopeId: KnowledgeScopeId\n  readonly documentId: KnowledgeDocumentId\n  readonly position: number\n  readonly contextChunks: number\n}\n\nexport type SearchIndexStoreApi = {\n  readonly upsertDocument: (\n    input: UpsertIndexedKnowledgeDocumentInput\n  ) => Effect.Effect<IndexedKnowledgeDocument, SearchIndexStoreError>\n  readonly markDocumentProcessing: (input: {\n    readonly scopeId: KnowledgeScopeId\n    readonly documentId: KnowledgeDocumentId\n  }) => Effect.Effect<IndexedKnowledgeDocument, SearchIndexStoreError>\n  readonly replaceDocumentChunks: (\n    input: ReplaceKnowledgeDocumentChunksInput\n  ) => Effect.Effect<void, SearchIndexStoreError>\n  readonly markDocumentReady: (\n    input: MarkKnowledgeDocumentReadyInput\n  ) => Effect.Effect<IndexedKnowledgeDocument, SearchIndexStoreError>\n  readonly markDocumentError: (\n    input: MarkKnowledgeDocumentErrorInput\n  ) => Effect.Effect<void, SearchIndexStoreError>\n  readonly deleteDocument: (input: {\n    readonly scopeId: KnowledgeScopeId\n    readonly documentId: KnowledgeDocumentId\n  }) => Effect.Effect<void, SearchIndexStoreError>\n  readonly searchChunks: (\n    input: KnowledgeChunkSearchInput\n  ) => Effect.Effect<ReadonlyArray<KnowledgeChunkSearchResult>, SearchIndexStoreError>\n  readonly searchChunksByText: (\n    input: KnowledgeChunkTextSearchInput\n  ) => Effect.Effect<ReadonlyArray<KnowledgeChunkSearchResult>, SearchIndexStoreError>\n  readonly getContextChunks: (\n    input: KnowledgeSearchContextChunksInput\n  ) => Effect.Effect<ReadonlyArray<KnowledgeChunk>, SearchIndexStoreError>\n}\n\nexport class SearchIndexStore extends Context.Service<SearchIndexStore, SearchIndexStoreApi>()(\n  '@yolk-sdk/knowledge/SearchIndexStore'\n) {}\n"],"mappings":";;AAyEA,IAAa,iBAAb,cAAoC,QAAQ,QAA2C,CAAC,CACtF,oCACF,CAAC,CAAC,CAAC;AAyFH,IAAa,mBAAb,cAAsC,QAAQ,QAA+C,CAAC,CAC5F,sCACF,CAAC,CAAC,CAAC"}

package/dist/summarization.d.mts

@@ -1,23 +1,20 @@
 import { KnowledgeMetadata } from "./documents.mjs";
 import { KnowledgeSummarizationError } from "./errors.mjs";
 import { Context, Effect, Layer } from "effect";
-
-//#region src/summarization.d.ts
-type KnowledgeDocumentSummary = {
+export type KnowledgeDocumentSummary = {
   readonly title?: string;
   readonly summary?: string;
 };
-type SummarizeKnowledgeDocumentInput = {
+export type SummarizeKnowledgeDocumentInput = {
   readonly content: string;
   readonly sourceTitle?: string;
   readonly metadata?: KnowledgeMetadata;
 };
-type KnowledgeSummarizerApi = {
+export type KnowledgeSummarizerApi = {
   readonly summarize: (input: SummarizeKnowledgeDocumentInput) => Effect.Effect<KnowledgeDocumentSummary, KnowledgeSummarizationError>;
 };
 declare const KnowledgeSummarizer_base: Context.ServiceClass<KnowledgeSummarizer, "@yolk-sdk/knowledge/KnowledgeSummarizer", KnowledgeSummarizerApi>;
-declare class KnowledgeSummarizer extends KnowledgeSummarizer_base {}
-declare const NoopKnowledgeSummarizerLive: Layer.Layer<KnowledgeSummarizer, never, never>;
-//#endregion
-export { KnowledgeDocumentSummary, KnowledgeSummarizer, KnowledgeSummarizerApi, NoopKnowledgeSummarizerLive, SummarizeKnowledgeDocumentInput };
+export declare class KnowledgeSummarizer extends KnowledgeSummarizer_base {}
+export declare const NoopKnowledgeSummarizerLive: Layer.Layer<KnowledgeSummarizer, never, never>;
+export {};
 //# sourceMappingURL=summarization.d.mts.map

package/dist/summarization.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"summarization.d.mts","names":[],"sources":["../src/summarization.ts"],"mappings":";;;;;KAIY,wBAAA;EAAA,SACD,KAAA;EAAA,SACA,OAAO;AAAA;AAAA,KAGN,+BAAA;EAAA,SACD,OAAA;EAAA,SACA,WAAA;EAAA,SACA,QAAA,GAAW,iBAAiB;AAAA;AAAA,KAG3B,sBAAA;EAAA,SACD,SAAA,GACP,KAAA,EAAO,+BAAA,KACJ,MAAA,CAAO,MAAA,CAAO,wBAAA,EAA0B,2BAAA;AAAA;AAAA,cAC9C,wBAAA;cAEY,mBAAA,SAA4B,wBAExC;AAAA,cAEY,2BAAA,EAA2B,KAAA,CAAA,KAAA,CAAA,mBAAA"}
+{"version":3,"file":"summarization.d.mts","names":[],"sources":["../src/summarization.ts"],"mappings":";;;YAIY;WACD;WACA;;YAGC;WACD;WACA;WACA,WAAW;;YAGV;WACD,YACP,OAAO,oCACJ,OAAO,OAAO,0BAA0B;;;qBAGlC,4BAA4B;qBAK5B,6BAA2B,MAAA,MAAA"}

package/dist/summarization.mjs

@@ -1,8 +1,7 @@
 import { Context, Effect, Layer } from "effect";
-//#region src/summarization.ts
+// src/summarization.ts
 var KnowledgeSummarizer = class extends Context.Service()("@yolk-sdk/knowledge/KnowledgeSummarizer") {};
 const NoopKnowledgeSummarizerLive = Layer.succeed(KnowledgeSummarizer, { summarize: (input) => Effect.succeed({ title: input.sourceTitle }) });
-//#endregion
 export { KnowledgeSummarizer, NoopKnowledgeSummarizerLive };
 
 //# sourceMappingURL=summarization.mjs.map

package/dist/summarization.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"summarization.mjs","names":[],"sources":["../src/summarization.ts"],"sourcesContent":["import { Context, Effect, Layer } from 'effect'\nimport type { KnowledgeMetadata } from './documents.ts'\nimport type { KnowledgeSummarizationError } from './errors.ts'\n\nexport type KnowledgeDocumentSummary = {\n  readonly title?: string\n  readonly summary?: string\n}\n\nexport type SummarizeKnowledgeDocumentInput = {\n  readonly content: string\n  readonly sourceTitle?: string\n  readonly metadata?: KnowledgeMetadata\n}\n\nexport type KnowledgeSummarizerApi = {\n  readonly summarize: (\n    input: SummarizeKnowledgeDocumentInput\n  ) => Effect.Effect<KnowledgeDocumentSummary, KnowledgeSummarizationError>\n}\n\nexport class KnowledgeSummarizer extends Context.Service<KnowledgeSummarizer, KnowledgeSummarizerApi>()(\n  '@yolk-sdk/knowledge/KnowledgeSummarizer'\n) {}\n\nexport const NoopKnowledgeSummarizerLive = Layer.succeed(KnowledgeSummarizer, {\n  summarize: input => Effect.succeed({ title: input.sourceTitle })\n})\n"],"mappings":";;AAqBA,IAAa,sBAAb,cAAyC,QAAQ,QAAqD,EACpG,yCACF,EAAE,CAAC;AAEH,MAAa,8BAA8B,MAAM,QAAQ,qBAAqB,EAC5E,YAAW,UAAS,OAAO,QAAQ,EAAE,OAAO,MAAM,YAAY,CAAC,EACjE,CAAC"}
+{"version":3,"file":"summarization.mjs","names":[],"sources":["../src/summarization.ts"],"sourcesContent":["import { Context, Effect, Layer } from 'effect'\nimport type { KnowledgeMetadata } from './documents.ts'\nimport type { KnowledgeSummarizationError } from './errors.ts'\n\nexport type KnowledgeDocumentSummary = {\n  readonly title?: string\n  readonly summary?: string\n}\n\nexport type SummarizeKnowledgeDocumentInput = {\n  readonly content: string\n  readonly sourceTitle?: string\n  readonly metadata?: KnowledgeMetadata\n}\n\nexport type KnowledgeSummarizerApi = {\n  readonly summarize: (\n    input: SummarizeKnowledgeDocumentInput\n  ) => Effect.Effect<KnowledgeDocumentSummary, KnowledgeSummarizationError>\n}\n\nexport class KnowledgeSummarizer extends Context.Service<\n  KnowledgeSummarizer,\n  KnowledgeSummarizerApi\n>()('@yolk-sdk/knowledge/KnowledgeSummarizer') {}\n\nexport const NoopKnowledgeSummarizerLive = Layer.succeed(KnowledgeSummarizer, {\n  summarize: input => Effect.succeed({ title: input.sourceTitle })\n})\n"],"mappings":";;AAqBA,IAAa,sBAAb,cAAyC,QAAQ,QAG/C,CAAC,CAAC,yCAAyC,CAAC,CAAC,CAAC;AAEhD,MAAa,8BAA8B,MAAM,QAAQ,qBAAqB,EAC5E,YAAW,UAAS,OAAO,QAAQ,EAAE,OAAO,MAAM,YAAY,CAAC,EACjE,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yolk-sdk/knowledge",
-  "version": "0.1.0-canary.13",
-  "description": "Domain-free knowledge record, artifact, search, provenance, and context contracts for Yolk agents.",
+  "version": "0.1.0-canary.130",
+  "description": "Domain-free knowledge document/source/file/context, ingestion, hybrid search, and lookup/manage tool helpers for agents.",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,
@@ -18,7 +18,7 @@
     "knowledge",
     "agents",
     "context",
-    "provenance",
+    "search",
     "effect"
   ],
   "engines": {
@@ -36,11 +36,6 @@
       "import": "./dist/agent.mjs",
       "default": "./dist/agent.mjs"
     },
-    "./artifacts": {
-      "types": "./dist/artifacts.d.mts",
-      "import": "./dist/artifacts.mjs",
-      "default": "./dist/artifacts.mjs"
-    },
     "./context": {
       "types": "./dist/context.d.mts",
       "import": "./dist/context.mjs",
@@ -66,6 +61,11 @@
       "import": "./dist/extraction.mjs",
       "default": "./dist/extraction.mjs"
     },
+    "./files": {
+      "types": "./dist/files.d.mts",
+      "import": "./dist/files.mjs",
+      "default": "./dist/files.mjs"
+    },
     "./ingestion": {
       "types": "./dist/ingestion.d.mts",
       "import": "./dist/ingestion.mjs",
@@ -76,31 +76,6 @@
       "import": "./dist/documents.mjs",
       "default": "./dist/documents.mjs"
     },
-    "./search-store": {
-      "types": "./dist/search-store.d.mts",
-      "import": "./dist/search-store.mjs",
-      "default": "./dist/search-store.mjs"
-    },
-    "./links": {
-      "types": "./dist/links.d.mts",
-      "import": "./dist/links.mjs",
-      "default": "./dist/links.mjs"
-    },
-    "./records": {
-      "types": "./dist/records.d.mts",
-      "import": "./dist/records.mjs",
-      "default": "./dist/records.mjs"
-    },
-    "./provenance": {
-      "types": "./dist/provenance.d.mts",
-      "import": "./dist/provenance.mjs",
-      "default": "./dist/provenance.mjs"
-    },
-    "./representations": {
-      "types": "./dist/representations.d.mts",
-      "import": "./dist/representations.mjs",
-      "default": "./dist/representations.mjs"
-    },
     "./search": {
       "types": "./dist/search.d.mts",
       "import": "./dist/search.mjs",
@@ -115,11 +90,6 @@
       "types": "./dist/summarization.d.mts",
       "import": "./dist/summarization.mjs",
       "default": "./dist/summarization.mjs"
-    },
-    "./vector-store": {
-      "types": "./dist/vector-store.d.mts",
-      "import": "./dist/vector-store.mjs",
-      "default": "./dist/vector-store.mjs"
     }
   },
   "files": [
@@ -134,13 +104,13 @@
     "provenance": true
   },
   "dependencies": {
-    "effect": "4.0.0-beta.65",
+    "effect": "4.1.2",
     "gpt-tokenizer": "^3.4.0",
-    "@yolk-sdk/agent": "^0.1.0-canary.13"
+    "@yolk-sdk/agent": "^0.1.0-canary.130"
   },
   "scripts": {
     "build": "tsdown",
-    "check": "tsc -p tsconfig.json --noEmit",
+    "check": "effect-tsgo tsrs -p tsconfig.json --noEmit",
     "test": "vitest run --passWithNoTests",
     "test:run": "vitest run --passWithNoTests"
   }