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

package/src/search.ts

@@ -1,8 +1,8 @@
-import { Effect } from 'effect'
-import type { KnowledgeChunk, KnowledgeDocument, KnowledgeSearchScope } from './documents.ts'
+import { Effect, Match } from 'effect'
+import type { IndexedKnowledgeDocument, KnowledgeChunk, KnowledgeSearchScope } from './documents.ts'
 import { KnowledgeEmbedder } from './embeddings.ts'
 import { KnowledgeSearchError } from './errors.ts'
-import { SearchIndexStore } from './search-store.ts'
+import { SearchIndexStore } from './store.ts'
 
 export type KnowledgeSearchInput = {
   readonly scope: KnowledgeSearchScope
@@ -26,7 +26,7 @@ export type KnowledgeSearchScores = {
 export type KnowledgeSearchResult = {
   readonly chunk: KnowledgeChunk
   readonly score: number
-  readonly document: KnowledgeDocument
+  readonly document: IndexedKnowledgeDocument
   readonly context?: ReadonlyArray<KnowledgeChunk>
   readonly scores?: KnowledgeSearchScores
 }
@@ -46,21 +46,22 @@ export type KnowledgeSearcher = {
 const packedResultText = (result: KnowledgeSearchResult) =>
   result.context?.map(chunk => chunk.content).join('\n\n') ?? result.chunk.content
 
-export const packKnowledgeSearchContext = (query: string, results: ReadonlyArray<KnowledgeSearchResult>): KnowledgeSearchContext =>
-  ({
-    query,
-    results,
-    text: results.map(packedResultText).join('\n\n')
-  })
-
-const scopeIds = (scope: KnowledgeSearchScope): ReadonlyArray<string> => {
-  switch (scope._tag) {
-    case 'KnowledgeCollection':
-      return [scope.id]
-    case 'KnowledgeCollections':
-      return scope.ids
-  }
-}
+export const packKnowledgeSearchContext = (
+  query: string,
+  results: ReadonlyArray<KnowledgeSearchResult>
+): KnowledgeSearchContext => ({
+  query,
+  results,
+  text: results.map(packedResultText).join('\n\n')
+})
+
+const scopeIds = (scope: KnowledgeSearchScope): ReadonlyArray<string> =>
+  Match.value(scope).pipe(
+    Match.tagsExhaustive({
+      KnowledgeScope: ({ id }) => [id],
+      KnowledgeScopes: ({ ids }) => ids
+    })
+  )
 
 const defaultHybridCandidateLimit = (limit: number) => Math.max(limit * 5, 40)
 
@@ -73,6 +74,7 @@ export const fuseKnowledgeSearchResults = (input: {
   readonly rankConstant?: number
 }): ReadonlyArray<KnowledgeSearchResult> => {
   const rankConstant = input.rankConstant ?? 60
+
   const fused = new Map<
     string,
     {
@@ -116,36 +118,54 @@ const validateSearchInput = (input: KnowledgeSearchInput) => {
   const limit = input.limit ?? 10
   const contextChunks = input.contextChunks ?? 0
   const mode = input.mode ?? 'hybrid'
-  const vectorLimit = input.vectorLimit ?? (mode === 'hybrid' ? defaultHybridCandidateLimit(limit) : limit)
+
+  const vectorLimit =
+    input.vectorLimit ?? (mode === 'hybrid' ? defaultHybridCandidateLimit(limit) : limit)
+
   const textLimit = input.textLimit ?? defaultHybridCandidateLimit(limit)
 
   if (query.length === 0) {
-    return Effect.fail(new KnowledgeSearchError({ message: 'Search query is empty', stage: 'embed' }))
+    return Effect.fail(
+      new KnowledgeSearchError({ message: 'Search query is empty', stage: 'embed' })
+    )
   }
 
   if (ids.length === 0) {
-    return Effect.fail(new KnowledgeSearchError({ message: 'Search scope is empty', stage: 'store' }))
+    return Effect.fail(
+      new KnowledgeSearchError({ message: 'Search scope is empty', stage: 'store' })
+    )
   }
 
   if (!Number.isInteger(limit) || limit < 1) {
-    return Effect.fail(new KnowledgeSearchError({ message: 'Search limit must be positive', stage: 'store' }))
+    return Effect.fail(
+      new KnowledgeSearchError({ message: 'Search limit must be positive', stage: 'store' })
+    )
   }
 
   if (!Number.isInteger(vectorLimit) || vectorLimit < 1) {
-    return Effect.fail(new KnowledgeSearchError({ message: 'Vector search limit must be positive', stage: 'store' }))
+    return Effect.fail(
+      new KnowledgeSearchError({ message: 'Vector search limit must be positive', stage: 'store' })
+    )
   }
 
   if (!Number.isInteger(textLimit) || textLimit < 1) {
-    return Effect.fail(new KnowledgeSearchError({ message: 'Text search limit must be positive', stage: 'store' }))
+    return Effect.fail(
+      new KnowledgeSearchError({ message: 'Text search limit must be positive', stage: 'store' })
+    )
   }
 
   if (mode !== 'vector' && mode !== 'hybrid') {
-    return Effect.fail(new KnowledgeSearchError({ message: 'Search mode is invalid', stage: 'store' }))
+    return Effect.fail(
+      new KnowledgeSearchError({ message: 'Search mode is invalid', stage: 'store' })
+    )
   }
 
   if (!Number.isInteger(contextChunks) || contextChunks < 0) {
     return Effect.fail(
-      new KnowledgeSearchError({ message: 'Context chunks must be zero or positive', stage: 'store' })
+      new KnowledgeSearchError({
+        message: 'Context chunks must be zero or positive',
+        stage: 'store'
+      })
     )
   }
 
@@ -167,11 +187,13 @@ const searchVectorChunks = (input: {
   Effect.gen(function* () {
     const store = yield* SearchIndexStore
     const embedder = yield* KnowledgeEmbedder
+
     const embedding = yield* embedder
       .embedQuery(input.query)
       .pipe(
         Effect.mapError(
-          error => new KnowledgeSearchError({ message: error.message, stage: 'embed', cause: error })
+          error =>
+            new KnowledgeSearchError({ message: error.message, stage: 'embed', cause: error })
         )
       )
 
@@ -184,7 +206,8 @@ const searchVectorChunks = (input: {
       })
       .pipe(
         Effect.mapError(
-          error => new KnowledgeSearchError({ message: error.message, stage: 'store', cause: error })
+          error =>
+            new KnowledgeSearchError({ message: error.message, stage: 'store', cause: error })
         )
       )
   })
@@ -196,11 +219,13 @@ const searchTextChunks = (input: {
 }) =>
   Effect.gen(function* () {
     const store = yield* SearchIndexStore
+
     return yield* store
       .searchChunksByText({ scope: input.scope, query: input.query, limit: input.limit })
       .pipe(
         Effect.mapError(
-          error => new KnowledgeSearchError({ message: error.message, stage: 'store', cause: error })
+          error =>
+            new KnowledgeSearchError({ message: error.message, stage: 'store', cause: error })
         )
       )
   })
@@ -216,37 +241,39 @@ export const searchKnowledge = (input: KnowledgeSearchInput) =>
       'knowledge_search.scope_count': scopeIds(input.scope).length
     })
     const store = yield* SearchIndexStore
-    const results: ReadonlyArray<KnowledgeSearchResult> = valid.mode === 'vector'
-      ? yield* searchVectorChunks({
-        scope: input.scope,
-        query: valid.query,
-        limit: valid.vectorLimit,
-        minScore: input.minScore
-      })
-      : yield* Effect.gen(function* () {
-        const searches = yield* Effect.all(
-          {
-            vectorResults: searchVectorChunks({
-              scope: input.scope,
-              query: valid.query,
-              limit: valid.vectorLimit,
-              minScore: input.minScore
-            }),
-            textResults: searchTextChunks({
-              scope: input.scope,
-              query: valid.query,
-              limit: valid.textLimit
-            })
-          },
-          { concurrency: 'unbounded' }
-        )
 
-        return fuseKnowledgeSearchResults({
-          vectorResults: searches.vectorResults,
-          textResults: searches.textResults,
-          limit: valid.limit
-        })
-      })
+    const results: ReadonlyArray<KnowledgeSearchResult> =
+      valid.mode === 'vector'
+        ? yield* searchVectorChunks({
+            scope: input.scope,
+            query: valid.query,
+            limit: valid.vectorLimit,
+            minScore: input.minScore
+          })
+        : yield* Effect.gen(function* () {
+            const searches = yield* Effect.all(
+              {
+                vectorResults: searchVectorChunks({
+                  scope: input.scope,
+                  query: valid.query,
+                  limit: valid.vectorLimit,
+                  minScore: input.minScore
+                }),
+                textResults: searchTextChunks({
+                  scope: input.scope,
+                  query: valid.query,
+                  limit: valid.textLimit
+                })
+              },
+              { concurrency: 'unbounded' }
+            )
+
+            return fuseKnowledgeSearchResults({
+              vectorResults: searches.vectorResults,
+              textResults: searches.textResults,
+              limit: valid.limit
+            })
+          })
 
     if (valid.contextChunks === 0) {
       return results
@@ -255,7 +282,7 @@ export const searchKnowledge = (input: KnowledgeSearchInput) =>
     return yield* Effect.forEach(results, result =>
       store
         .getContextChunks({
-          collectionId: result.chunk.collectionId,
+          scopeId: result.chunk.scopeId,
           documentId: result.chunk.documentId,
           position: result.chunk.position,
           contextChunks: valid.contextChunks
@@ -263,7 +290,8 @@ export const searchKnowledge = (input: KnowledgeSearchInput) =>
         .pipe(
           Effect.map(context => ({ ...result, context })),
           Effect.mapError(
-            error => new KnowledgeSearchError({ message: error.message, stage: 'store', cause: error })
+            error =>
+              new KnowledgeSearchError({ message: error.message, stage: 'store', cause: error })
           )
         )
     )

package/src/store.ts

@@ -1,29 +1,38 @@
 import { Context } from 'effect'
 import type { Effect } from 'effect'
-import type { KnowledgeArtifact } from './artifacts.ts'
-import type { KnowledgeStoreError } from './errors.ts'
-import type { KnowledgeLink } from './links.ts'
 import type {
-  CreateKnowledgeRecordInput,
-  KnowledgeRecord,
+  CreateKnowledgeDocumentInput,
+  IndexedKnowledgeDocument,
+  KnowledgeChunk,
+  KnowledgeDocument,
+  KnowledgeDocumentId,
+  KnowledgeFile,
   KnowledgeScope,
-  UpdateKnowledgeRecordInput
-} from './records.ts'
-import type { KnowledgeProvenance } from './provenance.ts'
-import type { KnowledgeRepresentation } from './representations.ts'
+  KnowledgeScopeId,
+  KnowledgeSearchScope,
+  UpdateKnowledgeDocumentInput
+} from './documents.ts'
+import type { KnowledgeEmbedding } from './embeddings.ts'
+import type { KnowledgeStoreError, SearchIndexStoreError } from './errors.ts'
 
-export type GetKnowledgeRecordInput = {
+export type GetKnowledgeDocumentInput = {
   readonly scope: KnowledgeScope
-  readonly id: string
+  readonly id: KnowledgeDocumentId
 }
 
-export type ListKnowledgeRecordsInput = {
+export type GetKnowledgeDocumentBySlugInput = {
+  readonly scope: KnowledgeScope
+  readonly slug: string
+}
+
+export type ListKnowledgeDocumentsInput = {
   readonly scope: KnowledgeScope
   readonly limit: number
+  readonly availability?: KnowledgeDocument['availability']
 }
 
-export type ListKnowledgeRecordsResult = {
-  readonly records: ReadonlyArray<KnowledgeRecord>
+export type ListKnowledgeDocumentsResult = {
+  readonly documents: ReadonlyArray<KnowledgeDocument>
 }
 
 export type ListPinnedKnowledgeInput = {
@@ -32,22 +41,127 @@ export type ListPinnedKnowledgeInput = {
 }
 
 export type ListPinnedKnowledgeResult = {
-  readonly records: ReadonlyArray<KnowledgeRecord>
-  readonly representations: ReadonlyArray<KnowledgeRepresentation>
+  readonly documents: ReadonlyArray<KnowledgeDocument>
 }
 
 export 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>
-  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 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 deleteDocument: (
+    input: GetKnowledgeDocumentInput
+  ) => Effect.Effect<void, KnowledgeStoreError>
+  readonly listFiles: (
+    input: GetKnowledgeDocumentInput
+  ) => Effect.Effect<ReadonlyArray<KnowledgeFile>, KnowledgeStoreError>
 }
 
 export class KnowledgeStore extends Context.Service<KnowledgeStore, KnowledgeStoreApi>()(
   '@yolk-sdk/knowledge/KnowledgeStore'
 ) {}
+
+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>
+}
+
+export class SearchIndexStore extends Context.Service<SearchIndexStore, SearchIndexStoreApi>()(
+  '@yolk-sdk/knowledge/SearchIndexStore'
+) {}

package/src/summarization.ts

@@ -19,9 +19,10 @@ export type KnowledgeSummarizerApi = {
   ) => Effect.Effect<KnowledgeDocumentSummary, KnowledgeSummarizationError>
 }
 
-export class KnowledgeSummarizer extends Context.Service<KnowledgeSummarizer, KnowledgeSummarizerApi>()(
-  '@yolk-sdk/knowledge/KnowledgeSummarizer'
-) {}
+export class KnowledgeSummarizer extends Context.Service<
+  KnowledgeSummarizer,
+  KnowledgeSummarizerApi
+>()('@yolk-sdk/knowledge/KnowledgeSummarizer') {}
 
 export const NoopKnowledgeSummarizerLive = Layer.succeed(KnowledgeSummarizer, {
   summarize: input => Effect.succeed({ title: input.sourceTitle })

package/dist/artifacts.d.mts

@@ -1,37 +0,0 @@
-import { KnowledgeArtifactError } from "./errors.mjs";
-import { Context, Effect } from "effect";
-import * as Schema$1 from "effect/Schema";
-
-//#region src/artifacts.d.ts
-declare const KnowledgeArtifactKindSchema: Schema$1.Literals<readonly ["original", "extracted_text", "thumbnail", "transcript", "caption", "structured"]>;
-type KnowledgeArtifactKind = Schema$1.Schema.Type<typeof KnowledgeArtifactKindSchema>;
-declare const KnowledgeArtifactSchema: Schema$1.Struct<{
-  readonly id: Schema$1.Trimmed;
-  readonly recordId: Schema$1.Trimmed;
-  readonly kind: Schema$1.Literals<readonly ["original", "extracted_text", "thumbnail", "transcript", "caption", "structured"]>;
-  readonly storageKey: Schema$1.Trimmed;
-  readonly mediaType: Schema$1.optional<Schema$1.Trimmed>;
-  readonly byteSize: Schema$1.optional<Schema$1.Int>;
-  readonly checksum: Schema$1.optional<Schema$1.Trimmed>;
-  readonly metadata: Schema$1.optional<Schema$1.$Record<Schema$1.String, Schema$1.Unknown>>;
-  readonly createdAt: Schema$1.DateTimeUtc;
-}>;
-type KnowledgeArtifact = Schema$1.Schema.Type<typeof KnowledgeArtifactSchema>;
-type PutKnowledgeArtifactInput = {
-  readonly storageKey: string;
-  readonly mediaType?: string;
-  readonly bytes: Uint8Array;
-};
-type GetKnowledgeArtifactInput = {
-  readonly storageKey: string;
-};
-type KnowledgeArtifactStoreApi = {
-  readonly putArtifact: (input: PutKnowledgeArtifactInput) => Effect.Effect<void, KnowledgeArtifactError>;
-  readonly getArtifact: (input: GetKnowledgeArtifactInput) => Effect.Effect<Uint8Array, KnowledgeArtifactError>;
-  readonly deleteArtifact: (input: GetKnowledgeArtifactInput) => Effect.Effect<void, KnowledgeArtifactError>;
-};
-declare const KnowledgeArtifactStore_base: Context.ServiceClass<KnowledgeArtifactStore, "@yolk-sdk/knowledge/KnowledgeArtifactStore", KnowledgeArtifactStoreApi>;
-declare class KnowledgeArtifactStore extends KnowledgeArtifactStore_base {}
-//#endregion
-export { GetKnowledgeArtifactInput, KnowledgeArtifact, KnowledgeArtifactKind, KnowledgeArtifactKindSchema, KnowledgeArtifactSchema, KnowledgeArtifactStore, KnowledgeArtifactStoreApi, PutKnowledgeArtifactInput };
-//# sourceMappingURL=artifacts.d.mts.map

package/dist/artifacts.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"artifacts.d.mts","names":[],"sources":["../src/artifacts.ts"],"mappings":";;;;;cAMa,2BAAA,EAA2B,QAAA,CAAA,QAAA;AAAA,KAQ5B,qBAAA,GAAwB,QAAA,CAAO,MAAA,CAAO,IAAI,QAAQ,2BAAA;AAAA,cAEjD,uBAAA,EAAuB,QAAA,CAAA,MAAA;EAAA;;;;;;;;;;KAWxB,iBAAA,GAAoB,QAAA,CAAO,MAAA,CAAO,IAAI,QAAQ,uBAAA;AAAA,KAE9C,yBAAA;EAAA,SACD,UAAA;EAAA,SACA,SAAA;EAAA,SACA,KAAA,EAAO,UAAU;AAAA;AAAA,KAGhB,yBAAA;EAAA,SACD,UAAU;AAAA;AAAA,KAGT,yBAAA;EAAA,SACD,WAAA,GAAc,KAAA,EAAO,yBAAA,KAA8B,MAAA,CAAO,MAAA,OAAa,sBAAA;EAAA,SACvE,WAAA,GAAc,KAAA,EAAO,yBAAA,KAA8B,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,sBAAA;EAAA,SAC7E,cAAA,GAAiB,KAAA,EAAO,yBAAA,KAA8B,MAAA,CAAO,MAAA,OAAa,sBAAA;AAAA;AAAA,cACpF,2BAAA;cAEY,sBAAA,SAA+B,2BAE3C"}

package/dist/artifacts.mjs

@@ -1,28 +0,0 @@
-import { KnowledgeMetadataSchema, NonEmptyTrimmedString, NonNegativeInteger } from "./records.mjs";
-import { Context } from "effect";
-import * as Schema$1 from "effect/Schema";
-//#region src/artifacts.ts
-const KnowledgeArtifactKindSchema = Schema$1.Literals([
-	"original",
-	"extracted_text",
-	"thumbnail",
-	"transcript",
-	"caption",
-	"structured"
-]);
-const KnowledgeArtifactSchema = Schema$1.Struct({
-	id: NonEmptyTrimmedString,
-	recordId: NonEmptyTrimmedString,
-	kind: KnowledgeArtifactKindSchema,
-	storageKey: NonEmptyTrimmedString,
-	mediaType: Schema$1.optional(NonEmptyTrimmedString),
-	byteSize: Schema$1.optional(NonNegativeInteger),
-	checksum: Schema$1.optional(NonEmptyTrimmedString),
-	metadata: Schema$1.optional(KnowledgeMetadataSchema),
-	createdAt: Schema$1.DateTimeUtc
-});
-var KnowledgeArtifactStore = class extends Context.Service()("@yolk-sdk/knowledge/KnowledgeArtifactStore") {};
-//#endregion
-export { KnowledgeArtifactKindSchema, KnowledgeArtifactSchema, KnowledgeArtifactStore };
-
-//# sourceMappingURL=artifacts.mjs.map

package/dist/artifacts.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"artifacts.mjs","names":["Schema"],"sources":["../src/artifacts.ts"],"sourcesContent":["import { Context } from 'effect'\nimport type { Effect } from 'effect'\nimport * as Schema from 'effect/Schema'\nimport type { KnowledgeArtifactError } from './errors.ts'\nimport { KnowledgeMetadataSchema, NonEmptyTrimmedString, NonNegativeInteger } from './records.ts'\n\nexport const KnowledgeArtifactKindSchema = Schema.Literals([\n  'original',\n  'extracted_text',\n  'thumbnail',\n  'transcript',\n  'caption',\n  'structured'\n])\nexport type KnowledgeArtifactKind = Schema.Schema.Type<typeof KnowledgeArtifactKindSchema>\n\nexport const KnowledgeArtifactSchema = Schema.Struct({\n  id: NonEmptyTrimmedString,\n  recordId: NonEmptyTrimmedString,\n  kind: KnowledgeArtifactKindSchema,\n  storageKey: NonEmptyTrimmedString,\n  mediaType: Schema.optional(NonEmptyTrimmedString),\n  byteSize: Schema.optional(NonNegativeInteger),\n  checksum: Schema.optional(NonEmptyTrimmedString),\n  metadata: Schema.optional(KnowledgeMetadataSchema),\n  createdAt: Schema.DateTimeUtc\n})\nexport type KnowledgeArtifact = Schema.Schema.Type<typeof KnowledgeArtifactSchema>\n\nexport type PutKnowledgeArtifactInput = {\n  readonly storageKey: string\n  readonly mediaType?: string\n  readonly bytes: Uint8Array\n}\n\nexport type GetKnowledgeArtifactInput = {\n  readonly storageKey: string\n}\n\nexport type KnowledgeArtifactStoreApi = {\n  readonly putArtifact: (input: PutKnowledgeArtifactInput) => Effect.Effect<void, KnowledgeArtifactError>\n  readonly getArtifact: (input: GetKnowledgeArtifactInput) => Effect.Effect<Uint8Array, KnowledgeArtifactError>\n  readonly deleteArtifact: (input: GetKnowledgeArtifactInput) => Effect.Effect<void, KnowledgeArtifactError>\n}\n\nexport class KnowledgeArtifactStore extends Context.Service<KnowledgeArtifactStore, KnowledgeArtifactStoreApi>()(\n  '@yolk-sdk/knowledge/KnowledgeArtifactStore'\n) {}\n"],"mappings":";;;;AAMA,MAAa,8BAA8BA,SAAO,SAAS;CACzD;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAGD,MAAa,0BAA0BA,SAAO,OAAO;CACnD,IAAI;CACJ,UAAU;CACV,MAAM;CACN,YAAY;CACZ,WAAWA,SAAO,SAAS,qBAAqB;CAChD,UAAUA,SAAO,SAAS,kBAAkB;CAC5C,UAAUA,SAAO,SAAS,qBAAqB;CAC/C,UAAUA,SAAO,SAAS,uBAAuB;CACjD,WAAWA,SAAO;AACpB,CAAC;AAmBD,IAAa,yBAAb,cAA4C,QAAQ,QAA2D,EAC7G,4CACF,EAAE,CAAC"}

package/dist/links.d.mts

@@ -1,17 +0,0 @@
-import * as Schema from "effect/Schema";
-
-//#region src/links.d.ts
-declare const KnowledgeLinkTypeSchema: Schema.Literals<readonly ["cites", "supports", "contradicts", "supersedes", "mentions", "derived_from", "related_to"]>;
-type KnowledgeLinkType = Schema.Schema.Type<typeof KnowledgeLinkTypeSchema>;
-declare const KnowledgeLinkSchema: Schema.Struct<{
-  readonly id: Schema.Trimmed;
-  readonly fromRecordId: Schema.Trimmed;
-  readonly toRecordId: Schema.Trimmed;
-  readonly type: Schema.Literals<readonly ["cites", "supports", "contradicts", "supersedes", "mentions", "derived_from", "related_to"]>;
-  readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
-  readonly createdAt: Schema.DateTimeUtc;
-}>;
-type KnowledgeLink = Schema.Schema.Type<typeof KnowledgeLinkSchema>;
-//#endregion
-export { KnowledgeLink, KnowledgeLinkSchema, KnowledgeLinkType, KnowledgeLinkTypeSchema };
-//# sourceMappingURL=links.d.mts.map

package/dist/links.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"links.d.mts","names":[],"sources":["../src/links.ts"],"mappings":";;;cAGa,uBAAA,EAAuB,MAAA,CAAA,QAAA;AAAA,KASxB,iBAAA,GAAoB,MAAA,CAAO,MAAA,CAAO,IAAI,QAAQ,uBAAA;AAAA,cAE7C,mBAAA,EAAmB,MAAA,CAAA,MAAA;EAAA;;;;;;;KAQpB,aAAA,GAAgB,MAAA,CAAO,MAAA,CAAO,IAAI,QAAQ,mBAAA"}

package/dist/links.mjs

@@ -1,24 +0,0 @@
-import { KnowledgeMetadataSchema, NonEmptyTrimmedString } from "./records.mjs";
-import * as Schema from "effect/Schema";
-//#region src/links.ts
-const KnowledgeLinkTypeSchema = Schema.Literals([
-	"cites",
-	"supports",
-	"contradicts",
-	"supersedes",
-	"mentions",
-	"derived_from",
-	"related_to"
-]);
-const KnowledgeLinkSchema = Schema.Struct({
-	id: NonEmptyTrimmedString,
-	fromRecordId: NonEmptyTrimmedString,
-	toRecordId: NonEmptyTrimmedString,
-	type: KnowledgeLinkTypeSchema,
-	metadata: Schema.optional(KnowledgeMetadataSchema),
-	createdAt: Schema.DateTimeUtc
-});
-//#endregion
-export { KnowledgeLinkSchema, KnowledgeLinkTypeSchema };
-
-//# sourceMappingURL=links.mjs.map

package/dist/links.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"links.mjs","names":[],"sources":["../src/links.ts"],"sourcesContent":["import * as Schema from 'effect/Schema'\nimport { KnowledgeMetadataSchema, NonEmptyTrimmedString } from './records.ts'\n\nexport const KnowledgeLinkTypeSchema = Schema.Literals([\n  'cites',\n  'supports',\n  'contradicts',\n  'supersedes',\n  'mentions',\n  'derived_from',\n  'related_to'\n])\nexport type KnowledgeLinkType = Schema.Schema.Type<typeof KnowledgeLinkTypeSchema>\n\nexport const KnowledgeLinkSchema = Schema.Struct({\n  id: NonEmptyTrimmedString,\n  fromRecordId: NonEmptyTrimmedString,\n  toRecordId: NonEmptyTrimmedString,\n  type: KnowledgeLinkTypeSchema,\n  metadata: Schema.optional(KnowledgeMetadataSchema),\n  createdAt: Schema.DateTimeUtc\n})\nexport type KnowledgeLink = Schema.Schema.Type<typeof KnowledgeLinkSchema>\n"],"mappings":";;;AAGA,MAAa,0BAA0B,OAAO,SAAS;CACrD;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAGD,MAAa,sBAAsB,OAAO,OAAO;CAC/C,IAAI;CACJ,cAAc;CACd,YAAY;CACZ,MAAM;CACN,UAAU,OAAO,SAAS,uBAAuB;CACjD,WAAW,OAAO;AACpB,CAAC"}

package/dist/provenance.d.mts

@@ -1,20 +0,0 @@
-import * as Schema from "effect/Schema";
-
-//#region src/provenance.d.ts
-declare const KnowledgeProvenanceSourceKindSchema: Schema.Literals<readonly ["upload", "user_statement", "url", "generated", "imported", "external_api"]>;
-type KnowledgeProvenanceSourceKind = Schema.Schema.Type<typeof KnowledgeProvenanceSourceKindSchema>;
-declare const KnowledgeProvenanceSchema: Schema.Struct<{
-  readonly id: Schema.Trimmed;
-  readonly recordId: Schema.Trimmed;
-  readonly artifactId: Schema.optional<Schema.Trimmed>;
-  readonly sourceKind: Schema.Literals<readonly ["upload", "user_statement", "url", "generated", "imported", "external_api"]>;
-  readonly sourceLabel: Schema.Trimmed;
-  readonly sourceUrl: Schema.optional<Schema.Trimmed>;
-  readonly observedAt: Schema.optional<Schema.DateTimeUtc>;
-  readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
-  readonly createdAt: Schema.DateTimeUtc;
-}>;
-type KnowledgeProvenance = Schema.Schema.Type<typeof KnowledgeProvenanceSchema>;
-//#endregion
-export { KnowledgeProvenance, KnowledgeProvenanceSchema, KnowledgeProvenanceSourceKind, KnowledgeProvenanceSourceKindSchema };
-//# sourceMappingURL=provenance.d.mts.map

package/dist/provenance.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"provenance.d.mts","names":[],"sources":["../src/provenance.ts"],"mappings":";;;cAGa,mCAAA,EAAmC,MAAA,CAAA,QAAA;AAAA,KAQpC,6BAAA,GAAgC,MAAA,CAAO,MAAA,CAAO,IAAI,QAAQ,mCAAA;AAAA,cAEzD,yBAAA,EAAyB,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;KAW1B,mBAAA,GAAsB,MAAA,CAAO,MAAA,CAAO,IAAI,QAAQ,yBAAA"}

package/dist/provenance.mjs

@@ -1,26 +0,0 @@
-import { KnowledgeMetadataSchema, NonEmptyTrimmedString } from "./records.mjs";
-import * as Schema from "effect/Schema";
-//#region src/provenance.ts
-const KnowledgeProvenanceSourceKindSchema = Schema.Literals([
-	"upload",
-	"user_statement",
-	"url",
-	"generated",
-	"imported",
-	"external_api"
-]);
-const KnowledgeProvenanceSchema = Schema.Struct({
-	id: NonEmptyTrimmedString,
-	recordId: NonEmptyTrimmedString,
-	artifactId: Schema.optional(NonEmptyTrimmedString),
-	sourceKind: KnowledgeProvenanceSourceKindSchema,
-	sourceLabel: NonEmptyTrimmedString,
-	sourceUrl: Schema.optional(NonEmptyTrimmedString),
-	observedAt: Schema.optional(Schema.DateTimeUtc),
-	metadata: Schema.optional(KnowledgeMetadataSchema),
-	createdAt: Schema.DateTimeUtc
-});
-//#endregion
-export { KnowledgeProvenanceSchema, KnowledgeProvenanceSourceKindSchema };
-
-//# sourceMappingURL=provenance.mjs.map

package/dist/provenance.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"provenance.mjs","names":[],"sources":["../src/provenance.ts"],"sourcesContent":["import * as Schema from 'effect/Schema'\nimport { KnowledgeMetadataSchema, NonEmptyTrimmedString } from './records.ts'\n\nexport const KnowledgeProvenanceSourceKindSchema = Schema.Literals([\n  'upload',\n  'user_statement',\n  'url',\n  'generated',\n  'imported',\n  'external_api'\n])\nexport type KnowledgeProvenanceSourceKind = Schema.Schema.Type<typeof KnowledgeProvenanceSourceKindSchema>\n\nexport const KnowledgeProvenanceSchema = Schema.Struct({\n  id: NonEmptyTrimmedString,\n  recordId: NonEmptyTrimmedString,\n  artifactId: Schema.optional(NonEmptyTrimmedString),\n  sourceKind: KnowledgeProvenanceSourceKindSchema,\n  sourceLabel: NonEmptyTrimmedString,\n  sourceUrl: Schema.optional(NonEmptyTrimmedString),\n  observedAt: Schema.optional(Schema.DateTimeUtc),\n  metadata: Schema.optional(KnowledgeMetadataSchema),\n  createdAt: Schema.DateTimeUtc\n})\nexport type KnowledgeProvenance = Schema.Schema.Type<typeof KnowledgeProvenanceSchema>\n"],"mappings":";;;AAGA,MAAa,sCAAsC,OAAO,SAAS;CACjE;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAGD,MAAa,4BAA4B,OAAO,OAAO;CACrD,IAAI;CACJ,UAAU;CACV,YAAY,OAAO,SAAS,qBAAqB;CACjD,YAAY;CACZ,aAAa;CACb,WAAW,OAAO,SAAS,qBAAqB;CAChD,YAAY,OAAO,SAAS,OAAO,WAAW;CAC9C,UAAU,OAAO,SAAS,uBAAuB;CACjD,WAAW,OAAO;AACpB,CAAC"}