@autorag/librarian 2.4.2 → 2.5.1

package/dist/cli/command-help.d.ts

@@ -0,0 +1 @@
+export declare function commandUsage(command: string | undefined): string | undefined;

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-retrieve.d.ts

@@ -2,6 +2,11 @@ import type { CommandContext } from "./types.js";
 export interface LiteRetrieveEnvelope {
     readonly ok: true;
     readonly query: string;
+    /**
+     * True when the last refresh does not cover the current sources. Retrieval still
+     * runs; the caller decides whether to trust the result or refresh first.
+     */
+    readonly stale: boolean;
     readonly results: readonly LiteRetrieveResultItem[];
     readonly diagnostics: readonly LiteRetrieveDiagnostic[];
 }
@@ -18,6 +23,10 @@ export interface LiteRetrieveDiagnostic {
     readonly severity: string;
     readonly message: string;
     readonly source?: string;
+    /** Why a source is considered stale, e.g. `mtime-and-size-changed`. */
+    readonly reason?: string;
+    /** Suggested recovery action, e.g. `refresh`. */
+    readonly action?: string;
 }
 /**
  * Run the `autorag lite retrieve` command.

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/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/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/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>;

package/dist/cli/index.d.ts

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+declare const COMMANDS: readonly ["init", "setup", "refresh", "status", "search", "feedback", "evidence", "memory", "index", "watch", "health", "duplicates", "tui", "ui", "serve", "p2p", "lite", "models", "gateway"];
+type CommandName = (typeof COMMANDS)[number];
+export type { CommandName };
 interface ParsedArgs {
     positionals: string[];
     flags: Record<string, string | boolean>;
@@ -7,4 +10,3 @@ export declare function parseArgs(argv: readonly string[]): ParsedArgs | {
     error: string;
 };
 export declare function main(argv: readonly string[]): Promise<number>;
-export {};