@keystrokehq/cli 0.1.15 → 0.1.16
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/dist/index.mjs +7 -4
- package/dist/index.mjs.map +1 -1
- package/dist/skills-bundle/_AGENTS.mcp.md +10 -3
- package/dist/skills-bundle/_AGENTS.md +61 -70
- package/dist/skills-bundle/skills/keystroke-actions/SKILL.md +60 -12
- package/dist/skills-bundle/skills/keystroke-actions/references/catalog-and-imports.md +32 -3
- package/dist/skills-bundle/skills/keystroke-agents/SKILL.md +50 -8
- package/dist/skills-bundle/skills/keystroke-agents/references/models.md +11 -13
- package/dist/skills-bundle/skills/keystroke-agents/references/tools-mcp-codemode.md +45 -3
- package/dist/skills-bundle/skills/keystroke-agents/references/workflows-and-testing.md +1 -1
- package/dist/skills-bundle/skills/keystroke-apps/SKILL.md +26 -13
- package/dist/skills-bundle/skills/keystroke-apps/references/cli-and-catalog.md +47 -16
- package/dist/skills-bundle/skills/keystroke-channels/SKILL.md +66 -0
- package/dist/skills-bundle/skills/keystroke-channels/references/slack-setup.md +41 -0
- package/dist/skills-bundle/skills/keystroke-cli/SKILL.md +41 -93
- package/dist/skills-bundle/skills/keystroke-deploy/SKILL.md +10 -9
- package/dist/skills-bundle/skills/keystroke-deploy/references/build-and-full-deploy.md +3 -1
- package/dist/skills-bundle/skills/keystroke-deploy/references/filtered-deploy.md +3 -2
- package/dist/skills-bundle/skills/keystroke-deploy/references/wip-ignore.md +5 -2
- package/dist/skills-bundle/skills/keystroke-files/SKILL.md +12 -4
- package/dist/skills-bundle/skills/keystroke-skills/SKILL.md +7 -2
- package/dist/skills-bundle/skills/keystroke-triggers/SKILL.md +30 -17
- package/dist/skills-bundle/skills/keystroke-workflows/SKILL.md +27 -12
- package/dist/skills-bundle/skills/keystroke-workflows/references/authoring.md +116 -4
- package/dist/skills-bundle/skills/keystroke-workflows/references/testing.md +17 -9
- package/dist/templates/hello-world/README.md +19 -8
- package/dist/templates/hello-world/src/workflows/greeting.test.ts +1 -1
- package/package.json +2 -2
- package/dist/skills-bundle/skills/keystroke-cli/references/api-targets.md +0 -87
- package/dist/skills-bundle/skills/keystroke-gateways/SKILL.md +0 -43
- package/dist/skills-bundle/skills/keystroke-gateways/references/slack-setup.md +0 -27
|
@@ -1,43 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: keystroke-gateways
|
|
3
|
-
description: Chat with keystroke agents from Slack via @keystrokehq/slack — OAuth, dashboard binding, channel attach. Use when setting up messaging for agents.
|
|
4
|
-
metadata:
|
|
5
|
-
keystroke-domain: gateways
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# Gateways
|
|
9
|
-
|
|
10
|
-
Gateways route **Slack (and similar) messages** to an agent — users chat in-channel instead of using the CLI.
|
|
11
|
-
|
|
12
|
-
## Setup (Slack)
|
|
13
|
-
|
|
14
|
-
1. Set Slack app env vars in `.env` (see apps skill)
|
|
15
|
-
2. `keystroke start` — open dashboard at `:3000`
|
|
16
|
-
3. Complete Slack OAuth install
|
|
17
|
-
4. **Gateways → Slack → Attach** — pick an agent key + channel
|
|
18
|
-
5. Message the bot in Slack
|
|
19
|
-
|
|
20
|
-
## What happens at runtime
|
|
21
|
-
|
|
22
|
-
Inbound Slack event → lookup channel attachment → `runPrompt` for the bound agent → reply in thread.
|
|
23
|
-
|
|
24
|
-
## Audit agent behavior from gateway traffic
|
|
25
|
-
|
|
26
|
-
```bash
|
|
27
|
-
keystroke agent sessions list <agent-key> --source gateway
|
|
28
|
-
keystroke agent sessions get <agent-key> <session-id> --include messages,trace
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
## Troubleshooting
|
|
32
|
-
|
|
33
|
-
| Issue | Check |
|
|
34
|
-
| ----------- | ------------------------------------------------------------------- |
|
|
35
|
-
| Bot silent | `keystroke agent sessions list` for errors; agent key on attachment |
|
|
36
|
-
| OAuth fails | Slack redirect URLs match your dashboard origin |
|
|
37
|
-
| Wrong agent | Re-bind attachment in dashboard |
|
|
38
|
-
|
|
39
|
-
## Next references
|
|
40
|
-
|
|
41
|
-
- [slack-setup.md](references/slack-setup.md) — env vars, attach flow
|
|
42
|
-
|
|
43
|
-
Related: [agents](.agents/skills/keystroke-agents/SKILL.md), [apps](.agents/skills/keystroke-apps/SKILL.md).
|
|
@@ -1,27 +0,0 @@
|
|
|
1
|
-
# Slack gateway
|
|
2
|
-
|
|
3
|
-
## .env
|
|
4
|
-
|
|
5
|
-
Set Slack OAuth provider env vars in `.env` (client id, secret, signing secret) — then connect the Slack app with `keystroke connect slack`.
|
|
6
|
-
|
|
7
|
-
## Install & bind
|
|
8
|
-
|
|
9
|
-
1. `keystroke start`
|
|
10
|
-
2. Dashboard → install Slack app (OAuth) — includes `chat:write.customize` for agent-named replies
|
|
11
|
-
3. **Gateways → Slack → Attach** — agent key + channel (attach URLs include `team` + `channel` query params)
|
|
12
|
-
4. Send a test message in Slack
|
|
13
|
-
|
|
14
|
-
## Audit
|
|
15
|
-
|
|
16
|
-
```bash
|
|
17
|
-
keystroke agent sessions list <agent-key> --source gateway
|
|
18
|
-
keystroke agent sessions get <agent-key> <session-id> --include messages,trace
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
## Common fixes
|
|
22
|
-
|
|
23
|
-
| Issue | Fix |
|
|
24
|
-
| ------------- | -------------------------------------------------- |
|
|
25
|
-
| 401 on events | Check signing secret in `.env` |
|
|
26
|
-
| No reply | Session errors via `keystroke agent sessions list` |
|
|
27
|
-
| Wrong agent | Re-attach in dashboard |
|