@theokit/sdk 1.8.1 → 2.0.0

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>;
-}