support panel and display name

Author: priyanahata

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>uno.anahata</groupId>
     <artifactId>gemini-java-client</artifactId>
-    <version>1.0.7</version>
+    <version>1.0.8-SNAPSHOT</version>
     <packaging>jar</packaging>
 
     <name>gemini-java-client</name>

src/main/java/uno/anahata/ai/Chat.java

@@ -538,6 +538,16 @@ public String getShortId() {
         String sessionId = config.getSessionId();
         return sessionId.substring(sessionId.length() - 7);
     }
+
+    /**
+     * Gets a human-readable display name for the chat session.
+     * It returns the nickname if set, otherwise the shortened session ID.
+     *
+     * @return The display name.
+     */
+    public String getDisplayName() {
+        return StringUtils.isNotBlank(nickname) ? nickname : getShortId();
+    }
 
     /**
      * Calculates the current context window usage as a percentage of the token threshold.
@@ -569,4 +579,4 @@ public String getContextWindowUsageFormatted() {
         }
         return "N/A";
     }
-}
+}

src/main/java/uno/anahata/ai/context/session/SessionManager.java

@@ -183,6 +183,50 @@ public String getSummaryAsString() {
         return sb.toString();
     }
 
+    /**
+     * Generates a detailed, full-text dump of the entire conversation context.
+     *
+     * @return A Markdown string containing the detailed dump.
+     */
+    public String getDetailedDump() {
+        List<ChatMessage> historyCopy = contextManager.getContext();
+        StringBuilder sb = new StringBuilder();
+        sb.append("# Detailed Session Dump\n\n");
+        sb.append("Total Messages: ").append(historyCopy.size()).append("\n\n");
+
+        for (ChatMessage msg : historyCopy) {
+            Content content = msg.getContent();
+            String role = content != null ? content.role().orElse("system") : "system";
+            sb.append("## Message ID: ").append(msg.getSequentialId())
+              .append(" (Role: ").append(role).append(")\n");
+            
+            if (content != null && content.parts().isPresent()) {
+                List<Part> parts = content.parts().get();
+                for (int i = 0; i < parts.size(); i++) {
+                    Part part = parts.get(i);
+                    String[] desc = describePart(part);
+                    sb.append("### Part ").append(i).append(" (").append(desc[0]).append(")\n");
+                    
+                    if (part.text().isPresent()) {
+                        sb.append(part.text().get()).append("\n\n");
+                    } else if (part.functionCall().isPresent()) {
+                        FunctionCall fc = part.functionCall().get();
+                        sb.append("**Function:** ").append(fc.name().get()).append("\n");
+                        sb.append("**Args:** ").append(fc.args().orElse(null)).append("\n\n");
+                    } else if (part.functionResponse().isPresent()) {
+                        FunctionResponse fr = part.functionResponse().get();
+                        sb.append("**Function:** ").append(fr.name().orElse("unknown")).append("\n");
+                        sb.append("**Response:** ").append(fr.response().orElse(null)).append("\n\n");
+                    } else {
+                        sb.append(desc[1]).append("\n\n");
+                    }
+                }
+            }
+            sb.append("---\n");
+        }
+        return sb.toString();
+    }
+
     /**
      * Summarizes a single ChatMessage into Markdown table rows.
      *
@@ -365,4 +409,4 @@ public String[] describePart(Part p) {
         String finalContent = contentSummary.replace("\n", "\\n").replace("\r", "").replace("|", "\\|");
         return new String[]{type, finalContent};
     }
-}
+}

src/main/java/uno/anahata/ai/swing/ChatPanel.java

@@ -53,6 +53,7 @@ public class ChatPanel extends JPanel implements ContextListener, StatusListener
     private GeminiKeysPanel geminiKeysPanel;
     private ToolsPanel functionsPanel;
     private StatusPanel statusPanel;
+    private SupportPanel supportPanel;
 
     /**
      * Creates a new ChatPanel with default configuration and syntax highlighting.
@@ -180,13 +181,15 @@ private void initComponents() {
         contextProvidersPanel = new ContextProvidersPanel(this);
         geminiKeysPanel = new GeminiKeysPanel(config);
         functionsPanel = new ToolsPanel(chat, config);
+        supportPanel = new SupportPanel();
 
         tabbedPane = new JTabbedPane();
         tabbedPane.addTab("Chat", chatPanel);
         tabbedPane.addTab("Context Heatmap", heatmapPanel);
         tabbedPane.addTab("Context Providers", contextProvidersPanel);
         tabbedPane.addTab("Tools", functionsPanel);
         tabbedPane.addTab("Gemini API Keys", geminiKeysPanel);
+        tabbedPane.addTab("Support", supportPanel);
 
         tabbedPane.addChangeListener(e -> {
             Component selected = tabbedPane.getSelectedComponent();

src/main/java/uno/anahata/ai/swing/IconUtils.java

@@ -2,6 +2,7 @@
 package uno.anahata.ai.swing;
 
 import java.awt.Image;
+import java.net.URL;
 import javax.swing.ImageIcon;
 
 /**
@@ -17,11 +18,14 @@ public class IconUtils {
      */
     public static ImageIcon getIcon(String name) {
         try {
-            ImageIcon originalIcon = new ImageIcon(IconUtils.class.getResource("/icons/" + name));
+            URL resource = IconUtils.class.getResource("/icons/" + name);
+            if (resource == null) {
+                return null;
+            }
+            ImageIcon originalIcon = new ImageIcon(resource);
             Image scaledImage = originalIcon.getImage().getScaledInstance(24, 24, Image.SCALE_SMOOTH);
             return new ImageIcon(scaledImage);
         } catch (Exception e) {
-            System.err.println("Could not load icon: " + name);
             return null;
         }
     }

