@autorag/librarian 2.6.3 → 2.7.0

package/dist/retrieval/index.d.ts

@@ -2,7 +2,7 @@ export { RetrievalEngine, type RetrievalEngineOptions } from "./engine.js";
 export type { MergeOptions } from "./merger.js";
 export { ParallelRetriever, ResultMerger } from "./merger.js";
 export { RetrievalMethodRegistry } from "./registry.js";
-export { type CreateRerankerOptions, createReranker, DEFAULT_RERANK_API_KEY_ENV, DEFAULT_RERANK_MODEL, DEFAULT_RERANK_PROVIDER, OpenRouterReranker, type OpenRouterRerankerOptions, type Reranker, type RerankerDescriptor, type RerankOptions, } from "./rerank.js";
+export { type CreateRerankerOptions, createReranker, DEFAULT_RERANK_API_KEY_ENV, DEFAULT_RERANK_MODEL, DEFAULT_RERANK_PROVIDER, OpenRouterReranker, type OpenRouterRerankerOptions, type Reranker, type RerankerDescriptor, type RerankOptions, SUPPORTED_RERANK_PROVIDERS, } from "./rerank.js";
 export { matchesVirtualPathScope, normalizeVirtualPath, normalizeVirtualPathScope, virtualPathScopeToRegExp, } from "./scope.js";
 export { describeRetrievalError, groupUnsearchedSurfaces, MINSYNC_SURFACE, type RetrievalSkip, retrievalSurfaceFor, } from "./skip.js";
 export type { CuratedResult, NumberedResult, RetrievalDiagnostic, RetrievalDiagnosticCode, RetrievalMethod, RetrievalMethodDescriptor, RetrievalOptions, RetrievalResult, RetrievalUnsearchedSurface, RetrievalWithDiagnostics, } from "./types.js";

package/dist/retrieval/rerank.d.ts

@@ -18,6 +18,8 @@ export declare const DEFAULT_RERANK_MODEL = "voyageai/rerank-3-lite";
 export declare const DEFAULT_RERANK_PROVIDER = "openrouter";
 /** Default environment variable holding the OpenRouter API key. */
 export declare const DEFAULT_RERANK_API_KEY_ENV = "OPENROUTER_API_KEY";
+/** Rerank providers {@link createReranker} can build. */
+export declare const SUPPORTED_RERANK_PROVIDERS: readonly string[];
 /** Static description of a reranker, used for diagnostics and inspection. */
 export interface RerankerDescriptor {
     /** Stable label (e.g. `openrouter`). */
@@ -57,6 +59,8 @@ export interface RerankClient {
             documents: string[];
             topN?: number;
         };
+    }, options?: {
+        signal?: AbortSignal;
     }): Promise<RerankResponse>;
 }
 /** Response body returned by OpenRouter's rerank router. */
@@ -92,9 +96,8 @@ export interface CreateRerankerOptions extends OpenRouterRerankerOptions {
 }
 /**
  * Build the configured reranker. Returns `undefined` when reranking is disabled
- * or absent, or when the provider is unsupported. Provider-agnostic by design:
- * a local reranker implements {@link Reranker} and plugs in here without
- * touching the retrieval pipeline.
+ * or absent. Throws for a provider AutoRAG cannot build (an unsupported
+ * `provider` id is a configuration error, not a silent no-op).
  */
 export declare function createReranker(config: CreateRerankerOptions | false | undefined): Reranker | undefined;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autorag/librarian",
-  "version": "2.6.3",
+  "version": "2.7.0",
   "description": "Self-evolving librarian agent on Pi framework with pluggable retrieval methods",
   "license": "MIT",
   "repository": {
@@ -77,5 +77,8 @@
     "typescript": "^7.0.2",
     "vitest": "^5.0.0",
     "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz"
+  },
+  "overrides": {
+    "zod": "3.25.76"
   }
 }

package/skills/autorag-setup/SKILL.md

