@qqbrowser/openclaw-qbot 0.0.106 → 0.0.108

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 (101) hide show
  1. package/package.json +13 -13
  2. package/preset-config.json +2 -2
  3. package/skills/srt-sandbox/SKILL.md +39 -0
  4. package/extensions/acpx/skills/acp-router/SKILL.md +0 -219
  5. package/extensions/diffs/skills/diffs/SKILL.md +0 -22
  6. package/extensions/lobster/SKILL.md +0 -97
  7. package/extensions/open-prose/skills/prose/LICENSE +0 -21
  8. package/extensions/open-prose/skills/prose/SKILL.md +0 -323
  9. package/extensions/open-prose/skills/prose/alt-borges.md +0 -141
  10. package/extensions/open-prose/skills/prose/alts/arabian-nights.md +0 -358
  11. package/extensions/open-prose/skills/prose/alts/borges.md +0 -360
  12. package/extensions/open-prose/skills/prose/alts/folk.md +0 -322
  13. package/extensions/open-prose/skills/prose/alts/homer.md +0 -346
  14. package/extensions/open-prose/skills/prose/alts/kafka.md +0 -373
  15. package/extensions/open-prose/skills/prose/compiler.md +0 -2971
  16. package/extensions/open-prose/skills/prose/examples/01-hello-world.prose +0 -4
  17. package/extensions/open-prose/skills/prose/examples/02-research-and-summarize.prose +0 -6
  18. package/extensions/open-prose/skills/prose/examples/03-code-review.prose +0 -17
  19. package/extensions/open-prose/skills/prose/examples/04-write-and-refine.prose +0 -14
  20. package/extensions/open-prose/skills/prose/examples/05-debug-issue.prose +0 -20
  21. package/extensions/open-prose/skills/prose/examples/06-explain-codebase.prose +0 -17
  22. package/extensions/open-prose/skills/prose/examples/07-refactor.prose +0 -20
  23. package/extensions/open-prose/skills/prose/examples/08-blog-post.prose +0 -20
  24. package/extensions/open-prose/skills/prose/examples/09-research-with-agents.prose +0 -25
  25. package/extensions/open-prose/skills/prose/examples/10-code-review-agents.prose +0 -32
  26. package/extensions/open-prose/skills/prose/examples/11-skills-and-imports.prose +0 -27
  27. package/extensions/open-prose/skills/prose/examples/12-secure-agent-permissions.prose +0 -43
  28. package/extensions/open-prose/skills/prose/examples/13-variables-and-context.prose +0 -51
  29. package/extensions/open-prose/skills/prose/examples/14-composition-blocks.prose +0 -48
  30. package/extensions/open-prose/skills/prose/examples/15-inline-sequences.prose +0 -23
  31. package/extensions/open-prose/skills/prose/examples/16-parallel-reviews.prose +0 -19
  32. package/extensions/open-prose/skills/prose/examples/17-parallel-research.prose +0 -19
  33. package/extensions/open-prose/skills/prose/examples/18-mixed-parallel-sequential.prose +0 -36
  34. package/extensions/open-prose/skills/prose/examples/19-advanced-parallel.prose +0 -71
  35. package/extensions/open-prose/skills/prose/examples/20-fixed-loops.prose +0 -20
  36. package/extensions/open-prose/skills/prose/examples/21-pipeline-operations.prose +0 -35
  37. package/extensions/open-prose/skills/prose/examples/22-error-handling.prose +0 -51
  38. package/extensions/open-prose/skills/prose/examples/23-retry-with-backoff.prose +0 -63
  39. package/extensions/open-prose/skills/prose/examples/24-choice-blocks.prose +0 -86
  40. package/extensions/open-prose/skills/prose/examples/25-conditionals.prose +0 -114
  41. package/extensions/open-prose/skills/prose/examples/26-parameterized-blocks.prose +0 -100
  42. package/extensions/open-prose/skills/prose/examples/27-string-interpolation.prose +0 -105
  43. package/extensions/open-prose/skills/prose/examples/28-automated-pr-review.prose +0 -37
  44. package/extensions/open-prose/skills/prose/examples/28-gas-town.prose +0 -1572
  45. package/extensions/open-prose/skills/prose/examples/29-captains-chair.prose +0 -218
  46. package/extensions/open-prose/skills/prose/examples/30-captains-chair-simple.prose +0 -42
  47. package/extensions/open-prose/skills/prose/examples/31-captains-chair-with-memory.prose +0 -145
  48. package/extensions/open-prose/skills/prose/examples/33-pr-review-autofix.prose +0 -168
  49. package/extensions/open-prose/skills/prose/examples/34-content-pipeline.prose +0 -204
  50. package/extensions/open-prose/skills/prose/examples/35-feature-factory.prose +0 -296
  51. package/extensions/open-prose/skills/prose/examples/36-bug-hunter.prose +0 -237
  52. package/extensions/open-prose/skills/prose/examples/37-the-forge.prose +0 -1474
  53. package/extensions/open-prose/skills/prose/examples/38-skill-scan.prose +0 -455
  54. package/extensions/open-prose/skills/prose/examples/39-architect-by-simulation.prose +0 -277
  55. package/extensions/open-prose/skills/prose/examples/40-rlm-self-refine.prose +0 -32
  56. package/extensions/open-prose/skills/prose/examples/41-rlm-divide-conquer.prose +0 -38
  57. package/extensions/open-prose/skills/prose/examples/42-rlm-filter-recurse.prose +0 -46
  58. package/extensions/open-prose/skills/prose/examples/43-rlm-pairwise.prose +0 -50
  59. package/extensions/open-prose/skills/prose/examples/44-run-endpoint-ux-test.prose +0 -261
  60. package/extensions/open-prose/skills/prose/examples/45-plugin-release.prose +0 -159
  61. package/extensions/open-prose/skills/prose/examples/45-run-endpoint-ux-test-with-remediation.prose +0 -637
  62. package/extensions/open-prose/skills/prose/examples/46-run-endpoint-ux-test-fast.prose +0 -148
  63. package/extensions/open-prose/skills/prose/examples/46-workflow-crystallizer.prose +0 -225
  64. package/extensions/open-prose/skills/prose/examples/47-language-self-improvement.prose +0 -356
  65. package/extensions/open-prose/skills/prose/examples/48-habit-miner.prose +0 -445
  66. package/extensions/open-prose/skills/prose/examples/49-prose-run-retrospective.prose +0 -210
  67. package/extensions/open-prose/skills/prose/examples/README.md +0 -391
  68. package/extensions/open-prose/skills/prose/examples/roadmap/README.md +0 -22
  69. package/extensions/open-prose/skills/prose/examples/roadmap/iterative-refinement.prose +0 -20
  70. package/extensions/open-prose/skills/prose/examples/roadmap/parallel-review.prose +0 -18
  71. package/extensions/open-prose/skills/prose/examples/roadmap/simple-pipeline.prose +0 -17
  72. package/extensions/open-prose/skills/prose/examples/roadmap/syntax/open-prose-syntax.prose +0 -223
  73. package/extensions/open-prose/skills/prose/guidance/antipatterns.md +0 -951
  74. package/extensions/open-prose/skills/prose/guidance/patterns.md +0 -700
  75. package/extensions/open-prose/skills/prose/guidance/system-prompt.md +0 -180
  76. package/extensions/open-prose/skills/prose/help.md +0 -144
  77. package/extensions/open-prose/skills/prose/lib/README.md +0 -108
  78. package/extensions/open-prose/skills/prose/lib/calibrator.prose +0 -215
  79. package/extensions/open-prose/skills/prose/lib/cost-analyzer.prose +0 -174
  80. package/extensions/open-prose/skills/prose/lib/error-forensics.prose +0 -250
  81. package/extensions/open-prose/skills/prose/lib/inspector.prose +0 -196
  82. package/extensions/open-prose/skills/prose/lib/profiler.prose +0 -460
  83. package/extensions/open-prose/skills/prose/lib/program-improver.prose +0 -275
  84. package/extensions/open-prose/skills/prose/lib/project-memory.prose +0 -118
  85. package/extensions/open-prose/skills/prose/lib/user-memory.prose +0 -93
  86. package/extensions/open-prose/skills/prose/lib/vm-improver.prose +0 -243
  87. package/extensions/open-prose/skills/prose/primitives/session.md +0 -593
  88. package/extensions/open-prose/skills/prose/prose.md +0 -1237
  89. package/extensions/open-prose/skills/prose/state/filesystem.md +0 -498
  90. package/extensions/open-prose/skills/prose/state/in-context.md +0 -384
  91. package/extensions/open-prose/skills/prose/state/postgres.md +0 -880
  92. package/extensions/open-prose/skills/prose/state/sqlite.md +0 -574
  93. package/skills/model-usage/SKILL.md +0 -69
  94. package/skills/model-usage/references/codexbar-cli.md +0 -33
  95. package/skills/model-usage/scripts/model_usage.py +0 -320
  96. package/skills/model-usage/scripts/test_model_usage.py +0 -40
  97. package/skills/study-habits/SKILL.md +0 -72
  98. package/skills/study-habits/_meta.json +0 -6
  99. package/skills/xiaohongshu-mcp/SKILL.md +0 -95
  100. package/skills/xiaohongshu-mcp/_meta.json +0 -6
  101. package/skills/xiaohongshu-mcp/scripts/xhs_client.py +0 -264
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@qqbrowser/openclaw-qbot",
3
- "version": "0.0.106",
3
+ "version": "0.0.108",
4
4
  "description": "Multi-channel AI gateway with extensible messaging integrations",
