@autorag/librarian 2.9.0 → 2.10.1

package/dist/agent/search-documents.d.ts

@@ -1,7 +1,6 @@
-import { type RetrievalMemory } from "../memory/memory.js";
-import type { CuratedResult, RetrievalResult } from "../retrieval/types.js";
-import type { AutoRAGResultsDetails } from "./emit-results-tool.js";
-import type { AutoRAGFastAnswerDetails } from "./fast-answer-tool.js";
+import { type RetrievalMemory, type SessionEvidenceRef } from "../memory/memory.js";
+import type { RetrievalResult } from "../retrieval/types.js";
+import type { AutoRAGMappingEntry, AutoRAGResultsDetails } from "./results.js";
 export type SearchDocumentWarning = "empty-query";
 export type SearchDocumentDiagnosticSeverity = "info" | "warning" | "error";
 /**
@@ -10,7 +9,7 @@ export type SearchDocumentDiagnosticSeverity = "info" | "warning" | "error";
  * (#21/#22) does not require another source-breaking type change; codes not yet
  * emitted are still valid members.
  */
-export type SearchDocumentDiagnosticCode = "empty-query" | "no-verified-results" | "unknown-warning" | "caller-tool-dropped" | "minsync-staging-excluded" | "minsync-sync-failed" | "embedder-unavailable" | "embedding-identity-mismatch" | "parser-skipped" | "parser-failed" | "source-vanished" | "source-unreadable" | "parser-warning" | "duplicate-excluded" | "unsupported-file" | "stale-index" | "deleted-mirror" | "pdf-extract-thin" | "retrieval-method-failed" | "rerank-failed" | "jikji-unavailable" | "jikji-prepare-failed" | "jikji-find-failed" | "everything-index-failed" | "fsearch-index-failed" | "fsearch-binary-missing" | "refresh-failed" | "refresh-interrupted" | "watch-failed" | "watch-limited" | "unknown-datasource-skill" | "missing-final-emit" | "model-request-failed" | "search-timeout" | "query-routed" | "query-route-fallback" | "query-decomposition-failed" | "follow-up-skipped" | "follow-up-check-fallback" | "datasources-selected" | "datasource-selection-fallback" | "citation-without-result" | "evidence-judged" | "evidence-judgment-fallback" | "memory-search-fallback" | "self-config-unavailable" | "self-config-rolled-back";
+export type SearchDocumentDiagnosticCode = "empty-query" | "no-verified-results" | "unknown-warning" | "caller-tool-dropped" | "minsync-staging-excluded" | "minsync-sync-failed" | "embedder-unavailable" | "embedding-identity-mismatch" | "parser-skipped" | "parser-failed" | "source-vanished" | "source-unreadable" | "parser-warning" | "duplicate-excluded" | "unsupported-file" | "stale-index" | "deleted-mirror" | "pdf-extract-thin" | "retrieval-method-failed" | "rerank-failed" | "jikji-unavailable" | "jikji-prepare-failed" | "jikji-find-failed" | "everything-index-failed" | "fsearch-index-failed" | "fsearch-binary-missing" | "refresh-failed" | "refresh-interrupted" | "watch-failed" | "watch-limited" | "unknown-datasource-skill" | "no-final-answer" | "model-request-failed" | "search-timeout" | "query-routed" | "query-route-fallback" | "query-decomposition-failed" | "follow-up-skipped" | "follow-up-check-fallback" | "datasources-selected" | "datasource-selection-fallback" | "citation-without-result" | "evidence-judged" | "evidence-judgment-fallback" | "memory-search-fallback" | "self-config-unavailable" | "self-config-rolled-back";
 export interface SearchDocumentDiagnostic {
     readonly code: SearchDocumentDiagnosticCode;
     readonly severity: SearchDocumentDiagnosticSeverity;
@@ -27,7 +26,8 @@ export interface SearchDocumentResult {
     readonly title: string;
     readonly summary: string;
     readonly evidence: readonly SearchDocumentEvidence[];
-    readonly confidence: number;
+    /** Absent when nothing measured one: derived results carry no model-reported confidence. */
+    readonly confidence?: number;
     readonly source?: string;
 }
 /** One retrieval candidate captured in a run's retrieval trace. */
@@ -38,7 +38,7 @@ export interface SearchDocumentRetrievalTraceResult {
 }
 /**
  * What one retrieval tool execution found during a search run. Attached to the
- * degraded fallback response when the agent never called emit_autorag_results,
+ * degraded fallback response when the agent never wrote a final answer,
  * so an upstream agent can still inspect the raw candidates.
  */
 export interface SearchDocumentRetrievalTraceEntry {
@@ -84,20 +84,15 @@ export type SearchDocumentsStreamEvent = {
     readonly type: "complete";
     readonly response: SearchDocumentsResponse;
 };
-type SearchSession = {
-    query: string;
-    registry: Map<number, CuratedResult>;
-};
-type SearchSessions = Map<string, SearchSession>;
 /**
  * Build the preliminary (fast-phase) search response. Unlike
- * {@link recordStructuredResultsSession} this NEVER touches memory or the
- * session registry — the final response owns those.
+ * {@link recordStructuredResultsSession} this NEVER touches memory — the final
+ * response owns that.
  */
-export declare function createPreliminarySearchDocumentsResponse(sessionId: string, query: string, details: AutoRAGFastAnswerDetails, diagnostics?: readonly SearchDocumentDiagnostic[]): SearchDocumentsResponse;
-export declare function createEmptySearchDocumentsResponse(sessionId: string, query: string, sessions: SearchSessions, diagnostics?: readonly SearchDocumentDiagnostic[]): SearchDocumentsResponse;
-export declare function recordStructuredResultsSession(sessionId: string, query: string, details: AutoRAGResultsDetails, sessions: SearchSessions, memory: RetrievalMemory, componentDiagnostics?: readonly SearchDocumentDiagnostic[], options?: {
-    /** Record the session registry only, skipping the retrieval-memory write. */
+export declare function createPreliminarySearchDocumentsResponse(sessionId: string, query: string, details: AutoRAGResultsDetails, diagnostics?: readonly SearchDocumentDiagnostic[]): SearchDocumentsResponse;
+export declare function createEmptySearchDocumentsResponse(sessionId: string, query: string, diagnostics?: readonly SearchDocumentDiagnostic[]): SearchDocumentsResponse;
+export declare function normalizeEntryEvidenceRefs(entry: AutoRAGMappingEntry): SessionEvidenceRef[];
+export declare function recordStructuredResultsSession(sessionId: string, query: string, details: AutoRAGResultsDetails, memory: RetrievalMemory, componentDiagnostics?: readonly SearchDocumentDiagnostic[], options?: {
+    /** Skip the retrieval-memory write. */
     readonly isolateMemory?: boolean;
 }): SearchDocumentsResponse;
-export {};

package/dist/agent/search-single-datasource-tool.d.ts

@@ -39,6 +39,7 @@ export interface SingleDatasourceSearchProvider {
     searchSingleDatasourceDocuments(datasourceId: string, query: string, options?: {
         readonly topK?: number;
         readonly scope?: string;
+        readonly signal?: AbortSignal;
     }): Promise<{
         readonly results: readonly RetrievalResult[];
         readonly diagnostics: readonly RetrievalDiagnostic[];

package/dist/agent/self-config.d.ts

@@ -35,6 +35,6 @@ export declare function rollbackIfBroken(options: SelfConfigOptions, before: str
 /**
  * The turn prompt for the `config` branch: the whole setup skill, where this
  * run's config lives, the safety rules for editing it, and the user's request.
- * The turn ends with `emit_autorag_results`; there is no fast answer.
+ * The turn ends with the model's plain final message; there is no fast answer.
  */
 export declare function buildSelfConfigPrompt(input: SelfConfigPromptInput): string;

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

@@ -1,4 +1,4 @@
-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 `autorag report` contract (explicit number -> source mapping). */
 export declare function validateReport(value: unknown): AutoRAGResultsDetails;

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

@@ -55,13 +55,14 @@ export interface WebSearchCliConfig {
 }
 /**
  * Jev decision-tool config. Absent disables the tool; `enabled: false` disables
- * it explicitly. Secrets never appear here: the `jev-use` engine reads the
- * backend credential from its own environment variable (`TYPESAFE_API_KEY`,
- * `OPENROUTER_API_KEY`, or `AI_GATEWAY_API_KEY`).
+ * 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 AutoRAG
+ * `autorag` backend reads `AUTORAG_API_KEY`.
  */
 export interface JevCliConfig {
     enabled?: boolean;
-    /** Force one backend; omit to let the first credential present win. */
+    /** Force one backend (`openrouter`, `typesafe`, `vercel`, or `autorag`); omit to let the first credential present win. */
     backend?: JevBackendName;
     /** Model id sent with every call, e.g. `jev-latest`. */
     model?: string;
@@ -75,20 +76,21 @@ export interface QueryDecompositionConfig {
 }
 /**
  * Post-merge reranking config. Routes merged evidence through a dedicated
- * rerank model. `provider` is `openrouter` today; `model` is the OpenRouter
- * wire id (default `voyageai/rerank-3-lite`). Secrets never appear here — only
- * the environment-variable name that holds the provider API key.
+ * rerank model. `provider` is `openrouter` (default) or the hosted AutoRAG
+ * plan (`autorag`); each provider supplies its own default `model` and
+ * `apiKeyEnv`. Secrets never appear here — only the environment-variable name
+ * that holds the provider API key.
  */
 export interface RerankConfig {
     /** `false` disables reranking. Missing means enabled when the block is present. */
     enabled?: boolean;
-    /** Provider id. @default "openrouter" */
+    /** Provider id (`openrouter` or `autorag`). @default "openrouter" */
     provider?: string;
-    /** Wire model id. @default "voyageai/rerank-3-lite" */
+    /** Wire model id. @default "voyageai/rerank-3-lite" (`openrouter`) / "qwen/qwen3-reranker-8b" (`autorag`) */
     model?: string;
-    /** Environment variable holding the provider API key. @default "OPENROUTER_API_KEY" */
+    /** Environment variable holding the provider API key. @default "OPENROUTER_API_KEY" (`openrouter`) / "AUTORAG_API_KEY" (`autorag`) */
     apiKeyEnv?: string;
-    /** Override the provider base URL (e.g. a gateway). */
+    /** Override the provider base URL (e.g. a gateway); for `autorag`, the API base including `/v1`. */
     baseUrl?: string;
     /** Return only the top N merged results. @default 25 (DEFAULT_RERANK_TOP_N) */
     topN?: number;