felo-ai 0.2.46 → 0.2.47

package/felo-livedoc/SKILL.md

@@ -119,6 +119,11 @@ node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update-resource SHORT
 node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update-resource SHORT_ID RESOURCE_ID --snippet "New summary" --thumbnail "https://example.com/thumb.png"
 ```
 
+**Update resource content (ai_doc type only — also auto-updates snippet from first 2000 bytes):**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update-resource-content SHORT_ID RESOURCE_ID --content "New content here"
+```
+
 ### Semantic Retrieval
 
 **Route relevant resources by query:**
@@ -240,6 +245,7 @@ The API returns JSON with this structure:
 - `short_id` — unique identifier (use this for all operations)
 - `name` — LiveDoc name
 - `description` — LiveDoc description
+- `is_shared` — `true` if this LiveDoc was shared with you (not owned by you)
 - `created_at` / `modified_at` — timestamps
 
 **Resource object:**

package/felo-livedoc/scripts/run_livedoc.mjs

@@ -95,6 +95,7 @@ function formatLiveDoc(doc) {
   out += `- ID: \`${doc.short_id}\`\n`;
   if (doc.description) out += `- Description: ${doc.description}\n`;
   if (doc.icon) out += `- Icon: ${doc.icon}\n`;
+  if (doc.is_shared != null) out += `- Shared: ${doc.is_shared}\n`;
   if (doc.created_at) out += `- Created: ${doc.created_at}\n`;
   if (doc.modified_at) out += `- Modified: ${doc.modified_at}\n`;
   out += '\n';
@@ -167,6 +168,7 @@ function usage() {
     '  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',
+    '  update-resource-content <short_id> <resource_id>  Update ai_doc content (--content required)',
     '  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',
@@ -432,6 +434,16 @@ async function main() {
         code = 0;
         break;
       }
+      case 'update-resource-content': {
+        if (!shortId || !resourceId) { console.error('ERROR: short_id and resource_id are required'); break; }
+        if (!args.content) { console.error('ERROR: --content is required'); break; }
+        spinnerId = startSpinner('Updating resource content');
+        const payload = await apiRequest('PUT', `/livedocs/${shortId}/resources/${resourceId}/content`, { content: args.content }, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else { process.stdout.write('Resource content updated.\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; }

package/felo-slides/SKILL.md

@@ -90,6 +90,7 @@ 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 `--livedoc-id <id>` to reuse an existing LiveDoc instead of auto-creating a new one
 - 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)

package/felo-slides/scripts/run_ppt_task.mjs

@@ -15,6 +15,7 @@ function usage() {
       '  --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)',
+      '  --livedoc-id <id>     Reuse an existing LiveDoc instead of auto-creating one',
       '  --interval <seconds>  Poll interval, default 10',
       '  --max-wait <seconds>  Max wait time, default 1800',
       '  --timeout <seconds>   Request timeout, default 60',
@@ -30,6 +31,7 @@ function parseArgs(argv) {
     query: '',
     taskId: '',
     theme: '',
+    livedocId: '',
     intervalSec: DEFAULT_INTERVAL_SEC,
     maxWaitSec: DEFAULT_MAX_WAIT_SEC,
     timeoutSec: DEFAULT_TIMEOUT_SEC,
@@ -54,6 +56,9 @@ function parseArgs(argv) {
     } else if (a === '--theme') {
       out.theme = argv[i + 1] ?? '';
       i += 1;
+    } else if (a === '--livedoc-id') {
+      out.livedocId = argv[i + 1] ?? '';
+      i += 1;
     } else if (a === '--interval') {
       out.intervalSec = Number.parseInt(argv[i + 1] ?? '', 10);
       i += 1;
@@ -138,11 +143,14 @@ function extractTaskUrls(historicalData, createData) {
   };
 }
 
-async function createTask(apiKey, apiBase, query, timeoutMs, theme) {
+async function createTask(apiKey, apiBase, query, timeoutMs, theme, livedocId) {
   const reqBody = { query };
   if (theme) {
     reqBody.ppt_config = { ai_theme_id: theme };
   }
+  if (livedocId) {
+    reqBody.livedoc_short_id = livedocId;
+  }
   const payload = await fetchJson(
     `${apiBase}/v2/ppts`,
     {
@@ -211,7 +219,7 @@ async function main() {
     }
   } else {
     // Create a new task
-    createData = await createTask(apiKey, apiBase, args.query, timeoutMs, args.theme);
+    createData = await createTask(apiKey, apiBase, args.query, timeoutMs, args.theme, args.livedocId || undefined);
     taskId = createData.task_id;
     if (args.verbose) {
       console.error(`Task ID: ${taskId}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "felo-ai",
-  "version": "0.2.46",
+  "version": "0.2.47",
   "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

@@ -89,6 +89,7 @@ program
   )
   .option("--theme <id>", "PPT theme ID (from ppt-themes command)")
   .option("--task-id <id>", "resume polling an existing task (skip creation)")
+  .option("--livedoc-id <id>", "reuse an existing LiveDoc short_id instead of auto-creating a new one")
   .action(async (query, opts) => {
     if (!query && !opts.taskId) {
       console.error("Error: provide a <query> or --task-id to resume an existing task");
@@ -105,6 +106,7 @@ program
       pollTimeoutMs: Number.isNaN(pollTimeoutMs) ? 1_200_000 : pollTimeoutMs,
       pptConfig,
       taskId: opts.taskId,
+      livedocShortId: opts.livedocId || undefined,
     });
     process.exitCode = code;
     flushStdioThenExit(code);
@@ -774,6 +776,23 @@ livedocCmd
     flushStdioThenExit(code);
   });
 
+livedocCmd
+  .command("update-resource-content <short_id> <resource_id>")
+  .description("Update the content of an ai_doc resource (also auto-updates snippet)")
+  .requiredOption("--content <text>", "new content for the resource")
+  .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.updateResourceContent(shortId, resourceId, {
+      content: opts.content,
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
 livedocCmd
   .command("content <short_id> <resource_id>")
   .description("Get extracted text content of a resource")

package/src/livedoc.js

@@ -91,6 +91,7 @@ function formatLiveDoc(doc) {
   out += `- ID: \`${doc.short_id}\`\n`;
   if (doc.description) out += `- Description: ${doc.description}\n`;
   if (doc.icon) out += `- Icon: ${doc.icon}\n`;
+  if (doc.is_shared != null) out += `- Shared: ${doc.is_shared}\n`;
   if (doc.created_at) out += `- Created: ${doc.created_at}\n`;
   if (doc.modified_at) out += `- Modified: ${doc.modified_at}\n`;
   out += '\n';
@@ -823,6 +824,28 @@ export async function createTaskComment(shortId, taskId, opts = {}) {
   } finally { stopSpinner(spinnerId); }
 }
 
+export async function updateResourceContent(shortId, resourceId, opts = {}) {
+  const apiKey = await getApiKey();
+  if (!apiKey) { console.error(NO_KEY_MESSAGE.trim()); return 1; }
+  if (!shortId) { process.stderr.write('ERROR: short_id is required.\n'); return 1; }
+  if (!resourceId) { process.stderr.write('ERROR: resource_id is required.\n'); return 1; }
+  if (!opts.content) { process.stderr.write('ERROR: --content is required.\n'); return 1; }
+
+  const apiBase = await getApiBase();
+  const timeoutMs = opts.timeoutMs || DEFAULT_TIMEOUT_MS;
+  const spinnerId = startSpinner('Updating resource content');
+
+  try {
+    const payload = await apiRequest('PUT', `/livedocs/${shortId}/resources/${resourceId}/content`, { content: opts.content }, apiKey, apiBase, timeoutMs);
+    if (opts.json) { console.log(JSON.stringify(payload, null, 2)); return 0; }
+    process.stdout.write('Resource content updated.\n');
+    return 0;
+  } catch (err) {
+    process.stderr.write(`Failed to update resource content: ${err?.message || err}\n`);
+    return 1;
+  } finally { stopSpinner(spinnerId); }
+}
+
 export async function pptRetrieve(shortId, opts = {}) {
   const apiKey = await getApiKey();
   if (!apiKey) { console.error(NO_KEY_MESSAGE.trim()); return 1; }

package/src/slides.js

@@ -53,13 +53,17 @@ function normalizeTaskStatus(status) {
  * @param {number} timeoutMs
  * @param {string} apiBase
  * @param {{ ai_theme_id?: string }} [pptConfig]
+ * @param {string} [livedocShortId]
  */
-async function createPptTask(apiKey, query, timeoutMs, apiBase, pptConfig) {
+async function createPptTask(apiKey, query, timeoutMs, apiBase, pptConfig, livedocShortId) {
   const url = `${apiBase}/v2/ppts`;
   const body = { query: query.trim() };
   if (pptConfig && Object.keys(pptConfig).length > 0) {
     body.ppt_config = pptConfig;
   }
+  if (livedocShortId) {
+    body.livedoc_short_id = livedocShortId;
+  }
   const res = await fetchWithTimeoutAndRetry(
     url,
     {
@@ -176,7 +180,8 @@ export async function slides(query, options = {}) {
         query,
         requestTimeoutMs,
         apiBase,
-        options.pptConfig
+        options.pptConfig,
+        options.livedocShortId
       );
       taskId = createResult.task_id;