@andreprado/agentkit 0.1.0-alpha.2 → 0.1.0-alpha.3

package/README.md

@@ -1,21 +1,54 @@
 # AgentKit
 
-AgentKit is a toolkit for creating, running, inspecting, and deploying Agent Capsules.
+AgentKit is a CLI-first toolkit for creating, running, inspecting, and deploying Agent Capsules.
+
+## Quick Start
 
 ```sh
 npx @andreprado/agentkit@alpha new support-agent --template support
 cd support-agent
-npm install
 npm run dev
+npm run chat -- --message "hello"
+```
+
+`agentkit new` installs the generated capsule dependencies by default so `agentkit.config.ts` resolves `@andreprado/agentkit` immediately in editors. Use `--no-install` only for offline or scripted scaffolds where you want to run `npm install` later.
+
+Generated capsules use the built-in `test/fake` provider by default, so the first local run works without provider keys.
+
+## What To Know First
+
+```sh
+agentkit new <name> [--template blank|support] [--no-install]
+agentkit dev
+agentkit chat --message <text>
+agentkit inspect
 ```
 
-Local scaffolding, development, inspection, evals, and builds do not require an AgentKit Cloud token. Hosted production deploys do:
+Once the capsule is running:
 
 ```sh
-agentkit login --token agk_user_...
+agentkit tool <name> [--input <path-or-json>]
+agentkit db migrate
+agentkit eval run
+agentkit conversations list
+```
+
+## Deploy Later
+
+```sh
+agentkit login --token <token>
 agentkit deploy doctor
-agentkit secret set OPENAI_API_KEY "$OPENAI_API_KEY"
+agentkit secret set OPENAI_API_KEY --from-local-env
 agentkit deploy
+agentkit deploy status
+agentkit chat-ui --deploy
 ```
 
-See `docs/guides/create-agent.md` and `docs/guides/prepare-deploy.md` for the user workflow.
+Production secrets are managed secrets, not committed `.env` values.
+Private hosted deploys automatically store a local chat/UI deploy access token at `.agentkit/chat-access-token.json`. `agentkit chat-ui --deploy` serves a local UI pointed at the hosted deploy without exposing that token to browser code.
+
+The npm package contains the public CLI/runtime/client surface only. AgentKit Cloud's control-plane server, operator commands, Postgres store, and Cloudflare/Turso/R2 publisher live in the private repo workspace and are not part of the published package.
+
+## Full Reference
+
+`agentkit --help` keeps the first surface focused. Run `agentkit help commands` for the full CLI reference and `agentkit docs full` for the full agent-facing operating contract.

package/docs/guides/create-agent.md

@@ -19,7 +19,6 @@ cd /tmp/agentkit-demo
 
 npx @andreprado/agentkit@alpha new demo --template blank
 cd demo
-npm install
 npm run typecheck
 npm run chat -- --message "hello"
 npm run agentkit -- conversations list
@@ -37,7 +36,6 @@ For the support template:
 ```sh
 npx @andreprado/agentkit@alpha new support-demo --template support
 cd support-demo
-npm install
 npm run agentkit -- tool lookup_order --input '{"orderId":"A100"}'
 ```
 
@@ -173,7 +171,7 @@ npm install
 npm run typecheck
 ```
 
-Make sure `tsconfig.json` has `moduleResolution: "Bundler"`.
+`agentkit new` installs dependencies by default. Run this if the scaffold was created with `--no-install`, the install failed, or `node_modules` was deleted. Make sure `tsconfig.json` has `moduleResolution: "Bundler"`.
 
 `No agentkit.config.ts found`:
 

package/docs/guides/prepare-deploy.md

@@ -19,7 +19,6 @@ Use this before asking a coding agent to make a capsule deployable, or before te
 From the capsule root:
 
 ```sh
-npm install
 npm run typecheck
 npm run agentkit -- inspect
 npm run agentkit -- db migrate
@@ -132,6 +131,8 @@ npm run agentkit -- deploy status
 npm run agentkit -- access token list
 ```
 
+For private hosted deploys, `npm run agentkit -- deploy` writes the local chat/UI access token to `.agentkit/chat-access-token.json`. Use `npm run agentkit -- access token create <name> --out <path>` only for additional clients.
+
 ## Readiness Checklist
 
 ```txt

