@autorag/librarian 2.1.0 → 2.3.0

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

@@ -14,5 +14,5 @@ export interface SearchBM25DocumentsDetails {
     readonly readiness: BM25Status["readiness"];
     readonly engine: BM25Status["engine"];
 }
-export declare function createSearchBM25DocumentsTool(getMethod: () => BM25Method | undefined): AgentTool<typeof searchBM25Schema, SearchBM25DocumentsDetails>;
+export declare function createSearchBM25DocumentsTool(getMethod: () => BM25Method | 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" | "duplicate-excluded" | "unsupported-file" | "stale-index" | "deleted-mirror" | "retrieval-method-failed" | "jikji-unavailable" | "jikji-prepare-failed" | "jikji-find-failed" | "refresh-failed" | "watch-failed" | "watch-limited";
 export interface SearchDocumentDiagnostic {
     readonly code: SearchDocumentDiagnosticCode;
     readonly severity: SearchDocumentDiagnosticSeverity;

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

@@ -20,5 +20,5 @@ export interface SearchMinSyncDocumentsDetails {
  * tool returns a path-free unavailable message with `available: false` and a
  * zero result count — never a real binary or workspace path.
  */
-export declare function createSearchMinSyncDocumentsTool(getMethod: () => MinSyncVectorMethod | undefined): AgentTool<typeof searchMinSyncSchema, SearchMinSyncDocumentsDetails>;
+export declare function createSearchMinSyncDocumentsTool(getMethod: () => MinSyncVectorMethod | undefined, resolveScope?: (scope: string | undefined) => string | undefined): AgentTool<typeof searchMinSyncSchema, SearchMinSyncDocumentsDetails>;
 export {};

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/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/config.d.ts

@@ -1,10 +1,10 @@
 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";
@@ -76,16 +76,17 @@ 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>;
     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. */
@@ -133,7 +134,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 +160,12 @@ 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 writeDefaultConfig(path: string, partial: Partial<CliConfig>, opts?: {
     force?: boolean;
     atomicCreate?: boolean;