@autorag/librarian 2.8.0 → 2.10.0

package/dist/agent/web-fetch-tool.d.ts

@@ -9,6 +9,7 @@
  */
 import type { AgentTool } from "@earendil-works/pi-agent-core";
 import { Type } from "typebox";
+import { EvidenceLedger } from "./evidence-ledger.js";
 export declare const WEB_FETCH_TOOL_NAME = "web_fetch";
 declare const webFetchSchema: Type.TObject<{
     url: Type.TString;
@@ -28,5 +29,5 @@ export interface WebFetchToolDetails {
     readonly available: boolean;
     readonly error?: string;
 }
-export declare function createWebFetchTool(options?: WebFetchToolOptions): AgentTool<typeof webFetchSchema, WebFetchToolDetails>;
+export declare function createWebFetchTool(options?: WebFetchToolOptions, ledger?: EvidenceLedger): AgentTool<typeof webFetchSchema, WebFetchToolDetails>;
 export {};

package/dist/agent/web-search-tool.d.ts

@@ -13,6 +13,7 @@ import type { AgentTool } from "@earendil-works/pi-agent-core";
 import { Type } from "typebox";
 import type { ModelNativeSearchAuth } from "../web/search/model-auth.js";
 import type { SearchProviderId } from "../web/search/types.js";
+import { EvidenceLedger } from "./evidence-ledger.js";
 export declare const WEB_SEARCH_TOOL_NAME = "web_search";
 declare const webSearchSchema: Type.TObject<{
     query: Type.TString;
@@ -44,5 +45,5 @@ export interface WebSearchToolDetails {
     readonly available: boolean;
     readonly error?: string;
 }
-export declare function createWebSearchTool(options?: WebSearchToolOptions): AgentTool<typeof webSearchSchema, WebSearchToolDetails>;
+export declare function createWebSearchTool(options?: WebSearchToolOptions, ledger?: EvidenceLedger): AgentTool<typeof webSearchSchema, WebSearchToolDetails>;
 export {};

package/dist/cli/commands/evidence.d.ts

@@ -1,4 +1,4 @@
-import type { MemorySchemaV4 } from "../../memory/memory.js";
+import type { MemorySchema } from "../../memory/memory.js";
 import type { CommandContext } from "./types.js";
 interface EvidenceView {
     readonly stableEvidenceId: string;
@@ -11,7 +11,7 @@ interface EvidenceView {
     readonly lineNumber?: number;
     readonly metadata?: Record<string, unknown>;
 }
-export declare function evidenceFor(schema: MemorySchemaV4, sessionId: string, resultNumber?: number): {
+export declare function evidenceFor(schema: MemorySchema, sessionId: string, resultNumber?: number): {
     sessionId: string;
     results: {
         number: number;

package/dist/cli/commands/memory.d.ts

@@ -1,7 +1,7 @@
 import type { CommandContext } from "./types.js";
 /**
  * `autorag memory inspect` — render a path-opaque snapshot of the retrieval
- * memory (curated results, feedback signals, insights, signal defaults).
+ * memory (judged evidence, curated results, evidence chunks, insights).
  * Model-free. The memory file is resolved from config and loaded read-only;
  * only the rendered schema is emitted, never the storage path.
  */

package/dist/cli/commands/report.d.ts

@@ -1,6 +1,6 @@
-import { type AutoRAGResultsDetails } from "../../agent/emit-results-tool.js";
+import { type AutoRAGResultsDetails } from "../../agent/results.js";
 import type { CommandContext } from "./types.js";
-/** Validate a curated report payload against the `emit_autorag_results` contract. */
+/** Validate a curated report payload against the `autorag report` contract (explicit number -> source mapping). */
 export declare function validateReport(value: unknown): AutoRAGResultsDetails;
 /** Persist a structured report submitted by an external curator. */
 export declare function runReport(ctx: CommandContext): Promise<number>;

package/dist/cli/commands/tui.d.ts

@@ -5,8 +5,9 @@ import type { CommandContext } from "./types.js";
  * Pi owns the terminal UI, `read`/`bash`/`edit`/`write`/`grep`/`find`/`ls`
  * tools, provider credentials/OAuth, model selection, session persistence and
  * resume/fork/compaction, settings, and extension loading. AutoRAG registers
- * its domain tools and streams progress, preliminary answers, and final results
- * into the same session through the agent's interactive runtime. The native
+ * its domain tools and runs the two-phase search in the same session through
+ * the agent's interactive runtime; the model's progress notes, first answer, and
+ * final answer are ordinary assistant messages there. The native
  * `/login`, `/model`, `/resume`, `/new`, `/tree`, `/compact`, and `/settings`
  * commands are therefore always available.
  */

package/dist/cli/config.d.ts

@@ -4,7 +4,6 @@ import type { AutoRAGAgentOptions, AutoRAGRetrievalLimits } from "../agent/agent
 import type { JevBackendName } from "../agent/jev-extension.js";
 import { type LoadLocalAutoRAGModelOptions } from "../agent/local-model.js";
 import type { DecompositionModel } from "../agent/query-decomposition.js";
-import type { DatasourceAccessContextOptions } from "../datasource/access-context.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";
@@ -19,7 +18,8 @@ export declare class ConfigError extends Error {
  * the MinSync vector embedder settings validated by {@link normalizeEmbedder}.
  */
 export interface MinSyncMethodConfig {
-    enabled?: boolean;
+    /** Accepted as `true` so existing configs load; `false` is rejected, MinSync is required. */
+    enabled?: true;
     autoInstall?: boolean;
     workspacePath?: string;
     maxChunkSize?: number;
@@ -143,6 +143,8 @@ export interface AgentModelConfig {
     maxTokens?: number;
 }
 export interface CliConfig {
+    /** Absolute path of the config file this config was resolved from (it may not exist yet). */
+    configPath?: string;
     searchPaths: string[];
     workspacePath: string;
     memoryPath: string;
@@ -168,7 +170,7 @@ export interface CliConfig {
     } | false;
     webSearch?: WebSearchCliConfig;
     /**
-     * Jev query routing (local / web / direct), the decomposition check, the
+     * 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
@@ -195,10 +197,8 @@ export interface CliConfig {
     excludePaths?: string[];
     /** Hard caps on retrieval, baseline prefetch, and model-facing candidate lists. */
     limits?: AutoRAGRetrievalLimits;
-    /** Trusted datasource skill configuration (skill name → config). */
+    /** Datasource skill configuration (skill name → config). */
     datasources?: DatasourcesConfig;
-    /** Trusted datasource allow-tags/allow-scopes. Absent ⇒ default-deny. */
-    datasourceAccess?: DatasourceAccessContextOptions;
     /** P2P sharing configuration. Disabled by default. */
     p2p?: P2pConfig;
 }
@@ -226,8 +226,8 @@ export declare function normalizeEmbedder(raw: unknown, path: string): MinSyncEm
  * Normalize raw indexing method config into a fully-populated shape.
  *
  * - `undefined` / missing key => `{ enabled: true, autoInstall: true }`
- * - `false` => `{ enabled: false }` (disabled marker)
  * - object merges with `enabled: true` default and is validated
+ * - `false` and `enabled: false` throw: MinSync is required
  *
  * Unknown fields, invalid embedder settings, and bad numeric values throw
  * {@link ConfigError}.
@@ -250,7 +250,7 @@ export declare const DEFAULT_JEV_BACKEND: JevBackendName;
  * Question-decomposition model used when the config names none. Picked from a
  * live OpenRouter bench (6 questions incl. Korean, 2 runs each): 12/12 valid,
  * covering, language-preserving decompositions at ~0.9s p50, about 3.5x
- * cheaper per call than google/gemini-2.5-flash-lite at equal quality.
+ * cheaper per call than the previous default (a 2025 Gemini flash-lite) at equal quality.
  */
 export declare const DEFAULT_QUERY_DECOMPOSITION_MODEL: AgentModelConfig;
 /** Validate the `queryDecomposition` config section (`false` = decompose with the session model). */
@@ -303,6 +303,14 @@ export interface ResolvedAgentModelDetailed {
     readonly role: ResolvedAgentModelRole;
 }
 export declare function resolveAgentModel(config: CliConfig, options?: ResolveAgentModelOptions): Promise<ResolvedAgentModel>;
+/**
+ * Check that a config file still resolves to a callable model, the way the
+ * next `autorag` launch will read it: invalid JSON, a schema error, or a model
+ * id that neither the pi catalog nor a declared endpoint knows is a problem.
+ * A missing credential is not (that is `autorag health`'s `auth_missing`).
+ * Resolves to a problem description, or `undefined` when the config is fine.
+ */
+export declare function validateAgentConfigFile(configPath: string, options?: ResolveAgentModelOptions): Promise<string | undefined>;
 /**
  * Resolve the question-decomposition model and its credential through the same
  * chain as the agent model. An absent section or `{}` uses

package/dist/cli/index.d.ts

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-declare const COMMANDS: readonly ["init", "setup", "refresh", "status", "search", "feedback", "evidence", "memory", "index", "watch", "health", "duplicates", "tui", "serve", "p2p", "lite", "models", "gateway", "update-check"];
+declare const COMMANDS: readonly ["init", "setup", "refresh", "status", "search", "evidence", "memory", "index", "watch", "health", "duplicates", "tui", "serve", "p2p", "lite", "models", "gateway", "update-check"];
 type CommandName = (typeof COMMANDS)[number];
 export type { CommandName };
 interface ParsedArgs {