@autorag/librarian 2.4.0 → 2.4.2

package/dist/core.d.ts

@@ -0,0 +1,67 @@
+import type { AutoRAGJikjiPrepareResult, AutoRAGRefreshOptions, AutoRAGRefreshResult, AutoRAGRefreshStatus, AutoRAGWatchRefreshHandle, AutoRAGWatchRefreshOptions } from "./agent/agent.js";
+import type { AutoRAGResultsDetails } from "./agent/emit-results-tool.js";
+import { type SearchDocumentsResponse } from "./agent/search-documents.js";
+import { type CliConfig, type ResolveConfigInput } from "./cli/config.js";
+import type { MemorySchemaV4 } from "./memory/memory.js";
+import type { MinSyncSyncResult } from "./minsync/types.js";
+import type { ParsedMirrorSyncResult } from "./mirror/sync.js";
+import type { RetrievalEngine } from "./retrieval/engine.js";
+import type { CuratedResult, RetrievalDiagnostic, RetrievalOptions, RetrievalResult } from "./retrieval/types.js";
+/** Input accepted by {@link createAutoRAGLite}. Flags keep CLI precedence intact. */
+export interface AutoRAGLiteOptions {
+    readonly flags?: ResolveConfigInput["flags"];
+    readonly env?: NodeJS.ProcessEnv;
+    readonly cwd?: string;
+    readonly readOnly?: boolean;
+}
+/** The model-free AutoRAG runtime facade. */
+export declare class AutoRAGLite {
+    readonly config: CliConfig;
+    private readonly agent;
+    private readonly retrievalEngine;
+    private readonly memory;
+    private readonly sessions;
+    constructor(config: CliConfig);
+    /** Refresh parsed mirrors and configured indexes without constructing a model. */
+    refresh(force?: boolean, options?: AutoRAGRefreshOptions): Promise<AutoRAGRefreshResult>;
+    /** Alias for callers that model indexing as a lifecycle operation. */
+    index(force?: boolean, options?: AutoRAGRefreshOptions): Promise<AutoRAGRefreshResult>;
+    /** Return the path-opaque refresh and index health snapshot. */
+    getRefreshStatus(): Promise<AutoRAGRefreshStatus>;
+    /** Short status alias for headless lifecycle callers. */
+    status(): Promise<AutoRAGRefreshStatus>;
+    /** Run only parsed-mirror indexing while preserving the agent's path pinning. */
+    syncParsedMirrors(force?: boolean): Promise<ParsedMirrorSyncResult>;
+    /** Run the configured MinSync indexer without constructing a model. */
+    syncMinSync(): Promise<MinSyncSyncResult | undefined>;
+    /** Run the configured Jikji preparer without constructing a model. */
+    prepareJikji(): Promise<readonly AutoRAGJikjiPrepareResult[] | undefined>;
+    /** Start an opt-in incremental filesystem refresh watcher. */
+    startWatchRefresh(options?: AutoRAGWatchRefreshOptions): AutoRAGWatchRefreshHandle;
+    /** Return the deterministic retrieval engine used by this configured runtime. */
+    getRetrievalEngine(): RetrievalEngine;
+    /** Retrieve merged results without entering the model-backed agent loop. */
+    retrieve(query: string, options?: RetrievalOptions): Promise<{
+        results: RetrievalResult[];
+        diagnostics: RetrievalDiagnostic[];
+    }>;
+    /** Retrieve per-method results without entering the model-backed agent loop. */
+    retrieveByMethod(query: string, options?: RetrievalOptions): Promise<{
+        byMethod: Map<string, RetrievalResult[]>;
+        diagnostics: RetrievalDiagnostic[];
+    }>;
+    /** Persist a typed structured report for later evidence and feedback commands. */
+    recordStructuredResultsSession(sessionId: string, query: string, details: AutoRAGResultsDetails): SearchDocumentsResponse;
+    /** Generate a session id and persist a typed structured report. */
+    recordReport(query: string, details: AutoRAGResultsDetails): SearchDocumentsResponse;
+    /** Return the opaque result registry associated with a persisted report. */
+    getResultRegistry(sessionId: string): ReadonlyMap<number, CuratedResult>;
+    /** Record numbered feedback against a report persisted by this facade. */
+    recordFeedbackByNumbers(sessionId: string, usefulNumbers: readonly number[], notUsefulNumbers?: readonly number[]): void;
+    /** Return a detached snapshot of persisted evidence and feedback state. */
+    getMemorySchema(): MemorySchemaV4;
+}
+/** Resolve the existing CLI config and construct a model-free runtime. */
+export declare function createAutoRAGLite(options?: AutoRAGLiteOptions): AutoRAGLite;
+export type { AgentModelAuth, AgentModelConfig, AgentModelResolutionSource, CliConfig, MinSyncMethodConfig, NormalizedIndexingConfig, RawIndexingMethods, ResolveConfigInput, ResolvedAgentModel, ResolvedAgentModelDetailed, ResolvedAgentModelRole, ResolvedConfigPath, UiConfig, } from "./cli/config.js";
+export { AUTORAG_HOME_ENV, buildAgentOptions, ConfigError, DEFAULT_CONFIG_FILENAME, LEGACY_CONFIG_FILENAME, normalizeEmbedder, normalizeIndexingConfig, normalizeLegacyConfigPaths, readRawConfigObject, resolveAgentModel, resolveAgentModelDetailed, resolveConfig, resolveConfigPath, resolveConfigReadOnly, resolveModel, writeConfigObject, writeDefaultConfig, } from "./cli/config.js";