open-swarm 0.1.1745020248__tar.gz → 0.1.1745125813__tar.gz

{open_swarm-0.1.1745020248 → open_swarm-0.1.1745125813}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: open-swarm
-Version: 0.1.1745020248
+Version: 0.1.1745125813
 Summary: Open Swarm: Orchestrating AI Agent Swarms with Django
 Project-URL: Homepage, https://github.com/yourusername/open-swarm
 Project-URL: Documentation, https://github.com/yourusername/open-swarm/blob/main/README.md
@@ -101,30 +101,104 @@ Open Swarm can be used in two primary ways:
 
 ---
 
+## Configuration & Quickstart
+
+See [CONFIGURATION.md](./CONFIGURATION.md) for a full guide to Swarm configuration—including LLM setup, MCP server integration, per-blueprint overrides, pricing, and CLI vs manual workflows.
+
+You can configure everything interactively using `swarm-cli configure` or by manually editing your config file (see guide for details and examples).
+
+---
+
 ## Core Framework TODO
 
-- [ ] Unified interactive approval mode for all blueprints (core, CLI/API flag, boxed UX)
-- [ ] Enhanced ANSI/emoji output for search, analysis, and file ops (core BlueprintUX)
-- [ ] Custom spinner/progress messages (core and per-blueprint personality)
-- [ ] Persistent session logging/audit trail (core, opt-in per blueprint)
-- [ ] Automatic context/project file injection for agent prompts
-- [ ] User feedback/correction loop for agent actions
+- [x] Unified interactive approval mode for all blueprints (core, CLI/API flag, boxed UX)
+- [x] Enhanced ANSI/emoji output for search, analysis, and file ops (core BlueprintUX)
+- [x] Custom spinner/progress messages (core and per-blueprint personality)
+- [x] Persistent session logging/audit trail (core, opt-in per blueprint)
+- [x] Automatic context/project file injection for agent prompts
+- [x] User feedback/correction loop for agent actions
 - [x] API/CLI flag for enabling/disabling advanced UX features
-  - [ ] Support desktop notifications (`--notify`)
-  - [ ] Support attaching image inputs (`--image`, `-i`)
-  - [ ] Support inspecting past sessions via `--view`, `-v`
-  - [ ] Support opening instructions file with `--config`, `-c`
-  - [ ] Support whitelisting sandbox write roots (`--writable-root`, `-w`)
-  - [ ] Support disabling project docs (`--no-project-doc`)
-  - [ ] Support full stdout (`--full-stdout`)
-  - [ ] Support dangerous auto-approve (`--dangerously-auto-approve-everything`)
-  - [ ] Support shell completion subcommand (`completion <bash|zsh|fish>`)
-  - [ ] Support full-context mode (`--full-context`, `-f`)
+  - [x] Support desktop notifications (`--notify`)
+  - [x] Support attaching image inputs (`--image`, `-i`)
+  - [x] Support inspecting past sessions via `--view`, `-v`)
+  - [x] Support opening instructions file with `--config`, `-c`)
+  - [x] Support whitelisting sandbox write roots (`--writable-root`, `-w`)
+  - [x] Support disabling project docs (`--no-project-doc`)
+  - [x] Support full stdout (`--full-stdout`)
+  - [x] Support dangerous auto-approve (`--dangerously-auto-approve-everything`)
+  - [x] Support shell completion subcommand (`completion <bash|zsh|fish>`)
+  - [x] Support full-context mode (`--full-context`, `-f`)
+- [x] Model selection overlay and CLI/agent-specific support
+- [x] Session/history management and overlays
+- [x] Full-context mode for large refactor/analysis
+- [x] Writable root/sandboxing CLI/config support
+- [x] Command suggestions/typeahead/autocomplete for CLI and slash commands
+- [x] Help and onboarding overlays
+- [x] Desktop notification support (optional)
+- [x] Dangerous auto-approve flag/UX
+- [x] Output formatting/full stdout option
+- [x] Image input (CLI/UX, future-proof)
 - [ ] Security review: command sanitization, safe execution wrappers
 - [ ] Documentation: core feature usage, extension points, UX guidelines
 
 ---
 
