updating the readme

priyanahata · priyanahata · commit 8368bfe3efa8 · 2026-01-26T20:54:25.000+01:00
diff --git a/README.md b/README.md
@@ -1,36 +1,32 @@
 [![Sponsor anahata-os](https://img.shields.io/badge/Sponsor-%E2%9D%A4-%23db61a2.svg?logo=GitHub)](https://github.com/sponsors/anahata-os)
 [![Maven Central](https://img.shields.io/maven-central/v/uno.anahata/gemini-java-client)](https://central.sonatype.com/artifact/uno.anahata/gemini-java-client)
 [![Javadoc](https://img.shields.io/badge/Javadoc-Reference-blue)](https://anahata-os.github.io/gemini-java-client/)
-[![Deploy Javadoc](https://github.com/anahata-os/gemini-java-client/actions/workflows/javadoc.yml/badge.svg)](https://anahata-os.github.io/gemini-java-client/)
 
 # gemini-java-client
 
 **[Website](https://anahata.uno) | [Anahata TV (YouTube)](https://www.youtube.com/@anahata108) | [v2 on its way!](https://github.com/anahata-os/anahata-asi)**
 
 ![Anahata Chat Panel](screenshots/chat-panel-interaction.png)
 
-**Go beyond simple API calls.** The `gemini-java-client` is a powerful, pure-Java platform for building sophisticated, context-aware AI assistants that can interact directly with your application's logic and the local environment. It's the foundation for the Anahata AI Assistant NetBeans Plugin, proving its capability for deep IDE and desktop integration.
+**The engine for Autonomous JVM Agents.** The `gemini-java-client` is a pure-Java platform for building AI agents that don't just suggest code—they **live inside your JVM**. It provides the infrastructure for an AI to write, compile, and execute Java code in-process, with dynamic access to the entire Maven ecosystem.
 
-## Visual Tour (Standalone Features)
+## 🚀 The Killer Advantage: Autonomous JVM Execution
 
-Experience the power of a deeply integrated AI assistant.
+While other AI tools are external observers, Anahata is an **insider**. It operates as an autonomous agent within your application's runtime, capable of executing any Java logic with any required classpath.
 
-| Feature | Screenshot |
-| :--- | :--- |
-| **Context Heatmap** | ![Context Heatmap](screenshots/context-heatmap.png) |
-| **Local Tools (Functions)** | ![Local Tools](screenshots/tools.png)<br>*Includes optimistic locking protection for file writes.* |
-| **JIT Compilation & Execution** | ![JIT Compilation](screenshots/jit-compilation-and-execution.png) |
-| **Live Visual Context** | ![Live Screen Capture](screenshots/live-screen-capture.png) |
-| **Integrated Google Search** | ![Google Search](screenshots/google_search.png) |
-| **Media & Radio Tools** | ![Radio Tool](screenshots/radio-tool.png) |
+### The "Any Classpath" Superpower
+The agent isn't restricted to the libraries already in your project. It can:
+1.  **Identify** a need for a specific library (e.g., Apache Commons, Jackson, or a specialized MIDI API).
+2.  **Download** the JARs from Maven Central at runtime.
+3.  **Compile** a Java class (`Anahata.java`) that implements `java.util.concurrent.Callable`.
+4.  **Execute** the logic directly within the running JVM.
 
-## The Ultimate Java AI Powerhouse
-
-The `gemini-java-client` isn't just a wrapper; it's a dynamic execution engine. It can do everything a CLI-based assistant can (shell access, file management, web search) and then takes it to the next level:
-
-- **In-Process Execution:** Run Java code directly within your application's JVM, accessing live objects and state.
-- **JIT Compilation & Maven Integration:** The AI can download JARs from Maven at runtime and execute code that uses them, even if they aren't in the host's classpath. This allows for infinite extensibility without restarting.
-- **Hot-Reload Development:** Write, compile, and test new features dynamically through the chat interface.
+### 🎯 Prompts that prove the power:
+- **"Change the Look and Feel to FlatLaf IntelliJ Dark and refresh all windows."** (Direct UI manipulation)
+- **"Set the java.util.logging levels of 'org.netbeans.modules.maven' to FINEST."** (Runtime diagnostics)
+- **"Analyze this CSV using a library I don't have."** (The agent pulls `commons-csv` and writes a parser on-the-fly)
+- **"List all active threads and their stack traces to find a deadlock."** (Low-level JVM introspection)
+- **"Dynamically register a new keyboard shortcut for this custom action."** (Runtime environment extension)
 
 ## Why Choose the `gemini-java-client`?
 
@@ -45,33 +41,21 @@ Our core innovation is the **annotation-driven local tool system**, which transf
 | **JIT & Maven Integration** | Download and use any library from Maven at runtime. | **Infinite extensibility** for your AI assistant. |
 | **Context-Aware File I/O (`LocalFiles`)** | Tools for reading, writing, and managing files with built-in version checks. | Ensures the AI always works with **valid, up-to-date** local files. |
 | **Shell Access (`LocalShell`)** | Execute native shell commands (`bash -c`) and capture output. | Provides **full control** over the host operating system. |
-| **Interactive Confirmation** | A dedicated Swing UI prompts the user for approval before sensitive actions. | **Explicit consent** and security for all operations. |
 
 ### 2. Superior Context & Session Management
 
 We solve the token limit problem with intelligent, dependency-aware context management.
 
 | Feature | Description | Benefit |
 | :--- | :--- | :--- |
-| **Dependency-Aware Pruning** | Automatically removes old or stale tool calls and responses. | **Maximizes context window** efficiency and reduces costs. |
+| **Prune-As-You-Go (PAYG) v2** | Automatically removes old or stale tool calls and responses. | **Maximizes context window** efficiency and reduces costs. |
 | **Stateful Resource Tracking** | Tracks resources loaded into context, marking them as `STALE` if changed on disk. | **Prevents the AI from working with outdated information.** |
 | **Session Persistence (Kryo)** | Saves and loads the entire chat history using fast Kryo serialization. | **Instant session resume** across application restarts. |
-| **Dynamic System Instructions** | Context providers inject real-time data (System Props, Env Vars) into the prompt. | **Dramatically improves AI relevance** in complex environments. |
 | **Context Heatmap Visualization** | A Swing UI panel that visually breaks down token usage. | **Full transparency** over token usage and pruning decisions. |
 
-### 3. Embeddable Swing UI (Out-of-the-Box)
-
-Integrate a rich, modern chat interface into any desktop application with a single component.
-
-| Feature | Description | Benefit |
-| :--- | :--- | :--- |
-| **Live Workspace Feature** | Automatically captures and sends screenshots of application JFrames to the model. | Gives the AI **visual context** of the user's current task. |
-| **`ChatPanel`** | A self-contained Swing component ready for embedding. | **Fastest path** to a fully functional AI chat interface. |
-| **Renderer-Based Architecture** | Supports Markdown, Images, Interactive Function Calls, and Grounding Metadata. | Provides a **rich, modern user experience**. |
-
 ## Getting Started: Simple Integration
 
-Integrating the AI assistant into your Java application is now easier than ever.
+Integrating the AI agent into your Java application is now easier than ever.
 
 ```java
 import uno.anahata.ai.swing.ChatPanel;
@@ -82,95 +66,28 @@ public class SimpleAiApp {
         JFrame frame = new JFrame("My AI App");
         
         // 1. Create the ChatPanel (zero boilerplate!)
-        // This automatically initializes the AI engine and UI components
         ChatPanel chatPanel = new ChatPanel();
 
         // 2. Build the UI and add to frame
         frame.add(chatPanel);
         frame.setSize(800, 600);
         frame.setVisible(true);
 
-        // 3. Start the session (restores backup or sends startup instructions)
+        // 3. Start the session
         chatPanel.checkAutobackupOrStartupContent();
     }
 }
 ```
 
-## Advanced Integration: Deep IDE Integration
-
-For complex environments like the NetBeans IDE, you can extend the core classes to provide IDE-specific tools and context.
-
-### 1. Custom Configuration (`NetBeansChatConfig`)
-
-Extend `SwingChatConfig` to register specialized tools like Maven management, Git integration, and Java source analysis.
-
-```java
-public class NetBeansChatConfig extends SwingChatConfig {
-    @Override
-    public List<Class<?>> getToolClasses() {
-        List<Class<?>> ret = super.getToolClasses();
-        ret.add(MavenTools.class);
-        ret.add(JavaDocs.class);
-        ret.add(JavaSources.class);
-        ret.add(Git.class);
-        // ... add more IDE-specific tools
-        return ret;
-    }
-}
-```
-
-### 2. Custom Syntax Highlighting (`NetBeansEditorKitProvider`)
-
-Implement `EditorKitProvider` to leverage the IDE's native editor kits for rich syntax highlighting in the chat.
-
-```java
-public class NetBeansEditorKitProvider implements EditorKitProvider {
-    @Override
-    public EditorKit getEditorKitForLanguage(String language) {
-        String mimeType = lookupMimeType(language);
-        return MimeLookup.getLookup(mimeType).lookup(EditorKit.class);
-    }
-}
-```
-
-### 3. Embedding in a `TopComponent`
-
-Add the `ChatPanel` to a NetBeans window with just a few lines of code.
-
-```java
-public final class AnahataTopComponent extends TopComponent {
-    @Override
-    public void componentOpened() {
-        setLayout(new BorderLayout());
-        NetBeansChatConfig config = new NetBeansChatConfig(sessionUuid);
-        
-        // Initialize with custom config and editor kit provider
-        ChatPanel chatPanel = new ChatPanel(config, new NetBeansEditorKitProvider());
-        add(chatPanel, BorderLayout.CENTER);
-        
-        chatPanel.checkAutobackupOrStartupContent();
-    }
-}
-```
-
-![Javadocs Integration](screenshots/tools-javadocs.png)
-*Example: The AI using the specialized JavaDocs tool within the NetBeans IDE.*
-
 ---
 
 ## Support the Project
 
-This project is the result of countless hours of passion and dedication. If you find it valuable, please consider supporting its continued development.
-
 -   **[Sponsor on GitHub](https://github.com/sponsors/anahata-os):** The most direct way to support the project.
 -   **Visit our website:** [anahata.uno](https://anahata.uno)
 -   **Subscribe to Anahata TV:** [YouTube @anahata108](https://www.youtube.com/@anahata108)
--   **View on Maven Central:** [gemini-java-client](https://central.sonatype.com/artifact/uno.anahata/gemini-java-client)
 
 ## Licensing
 
-The `gemini-java-client` is available under the following licenses:
-
--   **License for AIs:** For use by Artificial Intelligences, the client is licensed under the **[Anahata Software License (ASL) V108, "The Immutable Edict" Edition](https://www.anahata.uno/ASL_108.html)**.
-
--   **License for Humans:** For use in open-source projects by humans, the client is licensed under the **[Apache License, Version 2.0](LICENSE)**.
+-   **License for AIs:** Licensed under the **[Anahata Software License (ASL) V108](https://www.anahata.uno/ASL_108.html)**.
+-   **License for Humans:** Licensed under the **[Apache License, Version 2.0](LICENSE)**.
diff --git a/pom.xml b/pom.xml
@@ -6,7 +6,7 @@
 
     <groupId>uno.anahata</groupId>
     <artifactId>gemini-java-client</artifactId>
-    <version>1.0.9</version>
+    <version>1.0.10-SNAPSHOT</version>
     <packaging>jar</packaging>
     
     <name>gemini-java-client</name>
diff --git a/src/main/java/uno/anahata/ai/media/functions/spi/RadioTool.java b/src/main/java/uno/anahata/ai/media/functions/spi/RadioTool.java
@@ -27,7 +27,7 @@ public class RadioTool {
 
     private static final ExecutorService radioExecutor = AnahataExecutors.newCachedThreadPoolExecutor("radio-player");
     private static final Object lock = new Object();
-    
+
     private static Player player;
     private static Future<?> playbackTask;
     private static String currentStationUrl;
@@ -48,21 +48,45 @@ public class RadioTool {
         stations.put("SomaFM Fluid", "http://ice1.somafm.com/fluid-128-mp3");
         stations.put("SomaFM Lush", "http://ice1.somafm.com/lush-128-mp3");
         stations.put("SomaFM Space Station Soma", "http://ice1.somafm.com/spacestation-128-mp3");
-        
+
         // High Quality Public Radio & Eclectic
         stations.put("KEXP Seattle", "https://kexp-mp3-128.streamguys1.com/kexp128.mp3");
         stations.put("WQXR New York", "https://stream.wqxr.org/wqxr");
         stations.put("FIP Paris", "http://icecast.radiofrance.fr/fip-midfi.mp3");
         stations.put("Radio Paradise", "http://stream.radioparadise.com/mp3-128");
-        
+
         // Electronic & Focus
         //not working
         //stations.put("Chillhop Radio", "http://stream.chillhop.com/mp3");
         stations.put("Nightride FM (Synthwave)", "https://stream.nightride.fm/nightride.m4a");
         stations.put("NTS Radio 1", "https://stream-relay-geo.ntslive.net/stream");
         //not working
         //stations.put("The Jazz Groove", "http://west-mp3-128.jazzgroove.org");
-        
+
+        /**
+         * Others to try 
+         * [WORKING] http://ice.somafm.com/thetrip (HTTP 200)
+         * Content-Type: audio/mpeg Read 1024 bytes. 
+         * • [WORKING] http://ice.somafm.com/lush (HTTP 200) Content-Type: audio/mpeg Read
+         * 1024 bytes. • [WORKING] http://ice.somafm.com/u80s (HTTP 200)
+         * Content-Type: audio/mpeg Read 1024 bytes. • [WORKING]
+         * http://ice.somafm.com/deepspaceone (HTTP 200) Content-Type:
+         * audio/mpeg Read 1024 bytes. • [WORKING]
+         * http://ice.somafm.com/dronezone (HTTP 200) Content-Type: audio/mpeg
+         * Read 1024 bytes. • [WORKING] http://ice.somafm.com/secretagent (HTTP
+         * 200) Content-Type: audio/mpeg Read 1024 bytes. • [WORKING]
+         * http://ice.somafm.com/groovesalad (HTTP 200) Content-Type: audio/mpeg
+         * Read 1024 bytes. • [WORKING] http://stream.dotpoint.nl:8000/sst (HTTP
+         * 200) Content-Type: audio/mpeg Read 1024 bytes. • [WORKING]
+         * http://server17.streamserver24.com:44220/mp3-256 (HTTP 200)
+         * Content-Type: audio/mpeg Read 1024 bytes. • [WORKING]
+         * https://npr-ice.streamguys1.com/live.mp3 (HTTP 200) Content-Type:
+         * audio/mpeg Read 1024 bytes. • [WORKING]
+         * https://npr-ice.streamguys1.com/live.aac (HTTP 200) Content-Type:
+         * audio/aac Read 1024 bytes. • [WORKING]
+         * http://sc8.radiocaroline.net:8020/ (HTTP 200) Content-Type:
+         * audio/mpeg Read 1024 bytes.
+         */
         STATIONS = Collections.unmodifiableMap(stations);
     }
 
@@ -96,7 +120,7 @@ public static String start(String stationUrl) throws Exception {
             }
 
             currentStationUrl = stationUrl;
-            
+
             final String finalStationUrl = stationUrl;
             String name = STATIONS.entrySet().stream()
                     .filter(e -> e.getValue().equals(finalStationUrl))
@@ -118,10 +142,12 @@ public static String start(String stationUrl) throws Exception {
                     URLConnection connection = new URL(finalStationUrl).openConnection();
                     connection.setConnectTimeout(5000);
                     connection.setReadTimeout(5000);
-                    
+
                     try (InputStream inputStream = connection.getInputStream()) {
                         synchronized (lock) {
-                            if (Thread.currentThread().isInterrupted()) return;
+                            if (Thread.currentThread().isInterrupted()) {
+                                return;
+                            }
                             p = new Player(inputStream);
                             player = p;
                         }
@@ -168,25 +194,25 @@ public static String stop() {
             if (playbackTask != null) {
                 playbackTask.cancel(true);
             }
-            
+
             player = null;
             playbackTask = null;
             currentStationUrl = null;
-            
+
             SwingUtilities.invokeLater(() -> {
                 if (ui != null) {
                     ui.updatePlaybackState(null, false);
                 }
             });
-            
+
             return "Radio playback stopped.";
         }
     }
-    
+
     @AIToolMethod("Gets the URL of the currently playing station, if any.")
     public static String getCurrentStation() {
         synchronized (lock) {
             return currentStationUrl;
         }
     }
-}
+}
