@autonav/core 1.0.0

package/dist/cli/nav-query.js

@@ -0,0 +1,217 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import { ClaudeAdapter } from "../adapter/index.js";
+import { loadNavigator, validateResponse, formatResponse, formatErrorMessage, formatWarningMessage, formatSuggestion, NavigatorLoadError, } from "../query-engine/index.js";
+/**
+ * Parse a human-readable duration string into milliseconds
+ * Supports formats: "30s", "1m", "1m30s", "90", "90000" (plain ms)
+ * Max timeout: 10 minutes (600000ms) to prevent overflow issues
+ */
+function parseDuration(input) {
+    const MAX_TIMEOUT_MS = 600000; // 10 minutes
+    // Try plain number first (milliseconds)
+    const plainNumber = Number(input);
+    if (!isNaN(plainNumber) && Number.isFinite(plainNumber)) {
+        const ms = Math.floor(plainNumber);
+        if (ms <= 0) {
+            throw new Error("Timeout must be positive");
+        }
+        return Math.min(ms, MAX_TIMEOUT_MS);
+    }
+    // Parse human-readable format: 1m30s, 30s, 2m, etc.
+    const pattern = /^(?:(\d+)m)?(?:(\d+)s)?$/i;
+    const match = input.trim().match(pattern);
+    if (!match || (!match[1] && !match[2])) {
+        throw new Error(`Invalid duration format: "${input}". Use formats like: 30s, 1m, 1m30s, or milliseconds`);
+    }
+    const minutes = match[1] ? parseInt(match[1], 10) : 0;
+    const seconds = match[2] ? parseInt(match[2], 10) : 0;
+    // Calculate total milliseconds with overflow protection
+    const totalMs = (minutes * 60 + seconds) * 1000;
+    if (totalMs <= 0) {
+        throw new Error("Timeout must be positive");
+    }
+    if (totalMs > MAX_TIMEOUT_MS) {
+        console.error(`Warning: Timeout capped at 10 minutes (was ${input})`);
+        return MAX_TIMEOUT_MS;
+    }
+    return totalMs;
+}
+/**
+ * Main CLI program
+ */
+const program = new Command();
+program
+    .name("autonav query")
+    .description("Query a Platform AI navigator")
+    .version("1.0.0")
+    .argument("<navigator>", "Path to the navigator directory")
+    .argument("<question>", "Question to ask the navigator")
+    .option("--compact", "Compact output (answer + minimal sources)")
+    .option("--json", "Raw JSON output")
+    .option("--no-color", "Disable colored output")
+    .option("--validate", "Enable strict source validation (fail on missing sources)")
+    .option("--confidence <level>", "Minimum acceptable confidence (high|medium|low)")
+    .option("--timeout <duration>", "Query timeout (e.g., 30s, 1m, 1m30s, or milliseconds)", parseDuration, 30000)
+    .option("--verbose", "Show additional debug information")
+    .action(async (navigator, question, options) => {
+    await executeQuery(navigator, question, options);
+});
+/**
+ * Execute the query command
+ */
+async function executeQuery(navigatorPath, question, options) {
+    // Disable chalk if noColor is set
+    if (options.noColor) {
+        chalk.level = 0;
+    }
+    // Note: No API key check needed - Claude Agent SDK uses Claude Code's OAuth
+    // Validate confidence level option
+    if (options.confidence) {
+        const validLevels = ["high", "medium", "low"];
+        if (!validLevels.includes(options.confidence)) {
+            console.error(formatErrorMessage(`Invalid confidence level: ${options.confidence}. Must be one of: ${validLevels.join(", ")}`));
+            process.exit(1);
+        }
+    }
+    let spinner;
+    try {
+        // Determine output format
+        const format = options.json
+            ? "json"
+            : options.compact
+                ? "compact"
+                : "pretty";
+        // Show loading spinner (only in non-JSON mode)
+        if (format !== "json") {
+            spinner = ora("Loading navigator...").start();
+        }
+        // Load navigator (sync, from query-engine)
+        const navigator = loadNavigator(navigatorPath);
+        if (spinner) {
+            spinner.succeed(`Loaded: ${chalk.bold(navigator.config.name)}`);
+            if (options.verbose) {
+                console.error(chalk.dim(`Knowledge base: ${navigator.knowledgeBasePath}`));
+            }
+            console.error(""); // Blank line
+        }
+        // Show question (only in non-JSON mode)
+        if (format !== "json") {
+            console.error(chalk.blue("❓") + " Question: " + chalk.italic(question));
+            console.error(""); // Blank line
+            spinner = ora("Querying Claude...").start();
+        }
+        // Initialize adapter
+        const adapter = new ClaudeAdapter();
+        // Execute query with timeout
+        const queryPromise = adapter.query(navigator, question);
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => {
+                reject(new Error(`Query timed out after ${options.timeout}ms`));
+            }, options.timeout);
+        });
+        const response = await Promise.race([queryPromise, timeoutPromise]);
+        if (spinner) {
+            spinner.succeed("Query completed");
+            console.error(""); // Blank line
+        }
+        // Validate response (extended validation from query-engine)
+        const validation = validateResponse(response, {
+            minimumConfidence: options.confidence,
+            strictSourceValidation: options.validate,
+            knowledgeBasePath: navigator.knowledgeBasePath,
+        });
+        // Show warnings (only in non-JSON mode)
+        if (format !== "json" && validation.warnings.length > 0) {
+            for (const warning of validation.warnings) {
+                console.error(formatWarningMessage(warning));
+            }
+            console.error(""); // Blank line
+        }
+        // Check if validation failed
+        if (!validation.valid) {
+            if (format !== "json") {
+                console.error(chalk.red.bold("Validation Failed:"));
+                console.error("");
+                for (const error of validation.errors) {
+                    console.error(formatErrorMessage(error.message));
+                }
+                console.error("");
+                // Provide helpful suggestions
+                if (options.confidence && !validation.confidenceMet) {
+                    console.error(formatSuggestion("Try:", [
+                        "Rephrase the question more specifically",
+                        "Check if knowledge base covers this topic",
+                        `Accept ${validation.confidenceLevel || "lower"} confidence: remove --confidence flag`,
+                    ]));
+                }
+            }
+            process.exit(1);
+        }
+        // Format and output response
+        const formattedOutput = formatResponse(response, {
+            format,
+            noColor: options.noColor,
+            verbose: options.verbose,
+        });
+        console.log(formattedOutput);
+        // Success message (only in non-JSON mode)
+        if (format !== "json") {
+            console.error(""); // Blank line
+            console.error(chalk.green("✅") +
+                ` Query completed successfully! (${response.sources.length} source${response.sources.length !== 1 ? "s" : ""} cited)`);
+        }
+    }
+    catch (error) {
+        if (spinner) {
+            spinner.fail("Query failed");
+            console.error(""); // Blank line
+        }
+        // Handle different error types
+        if (error instanceof NavigatorLoadError) {
+            console.error(formatErrorMessage(error.message));
+            console.error("");
+            // Show helpful suggestions based on error context
+            if (error.context?.suggestions) {
+                const suggestions = error.context.suggestions;
+                if (suggestions.length > 0) {
+                    console.error(chalk.bold("Did you mean?"));
+                    for (const suggestion of suggestions) {
+                        console.error(chalk.dim(`  ./${suggestion}`));
+                    }
+                    console.error("");
+                }
+            }
+            if (error.context?.suggestion) {
+                console.error(chalk.dim(error.context.suggestion));
+                console.error("");
+            }
+            if (error.context?.missingFile === "config.json") {
+                console.error(formatSuggestion("Create a new navigator:", [
+                    "autonav init <navigator-name>",
+                ]));
+            }
+        }
+        else if (error instanceof Error) {
+            console.error(formatErrorMessage(error.message));
+            // Timeout error suggestions
+            if (error.message.includes("timed out")) {
+                console.error("");
+                console.error(formatSuggestion("Try:", [
+                    `Increase timeout: autonav query "${navigatorPath}" "${question}" --timeout 1m`,
+                    "Simplify the question",
+                    "Check knowledge base size",
+                ]));
+            }
+        }
+        else {
+            console.error(formatErrorMessage(String(error)));
+        }
+        process.exit(1);
+    }
+}
+// Parse and execute
+program.parse(process.argv);
+//# sourceMappingURL=nav-query.js.map

