@yolk-sdk/knowledge 0.0.1-canary.0

package/dist/records.d.mts

@@ -0,0 +1,59 @@
+import * as Schema from "effect/Schema";
+
+//#region src/records.d.ts
+declare const NonEmptyTrimmedString: Schema.Trimmed;
+declare const NonNegativeInteger: Schema.Int;
+declare const PositiveInteger: Schema.Int;
+declare const KnowledgeMetadataSchema: Schema.$Record<Schema.String, Schema.Unknown>;
+type KnowledgeMetadata = Schema.Schema.Type<typeof KnowledgeMetadataSchema>;
+declare const KnowledgeRecordRoleSchema: Schema.Literals<readonly ["source", "note", "operating_protocol", "knowledge_map", "compiled_truth", "decision"]>;
+type KnowledgeRecordRole = Schema.Schema.Type<typeof KnowledgeRecordRoleSchema>;
+declare const KnowledgeContextPolicySchema: Schema.Literals<readonly ["pinned", "routable", "searchable", "archival"]>;
+type KnowledgeContextPolicy = Schema.Schema.Type<typeof KnowledgeContextPolicySchema>;
+declare const KnowledgeLifecycleStatusSchema: Schema.Literals<readonly ["draft", "processing", "ready", "error", "archived", "deleted"]>;
+type KnowledgeLifecycleStatus = Schema.Schema.Type<typeof KnowledgeLifecycleStatusSchema>;
+declare const KnowledgeScopeSchema: Schema.Struct<{
+  readonly id: Schema.Trimmed;
+  readonly kind: Schema.optional<Schema.Trimmed>;
+}>;
+type KnowledgeScope = Schema.Schema.Type<typeof KnowledgeScopeSchema>;
+declare const KnowledgeRecordSchema: Schema.Struct<{
+  readonly id: Schema.Trimmed;
+  readonly role: Schema.Literals<readonly ["source", "note", "operating_protocol", "knowledge_map", "compiled_truth", "decision"]>;
+  readonly title: Schema.Trimmed;
+  readonly status: Schema.Literals<readonly ["draft", "processing", "ready", "error", "archived", "deleted"]>;
+  readonly contextPolicy: Schema.Literals<readonly ["pinned", "routable", "searchable", "archival"]>;
+  readonly summary: Schema.optional<Schema.String>;
+  readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+  readonly createdAt: Schema.DateTimeUtc;
+  readonly updatedAt: Schema.DateTimeUtc;
+}>;
+type KnowledgeRecord = Schema.Schema.Type<typeof KnowledgeRecordSchema>;
+declare const CreateKnowledgeRecordInputSchema: Schema.Struct<{
+  readonly scope: Schema.Struct<{
+    readonly id: Schema.Trimmed;
+    readonly kind: Schema.optional<Schema.Trimmed>;
+  }>;
+  readonly role: Schema.Literals<readonly ["source", "note", "operating_protocol", "knowledge_map", "compiled_truth", "decision"]>;
+  readonly title: Schema.Trimmed;
+  readonly contextPolicy: Schema.Literals<readonly ["pinned", "routable", "searchable", "archival"]>;
+  readonly summary: Schema.optional<Schema.String>;
+  readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+}>;
+type CreateKnowledgeRecordInput = Schema.Schema.Type<typeof CreateKnowledgeRecordInputSchema>;
+declare const UpdateKnowledgeRecordInputSchema: Schema.Struct<{
+  readonly scope: Schema.Struct<{
+    readonly id: Schema.Trimmed;
+    readonly kind: Schema.optional<Schema.Trimmed>;
+  }>;
+  readonly id: Schema.Trimmed;
+  readonly title: Schema.optional<Schema.Trimmed>;
+  readonly status: Schema.optional<Schema.Literals<readonly ["draft", "processing", "ready", "error", "archived", "deleted"]>>;
+  readonly contextPolicy: Schema.optional<Schema.Literals<readonly ["pinned", "routable", "searchable", "archival"]>>;
+  readonly summary: Schema.optional<Schema.String>;
+  readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+}>;
+type UpdateKnowledgeRecordInput = Schema.Schema.Type<typeof UpdateKnowledgeRecordInputSchema>;
+//#endregion
+export { CreateKnowledgeRecordInput, CreateKnowledgeRecordInputSchema, KnowledgeContextPolicy, KnowledgeContextPolicySchema, KnowledgeLifecycleStatus, KnowledgeLifecycleStatusSchema, KnowledgeMetadata, KnowledgeMetadataSchema, KnowledgeRecord, KnowledgeRecordRole, KnowledgeRecordRoleSchema, KnowledgeRecordSchema, KnowledgeScope, KnowledgeScopeSchema, NonEmptyTrimmedString, NonNegativeInteger, PositiveInteger, UpdateKnowledgeRecordInput, UpdateKnowledgeRecordInputSchema };
+//# sourceMappingURL=records.d.mts.map

package/dist/records.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.d.mts","names":[],"sources":["../src/records.ts"],"mappings":";;;cAEa,qBAAA,EAAqB,MAAA,CAAA,OAAyD;AAAA,cAC9E,kBAAA,EAAkB,MAAA,CAAA,GAAkE;AAAA,cACpF,eAAA,EAAe,MAAA,CAAA,GAAyD;AAAA,cAExE,uBAAA,EAAuB,MAAA,CAAA,OAAA,CAAA,MAAA,CAAA,MAAA,EAAA,MAAA,CAAA,OAAA;AAAA,KACxB,iBAAA,GAAoB,MAAA,CAAO,MAAA,CAAO,IAAI,QAAQ,uBAAA;AAAA,cAE7C,yBAAA,EAAyB,MAAA,CAAA,QAAA;AAAA,KAQ1B,mBAAA,GAAsB,MAAA,CAAO,MAAA,CAAO,IAAI,QAAQ,yBAAA;AAAA,cAE/C,4BAAA,EAA4B,MAAA,CAAA,QAAA;AAAA,KAM7B,sBAAA,GAAyB,MAAA,CAAO,MAAA,CAAO,IAAI,QAAQ,4BAAA;AAAA,cAElD,8BAAA,EAA8B,MAAA,CAAA,QAAA;AAAA,KAQ/B,wBAAA,GAA2B,MAAA,CAAO,MAAA,CAAO,IAAI,QAAQ,8BAAA;AAAA,cAEpD,oBAAA,EAAoB,MAAA,CAAA,MAAA;EAAA;;;KAIrB,cAAA,GAAiB,MAAA,CAAO,MAAA,CAAO,IAAI,QAAQ,oBAAA;AAAA,cAE1C,qBAAA,EAAqB,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;KAWtB,eAAA,GAAkB,MAAA,CAAO,MAAA,CAAO,IAAI,QAAQ,qBAAA;AAAA,cAE3C,gCAAA,EAAgC,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;KAQjC,0BAAA,GAA6B,MAAA,CAAO,MAAA,CAAO,IAAI,QAAQ,gCAAA;AAAA,cAEtD,gCAAA,EAAgC,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;KASjC,0BAAA,GAA6B,MAAA,CAAO,MAAA,CAAO,IAAI,QAAQ,gCAAA"}

package/dist/records.mjs

