@remixmate/cli 0.9.14 → 0.9.15

package/dist/billing.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Billing capture — makes credit consumption visible to whoever ran the skill.
+ *
+ * Credits are deducted server-side and used to be invisible here: a run printed
+ * its image/video URL and nothing else, so the first time a user noticed the
+ * credit system at all was the `insufficient_credits` error after the balance
+ * had already run out. ab-api now attaches a `billing` object to the envelope of
+ * every response that charged something (see core.Success / credits_billing.go);
+ * this module accumulates those across all the calls a single skill run makes —
+ * a gen-image run polls, a gen-video run polls, and each may charge once — and
+ * renders one footer at the end.
+ *
+ * Two outputs, two audiences, both on stdout:
+ *   - a human-readable footer, which is what the agent relays to the user.
+ *   - one `__progress__` line (phase `billing`) — the existing machine protocol,
+ *     already parsed by ab-agent's executor and skipped by the line-scanning
+ *     parsers in render_video.py, so a nested pipeline caller can aggregate a
+ *     whole run's spend without a new stdout contract.
+ *
+ * Both go to stdout rather than stderr (where the auth footer lives) because
+ * ab-agent hands the LLM `result.stdout || result.stderr` (mcp-tools.ts) — a
+ * stderr-only footer would be invisible in the hosted agent, visible only when
+ * a local host like codex shows both streams. Adding stdout lines is safe:
+ * emitProgress already writes NDJSON there, so no consumer can be treating
+ * stdout as a single JSON document.
+ */
+export interface BillingItem {
+    credits: number;
+    bizType?: string;
+    detail?: string;
+}
+/** The `billing` object ab-api attaches to a charged response. */
+export interface Billing {
+    credits: number;
+    balance: number;
+    items?: BillingItem[];
+}
+/** Accumulate one response's billing object; no-ops on responses that charged nothing. */
+export declare function recordBilling(billing: Billing | undefined | null): void;
+/** Everything charged so far in this process, or null when nothing was. */
+export declare function billingSummary(): Billing | null;
+export declare function emitBillingFooter(): void;
+/** Test seam — resets the accumulator between runs in-process. */
+export declare function resetBilling(): void;

package/dist/billing.js

@@ -0,0 +1,76 @@
+/**
+ * Billing capture — makes credit consumption visible to whoever ran the skill.
+ *
+ * Credits are deducted server-side and used to be invisible here: a run printed
+ * its image/video URL and nothing else, so the first time a user noticed the
+ * credit system at all was the `insufficient_credits` error after the balance
+ * had already run out. ab-api now attaches a `billing` object to the envelope of
+ * every response that charged something (see core.Success / credits_billing.go);
+ * this module accumulates those across all the calls a single skill run makes —
+ * a gen-image run polls, a gen-video run polls, and each may charge once — and
+ * renders one footer at the end.
+ *
+ * Two outputs, two audiences, both on stdout:
+ *   - a human-readable footer, which is what the agent relays to the user.
+ *   - one `__progress__` line (phase `billing`) — the existing machine protocol,
+ *     already parsed by ab-agent's executor and skipped by the line-scanning
+ *     parsers in render_video.py, so a nested pipeline caller can aggregate a
+ *     whole run's spend without a new stdout contract.
+ *
+ * Both go to stdout rather than stderr (where the auth footer lives) because
+ * ab-agent hands the LLM `result.stdout || result.stderr` (mcp-tools.ts) — a
+ * stderr-only footer would be invisible in the hosted agent, visible only when
+ * a local host like codex shows both streams. Adding stdout lines is safe:
+ * emitProgress already writes NDJSON there, so no consumer can be treating
+ * stdout as a single JSON document.
+ */
+import { emitProgress } from './progress.js';
+let creditsCharged = 0;
+let latestBalance = null;
+const chargedItems = [];
+/** Accumulate one response's billing object; no-ops on responses that charged nothing. */
+export function recordBilling(billing) {
+    if (!billing || typeof billing.credits !== 'number' || billing.credits <= 0)
+        return;
+    creditsCharged += billing.credits;
+    if (typeof billing.balance === 'number')
+        latestBalance = billing.balance;
+    for (const item of billing.items ?? []) {
+        if (item && typeof item.credits === 'number' && item.credits > 0)
+            chargedItems.push(item);
+    }
+}
+/** Everything charged so far in this process, or null when nothing was. */
+export function billingSummary() {
+    if (creditsCharged <= 0)
+        return null;
+    return { credits: creditsCharged, balance: latestBalance ?? 0, items: [...chargedItems] };
+}
+/**
+ * Emit the footer for what this process charged. Safe to call on the error path
+ * too: a run can fail after a successful (already billed) generation step, and
+ * that spend still needs to be reported.
+ *
+ * Idempotent — only the first call prints, so a handler and the dispatcher can
+ * both reach for it without doubling the number the user sees.
+ */
+let emitted = false;
+export function emitBillingFooter() {
+    if (emitted)
+        return;
+    const summary = billingSummary();
+    if (!summary)
+        return;
+    emitted = true;
+    emitProgress({ phase: 'billing', credits: summary.credits, balance: summary.balance, items: summary.items });
+    const balance = summary.balance.toLocaleString('en-US');
+    const credits = summary.credits.toLocaleString('en-US');
+    process.stdout.write(`\n💳 Charged ${credits} credits · balance ${balance}\n`);
+}
+/** Test seam — resets the accumulator between runs in-process. */
+export function resetBilling() {
+    creditsCharged = 0;
+    latestBalance = null;
+    chargedItems.length = 0;
+    emitted = false;
+}

