@itpay/cli 2.0.3 → 2.0.5

package/dist/src/commands/cart.js

@@ -1,8 +1,8 @@
 // CLI cart commands. Server cart is canonical for agent purchase/free-trial
 // flows; local cart helpers are kept for explicit local draft compatibility.
-import { HttpError } from "../client/http.js";
+import { formatMoney } from "../render/output.js";
 import { resolveOutput } from "../render/sink.js";
-import { attachAgentGuidance, buildCartGuidance, printAgentGuidance } from "./guidance.js";
+import { writeCommandEnvelope } from "./guidance.js";
 export function runCartAdd(session, options) {
     const out = resolveOutput(options.output);
     const item = {
@@ -13,11 +13,25 @@ export function runCartAdd(session, options) {
         ...(options.input ? { input: options.input } : {}),
     };
     session.add(item);
-    out(`added ${item.quantity} × variant=${item.catalogVariantID} offer=${item.offerID} to cart\n`);
+    const envelope = {
+        status: "added_local",
+        result: {
+            catalog_item_id: item.catalogItemID,
+            catalog_variant_id: item.catalogVariantID,
+            offer_id: item.offerID,
+            quantity: item.quantity,
+        },
+        instruction: "仅写入本地兼容草稿，未验证目录、价格或服务合同；不要把它当作 canonical Cart。",
+        next: { command: "itpay cart show --local", reason: "检查本地草稿" },
+        recovery: [],
+    };
+    writeCommandEnvelope(envelope, {
+        ...(options.jsonOutput !== undefined ? { jsonOutput: options.jsonOutput } : {}),
+        output: out,
+    });
 }
 export async function runCartAddServer(options) {
     const out = resolveOutput(options.output);
-    const agentDeviceID = options.session.ensureAgentDeviceID(options.config.agentDeviceID);
     const item = {
         catalog_item_id: options.catalogItemID,
         catalog_variant_id: options.catalogVariantID,
@@ -28,17 +42,14 @@ export async function runCartAddServer(options) {
     const clientContext = {
         host: options.host,
         ...(options.target ? { target: options.target } : {}),
-        agent_device_id: agentDeviceID,
     };
     const cart = options.session.lastCartID
         ? await options.backend.addCartItem(options.session.lastCartID, {
             ...item,
-            agent_device_id: agentDeviceID,
             client_context: clientContext,
         })
         : await options.backend.createCart({
             currency: options.config.checkoutCurrency,
-            agent_device_id: agentDeviceID,
             client_context: clientContext,
             items: [item],
         });
@@ -47,29 +58,99 @@ export async function runCartAddServer(options) {
         cartID: cart.cart_id,
         ...(line?.cart_item_id ? { cartItemID: line.cart_item_id } : {}),
         ...(line?.service_execution_id ? { serviceExecutionID: line.service_execution_id } : {}),
-        agentDeviceID,
     });
-    const serviceModel = line?.service_execution_id
-        ? await getServiceReadModel(options.backend, line.service_execution_id)
-        : undefined;
-    const guidance = buildCartGuidance(cart, serviceModel);
-    if (options.jsonOutput) {
-        out(JSON.stringify(attachAgentGuidance(cart, guidance), null, 2) + "\n");
+    if (!line?.cart_item_id) {
+        throw new Error("backend did not return the added cart item");
     }
-    else {
-        out(`cart: ${cart.cart_id}\n`);
-        if (line?.cart_item_id)
-            out(`line: ${line.cart_item_id}\n`);
-        if (line?.service_execution_id)
-            out(`service execution: ${line.service_execution_id}\n`);
-        printAgentGuidance(guidance, options.output);
+    const serviceExecutionID = line.service_execution_id;
+    const envelope = {
+        status: "added",
+        result: {
+            cart_id: cart.cart_id,
+            cart_item_id: line.cart_item_id,
+            ...(serviceExecutionID ? { service_execution_id: serviceExecutionID } : {}),
+            title: line.title,
+            amount: formatMoney(line.amount_minor, line.currency),
+        },
+        instruction: serviceExecutionID
+            ? "服务型项目已创建 Service Execution；先读取其当前步骤，不要直接进入普通 buy。"
+            : "普通项目已加入 canonical Cart；先检查购物车，再创建 Checkout。",
+        next: serviceExecutionID
+            ? { command: `itpay services next ${serviceExecutionID} --json`, reason: "读取服务执行的当前步骤" }
+            : { command: "itpay cart next --json", reason: "检查 canonical Cart" },
+        recovery: [],
+    };
+    writeCommandEnvelope(envelope, {
+        ...(options.jsonOutput !== undefined ? { jsonOutput: options.jsonOutput } : {}),
+        output: out,
+        plainResult: Object.entries(envelope.result).map(([key, value]) => `${key}: ${String(value)}`),
+    });
+    return cart;
+}
+export async function runCartAddQuoteServer(options) {
+    const out = resolveOutput(options.output);
+    const clientContext = {
+        host: options.host,
+        ...(options.target ? { target: options.target } : {}),
+    };
+    const quoteItem = { service_quote_lock_id: options.serviceQuoteLockID };
+    const cart = options.session.lastCartID
+        ? await options.backend.addCartItem(options.session.lastCartID, {
+            ...quoteItem,
+            client_context: clientContext,
+        })
+        : await options.backend.createCart({
+            currency: options.config.checkoutCurrency,
+            client_context: clientContext,
+            items: [quoteItem],
+        });
+    const line = cart.items[cart.items.length - 1];
+    if (!line?.cart_item_id) {
+        throw new Error("backend did not return the added cart item");
     }
+    options.session.rememberServerCart({
+        cartID: cart.cart_id,
+        cartItemID: line.cart_item_id,
+        ...(line.service_execution_id ? { serviceExecutionID: line.service_execution_id } : {}),
+    });
+    const envelope = {
+        status: "quote_added",
+        result: {
+            cart_id: cart.cart_id,
+            item_count: cart.items.length,
+            total: formatMoney(cart.amount_minor, cart.currency),
+        },
+        instruction: "付费服务报价已加入同一 Cart；每个项目仍保持独立 Execution 和交付。",
+        next: { command: `itpay buy --cart ${cart.cart_id} --json`, reason: "确认项目齐全后创建一次合并付款" },
+        recovery: [{ command: "itpay cart show --json", reason: "检查当前合并 Cart" }],
+    };
+    writeCommandEnvelope(envelope, {
+        ...(options.jsonOutput !== undefined ? { jsonOutput: options.jsonOutput } : {}),
+        output: out,
+        plainResult: [
+            `cart_id: ${cart.cart_id}`,
+            `item_count: ${cart.items.length}`,
+            `total: ${formatMoney(cart.amount_minor, cart.currency)}`,
+        ],
+    });
     return cart;
 }
 export function runCartRemove(session, options) {
     const out = resolveOutput(options.output);
     session.remove(options.catalogVariantID, options.offerID);
-    out(`removed variant=${options.catalogVariantID} offer=${options.offerID}\n`);
+    writeCommandEnvelope({
+        status: "removed_local",
+        result: {
+            catalog_variant_id: options.catalogVariantID,
+            offer_id: options.offerID,
+        },
+        instruction: "本地兼容草稿已更新；这不代表任何 canonical Cart 或 Service Execution 已变更。",
+        next: { command: "itpay cart show --local --json", reason: "检查剩余本地草稿" },
+        recovery: [],
+    }, {
+        ...(options.jsonOutput !== undefined ? { jsonOutput: options.jsonOutput } : {}),
+        output: out,
+    });
 }
 export async function runCartRemoveServer(backend, session, cartItemID, options = {}) {
     const out = resolveOutput(options.output);
@@ -82,183 +163,207 @@ export async function runCartRemoveServer(backend, session, cartItemID, options
         throw new Error("missing cart item id; pass --line <cart_item_id>");
     }
     const cart = await backend.removeCartItem(cartID, lineID);
-    out(`removed line=${lineID} from cart=${cart.cart_id}\n`);
-    out(`cart ${cart.cart_id} (${cart.status}, ${cart.amount_minor} ${cart.currency})\n`);
+    const latestLine = cart.items[cart.items.length - 1];
+    session.rememberServerCart({
+        cartID: cart.cart_id,
+        ...(latestLine?.cart_item_id ? { cartItemID: latestLine.cart_item_id } : {}),
+        ...(latestLine?.service_execution_id ? { serviceExecutionID: latestLine.service_execution_id } : {}),
+    });
+    const envelope = {
+        status: "removed",
+        result: {
+            cart_id: cart.cart_id,
+            cart_item_id: lineID,
+            remaining_item_count: cart.items.length,
+        },
+        instruction: "canonical Cart 已更新；被删除的最后一个 service-backed line 对应执行会由服务端一致性事务取消。",
+        next: { command: "itpay cart next --json", reason: "检查剩余内容" },
+        recovery: [],
+    };
+    writeCommandEnvelope(envelope, {
+        ...(options.jsonOutput !== undefined ? { jsonOutput: options.jsonOutput } : {}),
+        output: out,
+    });
     return cart;
 }
 export function runCartShow(session, options = {}) {
-    const out = resolveOutput(options.output);
     const snap = session.show();
-    out(`cart (currency=${snap.currency})\n`);
-    if (snap.items.length === 0) {
-        out("  (empty)\n");
-        return;
-    }
-    for (const item of snap.items) {
-        out(`  - ${item.quantity} × variant=${item.catalogVariantID} offer=${item.offerID}` +
-            (item.input ? ` input=${JSON.stringify(item.input)}` : "") +
-            "\n");
-    }
-    if (snap.lastCheckoutID) {
-        out(`last checkout: ${snap.lastCheckoutID}\n`);
-        if (snap.lastCheckoutURL) {
-            out(`checkout url:  ${snap.lastCheckoutURL}\n`);
-        }
-    }
+    const items = snap.items.map((item) => ({
+        catalog_item_id: item.catalogItemID,
+        catalog_variant_id: item.catalogVariantID,
+        offer_id: item.offerID,
+        quantity: item.quantity,
+    }));
+    const envelope = {
+        status: items.length > 0 ? "shown_local" : "local_empty",
+        result: { currency: snap.currency, items },
+        instruction: items.length > 0
+            ? "这是未验证的本地兼容草稿，只能用于明确的普通商品流程；不要把它当作 canonical Cart。"
+            : "本地兼容草稿为空；从已发布目录重新选择项目。",
+        next: items.length > 0
+            ? { command: "itpay buy --json", reason: "将普通本地草稿提交为 canonical Cart" }
+            : { command: "itpay catalog list --json", reason: "读取已发布目录" },
+        recovery: [],
+    };
+    writeCommandEnvelope(envelope, {
+        ...(options.jsonOutput !== undefined ? { jsonOutput: options.jsonOutput } : {}),
+        ...(options.output ? { output: options.output } : {}),
+    });
 }
 export async function runCartShowServer(backend, session, options = {}) {
-    const out = resolveOutput(options.output);
     if (!session.lastCartID) {
-        runCartShow(session, options);
+        writeCommandEnvelope({
+            status: "cart_handle_missing",
+            result: {},
+            instruction: "本地没有 canonical Cart 句柄；不要把本地草稿默认为服务端 Cart。",
+            next: { command: "itpay catalog list --json", reason: "读取已发布目录" },
+            recovery: [{ command: "itpay cart show --local --json", reason: "仅在明确需要时检查本地兼容草稿" }],
+        }, {
+            ...(options.jsonOutput !== undefined ? { jsonOutput: options.jsonOutput } : {}),
+            ...(options.output ? { output: options.output } : {}),
+        });
         return undefined;
     }
     const cart = await backend.getCart(session.lastCartID);
-    out(`cart ${cart.cart_id} (${cart.status}, ${cart.amount_minor} ${cart.currency})\n`);
-    if (cart.items.length === 0) {
-        out("  (empty)\n");
-        return cart;
-    }
-    for (const item of cart.items) {
-        out(`  - ${item.quantity} × ${item.title} ${item.amount_minor} ${item.currency}\n`);
-        out(`    line=${item.cart_item_id ?? ""} variant=${item.catalog_variant_id ?? ""} offer=${item.offer_id ?? ""}\n`);
-        if (item.service_execution_id) {
-            out(`    service_execution=${item.service_execution_id} next_action=${item.next_action ?? ""} checkout_required=${String(item.checkout_required ?? false)}\n`);
-        }
-        if (item.service_quote_lock_id) {
-            out(`    service_quote_lock=${item.service_quote_lock_id}\n`);
-        }
-    }
-    const serviceModel = await getServiceReadModelForCart(backend, cart);
-    printAgentGuidance(buildCartGuidance(cart, serviceModel), options.output);
+    const items = cart.items.map((item) => ({
+        ...(item.cart_item_id ? { cart_item_id: item.cart_item_id } : {}),
+        title: item.title,
+        quantity: item.quantity,
+        ...(item.service_execution_id ? { service_execution_id: item.service_execution_id } : {}),
+    }));
+    const envelope = {
+        status: "shown",
+        result: {
+            cart_id: cart.cart_id,
+            status: cart.status,
+            amount: formatMoney(cart.amount_minor, cart.currency),
+            items,
+        },
+        instruction: items.length > 0
+            ? "使用 line 或 execution 句柄继续；不要使用内部 quote lock ID。"
+            : "canonical Cart 当前为空；从已发布目录选择项目。",
+        next: items.length > 0
+            ? { command: "itpay cart next --json", reason: "取得当前首选动作" }
+            : { command: "itpay catalog list --json", reason: "读取已发布目录" },
+        recovery: [],
+    };
+    writeCommandEnvelope(envelope, {
+        ...(options.jsonOutput !== undefined ? { jsonOutput: options.jsonOutput } : {}),
+        ...(options.output ? { output: options.output } : {}),
+        plainResult: [
+            `cart_id: ${cart.cart_id}`,
+            `state: ${cart.status}`,
+            `amount: ${formatMoney(cart.amount_minor, cart.currency)}`,
+            ...items.map((item) => `${item.cart_item_id ?? "line"}: ${item.title} x${item.quantity}${item.service_execution_id ? ` service_execution=${item.service_execution_id}` : ""}`),
+        ],
+    });
     return cart;
 }
 export function runCartClear(session, options = {}) {
-    const out = resolveOutput(options.output);
     session.clear();
-    out("cart cleared\n");
+    const envelope = {
+        status: "cleared_local",
+        result: { server_abandoned: false, local_state_cleared: true },
+        instruction: "仅清除了本地草稿和恢复句柄；Backend Cart、Checkout 和 Service Execution 均未改变。",
+        next: { command: "itpay catalog list --json", reason: "仅在用户提出新需求时重新选择" },
+        recovery: [],
+    };
+    writeCommandEnvelope(envelope, {
+        ...(options.jsonOutput !== undefined ? { jsonOutput: options.jsonOutput } : {}),
+        ...(options.output ? { output: options.output } : {}),
+    });
 }
 export async function runCartAbandonServer(backend, session, options = {}) {
-    const out = resolveOutput(options.output);
     if (!session.lastCartID) {
-        runCartClear(session, options);
+        writeCommandEnvelope({
+            status: "cart_handle_missing",
+            result: {},
+            instruction: "本地没有 canonical Cart 句柄；未修改任何 Backend 或本地资源。",
+            next: { command: "itpay next --json", reason: "检查其他可恢复句柄" },
+            recovery: [{ command: "itpay cart clear --local --json", reason: "仅在明确放弃本地草稿和句柄时执行" }],
+        }, {
+            ...(options.jsonOutput !== undefined ? { jsonOutput: options.jsonOutput } : {}),
+            ...(options.output ? { output: options.output } : {}),
+        });
         return undefined;
     }
-    let cart;
-    try {
-        cart = await backend.abandonCart(session.lastCartID);
-    }
-    catch (error) {
-        if (error instanceof HttpError && (error.code === "cart_item_locked" || error.status === 409)) {
-            const cartID = session.lastCartID;
-            session.clear();
-            out(`cart local handle cleared; server cart ${cartID} is locked by quote/checkout\n`);
-            return undefined;
-        }
-        throw error;
-    }
+    const cart = await backend.abandonCart(session.lastCartID);
     session.clear();
-    out(`cart abandoned: ${cart.cart_id}\n`);
+    const envelope = {
+        status: "abandoned",
+        result: { cart_id: cart.cart_id, server_abandoned: true },
+        instruction: "canonical Cart 已放弃；Backend 已在同一事务中软删除 active lines，并取消其未付款 Service Execution。",
+        next: { command: "itpay catalog list --json", reason: "仅在用户提出新需求时重新选择" },
+        recovery: [],
+    };
+    writeCommandEnvelope(envelope, {
+        ...(options.jsonOutput !== undefined ? { jsonOutput: options.jsonOutput } : {}),
+        ...(options.output ? { output: options.output } : {}),
+        plainResult: [`cart_id: ${cart.cart_id}`, "server_abandoned: true"],
+    });
     return cart;
 }
 export async function runCartNext(backend, session, options = {}) {
-    const out = resolveOutput(options.output);
-    if (session.lastCartID) {
-        const cart = await backend.getCart(session.lastCartID);
-        const guidance = buildCartGuidance(cart, await getServiceReadModelForCart(backend, cart));
-        if (options.jsonOutput) {
-            out(JSON.stringify(guidance, null, 2) + "\n");
-        }
-        else {
-            printAgentGuidance(guidance, options.output);
-        }
-        return;
-    }
-    const snap = session.show();
-    if (snap.lastServiceExecutionID) {
-        const model = await getServiceReadModel(backend, snap.lastServiceExecutionID);
-        const guidance = model
-            ? buildCartGuidance({
-                cart_id: snap.lastCartID ?? "<unknown_cart>",
-                status: "unknown",
-                amount_minor: 0,
-                currency: snap.currency,
-                items: [{
-                        title: "Service Execution",
-                        quantity: 1,
-                        amount_minor: 0,
-                        currency: snap.currency,
-                        service_execution_id: snap.lastServiceExecutionID,
-                    }],
-            }, model)
-            : buildCartGuidance({
-                cart_id: snap.lastCartID ?? "<unknown_cart>",
-                status: "unknown",
-                amount_minor: 0,
-                currency: snap.currency,
-                items: [{
-                        title: "Service Execution",
-                        quantity: 1,
-                        amount_minor: 0,
-                        currency: snap.currency,
-                        service_execution_id: snap.lastServiceExecutionID,
-                    }],
-            });
-        if (options.jsonOutput) {
-            out(JSON.stringify(guidance, null, 2) + "\n");
-        }
-        else {
-            printAgentGuidance(guidance, options.output);
-        }
+    if (!session.lastCartID) {
+        writeCartNextEnvelope({
+            status: "cart_handle_missing",
+            result: {},
+            instruction: "本地没有 canonical Cart 句柄；先恢复已有资源，不要创建重复 Cart。",
+            next: { command: "itpay next --json", reason: "检查其他可恢复句柄" },
+            recovery: [{ command: "itpay services list --json", reason: "从服务端恢复当前设备的执行" }],
+        }, options);
         return;
     }
-    if (snap.lastCheckoutID && snap.lastDisplayToken) {
-        const guidance = {
-            kind: "checkout_handle",
-            summary: `checkout ${snap.lastCheckoutID}: continue human checkout`,
-            state: { checkout_id: snap.lastCheckoutID },
-            next_actions: [{
-                    id: "open_checkout",
-                    label: "Open saved checkout presentation",
-                    command: `itpay checkout --id ${snap.lastCheckoutID} --token ${snap.lastDisplayToken}`,
-                    requires_human: true,
-                }],
+    const cart = await backend.getCart(session.lastCartID);
+    const unquotedServiceLine = [...cart.items].reverse().find((item) => item.service_execution_id && !item.service_quote_lock_id);
+    let envelope;
+    if (unquotedServiceLine?.service_execution_id) {
+        envelope = {
+            status: "action_available",
+            result: {
+                cart_id: cart.cart_id,
+                cart_status: cart.status,
+                service_execution_id: unquotedServiceLine.service_execution_id,
+            },
+            instruction: "该 Cart 包含 service-backed line；继续 Service Execution，不要从 Cart 猜 capability。",
+            next: {
+                command: `itpay services next ${unquotedServiceLine.service_execution_id} --json`,
+                reason: "读取服务端最新执行状态",
+            },
             recovery: [],
         };
-        if (options.jsonOutput) {
-            out(JSON.stringify(guidance, null, 2) + "\n");
-        }
-        else {
-            printAgentGuidance(guidance, options.output);
-        }
-        return;
     }
-    const guidance = {
-        kind: "no_active_handle",
-        summary: "no active server cart, service execution, or checkout handle remembered",
-        state: {},
-        next_actions: [{
-                id: "browse_catalog",
-                label: "Browse services",
-                command: "itpay catalog list",
-            }],
-        recovery: [],
-    };
-    if (options.jsonOutput) {
-        out(JSON.stringify(guidance, null, 2) + "\n");
+    else if (cart.items.length === 0) {
+        envelope = {
+            status: "cart_empty",
+            result: { cart_id: cart.cart_id, cart_status: cart.status },
+            instruction: "Cart 当前为空；先读取已发布目录，不要猜测 item 或 variant。",
+            next: { command: "itpay catalog list --json", reason: "选择已发布服务" },
+            recovery: [],
+        };
     }
     else {
-        printAgentGuidance(guidance, options.output);
+        envelope = {
+            status: "action_available",
+            result: {
+                cart_id: cart.cart_id,
+                cart_status: cart.status,
+                item_count: cart.items.length,
+                amount_minor: cart.amount_minor,
+                currency: cart.currency,
+            },
+            instruction: cart.items.some((item) => item.service_quote_lock_id)
+                ? "服务报价已锁定输入和价格；确认项目齐全后使用同一 Cart 创建一次 Checkout。"
+                : "该 Cart 是普通购买流程；使用同一 Cart 创建 Checkout，不要重复添加商品。",
+            next: { command: `itpay buy --cart ${cart.cart_id} --json`, reason: "继续 canonical Cart 结算" },
+            recovery: [],
+        };
     }
+    writeCartNextEnvelope(envelope, options);
 }
-async function getServiceReadModelForCart(backend, cart) {
-    const serviceExecutionID = [...cart.items].reverse().find((item) => item.service_execution_id)?.service_execution_id;
-    return serviceExecutionID ? getServiceReadModel(backend, serviceExecutionID) : undefined;
-}
-async function getServiceReadModel(backend, serviceExecutionID) {
-    try {
-        return await backend.getServiceExecution(serviceExecutionID);
-    }
-    catch {
-        return undefined;
-    }
+function writeCartNextEnvelope(envelope, options) {
+    writeCommandEnvelope(envelope, {
+        ...(options.jsonOutput !== undefined ? { jsonOutput: options.jsonOutput } : {}),
+        ...(options.output ? { output: options.output } : {}),
+    });
 }

package/dist/src/commands/catalog.js

@@ -1,46 +1,71 @@
-import { resolveOutput } from "../render/sink.js";
+import { writeCommandEnvelope } from "./guidance.js";
 export async function runCatalogList(backend, options = {}) {
     const manifest = await backend.getCatalogManifest();
-    const items = manifest.manifest.items;
-    const out = resolveOutput(options.output);
-    if (options.jsonOutput) {
-        out(JSON.stringify(manifest, null, 2) + "\n");
-        return;
-    }
-    out(`ItPay 当前上线 ${items.length} 个服务（目录版本 ${manifest.version}）\n\n`);
-    for (const item of items) {
-        out(`  ${item.title}\n`);
-        if (item.description)
-            out(`    ${item.description}\n`);
-        if (item.service_flow) {
-            const discovery = item.service_flow.discovery;
-            const primary = item.service_flow.primary_service;
-            out(`\n    先做什么：${discovery.title}\n`);
-            out(`    ${discovery.description}\n`);
-            if (discovery.free_quota_limit !== undefined) {
-                out(`    每台已登记设备可免费使用 ${discovery.free_quota_limit} 次。\n`);
-            }
-            if (discovery.paid_continuation) {
-                const continuation = discovery.paid_continuation;
-                out(`    免费次数用完后：${formatProductMoney(continuation.amount_minor, continuation.currency)}/次，继续使用该辅助步骤；结果直接返回给 agent${continuation.delivery_email_required ? "，需要用户提供收件邮箱" : "，不需要邮箱"}。\n`);
-            }
-            out(`\n    确认主体后：${primary.title}，${formatProductMoney(primary.amount_minor, primary.currency)}/次\n`);
-            out(`    ${primary.description}\n`);
-            if (primary.delivery_description)
-                out(`    ${primary.delivery_description}\n`);
+    const services = manifest.manifest.items.map(summarizeService);
+    const firstServiceID = manifest.manifest.items.find((item) => item.service_id)?.service_id;
+    const empty = services.length === 0;
+    writeCommandEnvelope({
+        status: empty ? "catalog_empty" : "listed",
+        result: { catalog_version: manifest.version, services },
+        instruction: empty
+            ? "当前没有已发布服务；稍后重试，不要猜测 service_id。"
+            : "向用户解释主服务、辅助步骤和价格；得到用户意图后再启动对应 service_id。",
+        next: empty
+            ? { command: "itpay catalog list", reason: "稍后重新读取已发布目录" }
+            : {
+                command: `itpay services start ${services.length === 1 && firstServiceID ? firstServiceID : "<service_id>"}`,
+                reason: "启动用户选择的服务",
+            },
+        recovery: [],
+    }, {
+        ...options,
+        plainResult: catalogPlainLines(manifest.version, services),
+    });
+}
+function summarizeService(item) {
+    const flow = item.service_flow;
+    return {
+        service_id: item.service_id ?? null,
+        title: item.title,
+        description: item.description ?? "",
+        ...(flow ? {
+            discovery: {
+                title: flow.discovery.title,
+                description: flow.discovery.description,
+                ...(flow.discovery.free_quota_limit !== undefined ? { free_quota: flow.discovery.free_quota_limit } : {}),
+                ...(flow.discovery.paid_continuation ? {
+                    paid_price: formatProductMoney(flow.discovery.paid_continuation.amount_minor, flow.discovery.paid_continuation.currency),
+                } : {}),
+            },
+            primary_offer: {
+                title: flow.primary_service.title,
+                description: flow.primary_service.description,
+                price: formatProductMoney(flow.primary_service.amount_minor, flow.primary_service.currency),
+            },
+        } : {}),
+    };
+}
+function catalogPlainLines(version, services) {
+    const lines = [`catalog_version: ${version}`];
+    for (const service of services) {
+        lines.push(`service: ${String(service.title)}`);
+        lines.push(`  service_id: ${String(service.service_id ?? "unavailable")}`);
+        if (service.description)
+            lines.push(`  description: ${String(service.description)}`);
+        const discovery = service.discovery;
+        if (discovery) {
+            const quota = discovery.free_quota !== undefined ? `; free_quota: ${String(discovery.free_quota)}` : "";
+            const paid = discovery.paid_price ? `; paid_price: ${String(discovery.paid_price)}` : "";
+            lines.push(`  discovery: ${String(discovery.title)}${quota}${paid}`);
+            lines.push(`    ${String(discovery.description)}`);
         }
-        out(`\n    服务 ID：${item.service_id ?? "未发布"}`);
-        if (item.service_id)
-            out(`（启动：itpay services start ${item.service_id}）`);
-        out("\n");
-        if (item.variants.length > 0) {
-            out(`    可购买项目：\n`);
-            for (const variant of item.variants) {
-                out(`      - ${variant.catalog_variant_id}  ${variant.title}  ${variant.offer_id}  ${formatProductMoney(variant.amount_minor, variant.currency)}\n`);
-            }
+        const primary = service.primary_offer;
+        if (primary) {
+            lines.push(`  primary_offer: ${String(primary.title)}; price: ${String(primary.price)}`);
+            lines.push(`    ${String(primary.description)}`);
         }
-        out("\n");
     }
+    return lines;
 }
 function formatProductMoney(amountMinor, currency) {
     return new Intl.NumberFormat("zh-CN", {