feat: release github-copilot-sdk v0.6.0 and files-filter v0.1.2

docs/plugins/pipes/github-copilot-sdk-deep-dive.md

@@ -0,0 +1,80 @@
+# GitHub Copilot SDK Plugin Deep Dive
+
+**Version:** 0.6.0 | **Author:** [Fu-Jie](https://github.com/Fu-Jie/awesome-openwebui) | **Status:** Production-Ready
+
+The GitHub Copilot SDK plugin is far more than a simple API proxy; it is a highly integrated **Intelligent Agent Runtime Environment**. This document explores the core features, implementation details, technical architecture, and security design that define its capabilities.
+
+---
+
+## 🚀 1. Feature Catalog
+
+The plugin implements advanced capabilities that go far beyond standard API calls:
+
+- **✅ Physical Workspace Management**: Automatically creates isolated directories for each chat session to manage uploaded files and Agent-generated scripts.
+- **✅ Real-time TODO Sync**: Mounts to the OpenWebUI database to persist Agent plans directly into a UI progress bar, ensuring transparency for long-running tasks.
+- **✅ Cross-Ecosystem Tool Bridging**: Translates OpenWebUI Search, Python interpreters, and custom MCP tools into native Copilot capabilities.
+- **✅ Intelligent File Transport**: Ensures the Agent can access raw files (Excel, PDF, Code) like a local developer through physical file duplication.
+- **✅ Chain of Thought Streaming**: Full support for rendering the model's reasoning/thinking process in real-time.
+- **✅ BYOK with Plugin Power**: Connect external OpenAI/Anthropic models while retaining all the plugin's workspace and tool management features.
+
+---
+
+## 🎯 2. Use Cases: Beyond Basic Chat
+
+With these features, the plugin excels in complex, real-world scenarios:
+
+### 📁 Autonomous Repository Maintenance (Agentic DevOps)
+>
+> **Action**: Upload a Zip archive containing a codebase with bugs.
+> **Utility**: The Agent extracts the archive, uses `bash` to navigate and search, applies fixes via the `edit` tool, and runs tests to verify the solution—all within its isolated sandbox.
+
+### 📊 Deep Data Analysis (Data Scientist Agent)
+>
+> **Action**: Upload multiple heavy Excel spreadsheets.
+> **Utility**: By bypassing RAG (via the filter), the Agent loads raw files directly into its Python interpreter, performs cross-table calculations, and generates analytical charts presented via Artifacts.
+
+### 📝 Strategic Task Management
+>
+> **Action**: "Develop a full architecture for a new mobile app."
+> **Utility**: The plugin captures the Agent's breakdown of 20+ sub-tasks. The persistent progress bar reflects ongoing progress (e.g., "Designing Schema", "Drafting API"), providing clarity during long marathons.
+
+---
+
+## 🛡️ 3. Technical Architecture
+
+### 3.1 Three-Layer Sandbox Isolation
+
+To prevent data leakage in multi-user environments, the plugin enforces a strict physical directory structure:
+`/app/backend/data/copilot_workspace/{user_id}/{chat_id}/`
+
+- **Constraint**: Code execution and file storage are confined to the session-specific folder.
+- **Persistence**: Data remains valid across container restarts due to volume mounting.
+
+### 3.2 Dynamic Tool Bridging
+
+How does Copilot "learn" to use OpenWebUI tools?
+
+1. **Introspection**: Analyzes docstrings and type hints of OpenWebUI tools.
+2. **Schema Generation**: Dynamically creates JSON descriptions compliant with the GitHub Copilot specification.
+3. **Routing**: Handles parameter validation, identity injection, and result forwarding between systems.
+
+### 3.3 Event-Driven TODO Hub
+
+The plugin captures internal SDK events to power the UI progress bar:
+
+- **Interceptor**: Listens for `tool.execution_complete` events for the `update_todo` tool.
+- **Storage**: Syncs project metrics directly to the `chat_todos` table in the OpenWebUI database (SQLite/PostgreSQL).
+
+---
+
+## ⚡ 4. Runtime Performance
+
+- **Anti-Shake Logic**: Environment checks happen only once every 24 hours per process, preventing redundant system calls.
+- **Tool Caching**: Persists tool definitions across sessions to reduce overhead, improving initial response times by up to 40%.
+
+---
+
+## 🛠️ 5. Development Best Practices
+
+1. **Use the Filter**: Always pair with `github_copilot_sdk_files_filter` to ensure files reach the Agent in their original binary form.
+2. **File-First Execution**: Encourage the Agent to "write code to file and execute" rather than relying on direct interactive shell input for complex logic.