@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
@@ -5,14 +5,7 @@ import { fileURLToPath } from "node:url";
5
5
 
6
6
  import { AgentKitError } from "../../runtime/errors";
7
7
  import { findAgentCapsuleRoot, loadAgentCapsule } from "../../runtime/config";
8
- import { readLocalDeployStateIfExists } from "../../runtime/core/deploy-state";
9
8
  import type { ParsedArgs } from "../args";
10
- import {
11
- cloudApiRequest,
12
- readCloudAuthForApiUrl,
13
- resolveCloudApiUrl,
14
- type FeedbackSendResponse,
15
- } from "../cloud-client";
16
9
  import { parseOptionalStringFlag } from "../flags";
17
10
 
18
11
  type FeedbackKind =
@@ -20,11 +13,10 @@ type FeedbackKind =
20
13
  | "confusion"
21
14
  | "missing_docs"
22
15
  | "feature_request"
23
- | "deploy_issue"
24
16
  | "runtime_issue"
25
17
  | "other";
26
18
 
27
- type FeedbackAbout = "last-run" | "deploy" | "manual";
19
+ type FeedbackAbout = "last-run" | "manual";
28
20
 
29
21
  type FeedbackDraft = {
30
22
  schema_version: "agentkit.feedback.v1";
@@ -42,12 +34,11 @@ const feedbackKinds = new Set<FeedbackKind>([
42
34
  "confusion",
43
35
  "missing_docs",
44
36
  "feature_request",
45
- "deploy_issue",
46
37
  "runtime_issue",
47
38
  "other",
48
39
  ]);
49
40
 
50
- const feedbackAboutValues = new Set<FeedbackAbout>(["last-run", "deploy", "manual"]);
41
+ const feedbackAboutValues = new Set<FeedbackAbout>(["last-run", "manual"]);
51
42
 
52
43
  const moduleDir = dirname(fileURLToPath(import.meta.url));
53
44
 
@@ -61,7 +52,6 @@ export async function handleFeedbackCommand(args: ParsedArgs): Promise<void> {
61
52
  console.log("Feedback draft created");
62
53
  console.log(`JSON: ${relativePath(process.cwd(), written.jsonPath)}`);
63
54
  console.log(`Markdown: ${relativePath(process.cwd(), written.markdownPath)}`);
64
- console.log(`Send: agentkit feedback send ${relativePath(process.cwd(), written.jsonPath)}`);
65
55
  return;
66
56
  }
67
57
 
@@ -73,55 +63,14 @@ export async function handleFeedbackCommand(args: ParsedArgs): Promise<void> {
73
63
  return;
74
64
  }
75
65
 
76
- if (subcommand === "send") {
77
- const apiUrl = await resolveCloudApiUrl(args.flags.api);
78
- const auth = await readCloudAuthForApiUrl(apiUrl);
79
-
80
- if (!auth) {
81
- throw new AgentKitError(
82
- "auth_required",
83
- `Log in before sending feedback: agentkit login --token <token> --api ${apiUrl}`,
84
- );
85
- }
86
-
87
- const draft = draftPath
88
- ? await readFeedbackDraft(resolve(process.cwd(), draftPath))
89
- : await buildFeedbackDraft(process.cwd(), args);
90
-
91
- if (!draftPath && args.flags.save === true) {
92
- const written = await writeFeedbackDraft(process.cwd(), draft, args.flags.out);
93
- console.log(`Feedback draft saved: ${relativePath(process.cwd(), written.jsonPath)}`);
94
- }
95
-
96
- const payload = (await cloudApiRequest(apiUrl, "/v1/feedback", {
97
- method: "POST",
98
- headers: {
99
- "Idempotency-Key": draft.client_report_id,
100
- },
101
- body: JSON.stringify(feedbackDraftToSubmission(draft)),
102
- })) as FeedbackSendResponse;
103
-
104
- const feedback = payload.feedback;
105
-
106
- if (!feedback?.id) {
107
- throw new AgentKitError("feedback_response_invalid", "AgentKit Cloud returned an invalid feedback response.");
108
- }
109
-
110
- console.log("Feedback sent");
111
- console.log(`ID: ${feedback.id}`);
112
- console.log(`Kind: ${feedback.kind ?? draft.kind}`);
113
- console.log(`Status: ${feedback.status ?? "new"}`);
114
- return;
115
- }
116
-
117
66
  throw new Error(
118
- "Usage: agentkit feedback create|preview|send [draft.json] [--about last-run|deploy|manual] [--kind bug|confusion|missing_docs|feature_request|deploy_issue|runtime_issue|other] [--summary <text>] [--message <text>] [--api <url>]",
67
+ "Usage: agentkit feedback create|preview [draft.json] [--about last-run|manual] [--kind bug|confusion|missing_docs|feature_request|runtime_issue|other] [--summary <text>] [--message <text>]",
119
68
  );
120
69
  }
