@itpay/cli 2.1.40 → 2.1.41

package/dist/src/commands/services/actions.js

@@ -1,133 +0,0 @@
-import { serviceAdapter } from "../../services/registry.js";
-import { CommandContractError, writeCommandEnvelope } from "../../services/shared/envelope.js";
-import { normalizeServiceActionStatus, paidContinuation, serviceAllowedActionCommand, purchaseConfirmationInstruction, actionInputError } from "../../services/shared/platform.js";
-import { servicesNextEnvelope } from "../../services/presentation.js";
-export async function runServicesAction(backend, serviceExecutionID, actionType, input, options = {}) {
-    const selection = await resolveCandidateSelection(backend, serviceExecutionID, actionType, options);
-    const request = {
-        action_type: actionType,
-        input_snapshot: input,
-    };
-    if (options.actorType)
-        request.actor_type = options.actorType;
-    if (options.actorID)
-        request.actor_id = options.actorID;
-    if (options.status)
-        request.status = normalizeServiceActionStatus(options.status, serviceExecutionID);
-    const resultItemID = selection?.resultItemID ?? options.resultItemID;
-    if (resultItemID)
-        request.result_item_id = resultItemID;
-    if (options.requiredBefore)
-        request.required_before = options.requiredBefore;
-    let response;
-    try {
-        response = await backend.recordServiceExecutionAction(serviceExecutionID, request);
-    }
-    catch (error) {
-        // A failed write is never replayed. Only the locked execution identifies its adapter.
-        try {
-            const model = await backend.getServiceExecution(serviceExecutionID);
-            serviceAdapter(model.execution).actionError(error, serviceExecutionID, actionType);
-        }
-        catch (recoveryError) {
-            if (recoveryError instanceof CommandContractError)
-                throw recoveryError;
-        }
-        throw error;
-    }
-    if (actionType === "approve_purchase" && "status" in response && response.status === "approved") {
-        const quoteID = typeof input.service_quote_lock_id === "string" ? input.service_quote_lock_id : "";
-        writeCommandEnvelope({
-            status: "purchase_preparation_approved",
-            result: { service_execution_id: serviceExecutionID, evidence_source: "agent_reported", scope: "prepare_checkout", service_quote_lock_id: quoteID },
-            instruction: "已记录同范围的准备付款入口批准；这是Agent报告的真实会话同意，不是已付款或出票。继续使用本报价；条件未变不重复询问，官方页实际支付仍由用户完成。",
-            next: quoteID ? { command: `itpay cart add --quote ${quoteID} --json`, reason: "加入本次已批准报价，准备同一个付款入口" } : null,
-            recovery: [{ command: `itpay services next ${serviceExecutionID} --json`, reason: "读取原执行与付款状态，不重新购买" }],
-        }, { ...(options.jsonOutput !== undefined ? { jsonOutput: options.jsonOutput } : {}), ...(options.output ? { output: options.output } : {}) });
-        return;
-    }
-    if ("state" in response) {
-        const updated = await backend.getServiceExecution(serviceExecutionID);
-        const envelope = servicesNextEnvelope(updated);
-        envelope.result = {
-            ...envelope.result,
-            planning_action: { action_id: response.action_id, state: response.state, replayed: response.replayed },
-        };
-        writeCommandEnvelope(envelope, {
-            ...(options.jsonOutput !== undefined ? { jsonOutput: options.jsonOutput } : {}),
-            ...(options.output ? { output: options.output } : {}),
-        });
-        return;
-    }
-    if (selection && actionType === "select_candidate" && response.status === "approved") {
-        const updated = await backend.getServiceExecution(serviceExecutionID);
-        const preferred = updated.allowed_actions?.[0];
-        const continuation = preferred?.type === "prepare_quote"
-            ? paidContinuation(updated, preferred, {})
-            : null;
-        const next = continuation?.next ?? (preferred ? serviceAllowedActionCommand(updated, preferred) : null);
-        writeCommandEnvelope({
-            status: "candidate_selected",
-            result: {
-                service_execution_id: response.service_execution_id,
-                candidate: { rank: selection.rank, title: selection.title },
-                ...(continuation ? { checkout: continuation.checkout } : {}),
-            },
-            instruction: continuation
-                ? purchaseConfirmationInstruction("candidate_selected", continuation.price, continuation.capability.delivery_email_required, continuation.capability.delivery_email_purpose, selection.title)
-                : "候选已绑定到来源 Execution；后续动作必须继续使用该 Execution。",
-            next,
-            recovery: [{
-                    command: `itpay services next ${response.service_execution_id} --json`,
-                    reason: "重新读取服务端允许的动作",
-                }],
-        }, {
-            ...(options.jsonOutput !== undefined ? { jsonOutput: options.jsonOutput } : {}),
-            ...(options.output ? { output: options.output } : {}),
-        });
-        return;
-    }
-    writeCommandEnvelope({
-        status: "action_recorded",
-        result: {
-            service_execution_id: response.service_execution_id,
-            action_type: response.action_type,
-            action_status: response.status,
-            evidence_source: "agent_reported",
-            reported_actor_type: response.actor_type,
-        },
-        instruction: "动作已记录（Agent转述；actor_type并非官方页面真人确认的证明）。读取服务端计算的新状态；不要自行假设下一 capability。",
-        next: {
-            command: `itpay services next ${response.service_execution_id} --json`,
-            reason: "取得更新后的首选动作",
-        },
-        recovery: [],
-    }, {
-        ...(options.jsonOutput !== undefined ? { jsonOutput: options.jsonOutput } : {}),
-        ...(options.output ? { output: options.output } : {}),
-    });
-}
-export async function resolveCandidateSelection(backend, serviceExecutionID, actionType, options) {
-    if (options.candidateRank === undefined)
-        return undefined;
-    if (actionType !== "select_candidate") {
-        throw actionInputError(serviceExecutionID, "--candidate is only valid with --action select_candidate");
-    }
-    if (options.resultItemID) {
-        throw actionInputError(serviceExecutionID, "--candidate cannot be combined with --result-item");
-    }
-    if (!Number.isInteger(options.candidateRank) || options.candidateRank < 1) {
-        throw actionInputError(serviceExecutionID, "--candidate must be a positive integer result rank");
-    }
-    const execution = await backend.getServiceExecution(serviceExecutionID);
-    const currentItems = execution.current_result_items ?? [];
-    const result = currentItems.find((item) => item.rank === options.candidateRank);
-    if (!result) {
-        throw actionInputError(serviceExecutionID, `candidate ${options.candidateRank} is not available on service execution ${serviceExecutionID}`, "candidate_not_found");
-    }
-    return {
-        resultItemID: result.service_capability_result_item_id,
-        rank: result.rank,
-        title: result.display_title,
-    };
-}

