@itpay/cli 0.2.17 → 2.0.0-rc.1

package/dist/src/render/markdown.js

@@ -0,0 +1,83 @@
+// Markdown renderer for Codex / Claude Code hosts.
+// Always produces a full output: header, order table, branded QR image,
+// clickable links, checkout/payment IDs, and next-step instructions.
+// Every section is mandatory — the agent must display all of it.
+export function renderMarkdown(plan, options = {}) {
+    const out = options.output ?? ((line) => process.stdout.write(line + "\n"));
+    const handoff = buildAgentChatHandoff(plan);
+    out(`> AGENT ACTION REQUIRED: ${handoff.instruction}\n\n${handoff.markdown}`);
+}
+export function buildAgentChatHandoff(plan) {
+    const lines = ["### ItPay 付款"];
+    const attach = plan.ideImageAttach;
+    if (attach?.status === "downloaded" && attach.localPath) {
+        lines.push("", `![ItPay 付款二维码](<${attach.localPath}>)`);
+    }
+    else {
+        lines.push("", `> 二维码暂不可用：${attach?.error ?? attach?.status ?? "not prepared"}`);
+    }
+    const paymentLink = plan.platform.links[0]?.url;
+    if (paymentLink)
+        lines.push("", `[打开 ItPay 付款页面](${paymentLink})`);
+    const totalMinor = plan.orderItems?.reduce((sum, item) => sum + item.amountMinor * item.quantity, 0) ?? 0;
+    lines.push("", `金额：**${formatPrice(totalMinor, plan.orderCurrency ?? "CNY")}**`);
+    if (plan.orderItems?.length) {
+        lines.push(`项目：${plan.orderItems.map((item) => `${item.title} x${item.quantity}`).join("、")}`);
+    }
+    if (plan.afterActionCommand) {
+        lines.push("", `付款后查询：\`${plan.afterActionCommand}\``);
+    }
+    return {
+        type: "send_payment_handoff",
+        must_send_to_user: true,
+        instruction: "把下面的 Markdown 原样发送到当前聊天；二维码和付款链接都对用户可见后，才能等待付款。不要只展示工具调用或文件路径。",
+        markdown: lines.join("\n"),
+        ...(plan.afterActionCommand ? { after_visible_action: { command: plan.afterActionCommand } } : {}),
+    };
+}
+export function renderInteractionMarkdown(request) {
+    if (request.kind === "input") {
+        return renderInputMarkdown(request);
+    }
+    return renderSelectorMarkdown(request);
+}
+function renderInputMarkdown(req) {
+    const lines = [];
+    lines.push(`### :envelope: ${req.title}`);
+    lines.push("");
+    lines.push(`> ${req.prompt}`);
+    lines.push("");
+    for (const field of req.fields) {
+        lines.push(`- **${field.label}** (\`${field.id}\`, ${field.inputType}${field.required ? ", 必填" : ""})`);
+        if (field.placeholder)
+            lines.push(`  placeholder: ${field.placeholder}`);
+        if (field.description)
+            lines.push(`  ${field.description}`);
+    }
+    const template = buildInputTemplate(req.fields);
+    lines.push("");
+    lines.push("```json");
+    lines.push(JSON.stringify(template, null, 2));
+    lines.push("```");
+    return lines.join("\n");
+}
+function renderSelectorMarkdown(req) {
+    const lines = [];
+    const mode = req.selectionMode === "multiple" ? "多选" : "单选";
+    lines.push(`### ${req.title}`);
+    lines.push("");
+    lines.push(`> ${req.prompt} (${mode})`);
+    lines.push("");
+    for (const opt of req.options) {
+        lines.push(`- ${opt.label} -> \`${opt.value}\``);
+        if (opt.description)
+            lines.push(`  ${opt.description}`);
+    }
+    return lines.join("\n");
+}
+function buildInputTemplate(fields) {
+    return Object.fromEntries(fields.map((field) => [field.id, `<${field.inputType}>`]));
+}
+function formatPrice(amountMinor, currency) {
+    return `${(amountMinor / 100).toFixed(2)} ${currency}`;
+}

