felo-ai 0.2.16 → 0.2.17

package/CHANGELOG.md

@@ -5,6 +5,23 @@ 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.17] - 2026-03-14
+
+### Added
+
+- **`felo livedoc route <id>`**: route relevant resource IDs by query for targeted retrieval; supports `--max-resources`
+- **`felo livedoc retrieve` `--resource-ids`**: specify resource IDs to search within (comma-separated, max 50); auto-routes when omitted
+
+### Changed
+
+- `felo livedoc retrieve`: renamed request field `content` to `query` to align with backend API
+
+### Fixed
+
+- Fixed truncated README in `felo-livedoc` (was cut off at 53 lines)
+
+---
+
 ## [0.2.14] - 2026-03-13
 
 ### Added
@@ -55,7 +72,6 @@ Streamline the process and reduce the need for confirmation and selection.
 
 Earlier releases: search, slides, web fetch, youtube-subtitling features.
 
-[0.3.0]: https://github.com/Felo-Inc/felo-skills/compare/v0.2.10...v0.3.0
 [0.2.10]: https://github.com/Felo-Inc/felo-skills/compare/v0.2.9...v0.2.10
 [0.2.7]: https://github.com/Felo-Inc/felo-skills/compare/v0.2.6...v0.2.7
 [0.2.6]: https://github.com/Felo-Inc/felo-skills/releases/tag/v0.2.6

package/felo-livedoc/README.md

@@ -9,12 +9,14 @@ Manage knowledge bases (LiveDocs) and their resources via the Felo API.
 - Create, list, update, and delete knowledge bases (LiveDocs)
 - Add resources: text documents, URLs, file uploads
 - Semantic retrieval across knowledge base resources
+- Route relevant resources by query for targeted retrieval
 - Full CRUD for resources within a LiveDoc
 
 **When to use:**
 - Building or managing a knowledge base
 - Uploading documents or URLs for AI-powered retrieval
 - Searching across your knowledge base with natural language
+- Routing relevant resources before targeted retrieval
 
 **When NOT to use:**
 - General web search (use `felo-search`)
@@ -51,3 +53,45 @@ felo livedoc list
 ```bash
 # Create a knowledge base
 felo livedoc create --name "My KB" --description "Project docs"
+
+# Add a URL resource
+felo livedoc add-urls SHORT_ID --urls "https://example.com"
+
+# Upload a file
+felo livedoc upload SHORT_ID --file ./report.pdf
+
+# Semantic retrieval across all resources (auto-routes)
+felo livedoc retrieve SHORT_ID --query "latest AI research"
+
+# Retrieve within specific resources
+felo livedoc retrieve SHORT_ID --query "latest AI research" --resource-ids "id1,id2"
+
+# Route relevant resources by query
+felo livedoc route SHORT_ID --query "latest AI research"
+felo livedoc route SHORT_ID --query "latest AI research" --max-resources 5
+```
+
+---
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `create` | Create a new LiveDoc |
+| `list` | List all LiveDocs |
+| `update <short_id>` | Update a LiveDoc |
+| `delete <short_id>` | Delete a LiveDoc |
+| `resources <short_id>` | List resources in a LiveDoc |
+| `resource <short_id> <resource_id>` | Get a single resource |
+| `add-doc <short_id>` | Create a text document resource |
+| `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 |
+| `retrieve <short_id>` | Semantic retrieval (auto-routes if no `--resource-ids`) |
+| `route <short_id>` | Route relevant resource IDs by query |
+
+---
+
+## License
+
+MIT

package/felo-livedoc/SKILL.md

@@ -12,10 +12,11 @@ Trigger this skill when users want to:
 - **Create/manage knowledge bases:** Create, list, update, or delete LiveDocs
 - **Add resources:** Upload documents, add URLs, or create text documents in a LiveDoc
 - **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
 
 **Trigger words:**
-- English: knowledge base, livedoc, live doc, upload document, add URL, semantic search, retrieve, knowledge retrieval
+- English: knowledge base, livedoc, live doc, upload document, add URL, semantic search, retrieve, knowledge retrieval, route resources
 - 简体中文: 知识库, 文档库, 上传文档, 添加链接, 语义检索, 知识检索
 
 **Explicit commands:** `/felo-livedoc`, "livedoc", "felo livedoc"
@@ -110,10 +111,21 @@ node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs remove-resource SHORT
 
 ### Semantic Retrieval
 
-**Search across resources:**
+**Route relevant resources by query:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs route SHORT_ID --query "your search query"
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs route SHORT_ID --query "your search query" --max-resources 5
+```
+
+**Search across all resources (auto-routes):**
 ```bash
 node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs retrieve SHORT_ID --query "your search query"
 ```
+
+**Search within specific resources:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs retrieve SHORT_ID --query "your search query" --resource-ids "id1,id2,id3"
+```
 ### Options
 
 All commands support:

package/package.json

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