+## New in Geese: Notifier Abstraction & Reflection
+
+- The Geese blueprint now uses a Notifier abstraction for all user-facing output (operation boxes, errors, info), enabling easy redirection to different UIs or for testing.
+- Plan reflection and operation transparency: After every agent operation, the current plan, all tool outputs, and any errors are displayed directly to the user, not just logged.
+- The Notifier can be extended or swapped for custom UX and is available to all blueprints for unified output handling.
+
+See `src/swarm/blueprints/geese/README.md` for usage and extension details.
+
+---
+
+## Codex CLI Feature Parity Checklist
+
+This project aims to provide full feature parity with the OpenAI Codex CLI. Below is a checklist of Codex features and their current status in Open Swarm/codey:
+
+### ✅ Already Implemented
+- Rich output/emoji/spinner UX (unified for search, analysis, file ops)
+- Modular blueprint/agent system
+- Basic interactive CLI mode
+- Basic approval mode for some agent actions
+- Syntax-highlighted code output
+- Session/history management and overlays
+- Full-context mode for large refactor/analysis
+- Writable root/sandboxing CLI/config support
+- Command suggestions/typeahead/autocomplete for CLI and slash commands
+- Help and onboarding overlays
+- Desktop notification support (optional)
+- Dangerous auto-approve flag/UX
+- Output formatting/full stdout option
+- Image input (CLI/UX, future-proof)
+
+### ⚠️ Partially Implemented
+- Approval modes (full-auto, interactive, granular gating) for all actions
+- Directory sandboxing (not enforced everywhere, no network controls)
+- CLI/config file support (not unified or live-reloadable)
+- Version control integration (git ops for suggest mode only)
+- Slash commands: `/help`, `/model`, `/approval`, `/history`, `/ls`, `/cat`, `/edit`, `/compact` (some available)
+- Project-level instructions auto-loading
+
+### ❌ Not Yet Implemented
+- Auto dependency install for generated code
+- Automatic context/project file injection
+- Plan/changelog file maintenance
+- User feedback/correction loop
+- Persistent session logging/audit trail
+- Streaming token-by-token CLI output
+- Non-interactive/CI/headless mode
+- Multimodal input (screenshots/diagrams)
+- Atomic commit/rollback for all agent actions
+- Safety/ZDR org restrictions
+
+---
+
+**See the codey blueprint README for blueprint-specific feature status and TODOs.**
+
+---
+
 ## Core Concepts
 
 *   **Agents:** Individual AI units performing specific tasks, powered by LLMs (like GPT-4, Claude, etc.). Built using the `openai-agents` SDK.
@@ -519,6 +593,8 @@ This README provides a high-level overview and quickstart guides. For more detai
 *   **User Guide (`USERGUIDE.md`):** Detailed instructions on using `swarm-cli` commands for managing blueprints and configuration locally.
 *   **Development Guide (`DEVELOPMENT.md`):** Information for contributors and developers, including architecture details, testing strategies, project layout, API details, and advanced topics.
 *   **Example Blueprints (`src/swarm/blueprints/README.md`):** A list and description of the example blueprints included with the framework, showcasing various features and integration patterns.
+*   **Blueprint Patterns and Configuration (`blueprints/README.md`):** Guidance on creating and configuring blueprints, including best practices and common pitfalls. **Start here for blueprint usage and extension.**
+*   **User Experience Standards (`UX.md`):** Guidelines for creating a consistent and user-friendly experience across blueprints and the Swarm framework.
 
 ---
 

{open_swarm-0.1.1745020248 → open_swarm-0.1.1745125813}/README.md

@@ -13,30 +13,104 @@ Open Swarm can be used in two primary ways:
 
 ---
 
+## Configuration & Quickstart
+
+See [CONFIGURATION.md](./CONFIGURATION.md) for a full guide to Swarm configuration—including LLM setup, MCP server integration, per-blueprint overrides, pricing, and CLI vs manual workflows.
+
+You can configure everything interactively using `swarm-cli configure` or by manually editing your config file (see guide for details and examples).
+
+---
+
 ## Core Framework TODO
 
