@autorag/librarian 2.6.0 → 2.6.2

package/dist/mirror/index-store.d.ts

@@ -8,7 +8,7 @@ export interface ParsedMirrorEntry {
     readonly updatedAt: string;
 }
 /** Why refresh deliberately left a source out of the parsed mirror. */
-export type ParsedMirrorSkipReason = "duplicate-excluded" | "parser-skipped" | "parser-failed";
+export type ParsedMirrorSkipReason = "duplicate-excluded" | "user-excluded" | "parser-skipped" | "parser-failed";
 /**
  * A source the last refresh decided not to mirror, pinned to the exact version it
  * decided on. Staleness checks compare against this record instead of re-deriving

package/dist/mirror/index.d.ts

@@ -2,4 +2,4 @@ export type { ParsedMirrorEntry, ParsedMirrorIndex } from "./index-store.js";
 export { emptyMirrorIndex, loadMirrorIndex, saveMirrorIndex } from "./index-store.js";
 export { parsedMirrorIndexPath, parsedMirrorRoot, parsedOutputPath, refreshReadinessPath } from "./paths.js";
 export type { ParsedMirrorDiagnostic, ParsedMirrorDiagnosticCode, ParsedMirrorSyncOptions, ParsedMirrorSyncResult, } from "./sync.js";
-export { DEFAULT_MAX_SOURCE_BYTES, detectMirrorStaleness, syncParsedMirrors } from "./sync.js";
+export { DEFAULT_MAX_SOURCE_BYTES, detectMirrorStaleness, isPathExcluded, syncParsedMirrors } from "./sync.js";

package/dist/mirror/sync.d.ts

@@ -12,6 +12,8 @@ export interface ParsedMirrorSyncOptions {
     readonly maxSourceBytes?: number;
     /** Absolute source paths omitted from parsed mirrors (for example exact duplicate copies). */
     readonly excludeSourcePaths?: ReadonlySet<string>;
+    /** Absolute source paths or directories omitted by the user. */
+    readonly userExcludedSourcePaths?: ReadonlySet<string>;
 }
 export type ParsedMirrorDiagnosticCode = "unsupported-file" | "parser-skipped" | "parser-failed" | "duplicate-excluded" | "deleted-mirror" | "stale-index" | "pdf-extract-thin" | "parser-warning";
 /** Path-opaque refresh diagnostic. `source` is an opaque virtual path, never a real fs path. */
@@ -42,3 +44,4 @@ export declare function syncParsedMirrors(options: ParsedMirrorSyncOptions): Pro
  * getRefreshStatus).
  */
 export declare function detectMirrorStaleness(options: ParsedMirrorSyncOptions): Promise<ParsedMirrorDiagnostic[]>;
+export declare function isPathExcluded(sourcePath: string, excluded: ReadonlySet<string> | undefined): boolean;

package/dist/p2p/approval-store.d.ts

