@autorag/librarian 2.2.0 → 2.4.0

package/dist/agent/dupey-tool.d.ts

@@ -0,0 +1,15 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import { Type } from "typebox";
+import type { DupeyScanResult } from "../dupey/index.js";
+export declare const SCAN_DUPLICATE_DOCUMENTS_TOOL_NAME = "scan_duplicate_documents";
+export interface ScanDuplicateDocumentsDetails {
+    readonly scans: readonly DupeyScanResult[];
+    readonly familyCount: number;
+    readonly exactDuplicateCount: number;
+}
+export interface ScanDuplicateDocumentsProvider {
+    scanDuplicateDocuments(): Promise<ScanDuplicateDocumentsDetails>;
+}
+declare const scanDuplicateDocumentsSchema: Type.TObject<{}>;
+export declare function createScanDuplicateDocumentsTool(provider: ScanDuplicateDocumentsProvider): AgentTool<typeof scanDuplicateDocumentsSchema, ScanDuplicateDocumentsDetails>;
+export {};

package/dist/agent/emit-results-tool.d.ts

@@ -27,6 +27,13 @@ declare const emitResultsSchema: Type.TObject<{
             chunkIndex: Type.TOptional<Type.TInteger>;
             lineNumber: Type.TOptional<Type.TInteger>;
             stableEvidenceId: Type.TOptional<Type.TString>;
+            retrieverMix: Type.TOptional<Type.TArray<Type.TString>>;
+            parserType: Type.TOptional<Type.TString>;
+            documentType: Type.TOptional<Type.TString>;
+            documentArea: Type.TOptional<Type.TString>;
+            evidenceType: Type.TOptional<Type.TString>;
+            evidenceLocation: Type.TOptional<Type.TString>;
+            confidence: Type.TOptional<Type.TNumber>;
         }>>>;
     }>>;
     warnings: Type.TOptional<Type.TArray<Type.TString>>;
