felo-ai 0.2.16 → 0.2.18

package/CHANGELOG.md

@@ -5,6 +5,36 @@ 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.18] - 2026-03-14
+
+### Added
+
+- **`felo livedoc route <id>`**: add `route` subcommand to CLI for routing relevant resource IDs by query; supports `--max-resources` flag
+- **`felo livedoc retrieve` `--resource-ids`**: add `--resource-ids` option to search within specific resources (comma-separated)
+
+### Fixed
+
+- Fix `retrieve` request body field from `content` to `query`
+
+---
+
+## [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 +85,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.18",
   "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

@@ -640,12 +640,33 @@ livedocCmd
   .command("retrieve <short_id>")
   .description("Semantic search across resources")
   .requiredOption("--query <query>", "search query")
+  .option("--resource-ids <ids>", "comma-separated resource IDs to search within")
   .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.retrieve(shortId, {
       query: opts.query,
+      resourceIds: opts.resourceIds,
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
+livedocCmd
+  .command("route <short_id>")
+  .description("Route relevant resource IDs by query")
+  .requiredOption("--query <query>", "routing query")
+  .option("--max-resources <n>", "max resources to return")
+  .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.route(shortId, {
+      query: opts.query,
+      maxResources: opts.maxResources,
       json: opts.json,
       timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
     });

package/src/livedoc.js

@@ -374,6 +374,36 @@ export async function removeResource(shortId, resourceId, opts = {}) {
   } finally { stopSpinner(spinnerId); }
 }
 
+export async function route(shortId, 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 (!opts.query) { process.stderr.write('ERROR: --query is required.\n'); return 1; }
+
+  const apiBase = await getApiBase();
+  const timeoutMs = opts.timeoutMs || DEFAULT_TIMEOUT_MS;
+  const spinnerId = startSpinner('Routing relevant resources');
+
+  try {
+    const body = { query: opts.query };
+    if (opts.maxResources) {
+      const n = parseInt(opts.maxResources, 10);
+      if (Number.isFinite(n) && n > 0) body.max_resources = n;
+    }
+    const payload = await apiRequest('POST', `/livedocs/${shortId}/resources/route`, body, apiKey, apiBase, timeoutMs);
+    if (opts.json) { console.log(JSON.stringify(payload, null, 2)); return 0; }
+
+    const resourceIds = payload?.data || [];
+    if (!resourceIds.length) { process.stderr.write('No relevant resources found.\n'); return 0; }
+    process.stdout.write(`Found ${resourceIds.length} relevant resource(s):\n\n`);
+    for (const id of resourceIds) process.stdout.write(`- ${id}\n`);
+    return 0;
+  } catch (err) {
+    process.stderr.write(`Failed to route resources: ${err?.message || err}\n`);
+    return 1;
+  } finally { stopSpinner(spinnerId); }
+}
+
 export async function retrieve(shortId, opts = {}) {
   const apiKey = await getApiKey();
   if (!apiKey) { console.error(NO_KEY_MESSAGE.trim()); return 1; }
@@ -385,7 +415,10 @@ export async function retrieve(shortId, opts = {}) {
   const spinnerId = startSpinner('Retrieving from knowledge base');
 
   try {
-    const body = { content: opts.query };
+    const body = { query: opts.query };
+    if (opts.resourceIds) {
+      body.resource_ids = opts.resourceIds.split(',').map(id => id.trim()).filter(Boolean);
+    }
     const payload = await apiRequest('POST', `/livedocs/${shortId}/resources/retrieve`, body, apiKey, apiBase, timeoutMs);
     if (opts.json) { console.log(JSON.stringify(payload, null, 2)); return 0; }