package/docs/llms-full.txt

@@ -35,6 +35,7 @@ Implemented local commands:
 ```sh
 agentkit new <name> --template blank
 agentkit new <name> --template support
+agentkit new <name> --template blank --no-install
 agentkit chat --message "hello"
 agentkit tool <name> --input <path-or-json>
 agentkit eval run
@@ -95,7 +96,6 @@ cd /tmp/agentkit-demo
 
 npx @andreprado/agentkit@alpha new demo --template blank
 cd demo
-npm install
 npm run chat -- --message "hello"
 npm run chat -- --message "second message"
 npm run eval
@@ -117,7 +117,6 @@ The primary flow is:
 ```sh
 agentkit new eye-office-agent --template blank
 cd eye-office-agent
-npm install
 ```
 
 Then open the folder in Codex, Claude Code, or another coding agent and ask directly:
@@ -652,7 +651,7 @@ agentkit deploy
 agentkit deploy status
 ```
 
-`agentkit deploy doctor` checks AgentKit Cloud login, `cloudflare_deploy_alpha`, hosted secrets, local `.env` names that still need `agentkit secret set`, and private-access runtime token handling. `agentkit deploy` sends the capsule to AgentKit Cloud and runs the same readiness check automatically before building and uploading. Production alpha deploys require an account with `cloudflare_deploy_alpha`; local commands and dry-run builds do not require login. AgentKit owns infrastructure selection, backend migration, managed secrets, and public URL creation.
+`agentkit deploy doctor` checks AgentKit Cloud login, `cloudflare_deploy_alpha`, hosted secrets, local `.env` names that still need `agentkit secret set`, and private-access runtime token handling. `agentkit deploy` sends the capsule to AgentKit Cloud, runs the same readiness check automatically before building and uploading, and writes the local chat/UI deploy access token to `.agentkit/chat-access-token.json` for private hosted deploys. Production alpha deploys require an account with `cloudflare_deploy_alpha`; local commands and dry-run builds do not require login. AgentKit owns infrastructure selection, backend migration, managed secrets, and public URL creation.
 
 The CLI defaults to the hosted AgentKit Cloud API at `https://agentkit-cloud.aibuilders.com.br`. Use `AGENTKIT_CLOUD_API_URL` or `agentkit deploy --api <url>` only for local or alternate control-plane tests.
 
@@ -661,7 +660,7 @@ Account/access flow:
 ```sh
 agentkit secret set OPENAI_API_KEY
 agentkit secret list
-agentkit access token create website-chat
+agentkit access token create website-chat --out .agentkit/website-chat-access-token.json
 agentkit access token list
 ```
 
@@ -710,6 +709,8 @@ npm install
 npm run typecheck
 ```
 
+`agentkit new` installs dependencies by default. Run this if the scaffold used `--no-install`, the install failed, or `node_modules` was deleted.
+
 Make sure `tsconfig.json` contains:
 
 ```json

package/docs/llms.txt

@@ -25,6 +25,7 @@ Current local commands:
 
 ```sh
 agentkit new <name> --template blank|support
+agentkit new <name> --template blank --no-install
 agentkit docs full
 agentkit env list
 agentkit env unset <NAME>
@@ -45,7 +46,7 @@ agentkit deploy doctor
 agentkit deploy
 agentkit deploy status
 agentkit secret list
-agentkit access token create website-chat
+agentkit access token create website-chat --out .agentkit/website-chat-access-token.json
 agentkit access token list
 agentkit inspect
 agentkit dev

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andreprado/agentkit",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.3",
   "private": false,
   "type": "module",
   "repository": {
@@ -36,7 +36,6 @@
     "@earendil-works/pi-ai": "^0.75.5",
     "@earendil-works/pi-coding-agent": "^0.75.5",
     "esbuild": "^0.28.0",
-    "postgres": "^3.4.9",
     "tsx": "^4.22.3",
     "typebox": "^1.1.38"
   },