package/dist/cli/nav-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-query.js","sourceRoot":"","sources":["../../src/cli/nav-query.ts"],"names":[],"mappings":"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"}

package/dist/conversation/App.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Ink-based TUI for interactive navigator conversation
+ *
+ * Uses Claude Agent SDK for authentication (leverages Claude Code's OAuth)
+ */
+interface ConversationAppProps {
+    navigatorName: string;
+    navigatorPath: string;
+    navigatorSystemPrompt: string;
+    knowledgeBasePath: string;
+}
+export declare function ConversationApp({ navigatorName, navigatorPath, navigatorSystemPrompt, knowledgeBasePath, }: ConversationAppProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=App.d.ts.map

package/dist/conversation/App.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../src/conversation/App.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AA8BH,UAAU,oBAAoB;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,eAAe,CAAC,EAC9B,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,iBAAiB,GAClB,EAAE,oBAAoB,2CAkUtB"}

package/dist/conversation/App.js

@@ -0,0 +1,229 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Ink-based TUI for interactive navigator conversation
+ *
+ * Uses Claude Agent SDK for authentication (leverages Claude Code's OAuth)
+ */
+import { useState, useEffect, useCallback, useRef } from "react";
+import { Box, Text, useApp, useInput } from "ink";
+import TextInput from "ink-text-input";
+import { query } from "@anthropic-ai/claude-agent-sdk";
+import { buildConversationSystemPrompt } from "./prompts.js";
+// Check if debug mode is enabled
+const DEBUG = process.env.AUTONAV_DEBUG === "1" || process.env.DEBUG === "1";
+// Model to use for conversation
+const CONVERSATION_MODEL = "claude-sonnet-4-5";
+function debugLog(...args) {
+    if (DEBUG) {
+        console.error("[DEBUG]", ...args);
+    }
+}
+export function ConversationApp({ navigatorName, navigatorPath, navigatorSystemPrompt, knowledgeBasePath, }) {
+    const [messages, setMessages] = useState([]);
+    const [input, setInput] = useState("");
+    const [isLoading, setIsLoading] = useState(false);
+    const [activity, setActivity] = useState(null);
+    const [error, setError] = useState(null);
+    const queryRef = useRef(null);
+    const { exit } = useApp();
+    // Helper to determine activity type from tool name
+    const getActivityFromTool = (toolName) => {
+        const name = toolName.toLowerCase();
+        if (name.includes("read") || name === "cat") {
+            return { type: "reading", detail: toolName };
+        }
+        if (name.includes("write") || name.includes("edit")) {
+            return { type: "writing", detail: toolName };
+        }
+        if (name.includes("grep") || name.includes("glob") || name.includes("search") || name.includes("find")) {
+            return { type: "searching", detail: toolName };
+        }
+        return { type: "tool", detail: toolName };
+    };
+    // Format activity for display
+    const formatActivity = (act) => {
+        switch (act.type) {
+            case "thinking":
+                return "Thinking...";
+            case "reading":
+                return `Reading ${act.detail || "file"}...`;
+            case "writing":
+                return `Writing ${act.detail || "file"}...`;
+            case "searching":
+                return `Searching ${act.detail || ""}...`;
+            case "tool":
+                return `Running ${act.detail || "tool"}...`;
+            default:
+                return "Working...";
+        }
+    };
+    // Build the full system prompt
+    const systemPrompt = buildConversationSystemPrompt(navigatorName, navigatorSystemPrompt, knowledgeBasePath);
+    // Process messages from Claude
+    const processResponse = useCallback(async () => {
+        const queryInstance = queryRef.current;
+        if (!queryInstance)
+            return;
+        try {
+            debugLog("Waiting for Claude response...");
+            setActivity({ type: "thinking" });
+            for await (const message of queryInstance) {
+                debugLog("Received message type:", message.type);
+                if (message.type === "assistant") {
+                    // Extract text content and tool use from the assistant message
+                    const content = message.message.content;
+                    // Check for tool use blocks first
+                    const toolUseBlocks = content.filter((b) => b.type === "tool_use");
+                    // Update activity based on tool calls
+                    for (const toolBlock of toolUseBlocks) {
+                        const toolActivity = getActivityFromTool(toolBlock.name);
+                        setActivity(toolActivity);
+                        // Add activity message to show what's happening
+                        setMessages((prev) => [
+                            ...prev,
+                            { role: "activity", content: `⚙️ ${toolBlock.name}` },
+                        ]);
+                    }
+                    // Extract text content
+                    const textBlocks = content.filter((b) => b.type === "text");
+                    const text = textBlocks.map((b) => b.text).join("\n");
+                    if (text) {
+                        setActivity({ type: "thinking" });
+                        setMessages((prev) => [
+                            ...prev,
+                            { role: "assistant", content: text },
+                        ]);
+                    }
+                }
+                else if (message.type === "tool_progress") {
+                    // Tool execution happening
+                    debugLog("Tool progress:", message);
+                    // The tool_progress event has a tool_name property
+                    const toolName = message.tool_name;
+                    if (toolName) {
+                        setActivity(getActivityFromTool(toolName));
+                    }
+                }
+                else if (message.type === "result") {
+                    debugLog("Result received:", message.subtype);
+                    break;
+                }
+            }
+            setActivity(null);
+            setIsLoading(false);
+        }
+        catch (err) {
+            debugLog("Error processing response:", err);
+            setError(err instanceof Error ? err.message : "Error communicating with Claude");
+            setActivity(null);
+            setIsLoading(false);
+        }
+    }, [getActivityFromTool]);
+    // Send initial greeting
+    useEffect(() => {
+        setMessages([
+            {
+                role: "system",
+                content: `Connected to ${navigatorName}. Type /help for commands, or start chatting.`,
+            },
+        ]);
+    }, [navigatorName]);
+    // Handle special commands
+    const handleCommand = useCallback((command) => {
+        const cmd = command.toLowerCase().trim();
+        if (cmd === "/help") {
+            setMessages((prev) => [
+                ...prev,
+                {
+                    role: "system",
+                    content: `Available commands:
+  /help    - Show this help message
+  /status  - Show navigator status
+  /clear   - Clear conversation history
+  /exit    - Exit conversation mode
+
+Or just type naturally to chat with your navigator.`,
+                },
+            ]);
+            return true;
+        }
+        if (cmd === "/status") {
+            setMessages((prev) => [
+                ...prev,
+                {
+                    role: "system",
+                    content: `Navigator: ${navigatorName}
+Path: ${navigatorPath}
+Knowledge Base: ${knowledgeBasePath}
+Model: ${CONVERSATION_MODEL}`,
+                },
+            ]);
+            return true;
+        }
+        if (cmd === "/clear") {
+            setMessages([
+                {
+                    role: "system",
+                    content: "Conversation cleared. Start fresh!",
+                },
+            ]);
+            return true;
+        }
+        if (cmd === "/exit") {
+            exit();
+            return true;
+        }
+        return false;
+    }, [navigatorName, navigatorPath, knowledgeBasePath, exit]);
+    // Handle user input submission
+    const handleSubmit = useCallback(async (value) => {
+        if (!value.trim() || isLoading)
+            return;
+        setInput("");
+        // Check for commands
+        if (value.startsWith("/")) {
+            if (handleCommand(value)) {
+                return;
+            }
+        }
+        // Add user message to history
+        setMessages((prev) => [...prev, { role: "user", content: value }]);
+        setIsLoading(true);
+        setError(null);
+        try {
+            debugLog("Sending user message:", value);
+            // Build conversation history for context
+            const conversationHistory = messages
+                .filter((m) => m.role !== "system")
+                .map((m) => `${m.role === "user" ? "User" : "Assistant"}: ${m.content}`)
+                .join("\n\n");
+            const fullPrompt = conversationHistory
+                ? `${conversationHistory}\n\nUser: ${value}`
+                : value;
+            const queryInstance = query({
+                prompt: fullPrompt,
+                options: {
+                    model: CONVERSATION_MODEL,
+                    systemPrompt,
+                    permissionMode: "acceptEdits", // Allow file operations
+                    cwd: navigatorPath, // Set working directory to navigator
+                },
+            });
+            queryRef.current = queryInstance;
+            await processResponse();
+        }
+        catch (err) {
+            debugLog("Error sending message:", err);
+            setError(err instanceof Error ? err.message : "Failed to send message");
+            setIsLoading(false);
+        }
+    }, [isLoading, messages, systemPrompt, navigatorPath, handleCommand, processResponse]);
+    // Handle Ctrl+C or Ctrl+D to exit
+    useInput((input, key) => {
+        if (key.ctrl && (input === "c" || input === "d")) {
+            exit();
+        }
+    });
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsxs(Text, { bold: true, color: "cyan", children: ["\uD83D\uDCAC ", navigatorName] }), _jsx(Text, { color: "gray", children: " - conversation mode" })] }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "gray", children: "Type /help for commands. Press Ctrl+C or Ctrl+D to exit." }) }), messages.map((msg, i) => (_jsx(Box, { marginBottom: 1, flexDirection: "column", children: msg.role === "user" ? (_jsxs(Box, { children: [_jsx(Text, { color: "green", children: "you › " }), _jsx(Text, { children: msg.content })] })) : msg.role === "assistant" ? (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: "blue", children: [navigatorName, ":"] }), _jsx(Box, { marginLeft: 2, children: _jsx(Text, { children: msg.content }) })] })) : msg.role === "activity" ? (_jsx(Box, { children: _jsx(Text, { color: "yellow", dimColor: true, children: msg.content }) })) : (_jsx(Box, { children: _jsx(Text, { color: "gray", dimColor: true, children: msg.content }) })) }, i))), error && (_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { color: "red", children: ["Error: ", error] }) })), isLoading && activity && (_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "cyan", children: formatActivity(activity) }) })), !isLoading && (_jsxs(Box, { children: [_jsx(Text, { color: "green", children: "you › " }), _jsx(TextInput, { value: input, onChange: setInput, onSubmit: handleSubmit, placeholder: "Type a message..." })] }))] }));
+}
+//# sourceMappingURL=App.js.map

