@yolk-sdk/knowledge 0.1.0-canary.29 → 0.1.0-canary.31

package/README.md

@@ -1,6 +1,6 @@
 # @yolk-sdk/knowledge
 
-Domain-free knowledge record, artifact, representation, search, provenance, link, store, and context contracts.
+Simple durable knowledge documents for agents: pinned, searchable, or archived.
 
 ## Install
 
@@ -10,98 +10,77 @@ pnpm add @yolk-sdk/knowledge@canary @yolk-sdk/agent@canary effect
 
 Canary APIs are unstable. Keep all `@yolk-sdk/*` packages on the same version.
 
+## Model
+
+```txt
+KnowledgeDocument
+  id
+  slug
+  title
+  purpose
+  origin
+  content
+  summary?
+  status: processing | ready | error
+  availability: pinned | searchable | archived
+```
+
+- `pinned`: host may inject into startup context and search.
+- `searchable`: host may expose through search tools.
+- `archived`: retained, normally omitted from prompt and search.
+
+Optional files and chunks are modeled as `KnowledgeFile` and `KnowledgeChunk`.
+
 ## Subpaths
 
 | Subpath | Purpose |
 | --- | --- |
-| `@yolk-sdk/knowledge` | Root context/store/artifact/error helpers |
-| `@yolk-sdk/knowledge/records` | Knowledge record schemas and roles |
-| `@yolk-sdk/knowledge/artifacts` | Artifact catalog and blob-store contract |
-| `@yolk-sdk/knowledge/representations` | Agent-readable/searchable representations |
-| `@yolk-sdk/knowledge/chunking` | Search chunker contracts and defaults |
+| `@yolk-sdk/knowledge` | Root context/store/file/error helpers |
+| `@yolk-sdk/knowledge/documents` | Document, file, chunk, status, availability, and scope schemas |
+| `@yolk-sdk/knowledge/files` | File blob-store contract |
+| `@yolk-sdk/knowledge/store` | Document store and search-index store contracts |
+| `@yolk-sdk/knowledge/context` | Pinned context builder |
+| `@yolk-sdk/knowledge/chunking` | Text chunker contracts and defaults |
 | `@yolk-sdk/knowledge/embeddings` | Embedder contract and vector types |
-| `@yolk-sdk/knowledge/errors` | Shared knowledge error types |
-| `@yolk-sdk/knowledge/extraction` | Loaded source/extractor contract |
-| `@yolk-sdk/knowledge/ingestion` | Generic search ingestion pipeline |
-| `@yolk-sdk/knowledge/search` | Search interface, hybrid search, context packing |
-| `@yolk-sdk/knowledge/documents` | Collection, document, chunk, and search scope schemas |
-| `@yolk-sdk/knowledge/search-store` | Collection/document/chunk/search lifecycle store |
-| `@yolk-sdk/knowledge/vector-store` | Compatibility aliases for vector search/store types |
+| `@yolk-sdk/knowledge/extraction` | Source/extractor contract |
+| `@yolk-sdk/knowledge/ingestion` | Search chunk ingestion helper |
+| `@yolk-sdk/knowledge/search` | Vector/hybrid chunk search helpers |
 | `@yolk-sdk/knowledge/summarization` | Optional title/summary service contract |
-| `@yolk-sdk/knowledge/provenance` | Source/provenance metadata |
-| `@yolk-sdk/knowledge/links` | Typed links between records |
-| `@yolk-sdk/knowledge/store` | Knowledge store lifecycle contract |
-| `@yolk-sdk/knowledge/context` | Context assembly helpers |
-| `@yolk-sdk/knowledge/agent` | Agent-facing helper contracts |
+| `@yolk-sdk/knowledge/agent` | `knowledge_lookup` and `knowledge_manage` tool factories |
+| `@yolk-sdk/knowledge/errors` | Shared error types |
 
 ## Imports
 
 ```ts
 import { buildKnowledgeContext, KnowledgeStore } from '@yolk-sdk/knowledge'
-import type { KnowledgeRecord } from '@yolk-sdk/knowledge/records'
-import { KnowledgeArtifactStore } from '@yolk-sdk/knowledge/artifacts'
-import { makeDefaultKnowledgeChunker } from '@yolk-sdk/knowledge/chunking'
-import { searchKnowledge } from '@yolk-sdk/knowledge/search'
+import type { KnowledgeDocument } from '@yolk-sdk/knowledge/documents'
+import { KnowledgeFileBlobStore } from '@yolk-sdk/knowledge/files'
+import { makeKnowledgeLookupTool, makeKnowledgeManageTool } from '@yolk-sdk/knowledge/agent'
 ```
 
-## Migration
-
-Search APIs use canonical search naming. Removed retrieval APIs are intentionally not backward-compatible.
+## Use pinned knowledge as context
 
-| Removed | Use |
-| --- | --- |
-| Retrieval subpath | `@yolk-sdk/knowledge/search` |
-| `KnowledgeRetriever` | `KnowledgeSearcher` |
-| `retrieve(input)` | `search(input)` |
-| `KnowledgeRetrievalError` | `KnowledgeSearchError` |
+```ts
+import { buildKnowledgeContext } from '@yolk-sdk/knowledge/context'
 
-## Glossary
+const context = buildKnowledgeContext({
+  documents,
+  maxCharacters: 6000
+})
+```
 
-| Term | Meaning |
-| --- | --- |
-| Knowledge record | Stable logical thing an agent can know about. Domain-free; hosts decide product meaning. |
-| Artifact | Stored source/blob attached to knowledge, such as a file or captured output. |
-| Representation | Agent-readable or searchable form of knowledge, usually text plus metadata. |
-| Provenance | Source metadata explaining where knowledge came from and how it was produced. |
-| Link | Typed relationship between knowledge records. |
-| Context | Model-ready knowledge selected for a run. Built from host policy. |
-| Context policy | Host intent for use: `pinned`, `routable`, `searchable`, or `archived`. |
-| Search index | Searchable corpus built from source documents, chunks, embeddings, and metadata. |
-| Collection | Named searchable document group with shared embedding and chunking config. |
-| Document | Source item tracked through search ingestion: pending, processing, ready, or error. |
-| Source | Document origin: file ref, URL, or raw text. |
-| Chunk | Searchable slice of a document with position and token count. |
-| Embedding | Numeric vector for semantic search. Hosts provide the embedding provider. |
-| Chunker | Service that splits extracted text into chunks. |
-| Extractor | Service that loads source content into text/title/summary/metadata. |
-| Ingestion | Pipeline that extracts, chunks, embeds, stores chunks, and marks document status. |
-| Search | Query-time search over search chunks, optionally packed into context text. |
-| Hybrid search | Search mode that fuses vector and text search rankings. |
-| Search scope | Caller-provided collection or collections to search. Package does not interpret tenant semantics. |
-| Search index store | Persistence contract for collections, documents, chunks, status, and search. |
-| Vector store | Compatibility naming over search-store chunk search contracts. |
-| Knowledge store | Persistence contract for non-index knowledge records and context assembly. |
-| Artifact store | Persistence contract for artifact bytes/metadata. |
-| Host | App using the package; owns auth, DB, object storage, providers, permissions, and policy. |
-
-## Context policy
-
-| Policy | Meaning |
-| --- | --- |
-| `pinned` | Host may inject into model startup context |
-| `routable` | Host may use for routing/dispatch decisions |
-| `searchable` | Host may expose through search tools |
-| `archived` | Retained but normally omitted from active context/search |
+Add the resulting text to your system prompt. Your app chooses which documents are pinned.
 
 ## Host responsibilities
 
