felo-ai 0.2.28 → 0.2.31

package/felo-web-fetch/scripts/run_web_fetch.mjs

@@ -7,6 +7,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(() => {
@@ -20,7 +21,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 usage() {

package/felo-x-search/scripts/run_x_search.mjs

@@ -9,6 +9,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(() => {
@@ -22,7 +23,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) {

package/felo-youtube-subtitling/scripts/run_youtube_subtitling.mjs

@@ -7,6 +7,7 @@ const SPINNER_INTERVAL_MS = 80;
 const STATUS_PAD = 52;
 
 function startSpinner(message) {
+  if (!process.stderr.isTTY) return null;
   const start = Date.now();
   let i = 0;
   const id = setInterval(() => {
@@ -20,7 +21,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`);
 }
 
 /** Extract video ID from YouTube URL or return string if plain ID. Returns null if invalid. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "felo-ai",
-  "version": "0.2.28",
+  "version": "0.2.31",
   "description": "Felo AI CLI - real-time search, PPT generation, SuperAgent conversation, LiveDoc management, web fetch, YouTube subtitles, LiveDoc knowledge base, and X (Twitter) search from the terminal",
   "type": "module",
   "main": "src/cli.js",

package/src/cli.js

@@ -3,7 +3,7 @@
 import { createRequire } from "module";
 import { Command } from "commander";
 import { search } from "./search.js";
-import { slides } from "./slides.js";
+import { slides, listPptThemes } from "./slides.js";
 import { superAgent, listLiveDocs, listLiveDocResources } from "./superAgent.js";
 import { webFetch } from "./webFetch.js";
 import { youtubeSubtitling } from "./youtubeSubtitling.js";
@@ -71,7 +71,7 @@ program
     "Generate PPT/slides from a prompt (async task, outputs live doc URL when done)"
   )
   .argument(
-    "<query>",
+    "[query]",
     'PPT generation prompt (e.g. "Felo, 2 pages" or "Introduction to React")'
   )
   .option("-j, --json", "output raw JSON with task_id and live_doc_url")
@@ -86,14 +86,49 @@ program
     "max seconds to wait for task completion",
     "1200"
   )
+  .option("--theme <id>", "PPT theme ID (from ppt-themes command)")
+  .option("--task-id <id>", "resume polling an existing task (skip creation)")
   .action(async (query, opts) => {
+    if (!query && !opts.taskId) {
+      console.error("Error: provide a <query> or --task-id to resume an existing task");
+      flushStdioThenExit(1);
+      return;
+    }
     const timeoutMs = parseInt(opts.timeout, 10) * 1000;
     const pollTimeoutMs = parseInt(opts.pollTimeout, 10) * 1000 || 1_200_000;
-    const code = await slides(query, {
+    const pptConfig = opts.theme ? { ai_theme_id: opts.theme } : undefined;
+    const code = await slides(query || "", {
       json: opts.json,
       verbose: opts.verbose,
       timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
       pollTimeoutMs: Number.isNaN(pollTimeoutMs) ? 1_200_000 : pollTimeoutMs,
+      pptConfig,
+      taskId: opts.taskId,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
+program
+  .command("ppt-themes")
+  .description("List available PPT themes with optional filtering")
+  .option("--lang <code>", "language code (e.g. en, zh-Hans)")
+  .option("--type <type>", "filter by theme type (e.g. default, custom)")
+  .option("-k, --keyword <keyword>", "search keyword for theme titles")
+  .option("-p, --page <number>", "page number (starting from 1)", "1")
+  .option("-s, --size <number>", "page size (max 100)", "20")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await listPptThemes({
+      lang: opts.lang,
+      type: opts.type,
+      keyword: opts.keyword,
+      page: parseInt(opts.page, 10) || 1,
+      size: parseInt(opts.size, 10) || 20,
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
     });
     process.exitCode = code;
     flushStdioThenExit(code);
@@ -341,6 +376,7 @@ program
   )
   .option("-j, --json", "Output JSON with task_id and ppt/live_doc URL")
   .option("--verbose", "Show polling status")
+  .option("--theme <id>", "PPT theme ID (from ppt-themes command)")
   .action(async (opts) => {
     const timeoutMs = parseInt(opts.timeout, 10) * 1000;
     const pollTimeoutMs = parseInt(opts.pollTimeout, 10) * 1000;
@@ -354,6 +390,7 @@ program
       pollTimeoutMs: Number.isNaN(pollTimeoutMs) ? 1_200_000 : pollTimeoutMs,
       json: opts.json,
       verbose: opts.verbose,
+      theme: opts.theme,
     });
     process.exitCode = code;
     flushStdioThenExit(code);
@@ -636,6 +673,27 @@ livedocCmd
     flushStdioThenExit(code);
   });
 
+livedocCmd
+  .command("update-resource <short_id> <resource_id>")
+  .description("Update a resource's title, snippet, or thumbnail")
+  .option("--title <title>", "new resource title (max 500 characters)")
+  .option("--snippet <text>", "new resource summary (max 2000 characters)")
+  .option("--thumbnail <url>", "new thumbnail URL (max 2000 characters)")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, resourceId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.updateResource(shortId, resourceId, {
+      title: opts.title,
+      snippet: opts.snippet,
+      thumbnail: opts.thumbnail,
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
 livedocCmd
   .command("retrieve <short_id>")
   .description("Semantic search across resources")
@@ -729,6 +787,200 @@ livedocCmd
     flushStdioThenExit(code);
   });
 
+// ── LiveDoc README ──
+
+livedocCmd
+  .command("get-readme <short_id>")
+  .description("Get the README of a LiveDoc")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.getReadme(shortId, {
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
+livedocCmd
+  .command("update-readme <short_id>")
+  .description("Create or replace the README of a LiveDoc")
+  .requiredOption("--content <text>", "README content (Markdown)")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.upsertReadme(shortId, {
+      content: opts.content,
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
+livedocCmd
+  .command("append-readme <short_id>")
+  .description("Append content to the README of a LiveDoc")
+  .requiredOption("--content <text>", "content to append (Markdown)")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.appendReadme(shortId, {
+      content: opts.content,
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
+livedocCmd
+  .command("delete-readme <short_id>")
+  .description("Delete the README of a LiveDoc")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.deleteReadme(shortId, {
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
+// ── LiveDoc Tasks ──
+
+livedocCmd
+  .command("tasks <short_id>")
+  .description("List tasks in a LiveDoc")
+  .option("--status <n>", "filter by status: 0=TODO, 1=IN_PROGRESS, 2=DONE")
+  .option("--labels <labels>", "filter by labels (comma-separated)")
+  .option("--page <n>", "page number")
+  .option("--size <n>", "page size")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.listTasks(shortId, {
+      status: opts.status,
+      labels: opts.labels,
+      page: opts.page,
+      size: opts.size,
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
+livedocCmd
+  .command("create-task <short_id>")
+  .description("Create a task in a LiveDoc")
+  .requiredOption("--title <title>", "task title")
+  .requiredOption("--status <n>", "task status: 0=TODO, 1=IN_PROGRESS, 2=DONE")
+  .requiredOption("--sort <n>", "sort order (non-negative integer)")
+  .option("--description <desc>", "task description")
+  .option("--labels <labels>", "comma-separated labels (max 10)")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.createTask(shortId, {
+      title: opts.title,
+      status: opts.status,
+      sort: opts.sort,
+      description: opts.description,
+      labels: opts.labels,
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
+livedocCmd
+  .command("update-task <short_id> <task_id>")
+  .description("Partially update a task (only provided fields are changed)")
+  .option("--title <title>", "new task title")
+  .option("--description <desc>", "new task description")
+  .option("--status <n>", "new status: 0=TODO, 1=IN_PROGRESS, 2=DONE")
+  .option("--sort <n>", "new sort order")
+  .option("--labels <labels>", "new comma-separated labels")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, taskId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.updateTask(shortId, taskId, {
+      title: opts.title,
+      description: opts.description,
+      status: opts.status,
+      sort: opts.sort,
+      labels: opts.labels,
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
+livedocCmd
+  .command("delete-task <short_id> <task_id>")
+  .description("Delete a task")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, taskId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.deleteTask(shortId, taskId, {
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
+livedocCmd
+  .command("task-records <short_id> <task_id>")
+  .description("List records (comments + change history) for a task")
+  .option("--record-type <type>", "filter by type: comment, edit, status_change")
+  .option("--page <n>", "page number")
+  .option("--size <n>", "page size")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, taskId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.listTaskRecords(shortId, taskId, {
+      recordType: opts.recordType,
+      page: opts.page,
+      size: opts.size,
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
+livedocCmd
+  .command("add-task-comment <short_id> <task_id>")
+  .description("Add a comment to a task")
+  .requiredOption("--content <text>", "comment content")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, taskId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.createTaskComment(shortId, taskId, {
+      content: opts.content,
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
 program
   .command("summarize")
   .description("Summarize text or URL (coming when API is available)")

package/src/contentToSlides.js

@@ -77,5 +77,6 @@ export async function contentToSlides(opts) {
     verbose: opts?.verbose,
     timeoutMs: fetchTimeoutMs,
     pollTimeoutMs: opts?.pollTimeoutMs,
+    pptConfig: opts?.theme ? { ai_theme_id: opts.theme } : undefined,
   });
 }