@autorag/librarian 2.1.0 → 2.3.0

package/dist/datasource/skills/discord/skill.d.ts

@@ -1,20 +0,0 @@
-/**
- * Discord guild datasource skill (issue #1305).
- *
- * Thin composition of DiscordConnector with the shared
- * {@link ConnectorDatasourceSkill} base: descriptor, polling metadata,
- * ok/fail indexing with path/PII-opaque diagnostics, lexical retrieval via
- * the shared pipeline, opaque `/discord/<instance>/…` sources, and a
- * progressive-disclosure agent-skill manifest.
- */
-import { ConnectorDatasourceSkill, type ConnectorSkillDefinition, type ConnectorSkillOptions } from "../../connector-skill.js";
-import { DiscordConnector, type DiscordConnectorOptions } from "./connector.js";
-export declare const DISCORD_SKILL_DEFINITION: ConnectorSkillDefinition;
-export interface DiscordSkillOptions extends Omit<ConnectorSkillOptions, "connector"> {
-    /** Trusted connector configuration; a pre-built connector wins. */
-    readonly connector?: DiscordConnector;
-    readonly connectorOptions?: DiscordConnectorOptions;
-}
-export declare class DiscordSkill extends ConnectorDatasourceSkill {
-    constructor(options?: DiscordSkillOptions);
-}

package/dist/datasource/skills/notion/connector.d.ts

@@ -1,26 +0,0 @@
-/**
- * Notion workspace connector (issue #1302).
- *
- * Enumerates pages/databases via the Notion search API using a trusted,
- * server-configured integration token, then pulls one page of block children
- * per page for text content. Per-page block failures degrade to warnings.
- * Never throws; messages stay path/PII-opaque.
- */
-import type { ConnectorFetchResult, DatasourceConnector } from "../../connector.js";
-export interface NotionConnectorOptions {
-    /** Notion REST base; override to point at a mock server in tests. */
-    readonly baseUrl?: string;
-    /** Integration token; explicit value wins over {@link tokenEnv}. */
-    readonly token?: string;
-    /** Env var name holding the integration token. Default `NOTION_TOKEN`. */
-    readonly tokenEnv?: string;
-    readonly timeoutMs?: number;
-    readonly fetchImpl?: typeof fetch;
-    readonly maxPages?: number;
-    readonly maxDocuments?: number;
-}
-export declare class NotionConnector implements DatasourceConnector {
-    private readonly options;
-    constructor(options?: NotionConnectorOptions);
-    fetch(signal?: AbortSignal): Promise<ConnectorFetchResult>;
-}

package/dist/datasource/skills/notion/skill.d.ts

@@ -1,20 +0,0 @@
-/**
- * Notion workspace datasource skill (issue #1302).
- *
- * Thin composition of NotionConnector with the shared
- * {@link ConnectorDatasourceSkill} base: descriptor, polling metadata,
- * ok/fail indexing with path/PII-opaque diagnostics, lexical retrieval via
- * the shared pipeline, opaque `/notion/<instance>/…` sources, and a
- * progressive-disclosure agent-skill manifest.
- */
-import { ConnectorDatasourceSkill, type ConnectorSkillDefinition, type ConnectorSkillOptions } from "../../connector-skill.js";
-import { NotionConnector, type NotionConnectorOptions } from "./connector.js";
-export declare const NOTION_SKILL_DEFINITION: ConnectorSkillDefinition;
-export interface NotionSkillOptions extends Omit<ConnectorSkillOptions, "connector"> {
-    /** Trusted connector configuration; a pre-built connector wins. */
-    readonly connector?: NotionConnector;
-    readonly connectorOptions?: NotionConnectorOptions;
-}
-export declare class NotionSkill extends ConnectorDatasourceSkill {
-    constructor(options?: NotionSkillOptions);
-}

package/dist/datasource/skills/obsidian/connector.d.ts

@@ -1,22 +0,0 @@
-/**
- * Obsidian vault connector (issue #1314).
- *
- * Walks a trusted, server-configured vault directory for markdown notes,
- * extracting frontmatter/inline tags, wiki links, and embeds. No network
- * access. Per-file read failures aggregate into a count-only warning;
- * absolute paths never appear in warnings (vault-relative segments are the
- * vault's own logical hierarchy and are allowed in doc ids).
- */
-import type { ConnectorFetchResult, DatasourceConnector } from "../../connector.js";
-export interface ObsidianConnectorOptions {
-    /** Absolute path to the vault root. Required trusted configuration. */
-    readonly vaultPath?: string;
-    readonly maxDocuments?: number;
-    /** Files larger than this are skipped. Default 2 MiB. */
-    readonly maxBytesPerFile?: number;
-}
-export declare class ObsidianConnector implements DatasourceConnector {
-    private readonly options;
-    constructor(options?: ObsidianConnectorOptions);
-    fetch(): Promise<ConnectorFetchResult>;
-}

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

