llms-py 3.0.14__py3-none-any.whl → 3.0.16__py3-none-any.whl

llms/extensions/app/ui/threadStore.mjs

@@ -354,11 +354,11 @@ async function startNewThread({ title, model, tools, redirect }) {
 async function queueChat(ctxRequest, options = {}) {
     if (!ctxRequest.request) return ctx.createErrorResult({ message: 'No request provided' })
     if (!ctxRequest.thread) return ctx.createErrorResult({ message: 'No thread provided' })
-    if (!ctxRequest.request.metadata) {
-        ctxRequest.request.metadata = {}
-    }
+    ctxRequest = ctx.createChatContext(ctxRequest)
     ctx.chatRequestFilters.forEach(f => f(ctxRequest))
     const { thread, request } = ctxRequest
+    ctx.completeChatContext(ctxRequest)
+
     const api = await ctx.postJson(`/ext/app/threads/${thread.id}/chat`, {
         ...options,
         body: typeof request == 'string'
@@ -381,6 +381,12 @@ async function loadThreadDetails(id, opt = null) {
     return threadDetails.value[id]
 }
 
+function getCurrentThreadSystemPrompt() {
+    return currentThread.value?.systemPrompt
+        ?? currentThread.value?.messages?.find(m => m.role == 'system')?.content
+        ?? ''
+}
+
 // Export the store
 export function useThreadStore() {
     return {
@@ -391,6 +397,7 @@ export function useThreadStore() {
         groupedThreads,
 
         // Actions
+        getCurrentThreadSystemPrompt,
         query,
         createThread,
         updateThread,

llms/extensions/computer/README.md

@@ -0,0 +1,96 @@
+# Computer Use Tools
+
+This extension provides a set of tools that allow an Agent to interact with a computer environment in a way similar to a human user. It includes capabilities for screen interaction (mouse/keyboard), shell execution, and file editing. Based on [Anthropic's computer use tools](https://github.com/anthropics/anthropic-quickstarts/tree/main/computer-use-demo).
+
+## Available Tools
+
+### 1. Computer Tool (`computer`)
+Allows interaction with the screen, keyboard, and mouse.
+
+**Capabilities:**
+- **Mouse Interaction**: Move cursor, click (left, right, middle, double, triple), click & drag.
+- **Keyboard Interaction**: Type text, press specific keys or key combinations.
+- **Screen**: Take screenshots, get cursor position.
+- **Zooming**: Zoom into specific regions of the screen (Action: `zoom`).
+
+**Key Parameters:**
+- `action`: The action to perform (e.g., `mouse_move`, `left_click`, `type`, `screenshot`, `zoom`).
+- `coordinate`: `(x, y)` coordinates for mouse actions.
+- `text`: Text to type.
+- `key`: Key sequence to press (e.g., `Return`, `Control+c`).
+- `region`: `(x0, y0, x1, y1)` region for zooming.
+
+### 2. Bash Tool (`bash`)
+Provides a persistent shell session to execute command-line instructions.
+
+**Capabilities:**
+- **Execute Commands**: Run any bash command.
+- **Persistent Session**: State (like environment variables, working directory) is preserved between calls within the same session.
+- **Process Management**: Can restart the session if needed.
+- **Open Files/URLs**: Helper function `open` allows opening files or URLs using the system's default handler (`xdg-open`, `open`, or `start`).
+
+**Key Parameters:**
+- `command`: The bash command to execute.
+- `restart`: Boolean to restart the session.
+
+### 3. Edit Tool (`str_replace_editor`)
+A filesystem editor for viewing and modifying files.
+
+**Capabilities:**
+- **View**: Read file contents or list directories.
+- **Create**: Create new files with content.
+- **String Replace**: Replace unique strings in a file (robust for LLM editing).
+- **Insert**: Insert text at specific line numbers.
+- **Undo**: Undo the last edit to a file.
+
+**Key Parameters:**
+- `command`: The edit command (`view`, `create`, `str_replace`, `insert`, `undo_edit`).
+- `path`: Absolute path to the file or directory.
+- `file_text`: Content for file creation.
+- `old_str` / `new_str`: Strings for replacement.
+
+---
+
+## Capabilities & Workflows
+
+These tools are designed to work together to enable complex end-to-end tasks. An Agent can act as a developer, tester, or general user.
+
+### Example: "Build a Tetris web app in a tetris folder, open it then take a screenshot"
+
+To achieve this high-level task, the Agent would sequence the tools as follows:
+
+1.  **Create the Project Structure**
+    *   **Tool**: `bash`
+    *   **Command**: `mkdir -p tetris`
+    *   *Result*: Creates the folder.
+
+2.  **Create the Application Files**
+    *   **Tool**: `edit` (command: `create`)
+    *   **Path**: `/path/to/tetris/index.html`
+    *   **Content**: (HTML code for Tetris game)
+    *   *Result*: Writes the HTML file.
+
+3.  **Open the Application**
+    *   **Tool**: `bash` (via helper `open`) or `bash` directly.
+    *   **Command**: `xdg-open /path/to/tetris/index.html` (Linux) or just `python -m http.server` and open localhost.
+    *   *Result*: Opens the file in the default web browser.
+
+4.  **Wait & Verify**
+    *   **Tool**: `computer`
+    *   **Action**: `wait` or `screenshot` to see if it loaded.
+
+5.  **Take a Screenshot**
+    *   **Tool**: `computer`
+    *   **Action**: `screenshot`
+    *   *Result*: Captures the visual state of the running Tetris app for the user to see.
+
+### How it handles the "Build a Tetris..." request:
+When a user gives the command:
+> "Build a Tetris web app in a tetris folder, open it then take a screenshot"
+
+The Agent decomposes this into:
+1.  **"Build... in a tetris folder"** -> Uses `bash` to make the directory and `edit` to write the `index.html` / `style.css` / `script.js` files.
+2.  **"Open it"** -> Uses `bash` to run a server or open the file in a browser.
+3.  **"Take a screenshot"** -> Uses `computer` to verify the visual output.
+
+This combination allows the Agent to not just generate code, but **verify** it visually and interactively, closing the loop on development tasks.

llms/extensions/computer/__init__.py

@@ -0,0 +1,59 @@
+"""
+Anthropic's Computer Use Tools
+https://github.com/anthropics/claude-quickstarts/tree/main/computer-use-demo
+"""
+
+import os
+
+from .bash import open, run_bash
+from .computer import computer
+from .edit import edit
+from .filesystem import (
+    create_directory,
+    directory_tree,
+    edit_file,
+    filesystem_init,
+    get_file_info,
+    list_allowed_directories,
+    list_directory,
+    list_directory_with_sizes,
+    move_file,
+    read_media_file,
+    read_multiple_files,
+    read_text_file,
+    search_files,
+    write_file,
+)
+from .platform import get_display_num, get_screen_resolution
+
+width, height = get_screen_resolution()
+# set enviroment variables
+os.environ["WIDTH"] = str(width)
+os.environ["HEIGHT"] = str(height)
+os.environ["DISPLAY_NUM"] = str(get_display_num())
+
+
+def install(ctx):
+    filesystem_init(ctx)
+
+    ctx.register_tool(run_bash, group="computer")
+    ctx.register_tool(open, group="computer")
+    ctx.register_tool(edit, group="computer")
+    ctx.register_tool(computer, group="computer")
+
+    ctx.register_tool(read_text_file, group="filesystem")
+    ctx.register_tool(read_media_file, group="filesystem")
+    ctx.register_tool(read_multiple_files, group="filesystem")
+    ctx.register_tool(write_file, group="filesystem")
+    ctx.register_tool(edit_file, group="filesystem")
+    ctx.register_tool(create_directory, group="filesystem")
+    ctx.register_tool(list_directory, group="filesystem")
+    ctx.register_tool(list_directory_with_sizes, group="filesystem")
+    ctx.register_tool(directory_tree, group="filesystem")
+    ctx.register_tool(move_file, group="filesystem")
+    ctx.register_tool(search_files, group="filesystem")
+    ctx.register_tool(get_file_info, group="filesystem")
+    ctx.register_tool(list_allowed_directories, group="filesystem")
+
+
+__install__ = install

llms/extensions/{computer_use → computer}/bash.py

@@ -158,7 +158,7 @@ async def run_bash(
     if g_tool is None:
         g_tool = BashTool20241022()
 
-    result = await g_tool(command, restart)
+    result = await g_tool(command=command, restart=restart)
     if isinstance(result, Exception):
         raise result
     else:
@@ -182,4 +182,4 @@ async def open(target: Annotated[str, "URL or file path to open"]) -> list[dict[
     else:  # Linux and other Unix-like
         cmd = ["xdg-open", target]
 
-    return await run_bash(" ".join(cmd))
+    return await run_bash(command=" ".join(cmd))

llms/extensions/{computer_use → computer}/edit.py

@@ -1,6 +1,6 @@
 from collections import defaultdict
 from pathlib import Path
-from typing import Annotated, Any, Literal, get_args
+from typing import Annotated, Any, List, Literal, get_args
 
 from .base import BaseTool, CLIResult, ToolError, ToolResult
 from .run import maybe_truncate, run
@@ -272,10 +272,10 @@ async def edit(
     command: Command_20250124,
     path: Annotated[str, "The absolute path to the file or directory"],
     file_text: Annotated[str | None, "The content to write to the file (required for create)"] = None,
-    view_range: Annotated[list[int] | None, "The range of lines to view (e.g. [1, 10])"] = None,
+    view_range: Annotated[List[int], "The range of lines to view (e.g. [1, 10])"] = None,
     old_str: Annotated[str | None, "The string to replace (required for str_replace)"] = None,
     new_str: Annotated[str | None, "The replacement string (required for str_replace and insert)"] = None,
-    insert_line: Annotated[int | None, "The line number after which to insert (required for insert)"] = None,
+    insert_line: Annotated[int, "The line number after which to insert (required for insert)"] = None,
 ) -> list[dict[str, Any]]:
     """
     An filesystem editor tool that allows the agent to view, create, and edit files.
@@ -284,18 +284,14 @@ async def edit(
     if g_tool is None:
         g_tool = EditTool20250124()
 
-    view_range_values = None
-    if view_range:
-        view_range_values = [int(x) for x in view_range]
-
     result = await g_tool(
-        command,
-        path if path else None,
-        file_text if file_text else None,
-        view_range_values,
-        old_str if old_str else None,
-        new_str if new_str else None,
-        int(insert_line) if insert_line else None,
+        command=command,
+        path=path if path else None,
+        file_text=file_text if file_text else None,
+        view_range=view_range,
+        old_str=old_str if old_str else None,
+        new_str=new_str if new_str else None,
+        insert_line=int(insert_line) if insert_line else None,
     )
     if isinstance(result, Exception):
         raise result