@autonav/core 1.0.0

package/dist/templates/README.md.template

@@ -0,0 +1,174 @@
+# {{NAVIGATOR_NAME}}
+
+{{NAVIGATOR_DESCRIPTION}}
+
+## Setup
+
+This navigator was created using `@autonav/core`.
+
+### Directory Structure
+
+```
+{{NAVIGATOR_NAME}}/
+├── config.json          # Navigator configuration
+├── CLAUDE.md           # System prompt and grounding rules
+├── knowledge/          # Add your documentation here
+├── .claude/
+│   └── plugins.json   # Plugin configuration
+├── .gitignore
+└── README.md          # This file
+```
+
+## Adding Documentation
+
+1. Add your markdown files, text files, or documentation to the `knowledge/` directory
+2. Organize files in subdirectories as needed
+3. The navigator will search all files in this directory when answering questions
+
+Example structure:
+```
+knowledge/
+├── getting-started/
+│   └── quickstart.md
+├── deployment/
+│   ├── aws.md
+│   └── kubernetes.md
+└── troubleshooting/
+    └── common-issues.md
+```
+
+## Using the Navigator
+
+### Option 1: Interactive Mode (Recommended)
+
+The simplest way to use your navigator is with Claude Code directly:
+
+```bash
+cd {{NAVIGATOR_NAME}}
+claude
+```
+
+This opens an interactive session with your navigator's context already loaded. You can:
+- Have natural conversations
+- Ask follow-up questions
+- Let Claude search your docs
+
+The `CLAUDE.md` file tells Claude what this navigator knows about and how to behave.
+
+### Option 2: Programmatic Queries
+
+For scripts and automation, use structured queries:
+
+```bash
+npx @autonav/core query . "How do I deploy to production?"
+```
+
+Or from the parent directory:
+```bash
+npx @autonav/core query ./{{NAVIGATOR_NAME}} "Your question here"
+```
+
+## Response Format
+
+The navigator returns structured JSON responses:
+
+```json
+{
+  "protocolVersion": "1.0.0",
+  "query": "Your question",
+  "answer": "Detailed answer with citations",
+  "sources": [
+    {
+      "filePath": "path/to/source.md",
+      "excerpt": "Relevant quote",
+      "section": "Section name"
+    }
+  ],
+  "confidence": 0.95
+}
+```
+
+## Customization
+
+### Updating Instructions
+
+Edit `CLAUDE.md` to customize how the navigator behaves:
+- Add domain-specific rules
+- Include terminology definitions
+- Specify answer formatting preferences
+
+### Configuration
+
+Edit `config.json` to:
+- Update the navigator name or description
+- Change the knowledge base path
+- Add metadata fields
+
+## Security
+
+### Plugin Credentials
+
+**⚠️ IMPORTANT**: If you use plugins (`.claude/plugins.json`), be aware:
+
+1. **Credentials are stored in PLAIN TEXT** in `.claude/plugins.json`
+2. **NEVER commit** `.claude/plugins.json` to version control
+3. **Always add** `.claude/plugins.json` to your `.gitignore`
+4. **Recommended**: Use environment variables instead:
+   ```bash
+   export SLACK_TOKEN="xoxb-your-token"
+   export GITHUB_TOKEN="ghp_your-token"
+   ```
+5. **For production**: Use a secrets management system (AWS Secrets Manager, HashiCorp Vault, etc.)
+
+### File Watcher Plugin
+
+The file-watcher plugin has security restrictions:
+- Cannot watch system directories (`/etc`, `/sys`, `/proc`, `/root`, etc.)
+- Cannot watch sensitive user directories (`~/.ssh`, `~/.aws`, etc.)
+- Only watches project-specific directories you explicitly configure
+
+### GitHub/Slack Plugins
+
+All content posted to GitHub and Slack is automatically scanned for credentials to prevent accidental exposure. However:
+- Review all automated posts before enabling production use
+- Use webhook secrets where applicable
+- Limit plugin permissions to the minimum required
+
+## Best Practices
+
+1. **Keep docs updated**: The navigator is only as good as the knowledge base
+2. **Organize clearly**: Use directories and clear file names
+3. **Version control**: Commit both the navigator and knowledge base to git (but NOT `.claude/plugins.json`)
+4. **Review responses**: Check that citations are accurate and relevant
+5. **Security first**: Never commit credentials, use environment variables for tokens
+
+## Troubleshooting
+
+### Navigator can't find files
+
+- Ensure files are in the `knowledge/` directory
+- Check that file paths in responses match actual files
+- Verify the `knowledgeBase` in `config.json` is correct
+
+### Low confidence responses
+
+- Add more detailed documentation
+- Ensure docs cover the topic thoroughly
+- Check that docs are up to date
+
+### No answers to questions
+
+- Verify the knowledge base contains relevant information
+- Try rephrasing the question
+- Ensure Claude Code is authenticated (run `claude` to check)
+
+## Support
+
+For issues with the navigator framework:
+- GitHub: https://github.com/terraboops/autonav
+- Documentation: See the main project README
+
+---
+
+**Created**: {{CREATED_AT}}
+**Protocol Version**: 1.0.0