@@ -1,28 +0,0 @@
-/**
- * Slack workspace connector (issue #1300).
- *
- * Fetches channel history through the Slack Web API using a trusted,
- * server-configured bot token. Never throws; failures map onto the coarse
- * connector failure union with path/PII-opaque messages. Per-channel
- * failures degrade to warnings so one denied channel cannot fail the fetch.
- */
-import type { ConnectorFetchResult, DatasourceConnector } from "../../connector.js";
-export interface SlackConnectorOptions {
-    /** Slack Web API base; override to point at a mock server in tests. */
-    readonly baseUrl?: string;
-    /** Bot token; explicit value wins over {@link tokenEnv}. */
-    readonly token?: string;
-    /** Env var name holding the bot token. Default `SLACK_BOT_TOKEN`. */
-    readonly tokenEnv?: string;
-    /** Restrict indexing to these channel names or ids. */
-    readonly channels?: readonly string[];
-    readonly timeoutMs?: number;
-    readonly fetchImpl?: typeof fetch;
-    readonly maxPages?: number;
-    readonly maxDocuments?: number;
-}
-export declare class SlackConnector implements DatasourceConnector {
-    private readonly options;
-    constructor(options?: SlackConnectorOptions);
-    fetch(signal?: AbortSignal): Promise<ConnectorFetchResult>;
-}

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

@@ -1,20 +0,0 @@
-/**
- * Slack workspace datasource skill (issue #1300).
- *
- * Thin composition of SlackConnector with the shared
- * {@link ConnectorDatasourceSkill} base: descriptor, polling metadata,
- * ok/fail indexing with path/PII-opaque diagnostics, lexical retrieval via
- * the shared pipeline, opaque `/slack/<instance>/…` sources, and a
- * progressive-disclosure agent-skill manifest.
- */
-import { ConnectorDatasourceSkill, type ConnectorSkillDefinition, type ConnectorSkillOptions } from "../../connector-skill.js";
-import { SlackConnector, type SlackConnectorOptions } from "./connector.js";
-export declare const SLACK_SKILL_DEFINITION: ConnectorSkillDefinition;
-export interface SlackSkillOptions extends Omit<ConnectorSkillOptions, "connector"> {
-    /** Trusted connector configuration; a pre-built connector wins. */
-    readonly connector?: SlackConnector;
-    readonly connectorOptions?: SlackConnectorOptions;
-}
-export declare class SlackSkill extends ConnectorDatasourceSkill {
-    constructor(options?: SlackSkillOptions);
-}

package/dist/subagents/contracts.d.ts

