@andreprado/agentkit 0.1.1 → 0.3.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.
- package/README.md +8 -77
- package/docs/guides/add-channel.md +14 -92
- package/docs/guides/add-knowledge.md +0 -21
- package/docs/guides/add-tool.md +5 -11
- package/docs/guides/channel-security.md +3 -207
- package/docs/guides/connect-discord.md +7 -172
- package/docs/guides/connect-slack.md +6 -121
- package/docs/guides/connect-telegram.md +6 -165
- package/docs/guides/connect-whatsapp-evolution.md +6 -116
- package/docs/guides/connect-whatsapp-uazapi.md +6 -134
- package/docs/guides/connect-whatsapp-zapster.md +6 -202
- package/docs/guides/create-agent.md +5 -14
- package/docs/guides/debug-channel.md +4 -156
- package/docs/guides/improve-local.md +13 -0
- package/docs/guides/local-only-migration.md +35 -0
- package/docs/guides/replay-local-traces.md +11 -0
- package/docs/guides/run-evals.md +2 -4
- package/docs/guides/security-rules.md +5 -154
- package/docs/guides/use-jev.md +3 -6
- package/docs/guides/use-provider.md +5 -6
- package/docs/guides/write-feedback.md +10 -0
- package/docs/llms-full.txt +27 -448
- package/docs/llms.txt +8 -44
- package/package.json +3 -5
- package/src/cli/commands/channels.ts +8 -1613
- package/src/cli/commands/feedback.ts +8 -86
- package/src/cli/commands/provider.ts +29 -11
- package/src/cli/constants.ts +0 -3
- package/src/cli/flags.ts +0 -28
- package/src/cli/help.ts +16 -92
- package/src/cli/index.ts +15 -1091
- package/src/index.ts +6 -158
- package/src/providers/codex-auth.ts +16 -2
- package/src/providers/pi.ts +36 -19
- package/src/runtime/channels/discord.ts +2 -2
- package/src/runtime/chat.ts +5 -3
- package/src/runtime/config.ts +14 -148
- package/src/runtime/database.ts +2 -2
- package/src/runtime/dev-server.ts +8 -8
- package/src/runtime/env.ts +11 -0
- package/src/runtime/improve.ts +2 -262
- package/src/runtime/inspect.ts +13 -73
- package/src/runtime/knowledge/ingest.ts +1 -1
- package/src/runtime/knowledge/tool.ts +16 -2
- package/src/runtime/knowledge/vector.ts +1 -1
- package/src/runtime/tool-runner.ts +5 -3
- package/src/runtime/tools.ts +10 -14
- package/src/storage/sqlite.ts +11 -32
- package/src/templates/blank.ts +15 -102
- package/src/templates/common.ts +60 -0
- package/src/templates/dentista.ts +7 -74
- package/src/templates/skills/agentkit-capsule/SKILL.md +5 -7
- package/src/templates/skills/agentkit-capsule/references/docs-router.md +2 -3
- package/src/templates/skills/agentkit-channels/SKILL.md +6 -119
- package/src/templates/skills/agentkit-channels/references/channel-buffering.md +0 -9
- package/src/templates/skills/agentkit-channels/references/channel-debugging.md +1 -64
- package/src/templates/skills/agentkit-channels/references/discord.md +2 -92
- package/src/templates/skills/agentkit-channels/references/slack.md +2 -55
- package/src/templates/skills/agentkit-channels/references/telegram.md +2 -71
- package/src/templates/skills/agentkit-channels/references/whatsapp-evolution.md +2 -56
- package/src/templates/skills/agentkit-channels/references/whatsapp-uazapi.md +2 -53
- package/src/templates/skills/agentkit-channels/references/whatsapp-zapster.md +2 -70
- package/src/templates/skills/agentkit-database/SKILL.md +2 -4
- package/src/templates/skills/agentkit-evals/SKILL.md +1 -1
- package/src/templates/skills/agentkit-improve/SKILL.md +6 -85
- package/src/templates/skills/agentkit-improve/references/trace-packets.md +1 -1
- package/src/templates/skills/agentkit-provider/SKILL.md +1 -2
- package/src/templates/skills/agentkit-security/SKILL.md +1 -3
- package/src/templates/skills/agentkit-tools/SKILL.md +1 -1
- package/src/templates/skills/agentkit-tools/examples/database-write.tool.md +1 -2
- package/src/templates/skills/agentkit-troubleshooting/SKILL.md +5 -11
- package/src/templates/support.ts +8 -92
- package/docs/guides/add-managed-composio.md +0 -165
- package/docs/guides/improve-from-production.md +0 -151
- package/docs/guides/prepare-deploy.md +0 -227
- package/docs/guides/replay-production-traces.md +0 -72
- package/docs/guides/send-feedback.md +0 -135
- package/src/cli/cloud-client.ts +0 -377
- package/src/cli/deploy-chat-ui.ts +0 -606
- package/src/cli/deploy-readiness.ts +0 -561
- package/src/cloud/artifact.ts +0 -139
- package/src/cloud/client.ts +0 -80
- package/src/cloud/contracts.ts +0 -63
- package/src/cloud/index.ts +0 -3
- package/src/runtime/build.ts +0 -43
- package/src/runtime/core/deploy-state.ts +0 -54
- package/src/runtime/core/manifest.ts +0 -283
- package/src/runtime/core/targets.ts +0 -133
- package/src/runtime/deploy-readiness.ts +0 -135
- package/src/runtime/deploy.ts +0 -1
- package/src/runtime/integrations/composio.ts +0 -425
- package/src/runtime/targets/cloudflare/build.ts +0 -3319
- package/src/runtime/targets/container/build.ts +0 -146
- package/src/runtime/targets/container/server.ts +0 -33
- package/src/runtime/targets/vps/deploy.ts +0 -223
- package/src/templates/skills/agentkit-deploy/SKILL.md +0 -52
- 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-
|
|
15
|
-
- Replay collected traces locally: `docs/guides/replay-
|
|
16
|
-
- Send AgentKit product feedback safely: `docs/guides/
|
|
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
|
-
-
|
|
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 --
|
|
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>
|
|
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
|
-
|
|
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.
|
|
3
|
+
"version": "0.3.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",
|
|
@@ -30,9 +29,8 @@
|
|
|
30
29
|
"agentkit": "bin/agentkit.mjs"
|
|
31
30
|
},
|
|
32
31
|
"dependencies": {
|
|
33
|
-
"@earendil-works/pi-ai": "^0.
|
|
32
|
+
"@earendil-works/pi-ai": "^0.99.2",
|
|
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
|
},
|