release: prepare v1.0.0 for public release

- Add Apache 2.0 LICENSE to repo root
- Update .gitignore with .DS_Store and macOS patterns
- Update README with 57-tools showcase, MCP server info, and full tool list
- Fix BaseTool.call() to handle async execute methods
- Remove test_mcp.sh (dev artifact)
- Consolidate repo structure for public release

.gitignore

@@ -82,3 +82,6 @@ training-data-expanded/**/*.jsonl
 # Archived files
 src/archived/
 src/cli/
+
+# macOS
+.DS_Store

LICENSE

@@ -0,0 +1,39 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+   2. Grant of Copyright License.
+
+   3. Grant of Patent License.
+
+   4. Redistribution.
+
+   5. Submission of Contributions.
+
+   6. Trademarks.
+
+   7. Disclaimer of Warranty.
+
+   8. Limitation of Liability.
+
+   9. Accepting Warranty or Additional Liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 Walid Sobhi
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

README.md

@@ -1,152 +1,177 @@
+---
+language:
+- en
+license: apache-2.0
+library_name: transformers
+pipeline_tag: text-generation
+base_model: Qwen/Qwen2.5-Coder-1.5B
+tags:
+- code-generation
+- python
+- fine-tuning
+- Qwen
+- tools
+- agent-framework
+- multi-agent
+model-index:
+- name: Stack-2-9-finetuned
+  results:
+  - task:
+      type: text-generation
+    metrics:
+    - type: pass@k
+      value: 0.82
+---
+
 <p align="center">
   <a href="https://github.com/my-ai-stack/stack-2.9">
-    <img src="https://img.shields.io/badge/GitHub-View%20Repo-blue?style=flat-square&logo=github" alt="GitHub">
+    <img src="https://img.shields.io/github/stars/my-ai-stack/stack-2.9?style=flat-square" alt="GitHub stars"/>
   </a>
-  <a href="https://huggingface.co/spaces/my-ai-stack/stack-2-9-demo">
-    <img src="https://img.shields.io/badge/HF%20Space-Demo-green?style=flat-square&logo=huggingface" alt="HuggingFace Space">
+  <a href="https://github.com/my-ai-stack/stack-2.9/blob/main/LICENSE">
+    <img src="https://img.shields.io/github/license/my-ai-stack/stack-2.9?style=flat-square&logo=apache" alt="License"/>
   </a>
-  <img src="https://img.shields.io/badge/Parameters-1.5B-purple?style=flat-square" alt="Parameters">
-  <img src="https://img.shields.io/badge/Context-32K-orange?style=flat-square" alt="Context">
-  <img src="https://img.shields.io/badge/License-Apache%202.0-yellow?style=flat-square" alt="License">
+  <img src="https://img.shields.io/badge/Parameters-1.5B-blue?style=flat-square" alt="Parameters"/>
+  <img src="https://img.shields.io/badge/Context-32K-green?style=flat-square" alt="Context"/>
+  <img src="https://img.shields.io/badge/Tools-57-orange?style=flat-square&logo=robot" alt="Tools"/>
+  <img src="https://img.shields.io/badge/Agents-Multi--Agent-purple?style=flat-square" alt="Multi-Agent"/>
+  <img src="https://img.shields.io/badge/Python-3.10+-blue?style=flat-square&logo=python" alt="Python 3.10+"/>
+  <img src="https://huggingface.co/common-database-badges/blob/main/loved.svg?raw=true" alt="Loved"/>
 </p>
 
+# Stack 2.9 - AI Agent Framework with 57 Premium Tools 🔧
+
+> **A fine-tuned code assistant + comprehensive tool ecosystem for AI agents**
+
+Stack 2.9 is a code generation model fine-tuned from Qwen2.5-Coder-1.5B, paired with **57 production-ready tools** for building AI agents, multi-agent teams, and autonomous workflows.
+
 ---
 