@@ -0,0 +1,64 @@
+import * as Schema from "effect/Schema";
+//#region src/records.ts
+const NonEmptyTrimmedString = Schema.Trimmed.pipe(Schema.check(Schema.isNonEmpty()));
+const NonNegativeInteger = Schema.Int.pipe(Schema.check(Schema.isGreaterThanOrEqualTo(0)));
+const PositiveInteger = Schema.Int.pipe(Schema.check(Schema.isGreaterThan(0)));
+const KnowledgeMetadataSchema = Schema.Record(Schema.String, Schema.Unknown);
+const KnowledgeRecordRoleSchema = Schema.Literals([
+	"source",
+	"note",
+	"operating_protocol",
+	"knowledge_map",
+	"compiled_truth",
+	"decision"
+]);
+const KnowledgeContextPolicySchema = Schema.Literals([
+	"pinned",
+	"routable",
+	"searchable",
+	"archival"
+]);
+const KnowledgeLifecycleStatusSchema = Schema.Literals([
+	"draft",
+	"processing",
+	"ready",
+	"error",
+	"archived",
+	"deleted"
+]);
+const KnowledgeScopeSchema = Schema.Struct({
+	id: NonEmptyTrimmedString,
+	kind: Schema.optional(NonEmptyTrimmedString)
+});
+const KnowledgeRecordSchema = Schema.Struct({
+	id: NonEmptyTrimmedString,
+	role: KnowledgeRecordRoleSchema,
+	title: NonEmptyTrimmedString,
+	status: KnowledgeLifecycleStatusSchema,
+	contextPolicy: KnowledgeContextPolicySchema,
+	summary: Schema.optional(Schema.String),
+	metadata: Schema.optional(KnowledgeMetadataSchema),
+	createdAt: Schema.DateTimeUtc,
+	updatedAt: Schema.DateTimeUtc
+});
+const CreateKnowledgeRecordInputSchema = Schema.Struct({
+	scope: KnowledgeScopeSchema,
+	role: KnowledgeRecordRoleSchema,
+	title: NonEmptyTrimmedString,
+	contextPolicy: KnowledgeContextPolicySchema,
+	summary: Schema.optional(Schema.String),
+	metadata: Schema.optional(KnowledgeMetadataSchema)
+});
+const UpdateKnowledgeRecordInputSchema = Schema.Struct({
+	scope: KnowledgeScopeSchema,
+	id: NonEmptyTrimmedString,
+	title: Schema.optional(NonEmptyTrimmedString),
+	status: Schema.optional(KnowledgeLifecycleStatusSchema),
+	contextPolicy: Schema.optional(KnowledgeContextPolicySchema),
+	summary: Schema.optional(Schema.String),
+	metadata: Schema.optional(KnowledgeMetadataSchema)
+});
+//#endregion
+export { CreateKnowledgeRecordInputSchema, KnowledgeContextPolicySchema, KnowledgeLifecycleStatusSchema, KnowledgeMetadataSchema, KnowledgeRecordRoleSchema, KnowledgeRecordSchema, KnowledgeScopeSchema, NonEmptyTrimmedString, NonNegativeInteger, PositiveInteger, UpdateKnowledgeRecordInputSchema };
+
+//# sourceMappingURL=records.mjs.map

package/dist/records.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.mjs","names":[],"sources":["../src/records.ts"],"sourcesContent":["import * as Schema from 'effect/Schema'\n\nexport const NonEmptyTrimmedString = Schema.Trimmed.pipe(Schema.check(Schema.isNonEmpty()))\nexport const NonNegativeInteger = Schema.Int.pipe(Schema.check(Schema.isGreaterThanOrEqualTo(0)))\nexport const PositiveInteger = Schema.Int.pipe(Schema.check(Schema.isGreaterThan(0)))\n\nexport const KnowledgeMetadataSchema = Schema.Record(Schema.String, Schema.Unknown)\nexport type KnowledgeMetadata = Schema.Schema.Type<typeof KnowledgeMetadataSchema>\n\nexport const KnowledgeRecordRoleSchema = Schema.Literals([\n  'source',\n  'note',\n  'operating_protocol',\n  'knowledge_map',\n  'compiled_truth',\n  'decision'\n])\nexport type KnowledgeRecordRole = Schema.Schema.Type<typeof KnowledgeRecordRoleSchema>\n\nexport const KnowledgeContextPolicySchema = Schema.Literals([\n  'pinned',\n  'routable',\n  'searchable',\n  'archival'\n])\nexport type KnowledgeContextPolicy = Schema.Schema.Type<typeof KnowledgeContextPolicySchema>\n\nexport const KnowledgeLifecycleStatusSchema = Schema.Literals([\n  'draft',\n  'processing',\n  'ready',\n  'error',\n  'archived',\n  'deleted'\n])\nexport type KnowledgeLifecycleStatus = Schema.Schema.Type<typeof KnowledgeLifecycleStatusSchema>\n\nexport const KnowledgeScopeSchema = Schema.Struct({\n  id: NonEmptyTrimmedString,\n  kind: Schema.optional(NonEmptyTrimmedString)\n})\nexport type KnowledgeScope = Schema.Schema.Type<typeof KnowledgeScopeSchema>\n\nexport const KnowledgeRecordSchema = Schema.Struct({\n  id: NonEmptyTrimmedString,\n  role: KnowledgeRecordRoleSchema,\n  title: NonEmptyTrimmedString,\n  status: KnowledgeLifecycleStatusSchema,\n  contextPolicy: KnowledgeContextPolicySchema,\n  summary: Schema.optional(Schema.String),\n  metadata: Schema.optional(KnowledgeMetadataSchema),\n  createdAt: Schema.DateTimeUtc,\n  updatedAt: Schema.DateTimeUtc\n})\nexport type KnowledgeRecord = Schema.Schema.Type<typeof KnowledgeRecordSchema>\n\nexport const CreateKnowledgeRecordInputSchema = Schema.Struct({\n  scope: KnowledgeScopeSchema,\n  role: KnowledgeRecordRoleSchema,\n  title: NonEmptyTrimmedString,\n  contextPolicy: KnowledgeContextPolicySchema,\n  summary: Schema.optional(Schema.String),\n  metadata: Schema.optional(KnowledgeMetadataSchema)\n})\nexport type CreateKnowledgeRecordInput = Schema.Schema.Type<typeof CreateKnowledgeRecordInputSchema>\n\nexport const UpdateKnowledgeRecordInputSchema = Schema.Struct({\n  scope: KnowledgeScopeSchema,\n  id: NonEmptyTrimmedString,\n  title: Schema.optional(NonEmptyTrimmedString),\n  status: Schema.optional(KnowledgeLifecycleStatusSchema),\n  contextPolicy: Schema.optional(KnowledgeContextPolicySchema),\n  summary: Schema.optional(Schema.String),\n  metadata: Schema.optional(KnowledgeMetadataSchema)\n})\nexport type UpdateKnowledgeRecordInput = Schema.Schema.Type<typeof UpdateKnowledgeRecordInputSchema>\n"],"mappings":";;AAEA,MAAa,wBAAwB,OAAO,QAAQ,KAAK,OAAO,MAAM,OAAO,WAAW,CAAC,CAAC;AAC1F,MAAa,qBAAqB,OAAO,IAAI,KAAK,OAAO,MAAM,OAAO,uBAAuB,CAAC,CAAC,CAAC;AAChG,MAAa,kBAAkB,OAAO,IAAI,KAAK,OAAO,MAAM,OAAO,cAAc,CAAC,CAAC,CAAC;AAEpF,MAAa,0BAA0B,OAAO,OAAO,OAAO,QAAQ,OAAO,OAAO;AAGlF,MAAa,4BAA4B,OAAO,SAAS;CACvD;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAGD,MAAa,+BAA+B,OAAO,SAAS;CAC1D;CACA;CACA;CACA;AACF,CAAC;AAGD,MAAa,iCAAiC,OAAO,SAAS;CAC5D;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAGD,MAAa,uBAAuB,OAAO,OAAO;CAChD,IAAI;CACJ,MAAM,OAAO,SAAS,qBAAqB;AAC7C,CAAC;AAGD,MAAa,wBAAwB,OAAO,OAAO;CACjD,IAAI;CACJ,MAAM;CACN,OAAO;CACP,QAAQ;CACR,eAAe;CACf,SAAS,OAAO,SAAS,OAAO,MAAM;CACtC,UAAU,OAAO,SAAS,uBAAuB;CACjD,WAAW,OAAO;CAClB,WAAW,OAAO;AACpB,CAAC;AAGD,MAAa,mCAAmC,OAAO,OAAO;CAC5D,OAAO;CACP,MAAM;CACN,OAAO;CACP,eAAe;CACf,SAAS,OAAO,SAAS,OAAO,MAAM;CACtC,UAAU,OAAO,SAAS,uBAAuB;AACnD,CAAC;AAGD,MAAa,mCAAmC,OAAO,OAAO;CAC5D,OAAO;CACP,IAAI;CACJ,OAAO,OAAO,SAAS,qBAAqB;CAC5C,QAAQ,OAAO,SAAS,8BAA8B;CACtD,eAAe,OAAO,SAAS,4BAA4B;CAC3D,SAAS,OAAO,SAAS,OAAO,MAAM;CACtC,UAAU,OAAO,SAAS,uBAAuB;AACnD,CAAC"}