@@ -51,6 +58,13 @@ export interface AutoRAGEvidenceRef {
     readonly chunkIndex?: number;
     readonly lineNumber?: number;
     readonly stableEvidenceId?: string;
+    readonly retrieverMix?: readonly string[];
+    readonly parserType?: string;
+    readonly documentType?: string;
+    readonly documentArea?: string;
+    readonly evidenceType?: string;
+    readonly evidenceLocation?: string;
+    readonly confidence?: number;
 }
 export interface AutoRAGMappingEntry {
     readonly number: number;

package/dist/agent/index.d.ts

@@ -1,6 +1,7 @@
 export type { AutoRAGAgentOptions, AutoRefreshOptions } from "./agent.js";
 export { AutoRAGAgent } from "./agent.js";
 export { buildDatasourceSkillsPrompt, createLoadDatasourceSkillTool, type DatasourceSkillProvider, datasourceSkillLocation, formatDatasourceSkillInvocation, LOAD_DATASOURCE_SKILL_TOOL_NAME, type LoadDatasourceSkillDetails, toDatasourceAgentSkill, } from "./datasource-skill.js";
+export { createScanDuplicateDocumentsTool, SCAN_DUPLICATE_DOCUMENTS_TOOL_NAME, type ScanDuplicateDocumentsDetails, type ScanDuplicateDocumentsProvider, } from "./dupey-tool.js";
 export type { AutoRAGEmittedResult, AutoRAGMappingEntry, AutoRAGResultsDetails, } from "./emit-results-tool.js";
 export { createEmitResultsTool, EMIT_AUTORAG_RESULTS_TOOL_NAME } from "./emit-results-tool.js";
 export { createJikjiFindTool, JIKJI_FIND_TOOL_NAME, type JikjiFindDetails, type JikjiFindPerRootPolicy, type JikjiFindProvider, type JikjiFindProviderResult, type MergedJikjiPolicy, } from "./jikji-find-tool.js";

package/dist/agent/local-model.d.ts

@@ -0,0 +1,12 @@
+import type { Model } from "@earendil-works/pi-ai";
+export interface LocalAutoRAGModel {
+    readonly provider: string;
+    readonly apiKey: string;
+    readonly model: Model<"openai-responses">;
+}
+export interface LoadLocalAutoRAGModelOptions {
+    readonly configPath?: string;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    readonly modelId?: string;
+}
+export declare function loadLocalAutoRAGModel(options?: LoadLocalAutoRAGModelOptions): LocalAutoRAGModel;

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

@@ -1,7 +1,8 @@
 import type { AgentTool } from "@earendil-works/pi-agent-core";
 import { Type } from "typebox";
-import type { BM25Method, BM25Status } from "../retrieval/methods/bm25.js";
-export declare const SEARCH_BM25_DOCUMENTS_TOOL_NAME = "search_bm25_documents";
+import type { BM25Status } from "../retrieval/methods/bm25.js";
+import type { RetrievalResult } from "../retrieval/types.js";
+export declare const SEARCH_BM25_DOCUMENTS_TOOL_NAME = "lexical_search_local_docs";
 declare const searchBM25Schema: Type.TObject<{
     query: Type.TString;
     topK: Type.TOptional<Type.TInteger>;
@@ -14,5 +15,12 @@ export interface SearchBM25DocumentsDetails {
     readonly readiness: BM25Status["readiness"];
     readonly engine: BM25Status["engine"];
 }
-export declare function createSearchBM25DocumentsTool(getMethod: () => BM25Method | undefined, resolveScope?: (scope: string | undefined) => string | undefined): AgentTool<typeof searchBM25Schema, SearchBM25DocumentsDetails>;
+export interface BM25SearchMethod {
+    getStatus(): BM25Status;
+    retrieve(query: string, options: {
+        topK?: number;
+        scope?: string;
+    }): Promise<RetrievalResult[]>;
+}
+export declare function createSearchBM25DocumentsTool(getMethod: () => BM25SearchMethod | undefined, resolveScope?: (scope: string | undefined) => string | undefined): AgentTool<typeof searchBM25Schema, SearchBM25DocumentsDetails>;
 export {};

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

@@ -9,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" | "unknown-warning" | "caller-tool-dropped" | "bm25-unavailable" | "bm25-degraded-fallback" | "minsync-unavailable" | "parser-skipped" | "parser-failed" | "unsupported-file" | "stale-index" | "deleted-mirror" | "retrieval-method-failed" | "jikji-unavailable" | "jikji-prepare-failed" | "jikji-find-failed" | "refresh-failed" | "watch-failed" | "watch-limited";
+export type SearchDocumentDiagnosticCode = "empty-query" | "unknown-warning" | "caller-tool-dropped" | "bm25-unavailable" | "bm25-degraded-fallback" | "minsync-unavailable" | "parser-skipped" | "parser-failed" | "pdf-java-version" | "duplicate-excluded" | "unsupported-file" | "stale-index" | "deleted-mirror" | "pdf-extract-thin" | "pdf-hybrid-unavailable" | "retrieval-method-failed" | "jikji-unavailable" | "jikji-prepare-failed" | "jikji-find-failed" | "refresh-failed" | "watch-failed" | "watch-limited" | "unknown-datasource-skill";
 export interface SearchDocumentDiagnostic {
     readonly code: SearchDocumentDiagnosticCode;
     readonly severity: SearchDocumentDiagnosticSeverity;
@@ -51,7 +51,7 @@ type ReadonlySearchSessions = ReadonlyMap<string, {
     query: string;
     registry: ReadonlyMap<number, CuratedResult>;
 }>;
-export declare function createEmptySearchDocumentsResponse(sessionId: string, query: string, sessions: SearchSessions): 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[]): SearchDocumentsResponse;
 export declare function recordNumberedFeedback(sessions: ReadonlySearchSessions, memory: RetrievalMemory, sessionId: string, usefulNumbers: readonly number[], notUsefulNumbers: readonly number[]): void;
 export {};

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

@@ -1,14 +1,14 @@
 import type { AgentTool } from "@earendil-works/pi-agent-core";
 import { Type } from "typebox";
 import type { MinSyncVectorMethod } from "../minsync/method.js";
-export declare const SEARCH_MINSYNC_DOCUMENTS_TOOL_NAME = "search_minsync_documents";
+export declare const SEARCH_MINSYNC_DOCUMENTS_TOOL_NAME = "semantic_search_local_docs";
 declare const searchMinSyncSchema: Type.TObject<{
     query: Type.TString;
     topK: Type.TOptional<Type.TInteger>;
     scope: Type.TOptional<Type.TString>;
 }>;
 export interface SearchMinSyncDocumentsDetails {
-    readonly method: "search_minsync_documents";
+    readonly method: "semantic_search_local_docs";
     readonly resultCount: number;
     readonly sources: readonly string[];
     readonly available: boolean;

package/dist/agent/system-prompt.d.ts

@@ -2,8 +2,7 @@ import type { Skill } from "@earendil-works/pi-agent-core";
 import type { StoreManifest } from "../manifest/types.js";
 export interface SystemPromptConfig {
     toolNames: string[];
-    orchestratorModelId?: string;
-    explorerModelId?: string;
+    modelId?: string;
     memorySignalCount?: number;
     memoryEntries?: readonly unknown[];
     manifests: StoreManifest[];

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

@@ -0,0 +1,4 @@
+import type { DupeyScanResult } from "../../dupey/index.js";
+import type { CommandContext } from "./types.js";
+export type DuplicateScanner = (path: string) => Promise<DupeyScanResult>;
+export declare function runDuplicates(ctx: CommandContext, scanner?: DuplicateScanner): Promise<number>;

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

@@ -1,12 +1,10 @@
 import type { Api, Model } from "@earendil-works/pi-ai";
-import type { LoadLocalAutoRAGModelsOptions } from "../../subagents/local-models.js";
-import { type CliConfig } from "../config.js";
+import type { LoadLocalAutoRAGModelOptions } from "../../agent/local-model.js";
+import { type CliConfig, type ResolvedAgentModelDetailed } from "../config.js";
 import type { CommandContext } from "./types.js";
-export type HealthCategory = "config" | "model_resolution" | "auth_missing" | "provider_unreachable" | "completion_failed" | "subagent_failed" | "timeout" | "ok";
-export type HealthRole = "orchestrator" | "explorer";
+export type HealthCategory = "config" | "model_resolution" | "auth_missing" | "provider_unreachable" | "completion_failed" | "timeout" | "ok";
 export interface HealthCoverage {
     modelProvider: boolean;
-    subagentDispatch: boolean;
     retrievalTools: false;
     searchCuration: false;
     indexHealth: false;
@@ -17,12 +15,10 @@ export interface HealthRoleAuth {
     envName?: string;
 }
 export interface HealthRoleReport {
-    role: HealthRole;
     provider: string;
     modelId: string;
     displayName?: string;
     api: string;
-    routeFamily?: string;
     baseUrl?: string;
     contextWindow?: number;
     maxTokens?: number;
@@ -35,7 +31,6 @@ export interface HealthRoleReport {
     resolutionSource: "config" | "flags" | "env" | "local_runtime" | "catalog" | "configured_alias" | "mixed";
 }
 export interface HealthProbeReport {
-    role: HealthRole;
     skipped: boolean;
     ok: boolean;
     category: HealthCategory;
@@ -55,75 +50,32 @@ export interface HealthReportV1 {
     probesSkipped: boolean;
     coverage: HealthCoverage;
     config: HealthConfigReport;
-    models: {
-        orchestrator?: HealthRoleReport;
-        explorer?: HealthRoleReport;
-    };
-    probes: {
-        orchestrator?: HealthProbeReport;
-        explorer?: HealthProbeReport;
-    };
+    model?: HealthRoleReport;
+    probe?: HealthProbeReport;
     indexHealth: {
         separate: true;
         command: "autorag status";
         included: false;
     };
 }
-/**
- * Probe input passed to injected orchestrator/explorer probes. Credential
- * values are present for the probe to use but must never be surfaced in
- * rendered output.
- */
 export interface ProbeInput {
-    role: HealthRole;
     model: Model<Api>;
     apiKey?: string;
     providerApiKeys?: Readonly<Record<string, string>>;
     timeoutMs: number;
     cwd: string;
 }
-/**
- * Probe outcome returned by injected probes. `category` is the per-role
- * health category; `message` is already sanitized (no secrets/paths/stacks).
- */
 export interface ProbeOutput {
     ok: boolean;
     category: HealthCategory;
     message?: string;
 }
-/**
- * Detailed role metadata produced by the model resolver. The default
- * adapter derives this from {@link resolveAgentModel}; when config exports a
- * dedicated `resolveAgentModelDetailed`, the health command prefers it.
- */
-export interface ResolvedHealthRole {
-    readonly provider: string;
-    readonly modelId: string;
-    readonly displayName?: string;
-    readonly api: Api;
-    readonly baseUrl?: string;
-    readonly contextWindow?: number;
-    readonly maxTokens?: number;
-    readonly capabilities: {
-        input: readonly string[];
-        reasoning: boolean;
-    };
-    readonly auth: {
-        present: boolean;
-        source: "env" | "local_runtime" | "pi_auth" | "catalog" | "none" | "unknown";
-        envName?: string;
-    };
-    readonly resolutionSource: "config" | "flags" | "env" | "local_runtime" | "catalog" | "configured_alias" | "mixed";
-}
+export type ResolvedHealthRole = ResolvedAgentModelDetailed["role"];
 export interface ResolvedHealthModel {
     readonly model: Model<Api>;
-    readonly explorerModel: Model<Api>;
     readonly apiKey?: string;
     readonly providerApiKeys?: Readonly<Record<string, string>>;
-    readonly roles: {
-        orchestrator: ResolvedHealthRole;
-        explorer: ResolvedHealthRole;
-    };
+    readonly role: ResolvedHealthRole;
 }
 export interface HealthDeps {
     configResolver?: (input: {
@@ -131,16 +83,8 @@ export interface HealthDeps {
         cwd?: string;
         env?: NodeJS.ProcessEnv;
     }) => CliConfig;
-    modelResolver?: (config: CliConfig, localOptions?: LoadLocalAutoRAGModelsOptions) => ResolvedHealthModel;
-    orchestratorProbe?: (input: ProbeInput, signal: AbortSignal) => Promise<ProbeOutput>;
-    explorerProbe?: (input: ProbeInput, signal: AbortSignal) => Promise<ProbeOutput>;
+    modelResolver?: (config: CliConfig, localOptions?: LoadLocalAutoRAGModelOptions) => ResolvedHealthModel;
+    probe?: (input: ProbeInput, signal: AbortSignal) => Promise<ProbeOutput>;
     now?: () => number;
 }
-/**
- * Run the `autorag health` command. Returns an exit code and writes the
- * rendered health report to `ctx.stdout` (or an error to `ctx.stderr`).
- *
- * All network/runtime behavior is injectable via `deps`; unit tests inject
- * fake resolvers/probes and never touch live networks.
- */
 export declare function runHealth(ctx: CommandContext, deps?: HealthDeps): Promise<number>;

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

@@ -1,8 +1,8 @@
 import type { CommandContext } from "./types.js";
 /**
- * Run the `autorag index` command. `reset` removes the parsed mirror, BM25,
- * and MinSync index directories under `.autorag` (preserving `bin`,
- * `datasources`, and the memory file). `rebuild` resets then re-runs a forced
+ * Run the `autorag index` command. `reset` removes the parsed mirror
+ * MinSync, and leftover legacy BM25 index directories under `.autorag`
+ * (preserving `bin`, `datasources`, and the memory file). `rebuild` resets then re-runs a forced
  * refresh. Returns 0 on success, 2 for usage/decline errors, 1 for runtime
  * errors including path-escape guard violations.
  */

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

@@ -1,7 +1,7 @@
 import type { CommandContext } from "./types.js";
 /**
  * `autorag init` writes the default config to `~/.autorag/config.json`.
- * Role-specific model flags are folded into the generated config. A legacy
+ * Model flags are folded into the generated config. A legacy
  * `autorag.config.json` in the current working directory may be migrated
  * non-destructively. An existing home config is not overwritten without
  * `--force`.

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

@@ -4,12 +4,12 @@ import type { CommandContext } from "./types.js";
 /**
  * A recoverable health hint surfaced when `autorag search` fails for a reason
  * that `autorag health` can diagnose. The classifier only produces hints for
- * model/provider/subagent failures — never for retrieval, index, datasource,
+ * model/provider failures — never for retrieval, index, datasource,
  * or empty-query errors.
  */
 export interface SearchHealthHint {
     command: "autorag health";
-    reason: "model_resolution" | "subagent_failed" | "auth_missing" | "provider_unreachable" | "timeout";
+    reason: "model_resolution" | "auth_missing" | "provider_unreachable" | "timeout";
     message: string;
 }
 /**

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

@@ -0,0 +1,36 @@
+import type { AgentEvent } from "@earendil-works/pi-agent-core";
+import { AutoRAGAgent, type AutoRAGAgentOptions } from "../../agent/agent.js";
+import { type CliConfig, type ResolvedAgentModel } from "../config.js";
+import { type TuiSessionRecord, type TuiSessionStore } from "../tui-session-store.js";
+import type { CommandContext } from "./types.js";
+export { parseSlashCommand } from "../tui-commands.js";
+export interface TuiDriver {
+    submissions: string[];
+    rendered: string[];
+    started: boolean;
+    stopped: boolean;
+    onSubmit?: (text: string) => void | Promise<void>;
+    onExit?: () => void;
+    onEvent?: (event: AgentEvent) => void;
+    onInput?: (data: string) => void;
+}
+export interface TuiPresenter {
+    handle(event: AgentEvent): void;
+    lines(): readonly string[];
+    working(): boolean;
+    setWorking(active: boolean): void;
+    beginRun(): void;
+    interrupt(): void;
+    status(): string;
+    reset(): void;
+}
+type TuiAgent = Pick<AutoRAGAgent, "searchDocuments"> & Partial<Pick<AutoRAGAgent, "subscribe" | "abort">>;
+export interface TuiDeps {
+    agentFactory?: (opts?: AutoRAGAgentOptions) => TuiAgent;
+    modelResolver?: (config: CliConfig) => ResolvedAgentModel;
+    tuiFactory?: (ctx: CommandContext) => TuiDriver;
+    sessionStore?: TuiSessionStore;
+}
+export declare function createTuiPresenter(): TuiPresenter;
+export declare function renderTuiSessionView(session: TuiSessionRecord | undefined, input: string): string;
+export declare function runTui(ctx: CommandContext, deps?: TuiDeps): Promise<number>;

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

@@ -0,0 +1,13 @@
+import { startUiServer, type UiServer } from "../../ui/server.js";
+import type { CommandContext } from "./types.js";
+export interface UiCommandDeps {
+    readonly startServer?: typeof startUiServer;
+    readonly openBrowser?: (url: string) => Promise<void>;
+    readonly waitUntilStopped?: (server: UiServer) => Promise<void>;
+    readonly createToken?: () => string;
+}
+/**
+ * `autorag ui` — local loopback dashboard for folders and datasource connections.
+ */
+export declare function runUi(ctx: CommandContext, deps?: UiCommandDeps): Promise<number>;
+export declare function openBrowser(url: string): Promise<void>;

package/dist/cli/config.d.ts

@@ -1,10 +1,9 @@
 import type { Api, Model } from "@earendil-works/pi-ai";
 import type { AutoRAGAgentOptions } from "../agent/agent.js";
+import { type LoadLocalAutoRAGModelOptions } from "../agent/local-model.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";
-import type { BM25Engine, BM25FallbackMode } from "../retrieval/methods/bm25.js";
-import { type LoadLocalAutoRAGModelsOptions } from "../subagents/local-models.js";
 export declare const DEFAULT_CONFIG_FILENAME = "config.json";
 export declare const LEGACY_CONFIG_FILENAME = "autorag.config.json";
 export { AUTORAG_HOME_ENV, resolveAutoRAGHome } from "../config/home.js";
@@ -17,14 +16,10 @@ export declare class ConfigError extends Error {
  */
 export interface Bm25MethodConfig {
     enabled?: boolean;
-    indexPath?: string;
-    fallback?: BM25FallbackMode;
-    forceEngine?: Exclude<BM25Engine, "none">;
-    importBinding?: () => Promise<typeof import("@pngwasi/node-tantivy-binding")>;
 }
 /**
  * Typed MinSync method config persisted in `config.json`. Missing `enabled`
- * means enabled (true); `autoInstall` defaults to false. `embedder` carries
+ * means enabled (true); `autoInstall` defaults to true. `embedder` carries
  * the MinSync vector embedder settings validated by {@link normalizeEmbedder}.
  */
 export interface MinSyncMethodConfig {
@@ -32,6 +27,7 @@ export interface MinSyncMethodConfig {
     autoInstall?: boolean;
     binaryPath?: string;
     workspacePath?: string;
+    maxChunkSize?: number;
     installer?: Omit<EnsureMinSyncBinaryOptions, "root">;
     embedder?: MinSyncEmbedderConfig;
 }
@@ -45,6 +41,14 @@ export interface NormalizedIndexingConfig {
     bm25: Bm25MethodConfig;
     minSync: MinSyncMethodConfig;
 }
+export interface UiConfig {
+    host?: string;
+    port?: number;
+    allowRemote?: boolean;
+    publicOrigin?: string;
+    corsOrigins?: string[];
+    tokenEnv?: string;
+}
 export interface AgentModelConfig {
     /** Provider identity used for auth lookup and Model.provider (e.g. openrouter, fireworks, ollama). */
     provider: string;
@@ -76,20 +80,23 @@ export interface CliConfig {
     searchPaths: string[];
     workspacePath: string;
     memoryPath: string;
-    /** @deprecated Prefer agents.orchestrator. Kept for legacy single-model configs. */
     model?: AgentModelConfig;
-    agents?: {
-        orchestrator?: AgentModelConfig;
-        explorer?: AgentModelConfig;
-    };
     minSync?: MinSyncMethodConfig;
     bm25?: Bm25MethodConfig;
-    jikji?: Record<string, unknown>;
+    jikji?: Record<string, unknown> | false;
     parserOptions?: Record<string, unknown>;
+    dupey?: {
+        enabled?: boolean;
+        binaryPath?: string;
+        timeoutMs?: number;
+    };
+    excludeExactDuplicates?: boolean;
     /** Trusted datasource skill configuration (skill name → config). */
     datasources?: DatasourcesConfig;
     /** Trusted datasource allow-tags/allow-scopes. Absent ⇒ default-deny. */
     datasourceAccess?: DatasourceAccessContextOptions;
+    /** Optional local/deployment settings for the datasource UI. */
+    ui?: UiConfig;
 }
 export interface ResolveConfigInput {
     flags: Record<string, string | boolean | undefined>;
@@ -114,7 +121,7 @@ export declare function normalizeEmbedder(raw: unknown, path: string): MinSyncEm
 /**
  * Normalize raw indexing method config into a fully-populated shape.
  *
- * - `undefined` / missing key => `{ enabled: true }` (minSync `autoInstall: false`)
+ * - `undefined` / missing key => `{ enabled: true, autoInstall: true }`
  * - `false` => `{ enabled: false }` (disabled marker)
  * - object merges with `enabled: true` default and is validated
  *
@@ -133,7 +140,6 @@ export declare function buildAgentOptions(config: CliConfig): Omit<AutoRAGAgentO
 export declare function resolveModel(config: CliConfig): Model<Api>;
 export interface ResolvedAgentModel {
     readonly model: Model<Api>;
-    readonly explorerModel: Model<Api>;
     readonly apiKey?: string;
     readonly providerApiKeys?: Readonly<Record<string, string>>;
 }
@@ -160,16 +166,15 @@ export interface ResolvedAgentModelRole {
 }
 export interface ResolvedAgentModelDetailed {
     readonly model: Model<Api>;
-    readonly explorerModel: Model<Api>;
     readonly apiKey?: string;
     readonly providerApiKeys?: Readonly<Record<string, string>>;
-    readonly roles: {
-        readonly orchestrator: ResolvedAgentModelRole;
-        readonly explorer: ResolvedAgentModelRole;
-    };
+    readonly role: ResolvedAgentModelRole;
 }
-export declare function resolveAgentModel(config: CliConfig, localOptions?: LoadLocalAutoRAGModelsOptions): ResolvedAgentModel;
-export declare function resolveAgentModelDetailed(config: CliConfig, localOptions?: LoadLocalAutoRAGModelsOptions): ResolvedAgentModelDetailed;
+export declare function resolveAgentModel(config: CliConfig, localOptions?: LoadLocalAutoRAGModelOptions): ResolvedAgentModel;
+export declare function resolveAgentModelDetailed(config: CliConfig, localOptions?: LoadLocalAutoRAGModelOptions): ResolvedAgentModelDetailed;
+export declare function readRawConfigObject(path: string): Record<string, unknown>;
+/** Atomically replace a config file, preserving the caller's JSON object. */
+export declare function writeConfigObject(path: string, config: unknown): void;
 export declare function writeDefaultConfig(path: string, partial: Partial<CliConfig>, opts?: {
     force?: boolean;
     atomicCreate?: boolean;