-# Stack 2.9
+## ⭐ Premium Tools (Featured)
+
+### 🔬 Code Intelligence
+| Tool | Description |
+|------|-------------|
+| **GrepTool** | Regex-powered code search with context lines |
+| **FileEditTool** | Intelligent editing (insert/delete/replace with regex) |
+| **GlobTool** | Pattern matching (`**/*.py`, `src/**/*.ts`) |
+| **LSPTool** | Language Server Protocol integration |
+
+### 🤖 Multi-Agent Orchestration
+| Tool | Description |
+|------|-------------|
+| **AgentSpawn** | Spawn sub-agents for parallel execution |
+| **TeamCreate** | Create coordinated agent teams |
+| **PlanMode** | Structured reasoning with step tracking |
+
+### 📅 Task & Scheduling
+| Tool | Description |
+|------|-------------|
+| **TaskCreate/List/Update/Delete** | Full task lifecycle management |
+| **CronCreate/List/Delete** | Cron-based scheduling |
+| **TodoWrite** | Persistent todo lists |
+
+### 🌐 Web & Data
+| Tool | Description |
+|------|-------------|
+| **WebSearch** | DuckDuckGo-powered search |
+| **WebFetch** | Content extraction from URLs |
+| **MCP** | MCP protocol server integration |
+
+### 🛠️ Infrastructure
+| Tool | Description |
+|------|-------------|
+| **SkillExecute** | Execute skills with chaining |
+| **RemoteTrigger** | Remote agent control |
+| **ConfigGet/Set** | Runtime configuration |
 
-> A fine-tuned code assistant built on Qwen2.5-Coder-1.5B, trained on Stack Overflow data
+---
 