121
70
 
122
71
  async function buildFeedbackDraft(cwd: string, args: ParsedArgs): Promise<FeedbackDraft> {
123
72
  const about = parseFeedbackAbout(args.flags.about);
124
- const kind = parseFeedbackKind(args.flags.kind, about === "deploy" ? "deploy_issue" : "other");
73
+ const kind = parseFeedbackKind(args.flags.kind, "other");
125
74
  const message = parseOptionalStringFlag(args.flags.message, "message", "agentkit feedback create --message <text>");
126
75
  const summary =
127
76
  parseOptionalStringFlag(args.flags.summary, "summary", "agentkit feedback create --summary <text>") ??
@@ -150,8 +99,8 @@ async function buildFeedbackDraft(cwd: string, args: ParsedArgs): Promise<Feedba
150
99
  redaction: "agentkit-cli-redaction-v1",
151
100
  note:
152
101
  about === "last-run"
153
- ? "AgentKit does not persist a last-command transcript yet; this draft includes current capsule and deploy context."
154
- : "This draft includes current capsule and deploy context.",
102
+ ? "AgentKit does not persist a last-command transcript yet; this draft includes current capsule context."
103
+ : "This draft includes current capsule context.",
155
104
  },
156
105
  };
157
106
 
@@ -182,7 +131,6 @@ async function collectFeedbackContext(cwd: string): Promise<Record<string, unkno
182
131
  const capsule = await loadAgentCapsule(root).catch((error: unknown) => ({
183
132
  error: error instanceof Error ? error.message : String(error),
184
133
  }));
185
- const deployState = await readLocalDeployStateIfExists(root).catch(() => null);
186
134
 
187
135
  if ("config" in capsule) {
188
136
  context.capsule = {
@@ -205,19 +153,6 @@ async function collectFeedbackContext(cwd: string): Promise<Record<string, unkno
205
153
  };
206
154
  }
207
155
 
208
- if (deployState) {
209
- context.deploy = {
210
- project_id: deployState.project_id,
211
- deploy_id: deployState.deploy_id,
212
- target: deployState.target,
213
- runtime: deployState.runtime,
214
- owner_state: deployState.owner_state,
215
- access: deployState.access,
216
- url: deployState.url,
217
- created_at: deployState.created_at,
218
- };
219
- }
220
-
221
156
  return redactJson(context) as Record<string, unknown>;
222
157
  }
223
158
 
@@ -296,18 +231,6 @@ function validateFeedbackDraft(value: unknown): FeedbackDraft | null {
296
231
  };
297
232
  }
298
233
 
299
- function feedbackDraftToSubmission(draft: FeedbackDraft): Record<string, unknown> {
300
- return {
301
- kind: draft.kind,
302
- summary: draft.summary,
303
- ...(draft.message ? { message: draft.message } : {}),
304
- source: draft.source,
305
- context: draft.context,
306
- diagnostics: draft.diagnostics,
307
- client_report_id: draft.client_report_id,
308
- };
309
- }
310
-
311
234
  function renderFeedbackMarkdown(draft: FeedbackDraft): string {
312
235
  const lines = [
313
236
  "# AgentKit Feedback Draft",
@@ -323,7 +246,6 @@ function renderFeedbackMarkdown(draft: FeedbackDraft): string {
323
246
  }
324
247
 
325
248
  lines.push("## Context", "", "```json", JSON.stringify(draft.context, null, 2), "```", "");
326
- lines.push("Send with the JSON path printed by `agentkit feedback create`:", "", "```sh\nagentkit feedback send <draft.json>\n```", "");
327
249
 
328
250
  return `${lines.join("\n")}\n`;
329
251
  }
@@ -337,7 +259,7 @@ function parseFeedbackKind(value: string | boolean | undefined, fallback: Feedba
337
259
  return value;
338
260
  }
339
261
 
340
- throw new Error("feedback --kind must be bug, confusion, missing_docs, feature_request, deploy_issue, runtime_issue, or other.");
262
+ throw new Error("feedback --kind must be bug, confusion, missing_docs, feature_request, runtime_issue, or other.");
341
263
  }
