Merge branch 'master' into fix/1906-skillorchestra-imgs-kwargs-propagation

Author: PrinceThummar011

.github/workflows/RELEASE.yml

@@ -20,10 +20,10 @@ jobs:
       - uses: actions/checkout@v6
       - name: Install poetry
         run: pipx install poetry==$POETRY_VERSION
-      - name: Set up Python 3.9
+      - name: Set up Python 3.10
         uses: actions/setup-python@v6
         with:
-          python-version: "3.9"
+          python-version: "3.10"
           cache: "poetry"
       - name: Build project for distribution
         run: poetry build

.github/workflows/python-package.yml

@@ -15,6 +15,7 @@ jobs:
   build:
 
     runs-on: ubuntu-latest
+    timeout-minutes: 20
     strategy:
       fail-fast: false
       matrix:
@@ -31,6 +32,8 @@ jobs:
         python -m pip install --upgrade pip
         python -m pip install flake8 pytest
         if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+        # The tests import swarms, so the package under test has to be installed.
+        python -m pip install -e . --no-deps
     - name: Lint with flake8
       run: |
         # stop the build if there are Python syntax errors or undefined names

.github/workflows/test-main-features.yml

@@ -51,7 +51,7 @@ jobs:
 
     - name: Install dependencies
       run: |
-        poetry install --with test --no-dev
+        poetry install --only main,test
 
     - name: Set up environment variables
       run: |
@@ -65,7 +65,6 @@ jobs:
 
     - name: Run Main Features Tests
       run: |
-        cd /Users/swarms_wd/Desktop/research/swarms
         poetry run python tests/test_main_features.py
 
     - name: Upload test results

.github/workflows/tests.yml

@@ -9,6 +9,7 @@ on:
 jobs:
   test:
     runs-on: ubuntu-latest
+    timeout-minutes: 20
 
     steps:
     - uses: actions/checkout@v6

CLAUDE.md

@@ -112,7 +112,7 @@ print(result)
 | `context_compression` | bool | `True` | Auto-summarise when near context limit (v12) |
 | `persistent_memory` | bool | `False` | Read/write MEMORY.md across restarts (v12); opt in explicitly |
 | `temperature` | float | `0.5` | Sampling temperature |
-| `max_tokens` | int | `16000` | Max tokens per LLM call. Note: currently overwritten during setup by the model's own limit, so passing it has no effect |
+| `max_tokens` | int | model's max output | Max tokens per LLM call. Unset resolves to the model's own output limit |
 | `reasoning_effort` | str | `None` | `"low"`, `"medium"`, `"high"` for reasoning models |
 | `thinking_tokens` | int | `None` | Extended thinking budget (Claude) |
 | `output_type` | str | `"str-all-except-first"` | How to format returned output |
@@ -507,10 +507,8 @@ result = router.run("Write a blog post about transformer architectures.")
 | `"HeavySwarm"` | Intensive multi-loop deep analysis |
 | `"RoundRobin"` | Round-robin task distribution |
 | `"PlannerWorkerSwarm"` | Planner + worker delegation |
-| `"BatchedGridWorkflow"` | Grid-based batch execution |
 | `"LLMCouncil"` | LLM-based council decisions |
 | `"AutoSwarmBuilder"` | Auto-configures everything |
-| `"auto"` | Router selects swarm_type automatically |
 
 ---
 
@@ -938,7 +936,7 @@ agent = Agent(
 | High-stakes ruling with deliberation | `CouncilAsAJudge` |
 | Structured adversarial debate | `DebateWithJudge` |
 | Deep research, many loops | `HeavySwarm` |
-| Don't know yet / rapid prototyping | `AutoSwarmBuilder` or `SwarmRouter(swarm_type="auto")` |
+| Don't know yet / rapid prototyping | `AutoSwarmBuilder` |
 | Need to switch architectures easily | `SwarmRouter` |
 
 ---
@@ -1086,8 +1084,6 @@ from swarms import Agent
 
 **Don't instantiate heavyweight structures inside tight loops** — create agents and workflows once, reuse them across calls.
 
-**Don't pass `tools=[]` (empty list)** — pass `tools=None` instead. An empty list can confuse schema generation.
-
 **Don't use `streaming_on=True` and `streaming_callback` together on the same agent** — `streaming_on` streams to stdout; `streaming_callback` streams to your function. Pick one.
 
 **Don't set `context_compression=False` on very long autonomous sessions** — without compression the agent will eventually hit the context limit and raise an error.