@tokenbuddy/tokenbuddy 1.0.36 → 1.0.38

package/src/init-payment-options.ts

@@ -1,373 +0,0 @@
-import * as p from "@clack/prompts";
-import * as fs from "fs";
-import * as os from "os";
-import * as path from "path";
-import type { PaymentConfig } from "./buyer-store.js";
-import type { ProviderCandidate } from "./provider-install.js";
-
-/** 当前 init 流程已支持的支付方式。当前仅 JD ClawTip 扫码支付。 */
-export type InitPaymentMethod = "clawtip";
-
-/**
- * `INIT_PAYMENT_OPTIONS` 里的单条目，喂给 `@clack/prompts` 的 select 组件。
- */
-export interface InitPaymentOption {
-  /** 选项值，对应 `InitPaymentMethod` */
-  value: InitPaymentMethod;
-  /** 展示给用户的标签 */
-  label: string;
-  /** 选段下方的小字提示，可选 */
-  hint?: string;
-}
-
-/**
- * `INIT_COMING_SOON_PAYMENT_OPTIONS` 里的单条目：未上线的支付方式占位。
- * 仅用于"更多支付方式"提示框展示，不可被选中。
- */
-export interface ComingSoonPaymentOption {
-  /** 选项 ID（仅作展示和未来上线时引用） */
-  id: string;
-  /** 人类可读名称 */
-  label: string;
-}
-
-/**
- * buyer-store 里 ClawTip 支付的已有绑定（持久化的关键字段）。
- * `resourceUrl` / `orderNo` 至少存在一个才视为"可复用绑定"。
- */
-export interface ExistingClawtipBinding {
-  /** 原始 config 对象（透传回 buyer-store 时用） */
-  config: Record<string, unknown>;
-  /** 资源 URL（可选） */
-  resourceUrl?: string;
-  /** 订单号（可选） */
-  orderNo?: string;
-}
-
-/**
- * `buildInitTerminalSelectionState()` 的输出单条，喂给 `@clack/prompts` 的多选组件。
- */
-export interface InitTerminalOption {
-  /** 选项值（通常是 `provider.id` 或 `"other"`） */
-  value: string;
-  /** 展示给用户的标签 */
-  label: string;
-  /** 选段下方的小字提示，可选 */
-  hint?: string;
-}
-
-/**
- * `buildInitTerminalSelectionState()` 的输出：已配置 / 待配置 两个分组。
- * `options` 末尾会追加 `OTHER_TERMINAL_OPTION`，给"我自己接"留口。
- */
-export interface InitTerminalSelectionState {
-  /** 已配置完成的 provider（`status === "configured"`） */
-  installed: InitTerminalOption[];
-  /** 待配置的 provider，末尾追加 `OTHER_TERMINAL_OPTION` */
-  options: InitTerminalOption[];
-}
-
-/**
- * `inspectOpenClawWalletConfig()` 的输出：本地 OpenClaw 钱包目录的探查结果。
- * `alternatePaths` 是 `~/.openclaw/configs/` 里除 `config.json` 之外的文件，
- * 用于在 missing 状态下提示用户"目录里其实有别的东西"。
- */
-export interface OpenClawWalletConfigState {
-  /** `~/.openclaw/configs/config.json` 的预期路径 */
-  expectedPath: string;
-  /** `~/.openclaw/configs/` 目录是否存在 */
-  configsDirExists: boolean;
-  /** `expectedPath` 是否真实存在 */
-  exists: boolean;
-  /** 同目录里其它文件路径（按文件名字典序） */
-  alternatePaths: string[];
-}
-
-/**
- * ClawTip 钱包就绪状态四象限：
- * - `ready`：saved binding + 本地 wallet config 同时存在
- * - `metadata_missing_wallet`：只 saved binding，wallet 缺
- * - `wallet_missing_metadata`：只 wallet config，metadata 缺
- * - `missing`：都缺
- */
-export type ClawtipWalletStatus =
-  | "ready"
-  | "metadata_missing_wallet"
-  | "wallet_missing_metadata"
-  | "missing";
-
-/**
- * `inspectClawtipWalletReadiness()` 的输出：状态枚举 + 物证 + 给用户看的说明。
- */
-export interface ClawtipWalletReadiness {
-  /** 综合状态 */
-  status: ClawtipWalletStatus;
-  /** 本地 OpenClaw wallet config 探查结果 */
-  walletConfig: OpenClawWalletConfigState;
-  /** buyer-store 里的 saved binding（如果有） */
-  savedBinding?: ExistingClawtipBinding;
-  /** 既 saved 又本地存在的可复用 binding（如果有） */
-  reusableBinding?: ExistingClawtipBinding;
-  /** 面向 init 面板 / doctor 的人类可读说明 */
-  message: string;
-}
-
-/** init 流程里"我自己接"的兜底选项 */
-export const OTHER_TERMINAL_OPTION: InitTerminalOption = {
-  value: "other",
-  label: "Other",
-  hint: "I will configure my own terminal using the TokenBuddy proxy endpoints."
-};
-
-/** init 流程已支持的可选支付方式（喂给 `@clack/prompts` 的 select 组件） */
-export const INIT_PAYMENT_OPTIONS: InitPaymentOption[] = [
-  {
-    value: "clawtip",
-    label: "JD ClawTip Pay (Scan QR Code to activate)",
-    hint: "1 Fen activation fee"
-  }
-];
-
-/** init 流程"更多支付方式"占位列表（仅展示用，不可选） */
-export const INIT_COMING_SOON_PAYMENT_OPTIONS = [
-  {
-    id: "wechat-pay",
-    label: "WeChat Pay"
-  },
-  {
-    id: "alipay-agent-payment",
-    label: "Alipay Agent Payment"
-  },
-  {
-    id: "coinbase-smart-wallet",
-    label: "Coinbase Smart Wallet"
-  }
-] satisfies ReadonlyArray<ComingSoonPaymentOption>;
-
-/**
- * 在 init 流程的支付选择面板下追加"更多支付方式（接入中）"提示。
- *
- * @param note 注入的 note 函数（默认 `@clack/prompts.note`，测试可替换）
- */
-export function noteInitComingSoonPayments(
-  note: (message?: string, title?: string) => void = p.note
-): void {
-  note(
-    INIT_COMING_SOON_PAYMENT_OPTIONS.map((entry) => `- ${entry.label}（接入中）`).join("\n"),
-    "更多支付方式"
-  );
-}
-
-/**
- * 把 provider-install 阶段的探测结果转成 `InitTerminalSelectionState`：
- * 已配置完成的归 `installed`；已检测到但未配置的归 `options`，末尾追加 `OTHER_TERMINAL_OPTION`。
- *
- * @param providers provider-install 的探测结果
- * @returns init 流程的多选状态
- */
-export function buildInitTerminalSelectionState(providers: ProviderCandidate[]): InitTerminalSelectionState {
-  const installed = providers
-    .filter((provider) => provider.detected && provider.status === "configured")
-    .map((provider) => ({
-      value: provider.id,
-      label: `${provider.name}（已安装）`,
-      hint: provider.reason
-    }));
-
-  const options = providers
-    .filter((provider) => provider.detected && provider.status !== "configured")
-    .map((provider) => ({
-      value: provider.id,
-      label: provider.name,
-      hint: provider.reason
-    }));
-
-  return {
-    installed,
-    options: [...options, OTHER_TERMINAL_OPTION]
-  };
-}
-
-/**
- * 校验 init 多选面板的返回值：必须至少选一个 terminal 或选择 `Other`。
- *
- * @param selected `@clack/prompts` 多选返回值
- * @returns 错误消息字符串；合法时返回 `undefined`
- */
-export function validateInitTerminalSelection(selected: string[] | undefined): string | undefined {
-  if (!selected || selected.length === 0) {
-    return "Select at least one terminal or choose Other.";
-  }
-  return undefined;
-}
-
-/**
- * 把"已配置完成的 terminal"列表渲染成 init 面板顶部的摘要文案。
- *
- * @param installed 已配置完成的 terminal 列表
- * @returns 多行 markdown 摘要；空列表时返回 `undefined`
- */
-export function buildInstalledTerminalMessage(installed: InitTerminalOption[]): string | undefined {
-  if (installed.length === 0) {
-    return undefined;
-  }
-  return installed
-    .map((entry) => `- ${entry.label}${entry.hint ? `\n  ${entry.hint}` : ""}`)
-    .join("\n");
-}
-
-function defaultHomeDir(): string {
-  return process.env.HOME || os.homedir();
-}
-
-/**
- * 探查 `~/.openclaw/configs/` 目录及其默认 wallet 配置：
- * - 是否存在 configs 目录
- * - `config.json` 是否存在
- * - 同目录里其它文件列表（用于 missing 状态下的提示）
- *
- * @param home 用户 home 目录（默认读 `process.env.HOME` 或 `os.homedir()`）
- * @returns 探查结果
- */
-export function inspectOpenClawWalletConfig(home: string = defaultHomeDir()): OpenClawWalletConfigState {
-  const configsDir = path.join(home, ".openclaw", "configs");
-  const expectedPath = path.join(configsDir, "config.json");
-  const configsDirExists = fs.existsSync(configsDir);
-  const alternatePaths: string[] = [];
-
-  if (configsDirExists) {
-    try {
-      const entries = fs.readdirSync(configsDir)
-        .filter((entry) => entry !== "config.json" && !entry.startsWith("."))
-        .sort();
-      for (const entry of entries) {
-        alternatePaths.push(path.join(configsDir, entry));
-      }
-    } catch {
-      // Ignore directory read failures and treat as no alternates.
-    }
-  }
-
-  return {
-    expectedPath,
-    configsDirExists,
-    exists: fs.existsSync(expectedPath),
-    alternatePaths
-  };
-}
-
-function stringField(value: unknown): string | undefined {
-  return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
-}
-
-/**
- * 从 `PaymentConfig` 里识别 ClawTip 已保存的关键字段（`resourceUrl` / `orderNo`）。
- * 两者都没有时返回 `undefined`。
- *
- * @param payment buyer-store 读到的 payment 配置
- * @returns 识别出的 binding；无关键字段时返回 `undefined`
- */
-export function detectExistingClawtipBinding(payment: PaymentConfig | undefined): ExistingClawtipBinding | undefined {
-  if (!payment || payment.method !== "clawtip" || !payment.config || typeof payment.config !== "object") {
-    return undefined;
-  }
-  const config = payment.config as Record<string, unknown>;
-  const resourceUrl = stringField(config.resourceUrl);
-  const orderNo = stringField(config.orderNo);
-  if (!resourceUrl && !orderNo) {
-    return undefined;
-  }
-  return {
-    config,
-    resourceUrl,
-    orderNo,
-  };
-}
-
-/**
- * 判断已保存的 ClawTip binding 能否被本地 OpenClaw wallet config 复用：
- * wallet config 必须存在并且 saved binding 至少有一个关键字段。
- *
- * @param payment buyer-store 读到的 payment 配置
- * @param walletConfig `inspectOpenClawWalletConfig()` 的结果
- * @returns 可复用 binding；不可复用时返回 `undefined`
- */
-export function detectReusableClawtipBinding(
-  payment: PaymentConfig | undefined,
-  walletConfig: OpenClawWalletConfigState
-): ExistingClawtipBinding | undefined {
-  if (!walletConfig.exists) {
-    return undefined;
-  }
-  return detectExistingClawtipBinding(payment);
-}
-
-/**
- * 综合判断 ClawTip 钱包的就绪状态：把 saved binding、wallet config 和 reuse 关系
- * 合并成 `ClawtipWalletReadiness`，供 init 面板、doctor 和激活流程共同消费。
- *
- * @param payment buyer-store 读到的 payment 配置
- * @param walletConfig 本地 wallet 探查结果（默认 `inspectOpenClawWalletConfig()`）
- * @returns 就绪状态 + 物证 + 人类可读说明
- */
-export function inspectClawtipWalletReadiness(
-  payment: PaymentConfig | undefined,
-  walletConfig: OpenClawWalletConfigState = inspectOpenClawWalletConfig(),
-): ClawtipWalletReadiness {
-  const savedBinding = detectExistingClawtipBinding(payment);
-  const reusableBinding = detectReusableClawtipBinding(payment, walletConfig);
-
-  if (reusableBinding) {
-    return {
-      status: "ready",
-      walletConfig,
-      savedBinding,
-      reusableBinding,
-      message: "ClawTip payment metadata and local OpenClaw wallet config are both present.",
-    };
-  }
-
-  if (savedBinding) {
-    return {
-      status: "metadata_missing_wallet",
-      walletConfig,
-      savedBinding,
-      message: "Saved ClawTip payment metadata exists, but the local OpenClaw wallet config is missing.",
-    };
-  }
-
-  if (walletConfig.exists) {
-    return {
-      status: "wallet_missing_metadata",
-      walletConfig,
-      message: "Local OpenClaw wallet config exists, but TokenBuddy ClawTip payment metadata is not saved.",
-    };
-  }
-
-  return {
-    status: "missing",
-    walletConfig,
-    message: "ClawTip payment metadata and local OpenClaw wallet config are not configured.",
-  };
-}
-
-/**
- * 把 init 流程的若干条摘要拼成"成功"提示：
- * - 顶部一行 emoji + 成功消息
- * - 中间每条摘要 `- ` 开头
- * - 末尾附 `tb doctor` 提示
- *
- * @param summaryLines 摘要行（会先 trim，空行会被跳过）
- * @returns 多行 markdown 摘要
- */
-export function buildInitSuccessMessage(summaryLines: string[] = []): string {
-  const lines = ["✅ TokenBuddy setup completed successfully."];
-  for (const line of summaryLines) {
-    const trimmed = line.trim();
-    if (trimmed) {
-      lines.push(`- ${trimmed}`);
-    }
-  }
-  lines.push("Run `tb doctor` to audit status anytime.");
-  return lines.join("\n");
-}