package/dist/http.d.ts

@@ -18,6 +18,7 @@
  *   3. process.env.MM_BACKEND_API_URL   — ab-agent's convention (back-compat)
  *   4. https://api.remixmate.com/api    — production default (zero-config)
  */
+import { type Billing } from './billing.js';
 export { SkillError, EXIT } from './errors.js';
 /**
  * Resolve the ab-api base URL the same way for authenticated and device-flow calls.
@@ -49,6 +50,8 @@ export interface MmResponse<T = unknown> {
     code: number;
     msg?: string;
     data?: T;
+    /** Present only on responses that charged credits — see billing.ts. */
+    billing?: Billing;
 }
 /**
  * POST JSON to ab-api and return the parsed business payload.

package/dist/http.js

@@ -18,6 +18,7 @@
  *   3. process.env.MM_BACKEND_API_URL   — ab-agent's convention (back-compat)
  *   4. https://api.remixmate.com/api    — production default (zero-config)
  */
+import { recordBilling } from './billing.js';
 import { resolvePrivToken, NOT_AUTHENTICATED_HINT } from './auth/resolve.js';
 import { attemptAutoLogin } from './auth/auto-login.js';
 import { EXIT, SkillError } from './errors.js';
@@ -120,6 +121,9 @@ export async function mmPost(ctx, pathOrUrl, body, opts = {}) {
     catch {
         throw new SkillError(`❌ failed to parse response, body is not JSON: ${text.slice(0, 200)}`);
     }
+    // Before the code check: a charged response is always code=0 today, but a
+    // partial-failure envelope that still billed must not lose its billing line.
+    recordBilling(parsed.billing);
     if (parsed.code !== 0) {
         // ab-api reports auth failures in the envelope (HTTP 200 + code=401), so the
         // business-code path needs the same 401 → "re-authorize" mapping as above.

package/dist/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "version": "0.9.14",
-  "generatedAt": "2026-08-12T07:37:21.011Z",
+  "version": "0.9.15",
+  "generatedAt": "2026-08-14T08:23:17.130Z",
   "skills": [
     {
       "id": "export-jianying",

package/dist/runner.js

@@ -15,6 +15,7 @@ import { findSkill, SKILLS_DIR } from './registry.js';
 import { HANDLERS } from './handlers/index.js';
 import { EXIT, SkillError } from './errors.js';
 import { authChildEnv, ensureAuth } from './auth/ensure.js';
+import { emitBillingFooter } from './billing.js';
 /** Read the token override accepted by both the TS handlers and the Python skills. */
 function tokenFlag(args) {
     const value = args.token ?? args.priv_token;
@@ -34,6 +35,8 @@ export async function runSkill(skillName, opts) {
         });
         switch (skill.entry.type) {
             case 'python':
+                // Python children talk to ab-api themselves and print their own billing
+                // footer; nothing was charged through this process.
                 return await runPython(skill, opts.rawArgs, auth);
             case 'http':
             case 'builtin':
@@ -48,6 +51,12 @@ export async function runSkill(skillName, opts) {
         process.stderr.write(`❌ unexpected error: ${err.message}\n`);
         return EXIT.ERROR;
     }
+    finally {
+        // In `finally` because a run can fail *after* a billed step (e.g. the image
+        // generated and was charged, then the upload timed out) — spend gets
+        // reported either way. No-ops when nothing was charged.
+        emitBillingFooter();
+    }
 }
 async function runPython(skill, rawArgs, auth) {
     if (!skill.scriptAbsolutePath) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remixmate/cli",
-  "version": "0.9.14",
+  "version": "0.9.15",
   "description": "AI media generation skills for Claude Code / Codex — 12 skills covering image, video, voice, digital human, web screenshot, web recording, script, template registry, rendering, Jianying export, and video deconstruction.",
   "type": "module",
   "main": "dist/index.js",

package/skills/gen-digital-human/SKILL.md

@@ -175,6 +175,18 @@ remixmate gen-digital-human --check-status --generation-id 123
 - Keep individual jobs under ~500 characters.
 - Tone and style of the script affect the perceived voice.
 
+## Credits
+
+Every run charges credits. The CLI prints a footer on stdout when it does:
+
+```
+💳 Charged 31 credits · balance 1,240
+```
+
+Relay it to the user whenever it appears — it is the only signal they get about what a
+generation cost, and the balance is the only warning before a run fails with
+`insufficient_credits`. Do not drop it from your summary.
+
 ## Error handling
 
 - **401** / **token missing** (non-OpenClaw): set `PRIV_TOKEN`.

package/skills/gen-image/SKILL.md

@@ -122,6 +122,18 @@ remixmate gen-image \
 | `--api-base-url` | Override API root | see above |
 | `--priv-token` | Override token | see above |
 
+## Credits
+
+Every run charges credits. The CLI prints a footer on stdout when it does:
+
+```
+💳 Charged 31 credits · balance 1,240
+```
+
+Relay it to the user whenever it appears — it is the only signal they get about what a
+generation cost, and the balance is the only warning before a run fails with
+`insufficient_credits`. Do not drop it from your summary.
+
 ## Error handling
 
 - **401** / **token missing** (non-OpenClaw): set `PRIV_TOKEN`.

package/skills/gen-video/SKILL.md

@@ -150,6 +150,18 @@ remixmate gen-video \
 - Describe motion explicitly.
 - Example: `"At sunrise, an aerial drone shot of a futuristic city, golden light on glass facades, mist swirling, 4K ultra-clear"`.
 
+## Credits
+
+Every run charges credits. The CLI prints a footer on stdout when it does:
+
+```
+💳 Charged 31 credits · balance 1,240
+```
+
+Relay it to the user whenever it appears — it is the only signal they get about what a
+generation cost, and the balance is the only warning before a run fails with
+`insufficient_credits`. Do not drop it from your summary.
+
 ## Error handling
 
 - **401** / **token missing** (non-OpenClaw): set `PRIV_TOKEN`.

package/skills/gen-voice/SKILL.md

@@ -95,6 +95,18 @@ remixmate gen-voice --text "<text-to-synthesize>" --json-output
 | Voice-over / narration | 1.0–1.2 |
 | Fast announcement | 1.2–1.5 |
 
+## Credits
+
+Every run charges credits. The CLI prints a footer on stdout when it does:
+
+```
+💳 Charged 31 credits · balance 1,240
+```
+
+Relay it to the user whenever it appears — it is the only signal they get about what a
+generation cost, and the balance is the only warning before a run fails with
+`insufficient_credits`. Do not drop it from your summary.
+
 ## Error handling
 
 - **401** / **token missing** (non-OpenClaw): set `PRIV_TOKEN`.

package/skills/prepare-video-assets/SKILL.md

@@ -195,6 +195,18 @@ The Asset Resolver handles each `AssetRef` in this order:
 4. **Parallel generation**: assets of the same type are generated in parallel; different types are sequenced by dependency.
 5. **Cache reuse**: assets with the same payload are checked against `asset-cache-dir` to avoid duplicate generation.
 
+## Credits
+
+Every run charges credits. The CLI prints a footer on stdout when it does:
+
+```
+💳 Charged 31 credits · balance 1,240
+```
+
+Relay it to the user whenever it appears — it is the only signal they get about what a
+generation cost, and the balance is the only warning before a run fails with
+`insufficient_credits`. Do not drop it from your summary.
+
 ## Error handling
 
 - **DSL validation failed**: pre-validate with `gen-script --validate`.

package/skills/render-video/SKILL.md

@@ -210,6 +210,18 @@ The Remotion render project lives at the monorepo root under `<monorepo-root>/re
 - Production (default): the client uses `https://api-render.remixmate.com` when `REMOTION_RENDER_API_URL` is unset — no config needed.
 - Local debugging: in the renderer directory run `npm install && npm run server:dev`, then point the client at it with `REMOTION_RENDER_API_URL=http://localhost:3000`.
 
+## Credits
+
+Every run charges credits. The CLI prints a footer on stdout when it does:
+
+```
+💳 Charged 31 credits · balance 1,240
+```
+
+Relay it to the user whenever it appears — it is the only signal they get about what a
+generation cost, and the balance is the only warning before a run fails with
+`insufficient_credits`. Do not drop it from your summary.
+
 ## Error handling
 
 - **`job_id` missing or not assets-ready**: the script exits non-zero with a message like "render job N is not in assets-ready state". The agent should call `prepare_video_assets` again with the updated DSL to regenerate, then re-call this skill with the new `job_id`.

package/skills/render-video/scripts/render_video.py

@@ -24,6 +24,7 @@
 """
 
 import argparse
+import atexit
 import builtins
 import json
 import os
@@ -356,6 +357,62 @@ def LogPrint(*args, sep=" ", end="\n", file=None, flush=False):
     builtins.print(f"[{stamp}] {message}", end=end, file=file, flush=flush)
 
 
+# ─── 扣费汇总 ────────────────────────────────────────────────────────────────
+# 一条视频管线的花费分散在多处：每个 gen-image / gen-voice / gen-video /
+# gen-digital-human 子进程各扣一次，渲染再通过 saveManifest 扣一次。子进程是
+# capture_output 起的，它们自己打的 💳 页脚会被吞掉，所以这里把子进程 stdout 里的
+# billing 事件抓出来累加，最后统一报一次总账——否则用户跑完一整条管线，只知道视频
+# 好了，不知道花了多少积分。
+_BILLING: dict = {"credits": 0, "balance": None}
+
+
+def absorb_child_billing(stdout: str) -> None:
+    """从子 skill 的 stdout 里收集 `__progress__` billing 事件（见 CLI src/billing.ts）。"""
+    for line in (stdout or "").splitlines():
+        line = line.strip()
+        if not line.startswith("{") or "__progress__" not in line:
+            continue
+        try:
+            event = json.loads(line)
+        except json.JSONDecodeError:
+            continue
+        if not isinstance(event, dict) or event.get("phase") != "billing":
+            continue
+        credits = event.get("credits")
+        if not isinstance(credits, (int, float)) or credits <= 0:
+            continue
+        _BILLING["credits"] += int(credits)
+        balance = event.get("balance")
+        if isinstance(balance, (int, float)):
+            _BILLING["balance"] = int(balance)
+
+
+def print_billing_footer() -> None:
+    """收尾时报一次总账。通过 atexit 注册，所以 sys.exit / 中途失败也会打印
+    ——已经发生的扣费不该因为后面某一步失败就不告知用户。
+
+    走 stdout 而不是 stderr：ab-agent 交给 LLM 的是 `result.stdout || result.stderr`
+    （mcp-tools.ts），只写 stderr 在托管 agent 里等于不可见。
+    """
+    credits = _BILLING["credits"]
+    balance = _BILLING["balance"]
+    try:
+        import render_job_client  # type: ignore
+
+        job_billing = render_job_client.billing_summary()
+        if job_billing.get("credits"):
+            credits += int(job_billing["credits"])
+            # saveManifest（渲染扣费）在管线里排最后，它带回的余额最新。
+            if job_billing.get("balance") is not None:
+                balance = int(job_billing["balance"])
+    except Exception:  # noqa: BLE001 — 报账失败绝不能影响已完成的渲染
+        pass
+    if credits <= 0:
+        return
+    suffix = f" · balance {balance:,}" if balance is not None else ""
+    builtins.print(f"\n💳 Charged {credits:,} credits{suffix}", flush=True)
+
+
 def sync_chrome_headless_vendor(renderer_dir: str, render_plan: dict) -> None:
     """Chrome Headless vendor 同步——实现已抽到独立模块 ``_chrome_vendor``。
 
@@ -758,6 +815,7 @@ def resolve_asset_image(asset: dict, private_token: str, timeout: int) -> dict:
 
     try:
         result = subprocess.run(cmd, capture_output=True, text=True, timeout=timeout, stdin=subprocess.DEVNULL)
+        absorb_child_billing(result.stdout)
         if result.returncode == 0:
             for line in reversed(result.stdout.strip().split("\n")):
                 line = line.strip()
@@ -809,6 +867,7 @@ def resolve_asset_audio(asset: dict, private_token: str, timeout: int) -> dict:
 
     try:
         result = subprocess.run(cmd, capture_output=True, text=True, timeout=timeout, stdin=subprocess.DEVNULL)
+        absorb_child_billing(result.stdout)
         if result.returncode == 0:
             for line in reversed(result.stdout.strip().split("\n")):
                 line = line.strip()
@@ -854,6 +913,7 @@ def resolve_asset_video(asset: dict, private_token: str, timeout: int) -> dict:
 
     try:
         result = subprocess.run(cmd, capture_output=True, text=True, timeout=timeout, stdin=subprocess.DEVNULL)
+        absorb_child_billing(result.stdout)
         if result.returncode == 0:
             for line in reversed(result.stdout.strip().split("\n")):
                 line = line.strip()
@@ -893,6 +953,7 @@ def resolve_asset_digital_human(asset: dict, private_token: str, timeout: int) -
     dh_timeout = max(timeout, 660)
     try:
         result = subprocess.run(cmd, capture_output=True, text=True, timeout=dh_timeout, stdin=subprocess.DEVNULL)
+        absorb_child_billing(result.stdout)
         if result.returncode == 0:
             for line in reversed(result.stdout.strip().split("\n")):
                 line = line.strip()
@@ -1892,6 +1953,8 @@ def _log_render_plan_summary(render_plan: dict) -> None:
 
 
 def main():
+    # 无论正常结束、sys.exit 还是中途失败，都在最后报一次积分账（无扣费时静默）。
+    atexit.register(print_billing_footer)
     parser = argparse.ArgumentParser(
         description="Video render tool — DSL + TemplateBinding → Remotion video.",
         formatter_class=argparse.RawDescriptionHelpFormatter,

package/skills/template-registry/scripts/render_job_client.py

@@ -37,6 +37,31 @@ def _make_headers(priv_token: str) -> dict:
     return headers
 
 
+# ─── 扣费回传 ────────────────────────────────────────────────────────────────
+# ab-api 会在扣了积分的成功响应上挂 billing 字段（见 core.Success）。渲染积分是在
+# /renderJob/saveManifest 里扣的，所以这里是渲染花费唯一的可见入口——累加起来交给
+# render_video.py 在收尾时统一告知用户。
+_BILLING: dict = {"credits": 0, "balance": None}
+
+
+def _record_billing(result: dict) -> None:
+    billing = result.get("billing")
+    if not isinstance(billing, dict):
+        return
+    credits = billing.get("credits")
+    if not isinstance(credits, (int, float)) or credits <= 0:
+        return
+    _BILLING["credits"] += int(credits)
+    balance = billing.get("balance")
+    if isinstance(balance, (int, float)):
+        _BILLING["balance"] = int(balance)
+
+
+def billing_summary() -> dict:
+    """本进程通过本模块产生的累计扣费：{"credits": int, "balance": int|None}。"""
+    return dict(_BILLING)
+
+
 def _post(path: str, payload: dict, priv_token: str, timeout: int = 30) -> dict:
     """发送 POST 请求并返回响应 data 字段；失败时抛出 RuntimeError。"""
     url = f"{_api_base()}{path}"
@@ -50,6 +75,8 @@ def _post(path: str, payload: dict, priv_token: str, timeout: int = 30) -> dict:
     except urllib.error.URLError as e:
         raise RuntimeError(f"network request failed ({path}): {e.reason}") from e
 
+    _record_billing(result)
+
     if result.get("code") != 0:
         msg = result.get("msg") or result.get("message") or "unknown error"
         raise RuntimeError(f"API returned an error [{path}]: {msg}")