@vfarcic/dot-ai 0.105.0 → 0.107.0

package/README.md

@@ -22,10 +22,13 @@ DevOps AI Toolkit is an AI-powered development productivity platform that enhanc
 - **SRE Teams**: Automate root cause analysis and generate executable remediation commands
 - **Support Teams**: Handle incident response with AI-guided investigation and repair workflows
 
+<!--
 ### Platform Building
+DEVELOPER NOTE: This tool is under active development with incomplete functionality. Not recommended for production use.
 - **Platform Engineers**: Install and configure platform tools conversationally without memorizing script paths and commands
 - **New Team Members**: Build platform infrastructure through zero-knowledge guided workflows
 - **DevOps Teams**: Create and manage Kubernetes clusters through natural language interactions
+-->
 
 ### Documentation Testing  
 - **Documentation Maintainers**: Automatically validate documentation accuracy and catch outdated content
@@ -84,7 +87,9 @@ Result: Finds sqls.devopstoolkit.live as perfect match ✨
 
 📖 [Learn more →](./docs/mcp-remediate-guide.md)
 
+<!--
 ### Platform Building
+DEVELOPER NOTE: This tool is under active development with incomplete functionality. Not recommended for production use.
 🗣️ **Natural Language Operations**: Install tools and create clusters through conversation without memorizing commands
 🔍 **Dynamic Discovery**: Automatically discovers 21+ available platform operations from infrastructure scripts
 🤖 **AI-Powered Intent Mapping**: Understands variations like "Install Argo CD", "Set up ArgoCD", "Deploy Argo CD"
@@ -92,6 +97,7 @@ Result: Finds sqls.devopstoolkit.live as perfect match ✨
 🎯 **Zero-Knowledge Onboarding**: New users successfully build platforms without documentation
 
 📖 [Learn more →](./docs/mcp-build-platform-guide.md)
+-->
 
 ### Documentation Testing & Validation
 📖 **Automated Testing**: Validates documentation by executing commands and testing examples  

package/dist/core/ai-provider.interface.d.ts

@@ -68,6 +68,66 @@ export interface AIProviderConfig {
     /** Enable debug mode for logging AI interactions */
     debugMode?: boolean;
 }
+/**
+ * Tool definition for AI providers
+ * Defines a tool that the AI can call during agentic loops
+ */
+export interface AITool {
+    /** Unique tool name (e.g., 'kubectl_get', 'search_capabilities') */
+    name: string;
+    /** Human-readable description of what the tool does and when to use it */
+    description: string;
+    /** JSON schema for tool input parameters */
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, any>;
+        required?: string[];
+    };
+}
+/**
+ * Tool executor function type
+ * Called by the provider when AI requests a tool execution
+ */
+export type ToolExecutor = (toolName: string, input: any) => Promise<any>;
+/**
+ * Configuration for agentic tool loop
+ */
+export interface ToolLoopConfig {
+    /** System prompt with context and strategic guidance */
+    systemPrompt: string;
+    /** User message/query to respond to */
+    userMessage: string;
+    /** Available tools for this workflow (scoped to workflow needs) */
+    tools: AITool[];
+    /** Function to execute tool calls */
+    toolExecutor: ToolExecutor;
+    /** Maximum number of AI iterations (default: 20) */
+    maxIterations?: number;
+    /** Optional callback invoked after each iteration */
+    onIteration?: (iteration: number, toolCalls: any[]) => void;
+    /** Optional operation identifier for metrics and debugging */
+    operation?: string;
+}
+/**
+ * Result from agentic tool loop
+ */
+export interface AgenticResult {
+    /** Final text response from AI after completing tool loop */
+    finalMessage: string;
+    /** Number of iterations executed */
+    iterations: number;
+    /** All tool calls executed during the loop */
+    toolCallsExecuted: Array<{
+        tool: string;
+        input: any;
+        output: any;
+    }>;
+    /** Token usage statistics */
+    totalTokens: {
+        input: number;
+        output: number;
+    };
+}
 /**
  * AI Provider Interface
  *
@@ -112,5 +172,37 @@ export interface AIProvider {
      * @returns Provider identifier (e.g., 'anthropic', 'openai', 'google')
      */
     getProviderType(): string;
