open-swarm 0.1.1745274322__py3-none-any.whl → 0.1.1745274459__py3-none-any.whl

{open_swarm-0.1.1745274322.dist-info → open_swarm-0.1.1745274459.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: open-swarm
-Version: 0.1.1745274322
+Version: 0.1.1745274459
 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

{open_swarm-0.1.1745274322.dist-info → open_swarm-0.1.1745274459.dist-info}/RECORD

@@ -18,10 +18,11 @@ swarm/blueprints/blueprint_audit_status.json,sha256=6uv6_M8WU5VGr1GhG49_p0-iHHRo
 swarm/blueprints/chatbot/blueprint_chatbot.py,sha256=Fuy_kPQUaZtIKoM01aWGjieak1zGTxI8VBVbi-TzHH0,14441
 swarm/blueprints/chatbot/templates/chatbot/chatbot.html,sha256=REFnqNg0EHsXxAUfaCJe1YgOKiV_umBXuC6y8veF5CU,1568
 swarm/blueprints/codey/CODEY.md,sha256=JxGcR0INH0dLk_q4ua1D0YdvX99szyESsbbs4dIy5Sc,742
-swarm/blueprints/codey/README.md,sha256=_wQ8MuEFj4cMmKaJYfgvoepkCaF-zIZYfdhAyhvmzAg,7369
-swarm/blueprints/codey/blueprint_codey.py,sha256=u3VvUSPDu7hULMGpouVNOwNslwDtNFPSUofV8mUDxu8,61216
-swarm/blueprints/codey/codey_cli.py,sha256=I_xvePNqTdqeNmFAuI3blgvQM6u40nh7u-wah8dB7yM,6750
+swarm/blueprints/codey/README.md,sha256=4P9BdRhhUl65W3m1akp-wooM808P8jFWQHm9jbnDjYE,5266
+swarm/blueprints/codey/blueprint_codey.py,sha256=t6VSEgier8RHzdcZjsAKD098vzIUpsXIkQHwyrVOzDA,48030
+swarm/blueprints/codey/codey_cli.py,sha256=ovOlfuvxa8CSQ9v41DT1rww2v966QEYnf6UEyYbVwVc,17579
 swarm/blueprints/codey/instructions.md,sha256=XMvJngQ23vl7xJQx-Sp5UIME2-JQyyxeZFFtIuOtTOI,1209
+swarm/blueprints/codey/metadata.json,sha256=wsW0jGIKZ-vzrMSMbOuYtVM8rr4joNIeJ0NBQAiHqu4,775
 swarm/blueprints/codey/session_logs/session_2025-04-19T01-15-31.md,sha256=IRzOdr9wisTQYOc0FZQi-4zlX_vickQrq900SNZ9dPU,270
 swarm/blueprints/codey/session_logs/session_2025-04-19T01-16-03.md,sha256=2GQcj850IZMz3Fqvet3dynXuTom4ZT7VwoxwWMhgTH8,270
 swarm/blueprints/common/operation_box_utils.py,sha256=YYntqT6p44r7hxq5GLOS0gyOuInmhvWo1hp6-qKk36Q,3087
@@ -298,8 +299,8 @@ swarm/views/message_views.py,sha256=sDUnXyqKXC8WwIIMAlWf00s2_a2T9c75Na5FvYMJwBM,
 swarm/views/model_views.py,sha256=aAbU4AZmrOTaPeKMWtoKK7FPYHdaN3Zbx55JfKzYTRY,2937
 swarm/views/utils.py,sha256=8Usc0g0L0NPegNAyY20tJBNBy-JLwODf4VmxV0yUtpw,3627
 swarm/views/web_views.py,sha256=T1CKe-Nyv1C8aDt6QFTGWo_dkH7ojWAvS_QW9mZnZp0,7371
-open_swarm-0.1.1745274322.dist-info/METADATA,sha256=wb43VYjsD78i5jW9vba0ESlt0Cdh5k1OZusQ3bDHeoM,39330
-open_swarm-0.1.1745274322.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-open_swarm-0.1.1745274322.dist-info/entry_points.txt,sha256=fo28d0_zJrytRsh8QqkdlWQT_9lyAwYUx1WuSTDI3HM,177
-open_swarm-0.1.1745274322.dist-info/licenses/LICENSE,sha256=BU9bwRlnOt_JDIb6OT55Q4leLZx9RArDLTFnlDIrBEI,1062
-open_swarm-0.1.1745274322.dist-info/RECORD,,
+open_swarm-0.1.1745274459.dist-info/METADATA,sha256=LAmWU8maJObP1Ku7PcMovDBMQykoeKEA-Ly1nCFvmY0,39330
+open_swarm-0.1.1745274459.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+open_swarm-0.1.1745274459.dist-info/entry_points.txt,sha256=fo28d0_zJrytRsh8QqkdlWQT_9lyAwYUx1WuSTDI3HM,177
+open_swarm-0.1.1745274459.dist-info/licenses/LICENSE,sha256=BU9bwRlnOt_JDIb6OT55Q4leLZx9RArDLTFnlDIrBEI,1062
+open_swarm-0.1.1745274459.dist-info/RECORD,,

swarm/blueprints/codey/README.md

@@ -1,15 +1,52 @@
 # Codey Blueprint
 
-**Codey** is special because it presents advanced session management and code automation for developers using Open Swarm. It provides a seamless experience for managing code sessions, running code, and integrating with git and other developer tools.
+**Codey** is an agentic code and semantic search/analysis blueprint for Open Swarm, demonstrating agent-based orchestration, robust UX with ANSI/emoji output, spinner feedback, and resilient fallback for agent/LLM errors.
 
-## Special Feature
-- **Session Management & Code Automation:** Manage your coding sessions, automate repetitive tasks, and streamline your workflow with Codey.
+---
+
+## What This Blueprint Demonstrates
+- **Agent-based code and semantic search** (keyword and semantic)
+- **LLM fallback and error handling** with user-friendly messages
+- **Unified ANSI/emoji boxes** for search/analysis results, including summaries, counts, and parameters
+- **Custom spinner messages**: 'Generating.', 'Generating..', 'Generating...', 'Running...'
+- **Progress updates** for long-running operations (line numbers, result counts)
+- **Test mode** for robust, deterministic testing
+
+## Usage
+Run with the CLI:
+```sh
+swarm-cli run codey --instruction "/codesearch recursion . 5"
+```
+
+## Test
+```sh
+uv run pytest -v tests/blueprints/test_codey.py
+```
+
+## Compliance
+- Agentic: 
+- UX (ANSI/emoji): 
+- Spinner: 
+- Fallback: 
+- Test Coverage: 
+
+## Required Env Vars
+- `SWARM_TEST_MODE` (optional): Enables test mode for deterministic output.
+
+## Extending
+- See `blueprint_codey.py` for agent logic and UX hooks.
+- Extend agent capabilities or UX by modifying the `_run_non_interactive` method.
+
+---
+_Last updated: 2025-04-21_
+
+# (Legacy content below)
 
 Codey is an agentic coding assistant blueprint for Open Swarm, inspired by OpenAI Codex CLI. It orchestrates specialized agents and tools to automate and assist with software engineering tasks, especially those involving code, git, and project workflows.
 
 ---
 
-## ✅ Features Implemented
+## Features Implemented
 
 - **Global Instructions**: Reads and injects `~/.codey/instructions.md` as a base prompt for orchestration/coordinator agent.
 - **Agent Delegation**: Supports delegating tasks to specialized sub-agents (e.g., GitHub agent, code review agent).
@@ -19,111 +56,46 @@ Codey is an agentic coding assistant blueprint for Open Swarm, inspired by OpenA
 - **Rich Syntax Highlighting**: Code fences in assistant responses are colorized via Rich.
 - **Slash Commands**: Built-in `/help`, `/compact`, `/model`, `/approval`, `/history`, `/clear`, and `/clearhistory` available.
 - **Testable via CLI**: Supports test-driven development and CLI-based interaction.
-- **Project-Level Instructions**: Automatically loaded and injected from `CODEY.md` if present in the project. No manual step required.
-- **Interactive/Approval Mode**: Supports interactive prompts for git operations in suggest mode.
-- **Unified Rich Output Formatting**: Unified and enhanced rich output formatting (boxes, emojis, result summaries).
-- **Custom Spinner/Progress Messages**: Custom spinner/progress messages for better UX.
-- **Persistent Session Logging/Audit Trail**: Persistent log of actions, plans, or outputs.
-- **Full-Context Mode**: Full-context mode for large refactor/analysis.
-- **Writable Root/Sandboxing CLI/Config Support**: Writable root/sandboxing CLI/config support.
-- **Command Suggestions/Typeahead/Autocomplete**: Command suggestions/typeahead/autocomplete (CLI and slash commands).
-- **Session/History Management and Overlays**: Session/history management and overlays.
-- **Model Selection Overlay and CLI/Agent-Specific Support**: Model selection overlay and CLI/agent-specific support.
-- **Help and Onboarding Overlays**: Help and onboarding overlays.
-- **Desktop Notification Support**: Desktop notification support (optional).
-- **Dangerous Auto-Approve Flag/UX**: Dangerous auto-approve flag/UX.
-- **Output Formatting/Full Stdout Option**: Output formatting/full stdout option.
-- **Image Input**: Image input (CLI/UX, future-proof).
 
 ---
 
-## ⚠️ Features Partially Implemented
+## Features Partially Implemented
 
+- **Project-Level Instructions**: Can be injected manually (e.g., `CODEY.md`), but not auto-loaded.
 - **File/Directory Context Awareness**: File tools exist, but no automatic context file loading or project scanning.
 - **Rich Output Formatting**: Some ANSI/emoji UX, but not unified or as rich as Codex.
-- **User Feedback Loop**: No mechanism for user feedback/corrections mid-session.
+- **Interactive/Approval Mode**: Basic CLI flag (`--approval-mode`) supports interactive prompts for git operations in suggest mode.
 
 ---
 
-## ❌ Features Not Yet Implemented
+## Features Not Yet Implemented
 
 - **Automatic Plan/Changelog Updates**: Agent does not maintain `.codey/plan_*.md` or changelogs automatically.
 - **Automatic Context Injection**: Agent does not scan/include relevant files automatically in prompts.
+- **User Feedback Loop**: No mechanism for user feedback/corrections mid-session.
+- **Session Logging/Audit Trail**: No persistent log of actions, plans, or outputs.
 
 ---
 
-## Codex CLI Feature Parity Checklist
-
-This blueprint aims to match all core and advanced features of the OpenAI Codex CLI. Below is the current status:
-
-### ✅ Already Implemented
-- Rich output/emoji/spinner UX (unified for search, analysis, file ops)
-- Modular agent/blueprint system
-- Interactive CLI mode (basic)
-- Approval mode for git ops and some agent actions
-- Syntax-highlighted code output
-- Project-level instruction auto-loading (e.g., CODEY.md)
-- Slash commands: `/help`, `/compact`, `/model`, `/approval`, `/history`, `/clear`, `/clearhistory` (basic)
-- Persistent session logging/audit trail
-- Full-context mode for large refactor/analysis
-- Writable root/sandboxing CLI/config support
-- Command suggestions/typeahead/autocomplete (CLI and slash commands)
-- Session/history management and overlays
-- Model selection overlay and CLI/agent-specific support
-- 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 agent/file/code 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)
-
-### ❌ Not Yet Implemented
-- Auto dependency install for generated code
-- Automatic context/project file injection
-- Plan/changelog file maintenance
-- User feedback/correction loop
-- 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
-
----
-
-### Implementation Roadmap
-- [ ] Approval modes for all agent/file/code actions
-- [ ] Directory/network sandboxing for all agent execution
-- [ ] Auto dependency install for generated code
-- [ ] Automatic context injection for prompts
-- [ ] Plan/changelog file maintenance
-- [ ] User feedback/correction loop
-- [ ] Streaming CLI output
-- [ ] Non-interactive/CI/headless mode
-- [ ] Multimodal input support
-- [ ] Atomic commit/rollback for all agent actions
-- [ ] Safety/ZDR org restrictions
-
----
+## Onboarding Tips
 
