@khaentertainment/grok-swarm 1.3.3 → 1.3.5

package/README.md

@@ -113,8 +113,9 @@ npm install -g @khaentertainment/grok-swarm
 /plugin install grok-swarm@khaentertainment
 ```
 
-Then run `/grok-swarm:setup` inside Claude Code — an OAuth browser flow will
-authorize your OpenRouter account without exposing your API key in-context.
+Then run `/grok-swarm` or `/grok-swarm-setup` inside Claude Code. That bootstraps
+the plugin-local runtime, registers the Grok MCP server, and launches OAuth if
+your OpenRouter key is not configured yet.
 
 ### Option 3: ClawHub (OpenClaw)
 
@@ -146,10 +147,10 @@ For detailed instructions for each method, see [INSTALL.md](INSTALL.md).
 ### For Claude Code
 
 ```
-/grok-swarm:analyze Review the security of my auth module
-/grok-swarm:refactor Convert these callbacks to async/await
-/grok-swarm:code Write a FastAPI endpoint for user registration
-/grok-swarm:reason Compare microservices vs monolith for this project
+/grok-swarm-analyze Review the security of my auth module
+/grok-swarm-refactor Convert these callbacks to async/await
+/grok-swarm-code Write a FastAPI endpoint for user registration
+/grok-swarm-reason Compare microservices vs monolith for this project
 ```
 
 ### For OpenClaw
@@ -177,10 +178,10 @@ const result = await tools.grok_swarm({
 ### Claude Code
 
 ```
-/grok-swarm:analyze Review the security of my auth module
-/grok-swarm:refactor Convert this to async/await
-/grok-swarm:code Write a FastAPI user registration endpoint
-/grok-swarm:reason Compare these two architectural approaches
+/grok-swarm-analyze Review the security of my auth module
+/grok-swarm-refactor Convert this to async/await
+/grok-swarm-code Write a FastAPI user registration endpoint
+/grok-swarm-reason Compare these two architectural approaches
 ```
 
 ### OpenClaw
@@ -244,9 +245,10 @@ unset OPENROUTER_API_KEY
 
 ## Release Note
 
-`1.3.3` is the first npm release after the failed `1.3.0`-`1.3.2` publish attempts.
-If you previously installed `1.0.0`, upgrade directly to `1.3.3` to get the MCP server,
-OAuth helper, autonomous agent runtime, and the rest of the Claude/OpenClaw stabilization fixes.
+`1.3.4` fixes the Claude command surface after `1.3.3`.
+If you previously installed `1.3.3`, upgrade to `1.3.4` to get searchable
+`/grok-swarm-*` commands plus first-use bootstrap that repairs missing MCP
+registration from inside Claude Code itself.
 
 ## Morph LLM Integration
 

package/dist/README.md

@@ -113,8 +113,9 @@ npm install -g @khaentertainment/grok-swarm
 /plugin install grok-swarm@khaentertainment
 ```
 
-Then run `/grok-swarm:setup` inside Claude Code — an OAuth browser flow will
-authorize your OpenRouter account without exposing your API key in-context.
+Then run `/grok-swarm` or `/grok-swarm-setup` inside Claude Code. That bootstraps
+the plugin-local runtime, registers the Grok MCP server, and launches OAuth if
+your OpenRouter key is not configured yet.
 
 ### Option 3: ClawHub (OpenClaw)
 
@@ -146,10 +147,10 @@ For detailed instructions for each method, see [INSTALL.md](INSTALL.md).
 ### For Claude Code
 
 ```
-/grok-swarm:analyze Review the security of my auth module
-/grok-swarm:refactor Convert these callbacks to async/await
-/grok-swarm:code Write a FastAPI endpoint for user registration
-/grok-swarm:reason Compare microservices vs monolith for this project
+/grok-swarm-analyze Review the security of my auth module
+/grok-swarm-refactor Convert these callbacks to async/await
+/grok-swarm-code Write a FastAPI endpoint for user registration
+/grok-swarm-reason Compare microservices vs monolith for this project
 ```
 
 ### For OpenClaw
