@andreprado/agentkit 0.1.1 → 0.2.0

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 (95) hide show
  1. package/README.md +8 -77
  2. package/docs/guides/add-channel.md +14 -92
  3. package/docs/guides/add-knowledge.md +0 -21
  4. package/docs/guides/add-tool.md +5 -11
  5. package/docs/guides/channel-security.md +3 -207
  6. package/docs/guides/connect-discord.md +7 -172
  7. package/docs/guides/connect-slack.md +6 -121
  8. package/docs/guides/connect-telegram.md +6 -165
  9. package/docs/guides/connect-whatsapp-evolution.md +6 -116
  10. package/docs/guides/connect-whatsapp-uazapi.md +6 -134
  11. package/docs/guides/connect-whatsapp-zapster.md +6 -202
  12. package/docs/guides/create-agent.md +5 -14
  13. package/docs/guides/debug-channel.md +4 -156
  14. package/docs/guides/improve-local.md +13 -0
  15. package/docs/guides/local-only-migration.md +35 -0
  16. package/docs/guides/replay-local-traces.md +11 -0
  17. package/docs/guides/run-evals.md +2 -4
  18. package/docs/guides/security-rules.md +5 -154
  19. package/docs/guides/use-jev.md +3 -6
  20. package/docs/guides/use-provider.md +0 -3
  21. package/docs/guides/write-feedback.md +10 -0
  22. package/docs/llms-full.txt +27 -448
  23. package/docs/llms.txt +8 -44
  24. package/package.json +2 -4
  25. package/src/cli/commands/channels.ts +8 -1613
  26. package/src/cli/commands/feedback.ts +8 -86
  27. package/src/cli/constants.ts +0 -3
  28. package/src/cli/flags.ts +0 -28
  29. package/src/cli/help.ts +16 -92
  30. package/src/cli/index.ts +15 -1091
  31. package/src/index.ts +6 -158
  32. package/src/providers/pi.ts +2 -0
  33. package/src/runtime/channels/discord.ts +2 -2
  34. package/src/runtime/chat.ts +5 -3
  35. package/src/runtime/config.ts +14 -148
  36. package/src/runtime/database.ts +2 -2
  37. package/src/runtime/dev-server.ts +8 -8
  38. package/src/runtime/env.ts +11 -0
  39. package/src/runtime/improve.ts +2 -262
  40. package/src/runtime/inspect.ts +13 -73
  41. package/src/runtime/knowledge/ingest.ts +1 -1
  42. package/src/runtime/knowledge/tool.ts +16 -2
  43. package/src/runtime/knowledge/vector.ts +1 -1
  44. package/src/runtime/tool-runner.ts +5 -3
  45. package/src/runtime/tools.ts +10 -14
  46. package/src/storage/sqlite.ts +11 -32
  47. package/src/templates/blank.ts +15 -102
  48. package/src/templates/common.ts +60 -0
  49. package/src/templates/dentista.ts +7 -74
  50. package/src/templates/skills/agentkit-capsule/SKILL.md +5 -7
  51. package/src/templates/skills/agentkit-capsule/references/docs-router.md +2 -3
  52. package/src/templates/skills/agentkit-channels/SKILL.md +6 -119
  53. package/src/templates/skills/agentkit-channels/references/channel-buffering.md +0 -9
  54. package/src/templates/skills/agentkit-channels/references/channel-debugging.md +1 -64
  55. package/src/templates/skills/agentkit-channels/references/discord.md +2 -92
  56. package/src/templates/skills/agentkit-channels/references/slack.md +2 -55
  57. package/src/templates/skills/agentkit-channels/references/telegram.md +2 -71
  58. package/src/templates/skills/agentkit-channels/references/whatsapp-evolution.md +2 -56
  59. package/src/templates/skills/agentkit-channels/references/whatsapp-uazapi.md +2 -53
  60. package/src/templates/skills/agentkit-channels/references/whatsapp-zapster.md +2 -70
  61. package/src/templates/skills/agentkit-database/SKILL.md +2 -4
  62. package/src/templates/skills/agentkit-evals/SKILL.md +1 -1
  63. package/src/templates/skills/agentkit-improve/SKILL.md +6 -85
  64. package/src/templates/skills/agentkit-improve/references/trace-packets.md +1 -1
  65. package/src/templates/skills/agentkit-provider/SKILL.md +0 -1
  66. package/src/templates/skills/agentkit-security/SKILL.md +1 -3
  67. package/src/templates/skills/agentkit-tools/SKILL.md +1 -1
  68. package/src/templates/skills/agentkit-tools/examples/database-write.tool.md +1 -2
  69. package/src/templates/skills/agentkit-troubleshooting/SKILL.md +5 -11
  70. package/src/templates/support.ts +8 -92
  71. package/docs/guides/add-managed-composio.md +0 -165
  72. package/docs/guides/improve-from-production.md +0 -151
  73. package/docs/guides/prepare-deploy.md +0 -227
  74. package/docs/guides/replay-production-traces.md +0 -72
  75. package/docs/guides/send-feedback.md +0 -135
  76. package/src/cli/cloud-client.ts +0 -377
  77. package/src/cli/deploy-chat-ui.ts +0 -606
  78. package/src/cli/deploy-readiness.ts +0 -561
  79. package/src/cloud/artifact.ts +0 -139
  80. package/src/cloud/client.ts +0 -80
  81. package/src/cloud/contracts.ts +0 -63
  82. package/src/cloud/index.ts +0 -3
  83. package/src/runtime/build.ts +0 -43
  84. package/src/runtime/core/deploy-state.ts +0 -54
  85. package/src/runtime/core/manifest.ts +0 -283
  86. package/src/runtime/core/targets.ts +0 -133
  87. package/src/runtime/deploy-readiness.ts +0 -135
  88. package/src/runtime/deploy.ts +0 -1
  89. package/src/runtime/integrations/composio.ts +0 -425
  90. package/src/runtime/targets/cloudflare/build.ts +0 -3319
  91. package/src/runtime/targets/container/build.ts +0 -146
  92. package/src/runtime/targets/container/server.ts +0 -33
  93. package/src/runtime/targets/vps/deploy.ts +0 -223
  94. package/src/templates/skills/agentkit-deploy/SKILL.md +0 -52
  95. package/src/templates/skills/agentkit-integrations/SKILL.md +0 -98
