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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (27) hide show
  1. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/PKG-INFO +32 -7
  2. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/README.md +31 -6
  3. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/pyproject.toml +1 -1
  4. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/pyproject.toml.orig +1 -1
  5. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/LICENSE +0 -0
  6. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/__init__.py +0 -0
  7. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/assets/event.v1.json +0 -0
  8. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/assets/opencode/grokbot-kit.ts +0 -0
  9. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/cli.py +0 -0
  10. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/config.py +0 -0
  11. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/deliver.py +0 -0
  12. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/doctor.py +0 -0
  13. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/emit.py +0 -0
  14. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/gc.py +0 -0
  15. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/launch.py +0 -0
  16. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/login.py +0 -0
  17. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/models.py +0 -0
  18. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/opencode_plugin.py +0 -0
  19. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/payload.py +0 -0
  20. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/redeliver.py +0 -0
  21. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/resolve.py +0 -0
  22. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/route.py +0 -0
  23. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/run.py +0 -0
  24. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/secret.py +0 -0
  25. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/setup.py +0 -0
  26. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/sinks.py +0 -0
  27. {grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/src/grokbot_kit/terminal.py +0 -0
{grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: grokbot-kit
3
- Version: 0.2.0
3
+ Version: 0.2.1
4
4
  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.
5
5
  Author: Rodrigo Pasini
6
6
  License-Expression: MIT
@@ -58,20 +58,45 @@ CLIs and their login, the default CLI, the model tiers and the routine that the
58
58
 
59
59
  ```text
60
60
  Install the grokbot-kit skill and set up grokbot-kit on this box:
61
- 1. Download https://raw.githubusercontent.com/rodrigo-pasini/grokbot-kit/v0.2.0/skills/grokbot-kit/SKILL.md
61
+ 1. Download https://github.com/rodrigo-pasini/grokbot-kit/releases/latest/download/SKILL.md (follow redirects)
62
62
  to /home/box/agent-data/workflows/grokbot-kit/SKILL.md (create the directory).
63
63
  2. Read that skill and follow its "Setup (primeira vez)" section from start to finish, one step at a time,
64
64
  skipping what `grokbot-kit doctor --json` shows as already done. Use "mybot" as the name of this bot.
65
- 3. Never ask me for a secret (API key, routine URL or key) in the chat: tell me the `grokbot-kit secret set`
66
- command and I run it in a terminal on the box.
65
+ 3. Never ask me for a secret (API key, routine URL or key) in the chat: read it yourself from the routine
66
+ or ask me in a masked secret field, and pass it to `grokbot-kit secret set` on standard input.
67
67
  4. At the end, run `grokbot-kit doctor --json` and summarise the result and any problems.
68
68
  ```
69
69
 
70
- The skill asks you to create the routine in the Grok Bot panel, with a webhook trigger and the routine prompt it
71
- gives you. Copy the routine URL and key from the panel only into the box terminal, never into the chat or a
72
- screenshot. When the setup ends, ask for a small task, such as "rename the variables in x.py": the bot picks the
70
+ The bot creates the routine, with a webhook trigger and the routine prompt from the skill, or asks you to create it
71
+ in the Grok Bot panel. It reads the routine URL and key itself or asks for each one in a masked secret field, never
72
+ 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
73
73
  `trivial` tier and tells you so, and the result arrives through the routine.
74
74
 
75
+ <details>
76
+ <summary>Screenshots of a setup and a task (Grok Bot, in Portuguese)</summary>
77
+
78
+ **1. The message and the choice of CLIs**
79
+
80
+ ![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)
81
+
82
+ **2. opencode installed, free models without login**
83
+
84
+ ![2. opencode installed, free models without login](https://raw.githubusercontent.com/rodrigo-pasini/grokbot-kit/main/docs/images/quickstart/02-login.png)
85
+
86
+ **3. Model tiers and the routine created by the bot**
87
+
88
+ ![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)
89
+
90
+ **4. Routine URL and key through the masked secret field**
91
+
92
+ ![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)
93
+
94
+ **5. A task delegated to opencode, with the result back through the routine**
95
+
96
+ ![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)
97
+
98
+ </details>
99
+
75
100
  ### By hand
76
101
 
77
102
  ```sh
{grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/README.md RENAMED
@@ -41,20 +41,45 @@ CLIs and their login, the default CLI, the model tiers and the routine that the
41
41
 
42
42
  ```text
43
43
  Install the grokbot-kit skill and set up grokbot-kit on this box:
44
- 1. Download https://raw.githubusercontent.com/rodrigo-pasini/grokbot-kit/v0.2.0/skills/grokbot-kit/SKILL.md
44
+ 1. Download https://github.com/rodrigo-pasini/grokbot-kit/releases/latest/download/SKILL.md (follow redirects)
45
45
  to /home/box/agent-data/workflows/grokbot-kit/SKILL.md (create the directory).
46
46
  2. Read that skill and follow its "Setup (primeira vez)" section from start to finish, one step at a time,
47
47
  skipping what `grokbot-kit doctor --json` shows as already done. Use "mybot" as the name of this bot.
48
- 3. Never ask me for a secret (API key, routine URL or key) in the chat: tell me the `grokbot-kit secret set`
49
- command and I run it in a terminal on the box.
48
+ 3. Never ask me for a secret (API key, routine URL or key) in the chat: read it yourself from the routine
49
+ or ask me in a masked secret field, and pass it to `grokbot-kit secret set` on standard input.
50
50
  4. At the end, run `grokbot-kit doctor --json` and summarise the result and any problems.
51
51
  ```
52
52
 
53
- The skill asks you to create the routine in the Grok Bot panel, with a webhook trigger and the routine prompt it
54
- gives you. Copy the routine URL and key from the panel only into the box terminal, never into the chat or a
55
- screenshot. When the setup ends, ask for a small task, such as "rename the variables in x.py": the bot picks the
53
+ The bot creates the routine, with a webhook trigger and the routine prompt from the skill, or asks you to create it
54
+ in the Grok Bot panel. It reads the routine URL and key itself or asks for each one in a masked secret field, never
55
+ 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
56
56
  `trivial` tier and tells you so, and the result arrives through the routine.
57
57
 
58
+ <details>
59
+ <summary>Screenshots of a setup and a task (Grok Bot, in Portuguese)</summary>
60
+
61
+ **1. The message and the choice of CLIs**
62
+
63
+ ![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)
64
+
65
+ **2. opencode installed, free models without login**
66
+
67
+ ![2. opencode installed, free models without login](https://raw.githubusercontent.com/rodrigo-pasini/grokbot-kit/main/docs/images/quickstart/02-login.png)
68
+
69
+ **3. Model tiers and the routine created by the bot**
70
+
71
+ ![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)
72
+
73
+ **4. Routine URL and key through the masked secret field**
74
+
75
+ ![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)
76
+
77
+ **5. A task delegated to opencode, with the result back through the routine**
78
+
79
+ ![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)
80
+
81
+ </details>
82
+
58
83
  ### By hand
59
84
 
60
85
  ```sh
{grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/pyproject.toml RENAMED
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "grokbot-kit"
3
- version = "0.2.0"
3
+ version = "0.2.1"
4
4
  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."
5
5
  readme = "README.md"
6
6
  license = "MIT"
{grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/pyproject.toml.orig RENAMED
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "grokbot-kit"
3
- version = "0.2.0"
3
+ version = "0.2.1"
4
4
  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."
5
5
  readme = "README.md"
6
6
  license = "MIT"
{grokbot_kit-0.2.0 → grokbot_kit-0.2.1}/LICENSE RENAMED
File without changes