package/dist/src/render/output.js

@@ -0,0 +1,42 @@
+// Terminal output helpers. No HTTP, no SDK calls — only formatting.
+export function formatMoney(amountMinor, currency) {
+    const major = (amountMinor / 100).toFixed(2);
+    return `${major} ${currency}`;
+}
+export function renderReady(payload) {
+    return `backend ${payload.status} (version ${payload.version})`;
+}
+export function renderOrder(order) {
+    const lines = [];
+    lines.push(`order ${order.order_id}`);
+    lines.push(`  status:    ${order.status}`);
+    lines.push(`  checkout:  ${order.checkout_id}`);
+    lines.push(`  amount:    ${formatMoney(order.amount_minor, order.currency)}`);
+    if (order.paid_at) {
+        lines.push(`  paid_at:   ${order.paid_at}`);
+    }
+    if (order.items.length > 0) {
+        lines.push("  items:");
+        for (const item of order.items) {
+            lines.push(`    - ${item.title} × ${item.quantity}`);
+        }
+    }
+    if (order.delivery_artifacts.length > 0) {
+        lines.push("  delivery_artifacts:");
+        for (const artifact of order.delivery_artifacts) {
+            lines.push(`    - ${artifact.delivery_artifact_id} ${artifact.status} type=${artifact.artifact_type} redacted=${artifact.sensitive_content_redacted}`);
+        }
+    }
+    return lines.join("\n");
+}
+export function renderRefund(refund) {
+    return [
+        `refund ${refund.refund_request_id}`,
+        `  order:   ${refund.order_id}`,
+        `  status:  ${refund.status}`,
+        `  amount:  ${formatMoney(refund.amount_minor, refund.currency)}`,
+        refund.reason ? `  reason:  ${refund.reason}` : "",
+    ]
+        .filter((line) => line.length > 0)
+        .join("\n");
+}

package/dist/src/render/plain_chat.js

@@ -0,0 +1,60 @@
+// Plain-chat renderer for Discord / WhatsApp / `plain-chat` hosts.
+// V1 had this fallback as `image_or_link_then_human_reply` — a short
+// text block with the brand QR URL and the human-open link. No inline
+// buttons, no callbacks. The human pastes the link into their own
+// browser or wallet and reports back.
+import { ideImageAttachBlock } from "./ide.js";
+export function renderPlainChat(plan, options = {}) {
+    const out = options.output ?? ((line) => process.stdout.write(line));
+    const brand = plan.preferredQRSources.find((src) => src.length > 0);
+    const lines = [];
+    lines.push(plan.summary);
+    if (plan.checkoutID)
+        lines.push(`checkout_id: ${plan.checkoutID}`);
+    if (plan.paymentIntentID)
+        lines.push(`payment_intent_id: ${plan.paymentIntentID}`);
+    lines.push(`open: ${plan.url}`);
+    if (brand)
+        lines.push(`qr_image: ${brand}`);
+    if (plan.mobileWalletURL)
+        lines.push(`wallet: ${plan.mobileWalletURL}`);
+    for (const media of plan.platform.media ?? []) {
+        lines.push(`image: ${media.url}`);
+    }
+    for (const link of plan.platform.links) {
+        lines.push(`- ${link.label}: ${link.url}`);
+    }
+    for (const interaction of plan.platform.interactions ?? []) {
+        lines.push("");
+        lines.push(renderInteractionText(interaction));
+    }
+    if (plan.ideImageAttach) {
+        lines.push("");
+        for (const line of ideImageAttachBlock(plan.ideImageAttach)) {
+            lines.push(line);
+        }
+    }
+    out(lines.join("\n") + "\n");
+}
+export function renderPlainChatInteraction(request, options = {}) {
+    const out = options.output ?? ((line) => process.stdout.write(line));
+    out(renderInteractionText(request) + "\n");
+}
+function renderInteractionText(request) {
+    const lines = [`${request.title}`, request.prompt];
+    for (const media of request.media ?? []) {
+        lines.push(`image: ${media.url}`);
+    }
+    if (request.kind === "input") {
+        for (const field of request.fields) {
+            lines.push(`field ${field.id}: ${field.label} (${field.inputType}${field.required ? ", required" : ""})`);
+        }
+        lines.push(`reply_json: ${JSON.stringify(Object.fromEntries(request.fields.map((field) => [field.id, `<${field.inputType}>`])))}`);
+        return lines.join("\n");
+    }
+    lines.push(`selection_mode: ${request.selectionMode ?? "single"}`);
+    request.options.forEach((option, index) => {
+        lines.push(`${index + 1}. ${option.label} [${option.id}] => ${option.value}`);
+    });
+    return lines.join("\n");
+}