package/dist/representations.d.mts

@@ -0,0 +1,36 @@
+import * as Schema from "effect/Schema";
+
+//#region src/representations.d.ts
+declare const KnowledgeRepresentationModalitySchema: Schema.Literals<readonly ["text", "image", "audio", "video", "table"]>;
+type KnowledgeRepresentationModality = Schema.Schema.Type<typeof KnowledgeRepresentationModalitySchema>;
+declare const KnowledgeRepresentationStatusSchema: Schema.Literals<readonly ["pending", "processing", "ready", "error"]>;
+type KnowledgeRepresentationStatus = Schema.Schema.Type<typeof KnowledgeRepresentationStatusSchema>;
+declare const KnowledgeRepresentationSchema: Schema.Struct<{
+  readonly id: Schema.Trimmed;
+  readonly recordId: Schema.Trimmed;
+  readonly artifactId: Schema.optional<Schema.Trimmed>;
+  readonly modality: Schema.Literals<readonly ["text", "image", "audio", "video", "table"]>;
+  readonly status: Schema.Literals<readonly ["pending", "processing", "ready", "error"]>;
+  readonly contentText: Schema.optional<Schema.String>;
+  readonly summary: Schema.optional<Schema.String>;
+  readonly model: Schema.optional<Schema.Trimmed>;
+  readonly errorMessage: Schema.optional<Schema.String>;
+  readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+  readonly createdAt: Schema.DateTimeUtc;
+  readonly updatedAt: Schema.DateTimeUtc;
+}>;
+type KnowledgeRepresentation = Schema.Schema.Type<typeof KnowledgeRepresentationSchema>;
+declare const KnowledgeRepresentationChunkSchema: Schema.Struct<{
+  readonly id: Schema.Trimmed;
+  readonly recordId: Schema.Trimmed;
+  readonly representationId: Schema.Trimmed;
+  readonly content: Schema.Trimmed;
+  readonly position: Schema.Int;
+  readonly tokenCount: Schema.Int;
+  readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+  readonly createdAt: Schema.DateTimeUtc;
+}>;
+type KnowledgeRepresentationChunk = Schema.Schema.Type<typeof KnowledgeRepresentationChunkSchema>;
+//#endregion
+export { KnowledgeRepresentation, KnowledgeRepresentationChunk, KnowledgeRepresentationChunkSchema, KnowledgeRepresentationModality, KnowledgeRepresentationModalitySchema, KnowledgeRepresentationSchema, KnowledgeRepresentationStatus, KnowledgeRepresentationStatusSchema };
+//# sourceMappingURL=representations.d.mts.map

package/dist/representations.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"representations.d.mts","names":[],"sources":["../src/representations.ts"],"mappings":";;;cAOa,qCAAA,EAAqC,MAAA,CAAA,QAAA;AAAA,KAOtC,+BAAA,GAAkC,MAAA,CAAO,MAAA,CAAO,IAAI,QAAQ,qCAAA;AAAA,cAE3D,mCAAA,EAAmC,MAAA,CAAA,QAAA;AAAA,KAMpC,6BAAA,GAAgC,MAAA,CAAO,MAAA,CAAO,IAAI,QAAQ,mCAAA;AAAA,cAEzD,6BAAA,EAA6B,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;KAc9B,uBAAA,GAA0B,MAAA,CAAO,MAAA,CAAO,IAAI,QAAQ,6BAAA;AAAA,cAEnD,kCAAA,EAAkC,MAAA,CAAA,MAAA;EAAA;;;;;;;;;KAUnC,4BAAA,GAA+B,MAAA,CAAO,MAAA,CAAO,IAAI,QAAQ,kCAAA"}

package/dist/representations.mjs

@@ -0,0 +1,44 @@
+import { KnowledgeMetadataSchema, NonEmptyTrimmedString, NonNegativeInteger } from "./records.mjs";
+import * as Schema from "effect/Schema";
+//#region src/representations.ts
+const KnowledgeRepresentationModalitySchema = Schema.Literals([
+	"text",
+	"image",
+	"audio",
+	"video",
+	"table"
+]);
+const KnowledgeRepresentationStatusSchema = Schema.Literals([
+	"pending",
+	"processing",
+	"ready",
+	"error"
+]);
+const KnowledgeRepresentationSchema = Schema.Struct({
+	id: NonEmptyTrimmedString,
+	recordId: NonEmptyTrimmedString,
+	artifactId: Schema.optional(NonEmptyTrimmedString),
+	modality: KnowledgeRepresentationModalitySchema,
+	status: KnowledgeRepresentationStatusSchema,
+	contentText: Schema.optional(Schema.String),
+	summary: Schema.optional(Schema.String),
+	model: Schema.optional(NonEmptyTrimmedString),
+	errorMessage: Schema.optional(Schema.String),
+	metadata: Schema.optional(KnowledgeMetadataSchema),
+	createdAt: Schema.DateTimeUtc,
+	updatedAt: Schema.DateTimeUtc
+});
+const KnowledgeRepresentationChunkSchema = Schema.Struct({
+	id: NonEmptyTrimmedString,
+	recordId: NonEmptyTrimmedString,
+	representationId: NonEmptyTrimmedString,
+	content: NonEmptyTrimmedString,
+	position: NonNegativeInteger,
+	tokenCount: NonNegativeInteger,
+	metadata: Schema.optional(KnowledgeMetadataSchema),
+	createdAt: Schema.DateTimeUtc
+});
+//#endregion
+export { KnowledgeRepresentationChunkSchema, KnowledgeRepresentationModalitySchema, KnowledgeRepresentationSchema, KnowledgeRepresentationStatusSchema };
+
+//# sourceMappingURL=representations.mjs.map

