@autorag/librarian 2.13.4 → 2.13.5

package/dist/cli/setup.d.ts

@@ -1,6 +1,7 @@
 import { type ResolvedFileeBinary, type ResolveFileeBinaryOptions } from "../convert/index.js";
 import { type HisterServiceDeps, type HisterSetupReport } from "../datasource/skills/hister/setup.js";
 import { type EmbeddingBackend, type ManagedEmbedder } from "../embedding/index.js";
+import { type CloudFileProbe, type CloudRootKind } from "../filesystem/cloud-placeholder.js";
 import { type FileLockHandle } from "../filesystem/file-lock.js";
 export type SetupDatasourceState = "configured" | "skipped" | "blocked";
 export interface SetupDatasourceReport {
@@ -18,6 +19,19 @@ export interface SetupEmbeddingReport {
     readonly reason?: string;
 }
 export type SetupFileeState = "installed" | "cached" | "path" | "configured" | "skipped" | "failed";
+/**
+ * One cloud or network folder detected on this machine that no `searchPaths`
+ * entry covers. The path is the folder's own absolute location; the command is
+ * the exact `autorag init` invocation that adds it to the config's
+ * `searchPaths`. Detection reads directory metadata only (never file
+ * contents) and a probe that fails is dropped, never fatal.
+ */
+export interface SetupCloudFolderReport {
+    readonly path: string;
+    readonly kind: CloudRootKind;
+    /** Exact command that adds this folder to `searchPaths` on a fresh config. */
+    readonly command: string;
+}
 /** The Filee command line behind `convert_files`; setup installs it unless the operator opted out. */
 export interface SetupFileeReport {
     readonly state: SetupFileeState;
@@ -26,7 +40,7 @@ export interface SetupFileeReport {
 }
 export interface SetupReport {
     readonly ok: boolean;
-    readonly mode: "semantic" | "bm25";
+    readonly mode: "semantic" | "sparse";
     readonly embedding: SetupEmbeddingReport;
     readonly datasources: readonly SetupDatasourceReport[];
     readonly remediation?: string;
@@ -36,6 +50,12 @@ export interface SetupReport {
     readonly histers?: readonly HisterSetupReport[];
     /** Present on every run; `skipped` when `filee.enabled` or `filee.autoInstall` is false. */
     readonly filee?: SetupFileeReport;
+    /**
+     * Cloud and network folders this machine has that no `searchPaths` entry
+     * covers, each with the command that adds it. Absent when there are none or
+     * on a platform without a probe. Never affects `ok`.
+     */
+    readonly cloudFolders?: readonly SetupCloudFolderReport[];
     readonly changed: boolean;
 }
 export interface SetupDeps {
@@ -51,6 +71,12 @@ export interface SetupDeps {
     readonly hister?: HisterServiceDeps;
     /** Finds or installs filee-cli; defaults to the pinned release download. */
     readonly filee?: (options: Pick<ResolveFileeBinaryOptions, "executable" | "autoInstall">) => Promise<ResolvedFileeBinary>;
+    /**
+     * Cloud/network root probe; defaults to the platform probe (`DarwinCloudProbe`
+     * on macOS, `WindowsCloudProbe` on Windows, none elsewhere). Injected by
+     * tests so they need no real cloud mounts.
+     */
+    readonly cloudProbe?: CloudFileProbe;
 }
 export declare function runSetup(options: {
     configPath: string;

package/dist/cloud/jev-backend.d.ts

@@ -17,6 +17,21 @@ import { type BackendRequest, type BackendResponse, type JevBackend, type Questi
 export declare const JEV_PATH = "/v1/jev";
 /** Live Jev model id on the hosted Dazzi Models plan. */
 export declare const DAZZI_DEFAULT_JEV_MODEL = "jev-1.13";
+/** One decision model the hosted plan serves at `POST <root>/v1/jev`. */
+export interface DazziDecisionModel {
+    readonly id: string;
+    readonly description?: string;
+}
+/**
+ * `GET <root>/v1/models?operation=jev`: the decision models the hosted plan serves, in its order. Throws on a
+ * network failure, a non-2xx answer, or a body that is not a model list.
+ */
+export declare function listDazziDecisionModels(options: {
+    readonly baseUrl: string;
+    readonly apiKey: string;
+    readonly signal?: AbortSignal;
+    readonly fetchImpl?: typeof fetch;
+}): Promise<DazziDecisionModel[]>;
 /** Options for {@link DazziJevBackend}. */
 export interface DazziJevBackendOptions {
     /** Environment holding `AUTORAG_BASE_URL`. Default `process.env`. */
@@ -77,14 +92,21 @@ export declare class DazziJevBackend implements JevBackend {
     /** POST JSON with a per-attempt timeout and jev-use's retry policy. */
     private postJson;
 }
-/** Build the whole request body: model, a string state, and the questions by id. */
+/**
+ * The key each question goes out under, in question order. An id that is already a valid key keeps
+ * it; any other, such as `datasource:web` or a long `evidence:...` id, has every other character
+ * replaced with `_`, is cut to 100 characters, and takes a numeric suffix when that key is taken.
+ * Answers are read back under the same keys, so each stays with its own question.
+ */
+export declare function wireQuestionKeys(ids: readonly string[]): string[];
+/** Build the whole request body: model, a string state, and the questions by {@link wireQuestionKeys}. */
 export declare function toNativeBody(state: State, questions: (Question & {
     id: string;
 })[], model: string): NativeBody;
 /**
- * Read the provider's answer map back into raw answers, in question order.
- * Anything missing or mistyped is a `BackendError` — a silently dropped answer
- * would read as a low-confidence judgment.
+ * Read the provider's answer map back into raw answers, in question order, under the keys
+ * {@link toNativeBody} sent. Anything missing or mistyped is a `BackendError` — a silently dropped
+ * answer would read as a low-confidence judgment.
  */
 export declare function parseNativeAnswers(backend: string, answers: unknown, questions: (Question & {
     id: string;