@theokit/sdk 1.9.0 → 2.0.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 2.0.0
+
+### Major Changes
+
+- b9f30a6: Carve the non-Harness surface out of `@theokit/sdk` (plan `monorepo-cohesion-split`). The SDK now ships only the Agent-AI Harness.
+
+  BREAKING (no retro-compat, authorized):
+
+  - Removed the `@theokit/sdk/rag` sub-path export and the embedded `voice` module — they moved to standalone `@theokit/rag` / `@theokit/voice` packages (repos `theokit-rag` / `theokit-voice`). Import those packages instead.
+  - Decorator-first DX is no longer required of Harness features (ADR D431). `@theokit/di` / `@theokit/di-agent` / `@theokit/orm` moved to `theokit-backend-dx`, the gateway packages to `theokit-gateways`, `@theokit/react` to `theokit-react`, and `@theokit/skills-google-workspace` to the Skills pillar. Decorators remain available as an optional layer via the externally-published `@theokit/di`.
+
+  The surviving `@theokit/sdk-*` extension peer specifiers stay as semver ranges (`>=1.7.0`), satisfying the publish-readiness gate.
+
 ## 1.9.0
 
 ### Minor Changes
@@ -53,7 +66,7 @@
 
 - **Compression config resolution module (T2.2 step 2/N of plan `sdk-superiority-2026-06-07`, ADR D440)**: `resolveCompressionConfig(agentModel, config): ResolvedCompressionConfig` bridges the compression-model-registry (step 1) with the `Agent.create({compression})` override surface. Resolves: (a) compression model — registry default OR explicit `config.model` override; (b) API key — first-match chain: explicit `config.apiKey` → `THEOKIT_COMPRESSION_API_KEY` env var → undefined (signals aux-LLM client to use agent's main CredentialPool); (c) maxAttempts (default 3) + grace (default 1). Pure config resolution — no I/O. 11 new tests at `tests/internal/runtime/compression-config.test.ts`. Foundation for step 3 (aux-llm-client with OTel span) and step 4 (agent-loop wire).
 
-- **Model capabilities introspection registry (T3.10c step 1 of plan `sdk-superiority-2026-06-07`, DR3 #17)**: pre-T3.10c the SDK had no way to query a model's capability flags before sending a request — consumers who sent vision content to a text-only model or structured-output requests to a model without json_schema support got an opaque 400 from the provider. T3.10c step 1 adds the foundation pure-function registry `resolveModelCapabilities(modelId): ModelCapabilities` with typed per-model flags: `supportsVision`, `supportsStructuredOutput`, `supportsToolUse`, `supportsCacheControl`, `maxContextTokens`, `maxOutputTokens`. Resolution algorithm: strip routing prefixes (openrouter/, vertex/, bedrock/), exact-match against the vendor-model registry, then infer vendor from model name (claude-_ → anthropic/, gpt-_ → openai/, gemini-\* → google/) for routing-prefixed lookups. Unknown models return conservative defaults (all false, 4096/4096 token counts) — never optimistic assumptions. Initial registry covers OpenAI (gpt-4o/4o-mini/4-turbo/o1/o3) and Anthropic (claude-opus-4/sonnet-4/3-5-sonnet/3-haiku/3-opus) families. 9 new tests at `tests/internal/llm/model-capabilities.test.ts`. Foundation for step 2 (public `Theokit.models.capabilities()` API) and step 3 (Agent.create boundary gate + `CapabilityNotSupportedError`).
+- **Model capabilities introspection registry (T3.10c step 1 of plan `sdk-superiority-2026-06-07`, DR3 #17)**: pre-T3.10c the SDK had no way to query a model's capability flags before sending a request — consumers who sent vision content to a text-only model or structured-output requests to a model without json*schema support got an opaque 400 from the provider. T3.10c step 1 adds the foundation pure-function registry `resolveModelCapabilities(modelId): ModelCapabilities` with typed per-model flags: `supportsVision`, `supportsStructuredOutput`, `supportsToolUse`, `supportsCacheControl`, `maxContextTokens`, `maxOutputTokens`. Resolution algorithm: strip routing prefixes (openrouter/, vertex/, bedrock/), exact-match against the vendor-model registry, then infer vendor from model name (claude-* → anthropic/, gpt-\_ → openai/, gemini-\* → google/) for routing-prefixed lookups. Unknown models return conservative defaults (all false, 4096/4096 token counts) — never optimistic assumptions. Initial registry covers OpenAI (gpt-4o/4o-mini/4-turbo/o1/o3) and Anthropic (claude-opus-4/sonnet-4/3-5-sonnet/3-haiku/3-opus) families. 9 new tests at `tests/internal/llm/model-capabilities.test.ts`. Foundation for step 2 (public `Theokit.models.capabilities()` API) and step 3 (Agent.create boundary gate + `CapabilityNotSupportedError`).
 
 ### Fixed
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/sdk",
-  "version": "1.9.0",
+  "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",

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":";AAWO,IAAM,eAAN,MAAuC;AAAA,EAC5C,MAAM,MAAA,CAAO,MAAA,EAAgB,MAAA,EAAmD;AAC9E,IAAA,OAAO,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,EAAG,CAAA,MAAO;AAAA,MAC3B,MAAM,CAAA,CAAE,IAAA;AAAA,MACR,OAAO,CAAA,CAAE,KAAA;AAAA,MACT,aAAA,EAAe,CAAA;AAAA,MACf,UAAU,CAAA,CAAE;AAAA,KACd,CAAE,CAAA;AAAA,EACJ;AACF;AAUO,IAAM,iBAAN,MAAyC;AAAA,EAC7B,OAAA;AAAA,EACA,MAAA;AAAA,EACA,WAAA;AAAA,EAEjB,YAAY,IAAA,EAA6B;AACvC,IAAA,IAAA,CAAK,UAAU,IAAA,CAAK,MAAA;AACpB,IAAA,IAAA,CAAK,MAAA,GAAS,KAAK,KAAA,IAAS,aAAA;AAC5B,IAAA,IAAA,CAAK,cAAc,IAAA,CAAK,WAAA;AAAA,EAC1B;AAAA,EAEA,MAAM,MAAA,CAAO,KAAA,EAAe,MAAA,EAAmD;AAC7E,IAAA,IAAI,MAAA,CAAO,MAAA,KAAW,CAAA,EAAG,OAAO,EAAC;AAEjC,IAAA,IAAI,KAAK,WAAA,EAAa;AACpB,MAAA,OAAO,IAAA,CAAK,WAAA,CAAY,KAAA,EAAO,MAAM,CAAA;AAAA,IACvC;AAEA,IAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,kCAAA,EAAoC;AAAA,MAC/D,MAAA,EAAQ,MAAA;AAAA,MACR,OAAA,EAAS;AAAA,QACP,aAAA,EAAe,CAAA,OAAA,EAAU,IAAA,CAAK,OAAO,CAAA,CAAA;AAAA,QACrC,cAAA,EAAgB;AAAA,OAClB;AAAA,MACA,IAAA,EAAM,KAAK,SAAA,CAAU;AAAA,QACnB,OAAO,IAAA,CAAK,MAAA;AAAA,QACZ,KAAA;AAAA,QACA,WAAW,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,KAAM,EAAE,IAAI,CAAA;AAAA,QACnC,OAAO,MAAA,CAAO;AAAA,OACf;AAAA,KACF,CAAA;AAED,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,MAAM,IAAI,MAAM,CAAA,sBAAA,EAAyB,QAAA,CAAS,MAAM,CAAA,CAAA,EAAI,QAAA,CAAS,UAAU,CAAA,CAAE,CAAA;AAAA,IACnF;AAEA,IAAA,MAAM,IAAA,GAAQ,MAAM,QAAA,CAAS,IAAA,EAAK;AAIlC,IAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,KAAM;AAC7B,MAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,CAAA,CAAE,KAAK,CAAA;AAC5B,MAAA,OAAO;AAAA,QACL,IAAA,EAAM,OAAO,IAAA,IAAQ,EAAA;AAAA,QACrB,OAAO,CAAA,CAAE,eAAA;AAAA,QACT,eAAe,CAAA,CAAE,KAAA;AAAA,QACjB,UAAU,KAAA,EAAO;AAAA,OACnB;AAAA,IACF,CAAC,CAAA;AAAA,EACH;AACF;;;AC3DO,IAAM,kBAAN,MAA2C;AAAA,EAC/B,MAAA;AAAA,EACA,YAAA;AAAA,EAEjB,YAAY,IAAA,EAA8B;AACxC,IAAA,IAAA,CAAK,SAAS,IAAA,CAAK,KAAA;AACnB,IAAA,IAAA,CAAK,YAAA,GAAe,KAAK,IAAA,IAAQ,CAAA;AAAA,EACnC;AAAA,EAEA,MAAM,QAAA,CAAS,KAAA,EAAe,OAAA,EAAyD;AACrF,IAAA,MAAM,IAAA,GAAO,OAAA,EAAS,IAAA,IAAQ,IAAA,CAAK,YAAA;AACnC,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,MAAA,CAAO,KAAA,EAAO,IAAI,CAAA;AAAA,EACvC;AACF;;;ACvBA,SAAS,WAAW,KAAA,EAA0B;AAC5C,EAAA,OAAO,KAAA,CAAM,MAAA,CAAO,CAAC,CAAA,KAAM,EAAE,MAAA,GAAS,CAAC,CAAA,CAAE,GAAA,CAAI,CAAC,IAAA,EAAM,KAAA,MAAW,EAAE,IAAA,EAAM,OAAM,CAAE,CAAA;AACjF;AAEO,SAAS,gBAAA,CAAiB,MAAc,IAAA,EAA6B;AAC1E,EAAA,IAAI,IAAA,CAAK,MAAA,KAAW,CAAA,EAAG,OAAO,EAAC;AAC/B,EAAA,MAAM,EAAE,SAAA,EAAW,OAAA,GAAU,CAAA,EAAE,GAAI,IAAA;AACnC,EAAA,MAAM,IAAA,GAAO,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,YAAY,OAAO,CAAA;AAC5C,EAAA,MAAM,QAAkB,EAAC;AACzB,EAAA,KAAA,IAAS,IAAI,CAAA,EAAG,CAAA,GAAI,IAAA,CAAK,MAAA,EAAQ,KAAK,IAAA,EAAM;AAC1C,IAAA,KAAA,CAAM,KAAK,IAAA,CAAK,KAAA,CAAM,CAAA,EAAG,CAAA,GAAI,SAAS,CAAC,CAAA;AAAA,EACzC;AACA,EAAA,OAAO,WAAW,KAAK,CAAA;AACzB;AAEA,IAAM,WAAA,GAAc,eAAA;AAEb,SAAS,eAAA,CAAgB,MAAc,IAAA,EAA6B;AACzE,EAAA,IAAI,IAAA,CAAK,MAAA,KAAW,CAAA,EAAG,OAAO,EAAC;AAC/B,EAAA,MAAM,EAAE,WAAU,GAAI,IAAA;AACtB,EAAA,MAAM,SAAA,GAAY,IAAA,CAAK,KAAA,CAAM,WAAW,CAAA;AACxC,EAAA,MAAM,QAAkB,EAAC;AACzB,EAAA,IAAI,OAAA,GAAU,EAAA;AACd,EAAA,KAAA,MAAW,YAAY,SAAA,EAAW;AAChC,IAAA,IAAI,OAAA,CAAQ,SAAS,QAAA,CAAS,MAAA,GAAS,IAAI,SAAA,IAAa,OAAA,CAAQ,SAAS,CAAA,EAAG;AAC1E,MAAA,KAAA,CAAM,IAAA,CAAK,OAAA,CAAQ,IAAA,EAAM,CAAA;AACzB,MAAA,OAAA,GAAU,QAAA;AAAA,IACZ,CAAA,MAAO;AACL,MAAA,OAAA,GAAU,QAAQ,MAAA,GAAS,CAAA,GAAI,GAAG,OAAO,CAAA,CAAA,EAAI,QAAQ,CAAA,CAAA,GAAK,QAAA;AAAA,IAC5D;AAAA,EACF;AACA,EAAA,IAAI,QAAQ,MAAA,GAAS,CAAA,QAAS,IAAA,CAAK,OAAA,CAAQ,MAAM,CAAA;AACjD,EAAA,OAAO,WAAW,KAAK,CAAA;AACzB;AAEA,IAAM,YAAA,GAAe,OAAA;AAGd,SAAS,cAAA,CAAe,MAAc,IAAA,EAA6B;AACxE,EAAA,IAAI,IAAA,CAAK,MAAA,KAAW,CAAA,EAAG,OAAO,EAAC;AAC/B,EAAA,MAAM,EAAE,SAAA,EAAW,OAAA,GAAU,CAAA,EAAE,GAAI,IAAA;AAGnC,EAAA,MAAM,UAAA,GAAa,IAAA,CAAK,KAAA,CAAM,YAAY,CAAA,CAAE,OAAO,CAAC,CAAA,KAAM,CAAA,CAAE,MAAA,GAAS,CAAC,CAAA;AACtE,EAAA,MAAM,SAAmB,EAAC;AAE1B,EAAA,KAAA,MAAW,QAAQ,UAAA,EAAY;AAC7B,IAAA,IAAI,IAAA,CAAK,UAAU,SAAA,EAAW;AAC5B,MAAA,MAAA,CAAO,KAAK,IAAI,CAAA;AAAA,IAClB,CAAA,MAAO;AAEL,MAAA,MAAM,iBAAiB,eAAA,CAAgB,IAAA,EAAM,EAAE,SAAmB,CAAC,CAAA;AACnE,MAAA,KAAA,MAAW,MAAM,cAAA,EAAgB;AAC/B,QAAA,IAAI,EAAA,CAAG,IAAA,CAAK,MAAA,IAAU,SAAA,EAAW;AAC/B,UAAA,MAAA,CAAO,IAAA,CAAK,GAAG,IAAI,CAAA;AAAA,QACrB,CAAA,MAAO;AAEL,UAAA,MAAM,aAAa,gBAAA,CAAiB,EAAA,CAAG,MAAM,EAAE,SAAA,EAAW,SAAS,CAAA;AACnE,UAAA,KAAA,MAAW,MAAM,UAAA,EAAY;AAC3B,YAAA,MAAA,CAAO,IAAA,CAAK,GAAG,IAAI,CAAA;AAAA,UACrB;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,WAAW,MAAM,CAAA;AAC1B","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"]}

package/dist/rag/reranker.d.cts

@@ -1,26 +0,0 @@
-/**
- * Reranker implementations for RAG pipelines (T11.1, ADR D448).
- *
- * NoopReranker: passes through results unchanged (baseline).
- * CohereReranker: calls the Cohere Rerank API (optional peer dep).
- *
- * @public
- */
-import type { RankedChunk, Reranker, RetrievalResult } from "./types.js";
-export declare class NoopReranker implements Reranker {
-    rerank(_query: string, chunks: RetrievalResult[]): Promise<RankedChunk[]>;
-}
-type MockRerankFn = (query: string, docs: RetrievalResult[]) => Promise<RankedChunk[]>;
-export interface CohereRerankerOptions {
-    apiKey: string;
-    model?: string;
-    _mockRerank?: MockRerankFn;
-}
-export declare class CohereReranker implements Reranker {
-    private readonly _apiKey;
-    private readonly _model;
-    private readonly _mockRerank?;
-    constructor(opts: CohereRerankerOptions);
-    rerank(query: string, chunks: RetrievalResult[]): Promise<RankedChunk[]>;
-}
-export {};

package/dist/rag/reranker.d.ts

@@ -1,26 +0,0 @@
-/**
- * Reranker implementations for RAG pipelines (T11.1, ADR D448).
- *
- * NoopReranker: passes through results unchanged (baseline).
- * CohereReranker: calls the Cohere Rerank API (optional peer dep).
- *
- * @public
- */
-import type { RankedChunk, Reranker, RetrievalResult } from "./types.js";
-export declare class NoopReranker implements Reranker {
-    rerank(_query: string, chunks: RetrievalResult[]): Promise<RankedChunk[]>;
-}
-type MockRerankFn = (query: string, docs: RetrievalResult[]) => Promise<RankedChunk[]>;
-export interface CohereRerankerOptions {
-    apiKey: string;
-    model?: string;
-    _mockRerank?: MockRerankFn;
-}
-export declare class CohereReranker implements Reranker {
-    private readonly _apiKey;
-    private readonly _model;
-    private readonly _mockRerank?;
-    constructor(opts: CohereRerankerOptions);
-    rerank(query: string, chunks: RetrievalResult[]): Promise<RankedChunk[]>;
-}
-export {};

package/dist/rag/retriever.d.cts

@@ -1,25 +0,0 @@
-/**
- * Retriever implementations for RAG pipelines (T11.1, ADR D448).
- *
- * VectorRetriever wraps any index that implements `search(query, topK)`.
- * The Retriever interface is the contract — consumers depend on the interface,
- * implementations depend on the index adapter (DIP per architecture.md § 2).
- *
- * @public
- */
-import type { RetrievalResult, Retriever } from "./types.js";
-export interface VectorIndex {
-    search(query: string, topK: number): Promise<RetrievalResult[]>;
-}
-export interface VectorRetrieverOptions {
-    index: VectorIndex;
-    topK?: number;
-}
-export declare class VectorRetriever implements Retriever {
-    private readonly _index;
-    private readonly _defaultTopK;
-    constructor(opts: VectorRetrieverOptions);
-    retrieve(query: string, options?: {
-        topK?: number;
-    }): Promise<RetrievalResult[]>;
-}

package/dist/rag/retriever.d.ts

@@ -1,25 +0,0 @@
-/**
- * Retriever implementations for RAG pipelines (T11.1, ADR D448).
- *
- * VectorRetriever wraps any index that implements `search(query, topK)`.
- * The Retriever interface is the contract — consumers depend on the interface,
- * implementations depend on the index adapter (DIP per architecture.md § 2).
- *
- * @public
- */
-import type { RetrievalResult, Retriever } from "./types.js";
-export interface VectorIndex {
-    search(query: string, topK: number): Promise<RetrievalResult[]>;
-}
-export interface VectorRetrieverOptions {
-    index: VectorIndex;
-    topK?: number;
-}
-export declare class VectorRetriever implements Retriever {
-    private readonly _index;
-    private readonly _defaultTopK;
-    constructor(opts: VectorRetrieverOptions);
-    retrieve(query: string, options?: {
-        topK?: number;
-    }): Promise<RetrievalResult[]>;
-}

package/dist/rag/text-splitter.d.cts

@@ -1,12 +0,0 @@
-/**
- * Text splitting strategies for RAG pipelines (T11.1, ADR D448).
- *
- * Three strategies: character, sentence, recursive (paragraph→sentence→char).
- * All return Chunk[] with text + index. Empty input → empty array (EC-5).
- *
- * @public
- */
-import type { Chunk, SplitOptions } from "./types.js";
-export declare function splitByCharacter(text: string, opts: SplitOptions): Chunk[];
-export declare function splitBySentence(text: string, opts: SplitOptions): Chunk[];
-export declare function splitRecursive(text: string, opts: SplitOptions): Chunk[];

package/dist/rag/text-splitter.d.ts

@@ -1,12 +0,0 @@
-/**
- * Text splitting strategies for RAG pipelines (T11.1, ADR D448).
- *
- * Three strategies: character, sentence, recursive (paragraph→sentence→char).
- * All return Chunk[] with text + index. Empty input → empty array (EC-5).
- *
- * @public
- */
-import type { Chunk, SplitOptions } from "./types.js";
-export declare function splitByCharacter(text: string, opts: SplitOptions): Chunk[];
-export declare function splitBySentence(text: string, opts: SplitOptions): Chunk[];
-export declare function splitRecursive(text: string, opts: SplitOptions): Chunk[];

package/dist/rag/types.d.cts

@@ -1,37 +0,0 @@
-/**
- * RAG types — Document, Chunk, RetrievalResult (T11.1, ADR D448).
- * @public
- */
-export interface Document {
-    id: string;
-    text: string;
-    metadata?: Record<string, unknown>;
-}
-export interface Chunk {
-    text: string;
-    index: number;
-    metadata?: Record<string, unknown>;
-}
-export interface RetrievalResult {
-    text: string;
-    score: number;
-    metadata?: Record<string, unknown>;
-}
-export interface RankedChunk {
-    text: string;
-    score: number;
-    originalIndex: number;
-    metadata?: Record<string, unknown>;
-}
-export interface SplitOptions {
-    chunkSize: number;
-    overlap?: number;
-}
-export interface Retriever {
-    retrieve(query: string, options?: {
-        topK?: number;
-    }): Promise<RetrievalResult[]>;
-}
-export interface Reranker {
-    rerank(query: string, chunks: RetrievalResult[]): Promise<RankedChunk[]>;
-}

package/dist/rag/types.d.ts

@@ -1,37 +0,0 @@
-/**
- * RAG types — Document, Chunk, RetrievalResult (T11.1, ADR D448).
- * @public
- */
-export interface Document {
-    id: string;
-    text: string;
-    metadata?: Record<string, unknown>;
-}
-export interface Chunk {
-    text: string;
-    index: number;
-    metadata?: Record<string, unknown>;
-}
-export interface RetrievalResult {
-    text: string;
-    score: number;
-    metadata?: Record<string, unknown>;
-}
-export interface RankedChunk {
-    text: string;
-    score: number;
-    originalIndex: number;
-    metadata?: Record<string, unknown>;
-}
-export interface SplitOptions {
-    chunkSize: number;
-    overlap?: number;
-}
-export interface Retriever {
-    retrieve(query: string, options?: {
-        topK?: number;
-    }): Promise<RetrievalResult[]>;
-}
-export interface Reranker {
-    rerank(query: string, chunks: RetrievalResult[]): Promise<RankedChunk[]>;
-}

package/dist/voice/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * Voice sub-path barrel (T12.3).
- * Exported via `@theokit/sdk/voice`.
- * @public @experimental
- */
-export { OpenAIRealtimeVoiceProvider } from "./openai-realtime.js";
-export type { STTOptions, STTResult, TTSOptions, TTSResult, VoiceProvider } from "./types.js";

package/dist/voice/openai-realtime.d.ts

@@ -1,21 +0,0 @@
-/**
- * OpenAI Realtime voice provider — TTS via OpenAI Audio API (T12.3).
- *
- * Optional peer dep: none (uses native fetch).
- *
- * @public @experimental
- */
-import type { STTOptions, STTResult, TTSOptions, TTSResult, VoiceProvider } from "./types.js";
-interface OpenAIRealtimeVoiceProviderOptions {
-    apiKey: string;
-    baseUrl?: string;
-}
-export declare class OpenAIRealtimeVoiceProvider implements VoiceProvider {
-    readonly name = "openai-realtime";
-    private readonly _apiKey;
-    private readonly _baseUrl;
-    constructor(opts: OpenAIRealtimeVoiceProviderOptions);
-    textToSpeech(text: string, opts?: TTSOptions): Promise<TTSResult>;
-    speechToText(audio: Buffer | Uint8Array, opts?: STTOptions): Promise<STTResult>;
-}
-export {};

package/dist/voice/types.d.ts

@@ -1,35 +0,0 @@
-/**
- * VoiceProvider interface — foundation for TTS/STT adapters (T12.3).
- * @public @experimental
- */
-export interface TTSOptions {
-    model?: string;
-    voice?: string;
-    speed?: number;
-    format?: "mp3" | "opus" | "aac" | "flac" | "wav" | "pcm";
-}
-export interface STTOptions {
-    model?: string;
-    language?: string;
-    prompt?: string;
-}
-export interface TTSResult {
-    audio: Buffer | Uint8Array;
-    format: string;
-    durationMs?: number;
-}
-export interface STTResult {
-    text: string;
-    language?: string;
-    durationMs?: number;
-    segments?: Array<{
-        start: number;
-        end: number;
-        text: string;
-    }>;
-}
-export interface VoiceProvider {
-    readonly name: string;
-    textToSpeech(text: string, opts?: TTSOptions): Promise<TTSResult>;
-    speechToText(audio: Buffer | Uint8Array, opts?: STTOptions): Promise<STTResult>;
-}