5
5
  "keywords": [],
6
6
  "homepage": "https://github.com/openclaw/openclaw#readme",
@@ -434,6 +434,18 @@
434
434
  "typescript": "^5.9.3",
435
435
  "vitest": "^4.0.18"
436
436
  },
437
+ "peerDependencies": {
438
+ "node-llama-cpp": "3.16.2",
439
+ "playwright-core": "1.58.2"
440
+ },
441
+ "peerDependenciesMeta": {
442
+ "node-llama-cpp": {
443
+ "optional": true
444
+ },
445
+ "playwright-core": {
446
+ "optional": true
447
+ }
448
+ },
437
449
  "bundledDependencies": [
438
450
  "@agentclientprotocol/sdk",
439
451
  "@anthropic-ai/sandbox-runtime",
@@ -496,18 +508,6 @@
496
508
  "yaml",
497
509
  "zod"
498
510
  ],
499
- "peerDependencies": {
500
- "node-llama-cpp": "3.16.2",
501
- "playwright-core": "1.58.2"
502
- },
503
- "peerDependenciesMeta": {
504
- "node-llama-cpp": {
505
- "optional": true
506
- },
507
- "playwright-core": {
508
- "optional": true
509
- }
510
- },
511
511
  "engines": {
512
512
  "node": ">= 22.12.0"
513
513
  },
