@autorag/librarian 2.10.0 → 2.10.2

package/dist/agent/tool-burst-guard.d.ts

@@ -0,0 +1,26 @@
+export interface ToolBurstGuardOptions {
+    /** Calls of one tool inside `windowMs` that count as a runaway loop. */
+    readonly maxCalls: number;
+    /** Sliding window, in milliseconds. */
+    readonly windowMs: number;
+}
+/** One tool called 60 times inside 60 seconds is a loop, not work. */
+export declare const DEFAULT_TOOL_BURST_GUARD: ToolBurstGuardOptions;
+/**
+ * Detects a runaway tool loop: the same tool called `maxCalls` times inside
+ * `windowMs`. It limits the rate of one tool, never a run's total length or
+ * duration, so a long indexing job or a many-step run is never cut short.
+ * It reports every call that is part of a burst; `reset()` clears it for the next run.
+ */
+export declare class ToolBurstGuard {
+    private readonly options;
+    private readonly calls;
+    constructor(options?: ToolBurstGuardOptions | false);
+    /**
+     * Record one call. Returns true while the tool is inside a burst: on the call that
+     * reaches `maxCalls` and on every further call in the window. An abort issued
+     * mid-tool does not always stop the next model turn, so the caller keeps aborting.
+     */
+    record(tool: string, now?: number): boolean;
+    reset(): void;
+}

package/dist/cli/config.d.ts

@@ -1,6 +1,6 @@
 import type { Api, Model } from "@earendil-works/pi-ai";
 import { ModelRuntime } from "@earendil-works/pi-coding-agent";
-import type { AutoRAGAgentOptions, AutoRAGRetrievalLimits } from "../agent/agent.js";
+import type { AutoRAGAgentOptions, AutoRAGRefreshLimits, AutoRAGRetrievalLimits } from "../agent/agent.js";
 import type { JevBackendName } from "../agent/jev-extension.js";
 import { type LoadLocalAutoRAGModelOptions } from "../agent/local-model.js";
 import type { DecompositionModel } from "../agent/query-decomposition.js";
