grokbot-kit 0.2.0__tar.gz → 0.2.2__tar.gz

{grokbot_kit-0.2.0 → grokbot_kit-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: grokbot-kit
-Version: 0.2.0
+Version: 0.2.2
 Summary: Grok Bot integration kit: delegate tasks to headless coding agents (opencode, Claude Code, Codex) and wake the right Grok Bot routine when they finish or need input.
 Author: Rodrigo Pasini
 License-Expression: MIT
@@ -58,20 +58,45 @@ CLIs and their login, the default CLI, the model tiers and the routine that the
 
 ```text
 Install the grokbot-kit skill and set up grokbot-kit on this box:
-1. Download https://raw.githubusercontent.com/rodrigo-pasini/grokbot-kit/v0.2.0/skills/grokbot-kit/SKILL.md
+1. Download https://github.com/rodrigo-pasini/grokbot-kit/releases/latest/download/SKILL.md (follow redirects)
    to /home/box/agent-data/workflows/grokbot-kit/SKILL.md (create the directory).
 2. Read that skill and follow its "Setup (primeira vez)" section from start to finish, one step at a time,
    skipping what `grokbot-kit doctor --json` shows as already done. Use "mybot" as the name of this bot.
-3. Never ask me for a secret (API key, routine URL or key) in the chat: tell me the `grokbot-kit secret set`
-   command and I run it in a terminal on the box.
+3. Never ask me for a secret (API key, routine URL or key) in the chat: read it yourself from the routine
+   or ask me in a masked secret field, and pass it to `grokbot-kit secret set` on standard input.
 4. At the end, run `grokbot-kit doctor --json` and summarise the result and any problems.
 ```
 
-The skill asks you to create the routine in the Grok Bot panel, with a webhook trigger and the routine prompt it
-gives you. Copy the routine URL and key from the panel only into the box terminal, never into the chat or a
-screenshot. When the setup ends, ask for a small task, such as "rename the variables in x.py": the bot picks the
+The bot creates the routine, with a webhook trigger and the routine prompt from the skill, or asks you to create it
+in the Grok Bot panel. It reads the routine URL and key itself or asks for each one in a masked secret field, never
+in the chat or a screenshot. When the setup ends, ask for a small task, such as "rename the variables in x.py": the bot picks the
 `trivial` tier and tells you so, and the result arrives through the routine.
 
+<details>
+<summary>Screenshots of a setup and a task (Grok Bot, in Portuguese)</summary>
+
+**1. The message and the choice of CLIs**
+
+![1. The message and the choice of CLIs](https://raw.githubusercontent.com/rodrigo-pasini/grokbot-kit/main/docs/images/quickstart/01-pedido-e-clis.png)
+
+**2. opencode installed, free models without login**
+
+![2. opencode installed, free models without login](https://raw.githubusercontent.com/rodrigo-pasini/grokbot-kit/main/docs/images/quickstart/02-login.png)
+
+**3. Model tiers and the routine created by the bot**
+
+![3. Model tiers and the routine created by the bot](https://raw.githubusercontent.com/rodrigo-pasini/grokbot-kit/main/docs/images/quickstart/03-tiers-e-routine.png)
+
+**4. Routine URL and key through the masked secret field**
+
+![4. Routine URL and key through the masked secret field](https://raw.githubusercontent.com/rodrigo-pasini/grokbot-kit/main/docs/images/quickstart/04-segredos.png)
+
+**5. A task delegated to opencode, with the result back through the routine**
+
+![5. A task delegated to opencode, with the result back through the routine](https://raw.githubusercontent.com/rodrigo-pasini/grokbot-kit/main/docs/images/quickstart/05-tarefa.png)
+
+</details>
+
 ### By hand
 
 ```sh

{grokbot_kit-0.2.0 → grokbot_kit-0.2.2}/README.md

@@ -41,20 +41,45 @@ CLIs and their login, the default CLI, the model tiers and the routine that the
 
 ```text
 Install the grokbot-kit skill and set up grokbot-kit on this box:
-1. Download https://raw.githubusercontent.com/rodrigo-pasini/grokbot-kit/v0.2.0/skills/grokbot-kit/SKILL.md
+1. Download https://github.com/rodrigo-pasini/grokbot-kit/releases/latest/download/SKILL.md (follow redirects)
    to /home/box/agent-data/workflows/grokbot-kit/SKILL.md (create the directory).
 2. Read that skill and follow its "Setup (primeira vez)" section from start to finish, one step at a time,
    skipping what `grokbot-kit doctor --json` shows as already done. Use "mybot" as the name of this bot.
-3. Never ask me for a secret (API key, routine URL or key) in the chat: tell me the `grokbot-kit secret set`
-   command and I run it in a terminal on the box.
+3. Never ask me for a secret (API key, routine URL or key) in the chat: read it yourself from the routine
+   or ask me in a masked secret field, and pass it to `grokbot-kit secret set` on standard input.
 4. At the end, run `grokbot-kit doctor --json` and summarise the result and any problems.
 ```
 
-The skill asks you to create the routine in the Grok Bot panel, with a webhook trigger and the routine prompt it
-gives you. Copy the routine URL and key from the panel only into the box terminal, never into the chat or a
-screenshot. When the setup ends, ask for a small task, such as "rename the variables in x.py": the bot picks the
+The bot creates the routine, with a webhook trigger and the routine prompt from the skill, or asks you to create it
+in the Grok Bot panel. It reads the routine URL and key itself or asks for each one in a masked secret field, never
+in the chat or a screenshot. When the setup ends, ask for a small task, such as "rename the variables in x.py": the bot picks the
 `trivial` tier and tells you so, and the result arrives through the routine.
 
+<details>
+<summary>Screenshots of a setup and a task (Grok Bot, in Portuguese)</summary>
+
+**1. The message and the choice of CLIs**
+
+![1. The message and the choice of CLIs](https://raw.githubusercontent.com/rodrigo-pasini/grokbot-kit/main/docs/images/quickstart/01-pedido-e-clis.png)
+
+**2. opencode installed, free models without login**
+
+![2. opencode installed, free models without login](https://raw.githubusercontent.com/rodrigo-pasini/grokbot-kit/main/docs/images/quickstart/02-login.png)
+
+**3. Model tiers and the routine created by the bot**
+
+![3. Model tiers and the routine created by the bot](https://raw.githubusercontent.com/rodrigo-pasini/grokbot-kit/main/docs/images/quickstart/03-tiers-e-routine.png)
+
+**4. Routine URL and key through the masked secret field**
+
+![4. Routine URL and key through the masked secret field](https://raw.githubusercontent.com/rodrigo-pasini/grokbot-kit/main/docs/images/quickstart/04-segredos.png)
+
+**5. A task delegated to opencode, with the result back through the routine**
+
+![5. A task delegated to opencode, with the result back through the routine](https://raw.githubusercontent.com/rodrigo-pasini/grokbot-kit/main/docs/images/quickstart/05-tarefa.png)
+
+</details>
+
 ### By hand
 
 ```sh

{grokbot_kit-0.2.0 → grokbot_kit-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "grokbot-kit"
-version = "0.2.0"
+version = "0.2.2"
 description = "Grok Bot integration kit: delegate tasks to headless coding agents (opencode, Claude Code, Codex) and wake the right Grok Bot routine when they finish or need input."
 readme = "README.md"
 license = "MIT"

{grokbot_kit-0.2.0 → grokbot_kit-0.2.2}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "grokbot-kit"
-version = "0.2.0"
+version = "0.2.2"
 description = "Grok Bot integration kit: delegate tasks to headless coding agents (opencode, Claude Code, Codex) and wake the right Grok Bot routine when they finish or need input."
 readme = "README.md"
 license = "MIT"

{grokbot_kit-0.2.0 → grokbot_kit-0.2.2}/src/grokbot_kit/doctor.py

@@ -8,10 +8,11 @@ import subprocess
 import sys
 from typing import Any
 
-from grokbot_kit import config
+from grokbot_kit import config, launch, opencode_plugin
 from grokbot_kit.launch import TOOLS
 
 TIERS = ("trivial", "standard", "complex")
+PLUGIN_EXE_PREFIX = "const GROKBOT_KIT = "
 STATUS_ARGV = {"claude": ["auth", "status"], "codex": ["login", "status"], "opencode": ["auth", "list"]}
 COMMAND_TIMEOUT = 60
 SECRET_KEYS = ("url_secret", "key_secret", "token_secret", "webhook_secret")
@@ -41,6 +42,21 @@ def _opencode_logged_in(proc: subprocess.CompletedProcess[str]) -> bool:
     return False
 
 
+def _plugin() -> dict[str, Any]:
+    """O plugin global do opencode e o executável que ele chama (door 24)."""
+    path = opencode_plugin.plugin_path()
+    exe = None
+    try:
+        for line in path.read_text(encoding="utf-8").splitlines():
+            if line.startswith(PLUGIN_EXE_PREFIX):
+                value = json.loads(line.removeprefix(PLUGIN_EXE_PREFIX))
+                exe = value if isinstance(value, str) else None
+                break
+    except (OSError, ValueError):
+        exe = None
+    return {"path": str(path), "exe": exe, "ok": exe == launch.kit_executable()}
+
+
 def _cli(tool: str, cli: dict[str, Any], default: str | None) -> dict[str, Any]:
     bin_path = os.path.expanduser(str(cli.get("bin", tool)))
     method = "api-key" if tool == "claude" and "api_key_secret" in cli else "subscription"
@@ -58,13 +74,16 @@ def _cli(tool: str, cli: dict[str, Any], default: str | None) -> dict[str, Any]:
     else:
         logged_in = status.returncode == 0
     tiers = cli.get("tiers", {})
-    return {
+    entry = {
         "bin": bin_path,
         "version": (version.stdout.strip().splitlines() or [""])[0] if version and version.returncode == 0 else None,
         "default": tool == default,
         "login": {"command": " ".join([tool, *STATUS_ARGV[tool]]), "method": method, "logged_in": logged_in},
         "tiers": {tier: len(tiers.get(tier, [])) for tier in TIERS},
     }
+    if tool == "opencode":
+        entry["plugin"] = _plugin()
+    return entry
 
 
 def problems(out: dict[str, Any], facts: dict[str, Any]) -> list[str]:
@@ -85,6 +104,14 @@ def problems(out: dict[str, Any], facts: dict[str, Any]) -> list[str]:
             found.append(f"{cli['login']['command']} failed")
         elif not logged_in and tool != "opencode":
             found.append(f"{tool} is not logged in; run: grokbot-kit login {tool}")
+        plugin = cli.get("plugin")
+        if plugin and plugin["exe"] is None:
+            found.append(f"opencode plugin not found at {plugin['path']}; run: grokbot-kit install opencode")
+        elif plugin and not plugin["ok"]:
+            found.append(
+                f"opencode plugin at {plugin['path']} calls {plugin['exe']}, not {launch.kit_executable()}; "
+                "run: grokbot-kit install opencode"
+            )
     mode = facts.get("secrets_dir_mode")
     if mode is not None and mode != 0o700:
         found.append(
@@ -145,6 +172,10 @@ def _text(out: dict[str, Any]) -> str:
         default = " (default)" if cli["default"] else ""
         lines.append(f"{tool}{default}: {cli['version'] or 'version unknown'} at {cli['bin']}")
         lines.append(f"  login: {state} ({login['method']}, {login['command']}); tiers: {tiers}")
+        if "plugin" in cli:
+            plugin = cli["plugin"]
+            plugin_state = "missing" if plugin["exe"] is None else "ok" if plugin["ok"] else "stale"
+            lines.append(f"  plugin: {plugin_state} ({plugin['path']})")
     for target, sinks in out["routes"].items():
         lines.append(f"route {target}: {', '.join(sinks)}")
     for name, secret in out["secrets"].items():