@theokit/sdk 1.8.1 → 2.0.0

package/dist/internal/runtime/{cloud-config-serializer.d.ts → cloud/cloud-config-serializer.d.ts}

@@ -1,3 +1,3 @@
-import type { AgentOptions } from "../../types/agent.js";
+import type { AgentOptions } from "../../../types/agent.js";
 import type { CloudAgentPayload } from "./cloud-payload-types.js";
 export declare function serializeCloudAgentConfig(options: AgentOptions): CloudAgentPayload;

package/dist/internal/runtime/{real-cloud-run.d.ts → cloud/real-cloud-run.d.ts}

@@ -1,2 +1,2 @@
-import type { Run } from "../../types/run.js";
+import type { Run } from "../../../types/run.js";
 export declare function createRealCloudRun(options: CreateRealCloudRunOptions): Run;

package/dist/internal/runtime/fixtures/fixture-scripts.d.ts

@@ -1,5 +1,5 @@
 import type { FixtureRequest, FixtureScript } from "./fixture-types.js";
-export { extractMemoryFact, isMemoryWritePrompt } from "../memory-store.js";
+export { extractMemoryFact, isMemoryWritePrompt } from "../memory/memory-store.js";
 export declare function isMemoryRecallPrompt(message: string, request: FixtureRequest): boolean;
 export declare function memoryWriteScript(request: FixtureRequest): FixtureScript;
 export declare function memoryRecallScript(request: FixtureRequest): FixtureScript;

package/dist/internal/runtime/fork-agent.d.ts

@@ -12,4 +12,4 @@
  *
  * @internal
  */
-export {};
+export type { ForkOptions, ForkResult } from "../../types/fork.js";

package/dist/internal/runtime/{local-agent-bootstrap.d.ts → local-agent/local-agent-bootstrap.d.ts}

@@ -7,10 +7,10 @@
  *
  * @internal
  */