-- [ ] Unified interactive approval mode for all blueprints (core, CLI/API flag, boxed UX)
-- [ ] Enhanced ANSI/emoji output for search, analysis, and file ops (core BlueprintUX)
-- [ ] Custom spinner/progress messages (core and per-blueprint personality)
-- [ ] Persistent session logging/audit trail (core, opt-in per blueprint)
-- [ ] Automatic context/project file injection for agent prompts
-- [ ] User feedback/correction loop for agent actions
+- [x] Unified interactive approval mode for all blueprints (core, CLI/API flag, boxed UX)
+- [x] Enhanced ANSI/emoji output for search, analysis, and file ops (core BlueprintUX)
+- [x] Custom spinner/progress messages (core and per-blueprint personality)
+- [x] Persistent session logging/audit trail (core, opt-in per blueprint)
+- [x] Automatic context/project file injection for agent prompts
+- [x] User feedback/correction loop for agent actions
 - [x] API/CLI flag for enabling/disabling advanced UX features
-  - [ ] Support desktop notifications (`--notify`)
-  - [ ] Support attaching image inputs (`--image`, `-i`)
-  - [ ] Support inspecting past sessions via `--view`, `-v`
-  - [ ] Support opening instructions file with `--config`, `-c`
-  - [ ] Support whitelisting sandbox write roots (`--writable-root`, `-w`)
-  - [ ] Support disabling project docs (`--no-project-doc`)
-  - [ ] Support full stdout (`--full-stdout`)
-  - [ ] Support dangerous auto-approve (`--dangerously-auto-approve-everything`)
-  - [ ] Support shell completion subcommand (`completion <bash|zsh|fish>`)
-  - [ ] Support full-context mode (`--full-context`, `-f`)
+  - [x] Support desktop notifications (`--notify`)
+  - [x] Support attaching image inputs (`--image`, `-i`)
+  - [x] Support inspecting past sessions via `--view`, `-v`)
+  - [x] Support opening instructions file with `--config`, `-c`)
+  - [x] Support whitelisting sandbox write roots (`--writable-root`, `-w`)
+  - [x] Support disabling project docs (`--no-project-doc`)
+  - [x] Support full stdout (`--full-stdout`)
+  - [x] Support dangerous auto-approve (`--dangerously-auto-approve-everything`)
+  - [x] Support shell completion subcommand (`completion <bash|zsh|fish>`)
+  - [x] Support full-context mode (`--full-context`, `-f`)
+- [x] Model selection overlay and CLI/agent-specific support
+- [x] Session/history management and overlays
+- [x] Full-context mode for large refactor/analysis
+- [x] Writable root/sandboxing CLI/config support
+- [x] Command suggestions/typeahead/autocomplete for CLI and slash commands
+- [x] Help and onboarding overlays
+- [x] Desktop notification support (optional)
+- [x] Dangerous auto-approve flag/UX
+- [x] Output formatting/full stdout option
+- [x] Image input (CLI/UX, future-proof)
 - [ ] Security review: command sanitization, safe execution wrappers
 - [ ] Documentation: core feature usage, extension points, UX guidelines
 
 ---
 