package/dist/templates/config-pack.json.template

@@ -0,0 +1,16 @@
+{
+  "version": "0.1.0",
+  "name": "{{NAVIGATOR_NAME}}",
+  "description": "{{NAVIGATOR_DESCRIPTION}}",
+  "created": "{{CREATED_AT}}",
+  "knowledgePack": {
+    "name": "{{PACK_NAME}}",
+    "version": "{{PACK_VERSION}}",
+    "installedAt": "{{CREATED_AT}}"
+  },
+  "knowledgeBase": "./knowledge",
+  "systemConfiguration": "./system-configuration.md",
+  "plugins": {
+    "configFile": "./.claude/plugins.json"
+  }
+}

package/dist/templates/config.json.template

@@ -0,0 +1,11 @@
+{
+  "version": "0.1.0",
+  "name": "{{NAVIGATOR_NAME}}",
+  "description": "{{NAVIGATOR_DESCRIPTION}}",
+  "created": "{{CREATED_AT}}",
+  "knowledgePack": null,
+  "knowledgeBase": "./knowledge",
+  "plugins": {
+    "configFile": "./.claude/plugins.json"
+  }
+}

package/dist/templates/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Template files available for scaffolding navigators
+ */
+export interface Templates {
+    claudeMd: string;
+    claudeMdPack: string;
+    configJson: string;
+    configJsonPack: string;
+    pluginsJson: string;
+    gitignore: string;
+    readme: string;
+    systemConfiguration: string;
+}
+/**
+ * Load all template files
+ */
+export declare function loadTemplates(): Templates;
+/**
+ * Replace template variables in a string
+ */
+export declare function replaceTemplateVars(template: string, vars: Record<string, string>): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,SAAS,CAmCzC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,MAAM,CAMR"}

package/dist/templates/index.js

@@ -0,0 +1,32 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+// Get the directory of this module
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Load all template files
+ */
+export function loadTemplates() {
+    return {
+        claudeMd: fs.readFileSync(path.join(__dirname, "CLAUDE.md.template"), "utf-8"),
+        claudeMdPack: fs.readFileSync(path.join(__dirname, "CLAUDE-pack.md.template"), "utf-8"),
+        configJson: fs.readFileSync(path.join(__dirname, "config.json.template"), "utf-8"),
+        configJsonPack: fs.readFileSync(path.join(__dirname, "config-pack.json.template"), "utf-8"),
+        pluginsJson: fs.readFileSync(path.join(__dirname, "plugins.json.template"), "utf-8"),
+        gitignore: fs.readFileSync(path.join(__dirname, ".gitignore.template"), "utf-8"),
+        readme: fs.readFileSync(path.join(__dirname, "README.md.template"), "utf-8"),
+        systemConfiguration: fs.readFileSync(path.join(__dirname, "system-configuration.md.template"), "utf-8"),
+    };
+}
+/**
+ * Replace template variables in a string
+ */
+export function replaceTemplateVars(template, vars) {
+    let result = template;
+    for (const [key, value] of Object.entries(vars)) {
+        result = result.replace(new RegExp(`{{${key}}}`, "g"), value);
+    }
+    return result;
+}
+//# sourceMappingURL=index.js.map