-**See the root README for framework-wide feature status.**
+- Try `/codesearch <keyword> <path> <max_results>` (e.g. `/codesearch recursion . 5`)
+- Try `/semanticsearch <keyword>` for semantic code search with rich result boxes, result counts, and spinner
+- Use `/help` for slash commands, `/model` to switch models, `/approval` for approval mode
+- Use arrow keys for history, Ctrl+C to quit, Esc to interrupt
+- See the main README for advanced onboarding and blueprint discovery
 
 ---
 
 ## TODO
 
 - [x] Implement interactive/approval mode for agent actions
-- [x] Unify and enhance rich output formatting (boxes, emojis, result summaries)
-- [x] Add custom spinner/progress messages
-- [x] Enable automatic plan/changelog file updates
-- [x] Add project-level instruction auto-loading (e.g., `CODEY.md`)
+- [ ] Enable automatic plan/changelog file updates
+- [ ] Add project-level instruction auto-loading (e.g., `CODEY.md`)
 - [ ] Improve file/directory context awareness and context injection
+- [ ] Unify and enhance rich output formatting (boxes, emojis, result summaries)
 - [ ] Add user feedback/correction loop
-- [x] Add persistent session logging/audit trail
+- [ ] Add persistent session logging/audit trail
 - [ ] Implement summarization logic for `/compact` slash command
 - [ ] Implement model switching for `/model` slash command
 - [ ] Implement approval toggle for `/approval` slash command