Update to Omneky

{
  "description": "Company plan upgrade, Stripe Customer Portal, and prepaid credit balance / history for the signed-in Omneky account. Production mcp.omneky.com exposes these tools; still confirm they appear on tools/list before calling. Out of credits → upgrade plan. Never collect a card PAN. Intent keywords: upgrade plan, Stripe portal, invoices, card on file, checkout session, credit balance, billing summary.",
  "included_files": [],
  "name": "omneky-billing",
  "skill_md_contents": "---\nname: omneky-billing\ndescription: >-\n  Company plan upgrade, Stripe Customer Portal, and prepaid credit balance /\n  history for the signed-in Omneky account. Production mcp.omneky.com exposes\n  these tools; still confirm they appear on tools/list before calling. Out of\n  credits → upgrade plan. Never collect a card PAN. Intent keywords: upgrade\n  plan, Stripe portal, invoices, card on file, checkout session, credit\n  balance, billing summary.\n---\n\n# Omneky billing\n\n## Activation analytics\n\nIf the host exposes a skill-activation / analytics hook, call it once per new user request with this skill name; otherwise skip silently. Never invent a tracking tool. Omneky MCP does **not** expose `track_skill_activation`.\n\n## Purpose\n\nOperational plan / portal / prepaid-credit workflows via cgp-backend-backed\nMCP tools. Flow = Stripe Checkout / Customer Portal **URL redirects**. Never\ncomplete Checkout yourself. Never collect a PAN. Never invent Nexus debit or\nprepaid-credit purchase tools.\n\n## When to use\n\n- User asks which plan they are on, remaining credits, card on file, invoices,\n  or wants to upgrade\n- Creative path returned `credit_insufficient`\n- Tools below appear on this session’s `tools/list`\n\n## When not to use\n\n- Paid-media ROAS / campaign spend → `omneky-analytics`\n- Bank transfers / third-party invoices / general payment rails\n- Inventing auto-topup or card-PAN capture\n\n## OpenAI runtime contract\n\n- Use only tools from the current OpenAI host + Omneky MCP (`https://mcp.omneky.com/mcp`). Never invent tools.\n- Prefer native ChatGPT / host widgets and question UI for decisions. Use MCP `request_user_decision` for missing structured fields (not deprecated `ask_user`) when listed. Else `omneky-failure-modes` § Approval / plain-chat fallback.\n- When intake is incomplete, ask **one** concise chat question. Never invent a question tool.\n- Approval turns: end the turn after Approve / Deny (host UI or plain chat); mutate only next turn after Approve.\n- Never invent tokens; OAuth is host-managed.\n\n## Non-negotiable output / safety contract\n\n- Confirm tool names on `tools/list` before calling. Billing tools may be\n  **absent** on some ChatGPT sessions — follow `omneky-failure-modes`\n  § Billing tools absent. If absent, tell the user to manage the plan in the\n  Omneky app / settings; never invent balance or billing tools.\n- Out of credits → **plan upgrade** path (`list_available_plans` +\n  `start_plan_upgrade`, or Customer Portal). Do not invent prepaid purchase.\n- `list_available_plans` returns lookup keys — Nexus has **no dollar prices**\n  here; do not invent a price catalog.\n- Owner-only tools may refuse for non-owners — explain; do not bypass.\n- After handing `checkout_url` / `portal_url`, wait for the user; poll\n  `get_checkout_session_status` **once** after they say they paid (plan-upgrade\n  Checkout only). Managed-launch payment uses\n  `get_managed_launch_payment_status` instead — do not mix them.\n- Credits / deductions: existing MCP balance / history / upgrade tools only\n  (cgp-backend path). Never invent Nexus debit routes.\n- No subscription promo copy in chat — operational gates only (e.g. image ~5 /\n  video ~30 credit callouts belong on creative skills).\n\n## Staged workflow\n\n### Stage 1 — Presence check\n\n1. Confirm allowlisted names exist on `tools/list`. If **absent**, stop —\n   do not invent tools or a fake balance; point to Omneky app / settings\n   (`omneky-failure-modes` § Billing tools absent). Creative siblings may\n   still generate after operational-cost callout and rely on\n   `credit_insufficient` as the hard gate.\n\n### Stage 2 — Snapshot\n\n1. `get_billing_summary` — plan + credit snapshot (not a price catalog).\n2. Optional: `get_company` for identity / plan fields.\n3. Dedicated balance: `get_account_credit_balance` (`credit_balance`,\n   `usd_per_credit`).\n4. Ledger: `get_credit_history` (capped JSON rows).\n5. Card on file: `get_payment_method_summary` (brand / last4 / expiry only).\n\n### Stage 3 — Upgrade / portal\n\n1. `list_available_plans` → keys such as `cgp_standard_monthly`, …\n2. Either:\n   - `start_plan_upgrade` with a chosen key (saved-card change or\n     `checkout_url`), **or**\n   - `create_billing_portal_session` → `portal_url` when the user should pick\n     a plan / see live prices / invoices.\n3. Ask the user to open the URL in the browser. End turn if waiting.\n\n### Stage 4 — After payment\n\n1. User says they finished plan-upgrade Checkout →\n   `get_checkout_session_status` **once**.\n2. Re-read `get_account_credit_balance` / `get_billing_summary` if useful.\n3. Managed-launch `status=payment_required` Checkout →\n   `get_managed_launch_payment_status` (not `get_checkout_session_status`).\n\n### Stage 5 — Hand back\n\nReturn to `omneky-creative` / `omneky-image-ads` / `omneky-product-video`\nwhen the original intent was generation.\n\n## Allowlisted tools (when listed)\n\n`get_billing_summary`, `get_company`, `get_account_credit_balance`,\n`get_credit_history`, `list_available_plans`, `start_plan_upgrade`,\n`create_billing_portal_session`, `get_payment_method_summary`,\n`get_checkout_session_status`, `get_managed_launch_payment_status`.\n\n## Failure boundaries\n\n| Failure | Required response |\n| --- | --- |\n| Tools missing from `tools/list` | Stop; Omneky app / settings; never invent tools (`omneky-failure-modes` § Billing tools absent). |\n| Non-owner on upgrade / portal | Explain owner-only; do not invent bypass. |\n| User pastes card PAN in chat | Refuse to process PAN; send them to Stripe portal URL only. |\n| Invented prepaid top-up tool | Refuse; use plan upgrade / portal. |\n| Tight-loop checkout polling | One `get_checkout_session_status` after user confirmation. |\n| Confused managed-launch vs plan Checkout | Use the matching status tool only. |\n| `credit_insufficient` mid-creative | If balance/upgrade tools present → upgrade path; else Omneky app; do not retry generate until funded. |\n\n## Sibling map\n\n| Need | Skill |\n| --- | --- |\n| Balance-only gate | `omneky-credit-balance` |\n| Resume image/video after top-up | `omneky-creative` / `omneky-image-ads` / `omneky-product-video` |\n| Auth / tool missing | `omneky-failure-modes` / `omneky-getting-started` |\n\n## Never invent\n\n- Prepaid-credit purchase, auto-topup, webhook, or card-PAN tools\n- Nexus debit routes or non-cgp balance endpoints\n- Dollar prices from `list_available_plans` (keys only)\n"
}