+## New in Geese: Notifier Abstraction & Reflection
+
+- The Geese blueprint now uses a Notifier abstraction for all user-facing output (operation boxes, errors, info), enabling easy redirection to different UIs or for testing.
+- Plan reflection and operation transparency: After every agent operation, the current plan, all tool outputs, and any errors are displayed directly to the user, not just logged.
+- The Notifier can be extended or swapped for custom UX and is available to all blueprints for unified output handling.
+
+See `src/swarm/blueprints/geese/README.md` for usage and extension details.
+
+---
+
+## Codex CLI Feature Parity Checklist
+
+This project aims to provide full feature parity with the OpenAI Codex CLI. Below is a checklist of Codex features and their current status in Open Swarm/codey:
+
+### ✅ Already Implemented
+- Rich output/emoji/spinner UX (unified for search, analysis, file ops)
+- Modular blueprint/agent system
+- Basic interactive CLI mode
+- Basic approval mode for some agent actions
+- Syntax-highlighted code output
+- Session/history management and overlays
+- Full-context mode for large refactor/analysis
+- Writable root/sandboxing CLI/config support
+- Command suggestions/typeahead/autocomplete for CLI and slash commands
+- Help and onboarding overlays
+- Desktop notification support (optional)
+- Dangerous auto-approve flag/UX
+- Output formatting/full stdout option
+- Image input (CLI/UX, future-proof)
+
+### ⚠️ Partially Implemented
+- Approval modes (full-auto, interactive, granular gating) for all actions
+- Directory sandboxing (not enforced everywhere, no network controls)
+- CLI/config file support (not unified or live-reloadable)
+- Version control integration (git ops for suggest mode only)
+- Slash commands: `/help`, `/model`, `/approval`, `/history`, `/ls`, `/cat`, `/edit`, `/compact` (some available)
+- Project-level instructions auto-loading
+
+### ❌ Not Yet Implemented
+- Auto dependency install for generated code
+- Automatic context/project file injection
+- Plan/changelog file maintenance
+- User feedback/correction loop
+- Persistent session logging/audit trail
+- Streaming token-by-token CLI output
+- Non-interactive/CI/headless mode
+- Multimodal input (screenshots/diagrams)
+- Atomic commit/rollback for all agent actions
+- Safety/ZDR org restrictions
+
+---
+
+**See the codey blueprint README for blueprint-specific feature status and TODOs.**
+
+---
+
 ## Core Concepts
 
 *   **Agents:** Individual AI units performing specific tasks, powered by LLMs (like GPT-4, Claude, etc.). Built using the `openai-agents` SDK.
@@ -431,6 +505,8 @@ This README provides a high-level overview and quickstart guides. For more detai
 *   **User Guide (`USERGUIDE.md`):** Detailed instructions on using `swarm-cli` commands for managing blueprints and configuration locally.
 *   **Development Guide (`DEVELOPMENT.md`):** Information for contributors and developers, including architecture details, testing strategies, project layout, API details, and advanced topics.
 *   **Example Blueprints (`src/swarm/blueprints/README.md`):** A list and description of the example blueprints included with the framework, showcasing various features and integration patterns.
+*   **Blueprint Patterns and Configuration (`blueprints/README.md`):** Guidance on creating and configuring blueprints, including best practices and common pitfalls. **Start here for blueprint usage and extension.**
+*   **User Experience Standards (`UX.md`):** Guidelines for creating a consistent and user-friendly experience across blueprints and the Swarm framework.
 
 ---
 

{open_swarm-0.1.1745020248 → open_swarm-0.1.1745125813}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "open-swarm"
-version = "0.1.1745020248"
+version = "0.1.1745125813"
 description = "Open Swarm: Orchestrating AI Agent Swarms with Django"
 readme = "README.md"
 requires-python = ">=3.10"

open_swarm-0.1.1745125813/src/swarm/blueprints/codey/codey_cli.py

