@autorag/librarian 2.13.3 → 2.13.5

package/dist/cli/config.d.ts

@@ -1,10 +1,10 @@
 import type { Api, Model } from "@earendil-works/pi-ai";
 import { ModelRuntime } from "@earendil-works/pi-coding-agent";
 import type { AutoRAGAgentOptions, AutoRAGRefreshLimits, AutoRAGRetrievalLimits } from "../agent/agent.js";
-import type { JevBackendName } from "../agent/jev-extension.js";
 import { type LoadLocalAutoRAGModelOptions } from "../agent/local-model.js";
 import { type PermissionMode } from "../agent/permission-gate.js";
 import type { DecompositionModel } from "../agent/query-decomposition.js";
+import { type SllmDecisionModel } from "../agent/sllm-decision.js";
 import { type DatasourcesConfig } from "../datasource/skills/factory.js";
 import type { EnsureMinSyncBinaryOptions, MinSyncEmbedderConfig } from "../minsync/index.js";
 export declare const DEFAULT_CONFIG_FILENAME = "config.json";
@@ -55,20 +55,36 @@ export interface WebSearchCliConfig {
     } | false;
 }
 /**
- * Jev decision-tool config. Absent disables the tool; `enabled: false` disables
- * it explicitly. Secrets never appear here: `jev-use` reads the backend
- * credential from its own environment variable (`TYPESAFE_API_KEY`,
- * `OPENROUTER_API_KEY`, or `AI_GATEWAY_API_KEY`), and the hosted Dazzi Models
- * `dazzi` backend uses the credential stored by `/login`.
+ * Decision-model config. The decision model is required: an absent section or `{}` uses
+ * {@link defaultJevBackend}, and there is no opt-out. It is either Jev (`backend` names `dazzi` or a pi
+ * provider with decision models) or the small chat LLM (`backend: "sllm"`, see {@link JevCliConfig.sllm}).
+ * Secrets never appear here: a pi provider's credential comes from its
+ * environment variable (`OPENROUTER_API_KEY`, `OPENAI_API_KEY`, ...) or pi's
+ * `auth.json`, and the hosted Dazzi Models `dazzi` backend uses the credential
+ * stored by `/login`.
  */
 export interface JevCliConfig {
-    enabled?: boolean;
-    /** Force one backend (`openrouter`, `typesafe`, `vercel`, or `dazzi`); omit to let the first credential present win. */
-    backend?: JevBackendName;
-    /** Model id sent with every call, e.g. `jev-latest`. */
+    /**
+     * `dazzi`, or a pi provider with decision models: `openrouter`, `openai`, `typesafe`,
+     * `vercel-ai-gateway`, `cloudflare-workers-ai`, or `opencode` (`autorag models list --decision`).
+     * `sllm` decides with the small chat LLM ({@link JevCliConfig.sllm}) and never calls Jev.
+     */
+    backend?: string;
+    /** Jev model id within the backend, e.g. `openai/gpt-6-luna-decisions` on OpenRouter. Not valid with `backend: "sllm"`. */
     model?: string;
     /** Escalate verdicts below this confidence (0-1). Default: per-source thresholds. */
     confidenceThreshold?: number;
+    /**
+     * The small chat LLM (sLLM). It is the decision model when `backend` is `sllm`, and otherwise the
+     * fallback a session moves to when Jev is unavailable. Absent or `{}` uses the question-decomposition model.
+     */
+    sllm?: JevSllmConfig;
+    /** Move to the sLLM when Jev is unavailable. Default true; `false` fails the session instead. Ignored with `backend: "sllm"`. */
+    fallback?: boolean;
+}
+/** The sLLM; same model reference shape and auth rules as the top-level `model`. */
+export interface JevSllmConfig {
+    model?: AgentModelConfig;
 }
 /** Question-decomposition config. Secrets stay in env/pi auth like the main model. */
 export interface QueryDecompositionConfig {
@@ -76,19 +92,17 @@ export interface QueryDecompositionConfig {
     model?: AgentModelConfig;
 }
 /**
- * Post-merge reranking config. Routes merged evidence through a dedicated
- * rerank model. `provider` is `openrouter` (default) or the hosted Dazzi Models
- * plan (`dazzi`); each provider supplies its own default `model`. OpenRouter
- * reads its key from `apiKeyEnv`; Dazzi uses the credential stored by `/login`.
- * Secrets never appear here — only the environment-variable name that holds a
- * provider API key.
+ * Post-merge reranking config. Opt-in: reranking runs only when a `model` is named, and a block without one is treated
+ * as off (reported once at startup). `provider` is `openrouter` (default) or the hosted Dazzi Models plan (`dazzi`).
+ * OpenRouter reads its key from `apiKeyEnv`; Dazzi uses the credential stored by `/login`. Secrets never appear
+ * here, only the environment-variable name that holds a provider API key.
  */
 export interface RerankConfig {
-    /** `false` disables reranking. Missing means enabled when the block is present. */
+    /** `false` disables reranking. Missing means enabled when the block is present and names a model. */
     enabled?: boolean;
     /** Provider id (`openrouter` or `dazzi`). @default "openrouter" */
     provider?: string;
-    /** Wire model id. @default "voyageai/rerank-3-lite" (`openrouter`) / "qwen/qwen3-reranker-8b" (`dazzi`) */
+    /** Wire model id. Required to turn reranking on; there is no default model. */
     model?: string;
     /** Environment variable holding the provider API key (`openrouter` only). @default "OPENROUTER_API_KEY" */
     apiKeyEnv?: string;
@@ -156,13 +170,13 @@ export interface CliConfig {
     } | false;
     webSearch?: WebSearchCliConfig;
     /**
-     * Jev query routing (direct / local), the decomposition check, the
-     * post-fast-answer follow-up check, and the `jev` tool. On by default with
-     * the OpenRouter backend; `false` or `enabled: false` disables it. Secrets
-     * never appear here: `jev-use` reads the backend key from its own
-     * environment variable.
+     * Jev, the required decision model: query routing, the decomposition
+     * check, the post-fast-answer follow-up check, citation and evidence
+     * judgment, the `auto` permission gate, and the `jev` tool. Absent or `{}`
+     * uses the default backend. Secrets never appear here: `jev-use` reads the
+     * backend key from its own environment variable.
      */
-    jev?: JevCliConfig | false;
+    jev?: JevCliConfig;
     /**
      * Question decomposition for the Jev query pipeline. `model` names the LLM
      * that splits one question into at most five search queries; absent or `{}`
@@ -256,7 +270,7 @@ export declare function normalizeJevConfig(raw: unknown): JevCliConfig;
  * Jev backend used when the config names none (absent section or `{}`): the
  * hosted Dazzi Models plan when the user is signed in, else OpenRouter.
  */
-export declare function defaultJevBackend(agentDir?: string): JevBackendName;
+export declare function defaultJevBackend(agentDir?: string): string;
 /** The OpenRouter fallback decomposition model, used when not signed in to Dazzi Models. */
 export declare const OPENROUTER_QUERY_DECOMPOSITION_MODEL: AgentModelConfig;
 /**
@@ -268,13 +282,11 @@ export declare const OPENROUTER_QUERY_DECOMPOSITION_MODEL: AgentModelConfig;
 export declare function defaultQueryDecompositionModel(agentDir?: string): AgentModelConfig;
 /** Validate the `queryDecomposition` config section (`false` = decompose with the session model). */
 export declare function normalizeQueryDecompositionConfig(raw: unknown): QueryDecompositionConfig | false;
-/** Normalize and validate the `rerank` config section, filling in defaults. */
-export declare function normalizeRerankConfig(raw: unknown, path: string): RerankConfig | false;
 /**
- * Rerank block `autorag init` writes when none is given: the hosted Dazzi
- * Models reranker when signed in, else OpenRouter's.
+ * Normalize and validate the `rerank` config section, filling in the provider, key-env, and `topN` defaults. It never
+ * invents a model: reranking is opt-in and runs only on a model the operator names.
  */
-export declare function defaultRerankConfig(agentDir?: string): RerankConfig;
+export declare function normalizeRerankConfig(raw: unknown, path: string): RerankConfig | false;
 export declare function buildAgentOptions(config: CliConfig, agentDir?: string): Omit<AutoRAGAgentOptions, "model">;
 /**
  * Extra resolution inputs beyond the local codex-runtime options. `agentDir`
@@ -343,6 +355,13 @@ export declare function validateAgentConfigFile(configPath: string, options?: Re
  * returns undefined so the agent's own model decomposes.
  */
 export declare function resolveQueryDecompositionModel(config: CliConfig, options?: ResolveAgentModelOptions): Promise<DecompositionModel | undefined>;
+/**
+ * Resolve the sLLM and its credential through the same chain as the agent model. `jev.sllm.model` names it;
+ * absent, it is the question-decomposition model (its configured one, else {@link defaultQueryDecompositionModel}).
+ * It decides in Jev's place when `jev.backend` is `sllm`, and otherwise is Jev's fallback; `jev.fallback: false`
+ * returns undefined for the fallback, so a session without Jev fails.
+ */
+export declare function resolveSllmDecisionModel(config: CliConfig, options?: ResolveAgentModelOptions): Promise<SllmDecisionModel | undefined>;
 export declare function resolveAgentModelDetailed(config: CliConfig, options?: ResolveAgentModelOptions): Promise<ResolvedAgentModelDetailed>;
 export declare function readRawConfigObject(path: string): Record<string, unknown>;
 /** Atomically replace a config file, preserving the caller's JSON object. */