package/dist/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,mCAAmC;AACnC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAgB3C;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,QAAQ,EAAE,EAAE,CAAC,YAAY,CACvB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,EAC1C,OAAO,CACR;QACD,YAAY,EAAE,EAAE,CAAC,YAAY,CAC3B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,yBAAyB,CAAC,EAC/C,OAAO,CACR;QACD,UAAU,EAAE,EAAE,CAAC,YAAY,CACzB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC,EAC5C,OAAO,CACR;QACD,cAAc,EAAE,EAAE,CAAC,YAAY,CAC7B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,2BAA2B,CAAC,EACjD,OAAO,CACR;QACD,WAAW,EAAE,EAAE,CAAC,YAAY,CAC1B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,uBAAuB,CAAC,EAC7C,OAAO,CACR;QACD,SAAS,EAAE,EAAE,CAAC,YAAY,CACxB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,qBAAqB,CAAC,EAC3C,OAAO,CACR;QACD,MAAM,EAAE,EAAE,CAAC,YAAY,CACrB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,EAC1C,OAAO,CACR;QACD,mBAAmB,EAAE,EAAE,CAAC,YAAY,CAClC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,kCAAkC,CAAC,EACxD,OAAO,CACR;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,IAA4B;IAE5B,IAAI,MAAM,GAAG,QAAQ,CAAC;IACtB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/templates/plugins.json.template

@@ -0,0 +1,33 @@
+{
+  "_SECURITY_NOTICE": "WARNING: This file stores credentials in PLAIN TEXT. NEVER commit this file to version control. Use environment variables instead: SLACK_TOKEN, GITHUB_TOKEN. Add .claude/plugins.json to your .gitignore file. For production use, consider using a secrets management system.",
+  "file-watcher": {
+    "enabled": false,
+    "config": {
+      "paths": [],
+      "patterns": ["**/*.md"],
+      "ignorePatterns": ["**/node_modules/**", "**/.git/**", "**/dist/**"],
+      "pollInterval": 1000
+    }
+  },
+  "slack": {
+    "enabled": false,
+    "config": {
+      "token": "RECOMMENDED: Use process.env.SLACK_TOKEN instead of hardcoding here",
+      "channels": [],
+      "threadNotifications": true,
+      "summaryFrequency": "daily"
+    }
+  },
+  "github": {
+    "enabled": false,
+    "config": {
+      "token": "RECOMMENDED: Use process.env.GITHUB_TOKEN instead of hardcoding here",
+      "owner": "",
+      "repo": "",
+      "watchIssues": true,
+      "watchPullRequests": true,
+      "watchCommits": false,
+      "pollIntervalMinutes": 5
+    }
+  }
+}

package/dist/templates/system-configuration.md.template

