@autorag/librarian 2.4.1 → 2.5.0

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

@@ -8,5 +8,6 @@ export interface SystemPromptConfig {
     manifests: StoreManifest[];
     jikjiIndexingEnabled?: boolean;
     datasourceSkills?: readonly Skill[];
+    retrievedContentGuard?: boolean;
 }
 export declare function buildSystemPrompt(config: SystemPromptConfig): string;

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

@@ -1,4 +1,10 @@
 import type { DupeyScanResult } from "../../dupey/index.js";
 import type { CommandContext } from "./types.js";
 export type DuplicateScanner = (path: string) => Promise<DupeyScanResult>;
+/**
+ * `autorag duplicates` — scan configured roots for exact and near duplicate
+ * document families. Never deletes or moves source files.
+ *
+ * Exit codes: 0 on success, 2 on config error, 1 on runtime error.
+ */
 export declare function runDuplicates(ctx: CommandContext, scanner?: DuplicateScanner): Promise<number>;

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

@@ -0,0 +1,7 @@
+import { type RuntimeStatus } from "../../embedding-runtime/index.js";
+import type { CommandContext } from "./types.js";
+export interface GatewayCommandDeps {
+    runtimeStatus?: () => Promise<RuntimeStatus>;
+    stopRuntime?: () => Promise<void>;
+}
+export declare function runGateway(ctx: CommandContext, deps?: GatewayCommandDeps): Promise<number>;

package/dist/cli/commands/lite-refresh.d.ts

@@ -0,0 +1,10 @@
+import type { CommandContext } from "./types.js";
+/**
+ * `autorag lite refresh` — model-free index refresh using AutoRAGLite.
+ *
+ * Delegates to the agent's refresh pipeline (parsed mirrors, MinSync,
+ * datasources, Jikji) without requiring any model configuration.
+ *
+ * Exit codes: 0 on success, 2 on config error, 1 on runtime error.
+ */
+export declare function runLiteRefresh(ctx: CommandContext): Promise<number>;

package/dist/cli/commands/lite-retrieve.d.ts

@@ -0,0 +1,33 @@
+import type { CommandContext } from "./types.js";
+export interface LiteRetrieveEnvelope {
+    readonly ok: true;
+    readonly query: string;
+    readonly results: readonly LiteRetrieveResultItem[];
+    readonly diagnostics: readonly LiteRetrieveDiagnostic[];
+}
+export interface LiteRetrieveResultItem {
+    readonly number: number;
+    readonly source: string;
+    readonly method: string;
+    readonly score: number;
+    readonly metadata: Record<string, unknown>;
+    readonly content: string;
+}
+export interface LiteRetrieveDiagnostic {
+    readonly code: string;
+    readonly severity: string;
+    readonly message: string;
+    readonly source?: string;
+}
+/**
+ * Run the `autorag lite retrieve` command.
+ *
+ * Returns exit code 2 for:
+ *  - Empty query
+ *  - Config resolution failure
+ *  - Index not ready (never refreshed)
+ *
+ * Returns exit code 0 on successful retrieval (results may be empty).
+ * Returns exit code 1 for runtime errors.
+ */
+export declare function runLiteRetrieve(ctx: CommandContext): Promise<number>;

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

@@ -0,0 +1,3 @@
+import type { CommandContext } from "./types.js";
+export declare function liteUsage(): string;
+export declare function runLite(ctx: CommandContext): Promise<number>;

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

@@ -0,0 +1,18 @@
+import type { ProfileId } from "../../embedding-runtime/types.js";
+import type { CommandContext } from "./types.js";
+export interface ModelsCommandDeps {
+    prefetchModel?: (profileId?: ProfileId) => Promise<{
+        profileId: ProfileId;
+        path: string;
+    }>;
+    importModel?: (profileId: ProfileId | undefined, sourcePath: string) => Promise<{
+        profileId: ProfileId;
+        path: string;
+    }>;
+    verifyModel?: (profileId?: ProfileId) => Promise<{
+        profileId: ProfileId;
+        path: string;
+        hash: string;
+    }>;
+}
+export declare function runModels(ctx: CommandContext, deps?: ModelsCommandDeps): Promise<number>;

package/dist/cli/commands/p2p-policy.d.ts

@@ -0,0 +1,2 @@
+import type { CommandContext } from "./types.js";
+export declare function runP2pPolicy(ctx: CommandContext): number;

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

@@ -0,0 +1,7 @@
+import type { CommandContext } from "./types.js";
+/** Resolve the workspace used for P2P identity/policy, matching `autorag serve`. */
+export declare function resolveP2pWorkspace(ctx: CommandContext): string;
+/**
+ * `autorag p2p` — SimpleX peer trust management.
+ */
+export declare function runP2p(ctx: CommandContext): Promise<number>;

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