@@ -19,6 +19,7 @@ export declare class ApprovalTimeoutError extends Error {
 export declare class ApprovalAbortedError extends Error {
     constructor(id: string);
 }
+export declare const PEER_REQUEST_TTL_MS: number;
 export declare function savePendingPeerRequest(workspacePath: string, request: PendingPeerRequest): void;
 export declare function loadPendingPeerRequest(workspacePath: string, id: string): PendingPeerRequest | undefined;
 export declare function listPendingPeerRequests(workspacePath: string): PendingPeerRequest[];

package/dist/p2p/simplex-query-store.d.ts

@@ -0,0 +1,44 @@
+import type { SimplexTransport } from "./simplex-transport.js";
+import { type PeerQueryRequest, type PeerQueryResponse } from "./wire.js";
+export declare const DEFAULT_SIMPLEX_QUERY_FAST_TIMEOUT_MS = 60000;
+export declare const SIMPLEX_QUERY_TTL_MS: number;
+export type SimplexQueryStateStatus = "pending" | "completed" | "expired";
+export interface SimplexQueryState {
+    readonly id: string;
+    readonly contactId: number;
+    readonly request: PeerQueryRequest;
+    readonly sessionId?: string;
+    readonly createdAt: string;
+    readonly expiresAt: string;
+    readonly status: SimplexQueryStateStatus;
+    readonly response?: PeerQueryResponse;
+    readonly completedAt?: string;
+    readonly expiredAt?: string;
+    readonly diagnostic?: string;
+}
+export declare function saveSimplexQueryState(workspacePath: string, state: SimplexQueryState): void;
+export declare function loadSimplexQueryState(workspacePath: string, id: string): SimplexQueryState | undefined;
+export declare function listPendingSimplexQueryStates(workspacePath: string): readonly SimplexQueryState[];
+export declare function completeSimplexQueryState(workspacePath: string, id: string, response: PeerQueryResponse, completedAt: string): SimplexQueryState | undefined;
+export declare function expireSimplexQueryState(workspacePath: string, id: string, expiredAt: string, diagnostic: string): SimplexQueryState | undefined;
+export declare function removeSimplexQueryState(workspacePath: string, id: string): void;
+export type SimplexQueryResult = {
+    readonly status: "completed";
+    readonly id: string;
+    readonly response: PeerQueryResponse;
+} | {
+    readonly status: "pending";
+    readonly id: string;
+    readonly expiresAt: string;
+};
+export interface SimplexQueryClientOptions {
+    readonly fastTimeoutMs?: number;
+    readonly now?: () => Date;
+    readonly onResponse?: (state: SimplexQueryState, response: PeerQueryResponse) => void;
+    readonly onExpired?: (state: SimplexQueryState) => void;
+}
+export interface SimplexQueryClient {
+    send(contactId: number, request: PeerQueryRequest, sessionId?: string): Promise<SimplexQueryResult>;
+    close(): void;
+}
+export declare function createSimplexQueryClient(transport: SimplexTransport, workspacePath: string, options?: SimplexQueryClientOptions): SimplexQueryClient;

package/dist/p2p/simplex-server.d.ts

@@ -4,6 +4,7 @@ import type { RetrievalOptions } from "../retrieval/types.js";
 import { type InjectionClassifierModel } from "./injection-classifier.js";
 import { type PolicyQuotas, type PolicyResolution } from "./policy.js";
 import type { PolicyResolver } from "./policy-filter.js";
+import { type SimplexQueryResult, type SimplexQueryState } from "./simplex-query-store.js";
 import { type SimplexContact, type SimplexPeerProfile, type SimplexTransport } from "./simplex-transport.js";
 import { type PeerQueryRequest, type PeerQueryResponse } from "./wire.js";
 /**
@@ -102,10 +103,14 @@ export declare class QueueFullError extends Error {
 }
 export declare function startSimplexPeerServer(options: StartSimplexPeerServerOptions): Promise<SimplexPeerServer>;
 export interface QuerySimplexPeerOptions {
-    readonly timeoutMs?: number;
+    readonly workspacePath: string;
+    readonly fastTimeoutMs?: number;
+    readonly sessionId?: string;
+    readonly onResponse?: (state: SimplexQueryState, response: PeerQueryResponse) => void;
+    readonly onExpired?: (state: SimplexQueryState) => void;
 }
 /**
  * Client side of the SimpleX peer wire: send a PeerQueryRequest and await the
  * correlated PeerQueryResponse.
  */
-export declare function querySimplexPeer(transport: SimplexTransport, contactId: number, request: PeerQueryRequest, options?: QuerySimplexPeerOptions): Promise<PeerQueryResponse>;
+export declare function querySimplexPeer(transport: SimplexTransport, contactId: number, request: PeerQueryRequest, options: QuerySimplexPeerOptions): Promise<SimplexQueryResult>;

package/dist/p2p/simplex-transport.d.ts

@@ -53,3 +53,10 @@ export declare function parseSimplexProfile(value: unknown): SimplexPeerProfile
  * bot API. Creates the local user profile if it does not exist yet.
  */
 export declare function startSimplexChat(options: StartSimplexOptions): Promise<SimplexTransport>;
+export interface OpenPeerQueryTransportOptions extends StartSimplexOptions {
+    readonly portOpen?: (port: number) => Promise<boolean>;
+    readonly start?: (options: StartSimplexOptions) => Promise<SimplexTransport>;
+    readonly attach?: (options: StartSimplexOptions) => Promise<SimplexTransport>;
+}
+export declare function attachSimplexChat(options: StartSimplexOptions): Promise<SimplexTransport>;
+export declare function openPeerQueryTransport(options: OpenPeerQueryTransportOptions): Promise<SimplexTransport>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autorag/librarian",
-  "version": "2.6.0",
+  "version": "2.6.2",
   "description": "Self-evolving librarian agent on Pi framework with pluggable retrieval methods",
   "license": "MIT",
   "repository": {

package/skills/autorag/SKILL.md

@@ -41,6 +41,14 @@ near/contains families require human review. Exact duplicate exclusion during
 refresh is enabled by default and can be disabled with
 `"excludeExactDuplicates": false` in `config.json`.
 
+### Excluding local files from the index
+
+`"excludePaths"` in `config.json` lists files or folders (absolute, or relative
+to `workspacePath`) that refresh keeps out of the parsed mirror and MinSync.
+A folder entry excludes everything under it. Removing an entry and running
+`autorag refresh --method minsync` indexes the file again. Excluded sources are
+recorded as `user-excluded` skips, so they are not reported as stale.
+
 `status` is model-free and path-opaque. `health` resolves the single model,
 checks credential presence, and normally probes one live completion. If the
 model, authentication, configuration, or indexes are unhealthy, use

package/skills/autorag-setup/SKILL.md

@@ -134,6 +134,13 @@ true). Set `"autoInstall": false` only when managing the binary yourself. Jikji
 auto-installs `jikji-cli` through cargo when enabled (`jikji.autoInstall`
 defaults to true; requires the Rust toolchain).
 
+Jikji stores its prepared corpus metadata in a hidden `.jikji` directory
+inside each indexed source root — that is Jikji's native index layout and
+intended behavior, not a misplaced artifact. Tell the user before the first
+`refresh` that `<root>/.jikji` will be created inside every approved document
+root (one per root, alongside the documents), and never delete or edit its
+contents; removing it only forces a full Jikji re-prepare on the next refresh.
+
 Exact duplicate exclusion is enabled by default. AutoRAG invokes the external
 `dupey` CLI before parsed-mirror indexing, keeps the newest filesystem copy for
 each exact canonical-text hash, and excludes older copies from the mirror.