@@ -1,90 +0,0 @@
-export declare const RETRIEVAL_METHODS: readonly ["posix", "bash", "posix/bash", "bm25", "minsync", "vector", "minsync/vector", "datasource"];
-export type RetrievalMethod = (typeof RETRIEVAL_METHODS)[number];
-export type SourceTemporalStatus = "asOf" | "updatedAt" | "createdAt" | "unknown";
-export type SourceTemporal = {
-    readonly status: "asOf";
-    readonly asOf: string;
-} | {
-    readonly status: "updatedAt";
-    readonly updatedAt: string;
-} | {
-    readonly status: "createdAt";
-    readonly createdAt: string;
-} | {
-    readonly status: "unknown";
-};
-export interface ExplorerAssignment {
-    readonly originalQuery: string;
-    readonly method: RetrievalMethod;
-    readonly queryVariant: string;
-    /** Optional set of variants retained when an orchestrator fans out work. */
-    readonly queryVariants?: readonly string[];
-}
-export interface EvidenceCandidate {
-    readonly source: string;
-    readonly method: RetrievalMethod;
-    readonly evidence: string;
-    readonly retrievedAt: string;
-    readonly sourceTemporal: SourceTemporal;
-    readonly locator?: string;
-}
-export interface ExplorerReport {
-    readonly assignment: ExplorerAssignment;
-    readonly evidenceCandidates: readonly EvidenceCandidate[];
-    /** Alias for consumers that use the shorter candidate field name. */
-    readonly candidates?: readonly EvidenceCandidate[];
-    readonly summary?: string;
-}
-export interface FollowUpRequest {
-    readonly reason: string;
-    readonly assignments: readonly ExplorerAssignment[];
-}
-export type JudgeDecision = {
-    readonly decision: "sufficient";
-    readonly rationale: string;
-    readonly followUp?: undefined;
-} | {
-    readonly decision: "follow_up";
-    readonly rationale: string;
-    readonly followUp: FollowUpRequest;
-};
-export interface ExhaustionErrorDetails {
-    readonly code: "EXPLORER_EXHAUSTED";
-    readonly originalQuery: string;
-    readonly iterations: number;
-    readonly maxIterations: number;
-    readonly reason: string;
-}
-export type ContractErrorCode = "INVALID_OBJECT" | "MISSING_ORIGINAL_QUERY" | "INVALID_ORIGINAL_QUERY" | "MISSING_RETRIEVAL_METHOD" | "INVALID_RETRIEVAL_METHOD" | "MISSING_QUERY_VARIANT" | "INVALID_QUERY_VARIANT" | "INVALID_QUERY_VARIANTS" | "QUERY_VARIANT_NOT_INCLUDED" | "MISSING_SOURCE" | "INVALID_SOURCE" | "MISSING_EVIDENCE_METHOD" | "INVALID_EVIDENCE_METHOD" | "MISSING_EVIDENCE" | "INVALID_EVIDENCE" | "MISSING_RETRIEVED_AT" | "INVALID_RETRIEVED_AT" | "MISSING_SOURCE_TEMPORAL" | "INVALID_SOURCE_TEMPORAL" | "MISSING_SOURCE_TEMPORAL_DATE" | "INVALID_SOURCE_TEMPORAL_DATE" | "MISSING_ASSIGNMENT" | "MISSING_EVIDENCE_CANDIDATES" | "INVALID_EVIDENCE_CANDIDATES" | "INVALID_SUMMARY" | "MISSING_FOLLOW_UP_REASON" | "INVALID_FOLLOW_UP_REASON" | "MISSING_FOLLOW_UP_ASSIGNMENTS" | "EMPTY_FOLLOW_UP_ASSIGNMENTS" | "INVALID_FOLLOW_UP_ASSIGNMENTS" | "MISSING_JUDGE_DECISION" | "INVALID_JUDGE_DECISION" | "MISSING_JUDGE_RATIONALE" | "INVALID_JUDGE_RATIONALE" | "MISSING_FOLLOW_UP" | "INVALID_FOLLOW_UP" | "INVALID_EXHAUSTION_ERROR" | "INVALID_EXHAUSTION_CODE" | "MISSING_EXHAUSTION_QUERY" | "INVALID_EXHAUSTION_QUERY" | "INVALID_EXHAUSTION_ITERATIONS" | "INVALID_EXHAUSTION_LIMIT" | "MISSING_EXHAUSTION_REASON" | "INVALID_EXHAUSTION_REASON";
-export declare class ContractValidationError extends Error {
-    readonly code: ContractErrorCode;
-    readonly path?: string;
-    constructor(code: ContractErrorCode, message: string, path?: string);
-}
-export declare class ExplorerExhaustionError extends Error {
-    readonly code: "EXPLORER_EXHAUSTED";
-    readonly originalQuery: string;
-    readonly iterations: number;
-    readonly maxIterations: number;
-    readonly reason: string;
-    constructor(details: Omit<ExhaustionErrorDetails, "code">);
-    toJSON(): ExhaustionErrorDetails;
-}
-export declare function parseExplorerAssignment(value: unknown): ExplorerAssignment;
-export declare function parseEvidenceCandidate(value: unknown): EvidenceCandidate;
-export declare function parseExplorerReport(value: unknown): ExplorerReport;
-export declare function parseFollowUpRequest(value: unknown): FollowUpRequest;
-export declare function parseJudgeDecision(value: unknown): JudgeDecision;
-export declare function parseExhaustionError(value: unknown): ExhaustionErrorDetails;
-export declare function isExplorerAssignment(value: unknown): value is ExplorerAssignment;
-export declare function isEvidenceCandidate(value: unknown): value is EvidenceCandidate;
-export declare function isExplorerReport(value: unknown): value is ExplorerReport;
-export declare function isFollowUpRequest(value: unknown): value is FollowUpRequest;
-export declare function isJudgeDecision(value: unknown): value is JudgeDecision;
-export declare function isExhaustionError(value: unknown): value is ExhaustionErrorDetails;
-export declare function safeParseExplorerAssignment(value: unknown): ExplorerAssignment | undefined;
-export declare function safeParseEvidenceCandidate(value: unknown): EvidenceCandidate | undefined;
-export declare function safeParseExplorerReport(value: unknown): ExplorerReport | undefined;
-export declare function safeParseFollowUpRequest(value: unknown): FollowUpRequest | undefined;
-export declare function safeParseJudgeDecision(value: unknown): JudgeDecision | undefined;
-export declare function safeParseExhaustionError(value: unknown): ExhaustionErrorDetails | undefined;