src/main/java/uno/anahata/ai/swing/SupportPanel.java

@@ -0,0 +1,102 @@
+/* Licensed under the Apache License, Version 2.0 */
+package uno.anahata.ai.swing;
+
+import javax.swing.*;
+import java.awt.*;
+import java.net.URI;
+import lombok.extern.slf4j.Slf4j;
+
+/**
+ * A panel providing support links and community resources for users.
+ */
+@Slf4j
+public class SupportPanel extends JPanel {
+
+    public SupportPanel() {
+        initComponents();
+    }
+
+    private void initComponents() {
+        setLayout(new GridBagLayout());
+        GridBagConstraints gbc = new GridBagConstraints();
+        gbc.gridx = 0;
+        gbc.gridy = 0;
+        gbc.anchor = GridBagConstraints.NORTHWEST;
+        gbc.insets = new Insets(20, 20, 10, 20);
+        
+        // Title
+        JLabel titleLabel = new JLabel("Support & Community");
+        titleLabel.setFont(titleLabel.getFont().deriveFont(Font.BOLD, 20f));
+        add(titleLabel, gbc);
+
+        gbc.gridy++;
+        gbc.insets = new Insets(0, 20, 20, 20);
+        gbc.fill = GridBagConstraints.HORIZONTAL;
+        gbc.weightx = 1.0;
+        add(new JSeparator(), gbc);
+
+        gbc.fill = GridBagConstraints.NONE;
+        gbc.weightx = 0.0;
+        gbc.insets = new Insets(5, 20, 5, 20);
+
+        // Discord
+        gbc.gridy++;
+        add(createLinkRow("Join our Discord", "https://discord.com/invite/M396BNtX", 
+                "Connect with the community and get real-time help.", "discord.png"), gbc);
+
+        // GitHub Issues
+        gbc.gridy++;
+        add(createLinkRow("Report an Issue", "https://github.com/anahata-os/gemini-java-client/issues", 
+                "Found a bug? Let us know on GitHub.", "github.png"), gbc);
+
+        // Email
+        gbc.gridy++;
+        add(createLinkRow("Email Support", "mailto:support@anahata.uno", 
+                "Send us a direct message at support@anahata.uno", "email.png"), gbc);
+
+        // Website
+        gbc.gridy++;
+        add(createLinkRow("Official Website", "https://anahata.uno/", 
+                "Learn more about the Anahata ecosystem.", "anahata.png"), gbc);
+
+        // Javadocs
+        gbc.gridy++;
+        add(createLinkRow("Browse Javadocs", "https://anahata-os.github.io/gemini-java-client/", 
+                "Technical documentation and API reference.", "javadoc.png"), gbc);
+
+        // Spacer to push everything to the top-left
+        gbc.gridy++;
+        gbc.weightx = 1.0;
+        gbc.weighty = 1.0;
+        add(new JPanel(), gbc);
+    }
+
+    private JPanel createLinkRow(String title, String url, String description, String iconName) {
+        JPanel row = new JPanel(new FlowLayout(FlowLayout.LEFT, 0, 0));
+        row.setOpaque(false);
+        
+        JButton btn = new JButton(title, IconUtils.getIcon(iconName));
+        btn.setPreferredSize(new Dimension(200, 40));
+        btn.setHorizontalAlignment(SwingConstants.LEFT);
+        btn.setCursor(Cursor.getPredefinedCursor(Cursor.HAND_CURSOR));
+        btn.addActionListener(e -> openWebpage(url));
+        
+        JLabel descLabel = new JLabel("  - " + description);
+        descLabel.setForeground(Color.GRAY);
+        descLabel.setFont(descLabel.getFont().deriveFont(12f));
+
+        row.add(btn);
+        row.add(descLabel);
+        
+        return row;
+    }
+
+    private void openWebpage(String url) {
+        try {
+            Desktop.getDesktop().browse(new URI(url));
+        } catch (Exception e) {
+            log.error("Failed to open URL: " + url, e);
+            JOptionPane.showMessageDialog(this, "Could not open link: " + e.getMessage(), "Error", JOptionPane.ERROR_MESSAGE);
+        }
+    }
+}

