@zemerik/gemini-assist 1.1.1-beta → 1.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gemini Assist
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

package/README.md

@@ -101,6 +101,7 @@ In interactive mode:
 - Type your questions and press Enter
 - Type `exit`, `quit`, `bye`, or `q` to end the session
 - Type `clear` to clear the screen
+- Type `history` or `hist` to see conversation message count
 
 ### Single Query Mode
 
@@ -110,6 +111,21 @@ Ask a quick question:
 gemini-assist "What is the capital of France?"
 ```
 
+### Stdin Support (Piping)
+
+Pipe text directly to Gemini Assist for scripting and automation:
+
+```bash
+# Pipe text
+echo "What is AI?" | gemini-assist
+
+# Process file content
+cat document.txt | gemini-assist "Summarize this"
+
+# Chain with other commands
+curl -s https://api.example.com/data | gemini-assist "Analyze this JSON"
+```
+
 ### Command Line Options
 
 ```bash
@@ -117,8 +133,9 @@ gemini-assist [options] [query]
 
 Options:
   -V, --version          Show version number
+  --version-info         Show detailed version information
   -k, --api-key <key>    Gemini API key (or set GEMINI_API_KEY env variable)
-  -m, --model <model>    Gemini model to use (default: gemini-1.5-flash)
+  -m, --model <model>    Gemini model to use (default: gemini-2.5-flash)
   -i, --interactive      Start interactive chat mode
   -t, --temperature <value>  Temperature for response 0-1 (default: 0.7)
   -h, --help             Display help for command
@@ -135,6 +152,12 @@ gemini-assist -t 0.9 "Write a creative story"
 
 # Using alias
 gassist "Explain quantum computing"
+
+# Pipe text from stdin
+echo "Summarize this text" | gemini-assist
+
+# Show detailed version information
+gemini-assist --version-info
 ```
 
 ## Programmatic Usage

package/README_RUST.md

@@ -2,6 +2,8 @@
 
 This project is a **50% JavaScript, 50% Rust** hybrid implementation.
 
+**Current Version:** v1.1.2
+
 ## Architecture
 
 - **Rust (50%)**: Core Gemini API client logic, HTTP requests, and performance-critical operations

package/RELEASE_NOTES.md

@@ -1,82 +1,94 @@
-# Release Notes - Gemini Assist v1.1.1-Beta
+# Release Notes - Gemini Assist v1.1.2
 
-## 🎉 Gemini Assist v1.1.1-Beta
+## 🎉 Gemini Assist v1.1.2
 
-**Release Date:** December 2024  
-**Version:** 1.1.1-Beta  
-**Status:** Beta Release
+**Release Date:** January 2025  
+**Version:** 1.1.2  
+**Status:** Stable Release
 
 ---
 
 ## Overview
 
-Gemini Assist v1.1.1-Beta is the first beta release of our AI Assistant CLI tool, bringing the power of Google's Gemini AI directly to your terminal. This release focuses on core functionality, ease of use, and a polished command-line experience.
+Gemini Assist v1.1.2 introduces powerful new features that enhance usability, scripting capabilities, and developer experience. This release focuses on improving workflow integration and providing better insights into the tool's operation.
 
 ## ✨ New Features
 
-### Core Functionality
-- **Interactive Chat Mode** - Engage in natural conversations with Gemini AI through an intuitive terminal interface
-- **Single Query Mode** - Quick one-off questions for fast answers without starting a full chat session
-- **Dual Command Support** - Use either `gemini-assist` or the shorter `gassist` alias
+### 🚀 Stdin Support (Piping)
+- **Read prompts from stdin** - Perfect for scripting and automation
+- Pipe text directly to Gemini Assist for processing
+- Example: `echo "Summarize this" | gemini-assist`
 
-### API Integration
-- **Full Gemini API Support** - Seamless integration with Google's Generative AI SDK
-- **Multiple Model Support** - Choose between different Gemini models (gemini-pro, gemini-pro-vision)
-- **Configurable Parameters** - Customize temperature and other generation parameters
+### 📊 Enhanced Version Information
+- **Detailed version command** - `--version-info` flag shows comprehensive system information
+- Displays package details, Node.js version, platform, and Rust binding status
+- Helpful for debugging and support requests
 
-### User Experience
-- **Beautiful CLI Interface** - Colorful, user-friendly terminal output with chalk styling
-- **Welcome Screen** - Professional welcome message on startup
-- **Error Handling** - Comprehensive error messages with helpful troubleshooting tips
-- **Command History** - Maintains conversation context during interactive sessions
+### 📝 Conversation History Command
+- **History tracking in interactive mode** - Type `history` or `hist` to see conversation message count
+- Better awareness of conversation context
+- Useful for understanding conversation length
+
+### 🎯 Improved CLI Experience
+- Better help messages with new command examples
+- Enhanced error messages for stdin usage
+- More intuitive command flow
+
+## 🔧 Technical Improvements
+
+### Code Quality
+- Improved error handling for stdin operations
+- Better async/await patterns
+- Enhanced code documentation
 
 ### Developer Experience
-- **Programmatic API** - Use as an npm package in your Node.js projects
-- **Environment Variable Support** - Secure API key management via .env files
-- **Flexible Configuration** - Multiple ways to configure API keys and options
-
-## 🔧 Technical Details
-
-### Dependencies
-- `@google/generative-ai` (^0.21.0) - Official Google Generative AI SDK
-- `commander` (^11.1.0) - Command-line interface framework
-- `chalk` (^4.1.2) - Terminal string styling
-- `dotenv` (^16.4.5) - Environment variable management
-
-### Architecture
-- Modular design with separate concerns:
-  - `bin/gemini-assist.js` - CLI entry point and command handling
-  - `src/gemini.js` - Gemini API client and chat logic
-  - `src/utils.js` - Utility functions and helpers
-  - `index.js` - Programmatic API export
-
-### Supported Platforms
-- macOS
-- Linux
-- Windows (with Node.js)
+- More flexible input methods (args, stdin, interactive)
+- Better separation of concerns
+- Improved code maintainability
 
 ## 📋 Usage Examples
 
-### Basic Interactive Mode
+### Stdin Support (New!)
 ```bash