@@ -177,10 +178,10 @@ const result = await tools.grok_swarm({
 ### Claude Code
 
 ```
-/grok-swarm:analyze Review the security of my auth module
-/grok-swarm:refactor Convert this to async/await
-/grok-swarm:code Write a FastAPI user registration endpoint
-/grok-swarm:reason Compare these two architectural approaches
+/grok-swarm-analyze Review the security of my auth module
+/grok-swarm-refactor Convert this to async/await
+/grok-swarm-code Write a FastAPI user registration endpoint
+/grok-swarm-reason Compare these two architectural approaches
 ```
 
 ### OpenClaw
@@ -244,9 +245,10 @@ unset OPENROUTER_API_KEY
 
 ## Release Note
 
-`1.3.3` is the first npm release after the failed `1.3.0`-`1.3.2` publish attempts.
-If you previously installed `1.0.0`, upgrade directly to `1.3.3` to get the MCP server,
-OAuth helper, autonomous agent runtime, and the rest of the Claude/OpenClaw stabilization fixes.
+`1.3.4` fixes the Claude command surface after `1.3.3`.
+If you previously installed `1.3.3`, upgrade to `1.3.4` to get searchable
+`/grok-swarm-*` commands plus first-use bootstrap that repairs missing MCP
+registration from inside Claude Code itself.
 
 ## Morph LLM Integration
 

package/dist/VERSION

@@ -1 +1 @@
-1.3.3
+1.3.5

package/dist/grok_bridge.py

@@ -28,7 +28,7 @@ try:
 except ImportError:
     print(
         "ERROR: openai package required for this Grok Swarm runtime. "
-        "Install from src/requirements.txt or run /grok-swarm:setup to bootstrap the plugin-local environment.",
+        "Install from src/requirements.txt or run /grok-swarm-setup to bootstrap the plugin-local environment.",
         file=sys.stderr,
     )
     sys.exit(1)
@@ -330,7 +330,7 @@ def _get_client(api_key=None, timeout=120):
             "No OpenRouter API key found. "
             "Tried: OPENROUTER_API_KEY env, ~/.config/grok-swarm/config.json, "
             "~/.claude/grok-swarm.local.md, OpenClaw auth profiles. "
-            "Run: python3 src/bridge/oauth_setup.py  or  /grok-swarm:setup"
+            "Run: python3 src/bridge/oauth_setup.py  or  /grok-swarm-setup"
         )
     return OpenAI(base_url=OPENROUTER_BASE, api_key=key, timeout=timeout)
 
@@ -403,7 +403,7 @@ def call_grok(prompt, mode="reason", context="", system_override=None, tools=Non
         print("  2. ~/.config/grok-swarm/config.json", file=sys.stderr)
         print("  3. ~/.claude/grok-swarm.local.md", file=sys.stderr)
         print("  4. OpenClaw auth profiles (~/.openclaw/)", file=sys.stderr)
-        print("Run: python3 src/bridge/oauth_setup.py   or   /grok-swarm:setup", file=sys.stderr)
+        print("Run: python3 src/bridge/oauth_setup.py   or   /grok-swarm-setup", file=sys.stderr)
         sys.exit(1)
 
     # Resolve system prompt

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@khaentertainment/grok-swarm",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "description": "Multi-agent intelligence powered by Grok 4.20 via OpenRouter. Give any AI coding agent access to a 4-agent swarm with ~2M token context.",
   "keywords": [
     "grok",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@khaentertainment/grok-swarm",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "description": "Multi-agent intelligence powered by Grok 4.20 via OpenRouter. Give any AI coding agent access to a 4-agent swarm with ~2M token context.",
   "keywords": [
     "grok",

package/src/bridge/grok_bridge.py

@@ -28,7 +28,7 @@ try:
 except ImportError:
     print(
         "ERROR: openai package required for this Grok Swarm runtime. "
-        "Install from src/requirements.txt or run /grok-swarm:setup to bootstrap the plugin-local environment.",
+        "Install from src/requirements.txt or run /grok-swarm-setup to bootstrap the plugin-local environment.",
         file=sys.stderr,
     )
     sys.exit(1)
@@ -330,7 +330,7 @@ def _get_client(api_key=None, timeout=120):
             "No OpenRouter API key found. "
             "Tried: OPENROUTER_API_KEY env, ~/.config/grok-swarm/config.json, "
             "~/.claude/grok-swarm.local.md, OpenClaw auth profiles. "
-            "Run: python3 src/bridge/oauth_setup.py  or  /grok-swarm:setup"
+            "Run: python3 src/bridge/oauth_setup.py  or  /grok-swarm-setup"
         )
     return OpenAI(base_url=OPENROUTER_BASE, api_key=key, timeout=timeout)
 
@@ -403,7 +403,7 @@ def call_grok(prompt, mode="reason", context="", system_override=None, tools=Non
         print("  2. ~/.config/grok-swarm/config.json", file=sys.stderr)
         print("  3. ~/.claude/grok-swarm.local.md", file=sys.stderr)
         print("  4. OpenClaw auth profiles (~/.openclaw/)", file=sys.stderr)
-        print("Run: python3 src/bridge/oauth_setup.py   or   /grok-swarm:setup", file=sys.stderr)
+        print("Run: python3 src/bridge/oauth_setup.py   or   /grok-swarm-setup", file=sys.stderr)
         sys.exit(1)
 
     # Resolve system prompt

package/src/mcp/grok_server.py

@@ -31,6 +31,7 @@ from bridge.grok_bridge import (
     get_api_key,
     read_files,
     strip_pgp_blocks,
+    parse_and_write_files,
     MODE_PROMPTS,
     AGENT_COUNTS,
 )
@@ -57,13 +58,28 @@ log = logging.getLogger("grok-mcp")
 # ---------------------------------------------------------------------------
 
 SERVER_NAME = "grok-swarm"
-SERVER_VERSION = "1.3.3"
+SERVER_VERSION = "1.3.4"
 PROTOCOL_VERSION = "2024-11-05"
 
 # ---------------------------------------------------------------------------
 # Tool definitions (JSON Schema format for MCP, NOT OpenAI format)
 # ---------------------------------------------------------------------------
 
+# JSON Schema fragments parsed at import time so defaults use lowercase JSON
+# true/false rather than Python True/False literals.
+_WRITE_FILES_SCHEMA = json.loads(
+    '{"type": "boolean", "default": false, '
+    '"description": "Whether to parse and write code blocks from the response to disk."}'
+)
+_OUTPUT_DIR_SCHEMA = json.loads(
+    '{"type": "string", "default": "./grok-output/", '
+    '"description": "Output directory for write_files mode."}'
+)
+_BOOL_FALSE_SCHEMA = json.loads(
+    '{"type": "boolean", "default": false, '
+    '"description": "Whether to actually write changes (default: dry-run preview)."}'
+)
+
 TOOLS = [
     {
         "name": "grok_query",
@@ -105,6 +121,8 @@ TOOLS = [
                     "default": 120,
                     "description": "API timeout in seconds.",
                 },
+                "write_files": _WRITE_FILES_SCHEMA,
+                "output_dir": _OUTPUT_DIR_SCHEMA,
             },
             "required": ["prompt"],
         },
@@ -140,6 +158,16 @@ TOOLS = [
                     "items": {"type": "string"},
                     "description": "File paths to include as initial context.",
                 },
+                "write_files": {
+                    "type": "boolean",
+                    "default": False,
+                    "description": "Accepted for API consistency; applies only to grok_session_continue.",
+                },
+                "output_dir": {
+                    "type": "string",
+                    "default": "./grok-output/",
+                    "description": "Accepted for API consistency; applies only to grok_session_continue.",
+                },
             },
             "required": [],
         },
@@ -166,6 +194,8 @@ TOOLS = [
                     "items": {"type": "string"},
                     "description": "Additional file paths to add as context.",
                 },
+                "write_files": _WRITE_FILES_SCHEMA,
+                "output_dir": _OUTPUT_DIR_SCHEMA,
             },
             "required": ["session_id", "message"],
         },
