@spec2tools/cli 0.1.2 → 0.2.0

package/README.md

@@ -38,6 +38,9 @@ npx @spec2tools/cli start --spec ./openapi.yaml --no-auth
 
 # Provide API key directly
 npx @spec2tools/cli start --spec ./openapi.yaml --api-key "your-api-key"
+
+# Enable code mode (2 tools: search + execute)
+npx @spec2tools/cli start --spec ./openapi.yaml --code-mode
 ```
 
 ### Chat Mode

package/dist/agent.d.ts

@@ -1,6 +1,6 @@
-import { type Tool } from '@spec2tools/core';
+import { type ToolSet } from '@spec2tools/core';
 interface AgentConfig {
-    tools: Tool[];
+    tools: ToolSet;
     model?: string;
     maxSteps?: number;
 }
@@ -32,7 +32,7 @@ export declare class Agent {
     /**
      * Get a specific tool by name
      */
-    getTool(name: string): Tool | undefined;
+    getTool(name: string): ToolSet[string] | undefined;
 }
 export {};
 //# sourceMappingURL=agent.d.ts.map

package/dist/agent.js

@@ -1,4 +1,4 @@
-import { generateText, tool, stepCountIs } from 'ai';
+import { generateText, stepCountIs } from 'ai';
 import { openai } from '@ai-sdk/openai';
 import { ToolExecutionError } from '@spec2tools/core';
 import chalk from 'chalk';
@@ -31,11 +31,14 @@ export class Agent {
      * Get available tools description for the agent
      */
     getToolsDescription() {
-        if (this.tools.length === 0) {
+        const names = Object.keys(this.tools);
+        if (names.length === 0) {
             return 'No tools available.';
         }
-        const toolDescriptions = this.tools.map((tool) => {
-            return `- ${tool.name}: ${tool.description}`;
+        const toolDescriptions = names.map((name) => {
+            const t = this.tools[name];
+            const desc = 'description' in t ? t.description : '';
+            return `- ${name}: ${desc}`;
         });
         return `I have access to the following tools:\n${toolDescriptions.join('\n')}`;
     }
@@ -49,30 +52,29 @@ export class Agent {
             content: userMessage,
         });
         try {
-            // Build AI SDK tools from our tool definitions
-            const aiTools = {};
-            for (const t of this.tools) {
-                const toolExecute = t.execute;
-                const toolName = t.name;
-                aiTools[t.name] = tool({
-                    description: t.description,
-                    inputSchema: t.parameters,
-                    execute: async (params) => {
-                        console.log(chalk.dim(`\n[Calling ${toolName} with ${JSON.stringify(params)}]`));
-                        try {
-                            const result = await toolExecute(params);
-                            console.log(chalk.dim(`[${toolName} returned: ${trimOutput(result)}]\n`));
-                            return result;
-                        }
-                        catch (error) {
-                            if (error instanceof ToolExecutionError) {
-                                console.log(chalk.red(`[${toolName} failed: ${error.message}]\n`));
+            // Wrap each tool to add CLI logging
+            const wrappedTools = {};
+            for (const [name, t] of Object.entries(this.tools)) {
+                const originalExecute = 'execute' in t ? t.execute : undefined;
+                wrappedTools[name] = {
+                    ...t,
+                    execute: originalExecute
+                        ? async (params, options) => {
+                            console.log(chalk.dim(`\n[Calling ${name} with ${JSON.stringify(params)}]`));
+                            try {
+                                const result = await originalExecute(params, options);
+                                console.log(chalk.dim(`[${name} returned: ${trimOutput(result)}]\n`));
+                                return result;
+                            }
+                            catch (error) {
+                                if (error instanceof ToolExecutionError) {
+                                    console.log(chalk.red(`[${name} failed: ${error.message}]\n`));
+                                }
                                 throw error;
                             }
-                            throw error;
                         }
-                    },
-                });
+                        : undefined,
+                };
             }
             // Build system prompt
             const systemPrompt = `You are a helpful AI assistant with access to various API tools.
@@ -84,7 +86,7 @@ If a tool call fails, explain the error to the user.`;
                 model: openai(this.model),
                 system: systemPrompt,
                 messages: this.conversationHistory,
-                tools: aiTools,
+                tools: wrappedTools,
                 stopWhen: stepCountIs(this.maxSteps),
             });
             // Add assistant response to history
@@ -114,13 +116,13 @@ If a tool call fails, explain the error to the user.`;
      * Get the list of tool names
      */
     getToolNames() {
-        return this.tools.map((t) => t.name);
+        return Object.keys(this.tools);
     }
     /**
      * Get a specific tool by name
      */
     getTool(name) {
-        return this.tools.find((t) => t.name === name);
+        return this.tools[name];
     }
 }
 //# sourceMappingURL=agent.js.map

package/dist/cli.js

@@ -2,7 +2,7 @@ import { Command } from 'commander';
 import chalk from 'chalk';
 import ora from 'ora';
 import * as readline from 'readline';