package/dist/src/render/plan.js

@@ -0,0 +1,31 @@
+// V3 render plan: the contract between `buy` / `checkout` and the
+// per-host renderers. The CLI builds a `RenderPlan` from the canonical
+// V3 checkout response, then `selectPlatform` picks the host-specific
+// `RenderPlatform` payload. Each renderer is pure: it takes a plan and
+// a sink and writes to stdout/stderr. No HTTP, no state mutation.
+//
+// Mirrors V1's `lib/render-human.js` shape: `kind` is the high-level
+// action the buyer needs to take (`auth_qr` or `payment_qr`); `host`
+// is the consumer; `links` and `presentation` carry the brand assets.
+// Pick the platform key for a given host. Discord / WhatsApp and
+// unrecognised hosts fall back to plain-chat, matching V1.
+export function platformKeyForHost(host) {
+    switch (host) {
+        case "terminal":
+            return "terminal";
+        case "codex":
+        case "claude-code":
+            return "markdown";
+        case "telegram":
+            return "telegram";
+        case "feishu":
+            return "feishu";
+        case "lark":
+            return "lark";
+        case "discord":
+        case "whatsapp":
+        case "plain-chat":
+        default:
+            return "plain_chat";
+    }
+}

package/dist/src/render/qr.js

@@ -0,0 +1,32 @@
+// QR helpers used by the terminal renderer. The CLI never invents a
+// brand QR on its own — it consumes the brand URLs the V3 backend
+// hands back (qr_png_url / preferred_qr_url / mobile_wallet_url).
+// For `auth_qr` (provider authorization) the CLI is allowed to
+// generate a local QR from the brand URL because no provider QR
+// exists yet. For `payment_qr` the CLI must not regenerate the QR.
+import QRCode from "qrcode";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+function terminalQRType(format) {
+    return format === "utf8" ? "utf8" : "terminal";
+}
+export async function renderTerminalQR(url, format) {
+    return QRCode.toString(url, {
+        type: format === "unicode" ? "utf8" : terminalQRType(format),
+        small: true,
+        errorCorrectionLevel: "L",
+    });
+}
+export async function writeLocalPNG(url) {
+    const dir = await fs.mkdtemp(path.join(os.tmpdir(), "itpay-v3-"));
+    const filePath = path.join(dir, `itpay-${randomUUID()}.png`);
+    await QRCode.toFile(filePath, url, {
+        type: "png",
+        errorCorrectionLevel: "M",
+        margin: 2,
+        width: 512,
+    });
+    return { filePath, mimeType: "image/png" };
+}

package/dist/src/render/sink.js

@@ -0,0 +1,6 @@
+// Centralised output sink used by every command. Lets tests silence
+// stdout while still letting the real CLI write to the terminal.
+export const defaultOutput = (line) => process.stdout.write(line);
+export function resolveOutput(sink) {
+    return sink ?? defaultOutput;
+}

package/dist/src/render/status.js