package/docs/llms.txt CHANGED
@@ -11,17 +11,12 @@ Task guides:
11
11
  - Use TypeSafe/Jev inside a capsule tool: `docs/guides/use-jev.md`
12
12
  - Add Knowledge from local docs/CSVs: `docs/guides/add-knowledge.md`
13
13
  - Run or prepare evals: `docs/guides/run-evals.md`
14
- - Improve from production traces: `docs/guides/improve-from-production.md`
15
- - Replay collected traces locally: `docs/guides/replay-production-traces.md`
16
- - Send AgentKit product feedback safely: `docs/guides/send-feedback.md`
14
+ - Improve from production traces: `docs/guides/improve-local.md`
15
+ - Replay collected traces locally: `docs/guides/replay-local-traces.md`
16
+ - Send AgentKit product feedback safely: `docs/guides/write-feedback.md`
17
17
  - Switch from `test/fake` to a real provider: `docs/guides/use-provider.md`
18
- - Prepare for hosted deploy: `docs/guides/prepare-deploy.md`
19
- - Build Cloudflare artifact: `agentkit build --target cloudflare`
20
- - Build container artifact: `agentkit build --target container`
21
- - Generate VPS handoff: `agentkit deploy --target vps --host agent.example.com --dry-run`
22
- - Add hosted channels: `docs/guides/add-channel.md`
18
+ - Add local channels: `docs/guides/add-channel.md`
23
19
  - Route replies across channels or add generic output webhooks: `docs/guides/add-channel.md#reply-through-another-channel`
24
- - Add AgentKit-managed Composio: `docs/guides/add-managed-composio.md`
25
20
  - Buffer rapid channel messages: `docs/guides/add-channel.md#buffer-bursty-messages`
26
21
  - Connect Discord: `docs/guides/connect-discord.md`
27
22
  - Connect Slack: `docs/guides/connect-slack.md`
@@ -51,47 +46,17 @@ agentkit knowledge sync
51
46
  agentkit knowledge inspect
52
47
  agentkit knowledge search <query> [--top-k <number>]
53
48
  agentkit eval run
54
- agentkit improve collect --deploy --since 24h
49
+ agentkit improve collect --since 24h
55
50
  agentkit improve evals .agentkit/improve/<run>
56
51
  agentkit replay .agentkit/improve/<run> --against local
57
52
  agentkit feedback create --about last-run --kind bug --summary "what failed"
58
- agentkit feedback send .agentkit/feedback/<draft>.json
59
53
  agentkit conversations list
60
54
  agentkit conversations show <conversation-id>
61
- agentkit conversations trace <conversation-id> [--deploy]
55
+ agentkit conversations trace <conversation-id>
62
56
  agentkit channels list
