felo-ai 0.2.48 → 0.2.49

package/felo-superAgent/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: felo-superAgent
-description: "Felo SuperAgent API: AI conversation with real-time SSE streaming on a persistent LiveDoc canvas. Use when users want SuperAgent chat, continuous conversation, tweet writing, logo/branding design, or e-commerce product images. Explicit commands: /felo-superagent."
+description: "Felo SuperAgent API: AI conversation with real-time SSE streaming on a persistent LiveDoc canvas. Use when users want SuperAgent chat, continuous conversation, logo/branding design, or e-commerce product images. Do NOT use for tweet/X post writing — use felo-twitter-writer instead. Explicit commands: /felo-superagent."
 ---
 
 # Felo SuperAgent Skill
@@ -57,7 +57,6 @@ Trigger this skill when users want:
 
 - **SuperAgent conversation:** AI conversation with Felo SuperAgent, with real-time streaming output
 - **Continuous conversation:** Multi-turn Q&A on a persistent LiveDoc canvas
-- **Tweet writing:** Compose or post tweets (auto-selects `twitter-writer` skill)
 - **Logo & branding:** Create logos or brand designs (auto-selects `logo-and-branding` skill)
 - **E-commerce images:** Generate product images (auto-selects `ecommerce-product-image` skill)
 - **Tool-augmented answers:** Responses that may include image generation, document creation, PPT generation, or Twitter/X search
@@ -65,15 +64,16 @@ Trigger this skill when users want:
 
 **Trigger words:**
 
-- English: superagent, super agent, stream chat, streaming conversation, livedoc conversation, continuous chat, follow-up question, write a tweet, post a tweet, create a logo, brand design, product image, e-commerce image
-- Simplified Chinese (pinyin): chao ji zhu shou, liu shi dui hua, lian xu dui hua, zhui wen, fa tui wen, xie tui wen, she ji logo, pin pai she ji, dian shang tu pian
-- Traditional Chinese (pinyin): chao ji zhu shou, liu shi dui hua, lian xu dui hua, zhui wen, fa tui wen, xie tui wen, she ji logo, pin pai she ji, dian shang tu pian
-- Japanese (romaji): suupaa eejento, sutoriimingu kaiwa, keizoku kaiwa, tsuiito wo kaku, rogo sakusei, shouhin gazou
+- English: superagent, super agent, stream chat, streaming conversation, livedoc conversation, continuous chat, follow-up question, create a logo, brand design, product image, e-commerce image
+- Simplified Chinese (pinyin): chao ji zhu shou, liu shi dui hua, lian xu dui hua, zhui wen, she ji logo, pin pai she ji, dian shang tu pian
+- Traditional Chinese (pinyin): chao ji zhu shou, liu shi dui hua, lian xu dui hua, zhui wen, she ji logo, pin pai she ji, dian shang tu pian
+- Japanese (romaji): suupaa eejento, sutoriimingu kaiwa, keizoku kaiwa, rogo sakusei, shouhin gazou
 
 **Explicit commands:** `/felo-superagent`, "use felo superagent", "felo superagent"
 
 **Do NOT use for:**
 
+- Tweet/X post writing of any kind (use `felo-twitter-writer` instead)
 - Simple one-off Q&A or real-time information queries (prefer `felo-search`)
 - Web page content fetching only (use `felo-web-fetch`)
 - PPT/slide generation only (use `felo-slides`)
@@ -147,7 +147,7 @@ Skip to Step 3. Reuse the same ID. Sources include: a previous SuperAgent call's
 node felo-livedoc/scripts/run_livedoc.mjs list --json
 ```
 
-Parse the JSON output. The response contains `data.items` — an array of LiveDoc objects sorted by modification time. Pick the first item's `short_id` as your `live_doc_id`.
+Parse the JSON output. The response contains `data.items` — an array of LiveDoc objects sorted by modification time descending. Find the **first item where `is_shared === false`** and use its `short_id` as your `live_doc_id`. **NEVER pick an item where `is_shared === true`** — shared LiveDocs belong to other projects and will cause a 502 error.
 
 Example response:
 ```json