package/dist/representations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"representations.mjs","names":[],"sources":["../src/representations.ts"],"sourcesContent":["import * as Schema from 'effect/Schema'\nimport {\n  KnowledgeMetadataSchema,\n  NonEmptyTrimmedString,\n  NonNegativeInteger\n} from './records.ts'\n\nexport const KnowledgeRepresentationModalitySchema = Schema.Literals([\n  'text',\n  'image',\n  'audio',\n  'video',\n  'table'\n])\nexport type KnowledgeRepresentationModality = Schema.Schema.Type<typeof KnowledgeRepresentationModalitySchema>\n\nexport const KnowledgeRepresentationStatusSchema = Schema.Literals([\n  'pending',\n  'processing',\n  'ready',\n  'error'\n])\nexport type KnowledgeRepresentationStatus = Schema.Schema.Type<typeof KnowledgeRepresentationStatusSchema>\n\nexport const KnowledgeRepresentationSchema = Schema.Struct({\n  id: NonEmptyTrimmedString,\n  recordId: NonEmptyTrimmedString,\n  artifactId: Schema.optional(NonEmptyTrimmedString),\n  modality: KnowledgeRepresentationModalitySchema,\n  status: KnowledgeRepresentationStatusSchema,\n  contentText: Schema.optional(Schema.String),\n  summary: Schema.optional(Schema.String),\n  model: Schema.optional(NonEmptyTrimmedString),\n  errorMessage: Schema.optional(Schema.String),\n  metadata: Schema.optional(KnowledgeMetadataSchema),\n  createdAt: Schema.DateTimeUtc,\n  updatedAt: Schema.DateTimeUtc\n})\nexport type KnowledgeRepresentation = Schema.Schema.Type<typeof KnowledgeRepresentationSchema>\n\nexport const KnowledgeRepresentationChunkSchema = Schema.Struct({\n  id: NonEmptyTrimmedString,\n  recordId: NonEmptyTrimmedString,\n  representationId: NonEmptyTrimmedString,\n  content: NonEmptyTrimmedString,\n  position: NonNegativeInteger,\n  tokenCount: NonNegativeInteger,\n  metadata: Schema.optional(KnowledgeMetadataSchema),\n  createdAt: Schema.DateTimeUtc\n})\nexport type KnowledgeRepresentationChunk = Schema.Schema.Type<typeof KnowledgeRepresentationChunkSchema>\n"],"mappings":";;;AAOA,MAAa,wCAAwC,OAAO,SAAS;CACnE;CACA;CACA;CACA;CACA;AACF,CAAC;AAGD,MAAa,sCAAsC,OAAO,SAAS;CACjE;CACA;CACA;CACA;AACF,CAAC;AAGD,MAAa,gCAAgC,OAAO,OAAO;CACzD,IAAI;CACJ,UAAU;CACV,YAAY,OAAO,SAAS,qBAAqB;CACjD,UAAU;CACV,QAAQ;CACR,aAAa,OAAO,SAAS,OAAO,MAAM;CAC1C,SAAS,OAAO,SAAS,OAAO,MAAM;CACtC,OAAO,OAAO,SAAS,qBAAqB;CAC5C,cAAc,OAAO,SAAS,OAAO,MAAM;CAC3C,UAAU,OAAO,SAAS,uBAAuB;CACjD,WAAW,OAAO;CAClB,WAAW,OAAO;AACpB,CAAC;AAGD,MAAa,qCAAqC,OAAO,OAAO;CAC9D,IAAI;CACJ,UAAU;CACV,kBAAkB;CAClB,SAAS;CACT,UAAU;CACV,YAAY;CACZ,UAAU,OAAO,SAAS,uBAAuB;CACjD,WAAW,OAAO;AACpB,CAAC"}

package/dist/search-store.d.mts

