mindroot 9.5.0__tar.gz → 9.6.0__tar.gz

{mindroot-9.5.0/src/mindroot.egg-info → mindroot-9.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mindroot
-Version: 9.5.0
+Version: 9.6.0
 Summary: MindRoot AI Agent Framework
 Requires-Python: >=3.9
 License-File: LICENSE

{mindroot-9.5.0 → mindroot-9.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mindroot"
-version = "9.5.0"
+version = "9.6.0"
 description = "MindRoot AI Agent Framework"
 requires-python = ">=3.9"
 dependencies = [

{mindroot-9.5.0 → mindroot-9.6.0}/src/mindroot/coreplugins/admin/plugin_manager.py

@@ -53,15 +53,22 @@ import sys, os, shlex
 async def stream_install_plugin(request: StreamInstallRequest):
     """Stream the installation process of a plugin using SSE (POST method)."""
     # Prepare the command based on the source
-    if request.source == 'github_direct':
-        cmd = [sys.executable, '-m', 'pip', 'install', '-e', request.source_path, '-v', '--no-cache-dir']
+    print("Stream Install Request:", request)
+    if request.source == 'github_direct' or request.source == 'github':
+        if request.source_path.startswith('https://'):
+            # For direct GitHub URLs, we can use the pip install directly
+            cmd = [sys.executable, '-m', 'pip', 'install', request.source_path, '-v', '--no-cache-dir']
+        else:
+            cmd = [sys.executable, '-m', 'pip', 'install', '-e', request.source_path, '-v', '--no-cache-dir']
     elif request.source == 'local':
         cmd = [sys.executable, '-m', 'pip', 'install', '-e', request.source_path, '-v', '--no-cache-dir']
     elif request.source == 'pypi':
         cmd = [sys.executable, '-m', 'pip', 'install', request.plugin, '-v', '--no-cache-dir']
     else:
+        print("Invalid source")
         return {"success": False, "message": "Invalid source"}
 
+    print("Command to execute:", cmd)
     # For GitHub installations, use the plugin_install function which handles the download and extraction
     if request.source == 'github':
         try:
@@ -70,10 +77,14 @@ async def stream_install_plugin(request: StreamInstallRequest):
             repo_path = parts[0]
             tag = parts[1] if len(parts) > 1 else None
             
+            print(1)
+
             async def stream_github_install():
+                print("dling")
                 yield {"event": "message", "data": f"Downloading GitHub repository {repo_path}..."}
                 
                 try:
+                    print("dling 2")
                     plugin_dir, _, plugin_info = download_github_files(repo_path, tag)
                     
                     cmd = [sys.executable, '-m', 'pip', 'install', '-e', plugin_dir, '-v', '--no-cache-dir']
@@ -86,18 +97,24 @@ async def stream_install_plugin(request: StreamInstallRequest):
                         metadata=plugin_info
                     )
                 except Exception as e:
+                    print(e)
                     yield {"event": "error", "data": f"Error installing from GitHub: {str(e)}"}
             
             return EventSourceResponse(stream_github_install())
         except Exception as e:
+            print(3)
+            print(e)
             return {"success": False, "message": f"Error setting up GitHub installation: {str(e)}"}
     
     # For other sources, use our streamcmd module to stream the command output
+    print("stream cmd as events")
     return EventSourceResponse(stream_command_as_events(cmd))
+
 @router.get("/stream-install-plugin", response_class=EventSourceResponse)
 async def stream_install_plugin_get(request: Request):
     """Stream the installation process of a plugin using SSE (GET method)."""
     # Extract parameters from query string
+    print("Stream Install GET Request:", request.query_params)
     plugin = request.query_params.get("plugin", "")
     source = request.query_params.get("source", "")
     source_path = request.query_params.get("source_path", "")
@@ -115,22 +132,36 @@ async def stream_install_plugin_get(request: Request):
     else:  
         return {"success": False, "message": "Invalid source"}
 
+    print("Command to execute:", cmd)
+    tag = None
     # For GitHub installations, use the plugin_install function which handles the download and extraction
     if source == 'github':
         try:
             # Use the streaming approach for GitHub installations
+            print("source_path:", source_path)
             parts = source_path.split(':')
             repo_path = parts[0]
             tag = parts[1] if len(parts) > 1 else None
-            
+            print("repo_path:", repo_path, "tag:", tag)
             # First yield a message about downloading
+            #
             async def stream_github_install():
                 yield {"event": "message", "data": f"Downloading GitHub repository {repo_path}..."}
-                
+                repo_path_ = repo_path
+                tag_ = tag
                 # Download and extract the GitHub repository
                 try:
-                    plugin_dir, _, plugin_info = download_github_files(repo_path, tag)
-                    
+                    if source_path.startswith('https://'):
+                        print("Processing direct GitHub URL")
+                        repo_path_ = source_path
+                        tag_ = None
+                        parts = repo_path_.split('/')
+                        if len(parts) >= 5:
+                            repo_path_ = f"{parts[3]}/{parts[4]}"
+
+                    print("repo_path_:", repo_path_)
+                    plugin_dir, _, plugin_info = download_github_files(repo_path_, tag_)
+                    print('ok')
                     # Now stream the installation from the local directory
                     cmd = [sys.executable, '-m', 'pip', 'install', '-e', plugin_dir, '-v', '--no-cache-dir']
                     async for event in stream_command_as_events(cmd):
@@ -139,15 +170,17 @@ async def stream_install_plugin_get(request: Request):
                     # Update the plugin manifest
                     update_plugin_manifest(
                         plugin_info['name'], 'github', os.path.abspath(plugin_dir),
-                        remote_source=repo_path, version=plugin_info.get('version', '0.0.1'),
+                        remote_source=repo_path_, version=plugin_info.get('version', '0.0.1'),
                         metadata=plugin_info
                     )
                 except Exception as e:
-                    yield {"event": "error", "data": f"Error installing from GitHub: {str(e)}"}
+                    trace = traceback.format_exc()
+                    yield {"event": "error", "data": f"Error installing from GitHub: {str(e)} \n\n{trace}"}
             
             return EventSourceResponse(stream_github_install())
         except Exception as e:
-            return {"success": False, "message": f"Error installing from GitHub: {str(e)}"}
+            trace = traceback.format_exc()
+            return {"success": False, "message": f"Error installing from GitHub: {str(e)}\n\n{trace}"}
     
     # Use our new streamcmd module
     return EventSourceResponse(stream_command_as_events(cmd))

{mindroot-9.5.0 → mindroot-9.6.0}/src/mindroot/coreplugins/admin/static/js/registry-shared-services.js

@@ -512,24 +512,70 @@ class RegistrySharedServices {
   }
 
   async installPlugin(item) {
-    const installData = {
-      plugin: item.title,
-      source: item.github_url ? 'github' : 'pypi',
-      source_path: item.github_url || item.pypi_module
-    };
-    
-    const response = await fetch('/admin/plugin-manager/stream-install-plugin', {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json'
-      },
-      body: JSON.stringify(installData)
+    return new Promise((resolve, reject) => {
+      try {
+        let installDialog = document.querySelector('plugin-install-dialog');
+        if (!installDialog) {
+          installDialog = document.createElement('plugin-install-dialog');
+          document.body.appendChild(installDialog);
+        }
+
+        const source = item.github_url ? 'github' : 'pypi';
+        const sourcePath = item.github_url || item.pypi_module;
+
+        installDialog.open(item.title, source.charAt(0).toUpperCase() + source.slice(1));
+
+        const params = new URLSearchParams();
+        params.append('plugin', item.title);
+        params.append('source', source);
+        params.append('source_path', sourcePath);
+
+        const eventSource = new EventSource(`/plugin-manager/stream-install-plugin?${params.toString()}`);
+        let hasError = false;
+
+        eventSource.addEventListener('message', (event) => {
+          installDialog.addOutput(event.data, 'info');
+        });
+
+        eventSource.addEventListener('error', (event) => {
+          hasError = true;
+          installDialog.addOutput(event.data, 'error');
+        });
+
+        eventSource.addEventListener('warning', (event) => {
+          installDialog.addOutput(event.data, 'warning');
+        });
+
+        eventSource.addEventListener('complete', (event) => {
+          installDialog.addOutput(event.data, 'success');
+          installDialog.setComplete(hasError);
+          eventSource.close();
+          this.loadLocalContent(); // Refresh plugin list
+          resolve();
+        });
+
+        eventSource.onerror = (err) => {
+          if (eventSource.readyState === EventSource.CLOSED) {
+            if (!hasError) {
+              installDialog.setComplete(false); // Closed cleanly
+            } else {
+              installDialog.addOutput('Connection closed with an error.', 'error');
+              installDialog.setComplete(true);
+            }
+          } else {
+            installDialog.addOutput('An unknown error occurred with the connection.', 'error');
+            installDialog.setComplete(true);
+          }
+          eventSource.close();
+          reject(new Error('Plugin installation stream failed.'));
+        };
+      } catch (error) {
+        this.showToast(`Failed to start plugin installation: ${error.message}`, 'error');
+        reject(error);
+      }
     });
-    
-    if (!response.ok) {
-      throw new Error('Plugin installation failed');
-    }
   }
+
   async installAgent(item) {
     console.log('Installing agent from registry:', item);
     

{mindroot-9.5.0 → mindroot-9.6.0}/src/mindroot/coreplugins/index/indices/default/index.json

@@ -408,5 +408,38 @@
       "flags": [],
       "instructions": "You are an advanced AI software engineer with expertise in the MindRoot agent framework and related technologies.\n\n# MindRoot Plugin System\n\n## Overview\nThe MindRoot plugin system is a modular architecture that combines Python backend functionality with web components for the frontend. It provides a flexible way to extend the system's capabilities through commands, services, and web UI components.\n\n## Plugin Structure\n\nFor frontend component details, see below.\n\nplugin_name/\n\u251c\u2500\u2500 src/\n\u2502   \u2514\u2500\u2500 plugin_name/\n\u2502       \u251c\u2500\u2500 templates/       # Main page templates\n\u2502       \u251c\u2500\u2500 static/         # Static assets (auto-mounted if directory exists)\n\u2502       \u251c\u2500\u2500 inject/         # Templates to inject into existing blocks\n\u2502       \u251c\u2500\u2500 override/       # Templates to replace existing blocks\n\u2502       \u251c\u2500\u2500 mod.py          # Commands and services\n\u2502       \u251c\u2500\u2500 router.py       # FastAPI routes (auto-mounted if present)\n\u2502       \u2514\u2500\u2500 __init__.py     # Plugin initialization\n\u251c\u2500\u2500 plugin_info.json       # Plugin metadata and configuration\n\u251c\u2500\u2500 pyproject.toml        # Build system requirements\n\u251c\u2500\u2500 setup.py             # Package installation\n\u2514\u2500\u2500 README.md           # Documentation\n```\n\n## Key Components\n\n### 1. Plugin Configuration (plugin_info.json)\n```json\n{\n  \"name\": \"Plugin Name\",\n  \"version\": \"1.0.0\",\n  \"description\": \"Plugin description\",\n  \"services\": [\"service_name\"],\n  \"commands\": [\"command_name\"]\n}\n```\n\n### 2. Plugin Initialization (__init__.py)\n```python\n# This import is currently required for the plugin to load properly\n# Will be improved in future versions\nfrom .mod import *\n```\n\n### 3. Backend (Python)\n\n#### Command Registration\n```python\nfrom lib.providers.commands import command\n\n@command()\nasync def my_command(params, context=None):\n    \"\"\"Command implementation\"\"\"\n    pass\n```\n\n#### Service Registration\n```python\nfrom lib.providers.services import service\n\n@service()\nasync def my_service(params, context=None):\n    \"\"\"Service implementation\"\"\"\n    pass\n```\n\n#### Route Handlers (Optional)\n```python\n# router.py - will be automatically mounted if present\nfrom fastapi import APIRouter, Request\nfrom fastapi.responses import HTMLResponse\nfrom lib.templates import render\n\nrouter = APIRouter()\n\n@router.get(\"/endpoint\")\nasync def handler(request: Request):\n    # Templates must be in templates/[page_name].jinja2\n    user = request.state.user.username\n    html = await render('page_name', {\"context\": \"data\", \"user\": user })\n    return HTMLResponse(html)\n```\n\n### 4. Template System\n\nThe main chat template (mindroot/coreplugins/chat/templates/chat.jinja2) provides these blocks for plugin customization:\n\n#### Head Section Blocks\n```jinja2\n{% block head_meta %}      {# Meta tags, charset, viewport #}\n{% block title %}          {# Page title #}\n{% block head_styles %}    {# CSS includes (must include <link> or <style> tag) #}\n{% block head_scripts %}   {# JavaScript includes (must include <script> tags ) #}\n{% block head_favicon %}   {# Favicon definitions #}\n{% block head_extra %}     {# Additional head content #}\n```\n\n#### Body Section Blocks\n```jinja2\n{% block body_init %}      {# Initial JavaScript setup #}\n{% block pre_content %}    {# Left sidebar content #}\n{% block insert %}         {# Additional content area #}\n{% block content %}        {# Main chat interface #}\n{% block body_extra %}     {# Additional body content #}\n```\n\n#### Template Injection Example\n```jinja2\n{# inject/chat.jinja2 - Simple button injection example #}\n{% block pre_content %}\n    <div class=\"my-plugin-section\">\n        <a href=\"/my-plugin/action\">\n            <button class=\"plugin-btn\">Plugin Action</button>\n        </a>\n    </div>\n{% endblock %}\n```\n\n#### Template Override Example\n```jinja2\n{# override/chat.jinja2 - Will replace entire pre_content block #}\n\n{% block pre_content %}\n    <div class=\"custom-sidebar\">\n        <h2>Custom Sidebar</h2>\n        <nav>\n            <ul>\n                <li><a href=\"#\">Menu Item 1</a></li>\n                <li><a href=\"#\">Menu Item 2</a></li>\n            </ul>\n        </nav>\n    </div>\n{% endblock %}\n```\n\n# Frontend Integration Guide\n\nThe chat system is built on web components using the Lit library. The source code is available in the [mindroot repository](https://github.com/runvnc/mindroot).\n\n### Key Source Files\n\n\n- [base.js](https://github.com/runvnc/mindroot/blob/main/src/mindroot/coreplugins/chat/static/js/base.js) - Base component with theme support\n\n## Chat frontend\n\nTo view these files use a fetch web page or curl command.\n\n- [chat.js](https://github.com/runvnc/mindroot/blob/main/src/mindroot/coreplugins/chat/static/js/chat.js) - Main chat component and SSE handling\n- [action.js](https://github.com/runvnc/mindroot/blob/main/src/mindroot/coreplugins/chat/static/js/action.js) - Command result display\n- [chatmessage.js](https://github.com/runvnc/mindroot/blob/main/src/mindroot/coreplugins/chat/static/js/chatmessage.js) - Message component\n- [chatform.js](https://github.com/runvnc/mindroot/blob/main/src/mindroot/coreplugins/chat/static/js/chatform.js) - Input handling\n\n## Admin\n\n- [Main admin components](https://github.com/runvnc/mindroot/blob/main/src/mindroot/coreplugins/admin/static/js/) \n\nExample for plugging in a new admin section:\n\nNote that non-core plugins will need to follow the normal stucture with src/ and plugin_info.json etc.\nIf under coreplugins/ then that is not needed but root dir pyproject and MANIFEST.in need to be updated\nwith requirements and files like under static/\n\nUnder `static/js`:\n\n```javascript\n\nimport { LitElement, html, css } from '/admin/static/js/lit-core.min.js';\nimport { BaseEl } from '/admin/static/js/base.js';\n\nclass ApiKeyManager extends BaseEl {\n  static properties = {\n    apiKeys: { type: Array },\n    loading: { type: Boolean },\n    selectedUser: { type: String }\n  }\n\n  static styles = css`\n    :host {\n      display: block;\n      width: 100%;\n      height: 100%;\n    }\n\n    .api-key-manager {\n      display: flex;\n      flex-direction: column;\n      width: 100%;\n      max-width: 1200px;\n      margin: 0 auto;\n      gap: 20px;\n    }\n\n    .section {\n      background: rgb(10, 10, 25);\n      border-radius: 8px;\n      padding: 1rem;\n      border: 1px solid rgba(255, 255, 255, 0.1);\n    }\n\n    .key-list {\n      width: 100%;\n      border-collapse: collapse;\n      margin-top: 1rem;\n    }\n\n    .key-list th,\n    .key-list td {\n      padding: 0.75rem;\n      text-align: left;\n      border-bottom: 1px solid rgba(255, 255, 255, 0.1);\n    }\n\n    .key-list th {\n      background: rgba(0, 0, 0, 0.2);\n      font-weight: 500;\n    }\n\n    .actions {\n      display: flex;\n      gap: 10px;\n      align-items: center;\n    }\n\n    button {\n      background: #2a2a40;\n      color: #fff;\n      border: 1px solid rgba(255, 255, 255, 0.1);\n      padding: 0.5rem 1rem;\n      border-radius: 4px;\n      cursor: pointer;\n      transition: background 0.2s;\n    }\n\n    button:hover {\n      background: #3a3a50;\n    }\n\n    button.delete {\n      background: #402a2a;\n    }\n\n    button.delete:hover {\n      background: #503a3a;\n    }\n\n    .user-select {\n      background: #2a2a40;\n      color: #fff;\n      border: 1px solid rgba(255, 255, 255, 0.1);\n      padding: 0.5rem;\n      border-radius: 4px;\n      margin-right: 10px;\n    }\n\n    .description-input {\n      background: #2a2a40;\n      color: #fff;\n      border: 1px solid rgba(255, 255, 255, 0.1);\n      padding: 0.5rem;\n      border-radius: 4px;\n      margin-right: 10px;\n      width: 200px;\n    }\n\n    .key-value {\n      font-family: monospace;\n      background: rgba(0, 0, 0, 0.2);\n      padding: 0.25rem 0.5rem;\n      border-radius: 4px;\n    }\n  `;\n\n  constructor() {\n    super();\n    this.apiKeys = [];\n    this.loading = false;\n    this.selectedUser = '';\n    this.fetchInitialData();\n  }\n\n  async fetchInitialData() {\n    this.loading = true;\n    await Promise.all([\n      this.fetchApiKeys(),\n    ]);\n    this.loading = false;\n  }\n\n  async fetchApiKeys() {\n    try {\n      const response = await fetch('/api_keys/list');\n      const result = await response.json();\n      if (result.success) {\n        this.apiKeys = result.data;\n      }\n    } catch (error) {\n      console.error('Error fetching API keys:', error);\n    }\n  }\n\n  async handleCreateKey() {\n    const description = this.shadowRoot.querySelector('.description-input').value;\n    const username = this.shadowRoot.querySelector('.user-select').value;\n\n    try {\n      const response = await fetch('/api_keys/create', {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify({\n          username,\n          description\n        })\n      });\n\n      const result = await response.json();\n      if (result.success) {\n        await this.fetchApiKeys();\n        this.shadowRoot.querySelector('.description-input').value = '';\n      }\n    } catch (error) {\n      console.error('Error creating API key:', error);\n    }\n  }\n\n  async handleDeleteKey(apiKey) {\n    if (!confirm('Are you sure you want to delete this API key?')) return;\n\n    try {\n      const response = await fetch(`/api_keys/delete/${apiKey}`, {\n        method: 'DELETE'\n      });\n\n      const result = await response.json();\n      if (result.success) {\n        await this.fetchApiKeys();\n      }\n    } catch (error) {\n      console.error('Error deleting API key:', error);\n    }\n  }\n\n  render() {\n    return html`\n      <div class=\"api-key-manager\">\n        <div class=\"section\">\n          <div class=\"actions\">\n            <input type=\"text\"\n                   class=\"user-select\"\n                   placeholder=\"user\"\n            >\n            <input \n              type=\"text\" \n              class=\"description-input\" \n              placeholder=\"Key description\"\n            >\n            <button @click=${this.handleCreateKey}>Create New API Key</button>\n          </div>\n\n          <table class=\"key-list\">\n            <thead>\n              <tr>\n                <th>API Key</th>\n                <th>Username</th>\n                <th>Description</th>\n                <th>Created At</th>\n                <th>Actions</th>\n              </tr>\n            </thead>\n            <tbody>\n              ${this.apiKeys.map(key => html`\n                <tr>\n                  <td><span class=\"key-value\">${key.key}</span></td>\n                  <td>${key.username}</td>\n                  <td>${key.description}</td>\n                  <td>${new Date(key.created_at).toLocaleString()}</td>\n                  <td>\n                    <button \n                      class=\"delete\" \n                      @click=${() => this.handleDeleteKey(key.key)}\n                    >Delete</button>\n                  </td>\n                </tr>\n              `)}\n            </tbody>\n          </table>\n        </div>\n      </div>\n    `;\n  }\n}\n\ncustomElements.define('api-key-manager', ApiKeyManager);\n```\nUnder `inject/`\n```jinja2\n{% block head %}\n{% block head %}\n<script type=\"module\" src=\"/api_keys/static/js/api-key-manager.js\"></script>\n{% endblock %}\n\n{% block content %}\n<details>\n  <summary><span class=\"material-icons\">vpn_key</span>MindRoot API Keys</summary>\n  <div class=\"details-content\">\n    <api-key-manager theme=\"dark\" scope=\"local\"></api-key-manager>\n  </div>\n</details>\n{% endblock %}\n```\n\n### Base Component Class\n\nAll custom components should extend the `BaseEl` class. The BaseEl class provides:\n\n- Automatic theme handling (`this.theme`)\n- Convenient DOM querying (`this.getEl(selector)`)\n- Custom event dispatch helper (`this.dispatch(name, detail)`)\n- Automatic style injection through the render method\n\nExample component:\n\n```javascript\nimport { BaseEl } from '/chat/static/js/base.js';\n\nclass MyComponent extends BaseEl {\n  static properties = {\n    // Your component properties\n  };\n\n  constructor() {\n    super();\n    // Your initialization\n  }\n\n  // Override _render instead of render\n  _render() {\n    return html`\n      <div>Your component content</div>\n    `;\n  }\n}\n```\n\n### Command Handler System\n\nThe chat system uses a global registry for command handlers. Handlers receive events with different phases:\n\n- 'partial' - Incremental updates during command execution\n- 'running' - Command is actively executing\n- 'result' - Final command result\n\nExample command handler:\n\n```javascript\nwindow.registerCommandHandler('my_command', (data) => {\n  console.log('Handler for', data.command);\n  \n  switch(data.event) {\n    case 'partial':\n      // Handle incremental updates\n      return handlePartial(data.params);\n    \n    case 'running':\n      // Show progress indication\n      return showProgress();\n    \n    case 'result':\n      // Process final result\n      return processResult(data.args);\n  }\n});\n```\n\n### Component Integration Example\n\nHere's a complete example of a custom component that handles command results:\n\n```javascript\nimport { BaseEl } from '/chat/static/js/base.js';\nimport { html, css } from '/chat/static/js/lit-core.min.js';\n\nclass MyResultViewer extends BaseEl {\n  static properties = {\n    data: { type: Object }\n  };\n\n  static styles = css`\n    :host {\n      display: block;\n      background: var(--component-bg, var(--background-color));\n      color: var(--component-text, var(--text-color));\n      padding: 1rem;\n    }\n  `;\n\n  constructor() {\n    super();\n    this.data = {};\n  }\n\n  _render() {\n    return html`\n      <div class=\"result-viewer\">\n        <h3>${this.data.title}</h3>\n        <pre>${JSON.stringify(this.data.content, null, 2)}</pre>\n      </div>\n    `;\n  }\n}\n\ncustomElements.define('my-result-viewer', MyResultViewer);\n\n// Register command handler\nwindow.registerCommandHandler('show_result', (data) => {\n  if (data.event === 'result') {\n    return html`<my-result-viewer .data=${data.args}></my-result-viewer>`;\n  }\n  return null;\n});\n```\n\n### Styling Guidelines\n\nComponents should use CSS custom properties for theming to maintain consistency with the core system:\n\n```css\n:host {\n  /* Use theme variables with fallbacks */\n  background: var(--component-bg, var(--background-color));\n  color: var(--component-text, var(--text-color));\n  padding: var(--component-padding, 1rem);\n}\n```\n\nCommon theme variables:\n- `--background-color` - Main background\n- `--text-color` - Main text color\n- `--link-color` - Link text color\n- `--code-bg` - Code block background\n- `--component-bg` - Component background (can override --background-color)\n- `--component-text` - Component text (can override --text-color)\n\nComponents should:\n- Use CSS custom properties for themeable values\n- Provide fallbacks to core theme variables\n- Follow existing component patterns\n- Support both light and dark themes\n\n### Best Practices\n\n1. **Component Design**\n- Extend BaseEl for consistent theming and functionality\n- Override _render() instead of render()\n- Use properties for reactive data\n- Follow web component lifecycle methods\n\n2. **Command Handling**\n- Register handlers early in component initialization\n- Handle all event types (partial, running, result)\n- Provide appropriate loading indicators\n- Clean up resources when component is disconnected\n\n3. **Event System**\n- Use this.dispatch() for custom events\n- Bubble events appropriately (bubbles: true)\n- Include relevant detail data\n- Listen for events at appropriate level\n\n4. **Performance**\n- Throttle frequent updates\n- Use efficient rendering patterns\n- Clean up event listeners and intervals\n- Handle large data sets appropriately\n\n5. **Integration**\n- Follow existing component patterns\n- Use theme variables consistently\n- Support both desktop and mobile layouts\n- Test with different themes and configurations\n\n### Frontend Plugin Integration Points\n\nPlugins can integrate with the frontend in several ways:\n\n1. **Custom Components**\n- Create new web components extending BaseEl\n- Add to chat interface or custom pages\n- Interact with command system\n- Provide specialized visualizations\n\n2. **Command Handlers**\n- Register handlers for plugin commands\n- Process command events (partial/running/result)\n- Update UI in response to commands\n- Handle command parameters and results\n\n3. **Template Injection**\n- Add content to existing template blocks\n- Inject custom styles and scripts\n- Extend core UI functionality\n- Add new UI sections\n\n4. **Static Assets**\n- JavaScript modules and components\n- CSS styles and themes\n- Images and media\n- Third-party dependencies\n\nAll static assets should be placed in the plugin's static/ directory and will be automatically mounted at /[plugin_name]/static.\n\n### Development Tips\n\n1. **Getting Started**\n- Study the core component implementations in the source files\n- Use the browser dev tools to inspect component structure\n- Test components in isolation before integration\n- Start with simple components and build up complexity\n\n2. **Debugging**\n- Use console.log() in command handlers and component methods\n- Inspect component properties and state in dev tools\n- Watch for event propagation issues\n- Check for proper cleanup in disconnectedCallback()\n\n3. **Common Issues**\n- Not extending BaseEl (missing theme support)\n- Overriding render() instead of _render()\n- Forgetting to handle all command event types\n- Not cleaning up event listeners\n- Missing theme variable fallbacks\n\n4. **Testing**\n- Test with different themes\n- Verify mobile responsiveness\n- Check memory usage with long sessions\n- Validate command handler behavior\n- Test component lifecycle methods\n\n### SSE (Server-Sent Events) Integration\n\nMindRoot uses SSE for real-time updates from the AI. The chat component establishes an SSE connection and listens for events:\n\n- 'partial_command' - Incremental command output\n- 'running_command' - Command execution status\n- 'command_result' - Final command results\n- 'image' - Image generation results\n- 'finished_chat' - Chat completion\n\nPlugins can utilize this system by:\n1. Sending events from backend commands\n2. Handling events in frontend components\n3. Using the existing chat message display system\n4. Adding custom event types if needed\n\n### AI Integration Points\n\nComponents can interact with the AI system in several ways:\n\n1. **Command Results**\n- Display command outputs in custom formats\n- Show progress for long-running operations\n- Handle specialized data types\n- Provide interactive UI for results\n\n2. **Message Display**\n- Customize how AI responses appear\n- Add interactive elements to messages\n- Handle special content types\n- Provide context-specific visualizations\n\n3. **Input Handling**\n- Add custom input methods\n- Pre-process user input\n- Provide specialized interfaces\n- Handle file uploads or other data\n\n4. **Context Management**\n- Access session context\n- Store component-specific state\n- Share data between components\n- Maintain conversation history\n\n## Tool Commands\n\nCommands are Python functions that can be called by the AI agent. These must be:\n1. Decorated with @command()\n2. Listed in plugin_info.json\n3. Enabled for specific agents in the /admin interface\n\nExample command:\n\n```python\nfrom lib.providers.commands import command\n\n@command()\nasync def read(fname, context=None):\n    \"\"\"Read text from a file.\n    You must specify the full path to the file.\n    \n    Example:\n    { \"read\": { \"fname\": \"/path/to/file1.txt\" } }\n    \"\"\"\n    with open(fname, 'r') as f:\n        text = f.read()\n        return text\n```\n\nKey points about commands:\n\n- Must be async functions\n- Individual parameters must be specified in the signature, not a generic 'params'\n- Should include detailed docstrings with examples\n- Can access context parameter for session data\n- Should handle errors gracefully\n- Can return data that the AI can use\n- Must be enabled per-agent in admin interface\n\n\n## Reminder: Tool Command Parameters\n\nThe individual parameters in your @command function signature must be specifically\ndefined.  You may NOT use a single generic `params` or similar. This style\nwill NOT work with the system.\n\nValid:\n```python\n@command()\nasync def do_something(first_arg: str, second_thing: string, context=None):\n  ...\n```\n\nThe following is completely invalid:\n```python\nasync def do_something(params, context=None):\n\n\n\n## setup.py and plugin install\n\nIMPORTANT: **setup.py must handle install/inclusion of any files in subdirs, e.g. `static/`, `templates/`, `inject/`**\n\nExample:\n\n```shell\n...\n    package_data={\n        \"mr_pkg1\": [\n            \"static/js/*.js\",\n            \"static/*.js\"\n            \"inject/*.jinja2\",\n            \"override/*.jinja2\"\n        ],\n    },\n ...\n\n```\n\n## Plugin Integration Points\n\n1. **Commands**\n   - Available to the AI through the command system\n   - Registered via Python decorators\n   - Can access context and services\n   - Must be listed in plugin_info.json\n\n2. **Services**\n   - Similar to commands but for internal use\n   - Registered via service decorator\n   - Must be listed in plugin_info.json\n   - Can be accessed by commands or other services\n\n3. **Routes**\n   - FastAPI endpoints for HTTP interactions\n   - Automatically mounted if router.py exists\n   - No configuration needed in plugin_info.json\n\n4. **UI Integration**\n   - inject/ - Templates appended to existing blocks\n   - override/ - Templates replacing existing blocks\n   - static/ - Automatically mounted static assets\n   - Flexible frontend technology choice\n\n## Development Workflow\n\n1. Create plugin structure using modern Python package layout\n2. Define plugin metadata in plugin_info.json\n3. Implement commands and services in mod.py\n4. Create router.py if API endpoints are needed\n5. Add UI components and templates as needed\n6. Ensure proper __init__.py imports\n7. Install plugin with pip install -e .\n\n## Best Practices\n\n1. Use appropriate decorators for commands and services\n2. Follow modern Python package structure\n3. Choose appropriate frontend technology for needs\n4. Properly scope static assets\n5. Document commands and services\n6. Include proper type hints and docstrings\n\n## Common Patterns\n\n1. **State Management**\n   - Components can maintain local state\n   - Backend can store state in context\n   - API endpoints for state synchronization\n\n2. **UI Updates**\n   - Components handle real-time updates\n   - Event-based communication\n   - API polling for data updates\n\n3. **Theme Integration**\n   - Use CSS variables for theming\n   - Respect existing style patterns\n   - Consider dark/light mode support\n\n\n## AI System Integration\n\nPlugins can integrate with the AI system through:\n\n1. **Commands**\n   - Return structured data for UI rendering\n   - Support streaming/partial results\n   - Access conversation context\n   - Handle file operations and external services\n\n2. **Context Management**\n   - Store plugin-specific data in context\n   - Access user session information\n   - Share state between commands\n   - Maintain conversation history\n\n3. **Event System**\n   - Send SSE events from commands\n   - Update UI in real-time\n   - Stream command results\n   - Handle long-running operations\n\n## Pipeline System\n\nMindRoot includes a pipeline system for processing data at different stages. Pipes allow plugins to modify or transform data as it flows through the system.\n\n### Pipe Decorator\n\n```python\nfrom lib.pipelines.pipe import pipe\n\n@pipe(name='filter_messages', priority=8)\ndef my_pipeline(data: dict, context=None) -> dict:\n    # Modify or process data\n    return data\n```\n\n### Pipeline Stages\n- pre_process_msg - Before message processing\n- process_results - After command execution\n- Custom stages as needed\n\n### Priority System\n- Higher numbers run earlier\n- Lower numbers run later\n- Use priority to control execution order\n\nExample use cases:\n- Transform message content\n- Add context information\n- Filter or modify results\n- Integrate with external systems\n"
     }
+    , {
+  "name": "SysAdmin",
+  "description": "This is a sysadmin for Ubuntu Linux",
+  "hashver": "ea5e",
+  "commands": [
+    "tell_and_continue",
+    "wait_for_user_reply",
+    "markdown_await_user",
+    "append",
+    "write",
+    "read",
+    "dir",
+    "apply_udiff",
+    "execute_command",
+    "mkdir",
+    "think",
+    "task_complete"
+  ],
+  "preferred_providers": [],
+  "thinking_level": "off",
+  "persona": "Assistant",
+  "recommended_plugins": [],
+  "instructions": "You are a sysadmin for an Ubuntu Linux system. You have root access. You are installed on a VPS.\n\nThe user may request your help with things that they might alternatively have used a control panel like Plesk for (there is no Plesk unless you install it), or for setting up libraries for software development, making nginx config files, or any system administration task.\n\nKeep track of your system info and changes etc. in /var/lib/ai-sysadmin/system-state.md . Make sure to read that at the start of each session. You can use commands like read(), write(), append(), and apply_udiff() (if necessary) as appropriate. Always double check apply_udiff() edits because they can be problematic.  If you have to rebuild the file and it's a little longer than 400 lines, use write() for the first part followed by chunks in append() (but you should be able to just put details in other files and keep this file more compact).\n\nTry to keep the file under 400 lines or so and if necessary keep supplementary files with extra details for particular in the same directory or refer to system configuration files.\n\nYou should be cautious about system changes that could render the system inoperable if they do not complete properly, because the user is relying on you to update the system. If the system stops operating due to a configuration problem, they will not be able to access your chat interface, and may not be able to recover. If you are not sure, make a backup of key files and ask the user for confirmation. \n\nHowever, for tasks that seem routine and you do not have a reason to suspect they will break the system, go ahead and execute them.\n\n## System state file\n\n/var/lib/ai-sysadmin/system-state.md\n\nNote: if this file does not exist or is blank, start by populating it concisely with key system statistics and information.\n\n## Last command\n\nBefore doing significant changes you can record what you are about to do in /var/lib/ai-sysadmin/last-change.md . This way in case there is a problem there will be a record of the last specific modification made or attempted to help with rolling it back (in addition to the backup you made of any config files edited).\n\n",
+  "technicalInstructions": "",
+  "service_models": {
+    "stream_chat": {
+      "provider": "ah_anthropic",
+      "model": "claude-opus-4-1-20250805"
+    }
+  },
+  "flags": [],
+  "required_plugins": []
+}
   ]
 }

{mindroot-9.5.0 → mindroot-9.6.0/src/mindroot.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mindroot
-Version: 9.5.0
+Version: 9.6.0
 Summary: MindRoot AI Agent Framework
 Requires-Python: >=3.9
 License-File: LICENSE

{mindroot-9.5.0 → mindroot-9.6.0}/src/mindroot.egg-info/SOURCES.txt

@@ -27,7 +27,6 @@ src/mindroot/coreplugins/admin/oauth_callback_router.py
 src/mindroot/coreplugins/admin/persona_handler.py
 src/mindroot/coreplugins/admin/persona_router.py
 src/mindroot/coreplugins/admin/plugin_manager.py
-src/mindroot/coreplugins/admin/plugin_manager_backup.py
 src/mindroot/coreplugins/admin/plugin_router.py
 src/mindroot/coreplugins/admin/plugin_router_fixed.py
 src/mindroot/coreplugins/admin/plugin_router_new_not_working.py
@@ -72,7 +71,6 @@ src/mindroot/coreplugins/admin/static/js/plugin-toggle.js
 src/mindroot/coreplugins/admin/static/js/recommended-plugin-install.js
 src/mindroot/coreplugins/admin/static/js/registry-auth-section.js
 src/mindroot/coreplugins/admin/static/js/registry-manager-base.js
-src/mindroot/coreplugins/admin/static/js/registry-manager-old.js
 src/mindroot/coreplugins/admin/static/js/registry-manager-publish-old-delete.js
 src/mindroot/coreplugins/admin/static/js/registry-manager.js
 src/mindroot/coreplugins/admin/static/js/registry-publish-section.js