@autorag/librarian 2.7.0 → 2.9.0

package/dist/cli/output.d.ts

@@ -1,6 +1,6 @@
 import type { AutoRAGRefreshResult, AutoRAGRefreshStatus } from "../agent/agent.js";
 import type { SearchDocumentsResponse } from "../agent/search-documents.js";
-import type { MemorySchemaV4 } from "../memory/memory.js";
+import type { MemorySchema } from "../memory/memory.js";
 import type { HealthReportV1 } from "./commands/health.js";
 import type { SearchHealthHint } from "./commands/search.js";
 export interface RenderOptions {
@@ -17,11 +17,7 @@ export declare function renderSearch(resp: SearchDocumentsResponse, opts: Render
  * progression; the JSON shape wraps the normal search envelope.
  */
 export declare function renderPreliminary(resp: SearchDocumentsResponse, opts: RenderOptions): string;
-export declare function renderMemory(schema: MemorySchemaV4, opts: RenderOptions): string;
-export declare function renderFeedback(result: {
-    applied: boolean;
-    sessionId: string;
-}, opts: RenderOptions): string;
+export declare function renderMemory(schema: MemorySchema, opts: RenderOptions): string;
 export declare function renderIndex(result: {
     action: "reset" | "rebuild";
     removed: string[];

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/config/home.d.ts

@@ -1,2 +1,8 @@
 export declare const AUTORAG_HOME_ENV = "AUTORAG_HOME";
+/**
+ * Operator home directory. `HOME` wins over `USERPROFILE` on Windows, and a
+ * missing, empty, or relative value falls back to `os.homedir()` so callers
+ * never build absolute-looking state from a relative base.
+ */
+export declare function resolveUserHome(env?: NodeJS.ProcessEnv): string;
 export declare function resolveAutoRAGHome(env?: NodeJS.ProcessEnv): 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 { MemorySchemaV4 } from "./memory/memory.js";
+import type { EverythingSearchRequest, EverythingSearchResult } from "./everything/index.js";
+import type { FSearchSearchRequest, FSearchSearchResult } from "./fsearch/index.js";
+import type { MemorySchema } 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,29 @@ export declare class AutoRAGLite {
     startWatchRefresh(options?: AutoRAGWatchRefreshOptions): AutoRAGWatchRefreshHandle;
     /** Return the deterministic retrieval engine used by this configured runtime. */
     getRetrievalEngine(): RetrievalEngine;
+    /**
+     * List the configured datasources for this runtime: identity, descriptive
+     * tags, and 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 datasource never
+     * runs. Unknown methods or unknown datasource ids 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[];
@@ -52,16 +78,14 @@ export declare class AutoRAGLite {
         diagnostics: RetrievalDiagnostic[];
         unsearched: RetrievalUnsearchedSurface[];
     }>;
-    /** Persist a typed structured report for later evidence and feedback commands. */
+    /** Persist a typed structured report for later evidence 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;
+    /** Return a detached snapshot of persisted evidence state. */
+    getMemorySchema(): MemorySchema;
 }
 /** Resolve the existing CLI config and construct a model-free runtime. */
 export declare function createAutoRAGLite(options?: AutoRAGLiteOptions): AutoRAGLite;