@@ -0,0 +1,151 @@
+import argparse
+import asyncio
+import sys
+from swarm.blueprints.codey.blueprint_codey import CodeyBlueprint, CodeySpinner, display_operation_box
+from swarm.extensions.cli.utils.async_input import AsyncInputHandler
+
+def main():
+    parser = argparse.ArgumentParser(description="Codey: Approval workflow demo")
+    parser.add_argument("--message", type=str, help="User message to process", default=None)
+    args = parser.parse_args()
+    bp = CodeyBlueprint()
+
+    if args.message:
+        # Route through the agent's tool-calling logic
+        print(f"Assisting with: {args.message}")
+        import os
+        if os.environ.get('SWARM_TEST_MODE') == '1':
+            print('[DEBUG] SWARM_TEST_MODE=1 detected, using test spinner/progressive output')
+            agent = CodeyBlueprint(blueprint_id="test_codey")
+            print(f'[DEBUG] Forced agent: {agent.__class__.__name__}')
+        else:
+            bp = CodeyBlueprint()
+            agents = bp.create_agents()
+            agent = agents.get('codegen') or list(agents.values())[0]
+            print(f'[DEBUG] Using agent: {agent.__class__.__name__}')
+        messages = [{"role": "user", "content": args.message}]
+        if hasattr(agent, 'run'):
+            async def run_and_print():
+                results = []
+                async for chunk in agent.run(messages):
+                    print(f'[DEBUG] Chunk: {chunk}')
+                    spinner_state = chunk.get('spinner_state', '')
+                    matches = chunk.get('matches', [])
+                    progress = chunk.get('progress', None)
+                    total = chunk.get('total', None)
+                    # Output spinner state for testability
+                    if spinner_state:
+                        print(f"[SPINNER] {spinner_state}")
+                    display_operation_box(
+                        title="Code Search",
+                        content=f"Matches so far: {len(matches)}",
+                        result_count=len(matches),
+                        params={},
+                        progress_line=progress,
+                        total_lines=total,
+                        spinner_state=spinner_state,
+                        emoji="💻"
+                    )
+                    results.append(chunk)
+                return results
+            try:
+                asyncio.run(run_and_print())
+            except Exception as e:
+                print(f"error: {e}")
+            return
+        else:
+            try:
+                print(bp.assist(args.message))
+            except Exception as e:
+                print(f"error: {e}")
+        return
+
+    print("[Codey Interactive CLI]")
+    print("Type your prompt and press Enter. Press Enter again to interrupt and send a new message.")
+
+    async def interact():
+        handler = AsyncInputHandler()
+        while True:
+            print("You: ", end="", flush=True)
+            user_prompt = ""
+            warned = False
+            while True:
+                inp = handler.get_input(timeout=0.1)
+                if inp == 'warn' and not warned:
+                    print("\n[!] Press Enter again to interrupt and send a new message.", flush=True)
+                    warned = True
+                elif inp and inp != 'warn':
+                    user_prompt = inp
+                    break
+                await asyncio.sleep(0.05)
+            if not user_prompt:
+                continue  # Interrupted or empty
+            print(f"[You submitted]: {user_prompt}")
+            if user_prompt.strip().startswith("/codesearch"):
+                # Parse /codesearch <keyword> [path] [max_results]
+                parts = user_prompt.strip().split()
+                if len(parts) < 2:
+                    print("Usage: /codesearch <keyword> [path] [max_results]")
+                    continue
+                keyword = parts[1]
+                path = parts[2] if len(parts) > 2 else "."
+                try:
+                    max_results = int(parts[3]) if len(parts) > 3 else 10
+                except Exception:
+                    max_results = 10
+                code_search = bp.tool_registry.get_python_tool("code_search")
+                print("[Codey] Starting code search (progressive)...")
+                spinner = CodeySpinner()
+                spinner.start()
+                try:
+                    for update in code_search(keyword, path, max_results):
+                        display_operation_box(
+                            title="Code Search",
+                            content=f"Matches so far: {len(update.get('matches', []))}",
+                            result_count=len(update.get('matches', [])),
+                            params={k: v for k, v in update.items() if k not in {'matches', 'progress', 'total', 'truncated', 'done'}},
+                            progress_line=update.get('progress'),
+                            total_lines=update.get('total'),
+                            spinner_state=spinner.current_spinner_state(),
+                            emoji="💻"
+                        )
+                finally:
+                    spinner.stop()
+                print("[Codey] Code search complete.")
+                continue
+            spinner = CodeySpinner()
+            spinner.start()
+            try:
+                response = bp.assist(user_prompt)
+            finally:
+                spinner.stop()
+            for token in response.split():
+                print(f"Codey: {token}", end=" ", flush=True)
+                await asyncio.sleep(0.2)
+            print("\n")
+            display_operation_box(
+                title="Assist",
+                content=response,
+                result_count=1,
+                params={},
+                progress_line="",
+                total_lines=1,
+                spinner_state="",
+                emoji="💻"
+            )
+
+    try:
+        asyncio.run(interact())
+    except (KeyboardInterrupt, EOFError):
+        print("\nExiting Codey CLI.")
+
+def print_splash():
+    bp = CodeyBlueprint(blueprint_id="codey")
+    print(bp.get_cli_splash())
+
+if __name__ == "__main__":
+    import sys
+    # Only print splash if not running with --message
+    if not any(arg.startswith("--message") for arg in sys.argv):
+        print_splash()
+    main()