@vfarcic/dot-ai 0.105.0 → 0.106.0

package/dist/core/providers/vercel-provider.js

@@ -5,48 +5,13 @@
  * Implements AIProvider interface using Vercel AI SDK.
  * Supports OpenAI and Google Gemini providers through unified interface.
  */
-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.VercelProvider = void 0;
 const ai_1 = require("ai");
 const openai_1 = require("@ai-sdk/openai");
 const google_1 = require("@ai-sdk/google");
 const anthropic_1 = require("@ai-sdk/anthropic");
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const crypto = __importStar(require("crypto"));
+const provider_debug_utils_1 = require("./provider-debug-utils");
 /**
  * Provider-specific default models
  */
@@ -118,61 +83,11 @@ class VercelProvider {
     isInitialized() {
         return this.modelInstance !== undefined;
     }
-    /**
-     * Create debug directory if it doesn't exist
-     */
-    ensureDebugDirectory() {
-        const debugDir = path.join(process.cwd(), 'tmp', 'debug-ai');
-        if (!fs.existsSync(debugDir)) {
-            fs.mkdirSync(debugDir, { recursive: true });
-        }
-        return debugDir;
-    }
-    /**
-     * Generate unique identifier for debug files with operation context
-     */
-    generateDebugId(operation) {
-        const timestamp = new Date().toISOString().replace(/[:.]/g, '').split('T');
-        const dateTime = timestamp[0] + 'T' + timestamp[1].substring(0, 6);
-        const randomHex = crypto.randomBytes(4).toString('hex');
-        return `${dateTime}_${randomHex}_${operation}`;
-    }
-    /**
-     * Save AI interaction for debugging when DEBUG_DOT_AI=true
-     */
-    debugLogInteraction(debugId, prompt, response, operation = 'ai_call') {
-        if (!this.debugMode)
-            return;
-        try {
-            const debugDir = this.ensureDebugDirectory();
-            // Save prompt with descriptive naming
-            const promptFile = path.join(debugDir, `${debugId}_prompt.md`);
-            fs.writeFileSync(promptFile, `# AI Prompt - ${operation}\n\nTimestamp: ${new Date().toISOString()}\nProvider: ${this.providerType}\nModel: ${this.model}\nOperation: ${operation}\n\n---\n\n${prompt}`);
-            // Save response with matching naming
-            const responseFile = path.join(debugDir, `${debugId}_response.md`);
-            const responseContent = `# AI Response - ${operation}
-
-Timestamp: ${new Date().toISOString()}
-Provider: ${this.providerType}
-Model: ${this.model}
-Operation: ${operation}
-Input Tokens: ${response.usage.input_tokens}
-Output Tokens: ${response.usage.output_tokens}
-
----
-
-${response.content}`;
-            fs.writeFileSync(responseFile, responseContent);
-            console.log(`🐛 DEBUG: AI interaction logged to tmp/debug-ai/${debugId}_*.md`);
-        }
-        catch (error) {
-            console.warn('Failed to log AI debug interaction:', error);
-        }
-    }
     async sendMessage(message, operation = 'generic') {
         if (!this.isInitialized()) {
             throw new Error(`${this.providerType} provider not initialized`);
         }
+        const startTime = Date.now();
         try {
             // Use Vercel AI SDK generateText
             // Note: maxTokens omitted - let SDK/provider use model-specific optimal defaults
@@ -187,10 +102,12 @@ ${response.content}`;
                     output_tokens: result.usage.outputTokens || 0
                 }
             };
+            const durationMs = Date.now() - startTime;
             // Debug log the interaction if enabled
             if (this.debugMode) {
-                const debugId = this.generateDebugId(operation);
-                this.debugLogInteraction(debugId, message, response, operation);
+                const debugId = (0, provider_debug_utils_1.generateDebugId)(operation);
+                (0, provider_debug_utils_1.debugLogInteraction)(debugId, message, response, operation, this.getProviderType(), this.model, this.debugMode);
+                (0, provider_debug_utils_1.logMetrics)(operation, this.getProviderType(), response.usage, durationMs, this.debugMode);
             }
             return response;
         }
@@ -198,5 +115,38 @@ ${response.content}`;
             throw new Error(`${this.providerType} API error: ${error}`);
         }
     }
+    /**
+     * Agentic tool loop - NOT IMPLEMENTED for Vercel provider
+     *
+     * This method is intentionally not implemented because:
+     * 1. toolLoop() is currently NOT USED anywhere in the codebase (see PRD #136)
+     * 2. JSON-based agentic loops already provide equivalent functionality
+     * 3. No current workflows require SDK-managed tool loops
+     *
+     * If future requirements necessitate toolLoop() for non-Anthropic providers,
+     * this would need to be implemented using Vercel AI SDK's tool calling API.
+     *
+     * See AnthropicProvider.toolLoop() and PRD #136 for implementation reference.
+     */
+    async toolLoop(_config) {
+        if (!this.isInitialized()) {
+            throw new Error(`${this.providerType} provider not initialized`);
+        }
+        throw new Error(`toolLoop() not implemented for ${this.providerType} provider. Use AnthropicProvider for tool-based workflows, or use JSON-based agentic loops (recommended).`);
+    }
+    /**
+     * Single-shot tool calling - NOT IMPLEMENTED for Vercel provider
+     *
+     * Same reasoning as toolLoop(): not currently needed in codebase.
+     * JSON-based approach achieves same functionality without SDK overhead.
+     *
+     * See AnthropicProvider.sendMessageWithTools() for reference implementation.
+     */
+    async sendMessageWithTools(_message, _tools, _toolExecutor, _operation = 'tool-call') {
+        if (!this.isInitialized()) {
+            throw new Error(`${this.providerType} provider not initialized`);
+        }
+        throw new Error(`sendMessageWithTools() not implemented for ${this.providerType} provider. Use AnthropicProvider for tool-based workflows, or use JSON-based approach (recommended).`);
+    }
 }
 exports.VercelProvider = VercelProvider;