@@ -0,0 +1,66 @@
+# System Configuration: {{PACK_NAME}}
+
+This is the system configuration file from the {{PACK_NAME}} knowledge pack.
+
+## Domain Description
+
+[Describe what this knowledge pack covers and what types of questions it can answer]
+
+## Knowledge Scope
+
+This navigator has knowledge about:
+- [Topic 1]
+- [Topic 2]
+- [Topic 3]
+
+This navigator does NOT have knowledge about:
+- [Out of scope topic 1]
+- [Out of scope topic 2]
+
+## Response Guidelines
+
+When answering questions:
+1. Always cite specific files from the `knowledge/` directory
+2. Use exact headings and section references
+3. If information isn't in the knowledge base, say so explicitly
+4. Provide confidence scores based on how well-grounded your answer is
+
+## Source Citation Format
+
+For every answer, include:
+- **Direct answer**: Clear, concise response to the question
+- **File references**: [filename.md: Section Heading]
+- **Excerpts**: Relevant quotes from the sources
+- **Confidence**: Score from 0.0 to 1.0
+
+## Response Structure
+
+Always respond with JSON following this structure:
+
+```json
+{
+  "protocolVersion": "0.1.0",
+  "query": "the question asked",
+  "answer": "detailed answer with inline citations",
+  "sources": [
+    {
+      "filePath": "relative/path/from/knowledge/file.md",
+      "excerpt": "exact quote from the file",
+      "section": "section heading"
+    }
+  ],
+  "confidence": 0.95
+}
+```
+
+## Confidence Scoring
+
+- **1.0**: Fully grounded in multiple authoritative sources, no ambiguity
+- **0.8-0.9**: Well grounded with clear sources, minor gaps acceptable
+- **0.6-0.7**: Partially grounded, some inference required
+- **0.4-0.5**: Weakly grounded, significant uncertainty
+- **0.0-0.3**: Not grounded in knowledge base, requires human review
+
+## Special Instructions
+
+[Add any pack-specific instructions, terminology definitions, or special handling here]

package/dist/tools/handler.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Tool Handler for Self-Configuration
+ *
+ * Processes tool calls from Claude and executes the corresponding actions.
+ */
+import { PluginManager } from "../plugins/index.js";
+import { type UpdatePluginConfigInput, type GetPluginConfigInput, type SelfConfigResult } from "./self-config.js";
+/**
+ * Handle the update_plugin_config tool call
+ */
+export declare function handleUpdatePluginConfig(input: UpdatePluginConfigInput, pluginManager: PluginManager | undefined, pluginsConfigPath: string): Promise<SelfConfigResult>;
+/**
+ * Handle the get_plugin_config tool call
+ */
+export declare function handleGetPluginConfig(input: GetPluginConfigInput, pluginsConfigPath: string): Promise<SelfConfigResult>;
+/**
+ * Process a tool call and return the result
+ */
+export declare function processToolCall(toolName: string, toolInput: Record<string, unknown>, pluginManager: PluginManager | undefined, pluginsConfigPath: string): Promise<SelfConfigResult>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/tools/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/tools/handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAA0B,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EAGtB,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,uBAAuB,EAC9B,aAAa,EAAE,aAAa,GAAG,SAAS,EACxC,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAuF3B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,oBAAoB,EAC3B,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,gBAAgB,CAAC,CA4D3B;AAkCD;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,aAAa,EAAE,aAAa,GAAG,SAAS,EACxC,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAoC3B"}

package/dist/tools/handler.js

