@autorag/librarian 2.2.0 → 2.3.0

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;

package/dist/subagents/model-policy.d.ts

@@ -1,31 +0,0 @@
-export declare const ORCHESTRATOR_MODEL_ID: "gpt-5.6-sol";
-export declare const EXPLORER_MODEL_ID: "gpt-5.6-luna";
-export declare const REQUIRED_MODEL_IDS: Readonly<{
-    orchestrator: "gpt-5.6-sol";
-    explorer: "gpt-5.6-luna";
-}>;
-export type ModelRole = keyof typeof REQUIRED_MODEL_IDS;
-export interface ModelReference {
-    readonly id: string;
-    readonly provider?: string;
-}
-export interface ValidatedModelPolicy {
-    readonly orchestrator: ModelReference;
-    readonly explorer: ModelReference;
-}
-export type ModelPolicyErrorCode = "INVALID_POLICY_OBJECT" | "MISSING_REQUIRED_MODEL" | "INVALID_MODEL_REFERENCE";
-export declare class ModelPolicyError extends Error {
-    readonly code: ModelPolicyErrorCode;
-    readonly role?: ModelRole;
-    readonly expected?: string;
-    readonly actual?: string;
-    constructor(code: ModelPolicyErrorCode, message: string, options?: {
-        readonly role?: ModelRole;
-        readonly expected?: string;
-        readonly actual?: string;
-    });
-}
-export declare function validateModelPolicy(value: unknown): ValidatedModelPolicy;
-export declare function assertModelPolicy(value: unknown): asserts value is ValidatedModelPolicy;
-export declare function isModelPolicy(value: unknown): value is ValidatedModelPolicy;
-export declare function requiredModelId(role: ModelRole): string;

package/dist/subagents/runtime.d.ts

@@ -1,52 +0,0 @@
-import type { AgentTool } from "@earendil-works/pi-agent-core";
-import { type Api, type Model } from "@earendil-works/pi-ai";
-import { type AgentSession } from "@earendil-works/pi-coding-agent";
-export declare const EXPLORER_TOOLS_EXTENSION_PATH: string;
-export declare const AUTORAG_EXPLORER_AGENT_MANAGED_VERSION = 2;
-export declare const AUTORAG_EXPLORER_AGENT_DEFINITION: string;
-export interface MandatorySubagentSessionOptions {
-    readonly cwd: string;
-    readonly model: Model<Api>;
-    readonly explorerModel?: Model<Api>;
-    readonly systemPrompt: string;
-    readonly tools: readonly AgentTool[];
-    readonly extensionPath?: string;
-    readonly apiKey?: string;
-    readonly providerApiKeys?: Readonly<Record<string, string>>;
-    readonly agentDir?: string;
-    readonly sessionDir?: string;
-}
-export interface MandatorySubagentSession {
-    readonly session: AgentSession;
-    readonly extensionPath: string;
-}
-export interface HealthSubagentProbeSessionOptions {
-    readonly cwd: string;
-    readonly model: Model<Api>;
-    readonly explorerModel?: Model<Api>;
-    readonly systemPrompt: string;
-    readonly tools: readonly AgentTool[];
-    readonly extensionPath?: string;
-    readonly apiKey?: string;
-    readonly providerApiKeys?: Readonly<Record<string, string>>;
-    readonly agentDir: string;
-    readonly sessionDir: string;
-}
-export interface HealthSubagentProbeSession {
-    readonly session: AgentSession;
-    readonly extensionPath: string;
-    readonly dispose: () => void;
-}
-export declare function createMandatorySubagentSession(options: MandatorySubagentSessionOptions): Promise<MandatorySubagentSession>;
-/**
- * Create a short-lived subagent session for the `autorag health` explorer probe.
- *
- * Unlike {@link createMandatorySubagentSession}, this requires absolute
- * `agentDir` and `sessionDir` (typically under a caller-created temp
- * directory) so the probe never touches durable home state. On a lease
- * conflict — i.e. when another live session holds a different child
- * environment/registry routing — the error is rethrown with a stable
- * "concurrent AutoRAG session busy" message so the health command can map
- * it to `subagent_failed`.
- */
-export declare function createHealthSubagentProbeSession(options: HealthSubagentProbeSessionOptions): Promise<HealthSubagentProbeSession>;