@@ -0,0 +1,77 @@
+import { KnowledgeChunk, KnowledgeCollection, KnowledgeDocument, KnowledgeSearchScope } from "./documents.mjs";
+import { SearchIndexStoreError } from "./errors.mjs";
+import { KnowledgeEmbedding } from "./embeddings.mjs";
+import { Context, Effect } from "effect";
+
+//#region src/search-store.d.ts
+type UpsertKnowledgeDocumentInput = {
+  readonly document: KnowledgeDocument;
+};
+type ReplaceKnowledgeDocumentChunksInput = {
+  readonly collectionId: string;
+  readonly documentId: string;
+  readonly chunks: ReadonlyArray<{
+    readonly chunk: KnowledgeChunk;
+    readonly embedding: KnowledgeEmbedding;
+  }>;
+};
+type MarkKnowledgeDocumentReadyInput = {
+  readonly collectionId: string;
+  readonly documentId: string;
+  readonly title?: string;
+  readonly summary?: string;
+  readonly contentHash?: string;
+  readonly tokenCount: number;
+  readonly chunkCount: number;
+};
+type MarkKnowledgeDocumentErrorInput = {
+  readonly collectionId: string;
+  readonly documentId: string;
+  readonly message: string;
+};
+type KnowledgeChunkSearchInput = {
+  readonly scope: KnowledgeSearchScope;
+  readonly embedding: KnowledgeEmbedding;
+  readonly limit: number;
+  readonly minScore?: number;
+};
+type KnowledgeChunkTextSearchInput = {
+  readonly scope: KnowledgeSearchScope;
+  readonly query: string;
+  readonly limit: number;
+};
+type KnowledgeChunkSearchResult = {
+  readonly chunk: KnowledgeChunk;
+  readonly score: number;
+  readonly document: KnowledgeDocument;
+};
+type KnowledgeSearchContextChunksInput = {
+  readonly collectionId: string;
+  readonly documentId: string;
+  readonly position: number;
+  readonly contextChunks: number;
+};
+type SearchIndexStoreApi = {
+  readonly upsertSet: (set: KnowledgeCollection) => Effect.Effect<KnowledgeCollection, SearchIndexStoreError>;
+  readonly getSet: (id: string) => Effect.Effect<KnowledgeCollection, SearchIndexStoreError>;
+  readonly upsertDocument: (input: UpsertKnowledgeDocumentInput) => Effect.Effect<KnowledgeDocument, SearchIndexStoreError>;
+  readonly markDocumentProcessing: (input: {
+    readonly collectionId: string;
+    readonly documentId: string;
+  }) => Effect.Effect<KnowledgeDocument, SearchIndexStoreError>;
+  readonly replaceDocumentChunks: (input: ReplaceKnowledgeDocumentChunksInput) => Effect.Effect<void, SearchIndexStoreError>;
+  readonly markDocumentReady: (input: MarkKnowledgeDocumentReadyInput) => Effect.Effect<KnowledgeDocument, SearchIndexStoreError>;
+  readonly markDocumentError: (input: MarkKnowledgeDocumentErrorInput) => Effect.Effect<void, SearchIndexStoreError>;
+  readonly deleteDocument: (input: {
+    readonly collectionId: string;
+    readonly documentId: string;
+  }) => 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>;
+declare class SearchIndexStore extends SearchIndexStore_base {}
+//#endregion
+export { KnowledgeChunkSearchInput, KnowledgeChunkSearchResult, KnowledgeChunkTextSearchInput, KnowledgeSearchContextChunksInput, MarkKnowledgeDocumentErrorInput, MarkKnowledgeDocumentReadyInput, ReplaceKnowledgeDocumentChunksInput, SearchIndexStore, SearchIndexStoreApi, UpsertKnowledgeDocumentInput };
+//# sourceMappingURL=search-store.d.mts.map

package/dist/search-store.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-store.d.mts","names":[],"sources":["../src/search-store.ts"],"mappings":";;;;;;KAMY,4BAAA;EAAA,SACD,QAAA,EAAU,iBAAiB;AAAA;AAAA,KAG1B,mCAAA;EAAA,SACD,YAAA;EAAA,SACA,UAAA;EAAA,SACA,MAAA,EAAQ,aAAA;IAAA,SACN,KAAA,EAAO,cAAA;IAAA,SACP,SAAA,EAAW,kBAAA;EAAA;AAAA;AAAA,KAIZ,+BAAA;EAAA,SACD,YAAA;EAAA,SACA,UAAA;EAAA,SACA,KAAA;EAAA,SACA,OAAA;EAAA,SACA,WAAA;EAAA,SACA,UAAA;EAAA,SACA,UAAA;AAAA;AAAA,KAGC,+BAAA;EAAA,SACD,YAAA;EAAA,SACA,UAAA;EAAA,SACA,OAAA;AAAA;AAAA,KAGC,yBAAA;EAAA,SACD,KAAA,EAAO,oBAAA;EAAA,SACP,SAAA,EAAW,kBAAkB;EAAA,SAC7B,KAAA;EAAA,SACA,QAAA;AAAA;AAAA,KAGC,6BAAA;EAAA,SACD,KAAA,EAAO,oBAAoB;EAAA,SAC3B,KAAA;EAAA,SACA,KAAA;AAAA;AAAA,KAGC,0BAAA;EAAA,SACD,KAAA,EAAO,cAAA;EAAA,SACP,KAAA;EAAA,SACA,QAAA,EAAU,iBAAiB;AAAA;AAAA,KAG1B,iCAAA;EAAA,SACD,YAAA;EAAA,SACA,UAAA;EAAA,SACA,QAAA;EAAA,SACA,aAAA;AAAA;AAAA,KAGC,mBAAA;EAAA,SACD,SAAA,GAAY,GAAA,EAAK,mBAAA,KAAwB,MAAA,CAAO,MAAA,CAAO,mBAAA,EAAqB,qBAAA;EAAA,SAC5E,MAAA,GAAS,EAAA,aAAe,MAAA,CAAO,MAAA,CAAO,mBAAA,EAAqB,qBAAA;EAAA,SAC3D,cAAA,GACP,KAAA,EAAO,4BAAA,KACJ,MAAA,CAAO,MAAA,CAAO,iBAAA,EAAmB,qBAAA;EAAA,SAC7B,sBAAA,GAAyB,KAAA;IAAA,SACvB,YAAA;IAAA,SACA,UAAA;EAAA,MACL,MAAA,CAAO,MAAA,CAAO,iBAAA,EAAmB,qBAAA;EAAA,SAC9B,qBAAA,GACP,KAAA,EAAO,mCAAA,KACJ,MAAA,CAAO,MAAA,OAAa,qBAAA;EAAA,SAChB,iBAAA,GACP,KAAA,EAAO,+BAAA,KACJ,MAAA,CAAO,MAAA,CAAO,iBAAA,EAAmB,qBAAA;EAAA,SAC7B,iBAAA,GACP,KAAA,EAAO,+BAAA,KACJ,MAAA,CAAO,MAAA,OAAa,qBAAA;EAAA,SAChB,cAAA,GAAiB,KAAA;IAAA,SACf,YAAA;IAAA,SACA,UAAA;EAAA,MACL,MAAA,CAAO,MAAA,OAAa,qBAAA;EAAA,SACjB,YAAA,GACP,KAAA,EAAO,yBAAA,KACJ,MAAA,CAAO,MAAA,CAAO,aAAA,CAAc,0BAAA,GAA6B,qBAAA;EAAA,SACrD,kBAAA,GACP,KAAA,EAAO,6BAAA,KACJ,MAAA,CAAO,MAAA,CAAO,aAAA,CAAc,0BAAA,GAA6B,qBAAA;EAAA,SACrD,gBAAA,GACP,KAAA,EAAO,iCAAA,KACJ,MAAA,CAAO,MAAA,CAAO,aAAA,CAAc,cAAA,GAAiB,qBAAA;AAAA;AAAA,cACnD,qBAAA;cAEY,gBAAA,SAAyB,qBAErC"}

package/dist/search-store.mjs

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

package/dist/search-store.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-store.mjs","names":[],"sources":["../src/search-store.ts"],"sourcesContent":["import { Context } from 'effect'\nimport type { Effect } from 'effect'\nimport type { KnowledgeChunk, KnowledgeDocument, KnowledgeSearchScope, KnowledgeCollection } from './documents.ts'\nimport type { KnowledgeEmbedding } from './embeddings.ts'\nimport type { SearchIndexStoreError } from './errors.ts'\n\nexport type UpsertKnowledgeDocumentInput = {\n  readonly document: KnowledgeDocument\n}\n\nexport type ReplaceKnowledgeDocumentChunksInput = {\n  readonly collectionId: string\n  readonly documentId: string\n  readonly chunks: ReadonlyArray<{\n    readonly chunk: KnowledgeChunk\n    readonly embedding: KnowledgeEmbedding\n  }>\n}\n\nexport type MarkKnowledgeDocumentReadyInput = {\n  readonly collectionId: string\n  readonly documentId: string\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 collectionId: string\n  readonly documentId: string\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: KnowledgeDocument\n}\n\nexport type KnowledgeSearchContextChunksInput = {\n  readonly collectionId: string\n  readonly documentId: string\n  readonly position: number\n  readonly contextChunks: number\n}\n\nexport type SearchIndexStoreApi = {\n  readonly upsertSet: (set: KnowledgeCollection) => Effect.Effect<KnowledgeCollection, SearchIndexStoreError>\n  readonly getSet: (id: string) => Effect.Effect<KnowledgeCollection, SearchIndexStoreError>\n  readonly upsertDocument: (\n    input: UpsertKnowledgeDocumentInput\n  ) => Effect.Effect<KnowledgeDocument, SearchIndexStoreError>\n  readonly markDocumentProcessing: (input: {\n    readonly collectionId: string\n    readonly documentId: string\n  }) => Effect.Effect<KnowledgeDocument, SearchIndexStoreError>\n  readonly replaceDocumentChunks: (\n    input: ReplaceKnowledgeDocumentChunksInput\n  ) => Effect.Effect<void, SearchIndexStoreError>\n  readonly markDocumentReady: (\n    input: MarkKnowledgeDocumentReadyInput\n  ) => Effect.Effect<KnowledgeDocument, SearchIndexStoreError>\n  readonly markDocumentError: (\n    input: MarkKnowledgeDocumentErrorInput\n  ) => Effect.Effect<void, SearchIndexStoreError>\n  readonly deleteDocument: (input: {\n    readonly collectionId: string\n    readonly documentId: string\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":";;AA+FA,IAAa,mBAAb,cAAsC,QAAQ,QAA+C,EAC3F,sCACF,EAAE,CAAC"}

package/dist/search.d.mts

@@ -0,0 +1,49 @@
+import { KnowledgeChunk, KnowledgeDocument, KnowledgeSearchScope } from "./documents.mjs";
+import { KnowledgeSearchError } from "./errors.mjs";
+import { KnowledgeEmbedder } from "./embeddings.mjs";
+import { SearchIndexStore } from "./search-store.mjs";
+import { Effect } from "effect";
+
+//#region src/search.d.ts
+type KnowledgeSearchInput = {
+  readonly scope: KnowledgeSearchScope;
+  readonly query: string;
+  readonly limit?: number;
+  readonly minScore?: number;
+  readonly contextChunks?: number;
+  readonly mode?: KnowledgeSearchMode;
+  readonly vectorLimit?: number;
+  readonly textLimit?: number;
+};
+type KnowledgeSearchMode = 'vector' | 'hybrid';
+type KnowledgeSearchScores = {
+  readonly vector?: number;
+  readonly text?: number;
+  readonly fused?: number;
+};
+type KnowledgeSearchResult = {
+  readonly chunk: KnowledgeChunk;
+  readonly score: number;
+  readonly document: KnowledgeDocument;
+  readonly context?: ReadonlyArray<KnowledgeChunk>;
+  readonly scores?: KnowledgeSearchScores;
+};
+type KnowledgeSearchContext = {
+  readonly query: string;
+  readonly results: ReadonlyArray<KnowledgeSearchResult>;
+  readonly text: string;
+};
+type KnowledgeSearcher = {
+  readonly search: (input: KnowledgeSearchInput) => Effect.Effect<ReadonlyArray<KnowledgeSearchResult>, KnowledgeSearchError>;
+};
+declare const packKnowledgeSearchContext: (query: string, results: ReadonlyArray<KnowledgeSearchResult>) => KnowledgeSearchContext;
+declare const fuseKnowledgeSearchResults: (input: {
+  readonly vectorResults: ReadonlyArray<KnowledgeSearchResult>;
+  readonly textResults: ReadonlyArray<KnowledgeSearchResult>;
+  readonly limit: number;
+  readonly rankConstant?: number;
+}) => ReadonlyArray<KnowledgeSearchResult>;
+declare const searchKnowledge: (input: KnowledgeSearchInput) => Effect.Effect<readonly KnowledgeSearchResult[], KnowledgeSearchError, SearchIndexStore | KnowledgeEmbedder>;
+//#endregion
+export { KnowledgeSearchContext, KnowledgeSearchInput, KnowledgeSearchMode, KnowledgeSearchResult, KnowledgeSearchScores, KnowledgeSearcher, fuseKnowledgeSearchResults, packKnowledgeSearchContext, searchKnowledge };
+//# sourceMappingURL=search.d.mts.map

package/dist/search.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.mts","names":[],"sources":["../src/search.ts"],"mappings":";;;;;;;KAMY,oBAAA;EAAA,SACD,KAAA,EAAO,oBAAA;EAAA,SACP,KAAA;EAAA,SACA,KAAA;EAAA,SACA,QAAA;EAAA,SACA,aAAA;EAAA,SACA,IAAA,GAAO,mBAAmB;EAAA,SAC1B,WAAA;EAAA,SACA,SAAA;AAAA;AAAA,KAGC,mBAAA;AAAA,KAEA,qBAAA;EAAA,SACD,MAAA;EAAA,SACA,IAAA;EAAA,SACA,KAAA;AAAA;AAAA,KAGC,qBAAA;EAAA,SACD,KAAA,EAAO,cAAA;EAAA,SACP,KAAA;EAAA,SACA,QAAA,EAAU,iBAAA;EAAA,SACV,OAAA,GAAU,aAAA,CAAc,cAAA;EAAA,SACxB,MAAA,GAAS,qBAAA;AAAA;AAAA,KAGR,sBAAA;EAAA,SACD,KAAA;EAAA,SACA,OAAA,EAAS,aAAa,CAAC,qBAAA;EAAA,SACvB,IAAA;AAAA;AAAA,KAGC,iBAAA;EAAA,SACD,MAAA,GACP,KAAA,EAAO,oBAAA,KACJ,MAAA,CAAO,MAAA,CAAO,aAAA,CAAc,qBAAA,GAAwB,oBAAA;AAAA;AAAA,cAM9C,0BAAA,GAA8B,KAAA,UAAe,OAAA,EAAS,aAAA,CAAc,qBAAA,MAAyB,sBAAA;AAAA,cAoB7F,0BAAA,GAA8B,KAAA;EAAA,SAChC,aAAA,EAAe,aAAA,CAAc,qBAAA;EAAA,SAC7B,WAAA,EAAa,aAAA,CAAc,qBAAA;EAAA,SAC3B,KAAA;EAAA,SACA,YAAA;AAAA,MACP,aAAA,CAAc,qBAAA;AAAA,cAsIL,eAAA,GAAmB,KAAA,EAAO,oBAAA,KAAoB,MAAA,CAAA,MAAA,UAAA,qBAAA,IAAA,oBAAA,EAAA,gBAAA,GAAA,iBAAA"}

package/dist/search.mjs

@@ -0,0 +1,179 @@
+import { KnowledgeSearchError } from "./errors.mjs";
+import { KnowledgeEmbedder } from "./embeddings.mjs";
+import { SearchIndexStore } from "./search-store.mjs";
+import { Effect } from "effect";
+//#region src/search.ts
+const packedResultText = (result) => result.context?.map((chunk) => chunk.content).join("\n\n") ?? result.chunk.content;
+const packKnowledgeSearchContext = (query, results) => ({
+	query,
+	results,
+	text: results.map(packedResultText).join("\n\n")
+});
+const scopeIds = (scope) => {
+	switch (scope._tag) {
+		case "KnowledgeCollection": return [scope.id];
+		case "KnowledgeCollections": return scope.ids;
+	}
+};
+const defaultHybridCandidateLimit = (limit) => Math.max(limit * 5, 40);
+const reciprocalRankFusionScore = (rank, rankConstant) => 1 / (rankConstant + rank);
+const fuseKnowledgeSearchResults = (input) => {
+	const rankConstant = input.rankConstant ?? 60;
+	const fused = /* @__PURE__ */ new Map();
+	const addResults = (results, kind) => {
+		results.forEach((result, index) => {
+			const rank = index + 1;
+			const previous = fused.get(result.chunk.id);
+			const nextFused = (previous?.fused ?? 0) + reciprocalRankFusionScore(rank, rankConstant);
+			fused.set(result.chunk.id, {
+				result: previous?.result ?? result,
+				vector: kind === "vector" ? result.score : previous?.vector,
+				text: kind === "text" ? result.score : previous?.text,
+				fused: nextFused
+			});
+		});
+	};
+	addResults(input.vectorResults, "vector");
+	addResults(input.textResults, "text");
+	return Array.from(fused.values()).sort((left, right) => right.fused - left.fused).slice(0, input.limit).map((item) => ({
+		...item.result,
+		score: item.fused,
+		scores: {
+			vector: item.vector,
+			text: item.text,
+			fused: item.fused
+		}
+	}));
+};
+const validateSearchInput = (input) => {
+	const query = input.query.trim();
+	const ids = scopeIds(input.scope);
+	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 textLimit = input.textLimit ?? defaultHybridCandidateLimit(limit);
+	if (query.length === 0) 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"
+	}));
+	if (!Number.isInteger(limit) || limit < 1) 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"
+	}));
+	if (!Number.isInteger(textLimit) || textLimit < 1) 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"
+	}));
+	if (!Number.isInteger(contextChunks) || contextChunks < 0) return Effect.fail(new KnowledgeSearchError({
+		message: "Context chunks must be zero or positive",
+		stage: "store"
+	}));
+	if (input.minScore !== void 0 && !Number.isFinite(input.minScore)) return Effect.fail(new KnowledgeSearchError({
+		message: "Search minScore must be finite",
+		stage: "store"
+	}));
+	return Effect.succeed({
+		query,
+		limit,
+		contextChunks,
+		mode,
+		vectorLimit,
+		textLimit
+	});
+};
+const searchVectorChunks = (input) => Effect.gen(function* () {
+	const store = yield* SearchIndexStore;
+	const embedding = yield* (yield* KnowledgeEmbedder).embedQuery(input.query).pipe(Effect.mapError((error) => new KnowledgeSearchError({
+		message: error.message,
+		stage: "embed",
+		cause: error
+	})));
+	return yield* store.searchChunks({
+		scope: input.scope,
+		embedding,
+		limit: input.limit,
+		minScore: input.minScore
+	}).pipe(Effect.mapError((error) => new KnowledgeSearchError({
+		message: error.message,
+		stage: "store",
+		cause: error
+	})));
+});
+const searchTextChunks = (input) => Effect.gen(function* () {
+	return yield* (yield* SearchIndexStore).searchChunksByText({
+		scope: input.scope,
+		query: input.query,
+		limit: input.limit
+	}).pipe(Effect.mapError((error) => new KnowledgeSearchError({
+		message: error.message,
+		stage: "store",
+		cause: error
+	})));
+});
+const searchKnowledge = (input) => Effect.gen(function* () {
+	const valid = yield* validateSearchInput(input);
+	yield* Effect.annotateCurrentSpan({
+		"knowledge_search.query_length": valid.query.length,
+		"knowledge_search.limit": valid.limit,
+		"knowledge_search.mode": valid.mode,
+		"knowledge_search.context_chunks": valid.contextChunks,
+		"knowledge_search.scope_count": scopeIds(input.scope).length
+	});
+	const store = yield* SearchIndexStore;
+	const results = 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;
+	return yield* Effect.forEach(results, (result) => store.getContextChunks({
+		collectionId: result.chunk.collectionId,
+		documentId: result.chunk.documentId,
+		position: result.chunk.position,
+		contextChunks: valid.contextChunks
+	}).pipe(Effect.map((context) => ({
+		...result,
+		context
+	})), Effect.mapError((error) => new KnowledgeSearchError({
+		message: error.message,
+		stage: "store",
+		cause: error
+	}))));
+}).pipe(Effect.withSpan("knowledge_search.search"));
+//#endregion
+export { fuseKnowledgeSearchResults, packKnowledgeSearchContext, searchKnowledge };
+
+//# sourceMappingURL=search.mjs.map

