felo-ai 0.2.2 → 0.2.4

package/README.en.md

@@ -21,12 +21,9 @@ Search the web for up-to-date information and get AI-synthesized answers. Ideal
 - **Claude Code**: After installing the skill, it triggers automatically, or type `/felo-ai your question`
 - **Examples**: `felo search "Tokyo weather"`, `felo search "React 19 new features" --verbose`
 
-### Capability 2: Generate PPT
+### Capability 2: Generate PPT (Felo Slides)
 
-Describe a topic in one sentence and Felo generates a slideshow. The job runs in the cloud; when done, you get an **online document link** to open in your browser.
-
-- **Terminal**: `felo slides "your topic or description"`
-- **Examples**: `felo slides "Felo product intro, 3 slides"`, `felo slides "Introduction to React" --poll-timeout 300`
+Terminal: `felo slides "your topic"`. In Claude Code: install `npx @claude/skills add felo-slides`, then `/felo-slides your topic`. You get an online document link when done. Examples: `felo slides "Felo product intro, 3 slides"`, `felo slides "Introduction to React"`.
 
 ---
 
@@ -62,17 +59,39 @@ Get your API key at [felo.ai](https://felo.ai) (Settings → API Keys).
 | `felo config set FELO_API_KEY <key>` | Save API key |
 | `felo config get/list/path/unset` | View / list / path / remove config |
 
+### Examples
+
+**Search**
+
+```bash
+felo search "Tokyo weather"
+felo search "MacBook Air M3 price"
+felo search "React 19 new features" --verbose
+npx felo-ai search "Tokyo weather"
+```
+
+**Slides**
+
+```bash
+felo slides "Felo product intro, 3 slides"
+felo slides "Introduction to React"
+felo slides "Q4 2024 business review, 10 pages" --poll-timeout 300
+npx felo-ai slides "Tokyo travel guide, 5 slides"
+```
+
 ---
 
-## Claude Code Skill
+## Claude Code Skills
 
-Install the skill:
+**Search** — Install and use real-time search:
 
 ```bash
-npx @claude/skills add felo-ai
+npx @claude/skills add felo-search
 ```
 
-After setting `FELO_API_KEY`, ask Claude things like “What’s the weather in Tokyo today?” or “React 19 new features” and search will trigger automatically. PPT generation is available only via the terminal with `felo slides`.
+After setting `FELO_API_KEY`, ask Claude things like “What’s the weather in Tokyo today?” or “React 19 new features”; the search skill triggers automatically (or use `/felo-search your question`).
+
+**Slides (PPT)** — `npx @claude/skills add felo-slides`, then `/felo-slides your topic`. Same `FELO_API_KEY`. [Details →](./felo-slides/README.md)
 
 ---
 

package/README.md

@@ -1,30 +1,27 @@
-# Felo Skills for Claude Code
+# Felo AI CLI
 
-**Ask anything. Get current answers powered by AI.**
+**Ask anything. Get current answers. Generate slides from a prompt.**
 
-Real-time web search powered by Felo AI. Works in Chinese, English, Japanese, and Korean.
+[npm package: **felo-ai**](https://www.npmjs.com/package/felo-ai) — Real-time search and PPT generation from the terminal. Also works as Claude Code skills. Supports Chinese, English, Japanese, and Korean.
 
-[![Setup Time](https://img.shields.io/badge/setup-2%20minutes-blue)]() [![License](https://img.shields.io/badge/license-MIT-green)]()
+[![npm version](https://img.shields.io/npm/v/felo-ai.svg)](https://www.npmjs.com/package/felo-ai) [![License](https://img.shields.io/badge/license-MIT-green)]()
 
 ---
 
-## Felo CLI (Terminal)
-
-Use Felo search from the terminal without opening Claude Code.
-
-### Install
+## Install (CLI)
 
 ```bash
-npm install -g felo-search
+npm install -g felo-ai
 ```
 
-Or run without installing (uses latest published version):
+Run without installing:
 
 ```bash
-npx felo-search search "Tokyo weather"
+npx felo-ai search "Tokyo weather"
+npx felo-ai slides "Introduction to React, 5 slides"
 ```
 
-After install, the command is `felo` (from the package name `felo-search`).
+After install, the command is `felo` (package name: **felo-ai**).
 
 ### Configure API key
 
@@ -53,32 +50,47 @@ Get your API key from [felo.ai](https://felo.ai) (Settings → API Keys). Enviro
 | Command                              | Description                                           |
 | ------------------------------------ | ----------------------------------------------------- |
 | `felo search "<query>"`              | Search for current info (weather, news, prices, etc.) |
+| `felo slides "<prompt>"`             | Generate PPT; returns link when done                 |
 | `felo config set FELO_API_KEY <key>` | Save API key to config                                |
 | `felo config get FELO_API_KEY`       | Print stored key                                      |
 | `felo config list`                   | List config keys                                      |
 | `felo config path`                   | Show config file path                                 |
-| `felo summarize` / `felo translate`  | Planned; use `felo search` for now                    |
 
 ### Examples
 
+**Search**
+
 ```bash
 felo search "Tokyo weather"
 felo search "MacBook Air M3 price"
 felo search "React 19 new features" --verbose
 felo search "Hangzhou tomorrow weather" --json
-npx felo-search search "Tokyo weather"
+npx felo-ai search "Tokyo weather"
+```
+
+**Slides**
+
+```bash
+felo slides "Felo product intro, 3 slides"
+felo slides "Introduction to React"
+felo slides "Q4 2024 business review, 10 pages" --poll-timeout 300
+npx felo-ai slides "Tokyo travel guide, 5 slides"
 ```
 
 ### CLI FAQ
 
 - **Key not found?** Run `felo config set FELO_API_KEY <key>` or set the `FELO_API_KEY` environment variable.
 - **Request timeout?** Use `felo search "query" --timeout 120` (default 60 seconds). 5xx errors are retried automatically with backoff.
+- **Slides taking long?** Use `felo slides "topic" --poll-timeout 300` (default 1200s) to limit wait.
 - **Where is config stored?** Run `felo config path` to see the file (e.g. `~/.felo/config.json`).
-- **Streaming?** Not yet; when the Felo API supports streaming, the CLI can be updated to stream output.
 
 ---
 
-## Quick Start (Claude Code Skill)
+## Claude Code Skills (optional)
+
+This repo also provides **Claude Code** skills. If you use [Claude Code](https://claude.ai/code), you can install search and/or slides as skills so Claude can run them in chat.
+
+### Quick Start (Search skill)
 
 Install the skill:
 
@@ -110,6 +122,8 @@ Ask Claude: "What's the weather in Tokyo today?"
 
 **You're done!** The skill triggers automatically for any question needing current information.
 
+**Felo Slides (PPT):** In terminal run `felo slides "your topic"`. In Claude Code install with `npx @claude/skills add felo-slides`, then use `/felo-slides your topic`. See [felo-slides](./felo-slides/README.md).
+
 ---
 
 ## Usage Examples
@@ -284,6 +298,10 @@ Real-time web search with AI-generated answers.
 
 **[View skill documentation →](./felo-search/)**
 
+### felo-slides
+
+Generate PPT: in terminal use `felo slides "your topic"`, in Claude Code use `/felo-slides your topic`. **[View skill documentation →](./felo-slides/)**
+
 ---
 
 ## Contributing
@@ -302,6 +320,7 @@ Run CLI tests: `npm test`
 
 ## Links
 
+- **[npm: felo-ai](https://www.npmjs.com/package/felo-ai)** — CLI package
 - **[Felo Open Platform](https://openapi.felo.ai/docs/)** — Get your API key
 - **[API Documentation](https://openapi.felo.ai/docs/api-reference/v2/chat.html)** — API reference
 - **[Claude Code](https://claude.ai/code)** — AI assistant CLI
@@ -321,7 +340,7 @@ Run CLI tests: `npm test`
 
 ## License
 
-MIT License — see [LICENSE](./felo-search/LICENSE) for details.
+MIT — see [LICENSE](./felo-search/LICENSE) in the repo for details.
 
 ---
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "felo-ai",
-  "version": "0.2.2",
-  "description": "Felo AI CLI - real-time search from the terminal",
+  "version": "0.2.4",
+  "description": "Felo AI CLI - real-time search and PPT generation from the terminal",
   "type": "module",
   "main": "src/cli.js",
   "bin": {

package/src/cli.js

@@ -9,6 +9,31 @@ import * as config from './config.js';
 const require = createRequire(import.meta.url);
 const pkg = require('../package.json');
 
+/** Delay (ms) before process.exit to let Windows libuv finish handle cleanup. */
+const EXIT_DELAY_MS = 50;
+
+/**
+ * Flush stdout then stderr, then exit after a short delay. Avoids Node.js
+ * Windows UV_HANDLE_CLOSING assertion when process.exit() runs while streams
+ * or other handles are still closing.
+ * @param {number} code - Exit code.
+ */
+function flushStdioThenExit(code) {
+  const doExit = () => setTimeout(() => process.exit(code), EXIT_DELAY_MS);
+  const flushStderr = () => {
+    if (process.stderr?.writable && !process.stderr.destroyed) {
+      process.stderr.write('', () => doExit());
+    } else {
+      doExit();
+    }
+  };
+  if (process.stdout?.writable && !process.stdout.destroyed) {
+    process.stdout.write('', () => flushStderr());
+  } else {
+    flushStderr();
+  }
+}
+
 const program = new Command();
 
 program
@@ -31,8 +56,7 @@ program
       timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
     });
     process.exitCode = code;
-    // Defer exit so stdout/stderr can flush; avoids Node.js Windows UV_HANDLE_CLOSING assertion
-    setTimeout(() => process.exit(code), 0);
+    flushStdioThenExit(code);
   });
 
 program
@@ -53,8 +77,7 @@ program
       pollTimeoutMs: Number.isNaN(pollTimeoutMs) ? 1_200_000 : pollTimeoutMs,
     });
     process.exitCode = code;
-    // Defer exit so stderr can flush; reduces Node.js Windows assertion (UV_HANDLE_CLOSING)
-    setTimeout(() => process.exit(code), 0);
+    flushStdioThenExit(code);
   });
 
 const configCmd = program
@@ -68,9 +91,10 @@ configCmd
     try {
       await config.setConfig(key, value);
       console.log(`Set ${key}`);
+      flushStdioThenExit(0);
     } catch (e) {
       console.error('Error:', e.message);
-      process.exit(1);
+      flushStdioThenExit(1);
     }
   });
 
@@ -85,9 +109,10 @@ configCmd
       } else {
         console.log(config.maskValueForDisplay(key, value));
       }
+      flushStdioThenExit(0);
     } catch (e) {
       console.error('Error:', e.message);
-      process.exit(1);
+      flushStdioThenExit(1);
     }
   });
 