package/dist/conversation/App.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"App.js","sourceRoot":"","sources":["../../src/conversation/App.tsx"],"names":[],"mappings":"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"}

package/dist/conversation/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Conversation module for interactive nav management
+ *
+ * Exports the runConversationTUI function which launches an Ink-based
+ * conversational interface for managing navigators.
+ */
+export { buildConversationSystemPrompt } from "./prompts.js";
+/**
+ * Check if the current environment supports interactive TTY input
+ */
+export declare function isInteractiveTerminal(): boolean;
+/**
+ * Options for running the conversation TUI
+ */
+export interface ConversationOptions {
+    navigatorName: string;
+    navigatorPath: string;
+    navigatorSystemPrompt: string;
+    knowledgeBasePath: string;
+}
+/**
+ * Run the interactive conversation TUI
+ *
+ * @param options - Navigator configuration for the conversation
+ * @returns Promise that resolves when conversation ends
+ * @throws Error if terminal doesn't support interactive mode
+ */
+export declare function runConversationTUI(options: ConversationOptions): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/conversation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conversation/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAE7D;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAM/C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB9E"}

package/dist/conversation/index.js

@@ -0,0 +1,44 @@
+/**
+ * Conversation module for interactive nav management
+ *
+ * Exports the runConversationTUI function which launches an Ink-based
+ * conversational interface for managing navigators.
+ */
+import React from "react";
+import { render } from "ink";
+import { ConversationApp } from "./App.js";
+export { buildConversationSystemPrompt } from "./prompts.js";
+/**
+ * Check if the current environment supports interactive TTY input
+ */
+export function isInteractiveTerminal() {
+    return Boolean(process.stdin.isTTY &&
+        process.stdout.isTTY &&
+        process.stdin.setRawMode);
+}
+/**
+ * Run the interactive conversation TUI
+ *
+ * @param options - Navigator configuration for the conversation
+ * @returns Promise that resolves when conversation ends
+ * @throws Error if terminal doesn't support interactive mode
+ */
+export function runConversationTUI(options) {
+    // Check for TTY support before attempting to render
+    if (!isInteractiveTerminal()) {
+        return Promise.reject(new Error("Interactive conversation requires a TTY terminal."));
+    }
+    return new Promise((resolve, reject) => {
+        try {
+            const instance = render(React.createElement(ConversationApp, options));
+            // Wait for the app to exit
+            instance.waitUntilExit().then(() => {
+                resolve();
+            });
+        }
+        catch (err) {
+            reject(err);
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/conversation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/conversation/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAE7D;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,OAAO,CACZ,OAAO,CAAC,KAAK,CAAC,KAAK;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK;QACpB,OAAO,CAAC,KAAK,CAAC,UAAU,CACzB,CAAC;AACJ,CAAC;AAYD;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC7D,oDAAoD;IACpD,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAC7B,mDAAmD,CACpD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,CACrB,KAAK,CAAC,aAAa,CAAC,eAAe,EAAE,OAAO,CAAC,CAC9C,CAAC;YAEF,2BAA2B;YAC3B,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;gBACjC,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/conversation/prompts.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Conversation prompts for interactive nav management
+ */
+/**
+ * Build a system prompt for conversation mode
+ * Incorporates the navigator's own CLAUDE.md plus conversation-specific guidance
+ */
+export declare function buildConversationSystemPrompt(navigatorName: string, navigatorSystemPrompt: string, knowledgeBasePath: string): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/conversation/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/conversation/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,MAAM,EACrB,qBAAqB,EAAE,MAAM,EAC7B,iBAAiB,EAAE,MAAM,GACxB,MAAM,CAsCR"}

package/dist/conversation/prompts.js

@@ -0,0 +1,47 @@
+/**
+ * Conversation prompts for interactive nav management
+ */
+/**
+ * Build a system prompt for conversation mode
+ * Incorporates the navigator's own CLAUDE.md plus conversation-specific guidance
+ */
+export function buildConversationSystemPrompt(navigatorName, navigatorSystemPrompt, knowledgeBasePath) {
+    return `${navigatorSystemPrompt}
+
+---
+
+## Conversation Mode
+
+You are now in **conversation mode** with the user. This is an interactive session where you can help the user manage and evolve this navigator.
+
+### What You Can Do
+
+1. **Answer questions** about the knowledge base
+2. **Reorganize knowledge** - suggest or make changes to how information is structured
+3. **Add new knowledge** - help capture new information into the knowledge base
+4. **Update configuration** - modify settings, plugin configs, or behavior rules
+5. **Explain your capabilities** - help the user understand what this navigator can do
+
+### Navigator Context
+
+- **Name**: ${navigatorName}
+- **Knowledge Base**: ${knowledgeBasePath}
+
+### Guidelines
+
+- Be conversational and helpful
+- When making changes to files, explain what you're doing
+- For significant reorganizations, describe the plan before executing
+- You have access to the navigator's knowledge base and can read/write files there
+- Ask clarifying questions when requests are ambiguous
+
+### Special Commands
+
+The user can type these at any time:
+- \`/help\` - Show available commands
+- \`/status\` - Show current navigator state
+- \`/exit\` or Ctrl+C - End the conversation
+
+Remember: You are this navigator. Help the user make it better.`;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/conversation/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/conversation/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAC3C,aAAqB,EACrB,qBAA6B,EAC7B,iBAAyB;IAEzB,OAAO,GAAG,qBAAqB;;;;;;;;;;;;;;;;;;cAkBnB,aAAa;wBACH,iBAAiB;;;;;;;;;;;;;;;;;gEAiBuB,CAAC;AACjE,CAAC"}