-gemini-assist --interactive
+# Pipe text directly
+echo "What is AI?" | gemini-assist
+
+# Process file content
+cat document.txt | gemini-assist "Summarize this"
+
+# Chain commands
+curl -s https://api.example.com/data | gemini-assist "Analyze this JSON"
 ```
 
-### Single Query
+### Enhanced Version Info (New!)
 ```bash
-gemini-assist "Explain quantum computing in simple terms"
+# Show detailed version information
+gemini-assist --version-info
 ```
 
-### Custom Configuration
+### History Command (New!)
 ```bash
-gemini-assist --model gemini-pro --temperature 0.9 --interactive
+# In interactive mode
+gemini-assist --interactive
+You> history
+📊 Conversation history: 5 messages
 ```
 
-## 🐛 Known Issues
+## 🐛 Bug Fixes
+
+- Fixed stdin detection for better pipe support
+- Improved error messages when no input is provided
+- Better handling of edge cases in interactive mode
 
-- Chat history is not persisted between sessions
-- No support for file uploads or multimodal inputs in this release
-- Rate limiting errors may occur with free-tier API keys
+## 📝 Migration from v1.1.1-Beta
+
+No breaking changes! This is a drop-in replacement. Simply update:
+
+```bash
+npm install -g @zemerik/gemini-assist@latest
+```
+
+All existing functionality remains the same, with new features added.
 
 ## 🔮 Upcoming Features (Planned)
 
@@ -90,28 +102,21 @@ gemini-assist --model gemini-pro --temperature 0.9 --interactive
 ## 📝 Installation
 
 ```bash
