@autorag/librarian 2.12.0 → 2.13.1

package/dist/agent/results.d.ts

@@ -16,6 +16,8 @@ export declare const reportSchema: Type.TObject<{
         evidence: Type.TArray<Type.TObject<{
             excerpt: Type.TString;
             lineNumber: Type.TOptional<Type.TInteger>;
+            lineEnd: Type.TOptional<Type.TInteger>;
+            section: Type.TOptional<Type.TString>;
         }>>;
         confidence: Type.TNumber;
     }>>;
@@ -38,7 +40,8 @@ export declare const reportSchema: Type.TObject<{
             documentType: Type.TOptional<Type.TString>;
             documentArea: Type.TOptional<Type.TString>;
             evidenceType: Type.TOptional<Type.TString>;
-            evidenceLocation: Type.TOptional<Type.TString>;
+            lineEnd: Type.TOptional<Type.TInteger>;
+            section: Type.TOptional<Type.TString>;
             confidence: Type.TOptional<Type.TNumber>;
         }>>>;
     }>>;
@@ -47,6 +50,10 @@ export declare const reportSchema: Type.TObject<{
 export interface AutoRAGEmittedEvidence {
     readonly excerpt: string;
     readonly lineNumber?: number;
+    /** Last line of the chunk; with {@link lineNumber} the exact range in the parsed document. */
+    readonly lineEnd?: number;
+    /** Article or heading the chunk sits in. */
+    readonly section?: string;
 }
 export interface AutoRAGEmittedResult {
     readonly number: number;
@@ -64,13 +71,14 @@ export interface AutoRAGEvidenceRef {
     readonly retrievalResultId?: string;
     readonly chunkIndex?: number;
     readonly lineNumber?: number;
+    readonly lineEnd?: number;
+    readonly section?: string;
     readonly stableEvidenceId?: string;
     readonly retrieverMix?: readonly string[];
     readonly parserType?: string;
     readonly documentType?: string;
     readonly documentArea?: string;
     readonly evidenceType?: string;
-    readonly evidenceLocation?: string;
     readonly confidence?: number;
 }
 export interface AutoRAGMappingEntry {

package/dist/agent/search-documents.d.ts

@@ -9,7 +9,7 @@ export type SearchDocumentDiagnosticSeverity = "info" | "warning" | "error";
  * (#21/#22) does not require another source-breaking type change; codes not yet
  * emitted are still valid members.
  */
-export type SearchDocumentDiagnosticCode = "empty-query" | "no-verified-results" | "unknown-warning" | "caller-tool-dropped" | "minsync-staging-excluded" | "minsync-file-skipped" | "minsync-sync-failed" | "minsync-lock-held" | "embedder-unavailable" | "embedding-identity-mismatch" | "lexical-tokenizer-unavailable" | "parser-skipped" | "parser-failed" | "parser-crashed" | "source-vanished" | "source-unreadable" | "source-read-failed" | "mirror-write-failed" | "parser-warning" | "duplicate-excluded" | "unsupported-file" | "stale-index" | "deleted-mirror" | "search-root-unavailable" | "mass-delete-suppressed" | "walk-truncated" | "directory-unreadable" | "pdf-extract-thin" | "retrieval-method-failed" | "rerank-failed" | "jikji-unavailable" | "jikji-prepare-failed" | "jikji-find-failed" | "everything-index-failed" | "fsearch-index-failed" | "fsearch-binary-missing" | "refresh-failed" | "refresh-interrupted" | "watch-failed" | "watch-limited" | "unknown-datasource-skill" | "no-final-answer" | "model-request-failed" | "tool-call-burst" | "query-routed" | "query-route-fallback" | "query-decomposition-failed" | "follow-up-skipped" | "follow-up-check-fallback" | "datasources-selected" | "datasource-selection-fallback" | "citation-without-result" | "citation-irrelevant" | "citation-relevance-fallback" | "evidence-judged" | "evidence-judgment-fallback" | "memory-search-fallback" | "self-config-unavailable" | "self-config-rolled-back" | "embedding-unavailable";
+export type SearchDocumentDiagnosticCode = "empty-query" | "no-verified-results" | "unknown-warning" | "caller-tool-dropped" | "minsync-staging-excluded" | "minsync-file-skipped" | "minsync-sync-failed" | "minsync-lock-held" | "embedder-unavailable" | "embedding-identity-mismatch" | "lexical-tokenizer-unavailable" | "parser-skipped" | "parser-failed" | "parser-crashed" | "source-vanished" | "source-unreadable" | "source-read-failed" | "mirror-write-failed" | "parser-warning" | "duplicate-excluded" | "unsupported-file" | "stale-index" | "deleted-mirror" | "search-root-unavailable" | "mass-delete-suppressed" | "walk-truncated" | "directory-unreadable" | "pdf-extract-thin" | "retrieval-method-failed" | "rerank-failed" | "jikji-unavailable" | "jikji-prepare-failed" | "jikji-find-failed" | "everything-index-failed" | "fsearch-index-failed" | "fsearch-binary-missing" | "refresh-failed" | "refresh-interrupted" | "watch-failed" | "watch-limited" | "unknown-datasource-skill" | "no-final-answer" | "model-request-failed" | "tool-call-burst" | "query-routed" | "query-route-fallback" | "query-decomposition-failed" | "follow-up-skipped" | "follow-up-check-fallback" | "datasources-selected" | "datasource-selection-fallback" | "web-datasource-id-taken" | "web-search-failed" | "citation-without-result" | "line-reference-unverified" | "citation-irrelevant" | "citation-relevance-fallback" | "evidence-judged" | "evidence-judgment-fallback" | "memory-search-fallback" | "self-config-unavailable" | "self-config-rolled-back" | "organize-skill-unavailable" | "embedding-unavailable";
 export interface SearchDocumentDiagnostic {
     readonly code: SearchDocumentDiagnosticCode;
     readonly severity: SearchDocumentDiagnosticSeverity;
@@ -19,7 +19,12 @@ export interface SearchDocumentDiagnostic {
 }
 export interface SearchDocumentEvidence {
     readonly excerpt: string;
+    /** First line of the chunk in its parsed document, measured by the harness. */
     readonly lineNumber?: number;
+    /** Last line of the chunk in its parsed document. */
+    readonly lineEnd?: number;
+    /** Article or heading the chunk sits in. */
+    readonly section?: string;
 }
 export interface SearchDocumentResult {
     readonly number: number;

package/dist/agent/self-config.d.ts

@@ -1,3 +1,4 @@
+import type { PackagedAgentSkill } from "./packaged-skill.js";
 /**
  * Host opt-in for agent self-configuration: the Jev `config` branch, where the
  * agent edits its own settings with the full `autorag-setup` skill in hand.
@@ -5,7 +6,7 @@
 export interface SelfConfigOptions {
     /** The active AutoRAG config file the agent may read and edit. */
     readonly configPath: string;
-    /** Override for the `autorag-setup` SKILL.md; defaults to the packaged skill. */
+    /** Override for the packaged `autorag-setup` skill file; defaults to the packaged skill. */
     readonly skillPath?: string;
     /**
      * Check the config file after a config turn changed it. Resolves to a
@@ -14,13 +15,12 @@ export interface SelfConfigOptions {
      */
     readonly validate?: (configPath: string) => Promise<string | undefined>;
 }
-/** Full text of the `autorag-setup` skill with its YAML front matter removed. */
-export declare function loadSetupSkill(skillPath?: string): string;
 export interface SelfConfigPromptInput {
     readonly query: string;
     readonly configPath: string;
     readonly agentDir: string;
-    readonly skill: string;
+    /** The loaded `autorag-setup` skill, embedded as a `<skill …>` invocation. */
+    readonly skill: PackagedAgentSkill;
     /** True when `manage_automations` is available: file-triggered automations are then in scope. */
     readonly automations?: boolean;
 }

package/dist/agent/skill-invocation.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The `<skill name="…" location="…">…</skill>` invocation block AutoRAG embeds
+ * in a turn prompt: the shape pi uses for its file-backed skills, with a
+ * path-opaque `location`. AutoRAG loads skills that have no path the model
+ * should resolve against (datasource skills and its own packaged skills), so
+ * the location names the skill without exposing a real filesystem path.
+ */
+export interface SkillInvocation {
+    /** Skill name, as listed in the prompt's skill listing. */
+    readonly name: string;
+    /** Opaque, path-free location: `datasource://<name>` or `autorag-skill://<name>`. */
+    readonly location: string;
+    /** Full skill instructions. */
+    readonly content: string;
+}
+/** Render one skill's full instructions in the shared invocation shape. */
+export declare function formatSkillInvocation(skill: SkillInvocation): string;

package/dist/agent/user-requests.d.ts

@@ -13,8 +13,8 @@ export interface UserRequest {
 type SaveEntry = (request: UserRequest) => void;
 /**
  * What the user has said in this conversation, in order, exactly as typed: the first question, every
- * follow-up, every steer. AutoRAG's own phase prompts (fast answer, verification, direct answer, steer
- * continuation) never enter it, because it is fed where the user's words arrive, not from the transcript.
+ * follow-up, every steer. AutoRAG's own phase prompts (fast answer, verification, the extra/organize/config
+ * turn, steer continuation) never enter it, because it is fed where the user's words arrive, not from the transcript.
  *
  * It is not truncated here. Whoever consumes it fits it to its own limit.
  */

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

@@ -0,0 +1,13 @@
+import { type DiscordAttachmentConnection } from "../../datasource/skills/factory.js";
+import { type CliConfig } from "../config.js";
+import type { CommandContext } from "./types.js";
+/**
+ * `autorag attachments [status|download]` — show or fill each Discord connection's attachments folder.
+ *
+ * `status` re-checks every saved file (a deleted, renamed, or edited file is no longer counted as downloaded)
+ * and rewrites `download-status.json`. `download` additionally saves every attachment whose signed link still
+ * works, even when `connector.downloadAttachments` is `false`.
+ *
+ * Exit codes: 0 on success, 2 on config/usage error, 1 when a connection could not be checked.
+ */
+export declare function runAttachments(ctx: CommandContext, connections?: (config: CliConfig) => readonly DiscordAttachmentConnection[]): Promise<number>;

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

@@ -9,6 +9,8 @@ interface EvidenceView {
     readonly retrievalResultId?: string;
     readonly chunkIndex?: number;
     readonly lineNumber?: number;
+    readonly lineEnd?: number;
+    readonly section?: string;
     readonly metadata?: Record<string, unknown>;
 }
 export declare function evidenceFor(schema: MemorySchema, sessionId: string, resultNumber?: number): {

package/dist/cli/index.d.ts

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-declare const COMMANDS: readonly ["init", "setup", "refresh", "status", "search", "evidence", "memory", "index", "watch", "health", "duplicates", "tui", "lite", "models", "update-check", "automate"];
+declare const COMMANDS: readonly ["init", "setup", "refresh", "status", "search", "evidence", "memory", "index", "watch", "health", "duplicates", "tui", "lite", "models", "update-check", "automate", "attachments"];
 type CommandName = (typeof COMMANDS)[number];
 export type { CommandName };
 interface ParsedArgs {