@@ -0,0 +1,202 @@
+/**
+ * Tool Handler for Self-Configuration
+ *
+ * Processes tool calls from Claude and executes the corresponding actions.
+ */
+import * as fs from "node:fs";
+import { PluginConfigFileSchema } from "../plugins/index.js";
+import { CONFIGURABLE_PLUGINS, } from "./self-config.js";
+/**
+ * Handle the update_plugin_config tool call
+ */
+export async function handleUpdatePluginConfig(input, pluginManager, pluginsConfigPath) {
+    const { plugin, updates, reason } = input;
+    // Validate plugin name
+    if (!CONFIGURABLE_PLUGINS.includes(plugin)) {
+        return {
+            success: false,
+            message: `Unknown plugin: ${plugin}`,
+            plugin,
+            error: `Valid plugins are: ${CONFIGURABLE_PLUGINS.join(", ")}`,
+        };
+    }
+    // Check if plugins config file exists
+    if (!fs.existsSync(pluginsConfigPath)) {
+        return {
+            success: false,
+            message: `Plugin configuration file not found`,
+            plugin,
+            error: `Expected file at: ${pluginsConfigPath}`,
+        };
+    }
+    try {
+        // Read current config
+        const currentConfigContent = fs.readFileSync(pluginsConfigPath, "utf-8");
+        const currentConfig = PluginConfigFileSchema.parse(JSON.parse(currentConfigContent));
+        // Initialize plugin config if it doesn't exist
+        if (!currentConfig[plugin]) {
+            currentConfig[plugin] = {
+                enabled: false,
+                config: {},
+            };
+        }
+        // Merge updates into existing config
+        const existingPluginConfig = currentConfig[plugin].config || {};
+        const mergedConfig = {
+            ...existingPluginConfig,
+            ...updates,
+        };
+        // Update the config
+        currentConfig[plugin] = {
+            enabled: currentConfig[plugin].enabled,
+            config: mergedConfig,
+        };
+        // Write back to file
+        fs.writeFileSync(pluginsConfigPath, JSON.stringify(currentConfig, null, 2), "utf-8");
+        // If plugin manager exists and plugin is enabled, also update runtime config
+        if (pluginManager) {
+            const registeredPlugin = pluginManager.getPlugin(plugin);
+            if (registeredPlugin) {
+                try {
+                    await registeredPlugin.updateConfig(updates);
+                }
+                catch {
+                    // Plugin might not be initialized, that's okay
+                    // Config file was still updated
+                }
+            }
+        }
+        return {
+            success: true,
+            message: `Successfully updated ${plugin} configuration: ${reason}`,
+            plugin,
+            changes: updates,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            message: `Failed to update ${plugin} configuration`,
+            plugin,
+            error: errorMessage,
+        };
+    }
+}
+/**
+ * Handle the get_plugin_config tool call
+ */
+export async function handleGetPluginConfig(input, pluginsConfigPath) {
+    const { plugin } = input;
+    // Check if plugins config file exists
+    if (!fs.existsSync(pluginsConfigPath)) {
+        return {
+            success: false,
+            message: `Plugin configuration file not found`,
+            plugin,
+            error: `Expected file at: ${pluginsConfigPath}`,
+        };
+    }
+    try {
+        // Read current config
+        const currentConfigContent = fs.readFileSync(pluginsConfigPath, "utf-8");
+        const currentConfig = PluginConfigFileSchema.parse(JSON.parse(currentConfigContent));
+        if (plugin === "all") {
+            return {
+                success: true,
+                message: "Retrieved all plugin configurations",
+                plugin: "all",
+                changes: currentConfig,
+            };
+        }
+        // Validate plugin name
+        if (!CONFIGURABLE_PLUGINS.includes(plugin)) {
+            return {
+                success: false,
+                message: `Unknown plugin: ${plugin}`,
+                plugin,
+                error: `Valid plugins are: ${CONFIGURABLE_PLUGINS.join(", ")}`,
+            };
+        }
+        const pluginConfig = currentConfig[plugin] || {
+            enabled: false,
+            config: {},
+        };
+        return {
+            success: true,
+            message: `Retrieved ${plugin} configuration`,
+            plugin,
+            changes: pluginConfig,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            message: `Failed to read plugin configuration`,
+            plugin,
+            error: errorMessage,
+        };
+    }
+}
+/**
+ * Validate and parse update_plugin_config input
+ */
+function parseUpdatePluginConfigInput(input) {
+    const plugin = input.plugin;
+    const updates = input.updates;
+    const reason = input.reason;
+    if (!plugin || !updates || !reason) {
+        return null;
+    }
+    return { plugin, updates, reason };
+}
+/**
+ * Validate and parse get_plugin_config input
+ */
+function parseGetPluginConfigInput(input) {
+    const plugin = input.plugin;
+    if (!plugin) {
+        return null;
+    }
+    return { plugin };
+}
+/**
+ * Process a tool call and return the result
+ */
+export async function processToolCall(toolName, toolInput, pluginManager, pluginsConfigPath) {
+    switch (toolName) {
+        case "update_plugin_config": {
+            const parsed = parseUpdatePluginConfigInput(toolInput);
+            if (!parsed) {
+                return {
+                    success: false,
+                    message: "Invalid input for update_plugin_config",
+                    plugin: "unknown",
+                    error: "Missing required fields: plugin, updates, reason",
+                };
+            }
+            return handleUpdatePluginConfig(parsed, pluginManager, pluginsConfigPath);
+        }
+        case "get_plugin_config": {
+            const parsed = parseGetPluginConfigInput(toolInput);
+            if (!parsed) {
+                return {
+                    success: false,
+                    message: "Invalid input for get_plugin_config",
+                    plugin: "unknown",
+                    error: "Missing required field: plugin",
+                };
+            }
+            return handleGetPluginConfig(parsed, pluginsConfigPath);
+        }
+        default:
+            return {
+                success: false,
+                message: `Unknown tool: ${toolName}`,
+                plugin: "unknown",
+                error: `Tool "${toolName}" is not recognized`,
+            };
+    }
+}
+//# sourceMappingURL=handler.js.map