-import { FileContextManager } from "./context/context-manager.js";
-import { type PluginMetadata, PluginsManager } from "./plugins/plugins-manager.js";
-import { ProvidersManagerImpl } from "./providers-manager.js";
-import { type SkillMetadata, SkillsManager } from "./skills-manager.js";
+import { FileContextManager } from "../context/context-manager.js";
+import { type PluginMetadata, PluginsManager } from "../plugins/plugins-manager.js";
+import { ProvidersManagerImpl } from "../providers-manager.js";
+import { type SkillMetadata, SkillsManager } from "../skills/skills-manager.js";
 export declare function registerLocalAgent(args: {
     agentId: string;
     model: ModelSelection | undefined;

package/dist/internal/runtime/{local-agent-dispatch.d.ts → local-agent/local-agent-dispatch.d.ts}

@@ -4,13 +4,13 @@
  *
  * @internal
  */
-import type { AgentDefinition, AgentOptions, ModelSelection } from "../../types/agent.js";
-import type { Run, SDKUserMessage, SendOptions } from "../../types/run.js";
-import type { MemoryToolSpec } from "../agent-loop/loop-types.js";
-import type { PersonalityPreset } from "../personality/types.js";
-import type { PluginManager } from "../plugins/manager.js";
-import type { HooksExecutor } from "./hooks-executor.js";
-import type { MemoryFact } from "./memory-store.js";
+import type { AgentDefinition, AgentOptions, ModelSelection } from "../../../types/agent.js";
+import type { Run, SDKUserMessage, SendOptions } from "../../../types/run.js";
+import type { MemoryToolSpec } from "../../agent-loop/loop-types.js";
+import type { PersonalityPreset } from "../../personality/types.js";
+import type { PluginManager } from "../../plugins/manager.js";
+import type { HooksExecutor } from "../hooks/hooks-executor.js";
+import type { MemoryFact } from "../memory/memory-store.js";
 import { createRealLocalRun } from "./real-local-run.js";
 export interface DispatchInputs {
     agentId: string;

package/dist/internal/runtime/{local-agent-memory-hooks.d.ts → local-agent/local-agent-memory-hooks.d.ts}

@@ -10,8 +10,8 @@
  *
  * @internal
  */
-import type { Run, SDKUserMessage, SendOptions } from "../../types/run.js";
-import type { PluginManager } from "../plugins/manager.js";
+import type { Run, SDKUserMessage, SendOptions } from "../../../types/run.js";
+import type { PluginManager } from "../../plugins/manager.js";
 /**
  * EC-A + EC-G + EC-H: fire `pre_user_send` hooks, cap recalled context,
  * and prepend it as a `<memory-context>` fence around the original

package/dist/internal/runtime/{local-agent-memory-provider.d.ts → local-agent/local-agent-memory-provider.d.ts}

@@ -25,8 +25,8 @@
  * @internal — sdk-core's bridging glue. Replaced by sdk-memory rich impl
  * in Stage 3.
  */
-import type { TelemetryHandle } from "../telemetry/tracer.js";
-import type { MemoryProvider } from "./memory-provider.js";
+import type { TelemetryHandle } from "../../telemetry/tracer.js";
+import type { MemoryProvider } from "../memory/memory-provider.js";
 /**
  * Options for `createLocalAgentMemoryProvider`. Mirrors what
  * `LocalAgentMemory`'s constructor needs.

package/dist/internal/runtime/{real-local-run.d.ts → local-agent/real-local-run.d.ts}

@@ -1,2 +1,2 @@
-import type { Run } from "../../types/run.js";
+import type { Run } from "../../../types/run.js";
 export declare function createRealLocalRun(options: CreateRealLocalRunOptions): Run;

package/dist/internal/runtime/{memory-path-selector.d.ts → memory/memory-path-selector.d.ts}

@@ -19,7 +19,7 @@
  *
  * @internal
  */
-import type { MemoryToolSpec } from "../agent-loop/loop-types.js";
+import type { MemoryToolSpec } from "../../agent-loop/loop-types.js";
 import type { MemoryProvider } from "./memory-provider.js";
 /** Env var name — internal, not in public docs yet. */
 export declare const PORT_MEMORY_PATH_ENV_VAR = "THEOKIT_PORT_MEMORY_PATH";

package/dist/internal/runtime/{memory-provider.d.ts → memory/memory-provider.d.ts}

@@ -28,8 +28,8 @@
  *
  * @public — surface-level interface; impls are internal-but-replaceable.
  */
-import type { CustomTool, SDKAgent } from "../../types/agent.js";
-import type { MemoryAdapter, MemoryFact } from "../../types/memory-adapter.js";
+import type { CustomTool, SDKAgent } from "../../../types/agent.js";
+import type { MemoryAdapter, MemoryFact } from "../../../types/memory-adapter.js";
 /** Result of `MemoryProvider.runActivePass(...)` — what the kernel injects into the LLM call. */
 export interface ActiveMemoryPassResult {
     /** Compressed memory facts to seed the LLM's context window for this turn. */

package/dist/internal/runtime/{memory-store.d.ts → memory/memory-store.d.ts}

@@ -1,4 +1,4 @@
-import { type MemoryConfig, type MemoryFact, redactSecrets } from "../memory/types.js";
+import { type MemoryConfig, type MemoryFact, redactSecrets } from "../../memory/types.js";
 export { redactSecrets };
 export declare function readMemoryFacts(cwd: string, config: MemoryConfig): Promise<MemoryFact[]>;
 export declare function appendMemoryFact(cwd: string, config: MemoryConfig, fact: MemoryFact): Promise<void>;

package/dist/internal/runtime/skills/subagents-loader.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/agent.d.ts

@@ -478,7 +478,7 @@ export interface AgentOptions {
      *
      * @public
      */
-    budgetTracker?: import("../internal/runtime/budget-tracker.js").BudgetTracker;
+    budgetTracker?: import("../internal/runtime/budget/budget-tracker.js").BudgetTracker;
     /**
      * Pluggable memory subsystem (SDK 2.0 Phase 1 / T1.3 — Hexagonal
      * Architecture interface inversion). When provided, the agent loop
@@ -502,7 +502,7 @@ export interface AgentOptions {
      *
      * @public
      */
-    memoryProvider?: import("../internal/runtime/memory-provider.js").MemoryProvider;
+    memoryProvider?: import("../internal/runtime/memory/memory-provider.js").MemoryProvider;
 }
 /**
  * Artifact produced inside an agent's workspace. Cloud-only.
@@ -607,7 +607,7 @@ export interface SDKAgent {
      *
      * @public
      */
-    fork?(options: import("../internal/runtime/fork-agent.js").ForkOptions): Promise<import("../internal/runtime/fork-agent.js").ForkResult>;
+    fork?(options: import("./fork.js").ForkOptions): Promise<import("./fork.js").ForkResult>;
     /**
      * Direct API to third-party memory adapter(s) registered via
      * `plugins: [...]` (ADR D141 / D142). Returns `null` when no adapter

package/dist/types/fork.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Fork primitive public type contracts (T1.2, ADRs D110-D114).
+ *
+ * Extracted into a leaf type module (arch-review ADR 0001) so the public
+ * `types/agent.ts` barrel can reference `ForkOptions`/`ForkResult` without
+ * importing the `internal/runtime/fork-agent.ts` implementation — which in
+ * turn imports back from `types/agent.ts`. That mutual reference created a
+ * type-only `madge` cycle. These interfaces are self-contained (no SDKAgent
+ * / AgentOptions references), so co-locating them here breaks the cycle with
+ * no runtime change. `fork-agent.ts` re-exports them for back-compat.
+ */
+/**
+ * Caller-supplied fork configuration. See `forkAgentImpl`.
+ *
+ * @public
+ */
+export interface ForkOptions {
+    /**
+     * Tool subset visible to the fork. Names must match the canonical (post-repair)
+     * tool name — typically lowercase. Tools not in this set return a `tool_result`
+     * with `"Tool blocked by fork whitelist"` content (EC-H).
+     */
+    allowedTools: Set<string>;
+    /** Task prompt sent to the fork. */
+    prompt: string;
+    /** Override system prompt. Default: byte-identical inheritance from parent (D112). */
+    systemPrompt?: string;
+    /** Memory write provenance tag (D114). Default `"fork"`. */
+    forkOrigin?: string;
+}
+/**
+ * Outcome of a fork run.
+ *
+ * @public
+ */
+export interface ForkResult {
+    /** Final agent response text (`undefined` when the fork produced no result). */
+    result: string | undefined;
+    /** Tool calls executed inside the fork. */
+    toolCalls: ReadonlyArray<{
+        name: string;
+        input: Record<string, unknown>;
+    }>;
+    /** Aggregate token usage reported by the run. */
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}

package/dist/types/goal-events.d.ts

@@ -64,7 +64,7 @@ export interface GoalResult {
     finalResponse: string | undefined;
 }
 /**
- * Return type of {@link import("../internal/runtime/local-agent.js").LocalAgent.runUntil}.
+ * Return type of {@link import("../internal/runtime/local-agent/local-agent.js").LocalAgent.runUntil}.
  * Extracted so the LocalAgent method signature stays a single line (G8 LoC budget).
  *
  * @public

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/sdk",
-  "version": "1.8.1",
+  "version": "2.0.0",
   "description": "TypeScript SDK for the Theo agent harness — same surface, local or cloud.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/usetheo/theokit-sdk#readme",
@@ -158,16 +158,6 @@
         "default": "./dist/internal/security/index.cjs"
       }
     },
-    "./rag": {
-      "import": {
-        "types": "./dist/rag/index.d.ts",
-        "default": "./dist/rag/index.js"
-      },
-      "require": {
-        "types": "./dist/rag/index.d.cts",
-        "default": "./dist/rag/index.cjs"
-      }
-    },
     "./a2a": {
       "import": {
         "types": "./dist/a2a/index.d.ts",
@@ -214,15 +204,6 @@
     "theokit-migrate-memory": "./bin/theokit-migrate-memory.mjs"
   },
   "sideEffects": false,
-  "scripts": {
-    "build": "tsup && cp src/internal/providers/provider-catalog.json dist/provider-catalog.json",
-    "test": "vitest run --no-file-parallelism",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist",
-    "docs:json": "typedoc --options typedoc.json",
-    "docs:drift": "tsx scripts/check-docs-drift.ts"
-  },
   "peerDependencies": {
     "@lancedb/lancedb": "^0.30.0",
     "@types/ws": ">=8.0.0",
@@ -256,8 +237,7 @@
     }
   },
   "publishConfig": {
-    "access": "public",
-    "provenance": true
+    "access": "public"
   },
   "keywords": [
     "agent",
@@ -280,8 +260,6 @@
   "devDependencies": {
     "@opentelemetry/api": "^1.9.1",
     "@opentelemetry/sdk-trace-base": "^1.30.1",
-    "@theokit/sdk-handoff": "workspace:*",
-    "@theokit/sdk-memory": "workspace:*",
     "@types/better-sqlite3": "^7.6.13",
     "@types/proper-lockfile": "^4.1.4",
     "@types/ws": "^8.18.0",
@@ -291,6 +269,17 @@
     "sqlite-vec": "^0.1.9",
     "typedoc": "^0.28.19",
     "ws": "^8.18.0",
-    "zod": "^4.0.0"
+    "zod": "^4.0.0",
+    "@theokit/sdk-handoff": "0.1.0",
+    "@theokit/sdk-memory": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup && cp src/internal/providers/provider-catalog.json dist/provider-catalog.json",
+    "test": "vitest run --no-file-parallelism",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "docs:json": "typedoc --options typedoc.json",
+    "docs:drift": "tsx scripts/check-docs-drift.ts"
   }
-}
+}

package/dist/rag/index.cjs

@@ -1,136 +0,0 @@
-'use strict';
-
-// src/rag/reranker.ts
-var NoopReranker = class {
-  async rerank(_query, chunks) {
-    return chunks.map((c, i) => ({
-      text: c.text,
-      score: c.score,
-      originalIndex: i,
-      metadata: c.metadata
-    }));
-  }
-};
-var CohereReranker = class {
-  _apiKey;
-  _model;
-  _mockRerank;
-  constructor(opts) {
-    this._apiKey = opts.apiKey;
-    this._model = opts.model ?? "rerank-v3.5";
-    this._mockRerank = opts._mockRerank;
-  }
-  async rerank(query, chunks) {
-    if (chunks.length === 0) return [];
-    if (this._mockRerank) {
-      return this._mockRerank(query, chunks);
-    }
-    const response = await fetch("https://api.cohere.com/v2/rerank", {
-      method: "POST",
-      headers: {
-        Authorization: `Bearer ${this._apiKey}`,
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify({
-        model: this._model,
-        query,
-        documents: chunks.map((c) => c.text),
-        top_n: chunks.length
-      })
-    });
-    if (!response.ok) {
-      throw new Error(`Cohere rerank failed: ${response.status} ${response.statusText}`);
-    }
-    const data = await response.json();
-    return data.results.map((r) => {
-      const chunk = chunks[r.index];
-      return {
-        text: chunk?.text ?? "",
-        score: r.relevance_score,
-        originalIndex: r.index,
-        metadata: chunk?.metadata
-      };
-    });
-  }
-};
-
-// src/rag/retriever.ts
-var VectorRetriever = class {
-  _index;
-  _defaultTopK;
-  constructor(opts) {
-    this._index = opts.index;
-    this._defaultTopK = opts.topK ?? 5;
-  }
-  async retrieve(query, options) {
-    const topK = options?.topK ?? this._defaultTopK;
-    return this._index.search(query, topK);
-  }
-};
-
-// src/rag/text-splitter.ts
-function makeChunks(texts) {
-  return texts.filter((t) => t.length > 0).map((text, index) => ({ text, index }));
-}
-function splitByCharacter(text, opts) {
-  if (text.length === 0) return [];
-  const { chunkSize, overlap = 0 } = opts;
-  const step = Math.max(1, chunkSize - overlap);
-  const parts = [];
-  for (let i = 0; i < text.length; i += step) {
-    parts.push(text.slice(i, i + chunkSize));
-  }
-  return makeChunks(parts);
-}
-var SENTENCE_RE = /(?<=[.!?])\s+/;
-function splitBySentence(text, opts) {
-  if (text.length === 0) return [];
-  const { chunkSize } = opts;
-  const sentences = text.split(SENTENCE_RE);
-  const parts = [];
-  let current = "";
-  for (const sentence of sentences) {
-    if (current.length + sentence.length + 1 > chunkSize && current.length > 0) {
-      parts.push(current.trim());
-      current = sentence;
-    } else {
-      current = current.length > 0 ? `${current} ${sentence}` : sentence;
-    }
-  }
-  if (current.length > 0) parts.push(current.trim());
-  return makeChunks(parts);
-}
-var PARAGRAPH_RE = /\n\n+/;
-function splitRecursive(text, opts) {
-  if (text.length === 0) return [];
-  const { chunkSize, overlap = 0 } = opts;
-  const paragraphs = text.split(PARAGRAPH_RE).filter((p) => p.length > 0);
-  const result = [];
-  for (const para of paragraphs) {
-    if (para.length <= chunkSize) {
-      result.push(para);
-    } else {
-      const sentenceChunks = splitBySentence(para, { chunkSize});
-      for (const sc of sentenceChunks) {
-        if (sc.text.length <= chunkSize) {
-          result.push(sc.text);
-        } else {
-          const charChunks = splitByCharacter(sc.text, { chunkSize, overlap });
-          for (const cc of charChunks) {
-            result.push(cc.text);
-          }
-        }
-      }
-    }
-  }
-  return makeChunks(result);
-}
-
-exports.CohereReranker = CohereReranker;
-exports.NoopReranker = NoopReranker;
-exports.VectorRetriever = VectorRetriever;
-exports.splitByCharacter = splitByCharacter;
-exports.splitBySentence = splitBySentence;
-exports.splitRecursive = splitRecursive;
-//# sourceMappingURL=index.cjs.map
-//# sourceMappingURL=index.cjs.map

package/dist/rag/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/rag/reranker.ts","../../src/rag/retriever.ts","../../src/rag/text-splitter.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Reranker implementations for RAG pipelines (T11.1, ADR D448).\n *\n * NoopReranker: passes through results unchanged (baseline).\n * CohereReranker: calls the Cohere Rerank API (optional peer dep).\n *\n * @public\n */\n\nimport type { RankedChunk, Reranker, RetrievalResult } from \"./types.js\";\n\nexport class NoopReranker implements Reranker {\n  async rerank(_query: string, chunks: RetrievalResult[]): Promise<RankedChunk[]> {\n    return chunks.map((c, i) => ({\n      text: c.text,\n      score: c.score,\n      originalIndex: i,\n      metadata: c.metadata,\n    }));\n  }\n}\n\ntype MockRerankFn = (query: string, docs: RetrievalResult[]) => Promise<RankedChunk[]>;\n\nexport interface CohereRerankerOptions {\n  apiKey: string;\n  model?: string;\n  _mockRerank?: MockRerankFn;\n}\n\nexport class CohereReranker implements Reranker {\n  private readonly _apiKey: string;\n  private readonly _model: string;\n  private readonly _mockRerank?: MockRerankFn;\n\n  constructor(opts: CohereRerankerOptions) {\n    this._apiKey = opts.apiKey;\n    this._model = opts.model ?? \"rerank-v3.5\";\n    this._mockRerank = opts._mockRerank;\n  }\n\n  async rerank(query: string, chunks: RetrievalResult[]): Promise<RankedChunk[]> {\n    if (chunks.length === 0) return [];\n\n    if (this._mockRerank) {\n      return this._mockRerank(query, chunks);\n    }\n\n    const response = await fetch(\"https://api.cohere.com/v2/rerank\", {\n      method: \"POST\",\n      headers: {\n        Authorization: `Bearer ${this._apiKey}`,\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify({\n        model: this._model,\n        query,\n        documents: chunks.map((c) => c.text),\n        top_n: chunks.length,\n      }),\n    });\n\n    if (!response.ok) {\n      throw new Error(`Cohere rerank failed: ${response.status} ${response.statusText}`);\n    }\n\n    const data = (await response.json()) as {\n      results: Array<{ index: number; relevance_score: number }>;\n    };\n\n    return data.results.map((r) => {\n      const chunk = chunks[r.index];\n      return {\n        text: chunk?.text ?? \"\",\n        score: r.relevance_score,\n        originalIndex: r.index,\n        metadata: chunk?.metadata,\n      };\n    });\n  }\n}\n","/**\n * Retriever implementations for RAG pipelines (T11.1, ADR D448).\n *\n * VectorRetriever wraps any index that implements `search(query, topK)`.\n * The Retriever interface is the contract — consumers depend on the interface,\n * implementations depend on the index adapter (DIP per architecture.md § 2).\n *\n * @public\n */\n\nimport type { RetrievalResult, Retriever } from \"./types.js\";\n\nexport interface VectorIndex {\n  search(query: string, topK: number): Promise<RetrievalResult[]>;\n}\n\nexport interface VectorRetrieverOptions {\n  index: VectorIndex;\n  topK?: number;\n}\n\nexport class VectorRetriever implements Retriever {\n  private readonly _index: VectorIndex;\n  private readonly _defaultTopK: number;\n\n  constructor(opts: VectorRetrieverOptions) {\n    this._index = opts.index;\n    this._defaultTopK = opts.topK ?? 5;\n  }\n\n  async retrieve(query: string, options?: { topK?: number }): Promise<RetrievalResult[]> {\n    const topK = options?.topK ?? this._defaultTopK;\n    return this._index.search(query, topK);\n  }\n}\n","/**\n * Text splitting strategies for RAG pipelines (T11.1, ADR D448).\n *\n * Three strategies: character, sentence, recursive (paragraph→sentence→char).\n * All return Chunk[] with text + index. Empty input → empty array (EC-5).\n *\n * @public\n */\n\nimport type { Chunk, SplitOptions } from \"./types.js\";\n\nfunction makeChunks(texts: string[]): Chunk[] {\n  return texts.filter((t) => t.length > 0).map((text, index) => ({ text, index }));\n}\n\nexport function splitByCharacter(text: string, opts: SplitOptions): Chunk[] {\n  if (text.length === 0) return [];\n  const { chunkSize, overlap = 0 } = opts;\n  const step = Math.max(1, chunkSize - overlap);\n  const parts: string[] = [];\n  for (let i = 0; i < text.length; i += step) {\n    parts.push(text.slice(i, i + chunkSize));\n  }\n  return makeChunks(parts);\n}\n\nconst SENTENCE_RE = /(?<=[.!?])\\s+/;\n\nexport function splitBySentence(text: string, opts: SplitOptions): Chunk[] {\n  if (text.length === 0) return [];\n  const { chunkSize } = opts;\n  const sentences = text.split(SENTENCE_RE);\n  const parts: string[] = [];\n  let current = \"\";\n  for (const sentence of sentences) {\n    if (current.length + sentence.length + 1 > chunkSize && current.length > 0) {\n      parts.push(current.trim());\n      current = sentence;\n    } else {\n      current = current.length > 0 ? `${current} ${sentence}` : sentence;\n    }\n  }\n  if (current.length > 0) parts.push(current.trim());\n  return makeChunks(parts);\n}\n\nconst PARAGRAPH_RE = /\\n\\n+/;\n\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: recursive splitter inherently cascades through 3 levels (paragraph→sentence→char)\nexport function splitRecursive(text: string, opts: SplitOptions): Chunk[] {\n  if (text.length === 0) return [];\n  const { chunkSize, overlap = 0 } = opts;\n\n  // Level 1: split by paragraph\n  const paragraphs = text.split(PARAGRAPH_RE).filter((p) => p.length > 0);\n  const result: string[] = [];\n\n  for (const para of paragraphs) {\n    if (para.length <= chunkSize) {\n      result.push(para);\n    } else {\n      // Level 2: split by sentence\n      const sentenceChunks = splitBySentence(para, { chunkSize, overlap });\n      for (const sc of sentenceChunks) {\n        if (sc.text.length <= chunkSize) {\n          result.push(sc.text);\n        } else {\n          // Level 3: split by character\n          const charChunks = splitByCharacter(sc.text, { chunkSize, overlap });\n          for (const cc of charChunks) {\n            result.push(cc.text);\n          }\n        }\n      }\n    }\n  }\n\n  return makeChunks(result);\n}\n"]}

package/dist/rag/index.d.cts

@@ -1,11 +0,0 @@
-/**
- * RAG (Retrieval-Augmented Generation) sub-path barrel (T11.1, ADR D448).
- *
- * Exported via `@theokit/sdk/rag`.
- *
- * @public
- */
-export { CohereReranker, type CohereRerankerOptions, NoopReranker } from "./reranker.js";
-export { type VectorIndex, VectorRetriever, type VectorRetrieverOptions } from "./retriever.js";
-export { splitByCharacter, splitBySentence, splitRecursive } from "./text-splitter.js";
-export type { Chunk, Document, RankedChunk, Reranker, RetrievalResult, Retriever, SplitOptions, } from "./types.js";

package/dist/rag/index.d.ts

@@ -1,11 +0,0 @@
-/**
- * RAG (Retrieval-Augmented Generation) sub-path barrel (T11.1, ADR D448).
- *
- * Exported via `@theokit/sdk/rag`.
- *
- * @public
- */
-export { CohereReranker, type CohereRerankerOptions, NoopReranker } from "./reranker.js";
-export { type VectorIndex, VectorRetriever, type VectorRetrieverOptions } from "./retriever.js";
-export { splitByCharacter, splitBySentence, splitRecursive } from "./text-splitter.js";
-export type { Chunk, Document, RankedChunk, Reranker, RetrievalResult, Retriever, SplitOptions, } from "./types.js";

package/dist/rag/index.js

@@ -1,129 +0,0 @@
-// src/rag/reranker.ts
-var NoopReranker = class {
-  async rerank(_query, chunks) {
-    return chunks.map((c, i) => ({
-      text: c.text,
-      score: c.score,
-      originalIndex: i,
-      metadata: c.metadata
-    }));
-  }
-};
-var CohereReranker = class {
-  _apiKey;
-  _model;
-  _mockRerank;
-  constructor(opts) {
-    this._apiKey = opts.apiKey;
-    this._model = opts.model ?? "rerank-v3.5";
-    this._mockRerank = opts._mockRerank;
-  }
-  async rerank(query, chunks) {
-    if (chunks.length === 0) return [];
-    if (this._mockRerank) {
-      return this._mockRerank(query, chunks);
-    }
-    const response = await fetch("https://api.cohere.com/v2/rerank", {
-      method: "POST",
-      headers: {
-        Authorization: `Bearer ${this._apiKey}`,
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify({
-        model: this._model,
-        query,
-        documents: chunks.map((c) => c.text),
-        top_n: chunks.length
-      })
-    });
-    if (!response.ok) {
-      throw new Error(`Cohere rerank failed: ${response.status} ${response.statusText}`);
-    }
-    const data = await response.json();
-    return data.results.map((r) => {
-      const chunk = chunks[r.index];
-      return {
-        text: chunk?.text ?? "",
-        score: r.relevance_score,
-        originalIndex: r.index,
-        metadata: chunk?.metadata
-      };
-    });
-  }
-};
-
-// src/rag/retriever.ts
-var VectorRetriever = class {
-  _index;
-  _defaultTopK;
-  constructor(opts) {
-    this._index = opts.index;
-    this._defaultTopK = opts.topK ?? 5;
-  }
-  async retrieve(query, options) {
-    const topK = options?.topK ?? this._defaultTopK;
-    return this._index.search(query, topK);
-  }
-};
-
-// src/rag/text-splitter.ts
-function makeChunks(texts) {
-  return texts.filter((t) => t.length > 0).map((text, index) => ({ text, index }));
-}
-function splitByCharacter(text, opts) {
-  if (text.length === 0) return [];
-  const { chunkSize, overlap = 0 } = opts;
-  const step = Math.max(1, chunkSize - overlap);
-  const parts = [];
-  for (let i = 0; i < text.length; i += step) {
-    parts.push(text.slice(i, i + chunkSize));
-  }
-  return makeChunks(parts);
-}
-var SENTENCE_RE = /(?<=[.!?])\s+/;
-function splitBySentence(text, opts) {
-  if (text.length === 0) return [];
-  const { chunkSize } = opts;
-  const sentences = text.split(SENTENCE_RE);
-  const parts = [];
-  let current = "";
-  for (const sentence of sentences) {
-    if (current.length + sentence.length + 1 > chunkSize && current.length > 0) {
-      parts.push(current.trim());
-      current = sentence;
-    } else {
-      current = current.length > 0 ? `${current} ${sentence}` : sentence;
-    }
-  }
-  if (current.length > 0) parts.push(current.trim());
-  return makeChunks(parts);
-}
-var PARAGRAPH_RE = /\n\n+/;
-function splitRecursive(text, opts) {
-  if (text.length === 0) return [];
-  const { chunkSize, overlap = 0 } = opts;
-  const paragraphs = text.split(PARAGRAPH_RE).filter((p) => p.length > 0);
-  const result = [];
-  for (const para of paragraphs) {
-    if (para.length <= chunkSize) {
-      result.push(para);
-    } else {
-      const sentenceChunks = splitBySentence(para, { chunkSize});
-      for (const sc of sentenceChunks) {
-        if (sc.text.length <= chunkSize) {
-          result.push(sc.text);
-        } else {
-          const charChunks = splitByCharacter(sc.text, { chunkSize, overlap });
-          for (const cc of charChunks) {
-            result.push(cc.text);
-          }
-        }
-      }
-    }
-  }
-  return makeChunks(result);
-}
-
-export { CohereReranker, NoopReranker, VectorRetriever, splitByCharacter, splitBySentence, splitRecursive };
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/dist/rag/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/rag/reranker.ts","../../src/rag/retriever.ts","../../src/rag/text-splitter.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Reranker implementations for RAG pipelines (T11.1, ADR D448).\n *\n * NoopReranker: passes through results unchanged (baseline).\n * CohereReranker: calls the Cohere Rerank API (optional peer dep).\n *\n * @public\n */\n\nimport type { RankedChunk, Reranker, RetrievalResult } from \"./types.js\";\n\nexport class NoopReranker implements Reranker {\n  async rerank(_query: string, chunks: RetrievalResult[]): Promise<RankedChunk[]> {\n    return chunks.map((c, i) => ({\n      text: c.text,\n      score: c.score,\n      originalIndex: i,\n      metadata: c.metadata,\n    }));\n  }\n}\n\ntype MockRerankFn = (query: string, docs: RetrievalResult[]) => Promise<RankedChunk[]>;\n\nexport interface CohereRerankerOptions {\n  apiKey: string;\n  model?: string;\n  _mockRerank?: MockRerankFn;\n}\n\nexport class CohereReranker implements Reranker {\n  private readonly _apiKey: string;\n  private readonly _model: string;\n  private readonly _mockRerank?: MockRerankFn;\n\n  constructor(opts: CohereRerankerOptions) {\n    this._apiKey = opts.apiKey;\n    this._model = opts.model ?? \"rerank-v3.5\";\n    this._mockRerank = opts._mockRerank;\n  }\n\n  async rerank(query: string, chunks: RetrievalResult[]): Promise<RankedChunk[]> {\n    if (chunks.length === 0) return [];\n\n    if (this._mockRerank) {\n      return this._mockRerank(query, chunks);\n    }\n\n    const response = await fetch(\"https://api.cohere.com/v2/rerank\", {\n      method: \"POST\",\n      headers: {\n        Authorization: `Bearer ${this._apiKey}`,\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify({\n        model: this._model,\n        query,\n        documents: chunks.map((c) => c.text),\n        top_n: chunks.length,\n      }),\n    });\n\n    if (!response.ok) {\n      throw new Error(`Cohere rerank failed: ${response.status} ${response.statusText}`);\n    }\n\n    const data = (await response.json()) as {\n      results: Array<{ index: number; relevance_score: number }>;\n    };\n\n    return data.results.map((r) => {\n      const chunk = chunks[r.index];\n      return {\n        text: chunk?.text ?? \"\",\n        score: r.relevance_score,\n        originalIndex: r.index,\n        metadata: chunk?.metadata,\n      };\n    });\n  }\n}\n","/**\n * Retriever implementations for RAG pipelines (T11.1, ADR D448).\n *\n * VectorRetriever wraps any index that implements `search(query, topK)`.\n * The Retriever interface is the contract — consumers depend on the interface,\n * implementations depend on the index adapter (DIP per architecture.md § 2).\n *\n * @public\n */\n\nimport type { RetrievalResult, Retriever } from \"./types.js\";\n\nexport interface VectorIndex {\n  search(query: string, topK: number): Promise<RetrievalResult[]>;\n}\n\nexport interface VectorRetrieverOptions {\n  index: VectorIndex;\n  topK?: number;\n}\n\nexport class VectorRetriever implements Retriever {\n  private readonly _index: VectorIndex;\n  private readonly _defaultTopK: number;\n\n  constructor(opts: VectorRetrieverOptions) {\n    this._index = opts.index;\n    this._defaultTopK = opts.topK ?? 5;\n  }\n\n  async retrieve(query: string, options?: { topK?: number }): Promise<RetrievalResult[]> {\n    const topK = options?.topK ?? this._defaultTopK;\n    return this._index.search(query, topK);\n  }\n}\n","/**\n * Text splitting strategies for RAG pipelines (T11.1, ADR D448).\n *\n * Three strategies: character, sentence, recursive (paragraph→sentence→char).\n * All return Chunk[] with text + index. Empty input → empty array (EC-5).\n *\n * @public\n */\n\nimport type { Chunk, SplitOptions } from \"./types.js\";\n\nfunction makeChunks(texts: string[]): Chunk[] {\n  return texts.filter((t) => t.length > 0).map((text, index) => ({ text, index }));\n}\n\nexport function splitByCharacter(text: string, opts: SplitOptions): Chunk[] {\n  if (text.length === 0) return [];\n  const { chunkSize, overlap = 0 } = opts;\n  const step = Math.max(1, chunkSize - overlap);\n  const parts: string[] = [];\n  for (let i = 0; i < text.length; i += step) {\n    parts.push(text.slice(i, i + chunkSize));\n  }\n  return makeChunks(parts);\n}\n\nconst SENTENCE_RE = /(?<=[.!?])\\s+/;\n\nexport function splitBySentence(text: string, opts: SplitOptions): Chunk[] {\n  if (text.length === 0) return [];\n  const { chunkSize } = opts;\n  const sentences = text.split(SENTENCE_RE);\n  const parts: string[] = [];\n  let current = \"\";\n  for (const sentence of sentences) {\n    if (current.length + sentence.length + 1 > chunkSize && current.length > 0) {\n      parts.push(current.trim());\n      current = sentence;\n    } else {\n      current = current.length > 0 ? `${current} ${sentence}` : sentence;\n    }\n  }\n  if (current.length > 0) parts.push(current.trim());\n  return makeChunks(parts);\n}\n\nconst PARAGRAPH_RE = /\\n\\n+/;\n\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: recursive splitter inherently cascades through 3 levels (paragraph→sentence→char)\nexport function splitRecursive(text: string, opts: SplitOptions): Chunk[] {\n  if (text.length === 0) return [];\n  const { chunkSize, overlap = 0 } = opts;\n\n  // Level 1: split by paragraph\n  const paragraphs = text.split(PARAGRAPH_RE).filter((p) => p.length > 0);\n  const result: string[] = [];\n\n  for (const para of paragraphs) {\n    if (para.length <= chunkSize) {\n      result.push(para);\n    } else {\n      // Level 2: split by sentence\n      const sentenceChunks = splitBySentence(para, { chunkSize, overlap });\n      for (const sc of sentenceChunks) {\n        if (sc.text.length <= chunkSize) {\n          result.push(sc.text);\n        } else {\n          // Level 3: split by character\n          const charChunks = splitByCharacter(sc.text, { chunkSize, overlap });\n          for (const cc of charChunks) {\n            result.push(cc.text);\n          }\n        }\n      }\n    }\n  }\n\n  return makeChunks(result);\n}\n"]}