@keystrokehq/cli 0.1.171 → 0.1.173
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.
- package/README.md +24 -1
- package/dist/dist-BOlrsYA4.mjs +3 -0
- package/dist/{dist-CnddVrzY.mjs → dist-BUDyVVbj.mjs} +642 -6
- package/dist/dist-BUDyVVbj.mjs.map +1 -0
- package/dist/{dist-B8ZXKNXj.mjs → dist-D2xubfXd.mjs} +3560 -2633
- package/dist/dist-D2xubfXd.mjs.map +1 -0
- package/dist/{dist-C5ooQsTQ.mjs → dist-DRSCtW8V.mjs} +40 -4
- package/dist/dist-DRSCtW8V.mjs.map +1 -0
- package/dist/dist-n16MYIv2.mjs +4 -0
- package/dist/index.mjs +1 -1
- package/dist/{maybe-auto-update-28IpqxhP.mjs → maybe-auto-update-Dmcj8aoh.mjs} +2 -2
- package/dist/{maybe-auto-update-28IpqxhP.mjs.map → maybe-auto-update-Dmcj8aoh.mjs.map} +1 -1
- package/dist/{program-Ckl_ELbL.mjs → program-DO7ZQHjx.mjs} +651 -14
- package/dist/program-DO7ZQHjx.mjs.map +1 -0
- package/dist/{run-package-manager-update-CcJWW5xj.mjs → run-package-manager-update-Dvl8GJr2.mjs} +2 -2
- package/dist/{run-package-manager-update-CcJWW5xj.mjs.map → run-package-manager-update-Dvl8GJr2.mjs.map} +1 -1
- package/package.json +5 -4
- package/dist/dist-B8ZXKNXj.mjs.map +0 -1
- package/dist/dist-Brtmx-yx.mjs +0 -3
- package/dist/dist-C5ooQsTQ.mjs.map +0 -1
- package/dist/dist-CPGQbDRC.mjs +0 -4
- package/dist/dist-CnddVrzY.mjs.map +0 -1
- package/dist/program-Ckl_ELbL.mjs.map +0 -1
package/README.md
CHANGED
|
@@ -29,7 +29,7 @@ keystroke <verb> # lifecycle only (init, buil
|
|
|
29
29
|
|
|
30
30
|
Rules:
|
|
31
31
|
|
|
32
|
-
- **Collections are plural** and match the HTTP API / SDK / `src/` dirs — `workflows`, `agents`, `triggers`, `projects`, `apps`, `channels`, `credentials`. Never singular.
|
|
32
|
+
- **Collections are plural** and match the HTTP API / SDK / `src/` dirs — `workflows`, `agents`, `triggers`, `brains`, `projects`, `apps`, `channels`, `credentials`. Never singular.
|
|
33
33
|
- **The primary resource is positional**, not a flag. The collection already names the type, so `workflows run greeting` — never `workflows run --workflow greeting`.
|
|
34
34
|
- **Nested resources are sub-collections before the verb** — `workflows runs list <slug>`, `apps actions get <app> <tool>`. Not flat (`workflows-runs-list`) and not verb-first (`workflows list runs`).
|
|
35
35
|
- **A second positional is the child id** — `workflows runs cancel <workflow> <run-id>`, `agents sessions cancel <agent> <session-id>`.
|
|
@@ -50,11 +50,16 @@ keystroke agents prompt <slug> --message "…" [--wait] [--timeout <seconds>]
|
|
|
50
50
|
keystroke agents sessions list <slug>
|
|
51
51
|
keystroke agents sessions get <slug> <session-id> [--wait] [--timeout <seconds>]
|
|
52
52
|
keystroke agents sessions cancel <slug> <session-id>
|
|
53
|
+
keystroke agents browser open <slug> [--url <url>]
|
|
54
|
+
keystroke agents browser reset <slug>
|
|
55
|
+
keystroke agents browser status <slug>
|
|
53
56
|
keystroke channels list|setup|bind <agent>
|
|
54
57
|
keystroke channels unbind|update-binding <agent> <binding-id>
|
|
55
58
|
keystroke triggers invoke <slug> [--input '{…}'] [--workflow <s> | --agent <s>]
|
|
56
59
|
keystroke triggers disable|enable <slug> [--workflow <s> | --agent <s>]
|
|
57
60
|
keystroke triggers runs list|get <slug> [--workflow <s> | --agent <s>]
|
|
61
|
+
keystroke brains members|projects|filters list|create|update|delete <slug> [<child>]
|
|
62
|
+
keystroke brains documents list|get|delete <slug> [<document-id>]
|
|
58
63
|
keystroke apps actions list|get <app> [<tool>]
|
|
59
64
|
keystroke apps execute <app> <tool> --input '{...}' # catalog or custom MCP
|
|
60
65
|
keystroke apps create|delete [<slug>]
|
|
@@ -149,6 +154,21 @@ keystroke triggers invoke signup --input '{"name":"Ada","email":"ada@example.com
|
|
|
149
154
|
|
|
150
155
|
`url` prints a single line suitable for piping into curl or pasting into external webhook config. `invoke` is platform-only: webhook invokes take `--input`; cron and poll take none (cron always uses its static payload). Narrow with `--workflow` / `--agent` when a trigger has multiple attachments.
|
|
151
156
|
|
|
157
|
+
### `brains`
|
|
158
|
+
|
|
159
|
+
Organization-scoped Brain management (requires `keystroke auth login` plus an organization target; no linked project). You manage the Brains you own or administer; sharing with a project is an explicit grant with the project as a positional cross-reference:
|
|
160
|
+
|
|
161
|
+
```bash
|
|
162
|
+
keystroke brains list
|
|
163
|
+
keystroke brains create --name "Company knowledge" --description "…" [--embedding-model voyage/voyage-4] [--language english]
|
|
164
|
+
keystroke brains update|delete|rebuild <slug>
|
|
165
|
+
keystroke brains members list|create|update|delete <slug> [<user-id>] [--role owner|admin]
|
|
166
|
+
keystroke brains projects list|create|delete <slug> [<project>] [--access read|write]
|
|
167
|
+
keystroke brains filters list|create|update|delete <slug> [<filter-slug>] [--filter '{"source":["linear"]}']
|
|
168
|
+
keystroke brains documents list <slug> [--search <text>] [--source <s>]… [--provisioner workflow|manual]… [--filter <filter-slug>]
|
|
169
|
+
keystroke brains documents get|delete <slug> <document-id…>
|
|
170
|
+
```
|
|
171
|
+
|
|
152
172
|
### `init`
|
|
153
173
|
|
|
154
174
|
Scaffold a new project from the bundled `hello-world` template — definitions only under `src/`, no `server.ts`.
|
|
@@ -216,10 +236,13 @@ Upload local working-tree changes to the shared draft (`ks/draft`), fetch the pi
|
|
|
216
236
|
```bash
|
|
217
237
|
keystroke deploy
|
|
218
238
|
keystroke deploy --accept-impact --filter workflows/ping --filter agents/world
|
|
239
|
+
keystroke deploy --build-from-workspace
|
|
219
240
|
```
|
|
220
241
|
|
|
221
242
|
`--filter` accepts workflow/agent resource keys (`workflows/…`, `agents/…`). Deploy analyzes shared dependency impact locally. In non-TTY environments, pass `--accept-impact` when filtered expansion requires confirmation — otherwise deploy prints the impact and fails fast without hanging.
|
|
222
243
|
|
|
244
|
+
For a Keystroke project nested in a package-manager monorepo, `--build-from-workspace` permits `workspace:`, `link:`, and local `file:` dependencies by building against the current checkout and its installed dependencies. It is full-deploy only and intentionally non-reproducible from Keystroke's managed source because local package sources are not uploaded. Prefer published package versions when possible.
|
|
245
|
+
|
|
223
246
|
### `pull`
|
|
224
247
|
|
|
225
248
|
Fetches the shared unpublished draft tip (`ks/draft`) with a short-lived read-only remote and merges it into the local checkout (preserving local edits). Managed draft state lives in `.keystroke/git` (work tree = project root) so your own `.git` / GitHub `origin` are never modified. Git-less directories are bootstrapped into that sidecar. Requires `keystroke auth login` and a linked project (or `--project <slug>`).
|