@agentoctopus/cli 0.4.2 → 0.4.4

package/dist/skill-create.js

@@ -0,0 +1,220 @@
+import { input, select, confirm } from '@inquirer/prompts';
+import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
+import { loadOctopusConfig } from './config.js';
+// ── Template scaffold ─────────────────────────────────────────────────────────
+const SKILL_MD_TEMPLATE = `---
+name: my-skill
+description: Describe what this skill does.
+tags: [example]
+version: 1.0.0
+adapter: subprocess
+hosting: local
+auth: none
+input_schema:
+  query: string
+output_schema:
+  result: string
+---
+
+## Instructions
+
+Describe how the skill should behave. The router uses this text to decide
+when to invoke the skill.
+`;
+const INVOKE_JS_TEMPLATE = `#!/usr/bin/env node
+// TODO: implement your skill logic here
+const input = JSON.parse(process.env.OCTOPUS_INPUT || '{}');
+const { query } = input;
+
+// Example: fetch from an external API
+// const res = await fetch(\`https://api.example.com?q=\${query}\`);
+// const data = await res.json();
+
+console.log(JSON.stringify({ result: 'TODO' }));
+`;
+// ── LLM prompt ────────────────────────────────────────────────────────────────
+function buildLLMSystemPrompt() {
+    return `You are generating a SKILL.md file for AgentOctopus.
+
+A SKILL.md file has YAML frontmatter followed by a markdown instructions block.
+Return ONLY the SKILL.md content, no explanation, no markdown code fences.`;
+}
+function buildLLMUserPrompt(answers) {
+    const apiSection = answers.type === 'api'
+        ? `The skill calls an external API.
+Endpoint: ${answers.endpoint || 'not specified'}
+Auth: ${answers.authType || 'none'}
+Sample input/output: ${answers.sampleIO || 'not provided'}`
+        : `The skill is LLM-only (no external API calls).
+Constraints/tone: ${answers.constraints || 'none specified'}`;
+    return `User description: ${answers.description}
+${apiSection}
+
+Generate a valid SKILL.md with this exact structure:
+---
+name: <slug, lowercase, hyphens>
+description: <one sentence, what it does and when to use it>
+tags: [<3-5 relevant tags>]
+version: 1.0.0
+adapter: ${answers.type === 'api' ? 'subprocess' : 'http'}
+hosting: local
+auth: ${answers.authType === 'none' || answers.type === 'llm' ? 'none' : answers.authType || 'none'}
+llm_powered: ${answers.type === 'llm' ? 'true' : 'false'}
+input_schema:
+  query: string
+output_schema:
+  result: string
+---
+
+## Instructions
+
+<2-4 sentences describing the behavior, how to extract input, and what to return>`;
+}
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function resolveSkillsDir() {
+    if (process.env.REGISTRY_PATH)
+        return process.env.REGISTRY_PATH;
+    const config = loadOctopusConfig();
+    if (config?.skillsDir)
+        return config.skillsDir;
+    return path.join(process.cwd(), 'registry', 'skills');
+}
+function writeSkillFiles(skillDir, skillMd, writeScript) {
+    fs.mkdirSync(skillDir, { recursive: true });
+    fs.writeFileSync(path.join(skillDir, 'SKILL.md'), skillMd, 'utf8');
+    if (writeScript) {
+        const scriptsDir = path.join(skillDir, 'scripts');
+        fs.mkdirSync(scriptsDir, { recursive: true });
+        const invokeJs = path.join(scriptsDir, 'invoke.js');
+        if (!fs.existsSync(invokeJs)) {
+            fs.writeFileSync(invokeJs, INVOKE_JS_TEMPLATE, 'utf8');
+        }
+    }
+}
+function extractSkillName(skillMd) {
+    const match = skillMd.match(/^---[\s\S]*?^name:\s*(.+)$/m);
+    return match ? match[1].trim() : 'my-skill';
+}
+// ── Template mode ─────────────────────────────────────────────────────────────
+export async function runSkillTemplate(skillsDir) {
+    const targetDir = skillsDir ?? resolveSkillsDir();
+    const skillName = 'my-skill';
+    const skillDir = path.join(targetDir, skillName);
+    if (fs.existsSync(skillDir)) {
+        console.log(chalk.red(`\n  Directory already exists: ${skillDir}`));
+        console.log(chalk.gray('  Choose a different name or remove the existing skill.\n'));
+        return;
+    }
+    writeSkillFiles(skillDir, SKILL_MD_TEMPLATE, true);
+    console.log(chalk.green(`\n  Scaffolded skill at ${skillDir}`));
+    console.log(chalk.gray('  Edit SKILL.md to define your skill, then restart the server.\n'));
+}
+// ── AI wizard mode ────────────────────────────────────────────────────────────
+export async function runSkillCreateWizard(skillsDir) {
+    const targetDir = skillsDir ?? resolveSkillsDir();
+    console.log(chalk.bold('\n  Skill Create Wizard\n'));
+    const description = await input({
+        message: 'What does your skill do?',
+        validate: (v) => (v.trim().length > 0 ? true : 'Description is required'),
+    });
+    const skillType = await select({
+        message: 'How does it work?',
+        choices: [
+            { value: 'api', name: 'Calls an external API' },
+            { value: 'llm', name: 'LLM-only (no external calls)' },
+        ],
+    });
+    const answers = { description, type: skillType };
+    if (skillType === 'api') {
+        answers.endpoint = await input({ message: 'API endpoint URL (optional, press Enter to skip):' });
+        answers.authType = await select({
+            message: 'Authentication type:',
+            choices: [
+                { value: 'none', name: 'None' },
+                { value: 'api_key', name: 'API key' },
+                { value: 'bearer', name: 'Bearer token' },
+                { value: 'oauth', name: 'OAuth' },
+            ],
+        });
+        answers.sampleIO = await input({ message: 'Describe a sample input and expected output (optional):' });
+    }
+    else {
+        answers.constraints = await input({ message: 'Any constraints, tone, or output format? (optional):' });
+    }
+    // AI generation — use createChatClient from @agentoctopus/core
+    // ChatClient has a .chat(systemPrompt, userMessage) method
+    let llmChat;
+    try {
+        const { createChatClient } = await import('@agentoctopus/core');
+        const llmProvider = process.env.LLM_PROVIDER || 'openai';
+        const llmConfig = {
+            provider: llmProvider,
+            model: process.env.LLM_MODEL || 'gpt-4o-mini',
+            apiKey: process.env.OPENAI_API_KEY || process.env.GEMINI_API_KEY,
+            baseUrl: llmProvider === 'openai' ? process.env.OPENAI_BASE_URL : process.env.OLLAMA_BASE_URL,
+        };
+        const chatClient = createChatClient(llmConfig);
+        llmChat = (systemPrompt, userMessage) => chatClient.chat(systemPrompt, userMessage);
+    }
+    catch {
+        console.error(chalk.red('  Could not initialize LLM client. Falling back to template.'));
+        await runSkillTemplate(targetDir);
+        return;
+    }
+    console.log(chalk.gray('\n  Generating SKILL.md with AI...\n'));
+    let skillMd = '';
+    let additionalNotes = '';
+    while (true) {
+        const systemPrompt = buildLLMSystemPrompt();
+        const userPrompt = buildLLMUserPrompt(answers) +
+            (additionalNotes ? `\n\nAdditional notes: ${additionalNotes}` : '');
+        try {
+            skillMd = await llmChat(systemPrompt, userPrompt);
+        }
+        catch (err) {
+            console.error(chalk.red(`  AI generation failed: ${err.message}`));
+            console.log(chalk.gray('  Falling back to template scaffold.\n'));
+            await runSkillTemplate(targetDir);
+            return;
+        }
+        console.log(chalk.cyan('─── Generated SKILL.md ───────────────────────────────────────'));
+        console.log(skillMd);
+        console.log(chalk.cyan('──────────────────────────────────────────────────────────────\n'));
+        const action = await select({
+            message: 'Does this look right?',
+            choices: [
+                { value: 'yes', name: 'Yes — write the files' },
+                { value: 'regenerate', name: 'Regenerate — add notes for the AI' },
+                { value: 'template', name: 'Use template instead (skip AI)' },
+            ],
+        });
+        if (action === 'yes')
+            break;
+        if (action === 'template') {
+            await runSkillTemplate(targetDir);
+            return;
+        }
+        additionalNotes = await input({ message: 'Notes for the AI (what to change):' });
+    }
+    const skillName = extractSkillName(skillMd);
+    const skillDir = path.join(targetDir, skillName);
+    if (fs.existsSync(skillDir)) {
+        const overwrite = await confirm({
+            message: `Skill directory "${skillDir}" already exists. Overwrite?`,
+            default: false,
+        });
+        if (!overwrite) {
+            console.log(chalk.gray('\n  Cancelled. No files written.\n'));
+            return;
+        }
+    }
+    writeSkillFiles(skillDir, skillMd, skillType === 'api');
+    console.log(chalk.green(`\n  Skill written to ${skillDir}`));
+    if (skillType === 'api') {
+        console.log(chalk.gray('  Edit scripts/invoke.js to implement the API call.'));
+    }
+    console.log(chalk.yellow('  Restart the server to pick up the new skill.\n'));
+}
+//# sourceMappingURL=skill-create.js.map

