@autorag/librarian 2.4.2 → 2.5.0

package/dist/cli/output.d.ts

@@ -11,6 +11,12 @@ export interface RenderOptions {
 export declare function renderRefresh(result: AutoRAGRefreshResult, opts: RenderOptions): string;
 export declare function renderStatus(status: AutoRAGRefreshStatus, opts: RenderOptions): string;
 export declare function renderSearch(resp: SearchDocumentsResponse, opts: RenderOptions): string;
+/**
+ * Render the two-phase search's immediate first answer. Kept distinct from
+ * the final response so callers can show "fast answer → verified answer"
+ * 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;

package/dist/cli/setup.d.ts

@@ -0,0 +1,59 @@
+import { type RuntimeStatus } from "../embedding-runtime/index.js";
+import { resolveProfile } from "../embedding-runtime/manifest.js";
+import type { ProfileId } from "../embedding-runtime/types.js";
+import { type FileLockHandle } from "../filesystem/file-lock.js";
+export type SetupDatasourceState = "configured" | "skipped" | "blocked";
+export interface SetupDatasourceReport {
+    readonly name: string;
+    readonly state: SetupDatasourceState;
+    readonly reason?: string;
+}
+export interface SetupReport {
+    readonly ok: boolean;
+    readonly mode: "semantic" | "bm25";
+    readonly runtime: {
+        readonly state: string;
+        readonly health: boolean;
+        readonly model: string;
+    };
+    readonly model: {
+        readonly valid: boolean;
+        readonly profile: ProfileId;
+    };
+    readonly datasources: readonly SetupDatasourceReport[];
+    readonly remediation?: string;
+    readonly changed: boolean;
+}
+export interface SetupRuntime {
+    runtimeStatus(): Promise<RuntimeStatus>;
+    verifyModel(profileId?: ProfileId): Promise<{
+        profileId: ProfileId;
+        path: string;
+        hash: string;
+    }>;
+    ensureRuntime?(input?: {
+        profileId?: ProfileId;
+    }): Promise<{
+        baseUrl: string;
+        profile: ReturnType<typeof resolveProfile>;
+        identity: {
+            provider: string;
+            model: string;
+            dimension: number;
+            profileId: ProfileId;
+        };
+    }>;
+}
+export interface SetupDeps {
+    readonly runtime?: SetupRuntime;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly pathExists?: (path: string) => boolean;
+    readonly executable?: (name: string) => string | undefined;
+    readonly acquireLock?: (path: string) => FileLockHandle;
+}
+export declare function runSetup(options: {
+    configPath: string;
+    workspacePath: string;
+    profileId?: ProfileId;
+    deps?: SetupDeps;
+}): Promise<SetupReport>;