package/dist/subagents/dispatch-templates.d.ts

@@ -1,104 +0,0 @@
-/**
- * Shared dispatch template builders, skeleton literals, and anti-examples for
- * AutoRAG explorer subagent dispatch.
- *
- * This module is the single source of truth for:
- * - Assignment V1 sentinel/role-line constants and block builder
- * - Single-root and multi-root success dispatch payload builders
- * - Compact skeleton literals consumed by `formatBlockReason`
- * - Anti-examples for rejected dispatch patterns
- * - Stable coded patch-error reference (single source of truth for the error catalog)
- *
- * `buildSearchPrompt` and prompt tests reuse these builders so no divergent
- * template text exists inside TypeScript.
- */
-export declare const AUTORAG_ASSIGNMENT_V1_START = "<<<AUTORAG_ASSIGNMENT_V1>>>";
-export declare const AUTORAG_ASSIGNMENT_V1_END = "<<<END_AUTORAG_ASSIGNMENT_V1>>>";
-export declare const AUTORAG_ROLE_LINE_RETRIEVED_AT = "Required handoff: include retrievedAt.";
-export declare const AUTORAG_ROLE_LINE_TEMPORAL_METADATA = "Required handoff: include temporal metadata.";
-export declare const AUTORAG_CANONICAL_ROLE_LINES = "Required handoff: include retrievedAt.\nRequired handoff: include temporal metadata.";
-export declare const PLACEHOLDER_CONFIGURED_MODEL = "<configured-model>";
-export declare const PLACEHOLDER_ALLOWED_ROOT = "<allowed-root>";
-export declare const PLACEHOLDER_ASSIGNMENT_V1_BLOCK = "<Assignment V1 block>";
-export declare const PLACEHOLDER_CALLER_QUERY = "<caller query verbatim>";
-export declare const DISPATCH_ADMIN_SKELETON = "{\"action\":\"list\"}";
-export declare const DISPATCH_SINGLE_SKELETON = "{\"agentScope\":\"user\",\"artifacts\":false,\"agent\":\"autorag-explorer\",\"model\":\"<configured-model>\",\"cwd\":\"<allowed-root>\",\"task\":\"<Assignment V1 block>\"}";
-export declare const DISPATCH_FANOUT_SKELETON = "{\"agentScope\":\"user\",\"artifacts\":false,\"tasks\":[{\"agent\":\"autorag-explorer\",\"model\":\"<configured-model>\",\"cwd\":\"<allowed-root>\",\"task\":\"<Assignment V1 block>\"}]}";
-export interface AssignmentV1Options {
-    readonly originalQuery: string;
-    readonly method: string;
-    readonly queryVariants: readonly string[];
-}
-/**
- * Build a canonical Assignment V1 block string for use as the `task` field
- * value in a subagent dispatch payload.
- *
- * Output shape (LF-joined):
- * ```
- * <<<AUTORAG_ASSIGNMENT_V1>>>
- * {"originalQuery":"...","method":"...","queryVariants":["..."]}
- * <<<END_AUTORAG_ASSIGNMENT_V1>>>
- * Required handoff: include retrievedAt.
- * Required handoff: include temporal metadata.
- * ```
- */
-export declare function buildAssignmentV1Block(opts: AssignmentV1Options): string;
-export interface SingleRootDispatchOptions {
-    readonly explorerModel: string;
-    readonly allowedRoot: string;
-    readonly task: string;
-}
-/**
- * Build a single-root success dispatch payload as pretty-printed JSON.
- *
- * `agentScope` and `artifacts` are set exactly once at the top level.
- * The single leaf carries `agent`, `model`, `cwd`, and `task`.
- * Pass `PLACEHOLDER_*` constants for prompt examples or real values for
- * actual dispatch payloads.
- */
-export declare function buildSingleRootDispatchPayload(opts: SingleRootDispatchOptions): string;
-export interface MultiRootDispatchTask {
-    readonly explorerModel: string;
-    readonly allowedRoot: string;
-    readonly task: string;
-}
-/**
- * Build a multi-root success dispatch payload as pretty-printed JSON.
- *
- * `agentScope` and `artifacts` are set exactly once at the top level.
- * Each task in `tasks` carries `agent`, `model`, `cwd`, and `task` and
- * omits `agentScope`/`artifacts`. Pass one task per configured root.
- */
-export declare function buildMultiRootDispatchPayload(tasks: readonly MultiRootDispatchTask[]): string;
-export interface DispatchAntiExample {
-    readonly label: string;
-    readonly body: string;
-    readonly reason: string;
-}
-/**
- * Brief anti-examples showing dispatch patterns that are rejected.
- * Each body is pretty-printed JSON using non-sensitive placeholders only.
- */
-export declare const DISPATCH_ANTIEXAMPLES: readonly DispatchAntiExample[];
-export interface DispatchErrorInfo {
-    readonly code: string;
-    readonly exactFix: string;
-    readonly forceCorrectable: boolean;
-}
-/**
- * Reference table of stable dispatch rejection codes, their exactFix strings,
- * and forceCorrectable flags. This is the single source of truth for the error
- * catalog — `dispatch-validation.ts` derives its `EXACT_FIX_MAP` and
- * `FORCE_CORRECTABLE_MAP` from this table so no dual catalog exists.
- *
- * `DISPATCH_ROLE_METADATA_INVALID` is intentionally absent: valid tasks are
- * normalized by `ensureRoleLines` and no rejection path emits that code.
- */
-export declare const DISPATCH_ERROR_REFERENCE: readonly DispatchErrorInfo[];
-/**
- * Build the `### Canonical dispatch templates` subsection text for the system
- * prompt. Uses the builders and constants above so no divergent template text
- * exists. The `explorerModelId` parameter fills the model field in the example
- * payloads.
- */
-export declare function buildDispatchTemplatesPromptSection(explorerModelId: string): string;