-npm install -g gemini-assist
+npm install -g @zemerik/gemini-assist
 ```
 
 ## 🔑 Getting Started
 
 1. Get your API key from [Google AI Studio](https://makersuite.google.com/app/apikey)
 2. Set environment variable: `export GEMINI_API_KEY=your_key`
-3. Run: `gemini-assist --interactive`
-
-## ⚠️ Beta Notice
-
-This is a beta release. While we've tested the core functionality, you may encounter:
-- Occasional API errors
-- Performance variations
-- Missing features compared to future stable releases
-
-We welcome feedback and bug reports to help improve the tool!
+3. Or create a `.env` file: `GEMINI_API_KEY=your_key`
+4. Run: `gemini-assist --interactive`
 
 ## 🙏 Acknowledgments
 
 - Google Gemini API team for the powerful AI capabilities
 - Open source community for the excellent npm packages used
+- All contributors and users who provided feedback
 
 ## 📄 License
 
@@ -119,6 +124,6 @@ MIT License - See LICENSE file for details
 
 ---
 
-**Download:** `npm install -g gemini-assist`  
+**Download:** `npm install -g @zemerik/gemini-assist`  
 **Documentation:** See README.md  
 **Issues:** Please report via GitHub Issues

package/bin/gemini-assist.js

@@ -4,6 +4,7 @@ const { program } = require('commander');
 const chalk = require('chalk');
 const readline = require('readline');
 const path = require('path');
+const fs = require('fs');
 require('dotenv').config();
 
 const { GeminiClient } = require('../src/gemini');
@@ -15,15 +16,22 @@ const packageJson = require('../package.json');
 program
   .name('gemini-assist')
   .description('AI Assistant CLI powered by Google Gemini API')
-  .version(packageJson.version)
+  .version(packageJson.version, '-v, --version', 'Display version information')
   .option('-k, --api-key <key>', 'Gemini API key (or set GEMINI_API_KEY env variable)')
   .option('-m, --model <model>', 'Gemini model to use (default: gemini-2.5-flash)')
   .option('-i, --interactive', 'Start interactive chat mode', false)
   .option('-t, --temperature <value>', 'Temperature for response (0-1)', '0.7')
+  .option('--version-info', 'Show detailed version information')
   .parse(process.argv);
 
 const options = program.opts();
 
+// Handle version info command
+if (options.versionInfo) {
+  showVersionInfo();
+  process.exit(0);
+}
+
 async function main() {
   try {
     // Get API key
@@ -54,14 +62,23 @@ async function main() {
       temperature: parseFloat(options.temperature)
     });
 
+    // Check if stdin has data (for piping)
+    const stdinData = await readStdin();
+    
     // Interactive mode
-    if (options.interactive || process.argv.length === 2) {
+    if (options.interactive || (process.argv.length === 2 && !stdinData)) {
       await startInteractiveMode(client);
     } else {
-      // Single query mode
-      const query = program.args.join(' ');
+      // Single query mode - from args, stdin, or error
+      let query = program.args.join(' ');
+      
+      // If no args but stdin has data, use stdin
+      if (!query && stdinData) {
+        query = stdinData;
+      }
+      
       if (!query) {
-        printError('Please provide a query or use --interactive mode.');
+        printError('Please provide a query, use --interactive mode, or pipe input.');
         program.help();
         process.exit(1);
       }
@@ -87,7 +104,8 @@ async function startInteractiveMode(client) {
     prompt: chalk.cyan('You> ')
   });
 
-  console.log(chalk.gray('Type your message and press Enter. Type "exit", "quit", or "bye" to end the conversation.\n'));
+  console.log(chalk.gray('Type your message and press Enter. Type "exit", "quit", or "bye" to end the conversation.'));
+  console.log(chalk.gray('Commands: "clear" to clear screen, "history" to show conversation history.\n'));
 
   rl.prompt();
 
@@ -114,6 +132,18 @@ async function startInteractiveMode(client) {
       return;
     }
 
+    // History command
+    if (query.toLowerCase() === 'history' || query.toLowerCase() === 'hist') {
+      try {
+        const count = await client.getHistoryCount();
+        console.log(chalk.blue(`\n📊 Conversation history: ${count} messages\n`));
+      } catch (error) {
+        console.log(chalk.blue('\n📊 Conversation history: Not available\n'));
+      }
+      rl.prompt();
+      return;
+    }
+
     // Show thinking indicator
     process.stdout.write(chalk.gray('Gemini> '));
     
@@ -132,5 +162,63 @@ async function startInteractiveMode(client) {
   });
 }
 
+// Helper function to read from stdin
+function readStdin() {
+  return new Promise((resolve) => {
+    if (process.stdin.isTTY) {
+      resolve('');
+      return;
+    }
+    
+    let data = '';
+    process.stdin.setEncoding('utf8');
+    
+    process.stdin.on('data', (chunk) => {
+      data += chunk;
+    });
+    
+    process.stdin.on('end', () => {
+      resolve(data.trim());
+    });
+    
+    // Set a timeout to resolve if no data comes
+    setTimeout(() => resolve(''), 100);
+  });
+}
+
+// Helper function to show detailed version info
+function showVersionInfo() {
+  const os = require('os');
+  let rustInfo = 'Not available (using JS fallback)';
+  let nodeVersion = process.version;
+  
+  try {
+    const native = require('../index.node');
+    const rustVersion = native.rust_version();
+    rustInfo = 'Available ✓';
+  } catch (error) {
+    rustInfo = 'Not available (using JS fallback)';
+  }
+  
+  console.log(chalk.bold.cyan('╔═══════════════════════════════════════╗'));
+  console.log(chalk.bold.cyan('║   ') + chalk.bold.white('Gemini Assist Version Info') + chalk.bold.cyan('   ║'));
+  console.log(chalk.bold.cyan('╚═══════════════════════════════════════╝'));
+  console.log(chalk.cyan('\n📦 Package:') + chalk.white(` ${packageJson.name}`));
+  console.log(chalk.cyan('🔢 Version:') + chalk.white(` ${packageJson.version}`));
+  console.log(chalk.cyan('📝 Description:') + chalk.white(` ${packageJson.description}`));
+  console.log(chalk.cyan('👤 Author:') + chalk.white(` ${packageJson.author}`));
+  console.log(chalk.cyan('📄 License:') + chalk.white(` ${packageJson.license}`));
+  console.log(chalk.cyan('\n🖥️  Environment:'));
+  console.log(chalk.cyan('   Node.js:') + chalk.white(` ${nodeVersion}`));
+  console.log(chalk.cyan('   Platform:') + chalk.white(` ${os.platform()} ${os.arch()}`));
+  console.log(chalk.cyan('   Rust Bindings:') + chalk.white(` ${rustInfo}`));
+  console.log(chalk.cyan('\n🔗 Links:'));
+  if (packageJson.repository && packageJson.repository.url) {
+    console.log(chalk.cyan('   Repository:') + chalk.white(` ${packageJson.repository.url}`));
+  }
+  console.log(chalk.cyan('   NPM:') + chalk.white(` https://www.npmjs.com/package/${packageJson.name}`));
+  console.log('');
+}
+
 // Run the CLI
 main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zemerik/gemini-assist",
-  "version": "1.1.1-beta",
+  "version": "1.1.2",
   "description": "AI Assistant CLI tool powered by Google Gemini API (50% JS, 50% Rust)",
   "main": "index.js",
   "bin": {