@@ -0,0 +1,3 @@
+import type { CommandContext } from "./types.js";
+/** Persist a structured report submitted by an external curator. */
+export declare function runReport(ctx: CommandContext): Promise<number>;

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

@@ -0,0 +1,18 @@
+import type { InjectionClassifierModel } from "../../p2p/injection-classifier.js";
+import { type SimplexPeerServer, startSimplexPeerServer } from "../../p2p/simplex-server.js";
+import { type SimplexTransport, type StartSimplexOptions } from "../../p2p/simplex-transport.js";
+import { type ResolvedAgentModel, resolveAgentModel } from "../config.js";
+import type { CommandContext } from "./types.js";
+export interface ServeCommandDeps {
+    readonly startSimplexPeerServer?: typeof startSimplexPeerServer;
+    readonly startSimplexChat?: (options: StartSimplexOptions) => Promise<SimplexTransport>;
+    readonly waitUntilStopped?: (server: SimplexPeerServer) => Promise<void>;
+    readonly modelResolver?: typeof resolveAgentModel;
+}
+export declare function createInjectionClassifierModel(resolved: ResolvedAgentModel): InjectionClassifierModel;
+/**
+ * `autorag serve` — start the P2P peer query server over SimpleX Chat.
+ * Peers reach this installation through SimpleX; all security gates run
+ * unchanged.
+ */
+export declare function runServe(ctx: CommandContext, deps?: ServeCommandDeps): Promise<number>;

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

@@ -0,0 +1,2 @@
+import type { CommandContext } from "./types.js";
+export declare function runSetupCommand(ctx: CommandContext): Promise<number>;

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

@@ -3,5 +3,7 @@ import type { CommandContext } from "./types.js";
  * `autorag status` — path-opaque snapshot of corpus freshness and index health.
  * Runs a cheap parse-free staleness scan plus the cached last-refresh outcome.
  * Model-free. Never emits filesystem paths; only the renderered status text.
+ *
+ * Exit codes: 0 on success, 2 on config error, 1 on runtime error.
  */
 export declare function runStatus(ctx: CommandContext): Promise<number>;

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

@@ -26,7 +26,7 @@ export interface TuiPresenter {
 }
 type TuiAgent = Pick<AutoRAGAgent, "searchDocumentsStream"> & Partial<Pick<AutoRAGAgent, "subscribe" | "abort">>;
 export interface TuiDeps {
-    agentFactory?: (opts?: AutoRAGAgentOptions) => TuiAgent;
+    agentFactory?: (opts?: Partial<AutoRAGAgentOptions>) => TuiAgent;
     modelResolver?: (config: CliConfig) => ResolvedAgentModel;
     tuiFactory?: (ctx: CommandContext) => TuiDriver;
     sessionStore?: TuiSessionStore;

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

@@ -4,5 +4,7 @@ import type { CommandContext } from "./types.js";
  *
  * - default: long-running recursive fs watch with debounced refresh
  * - `--once`: single refresh tick (for cron / launchd / Task Scheduler)
+ *
+ * Exit codes: 0 on success, 2 on config error, 1 on runtime error.
  */
 export declare function runWatch(ctx: CommandContext): Promise<number>;

package/dist/cli/config.d.ts

@@ -31,6 +31,24 @@ export interface RawIndexingMethods {
 export interface NormalizedIndexingConfig {
     minSync: MinSyncMethodConfig;
 }
+export interface P2pConfig {
+    enabled?: boolean;
+    port?: number;
+    host?: string;
+    /** SimpleX CLI database prefix (defaults to <workspace>/.autorag/p2p/simplex). */
+    simplexDbPrefix?: string;
+    maxBodyBytes?: number;
+    maxFileBytes?: number;
+    policy?: Record<string, unknown>;
+    quotas?: {
+        queriesPerHour?: number;
+        burst?: number;
+    };
+    injectionClassifier?: boolean;
+    piiNer?: boolean;
+    searchTimeoutMs?: number;
+    newFilesPublic?: boolean;
+}
 export interface UiConfig {
     host?: string;
     port?: number;
@@ -86,6 +104,8 @@ export interface CliConfig {
     datasourceAccess?: DatasourceAccessContextOptions;
     /** Optional local/deployment settings for the datasource UI. */
     ui?: UiConfig;
+    /** P2P sharing configuration. Disabled by default. */
+    p2p?: P2pConfig;
 }
 export interface ResolveConfigInput {
     flags: Record<string, string | boolean | undefined>;