@@ -189,11 +219,7 @@ TOOLS = [
                     "default": ".",
                     "description": "Target directory or file to operate on.",
                 },
-                "apply": {
-                    "type": "boolean",
-                    "default": False,
-                    "description": "Whether to actually write changes (default: dry-run preview).",
-                },
+                "apply": _BOOL_FALSE_SCHEMA,
                 "max_iterations": {
                     "type": "integer",
                     "default": 5,
@@ -222,6 +248,8 @@ def _handle_grok_query(params):
     system = params.get("system")
     thinking = params.get("thinking", "low")
     timeout = params.get("timeout", 120)
+    write_files = params.get("write_files", False)
+    output_dir = params.get("output_dir", "./grok-output/")
 
     if mode == "orchestrate" and not system:
         return _error_content("orchestrate mode requires the 'system' parameter")
@@ -255,7 +283,19 @@ def _handle_grok_query(params):
         return _error_content("Empty response from Grok API")
 
     content = response.choices[0].message.content or ""
-    return _text_content(strip_pgp_blocks(content))
+    cleaned = strip_pgp_blocks(content)
+
+    if write_files:
+        try:
+            written = parse_and_write_files(cleaned, output_dir)
+        except (OSError, IOError) as exc:
+            log.error("Failed to write files: %s", exc)
+            return _error_content(f"Failed to write files: {exc}")
+        if written:
+            paths = ", ".join(p for p, _ in written)
+            return _text_content(f"{len(written)} file(s) written to {output_dir}: {paths}")
+        # Fall back to printing the response text if no files were written
+    return _text_content(cleaned)
 
 
 def _handle_grok_session_start(params):
@@ -266,6 +306,8 @@ def _handle_grok_session_start(params):
     system = params.get("system")
     thinking = params.get("thinking", "low")
     files = params.get("files", [])
+    # write_files and output_dir params are accepted for API consistency
+    # but apply to grok_session_continue, not the session start itself
 
     # Read initial file context
     file_context = ""
@@ -296,6 +338,8 @@ def _handle_grok_session_continue(params):
     session_id = params["session_id"]
     message = params["message"]
     files = params.get("files", [])
+    write_files = params.get("write_files", False)
+    output_dir = params.get("output_dir", "./grok-output/")
 
     session = session_mod.get_session(session_id)
     if session is None:
@@ -312,7 +356,17 @@ def _handle_grok_session_continue(params):
         log.error("Session %s error: %s", session_id, exc)
         return _error_content(f"Grok API error: {exc}")
 
-    return _text_content(strip_pgp_blocks(response))
+    cleaned = strip_pgp_blocks(response)
+    if write_files:
+        try:
+            written = parse_and_write_files(cleaned, output_dir)
+        except (OSError, IOError) as exc:
+            log.error("Failed to write files to %s: %s", output_dir, exc)
+            return _error_content(f"Failed to write files: {exc}")
+        if written:
+            paths = ", ".join(p for p, _ in written)
+            return _text_content(f"{len(written)} file(s) written to {output_dir}: {paths}")
+    return _text_content(cleaned)
 
 
 def _handle_grok_agent(params):