felo-ai 0.2.28 → 0.2.31

package/.claude-plugin/marketplace.json

@@ -0,0 +1,85 @@
+{
+  "name": "felo-ai",
+  "owner": {
+    "name": "Felo-Inc",
+    "url": "https://github.com/Felo-Inc"
+  },
+  "metadata": {
+    "description": "Felo AI skills for Claude Code — real-time search, PPT generation, SuperAgent, LiveDoc knowledge base, web fetch, YouTube subtitles, and X (Twitter) search",
+    "version": "1.0.0"
+  },
+  "plugins": [
+    {
+      "name": "felo-search",
+      "description": "Real-time web search powered by Felo AI",
+      "source": "./",
+      "strict": false,
+      "skills": [
+        "./felo-search"
+      ]
+    },
+    {
+      "name": "felo-livedoc",
+      "description": "Manage knowledge bases (LiveDocs) and semantic retrieval via Felo API",
+      "source": "./",
+      "strict": false,
+      "skills": [
+        "./felo-livedoc"
+      ]
+    },
+    {
+      "name": "felo-slides",
+      "description": "Generate PPT presentations from a prompt using Felo AI",
+      "source": "./",
+      "strict": false,
+      "skills": [
+        "./felo-slides"
+      ]
+    },
+    {
+      "name": "felo-superAgent",
+      "description": "SuperAgent conversation with SSE streaming and LiveDoc integration",
+      "source": "./",
+      "strict": false,
+      "skills": [
+        "./felo-superAgent"
+      ]
+    },
+    {
+      "name": "felo-web-fetch",
+      "description": "Fetch and extract webpage content in markdown, text, or HTML format",
+      "source": "./",
+      "strict": false,
+      "skills": [
+        "./felo-web-fetch"
+      ]
+    },
+    {
+      "name": "felo-youtube-subtitling",
+      "description": "Fetch YouTube video subtitles and captions by URL or video ID",
+      "source": "./",
+      "strict": false,
+      "skills": [
+        "./felo-youtube-subtitling"
+      ]
+    },
+    {
+      "name": "felo-x-search",
+      "description": "Search X (Twitter) tweets, users, and replies via Felo API",
+      "source": "./",
+      "strict": false,
+      "skills": [
+        "./felo-x-search"
+      ]
+    },
+    {
+      "name": "felo-content-to-slides",
+      "description": "Fetch content from a webpage or YouTube video and generate a PPT",
+      "source": "./",
+      "strict": false,
+      "skills": [
+        "./felo-content-to-slides"
+      ]
+    }
+  ]
+}

package/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.29] - 2026-03-18
+
+### Fixed
+
+- Fix spinner animation displaying repeated lines in non-TTY environments (e.g. Claude Code TUI, pipes, CI) by checking `process.stderr.isTTY` before writing `\r` control characters; spinner is silently skipped when stderr is not a TTY
+
+---
+
 ## [0.2.25] - 2026-03-17
 
 ### Added

package/felo-content-to-slides/SKILL.md

@@ -56,6 +56,7 @@ felo content-to-slides -v "https://www.youtube.com/watch?v=ID" [options]
 | `-l, --language <code>` | For --video: subtitle language (e.g. en, zh-CN) |
 | `-t, --timeout <seconds>` | Fetch timeout (default 60) |
 | `--poll-timeout <seconds>` | Max seconds to wait for PPT task (default 1200) |
+| `--theme <id>` | PPT theme ID (list themes with `felo ppt-themes`) |
 | `-j, --json` | Output JSON with task_id and ppt/live_doc URL |
 | `--verbose` | Show polling status |
 
@@ -67,6 +68,9 @@ Provide **either** `--url` or `--video`, not both.
 # Web page → PPT (with readability)
 node src/cli.js content-to-slides --url "https://openclaw.ai/" --readability
 
