@autorag/librarian 2.5.0 → 2.5.1

package/dist/datasource/index.d.ts

@@ -9,7 +9,7 @@ export { DatasourceSkillRegistry, type RegisteredDatasourceSkill } from "./regis
 export { DatasourceResultFilter, type ResultsByMethod } from "./result-filter.js";
 export { buildDatasourceChunkSource, buildDatasourceInstanceSource, DATASOURCE_CHUNKS_SEGMENT, datasourceSourceHasFragment, datasourceSourcePath, isDatasourceSource, matchesDatasourceScope, matchesVirtualPathScope, normalizeVirtualPath, } from "./scope.js";
 export { CLOUD_DRIVE_SKILL_DEFINITION, CloudDriveSkill, type CloudDriveSkillOptions, RcloneConnector, type RcloneConnectorOptions, type RcloneRunner, type RcloneRunResult, } from "./skills/cloud-drive/index.js";
-export { DEFAULT_DISCRAWL_EMBEDDING_MODEL, DEFAULT_DISCRAWL_MODE, DEFAULT_DISCRAWL_SOURCE, DiscrawlClient, type DiscrawlFailureReason, DiscrawlFtsMethod, DiscrawlHybridMethod, type DiscrawlOptions, type DiscrawlSearchHit, type DiscrawlSearchMode, type DiscrawlSearchOptions, type DiscrawlSearchResult, DiscrawlSemanticMethod, DiscrawlSkill, type DiscrawlSkillClient, type DiscrawlSkillOptions, type DiscrawlSourceKind, ENGLISH_ONLY_EMBEDDING_MODELS, } from "./skills/discrawl/index.js";
+export { DEFAULT_DISCRAWL_EMBEDDING_MODEL, DEFAULT_DISCRAWL_MODE, DiscrawlClient, type DiscrawlFailureReason, DiscrawlFtsMethod, DiscrawlHybridMethod, type DiscrawlOptions, type DiscrawlSearchHit, type DiscrawlSearchMode, type DiscrawlSearchOptions, type DiscrawlSearchResult, DiscrawlSemanticMethod, DiscrawlSkill, type DiscrawlSkillClient, type DiscrawlSkillOptions, ENGLISH_ONLY_EMBEDDING_MODELS, } from "./skills/discrawl/index.js";
 export { BUILTIN_DATASOURCE_SKILL_NAMES, type BuildDatasourceSkillsResult, buildDatasourceSkills, type DatasourceSkillConfig, type DatasourcesConfig, } from "./skills/factory.js";
 export { GitHubConnector, type GitHubConnectorOptions, GitHubSkill, type GitHubSkillOptions, } from "./skills/github/index.js";
 export type { KatokFailureReason, KatokHit, KatokOptions, KatokSearchMode, KatokSearchOptions, KatokSearchResult, KatokSkillClient, KatokSkillOptions, } from "./skills/katok/index.js";

package/dist/datasource/skills/discrawl/client.d.ts

