@runflow-ai/cli 0.2.22 → 0.2.23

package/dist/commands/create/code-generator.d.ts

@@ -0,0 +1,11 @@
+export interface GenerateAgentCodeConfig {
+    agentName: string;
+    provider: 'openai' | 'anthropic' | 'groq' | 'gemini' | 'bedrock';
+    model: string;
+    template?: 'starter' | 'rag';
+}
+export interface GeneratedFile {
+    path: string;
+    content: string;
+}
+export declare function generateAgentCode(config: GenerateAgentCodeConfig): GeneratedFile[];

package/dist/commands/create/code-generator.js

@@ -0,0 +1,532 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAgentCode = generateAgentCode;
+function generateAgentCode(config) {
+    const { agentName, provider, model, template = 'starter' } = config;
+    const agentSlug = slugify(agentName);
+    const files = [
+        { path: 'main.ts', content: generateMainTs(config) },
+        { path: 'tools/index.ts', content: generateToolsIndex() },
+        { path: 'tools/weather.ts', content: generateWeatherTool() },
+        { path: 'prompts/index.ts', content: generatePromptsIndex(agentName) },
+        { path: 'package.json', content: generatePackageJson(agentSlug) },
+        { path: 'tsconfig.json', content: generateTsConfig() },
+        { path: 'README.md', content: generateReadme(agentName, agentSlug) },
+    ];
+    if (template === 'rag') {
+        files[0].content = generateMainTsWithRag(config);
+    }
+    return files;
+}
+function generateMainTs(config) {
+    const { agentName, provider, model } = config;
+    return `import { Agent, ${provider} } from '@runflow-ai/sdk';
+// import { identify } from '@runflow-ai/sdk';  // Uncomment to use identify
+import { tools } from './tools';
+import { systemPrompt } from './prompts';
+
+/**
+ * ${agentName} - AI Agent powered by Runflow SDK
+ * 
+ * Provider: ${provider}
+ * Model: ${model}
+ */
+const agent = new Agent({
+  name: '${agentName}',
+  model: ${provider}('${model}'),
+  instructions: systemPrompt,
+  tools,
+
+  // Memory - stores conversation history per session
+  // The sessionId is automatically provided by rf test or execution engine
+  memory: {
+    maxTurns: 10,  // Keep last 10 conversation turns
+  },
+
+  // Uncomment to enable RAG (Retrieval Augmented Generation)
+  // rag: {
+  //   vectorStore: 'my-knowledge-base',
+  //   k: 5,
+  //   threshold: 0.7,
+  // },
+
+  // Uncomment to enable debug logging
+  // debug: true,
+});
+
+/**
+ * Input validation
+ */
+function validateInput(input: unknown): { message: string; sessionId?: string } {
+  if (!input || typeof input !== 'object') {
+    throw new Error('Input must be an object');
+  }
+
+  const { message, sessionId } = input as Record<string, unknown>;
+
+  if (!message || typeof message !== 'string') {
+    throw new Error('message is required and must be a string');
+  }
+
+  if (message.trim().length === 0) {
+    throw new Error('message cannot be empty');
+  }
+
+  return {
+    message: message.trim(),
+    sessionId: typeof sessionId === 'string' ? sessionId : undefined,
+  };
+}
+
+/**
+ * Main entry point - called by Runflow runtime
+ * 
+ * The input object contains:
+ * - message: User's message (required)
+ * - sessionId: Unique session identifier (auto-generated by rf test)
+ * 
+ * Memory works automatically:
+ * - Same sessionId = same conversation history
+ * - Different sessionId = fresh conversation
+ */
+export async function main(input: { message: string; sessionId?: string }) {
+  try {
+    // Validate input
+    const validatedInput = validateInput(input);
+
+    // Uncomment to identify user for memory persistence across channels
+    // This creates a stable memory key based on user identity instead of session
+    // identify('+5511999999999');                    // Auto-detects type (phone)
+    // identify('user@email.com');                    // Auto-detects type (email)
+    // identify({ type: 'phone', value: '+5511999999999' });
+    // identify({ type: 'email', value: 'user@email.com' });
+    // identify({ type: 'hubspot_contact', value: 'contact_123' });
+
+    // Process message
+    const result = await agent.process(validatedInput);
+
+    return result;
+  } catch (error) {
+    // Log error for debugging
+    console.error('[${agentName}] Error:', error instanceof Error ? error.message : error);
+
+    // Return structured error response
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : 'An unexpected error occurred',
+    };
+  }
+}
+
+export default main;
+`;
+}
+function generateMainTsWithRag(config) {
+    const { agentName, provider, model } = config;
+    return `import { Agent, ${provider} } from '@runflow-ai/sdk';
+// import { identify } from '@runflow-ai/sdk';  // Uncomment to use identify
+import { tools } from './tools';
+import { systemPrompt } from './prompts';
+
+/**
+ * ${agentName} - RAG-enabled AI Agent powered by Runflow SDK
+ * 
+ * Provider: ${provider}
+ * Model: ${model}
+ * RAG: Enabled
+ */
+const agent = new Agent({
+  name: '${agentName}',
+  model: ${provider}('${model}'),
+  instructions: systemPrompt,
+  tools,
+
+  // Memory - stores conversation history per session
+  memory: {
+    maxTurns: 10,
+  },
+
+  // RAG - Retrieval Augmented Generation
+  rag: {
+    vectorStore: 'docs',
+    k: 5,
+    threshold: 0.7,
+  },
+
+  // Uncomment to enable debug logging
+  // debug: true,
+});
+
+/**
+ * Input validation
+ */
+function validateInput(input: unknown): { message: string; sessionId?: string } {
+  if (!input || typeof input !== 'object') {
+    throw new Error('Input must be an object');
+  }
+
+  const { message, sessionId } = input as Record<string, unknown>;
+
+  if (!message || typeof message !== 'string') {
+    throw new Error('message is required and must be a string');
+  }
+
+  if (message.trim().length === 0) {
+    throw new Error('message cannot be empty');
+  }
+
+  return {
+    message: message.trim(),
+    sessionId: typeof sessionId === 'string' ? sessionId : undefined,
+  };
+}
+
+/**
+ * Main entry point - called by Runflow runtime
+ */
+export async function main(input: { message: string; sessionId?: string }) {
+  try {
+    // Validate input
+    const validatedInput = validateInput(input);
+
+    // Uncomment to identify user for memory persistence across channels
+    // identify('+5511999999999');
+    // identify({ type: 'email', value: 'user@email.com' });
+
+    // Process message
+    const result = await agent.process(validatedInput);
+
+    return result;
+  } catch (error) {
+    console.error('[${agentName}] Error:', error instanceof Error ? error.message : error);
+
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : 'An unexpected error occurred',
+    };
+  }
+}
+
+export default main;
+`;
+}
+function generateToolsIndex() {
+    return `import { getWeather } from './weather';
+
+/**
+ * Agent Tools Registry
+ * 
+ * Tools are registered as a Record<string, RunflowTool>
+ * The key should match the tool's 'id' property
+ */
+export const tools = {
+  get_weather: getWeather,
+};
+`;
+}
+function generateWeatherTool() {
+    return `import { createTool } from '@runflow-ai/sdk';
+import { z } from 'zod';
+
+/**
+ * Weather Tool - Get current temperature for any city
+ * 
+ * Uses Open-Meteo API (free, no API key required)
+ * Documentation: https://open-meteo.com/
+ */
+export const getWeather = createTool({
+  id: 'get_weather',
+  description: 'Get current weather and temperature for a city. Use this when the user asks about weather, temperature, or climate conditions.',
+
+  inputSchema: z.object({
+    city: z.string().describe('City name (e.g., "São Paulo", "New York", "London")'),
+  }),
+
+  execute: async ({ context }) => {
+    const { city } = context;
+    
+    try {
+      // 1. Geocoding: Convert city name to coordinates
+      const geoUrl = \`https://geocoding-api.open-meteo.com/v1/search?name=\${encodeURIComponent(city)}&count=1&language=en\`;
+      const geoResponse = await fetch(geoUrl);
+
+      if (!geoResponse.ok) {
+        return { success: false, error: 'Failed to connect to geocoding service' };
+      }
+
+      const geoData = await geoResponse.json();
+
+      if (!geoData.results || geoData.results.length === 0) {
+        return { 
+          success: false, 
+          error: \`City "\${city}" not found. Try a different spelling or a nearby major city.\` 
+        };
+      }
+
+      const { latitude, longitude, name, country, admin1 } = geoData.results[0];
+
+      // 2. Weather: Get current conditions
+      const weatherUrl = \`https://api.open-meteo.com/v1/forecast?latitude=\${latitude}&longitude=\${longitude}&current=temperature_2m,relative_humidity_2m,apparent_temperature,wind_speed_10m,weather_code&timezone=auto\`;
+      const weatherResponse = await fetch(weatherUrl);
+
+      if (!weatherResponse.ok) {
+        return { success: false, error: 'Failed to fetch weather data' };
+      }
+
+      const weatherData = await weatherResponse.json();
+      const current = weatherData.current;
+
+      return {
+        success: true,
+        location: {
+          city: name,
+          region: admin1 || null,
+          country,
+          coordinates: { latitude, longitude },
+        },
+        weather: {
+          temperature: \`\${current.temperature_2m}°C\`,
+          feelsLike: \`\${current.apparent_temperature}°C\`,
+          humidity: \`\${current.relative_humidity_2m}%\`,
+          windSpeed: \`\${current.wind_speed_10m} km/h\`,
+          conditions: getWeatherDescription(current.weather_code),
+        },
+        timestamp: new Date().toISOString(),
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : 'Unknown error fetching weather',
+      };
+    }
+  },
+});
+
+/**
+ * Convert WMO weather codes to human-readable descriptions
+ * Reference: https://open-meteo.com/en/docs
+ */
+function getWeatherDescription(code: number): string {
+  const descriptions: Record<number, string> = {
+    0: 'Clear sky',
+    1: 'Mainly clear',
+    2: 'Partly cloudy',
+    3: 'Overcast',
+    45: 'Foggy',
+    48: 'Depositing rime fog',
+    51: 'Light drizzle',
+    53: 'Moderate drizzle',
+    55: 'Dense drizzle',
+    56: 'Light freezing drizzle',
+    57: 'Dense freezing drizzle',
+    61: 'Slight rain',
+    63: 'Moderate rain',
+    65: 'Heavy rain',
+    66: 'Light freezing rain',
+    67: 'Heavy freezing rain',
+    71: 'Slight snow',
+    73: 'Moderate snow',
+    75: 'Heavy snow',
+    77: 'Snow grains',
+    80: 'Slight rain showers',
+    81: 'Moderate rain showers',
+    82: 'Violent rain showers',
+    85: 'Slight snow showers',
+    86: 'Heavy snow showers',
+    95: 'Thunderstorm',
+    96: 'Thunderstorm with slight hail',
+    99: 'Thunderstorm with heavy hail',
+  };
+  return descriptions[code] || 'Unknown conditions';
+}
+`;
+}
+function generatePromptsIndex(agentName) {
+    return `/**
+ * System Prompts for ${agentName}
+ * 
+ * These prompts define the agent's personality, capabilities, and behavior.
+ * You can customize them to match your use case.
+ */
+
+export const systemPrompt = \`You are ${agentName}, a helpful and knowledgeable AI assistant.
+
+## Your Capabilities
+- Check weather and temperature for any city worldwide using the get_weather tool
+- Answer general questions with accuracy and clarity
+- Engage in friendly, professional conversations
+
+## Guidelines
+1. When users ask about weather, temperature, or climate, ALWAYS use the get_weather tool
+2. Provide clear, concise answers while being thorough when needed
+3. If you're unsure about something, acknowledge it honestly
+4. Be friendly and professional in your responses
+5. Format responses for readability (use bullet points, headers when appropriate)
+
+## Response Format
+- For weather queries: Include temperature, conditions, and any relevant details
+- For general questions: Be direct but comprehensive
+- Always maintain a helpful and positive tone
+\`;
+
+/**
+ * Additional prompt templates you can use
+ */
+export const prompts = {
+  // Greeting prompt for new sessions
+  greeting: \`Hello! I'm ${agentName}. I can help you check the weather for any city, answer questions, or just chat. What can I do for you today?\`,
+
+  // Error handling prompt
+  errorRecovery: \`I encountered an issue processing that request. Could you please rephrase or try again?\`,
+
+  // Weather-specific prompt enhancement
+  weatherContext: \`When providing weather information, include the temperature, how it feels, humidity, and wind conditions.\`,
+};
+`;
+}
+function generatePackageJson(agentSlug) {
+    const packageJson = {
+        name: agentSlug,
+        version: '1.0.0',
+        description: 'AI agent built with Runflow SDK',
+        main: 'main.ts',
+        type: 'module',
+        scripts: {
+            dev: 'rf dev',
+            test: 'rf test',
+            deploy: 'rf agents deploy',
+        },
+        dependencies: {
+            '@runflow-ai/sdk': '^1.0.68',
+            zod: '^3.23.0',
+        },
+        devDependencies: {
+            '@types/node': '^20.0.0',
+            typescript: '^5.5.0',
+        },
+    };
+    return JSON.stringify(packageJson, null, 2);
+}
+function generateTsConfig() {
+    const tsConfig = {
+        compilerOptions: {
+            target: 'ES2022',
+            module: 'ESNext',
+            moduleResolution: 'node',
+            outDir: './dist',
+            esModuleInterop: true,
+            strict: true,
+            skipLibCheck: true,
+        },
+        include: ['*.ts', 'tools/*.ts', 'prompts/*.ts'],
+    };
+    return JSON.stringify(tsConfig, null, 2);
+}
+function generateReadme(agentName, agentSlug) {
+    return `# ${agentName}
+
+AI agent built with [Runflow SDK](https://docs.runflow.ai).
+
+## Features
+
+- **Weather Tool**: Check real-time weather for any city worldwide (powered by [Open-Meteo](https://open-meteo.com/))
+- **Conversational AI**: Helpful assistant with memory and context awareness
+- **Extensible**: Easy to add new tools and capabilities
+
+## Quick Start
+
+\`\`\`bash
+# Install dependencies
+npm install
+
+# Test locally with interactive UI
+rf test
+
+# Deploy to production
+rf agents deploy
+\`\`\`
+
+## Project Structure
+
+\`\`\`
+${agentSlug}/
+├── main.ts              # Agent configuration and entry point
+├── tools/
+│   ├── index.ts         # Tools registry
+│   └── weather.ts       # Weather tool (Open-Meteo API)
+├── prompts/
+│   └── index.ts         # System prompts and templates
+├── .runflow/
+│   └── rf.json          # Runflow configuration
+├── package.json
+└── tsconfig.json
+\`\`\`
+
+## Example Conversations
+
+\`\`\`
+User: What's the weather in São Paulo?
+Agent: The current weather in São Paulo, Brazil:
+       - Temperature: 24°C (feels like 26°C)
+       - Conditions: Partly cloudy
+       - Humidity: 65%
+       - Wind: 12 km/h
+
+User: How about Tokyo?
+Agent: Here's the weather in Tokyo, Japan:
+       - Temperature: 18°C (feels like 17°C)
+       - Conditions: Clear sky
+       - Humidity: 45%
+       - Wind: 8 km/h
+\`\`\`
+
+## Adding New Tools
+
+1. Create a new file in \`tools/\` (e.g., \`tools/my-tool.ts\`)
+2. Use \`createTool\` from the SDK:
+
+\`\`\`typescript
+import { createTool } from '@runflow-ai/sdk';
+import { z } from 'zod';
+
+export const myTool = createTool({
+  id: 'my_tool',
+  description: 'Description of what the tool does',
+  inputSchema: z.object({
+    param: z.string().describe('Parameter description'),
+  }),
+  execute: async ({ context }) => {
+    const { param } = context;
+    // Your logic here
+    return { result: 'success' };
+  },
+});
+\`\`\`
+
+3. Register in \`tools/index.ts\`:
+
+\`\`\`typescript
+import { myTool } from './my-tool';
+
+export const tools = {
+  get_weather: getWeather,
+  my_tool: myTool,  // Add here
+};
+\`\`\`
+
+## Documentation
+
+- [Runflow Docs](https://docs.runflow.ai)
+- [SDK Reference](https://docs.runflow.ai/sdk)
+- [Tool Creation Guide](https://docs.runflow.ai/sdk/tools)
+- [RAG Configuration](https://docs.runflow.ai/sdk/rag)
+`;
+}
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .trim()
+        .replace(/\s+/g, '-')
+        .replace(/[^a-z0-9-]/g, '');
+}
+//# sourceMappingURL=code-generator.js.map

package/dist/commands/create/code-generator.js.map

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

package/dist/commands/create/create.command.d.ts

@@ -3,17 +3,18 @@ interface CreateOptions {
     apiKey?: string;
     api?: string;
     name?: string;
-    template?: string;
+    provider?: string;
+    model?: string;
     yes?: boolean;
 }
 export declare class CreateCommand extends CommandRunner {
     run(inputs: string[], options: CreateOptions): Promise<void>;
     private slugify;
-    private writeTreeToDisk;
     parseApiKey(val: string): string;
     parseApi(val: string): string;
     parseName(val: string): string;
-    parseTemplate(val: string): string;
+    parseProvider(val: string): string;
+    parseModel(val: string): string;
     parseYes(): boolean;
 }
 export {};