63
- agentkit channels add telegram support-telegram
64
- agentkit channels connect whatsapp main-whatsapp --provider evolution
65
- agentkit channels connect whatsapp support-whatsapp --provider uazapi
66
- agentkit channels connect discord support-discord
67
- agentkit channels connect discord server-discord --mode bot
68
- agentkit channels connect slack support-slack
69
- agentkit channels connect webhook n8n-webhook
70
- agentkit channels setup support-telegram
71
- agentkit channels status support-telegram
72
- agentkit channels test support-telegram --message "hello"
73
- agentkit channels test-audio support-telegram --fixture voice-note
74
57
  agentkit transcribe smoke --provider groq
75
- agentkit channels deliveries list support-telegram
76
- agentkit integrations status [--toolkit googlecalendar]
77
- agentkit integrations connect composio --toolkit gmail
78
58
  agentkit skills status
79
59
  agentkit skills sync
80
- agentkit billing checkout --slots 1 --email user@example.com
81
- agentkit billing claim billint_... --secret bsec_...
82
- agentkit login --token agk_user_...
83
- agentkit account token create new-laptop --use
84
- agentkit account token list
85
- agentkit deploy doctor
86
- agentkit deploy --smoke "hello"
87
- agentkit deploy status
88
- agentkit deploy smoke --message "hello"
89
- agentkit chat-ui --deploy
90
- agentkit secret set <NAME> --from-local-env
91
- agentkit secret sync --from-local
92
- agentkit secret list
93
- agentkit access token create website-chat --out .agentkit/website-chat-access-token.json
94
- agentkit access token list
95
60
  agentkit inspect
96
61
  agentkit dev
97
62
  agentkit open
@@ -101,9 +66,7 @@ On Windows PowerShell, if `npm.ps1` or `npx.ps1` is blocked with `PSSecurityExce
101
66
 
102
67
  Generated capsules include `AGENTKIT.md`, `AGENTS.md`, and a repo-local `skills/` pack so Codex, Claude Code, or another coding agent can treat the owner's natural-language request as the brief and start building immediately without loading the full contract by default. Start with `skills/agentkit-capsule/SKILL.md`, then load the task skill for the current work. `agentkit handoff codex "Develop an ophthalmology office intake agent"` is an optional prompt-printing shortcut for users who are not already inside a coding-agent workspace. There is no AgentKit CLI wizard in the normal flow: the coding agent edits the capsule directly from the scaffold and contract.
103
68
 
104
- UI testing is part of the handoff. For local UI testing, run `agentkit dev`, open the printed `Chat:` URL, and tell the owner the exact URL. After hosted deploy, run `agentkit chat-ui --deploy`, open the printed `Chat:` URL, and tell the owner it is connected to the deploy.
105
69
 
106
- Hosted Chat UI shows the current conversation id, tool calls, tool errors, and a new-conversation control. Use `agentkit conversations trace <conversation-id> --deploy` to pull the hosted trace from the last deploy.
107
70
 
108
71
  `test/fake` is deterministic and validates scaffold, direct tool calls, and fake-provider evals. It does not validate natural conversation quality. Before claiming real conversation behavior has been tested, ask the owner which provider to use: OpenRouter, OpenAI, Anthropic, OpenCode Zen, OpenCode Go, or another supported provider. Do not choose for them.
109
72
 
@@ -127,4 +90,5 @@ POST /channels/<name>/webhook
127
90
 
128
91
  Only authenticated channel webhook routes may arrive through a public HTTPS tunnel. Other local endpoints remain loopback-only. UAZAPI and Zapster use user-generated AgentKit URL secrets in `?token=...`; the providers do not issue those values.
129
92
 
130
- Local `.env` is for development only. Use `.env.schema` as the committed secret-name contract; local AgentKit commands load `.env` directly. Hosted deploys require an AgentKit Cloud account with `cloudflare_deploy_alpha` or purchased/manual deploy slots. Use `agentkit billing checkout` + `agentkit billing claim` for first-time paid access, or `agentkit login --token ...` when the user already has an `agk_user_...` token. Production uses managed secrets in the hosted contract.
93
+
94
+ For existing capsules, read `docs/guides/local-only-migration.md` before upgrading.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@andreprado/agentkit",
3
- "version": "0.1.1",
3
+ "version": "0.2.0",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "repository": {
@@ -9,8 +9,7 @@
9
9
  "directory": "packages/agentkit"
10
10
  },
11
11
  "exports": {
12
- ".": "./src/index.ts",
13
- "./runtime/container": "./src/runtime/targets/container/server.ts"
12
+ ".": "./src/index.ts"
14
13
  },
15
14
  "files": [
16
15
  "bin",
@@ -32,7 +31,6 @@
32
31
  "dependencies": {
33
32
  "@earendil-works/pi-ai": "^0.75.5",
34
33
  "@libsql/client": "^0.15.15",
35
- "esbuild": "^0.28.2",
36
34
  "tsx": "^4.23.12",
37
35
  "typebox": "^1.1.38"
38
36
  },