@autorag/librarian 2.7.0 → 2.8.0

package/dist/cli/update-check.d.ts

@@ -0,0 +1,34 @@
+/**
+ * AutoRAG's own update check. Pi's interactive host reports its own version and
+ * changelog; this module answers "is a newer `@autorag/librarian` published?"
+ * so the CLI and TUI can notify on AutoRAG's terms.
+ *
+ * The check is best-effort: any network/parse failure yields `status: "error"`
+ * and never throws, so a launch is never blocked or failed by the lookup.
+ */
+export declare const AUTORAG_PACKAGE_NAME = "@autorag/librarian";
+export declare const AUTORAG_UPDATE_COMMAND = "bun install -g @autorag/librarian";
+export declare const AUTORAG_LATEST_VERSION_URL: string;
+export declare const AUTORAG_UPDATE_CHECK_TIMEOUT_MS = 2500;
+export type AutoRAGUpdateStatus = "available" | "up-to-date" | "skipped" | "error";
+export interface AutoRAGUpdateResult {
+    readonly status: AutoRAGUpdateStatus;
+    readonly packageName: string;
+    readonly currentVersion: string;
+    readonly latestVersion?: string;
+    readonly installCommand: string;
+}
+export interface CheckAutoRAGUpdateOptions {
+    /** The running package version to compare against the registry. */
+    readonly currentVersion: string;
+    /** Registry endpoint override; primarily a test/QA seam. */
+    readonly url?: string;
+    readonly timeoutMs?: number;
+    readonly fetchImpl?: typeof fetch;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+}
+/** Semver precedence by numeric core, then release-over-prerelease. `undefined` when either side is unparsable. */
+export declare function comparePackageVersions(left: string, right: string): number | undefined;
+export declare function checkAutoRAGUpdate(options: CheckAutoRAGUpdateOptions): Promise<AutoRAGUpdateResult>;
+/** One-line TUI/CLI notice, or `undefined` when there is nothing to announce. */
+export declare function renderAutoRAGUpdateNotice(result: AutoRAGUpdateResult): string | undefined;

package/dist/cli/version.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The installed package version. The manifest sits two levels above this module
+ * in both layouts: `src/cli/version.ts` and the bundled `dist/cli/index.js`.
+ */
+export declare function readPackageVersion(): string;

package/dist/core.d.ts

@@ -2,10 +2,13 @@ import type { AutoRAGJikjiPrepareResult, AutoRAGRefreshOptions, AutoRAGRefreshRe
 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 { EverythingSearchRequest, EverythingSearchResult } from "./everything/index.js";
+import type { FSearchSearchRequest, FSearchSearchResult } from "./fsearch/index.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 { DatasourceCatalogEntry, RetrievalSelection } from "./retrieval/selection.js";
 import type { CuratedResult, RetrievalDiagnostic, RetrievalOptions, RetrievalResult, RetrievalUnsearchedSurface } from "./retrieval/types.js";
 /** Input accepted by {@link createAutoRAGLite}. Flags keep CLI precedence intact. */
 export interface AutoRAGLiteOptions {
@@ -40,6 +43,30 @@ export declare class AutoRAGLite {
     startWatchRefresh(options?: AutoRAGWatchRefreshOptions): AutoRAGWatchRefreshHandle;
     /** Return the deterministic retrieval engine used by this configured runtime. */
     getRetrievalEngine(): RetrievalEngine;
+    /**
+     * List the authorized configured datasources for this runtime: identity,
+     * capability tags, and authorized source scope strings only — no
+     * credentials or config metadata.
+     */
+    listDatasources(): DatasourceCatalogEntry[];
+    /**
+     * Search only the selected datasources/methods/local surfaces. Selection is
+     * applied before any backend is invoked, so an unselected or unauthorized
+     * datasource never runs. Unknown or unauthorized selections throw
+     * {@link RetrievalSelectionError}.
+     */
+    searchSelected(query: string, selection?: RetrievalSelection, options?: RetrievalOptions): Promise<{
+        results: RetrievalResult[];
+        diagnostics: RetrievalDiagnostic[];
+        unsearched: RetrievalUnsearchedSurface[];
+    }>;
+    /**
+     * Search the Windows-only Everything index through the model-free provider,
+     * delegating to the existing agent backend (unsupported off Windows).
+     */
+    searchEverything(request: EverythingSearchRequest): Promise<EverythingSearchResult>;
+    /** Search the existing macOS/Linux FSearch client through the model-free provider. */
+    searchFsearch(request: FSearchSearchRequest): Promise<FSearchSearchResult>;
     /** Retrieve merged results without entering the model-backed agent loop. */
     retrieve(query: string, options?: RetrievalOptions): Promise<{
         results: RetrievalResult[];
@@ -58,8 +85,13 @@ export declare class AutoRAGLite {
     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 and report whether numbers matched and changed memory. */
+    recordFeedbackByNumbersDetailed(sessionId: string, usefulNumbers: readonly number[], notUsefulNumbers?: readonly number[]): {
+        matched: boolean;
+        applied: boolean;
+    };
     /** Record numbered feedback against a report persisted by this facade. */
-    recordFeedbackByNumbers(sessionId: string, usefulNumbers: readonly number[], notUsefulNumbers?: readonly number[]): void;
+    recordFeedbackByNumbers(sessionId: string, usefulNumbers: readonly number[], notUsefulNumbers?: readonly number[]): boolean;
     /** Return a detached snapshot of persisted evidence and feedback state. */
     getMemorySchema(): MemorySchemaV4;
 }