@ambasada/skills 0.6.0 → 0.7.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ambasada/skills",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "description": "Skills for Claude Code, Cursor and Codex: ambasada-product (build a product that sells in the Hack A Ton Village) and ambasada-payments (TON Checkout, receipts, webhooks).",
   "type": "module",
   "files": [

package/skills/ambasada-payments/recipes/nextjs.md

@@ -88,7 +88,7 @@ export async function buy() {
 ## Deliver: the webhook
 
 ```ts
-// app/api/webhook/route.ts   (`ambasada webhook set https://<slug>.hackaton.ambasada.id/api/webhook`)
+// app/api/webhook/route.ts   (`ambasada webhook set https://<slug>.ambasada.dev/api/webhook`)
 import { ambasada } from "../../../lib/ambasada.ts";
 
 export async function POST(req: Request) {

package/skills/ambasada-product/SKILL.md

@@ -9,7 +9,7 @@ The Village is the Hack A Ton market. Everything is paid in **TON**: a play curr
 bank, **not** the TON blockchain. Visitors spend TON from their Ambasada ID wallet; other teams' agents
 buy from you through the Gateway.
 
-A product is **one website** (one Cloudflare Worker) at `https://<your-slug>.hackaton.ambasada.id`, plus
+A product is **one website** (one Cloudflare Worker) at `https://<your-slug>.ambasada.dev`, plus
 **your agent**, which runs the shop (prices, suppliers, deals) while you sleep.
 
 For payment details (Checkout, receipts, webhooks, `buy`/`need`, LLM and images) use the

package/skills/ambasada-product/checklists/sellable.md

@@ -43,7 +43,7 @@ running, except the last section.
 
 ## Online (after `npx ambasada deploy`)
 
-- [ ] `https://<slug>.hackaton.ambasada.id` loads on a phone.
+- [ ] `https://<slug>.ambasada.dev` loads on a phone.
 - [ ] `npx ambasada offerings list`: every endpoint starts with your public URL, none with `localhost`.
 - [ ] `npx ambasada webhook test` prints `delivered`.
 - [ ] One real payment by someone outside your team (members can't buy from their own company) shows up

package/skills/ambasada-product/reference/dev-and-deploy.md

@@ -24,7 +24,7 @@ Try a sale:
 `AMBASADA_API_URL=http://127.0.0.1:8788`, `AMBASADA_API_KEY=sk_test_dev` (already in the project's `.env`).
 More on the mock: the ambasada-payments skill, `reference/test-mode.md`.
 
-## `ambasada deploy`: online at `<slug>.hackaton.ambasada.id`
+## `ambasada deploy`: online at `<slug>.ambasada.dev`
 
 Once, per laptop:
 
@@ -45,7 +45,7 @@ It does, in order:
 1. **build**: `opennextjs-cloudflare build` (Next), `vite build` (spa) or a bundle of the Worker (worker);
 2. **smoke test**: runs the built Worker locally in workerd and requests `/` and `/api/receipt`;
    a crash stops the deploy (skip with `--no-smoke` only if you know why it fails);
-3. **upload** to the Village's hosting: the URL is `https://<your-company-slug>.hackaton.ambasada.id`,
+3. **upload** to the Village's hosting: the URL is `https://<your-company-slug>.ambasada.dev`,
    with `AMBASADA_API_KEY`, `AMBASADA_API_URL` and `AMBASADA_COMPANY` set for you;
 4. **agent and offerings**: pushes `agent/agent.md` + `agent/settings.json`, and lists your offerings at the new URL.
 
@@ -55,13 +55,29 @@ offerings list), `--dry-run` (print what it would push).
 After the first deploy, point the webhook at it and deploy again so the Worker gets the secret:
 
 ```sh
-npx ambasada webhook set https://<slug>.hackaton.ambasada.id/api/webhook
+npx ambasada webhook set https://<slug>.ambasada.dev/api/webhook
 npx ambasada webhook test        # should print "delivered"
 ```
 
 Limits on Village hosting: 10 MB compressed bundle, 1000 static files, short CPU time per request
 (waiting on `fetch` or the LLM does not count). Heavy work belongs in an API you call, not in the Worker.
 
+## `ambasada dev --tunnel`: your laptop, live in the Village
+
+When real buyers, Checkout, webhooks or other teams' agents need to reach the version on your laptop
+(before deploying, or to debug a sale), log in once, then:
+
+```sh
+npx ambasada dev --tunnel     # your dev server, against the real Village, at https://<slug>-dev.ambasada.dev
+npx ambasada tunnel --port 5173   # or: only the tunnel, for a server you started yourself
+```
+
+Until Ctrl+C, `https://<slug>-dev.ambasada.dev` is your product URL. Offerings and the webhook point
+there, and the Shop tab shows "Live from your laptop". On Ctrl+C everything goes back to where it was.
+There is no mock in this mode, so payments are real TON. The first time takes up to 2 minutes while
+the address is published; after that it is instant. Use `--no-register` to share the URL without
+moving offerings. Only one terminal per company at a time: `--force` takes it over. More: docs/TUNNEL.md.
+
 ## `ambasada deploy --own`: your own Cloudflare account
 
 Runs `wrangler deploy` into your account (you need `npx wrangler login` first), then