+# Web page → PPT with a specific theme
+node src/cli.js content-to-slides --url "https://openclaw.ai/" --readability --theme "THEME_ID"
+
 # YouTube → PPT, with extra instruction
 node src/cli.js content-to-slides -v "https://www.youtube.com/watch?v=xxx" --extra-prompt "max 10 slides"
 

package/felo-livedoc/README.md

@@ -11,6 +11,8 @@ Manage knowledge bases (LiveDocs) and their resources via the Felo API.
 - Semantic retrieval across knowledge base resources
 - Route relevant resources by query for targeted retrieval
 - Full CRUD for resources within a LiveDoc
+- Manage README content for each LiveDoc
+- Task management: create, update, delete tasks with comments and change history
 
 **When to use:**
 - Building or managing a knowledge base
@@ -87,8 +89,19 @@ felo livedoc route SHORT_ID --query "latest AI research" --max-resources 5
 | `add-urls <short_id>` | Add URL resources (max 10) |
 | `upload <short_id>` | Upload a file resource |
 | `remove-resource <short_id> <resource_id>` | Delete a resource |
+| `update-resource <short_id> <resource_id>` | Update resource title, snippet, or thumbnail |
 | `retrieve <short_id>` | Semantic retrieval (auto-routes if no `--resource-ids`) |
 | `route <short_id>` | Route relevant resource IDs by query |
+| `get-readme <short_id>` | Get README content |
+| `update-readme <short_id>` | Create or replace README |
+| `append-readme <short_id>` | Append content to README |
+| `delete-readme <short_id>` | Delete README |
+| `tasks <short_id>` | List tasks (filter by `--status`, `--labels`) |
+| `create-task <short_id>` | Create a task |
+| `update-task <short_id> <task_id>` | Partially update a task |
+| `delete-task <short_id> <task_id>` | Delete a task |
+| `task-records <short_id> <task_id>` | List task records (comments + change history) |
+| `add-task-comment <short_id> <task_id>` | Add a comment to a task |
 
 ---
 

package/felo-livedoc/SKILL.md

@@ -14,10 +14,12 @@ Trigger this skill when users want to:
 - **Semantic retrieval:** Search across knowledge base resources using natural language queries
 - **Route resources:** Find relevant resource IDs by query for targeted retrieval
 - **Resource management:** List, view, or delete resources within a LiveDoc
+- **README management:** Get, create, update, append, or delete a LiveDoc's README
+- **Task management:** Create, update, delete tasks; add comments; view change history
 
 **Trigger words:**
-- English: knowledge base, livedoc, live doc, upload document, add URL, semantic search, retrieve, knowledge retrieval, route resources
-- 简体中文: 知识库, 文档库, 上传文档, 添加链接, 语义检索, 知识检索
+- English: knowledge base, livedoc, live doc, upload document, add URL, semantic search, retrieve, knowledge retrieval, route resources, readme, task, task management, comment
+- 简体中文: 知识库, 文档库, 上传文档, 添加链接, 语义检索, 知识检索, 任务, 任务管理, 评论
 
 **Explicit commands:** `/felo-livedoc`, "livedoc", "felo livedoc"
 
@@ -111,6 +113,12 @@ node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs resource SHORT_ID RES
 node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs remove-resource SHORT_ID RESOURCE_ID
 ```
 
+**Update a resource (title/snippet/thumbnail):**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update-resource SHORT_ID RESOURCE_ID --title "New Title"
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update-resource SHORT_ID RESOURCE_ID --snippet "New summary" --thumbnail "https://example.com/thumb.png"
+```
+
 ### Semantic Retrieval
 
 **Route relevant resources by query:**