@@ -0,0 +1,37 @@
+// Maps backend enum values to short terminal hints. Keep this file
+// narrow on purpose: presentation is a CLI concern, not business truth.
+export const CHECKOUT_STATUS_HINTS = {
+    draft: "Checkout is still being assembled.",
+    quote_bound: "Show the checkout QR to the buyer to start the human flow.",
+    auth_required: "Buyer must complete provider authorization before payment.",
+    payment_required: "Frontend should create a payment intent.",
+    payment_pending: "Provider is processing the payment. Wait for the verify callback.",
+    payment_succeeded: "Payment verified. Awaiting delivery.",
+    completed: "Order is complete and delivered.",
+    failed: "Checkout failed. See server logs for the underlying reason.",
+    expired: "Checkout expired. Create a new checkout to retry.",
+    refunded: "Order has been fully refunded.",
+};
+export const ORDER_STATUS_HINTS = {
+    pending_payment: "Order is waiting for payment verification.",
+    paid: "Payment verified. Delivery in progress.",
+    delivery_pending: "Order is queued for delivery preparation.",
+    delivered: "Order is delivered. No further action needed.",
+    failed: "Order failed. Contact support.",
+    partially_refunded: "A partial refund has been issued.",
+    refunded: "Order has been fully refunded.",
+    cancelled: "Order has been cancelled.",
+};
+export const REFUND_STATUS_HINTS = {
+    requested: "Refund request received. Awaiting review.",
+    policy_review_required: "Refund requires human/admin review.",
+    accepted: "Refund accepted by the platform. Provider call in flight.",
+    provider_pending: "Refund is being processed by the provider.",
+    succeeded: "Refund completed.",
+    failed: "Refund failed. See server logs.",
+    cancelled: "Refund was cancelled before it completed.",
+};
+export function hintFor(kind, status) {
+    const table = kind === "checkout" ? CHECKOUT_STATUS_HINTS : kind === "order" ? ORDER_STATUS_HINTS : REFUND_STATUS_HINTS;
+    return table[status] ?? `Status: ${status}`;
+}

package/dist/src/render/telegram.js

