@visiblebase/manager 0.1.1

package/bin/auth/user.js

@@ -0,0 +1,223 @@
+/**
+ * User 鉴权模块。
+ *
+ * 支持四种登录方式：
+ *   1. Email Login      — 邮箱 + 密码直接登录
+ *   2. Email Register   — 邮箱 + 密码注册 → 验证码 → 完成
+ *   3. GitHub OAuth     — 浏览器授权
+ *   4. Google OAuth     — 浏览器授权
+ *
+ * 已有有效 session 直接返回，不重复鉴权。
+ */
+import { execSync } from "node:child_process";
+import { UserClient } from "@visiblebase/client";
+import { select, isCancel } from "@clack/prompts";
+import { normalizeBaseUrl } from "../core/env.js";
+import { readUserSession, writeUserSession, readConfig } from "../core/session.js";
+import { askText, askSecret, showError, showSuccess, show } from "../core/ui.js";
+// ===========================================================================
+// 入口
+// ===========================================================================
+export async function userAuth(baseUrl) {
+    const existing = readUserSession(normalizeBaseUrl(baseUrl));
+    if (existing)
+        return { session: existing, config: readConfig() };
+    while (true) {
+        const method = await selectAuthMethod();
+        if (!method)
+            return undefined;
+        const ctx = await doAuth(baseUrl, method);
+        if (ctx)
+            return ctx;
+    }
+}
+async function selectAuthMethod() {
+    const selected = await select({
+        message: "Sign in",
+        options: [
+            { label: "Email Login", value: "login", hint: "Sign in with email + password" },
+            { label: "Email Register", value: "register", hint: "Create a new account" },
+            { label: "GitHub", value: "github", hint: "Sign in with GitHub OAuth" },
+            { label: "Google", value: "google", hint: "Sign in with Google OAuth" },
+        ],
+    });
+    if (!selected || isCancel(selected))
+        return undefined;
+    return selected;
+}
+// ===========================================================================
+// 鉴权分发
+// ===========================================================================
+async function doAuth(baseUrl, method) {
+    switch (method) {
+        case "login": return emailLogin(baseUrl);
+        case "register": return emailRegister(baseUrl);
+        case "github": return oauthAuth(baseUrl, "github");
+        case "google": return oauthAuth(baseUrl, "google");
+    }
+}
+async function emailLogin(baseUrl) {
+    const email = await askText("email");
+    if (!email || !email.includes("@")) {
+        showError("invalid email");
+        return undefined;
+    }
+    const password = await askSecret("password");
+    if (!password)
+        return undefined;
+    const client = new UserClient({ base_url: normalizeBaseUrl(baseUrl) });
+    const accounts = client.service("accounts");
+    try {
+        const result = await accounts.action("login").invoke({ email, password });
+        if (result.error) {
+            showError(result.error);
+            return undefined;
+        }
+        if (!result.user_token) {
+            showError("login failed: no token");
+            return undefined;
+        }
+        return saveSession(baseUrl, email, result);
+    }
+    catch (e) {
+        showError(e instanceof Error ? e.message : String(e));
+        return undefined;
+    }
+}
+async function emailRegister(baseUrl) {
+    const email = await askText("email");
+    if (!email || !email.includes("@")) {
+        showError("invalid email");
+        return undefined;
+    }
+    const password = await askSecret("password (min 8 characters)");
+    if (!password || password.length < 8) {
+        showError("password must be at least 8 characters");
+        return undefined;
+    }
+    const client = new UserClient({ base_url: normalizeBaseUrl(baseUrl) });
+    const accounts = client.service("accounts");
+    let reg;
+    try {
+        reg = await accounts.action("register").invoke({ email, password });
+    }
+    catch (e) {
+        showError(e instanceof Error ? e.message : String(e));
+        return undefined;
+    }
+    if (reg.error) {
+        showError(reg.error);
+        return undefined;
+    }
+    if (!reg.success) {
+        showError("registration failed");
+        return undefined;
+    }
+    showSuccess("Verification code sent to your email");
+    show("If email delivery is unavailable, check server logs for the verification code.");
+    const token = await askText("verification token");
+    if (!token)
+        return undefined;
+    try {
+        const verify = await accounts.action("verify-email").invoke({ token: token.trim() });
+        if (verify.error) {
+            showError(verify.error);
+            return undefined;
+        }
+        if (!verify.user_token) {
+            showError("verification failed: no token");
+            return undefined;
+        }
+        return saveSession(baseUrl, email, verify);
+    }
+    catch (e) {
+        showError(e instanceof Error ? e.message : String(e));
+        return undefined;
+    }
+}
+async function oauthAuth(baseUrl, provider) {
+    const client = new UserClient({ base_url: normalizeBaseUrl(baseUrl) });
+    const accounts = client.service("accounts");
+    let start;
+    try {
+        start = await accounts.action("oauth/start").invoke({ provider });
+    }
+    catch (e) {
+        showError(e instanceof Error ? e.message : String(e));
+        return undefined;
+    }
+    if (start.error) {
+        showError(start.error);
+        return undefined;
+    }
+    if (!start.url || !start.state) {
+        showError("failed to start OAuth");
+        return undefined;
+    }
+    show(`Opening browser for ${provider} authorization...`);
+    const opened = openBrowser(start.url);
+    if (!opened)
+        showError(`Could not open browser. Please visit:\n  ${start.url}`);
+    show("Waiting for authorization...");
+    const result = await pollOAuth(client, start.state);
+    if (!result || result.error) {
+        showError(result?.error ?? "OAuth failed");
+        return undefined;
+    }
+    if (!result.user_token) {
+        showError("OAuth failed: no token");
+        return undefined;
+    }
+    showSuccess(`${provider} login successful`);
+    return saveSession(baseUrl, `${provider}:`, result);
+}
+/** 轮询 OAuth 结果（最多 3 分钟） */
+async function pollOAuth(client, state) {
+    const accounts = client.service("accounts");
+    for (let i = 0; i < 180; i++) {
+        try {
+            const result = await accounts.get("oauth/result", { state });
+            if (result.error)
+                return result;
+            if (result.status === "done")
+                return result;
+        }
+        catch { /* continue polling */ }
+        await sleep(1000);
+    }
+    return { error: "OAuth timed out" };
+}
+// ===========================================================================
+// 工具函数
+// ===========================================================================
+function saveSession(baseUrl, email, result) {
+    const session = {
+        base_url: normalizeBaseUrl(baseUrl),
+        email,
+        user_id: result.user_id ?? "",
+        product_id: "prod_visiblebase",
+        user_token: result.user_token,
+    };
+    writeUserSession(session);
+    showSuccess(`signed in: ${email}`);
+    return { session, config: readConfig() };
+}
+/** 打开系统默认浏览器 */
+function openBrowser(url) {
+    try {
+        if (process.platform === "darwin")
+            execSync(`open "${url}"`);
+        else if (process.platform === "win32")
+            execSync(`start "" "${url}"`);
+        else
+            execSync(`xdg-open "${url}"`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=user.js.map

package/bin/auth/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../src/auth/user.ts"],"names":[],"mappings":"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"}

package/bin/core/env.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 运行时工具模块。
+ *
+ * 提供 CLI 参数解析、URL 规范化等基础设施。
+ */
+export declare const DEFAULT_HOST = "127.0.0.1";
+export declare const DEFAULT_PORT = 43127;
+export declare const DEFAULT_BASE_URL = "http://127.0.0.1:43127";
+export declare const DEFAULT_PRODUCT_ID = "prod_visiblebase";
+export declare function parseArgs(argv: string[]): {
+    command: string;
+    options: Record<string, string | boolean>;
+};
+export declare function normalizeBaseUrl(baseUrl?: string): string;
+//# sourceMappingURL=env.d.ts.map

package/bin/core/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/core/env.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,eAAO,MAAM,YAAY,cAAc,CAAC;AACxC,eAAO,MAAM,YAAY,QAAQ,CAAC;AAClC,eAAO,MAAM,gBAAgB,2BAA2C,CAAC;AACzE,eAAO,MAAM,kBAAkB,qBAAqB,CAAC;AAMrD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE;;;EAevC;AAMD,wBAAgB,gBAAgB,CAAC,OAAO,SAAmB,GAAG,MAAM,CAWnE"}

package/bin/core/env.js

@@ -0,0 +1,67 @@
+/**
+ * 运行时工具模块。
+ *
+ * 提供 CLI 参数解析、URL 规范化等基础设施。
+ */
+// ============================================================
+// 常量
+// ============================================================
+export const DEFAULT_HOST = "127.0.0.1";
+export const DEFAULT_PORT = 43127;
+export const DEFAULT_BASE_URL = `http://${DEFAULT_HOST}:${DEFAULT_PORT}`;
+export const DEFAULT_PRODUCT_ID = "prod_visiblebase";
+// ============================================================
+// CLI 参数解析
+// ============================================================
+export function parseArgs(argv) {
+    const positionals = [];
+    const options = {};
+    for (let index = 0; index < argv.length; index += 1) {
+        const token = argv[index];
+        if (!token.startsWith("--")) {
+            positionals.push(token);
+            continue;
+        }
+        const key = token.slice(2).replace(/-([a-z])/g, (_, l) => l.toUpperCase());
+        const next = argv[index + 1];
+        if (!next || next.startsWith("--")) {
+            options[key] = true;
+            continue;
+        }
+        options[key] = next;
+        index += 1;
+    }
+    return { command: positionals[0] ?? "", options };
+}
+// ============================================================
+// URL 规范化
+// ============================================================
+export function normalizeBaseUrl(baseUrl = DEFAULT_BASE_URL) {
+    const raw = String(baseUrl).trim();
+    if (!raw)
+        return DEFAULT_BASE_URL;
+    const hasProtocol = /^[a-z][a-z\d+.-]*:\/\//iu.test(raw);
+    const withProtocol = hasProtocol ? raw : `${defaultProtocol(raw)}://${raw}`;
+    const url = new URL(withProtocol);
+    if (!url.port && isLocalOrIp(url.hostname))
+        url.port = String(DEFAULT_PORT);
+    if (!url.pathname || url.pathname === "/")
+        url.pathname = "/";
+    return url.toString().replace(/\/+$/, "");
+}
+// ============================================================
+// 内部辅助
+// ============================================================
+function defaultProtocol(value) {
+    const host = value.split("/")[0] ?? "";
+    return (isLocalOrIp(host.split(":")[0] ?? "") || host.includes(":")) ? "http" : "https";
+}
+function isLocalOrIp(value) {
+    const host = value.replace(/^\[/u, "").replace(/\]$/u, "");
+    return host === "localhost" || isIpv4Host(host) || host.includes(":");
+}
+function isIpv4Host(value) {
+    const parts = value.split(".");
+    return parts.length === 4 && parts.every((p) => /^\d+$/u.test(p) && Number(p) <= 255);
+}
+//# sourceMappingURL=env.js.map

package/bin/core/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/core/env.ts"],"names":[],"mappings":"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"}

package/bin/core/session.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Session 持久化模块。
+ *
+ * 支持多服务端地址，每个地址独立保存 admin / user session。
+ * 使用 URL 哈希作为目录名，避免特殊字符问题。
+ */
+export interface AdminSession {
+    base_url: string;
+    admin_token: string;
+}
+export interface UserSession {
+    base_url: string;
+    email: string;
+    user_id: string;
+    product_id: string;
+    user_token: string;
+}
+/** 单个服务端配置 */
+export interface ServerProfile {
+    /** 显示名称 */
+    name: string;
+    /** 服务端 URL */
+    url: string;
+}
+export interface ClientConfig {
+    /** 当前激活的服务端 URL */
+    base_url: string;
+    /** 已保存的服务端列表 */
+    servers: ServerProfile[];
+    /** 当前选择的模型 ID */
+    model: string;
+    /** 上次使用的身份 */
+    last_identity?: "admin" | "user";
+}
+/** 从磁盘读取 config，缺失字段用默认值补齐 */
+export declare function readConfig(): ClientConfig;
+/** 写入 config 到磁盘 */
+export declare function writeConfig(c: ClientConfig): void;
+/** 切换激活的服务端（caller 保证 url 已在 servers 列表中） */
+export declare function switchServer(url: string): void;
+/** 添加服务端（同名则更新名称） */
+export declare function addServer(name: string, url: string): void;
+/** 删除服务端，同时清除其 session */
+export declare function removeServer(url: string): void;
+export declare function readAdminSession(url: string): AdminSession | undefined;
+export declare function writeAdminSession(s: AdminSession): void;
+export declare function clearAdminSession(url: string): void;
+export declare function readUserSession(url: string): UserSession | undefined;
+export declare function writeUserSession(s: UserSession): void;
+export declare function clearUserSession(url: string): void;
+/** 清除某服务端的所有 session（admin + user） */
+export declare function clearServerSessions(url: string): void;
+//# sourceMappingURL=session.d.ts.map

package/bin/core/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,cAAc;AACd,MAAM,WAAW,aAAa;IAC5B,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc;IACd,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAClC;AAMD,8BAA8B;AAC9B,wBAAgB,UAAU,IAAI,YAAY,CAWzC;AAED,oBAAoB;AACpB,wBAAgB,WAAW,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,CAEjD;AAMD,6CAA6C;AAC7C,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAI9C;AAED,qBAAqB;AACrB,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAMzD;AAED,0BAA0B;AAC1B,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAQ9C;AAaD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEtE;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,CAEvD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEpE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,CAErD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,sCAAsC;AACtC,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGrD"}

package/bin/core/session.js

@@ -0,0 +1,118 @@
+/**
+ * Session 持久化模块。
+ *
+ * 支持多服务端地址，每个地址独立保存 admin / user session。
+ * 使用 URL 哈希作为目录名，避免特殊字符问题。
+ */
+import fs from "node:fs";
+import path from "node:path";
+import crypto from "node:crypto";
+import { DEFAULT_BASE_URL } from "./env.js";
+const DIR = path.join(process.cwd(), ".viba");
+const CONFIG_FILE = path.join(DIR, "config.json");
+// ============================================================
+// Config 读写
+// ============================================================
+/** 从磁盘读取 config，缺失字段用默认值补齐 */
+export function readConfig() {
+    const c = readJSON(CONFIG_FILE) ?? {};
+    const servers = c.servers ?? [];
+    const base_url = c.base_url ?? servers[0]?.url ?? DEFAULT_BASE_URL;
+    // 确保当前 base_url 在 servers 列表中
+    if (servers.length === 0 || !servers.find((s) => s.url === base_url)) {
+        servers.unshift({ name: "default", url: base_url });
+    }
+    return { base_url, servers, model: c.model ?? "", last_identity: c.last_identity };
+}
+/** 写入 config 到磁盘 */
+export function writeConfig(c) {
+    writeJSON(CONFIG_FILE, c);
+}
+// ============================================================
+// 服务端管理
+// ============================================================
+/** 切换激活的服务端（caller 保证 url 已在 servers 列表中） */
+export function switchServer(url) {
+    const config = readConfig();
+    config.base_url = url;
+    writeConfig(config);
+}
+/** 添加服务端（同名则更新名称） */
+export function addServer(name, url) {
+    const config = readConfig();
+    const normalized = url.replace(/\/+$/, "");
+    const existing = config.servers.find((s) => s.url === normalized);
+    if (existing) {
+        existing.name = name;
+    }
+    else {
+        config.servers.push({ name, url: normalized });
+    }
+    writeConfig(config);
+}
+/** 删除服务端，同时清除其 session */
+export function removeServer(url) {
+    const config = readConfig();
+    config.servers = config.servers.filter((s) => s.url !== url);
+    if (config.base_url === url) {
+        config.base_url = config.servers[0]?.url ?? DEFAULT_BASE_URL;
+    }
+    writeConfig(config);
+    clearServerSessions(url);
+}
+// ============================================================
+// Session 读写（按 URL 隔离）
+// ============================================================
+function sessionDir(url) {
+    return path.join(DIR, "servers", urlHash(url));
+}
+function adminFile(url) { return path.join(sessionDir(url), "admin.json"); }
+function userFile(url) { return path.join(sessionDir(url), "user.json"); }
+export function readAdminSession(url) {
+    return readJSON(adminFile(url));
+}
+export function writeAdminSession(s) {
+    writeJSON(adminFile(s.base_url), s);
+}
+export function clearAdminSession(url) {
+    try {
+        fs.unlinkSync(adminFile(url));
+    }
+    catch { /* ok */ }
+}
+export function readUserSession(url) {
+    return readJSON(userFile(url));
+}
+export function writeUserSession(s) {
+    writeJSON(userFile(s.base_url), s);
+}
+export function clearUserSession(url) {
+    try {
+        fs.unlinkSync(userFile(url));
+    }
+    catch { /* ok */ }
+}
+/** 清除某服务端的所有 session（admin + user） */
+export function clearServerSessions(url) {
+    clearAdminSession(url);
+    clearUserSession(url);
+}
+// ============================================================
+// 内部工具
+// ============================================================
+function urlHash(url) {
+    return crypto.createHash("sha256").update(url).digest("hex").slice(0, 16);
+}
+function readJSON(filepath) {
+    try {
+        return JSON.parse(fs.readFileSync(filepath, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+function writeJSON(filepath, data) {
+    fs.mkdirSync(path.dirname(filepath), { recursive: true });
+    fs.writeFileSync(filepath, JSON.stringify(data, null, 2));
+}
+//# sourceMappingURL=session.js.map

package/bin/core/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"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"}

package/bin/core/ui.d.ts

@@ -0,0 +1,29 @@
+/**
+ * UI 工具模块。
+ *
+ * 提供 CLI 交互所需的输入/输出封装。
+ * 模型选择接受通用的 { id, name, hint } 数组，不依赖 server model 类型。
+ */
+import { isCancel, intro, log } from "@clack/prompts";
+export { intro, log, isCancel };
+export declare function show(text: string): void;
+export declare function showError(text: string): void;
+export declare function showSuccess(text: string): void;
+/** 主命令菜单 */
+export declare function askUserCommand(): Promise<string | undefined>;
+/** 文本输入 */
+export declare function askText(label: string): Promise<string | undefined>;
+/** 密码输入 */
+export declare function askSecret(label: string): Promise<string | undefined>;
+/** 模型选项 */
+export interface ModelOption {
+    /** 模型 ID */
+    id: string;
+    /** 模型展示名 */
+    name: string;
+    /** 提示信息 */
+    hint: string;
+}
+/** 列出并选择模型，返回模型 id 或 undefined */
+export declare function askModel(models: ModelOption[], currentModel: string): Promise<string | undefined>;
+//# sourceMappingURL=ui.d.ts.map

package/bin/core/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/core/ui.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA0B,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAE9E,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;AAMhC,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAoB;AAC5D,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAqB;AAClE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAuB;AAMtE,YAAY;AACZ,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiBlE;AAED,WAAW;AACX,wBAAsB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAGxE;AAED,WAAW;AACX,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAG1E;AAMD,WAAW;AACX,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,kCAAkC;AAClC,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,WAAW,EAAE,EACrB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQ7B"}

package/bin/core/ui.js

@@ -0,0 +1,58 @@
+/**
+ * UI 工具模块。
+ *
+ * 提供 CLI 交互所需的输入/输出封装。
+ * 模型选择接受通用的 { id, name, hint } 数组，不依赖 server model 类型。
+ */
+import { password, select, text, isCancel, intro, log } from "@clack/prompts";
+export { intro, log, isCancel };
+// ============================================================
+// 显示函数
+// ============================================================
+export function show(text) { log.info(text); }
+export function showError(text) { log.error(text); }
+export function showSuccess(text) { log.success(text); }
+// ============================================================
+// 交互 prompts
+// ============================================================
+/** 主命令菜单 */
+export async function askUserCommand() {
+    const s = await select({ message: "Command", options: [
+            { label: "Chat (agent)", value: "chat", hint: "Continuous conversation with pi-agent" },
+            { label: "Models", value: "models", hint: "List and select model" },
+            { label: "Balance", value: "balance", hint: "View current balance" },
+            { label: "History", value: "history", hint: "View balance ledger" },
+            { label: "Topups", value: "topups", hint: "View recharge orders" },
+            { label: "Recharge", value: "recharge", hint: "Create a topup order" },
+            { label: "My profile", value: "me" },
+            { label: "List services", value: "services" },
+            { label: "Call service", value: "service" },
+            { label: "Switch to Admin", value: "switch" },
+            { label: "Logout", value: "logout" },
+            { label: "Quit", value: "quit" },
+        ] });
+    if (!s || isCancel(s))
+        return undefined;
+    return s;
+}
+/** 文本输入 */
+export async function askText(label) {
+    const v = await text({ message: label });
+    return (!v || isCancel(v)) ? undefined : v;
+}
+/** 密码输入 */
+export async function askSecret(label) {
+    const v = await password({ message: label });
+    return (!v || isCancel(v)) ? undefined : v;
+}
+/** 列出并选择模型，返回模型 id 或 undefined */
+export async function askModel(models, currentModel) {
+    const options = models.map((m) => ({
+        label: m.id === currentModel ? `★ ${m.name}` : `   ${m.name}`,
+        value: m.id,
+        hint: m.hint,
+    }));
+    const s = await select({ message: "Select model (★ current)", options });
+    return (!s || isCancel(s)) ? undefined : String(s);
+}
+//# sourceMappingURL=ui.js.map

package/bin/core/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/core/ui.ts"],"names":[],"mappings":"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"}

package/bin/user/balance.d.ts

@@ -0,0 +1,19 @@
+/**
+ * User Balance 命令。
+ *
+ * 提供：
+ * - 查看当前余额
+ * - 查看个人流水
+ * - 查看个人充值单
+ * - 发起充值
+ */
+import type { UserClient } from "@visiblebase/client";
+/** 展示当前余额 */
+export declare function showBalance(c: UserClient): Promise<void>;
+/** 展示个人流水 */
+export declare function showBalanceHistory(c: UserClient): Promise<void>;
+/** 展示个人充值单 */
+export declare function showTopups(c: UserClient): Promise<void>;
+/** 发起充值 */
+export declare function createTopup(c: UserClient): Promise<void>;
+//# sourceMappingURL=balance.d.ts.map

package/bin/user/balance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.d.ts","sourceRoot":"","sources":["../../src/user/balance.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAwCtD,aAAa;AACb,wBAAsB,WAAW,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9D;AAED,aAAa;AACb,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAYrE;AAED,cAAc;AACd,wBAAsB,UAAU,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAY7D;AAED,WAAW;AACX,wBAAsB,WAAW,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB9D"}