package/dist/tools/handler.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Tools Module
+ *
+ * Exports tool definitions and handlers for navigator capabilities.
+ * Tools use MCP format for integration with Claude Agent SDK.
+ */
+export { createSelfConfigMcpServer, CONFIGURABLE_PLUGINS, type ConfigurablePlugin, type UpdatePluginConfigInput, type GetPluginConfigInput, type SelfConfigResult, } from "./self-config.js";
+export { handleUpdatePluginConfig, handleGetPluginConfig, processToolCall, } from "./handler.js";
+export { createResponseMcpServer, SUBMIT_ANSWER_TOOL, type SubmitAnswerResult, } from "./response.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,10 @@
+/**
+ * Tools Module
+ *
+ * Exports tool definitions and handlers for navigator capabilities.
+ * Tools use MCP format for integration with Claude Agent SDK.
+ */
+export { createSelfConfigMcpServer, CONFIGURABLE_PLUGINS, } from "./self-config.js";
+export { handleUpdatePluginConfig, handleGetPluginConfig, processToolCall, } from "./handler.js";
+export { createResponseMcpServer, SUBMIT_ANSWER_TOOL, } from "./response.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,yBAAyB,EACzB,oBAAoB,GAKrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,uBAAuB,EACvB,kBAAkB,GAEnB,MAAM,eAAe,CAAC"}

package/dist/tools/response.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Response Tools for Autonav Navigators
+ *
+ * These tools allow navigators to submit structured responses
+ * using Zod-validated schemas, providing the benefits of
+ * Claude's Structured Outputs through tool use.
+ *
+ * Uses MCP format for integration with Claude Agent SDK.
+ */
+/**
+ * Result type returned when submit_answer tool is called
+ */
+export interface SubmitAnswerResult {
+    success: boolean;
+    message: string;
+}
+/**
+ * Create an MCP server with response tools
+ *
+ * The submit_answer tool allows Claude to submit structured responses
+ * that are validated against the NavigatorResponse schema.
+ * This achieves the same result as Claude's Structured Outputs
+ * but works within the Claude Agent SDK's tool use flow.
+ */
+export declare function createResponseMcpServer(): import("@anthropic-ai/claude-agent-sdk").McpSdkServerConfigWithInstance;
+/**
+ * Tool name constant for detection in ClaudeAdapter
+ */
+export declare const SUBMIT_ANSWER_TOOL = "submit_answer";
+//# sourceMappingURL=response.d.ts.map

package/dist/tools/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/tools/response.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,4EAyDtC;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,kBAAkB,CAAC"}