-import { loadOpenAPISpec, extractBaseUrl, extractAuthConfig, parseOperations, formatToolSchema, formatToolSignature, AuthManager, createExecutableTools, executeToolByName, UnsupportedSchemaError, AuthenticationError, ToolExecutionError, SpecLoadError, } from '@spec2tools/core';
+import { loadOpenAPISpec, extractBaseUrl, extractAuthConfig, parseOperations, formatToolSchema, formatToolSignature, AuthManager, createExecutableTools, executeToolByName, toAISDKTools, toCodeModeTools, UnsupportedSchemaError, AuthenticationError, ToolExecutionError, SpecLoadError, } from '@spec2tools/core';
 import { Agent } from './agent.js';
 const VERSION = '0.1.6';
 export function createCLI() {
@@ -17,6 +17,7 @@ export function createCLI() {
         .requiredOption('-s, --spec <path>', 'Path or URL to OpenAPI specification')
         .option('--no-auth', 'Skip authentication even if required by spec')
         .option('--api-key <key>', 'Provide API key or access token directly')
+        .option('--code-mode', 'Use code mode (2 tools: search + execute)')
         .action(async (options) => {
         await startAgent(options);
     });
@@ -59,6 +60,12 @@ async function startAgent(options) {
         }
         // Create executable tools
         const tools = createExecutableTools(toolDefs, baseUrl, authManager);
+        // Convert to AI SDK tools
+        let aiTools = toAISDKTools(tools);
+        if (options.codeMode) {
+            aiTools = toCodeModeTools(aiTools);
+            console.log(chalk.green('Code mode enabled (2 tools: search + execute)'));
+        }
         // Initialize session
         const session = {
             baseUrl,
@@ -67,7 +74,7 @@ async function startAgent(options) {
             accessToken: authManager.getAccessToken(),
         };
         // Start chat loop
-        await startChatLoop(session);
+        await startChatLoop(session, aiTools, options.codeMode ?? false);
     }
     catch (error) {
         spinner.fail();
@@ -87,9 +94,9 @@ async function startAgent(options) {
         process.exit(1);
     }
 }
-async function startChatLoop(session) {
+async function startChatLoop(session, aiTools, codeMode) {
     // Initialize agent
-    const agent = new Agent({ tools: session.tools });
+    const agent = new Agent({ tools: aiTools });
     console.log(chalk.bold('\n--- Spec2Tools ---'));
     console.log(chalk.dim('Type your message or use special commands:'));
     console.log(chalk.dim('  /tools  - List available tools'));
@@ -112,7 +119,7 @@ async function startChatLoop(session) {
             // Pause readline during async operations to prevent corruption
             rl.pause();
             try {
-                await handleInput(trimmedInput, session, agent);
+                await handleInput(trimmedInput, session, agent, codeMode, aiTools);
             }
             catch (error) {
                 console.error(chalk.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
@@ -129,10 +136,10 @@ async function startChatLoop(session) {
     });
     prompt();
 }
-async function handleInput(input, session, agent) {
+async function handleInput(input, session, agent, codeMode, aiTools) {
     // Handle special commands
     if (input.startsWith('/')) {
-        await handleCommand(input, session, agent);
+        await handleCommand(input, session, agent, codeMode, aiTools);
         return;
     }
     // Regular chat message
@@ -147,13 +154,18 @@ async function handleInput(input, session, agent) {
         throw error;
     }
 }
-async function handleCommand(input, session, agent) {
+async function handleCommand(input, session, agent, codeMode, aiTools) {
     const parts = input.slice(1).split(/\s+/);
     const command = parts[0].toLowerCase();
     const args = parts.slice(1);
     switch (command) {
         case 'tools':
-            listTools(session.tools);
+            if (codeMode) {
+                listCodeModeTools(aiTools);
+            }
+            else {
+                listTools(session.tools);
+            }
             break;
         case 'call':
             await callTool(session.tools, args);
@@ -186,6 +198,15 @@ function listTools(tools) {
     });
     console.log('');
 }
+function listCodeModeTools(aiTools) {
+    console.log(chalk.bold('\nCode mode tools:'));
+    Object.entries(aiTools).forEach(([name, t], index) => {
+        const desc = 'description' in t ? t.description || '' : '';
+        console.log(chalk.cyan(`${index + 1}. ${name}`));
+        console.log(chalk.dim(`   ${desc}`));
+    });
+    console.log('');
+}
 async function callTool(tools, args) {
     if (args.length === 0) {
         console.log(chalk.yellow('Usage: /call <toolName> [--param value ...]'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spec2tools/cli",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "CLI for interacting with OpenAPI-based AI tools",
   "type": "module",
   "main": "dist/index.js",
@@ -39,7 +39,7 @@
     "commander": "^14.0.0",
     "dotenv": "^17.2.3",
     "ora": "^8.1.0",
-    "@spec2tools/core": "0.1.2"
+    "@spec2tools/core": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",