@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 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>`).
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env node
2
+ import { a as buildApp } from "./dist-DRSCtW8V.mjs";
3
+ export { buildApp };