@@ -0,0 +1,172 @@
+// Telegram renderer for the V3 CLI. Builds an `openclaw_message`
+// command payload the agent can hand to the OpenClaw gateway, plus
+// a structured `presentation.blocks` for native inline buttons.
+//
+// V1 only rendered `auth_qr` and `payment_qr`; V3 also has
+// `checkout_qr` (a buyer scans a branded QR from the CLI/agent to
+// land on the human checkout page). We emit the same button shape
+// for all three kinds but adjust the button intent.
+import { ideImageAttachBlock } from "./ide.js";
+function buttonsFor(plan) {
+    if (plan.kind === "payment_qr" && plan.paymentIntentID) {
+        return [
+            { label: "支付遇到问题 / 刷新", kind: "callback", intent: "refresh_payment_qr", ref: plan.paymentIntentID },
+            { label: "我已付款，查询状态", kind: "callback", intent: "check_payment_status", ref: plan.paymentIntentID },
+        ];
+    }
+    if (plan.kind === "auth_qr" && plan.checkoutID) {
+        return [
+            { label: "打开授权页面", kind: "url", url: plan.url },
+            { label: "查询授权状态", kind: "callback", intent: "check_checkout_status", ref: plan.checkoutID },
+        ];
+    }
+    // checkout_qr
+    return [
+        { label: "打开 ItPay 收银台", kind: "url", url: plan.url },
+        ...(plan.checkoutID
+            ? [{ label: "查询 Checkout 状态", kind: "callback", intent: "check_checkout_status", ref: plan.checkoutID }]
+            : []),
+    ];
+}
+function format(plan) {
+    return plan.kind === "payment_qr" ? "photo_text_inline_buttons" : "text_inline_buttons";
+}
+export function renderTelegram(plan, options) {
+    const out = options.output ?? ((line) => process.stdout.write(line));
+    const buttons = buttonsFor(plan);
+    const media = collectTelegramMedia(plan);
+    const text = plan.kind === "payment_qr"
+        ? `ItPay payment QR — ${plan.summary}`
+        : plan.kind === "auth_qr"
+            ? `ItPay auth required — ${plan.summary}`
+            : `ItPay checkout QR — ${plan.summary}`;
+    const presentation = {
+        format: format(plan),
+        media,
+        text,
+        links: plan.platform.links,
+        buttons,
+        interactions: plan.platform.interactions ?? [],
+        blocks: [
+            { type: "text", text },
+            ...(media.length > 0 ? [{ type: "image", url: media[0].url }] : []),
+            { type: "buttons", buttons },
+        ],
+        ...(plan.ideImageAttach
+            ? {
+                ide_image_attach: {
+                    status: plan.ideImageAttach.status,
+                    local_path: plan.ideImageAttach.localPath,
+                    mirrors: plan.ideImageAttach.mirrors,
+                    mime_type: plan.ideImageAttach.mimeType,
+                    source: plan.ideImageAttach.source,
+                    ...(plan.ideImageAttach.caption ? { caption: plan.ideImageAttach.caption } : {}),
+                    must_render_reason: plan.ideImageAttach.mustRenderReason,
+                    ...(plan.ideImageAttach.error ? { error: plan.ideImageAttach.error } : {}),
+                    action: "agent_must_render_into_ide_chat",
+                    instructions: ideImageAttachBlock(plan.ideImageAttach).filter((l) => l.length > 0),
+                },
+            }
+            : {}),
+    };
+    const openclawMessage = {
+        command: [
+            "openclaw",
+            "message",
+            "send",
+            "--channel",
+            "telegram",
+            "--target",
+            options.target,
+            "--message",
+            text,
+            ...(media.length > 0 ? ["--media", media[0].url] : []),
+            "--presentation",
+            JSON.stringify(presentation),
+        ],
+        // Hint: agents that cannot run openclaw must stop and tell the user
+        // they lack the native Telegram buttons tool — never downgrade.
+        if_unavailable: "Current agent cannot run `openclaw message send`. Stop and tell the user the native Telegram inline-button tool is missing; do not downgrade to a markdown table or plain link.",
+    };
+    out(JSON.stringify({ presentation, openclaw_message: openclawMessage }, null, 2) + "\n");
+}
+export function renderTelegramInteraction(request, options) {
+    const out = options.output ?? ((line) => process.stdout.write(line));
+    const media = (request.media ?? []).map((item) => ({
+        url: item.url,
+        mimeType: item.mimeType ?? "image/png",
+    }));
+    const buttons = request.kind === "selector"
+        ? request.options.map((option) => selectorButton(request.id, option))
+        : [];
+    const text = `${request.title} — ${request.prompt}`;
+    const presentation = {
+        format: request.kind === "selector" ? "text_inline_buttons" : "text",
+        media,
+        text,
+        buttons,
+        input_request: request.kind === "input"
+            ? {
+                type: "itpay_input_request",
+                id: request.id,
+                submit_label: request.submitLabel ?? "Submit",
+                fields: request.fields,
+            }
+            : undefined,
+        selector_request: request.kind === "selector"
+            ? {
+                type: "itpay_selector_request",
+                id: request.id,
+                selection_mode: request.selectionMode ?? "single",
+                submit_label: request.submitLabel ?? "Confirm",
+                options: request.options,
+            }
+            : undefined,
+        blocks: [
+            { type: "text", text },
+            ...(media.map((item) => ({ type: "image", url: item.url }))),
+            ...(request.kind === "input"
+                ? [{ type: "input_request", request_id: request.id, fields: request.fields }]
+                : [{ type: "buttons", buttons }]),
+        ],
+    };
+    const openclawMessage = {
+        command: [
+            "openclaw",
+            "message",
+            "send",
+            "--channel",
+            "telegram",
+            "--target",
+            options.target,
+            "--message",
+            text,
+            ...(media.length > 0 ? ["--media", media[0].url] : []),
+            "--presentation",
+            JSON.stringify(presentation),
+        ],
+        if_unavailable: "Current agent cannot run `openclaw message send`. Stop and tell the user the native Telegram input/button tool is missing; do not downgrade silently.",
+    };
+    out(JSON.stringify({ presentation, openclaw_message: openclawMessage }, null, 2) + "\n");
+}
+function collectTelegramMedia(plan) {
+    const media = (plan.platform.media ?? []).map((item) => ({
+        url: item.url,
+        mimeType: item.mimeType ?? "image/png",
+    }));
+    if (plan.kind === "payment_qr" || media.length === 0) {
+        media.unshift({
+            url: plan.preferredQRSources.find((src) => src.length > 0) ?? plan.url,
+            mimeType: "image/png",
+        });
+    }
+    return media;
+}
+function selectorButton(requestID, option) {
+    return {
+        label: option.label,
+        kind: "callback",
+        intent: "submit_selector_option",
+        ref: `${requestID}:${option.id}`,
+    };
+}