@@ -147,6 +155,67 @@ node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs content SHORT_ID RESO
 node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs ppt-retrieve SHORT_ID --resource-id RESOURCE_ID --page-number 3 --query "pricing information"
 node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs ppt-retrieve SHORT_ID --resource-id RESOURCE_ID --page-number 3 --query "pricing information" --max-chunk 5
 ```
+
+### README Management
+
+**Get README:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs get-readme SHORT_ID
+```
+
+**Create or replace README:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update-readme SHORT_ID --content "# My KB\n\nThis is the README."
+```
+
+**Append to README:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs append-readme SHORT_ID --content "\n\n## New Section\n\nAdditional content."
+```
+
+**Delete README:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs delete-readme SHORT_ID
+```
+
+### Task Management
+
+**List tasks (with optional filters):**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs tasks SHORT_ID
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs tasks SHORT_ID --status 0
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs tasks SHORT_ID --labels "docs,priority-high"
+```
+
+**Create a task:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs create-task SHORT_ID --title "Write docs" --status 0 --sort 0
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs create-task SHORT_ID --title "Write docs" --status 0 --sort 0 --description "API docs" --labels "docs"
+```
+
+Task status values: `0`=TODO, `1`=IN_PROGRESS, `2`=DONE
+
+**Update a task (partial update):**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update-task SHORT_ID TASK_ID --status 1
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update-task SHORT_ID TASK_ID --title "New title" --labels "docs,done"
+```
+
+**Delete a task:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs delete-task SHORT_ID TASK_ID
+```
+
+**List task records (comments + change history):**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs task-records SHORT_ID TASK_ID
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs task-records SHORT_ID TASK_ID --record-type comment
+```
+
+**Add a comment to a task:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs add-task-comment SHORT_ID TASK_ID --content "This is a comment."
+```
 ### Options
 
 All commands support:
@@ -194,6 +263,16 @@ The API returns JSON with this structure:
 - `LIVEDOC_RESOURCE_UPLOAD_FAILED` — File upload failed
 - `LIVEDOC_RESOURCE_ADD_URLS_FAILED` — URL addition failed
 - `LIVEDOC_RESOURCE_RETRIEVE_FAILED` — Semantic retrieval failed
+- `LIVEDOC_README_GET_FAILED` — Failed to get README
+- `LIVEDOC_README_UPDATE_FAILED` — Failed to create or update README
+- `LIVEDOC_README_DELETE_FAILED` — Failed to delete README
+- `LIVEDOC_TASK_LIST_FAILED` — Failed to list tasks
+- `LIVEDOC_TASK_CREATE_FAILED` — Failed to create task
+- `LIVEDOC_TASK_UPDATE_FAILED` — Failed to update task
+- `LIVEDOC_TASK_DELETE_FAILED` — Failed to delete task
+- `LIVEDOC_TASK_NOT_FOUND` — Task does not exist
+- `LIVEDOC_TASK_RECORD_LIST_FAILED` — Failed to list task records
+- `LIVEDOC_TASK_COMMENT_CREATE_FAILED` — Failed to add comment
 
 ### Missing API Key
 

package/felo-livedoc/scripts/run_livedoc.mjs

@@ -12,6 +12,7 @@ const SPINNER_INTERVAL_MS = 80;
 const STATUS_PAD = 56;
 
 function startSpinner(message) {
+  if (!process.stderr.isTTY) return null;
   const start = Date.now();
   let i = 0;
   const id = setInterval(() => {
@@ -25,7 +26,7 @@ function startSpinner(message) {
 
 function stopSpinner(id) {
   if (id != null) clearInterval(id);
-  process.stderr.write(`\r${' '.repeat(STATUS_PAD)}\r`);
+  if (process.stderr.isTTY) process.stderr.write(`\r${' '.repeat(STATUS_PAD)}\r`);
 }
 
 function sleep(ms) { return new Promise((r) => setTimeout(r, ms)); }
@@ -126,6 +127,28 @@ function formatRetrieveResult(r) {
   return out;
 }
 
+function formatTask(t) {
+  if (!t) return '';
+  let out = `### ${t.title || '(untitled)'}\n`;
+  out += `- Task ID: \`${t.id}\`\n`;
+  out += `- Status: ${t.status === 0 ? 'TODO' : t.status === 1 ? 'IN_PROGRESS' : t.status === 2 ? 'DONE' : t.status}\n`;
+  if (t.sort != null) out += `- Sort: ${t.sort}\n`;
+  if (t.description) out += `- Description: ${t.description}\n`;
+  if (t.labels?.length) out += `- Labels: ${t.labels.join(', ')}\n`;
+  if (t.created_at) out += `- Created: ${t.created_at}\n`;
+  out += '\n';
+  return out;
+}
+
+function formatTaskRecord(r) {
+  if (!r) return '';
+  let out = `- [${r.record_type}] `;
+  if (r.content) out += r.content;
+  else if (r.meta) out += JSON.stringify(r.meta);
+  out += `  (id: ${r.id}, ${r.created_at || ''})\n`;
+  return out;
+}
+
 // ── CLI ──
 
 function usage() {
@@ -143,11 +166,22 @@ function usage() {
     '  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',
+    '  update-resource <short_id> <resource_id>  Update resource title/snippet/thumbnail',
     '  retrieve <short_id>   Semantic search (--query required, --resource-ids optional)',
     '  route <short_id>      Route relevant resources by query (--query required)',
     '  download <short_id> <resource_id>  Download source file to disk',
     '  content <short_id> <resource_id>   Get text content of a resource',
     '  ppt-retrieve <short_id>  PPT page deep retrieval (--resource-id, --page-number, --query required)',
+    '  get-readme <short_id>    Get README content',
+    '  update-readme <short_id> Create or replace README (--content required)',
+    '  append-readme <short_id> Append to README (--content required)',
+    '  delete-readme <short_id> Delete README',
+    '  tasks <short_id>         List tasks (--status, --labels optional)',
+    '  create-task <short_id>   Create a task (--title, --status, --sort required)',
+    '  update-task <short_id> <task_id>  Partially update a task',
+    '  delete-task <short_id> <task_id>  Delete a task',
+    '  task-records <short_id> <task_id> List task records (comments + history)',
+    '  add-task-comment <short_id> <task_id>  Add a comment (--content required)',
     '',
     'Options:',
     '  --name <name>         LiveDoc name',
@@ -157,8 +191,8 @@ function usage() {
     '  --page <n>            Page number',
     '  --size <n>            Page size',
     '  --type <type>         Resource type filter',
-    '  --content <text>      Document content',
-    '  --title <title>       Document title',
+    '  --content <text>      Document/README/comment content',
+    '  --title <title>       Document/task title',
     '  --urls <urls>         Comma-separated URLs',
     '  --file <path>         File path to upload',
     '  --convert             Convert uploaded file to document',
@@ -170,6 +204,10 @@ function usage() {
     '  --max-chunk <n>       Max chunks to return (ppt-retrieve, default 3)',
     '  --expires-in <s>      Presigned URL expiry in seconds (download, default 3600)',
     '  --output <path>       Output file path (download, default: filename from response)',
+    '  --status <n>          Task status: 0=TODO, 1=IN_PROGRESS, 2=DONE',
+    '  --sort <n>            Task sort order (non-negative integer)',
+    '  --labels <labels>     Comma-separated labels (tasks)',
+    '  --record-type <type>  Record type filter: comment, edit, status_change',
     '  -j, --json            Output raw JSON',
     '  -t, --timeout <ms>    Timeout in ms (default: 60000)',
     '  --help                Show this help',
@@ -180,7 +218,8 @@ function parseArgs(argv) {
     action: '', positional: [], name: '', description: '', icon: '',
     keyword: '', page: '', size: '', type: '', content: '', title: '',
     urls: '', file: '', convert: false, query: '', resourceIds: '', maxResources: '',
-    resourceId: '', pageNumber: '', maxChunk: '', expiresIn: '',
+    resourceId: '', pageNumber: '', maxChunk: '', expiresIn: '', output: '',
+    status: '', sort: '', labels: '', recordType: '',
     json: false, timeoutMs: DEFAULT_TIMEOUT_MS, help: false,
   };
   const positional = [];
@@ -207,6 +246,11 @@ function parseArgs(argv) {
     else if (a === '--page-number') out.pageNumber = argv[++i] || '';
     else if (a === '--max-chunk') out.maxChunk = argv[++i] || '';
     else if (a === '--expires-in') out.expiresIn = argv[++i] || '';
+    else if (a === '--output') out.output = argv[++i] || '';
+    else if (a === '--status') out.status = argv[++i] || '';
+    else if (a === '--sort') out.sort = argv[++i] || '';
+    else if (a === '--labels') out.labels = argv[++i] || '';
+    else if (a === '--record-type') out.recordType = argv[++i] || '';
     else if (a === '-t' || a === '--timeout') {
       const n = parseInt(argv[++i] || '', 10);
       if (Number.isFinite(n) && n > 0) out.timeoutMs = n;
@@ -373,6 +417,19 @@ async function main() {
         code = 0;
         break;
       }
+      case 'update-resource': {
+        if (!shortId || !resourceId) { console.error('ERROR: short_id and resource_id are required'); break; }
+        spinnerId = startSpinner('Updating resource');
+        const body = {};
+        if (args.title !== undefined) body.title = args.title;
+        if (args.snippet !== undefined) body.snippet = args.snippet;
+        if (args.thumbnail !== undefined) body.thumbnail = args.thumbnail;
+        const payload = await apiRequest('PUT', `/livedocs/${shortId}/resources/${resourceId}`, body, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else { process.stdout.write('Resource updated!\n\n'); process.stdout.write(formatResource(payload?.data)); }
+        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; }
@@ -489,6 +546,140 @@ async function main() {
         code = 0;
         break;
       }
+      case 'get-readme': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        spinnerId = startSpinner('Fetching README');
+        const payload = await apiRequest('GET', `/livedocs/${shortId}/readme`, null, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else { process.stdout.write(payload?.data?.content || '(empty)\n'); }
+        code = 0;
+        break;
+      }
+      case 'update-readme': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        if (args.content === undefined || args.content === '') { console.error('ERROR: --content is required'); break; }
+        spinnerId = startSpinner('Updating README');
+        await apiRequest('PUT', `/livedocs/${shortId}/readme`, { content: args.content }, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify({ status: 'ok' }, null, 2)); }
+        else { process.stdout.write('README updated.\n'); }
+        code = 0;
+        break;
+      }
+      case 'append-readme': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        if (!args.content) { console.error('ERROR: --content is required'); break; }
+        spinnerId = startSpinner('Appending to README');
+        await apiRequest('POST', `/livedocs/${shortId}/readme/append`, { content: args.content }, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify({ status: 'ok' }, null, 2)); }
+        else { process.stdout.write('README appended.\n'); }
+        code = 0;
+        break;
+      }
+      case 'delete-readme': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        spinnerId = startSpinner('Deleting README');
+        await apiRequest('DELETE', `/livedocs/${shortId}/readme`, null, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify({ status: 'ok' }, null, 2)); }
+        else { process.stdout.write('README deleted.\n'); }
+        code = 0;
+        break;
+      }
+      case 'tasks': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        spinnerId = startSpinner('Listing tasks');
+        const params = new URLSearchParams();
+        if (args.status !== '') params.set('status', args.status);
+        if (args.labels) args.labels.split(',').map(l => l.trim()).filter(Boolean).forEach(l => params.append('labels', l));
+        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}/tasks${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 tasks found.\n'); }
+          else {
+            process.stdout.write(`Found ${payload.data.total || items.length} task(s)\n\n`);
+            for (const t of items) process.stdout.write(formatTask(t));
+          }
+        }
+        code = 0;
+        break;
+      }
+      case 'create-task': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        if (!args.title) { console.error('ERROR: --title is required'); break; }
+        if (args.status === '') { console.error('ERROR: --status is required'); break; }
+        if (args.sort === '') { console.error('ERROR: --sort is required'); break; }
+        spinnerId = startSpinner('Creating task');
+        const body = { title: args.title, status: parseInt(args.status, 10), sort: parseInt(args.sort, 10) };
+        if (args.description) body.description = args.description;
+        if (args.labels) body.labels = args.labels.split(',').map(l => l.trim()).filter(Boolean);
+        const payload = await apiRequest('POST', `/livedocs/${shortId}/tasks`, body, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else { process.stdout.write('Task created!\n\n'); process.stdout.write(formatTask(payload?.data)); }
+        code = 0;
+        break;
+      }
+      case 'update-task': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        if (!resourceId) { console.error('ERROR: task_id is required'); break; }
+        spinnerId = startSpinner('Updating task');
+        const body = {};
+        if (args.title) body.title = args.title;
+        if (args.description !== undefined) body.description = args.description;
+        if (args.status !== '') body.status = parseInt(args.status, 10);
+        if (args.sort !== '') body.sort = parseInt(args.sort, 10);
+        if (args.labels !== undefined) body.labels = args.labels.split(',').map(l => l.trim()).filter(Boolean);
+        const payload = await apiRequest('PATCH', `/livedocs/${shortId}/tasks/${resourceId}`, body, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else { process.stdout.write('Task updated!\n\n'); process.stdout.write(formatTask(payload?.data)); }
+        code = 0;
+        break;
+      }
+      case 'delete-task': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        if (!resourceId) { console.error('ERROR: task_id is required'); break; }
+        spinnerId = startSpinner('Deleting task');
+        await apiRequest('DELETE', `/livedocs/${shortId}/tasks/${resourceId}`, null, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify({ status: 'ok' }, null, 2)); }
+        else { process.stdout.write(`Task \`${resourceId}\` deleted.\n`); }
+        code = 0;
+        break;
+      }
+      case 'task-records': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        if (!resourceId) { console.error('ERROR: task_id is required'); break; }
+        spinnerId = startSpinner('Fetching task records');
+        const params = new URLSearchParams();
+        if (args.recordType) params.set('record_type', args.recordType);
+        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}/tasks/${resourceId}/records${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 records found.\n'); }
+          else {
+            process.stdout.write(`Found ${payload.data.total || items.length} record(s)\n\n`);
+            for (const r of items) process.stdout.write(formatTaskRecord(r));
+          }
+        }
+        code = 0;
+        break;
+      }
+      case 'add-task-comment': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        if (!resourceId) { console.error('ERROR: task_id is required'); break; }
+        if (!args.content) { console.error('ERROR: --content is required'); break; }
+        spinnerId = startSpinner('Adding comment');
+        const payload = await apiRequest('POST', `/livedocs/${shortId}/tasks/${resourceId}/comments`, { content: args.content }, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else { process.stdout.write('Comment added.\n'); process.stdout.write(formatTaskRecord(payload?.data)); }
+        code = 0;
+        break;
+      }
       default:
         console.error(`Unknown action: ${action}`);
         usage();