package/src/init-setup.ts

@@ -1,165 +0,0 @@
-export const INIT_SETUP_CONFIG_KEY = "init-setup";
-
-export const INIT_SETUP_VERSION = 1;
-
-export const INIT_SETUP_STEPS = [
-  "gateway_intro",
-  "model_access",
-  "supplier_routing",
-  "auto_purchase",
-  "connect_tools",
-  "verify_gateway",
-  "install_app",
-] as const;
-
-export const DEFAULT_INIT_RECOMMENDED_MODELS = [
-  "deepseek-v4-flash",
-  "kimi-2.6",
-  "gpt-5.5",
-  "gpt-5.4",
-  "claude-opus-4.7",
-  "claude-opus-4.8",
-  "claude-sonnet-4.6",
-  "gemma-4-26b-a4b-it",
-  "qwen3-235b-a22b",
-  "google/gemini-3.5-flash",
-  "google/gemini-3.1-pro-preview",
-  "qwen/qwen3.7-max",
-  "qwen/qwen3.7-plus",
-] as const;
-
-export type InitSetupStep = typeof INIT_SETUP_STEPS[number];
-export type InitSetupStatus = "not_started" | "in_progress" | "completed";
-
-export interface InitSetupMarker {
-  status: InitSetupStatus;
-  version: typeof INIT_SETUP_VERSION;
-  completedSteps: InitSetupStep[];
-  startedAt?: string;
-  updatedAt?: string;
-  completedAt?: string;
-}
-
-const INIT_SETUP_STEP_SET = new Set<string>(INIT_SETUP_STEPS);
-
-export function normalizeInitSetupMarker(value: unknown): InitSetupMarker {
-  if (!value || typeof value !== "object") {
-    return defaultInitSetupMarker();
-  }
-  const raw = value as {
-    status?: unknown;
-    completedSteps?: unknown;
-    startedAt?: unknown;
-    updatedAt?: unknown;
-    completedAt?: unknown;
-  };
-  const status = normalizeInitSetupStatus(raw.status);
-  return {
-    status,
-    version: INIT_SETUP_VERSION,
-    completedSteps: normalizeInitSetupSteps(raw.completedSteps),
-    startedAt: typeof raw.startedAt === "string" ? raw.startedAt : undefined,
-    updatedAt: typeof raw.updatedAt === "string" ? raw.updatedAt : undefined,
-    completedAt: typeof raw.completedAt === "string" ? raw.completedAt : undefined,
-  };
-}
-
-export function buildInProgressInitSetupMarker(
-  previous: InitSetupMarker = defaultInitSetupMarker(),
-  now: Date = new Date(),
-): InitSetupMarker {
-  const updatedAt = now.toISOString();
-  return {
-    ...previous,
-    status: previous.status === "completed" ? "completed" : "in_progress",
-    version: INIT_SETUP_VERSION,
-    startedAt: previous.startedAt || updatedAt,
-    updatedAt,
-  };
-}
-
-export function buildCompletedInitSetupMarker(
-  completedSteps: readonly string[] = INIT_SETUP_STEPS,
-  now: Date = new Date(),
-): InitSetupMarker {
-  const normalizedSteps = normalizeInitSetupSteps(completedSteps);
-  const updatedAt = now.toISOString();
-  return {
-    status: "completed",
-    version: INIT_SETUP_VERSION,
-    completedSteps: normalizedSteps.length > 0 ? normalizedSteps : [...INIT_SETUP_STEPS],
-    startedAt: updatedAt,
-    updatedAt,
-    completedAt: updatedAt,
-  };
-}
-
-export function assertInitSetupSteps(value: unknown): InitSetupStep[] {
-  if (value === undefined) {
-    return [...INIT_SETUP_STEPS];
-  }
-  if (!Array.isArray(value)) {
-    throw new Error("completedSteps must be an array");
-  }
-  const steps: InitSetupStep[] = [];
-  for (const entry of value) {
-    if (typeof entry !== "string" || !INIT_SETUP_STEP_SET.has(entry)) {
-      throw new Error(`unknown init setup step: ${String(entry)}`);
-    }
-    if (!steps.includes(entry as InitSetupStep)) {
-      steps.push(entry as InitSetupStep);
-    }
-  }
-  return steps;
-}
-
-export function isFreshInitMachine(marker: InitSetupMarker): boolean {
-  return marker.status !== "completed";
-}
-
-export function normalizeInitRecommendedModels(value: readonly string[] | string | undefined): string[] {
-  const entries = typeof value === "string"
-    ? value.split(",")
-    : value ?? [];
-  return Array.from(new Set(entries.map((entry) => entry.trim()).filter(Boolean)));
-}
-
-export function resolveInitRecommendedModels(input?: {
-  configuredModels?: readonly string[];
-  env?: Record<string, string | undefined>;
-}): string[] {
-  const configured = normalizeInitRecommendedModels(input?.configuredModels);
-  if (configured.length > 0) {
-    return configured;
-  }
-  const envModels = normalizeInitRecommendedModels(input?.env?.TB_PROXYD_INIT_RECOMMENDED_MODELS);
-  if (envModels.length > 0) {
-    return envModels;
-  }
-  return [...DEFAULT_INIT_RECOMMENDED_MODELS];
-}
-
-function defaultInitSetupMarker(): InitSetupMarker {
-  return {
-    status: "not_started",
-    version: INIT_SETUP_VERSION,
-    completedSteps: [],
-  };
-}
-
-function normalizeInitSetupStatus(value: unknown): InitSetupStatus {
-  return value === "in_progress" || value === "completed" ? value : "not_started";
-}
-
-function normalizeInitSetupSteps(value: unknown): InitSetupStep[] {
-  if (!Array.isArray(value)) {
-    return [];
-  }
-  const steps: InitSetupStep[] = [];
-  for (const entry of value) {
-    if (typeof entry === "string" && INIT_SETUP_STEP_SET.has(entry) && !steps.includes(entry as InitSetupStep)) {
-      steps.push(entry as InitSetupStep);
-    }
-  }
-  return steps;
-}