@@ -106,9 +106,20 @@ autorag init \
   --model-id MODEL
 ```
 
-If the authenticated local runtime already supplies the intended model, model
-flags may be omitted. For a custom endpoint, add `api`, `baseUrl`, and
-`apiKeyEnv` to the single `model` object in the trusted config:
+Model resolution runs through the pi runtime. A configured `provider`/`id` is
+resolved against the pi runtime catalog — the built-in providers plus any
+`~/.pi/agent/models.json`, custom, or extension providers — and credentials come
+from stored pi auth (`~/.pi/agent/auth.json`, API key or OAuth established with
+`pi /login`), then provider environment variables. When no `model` is
+configured, AutoRAG uses pi's `defaultProvider`/`defaultModel` when that
+provider has configured credentials; otherwise it falls back to the
+authenticated local codex runtime. So model flags may be omitted when either pi
+or the local runtime already supplies the intended model. Inspect what pi can
+resolve with `autorag models list` (`--available` shows only providers with
+configured credentials); it never prints credential values.
+
+For a custom endpoint, add `api`, `baseUrl`, and `apiKeyEnv` to the single
+`model` object in the trusted config:
 
 ```json
 {
@@ -123,12 +134,12 @@ flags may be omitted. For a custom endpoint, add `api`, `baseUrl`, and
 }
 ```
 
-When `provider`/`id` names a pi-ai catalog model, the catalog entry stays the
-base: `baseUrl`, `api`, and any declared `reasoning`, `input`, `contextWindow`,
-or `maxTokens` override only those fields, and the catalog's reasoning,
-thinking, and compat settings are kept. Only an id outside the catalog (private
-proxy, Ollama, LiteLLM) gets a generic text model with a 128k context window
-unless those fields are declared.
+When `provider`/`id` names a pi runtime catalog model, the catalog entry stays
+the base: `baseUrl`, `api`, and any declared `reasoning`, `input`,
+`contextWindow`, or `maxTokens` override only those fields, and the catalog's
+reasoning, thinking, and compat settings are kept. Only an id outside the
+catalog (private proxy, Ollama, LiteLLM) gets a generic text model with a 128k
+context window unless those fields are declared.
 
 Use `--force` only when intentionally replacing an existing config. Legacy cwd
 `autorag.config.json` is a migration source only and is never deleted by init.

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

@@ -1,32 +0,0 @@
-import type { AgentTool } from "@earendil-works/pi-agent-core";
-import { Type } from "typebox";
-export declare const BASH_TOOL_NAME = "bash";
-declare const bashSchema: Type.TObject<{
-    command: Type.TString;
-    cwd: Type.TOptional<Type.TString>;
-    timeoutMs: Type.TOptional<Type.TInteger>;
-}>;
-export interface BashToolOptions {
-    /** Default working directory for spawned commands. */
-    readonly cwd: string;
-    /** Maximum wall-clock time per command before it is killed. */
-    readonly timeoutMs?: number;
-    /** Maximum captured output bytes before truncation. */
-    readonly maxOutputBytes?: number;
-}
-export interface BashToolDetails {
-    readonly method: "bash";
-    readonly command: string;
-    readonly aborted: boolean;
-    readonly exitCode: number | undefined;
-    readonly terminationFailed: boolean;
-    readonly timedOut: boolean;
-    readonly truncated: boolean;
-}
-/**
- * Real shell access for the librarian agent. AutoRAG navigates and reads the
- * configured collection directly through this tool (ls, find, grep, cat, …).
- * Output — including real filesystem paths — is returned to the model verbatim.
- */
-export declare function createBashTool(options: BashToolOptions): AgentTool<typeof bashSchema, BashToolDetails>;
-export {};

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

@@ -1,16 +0,0 @@
-import type { SlashCommand } from "@earendil-works/pi-tui";
-import type { TuiSessionStore } from "./tui-session-store.js";
-export type ParsedSlashCommand = {
-    kind: "incomplete";
-} | {
-    kind: "quit";
-} | {
-    kind: "resume";
-    sessionId: string | undefined;
-} | {
-    kind: "unknown";
-    name: string;
-};
-export declare function parseSlashCommand(input: string): ParsedSlashCommand | undefined;
-export declare function createTuiSlashCommands(store: TuiSessionStore): SlashCommand[];
-export declare function renderSlashHelp(): string;

package/dist/cli/tui-session-store.d.ts

@@ -1,16 +0,0 @@
-export interface TuiSessionRecord {
-    readonly id: string;
-    readonly query: string;
-    readonly answer: string;
-    readonly trace: string;
-    readonly updatedAt: number;
-}
-export interface TuiSessionStore {
-    list(): readonly TuiSessionRecord[];
-    get(id: string): TuiSessionRecord | undefined;
-    save(session: TuiSessionRecord): void;
-}
-export declare function createFileTuiSessionStore(path: string): TuiSessionStore;
-export declare function createMergedTuiSessionStore(...stores: readonly TuiSessionStore[]): TuiSessionStore;
-export declare function renderTuiSessionList(sessions: readonly TuiSessionRecord[]): string;
-export declare function renderRestoredTuiSession(session: TuiSessionRecord): string;