@autorag/librarian 2.5.1 → 2.5.2

package/dist/datasource/connector-skill.d.ts

@@ -42,6 +42,12 @@ export interface ConnectorSkillDefinition {
     readonly manifestDescription: string;
     /** Extra path-opaque manifest body lines (after the standard sections). */
     readonly manifestNotes?: readonly string[];
+    /**
+     * Native CLI note for the manifest, e.g. how to inspect the underlying
+     * tool directly. Omit when the connector has no external CLI; the manifest
+     * then states that the dedicated search tool is the only search path.
+     */
+    readonly nativeCliNote?: string;
 }
 export interface ConnectorSkillOptions {
     readonly connector: DatasourceConnector;

package/dist/datasource/crawler-skill.d.ts

@@ -13,6 +13,8 @@ export interface CrawlerDatasourceDefinition {
     readonly contentType: string;
     readonly manifestDescription: string;
     readonly backendName: string;
+    /** One copy-pastable native CLI search example shown in the skill manifest. */
+    readonly nativeCliSearchExample: string;
 }
 export interface CrawlerDatasourceSkillOptions {
     readonly client: CrawlerSkillClient;

package/dist/datasource/errors.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Datasource retrieval errors.
+ *
+ * A CLI-backed datasource that cannot answer must say why. Its retrieval method
+ * throws this error instead of returning an empty result set, so the retrieval
+ * pipeline reports the surface as unsearched and hands the operator the CLI's
+ * own words: failure kind, exit status, and stderr verbatim.
+ */
+/** The failure payload every datasource CLI client returns (katok, discrawl, qmd, …). */
+export interface DatasourceCliFailure {
+    readonly reason: string;
+    readonly stderr?: string;
+    readonly stdout?: string;
+    readonly code?: number | null;
+}
+/** Error thrown by a datasource retrieval method when its CLI failed. */
+export declare class DatasourceCliError extends Error {
+    readonly datasourceId: string;
+    readonly command: string;
+    readonly reason: string;
+    readonly stderr: string;
+    readonly code: number | null;
+    constructor(datasourceId: string, command: string, failure: DatasourceCliFailure);
+}
+/** Build the error a datasource retrieval method throws for a failed CLI call. */
+export declare function datasourceCliError(datasourceId: string, command: string, failure: DatasourceCliFailure): DatasourceCliError;

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

@@ -2,6 +2,14 @@ import { CrawlerCliClient } from "../../crawler-client.js";
 import { CrawlerDatasourceSkill, type CrawlerDatasourceSkillOptions, type CrawlerSkillClient } from "../../crawler-skill.js";
 import type { CrawlerCliOptions } from "../../crawler-types.js";
 export interface SlacrawlOptions extends CrawlerCliOptions {
+    /**
+     * Slack workspace (team) id to scope reads to, e.g. `T0435JHH63Z`.
+     *
+     * slacrawl's `search`/`messages` read paths return nothing unless a workspace
+     * is named explicitly, even when the archive and its FTS index hold matching
+     * rows, so an unscoped search silently looks like an empty archive.
+     */
+    readonly workspace?: string;
 }
 export declare class SlacrawlClient extends CrawlerCliClient {
     constructor(options?: SlacrawlOptions);

package/dist/datasource/tool-naming.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Canonical model-visible search tool name for one datasource connection.
+ *
+ * The agent generates one `search_datasource_<id>` tool per authorized
+ * connection (see `src/agent/search-single-datasource-tool.ts`), and skill
+ * manifests must be able to name that tool without importing the agent layer
+ * (the import direction is agent → datasource, never the reverse). The alias
+ * rewrite in `aliased-skill.ts` relies on this exact transformation, so keep
+ * it stable: lowercase, non-alphanumerics collapse to `_`, edges trimmed.
+ */
+export declare function datasourceSearchToolName(datasourceId: string): string;