faceless-cli 1.1.17 → 1.1.18

package/README.md

@@ -37,6 +37,7 @@ Key precedence: `--api-key` flag, then `FACELESS_API_KEY`, then the config file.
 | `faceless logout`              | Remove the saved API key                                              |
 | `faceless whoami`              | Identify the caller (team, plan, scopes)                              |
 | `faceless credits`             | Credit balance and history                                            |
+| `faceless buy-credits`         | Buy a credit pack with an agent payment token (`--pack`, `--token`)   |
 | `faceless videos create`       | Create a faceless video from a script (charges credits)               |
 | `faceless videos captions`     | Caption an existing video or audio URL                                |
 | `faceless videos list`         | List the team's videos                                                |

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "faceless-cli",
-	"version": "1.1.17",
+	"version": "1.1.18",
 	"description": "CLI for Faceless.so: create AI faceless videos, run automated series and publish to YouTube, TikTok, Instagram and more.",
 	"type": "module",
 	"bin": {

package/src/generated/operations.json

@@ -1,6 +1,6 @@
 {
   "generatedFrom": "src/backend/api/v1/spec/registry.mjs",
-  "version": "1.1.17",
+  "version": "1.1.18",
   "baseUrl": "https://faceless.so/api/v1",
   "operations": [
     {
@@ -105,6 +105,67 @@
         }
       }
     },
+    {
+      "operationId": "buyCredits",
+      "method": "post",
+      "path": "/credits",
+      "resource": "credits",
+      "summary": "Buy a credit pack with an agent payment token",
+      "description": "Buys a credit pack and adds the credits to the team immediately, paid with a Stripe Shared Payment Token (spt_...) that the customer approved in their Link agent wallet. Packs: pack_10 ($10, 100 credits), pack_25 ($25, 275), pack_50 ($50, 600); active subscribers get more credits per pack at their plan rate. Request the token for the Faceless.so Stripe profile (profile_61UDMKC11wsLfeXaMA6UDMKCL0SQKAF3aHKCFz33IPL6) with a USD max_amount of at least the pack price. Tokens are single use: retrying with the same token never charges twice. A declined, expired or already used token returns 402 payment_failed.",
+      "scopes": [
+        "credits:write"
+      ],
+      "status": 201,
+      "idempotent": true,
+      "terminalStates": null,
+      "creditCost": "none (adds credits; charges the payment token the pack price in USD)",
+      "cli": {
+        "command": "buy-credits"
+      },
+      "mcp": {
+        "name": "faceless_buy_credits",
+        "enabled": false
+      },
+      "querySchema": null,
+      "requestSchema": {
+        "type": "object",
+        "properties": {
+          "packId": {
+            "type": "string",
+            "enum": [
+              "pack_10",
+              "pack_25",
+              "pack_50"
+            ],
+            "description": "Credit pack to buy: pack_10 ($10), pack_25 ($25) or pack_50 ($50)"
+          },
+          "paymentToken": {
+            "type": "string",
+            "pattern": "^spt_[A-Za-z0-9_]+$",
+            "description": "Stripe Shared Payment Token granted to Faceless.so by the customer's agent wallet"
+          }
+        },
+        "required": [
+          "packId",
+          "paymentToken"
+        ],
+        "additionalProperties": false
+      },
+      "requestExample": {
+        "packId": "pack_10",
+        "paymentToken": "spt_1Rx2abc"
+      },
+      "responseExample": {
+        "success": true,
+        "data": {
+          "packId": "pack_10",
+          "amountUsd": 10,
+          "creditsAdded": 100,
+          "balance": 440,
+          "paymentIntentId": "pi_3Rx2abc"
+        }
+      }
+    },
     {
       "operationId": "createVideo",
       "method": "post",

package/src/index.mjs

@@ -286,6 +286,16 @@ program
 		print(result, { json: cmd.optsWithGlobals().json });
 	});
 
+program
+	.command("buy-credits")
+	.description(getOp("buyCredits").summary)
+	.requiredOption("--pack <id>", "credit pack: pack_10, pack_25 or pack_50")
+	.requiredOption("--token <spt>", "Stripe Shared Payment Token (spt_...) from your agent wallet")
+	.action(async (opts, cmd) => {
+		const result = await execute("buyCredits", { body: { packId: opts.pack, paymentToken: opts.token } }, cmd);
+		print(result, { json: cmd.optsWithGlobals().json });
+	});
+
 const videos = program.command("videos").description("Faceless video projects");
 
 withWaitFlags(