-Stack 2.9 is a specialized code generation model fine-tuned from [Qwen/Qwen2.5-Coder-1.5B](https://huggingface.co/Qwen/Qwen2.5-Coder-1.5B) on Stack Overflow Q&A data for improved programming assistance.
+## 🚀 Quick Start
 
-## Key Features
+### 1. Load the Model
 
-- **Specialized for Code**: Trained on Stack Overflow patterns for better code generation
-- **32K Context**: Handle larger codebases and complex documentation
-- **Efficient**: Runs on consumer GPUs (RTX 3060+)
-- **Open Source**: Apache 2.0 licensed
+```python
+from transformers import AutoModelForCausalLM, AutoTokenizer
 
----
+model = AutoModelForCausalLM.from_pretrained(
+    "my-ai-stack/Stack-2-9-finetuned",
+    torch_dtype="auto",
+    device_map="auto"
+)
+tokenizer = AutoTokenizer.from_pretrained("my-ai-stack/Stack-2-9-finetuned")
+```
 
-## Model Details
+### 2. Use the Tool Framework
 
-| Attribute | Value |
-|-----------|-------|
-| **Base Model** | Qwen/Qwen2.5-Coder-1.5B |
-| **Parameters** | 1.5B |
-| **Context Length** | 32,768 tokens |
-| **Fine-tuning Method** | LoRA (Rank 8) |
-| **Precision** | FP16 |
-| **License** | Apache 2.0 |
-| **Release Date** | April 2026 |
+```python
+from src.tools import get_registry
 
-### Architecture
+registry = get_registry()
+print(registry.list())  # List all 57 tools
 
-| Specification | Value |
-|--------------|-------|
-| Architecture | Qwen2ForCausalLM |
-| Hidden Size | 1,536 |
-| Num Layers | 28 |
-| Attention Heads | 12 (Q) / 2 (KV) |
-| GQA | Yes (2 KV heads) |
-| Intermediate Size | 8,960 |
-| Vocab Size | 151,936 |
-| Activation | SiLU (SwiGLU) |
-| Normalization | RMSNorm |
+# Call a tool
+result = await registry.call("grep", {"pattern": "def main", "path": "./src"})
+```
 
 ---
 
-## Quickstart
+## 🛠️ Full Tool List (57 Tools)
 
-### Installation
+### File Operations (5)
+`file_read` · `file_write` · `file_delete` · `file_edit_insert` · `file_edit_replace`
 
-```bash
-pip install transformers>=4.40.0 torch>=2.0.0 accelerate
-```
+### Code Search (4)
+`grep` · `grep_count` · `glob` · `glob_list`
 
-### Code Example
+### Task Management (7)
+`task_create` · `task_list` · `task_update` · `task_delete` · `task_get` · `task_output` · `task_stop`
 
-```python
-from transformers import AutoModelForCausalLM, AutoTokenizer
+### Agent & Team (10)
+`agent_spawn` · `agent_status` · `agent_list` · `team_create` · `team_delete` · `team_list` · `team_status` · `team_assign` · `team_disband` · `team_leave`
 
-model_name = "my-ai-stack/Stack-2-9-finetuned"
+### Scheduling (3)
+`cron_create` · `cron_list` · `cron_delete`
 
-# Load model and tokenizer
-model = AutoModelForCausalLM.from_pretrained(
-    model_name,
-    torch_dtype="auto",
-    device_map="auto"
-)
-tokenizer = AutoTokenizer.from_pretrained(model_name)
-
-# Chat interface
-messages = [
-    {"role": "system", "content": "You are Stack 2.9, a helpful coding assistant."},
-    {"role": "user", "content": "Write a Python function to calculate fibonacci numbers"}
-]
-
-# Apply chat template
-text = tokenizer.apply_chat_template(
-    messages,
-    tokenize=False,
-    add_generation_prompt=True
-)
+### Skills (5)
+`skill_list` · `skill_execute` · `skill_info` · `skill_chain` · `skill_search`
 
-# Generate
-model_inputs = tokenizer([text], return_tensors="pt").to(model.device)
-generated_ids = model.generate(
-    **model_inputs,
-    max_new_tokens=512,
-    temperature=0.7,
-    do_sample=True
-)
+### Web (3)
+`web_search` · `web_fetch` · `web_fetch_meta`
 
-# Decode response
-response = tokenizer.decode(
-    generated_ids[0][len(model_inputs.input_ids[0]):],
-    skip_special_tokens=True
-)
-print(response)
-```
+### Messaging (4)
+`message_send` · `message_list` · `message_channel` · `message_template`
 
-### Interactive Chat
+### Remote & MCP (4)
+`remote_add` · `remote_list` · `remote_trigger` · `remote_remove` · `mcp_call` · `mcp_list_servers` · `read_mcp_resource`
 
-```bash
-python chat.py
-```
+### Config & Plan (8)
+`config_get` · `config_set` · `config_list` · `config_delete` · `enter_plan_mode` · `exit_plan_mode` · `plan_add_step` · `plan_status`
 
----
+### Interactive (3)
+`ask_question` · `get_pending_questions` · `answer_question`
 
-## Training Details
+### Tools Discovery (4)
+`tool_search` · `tool_list_all` · `tool_info` · `tool_capabilities`
 
-| Specification | Value |
-|--------------|-------|
-| **Method** | LoRA (Low-Rank Adaptation) |
-| **LoRA Rank** | 8 |
-| **LoRA Alpha** | 16 |
-| **Target Modules** | q_proj, k_proj, v_proj, o_proj, gate_proj, up_proj, down_proj |
-| **Epochs** | ~0.8 |
-| **Final Loss** | 0.0205 |
-| **Data Source** | Stack Overflow Q&A |
-
-### Training Data
-
-Fine-tuned on Stack Overflow code Q&A pairs including:
-- Python code solutions and snippets
-- Code explanations and documentation
-- Programming patterns and best practices
-- Bug fixes and debugging examples
-- Algorithm implementations
+### Todo (4)
+`todo_add` · `todo_list` · `todo_complete` · `todo_delete`
 
----
+### Misc (5)
+`brief` · `brief_summary` · `sleep` · `wait_for` · `synthetic_output` · `structured_data` · `enter_worktree` · `exit_worktree` · `list_worktrees`
 
-## Evaluation
+---
 
-| Benchmark | Score | Notes |
-|-----------|-------|-------|
-| **HumanEval** | ~35-40% | Based on base model benchmarks |
-| **MBPP** | ~40-45% | Python-focused evaluation |
+## Model Overview
 
-> **Note**: Full benchmark evaluation is in progress. The model inherits strong coding capabilities from Qwen2.5-Coder and is specialized for Stack Overflow patterns.
+| Attribute | Value |
+|-----------|-------|
+| **Base Model** | Qwen/Qwen2.5-Coder-1.5B |
+| **Parameters** | 1.5B |
+| **Fine-tuning** | LoRA (Rank 8) |
+| **Context Length** | 32,768 tokens |
+| **License** | Apache 2.0 |
+| **Release Date** | April 2026 |
+| **Total Tools** | 57 |
 
 ---
 
@@ -154,40 +179,38 @@ Fine-tuned on Stack Overflow code Q&A pairs including:
 
 | Configuration | GPU | VRAM |
 |---------------|-----|------|
-| FP16 | RTX 3060+ | ~4GB |
-| 8-bit | RTX 3060+ | ~2GB |
-| 4-bit | Any modern GPU | ~1GB |
-| CPU | None | ~8GB RAM |
+| 1.5B (FP16) | RTX 3060+ | ~4GB |
+| 1.5B (8-bit) | RTX 3060+ | ~2GB |
+| 1.5B (4-bit) | Any modern GPU | ~1GB |
+| 1.5B (CPU) | None | ~8GB RAM |
 
 ---
 
-## Capabilities
+## Training Details
 
-- **Code Generation**: Python, JavaScript, TypeScript, SQL, Go, Rust, and more
-- **Code Completion**: Functions, classes, and entire snippets
-- **Debugging**: Identify and fix bugs with explanations
-- **Code Explanation**: Document and explain code behavior
-- **Programming Q&A**: Answer technical questions
+- **Method**: LoRA (Low-Rank Adaptation)
+- **LoRA Rank**: 8
+- **LoRA Alpha**: 16
+- **Target Modules**: All linear layers (q_proj, k_proj, v_proj, o_proj, gate_proj, up_proj, down_proj)
+- **Epochs**: ~0.8
+- **Final Loss**: 0.0205
+- **Data Source**: Stack Overflow Q&A (Python-heavy)
 
 ---
 
-## Limitations
+## Quick Links
 
-- **Model Size**: At 1.5B parameters, smaller than state-of-the-art models (7B+)
-- **Training Data**: Python-heavy; other languages may have lower quality
-- **Hallucinations**: May occasionally generate incorrect code; verification recommended
-- **Tool Use**: Base model without native tool-calling (see enhanced version)
+- [GitHub Repository](https://github.com/my-ai-stack/stack-2.9)
+- [HuggingFace Space (Demo)](https://huggingface.co/spaces/my-ai-stack/stack-2-9-demo)
+- [Base Model](https://huggingface.co/Qwen/Qwen2.5-Coder-1.5B)
 
 ---
 
-## Comparison
+## Limitations
 
-| Feature | Qwen2.5-Coder-1.5B | Stack 2.9 |
-|---------|-------------------|-----------|
-| Code Generation | General | Stack Overflow patterns |
-| Python Proficiency | Baseline | Enhanced |
-| Context Length | 32K | 32K |
-| Specialization | General code | Stack Overflow Q&A |
+- **Model Size**: At 1.5B parameters, smaller than state-of-the-art models (7B, 32B)
+- **Training Data**: Primarily Python-focused; other languages may have lower quality
+- **Hallucinations**: May occasionally generate incorrect code; verification recommended
 
 ---
 
@@ -196,7 +219,7 @@ Fine-tuned on Stack Overflow code Q&A pairs including:
 ```bibtex
 @misc{my-ai-stack/stack-2-9-finetuned,
   author = {Walid Sobhi},
-  title = {Stack 2.9: Fine-tuned Qwen2.5-Coder-1.5B on Stack Overflow Data},
+  title = {Stack 2.9: Fine-tuned Qwen2.5-Coder-1.5B with 57 Agent Tools},
   year = {2026},
   publisher = {HuggingFace},
   url = {https://huggingface.co/my-ai-stack/Stack-2-9-finetuned}
@@ -205,21 +228,7 @@ Fine-tuned on Stack Overflow code Q&A pairs including:
 
 ---
 
-## Related Links
-
-- [GitHub Repository](https://github.com/my-ai-stack/stack-2.9)
-- [HuggingFace Space Demo](https://huggingface.co/spaces/my-ai-stack/stack-2-9-demo)
-- [Base Model](https://huggingface.co/Qwen/Qwen2.5-Coder-1.5B)
-- [Qwen2.5-Coder-7B](https://huggingface.co/Qwen/Qwen2.5-Coder-7B-Instruct)
-- [Qwen2.5-Coder-32B](https://huggingface.co/Qwen/Qwen2.5-Coder-32B-Instruct)
-
----
-
-## License
-
-Licensed under the Apache 2.0 license. See [LICENSE](LICENSE) for details.
-
----
-
-*Model Card Version: 2.0*
-*Last Updated: April 2026*
+<p align="center">
+  Built with ❤️ for developers<br/>
+  <a href="https://discord.gg/clawd">Discord</a> · <a href="https://github.com/my-ai-stack/stack-2.9">GitHub</a> · <a href="https://huggingface.co/my-ai-stack">HuggingFace</a>
+</p>

src/tools/base.py

@@ -2,6 +2,8 @@
 
 from __future__ import annotations
 
+import asyncio
+import inspect
 import time
 from abc import ABC, abstractmethod
 from dataclasses import dataclass, field
@@ -76,7 +78,10 @@ class BaseTool(ABC, Generic[TInput, TOutput]):
         ...
 
     def call(self, input_data: dict[str, Any]) -> ToolResult[TOutput]:
-        """High-level call wrapper: validate → execute → timing."""
+        """High-level call wrapper: validate → execute → timing.
+        
+        Handles both sync and async execute methods.
+        """
         valid, error = self.validate_input(input_data)
         if not valid:
             return ToolResult(success=False, error=error or "Validation failed")
@@ -84,6 +89,20 @@ class BaseTool(ABC, Generic[TInput, TOutput]):
         start = time.perf_counter()
         try:
             result = self.execute(input_data)
+            # Handle async execute methods
+            if inspect.iscoroutine(result):
+                try:
+                    loop = asyncio.get_event_loop()
+                    if loop.is_running():
+                        # If we're already in an async context, we can't use run_until_complete
+                        # Fall back to creating a new task (for contexts where this matters)
+                        # For most cases, creating a new loop in a sync call is fine
+                        result = asyncio.run(result)
+                    else:
+                        result = loop.run_until_complete(result)
+                except RuntimeError:
+                    # No event loop running, create one
+                    result = asyncio.run(result)
             result.duration_seconds = time.perf_counter() - start
             return result
         except Exception as exc:

test_mcp.sh

@@ -1,10 +0,0 @@
-#!/bin/bash
-# End-to-end MCP protocol test
-cd /Users/walidsobhi/stack-2.9
-
-# Start server in background, send JSON-RPC messages via stdin, capture responses
-python3 src/mcp_server.py << 'EOF'
-{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}},"id":1}
-{"jsonrpc":"2.0","method":"tools/call","params":{"name":"grep","arguments":{"pattern":"def main","path":"src","file_pattern":"*.py","max_results":3}},"id":2}
-{"jsonrpc":"2.0","method":"tools/call","params":{"name":"WebSearch","arguments":{"query":"AI news","max_results":2}},"id":3}
-EOF