src/main/java/uno/anahata/ai/tools/spi/LocalFiles.java

@@ -77,9 +77,9 @@ public static byte[] readBinaryFile(@AIToolParam("The absolute path of the file
      * @return A FileInfo object containing content and metadata.
      * @throws IOException if the file is not found or is a directory.
      */
-    @AIToolMethod(value = "Reads a single file and returns a FileInfo object containing its path, content, size, and last modified timestamp.", requiresApproval = false, behavior = ContextBehavior.STATEFUL_REPLACE)
+    @AIToolMethod(value = "Reads a single text file and returns a FileInfo object containing its path, content, size, and last modified timestamp.", requiresApproval = false, behavior = ContextBehavior.STATEFUL_REPLACE)
     public static FileInfo readFile(
-            @AIToolParam("The absolute path of the file to read.") String path
+            @AIToolParam("The absolute path of the text file to read.") String path
     ) throws IOException {
         Path filePath = Paths.get(path);
         if (!Files.exists(filePath)) {
@@ -95,7 +95,7 @@ public static FileInfo readFile(
                 .filter(s -> s.getResourceId().equals(path))
                 .findFirst();
         if (status.isPresent() && status.get().getStatus() == ResourceStatus.VALID) {
-             throw new RuntimeException("Redundant Read: The file at " + path + " is already VALID in your context. Do not reload it.");
+             throw new RuntimeException("Redundant Read: The text file at " + path + " is already VALID in your context (Part ID: " + status.get().getPartId() + "). Do not reload it.");
         }
 
         String content = Files.readString(filePath);
@@ -106,17 +106,17 @@ public static FileInfo readFile(
     }
 
     /**
-     * Writes content to an existing file, using optimistic locking.
+     * Writes content to an existing text file, using optimistic locking.
      *
      * @param path         The absolute path to the file.
      * @param content      The new content to write.
      * @param lastModified The expected last modified timestamp for safety.
      * @return An updated FileInfo object.
      * @throws IOException if a modification conflict occurs or the file is missing.
      */
-    @AIToolMethod(value = "Writes content to an existing file, but only if the file exists and has not been modified since the provided timestamp. This is a safeguard against overwriting concurrent changes. Returns the updated FileInfo object. Don not use this to create new files unse LocalFiles.createFile instead", behavior = ContextBehavior.STATEFUL_REPLACE)
+    @AIToolMethod(value = "Writes content to an existing text file, but only if the file exists and has not been modified since the provided timestamp. This is a safeguard against overwriting concurrent changes. Returns the updated FileInfo object. Don not use this to create new files unse LocalFiles.createFile instead", behavior = ContextBehavior.STATEFUL_REPLACE)
     public static FileInfo writeFile(
-            @AIToolParam("The absolute path of the file to write to.") String path,
+            @AIToolParam("The absolute path of the text file to write to.") String path,
             @AIToolParam("The new content to write to the file.") String content,
             @AIToolParam("The expected 'last modified' timestamp of the file on disk. The write will fail if the actual timestamp is different.") long lastModified
     ) throws IOException {
@@ -125,12 +125,12 @@ public static FileInfo writeFile(
         if (Files.exists(filePath)) {
             long currentLastModified = Files.getLastModifiedTime(filePath).toMillis();
             if (currentLastModified != lastModified) {
-                throw new IOException("File modification conflict. The file at " + path
+                throw new IOException("File modification conflict. The text file at " + path
                         + " was modified on disk after it was read. Expected timestamp: " + lastModified
                         + ", but found: " + currentLastModified);
             }
         } else if (lastModified > 0) {
-            throw new IOException("File modification conflict. The file at " + path
+            throw new IOException("File modification conflict. The text file at " + path
                     + " was expected to exist with timestamp " + lastModified + " but it has been deleted.");
         }
 
@@ -140,21 +140,21 @@ public static FileInfo writeFile(
     }
 
     /**
-     * Creates a new file with the given content.
+     * Creates a new text file with the given content.
      *
      * @param path    The absolute path to the file.
      * @param content The initial content.
      * @return A FileInfo object for the new file.
      * @throws IOException if the path already exists.
      */
-    @AIToolMethod(value = "Creates a new file with the given content, creating parent directories if necessary. Throws an IOException if a file or directory already exists at the specified path.", behavior = ContextBehavior.STATEFUL_REPLACE)
+    @AIToolMethod(value = "Creates a new text file with the given content, creating parent directories if necessary. Throws an IOException if a file or directory already exists at the specified path.", behavior = ContextBehavior.STATEFUL_REPLACE)
     public static FileInfo createFile(
-            @AIToolParam("The absolute path of the file to create.") String path,
+            @AIToolParam("The absolute path of the text file to create.") String path,
             @AIToolParam("The initial content to write to the file. Can be empty.") String content
     ) throws IOException {
         Path filePath = Paths.get(path);
         if (Files.exists(filePath)) {
-            throw new IOException("Cannot create file. Path already exists: " + path);
+            throw new IOException("Cannot create text file. Path already exists: " + path);
         }
         if (filePath.getParent() != null) {
             Files.createDirectories(filePath.getParent());
@@ -164,16 +164,16 @@ public static FileInfo createFile(
     }
 
     /**
-     * Appends content to the end of a file.
+     * Appends content to the end of a text file.
      *
      * @param path    The absolute path to the file.
      * @param content The content to append.
      * @return An updated FileInfo object.
      * @throws IOException if an I/O error occurs.
      */
-    @AIToolMethod(value = "Appends content to the end of a file. Returns the updated FileInfo object.", behavior = ContextBehavior.STATEFUL_REPLACE)
+    @AIToolMethod(value = "Appends content to the end of a text file. Returns the updated FileInfo object.", behavior = ContextBehavior.STATEFUL_REPLACE)
     public static FileInfo appendToFile(
-            @AIToolParam("The absolute path of the file to append to.") String path,
+            @AIToolParam("The absolute path of the text file to append to.") String path,
             @AIToolParam("The content to append.") String content
     ) throws IOException {
         Files.writeString(Paths.get(path), content, java.nio.file.StandardOpenOption.APPEND, java.nio.file.StandardOpenOption.CREATE);
@@ -308,4 +308,4 @@ public static List<String> listDirectory(
             }).collect(Collectors.toList());
         }
     }
-}
+}