@@ -156,16 +156,17 @@ Example response:
   "data": {
     "total": 3,
     "items": [
-      { "short_id": "QPetunwpGnkKuZHStP7gwt", "name": "My Workspace", "modified_at": "..." },
+      { "short_id": "abc123", "name": "Shared Project", "is_shared": true, "modified_at": "..." },
+      { "short_id": "QPetunwpGnkKuZHStP7gwt", "name": "My Workspace", "is_shared": false, "modified_at": "..." },
       ...
     ]
   }
 }
 ```
 
-Use: `live_doc_id = data.items[0].short_id`
+Use: `live_doc_id = data.items.find(i => !i.is_shared)?.short_id`
 
-**2c. If the list is empty (no LiveDocs exist) — create one:**
+**2c. If no `is_shared === false` item exists (or list is empty) — create one:**
 
 ```bash
 node felo-livedoc/scripts/run_livedoc.mjs create --name "SuperAgent Workspace" --json

package/felo-twitter-writer/SKILL.md

@@ -15,10 +15,11 @@ These rules are mandatory. Violating any of them will produce incorrect behavior
 
 3. **ALWAYS output `data.answer` verbatim.** After the script finishes, print `data.answer` exactly as-is as your response text. Do NOT summarize, paraphrase, or add commentary around it.
 
-4. **`--live-doc-id` is REQUIRED** for every SuperAgent call. Follow the livedoc reuse rules from `felo-superAgent/SKILL.md`:
-   - Reuse any `live_doc_id` already available in this session
-   - If none: run `node felo-livedoc/scripts/run_livedoc.mjs list --json`, use `data.items[0].short_id`
-   - If list is empty: run `node felo-livedoc/scripts/run_livedoc.mjs create --name "Twitter Writer" --json`, use `data.short_id`
+4. **`--live-doc-id` is REQUIRED** for every SuperAgent call. Follow these rules strictly:
+   - Reuse any `live_doc_id` already available in this session (from a prior SuperAgent or livedoc call)
+   - If none: run `node felo-livedoc/scripts/run_livedoc.mjs list --json`, then find the **first item where `is_shared === false`** in `data.items` (list is sorted by modification time descending, so this gives the most recently modified private LiveDoc). Use its `short_id`.
+   - If no `is_shared === false` item exists (or list is empty): run `node felo-livedoc/scripts/run_livedoc.mjs create --name "Twitter Writer" --json`, use `data.short_id`
+   - **NEVER use a LiveDoc where `is_shared === true`** — shared LiveDocs belong to other projects and will cause a 502 error.
 
 5. **Always persist state.** After every SuperAgent call, extract `thread_short_id` and `live_doc_short_id` from the JSON response fields `data.thread_short_id` and `data.live_doc_short_id`. Use them in subsequent calls.
 
@@ -184,20 +185,21 @@ Always pass `--accept-language` matching the user's language (same value used fo
 
 **If the list is empty:** Skip silently. Proceed to Step 2 without `--ext`.
 
-**If styles are available:** Present them to the user grouped by type, showing names only. Always include a "no preference" option. Wait for the user's reply before proceeding.
+**If styles are available:** Output the COMPLETE list as plain text — every style returned by the API, grouped by type, numbered sequentially. NEVER use `AskUserQuestion` tool (it limits to 4 options and will silently drop styles). NEVER pre-select or filter styles on behalf of the user. Always append a "no preference" option as the last item. Then wait for the user's plain-text reply before proceeding.
 
 Example presentation (adapt language to match user's language):
 ```
-Here are the available Twitter writing styles — choosing one will make the output more accurate:
+以下是可用的推文写作风格，选一个会让输出更贴合你的需求：
 
-[Your styles]
+[你的风格]
 1. My Bold Voice
-2. darioamodei
 
-[Recommended styles]
-3. Casual & Witty
+[推荐风格]
+2. elonmusk — Shitposting provocateur
+3. naval — Pithy aphorism master
+...（所有风格全部列出，不省略）
 
-0. No preference — use default style
+0. 无偏好，使用默认风格
 ```
 
 **1.5d. Build `--ext` from the chosen style:**

package/package.json

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