gencode-ai 0.2.0 → 0.4.0

package/RELEASE_NOTES_v0.4.0.md

@@ -0,0 +1,140 @@
+# Release Notes - v0.4.0
+
+## 🔄 Breaking Changes
+
+### Provider Rename: Gemini → Google
+
+We've renamed the "Gemini" provider to "Google" for better naming consistency.
+
+**Rationale:**
+- Provider = Company (Google, OpenAI, Anthropic)
+- Model = Product (Gemini, GPT, Claude)
+- Aligns with industry naming patterns
+
+**Changes:**
+- Provider ID: `'gemini'` → `'google'`
+- TypeScript: `GeminiProvider` → `GoogleProvider`, `GeminiConfig` → `GoogleConfig`
+
+**Unchanged:**
+- ✅ Model names: `gemini-2.0-flash`, `gemini-1.5-pro`, etc.
+- ✅ Environment variables: `GOOGLE_API_KEY` and `GEMINI_API_KEY` both supported
+- ✅ All functionality identical
+
+### Migration Required
+
+**Automatic Migration (Recommended):**
+
+```bash
+# macOS
+sed -i '' 's/"gemini":/"google":/g' ~/.gen/providers.json
+sed -i '' 's/"gemini:/"google:/g' ~/.gen/providers.json
+sed -i '' 's/"provider": "gemini"/"provider": "google"/g' ~/.gen/settings.json
+
+# Linux
+sed -i 's/"gemini":/"google":/g' ~/.gen/providers.json
+sed -i 's/"gemini:/"google:/g' ~/.gen/providers.json
+sed -i 's/"provider": "gemini"/"provider": "google"/g' ~/.gen/settings.json
+```
+
+**Manual Migration:**
+
+1. **`~/.gen/settings.json`**: Change `"provider": "gemini"` → `"provider": "google"`
+2. **`~/.gen/providers.json`**:
+   - Rename connection: `"gemini": {...}` → `"google": {...}`
+   - Rename model cache: `"gemini:api_key": {...}` → `"google:api_key": {...}`
+
+**For SDK Users:**
+
+```typescript
+// Before
+import { GeminiProvider, type GeminiConfig } from 'gencode-ai';
+const provider = new GeminiProvider();
+
+// After
+import { GoogleProvider, type GoogleConfig } from 'gencode-ai';
+const provider = new GoogleProvider();
+```
+
+---
+
+## ✨ New Features
+
+### Context Management (Proposal 0007)
+Manual control over conversation context with new CLI commands:
+
+- **`/compact`** - Trigger conversation compaction manually
+  - Summarizes older messages to reduce context
+  - Shows before/after statistics
+
+- **`/context`** - View context usage statistics
+  - Active vs total messages
+  - Compression status
+  - Visual progress indicator
+
+### Checkpoint Persistence (Proposal 0008)
+Fixed critical persistence bug:
+
+- ✅ Checkpoints saved to disk with sessions
+- ✅ Restored when resuming sessions
+- ✅ Preserved when forking sessions
+- ✅ Session compression works across restarts
+
+### Gemini 3+ Thinking Support
+Added support for Gemini 3+ model reasoning:
+
+- Captures `thoughtSignature` from Gemini 3+ models
+- Streams reasoning chunks with `type: 'reasoning'`
+- Preserves thinking process in tool calls
+
+---
+
+## 🐛 Bug Fixes
+
+- Fixed checkpoint data not persisting across session restarts
+- Fixed provider display name for Google in registry
+- Improved error messages for unknown provider IDs
+
+---
+
+## 📚 Documentation
+
+- Added session compression implementation guide with flowcharts
+- Updated provider documentation for Google rename
+- Added migration guide for breaking changes
+
+---
+
+## 🧹 Housekeeping
+
+- Removed temporary test scripts and documentation
+- Cleaned up code comments and logging
+- Improved checkpoint serialization logic
+
+---
+
+## 📦 Installation
+
+```bash
+# New installation
+npm install -g gencode-ai@0.4.0
+
+# Update from v0.3.x
+npm update -g gencode-ai
+```
+
+---
+
+## ⚠️ Important Notes
+
+- **Breaking changes** - Follow migration guide above
+- **Backup recommended** - Back up `~/.gen/` before upgrading
+- **Config update required** - Use migration script or update manually
+- **SDK users** - Update imports from `GeminiProvider` to `GoogleProvider`
+
+---
+
+## 🔗 Links
+
+- [Full Changelog](https://github.com/your-repo/gencode/compare/v0.3.0...v0.4.0)
+- [Documentation](https://github.com/your-repo/gencode/docs)
+- [Report Issues](https://github.com/your-repo/gencode/issues)

package/dist/agent/agent.d.ts

@@ -1,7 +1,7 @@
 /**
  * Agent - Core agent implementation with tool loop and session support
  */
-import type { Message } from '../providers/types.js';
+import type { Message, Provider } from '../providers/types.js';
 import { PermissionManager, type ApprovalAction, type ApprovalSuggestion, type PromptPermission, type PermissionSettings } from '../permissions/index.js';
 import { SessionManager } from '../session/index.js';
 import { MemoryManager, type LoadedMemory } from '../memory/index.js';
@@ -17,7 +17,6 @@ export declare class Agent {
     private memoryManager;
     private planModeManager;
     private config;
-    private messages;
     private sessionId;
     private loadedMemory;
     private askUserCallback;
@@ -106,12 +105,26 @@ export declare class Agent {
     getSessionManager(): SessionManager;
     /**
      * Set the model to use (auto-switches provider if needed)
+     * @param model Model ID to use
+     * @param provider Optional: explicit provider (otherwise inferred from model name)
+     * @param authMethod Optional: explicit auth method (otherwise inferred or use current)
      */
-    setModel(model: string): void;
+    setModel(model: string, provider?: string, authMethod?: string): void;
     /**
      * Get current model
      */
     getModel(): string;
+    /**
+     * Get current provider
+     */
+    getProvider(): Provider;
+    /**
+     * Get model information for compression
+     */
+    getModelInfo(): {
+        contextWindow: number;
+        outputLimit?: number;
+    };
     /**
      * List available models from the provider API
      */
@@ -150,7 +163,7 @@ export declare class Agent {
     /**
      * Run a single query through the agent
      */
-    run(prompt: string): AsyncGenerator<AgentEvent, void, unknown>;
+    run(prompt: string, signal?: AbortSignal): AsyncGenerator<AgentEvent, void, unknown>;
     /**
      * Clear conversation history
      */
@@ -164,5 +177,14 @@ export declare class Agent {
      * Get conversation history
      */
     getHistory(): Message[];
+    /**
+     * Get compression statistics
+     */
+    getCompressionStats(): {
+        totalMessages: number;
+        activeMessages: number;
+        summaryCount: number;
+        compressionRatio: number;
+    } | null;
 }
 //# sourceMappingURL=agent.d.ts.map

package/dist/agent/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"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"}