felo-ai 0.2.45 → 0.2.47

package/README.md

@@ -127,23 +127,48 @@ felo apple-buy-advisor "Is it worth upgrading to iPad Air 13?"
 /apple-buy-advisor Is it worth upgrading to iPad Air 13?
 ```
 
+**Twitter Writer** — [full options →](./felo-twitter-writer/SKILL.md)
+
+```bash
+# Use as Claude Code skill
+/felo-twitter-writer Analyze @paulg's tweet style and extract a style DNA
+/felo-twitter-writer Write 3 tweets about AI trends in @paulg's style
+/felo-twitter-writer Write a Twitter thread about why most startups fail
+```
+
+**SuperAgent** — [full options →](./felo-superAgent/README.md)
+
+```bash
+# Use as Claude Code skill
+/felo-superagent What is the latest news about AI?
+/felo-superagent Tell me more --thread-id <thread_short_id>
+```
+
+```bash
+# Run script directly
+node felo-superAgent/scripts/run_superagent.mjs --query "What is quantum computing?"
+node felo-superAgent/scripts/run_superagent.mjs --query "Tell me more" --thread-id <thread_short_id>
+```
+
 **[See 40+ more examples →](./docs/EXAMPLES.md)**
 
 ---
 
 ## Skills Overview
 
-7 skills across search, content generation, web scraping, social media, knowledge base, and shopping advice:
+9 skills across search, content generation, web scraping, social media, knowledge base, shopping advice, Twitter writing, and AI conversation:
 
-| Skill                       | Description                                                   | Docs                            |
-| --------------------------- | ------------------------------------------------------------- | ------------------------------- |
-| **felo-search**             | Real-time web search with AI answers. Triggers automatically. | [→](./felo-search/)             |
-| **felo-slides**             | Generate PPT from a prompt                                    | [→](./felo-slides/)             |
-| **felo-web-fetch**          | Fetch and extract webpage content                             | [→](./felo-web-fetch/)          |
-| **felo-youtube-subtitling** | Fetch YouTube video subtitles                                 | [→](./felo-youtube-subtitling/) |
-| **felo-x-search**           | Search X (Twitter) tweets, users, replies                     | [→](./felo-x-search/SKILL.md)   |
-| **felo-livedoc**            | Manage knowledge bases and semantic retrieval                 | [→](./felo-livedoc/)            |
-| **apple-buy-advisor**       | Research and compare Apple products before you buy            | [→](./apple-buy-advisor/)       |
+| Skill                       | Description                                                   | Docs                                      |
+| --------------------------- | ------------------------------------------------------------- | ----------------------------------------- |
+| **felo-search**             | Real-time web search with AI answers. Triggers automatically. | [→](./felo-search/)                       |
+| **felo-slides**             | Generate PPT from a prompt                                    | [→](./felo-slides/)                       |
+| **felo-web-fetch**          | Fetch and extract webpage content                             | [→](./felo-web-fetch/)                    |
+| **felo-youtube-subtitling** | Fetch YouTube video subtitles                                 | [→](./felo-youtube-subtitling/)           |
+| **felo-x-search**           | Search X (Twitter) tweets, users, replies                     | [→](./felo-x-search/SKILL.md)             |
+| **felo-livedoc**            | Manage knowledge bases and semantic retrieval                 | [→](./felo-livedoc/)                      |
+| **apple-buy-advisor**       | Research and compare Apple products before you buy            | [→](./apple-buy-advisor/)                 |
+| **felo-twitter-writer**     | Analyze tweet style DNA and compose tweets, threads, X posts  | [→](./felo-twitter-writer/SKILL.md)       |
+| **felo-superAgent**         | AI conversation with real-time streaming, continuous threads  | [→](./felo-superAgent/README.md)          |
 
 ---
 
@@ -163,6 +188,8 @@ felo apple-buy-advisor "Is it worth upgrading to iPad Air 13?"
 /plugin install felo-x-search@felo-ai
 /plugin install felo-livedoc@felo-ai
 /plugin install apple-buy-advisor@felo-ai
+/plugin install felo-twitter-writer@felo-ai
+/plugin install felo-superAgent@felo-ai
 ```
 
 ### ClawHub
@@ -177,6 +204,8 @@ clawhub install felo-youtube-subtitling
 clawhub install felo-x-search
 clawhub install felo-livedoc
 clawhub install apple-buy-advisor
+clawhub install felo-twitter-writer
+clawhub install felo-superAgent
 ```
 
 ### Gemini CLI

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.45",
+  "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",
@@ -32,7 +32,8 @@
     "url": "git+https://github.com/Felo-Inc/felo-skills.git"
   },
   "dependencies": {
-    "commander": "^12.0.0"
+    "commander": "^12.0.0",
+    "felo-ai": "^0.2.43"
   },
   "scripts": {
     "test": "node --test tests/",

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;