-- Own users, teams, permissions, routing, and product policy.
-- Implement `KnowledgeStore` and `KnowledgeArtifactStore` with app storage.
-- Own concrete extraction, embeddings, search ingestion, R2/S3 layout, and DB schema.
-- Decide which knowledge is pinned, searchable, routable, or archived.
+- Own users, workspaces, permissions, routing, and product policy.
+- Implement `KnowledgeStore` with app storage.
+- Implement `KnowledgeFileBlobStore` with R2/S3/blob storage when files are needed.
+- Own concrete extraction, embeddings, search SQL/vector storage, and upload URLs.
+- Keep slug uniqueness scoped to the host boundary.
 
 ## Boundaries
 
 - No app auth, DB drivers, object storage SDKs, React, Next.js, or provider SDKs.
-- Search/chunking APIs are exposed as flat knowledge subpaths; concrete stores and providers remain app-owned.
-- Package owns semantics and contracts only.
+- Package owns simple schemas, contracts, context formatting, tool factories, chunking, and search helpers.
+- Host owns all IO and policy.

package/dist/agent.d.mts

@@ -1,26 +1,72 @@
-import { KnowledgeScope } from "./records.mjs";
-import { KnowledgeSearchScope } from "./documents.mjs";
-import { KnowledgeSearcher } from "./search.mjs";
+import { KnowledgeAvailability, KnowledgeDocument } from "./documents.mjs";
 import { Effect } from "effect";
 import { ToolError } from "@yolk-sdk/agent/loop";
 import { ToolRegistration } from "@yolk-sdk/agent/tools";
 
 //#region src/agent.d.ts