package/dist/subagents/dispatch-validation.d.ts

@@ -1,169 +0,0 @@
-export type DispatchRejectionCode = "DISPATCH_MALFORMED" | "DISPATCH_ACTION_UNKNOWN" | "DISPATCH_ADMIN_MUTATION_FORBIDDEN" | "DISPATCH_CONTROL_FORBIDDEN" | "DISPATCH_SCHEDULE_FORBIDDEN" | "DISPATCH_ARTIFACTS_INVALID" | "DISPATCH_AGENT_SCOPE_INVALID" | "DISPATCH_AGENT_IDENTITY" | "DISPATCH_MODEL_MISMATCH" | "DISPATCH_ASSIGNMENT_INVALID" | "DISPATCH_QUERY_MISMATCH" | "DISPATCH_CWD_MISSING" | "DISPATCH_CWD_OUTSIDE_ROOTS" | "DISPATCH_NO_ACTIVE_QUERY";
-export type DispatchKind = "launch" | "admin" | "control" | "mutation" | "schedule" | "hybrid" | "unknown";
-export interface DispatchRejection {
-    readonly code: DispatchRejectionCode;
-    readonly field: string;
-    readonly dispatchKind: DispatchKind;
-}
-export declare class DispatchRejectionError extends Error {
-    readonly code: DispatchRejectionCode;
-    readonly field: string;
-    readonly exactFix: string;
-    readonly forceCorrectable: boolean;
-    readonly skeleton: string;
-    readonly dispatchKind: DispatchKind;
-    constructor(rejection: DispatchRejection, exactFix: string, forceCorrectable: boolean, skeleton: string);
-}
-export declare const EXACT_FIX_MAP: Readonly<Record<DispatchRejectionCode, string>>;
-export declare const FORCE_CORRECTABLE_MAP: Readonly<Record<DispatchRejectionCode, boolean>>;
-/** Backward-compatible aliases for the shared skeleton literals from dispatch-templates.ts. */
-export declare const SKELETON_ADMIN = "{\"action\":\"list\"}";
-export declare const SKELETON_SINGLE = "{\"agentScope\":\"user\",\"artifacts\":false,\"agent\":\"autorag-explorer\",\"model\":\"<configured-model>\",\"cwd\":\"<allowed-root>\",\"task\":\"<Assignment V1 block>\"}";
-export declare const SKELETON_FANOUT = "{\"agentScope\":\"user\",\"artifacts\":false,\"tasks\":[{\"agent\":\"autorag-explorer\",\"model\":\"<configured-model>\",\"cwd\":\"<allowed-root>\",\"task\":\"<Assignment V1 block>\"}]}";
-export declare function formatBlockReason(code: DispatchRejectionCode, field: string, exactFix: string, skeleton: string): string;
-export declare function classifyAction(action: unknown): DispatchKind;
-/**
- * Classify a full dispatch invocation into a dispatch kind.
- *
- * Classification happens BEFORE any defaults or autofill.
- * - If `action` is present and is a mutation/control/schedule → that kind (forbidden-action precedence).
- * - If `action` is present and is a diagnostic (exact lowercase) → admin.
- * - If `action` is present and is an explicit execution alias (exact lowercase: single/parallel/tasks) with launch shape → launch.
- * - If `action` is present but is non-string, unknown, or a non-exact-lowercase value
- *   (e.g. "Create", "LIST", "Interrupt", 42) → unknown, regardless of launch fields.
- * - If no `action` property but launch shape fields present (agent/task/tasks/chain/parallel) → launch.
- * - Otherwise → unknown.
- */
-export declare function classifyDispatch(args: unknown): DispatchKind;
-/**
- * Validate a diagnostic invocation against its exact allowed field set.
- * Returns a DispatchRejection if invalid, undefined if valid.
- * Diagnostics bypass explorer assignment/root/model launch gates.
- */
-export declare function validateDiagnostic(args: Record<string, unknown>, action: string): DispatchRejection | undefined;
-export declare function rejectForbiddenAction(action: string): DispatchRejection;
-export interface PrepareContext {
-    /** Configured explorer model wire id (e.g. "provider/model-id"). */
-    readonly configuredModel: string | undefined;
-}
-export interface PrepareResult {
-    /** Normalized args (defaults filled for launch, null-deleted). */
-    readonly args: Record<string, unknown>;
-    /** Whether any field was autofilled. */
-    readonly autofilled: {
-        readonly artifacts: boolean;
-        readonly agentScope: boolean;
-        readonly leafModelFillCount: number;
-    };
-}
-/**
- * Composed prepareArguments for the subagent tool.
- *
- * Classifies first, then applies launch-only normalization (null-delete + missing defaults).
- * Diagnostics never receive artifacts/agentScope/model defaults.
- * Throws DispatchRejectionError on any validation failure.
- */
-export declare function autoragPrepare(rawArgs: unknown, ctx: PrepareContext): Record<string, unknown>;
-export declare function readAutofilled(args: Record<string, unknown>): {
-    readonly artifacts: boolean;
-    readonly agentScope: boolean;
-    readonly leafModelFillCount: number;
-} | undefined;
-interface LaunchLeaf {
-    readonly record: Record<string, unknown>;
-    readonly path: string;
-}
-export declare function getLaunchLeaves(args: Record<string, unknown>): readonly LaunchLeaf[];
-/**
- * Create a DispatchRejectionError from a DispatchRejection with proper
- * exactFix, forceCorrectable, and skeleton selection.
- * Used by beforeToolCall for post-schema rejections.
- *
- * When `args` is provided and the rejection is a launch kind, the skeleton is
- * selected from the args shape: fanout if `tasks`/`chain`/`parallel` are
- * present, single otherwise. When `args` is omitted, launch rejections default
- * to the single skeleton. Non-launch kinds always use the admin skeleton.
- */
-export declare function createDispatchRejectionError(rejection: DispatchRejection, args?: Record<string, unknown>): DispatchRejectionError;
-/** Backward-compatible aliases for shared V1 sentinel constants. */
-export declare const AUTORAG_ASSIGNMENT_V1_START = "<<<AUTORAG_ASSIGNMENT_V1>>>";
-export declare const AUTORAG_ASSIGNMENT_V1_END = "<<<END_AUTORAG_ASSIGNMENT_V1>>>";
-export interface ParsedAssignment {
-    readonly originalQuery: string;
-    readonly method: string;
-    readonly queryVariants: readonly string[];
-    /** Whether V1 (true) or legacy (false) format was used. */
-    readonly isV1: boolean;
-}
-/** Backward-compatible aliases for shared role line constants. */
-export declare const ROLE_LINE_RETRIEVED_AT = "Required handoff: include retrievedAt.";
-export declare const ROLE_LINE_TEMPORAL_METADATA = "Required handoff: include temporal metadata.";
-export declare function canonicalRoleLines(): string;
-/**
- * Parse a task string as an Assignment V1 block.
- *
- * V1 sentinels:
- * - Start line (after stripping single trailing CR) must equal <<<AUTORAG_ASSIGNMENT_V1>>>
- * - End line (after stripping single trailing CR) must equal <<<END_AUTORAG_ASSIGNMENT_V1>>>
- * - End sentinel at EOF valid
- * - Exactly one V1 block; duplicate/malformed/unterminated → reject
- * - Body: one JSON object with exactly keys originalQuery, method, queryVariants
- * - originalQuery: string, trimmed nonempty
- * - method: string, trimmed nonempty
- * - queryVariants: nonempty array of nonempty strings
- * - Extra/missing keys/wrong types → reject
- *
- * Returns undefined if no V1 sentinel found (caller should try legacy).
- * Returns ParsedAssignment on success.
- * Throws DispatchRejectionError on malformed V1.
- */
-export declare function parseAssignmentV1(task: string): ParsedAssignment | undefined;
-/**
- * Parse a task string as a legacy prose assignment.
- *
- * Legacy (n4 retained):
- * - Full logical lines; optional leading whitespace; optional `- ` bullet; optional matching `**` around label.
- * - Case/space normalize labels; value = remainder of same line only.
- * - Labels: Original query; Selected retrieval method | Retrieval method; Query variants | Query variant.
- * - Reorder OK; exactly once each; Query variants split on `;`, trim, reject empty segments.
- * - Later label-looking line → reject.
- * - Prefix/suffix outside three lines preserved.
- * - Multiline / special / label-looking content inside values → V1 required, not legacy.
- *
- * Returns undefined if no legacy labels found.
- * Throws DispatchRejectionError on malformed legacy.
- */
-export declare function parseLegacyAssignment(task: string): ParsedAssignment | undefined;
-/**
- * Parse a task string as either V1 or legacy assignment.
- * Tries V1 first; if no V1 sentinels, tries legacy.
- * Returns undefined if neither format is found.
- * Throws DispatchRejectionError on malformed input.
- */
-export declare function parseAssignment(task: string): ParsedAssignment | undefined;
-/**
- * Insert canonical role lines into a task string, byte-idempotent.
- *
- * 1. Remove all existing exact canonical role lines (the two literals after CR-strip).
- * 2. Insert exactly one of each immediately after end sentinel (V1) or
- *    immediately after the last of the three recognized legacy label lines.
- * 3. Preserve all other suffix bytes and original newline style.
- * 4. Repeat rendering is byte-idempotent.
- */
-export declare function ensureRoleLines(task: string): string;
-export interface PostSchemaContext {
-    readonly configuredModel: string | undefined;
-    readonly currentQuery: string | undefined;
-    readonly allowedRoots: readonly string[];
-    readonly workspaceRoot: string;
-}
-/**
- * Post-schema validation for launch invocations.
- * Checks: assignment parse, structural query equality, role lines,
- * cwd realpath/allowed roots, model match.
- *
- * Returns a DispatchRejection if invalid, undefined if valid.
- * Also normalizes cwd to canonical realpath on success.
- */
-export declare function validateLaunchPostSchema(args: Record<string, unknown>, ctx: PostSchemaContext): DispatchRejection | undefined;
-export {};