+    /**
+     * Execute agentic loop with tool calling (NEW - PRD #136)
+     *
+     * AI autonomously decides which tools to call and when to stop.
+     * Supports multi-turn conversations with tool execution.
+     *
+     * NOTE: Currently NOT USED in codebase. PRD #136 analysis showed JSON-based loops
+     * achieve same goals without SDK overhead. Kept for potential future use.
+     *
+     * IMPLEMENTATION STATUS:
+     * - AnthropicProvider: ✅ Implemented
+     * - VercelAIProvider: ❌ Not implemented (not needed for current workflows)
+     *
+     * @param config Tool loop configuration with system prompt, tools, and executor
+     * @returns Agentic result with final message, iterations, tool calls, and token usage
+     */
+    toolLoop(config: ToolLoopConfig): Promise<AgenticResult>;
+    /**
+     * Single-shot message with tool calling enabled (NEW - PRD #136)
+     *
+     * AI can call tools, but only processes one round.
+     * Useful for simple tool use cases that don't require iteration.
+     *
+     * @param message The message/prompt to send
+     * @param tools Available tools for this request
+     * @param toolExecutor Function to execute tool calls
+     * @param operation Optional operation identifier for debugging
+     * @returns AI response with content, usage, and any tool calls made
+     */
+    sendMessageWithTools(message: string, tools: AITool[], toolExecutor: ToolExecutor, operation?: string): Promise<AIResponse & {
+        toolCalls?: any[];
+    }>;
 }
 //# sourceMappingURL=ai-provider.interface.d.ts.map

package/dist/core/ai-provider.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-provider.interface.d.ts","sourceRoot":"","sources":["../../src/core/ai-provider.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,0BAA0B,GAC1B,uBAAuB,GACvB,0BAA0B,GAC1B,qBAAqB,GACrB,0BAA0B,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,0BAA0B,EAAE,wBAAwB,EAAE,CAAC;IACvD,iBAAiB,EAAE;QACjB,oBAAoB,EAAE,WAAW,CAAC;QAClC,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,aAAa,EAAE;QACb,kBAAkB,EAAE,MAAM,CAAC;QAC3B,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IAEf,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IAEjB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;;;;;;OAUG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEtE;;;;;;OAMG;IACH,aAAa,IAAI,OAAO,CAAC;IAEzB;;;;;;;OAOG;IACH,eAAe,IAAI,MAAM,CAAC;IAE1B;;;;;;OAMG;IACH,eAAe,IAAI,MAAM,CAAC;CAC3B"}
+{"version":3,"file":"ai-provider.interface.d.ts","sourceRoot":"","sources":["../../src/core/ai-provider.interface.ts"],"names":[],"mappings":"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"}

package/dist/core/platform-operations.d.ts

@@ -1,20 +1,13 @@
 /**
  * Platform Operations Discovery
  *
- * Discovers available Nu shell script operations and maps user intent to operations
- * using AI-powered parsing and matching.
+ * Orchestrates tool-based discovery and mapping of Nu shell script operations.
+ * All data fetching logic lives in tools, this module handles orchestration.
  */
 import { AIProvider } from './ai-provider.interface';
 import { Logger } from './error-handling';