@@ -10,7 +10,7 @@
10
10
  {
11
11
  "id": "deepseek-v3.2",
12
12
  "name": "DeepSeek V3.2",
13
- "reasoning": true,
13
+ "reasoning": false,
14
14
  "input": ["text", "image"],
15
15
  "cost": {
16
16
  "input": 0,
@@ -87,7 +87,7 @@
87
87
  {
88
88
  "id": "DeepSeek-V3_2",
89
89
  "name": "DeepSeek-V3_2",
90
- "reasoning": true,
90
+ "reasoning": false,
91
91
  "input": ["text", "image"],
92
92
  "cost": {
93
93
  "input": 0,
@@ -0,0 +1,39 @@
1
+ ---
2
+ name: srt-sandbox
3
+ description: "SRT 沙箱运行环境认知。了解当前沙箱的文件系统、网络、安全边界,避免错误拒绝合法操作。"
4
+ disable-model-invocation: true
5
+ metadata: { "openclaw": { "always": true, "emoji": "🔒" } }
6
+ ---
7
+
8
+ # SRT 沙箱环境速查
9
+
10
+ 你运行在 SRT 沙箱中(macOS Seatbelt / Linux bwrap)。**先查本表再判断能不能做,不要凭猜测拒绝操作。**
11
+
12
+ ## 文件权限
13
+
14
+ **可写路径(allowWrite):**
15
+
16
+ - `.`(当前工作目录)
17
+ - `~/.qbotclaw`
18
+ - `/tmp`、`/private/tmp`、`/var/tmp`
19
+ - **`~/Desktop`、`~/Downloads`、`~/Pictures`** ← 用户常用目录,可写!
20
+
21
+ **禁读路径(denyRead):** `~/.ssh`、`~/.gnupg`、`~/.aws/credentials`
22
+
23
+ **禁写文件(denyWrite):** `.env`、`.env.local`、`.env.production`
24
+
25
+ ## 网络权限
26
+
27
+ 允许访问:`*.com *.org *.net *.io *.dev *.cn *.ai *.cc *.co *.me *.in *.app *.sh *.xyz *.info *.edu *.gov *.uk *.jp *.de`
28
+ → 几乎所有常见网站和 API 均可访问。
29
+
30
+ 本地端口绑定:✅ 允许(可启动 dev server)
31
+
32
+ ## 决策规则
33
+
34
+ 1. 目标路径在 allowWrite 内 + 文件名不在 denyWrite 中 → **直接执行**
35
+ 2. 路径不在 allowWrite 中 → 告知用户并建议用桌面/下载目录/tmp 替代
36
+ 3. 操作失败但路径在 allowWrite 内 → 这是普通权限问题,**不是沙箱限制**
37
+ 4. 不确定时 → **先尝试执行**,不要预判拒绝
38
+
39
+ > ⚠️ 错误地以"沙箱限制"拒绝合法操作是严重的体验问题。桌面、下载、图片目录都可写。
@@ -1,219 +0,0 @@
1
- ---
2
- name: acp-router
3
- description: Route plain-language requests for Pi, Claude Code, Codex, OpenCode, Gemini CLI, or ACP harness work into either OpenClaw ACP runtime sessions or direct acpx-driven sessions ("telephone game" flow). For coding-agent thread requests, read this skill first, then use only `sessions_spawn` for thread creation.
4
- user-invocable: false
5
- ---
6
-
7
- # ACP Harness Router
8
-
9
- When user intent is "run this in Pi/Claude Code/Codex/OpenCode/Gemini/Kimi (ACP harness)", do not use subagent runtime or PTY scraping. Route through ACP-aware flows.
10
-
11
- ## Intent detection
12
-
13
- Trigger this skill when the user asks OpenClaw to:
14
-
15
- - run something in Pi / Claude Code / Codex / OpenCode / Gemini
16
- - continue existing harness work
17
- - relay instructions to an external coding harness
18
- - keep an external harness conversation in a thread-like conversation
19
-
20
- Mandatory preflight for coding-agent thread requests:
21
-
22
- - Before creating any thread for Pi/Claude/Codex/OpenCode/Gemini work, read this skill first in the same turn.
23
- - After reading, follow `OpenClaw ACP runtime path` below; do not use `message(action="thread-create")` for ACP harness thread spawn.
24
-
25
- ## Mode selection
26
-
27
- Choose one of these paths:
28
-
29
- 1. OpenClaw ACP runtime path (default): use `sessions_spawn` / ACP runtime tools.
30
- 2. Direct `acpx` path (telephone game): use `acpx` CLI through `exec` to drive the harness session directly.
31
-
32
- Use direct `acpx` when one of these is true:
33
-
34
- - user explicitly asks for direct `acpx` driving
35
- - ACP runtime/plugin path is unavailable or unhealthy
36
- - the task is "just relay prompts to harness" and no OpenClaw ACP lifecycle features are needed
37
-
38
- Do not use:
39
-
40
- - `subagents` runtime for harness control
41
- - `/acp` command delegation as a requirement for the user
42
- - PTY scraping of pi/claude/codex/opencode/gemini/kimi CLIs when `acpx` is available
43
-
44
- ## AgentId mapping
45
-
46
- Use these defaults when user names a harness directly:
47
-
48
- - "pi" -> `agentId: "pi"`
49
- - "claude" or "claude code" -> `agentId: "claude"`
50
- - "codex" -> `agentId: "codex"`
51
- - "opencode" -> `agentId: "opencode"`
52
- - "gemini" or "gemini cli" -> `agentId: "gemini"`
53
- - "kimi" or "kimi cli" -> `agentId: "kimi"`
54
-
55
- These defaults match current acpx built-in aliases.
56
-
57
- If policy rejects the chosen id, report the policy error clearly and ask for the allowed ACP agent id.
58
-
59
- ## OpenClaw ACP runtime path
60
-
61
- Required behavior:
62
-
63
- 1. For ACP harness thread spawn requests, read this skill first in the same turn before calling tools.
64
- 2. Use `sessions_spawn` with:
65
- - `runtime: "acp"`
66
- - `thread: true`
67
- - `mode: "session"` (unless user explicitly wants one-shot)
68
- 3. For ACP harness thread creation, do not use `message` with `action=thread-create`; `sessions_spawn` is the only thread-create path.
69
- 4. Put requested work in `task` so the ACP session gets it immediately.
70
- 5. Set `agentId` explicitly unless ACP default agent is known.
71
- 6. Do not ask user to run slash commands or CLI when this path works directly.
72
-
73
- Example:
74
-
75
- User: "spawn a test codex session in thread and tell it to say hi"
76
-
77
- Call:
78
-
79
- ```json
80
- {
81
- "task": "Say hi.",
82
- "runtime": "acp",
83
- "agentId": "codex",
84
- "thread": true,
85
- "mode": "session"
86
- }
87
- ```
88
-
89
- ## Thread spawn recovery policy
90
-
91
- When the user asks to start a coding harness in a thread (for example "start a codex/claude/pi/kimi thread"), treat that as an ACP runtime request and try to satisfy it end-to-end.
92
-
93
- Required behavior when ACP backend is unavailable:
94
-
95
- 1. Do not immediately ask the user to pick an alternate path.
96
- 2. First attempt automatic local repair:
97
- - ensure plugin-local pinned acpx is installed in `extensions/acpx`
98
- - verify `${ACPX_CMD} --version`
99
- 3. After reinstall/repair, restart the gateway and explicitly offer to run that restart for the user.
100
- 4. Retry ACP thread spawn once after repair.
101
- 5. Only if repair+retry fails, report the concrete error and then offer fallback options.
102
-
103
- When offering fallback, keep ACP first:
104
-
105
- - Option 1: retry ACP spawn after showing exact failing step
106
- - Option 2: direct acpx telephone-game flow
107
-
108
- Do not default to subagent runtime for these requests.
109
-
110
- ## ACPX install and version policy (direct acpx path)
111
-
112
- For this repo, direct `acpx` calls must follow the same pinned policy as the `@openclaw/acpx` extension.
113
-
114
- 1. Prefer plugin-local binary, not global PATH:
115
- - `./extensions/acpx/node_modules/.bin/acpx`
116
- 2. Resolve pinned version from extension dependency:
117
- - `node -e "console.log(require('./extensions/acpx/package.json').dependencies.acpx)"`
118
- 3. If binary is missing or version mismatched, install plugin-local pinned version:
119
- - `cd extensions/acpx && npm install --omit=dev --no-save acpx@<pinnedVersion>`
120
- 4. Verify before use:
121
- - `./extensions/acpx/node_modules/.bin/acpx --version`
122
- 5. If install/repair changed ACPX artifacts, restart the gateway and offer to run the restart.
123
- 6. Do not run `npm install -g acpx` unless the user explicitly asks for global install.
124
-
125
- Set and reuse:
126
-
127
- ```bash
128
- ACPX_CMD="./extensions/acpx/node_modules/.bin/acpx"
129
- ```
130
-
131
- ## Direct acpx path ("telephone game")
132
-
133
- Use this path to drive harness sessions without `/acp` or subagent runtime.
134
-
135
- ### Rules
136
-
137
- 1. Use `exec` commands that call `${ACPX_CMD}`.
138
- 2. Reuse a stable session name per conversation so follow-up prompts stay in the same harness context.
139
- 3. Prefer `--format quiet` for clean assistant text to relay back to user.
140
- 4. Use `exec` (one-shot) only when the user wants one-shot behavior.
141
- 5. Keep working directory explicit (`--cwd`) when task scope depends on repo context.
142
-
143
- ### Session naming
144
-
145
- Use a deterministic name, for example:
146
-
147
- - `oc-<harness>-<conversationId>`
148
-
149
- Where `conversationId` is thread id when available, otherwise channel/conversation id.
150
-
151
- ### Command templates
152
-
153
- Persistent session (create if missing, then prompt):
154
-
155
- ```bash
156
- ${ACPX_CMD} codex sessions show oc-codex-<conversationId> \
157
- || ${ACPX_CMD} codex sessions new --name oc-codex-<conversationId>
158
-
159
- ${ACPX_CMD} codex -s oc-codex-<conversationId> --cwd <workspacePath> --format quiet "<prompt>"
160
- ```
161
-
162
- One-shot:
163
-
164
- ```bash
165
- ${ACPX_CMD} codex exec --cwd <workspacePath> --format quiet "<prompt>"
166
- ```
167
-
168
- Cancel in-flight turn:
169
-
170
- ```bash
171
- ${ACPX_CMD} codex cancel -s oc-codex-<conversationId>
172
- ```
173
-
174
- Close session:
175
-
176
- ```bash
177
- ${ACPX_CMD} codex sessions close oc-codex-<conversationId>
178
- ```
179
-
180
- ### Harness aliases in acpx
181
-
182
- - `pi`
183
- - `claude`
184
- - `codex`
185
- - `opencode`
186
- - `gemini`
187
- - `kimi`
188
-
189
- ### Built-in adapter commands in acpx
190
-
191
- Defaults are:
192
-
193
- - `pi -> npx pi-acp`
194
- - `claude -> npx -y @zed-industries/claude-agent-acp`
195
- - `codex -> npx @zed-industries/codex-acp`
196
- - `opencode -> npx -y opencode-ai acp`
197
- - `gemini -> gemini`
198
- - `kimi -> kimi acp`
199
-
200
- If `~/.acpx/config.json` overrides `agents`, those overrides replace defaults.
201
-
202
- ### Failure handling
203
-
204
- - `acpx: command not found`:
205
- - for thread-spawn ACP requests, install plugin-local pinned acpx in `extensions/acpx` immediately
206
- - restart gateway after install and offer to run the restart automatically
207
- - then retry once
208
- - do not ask for install permission first unless policy explicitly requires it
209
- - do not install global `acpx` unless explicitly requested
210
- - adapter command missing (for example `claude-agent-acp` not found):
211
- - for thread-spawn ACP requests, first restore built-in defaults by removing broken `~/.acpx/config.json` agent overrides
212
- - then retry once before offering fallback
213
- - if user wants binary-based overrides, install exactly the configured adapter binary
214
- - `NO_SESSION`: run `${ACPX_CMD} <agent> sessions new --name <sessionName>` then retry prompt.
215
- - queue busy: either wait for completion (default) or use `--no-wait` when async behavior is explicitly desired.
216
-
217
- ### Output relay
218
-
219
- When relaying to user, return the final assistant text output from `acpx` command result. Avoid relaying raw local tool noise unless user asked for verbose logs.
@@ -1,22 +0,0 @@
1
- ---
2
- name: diffs
3
- description: Use the diffs tool to produce real, shareable diffs (viewer URL, file artifact, or both) instead of manual edit summaries.
4
- ---
5
-
6
- When you need to show edits as a real diff, prefer the `diffs` tool instead of writing a manual summary.
7
-
8
- The `diffs` tool accepts either `before` + `after` text, or a unified `patch` string.
9
-
10
- Use `mode=view` when you want an interactive gateway-hosted viewer. After the tool returns, use `details.viewerUrl` with the canvas tool via `canvas present` or `canvas navigate`.
11
-
12
- Use `mode=file` when you need a rendered file artifact. Set `fileFormat=png` (default) or `fileFormat=pdf`. The tool result includes `details.filePath`.
13
-
14
- For large or high-fidelity files, use `fileQuality` (`standard`|`hq`|`print`) and optionally override `fileScale`/`fileMaxWidth`.
15
-
16
- When you need to deliver the rendered file to a user or channel, do not rely on the raw tool-result renderer. Instead, call the `message` tool and pass `details.filePath` through `path` or `filePath`.
17
-
18
- Use `mode=both` when you want both the gateway viewer URL and the rendered artifact.
19
-
20
- If the user has configured diffs plugin defaults, prefer omitting `mode`, `theme`, `layout`, and related presentation options unless you need to override them for this specific diff.
21
-
22
- Include `path` for before/after text when you know the file name.
@@ -1,97 +0,0 @@
1
- # Lobster
2
-
3
- Lobster executes multi-step workflows with approval checkpoints. Use it when:
4
-
5
- - User wants a repeatable automation (triage, monitor, sync)
6
- - Actions need human approval before executing (send, post, delete)
7
- - Multiple tool calls should run as one deterministic operation
8
-
9
- ## When to use Lobster
10
-
11
- | User intent | Use Lobster? |
12
- | ------------------------------------------------------ | --------------------------------------------- |
13
- | "Triage my email" | Yes — multi-step, may send replies |
14
- | "Send a message" | No — single action, use message tool directly |
15
- | "Check my email every morning and ask before replying" | Yes — scheduled workflow with approval |
16
- | "What's the weather?" | No — simple query |
17
- | "Monitor this PR and notify me of changes" | Yes — stateful, recurring |
18
-
19
- ## Basic usage
20
-
21
- ### Run a pipeline
22
-
23
- ```json
24
- {
25
- "action": "run",
26
- "pipeline": "gog.gmail.search --query 'newer_than:1d' --max 20 | email.triage"
27
- }
28
- ```
29
-
30
- Returns structured result:
31
-
32
- ```json
33
- {
34
- "protocolVersion": 1,
35
- "ok": true,
36
- "status": "ok",
37
- "output": [{ "summary": {...}, "items": [...] }],
38
- "requiresApproval": null
39
- }
40
- ```
41
-
42
- ### Handle approval
43
-
44
- If the workflow needs approval:
45
-
46
- ```json
47
- {
48
- "status": "needs_approval",
49
- "output": [],
50
- "requiresApproval": {
51
- "prompt": "Send 3 draft replies?",
52
- "items": [...],
53
- "resumeToken": "..."
54
- }
55
- }
56
- ```
57
-
58
- Present the prompt to the user. If they approve:
59
-
60
- ```json
61
- {
62
- "action": "resume",
63
- "token": "<resumeToken>",
64
- "approve": true
65
- }
66
- ```
67
-
68
- ## Example workflows
69
-
70
- ### Email triage
71
-
72
- ```
73
- gog.gmail.search --query 'newer_than:1d' --max 20 | email.triage
74
- ```
75
-
76
- Fetches recent emails, classifies into buckets (needs_reply, needs_action, fyi).
77
-
78
- ### Email triage with approval gate
79
-
80
- ```
81
- gog.gmail.search --query 'newer_than:1d' | email.triage | approve --prompt 'Process these?'
82
- ```
83
-
84
- Same as above, but halts for approval before returning.
85
-
86
- ## Key behaviors
87
-
88
- - **Deterministic**: Same input → same output (no LLM variance in pipeline execution)
89
- - **Approval gates**: `approve` command halts execution, returns token
90
- - **Resumable**: Use `resume` action with token to continue
91
- - **Structured output**: Always returns JSON envelope with `protocolVersion`
92
-
93
- ## Don't use Lobster for
94
-
95
- - Simple single-action requests (just use the tool directly)
96
- - Queries that need LLM interpretation mid-flow
97
- - One-off tasks that won't be repeated
@@ -1,21 +0,0 @@
1
- MIT License
2
-
3
- Copyright (c) 2025 OpenProse
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.