package/dist/src/commands/services/commerce.js

@@ -1,197 +0,0 @@
-import { assertCheckoutPayable } from "../checkout_handoff.js";
-import { serviceAdapter } from "../../services/registry.js";
-import { HttpError } from "../../client/http.js";
-import { validateContext } from "../../state/client_context.js";
-import { dispatchRender } from "../../render/index.js";
-import { ensureIdeImageAttach } from "../../render/ide.js";
-import { shouldPrepareLocalCheckoutImage } from "../../render/checkout_handoff.js";
-import { localizeCardURL, normalizeCardLocale } from "../../render/locale.js";
-import { platformKeyForHost } from "../../render/plan.js";
-import { renderTerminalQR } from "../../render/qr.js";
-import { buildCheckoutQRPlan } from "../../render/checkout_plan.js";
-import { CommandContractError, writeCommandEnvelope, plainValueLines } from "../../services/shared/envelope.js";
-import { missingRequiredInput, checkoutCommand, formatInputOptions, tokenizedCheckoutURL, absolutePublicURL, fallbackCardURL, fallbackCardPNGURL, buildServicesCheckoutEnvelope, quoteCommand, formatMoney } from "../../services/shared/platform.js";
-export async function runServicesCheckout(backend, config, serviceExecutionID, capabilityID, options = {}) {
-    const host = options.host ?? "terminal";
-    const contextError = validateContext(host, options.target);
-    if (contextError) {
-        throw new CommandContractError(contextError.code, contextError.message, "从当前可信会话上下文补齐 Host/target；本次未创建 Checkout。", []);
-    }
-    const deliveryContact = {
-        ...(options.deliveryContact ?? {}),
-        ...(options.email ? { email: options.email } : {}),
-    };
-    if (!options.resume && !capabilityID) {
-        const model = await backend.getServiceExecution(serviceExecutionID);
-        capabilityID = model.workflow_entry?.capability_id;
-    }
-    if (!options.resume && !capabilityID) {
-        throw new CommandContractError("capability_required", "--capability is required when creating a service checkout", "使用当前 Service Execution 返回的付费 capability；恢复已有 Checkout 时改用 --resume。", [{ command: `itpay services next ${serviceExecutionID} --json`, reason: "读取当前允许的付费 capability" }]);
-    }
-    if (!options.resume) {
-        const readModel = await backend.getServiceExecution(serviceExecutionID);
-        const capability = readModel.capabilities.find((item) => item.capability_id === capabilityID);
-        if (!capability || !capability.requires_payment) {
-            throw new CommandContractError("capability_not_checkoutable", `capability ${capabilityID} is not available for checkout on service execution ${serviceExecutionID}`, "只为当前 Service Execution 返回的 requires_payment capability 创建 Checkout。", [{ command: `itpay services next ${serviceExecutionID} --json`, reason: "读取当前允许的下一步" }]);
-        }
-        if (readModel.checkout_bindings.length === 0 && !readModel.actions.some(action => action.action_type === "approve_purchase" && action.status === "approved")) {
-            await runServicesQuote(backend, serviceExecutionID, capability.capability_id, options.lockedInput ?? {}, options);
-            return;
-        }
-        const lockedInput = options.lockedInput ?? {};
-        const missingInput = missingRequiredInput(capability.input_schema, lockedInput);
-        if (missingInput.length > 0 && !readModel.workflow_entry && readModel.execution.next_action !== "create_checkout") {
-            throw new CommandContractError("capability_input_invalid", `missing required capability input: ${missingInput.join(", ")}`, "补齐付费 capability 的 required_input；本次没有创建 quote、Checkout 或订单。", [], { schema_version: "itpay.interaction.v1", stage: "input_required", input_template: { command: checkoutCommand(serviceExecutionID, capability, lockedInput), required_input: missingInput, executable: false } });
-        }
-        if (capability.delivery_email_required && readModel.workflow_entry?.capability_id !== capability.capability_id && String(deliveryContact.email ?? "").trim() === "") {
-            throw new CommandContractError("delivery_email_required", "delivery email is required before creating this service checkout", "该 capability 的交付链接会发送到用户邮箱；先向用户说明用途并询问邮箱，不要代填。", [], { schema_version: "itpay.interaction.v1", stage: "input_required", input_template: { command: `itpay services checkout ${serviceExecutionID} --capability ${capability.capability_id}${formatInputOptions(lockedInput)} --email <email> --json`, required_input: ["email"], executable: false } });
-        }
-    }
-    let response;
-    try {
-        response = await backend.createServiceExecutionCheckout(serviceExecutionID, {
-            ...(capabilityID ? { capability_id: capabilityID } : {}),
-            ...(Object.keys(deliveryContact).length > 0 ? { delivery_contact: deliveryContact } : {}),
-            ...(options.lockedInput && Object.keys(options.lockedInput).length > 0 ? { locked_input: options.lockedInput } : {}),
-            ...(options.resume ? { resume: true } : {}),
-        });
-    }
-    catch (error) {
-        if (error instanceof HttpError && error.code === "purchase_approval_required") {
-            throw new CommandContractError(error.code, error.message, "先读当前报价及完整范围模板。沿用覆盖同条件的真实批准；缺少哪部分才补哪部分，不把候选选择当作价格同意，也不代付。", [{ command: capabilityID ? `itpay services quote ${serviceExecutionID} --capability ${capabilityID}${formatInputOptions(options.lockedInput ?? {})} --json` : `itpay services next ${serviceExecutionID} --json`, reason: "读取同一执行的当前批准范围，不新建购买" }]);
-        }
-        throw error;
-    }
-    const checkout = response.checkout;
-    const authoritative = checkout.display_token ? await backend.getCheckoutPresentation(checkout.checkout.checkout_id, checkout.display_token) : undefined;
-    assertCheckoutPayable(checkout, authoritative, response.cart.cart_id, serviceExecutionID);
-    if (authoritative)
-        response.cart.items = authoritative.items;
-    const checkoutID = checkout.checkout.checkout_id;
-    const displayToken = checkout.display_token;
-    const locale = normalizeCardLocale(options.locale);
-    const checkoutURL = tokenizedCheckoutURL(checkout.checkout_url, displayToken, checkout.qr_payload);
-    const cardURL = localizeCardURL(absolutePublicURL(config.baseURL, checkout.card_url ?? fallbackCardURL(config.baseURL, checkoutID, displayToken)), locale);
-    const cardPNGURL = localizeCardURL(absolutePublicURL(config.baseURL, checkout.card_png_url ?? checkout.qr_png_url ?? fallbackCardPNGURL(config.baseURL, checkoutID, displayToken)), locale);
-    let itineraryTitle;
-    let itinerary;
-    try {
-        const booking = await backend.getServiceExecution(serviceExecutionID);
-        ({ itinerary, itineraryTitle } = await serviceAdapter(booking.execution).checkout(backend, booking, checkoutID, displayToken));
-    }
-    catch {
-        // Checkout already exists; a display-only title lookup cannot hide its official handoff.
-    }
-    const plan = buildCheckoutQRPlan({
-        localSimulation: backend.localSimulation,
-        host,
-        checkoutID,
-        checkoutURL,
-        cardURL,
-        displayToken,
-        qrPayload: checkout.qr_payload,
-        qrPNGURL: cardPNGURL,
-        nextAction: checkout.checkout.next_action,
-        orderItems: response.cart.items.map((item) => ({
-            title: itineraryTitle || item.title,
-            quantity: item.quantity,
-            amountMinor: item.amount_minor,
-            currency: item.currency,
-        })),
-        orderCurrency: checkout.checkout.currency,
-        ...(options.agentType ? { agentType: options.agentType } : {}),
-        locale,
-    });
-    options.persistHandoff?.({
-        serviceExecutionID,
-        cartID: response.cart.cart_id,
-        checkoutID,
-        displayToken,
-        checkoutURL,
-    });
-    const platform = platformKeyForHost(plan.host);
-    if (!options.jsonOutput && (platform === "telegram" || platform === "feishu" || platform === "lark")) {
-        await dispatchRender(plan, {
-            host,
-            ...(options.target ? { target: options.target } : {}),
-            ...(options.qrFormat ? { qrFormat: options.qrFormat } : {}),
-            ...(options.qrFilePath ? { qrFilePath: options.qrFilePath } : {}),
-            ...(options.output ? { output: options.output } : {}),
-            ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),
-            baseURL: config.baseURL,
-        });
-        return;
-    }
-    if (shouldPrepareLocalCheckoutImage(platform)) {
-        await ensureIdeImageAttach(plan, {
-            enabled: config.ideImageAttach,
-            ...(config.baseURL ? { baseURL: config.baseURL } : {}),
-            ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),
-        });
-    }
-    const envelope = buildServicesCheckoutEnvelope(response, checkoutURL, plan, options.agentType, options.target);
-    if (itinerary) {
-        envelope.result = { ...envelope.result, itinerary };
-        envelope.instruction = "整程一次付款，各段分别出票；展示入口不等于付款，付款成功不等于全部出票。" + envelope.instruction;
-    }
-    const plainResult = plainValueLines(envelope.result);
-    if (!options.jsonOutput && platform === "terminal") {
-        plainResult.push("qr:", await renderTerminalQR(checkoutURL, options.qrFormat ?? "terminal"));
-    }
-    writeCommandEnvelope(envelope, {
-        ...(options.jsonOutput !== undefined ? { jsonOutput: options.jsonOutput } : {}),
-        ...(options.output ? { output: options.output } : {}),
-        plainResult,
-    });
-}
-export async function runServicesQuote(backend, serviceExecutionID, capabilityID, input, options = {}) {
-    const model = await backend.getServiceExecution(serviceExecutionID);
-    const capability = model.capabilities.find((item) => item.capability_id === capabilityID);
-    if (!capability || !capability.requires_payment) {
-        throw new CommandContractError("capability_not_quoteable", `capability ${capabilityID} is not available for quote on service execution ${serviceExecutionID}`, "只为当前 Service Execution 返回的付费 capability 创建报价。", [{ command: `itpay services next ${serviceExecutionID} --json`, reason: "读取当前合法动作" }]);
-    }
-    const selectionBacked = model.execution.status === "human_action_approved" &&
-        model.allowed_actions?.some((action) => action.type === "prepare_quote" && action.capability_id === capabilityID);
-    const missingInput = missingRequiredInput(capability.input_schema, input);
-    if (missingInput.length > 0 && !selectionBacked && model.workflow_entry?.capability_id !== capability.capability_id) {
-        throw new CommandContractError("capability_input_invalid", `missing required capability input: ${missingInput.join(", ")}`, "补齐付费 capability 输入；本次没有创建 Quote、Cart 或 Checkout。", [], { schema_version: "itpay.interaction.v1", stage: "input_required", input_template: { command: quoteCommand(serviceExecutionID, capability, input), required_input: missingInput, executable: false } });
-    }
-    const deliveryContact = {
-        ...(options.deliveryContact ?? {}),
-        ...(options.email ? { email: options.email } : {}),
-    };
-    if (capability.delivery_email_required && model.workflow_entry?.capability_id !== capability.capability_id && String(deliveryContact.email ?? "").trim() === "") {
-        throw new CommandContractError("delivery_email_required", "delivery email is required before preparing this service quote", "交付链接会发送到用户邮箱；说明用途并询问邮箱，不要代填。", [], { schema_version: "itpay.interaction.v1", stage: "input_required", input_template: { command: quoteCommand(serviceExecutionID, capability, input), required_input: ["email"], executable: false } });
-    }
-    const quote = await backend.prepareServiceQuote(serviceExecutionID, {
-        capability_id: capabilityID,
-        ...(Object.keys(deliveryContact).length > 0 ? { delivery_contact: deliveryContact } : {}),
-        ...(Object.keys(input).length > 0 ? { locked_input: input } : {}),
-    });
-    const result = {
-        service_quote_lock_id: quote.service_quote_lock_id,
-        service_execution_id: quote.service_execution_id,
-        capability_id: quote.capability_id,
-        price: formatMoney(quote.amount_minor, quote.currency),
-        ...(quote.purchase_summary ? { purchase_summary: quote.purchase_summary } : {}),
-        expires_at: quote.expires_at,
-        ...(quote.approval_template ? { approval_template: quote.approval_template } : {}),
-    };
-    writeCommandEnvelope({
-        status: "quote_ready",
-        result,
-        instruction: quote.approval_template
-            ? "报价已锁定。先展示服务端商品名称、对象、范围、数量和金额；与用户请求不符时让用户决定，不自称基础报告或换商品。选择候选不是价格同意；模板中的user_approved=false表示尚未记录批准。仅在用户已有真实批准覆盖本范围时改为true并提交，不重复询问同条件已明确同意。用户授权预算时用capped及真实maximum_minor；仅委托准备入口、最终金额在官方页确认时用confirm_on_official_page。不要伪造接受未知金额或条款。"
-            : "报价已锁定当前 Execution 的可信输入和价格；可单独付款，也可与其他独立 Execution 的报价合并。",
-        ...(quote.approval_template ? { interaction: { schema_version: "itpay.interaction.v1", stage: "purchase_approval_required", input_template: { command: `itpay services action ${serviceExecutionID} --action approve_purchase --actor-type agent --status approved --input-json <file> --json`, input: quote.approval_template, required_input: ["file"], executable: false } } } : {}),
-        next: quote.approval_template ? null : {
-            command: `itpay cart add --quote ${quote.service_quote_lock_id} --json`,
-            reason: "加入 canonical Cart",
-        },
-        recovery: [{ command: `itpay services next ${serviceExecutionID} --json`, reason: "重新读取当前 Execution 状态" }],
-    }, {
-        ...(options.jsonOutput !== undefined ? { jsonOutput: options.jsonOutput } : {}),
-        ...(options.output ? { output: options.output } : {}),
-        plainResult: plainValueLines(result),
-    });
-}