package/felo-slides/SKILL.md

@@ -75,9 +75,22 @@ node felo-slides/scripts/run_ppt_task.mjs \
   --timeout 60
 ```
 
+To apply a specific theme, first list available themes with `felo ppt-themes`, then pass the theme ID:
+
+```bash
+node felo-slides/scripts/run_ppt_task.mjs \
+  --query "USER_PROMPT_HERE" \
+  --theme "THEME_ID_HERE" \
+  --interval 10 \
+  --max-wait 1800 \
+  --timeout 60
+```
+
 Script behavior:
 
 - Creates task via `POST https://openapi.felo.ai/v2/ppts`
+- Supports optional `--theme <id>` to apply a PPT theme (sends `ppt_config.ai_theme_id`)
+- Supports optional `--task-id <id>` to resume polling an existing task (skips creation)
 - Polls via `GET https://openapi.felo.ai/v2/tasks/{task_id}/historical`
 - Treats `COMPLETED`/`SUCCESS` as success terminal (case-insensitive)
 - Treats `FAILED`/`ERROR` as failure terminal
@@ -152,6 +165,14 @@ Timeout handling:
 
 - If timeout reached, return last known status and instruct user to retry later
 - Include `task_id` so user can query again
+- **IMPORTANT**: To resume a timed-out task, use `--task-id` instead of `--query` to avoid creating a duplicate PPT:
+
+```bash
+node felo-slides/scripts/run_ppt_task.mjs \
+  --task-id "TASK_ID_HERE" \
+  --interval 10 \
+  --max-wait 1800
+```
 
 ## Important Notes
 