package/dist/skill-create.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentoctopus/cli",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "AgentOctopus CLI — route natural language queries to skills via `octopus ask`",
   "type": "module",
   "bin": {
@@ -8,7 +8,8 @@
   },
   "files": [
     "README.md",
-    "dist"
+    "dist",
+    "skills"
   ],
   "dependencies": {
     "@inquirer/prompts": "^8.3.2",
@@ -19,8 +20,8 @@
     "ora": "^8.0.1",
     "readline": "^1.3.0",
     "@agentoctopus/core": "0.4.0",
-    "@agentoctopus/gateway": "0.4.1",
-    "@agentoctopus/registry": "0.4.0"
+    "@agentoctopus/registry": "0.4.1",
+    "@agentoctopus/gateway": "0.4.4"
   },
   "devDependencies": {
     "@types/node": "^20.12.0",

package/skills/ip-lookup/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: ip-lookup
+description: >
+  Look up geolocation and network details for a specific IP address or domain name.
+  ONLY use this when the user provides an actual IP address (e.g. 8.8.8.8, 1.1.1.1)
+  or a domain name (e.g. github.com) to look up. Do NOT use for general questions
+  about what ISP, AS, or networking terms mean.
+tags: [ip, geolocation, network, lookup, dns]
+version: 1.0.0
+adapter: subprocess
+hosting: local
+input_schema:
+  query: string
+output_schema:
+  report: string
+auth: none
+rating: 4.6
+invocations: 0
+---
+
+## Instructions
+
+Extract the IP address or domain from the user's query and call ip-api.com
+to retrieve geolocation and ISP information. Return a formatted report.
+If no IP address or domain is present in the query, say so clearly.

package/skills/ip-lookup/scripts/invoke.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+// IP Lookup skill — calls ip-api.com (free, no key, 45 req/min)
+const input = JSON.parse(process.env.OCTOPUS_INPUT || '{}');
+const query = input.query || '';
+
+function extractTarget(q) {
+  // Match an IPv4, IPv6, or domain
+  const ipv4 = q.match(/\b(\d{1,3}(?:\.\d{1,3}){3})\b/);
+  if (ipv4) return ipv4[1];
+  const domain = q.match(/\b([a-zA-Z0-9](?:[a-zA-Z0-9\-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z]{2,})+)\b/);
+  if (domain) return domain[1];
+  return null;
+}
+
+async function main() {
+  const target = extractTarget(query);
+
+  if (!target) {
+    console.log(JSON.stringify({
+      result: 'Please provide an IP address (e.g. 8.8.8.8) or domain name (e.g. github.com) to look up.',
+    }));
+    return;
+  }
+  const url = `http://ip-api.com/json/${encodeURIComponent(target)}?fields=status,message,country,regionName,city,zip,lat,lon,timezone,isp,org,as,query`;
+
+  const res = await fetch(url, { headers: { 'User-Agent': 'AgentOctopus/0.1' } });
+
+  if (!res.ok) {
+    console.error(`ip-api error: ${res.status}`);
+    process.exit(1);
+  }
+
+  const d = await res.json();
+
+  if (d.status === 'fail') {
+    console.log(JSON.stringify({ result: `Lookup failed: ${d.message}` }));
+    return;
+  }
+
+  const report = [
+    `IP / Host  : ${d.query}`,
+    `Location   : ${d.city}, ${d.regionName}, ${d.country}`,
+    `Coordinates: ${d.lat}, ${d.lon}`,
+    `Timezone   : ${d.timezone}`,
+    `ISP        : ${d.isp}`,
+    `Org        : ${d.org}`,
+    `AS         : ${d.as}`,
+  ].join('\n');
+
+  console.log(JSON.stringify({ result: report }));
+}
+
+main().catch((err) => {
+  console.error(err.message);
+  process.exit(1);
+});

package/skills/translation/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: translation
+description: >
+  Translates text between languages using MyMemory. Use when the user asks
+  to translate text, convert language, or says things like "in French",
+  "en Español", "translate to Japanese", etc.
+tags: [translation, language, text, convert]
+version: 2.0.0
+adapter: subprocess
+hosting: local
+input_schema:
+  query: string
+output_schema:
+  translated_text: string
+auth: none
+rating: 4.5
+invocations: 0
+---
+
+## Instructions
+
+Parse the user's query to extract the text to translate and the target language.
+Call the MyMemory free translation API and return the translated text.

package/skills/translation/scripts/invoke.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+// Translation skill — calls MyMemory free API (no key required, 5000 chars/day)
+const input = JSON.parse(process.env.OCTOPUS_INPUT || '{}');
+const query = input.query || '';
+
+// Language code map (common names → ISO 639-1)
+const LANG_CODES = {
+  french: 'fr', spanish: 'es', german: 'de', italian: 'it', portuguese: 'pt',
+  japanese: 'ja', chinese: 'zh', korean: 'ko', arabic: 'ar', russian: 'ru',
+  dutch: 'nl', polish: 'pl', turkish: 'tr', hindi: 'hi', thai: 'th',
+  vietnamese: 'vi', greek: 'el', czech: 'cs', swedish: 'sv', danish: 'da',
+  finnish: 'fi', norwegian: 'no', hebrew: 'he', indonesian: 'id', malay: 'ms',
+  romanian: 'ro', hungarian: 'hu', ukrainian: 'uk',
+};
+
+function detectTargetLang(q) {
+  const lower = q.toLowerCase();
+  for (const [name, code] of Object.entries(LANG_CODES)) {
+    if (lower.includes(name)) return { code, name };
+  }
+  const m = lower.match(/\bto\s+([a-z]{2})\b/);
+  if (m) return { code: m[1], name: m[1] };
+  return { code: 'fr', name: 'French' };
+}
+
+function extractText(q) {
+  return q
+    .replace(/translate\s+(to\s+\w+\s+)?["']?/gi, '')
+    .replace(/\b(to|in|into)\s+(french|spanish|german|italian|portuguese|japanese|chinese|korean|arabic|russian|dutch|polish|turkish|hindi|thai|vietnamese|greek|czech|swedish|danish|finnish|norwegian|hebrew|indonesian|malay|romanian|hungarian|ukrainian|[a-z]{2})\b/gi, '')
+    .replace(/["']/g, '')
+    .trim();
+}
+
+async function main() {
+  const { code: langCode, name: langName } = detectTargetLang(query);
+  const text = extractText(query) || query;
+
+  const url = `https://api.mymemory.translated.net/get?q=${encodeURIComponent(text)}&langpair=en|${langCode}`;
+  const res = await fetch(url, { headers: { 'User-Agent': 'AgentOctopus/0.1' } });
+
+  if (!res.ok) {
+    console.error(`MyMemory error: ${res.status}`);
+    process.exit(1);
+  }
+
+  const data = await res.json();
+  const translated = data.responseData?.translatedText;
+
+  if (!translated) {
+    console.log(JSON.stringify({ result: 'Translation failed — no result returned.' }));
+    return;
+  }
+
+  const langLabel = langName.charAt(0).toUpperCase() + langName.slice(1);
+  console.log(JSON.stringify({
+    result: `"${text}" in ${langLabel}: ${translated}`,
+  }));
+}
+
+main().catch((err) => {
+  console.error(err.message);
+  process.exit(1);
+});

package/skills/weather/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: weather
+description: >
+  Get current weather conditions and forecast for any city or location.
+  Use when the user asks about weather, temperature, rain, forecast,
+  or conditions in a place — e.g. "What's the weather in Tokyo?".
+tags: [weather, forecast, temperature, climate]
+version: 1.0.0
+adapter: subprocess
+hosting: local
+input_schema:
+  query: string
+output_schema:
+  report: string
+auth: none
+rating: 4.8
+invocations: 0
+---
+
+## Instructions
+
+Parse the location from the user's query and call wttr.in to get the current weather report.
+Return a concise plain-text summary including temperature, conditions, humidity, and wind.

package/skills/weather/scripts/invoke.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+// Weather skill — calls wttr.in (free, no API key)
+const input = JSON.parse(process.env.OCTOPUS_INPUT || '{}');
+const query = input.query || '';
+
+// Extract location: strip common phrases like "weather in", "forecast for"
+const location = query
+  .replace(/\b(what('s| is) the |get |show |weather|forecast|temperature|conditions?|climate)\b/gi, '')
+  .replace(/\b(in|for|at|of)\b/gi, '')
+  .trim()
+  .split(/\s+/)
+  .join('+') || 'London';
+
+async function main() {
+  const url = `https://wttr.in/${encodeURIComponent(location)}?format=j1`;
+  const res = await fetch(url, { headers: { 'User-Agent': 'AgentOctopus/0.1' } });
+
+  if (!res.ok) {
+    console.error(`wttr.in error: ${res.status}`);
+    process.exit(1);
+  }
+
+  const data = await res.json();
+  const current = data.current_condition?.[0];
+  const area = data.nearest_area?.[0];
+
+  if (!current) {
+    console.log(JSON.stringify({ result: 'No weather data found for that location.' }));
+    return;
+  }
+
+  const place = [
+    area?.areaName?.[0]?.value,
+    area?.country?.[0]?.value,
+  ].filter(Boolean).join(', ') || location;
+
+  const tempC = current.temp_C;
+  const tempF = current.temp_F;
+  const desc = current.weatherDesc?.[0]?.value || '';
+  const humidity = current.humidity;
+  const windKmph = current.windspeedKmph;
+  const feelsC = current.FeelsLikeC;
+
+  const report = [
+    `Weather in ${place}:`,
+    `  Conditions : ${desc}`,
+    `  Temperature: ${tempC}°C / ${tempF}°F (feels like ${feelsC}°C)`,
+    `  Humidity   : ${humidity}%`,
+    `  Wind       : ${windKmph} km/h`,
+  ].join('\n');
+
+  console.log(JSON.stringify({ result: report }));
+}
+
+main().catch((err) => {
+  console.error(err.message);
+  process.exit(1);
+});

package/skills/x-search/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: x-search
+description: >
+  Search X (Twitter) posts using the xAI Grok API with real-time access to X content.
+tags: [x, twitter, social, search]
+version: 1.0.0
+adapter: subprocess
+hosting: local
+input_schema:
+  query: string
+output_schema:
+  report: string
+auth: api_key
+rating: 3.0
+invocations: 0
+credentials:
+  - key: XAI_API_KEY
+    label: "xAI API Key (get one at console.x.ai)"
+    required: true
+---
+
+## Instructions
+
+Search X (Twitter) for posts matching the user's query using the xAI Grok API.
+Parse the query, call the Grok live-search endpoint, and return a concise
+plain-text summary of the top results including author handles and timestamps.

package/skills/x-search/scripts/invoke.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+// x-search skill — search X/Twitter via xAI Grok API
+const { spawn } = require('child_process');
+const path = require('path');
+
+const input = JSON.parse(process.env.OCTOPUS_INPUT || '{}');
+const query = input.query;
+if (!query || typeof query !== 'string') {
+  console.log(JSON.stringify({ report: 'Missing or invalid query', status: 'error' }));
+  process.exit(0);
+}
+
+const args = [query];
+
+if (input.handles) {
+  const handles = Array.isArray(input.handles) ? input.handles.join(',') : input.handles;
+  args.push('--handles', handles);
+}
+if (input.exclude) {
+  const exclude = Array.isArray(input.exclude) ? input.exclude.join(',') : input.exclude;
+  args.push('--exclude', exclude);
+}
+if (input.from) args.push('--from', input.from);
+if (input.to) args.push('--to', input.to);
+if (input.images) args.push('--images');
+if (input.video) args.push('--video');
+
+// Path to search.py relative to this script's location
+const scriptPath = path.resolve(__dirname, 'search.py');
+
+const proc = spawn('python3', [scriptPath, ...args], {
+  env: { ...process.env },
+  timeout: 120000,
+});
+
+let stdout = '';
+let stderr = '';
+
+proc.stdout.on('data', (data) => { stdout += data; });
+proc.stderr.on('data', (data) => { stderr += data; });
+
+proc.on('close', (code) => {
+  if (code !== 0) {
+    console.log(JSON.stringify({ report: `Search failed: ${stderr || 'unknown error'}`, status: 'error' }));
+    process.exit(0);
+  }
+  try {
+    const result = JSON.parse(stdout);
+    console.log(JSON.stringify({ report: result.text || '', status: result.status || 'completed' }));
+  } catch (e) {
+    console.log(JSON.stringify({ report: `Failed to parse result: ${e.message}`, status: 'error' }));
+  }
+});
+
+proc.on('error', (err) => {
+  console.log(JSON.stringify({ report: `Spawn error: ${err.message}`, status: 'error' }));
+});