@layers/amba-mcp 4.0.2 → 4.0.4

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.
@@ -96,6 +96,14 @@ Tell the user where their credentials live:
96
96
 
97
97
  **Already have a PAT?** Skip the signup. Call \`amba_developer_me({})\` to verify the Bearer; if it succeeds, either reuse the most recent project (\`amba_projects_list\`) or call \`amba_projects_create({ name: "<app-name>", platform: "all" })\` and then \`amba_api_keys_create\` twice to mint client + server keys for \`environment: "development"\`.
98
98
 
99
+ **Can't reach \`amba_developer_signup\` — it's not in your tool list, or your harness blocks the call?** Do NOT try to work around it by adding the MCP server yourself, running an installer, or editing your own settings/permissions — refusing to self-modify or widen your own permissions is the correct call, and you should not circumvent it. Instead, hand the developer **one** command to run in **their own** terminal (which is not subject to your sandbox):
100
+
101
+ \`\`\`bash
102
+ npx @layers/amba init
103
+ \`\`\`
104
+
105
+ It creates the account with no browser and writes \`AMBA_PROJECT_ID\` + \`AMBA_CLIENT_KEY\` to \`.env.local\` (and wires this MCP server up for your next session). Ask them to run it, tell you when it's done, then resume from this Step 0 by reading \`.env.local\`. Asking the developer to paste an \`amb_ck_…\` client key is the last-resort lite path — it's enough to wire \`Amba.configure()\` + runtime calls and verify events land, but a client key alone can't do admin provisioning (creating achievements, collections, segments, etc.), which needs the PAT or server key.
106
+
99
107
  ## Step 1 — Classify the app
100
108
 
101
109
  Look at what the user told you and at any files they shared. You're trying to pick one of ten presets in 30 seconds, not write a treatise. Inputs:
@@ -217,7 +225,7 @@ SKIPPED (low signal — re-run with /amba <feature> if you want them)
217
225
  NEEDS YOUR INPUT
218
226
  - Apple Sign In: add the "Sign in with Apple" capability in Xcode > Signing & Capabilities.
219
227
  - Google Sign In: paste your Google OAuth client ID into amba_projects_update({ google_oauth_client_id: "..." }).
220
- - APNs / FCM: upload credentials in app.amba.dev before push delivers.
228
+ - APNs / FCM: configure credentials with amba_integrations_configure (paste the .p8 / service-account JSON inline) before push delivers.
221
229
 
222
230
  NEXT STEPS
223
231
  - Paste AMBA_CLIENT_KEY into your build env (already shown above)
@@ -279,7 +287,7 @@ All SDKs expose the same surface: \`Amba.configure({ projectId, apiKey })\`, the
279
287
  - **challenges** — time-bounded goals. Define with \`amba_challenges_create\`; progress via SDK.
280
288
 
281
289
  ### Economy
282
- - **currencies** — virtual currencies (coins, gems). Define with \`amba_currencies_create\`; grant via \`amba_currencies_grant\` or event rules via \`amba_currency_grant_rules_create\`.
290
+ - **currencies** — virtual currencies (coins, gems). Define with \`amba_currencies_create\`; grant via \`amba_currencies_grant\` or event rules via \`amba_currency_grant_rules_create\`; debit via \`amba_currencies_spend\` (atomic, rejects on insufficient funds).
283
291
  - **catalog + stores** — purchasable items + storefronts. Chain: \`amba_catalog_items_create\` → \`amba_catalog_items_set_price\` → \`amba_stores_create\` → \`amba_stores_add_listing\`. (Define currency first.)
284
292
  - **inventory** — items users own. Read via SDK \`Amba.inventory.*\`; grant with \`amba_inventory_grant_item\`.
285
293
 
@@ -302,7 +310,7 @@ All SDKs expose the same surface: \`Amba.configure({ projectId, apiKey })\`, the
302
310
  - **sites** — static site hosting at \`*.app.amba.host\`. Deploy with \`amba_sites_deploy\`.
303
311
  - **media** — file storage + CDN. Upload via \`amba_media_upload\`.
304
312
  - **secrets** — env vars for functions. Set via \`amba_secrets_set\`.
305
- - **configs** — remote config flags. Define with \`amba_configs_create\`.
313
+ - **configs** — remote config flags. Define with \`amba_remote_configs_create\`.
306
314
  - **integrations** — third-party webhooks (RevenueCat, Superwall, AppsFlyer, etc.). Configure with \`amba_integrations_configure\`.
307
315
  - **ai_prompts** — versioned LLM prompts callable from SDK. Define with \`amba_ai_prompts_create\`; call via \`amba_ai_prompts_invoke\`.
308
316
  `;