package/dist/interfaces/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/interfaces/mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AA8CtC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;CACxC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAC,CAAkC;IACrD,OAAO,CAAC,aAAa,CAAC,CAAgC;IACtD,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,aAAa,CAAgB;gBAEzB,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe;IAsCjD;;OAEG;IACH,OAAO,CAAC,YAAY;IAsBpB;;OAEG;IACH,OAAO,CAAC,aAAa;IA4HrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqCvB,OAAO,CAAC,iBAAiB;IAInB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAkBd,mBAAmB;YAMnB,kBAAkB;YAiFlB,gBAAgB;IAexB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B,OAAO,IAAI,OAAO;CAGnB"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/interfaces/mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAiDtC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;CACxC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAC,CAAkC;IACrD,OAAO,CAAC,aAAa,CAAC,CAAgC;IACtD,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,aAAa,CAAgB;gBAEzB,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe;IAsCjD;;OAEG;IACH,OAAO,CAAC,YAAY;IAsBpB;;OAEG;IACH,OAAO,CAAC,aAAa;IA+HrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqCvB,OAAO,CAAC,iBAAiB;IAInB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAkBd,mBAAmB;YAMnB,kBAAkB;YAiFlB,gBAAgB;IAexB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B,OAAO,IAAI,OAAO;CAGnB"}

package/dist/interfaces/mcp.js

@@ -19,7 +19,15 @@ const version_1 = require("../tools/version");
 const test_docs_1 = require("../tools/test-docs");
 const organizational_data_1 = require("../tools/organizational-data");
 const remediate_1 = require("../tools/remediate");
-const build_platform_1 = require("../tools/build-platform");
+/*
+// DEVELOPER NOTE: Platform Building tool disabled - imports commented out
+import {
+  BUILD_PLATFORM_TOOL_NAME,
+  BUILD_PLATFORM_TOOL_DESCRIPTION,
+  BUILD_PLATFORM_TOOL_INPUT_SCHEMA,
+  handleBuildPlatformTool,
+} from '../tools/build-platform';
+*/
 const prompts_1 = require("../tools/prompts");
 const rest_registry_1 = require("./rest-registry");
 const rest_api_1 = require("./rest-api");
@@ -117,12 +125,25 @@ class MCPServer {
             this.logger.info(`Processing ${remediate_1.REMEDIATE_TOOL_NAME} tool request`, { requestId });
             return await (0, remediate_1.handleRemediateTool)(args);
         }, 'Troubleshooting', ['remediation', 'troubleshooting', 'kubernetes', 'analysis']);