@@ -100,12 +125,13 @@ configCmd
       const keys = Object.keys(c);
       if (keys.length === 0) {
         console.log('No config set. Use: felo config set FELO_API_KEY <key>');
-        return;
+      } else {
+        keys.forEach((k) => console.log(k));
       }
-      keys.forEach((k) => console.log(k));
+      flushStdioThenExit(0);
     } catch (e) {
       console.error('Error:', e.message);
-      process.exit(1);
+      flushStdioThenExit(1);
     }
   });
 
@@ -116,9 +142,10 @@ configCmd
     try {
       await config.unsetConfig(key);
       console.log(`Unset ${key}`);
+      flushStdioThenExit(0);
     } catch (e) {
       console.error('Error:', e.message);
-      process.exit(1);
+      flushStdioThenExit(1);
     }
   });
 
@@ -127,6 +154,7 @@ configCmd
   .description('Show config file path')
   .action(() => {
     console.log(config.getConfigPath());
+    flushStdioThenExit(0);
   });
 
 program
@@ -135,7 +163,7 @@ program
   .argument('[input]', 'text or URL to summarize')
   .action(() => {
     console.error('summarize: not yet implemented. Use felo search for now.');
-    process.exit(1);
+    flushStdioThenExit(1);
   });
 
 program
@@ -144,7 +172,7 @@ program
   .argument('[text]', 'text to translate')
   .action(() => {
     console.error('translate: not yet implemented. Use felo search for now.');
-    process.exit(1);
+    flushStdioThenExit(1);
   });
 
 program.parse();

package/src/search.js

@@ -38,7 +38,6 @@ async function fetchWithTimeoutAndRetry(url, options, timeoutMs = DEFAULT_TIMEOU
         ...options,
         signal: controller.signal,
       });
-      clearTimeout(timeoutId);
       // Retry on 5xx (server errors)
       if (res.status >= 500 && attempt < MAX_RETRIES) {
         const delay = RETRY_BASE_MS * Math.pow(2, attempt);
@@ -47,7 +46,6 @@ async function fetchWithTimeoutAndRetry(url, options, timeoutMs = DEFAULT_TIMEOU
       }
       return res;
     } catch (err) {
-      clearTimeout(timeoutId);
       lastError = err;
       if (err.name === 'AbortError') {
         throw new Error(`Request timed out after ${timeoutMs / 1000}s`);
@@ -58,6 +56,8 @@ async function fetchWithTimeoutAndRetry(url, options, timeoutMs = DEFAULT_TIMEOU
         continue;
       }
       throw lastError;
+    } finally {
+      clearTimeout(timeoutId);
     }
   }
   throw lastError;