-type ResolveKnowledgeScope<Context> = (context: Context) => KnowledgeScope;
-type KnowledgeAgentContextOptions = {
-  readonly maxPinnedContextCharacters: number;
+type KnowledgeTarget = {
+  readonly slug: string;
+  readonly scope?: string;
 };
-declare const defaultKnowledgeAgentContextOptions: KnowledgeAgentContextOptions;
-type KnowledgeSearchToolScopeResolver<Context> = KnowledgeSearchScope | ((context: Context) => Effect.Effect<KnowledgeSearchScope, ToolError>);
-type MakeKnowledgeSearchToolOptions<Context> = {
-  readonly scope: KnowledgeSearchToolScopeResolver<Context>;
+type KnowledgeLookupResult = {
+  readonly document: KnowledgeDocument;
+  readonly score?: number;
+  readonly context?: ReadonlyArray<{
+    readonly content: string;
+  }>;
+};
+type KnowledgeSavedDocument = {
+  readonly id: string;
+  readonly slug: string;
+  readonly title: string;
+};
+type KnowledgeLookupHandlers<Context> = {
+  readonly search: (input: {
+    readonly context: Context;
+    readonly query: string;
+    readonly limit?: number;
+    readonly minScore?: number;
+    readonly contextChunks?: number;
+  }) => Effect.Effect<ReadonlyArray<KnowledgeLookupResult>, ToolError>;
+  readonly get: (input: {
+    readonly context: Context;
+    readonly id?: string;
+    readonly target?: KnowledgeTarget;
+  }) => Effect.Effect<KnowledgeDocument, ToolError>;
+};
+type KnowledgeManageHandlers<Context> = {
+  readonly upsert: (input: {
+    readonly context: Context;
+    readonly target: KnowledgeTarget;
+    readonly title: string;
+    readonly purpose: string;
+    readonly origin: string;
+    readonly content: string;
+    readonly availability: KnowledgeAvailability;
+  }) => Effect.Effect<KnowledgeSavedDocument, ToolError>;
+  readonly setAvailability: (input: {
+    readonly context: Context;
+    readonly target: KnowledgeTarget;
+    readonly availability: KnowledgeAvailability;
+  }) => Effect.Effect<KnowledgeSavedDocument, ToolError>;
+  readonly renameSlug: (input: {
+    readonly context: Context;
+    readonly target: KnowledgeTarget;
+    readonly nextSlug: string;
+  }) => Effect.Effect<KnowledgeSavedDocument, ToolError>;
+  readonly delete: (input: {
+    readonly context: Context;
+    readonly target: KnowledgeTarget;
+  }) => Effect.Effect<KnowledgeSavedDocument, ToolError>;
+};
+declare const makeKnowledgeLookupTool: <Context>(handlers: KnowledgeLookupHandlers<Context>, options?: {
   readonly name?: string;
   readonly description?: string;
-  readonly limit?: number;
-  readonly minScore?: number;
-  readonly contextChunks?: number;
-};
-declare const makeKnowledgeSearchTool: <Context>(searcher: KnowledgeSearcher, options: MakeKnowledgeSearchToolOptions<Context>) => ToolRegistration<Context>;
+}) => ToolRegistration<Context>;
+declare const makeKnowledgeManageTool: <Context>(handlers: KnowledgeManageHandlers<Context>, options?: {
+  readonly name?: string;
+  readonly description?: string;
+}) => ToolRegistration<Context>;
 //#endregion
-export { KnowledgeAgentContextOptions, KnowledgeSearchToolScopeResolver, MakeKnowledgeSearchToolOptions, ResolveKnowledgeScope, defaultKnowledgeAgentContextOptions, makeKnowledgeSearchTool };
+export { KnowledgeLookupHandlers, KnowledgeLookupResult, KnowledgeManageHandlers, KnowledgeSavedDocument, KnowledgeTarget, makeKnowledgeLookupTool, makeKnowledgeManageTool };
 //# sourceMappingURL=agent.d.mts.map

package/dist/agent.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.mts","names":[],"sources":["../src/agent.ts"],"mappings":";;;;;;;;KAUY,qBAAA,aAAkC,OAAA,EAAS,OAAA,KAAY,cAAc;AAAA,KAErE,4BAAA;EAAA,SACD,0BAA0B;AAAA;AAAA,cAGxB,mCAAA,EAAqC,4BAEjD;AAAA,KAWW,gCAAA,YACR,oBAAA,KACE,OAAA,EAAS,OAAA,KAAY,MAAA,CAAO,MAAA,CAAO,oBAAA,EAAsB,SAAA;AAAA,KAEnD,8BAAA;EAAA,SACD,KAAA,EAAO,gCAAgC,CAAC,OAAA;EAAA,SACxC,IAAA;EAAA,SACA,WAAA;EAAA,SACA,KAAA;EAAA,SACA,QAAA;EAAA,SACA,aAAA;AAAA;AAAA,cAWE,uBAAA,YACX,QAAA,EAAU,iBAAA,EACV,OAAA,EAAS,8BAAA,CAA+B,OAAA,MACvC,gBAAA,CAAiB,OAAA"}
+{"version":3,"file":"agent.d.mts","names":[],"sources":["../src/agent.ts"],"mappings":";;;;;;KAiEY,eAAA;EAAA,SACD,IAAA;EAAA,SACA,KAAK;AAAA;AAAA,KAGJ,qBAAA;EAAA,SACD,QAAA,EAAU,iBAAA;EAAA,SACV,KAAA;EAAA,SACA,OAAA,GAAU,aAAa;IAAA,SAAY,OAAA;EAAA;AAAA;AAAA,KAGlC,sBAAA;EAAA,SACD,EAAA;EAAA,SACA,IAAA;EAAA,SACA,KAAA;AAAA;AAAA,KAGC,uBAAA;EAAA,SACD,MAAA,GAAS,KAAA;IAAA,SACP,OAAA,EAAS,OAAA;IAAA,SACT,KAAA;IAAA,SACA,KAAA;IAAA,SACA,QAAA;IAAA,SACA,aAAA;EAAA,MACL,MAAA,CAAO,MAAA,CAAO,aAAA,CAAc,qBAAA,GAAwB,SAAA;EAAA,SACjD,GAAA,GAAM,KAAA;IAAA,SACJ,OAAA,EAAS,OAAA;IAAA,SACT,EAAA;IAAA,SACA,MAAA,GAAS,eAAA;EAAA,MACd,MAAA,CAAO,MAAA,CAAO,iBAAA,EAAmB,SAAA;AAAA;AAAA,KAG7B,uBAAA;EAAA,SACD,MAAA,GAAS,KAAA;IAAA,SACP,OAAA,EAAS,OAAA;IAAA,SACT,MAAA,EAAQ,eAAA;IAAA,SACR,KAAA;IAAA,SACA,OAAA;IAAA,SACA,MAAA;IAAA,SACA,OAAA;IAAA,SACA,YAAA,EAAc,qBAAA;EAAA,MACnB,MAAA,CAAO,MAAA,CAAO,sBAAA,EAAwB,SAAA;EAAA,SACnC,eAAA,GAAkB,KAAA;IAAA,SAChB,OAAA,EAAS,OAAA;IAAA,SACT,MAAA,EAAQ,eAAA;IAAA,SACR,YAAA,EAAc,qBAAA;EAAA,MACnB,MAAA,CAAO,MAAA,CAAO,sBAAA,EAAwB,SAAA;EAAA,SACnC,UAAA,GAAa,KAAA;IAAA,SACX,OAAA,EAAS,OAAA;IAAA,SACT,MAAA,EAAQ,eAAA;IAAA,SACR,QAAA;EAAA,MACL,MAAA,CAAO,MAAA,CAAO,sBAAA,EAAwB,SAAA;EAAA,SACnC,MAAA,GAAS,KAAA;IAAA,SACP,OAAA,EAAS,OAAA;IAAA,SACT,MAAA,EAAQ,eAAA;EAAA,MACb,MAAA,CAAO,MAAA,CAAO,sBAAA,EAAwB,SAAA;AAAA;AAAA,cAoDjC,uBAAA,YACX,QAAA,EAAU,uBAAA,CAAwB,OAAA,GAClC,OAAA;EAAA,SAAoB,IAAA;EAAA,SAAwB,WAAA;AAAA,MAC3C,gBAAA,CAAiB,OAAA;AAAA,cAmCP,uBAAA,YACX,QAAA,EAAU,uBAAA,CAAwB,OAAA,GAClC,OAAA;EAAA,SAAoB,IAAA;EAAA,SAAwB,WAAA;AAAA,MAC3C,gBAAA,CAAiB,OAAA"}

package/dist/agent.mjs

@@ -1,45 +1,186 @@
-import { packKnowledgeSearchContext } from "./search.mjs";
+import { KnowledgeAvailabilitySchema, NonEmptyTrimmedString } from "./documents.mjs";
 import { Effect } from "effect";
-import * as Schema$1 from "effect/Schema";
+import * as Schema from "effect/Schema";
 import { ToolError } from "@yolk-sdk/agent/loop";
 import { ToolResult } from "@yolk-sdk/agent/protocol";
 import { makeTool } from "@yolk-sdk/agent/tools";
 //#region src/agent.ts
-const defaultKnowledgeAgentContextOptions = { maxPinnedContextCharacters: 6e3 };
-const KnowledgeSearchToolParams = Schema$1.Struct({ query: Schema$1.Trimmed.pipe(Schema$1.check(Schema$1.isNonEmpty()), Schema$1.annotate({ description: "Search query for the configured knowledge search." })) });
-const isToolError = Schema$1.is(ToolError);
-const resolveScope = (resolver, context) => {
-	if (typeof resolver === "function") return resolver(context);
-	return Effect.succeed(resolver);
+const OptionalNonEmptyTrimmedString = Schema.optional(Schema.NullOr(NonEmptyTrimmedString));
+const OptionalNumber = Schema.optional(Schema.NullOr(Schema.Number));
+const KnowledgeTargetParamsSchema = Schema.Struct({
+	slug: NonEmptyTrimmedString,
+	scope: OptionalNonEmptyTrimmedString
+});
+const KnowledgeLookupParams = Schema.Union([Schema.Struct({
+	operation: Schema.Literal("search"),
+	query: NonEmptyTrimmedString,
+	limit: OptionalNumber,
+	minScore: OptionalNumber,
+	contextChunks: OptionalNumber
+}), Schema.Struct({
+	operation: Schema.Literal("get"),
+	id: OptionalNonEmptyTrimmedString,
+	target: Schema.optional(Schema.NullOr(KnowledgeTargetParamsSchema))
+})]);
+const KnowledgeManageParams = Schema.Union([
+	Schema.Struct({
+		operation: Schema.Literal("upsert"),
+		target: KnowledgeTargetParamsSchema,
+		title: NonEmptyTrimmedString,
+		purpose: NonEmptyTrimmedString,
+		origin: NonEmptyTrimmedString,
+		content: NonEmptyTrimmedString,
+		availability: KnowledgeAvailabilitySchema
+	}),
+	Schema.Struct({
+		operation: Schema.Literal("set_availability"),
+		target: KnowledgeTargetParamsSchema,
+		availability: KnowledgeAvailabilitySchema
+	}),
+	Schema.Struct({
+		operation: Schema.Literal("rename_slug"),
+		target: KnowledgeTargetParamsSchema,
+		nextSlug: NonEmptyTrimmedString
+	}),
+	Schema.Struct({
+		operation: Schema.Literal("delete"),
+		target: KnowledgeTargetParamsSchema
+	})
+]);
+const unknownToMessage = (error) => error instanceof Error ? error.message : String(error);
+const optionalValue = (value) => value ?? void 0;
+const targetFromParams = (target) => target.scope === null || target.scope === void 0 ? { slug: target.slug } : {
+	slug: target.slug,
+	scope: target.scope
 };
-const makeKnowledgeSearchTool = (searcher, options) => {
+const optionalTargetFromParams = (target) => target === null || target === void 0 ? void 0 : targetFromParams(target);
+const formatDocument = (document) => [
+	`# ${document.title}`,
+	`document_id: ${document.id}`,
+	`slug: ${document.slug}`,
+	`purpose: ${document.purpose}`,
+	`origin: ${document.origin}`,
+	`availability: ${document.availability}`,
+	`status: ${document.status}`,
+	"",
+	document.content
+].join("\n");
+const formatSearchResults = (results) => results.length === 0 ? "No knowledge matches found." : results.map((result) => [
+	`## ${result.document.title}`,
+	`document_id: ${result.document.id}`,
+	`slug: ${result.document.slug}`,
+	`purpose: ${result.document.purpose}`,
+	`origin: ${result.document.origin}`,
+	`availability: ${result.document.availability}`,
+	result.score === void 0 ? void 0 : `score: ${result.score}`,
+	"",
+	result.context?.map((chunk) => chunk.content).join("\n\n") ?? result.document.content
+].filter((line) => line !== void 0).join("\n")).join("\n\n");
+const formatSaved = (verb, document) => [
+	verb,
+	`title: ${document.title}`,
+	`slug: ${document.slug}`,
+	`document_id: ${document.id}`
+].join("\n");
+const makeKnowledgeLookupTool = (handlers, options = {}) => {
 	return makeTool({
-		name: options.name ?? "search_knowledge",
-		description: options.description ?? "Search the configured knowledge search.",
-		parameters: KnowledgeSearchToolParams,
+		name: options.name ?? "knowledge_lookup",
+		description: options.description ?? "Look up durable knowledge. Search for semantic discovery; get when document_id or slug is known.",
+		parameters: KnowledgeLookupParams,
 		access: "read",
-		invalidParamsMessage: (error) => error instanceof Error ? error.message : String(error),
-		execute: (input) => resolveScope(options.scope, input.context).pipe(Effect.flatMap((scope) => searcher.search({
-			scope,
-			query: input.params.query,
-			limit: options.limit,
-			minScore: options.minScore,
-			contextChunks: options.contextChunks
-		})), Effect.map((results) => packKnowledgeSearchContext(input.params.query, results)), Effect.map((context) => ToolResult.make({
-			toolCallId: input.call.id,
-			content: context.text,
-			structuredContent: context
-		})), Effect.mapError((error) => {
-			if (isToolError(error)) return error;
-			return new ToolError({
-				tool: input.call.name,
-				message: error.message,
-				cause: "execution"
+		invalidParamsMessage: (error) => `Invalid knowledge lookup arguments: ${unknownToMessage(error)}`,
+		execute: ({ call, context, params }) => Effect.gen(function* () {
+			if (params.operation === "search") {
+				const results = yield* handlers.search({
+					context,
+					query: params.query,
+					limit: optionalValue(params.limit),
+					minScore: optionalValue(params.minScore),
+					contextChunks: optionalValue(params.contextChunks)
+				});
+				return ToolResult.make({
+					toolCallId: call.id,
+					content: formatSearchResults(results)
+				});
+			}
+			const document = yield* handlers.get({
+				context,
+				id: optionalValue(params.id),
+				target: optionalTargetFromParams(params.target)
 			});
-		}))
+			return ToolResult.make({
+				toolCallId: call.id,
+				content: formatDocument(document)
+			});
+		})
+	});
+};
+const makeKnowledgeManageTool = (handlers, options = {}) => {
+	return makeTool({
+		name: options.name ?? "knowledge_manage",
+		description: options.description ?? "Create, replace, pin, archive, rename, or delete durable knowledge. Use only when explicitly asked.",
+		parameters: KnowledgeManageParams,
+		access: "write",
+		invalidParamsMessage: (error) => `Invalid knowledge manage arguments: ${unknownToMessage(error)}`,
+		execute: ({ call, context, params }) => Effect.gen(function* () {
+			switch (params.operation) {
+				case "upsert": {
+					const document = yield* handlers.upsert({
+						context,
+						target: targetFromParams(params.target),
+						title: params.title,
+						purpose: params.purpose,
+						origin: params.origin,
+						content: params.content,
+						availability: params.availability
+					});
+					return ToolResult.make({
+						toolCallId: call.id,
+						content: formatSaved("Knowledge upserted", document)
+					});
+				}
+				case "set_availability": {
+					const document = yield* handlers.setAvailability({
+						context,
+						target: targetFromParams(params.target),
+						availability: params.availability
+					});
+					return ToolResult.make({
+						toolCallId: call.id,
+						content: formatSaved("Knowledge availability updated", document)
+					});
+				}
+				case "rename_slug": {
+					const document = yield* handlers.renameSlug({
+						context,
+						target: targetFromParams(params.target),
+						nextSlug: params.nextSlug
+					});
+					return ToolResult.make({
+						toolCallId: call.id,
+						content: formatSaved("Knowledge slug renamed", document)
+					});
+				}
+				case "delete": {
+					const document = yield* handlers.delete({
+						context,
+						target: targetFromParams(params.target)
+					});
+					return ToolResult.make({
+						toolCallId: call.id,
+						content: formatSaved("Knowledge deleted", document)
+					});
+				}
+			}
+			return yield* Effect.fail(new ToolError({
+				tool: call.name,
+				message: "Unsupported knowledge operation",
+				cause: "validation"
+			}));
+		})
 	});
 };
 //#endregion
-export { defaultKnowledgeAgentContextOptions, makeKnowledgeSearchTool };
+export { makeKnowledgeLookupTool, makeKnowledgeManageTool };
 
 //# sourceMappingURL=agent.mjs.map

package/dist/agent.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"agent.mjs","names":["Schema"],"sources":["../src/agent.ts"],"sourcesContent":["import { Effect } from 'effect'\nimport * as Schema from 'effect/Schema'\nimport { ToolError } from '@yolk-sdk/agent/loop'\nimport { ToolResult } from '@yolk-sdk/agent/protocol'\nimport { makeTool, type ToolRegistration } from '@yolk-sdk/agent/tools'\nimport type { KnowledgeScope } from './records.ts'\nimport type { KnowledgeSearchScope } from './documents.ts'\nimport type { KnowledgeSearcher } from './search.ts'\nimport { packKnowledgeSearchContext } from './search.ts'\n\nexport type ResolveKnowledgeScope<Context> = (context: Context) => KnowledgeScope\n\nexport type KnowledgeAgentContextOptions = {\n  readonly maxPinnedContextCharacters: number\n}\n\nexport const defaultKnowledgeAgentContextOptions: KnowledgeAgentContextOptions = {\n  maxPinnedContextCharacters: 6000\n}\n\nconst KnowledgeSearchToolParams = Schema.Struct({\n  query: Schema.Trimmed.pipe(\n    Schema.check(Schema.isNonEmpty()),\n    Schema.annotate({ description: 'Search query for the configured knowledge search.' })\n  )\n})\n\nconst isToolError = Schema.is(ToolError)\n\nexport type KnowledgeSearchToolScopeResolver<Context> =\n  | KnowledgeSearchScope\n  | ((context: Context) => Effect.Effect<KnowledgeSearchScope, ToolError>)\n\nexport type MakeKnowledgeSearchToolOptions<Context> = {\n  readonly scope: KnowledgeSearchToolScopeResolver<Context>\n  readonly name?: string\n  readonly description?: string\n  readonly limit?: number\n  readonly minScore?: number\n  readonly contextChunks?: number\n}\n\nconst resolveScope = <Context>(resolver: KnowledgeSearchToolScopeResolver<Context>, context: Context) => {\n  if (typeof resolver === 'function') {\n    return resolver(context)\n  }\n\n  return Effect.succeed(resolver)\n}\n\nexport const makeKnowledgeSearchTool = <Context>(\n  searcher: KnowledgeSearcher,\n  options: MakeKnowledgeSearchToolOptions<Context>\n): ToolRegistration<Context> => {\n  const name = options.name ?? 'search_knowledge'\n\n  return makeTool({\n    name,\n    description: options.description ?? 'Search the configured knowledge search.',\n    parameters: KnowledgeSearchToolParams,\n    access: 'read',\n    invalidParamsMessage: error => error instanceof Error ? error.message : String(error),\n    execute: input =>\n      resolveScope(options.scope, input.context).pipe(\n        Effect.flatMap(scope =>\n          searcher.search({\n            scope,\n            query: input.params.query,\n            limit: options.limit,\n            minScore: options.minScore,\n            contextChunks: options.contextChunks\n          })\n        ),\n        Effect.map(results => packKnowledgeSearchContext(input.params.query, results)),\n        Effect.map(\n          context =>\n            ToolResult.make({\n              toolCallId: input.call.id,\n              content: context.text,\n              structuredContent: context\n            })\n        ),\n        Effect.mapError(error => {\n          if (isToolError(error)) {\n            return error\n          }\n\n          return new ToolError({\n            tool: input.call.name,\n            message: error.message,\n            cause: 'execution'\n          })\n        })\n      )\n  })\n}\n"],"mappings":";;;;;;;AAgBA,MAAa,sCAAoE,EAC/E,4BAA4B,IAC9B;AAEA,MAAM,4BAA4BA,SAAO,OAAO,EAC9C,OAAOA,SAAO,QAAQ,KACpBA,SAAO,MAAMA,SAAO,WAAW,CAAC,GAChCA,SAAO,SAAS,EAAE,aAAa,oDAAoD,CAAC,CACtF,EACF,CAAC;AAED,MAAM,cAAcA,SAAO,GAAG,SAAS;AAevC,MAAM,gBAAyB,UAAqD,YAAqB;CACvG,IAAI,OAAO,aAAa,YACtB,OAAO,SAAS,OAAO;CAGzB,OAAO,OAAO,QAAQ,QAAQ;AAChC;AAEA,MAAa,2BACX,UACA,YAC8B;CAG9B,OAAO,SAAS;EACd,MAHW,QAAQ,QAAQ;EAI3B,aAAa,QAAQ,eAAe;EACpC,YAAY;EACZ,QAAQ;EACR,uBAAsB,UAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;EACpF,UAAS,UACP,aAAa,QAAQ,OAAO,MAAM,OAAO,EAAE,KACzC,OAAO,SAAQ,UACb,SAAS,OAAO;GACd;GACA,OAAO,MAAM,OAAO;GACpB,OAAO,QAAQ;GACf,UAAU,QAAQ;GAClB,eAAe,QAAQ;EACzB,CAAC,CACH,GACA,OAAO,KAAI,YAAW,2BAA2B,MAAM,OAAO,OAAO,OAAO,CAAC,GAC7E,OAAO,KACL,YACE,WAAW,KAAK;GACd,YAAY,MAAM,KAAK;GACvB,SAAS,QAAQ;GACjB,mBAAmB;EACrB,CAAC,CACL,GACA,OAAO,UAAS,UAAS;GACvB,IAAI,YAAY,KAAK,GACnB,OAAO;GAGT,OAAO,IAAI,UAAU;IACnB,MAAM,MAAM,KAAK;IACjB,SAAS,MAAM;IACf,OAAO;GACT,CAAC;EACH,CAAC,CACH;CACJ,CAAC;AACH"}
+{"version":3,"file":"agent.mjs","names":[],"sources":["../src/agent.ts"],"sourcesContent":["import { Effect } from 'effect'\nimport * as Schema from 'effect/Schema'\nimport { ToolError } from '@yolk-sdk/agent/loop'\nimport { ToolResult } from '@yolk-sdk/agent/protocol'\nimport { makeTool, type ToolRegistration } from '@yolk-sdk/agent/tools'\nimport {\n  KnowledgeAvailabilitySchema,\n  NonEmptyTrimmedString,\n  type KnowledgeAvailability,\n  type KnowledgeDocument\n} from './documents.ts'\n\nconst OptionalNonEmptyTrimmedString = Schema.optional(Schema.NullOr(NonEmptyTrimmedString))\nconst OptionalNumber = Schema.optional(Schema.NullOr(Schema.Number))\n\nconst KnowledgeTargetParamsSchema = Schema.Struct({\n  slug: NonEmptyTrimmedString,\n  scope: OptionalNonEmptyTrimmedString\n})\n\nconst KnowledgeLookupParams = Schema.Union([\n  Schema.Struct({\n    operation: Schema.Literal('search'),\n    query: NonEmptyTrimmedString,\n    limit: OptionalNumber,\n    minScore: OptionalNumber,\n    contextChunks: OptionalNumber\n  }),\n  Schema.Struct({\n    operation: Schema.Literal('get'),\n    id: OptionalNonEmptyTrimmedString,\n    target: Schema.optional(Schema.NullOr(KnowledgeTargetParamsSchema))\n  })\n])\n\nconst KnowledgeManageParams = Schema.Union([\n  Schema.Struct({\n    operation: Schema.Literal('upsert'),\n    target: KnowledgeTargetParamsSchema,\n    title: NonEmptyTrimmedString,\n    purpose: NonEmptyTrimmedString,\n    origin: NonEmptyTrimmedString,\n    content: NonEmptyTrimmedString,\n    availability: KnowledgeAvailabilitySchema\n  }),\n  Schema.Struct({\n    operation: Schema.Literal('set_availability'),\n    target: KnowledgeTargetParamsSchema,\n    availability: KnowledgeAvailabilitySchema\n  }),\n  Schema.Struct({\n    operation: Schema.Literal('rename_slug'),\n    target: KnowledgeTargetParamsSchema,\n    nextSlug: NonEmptyTrimmedString\n  }),\n  Schema.Struct({\n    operation: Schema.Literal('delete'),\n    target: KnowledgeTargetParamsSchema\n  })\n])\n\ntype KnowledgeTargetParams = typeof KnowledgeTargetParamsSchema.Type\ntype KnowledgeLookupParams = typeof KnowledgeLookupParams.Type\ntype KnowledgeManageParams = typeof KnowledgeManageParams.Type\n\nexport type KnowledgeTarget = {\n  readonly slug: string\n  readonly scope?: string\n}\n\nexport type KnowledgeLookupResult = {\n  readonly document: KnowledgeDocument\n  readonly score?: number\n  readonly context?: ReadonlyArray<{ readonly content: string }>\n}\n\nexport type KnowledgeSavedDocument = {\n  readonly id: string\n  readonly slug: string\n  readonly title: string\n}\n\nexport type KnowledgeLookupHandlers<Context> = {\n  readonly search: (input: {\n    readonly context: Context\n    readonly query: string\n    readonly limit?: number\n    readonly minScore?: number\n    readonly contextChunks?: number\n  }) => Effect.Effect<ReadonlyArray<KnowledgeLookupResult>, ToolError>\n  readonly get: (input: {\n    readonly context: Context\n    readonly id?: string\n    readonly target?: KnowledgeTarget\n  }) => Effect.Effect<KnowledgeDocument, ToolError>\n}\n\nexport type KnowledgeManageHandlers<Context> = {\n  readonly upsert: (input: {\n    readonly context: Context\n    readonly target: KnowledgeTarget\n    readonly title: string\n    readonly purpose: string\n    readonly origin: string\n    readonly content: string\n    readonly availability: KnowledgeAvailability\n  }) => Effect.Effect<KnowledgeSavedDocument, ToolError>\n  readonly setAvailability: (input: {\n    readonly context: Context\n    readonly target: KnowledgeTarget\n    readonly availability: KnowledgeAvailability\n  }) => Effect.Effect<KnowledgeSavedDocument, ToolError>\n  readonly renameSlug: (input: {\n    readonly context: Context\n    readonly target: KnowledgeTarget\n    readonly nextSlug: string\n  }) => Effect.Effect<KnowledgeSavedDocument, ToolError>\n  readonly delete: (input: {\n    readonly context: Context\n    readonly target: KnowledgeTarget\n  }) => Effect.Effect<KnowledgeSavedDocument, ToolError>\n}\n\nconst unknownToMessage = (error: unknown) => error instanceof Error ? error.message : String(error)\n\nconst optionalValue = <Value>(value: Value | null | undefined) => value ?? undefined\n\nconst targetFromParams = (target: KnowledgeTargetParams): KnowledgeTarget =>\n  target.scope === null || target.scope === undefined\n    ? { slug: target.slug }\n    : { slug: target.slug, scope: target.scope }\n\nconst optionalTargetFromParams = (target: KnowledgeTargetParams | null | undefined) =>\n  target === null || target === undefined ? undefined : targetFromParams(target)\n\nconst formatDocument = (document: KnowledgeDocument) =>\n  [\n    `# ${document.title}`,\n    `document_id: ${document.id}`,\n    `slug: ${document.slug}`,\n    `purpose: ${document.purpose}`,\n    `origin: ${document.origin}`,\n    `availability: ${document.availability}`,\n    `status: ${document.status}`,\n    '',\n    document.content\n  ].join('\\n')\n\nconst formatSearchResults = (results: ReadonlyArray<KnowledgeLookupResult>) =>\n  results.length === 0\n    ? 'No knowledge matches found.'\n    : results\n        .map(result =>\n          [\n            `## ${result.document.title}`,\n            `document_id: ${result.document.id}`,\n            `slug: ${result.document.slug}`,\n            `purpose: ${result.document.purpose}`,\n            `origin: ${result.document.origin}`,\n            `availability: ${result.document.availability}`,\n            result.score === undefined ? undefined : `score: ${result.score}`,\n            '',\n            result.context?.map(chunk => chunk.content).join('\\n\\n') ?? result.document.content\n          ]\n            .filter(line => line !== undefined)\n            .join('\\n')\n        )\n        .join('\\n\\n')\n\nconst formatSaved = (verb: string, document: KnowledgeSavedDocument) =>\n  [verb, `title: ${document.title}`, `slug: ${document.slug}`, `document_id: ${document.id}`].join('\\n')\n\nexport const makeKnowledgeLookupTool = <Context>(\n  handlers: KnowledgeLookupHandlers<Context>,\n  options: { readonly name?: string; readonly description?: string } = {}\n): ToolRegistration<Context> => {\n  const name = options.name ?? 'knowledge_lookup'\n\n  return makeTool({\n    name,\n    description:\n      options.description ??\n      'Look up durable knowledge. Search for semantic discovery; get when document_id or slug is known.',\n    parameters: KnowledgeLookupParams,\n    access: 'read',\n    invalidParamsMessage: error => `Invalid knowledge lookup arguments: ${unknownToMessage(error)}`,\n    execute: ({ call, context, params }) =>\n      Effect.gen(function* () {\n        if (params.operation === 'search') {\n          const results = yield* handlers.search({\n            context,\n            query: params.query,\n            limit: optionalValue(params.limit),\n            minScore: optionalValue(params.minScore),\n            contextChunks: optionalValue(params.contextChunks)\n          })\n\n          return ToolResult.make({ toolCallId: call.id, content: formatSearchResults(results) })\n        }\n\n        const document = yield* handlers.get({\n          context,\n          id: optionalValue(params.id),\n          target: optionalTargetFromParams(params.target)\n        })\n        return ToolResult.make({ toolCallId: call.id, content: formatDocument(document) })\n      })\n  })\n}\n\nexport const makeKnowledgeManageTool = <Context>(\n  handlers: KnowledgeManageHandlers<Context>,\n  options: { readonly name?: string; readonly description?: string } = {}\n): ToolRegistration<Context> => {\n  const name = options.name ?? 'knowledge_manage'\n\n  return makeTool({\n    name,\n    description:\n      options.description ??\n      'Create, replace, pin, archive, rename, or delete durable knowledge. Use only when explicitly asked.',\n    parameters: KnowledgeManageParams,\n    access: 'write',\n    invalidParamsMessage: error => `Invalid knowledge manage arguments: ${unknownToMessage(error)}`,\n    execute: ({ call, context, params }) =>\n      Effect.gen(function* () {\n        switch (params.operation) {\n          case 'upsert': {\n            const document = yield* handlers.upsert({\n              context,\n              target: targetFromParams(params.target),\n              title: params.title,\n              purpose: params.purpose,\n              origin: params.origin,\n              content: params.content,\n              availability: params.availability\n            })\n            return ToolResult.make({ toolCallId: call.id, content: formatSaved('Knowledge upserted', document) })\n          }\n          case 'set_availability': {\n            const document = yield* handlers.setAvailability({\n              context,\n              target: targetFromParams(params.target),\n              availability: params.availability\n            })\n            return ToolResult.make({\n              toolCallId: call.id,\n              content: formatSaved('Knowledge availability updated', document)\n            })\n          }\n          case 'rename_slug': {\n            const document = yield* handlers.renameSlug({\n              context,\n              target: targetFromParams(params.target),\n              nextSlug: params.nextSlug\n            })\n            return ToolResult.make({ toolCallId: call.id, content: formatSaved('Knowledge slug renamed', document) })\n          }\n          case 'delete': {\n            const document = yield* handlers.delete({ context, target: targetFromParams(params.target) })\n            return ToolResult.make({ toolCallId: call.id, content: formatSaved('Knowledge deleted', document) })\n          }\n        }\n\n        return yield* Effect.fail(\n          new ToolError({ tool: call.name, message: 'Unsupported knowledge operation', cause: 'validation' })\n        )\n      })\n  })\n}\n"],"mappings":"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"}

package/dist/chunking.d.mts

@@ -4,7 +4,7 @@ import { Context, Effect, Layer } from "effect";
 
 //#region src/chunking.d.ts
 type ChunkKnowledgeDocumentInput = {
-  readonly collectionId: string;
+  readonly scopeId: string;
   readonly documentId: string;
   readonly content: string;
   readonly maxTokens?: number;
@@ -18,7 +18,7 @@ declare class KnowledgeChunker extends KnowledgeChunker_base {}
 declare const countKnowledgeChunkTokens: (text: string) => number;
 declare const chunkKnowledgeText: (input: ChunkKnowledgeDocumentInput, maxTokens: number) => Effect.Effect<{
   id: string;
-  collectionId: string;
+  scopeId: string;
   documentId: string;
   content: string;
   position: number;

package/dist/chunking.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"chunking.d.mts","names":[],"sources":["../src/chunking.ts"],"mappings":";;;;;KASY,2BAAA;EAAA,SACD,YAAA;EAAA,SACA,UAAA;EAAA,SACA,OAAA;EAAA,SACA,SAAA;EAAA,SACA,QAAA,GAAW,iBAAiB;AAAA;AAAA,KAG3B,mBAAA;EAAA,SACD,KAAA,GACP,KAAA,EAAO,2BAAA,KACJ,MAAA,CAAO,MAAA,CAAO,aAAA,CAAc,cAAA,GAAiB,sBAAA;AAAA;AAAA,cACnD,qBAAA;cAEY,gBAAA,SAAyB,qBAErC;AAAA,cAEY,yBAAA,GAA6B,IAAY;AAAA,cA+GzC,kBAAA,GAAsB,KAAA,EAAO,2BAAA,EAA6B,SAAA,aAAiB,MAAA,CAAA,MAAA;;;;;;;;;;;cA+B3E,2BAAA,GAA+B,KAAA;EAAA,SAAkB,SAAA;AAAA,MAAsB,mBAElF;AAAA,cAEW,2BAAA,GAA+B,KAAA;EAAA,SAAkB,SAAA;AAAA,MAAwC,KAAA,CAAA,KAAA,CAAA,gBAAA"}
+{"version":3,"file":"chunking.d.mts","names":[],"sources":["../src/chunking.ts"],"mappings":";;;;;KASY,2BAAA;EAAA,SACD,OAAA;EAAA,SACA,UAAA;EAAA,SACA,OAAA;EAAA,SACA,SAAA;EAAA,SACA,QAAA,GAAW,iBAAiB;AAAA;AAAA,KAG3B,mBAAA;EAAA,SACD,KAAA,GACP,KAAA,EAAO,2BAAA,KACJ,MAAA,CAAO,MAAA,CAAO,aAAA,CAAc,cAAA,GAAiB,sBAAA;AAAA;AAAA,cACnD,qBAAA;cAEY,gBAAA,SAAyB,qBAErC;AAAA,cAEY,yBAAA,GAA6B,IAAY;AAAA,cA+GzC,kBAAA,GAAsB,KAAA,EAAO,2BAAA,EAA6B,SAAA,aAAiB,MAAA,CAAA,MAAA;;;;;;;;;;;cA+B3E,2BAAA,GAA+B,KAAA;EAAA,SAAkB,SAAA;AAAA,MAAsB,mBAElF;AAAA,cAEW,2BAAA,GAA+B,KAAA;EAAA,SAAkB,SAAA;AAAA,MAAwC,KAAA,CAAA,KAAA,CAAA,gBAAA"}

package/dist/chunking.mjs

@@ -77,7 +77,7 @@ const chunkKnowledgeText = (input, maxTokens) => Effect.gen(function* () {
 	if (contents.length === 0) return yield* Effect.fail(new KnowledgeChunkingError({ message: "No chunks produced" }));
 	return contents.map((content, position) => ({
 		id: `${input.documentId}:chunk:${position}`,
-		collectionId: input.collectionId,
+		scopeId: input.scopeId,
 		documentId: input.documentId,
 		content,
 		position,

package/dist/chunking.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"chunking.mjs","names":[],"sources":["../src/chunking.ts"],"sourcesContent":["import { Context, Effect, Layer } from 'effect'\nimport { countTokens, decode, encode } from 'gpt-tokenizer/encoding/o200k_base'\nimport type { KnowledgeChunk, KnowledgeMetadata } from './documents.ts'\nimport { KnowledgeChunkingError } from './errors.ts'\n\nconst SENTENCE_PATTERN = /[^.!?]+[.!?]+(?:[\"')\\]]+)?\\s*|[^.!?]+$/g\nconst PARAGRAPH_BREAK_PATTERN = /(\\n{2,})/\nconst WORD_PATTERN = /\\S+\\s*/g\n\nexport type ChunkKnowledgeDocumentInput = {\n  readonly collectionId: string\n  readonly documentId: string\n  readonly content: string\n  readonly maxTokens?: number\n  readonly metadata?: KnowledgeMetadata\n}\n\nexport type KnowledgeChunkerApi = {\n  readonly chunk: (\n    input: ChunkKnowledgeDocumentInput\n  ) => Effect.Effect<ReadonlyArray<KnowledgeChunk>, KnowledgeChunkingError>\n}\n\nexport class KnowledgeChunker extends Context.Service<KnowledgeChunker, KnowledgeChunkerApi>()(\n  '@yolk-sdk/knowledge/KnowledgeChunker'\n) {}\n\nexport const countKnowledgeChunkTokens = (text: string) => countTokens(text)\n\nconst sanitizeText = (text: string) =>\n  text\n    .replace(/\\r\\n/g, '\\n')\n    .replace(/[\\t ]+/g, ' ')\n    .replace(/\\n{3,}/g, '\\n\\n')\n    .trim()\n\nconst splitSentences = (text: string) =>\n  text\n    .split(PARAGRAPH_BREAK_PATTERN)\n    .flatMap(part => {\n      if (part.length === 0) {\n        return []\n      }\n\n      if (/^\\n{2,}$/.test(part)) {\n        return ['\\n\\n']\n      }\n\n      return part.match(SENTENCE_PATTERN) ?? [part]\n    })\n    .filter(unit => unit.length > 0)\n\nconst splitEncodedTokens = (text: string, maxTokens: number) => {\n  const tokens = encode(text)\n  return Array.from({ length: Math.ceil(tokens.length / maxTokens) }, (_, index) =>\n    decode(tokens.slice(index * maxTokens, index * maxTokens + maxTokens)).trim()\n  ).filter(chunk => chunk.length > 0)\n}\n\nconst splitOversizedUnit = (text: string, maxTokens: number) => {\n  const words = text.match(WORD_PATTERN) ?? []\n  const chunks: string[] = []\n  let current = ''\n  let currentTokenCount = 0\n\n  for (const word of words) {\n    const wordTokenCount = countTokens(word)\n\n    if (wordTokenCount > maxTokens) {\n      const currentChunk = current.trim()\n      if (currentChunk.length > 0) {\n        chunks.push(currentChunk)\n      }\n\n      chunks.push(...splitEncodedTokens(word, maxTokens))\n      current = ''\n      currentTokenCount = 0\n      continue\n    }\n\n    if (currentTokenCount > 0 && currentTokenCount + wordTokenCount > maxTokens) {\n      const currentChunk = current.trim()\n      if (currentChunk.length > 0) {\n        chunks.push(currentChunk)\n      }\n\n      current = word\n      currentTokenCount = wordTokenCount\n      continue\n    }\n\n    current = `${current}${word}`\n    currentTokenCount += wordTokenCount\n  }\n\n  const finalChunk = current.trim()\n  if (finalChunk.length > 0) {\n    chunks.push(finalChunk)\n  }\n\n  return chunks\n}\n\nconst splitUnitsBySize = (units: ReadonlyArray<string>, maxTokens: number) =>\n  units.flatMap(unit =>\n    countTokens(unit) <= maxTokens ? [unit] : splitOversizedUnit(unit, maxTokens)\n  )\n\nconst buildChunkContents = (units: ReadonlyArray<string>, maxTokens: number) => {\n  const chunks: string[] = []\n  let current = ''\n  let currentTokenCount = 0\n\n  const pushCurrent = () => {\n    const content = current.trim()\n    if (content.length > 0) {\n      chunks.push(content)\n    }\n  }\n\n  for (const unit of units) {\n    const unitTokenCount = countTokens(unit)\n\n    if (currentTokenCount > 0 && currentTokenCount + unitTokenCount > maxTokens) {\n      pushCurrent()\n      current = unit\n      currentTokenCount = unitTokenCount\n      continue\n    }\n\n    current = `${current}${unit}`\n    currentTokenCount += unitTokenCount\n  }\n\n  pushCurrent()\n  return chunks\n}\n\nexport const chunkKnowledgeText = (input: ChunkKnowledgeDocumentInput, maxTokens: number) =>\n  Effect.gen(function* () {\n    if (!Number.isInteger(maxTokens) || maxTokens < 1) {\n      return yield* Effect.fail(\n        new KnowledgeChunkingError({ message: 'Chunk maxTokens must be a positive integer' })\n      )\n    }\n\n    const sanitized = sanitizeText(input.content)\n    if (sanitized.length === 0) {\n      return yield* Effect.fail(new KnowledgeChunkingError({ message: 'Cannot chunk empty content' }))\n    }\n\n    const units = splitUnitsBySize(splitSentences(sanitized), maxTokens)\n    const contents = buildChunkContents(units, maxTokens)\n\n    if (contents.length === 0) {\n      return yield* Effect.fail(new KnowledgeChunkingError({ message: 'No chunks produced' }))\n    }\n\n    return contents.map((content, position) => ({\n      id: `${input.documentId}:chunk:${position}`,\n      collectionId: input.collectionId,\n      documentId: input.documentId,\n      content,\n      position,\n      tokenCount: countTokens(content),\n      metadata: input.metadata\n    })) satisfies ReadonlyArray<KnowledgeChunk>\n  })\n\nexport const makeDefaultKnowledgeChunker = (input: { readonly maxTokens: number }): KnowledgeChunkerApi => ({\n  chunk: document => chunkKnowledgeText(document, document.maxTokens ?? input.maxTokens)\n})\n\nexport const DefaultKnowledgeChunkerLive = (input: { readonly maxTokens: number } = { maxTokens: 512 }) =>\n  Layer.succeed(KnowledgeChunker, makeDefaultKnowledgeChunker(input))\n"],"mappings":"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"}
+{"version":3,"file":"chunking.mjs","names":[],"sources":["../src/chunking.ts"],"sourcesContent":["import { Context, Effect, Layer } from 'effect'\nimport { countTokens, decode, encode } from 'gpt-tokenizer/encoding/o200k_base'\nimport type { KnowledgeChunk, KnowledgeMetadata } from './documents.ts'\nimport { KnowledgeChunkingError } from './errors.ts'\n\nconst SENTENCE_PATTERN = /[^.!?]+[.!?]+(?:[\"')\\]]+)?\\s*|[^.!?]+$/g\nconst PARAGRAPH_BREAK_PATTERN = /(\\n{2,})/\nconst WORD_PATTERN = /\\S+\\s*/g\n\nexport type ChunkKnowledgeDocumentInput = {\n  readonly scopeId: string\n  readonly documentId: string\n  readonly content: string\n  readonly maxTokens?: number\n  readonly metadata?: KnowledgeMetadata\n}\n\nexport type KnowledgeChunkerApi = {\n  readonly chunk: (\n    input: ChunkKnowledgeDocumentInput\n  ) => Effect.Effect<ReadonlyArray<KnowledgeChunk>, KnowledgeChunkingError>\n}\n\nexport class KnowledgeChunker extends Context.Service<KnowledgeChunker, KnowledgeChunkerApi>()(\n  '@yolk-sdk/knowledge/KnowledgeChunker'\n) {}\n\nexport const countKnowledgeChunkTokens = (text: string) => countTokens(text)\n\nconst sanitizeText = (text: string) =>\n  text\n    .replace(/\\r\\n/g, '\\n')\n    .replace(/[\\t ]+/g, ' ')\n    .replace(/\\n{3,}/g, '\\n\\n')\n    .trim()\n\nconst splitSentences = (text: string) =>\n  text\n    .split(PARAGRAPH_BREAK_PATTERN)\n    .flatMap(part => {\n      if (part.length === 0) {\n        return []\n      }\n\n      if (/^\\n{2,}$/.test(part)) {\n        return ['\\n\\n']\n      }\n\n      return part.match(SENTENCE_PATTERN) ?? [part]\n    })\n    .filter(unit => unit.length > 0)\n\nconst splitEncodedTokens = (text: string, maxTokens: number) => {\n  const tokens = encode(text)\n  return Array.from({ length: Math.ceil(tokens.length / maxTokens) }, (_, index) =>\n    decode(tokens.slice(index * maxTokens, index * maxTokens + maxTokens)).trim()\n  ).filter(chunk => chunk.length > 0)\n}\n\nconst splitOversizedUnit = (text: string, maxTokens: number) => {\n  const words = text.match(WORD_PATTERN) ?? []\n  const chunks: string[] = []\n  let current = ''\n  let currentTokenCount = 0\n\n  for (const word of words) {\n    const wordTokenCount = countTokens(word)\n\n    if (wordTokenCount > maxTokens) {\n      const currentChunk = current.trim()\n      if (currentChunk.length > 0) {\n        chunks.push(currentChunk)\n      }\n\n      chunks.push(...splitEncodedTokens(word, maxTokens))\n      current = ''\n      currentTokenCount = 0\n      continue\n    }\n\n    if (currentTokenCount > 0 && currentTokenCount + wordTokenCount > maxTokens) {\n      const currentChunk = current.trim()\n      if (currentChunk.length > 0) {\n        chunks.push(currentChunk)\n      }\n\n      current = word\n      currentTokenCount = wordTokenCount\n      continue\n    }\n\n    current = `${current}${word}`\n    currentTokenCount += wordTokenCount\n  }\n\n  const finalChunk = current.trim()\n  if (finalChunk.length > 0) {\n    chunks.push(finalChunk)\n  }\n\n  return chunks\n}\n\nconst splitUnitsBySize = (units: ReadonlyArray<string>, maxTokens: number) =>\n  units.flatMap(unit =>\n    countTokens(unit) <= maxTokens ? [unit] : splitOversizedUnit(unit, maxTokens)\n  )\n\nconst buildChunkContents = (units: ReadonlyArray<string>, maxTokens: number) => {\n  const chunks: string[] = []\n  let current = ''\n  let currentTokenCount = 0\n\n  const pushCurrent = () => {\n    const content = current.trim()\n    if (content.length > 0) {\n      chunks.push(content)\n    }\n  }\n\n  for (const unit of units) {\n    const unitTokenCount = countTokens(unit)\n\n    if (currentTokenCount > 0 && currentTokenCount + unitTokenCount > maxTokens) {\n      pushCurrent()\n      current = unit\n      currentTokenCount = unitTokenCount\n      continue\n    }\n\n    current = `${current}${unit}`\n    currentTokenCount += unitTokenCount\n  }\n\n  pushCurrent()\n  return chunks\n}\n\nexport const chunkKnowledgeText = (input: ChunkKnowledgeDocumentInput, maxTokens: number) =>\n  Effect.gen(function* () {\n    if (!Number.isInteger(maxTokens) || maxTokens < 1) {\n      return yield* Effect.fail(\n        new KnowledgeChunkingError({ message: 'Chunk maxTokens must be a positive integer' })\n      )\n    }\n\n    const sanitized = sanitizeText(input.content)\n    if (sanitized.length === 0) {\n      return yield* Effect.fail(new KnowledgeChunkingError({ message: 'Cannot chunk empty content' }))\n    }\n\n    const units = splitUnitsBySize(splitSentences(sanitized), maxTokens)\n    const contents = buildChunkContents(units, maxTokens)\n\n    if (contents.length === 0) {\n      return yield* Effect.fail(new KnowledgeChunkingError({ message: 'No chunks produced' }))\n    }\n\n    return contents.map((content, position) => ({\n      id: `${input.documentId}:chunk:${position}`,\n      scopeId: input.scopeId,\n      documentId: input.documentId,\n      content,\n      position,\n      tokenCount: countTokens(content),\n      metadata: input.metadata\n    })) satisfies ReadonlyArray<KnowledgeChunk>\n  })\n\nexport const makeDefaultKnowledgeChunker = (input: { readonly maxTokens: number }): KnowledgeChunkerApi => ({\n  chunk: document => chunkKnowledgeText(document, document.maxTokens ?? input.maxTokens)\n})\n\nexport const DefaultKnowledgeChunkerLive = (input: { readonly maxTokens: number } = { maxTokens: 512 }) =>\n  Layer.succeed(KnowledgeChunker, makeDefaultKnowledgeChunker(input))\n"],"mappings":"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"}

package/dist/context.d.mts

@@ -1,16 +1,11 @@
-import { KnowledgeRecord } from "./records.mjs";
-import { KnowledgeRepresentation } from "./representations.mjs";
+import { KnowledgeDocument } from "./documents.mjs";
 
 //#region src/context.d.ts
-type KnowledgeContextItem = {
-  readonly record: KnowledgeRecord;
-  readonly representation?: KnowledgeRepresentation;
-};
 type BuildKnowledgeContextInput = {
-  readonly items: ReadonlyArray<KnowledgeContextItem>;
+  readonly documents: ReadonlyArray<KnowledgeDocument>;
   readonly maxCharacters: number;
 };
 declare const buildKnowledgeContext: (input: BuildKnowledgeContextInput) => string;
 //#endregion
-export { BuildKnowledgeContextInput, KnowledgeContextItem, buildKnowledgeContext };
+export { BuildKnowledgeContextInput, buildKnowledgeContext };
 //# sourceMappingURL=context.d.mts.map

package/dist/context.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.mts","names":[],"sources":["../src/context.ts"],"mappings":";;;;KAIY,oBAAA;EAAA,SACD,MAAA,EAAQ,eAAA;EAAA,SACR,cAAA,GAAiB,uBAAuB;AAAA;AAAA,KAGvC,0BAAA;EAAA,SACD,KAAA,EAAO,aAAa,CAAC,oBAAA;EAAA,SACrB,aAAA;AAAA;AAAA,cAeE,qBAAA,GAAyB,KAAiC,EAA1B,0BAA0B"}
+{"version":3,"file":"context.d.mts","names":[],"sources":["../src/context.ts"],"mappings":";;;KAGY,0BAAA;EAAA,SACD,SAAA,EAAW,aAAa,CAAC,iBAAA;EAAA,SACzB,aAAA;AAAA;AAAA,cAuBE,qBAAA,GAAyB,KAAiC,EAA1B,0BAA0B"}