searchsocket 0.2.0

package/dist/index.d.cts

@@ -0,0 +1,119 @@
+import { R as ResolvedSearchSocketConfig, b as SearchSocketConfig, c as Scope, E as EmbeddingsProvider, d as Reranker, e as RerankCandidate, V as VectorStore, I as IndexOptions, f as IndexStats, S as SearchRequest, a as SearchResponse } from './types-D1K46vwd.cjs';
+export { C as Chunk, Q as QueryOpts, g as VectorHit, h as VectorRecord } from './types-D1K46vwd.cjs';
+export { searchsocketHandle, searchsocketVitePlugin } from './sveltekit.cjs';
+export { createSearchClient } from './client.cjs';
+
+interface LoadConfigOptions {
+    cwd?: string;
+    configPath?: string;
+    allowMissing?: boolean;
+}
+declare function mergeConfig(cwd: string, rawConfig: SearchSocketConfig): ResolvedSearchSocketConfig;
+declare function loadConfig(options?: LoadConfigOptions): Promise<ResolvedSearchSocketConfig>;
+
+declare function resolveScope(config: ResolvedSearchSocketConfig, override?: string): Scope;
+
+declare function createEmbeddingsProvider(config: ResolvedSearchSocketConfig): EmbeddingsProvider;
+
+interface JinaRerankerOptions {
+    apiKey: string;
+    model: string;
+    maxRetries?: number;
+}
+declare class JinaReranker implements Reranker {
+    private readonly apiKey;
+    private readonly model;
+    private readonly maxRetries;
+    constructor(options: JinaRerankerOptions);
+    rerank(query: string, candidates: RerankCandidate[], topN?: number): Promise<Array<{
+        id: string;
+        score: number;
+    }>>;
+}
+
+declare function createReranker(config: ResolvedSearchSocketConfig): Reranker | null;
+
+interface LoggerOptions {
+    json?: boolean;
+    verbose?: boolean;
+    /** When true, all output (including info/event) is written to stderr instead of stdout. */
+    stderrOnly?: boolean;
+}
+declare class Logger {
+    private readonly json;
+    private readonly verbose;
+    private readonly stderrOnly;
+    constructor(opts?: LoggerOptions);
+    info(message: string): void;
+    debug(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    event(event: string, data?: Record<string, unknown>): void;
+    private writeOut;
+    private logJson;
+}
+
+interface IndexPipelineOptions {
+    cwd?: string;
+    configPath?: string;
+    config?: ResolvedSearchSocketConfig;
+    embeddingsProvider?: EmbeddingsProvider;
+    vectorStore?: VectorStore;
+    logger?: Logger;
+}
+declare class IndexPipeline {
+    private readonly cwd;
+    private readonly config;
+    private readonly embeddings;
+    private readonly vectorStore;
+    private readonly logger;
+    private constructor();
+    static create(options?: IndexPipelineOptions): Promise<IndexPipeline>;
+    getConfig(): ResolvedSearchSocketConfig;
+    run(rawOptions?: IndexOptions): Promise<IndexStats>;
+}
+
+interface SearchEngineOptions {
+    cwd?: string;
+    configPath?: string;
+    config?: ResolvedSearchSocketConfig;
+    embeddingsProvider?: EmbeddingsProvider;
+    vectorStore?: VectorStore;
+    reranker?: Reranker | null;
+}
+declare class SearchEngine {
+    private readonly cwd;
+    private readonly config;
+    private readonly embeddings;
+    private readonly vectorStore;
+    private readonly reranker;
+    private constructor();
+    static create(options?: SearchEngineOptions): Promise<SearchEngine>;
+    getConfig(): ResolvedSearchSocketConfig;
+    search(request: SearchRequest): Promise<SearchResponse>;
+    getPage(pathOrUrl: string, scope?: string): Promise<{
+        url: string;
+        frontmatter: Record<string, unknown>;
+        markdown: string;
+    }>;
+    health(): Promise<{
+        ok: boolean;
+        details?: string;
+    }>;
+    private resolveInputPath;
+    private assertModelCompatibility;
+    private rerankHits;
+}
+
+declare function createVectorStore(config: ResolvedSearchSocketConfig, cwd: string): Promise<VectorStore>;
+
+interface McpServerOptions {
+    cwd?: string;
+    configPath?: string;
+    transport?: "stdio" | "http";
+    httpPort?: number;
+    httpPath?: string;
+}
+declare function runMcpServer(options?: McpServerOptions): Promise<void>;
+
+export { EmbeddingsProvider, IndexOptions, IndexPipeline, IndexStats, JinaReranker, RerankCandidate, Reranker, ResolvedSearchSocketConfig, Scope, SearchEngine, SearchRequest, SearchResponse, SearchSocketConfig, VectorStore, createEmbeddingsProvider, createReranker, createVectorStore, loadConfig, mergeConfig, resolveScope, runMcpServer };

package/dist/index.d.ts

@@ -0,0 +1,119 @@
+import { R as ResolvedSearchSocketConfig, b as SearchSocketConfig, c as Scope, E as EmbeddingsProvider, d as Reranker, e as RerankCandidate, V as VectorStore, I as IndexOptions, f as IndexStats, S as SearchRequest, a as SearchResponse } from './types-D1K46vwd.js';
+export { C as Chunk, Q as QueryOpts, g as VectorHit, h as VectorRecord } from './types-D1K46vwd.js';
+export { searchsocketHandle, searchsocketVitePlugin } from './sveltekit.js';
+export { createSearchClient } from './client.js';
+
+interface LoadConfigOptions {
+    cwd?: string;
+    configPath?: string;
+    allowMissing?: boolean;
+}
+declare function mergeConfig(cwd: string, rawConfig: SearchSocketConfig): ResolvedSearchSocketConfig;
+declare function loadConfig(options?: LoadConfigOptions): Promise<ResolvedSearchSocketConfig>;
+
+declare function resolveScope(config: ResolvedSearchSocketConfig, override?: string): Scope;
+
+declare function createEmbeddingsProvider(config: ResolvedSearchSocketConfig): EmbeddingsProvider;
+
+interface JinaRerankerOptions {
+    apiKey: string;
+    model: string;
+    maxRetries?: number;
+}
+declare class JinaReranker implements Reranker {
+    private readonly apiKey;
+    private readonly model;
+    private readonly maxRetries;
+    constructor(options: JinaRerankerOptions);
+    rerank(query: string, candidates: RerankCandidate[], topN?: number): Promise<Array<{
+        id: string;
+        score: number;
+    }>>;
+}
+
+declare function createReranker(config: ResolvedSearchSocketConfig): Reranker | null;
+
+interface LoggerOptions {
+    json?: boolean;
+    verbose?: boolean;
+    /** When true, all output (including info/event) is written to stderr instead of stdout. */
+    stderrOnly?: boolean;
+}
+declare class Logger {
+    private readonly json;
+    private readonly verbose;
+    private readonly stderrOnly;
+    constructor(opts?: LoggerOptions);
+    info(message: string): void;
+    debug(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    event(event: string, data?: Record<string, unknown>): void;
+    private writeOut;
+    private logJson;
+}
+
+interface IndexPipelineOptions {
+    cwd?: string;
+    configPath?: string;
+    config?: ResolvedSearchSocketConfig;
+    embeddingsProvider?: EmbeddingsProvider;
+    vectorStore?: VectorStore;
+    logger?: Logger;
+}
+declare class IndexPipeline {
+    private readonly cwd;
+    private readonly config;
+    private readonly embeddings;
+    private readonly vectorStore;
+    private readonly logger;
+    private constructor();
+    static create(options?: IndexPipelineOptions): Promise<IndexPipeline>;
+    getConfig(): ResolvedSearchSocketConfig;
+    run(rawOptions?: IndexOptions): Promise<IndexStats>;
+}
+
+interface SearchEngineOptions {
+    cwd?: string;
+    configPath?: string;
+    config?: ResolvedSearchSocketConfig;
+    embeddingsProvider?: EmbeddingsProvider;
+    vectorStore?: VectorStore;
+    reranker?: Reranker | null;
+}
+declare class SearchEngine {
+    private readonly cwd;
+    private readonly config;
+    private readonly embeddings;
+    private readonly vectorStore;
+    private readonly reranker;
+    private constructor();
+    static create(options?: SearchEngineOptions): Promise<SearchEngine>;
+    getConfig(): ResolvedSearchSocketConfig;
+    search(request: SearchRequest): Promise<SearchResponse>;
+    getPage(pathOrUrl: string, scope?: string): Promise<{
+        url: string;
+        frontmatter: Record<string, unknown>;
+        markdown: string;
+    }>;
+    health(): Promise<{
+        ok: boolean;
+        details?: string;
+    }>;
+    private resolveInputPath;
+    private assertModelCompatibility;
+    private rerankHits;
+}
+
+declare function createVectorStore(config: ResolvedSearchSocketConfig, cwd: string): Promise<VectorStore>;
+
+interface McpServerOptions {
+    cwd?: string;
+    configPath?: string;
+    transport?: "stdio" | "http";
+    httpPort?: number;
+    httpPath?: string;
+}
+declare function runMcpServer(options?: McpServerOptions): Promise<void>;
+
+export { EmbeddingsProvider, IndexOptions, IndexPipeline, IndexStats, JinaReranker, RerankCandidate, Reranker, ResolvedSearchSocketConfig, Scope, SearchEngine, SearchRequest, SearchResponse, SearchSocketConfig, VectorStore, createEmbeddingsProvider, createReranker, createVectorStore, loadConfig, mergeConfig, resolveScope, runMcpServer };