-export interface OperationCommand {
-    name: string;
-    command: string[];
-}
-export interface Operation {
-    name: string;
-    description: string;
-    operations: OperationCommand[];
-}
+export { Operation, OperationCommand } from '../tools/platform/discover-operations.tool';
+import { Operation } from '../tools/platform/discover-operations.tool';
 export interface MatchedOperation {
     tool: string;
     operation: string;
@@ -45,7 +38,8 @@ export interface PlatformSession {
     updatedAt: string;
 }
 /**
- * Discover available operations from Nu shell scripts using AI parsing
+ * Discover available operations from Nu shell scripts
+ * Uses tool for data fetching and prompt injection for AI parsing
  */
 export declare function discoverOperations(aiProvider: AIProvider, logger: Logger): Promise<Operation[]>;
 /**

package/dist/core/platform-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-operations.d.ts","sourceRoot":"","sources":["../../src/core/platform-operations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AA4B1C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjD,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,WAAW,EAAE,mBAAmB,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,EAAE,CAAC,CAiCtB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,SAAS,EAAE,EACvB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,CAAC,CAqCxB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAuE9B;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,gBAAgB,EAClC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC,CA8B1B;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,eAAe,GAAG,IAAI,CAmBxB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAkE/F"}
+{"version":3,"file":"platform-operations.d.ts","sourceRoot":"","sources":["../../src/core/platform-operations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAM1C,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAGzF,OAAO,EAAE,SAAS,EAAE,MAAM,4CAA4C,CAAC;AAEvE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjD,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,WAAW,EAAE,mBAAmB,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,EAAE,CAAC,CAmCtB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,SAAS,EAAE,EACvB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,CAAC,CAqCxB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAuE9B;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,gBAAgB,EAClC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC,CA8B1B;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,eAAe,GAAG,IAAI,CAmBxB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAkE/F"}

package/dist/core/platform-operations.js

@@ -2,8 +2,8 @@
 /**
  * Platform Operations Discovery
  *
- * Discovers available Nu shell script operations and maps user intent to operations
- * using AI-powered parsing and matching.
+ * Orchestrates tool-based discovery and mapping of Nu shell script operations.
+ * All data fetching logic lives in tools, this module handles orchestration.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -45,52 +45,31 @@ exports.getOperationParameters = getOperationParameters;
 exports.createSession = createSession;
 exports.loadSession = loadSession;
 exports.executeOperation = executeOperation;
-const child_process_1 = require("child_process");
-const util_1 = require("util");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const execAsync = (0, util_1.promisify)(child_process_1.exec);
+const platform_utils_1 = require("./platform-utils");
 /**
- * Get the scripts directory path, works in both development and installed npm package
- */
-function getScriptsDir() {
-    // In CommonJS (after TypeScript compilation), __dirname is available
-    // Go up from dist/core/ to project root, then into scripts/
-    return path.join(__dirname, '..', '..', 'scripts');
-}
-/**
- * Strip markdown code blocks from AI response
- */
-function stripMarkdownCodeBlocks(content) {
-    let jsonContent = content.trim();
-    if (jsonContent.startsWith('```json')) {
-        jsonContent = jsonContent.replace(/^```json\s*/, '').replace(/\s*```$/, '');
-    }
-    else if (jsonContent.startsWith('```')) {
-        jsonContent = jsonContent.replace(/^```\s*/, '').replace(/\s*```$/, '');
-    }
-    return jsonContent;
-}
-/**
- * Discover available operations from Nu shell scripts using AI parsing
+ * Discover available operations from Nu shell scripts
+ * Uses tool for data fetching and prompt injection for AI parsing
  */
 async function discoverOperations(aiProvider, logger) {
     try {
-        // Execute Nu script help command
-        const scriptPath = path.join(getScriptsDir(), 'dot.nu');
-        const { stdout, stderr } = await execAsync(`nu ${scriptPath} --help`);
-        if (stderr) {
-            logger.warn?.('Nu script help command produced stderr', { stderr });
+        // Import the tool execution function
+        const { executeDiscoverOperations } = await Promise.resolve().then(() => __importStar(require('../tools/platform/discover-operations.tool')));
+        // Execute tool directly to get help output
+        const toolResult = await executeDiscoverOperations({}, aiProvider, logger);
+        if (!toolResult.success || !toolResult.helpOutput) {
+            throw new Error(toolResult.error || 'Failed to get Nu script help output');
         }
-        // Load AI prompt template for parsing help output
-        const promptPath = path.join(process.cwd(), 'prompts', 'parse-script-operations.md');
+        // Load the parsing prompt template
+        const promptPath = path.join(process.cwd(), 'prompts', 'platform-operations-parse-script-help.md');
         const promptTemplate = fs.readFileSync(promptPath, 'utf8');
-        // Replace template variable with actual help output
-        const prompt = promptTemplate.replace('{helpOutput}', stdout);
-        // Send to AI provider for AI-powered parsing
-        const response = await aiProvider.sendMessage(prompt);
-        // Strip markdown code blocks and parse JSON
-        const jsonContent = stripMarkdownCodeBlocks(response.content);
+        // Inject help output into prompt
+        const prompt = promptTemplate.replace('{helpOutput}', toolResult.helpOutput);
+        // Single AI call with injected data
+        const response = await aiProvider.sendMessage(prompt, 'platform-discover-operations');
+        // Parse operations from AI response
+        const jsonContent = (0, platform_utils_1.stripMarkdownCodeBlocks)(response.content);
         const operations = JSON.parse(jsonContent);
         logger.info?.('Discovered operations from Nu scripts', {
             count: operations.length
@@ -115,9 +94,9 @@ async function mapIntentToOperation(intent, operations, aiProvider, logger) {
             .replace('{intent}', intent)
             .replace('{operations}', JSON.stringify(operations, null, 2));
         // Send to AI provider for AI-powered intent matching
-        const response = await aiProvider.sendMessage(prompt);
+        const response = await aiProvider.sendMessage(prompt, 'platform-map-intent');
         // Strip markdown code blocks and parse JSON
-        const jsonContent = stripMarkdownCodeBlocks(response.content);
+        const jsonContent = (0, platform_utils_1.stripMarkdownCodeBlocks)(response.content);
         const mapping = JSON.parse(jsonContent);
         // Validate that AI returned required fields
         if (mapping.matched && mapping.operation) {
@@ -146,9 +125,9 @@ async function getOperationParameters(command, logger) {
         // Build the full command name that Nushell expects
         const commandName = `main ${command.join(' ')}`;
         // Execute Nu script to get structured command metadata
-        const scriptPath = path.join(getScriptsDir(), 'dot.nu');
+        const scriptPath = path.join((0, platform_utils_1.getScriptsDir)(), 'dot.nu');
         const nuCommand = `source ${scriptPath}; scope commands | where name == "${commandName}" | to json`;
-        const { stdout, stderr } = await execAsync(`nu -c '${nuCommand}'`);
+        const { stdout, stderr } = await (0, platform_utils_1.execAsync)(`nu -c '${nuCommand}'`);
         if (stderr) {
             logger.warn?.('Nu scope commands produced stderr', { stderr });
         }
@@ -278,7 +257,7 @@ async function executeOperation(session, answers, logger) {
             }
         }
         // Build Nu script command
-        const scriptPath = path.join(getScriptsDir(), 'dot.nu');
+        const scriptPath = path.join((0, platform_utils_1.getScriptsDir)(), 'dot.nu');
         const command = session.matchedOperation.command;
         // Build command arguments
         const args = [];
@@ -294,7 +273,7 @@ async function executeOperation(session, answers, logger) {
             sessionId: session.sessionId,
             command: fullCommand
         });
-        const { stdout, stderr } = await execAsync(fullCommand);
+        const { stdout, stderr } = await (0, platform_utils_1.execAsync)(fullCommand);
         if (stderr) {
             logger.warn?.('Operation produced stderr', { stderr });
         }

package/dist/core/platform-utils.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Platform Utilities
+ *
+ * Shared utility functions for platform operations and tools.
+ */
+import { exec } from 'child_process';
+export declare const execAsync: typeof exec.__promisify__;
+/**
+ * Get the scripts directory path, works in both development and installed npm package
+ */
+export declare function getScriptsDir(): string;
+/**
+ * Strip markdown code blocks from AI response
+ */
+export declare function stripMarkdownCodeBlocks(content: string): string;
+//# sourceMappingURL=platform-utils.d.ts.map

package/dist/core/platform-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-utils.d.ts","sourceRoot":"","sources":["../../src/core/platform-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAIrC,eAAO,MAAM,SAAS,2BAAkB,CAAC;AAEzC;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAItC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ/D"}

package/dist/core/platform-utils.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Platform Utilities
+ *
+ * Shared utility functions for platform operations and tools.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execAsync = void 0;
+exports.getScriptsDir = getScriptsDir;
+exports.stripMarkdownCodeBlocks = stripMarkdownCodeBlocks;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const path = __importStar(require("path"));
+exports.execAsync = (0, util_1.promisify)(child_process_1.exec);
+/**
+ * Get the scripts directory path, works in both development and installed npm package
+ */
+function getScriptsDir() {
+    // In CommonJS (after TypeScript compilation), __dirname is available
+    // Go up from dist/core/ to project root, then into scripts/
+    return path.join(__dirname, '..', '..', 'scripts');
+}
+/**
+ * Strip markdown code blocks from AI response
+ */
+function stripMarkdownCodeBlocks(content) {
+    let jsonContent = content.trim();
+    if (jsonContent.startsWith('```json')) {
+        jsonContent = jsonContent.replace(/^```json\s*/, '').replace(/\s*```$/, '');
+    }
+    else if (jsonContent.startsWith('```')) {
+        jsonContent = jsonContent.replace(/^```\s*/, '').replace(/\s*```$/, '');
+    }
+    return jsonContent;
+}

package/dist/core/providers/anthropic-provider.d.ts

@@ -4,7 +4,7 @@
  * Implements AIProvider interface using Anthropic SDK directly.
  * Supports streaming for long operations and debug logging.
  */
-import { AIProvider, AIResponse, AIProviderConfig } from '../ai-provider.interface';
+import { AIProvider, AIResponse, AIProviderConfig, AITool, ToolExecutor, ToolLoopConfig, AgenticResult } from '../ai-provider.interface';
 export declare class AnthropicProvider implements AIProvider {
     private client;
     private apiKey;
@@ -15,18 +15,30 @@ export declare class AnthropicProvider implements AIProvider {
     getProviderType(): string;
     getDefaultModel(): string;
     isInitialized(): boolean;
+    sendMessage(message: string, operation?: string): Promise<AIResponse>;
     /**
-     * Create debug directory if it doesn't exist
-     */
-    private ensureDebugDirectory;
-    /**
-     * Generate unique identifier for debug files with operation context
-     */
-    private generateDebugId;
-    /**
-     * Save AI interaction for debugging when DEBUG_DOT_AI=true
+     * Agentic tool loop implementation
+     *
+     * NOTE: This method is currently NOT USED in the codebase (as of PRD #136 completion).
+     *
+     * Analysis showed that SDK-based tool loops and JSON-based agentic loops are functionally
+     * equivalent - both allow AI to decide which tools to call and when to stop. The JSON-based
+     * approach we already use provides the same capabilities without the token overhead of
+     * tool schemas in every request.
+     *
+     * This implementation is kept for potential future use cases where SDK-managed tool loops
+     * might provide advantages (e.g., better provider-specific optimizations, simpler code for
+     * highly exploratory workflows).
+     *
+     * ONLY IMPLEMENTED IN ANTHROPIC PROVIDER - VercelAIProvider does not implement this method
+     * as it's not needed for current workflows. If you need toolLoop for other providers, you'll
+     * need to implement it there as well.
+     *
+     * See PRD #136 for full architecture analysis and decision rationale.
      */
-    private debugLogInteraction;
-    sendMessage(message: string, operation?: string): Promise<AIResponse>;
+    toolLoop(config: ToolLoopConfig): Promise<AgenticResult>;
+    sendMessageWithTools(message: string, tools: AITool[], toolExecutor: ToolExecutor, operation?: string): Promise<AIResponse & {
+        toolCalls?: any[];
+    }>;
 }
 //# sourceMappingURL=anthropic-provider.d.ts.map

package/dist/core/providers/anthropic-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic-provider.d.ts","sourceRoot":"","sources":["../../../src/core/providers/anthropic-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EACL,UAAU,EACV,UAAU,EACV,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAElC,qBAAa,iBAAkB,YAAW,UAAU;IAClD,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAU;gBAEf,MAAM,EAAE,gBAAgB;IAWpC,OAAO,CAAC,cAAc;IAStB,eAAe,IAAI,MAAM;IAIzB,eAAe,IAAI,MAAM;IAIzB,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA+BrB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;CAkDvF"}
+{"version":3,"file":"anthropic-provider.d.ts","sourceRoot":"","sources":["../../../src/core/providers/anthropic-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,MAAM,EACN,YAAY,EACZ,cAAc,EACd,aAAa,EACd,MAAM,0BAA0B,CAAC;AAGlC,qBAAa,iBAAkB,YAAW,UAAU;IAClD,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAU;gBAEf,MAAM,EAAE,gBAAgB;IAWpC,OAAO,CAAC,cAAc;IAStB,eAAe,IAAI,MAAM;IAIzB,eAAe,IAAI,MAAM;IAIzB,aAAa,IAAI,OAAO;IAIlB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAwDtF;;;;;;;;;;;;;;;;;;;OAmBG;IACG,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAgIxD,oBAAoB,CACxB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EAAE,EACf,YAAY,EAAE,YAAY,EAC1B,SAAS,GAAE,MAAoB,GAC9B,OAAO,CAAC,UAAU,GAAG;QAAE,SAAS,CAAC,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC;CAqE/C"}