pygpt-net 2.6.60__py3-none-any.whl → 2.6.62__py3-none-any.whl

pygpt_net/utils.py

@@ -6,15 +6,19 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2025.08.19 07:00:00                  #
+# Updated Date: 2025.09.25 12:00:00                  #
 # ================================================== #
 
 import json
 import os
 import re
+import math
+
 from datetime import datetime
 from contextlib import contextmanager
 from typing import Any
+from decimal import Decimal, ROUND_HALF_UP, InvalidOperation
+from typing import Sequence
 
 from PySide6 import QtCore, QtGui
 from PySide6.QtWidgets import QApplication
@@ -381,4 +385,112 @@ def mem_clean(force: bool = False) -> bool:
         '''
     except Exception as e:
         print(e)
-    return ok
+    return ok
+
+def short_num(value,
+              *,
+              base: int = 1000,
+              suffixes: Sequence[str] = ("", "k", "M", "B", "T", "P", "E"),
+              max_decimals: int = 1,
+              decimal_sep: str = ",") -> str:
+    """
+    Compact human-readable formatter for numbers with suffixes (k, M, B, ...).
+
+    Rules:
+      - abs(value) < base -> return the value without a suffix
+      - otherwise -> divide by base^n and append suffix
+      - decimals:
+           < 10   -> up to 2 (bounded by max_decimals)
+           < 100  -> up to 1 (bounded by max_decimals)
+           >= 100 -> 0
+      - rounding: ROUND_HALF_UP
+      - auto "carry" to the next suffix after rounding (e.g., 999.95k -> 1M)
+
+    Params:
+      - base: 1000 for general numbers, 1024 for bytes, etc.
+      - suffixes: first item must be "" (for < base)
+      - max_decimals: upper bound for fractional digits
+      - decimal_sep: decimal separator in the output
+    """
+
+    # --- helpers hidden inside (closure) ---
+
+    def _to_decimal(v) -> Decimal:
+        """Convert supported inputs to Decimal; keep NaN/Inf as-is."""
+        if isinstance(v, Decimal):
+            return v
+        if isinstance(v, int):
+            return Decimal(v)
+        if isinstance(v, float):
+            if math.isnan(v):
+                return Decimal("NaN")
+            if math.isinf(v):
+                return Decimal("Infinity") if v > 0 else Decimal("-Infinity")
+            # str() to avoid binary float artefacts
+            return Decimal(str(v))
+        try:
+            return Decimal(str(v))
+        except (InvalidOperation, ValueError, TypeError):
+            raise TypeError("short_num(value): value must be numeric (int/float/Decimal) "
+                            "or a string parsable to a number.")
+
+    def _decimals_for(scaled: Decimal) -> int:
+        """Pick number of decimals based on magnitude."""
+        if max_decimals <= 0:
+            return 0
+        if scaled < 10:
+            return min(2, max_decimals)
+        if scaled < 100:
+            return min(1, max_decimals)
+        return 0
+
+    def _round_dec(d: Decimal, decimals: int) -> Decimal:
+        """ROUND_HALF_UP to the requested decimals."""
+        if decimals <= 0:
+            return d.quantize(Decimal("1"), rounding=ROUND_HALF_UP)
+        q = Decimal(1).scaleb(-decimals)  # 10**(-decimals)
+        return d.quantize(q, rounding=ROUND_HALF_UP)
+
+    def _strip_trailing_zeros(s: str) -> str:
+        """Remove trailing zeros and trailing decimal point if needed."""
+        if "." in s:
+            s = s.rstrip("0").rstrip(".")
+        return s
+
+    # --- main logic ---
+
+    d = _to_decimal(value)
+    if not d.is_finite():
+        # For NaN/Inf just echo back Python-ish text
+        return str(value)
+
+    sign = "-" if d < 0 else ""
+    d = abs(d)
+
+    # For values below base, return "as is" (normalized, no suffix)
+    if d < base:
+        s = _strip_trailing_zeros(f"{d.normalize():f}")
+        return (sign + s).replace(".", decimal_sep)
+
+    # Find initial suffix tier
+    idx = 0
+    last_idx = len(suffixes) - 1
+    while d >= base and idx < last_idx:
+        d = d / base
+        idx += 1
+
+    # Choose decimals, round, then handle possible carry to next suffix
+    decimals = _decimals_for(d)
+    d = _round_dec(d, decimals)
+
+    while d >= base and idx < last_idx:
+        # Carry over (e.g., 999.95k -> 1000.00k -> 1.00M)
+        d = d / base
+        idx += 1
+        decimals = _decimals_for(d)
+        d = _round_dec(d, decimals)
+
+    # Format, trim zeros, apply custom decimal separator, attach suffix
+    out = f"{d:.{decimals}f}"
+    out = _strip_trailing_zeros(out).replace(".", decimal_sep)
+    return f"{sign}{out}{suffixes[idx]}"

{pygpt_net-2.6.60.dist-info → pygpt_net-2.6.62.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pygpt-net
-Version: 2.6.60
+Version: 2.6.62
 Summary: Desktop AI Assistant powered by: OpenAI GPT-5, GPT-4, o1, o3, Gemini, Claude, Grok, DeepSeek, and other models supported by Llama Index, and Ollama. Chatbot, agents, completion, image generation, vision analysis, speech-to-text, plugins, MCP, internet access, file handling, command execution and more.
 License: MIT
 Keywords: ai,api,api key,app,assistant,bielik,chat,chatbot,chatgpt,claude,dall-e,deepseek,desktop,gemini,gpt,gpt-3.5,gpt-4,gpt-4-vision,gpt-4o,gpt-5,gpt-oss,gpt3.5,gpt4,grok,langchain,llama-index,llama3,mistral,o1,o3,ollama,openai,presets,py-gpt,py_gpt,pygpt,pyside,qt,text completion,tts,ui,vision,whisper
@@ -117,7 +117,7 @@ Description-Content-Type: text/markdown
 
 [![pygpt](https://snapcraft.io/pygpt/badge.svg)](https://snapcraft.io/pygpt)
 
-Release: **2.6.60** | build: **2025-09-25** | Python: **>=3.10, <3.14**
+Release: **2.6.62** | build: **2025-09-26** | Python: **>=3.10, <3.14**
 
 > Official website: https://pygpt.net | Documentation: https://pygpt.readthedocs.io
 > 
@@ -787,6 +787,8 @@ Includes built-in agents (Legacy):
 
 In the future, the list of built-in agents will be expanded.
 
+You can create your own types (workflows/patterns) using the built-in visual node-based editor found in the `Tools -> Agents Builder`.
+
 You can also create your own agent by creating a new provider that inherits from `pygpt_net.provider.agents.base`.
 
 **Tools and Plugins**  
@@ -824,7 +826,7 @@ It allows running agents for OpenAI models and models compatible with the OpenAI
 
 In this mode, you can use pre-configured Experts in Expert mode presets - they will be launched as agents (in the `openai_agents_experts` type, which allows launching one main agent and subordinate agents to which queries will be appropriately directed).
 
-**Agent types:**
+**Agent types (workflows/patterns):**
 
 - `Agent with experts` - uses attached experts as sub-agents
 - `Agent with experts + feedback` - uses attached experts as sub-agents + feedback agent in a loop
@@ -836,7 +838,7 @@ In this mode, you can use pre-configured Experts in Expert mode presets - they w
 - `B2B` - bot-to-bot communication, involving two bots interacting with each other while keeping a human in the loop.
 - `Supervisor + Worker` - one agent (supervisor) acts as a bridge between the user and the second agent (worker). The user provides a query to the supervisor, who then sends instructions to the worker until the task is completed by the worker.
 
-More types will be available in the future.
+You can create your own types (workflows/patterns) using the built-in visual node-based editor found in the `Tools -> Agents Builder`.
 
 There are also predefined presets added as examples:
 
@@ -2181,10 +2183,10 @@ To add a new element, right-click on the editor grid and select `Add` to insert
 
 **Types of Nodes:**
 
-- **Flow/Start**: The starting point for agents (user input).
-- **Flow/Agent**: A single agent with customizable default parameters, such as system instructions and tool usage. These settings can be overridden in the preset.
-- **Flow/Memory**: Shared memory between agents (shared Context).
-- **Flow/End**: The endpoint, returning control to the user.
+- **Start**: The starting point for agents (user input).
+- **Agent**: A single agent with customizable default parameters, such as system instructions and tool usage. These settings can be overridden in the preset.
+- **Memory**: Shared memory between agents (shared Context).
+- **End**: The endpoint, returning control to the user.
 
 Agents with connected shared memory share it among themselves. Agents without shared memory only receive the latest output from the previous agent.
 
@@ -2224,7 +2226,8 @@ Rules:
 - content must contain the user-facing answer (you may include structured data as JSON or Markdown inside content).
 - Do NOT add any commentary outside of the JSON. No leading or trailing text.
 - If using tools, still return the final JSON with tool results summarized in content.
-- Human-friendly route names: <friendly>
+- Human-friendly route names: <names>
+- Human-friendly route roles (optional): <roles>
 
 <here begins your system instruction>
 ```
@@ -2455,8 +2458,6 @@ Config -> Settings...
 
 - `Store dialog window positions`: Enable or disable dialogs positions store/restore, Default: True.
 
-- `Use theme colors in chat window`: Use color theme in chat window, Default: True.
-
 **Code syntax**
 
 - `Code syntax highlight`: Syntax highlight theme in code blocks. `WebEngine / Chromium` render mode only.
@@ -2523,8 +2524,6 @@ Config -> Settings...
 
 - `Open URLs in built-in browser`: Enable this option to open all URLs in the built-in browser (Chromium) instead of an external browser. Default: False.
 
-- `Convert lists to paragraphs`: If enabled, lists (ul, ol) will be converted to paragraphs (p), Default: True.
-
 - `Model used for auto-summary`: Model used for context auto-summary (generating titles in context list) (default: *gpt-4o-mini*). **Tip:** If you prefer to use local models, you should change the model here as well
 
 **Remote tools**
@@ -3724,6 +3723,20 @@ may consume additional tokens that are not displayed in the main window.
 
 ## Recent changes:
 
+**2.6.62 (2025-09-26)**
+
+- Enhanced agent workflow execution.
+- Improved preset list handling by adding a drop field indicator and fixing auto-scroll.
+- Added middle-mouse button panning to Painter.
+- Added an input character counter.
+
+**2.6.61 (2025-09-26)**
+
+- Enhanced the agents node editor, custom agent flow, and instruction following.
+- Added drag-and-drop and reordering functionality to the presets list.
+- Added statistics for response tokens, including time elapsed and tokens per second.
+- Improved UI/UX.
+
 **2.6.60 (2025-09-25)**
 
 - Added a new tool: Agents Builder - allowing visual design of agent workflows using nodes - available in Tools -> Agents Builder (beta).
@@ -3744,93 +3757,6 @@ may consume additional tokens that are not displayed in the main window.
 - Improved: The local web search plugin has been enhanced to retrieve multiple URLs at once.
 - Added: Use proxy switch in Settings.
 
-**2.6.56 (2025-09-22)**
-
-- Optimized: Memory usage and performance in streaming and rendering large contexts.
-- Added: Copy to clipboard functionality in user messages.
-- Added: Manual scroll in plain-text mode.
-
-**2.6.55 (2025-09-18)**
-
-- Fixed: Unnecessary context loading from the database.
-- Optimized: Token count in the input field.
-
-**2.6.54 (2025-09-18)**
-
-- Added: Remote tools (like web search) are now also available in the Chat with Files and Agents (LlamaIndex) modes.
-- Added: Two new plugins: Wolfram Alpha and OpenStreetMap.
-- Fixed: Enabled local file-like schemes in links/images in the markdown-it parser.
-
-**2.6.53 (2025-09-17)**
-
-- Added: An icon to enable/disable the web search remote tool in the icon bar, along with remote web search functionality in OpenRouter (#135).
-- Added: The ability to mute audio in real-time mode via the audio icon.
-
-**2.6.52 (2025-09-17)**
-
-- Added MCP plugin: Provides access to remote tools via the Model Context Protocol (MCP), including stdio, SSE, and Streamable HTTP transports, with per-server allow/deny filtering, Authorization header support, and a tools cache.
-- Fixed: tab tooltips reload on profile switch.
-
-**2.6.51 (2025-09-16)**
-
-- Fix: Automatically reloading calendar notes.
-- Fix: Context menu CSS background color for calendar items.
-
-**2.6.50 (2025-09-16)**
-
-- Optimized: Improved memory cleanup when switching profiles and unloading tabs.
-- Fix: Resolved missing PID data in text output.
-- Fix: Enhanced real-time parsing of execute tags.
-
-**2.6.49 (2025-09-16)**
-
-- Fixed: Occasional crashes when focusing on an output container unloaded from memory in the second column.
-
-**2.6.48 (2025-09-15)**
-
-- Added: auto-loading of next items to the list of contexts when scrolling to the end of the list.
-
-**2.6.47 (2025-09-15)**
-
-- Improved: Parsing of custom markup tags.
-- Optimized: Switching profiles.
-
-**2.6.46 (2025-09-15)**
-
-- Added: Global proxy settings for all API SDKs.
-- Fixed: xAI client configuration in Chat with Files.
-- Fixed: Top margin in streaming container.
-- Refactored: Debug workers.
-
-**2.6.45 (2025-09-13)**
-
-- Improved: Parsing of custom markup in the stream.
-- Improved: Message block parsing moved to JavaScript.
-
-**2.6.44 (2025-09-12)**
-
-- Added: Auto-collapse for large user input blocks.
-- Added: Configuration for syntax highlighting intervals.
-- Improved: Visibility of label icons.
-- Improved: Scrolling of code blocks.
-- Fixed: Parsing of quotes in custom markdown blocks.
-
-**2.6.43 (2025-09-12)**
-
-- Fixed: preset restoration when switching profiles.
-- Improved: faster application launch and exit.
-
-**2.6.42 (2025-09-11)**
-
-- Fixed: Save/load zoom factor in the chat window when switched via Ctrl + mouse wheel.
-- Fixed: Break the first line in code blocks.
-- Added: Configuration options for syntax highlight limits.
-- Updated: SVG icons.
-
-**2.6.41 (2025-09-11)**
-
-- Rendering engine optimizations: markdown parsing moved to JS, reduced CPU usage, added auto-memory clearing, and more.
-
 # Credits and links
 
 **Official website:** <https://pygpt.net>