@@ -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 Dazzi Models
+ * `dazzi` backend uses the credential stored by `/login`.
  */
 export interface JevCliConfig {
     enabled?: boolean;
-    /** Force one backend; omit to let the first credential present win. */
+    /** Force one backend (`openrouter`, `typesafe`, `vercel`, or `dazzi`); 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,22 @@ 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 Dazzi Models
+ * plan (`dazzi`); each provider supplies its own default `model`. OpenRouter
+ * reads its key from `apiKeyEnv`; Dazzi uses the credential stored by `/login`.
+ * Secrets never appear here — only the environment-variable name that holds a
+ * 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 `dazzi`). @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" (`dazzi`) */
     model?: string;
-    /** Environment variable holding the provider API key. @default "OPENROUTER_API_KEY" */
+    /** Environment variable holding the provider API key (`openrouter` only). @default "OPENROUTER_API_KEY" */
     apiKeyEnv?: string;
-    /** Override the provider base URL (e.g. a gateway). */
+    /** Override the provider base URL (e.g. a gateway); for `dazzi`, the API base including `/v1`. */
     baseUrl?: string;
     /** Return only the top N merged results. @default 25 (DEFAULT_RERANK_TOP_N) */
     topN?: number;
@@ -110,7 +113,6 @@ export interface P2pConfig {
     };
     injectionClassifier?: boolean;
     piiNer?: boolean;
-    searchTimeoutMs?: number;
     newFilesPublic?: boolean;
 }
 export interface AgentModelConfig {
@@ -180,7 +182,7 @@ export interface CliConfig {
     /**
      * Question decomposition for the Jev query pipeline. `model` names the LLM
      * that splits one question into at most five search queries; absent or `{}`
-     * uses {@link DEFAULT_QUERY_DECOMPOSITION_MODEL}, and `false` lets the
+     * uses {@link defaultQueryDecompositionModel}, and `false` lets the
      * agent's own model decompose.
      */
     queryDecomposition?: QueryDecompositionConfig | false;
@@ -197,6 +199,8 @@ export interface CliConfig {
     excludePaths?: string[];
     /** Hard caps on retrieval, baseline prefetch, and model-facing candidate lists. */
     limits?: AutoRAGRetrievalLimits;
+    /** Refresh limits (delete-ratio valve, walk caps) and `transientRetries` (default 3, EMFILE/EBUSY/EIO/ETIMEDOUT per file). */
+    refresh?: AutoRAGRefreshLimits;
     /** Datasource skill configuration (skill name → config). */
     datasources?: DatasourcesConfig;
     /** P2P sharing configuration. Disabled by default. */
@@ -235,6 +239,8 @@ export declare function normalizeEmbedder(raw: unknown, path: string): MinSyncEm
 export declare function normalizeIndexingConfig(raw: RawIndexingMethods): NormalizedIndexingConfig;
 /** Validate the `limits` section and map it onto the agent option. */
 export declare function normalizeLimitsConfig(raw: unknown): AutoRAGRetrievalLimits;
+/** Validate the `refresh` section and map it onto the agent option. */
+export declare function normalizeRefreshConfig(raw: unknown): AutoRAGRefreshLimits;
 export declare function resolveConfig(input: ResolveConfigInput): CliConfig;
 /**
  * Resolve config without writing, migrating, or locking. Health and other
@@ -244,20 +250,30 @@ export declare function resolveConfig(input: ResolveConfigInput): CliConfig;
 export declare function resolveConfigReadOnly(input: ResolveConfigInput): CliConfig;
 /** Validate and normalize the `jev` config section. */
 export declare function normalizeJevConfig(raw: unknown): JevCliConfig;
-/** Jev backend used when the config names none (absent section or `{}`). */
-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 the previous default (a 2025 Gemini flash-lite) at equal quality.
+ * Jev backend used when the config names none (absent section or `{}`): the
+ * hosted Dazzi Models plan when the user is signed in, else OpenRouter.
  */
-export declare const DEFAULT_QUERY_DECOMPOSITION_MODEL: AgentModelConfig;
+export declare function defaultJevBackend(agentDir?: string): JevBackendName;
+/** The OpenRouter fallback decomposition model, used when not signed in to Dazzi Models. */
+export declare const OPENROUTER_QUERY_DECOMPOSITION_MODEL: AgentModelConfig;
+/**
+ * Question-decomposition model used when the config names none: the hosted
+ * Dazzi Models plan when signed in, else OpenRouter. The OpenRouter pick came
+ * from a live bench (6 questions incl. Korean, 2 runs each): 12/12 valid,
+ * covering, language-preserving decompositions at ~0.9s p50.
+ */
+export declare function defaultQueryDecompositionModel(agentDir?: string): AgentModelConfig;
 /** Validate the `queryDecomposition` config section (`false` = decompose with the session model). */
 export declare function normalizeQueryDecompositionConfig(raw: unknown): QueryDecompositionConfig | false;
 /** Normalize and validate the `rerank` config section, filling in defaults. */
 export declare function normalizeRerankConfig(raw: unknown, path: string): RerankConfig | false;
-export declare function buildAgentOptions(config: CliConfig): Omit<AutoRAGAgentOptions, "model">;
+/**
+ * Rerank block `autorag init` writes when none is given: the hosted Dazzi
+ * Models reranker when signed in, else OpenRouter's.
+ */
+export declare function defaultRerankConfig(agentDir?: string): RerankConfig;
+export declare function buildAgentOptions(config: CliConfig, agentDir?: string): Omit<AutoRAGAgentOptions, "model">;
 /**
  * Extra resolution inputs beyond the local codex-runtime options. `agentDir`
  * points at the pi agent home (`~/.pi/agent` by default) that owns
@@ -314,7 +330,7 @@ export declare function validateAgentConfigFile(configPath: string, options?: Re
 /**
  * Resolve the question-decomposition model and its credential through the same
  * chain as the agent model. An absent section or `{}` uses
- * {@link DEFAULT_QUERY_DECOMPOSITION_MODEL}; `queryDecomposition: false`
+ * {@link defaultQueryDecompositionModel}; `queryDecomposition: false`
  * returns undefined so the agent's own model decomposes.
  */
 export declare function resolveQueryDecompositionModel(config: CliConfig, options?: ResolveAgentModelOptions): Promise<DecompositionModel | undefined>;