package/dist/search.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.mjs","names":[],"sources":["../src/search.ts"],"sourcesContent":["import { Effect } from 'effect'\nimport type { KnowledgeChunk, KnowledgeDocument, KnowledgeSearchScope } from './documents.ts'\nimport { KnowledgeEmbedder } from './embeddings.ts'\nimport { KnowledgeSearchError } from './errors.ts'\nimport { SearchIndexStore } from './search-store.ts'\n\nexport type KnowledgeSearchInput = {\n  readonly scope: KnowledgeSearchScope\n  readonly query: string\n  readonly limit?: number\n  readonly minScore?: number\n  readonly contextChunks?: number\n  readonly mode?: KnowledgeSearchMode\n  readonly vectorLimit?: number\n  readonly textLimit?: number\n}\n\nexport type KnowledgeSearchMode = 'vector' | 'hybrid'\n\nexport type KnowledgeSearchScores = {\n  readonly vector?: number\n  readonly text?: number\n  readonly fused?: number\n}\n\nexport type KnowledgeSearchResult = {\n  readonly chunk: KnowledgeChunk\n  readonly score: number\n  readonly document: KnowledgeDocument\n  readonly context?: ReadonlyArray<KnowledgeChunk>\n  readonly scores?: KnowledgeSearchScores\n}\n\nexport type KnowledgeSearchContext = {\n  readonly query: string\n  readonly results: ReadonlyArray<KnowledgeSearchResult>\n  readonly text: string\n}\n\nexport type KnowledgeSearcher = {\n  readonly search: (\n    input: KnowledgeSearchInput\n  ) => Effect.Effect<ReadonlyArray<KnowledgeSearchResult>, KnowledgeSearchError>\n}\n\nconst packedResultText = (result: KnowledgeSearchResult) =>\n  result.context?.map(chunk => chunk.content).join('\\n\\n') ?? result.chunk.content\n\nexport const packKnowledgeSearchContext = (query: string, results: ReadonlyArray<KnowledgeSearchResult>): KnowledgeSearchContext =>\n  ({\n    query,\n    results,\n    text: results.map(packedResultText).join('\\n\\n')\n  })\n\nconst scopeIds = (scope: KnowledgeSearchScope): ReadonlyArray<string> => {\n  switch (scope._tag) {\n    case 'KnowledgeCollection':\n      return [scope.id]\n    case 'KnowledgeCollections':\n      return scope.ids\n  }\n}\n\nconst defaultHybridCandidateLimit = (limit: number) => Math.max(limit * 5, 40)\n\nconst reciprocalRankFusionScore = (rank: number, rankConstant: number) => 1 / (rankConstant + rank)\n\nexport const fuseKnowledgeSearchResults = (input: {\n  readonly vectorResults: ReadonlyArray<KnowledgeSearchResult>\n  readonly textResults: ReadonlyArray<KnowledgeSearchResult>\n  readonly limit: number\n  readonly rankConstant?: number\n}): ReadonlyArray<KnowledgeSearchResult> => {\n  const rankConstant = input.rankConstant ?? 60\n  const fused = new Map<\n    string,\n    {\n      readonly result: KnowledgeSearchResult\n      readonly vector?: number\n      readonly text?: number\n      readonly fused: number\n    }\n  >()\n\n  const addResults = (results: ReadonlyArray<KnowledgeSearchResult>, kind: 'vector' | 'text') => {\n    results.forEach((result, index) => {\n      const rank = index + 1\n      const previous = fused.get(result.chunk.id)\n      const nextFused = (previous?.fused ?? 0) + reciprocalRankFusionScore(rank, rankConstant)\n      fused.set(result.chunk.id, {\n        result: previous?.result ?? result,\n        vector: kind === 'vector' ? result.score : previous?.vector,\n        text: kind === 'text' ? result.score : previous?.text,\n        fused: nextFused\n      })\n    })\n  }\n\n  addResults(input.vectorResults, 'vector')\n  addResults(input.textResults, 'text')\n\n  return Array.from(fused.values())\n    .sort((left, right) => right.fused - left.fused)\n    .slice(0, input.limit)\n    .map(item => ({\n      ...item.result,\n      score: item.fused,\n      scores: { vector: item.vector, text: item.text, fused: item.fused }\n    }))\n}\n\nconst validateSearchInput = (input: KnowledgeSearchInput) => {\n  const query = input.query.trim()\n  const ids = scopeIds(input.scope)\n  const limit = input.limit ?? 10\n  const contextChunks = input.contextChunks ?? 0\n  const mode = input.mode ?? 'hybrid'\n  const vectorLimit = input.vectorLimit ?? (mode === 'hybrid' ? defaultHybridCandidateLimit(limit) : limit)\n  const textLimit = input.textLimit ?? defaultHybridCandidateLimit(limit)\n\n  if (query.length === 0) {\n    return Effect.fail(new KnowledgeSearchError({ message: 'Search query is empty', stage: 'embed' }))\n  }\n\n  if (ids.length === 0) {\n    return Effect.fail(new KnowledgeSearchError({ message: 'Search scope is empty', stage: 'store' }))\n  }\n\n  if (!Number.isInteger(limit) || limit < 1) {\n    return Effect.fail(new KnowledgeSearchError({ message: 'Search limit must be positive', stage: 'store' }))\n  }\n\n  if (!Number.isInteger(vectorLimit) || vectorLimit < 1) {\n    return Effect.fail(new KnowledgeSearchError({ message: 'Vector search limit must be positive', stage: 'store' }))\n  }\n\n  if (!Number.isInteger(textLimit) || textLimit < 1) {\n    return Effect.fail(new KnowledgeSearchError({ message: 'Text search limit must be positive', stage: 'store' }))\n  }\n\n  if (mode !== 'vector' && mode !== 'hybrid') {\n    return Effect.fail(new KnowledgeSearchError({ message: 'Search mode is invalid', stage: 'store' }))\n  }\n\n  if (!Number.isInteger(contextChunks) || contextChunks < 0) {\n    return Effect.fail(\n      new KnowledgeSearchError({ message: 'Context chunks must be zero or positive', stage: 'store' })\n    )\n  }\n\n  if (input.minScore !== undefined && !Number.isFinite(input.minScore)) {\n    return Effect.fail(\n      new KnowledgeSearchError({ message: 'Search minScore must be finite', stage: 'store' })\n    )\n  }\n\n  return Effect.succeed({ query, limit, contextChunks, mode, vectorLimit, textLimit })\n}\n\nconst searchVectorChunks = (input: {\n  readonly scope: KnowledgeSearchScope\n  readonly query: string\n  readonly limit: number\n  readonly minScore?: number\n}) =>\n  Effect.gen(function* () {\n    const store = yield* SearchIndexStore\n    const embedder = yield* KnowledgeEmbedder\n    const embedding = yield* embedder\n      .embedQuery(input.query)\n      .pipe(\n        Effect.mapError(\n          error => new KnowledgeSearchError({ message: error.message, stage: 'embed', cause: error })\n        )\n      )\n\n    return yield* store\n      .searchChunks({\n        scope: input.scope,\n        embedding,\n        limit: input.limit,\n        minScore: input.minScore\n      })\n      .pipe(\n        Effect.mapError(\n          error => new KnowledgeSearchError({ message: error.message, stage: 'store', cause: error })\n        )\n      )\n  })\n\nconst searchTextChunks = (input: {\n  readonly scope: KnowledgeSearchScope\n  readonly query: string\n  readonly limit: number\n}) =>\n  Effect.gen(function* () {\n    const store = yield* SearchIndexStore\n    return yield* store\n      .searchChunksByText({ scope: input.scope, query: input.query, limit: input.limit })\n      .pipe(\n        Effect.mapError(\n          error => new KnowledgeSearchError({ message: error.message, stage: 'store', cause: error })\n        )\n      )\n  })\n\nexport const searchKnowledge = (input: KnowledgeSearchInput) =>\n  Effect.gen(function* () {\n    const valid = yield* validateSearchInput(input)\n    yield* Effect.annotateCurrentSpan({\n      'knowledge_search.query_length': valid.query.length,\n      'knowledge_search.limit': valid.limit,\n      'knowledge_search.mode': valid.mode,\n      'knowledge_search.context_chunks': valid.contextChunks,\n      'knowledge_search.scope_count': scopeIds(input.scope).length\n    })\n    const store = yield* SearchIndexStore\n    const results: ReadonlyArray<KnowledgeSearchResult> = valid.mode === 'vector'\n      ? yield* searchVectorChunks({\n        scope: input.scope,\n        query: valid.query,\n        limit: valid.vectorLimit,\n        minScore: input.minScore\n      })\n      : yield* Effect.gen(function* () {\n        const searches = yield* Effect.all(\n          {\n            vectorResults: searchVectorChunks({\n              scope: input.scope,\n              query: valid.query,\n              limit: valid.vectorLimit,\n              minScore: input.minScore\n            }),\n            textResults: searchTextChunks({\n              scope: input.scope,\n              query: valid.query,\n              limit: valid.textLimit\n            })\n          },\n          { concurrency: 'unbounded' }\n        )\n\n        return fuseKnowledgeSearchResults({\n          vectorResults: searches.vectorResults,\n          textResults: searches.textResults,\n          limit: valid.limit\n        })\n      })\n\n    if (valid.contextChunks === 0) {\n      return results\n    }\n\n    return yield* Effect.forEach(results, result =>\n      store\n        .getContextChunks({\n          collectionId: result.chunk.collectionId,\n          documentId: result.chunk.documentId,\n          position: result.chunk.position,\n          contextChunks: valid.contextChunks\n        })\n        .pipe(\n          Effect.map(context => ({ ...result, context })),\n          Effect.mapError(\n            error => new KnowledgeSearchError({ message: error.message, stage: 'store', cause: error })\n          )\n        )\n    )\n  }).pipe(Effect.withSpan('knowledge_search.search'))\n"],"mappings":"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"}

package/dist/store.d.mts

@@ -0,0 +1,44 @@
+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 { Context, Effect } from "effect";
+
+//#region src/store.d.ts
+type GetKnowledgeRecordInput = {
+  readonly scope: KnowledgeScope;
+  readonly id: string;
+};
+type ListKnowledgeRecordsInput = {
+  readonly scope: KnowledgeScope;
+  readonly limit: number;
+};
+type ListKnowledgeRecordsResult = {
+  readonly records: ReadonlyArray<KnowledgeRecord>;
+};
+type ListPinnedKnowledgeInput = {
+  readonly scope: KnowledgeScope;
+  readonly limit: number;
+};
+type ListPinnedKnowledgeResult = {
+  readonly records: ReadonlyArray<KnowledgeRecord>;
+  readonly representations: ReadonlyArray<KnowledgeRepresentation>;
+};
+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>;
+};
+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 };
+//# sourceMappingURL=store.d.mts.map