package/dist/src/render/terminal.js

@@ -0,0 +1,148 @@
+// Terminal renderer for the V3 CLI.
+// QR display:
+//   1. Branded QR PNG from server — download + save to local file
+//   2. Terminal QR — scannable ASCII QR from checkout URL (always)
+// All sections MANDATORY, never skipped.
+import { renderTerminalQR, writeLocalPNG } from "./qr.js";
+import { renderInlineTerminalImage } from "./terminal_image.js";
+import { ideImageAttachBlock } from "./ide.js";
+import { copyFile } from "node:fs/promises";
+export async function renderTerminal(plan, options) {
+    const out = options.output ?? ((line) => process.stdout.write(line));
+    const isPayment = plan.kind === "payment_qr";
+    out(`\n${"━".repeat(56)}\n`);
+    out(isPayment ? "  ITP 待付款\n" : "  ITP 收银台\n");
+    out(`${"━".repeat(56)}\n\n`);
+    // --- Order table ---
+    if (plan.orderItems && plan.orderItems.length > 0) {
+        out("  订单详情:\n");
+        let total = 0;
+        for (const item of plan.orderItems) {
+            const price = fmtPrice(item.amountMinor, item.currency);
+            const lineTotal = item.amountMinor * item.quantity;
+            total += lineTotal;
+            out(`    ${item.title}  ×${item.quantity}  ${price}\n`);
+        }
+        out(`    ${"─".repeat(40)}\n`);
+        out(`    合计: ${fmtPrice(total, plan.orderCurrency ?? "CNY")}\n\n`);
+    }
+    // --- Payment info ---
+    if (isPayment) {
+        out(`  支付方式: ${plan.paymentMethod ?? "—"}  状态: ${plan.paymentStatus ?? "—"}\n`);
+        if (plan.paymentIntentID)
+            out(`  支付 ID:   ${plan.paymentIntentID}\n`);
+        out("\n");
+    }
+    // --- Checkout IDs + links ---
+    out(`  Checkout:   ${plan.checkoutID ?? "—"}\n`);
+    out(`  URL:        ${plan.url}\n`);
+    for (const link of plan.platform.links) {
+        out(`  ${link.label}: ${link.url}\n`);
+    }
+    out("\n");
+    // --- Branded QR PNG download ---
+    await downloadServerQR(plan, options, out);
+    // --- Terminal QR (always, from checkout URL) ---
+    try {
+        const ascii = await renderTerminalQR(plan.url, options.format);
+        out(ascii + "\n");
+    }
+    catch {
+        out("  [QR render failed]\n\n");
+    }
+    // --- Interactions ---
+    for (const interaction of plan.platform.interactions ?? []) {
+        await renderTerminalInteraction(interaction, options);
+    }
+    // --- After-action ---
+    if (plan.afterActionCommand) {
+        out(`\n  ${plan.afterActionLabel ?? "Next step:"}\n`);
+        out(`  ${plan.afterActionCommand}\n`);
+    }
+    // --- IDE image attach (mandatory) ---
+    if (plan.ideImageAttach) {
+        out("\n  ── IDE 图片回显（必须执行） ──\n");
+        for (const line of ideImageAttachBlock(plan.ideImageAttach)) {
+            if (line === "") {
+                out("\n");
+            }
+            else {
+                out(`  ${line.replace(/^> ?/, "")}\n`);
+            }
+        }
+    }
+    out(`\n${"━".repeat(56)}\n`);
+}
+async function downloadServerQR(plan, options, out) {
+    // Use the precomputed IDE image attach when one was attached by
+    // ensureIdeImageAttach (single source of truth). This avoids writing
+    // a second copy of the PNG and keeps the path the agent received
+    // consistent with what the terminal prints.
+    const attach = plan.ideImageAttach;
+    if (attach && attach.status === "downloaded" && attach.localPath) {
+        out(`  Branded QR:  ${attach.localPath}\n`);
+        if (attach.mirrors.length > 0) {
+            out(`  QR mirrors:  ${attach.mirrors.join(", ")}\n`);
+        }
+        out(`  QR PNG URL:  ${attach.source}\n`);
+        out(`  Attach status: ${attach.status}\n`);
+        const target = options.qrFilePath ?? attach.localPath;
+        if (options.isTTY) {
+            renderInlineTerminalImage(target, out);
+        }
+        return;
+    }
+    if (attach && attach.status === "failed") {
+        out(`  Branded QR:  MISSING (${attach.error ?? "unknown error"})\n`);
+    }
+    if (attach && attach.status === "disabled") {
+        out(`  Branded QR:  disabled (ITPAY_IDE_IMAGE_ATTACH=0)\n`);
+    }
+    // Fallback: synthesise a local QR for the terminal so the human
+    // still gets a scannable image even when the backend brand PNG
+    // could not be obtained.
+    try {
+        const localPNG = await writeLocalPNG(plan.url);
+        const filePath = options.qrFilePath ?? localPNG.filePath;
+        if (options.qrFilePath) {
+            await copyFile(localPNG.filePath, filePath);
+        }
+        out(`  QR file:     ${filePath}\n`);
+        if (options.isTTY) {
+            renderInlineTerminalImage(filePath, out);
+        }
+    }
+    catch {
+        /* ignore */
+    }
+}
+export async function renderTerminalInteraction(request, options) {
+    const out = options.output ?? ((line) => process.stdout.write(line));
+    out(`\nITP INPUT REQUIRED [${request.kind}]\n`);
+    out(`  title:       ${request.title}\n`);
+    out(`  prompt:      ${request.prompt}\n`);
+    if (request.kind === "input") {
+        for (const field of request.fields) {
+            out(`  field:       ${field.id} (${field.inputType}${field.required ? " required" : ""}) - ${field.label}\n`);
+            if (field.placeholder)
+                out(`  placeholder: ${field.placeholder}\n`);
+            if (field.description)
+                out(`  note:        ${field.description}\n`);
+        }
+        out(`  reply_json:  ${JSON.stringify(buildInputTemplate(request.fields))}\n`);
+        return;
+    }
+    out(`  select:      ${request.selectionMode ?? "single"}\n`);
+    request.options.forEach((option, index) => {
+        out(`  [${index + 1}] ${option.label} -> ${option.value}\n`);
+        if (option.description)
+            out(`      ${option.description}\n`);
+    });
+    out(`  reply_hint:  reply with option id(s) for request ${request.id}\n`);
+}
+function buildInputTemplate(fields) {
+    return Object.fromEntries(fields.map((field) => [field.id, `<${field.inputType}>`]));
+}
+function fmtPrice(amountMinor, currency) {
+    return `${(amountMinor / 100).toFixed(2)} ${currency}`;
+}

package/dist/src/render/terminal_image.js

@@ -0,0 +1,19 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+export function supportsInlineTerminalImages() {
+    return Boolean(process.env.ITERM_SESSION_ID) || process.env.TERM_PROGRAM === "iTerm.app";
+}
+export function renderInlineTerminalImage(filePath, out) {
+    if (!supportsInlineTerminalImages())
+        return;
+    try {
+        const buf = readFileSync(filePath);
+        const name = path.basename(filePath);
+        const nameB64 = Buffer.from(name).toString("base64");
+        const dataB64 = buf.toString("base64");
+        out(`\u001b]1337;File=name=${nameB64};size=${buf.length};inline=1;preserveAspectRatio=1:${dataB64}\u0007\n`);
+    }
+    catch {
+        return;
+    }
+}