@@ -17,6 +17,12 @@ export declare class DiscrawlClient {
     metadata(signal?: AbortSignal): Promise<DiscrawlMetadataResult>;
     doctor(signal?: AbortSignal): Promise<DiscrawlDoctorResult>;
     status(signal?: AbortSignal): Promise<DiscrawlStatusResult>;
+    /**
+     * Imports new messages from the local Discord Desktop cache through
+     * `discrawl wiretap`. AutoRAG never drives discrawl's bot sync — that path
+     * belongs to the CLI, which owns its own credential — so no Discord token is
+     * involved in an AutoRAG refresh.
+     */
     sync(signal?: AbortSignal): Promise<DiscrawlSyncResult>;
     embed(limit?: number, rebuild?: boolean, signal?: AbortSignal): Promise<DiscrawlEmbedResult>;
     search(mode: DiscrawlSearchMode, query: string, options?: DiscrawlSearchOptions): Promise<DiscrawlSearchResult>;

package/dist/datasource/skills/discrawl/index.d.ts

@@ -2,4 +2,4 @@ export { DiscrawlClient, discrawlWorkspace } from "./client.js";
 export { DiscrawlFtsMethod, DiscrawlHybridMethod, type DiscrawlMethodOptions, type DiscrawlSearchClient, DiscrawlSemanticMethod, } from "./methods.js";
 export { DISCRAWL_SOURCE_KIND, discrawlConfigPath, discrawlDatabasePath, discrawlDatasourceRoot, discrawlSourcePath, parseDiscrawlSourcePath, } from "./paths.js";
 export { DiscrawlSkill, type DiscrawlSkillClient, type DiscrawlSkillOptions } from "./skill.js";
-export { DEFAULT_DISCRAWL_BINARY, DEFAULT_DISCRAWL_EMBEDDING_MODEL, DEFAULT_DISCRAWL_EMBEDDING_PROVIDER, DEFAULT_DISCRAWL_MAX_BUFFER_BYTES, DEFAULT_DISCRAWL_MODE, DEFAULT_DISCRAWL_SOURCE, DEFAULT_DISCRAWL_TIMEOUT_MS, type DiscrawlDoctorInfo, type DiscrawlDoctorResult, type DiscrawlEmbeddingConfigResult, type DiscrawlEmbeddingRuntime, type DiscrawlEmbedInfo, type DiscrawlEmbedResult, type DiscrawlFailure, type DiscrawlFailureReason, type DiscrawlMessage, type DiscrawlMetadataInfo, type DiscrawlMetadataResult, type DiscrawlOptions, type DiscrawlSearchHit, type DiscrawlSearchMode, type DiscrawlSearchOptions, type DiscrawlSearchResult, type DiscrawlSourceKind, type DiscrawlStatusInfo, type DiscrawlStatusResult, type DiscrawlSyncInfo, type DiscrawlSyncResult, ENGLISH_ONLY_EMBEDDING_MODELS, } from "./types.js";
+export { DEFAULT_DISCRAWL_BINARY, DEFAULT_DISCRAWL_EMBEDDING_MODEL, DEFAULT_DISCRAWL_EMBEDDING_PROVIDER, DEFAULT_DISCRAWL_MAX_BUFFER_BYTES, DEFAULT_DISCRAWL_MODE, DEFAULT_DISCRAWL_TIMEOUT_MS, type DiscrawlDoctorInfo, type DiscrawlDoctorResult, type DiscrawlEmbeddingConfigResult, type DiscrawlEmbeddingRuntime, type DiscrawlEmbedInfo, type DiscrawlEmbedResult, type DiscrawlFailure, type DiscrawlFailureReason, type DiscrawlMessage, type DiscrawlMetadataInfo, type DiscrawlMetadataResult, type DiscrawlOptions, type DiscrawlSearchHit, type DiscrawlSearchMode, type DiscrawlSearchOptions, type DiscrawlSearchResult, type DiscrawlStatusInfo, type DiscrawlStatusResult, type DiscrawlSyncInfo, type DiscrawlSyncResult, ENGLISH_ONLY_EMBEDDING_MODELS, } from "./types.js";

package/dist/datasource/skills/discrawl/types.d.ts

@@ -8,22 +8,6 @@ import type { RetrievalOptions } from "../../../retrieval/types.js";
  *                semantic is unavailable.
  */
 export type DiscrawlSearchMode = "fts" | "semantic" | "hybrid";
-/**
- * Where the `discrawl` CLI reads Discord data from.
- *
- * - `wiretap`  — the local Discord Desktop cache. Requires no token and issues
- *                no Discord API calls; it reads only files Discord already
- *                wrote to disk. Includes classifiable direct messages.
- * - `discord`  — the Discord bot API using a server-configured bot token. This
- *                is the ToS-sanctioned automation path (a bot token identifies
- *                an OAuth2 application, not a human user).
- * - `both`     — bot API plus desktop cache.
- *
- * AutoRAG never uses a Discord *user* token: automating a user account is
- * prohibited by Discord's Community Guidelines and can get the account
- * terminated.
- */
-export type DiscrawlSourceKind = "wiretap" | "discord" | "both";
 /**
  * Embedding models known to be English-only. Selecting one for a non-English
  * archive silently degrades semantic search to noise rather than failing, so
@@ -49,6 +33,11 @@ export declare const DEFAULT_DISCRAWL_EMBEDDING_PROVIDER = "ollama";
  * Configuration for the discrawl client. All fields optional; defaults mirror
  * the katok client. The client spawns the `discrawl` binary as a child process
  * — it never opens the Discord archive database directly.
+ *
+ * AutoRAG drives discrawl's local archive only: `wiretap` to import the
+ * Discord Desktop cache plus search/embed against that native store. The bot
+ * API path belongs to the CLI, which owns its own credential, so no Discord
+ * token is configured, required, or forwarded here.
  */
 export interface DiscrawlEmbeddingRuntime {
     readonly provider: string;
@@ -76,8 +65,6 @@ export interface DiscrawlOptions {
     readonly timeoutMs?: number;
     /** Max stdout/stderr bytes retained. Default 1_048_576 (1 MiB). */
     readonly maxBufferBytes?: number;
-    /** Archive source for the CLI. Default `wiretap` (no token required). */
-    readonly source?: DiscrawlSourceKind;
     /**
      * Explicit operator-owned discrawl config file passed as `--config`.
      * AutoRAG never rewrites an explicit config.
@@ -87,7 +74,7 @@ export interface DiscrawlOptions {
     readonly root?: string;
     /** Explicit workspace directory overriding the computed default. */
     readonly workspacePath?: string;
-    /** Restrict search and sync to one guild id. */
+    /** Restrict search to one guild id. */
     readonly guildId?: string;
     /** Embedding provider understood by the native discrawl configuration. */
     readonly embeddingProvider?: string;
@@ -112,7 +99,6 @@ export interface DiscrawlOptions {
 export declare const DEFAULT_DISCRAWL_BINARY = "discrawl";
 export declare const DEFAULT_DISCRAWL_TIMEOUT_MS = 30000;
 export declare const DEFAULT_DISCRAWL_MAX_BUFFER_BYTES = 1048576;
-export declare const DEFAULT_DISCRAWL_SOURCE: DiscrawlSourceKind;
 export declare const DEFAULT_DISCRAWL_MODE: DiscrawlSearchMode;
 /**
  * Reasons a discrawl CLI invocation can fail. The client never throws for
@@ -168,7 +154,7 @@ export interface DiscrawlDoctorInfo {
     readonly embeddingProvider?: string;
     readonly metadata?: Readonly<Record<string, unknown>>;
 }
-/** Result of `discrawl sync` / `discrawl wiretap`. */
+/** Result of `discrawl wiretap`. */
 export interface DiscrawlSyncInfo {
     readonly messages: number;
     readonly guilds?: number;

package/dist/filesystem/source-paths.d.ts

@@ -24,8 +24,12 @@ export declare function isFilesystemAbsolutePath(source: string): boolean;
 /**
  * Normalize an opaque virtual source id. Returns the normalized id, or
  * `undefined` when the input is syntactically invalid or unsafe (no leading
- * slash, URL scheme, fragment/query, traversal, NUL, backslash). Never throws
- * and never returns a real path — failures are signaled as `undefined`.
+ * slash, URL scheme, traversal, NUL, backslash). Never throws and never
+ * returns a real path — failures are signaled as `undefined`.
+ *
+ * `#` and `?` are NOT rejected: they are ordinary characters in a real file
+ * name, and ids are derived verbatim from real file names. URL-shaped input
+ * is already rejected by the scheme check above.
  */
 export declare function normalizeVirtualPath(virtual: string | undefined | null): string | undefined;
 /**