package/dist/subagents/explorer-tools-extension.d.ts

@@ -1,4 +0,0 @@
-import { type ExtensionAPI } from "@earendil-works/pi-coding-agent";
-type ExplorerToolRegistrar = Pick<ExtensionAPI, "registerTool">;
-export default function registerExplorerTools(pi: ExplorerToolRegistrar): void;
-export {};

package/dist/subagents/explorer-tools-extension.js

@@ -1,130 +0,0 @@
-import { createRequire } from "node:module";
-var __defProp = Object.defineProperty;
-var __returnValue = (v) => v;
-function __exportSetter(name, newValue) {
-  this[name] = __returnValue.bind(null, newValue);
-}
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: __exportSetter.bind(all, name)
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
-
-// src/subagents/explorer-tools-extension.ts
-import { realpath, stat } from "node:fs/promises";
-import { dirname, isAbsolute, relative, resolve, sep } from "node:path";
-import {
-  createFindToolDefinition,
-  createGrepToolDefinition,
-  createLsToolDefinition,
-  createReadToolDefinition
-} from "@earendil-works/pi-coding-agent";
-var PARENT_TRAVERSAL_SEGMENT = /(^|[/\\])\.\.($|[/\\])/;
-var TOOL_METADATA_CWD = "/";
-
-class ExplorerPathContainmentError extends Error {
-  code;
-  requestedPath;
-  root;
-  constructor(message, requestedPath, root) {
-    super(message);
-    this.name = "ExplorerPathContainmentError";
-    this.code = "EXPLORER_PATH_CONTAINMENT";
-    this.requestedPath = requestedPath;
-    this.root = root;
-  }
-}
-function isMissingPathError(error) {
-  return error instanceof Error && "code" in error && (error.code === "ENOENT" || error.code === "ENOTDIR");
-}
-function isEqualOrDescendant(root, target) {
-  const pathFromRoot = relative(root, target);
-  return pathFromRoot === "" || pathFromRoot !== ".." && !pathFromRoot.startsWith(`..${sep}`) && !isAbsolute(pathFromRoot);
-}
-async function resolveExistingTargetOrNearestParent(target) {
-  try {
-    return await realpath(target);
-  } catch (error) {
-    if (!isMissingPathError(error))
-      throw error;
-  }
-  let candidateParent = dirname(target);
-  while (true) {
-    try {
-      const realParent = await realpath(candidateParent);
-      return resolve(realParent, relative(candidateParent, target));
-    } catch (error) {
-      if (!isMissingPathError(error))
-        throw error;
-      const nextParent = dirname(candidateParent);
-      if (nextParent === candidateParent)
-        throw error;
-      candidateParent = nextParent;
-    }
-  }
-}
-async function resolveExplorerRoot(cwd) {
-  const root = await realpath(cwd);
-  if (!(await stat(root)).isDirectory()) {
-    throw new Error(`Explorer assigned cwd is not a directory: ${cwd}`);
-  }
-  return root;
-}
-async function resolveContainedPath(root, requestedPath) {
-  if (PARENT_TRAVERSAL_SEGMENT.test(requestedPath)) {
-    throw new ExplorerPathContainmentError(`Explorer filesystem containment rejected parent traversal path: ${requestedPath}`, requestedPath, root);
-  }
-  const target = await resolveExistingTargetOrNearestParent(resolve(root, requestedPath));
-  if (!isEqualOrDescendant(root, target)) {
-    throw new ExplorerPathContainmentError(`Explorer filesystem containment rejected path outside assigned cwd: ${requestedPath}`, requestedPath, root);
-  }
-  return { root, target };
-}
-function registerExplorerTools(pi) {
-  let pinnedRoot;
-  const getPinnedRoot = (cwd) => {
-    pinnedRoot ??= resolveExplorerRoot(cwd);
-    return pinnedRoot;
-  };
-  const readTool = createReadToolDefinition(TOOL_METADATA_CWD);
-  pi.registerTool({
-    ...readTool,
-    async execute(toolCallId, params, signal, onUpdate, ctx) {
-      const { root, target } = await resolveContainedPath(await getPinnedRoot(ctx.cwd), params.path);
-      return createReadToolDefinition(root).execute(toolCallId, { ...params, path: target }, signal, onUpdate, ctx);
-    }
-  });
-  const grepTool = createGrepToolDefinition(TOOL_METADATA_CWD);
-  pi.registerTool({
-    ...grepTool,
-    async execute(toolCallId, params, signal, onUpdate, ctx) {
-      const { root, target } = await resolveContainedPath(await getPinnedRoot(ctx.cwd), params.path ?? ".");
-      return createGrepToolDefinition(root).execute(toolCallId, { ...params, path: target }, signal, onUpdate, ctx);
-    }
-  });
-  const findTool = createFindToolDefinition(TOOL_METADATA_CWD);
-  pi.registerTool({
-    ...findTool,
-    async execute(toolCallId, params, signal, onUpdate, ctx) {
-      const { root, target } = await resolveContainedPath(await getPinnedRoot(ctx.cwd), params.path ?? ".");
-      return createFindToolDefinition(root).execute(toolCallId, { ...params, path: target }, signal, onUpdate, ctx);
-    }
-  });
-  const lsTool = createLsToolDefinition(TOOL_METADATA_CWD);
-  pi.registerTool({
-    ...lsTool,
-    async execute(toolCallId, params, signal, onUpdate, ctx) {
-      const { root, target } = await resolveContainedPath(await getPinnedRoot(ctx.cwd), params.path ?? ".");
-      return createLsToolDefinition(root).execute(toolCallId, { ...params, path: target }, signal, onUpdate, ctx);
-    }
-  });
-}
-export {
-  registerExplorerTools as default
-};

package/dist/subagents/local-models.d.ts

@@ -1,14 +0,0 @@
-import type { Model } from "@earendil-works/pi-ai";
-export interface LocalAutoRAGModels {
-    readonly provider: string;
-    readonly apiKey: string;
-    readonly orchestrator: Model<"openai-responses">;
-    readonly explorer: Model<"openai-responses">;
-}
-export interface LoadLocalAutoRAGModelsOptions {
-    readonly configPath?: string;
-    readonly env?: Readonly<Record<string, string | undefined>>;
-    readonly orchestratorModelId?: string;
-    readonly explorerModelId?: string;
-}
-export declare function loadLocalAutoRAGModels(options?: LoadLocalAutoRAGModelsOptions): LocalAutoRAGModels;