342
264
 
343
265
  function parseFeedbackAbout(value: string | boolean | undefined): FeedbackAbout {
@@ -349,7 +271,7 @@ function parseFeedbackAbout(value: string | boolean | undefined): FeedbackAbout
349
271
  return value as FeedbackAbout;
350
272
  }
351
273
 
352
- throw new Error("feedback --about must be last-run, deploy, or manual.");
274
+ throw new Error("feedback --about must be last-run or manual.");
353
275
  }
354
276
 
355
277
  function summarizeMessage(message: string | undefined): string | undefined {
@@ -1,4 +1 @@
1
- export const defaultAgentKitCloudApiUrl = "https://agentkit-cloud.aibuilders.com.br";
2
1
  export const defaultAgentKitDevPort = 4123;
3
- export const defaultDeployChatAccessTokenName = "agentkit-chat-ui";
4
- export const defaultDeployChatAccessTokenPath = ".agentkit/chat-access-token.json";
package/src/cli/flags.ts CHANGED
@@ -1,7 +1,5 @@
1
- import { listTargetsWithCapability } from "../runtime/core/targets";
2
1
  import { loadCapsuleEnv } from "../runtime/env";
3
2
  import { AgentKitError } from "../runtime/errors";
4
- import { defaultAgentKitCloudApiUrl } from "./constants";
5
3
 
6
4
  export function parsePort(value: string | boolean | undefined, usage = "agentkit dev --port <number>"): number | undefined {
7
5
  if (value === undefined) {
@@ -21,32 +19,6 @@ export function parsePort(value: string | boolean | undefined, usage = "agentkit
21
19
  return port;
22
20
  }
23
21
 
24
- export function parseTargetFlag(value: string | boolean | undefined, capability: "build" | "deploy"): string {
25
- if (value === undefined) {
26
- return "cloudflare";
27
- }
28
-
29
- if (typeof value !== "string") {
30
- throw new Error(
31
- `Missing target. Usage: agentkit ${capability} --target ${listTargetsWithCapability(capability).join("|")}`,
32
- );
33
- }
34
-
35
- return value;
36
- }
37
-
38
- export function parseCloudApiUrl(value: string | boolean | undefined): string {
39
- if (value === undefined) {
40
- return process.env.AGENTKIT_CLOUD_API_URL ?? defaultAgentKitCloudApiUrl;
41
- }
42
-
43
- if (typeof value !== "string") {
44
- throw new Error("Missing API URL. Usage: agentkit deploy --api <url>");
45
- }
46
-
47
- return value;
48
- }
49
-
50
22
  export function parseRequiredStringFlag(value: string | boolean | undefined, name: string, usage: string): string {
51
23
  if (typeof value !== "string" || value.trim().length === 0) {
52
24
  throw new Error(`Missing ${name}. Usage: ${usage}`);
package/src/cli/help.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  export function renderHelp(): string {
2
2
  return `AgentKit
3
3
 
4
- Create, run, inspect, and deploy Agent Capsules.
4
+ Create, run, and inspect local Agent Capsules.
5
5
 
6
6
  Quick start:
7
7
  agentkit new support-agent --template support
@@ -16,11 +16,10 @@ Start:
16
16
  agentkit new [name] [--template blank|support|dentista] [--no-install]
17
17
  agentkit dev
18
18
  agentkit open
19
- agentkit chat-ui --deploy
20
19
  agentkit chat --message <text> [--conversation-id <id>]
21
20
  agentkit inspect
22
21
 
23
- Build:
22
+ Develop:
24
23
  agentkit knowledge add <path>
25
24
  agentkit knowledge search <query>
26
25
  agentkit spec init --brief <text>
@@ -29,25 +28,14 @@ Build:
29
28
  agentkit db migrate
30
29
  agentkit eval run
31
30
  agentkit eval from-conversation <id>
32
- agentkit improve collect --deploy --since 24h
31
+ agentkit improve collect --since 24h
33
32
  agentkit feedback create --about last-run --kind bug --summary <text>
34
33
  agentkit replay <bundle-dir> --against local
35
34
  agentkit conversations list
36
35
 
37
- Deploy:
38
- agentkit login --token <token>
39
- agentkit deploy doctor
40
- agentkit secret set <NAME> --stdin
41
- agentkit secret sync --from-local
42
- agentkit deploy --smoke "hello"
43
- agentkit deploy status
44
36
 
45
37
  More:
46
- agentkit channels ...
47
- agentkit integrations status
48
- agentkit billing checkout --slots <count>
49
- agentkit account token ...
50
- agentkit access token ...
38
+ agentkit channels list
51
39
  agentkit provider login openai-codex
52
40
  agentkit env ...
53
41
  agentkit feedback create --summary <text>
@@ -63,7 +51,6 @@ Usage:
63
51
  agentkit new [name] [--template blank|support|dentista] [--no-install]
64
52
  agentkit dev [--port <number>]
65
53
  agentkit open
66
- agentkit chat-ui --deploy [--port <number>] [--token-file <path>]
67
54
  agentkit chat --message <text> [--conversation-id <id>]
68
55
  agentkit tool <name> [--input <path-or-json>]
69
56
  agentkit knowledge add <path-or-url>
@@ -80,63 +67,20 @@ Usage:
80
67
  agentkit db seed [--file <path>]
81
68
  agentkit eval run
82
69
  agentkit eval from-conversation <conversation-id> [--out <path>] [--force]
83
- agentkit improve collect [--deploy] [--since <duration|iso>] [--conversation-id <id>] [--out <directory>]
70
+ agentkit improve collect [--since <duration|iso>] [--conversation-id <id>] [--out <directory>]
84
71
  agentkit improve evals <bundle-dir-or-json> [--force]
85
- agentkit feedback create [--about last-run|deploy|manual] [--kind bug|confusion|missing_docs|feature_request|deploy_issue|runtime_issue|other] --summary <text> [--message <text>] [--out <path>]
72
+ agentkit feedback create [--about last-run|manual] [--kind bug|confusion|missing_docs|feature_request|runtime_issue|other] --summary <text> [--message <text>] [--out <path>]
86
73
  agentkit feedback preview [draft.json]
87
- agentkit feedback send [draft.json] [--about last-run|deploy|manual] [--kind <kind>] --summary <text> [--message <text>] [--api <url>] [--save]
88
74
  agentkit replay <bundle-dir-or-json> --against local
89
- agentkit conversations list [--deploy]
90
- agentkit conversations show <conversation-id> [--deploy]
91
- agentkit conversations trace <conversation-id> [--deploy]
75
+ agentkit conversations list
76
+ agentkit conversations show <conversation-id>
77
+ agentkit conversations trace <conversation-id>
92
78
  agentkit channels list
93
- agentkit channels add <website|telegram|whatsapp|discord|slack|webhook> <name> [--provider zapster|meta|uazapi|evolution] [--mode interactions|bot] [--api <url>]
94
- agentkit channels connect <website|telegram|whatsapp|discord|slack|webhook> <name> [--provider zapster|meta|uazapi|evolution] [--mode interactions|bot] [--api <url>]
95
- agentkit channels setup <name> [--apply] [--api <url>]
96
- agentkit channels status <name> [--api <url>]
97
- agentkit channels doctor <name> [--api <url>]
98
- agentkit channels test <name> [--message <text>] [--fixture <path>] [--api <url>]
99
- agentkit channels test-audio <name> [--fixture voice-note|audio-file|<path>] [--api <url>]
100
- agentkit channels deliveries list <name> [--api <url>]
101
- agentkit channels deliveries show <delivery-id> [--api <url>]
102
- agentkit channels buffers list <name> [--api <url>]
103
- agentkit channels buffers show [<name>] <conversation-id> [--api <url>]
104
- agentkit channels buffers flush [<name>] <conversation-id> [--api <url>]
105
- agentkit channels buffers clear [<name>] <conversation-id> [--api <url>]
106
- agentkit channels buffers retry [<name>] <conversation-id> [--api <url>]
107
- agentkit integrations status [--toolkit <slug>] [--api <url>]
108
- agentkit integrations connect composio [--toolkit <slug>] [--callback-url <url>] [--api <url>]
109
79
  agentkit skills status
110
80
  agentkit skills sync
111
81
  agentkit inspect
112
- agentkit build [--target cloudflare|container]
113
82
  agentkit provider login|status|logout openai-codex
114
- agentkit login --token <token> [--api <url>]
115
- agentkit logout
116
- agentkit billing checkout --slots <count> [--email <email>] [--api <url>]
117
- agentkit billing status <billing-intent-id> --secret <secret> [--api <url>]
118
- agentkit billing claim <billing-intent-id> --secret <secret> [--token-name <name>] [--api <url>]
119
- agentkit billing portal [--api <url>]
120
- agentkit account token create <name> [--api <url>] [--use] [--out <path>]
121
- agentkit account token list [--api <url>]
122
- agentkit account token revoke <token-id> [--api <url>]
123
- agentkit deploy [--target cloudflare|vps] [--host <host>] [--api <url>] [--dry-run] [--anonymous] [--local-wrangler] [--smoke <message>]
124
- agentkit deploy doctor [--api <url>] [--anonymous]
125
- agentkit deploy smoke [--message <text>] [--api <url>]
126
- agentkit deploy status [--api <url>]
127
- agentkit deploy pause [--api <url>]
128
- agentkit deploy resume [--api <url>]
129
83
  agentkit transcribe smoke [--provider test|openai|groq] [--model <model>] [--fixture <audio-file>]
130
- agentkit secret set <NAME> <VALUE> [--api <url>]
131
- agentkit secret set <NAME> --stdin [--api <url>]
132
- agentkit secret set <NAME> --from-env [ENV_NAME] [--api <url>]
133
- agentkit secret set <NAME> --from-local-env [--api <url>]
134
- agentkit secret sync --from-local [--api <url>]
135
- agentkit secret list [--api <url>]
136
- agentkit secret unset <NAME> [--api <url>]
137
- agentkit access token create <name> [--api <url>] [--out <path>]
138
- agentkit access token list [--api <url>]
139
- agentkit access token revoke <token-id> [--api <url>]
140
84
  agentkit env set <NAME> <VALUE>
141
85
  agentkit env set <NAME> --stdin
142
86
  agentkit env set <NAME> --from-env [ENV_NAME]
@@ -153,7 +97,6 @@ Commands:
153
97
  new Create a new Agent Capsule
154
98
  dev Run the Agent Capsule locally
155
99
  open Open the local Agent Capsule UI if it is already running
156
- chat-ui Run a local chat UI, optionally pointed at a hosted deploy
157
100
  chat Send one message to the local Agent Capsule
158
101
  tool Run one registered tool directly
159
102
  knowledge Add, sync, inspect, and search local Knowledge sources
@@ -161,24 +104,15 @@ Commands:
161
104
  sync Run or scaffold catalog/data synchronization
162
105
  db Manage the local SQLite database
163
106
  eval Run local eval files or create one from a conversation
164
- improve Collect production or local traces and generate regression evals
165
- feedback Create local redacted feedback drafts and send them to AgentKit Cloud
107
+ improve Collect local traces and generate regression evals
108
+ feedback Create and preview local redacted feedback drafts
166
109
  replay Replay an improve bundle against the local Agent Capsule
167
110
  conversations List, inspect, and trace stored local conversations
168
- channels Manage hosted channel resources
169
- integrations Manage hosted AgentKit-managed integrations
111
+ channels List local channel configuration
170
112
  skills Check or refresh local AgentKit skill files
171
113
  transcribe Smoke-test audio transcription providers
172
114
  inspect Print machine-readable Agent Capsule state
173
- build Build a hosted deploy artifact
174
115
  provider Manage local model-provider login
175
- login Store an AgentKit Cloud alpha token outside the capsule
176
- logout Remove the stored AgentKit Cloud alpha token
177
- billing Buy deploy slots, claim checkout tokens, and open the billing portal
178
- account Manage AgentKit Cloud account tokens
179
- deploy Build and send a hosted artifact to AgentKit Cloud
180
- secret Manage hosted AgentKit Cloud secrets without readback
181
- access Manage hosted deploy access tokens
182
116
  env Manage local .env values without opening code
183
117
  docs Print AgentKit docs locations
184
118
  handoff Print a ready-to-paste prompt for another coding agent
@@ -203,7 +137,6 @@ export function renderCommandHelp(command: string): string {
203
137
  new: "agentkit new [name] [--template blank|support|dentista] [--no-install]",
204
138
  dev: "agentkit dev [--port <number>]",
205
139
  open: "agentkit open",
206
- "chat-ui": "agentkit chat-ui --deploy [--port <number>] [--token-file <path>]",
207
140
  chat: 'agentkit chat --message "hello" [--conversation-id <id>]',
208
141
  tool: "agentkit tool <name> [--input <path-or-json>]",
209
142
  knowledge: "agentkit knowledge add <path-or-url> | sync | inspect | search <query> [--top-k <number>]",
@@ -211,25 +144,16 @@ export function renderCommandHelp(command: string): string {
211
144
  sync: "agentkit sync init [--force] | agentkit sync run [--file <path>]",
212
145
  eval: "agentkit eval run | agentkit eval from-conversation <conversation-id> [--out <path>] [--force]",
213
146
  improve:
214
- "agentkit improve collect [--deploy] [--since <duration|iso>] [--conversation-id <id>] [--out <directory>] | agentkit improve evals <bundle-dir-or-json> [--force]",
147
+ "agentkit improve collect [--since <duration|iso>] [--conversation-id <id>] [--out <directory>] | agentkit improve evals <bundle-dir-or-json> [--force]",
215
148
  feedback:
216
- "agentkit feedback create|preview|send [draft.json] [--about last-run|deploy|manual] [--kind <kind>] [--summary <text>] [--message <text>]",
149
+ "agentkit feedback create|preview [draft.json] [--about last-run|manual] [--kind <kind>] [--summary <text>] [--message <text>]",
217
150
  replay: "agentkit replay <bundle-dir-or-json> --against local",
218
151
  conversations:
219
- "agentkit conversations list [--deploy] | agentkit conversations show <conversation-id> [--deploy] | agentkit conversations trace <conversation-id> [--deploy]",
152
+ "agentkit conversations list | agentkit conversations show <conversation-id> | agentkit conversations trace <conversation-id>",
220
153
  channels:
221
- "agentkit channels list | add | connect | setup | status | doctor | test | test-audio | deliveries | buffers",
154
+ "agentkit channels list",
222
155
  skills: "agentkit skills status | agentkit skills sync",
223
156
  transcribe: "agentkit transcribe smoke [--provider test|openai|groq] [--model <model>] [--fixture <audio-file>]",
224
- deploy:
225
- 'agentkit deploy [--smoke "hello"] | agentkit deploy smoke [--message "hello"] | agentkit deploy doctor | status | pause | resume',
226
- secret:
227
- "agentkit secret set <NAME> --stdin | --from-env [ENV_NAME] | --from-local-env | agentkit secret sync --from-local | list | unset <NAME>",
228
- access: "agentkit access token create <name> [--out <path>] | list | revoke <token-id>",
229
- account: "agentkit account token create <name> [--use] [--out <path>] | list | revoke <token-id>",
230
- billing:
231
- "agentkit billing checkout --slots <count> [--email <email>] | status <intent-id> --secret <secret> | claim <intent-id> --secret <secret> | portal",
232
- integrations: "agentkit integrations status [--toolkit <slug>] | agentkit integrations connect composio [--toolkit <slug>]",
233
157
  provider: "agentkit provider login|status|logout openai-codex",
234
158
  env: "agentkit env set <NAME> --stdin | --from-env [ENV_NAME] | list | unset <NAME>",
235
159
  docs: "agentkit docs path | llms | full",