package/felo-slides/scripts/run_ppt_task.mjs

@@ -12,7 +12,9 @@ function usage() {
       '  node felo-slides/scripts/run_ppt_task.mjs --query "your prompt" [options]',
       '',
       'Options:',
-      '  --query <text>        PPT prompt (required)',
+      '  --query <text>        PPT prompt (required unless --task-id is given)',
+      '  --task-id <id>        Resume polling an existing task (skip creation)',
+      '  --theme <id>          PPT theme ID (from ppt-themes)',
       '  --interval <seconds>  Poll interval, default 10',
       '  --max-wait <seconds>  Max wait time, default 1800',
       '  --timeout <seconds>   Request timeout, default 60',
@@ -26,6 +28,8 @@ function usage() {
 function parseArgs(argv) {
   const out = {
     query: '',
+    taskId: '',
+    theme: '',
     intervalSec: DEFAULT_INTERVAL_SEC,
     maxWaitSec: DEFAULT_MAX_WAIT_SEC,
     timeoutSec: DEFAULT_TIMEOUT_SEC,
@@ -44,6 +48,12 @@ function parseArgs(argv) {
     } else if (a === '--query') {
       out.query = argv[i + 1] ?? '';
       i += 1;
+    } else if (a === '--task-id') {
+      out.taskId = argv[i + 1] ?? '';
+      i += 1;
+    } else if (a === '--theme') {
+      out.theme = argv[i + 1] ?? '';
+      i += 1;
     } else if (a === '--interval') {
       out.intervalSec = Number.parseInt(argv[i + 1] ?? '', 10);
       i += 1;
@@ -128,7 +138,11 @@ function extractTaskUrls(historicalData, createData) {
   };
 }
 
-async function createTask(apiKey, apiBase, query, timeoutMs) {
+async function createTask(apiKey, apiBase, query, timeoutMs, theme) {
+  const reqBody = { query };
+  if (theme) {
+    reqBody.ppt_config = { ai_theme_id: theme };
+  }
   const payload = await fetchJson(
     `${apiBase}/v2/ppts`,
     {
@@ -138,7 +152,7 @@ async function createTask(apiKey, apiBase, query, timeoutMs) {
         Authorization: `Bearer ${apiKey}`,
         'Content-Type': 'application/json',
       },
-      body: JSON.stringify({ query }),
+      body: JSON.stringify(reqBody),
     },
     timeoutMs
   );
@@ -170,7 +184,7 @@ async function main() {
     usage();
     process.exit(0);
   }
-  if (!args.query) {
+  if (!args.query && !args.taskId) {
     usage();
     process.exit(1);
   }
@@ -186,10 +200,22 @@ async function main() {
   const intervalMs = args.intervalSec * 1000;
   const maxWaitMs = args.maxWaitSec * 1000;
 
-  const createData = await createTask(apiKey, apiBase, args.query, timeoutMs);
-  const taskId = createData.task_id;
-  if (args.verbose) {
-    console.error(`Task ID: ${taskId}`);
+  let createData = {};
+  let taskId;
+
+  if (args.taskId) {
+    // Resume polling an existing task
+    taskId = args.taskId;
+    if (args.verbose) {
+      console.error(`Resuming task: ${taskId}`);
+    }
+  } else {
+    // Create a new task
+    createData = await createTask(apiKey, apiBase, args.query, timeoutMs, args.theme);
+    taskId = createData.task_id;
+    if (args.verbose) {
+      console.error(`Task ID: ${taskId}`);
+    }
   }
 
   const startAt = Date.now();