@autonav/core 1.7.0 → 1.9.0

package/dist/adapter/claude-adapter.d.ts

@@ -1,189 +0,0 @@
-import { NavigatorConfig, NavigatorResponse, type ValidationResult } from "@autonav/communication-layer";
-import { PluginManager } from "../plugins/index.js";
-/**
- * Configuration options for Claude Adapter
- */
-export interface ClaudeAdapterOptions {
-    /**
-     * Claude model to use (defaults to claude-sonnet-4-5)
-     */
-    model?: string;
-    /**
-     * Maximum turns for agentic loop
-     *
-     * The SDK's agentic loop continues until Claude naturally stops responding,
-     * or until this limit is reached. MCP tools cannot force early termination -
-     * instead, we rely on the system prompt instructing Claude to stop after
-     * calling submit_answer.
-     *
-     * In practice, Claude typically stops within 0-2 turns after calling submit_answer,
-     * often stopping immediately on the same turn. This parameter serves as a safety
-     * limit to prevent runaway execution in edge cases (e.g., if Claude ignores the
-     * stop instruction or enters an unexpected loop).
-     *
-     * @default 50
-     */
-    maxTurns?: number;
-}
-/**
- * Loaded navigator with all necessary context
- */
-export interface LoadedNavigator {
-    config: NavigatorConfig;
-    systemPrompt: string;
-    navigatorPath: string;
-    knowledgeBasePath: string;
-    pluginManager?: PluginManager;
-    pluginsConfigPath?: string;
-}
-/**
- * Query options
- */
-export interface QueryOptions {
-    /**
-     * Enable self-configuration tools (defaults to true)
-     */
-    enableSelfConfig?: boolean;
-    /**
-     * Maximum turns for agentic loop
-     *
-     * The SDK's agentic loop continues until Claude naturally stops responding,
-     * or until this limit is reached. MCP tools cannot force early termination -
-     * instead, we rely on the system prompt instructing Claude to stop after
-     * calling submit_answer.
-     *
-     * In practice, Claude typically stops within 0-2 turns after calling submit_answer,
-     * often stopping immediately on the same turn. This parameter serves as a safety
-     * limit to prevent runaway execution in edge cases (e.g., if Claude ignores the
-     * stop instruction or enters an unexpected loop).
-     *
-     * @default 50
-     */
-    maxTurns?: number;
-}
-/**
- * Claude Agent SDK Adapter
- *
- * Bridges Claude Agent SDK to the Communication Layer protocol.
- * Loads navigators, executes queries, and validates responses.
- *
- * @example
- * ```typescript
- * const adapter = new ClaudeAdapter({
- *   model: 'claude-sonnet-4-5'
- * });
- *
- * const navigator = adapter.loadNavigator('./my-navigator');
- * const response = await adapter.query(navigator, 'How do I deploy?');
- * ```
- */
-export declare class ClaudeAdapter {
-    private readonly options;
-    /**
-     * Create a new Claude Adapter
-     *
-     * @param options - Configuration options
-     */
-    constructor(options?: ClaudeAdapterOptions);
-    /**
-     * Load a navigator from a directory
-     *
-     * Reads and validates config.json and CLAUDE.md (or custom instructions file).
-     * Verifies that the knowledge base directory exists.
-     * If .claude/plugins.json exists, initializes configured plugins.
-     *
-     * @param navigatorPath - Path to the navigator directory
-     * @returns Loaded navigator with config, system prompt, paths, and optional plugin manager
-     * @throws {Error} If directory doesn't exist, config is invalid, or required files are missing
-     *
-     * @example
-     * ```typescript
-     * const adapter = new ClaudeAdapter();
-     * const navigator = await adapter.loadNavigator('./my-navigator');
-     * console.log(`Loaded: ${navigator.config.name}`);
-     * ```
-     */
-    loadNavigator(navigatorPath: string): Promise<LoadedNavigator>;
-    /**
-     * Execute a query using Claude Agent SDK
-     *
-     * Sends the question to Claude with the navigator's system prompt,
-     * handles tool use via the built-in agentic loop, parses the response,
-     * and validates it against the knowledge base.
-     *
-     * @param navigator - Loaded navigator to query
-     * @param question - Question to ask
-     * @param options - Query options (enableSelfConfig, maxTurns)
-     * @returns Validated navigator response with answer and sources
-     * @throws {Error} If API call fails, response parsing fails, or validation fails
-     *
-     * @example
-     * ```typescript
-     * const response = await adapter.query(navigator, 'How do I deploy?');
-     * console.log(response.answer);
-     * console.log(`Confidence: ${response.confidence}`);
-     * console.log(`Sources: ${response.sources.map(s => s.filePath).join(', ')}`);
-     * ```
-     */
-    query(navigator: LoadedNavigator, question: string, options?: QueryOptions): Promise<NavigatorResponse>;
-    /**
-     * Internal method to execute the query
-     * Separated to allow for LangSmith tracing wrapper
-     *
-     * @internal
-     */
-    private executeQuery;
-    /**
-     * Update navigator documentation
-     *
-     * Sends an update message to Claude with write permissions enabled.
-     * Claude can edit files in the knowledge base to document progress,
-     * add troubleshooting steps, or update existing documentation.
-     *
-     * @param navigator - Loaded navigator to update
-     * @param message - Update message or report
-     * @param options - Query options (maxTurns)
-     * @returns Text response from Claude describing what was updated
-     * @throws {Error} If API call fails or update fails
-     *
-     * @example
-     * ```typescript
-     * const result = await adapter.update(
-     *   navigator,
-     *   'I completed feature X. Please document this in the knowledge base.'
-     * );
-     * console.log(result);
-     * ```
-     */
-    update(navigator: LoadedNavigator, message: string, options?: QueryOptions): Promise<string>;
-    /**
-     * Parse Claude's response into a NavigatorResponse
-     *
-     * Extracts JSON from the response text (either from code blocks or raw JSON)
-     * and validates it against the NavigatorResponseSchema.
-     *
-     * @param rawResponse - Raw text response from Claude
-     * @param query - Original query (used to populate missing query field)
-     * @returns Parsed and validated NavigatorResponse
-     * @throws {Error} If JSON cannot be extracted or schema validation fails
-     *
-     * @internal
-     */
-    parseResponse(rawResponse: string, query: string): NavigatorResponse;
-    /**
-     * Validate a NavigatorResponse
-     *
-     * Runs comprehensive validation including:
-     * - Source file existence checks
-     * - Hallucination pattern detection
-     * - Confidence level validation
-     *
-     * @param response - Navigator response to validate
-     * @param knowledgeBasePath - Path to knowledge base directory
-     * @returns Validation result with errors and warnings
-     *
-     * @internal
-     */
-    validate(response: NavigatorResponse, knowledgeBasePath: string): ValidationResult;
-}
-//# sourceMappingURL=claude-adapter.d.ts.map

package/dist/adapter/claude-adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"claude-adapter.d.ts","sourceRoot":"","sources":["../../src/adapter/claude-adapter.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,eAAe,EAEf,iBAAiB,EAKjB,KAAK,gBAAgB,EACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAuB,aAAa,EAA0B,MAAM,qBAAqB,CAAC;AAiDjG;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,eAAe,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAE/D;;;;OAIG;gBACS,OAAO,GAAE,oBAAyB;IAO9C;;;;;;;;;;;;;;;;;OAiBG;IACG,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAmHpE;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,KAAK,CACT,SAAS,EAAE,eAAe,EAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,iBAAiB,CAAC;IAwB7B;;;;;OAKG;YACW,YAAY;IAoN1B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,MAAM,CACV,SAAS,EAAE,eAAe,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,MAAM,CAAC;IAgFlB;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB;IAoCpE;;;;;;;;;;;;;OAaG;IACH,QAAQ,CACN,QAAQ,EAAE,iBAAiB,EAC3B,iBAAiB,EAAE,MAAM,GACxB,gBAAgB;CAGpB"}