felo-ai 0.2.12 → 0.2.14

package/felo-livedoc/README.md

@@ -0,0 +1,53 @@
+# Felo LiveDoc
+
+Manage knowledge bases (LiveDocs) and their resources via the Felo API.
+
+---
+
+## What It Does
+
+- Create, list, update, and delete knowledge bases (LiveDocs)
+- Add resources: text documents, URLs, file uploads
+- Semantic retrieval across knowledge base resources
+- Full CRUD for resources within a LiveDoc
+
+**When to use:**
+- Building or managing a knowledge base
+- Uploading documents or URLs for AI-powered retrieval
+- Searching across your knowledge base with natural language
+
+**When NOT to use:**
+- General web search (use `felo-search`)
+- PPT generation (use `felo-slides`)
+
+---
+
+## Quick Setup
+
+### Step 1: Install
+
+```bash
+claude install Felo-Inc/felo-skills/felo-livedoc
+```
+
+### Step 2: Configure API Key
+
+Get your API key from [felo.ai](https://felo.ai) (Settings → API Keys), then:
+
+```bash
+export FELO_API_KEY="your-api-key-here"
+```
+
+### Step 3: Test
+
+```bash
+felo livedoc list
+```
+
+---
+
+## Usage Examples
+
+```bash
+# Create a knowledge base
+felo livedoc create --name "My KB" --description "Project docs"

package/felo-livedoc/SKILL.md

@@ -0,0 +1,180 @@
+---
+name: felo-livedoc
+description: "Manage Felo LiveDocs (knowledge bases) and their resources. Use when users want to create, manage, or query knowledge bases, upload documents, add URLs, or perform semantic retrieval over a knowledge base. Explicit commands: /felo-livedoc."
+---
+
+# Felo LiveDoc Skill
+
+## When to Use
+
+Trigger this skill when users want to:
+
+- **Create/manage knowledge bases:** Create, list, update, or delete LiveDocs
+- **Add resources:** Upload documents, add URLs, or create text documents in a LiveDoc
+- **Semantic retrieval:** Search across knowledge base resources using natural language queries
+- **Resource management:** List, view, or delete resources within a LiveDoc
+
+**Trigger words:**
+- English: knowledge base, livedoc, live doc, upload document, add URL, semantic search, retrieve, knowledge retrieval
+- 简体中文: 知识库, 文档库, 上传文档, 添加链接, 语义检索, 知识检索
+
+**Explicit commands:** `/felo-livedoc`, "livedoc", "felo livedoc"
+
+**Do NOT use for:**
+- General web search (use felo-search)
+- PPT generation (use felo-slides)
+- SuperAgent conversations (use felo-superAgent)
+
+## Setup
+
+### 1. Get Your API Key
+
+1. Visit [felo.ai](https://felo.ai) and log in (or register)
+2. Click your avatar in the top right corner → Settings
+3. Navigate to the "API Keys" tab
+4. Click "Create New Key" to generate a new API Key
+5. Copy and save your API Key securely
+
+### 2. Configure API Key
+
+Set the `FELO_API_KEY` environment variable:
+
+**Linux/macOS:**
+```bash
+export FELO_API_KEY="your-api-key-here"
+```
+
+**Windows (PowerShell):**
+```powershell
+$env:FELO_API_KEY="your-api-key-here"
+```
+## How to Execute
+
+When this skill is triggered, execute the livedoc script using the Bash tool:
+
+### LiveDoc Management
+
+**Create a LiveDoc:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs create --name "KB Name" --description "Description"
+```
+
+**List LiveDocs:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs list
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs list --keyword "search term"
+```
+
+**Update a LiveDoc:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update SHORT_ID --name "New Name" --description "New Desc"
+```
+
+**Delete a LiveDoc:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs delete SHORT_ID
+```
+
+### Resource Management
+
+**Add a text document:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs add-doc SHORT_ID --title "Doc Title" --content "Document content here"
+```
+
+**Add URLs (max 10, comma-separated):**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs add-urls SHORT_ID --urls "https://example.com,https://example.org"
+```
+
+**Upload a file:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs upload SHORT_ID --file ./document.pdf
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs upload SHORT_ID --file ./document.pdf --convert
+```
+
+**List resources:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs resources SHORT_ID
+```
+
+**Get a single resource:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs resource SHORT_ID RESOURCE_ID
+```
+
+**Delete a resource:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs remove-resource SHORT_ID RESOURCE_ID
+```
+
+### Semantic Retrieval
+
+**Search across resources:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs retrieve SHORT_ID --query "your search query"
+```
+### Options
+
+All commands support:
+- `--json` or `-j` — output raw JSON response
+- `--timeout <ms>` or `-t <ms>` — request timeout in milliseconds (default: 60000)
+
+### Parse and Format Response
+
+The API returns JSON with this structure:
+```json
+{
+  "status": "ok",
+  "message": "success",
+  "data": { ... }
+}
+```
+
+**LiveDoc object:**
+- `short_id` — unique identifier (use this for all operations)
+- `name` — LiveDoc name
+- `description` — LiveDoc description
+- `created_at` / `modified_at` — timestamps
+
+**Resource object:**
+- `id` — resource identifier
+- `title` — resource title
+- `resource_type` — type (web, ai_doc, file, etc.)
+- `status` — processing status
+- `snippet` — content preview
+
+**Retrieve result:**
+- `id` — resource ID
+- `title` — resource title
+- `content` — matched content
+- `score` — relevance score (0-1)
+
+## Error Handling
+
+### Common Error Codes
+
+- `INVALID_API_KEY` — API Key is invalid or revoked
+- `LIVEDOC_NOT_FOUND` — LiveDoc does not exist
+- `LIVEDOC_RESOURCE_NOT_FOUND` — Resource does not exist
+- `LIVEDOC_CREATE_FAILED` — Failed to create LiveDoc
+- `LIVEDOC_RESOURCE_UPLOAD_FAILED` — File upload failed
+- `LIVEDOC_RESOURCE_ADD_URLS_FAILED` — URL addition failed
+- `LIVEDOC_RESOURCE_RETRIEVE_FAILED` — Semantic retrieval failed
+
+### Missing API Key
+
+If `FELO_API_KEY` is not set, display this message:
+
+```
+ERROR: FELO_API_KEY not set. Get your API key from https://felo.ai (Settings → API Keys).
+Set it with: export FELO_API_KEY="your-key"
+```
+
+## Important Notes
+
+- Always use the `short_id` returned from create/list to reference a LiveDoc
+- URL resources are limited to 10 per request
+- Use `--convert` with upload to convert files to searchable documents
+- Semantic retrieval returns results sorted by relevance score
+- Execute immediately using the Bash tool — don't just describe what you would do

package/felo-livedoc/scripts/run_livedoc.mjs

@@ -0,0 +1,391 @@
+#!/usr/bin/env node
+
+import fs from 'fs/promises';
+import path from 'path';
+
+const DEFAULT_API_BASE = 'https://openapi.felo.ai';
+const DEFAULT_TIMEOUT_MS = 60_000;
+const MAX_RETRIES = 3;
+const RETRY_BASE_MS = 1000;
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+const SPINNER_INTERVAL_MS = 80;
+const STATUS_PAD = 56;
+
+function startSpinner(message) {
+  const start = Date.now();
+  let i = 0;
+  const id = setInterval(() => {
+    const elapsed = Math.floor((Date.now() - start) / 1000);
+    const line = `${message} ${SPINNER_FRAMES[i % SPINNER_FRAMES.length]} ${elapsed}s`;
+    process.stderr.write(`\r${line.padEnd(STATUS_PAD, ' ')}`);
+    i += 1;
+  }, SPINNER_INTERVAL_MS);
+  return id;
+}
+
+function stopSpinner(id) {
+  if (id != null) clearInterval(id);
+  process.stderr.write(`\r${' '.repeat(STATUS_PAD)}\r`);
+}
+
+function sleep(ms) { return new Promise((r) => setTimeout(r, ms)); }
+
+function getMessage(p) {
+  return p?.message || p?.error || p?.msg || p?.code || 'Unknown error';
+}
+
+async function fetchWithRetry(url, init, timeoutMs) {
+  let lastError;
+  for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+      const res = await fetch(url, { ...init, signal: controller.signal });
+      if (res.status >= 500 && attempt < MAX_RETRIES) {
+        await sleep(RETRY_BASE_MS * Math.pow(2, attempt));
+        continue;
+      }
+      return res;
+    } catch (err) {
+      lastError = err;
+      if (err.name === 'AbortError') throw new Error(`Request timed out after ${timeoutMs / 1000}s`);
+      if (attempt < MAX_RETRIES) { await sleep(RETRY_BASE_MS * Math.pow(2, attempt)); continue; }
+      throw lastError;
+    } finally { clearTimeout(timer); }
+  }
+  throw lastError;
+}
+
+async function apiRequest(method, apiPath, body, apiKey, apiBase, timeoutMs) {
+  const url = `${apiBase}/v2${apiPath}`;
+  const headers = { Accept: 'application/json', Authorization: `Bearer ${apiKey}` };
+  const init = { method, headers };
+  if (body !== undefined && body !== null) {
+    headers['Content-Type'] = 'application/json';
+    init.body = JSON.stringify(body);
+  }
+  const res = await fetchWithRetry(url, init, timeoutMs);
+  let data = {};
+  try { data = await res.json(); } catch { data = {}; }
+  if (!res.ok) throw new Error(`HTTP ${res.status}: ${getMessage(data)}`);
+  if (data.status === 'error') throw new Error(getMessage(data));
+  return data;
+}
+
+async function uploadFormData(apiPath, formData, apiKey, apiBase, timeoutMs) {
+  const url = `${apiBase}/v2${apiPath}`;
+  const res = await fetchWithRetry(
+    url,
+    { method: 'POST', headers: { Accept: 'application/json', Authorization: `Bearer ${apiKey}` }, body: formData },
+    timeoutMs,
+  );
+  let data = {};
+  try { data = await res.json(); } catch { data = {}; }
+  if (!res.ok) throw new Error(`HTTP ${res.status}: ${getMessage(data)}`);
+  if (data.status === 'error') throw new Error(getMessage(data));
+  return data;
+}
+
+// ── Formatting ──
+
+function formatLiveDoc(doc) {
+  if (!doc) return '';
+  let out = `## ${doc.name || '(untitled)'}\n`;
+  out += `- ID: \`${doc.short_id}\`\n`;
+  if (doc.description) out += `- Description: ${doc.description}\n`;
+  if (doc.icon) out += `- Icon: ${doc.icon}\n`;
+  if (doc.created_at) out += `- Created: ${doc.created_at}\n`;
+  if (doc.modified_at) out += `- Modified: ${doc.modified_at}\n`;
+  out += '\n';
+  return out;
+}
+
+function formatResource(r) {
+  if (!r) return '';
+  let out = `### ${r.title || '(untitled)'}\n`;
+  out += `- Resource ID: \`${r.id}\`\n`;
+  if (r.resource_type) out += `- Type: ${r.resource_type}\n`;
+  if (r.status) out += `- Status: ${r.status}\n`;
+  if (r.source) out += `- Source: ${r.source}\n`;
+  if (r.link) out += `- Link: ${r.link}\n`;
+  if (r.snippet) out += `- Snippet: ${r.snippet}\n`;
+  if (r.created_at) out += `- Created: ${r.created_at}\n`;
+  out += '\n';
+  return out;
+}
+function formatRetrieveResult(r) {
+  if (!r) return '';
+  const score = r.score != null ? `${(r.score * 100).toFixed(1)}%` : 'N/A';
+  let out = `### ${r.title || '(untitled)'} (score: ${score})\n`;
+  out += `- ID: \`${r.id}\`\n`;
+  if (r.content) {
+    const preview = r.content.length > 300 ? r.content.slice(0, 300) + '...' : r.content;
+    out += `- Content: ${preview}\n`;
+  }
+  out += '\n';
+  return out;
+}
+
+// ── CLI ──
+
+function usage() {
+  console.error([
+    'Usage: node run_livedoc.mjs <action> [args] [options]',
+    '',
+    'Actions:',
+    '  create                Create a LiveDoc (--name required)',
+    '  list                  List LiveDocs',
+    '  update <short_id>     Update a LiveDoc',
+    '  delete <short_id>     Delete a LiveDoc',
+    '  resources <short_id>  List resources',
+    '  resource <short_id> <resource_id>  Get a resource',
+    '  add-doc <short_id>    Create text document (--content required)',
+    '  add-urls <short_id>   Add URLs (--urls required, comma-separated, max 10)',
+    '  upload <short_id>     Upload file (--file required, --convert optional)',
+    '  remove-resource <short_id> <resource_id>  Delete a resource',
+    '  retrieve <short_id>   Semantic search (--query required)',
+    '',
+    'Options:',
+    '  --name <name>         LiveDoc name',
+    '  --description <desc>  LiveDoc description',
+    '  --icon <icon>         LiveDoc icon',
+    '  --keyword <kw>        Search keyword (list)',
+    '  --page <n>            Page number',
+    '  --size <n>            Page size',
+    '  --type <type>         Resource type filter',
+    '  --content <text>      Document content',
+    '  --title <title>       Document title',
+    '  --urls <urls>         Comma-separated URLs',
+    '  --file <path>         File path to upload',
+    '  --convert             Convert uploaded file to document',
+    '  --query <text>        Retrieval query',
+    '  -j, --json            Output raw JSON',
+    '  -t, --timeout <ms>    Timeout in ms (default: 60000)',
+    '  --help                Show this help',
+  ].join('\n'));
+}
+function parseArgs(argv) {
+  const out = {
+    action: '', positional: [], name: '', description: '', icon: '',
+    keyword: '', page: '', size: '', type: '', content: '', title: '',
+    urls: '', file: '', convert: false, query: '',
+    json: false, timeoutMs: DEFAULT_TIMEOUT_MS, help: false,
+  };
+  const positional = [];
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--help' || a === '-h') out.help = true;
+    else if (a === '--json' || a === '-j') out.json = true;
+    else if (a === '--convert') out.convert = true;
+    else if (a === '--name') out.name = argv[++i] || '';
+    else if (a === '--description') out.description = argv[++i] || '';
+    else if (a === '--icon') out.icon = argv[++i] || '';
+    else if (a === '--keyword') out.keyword = argv[++i] || '';
+    else if (a === '--page') out.page = argv[++i] || '';
+    else if (a === '--size') out.size = argv[++i] || '';
+    else if (a === '--type') out.type = argv[++i] || '';
+    else if (a === '--content') out.content = argv[++i] || '';
+    else if (a === '--title') out.title = argv[++i] || '';
+    else if (a === '--urls') out.urls = argv[++i] || '';
+    else if (a === '--file') out.file = argv[++i] || '';
+    else if (a === '--query') out.query = argv[++i] || '';
+    else if (a === '-t' || a === '--timeout') {
+      const n = parseInt(argv[++i] || '', 10);
+      if (Number.isFinite(n) && n > 0) out.timeoutMs = n;
+    }
+    else if (!a.startsWith('-')) positional.push(a);
+  }
+  out.action = positional[0] || '';
+  out.positional = positional.slice(1);
+  return out;
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  if (args.help || !args.action) { usage(); process.exit(args.help ? 0 : 1); }
+
+  const apiKey = process.env.FELO_API_KEY?.trim();
+  if (!apiKey) { console.error('ERROR: FELO_API_KEY not set'); process.exit(1); }
+
+  const apiBase = (process.env.FELO_API_BASE?.trim() || DEFAULT_API_BASE).replace(/\/$/, '');
+  const { action, positional, json, timeoutMs } = args;
+  const shortId = positional[0] || '';
+  const resourceId = positional[1] || '';
+
+  let code = 1;
+  let spinnerId;
+  try {
+    switch (action) {
+      case 'create': {
+        if (!args.name) { console.error('ERROR: --name is required'); break; }
+        spinnerId = startSpinner('Creating LiveDoc');
+        const body = { name: args.name };
+        if (args.description) body.description = args.description;
+        if (args.icon) body.icon = args.icon;
+        const payload = await apiRequest('POST', '/livedocs', body, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else { process.stdout.write('LiveDoc created!\n\n'); process.stdout.write(formatLiveDoc(payload?.data)); }
+        code = 0;
+        break;
+      }
+      case 'list': {
+        spinnerId = startSpinner('Listing LiveDocs');
+        const params = new URLSearchParams();
+        if (args.keyword) params.set('keyword', args.keyword);
+        if (args.page) params.set('page', args.page);
+        if (args.size) params.set('size', args.size);
+        const qs = params.toString();
+        const payload = await apiRequest('GET', `/livedocs${qs ? `?${qs}` : ''}`, null, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else {
+          const items = payload?.data?.items || [];
+          if (!items.length) { process.stderr.write('No LiveDocs found.\n'); }
+          else {
+            process.stdout.write(`Found ${payload.data.total || items.length} LiveDoc(s)\n\n`);
+            for (const doc of items) process.stdout.write(formatLiveDoc(doc));
+          }
+        }
+        code = 0;
+        break;
+      }
+      case 'update': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        spinnerId = startSpinner('Updating LiveDoc');
+        const body = {};
+        if (args.name) body.name = args.name;
+        if (args.description) body.description = args.description;
+        const payload = await apiRequest('PUT', `/livedocs/${shortId}`, body, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else { process.stdout.write('LiveDoc updated!\n\n'); process.stdout.write(formatLiveDoc(payload?.data)); }
+        code = 0;
+        break;
+      }
+      case 'delete': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        spinnerId = startSpinner('Deleting LiveDoc');
+        await apiRequest('DELETE', `/livedocs/${shortId}`, null, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify({ status: 'ok' }, null, 2)); }
+        else { process.stdout.write(`LiveDoc \`${shortId}\` deleted.\n`); }
+        code = 0;
+        break;
+      }
+      case 'resources': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        spinnerId = startSpinner('Listing resources');
+        const params = new URLSearchParams();
+        if (args.type) params.set('resource_types', args.type);
+        if (args.page) params.set('page', args.page);
+        if (args.size) params.set('size', args.size);
+        const qs = params.toString();
+        const payload = await apiRequest('GET', `/livedocs/${shortId}/resources${qs ? `?${qs}` : ''}`, null, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else {
+          const items = payload?.data?.items || [];
+          if (!items.length) { process.stderr.write('No resources found.\n'); }
+          else {
+            process.stdout.write(`Found ${payload.data.total || items.length} resource(s)\n\n`);
+            for (const r of items) process.stdout.write(formatResource(r));
+          }
+        }
+        code = 0;
+        break;
+      }
+      case 'resource': {
+        if (!shortId || !resourceId) { console.error('ERROR: short_id and resource_id are required'); break; }
+        spinnerId = startSpinner('Fetching resource');
+        const payload = await apiRequest('GET', `/livedocs/${shortId}/resources/${resourceId}`, null, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else { process.stdout.write(formatResource(payload?.data)); }
+        code = 0;
+        break;
+      }
+      case 'add-doc': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        if (!args.content) { console.error('ERROR: --content is required'); break; }
+        spinnerId = startSpinner('Creating document');
+        const body = { content: args.content };
+        if (args.title) body.title = args.title;
+        const payload = await apiRequest('POST', `/livedocs/${shortId}/resources/doc`, body, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else { process.stdout.write('Document created!\n\n'); process.stdout.write(formatResource(payload?.data)); }
+        code = 0;
+        break;
+      }
+      case 'add-urls': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        if (!args.urls) { console.error('ERROR: --urls is required'); break; }
+        const urls = args.urls.split(',').map(u => u.trim()).filter(Boolean);
+        if (urls.length > 10) { console.error('ERROR: maximum 10 URLs allowed'); break; }
+        spinnerId = startSpinner(`Adding ${urls.length} URL(s)`);
+        const payload = await apiRequest('POST', `/livedocs/${shortId}/resources/urls`, { urls }, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else {
+          for (const r of (payload?.data || [])) {
+            const icon = r.status === 'success' ? '✓' : r.status === 'existed' ? '~' : '✗';
+            let line = `${icon} ${r.url} → ${r.status}`;
+            if (r.resource_id) line += ` (id: ${r.resource_id})`;
+            if (r.fail_reason) line += ` (${r.fail_reason})`;
+            process.stdout.write(line + '\n');
+          }
+        }
+        code = 0;
+        break;
+      }
+      case 'upload': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        if (!args.file) { console.error('ERROR: --file is required'); break; }
+        const endpoint = args.convert ? 'upload-doc' : 'upload';
+        spinnerId = startSpinner(`Uploading file (${endpoint})`);
+        const fileBuffer = await fs.readFile(args.file);
+        const blob = new Blob([fileBuffer]);
+        const formData = new FormData();
+        formData.append('file', blob, path.basename(args.file));
+        const payload = await uploadFormData(`/livedocs/${shortId}/resources/${endpoint}`, formData, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else { process.stdout.write('File uploaded!\n\n'); process.stdout.write(formatResource(payload?.data)); }
+        code = 0;
+        break;
+      }
+      case 'remove-resource': {
+        if (!shortId || !resourceId) { console.error('ERROR: short_id and resource_id are required'); break; }
+        spinnerId = startSpinner('Deleting resource');
+        await apiRequest('DELETE', `/livedocs/${shortId}/resources/${resourceId}`, null, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify({ status: 'ok' }, null, 2)); }
+        else { process.stdout.write(`Resource \`${resourceId}\` deleted.\n`); }
+        code = 0;
+        break;
+      }
+      case 'retrieve': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        if (!args.query) { console.error('ERROR: --query is required'); break; }
+        spinnerId = startSpinner('Retrieving from knowledge base');
+        const payload = await apiRequest('POST', `/livedocs/${shortId}/resources/retrieve`, { content: args.query }, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else {
+          const results = payload?.data || [];
+          if (!results.length) { process.stderr.write('No results found.\n'); }
+          else {
+            process.stdout.write(`Found ${results.length} result(s)\n\n`);
+            for (const r of results) process.stdout.write(formatRetrieveResult(r));
+          }
+        }
+        code = 0;
+        break;
+      }
+      default:
+        console.error(`Unknown action: ${action}`);
+        usage();
+    }
+  } catch (err) {
+    process.stderr.write(`Error: ${err?.message || err}\n`);
+  } finally {
+    stopSpinner(spinnerId);
+  }
+
+  process.exit(code);
+}
+
+main().catch((err) => {
+  process.stderr.write(`Fatal: ${err?.message || err}\n`);
+  process.exit(1);
+});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "felo-ai",
-  "version": "0.2.12",
-  "description": "Felo AI CLI - real-time search, PPT generation, web fetch, and YouTube subtitles from the terminal",
+  "version": "0.2.14",
+  "description": "Felo AI CLI - real-time search, PPT generation, web fetch, YouTube subtitles, LiveDoc knowledge base from the terminal",
   "type": "module",
   "main": "src/cli.js",
   "bin": {
@@ -19,6 +19,8 @@
     "youtube-subtitles",
     "x-search",
     "twitter",
+    "livedoc",
+    "knowledge-base",
     "cli",
     "ai"
   ],