+        /*
+        // DEVELOPER NOTE: buildPlatform tool disabled - under active development with incomplete functionality
         // Register buildPlatform tool
-        this.registerTool(build_platform_1.BUILD_PLATFORM_TOOL_NAME, build_platform_1.BUILD_PLATFORM_TOOL_DESCRIPTION, build_platform_1.BUILD_PLATFORM_TOOL_INPUT_SCHEMA, async (args) => {
+        this.registerTool(
+          BUILD_PLATFORM_TOOL_NAME,
+          BUILD_PLATFORM_TOOL_DESCRIPTION,
+          BUILD_PLATFORM_TOOL_INPUT_SCHEMA,
+          async (args: any) => {
             const requestId = this.generateRequestId();
-            this.logger.info(`Processing ${build_platform_1.BUILD_PLATFORM_TOOL_NAME} tool request`, { requestId });
-            return await (0, build_platform_1.handleBuildPlatformTool)(args, this.dotAI, this.logger, requestId);
-        }, 'Platform', ['platform', 'kubernetes', 'installation', 'infrastructure']);
+            this.logger.info(
+              `Processing ${BUILD_PLATFORM_TOOL_NAME} tool request`,
+              { requestId }
+            );
+            return await handleBuildPlatformTool(args, this.dotAI, this.logger, requestId);
+          },
+          'Platform',
+          ['platform', 'kubernetes', 'installation', 'infrastructure']
+        );
+        */
         this.logger.info('Registered all tools with McpServer', {
             tools: [
                 recommend_1.RECOMMEND_TOOL_NAME,
@@ -130,9 +151,9 @@ class MCPServer {
                 test_docs_1.TESTDOCS_TOOL_NAME,
                 organizational_data_1.ORGANIZATIONAL_DATA_TOOL_NAME,
                 remediate_1.REMEDIATE_TOOL_NAME,
-                build_platform_1.BUILD_PLATFORM_TOOL_NAME,
+                // BUILD_PLATFORM_TOOL_NAME, // Disabled - under development
             ],
-            totalTools: 6,
+            totalTools: 5,
         });
     }
     /**

package/dist/tools/platform/discover-operations.tool.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Discover Operations Tool
+ *
+ * Self-contained tool that fetches raw Nu shell script help output.
+ * Returns unprocessed data for AI to parse.
+ */
+import { AITool, AIProvider } from '../../core/ai-provider.interface';
+import { Logger } from '../../core/error-handling';
+/**
+ * Operation interfaces (re-export for tool consumers)
+ */
+export interface OperationCommand {
+    name: string;
+    command: string[];
+}
+export interface Operation {
+    name: string;
+    description: string;
+    operations: OperationCommand[];
+}
+/**
+ * Tool schema for getting Nu script help output
+ */
+export declare const discoverOperationsTool: AITool;
+/**
+ * Execute get_nu_help_output tool
+ *
+ * Simple data fetcher - returns raw Nu script help output
+ */
+export declare function executeDiscoverOperations(input: any, aiProvider: AIProvider, logger: Logger): Promise<{
+    success: boolean;
+    helpOutput?: string;
+    error?: string;
+}>;
+//# sourceMappingURL=discover-operations.tool.d.ts.map

package/dist/tools/platform/discover-operations.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-operations.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/platform/discover-operations.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAGnD;;GAEG;AACH,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;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAUpC,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,GAAG,EACV,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAyBpE"}

package/dist/tools/platform/discover-operations.tool.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * Discover Operations Tool
+ *
+ * Self-contained tool that fetches raw Nu shell script help output.
+ * Returns unprocessed data for AI to parse.
+ */
+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.discoverOperationsTool = void 0;
+exports.executeDiscoverOperations = executeDiscoverOperations;
+const path = __importStar(require("path"));
+const platform_utils_1 = require("../../core/platform-utils");
+/**
+ * Tool schema for getting Nu script help output
+ */
+exports.discoverOperationsTool = {
+    name: "get_nu_help_output",
+    description: `Executes 'nu ./dot.nu --help' and returns the raw help output text.
+
+  Returns the complete help documentation that lists all available platform
+  operations with their commands and descriptions.`,
+    inputSchema: {
+        type: "object",
+        properties: {} // No input needed
+    }
+};
+/**
+ * Execute get_nu_help_output tool
+ *
+ * Simple data fetcher - returns raw Nu script help output
+ */
+async function executeDiscoverOperations(input, aiProvider, logger) {
+    try {
+        // Execute Nu script help command
+        const scriptPath = path.join((0, platform_utils_1.getScriptsDir)(), 'dot.nu');
+        const { stdout, stderr } = await (0, platform_utils_1.execAsync)(`nu "${scriptPath}" --help`);
+        if (stderr) {
+            logger.warn?.('Nu script help command produced stderr', { stderr });
+        }
+        logger.info?.('Tool fetched Nu help output', {
+            length: stdout.length
+        });
+        return {
+            success: true,
+            helpOutput: stdout
+        };
+    }
+    catch (error) {
+        logger.error?.('Tool failed to get Nu help output', error);
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error)
+        };
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vfarcic/dot-ai",
-  "version": "0.105.0",
+  "version": "0.106.0",
   "description": "AI-powered development productivity platform that enhances software development workflows through intelligent automation and AI-driven assistance",
   "mcpName": "io.github.vfarcic/dot-ai",
   "main": "dist/index.js",

package/prompts/{parse-script-operations.md → platform-operations-parse-script-help.md}

@@ -2,17 +2,13 @@
 
 You are a specialized parser that extracts available operations from Nushell script help output.
 
-## Input
-
-Here is the help output from a Nu shell script:
+## Task
 
-```text
-{helpOutput}
-```
+Parse the help output below and extract all available tools/resources with their operations into a structured JSON array.
 
-## Task
+## Help Output
 
-Parse this help output and extract all available tools/resources with their operations into a structured JSON array.
+{helpOutput}
 
 ## Rules