u1s1-cli 0.9.3 → 0.11.0

package/dist/agent-setup.d.ts

@@ -0,0 +1,32 @@
+import { type CliConfig } from "./config.js";
+/** pi auto-appends <agentDir>/APPEND_SYSTEM.md to its system prompt — our branding hook. */
+export declare function ensureBrandPrompt(): void;
+/** Defaults that don't overwrite values the user already set. */
+export declare function ensureDefaultSettings(): void;
+/** ≤0.4.0 wrote u1s1-dark/u1s1-light into the pi themes dir; remove them. */
+export declare function cleanupBrandThemes(): void;
+/**
+ * u1s1 provider for SDK-based frontends (`u1s1 web`): pi composes
+ * <agentDir>/models.json above registered providers, so this exposes the same
+ * models as the TUI's in-process extension without patching the frontend.
+ * apiKey stays an env reference — the launcher sets U1S1_API_KEY, the file
+ * itself holds no secret. Rewritten on every launch so baseUrl/model changes
+ * propagate; other providers a user may have added are preserved.
+ */
+/**
+ * 联网工具经 <agentDir>/extensions 投影:pi 的资源加载器对 TUI 和 `u1s1 web`
+ * 都会扫描这个目录,两个前端从此共用同一份工具注册,不用各接一遍。
+ * 文件每次启动重写(baseUrl/服务端开关变化随之生效);apiKey 走 U1S1_API_KEY
+ * 环境变量,文件里不落密钥。U1S1_TOOLS_VIA_EXTENSION 守卫:旧版 CLI 仍在
+ * 进程内注册工具且不设该变量,残留的本文件在旧版下自动空转,避免双重注册。
+ */
+export declare function writeWebToolsExtension(cfg: CliConfig, webSearchEnabled: boolean): void;
+/**
+ * pi-web-ui 的就绪检测只认 <agentDir>/auth.json 里有没有凭据条目(models.json
+ * 的 apiKey 它不看),空 {} 会在网页里弹「未检测到 pi agent 配置」引导装 pi。
+ * 这里补一条 u1s1 的 api_key 记录 —— key 用 $U1S1_API_KEY 环境变量引用,
+ * pi 的 resolveConfigValue 读取时才解析,文件本身不落密钥,和 models.json 同款。
+ * 其他 provider 的凭据原样保留;文件损坏时不动它,交给 SDK 自己报错。
+ */
+export declare function ensureAuthCredential(): void;
+export declare function ensureProviderModels(cfg: CliConfig): void;

package/dist/agent-setup.js

@@ -106,6 +106,33 @@ export function writeWebToolsExtension(cfg, webSearchEnabled) {
         `  pi.registerTool(tools.webFetchTool);\n` +
         `}\n`);
 }
+/**
+ * pi-web-ui 的就绪检测只认 <agentDir>/auth.json 里有没有凭据条目(models.json
+ * 的 apiKey 它不看),空 {} 会在网页里弹「未检测到 pi agent 配置」引导装 pi。
+ * 这里补一条 u1s1 的 api_key 记录 —— key 用 $U1S1_API_KEY 环境变量引用,
+ * pi 的 resolveConfigValue 读取时才解析,文件本身不落密钥,和 models.json 同款。
+ * 其他 provider 的凭据原样保留;文件损坏时不动它,交给 SDK 自己报错。
+ */
+export function ensureAuthCredential() {
+    mkdirSync(agentDir, { recursive: true });
+    const p = join(agentDir, "auth.json");
+    let root = {};
+    if (existsSync(p)) {
+        try {
+            root = JSON.parse(readFileSync(p, "utf8"));
+        }
+        catch {
+            return;
+        }
+        if (typeof root !== "object" || root === null || Array.isArray(root))
+            return;
+    }
+    const entry = root[PROVIDER_ID];
+    if (entry?.["type"] === "api_key" && entry["key"] === "$U1S1_API_KEY")
+        return;
+    root[PROVIDER_ID] = { type: "api_key", key: "$U1S1_API_KEY" };
+    writeFileSync(p, JSON.stringify(root, null, 2) + "\n", { mode: 0o600 });
+}
 export function ensureProviderModels(cfg) {
     mkdirSync(agentDir, { recursive: true });
     const p = join(agentDir, "models.json");

package/dist/api.d.ts

@@ -0,0 +1,51 @@
+import { type CliConfig } from "./config.js";
+export interface MeResponse {
+    email: string | null;
+    signup_credit_usd?: number;
+    monthly_free_usd?: number;
+    daily_free_usd: number;
+    daily_free_used_usd: number;
+    daily_free_remaining_usd: number;
+    daily_free_resets_at: string;
+    daily_free_model: string;
+    mtd_usd: number;
+    balance_spent_usd: number;
+    bonus_balance_usd: number;
+    remaining_usd: number;
+    /** USD→默认模型 Token 折算率;老网关没有该字段,展示时需兜底回 $ */
+    tokens_per_usd?: number;
+}
+export interface ApiModel {
+    id: string;
+    name: string;
+    reasoning: boolean;
+    context_length: number;
+    max_tokens: number;
+    price: {
+        input: number;
+        output: number;
+        cache_read: number | null;
+    };
+}
+/** 服务端能力开关;字段缺失(老网关)时按开启处理,保持现状。 */
+export interface ApiFeatures {
+    web_search?: boolean;
+}
+export interface ModelsResponse {
+    models: ApiModel[];
+    features: ApiFeatures;
+}
+export declare function fetchModels(cfg: CliConfig): Promise<ModelsResponse>;
+export interface SearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+}
+export interface SearchResponse {
+    query: string;
+    answer: string | null;
+    results: SearchResult[];
+}
+/** 联网搜索走网关代理（上游 key 只在服务端）。maxResults 不传时由服务端决定默认值。 */
+export declare function searchWeb(cfg: Pick<CliConfig, "baseUrl" | "apiKey">, query: string, maxResults?: number, signal?: AbortSignal): Promise<SearchResponse>;
+export declare function fetchMe(cfg: CliConfig): Promise<MeResponse>;

package/dist/brand.d.ts

@@ -0,0 +1,13 @@
+import type { Theme } from "@earendil-works/pi-coding-agent";
+export declare const BRAND_NAME = "u1s1";
+export declare const BRAND_CN = "\u6709\u4E00\u8BF4\u4E00";
+export declare const BRAND_TAGLINE = "\u8BF4\u4EBA\u8BDD\u7684 AI \u7F16\u7A0B\u642D\u5B50";
+export declare const DASHBOARD_URL = "https://u1s1.io/dashboard";
+export declare function formatHomePath(path: string): string;
+export declare const HERO_ART: string[];
+/**
+ * Startup hero, responsive to terminal width:
+ * wide → wordmark with info column beside it; medium → stacked; narrow → one-liner.
+ */
+export declare function renderBrandHeader(theme: Theme, version: string, cwd: string, width: number, notice?: string): string[];
+export declare function printConsoleBanner(version: string): void;

package/dist/config.d.ts

@@ -0,0 +1,77 @@
+export declare const VERSION: string;
+/**
+ * 便携包安装(install.sh / install.ps1):包根旁边带自己的 node 运行时,
+ * npm 更新碰不到这份拷贝,升级只能整包重装。npm 全局安装的包在 node_modules
+ * 下,按父目录名先排除,避免撞上恰好叫 node 的目录误判。
+ */
+export declare function isPortableInstall(): boolean;
+export declare const DEFAULT_BASE_URL = "https://api.u1s1.io/v1";
+export declare const PROVIDER_ID = "u1s1";
+/**
+ * Convert an API model response to our internal ModelDef.
+ * Aliases are derived from the short id; note is left empty (filled by /model command).
+ */
+export declare function apiModelToDef(m: {
+    id: string;
+    name: string;
+    reasoning: boolean;
+    context_length: number;
+    max_tokens: number;
+    price: {
+        input: number;
+        output: number;
+        cache_read: number | null;
+    };
+}): ModelDef;
+export interface ModelDef {
+    id: string;
+    name: string;
+    /** short aliases accepted by `u1s1 model <name>` */
+    aliases: string[];
+    reasoning: boolean;
+    contextWindow: number;
+    maxTokens: number;
+    /** USD per million tokens — display/estimation only; billing is server-side */
+    cost: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+    };
+    note: string;
+}
+export declare const MODELS: ModelDef[];
+/** Replace MODELS with a fresh list fetched from server (e.g. at startup). */
+export declare function setModelsFromApi(apiModels: ModelDef[]): void;
+export declare const DEFAULT_MODEL_ID: string;
+export declare function resolveModel(nameOrAlias: string): ModelDef | undefined;
+export interface CliConfig {
+    apiKey?: string;
+    baseUrl: string;
+    /** preferred model id; must be one of MODELS */
+    model?: string;
+}
+export declare const u1s1Dir: string;
+/** pi keeps auth/models/settings/sessions under this dir — isolated from any real pi install. */
+export declare const agentDir: string;
+export declare const agentSettingsFile: string;
+export interface AgentSettings {
+    showStartupBanner?: boolean;
+    autoUpdate?: boolean;
+    [key: string]: unknown;
+}
+/** Read u1s1 agent settings (settings.json). Returns empty object if missing or invalid. */
+export declare function readSettings(): AgentSettings;
+/** Model last chosen in-session via /model (pi writes this). */
+export declare function readAgentDefaultModel(): string | undefined;
+/** Keep pi's settings.json in sync so /model and `u1s1 model` share one default. */
+export declare function writeAgentDefaultModel(modelId: string): void;
+/**
+ * After this fix both stores stay in sync. If they still disagree (old installs),
+ * prefer the in-session /model value — that's the one users thought they had set.
+ */
+export declare function resolvePreferredModel(configModel: string | undefined): string;
+export declare function loadConfig(): CliConfig;
+export declare function saveConfig(cfg: CliConfig): void;
+/** Persist the user's preferred model to both stores. */
+export declare function persistPreferredModel(cfg: CliConfig, modelId: string): CliConfig;

package/dist/deploy.d.ts

@@ -0,0 +1,2 @@
+import { type CliConfig } from "./config.js";
+export declare function deployCommand(cfg: CliConfig, args: string[]): Promise<void>;

package/dist/deploy.js

@@ -0,0 +1,235 @@
+import { existsSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { basename, join, relative, resolve, sep } from "node:path";
+import { createInterface } from "node:readline/promises";
+import { VERSION, u1s1Dir } from "./config.js";
+/**
+ * u1s1 deploy:把静态网页一键发布到 <name>.u1s1.app。
+ * 检测项目里的静态站点根目录 → 首次询问子域名(记在 ~/.u1s1/deploys.json)
+ * → 并发上传 → 网关原子切换生效,输出可分享的网址。
+ */
+const deploysFile = join(u1s1Dir, "deploys.json");
+/** 构建产物目录优先:Vite/Next 等项目根的 index.html 是源码,不是能直接上线的产物。 */
+const BUILD_DIRS = ["dist", "build", "out", "_site", "public"];
+const SKIP_DIRS = new Set(["node_modules", "__pycache__"]);
+function authHeaders(apiKey) {
+    return { authorization: `Bearer ${apiKey}`, "x-u1s1-version": VERSION };
+}
+function readDeploys() {
+    try {
+        return JSON.parse(readFileSync(deploysFile, "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+function rememberSite(dir, site) {
+    const all = readDeploys();
+    all[dir] = site;
+    writeFileSync(deploysFile, JSON.stringify(all, null, 2) + "\n");
+}
+/** 找要部署的目录:显式参数 > 含 index.html 的构建产物目录 > 当前目录本身。 */
+function resolveSiteDir(explicit) {
+    if (explicit) {
+        const dir = resolve(explicit);
+        if (!existsSync(dir) || !statSync(dir).isDirectory()) {
+            throw new Error(`目录不存在:${dir}`);
+        }
+        if (!existsSync(join(dir, "index.html"))) {
+            throw new Error(`${dir} 里没有 index.html,网站需要一个首页`);
+        }
+        return dir;
+    }
+    const cwd = process.cwd();
+    for (const sub of BUILD_DIRS) {
+        if (existsSync(join(cwd, sub, "index.html")))
+            return join(cwd, sub);
+    }
+    if (existsSync(join(cwd, "index.html")))
+        return cwd;
+    throw new Error("这里找不到能发布的网页(index.html)。\n" +
+        "  在网站目录里运行 u1s1 deploy,或指定目录:u1s1 deploy <目录>\n" +
+        "  如果项目需要构建(如 Vite/Next),先跑构建再部署 dist/ 等产物目录");
+}
+function collectFiles(root) {
+    const files = [];
+    const walk = (dir) => {
+        for (const name of readdirSync(dir)) {
+            if (name.startsWith(".") || SKIP_DIRS.has(name))
+                continue;
+            const abs = join(dir, name);
+            const st = statSync(abs);
+            if (st.isDirectory())
+                walk(abs);
+            else if (st.isFile()) {
+                files.push({ path: relative(root, abs).split(sep).join("/"), abs, bytes: st.size });
+            }
+        }
+    };
+    walk(root);
+    return files;
+}
+/** 从目录名生成默认子域名。 */
+function slugify(name) {
+    const slug = name
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, "-")
+        .replace(/-{2,}/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 30)
+        .replace(/^-+|-+$/g, "");
+    return slug.length >= 3 ? slug : `site-${Math.random().toString(36).slice(2, 6)}`;
+}
+function fmtBytes(n) {
+    if (n >= 1024 * 1024)
+        return `${(n / 1024 / 1024).toFixed(1)}MB`;
+    if (n >= 1024)
+        return `${Math.round(n / 1024)}KB`;
+    return `${n}B`;
+}
+async function api(cfg, method, path, body) {
+    let resp;
+    try {
+        resp = await fetch(`${cfg.baseUrl}${path}`, {
+            method,
+            headers: { ...authHeaders(cfg.apiKey), "content-type": "application/json" },
+            body: body === undefined ? undefined : JSON.stringify(body),
+        });
+    }
+    catch {
+        throw new Error(`连不上 ${cfg.baseUrl},检查一下网络?`);
+    }
+    const data = (await resp.json().catch(() => null));
+    if (!resp.ok) {
+        const e = new Error(data?.error?.message ?? `服务端返回 ${resp.status},稍后再试`);
+        e.code = data?.error?.code;
+        throw e;
+    }
+    return data;
+}
+/** 逐个上传,失败重试一次;并发数保守取 6。 */
+async function uploadAll(cfg, start, files) {
+    let done = 0;
+    const queue = [...files];
+    const uploadOne = async (f) => {
+        const qs = new URLSearchParams({ site: start.site, deploy_id: start.deploy_id, path: f.path });
+        const put = async () => fetch(`${cfg.baseUrl}/deploy/file?${qs}`, {
+            method: "PUT",
+            headers: { ...authHeaders(cfg.apiKey), "content-type": "application/octet-stream" },
+            body: readFileSync(f.abs),
+        });
+        let resp = await put().catch(() => null);
+        if (!resp?.ok)
+            resp = await put().catch(() => null);
+        if (!resp?.ok) {
+            const body = resp ? (await resp.json().catch(() => null)) : null;
+            throw new Error(`上传 ${f.path} 失败:${body?.error?.message ?? "网络错误"}`);
+        }
+        done++;
+        process.stdout.write(`\r  上传中 ${done}/${files.length}  ${f.path.slice(0, 48).padEnd(48)}`);
+    };
+    const workers = Array.from({ length: Math.min(6, queue.length) }, async () => {
+        for (let f = queue.shift(); f; f = queue.shift())
+            await uploadOne(f);
+    });
+    await Promise.all(workers);
+    process.stdout.write("\r" + " ".repeat(70) + "\r");
+}
+async function promptSiteName(def) {
+    if (!process.stdin.isTTY)
+        return def;
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const answer = (await rl.question(`  站点子域名(回车用 ${def}):`)).trim().toLowerCase();
+        return answer || def;
+    }
+    finally {
+        rl.close();
+    }
+}
+export async function deployCommand(cfg, args) {
+    // 参数:[dir] [--name xxx];u1s1 deploy list 列出已有站点
+    if (args[0] === "list") {
+        const { sites } = await api(cfg, "GET", "/deploy/sites");
+        if (!sites.length) {
+            console.log("  还没有部署过站点。在网页目录里跑 u1s1 deploy 试试。");
+            return;
+        }
+        console.log("");
+        for (const s of sites) {
+            console.log(`  ${s.deployed ? "●" : "○"} ${s.url}  ${fmtBytes(s.total_bytes)} · ${s.updated_at} UTC`);
+        }
+        console.log("");
+        return;
+    }
+    let name;
+    let dirArg;
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === "--name" || a === "-n")
+            name = args[++i]?.toLowerCase();
+        else if (a.startsWith("--name="))
+            name = a.slice(7).toLowerCase();
+        else if (!a.startsWith("-"))
+            dirArg = a;
+    }
+    const dir = resolveSiteDir(dirArg);
+    const files = collectFiles(dir);
+    if (!files.some((f) => f.path === "index.html")) {
+        throw new Error(`${dir} 里没有 index.html,网站需要一个首页`);
+    }
+    const totalBytes = files.reduce((s, f) => s + f.bytes, 0);
+    console.log("");
+    console.log(`  部署目录  ${dir}`);
+    console.log(`  文件      ${files.length} 个,共 ${fmtBytes(totalBytes)}`);
+    // 站点名:--name > 上次用过的 > 交互询问(默认目录名;dist 等产物目录用项目名)
+    const remembered = readDeploys()[dir];
+    if (!name && remembered)
+        name = remembered;
+    if (!name) {
+        const projectName = BUILD_DIRS.includes(basename(dir)) ? basename(resolve(dir, "..")) : basename(dir);
+        name = await promptSiteName(slugify(projectName));
+    }
+    let start;
+    for (let attempt = 0; !start; attempt++) {
+        try {
+            start = await api(cfg, "POST", "/deploy/start", { site: name });
+        }
+        catch (e) {
+            const code = e.code;
+            const retriable = code === "site_name_taken" || code === "invalid_site_name";
+            if (!retriable || attempt >= 3)
+                throw e;
+            console.log(`  ${e.message}`);
+            if (!process.stdin.isTTY) {
+                // 非交互环境自动加后缀重试一次
+                if (attempt > 0)
+                    throw e;
+                name = `${name.slice(0, 25)}-${Math.random().toString(36).slice(2, 6)}`;
+            }
+            else {
+                name = await promptSiteName(`${name.slice(0, 25)}-${Math.random().toString(36).slice(2, 6)}`);
+            }
+        }
+    }
+    const tooBig = files.filter((f) => f.bytes > start.limits.max_file_bytes);
+    if (tooBig.length) {
+        throw new Error(`这些文件超过单文件上限 ${fmtBytes(start.limits.max_file_bytes)}:\n` +
+            tooBig.map((f) => `    ${f.path}(${fmtBytes(f.bytes)})`).join("\n"));
+    }
+    if (files.length > start.limits.max_files || totalBytes > start.limits.max_total_bytes) {
+        throw new Error(`超出配额:最多 ${start.limits.max_files} 个文件 / ${fmtBytes(start.limits.max_total_bytes)}。` +
+            `当前 ${files.length} 个 / ${fmtBytes(totalBytes)}`);
+    }
+    await uploadAll(cfg, start, files);
+    const fin = await api(cfg, "POST", "/deploy/finish", {
+        site: start.site,
+        deploy_id: start.deploy_id,
+    });
+    rememberSite(dir, start.site);
+    console.log(`  ✅ 部署完成,${fin.file_count} 个文件已上线`);
+    console.log("");
+    console.log(`  🌐 ${fin.url}`);
+    console.log("");
+    console.log("  把网址发给朋友就能看。改完代码再跑一次 u1s1 deploy 即可更新。");
+    console.log("");
+}

package/dist/embed.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 桌面版 App(packages/app)的嵌入 API,对外路径 "u1s1-cli/embed"(见
+ * package.json exports)。App 与 CLI 共享 ~/.u1s1 的登录态和 agentDir 配置,
+ * 这里只做转发,不放实现 —— 保证两个入口永远走同一份逻辑。
+ */
+export { agentDir, loadConfig, saveConfig, u1s1Dir, VERSION, type CliConfig, } from "./config.js";
+export { fetchMe, fetchModels } from "./api.js";
+export { apiOrigin, pollDeviceLogin, startDeviceLogin, type DeviceStart } from "./login.js";
+export { prepareWebEnv } from "./web.js";
+export { applyWebUiBranding, applyWebUiFrontend } from "./webui-brand.js";
+export { DASHBOARD_URL } from "./brand.js";

package/dist/embed.js

@@ -0,0 +1,11 @@
+/**
+ * 桌面版 App(packages/app)的嵌入 API,对外路径 "u1s1-cli/embed"(见
+ * package.json exports)。App 与 CLI 共享 ~/.u1s1 的登录态和 agentDir 配置,
+ * 这里只做转发,不放实现 —— 保证两个入口永远走同一份逻辑。
+ */
+export { agentDir, loadConfig, saveConfig, u1s1Dir, VERSION, } from "./config.js";
+export { fetchMe, fetchModels } from "./api.js";
+export { apiOrigin, pollDeviceLogin, startDeviceLogin } from "./login.js";
+export { prepareWebEnv } from "./web.js";
+export { applyWebUiBranding, applyWebUiFrontend } from "./webui-brand.js";
+export { DASHBOARD_URL } from "./brand.js";

package/dist/import/claude.d.ts

@@ -0,0 +1,3 @@
+import type { SourceAdapter, SourceSession } from "./types.js";
+export declare function hydrateClaudeSession(session: SourceSession): Promise<SourceSession>;
+export declare const claudeAdapter: SourceAdapter;

package/dist/import/codex.d.ts

@@ -0,0 +1,3 @@
+import type { SourceAdapter, SourceSession } from "./types.js";
+export declare function hydrateCodexSession(session: SourceSession): Promise<SourceSession>;
+export declare const codexAdapter: SourceAdapter;

package/dist/import/index.d.ts

@@ -0,0 +1 @@
+export declare function importCommand(args: string[]): Promise<void>;

package/dist/import/types.d.ts

@@ -0,0 +1,104 @@
+export type ImportSourceId = "claude" | "codex";
+export interface SourceSession {
+    source: ImportSourceId;
+    /** Stable id from the original tool (session uuid). */
+    sourceId: string;
+    sourcePath: string;
+    cwd: string;
+    title?: string;
+    startedAt?: number;
+    mtimeMs: number;
+}
+export interface DiscoverOpts {
+    /** If set, only sessions that belong to this working directory. */
+    cwd?: string;
+}
+export type ImportedContent = {
+    type: "text";
+    text: string;
+} | {
+    type: "thinking";
+    thinking: string;
+} | {
+    type: "toolCall";
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+};
+export interface ImportedUser {
+    role: "user";
+    text: string;
+    timestamp: number;
+}
+export interface ImportedAssistant {
+    role: "assistant";
+    content: ImportedContent[];
+    provider: string;
+    model: string;
+    api: string;
+    stopReason: "stop" | "length" | "toolUse" | "error" | "aborted";
+    usage?: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+    };
+    timestamp: number;
+}
+export interface ImportedToolResult {
+    role: "toolResult";
+    toolCallId: string;
+    toolName: string;
+    text: string;
+    isError: boolean;
+    timestamp: number;
+}
+export type ImportedMessage = ImportedUser | ImportedAssistant | ImportedToolResult;
+export interface ConvertedSession {
+    cwd: string;
+    title?: string;
+    messages: ImportedMessage[];
+}
+export interface SourceAdapter {
+    id: ImportSourceId;
+    label: string;
+    discover(opts: DiscoverOpts): SourceSession[];
+    convert(session: SourceSession): ConvertedSession;
+}
+export interface ImportRecord {
+    source: ImportSourceId;
+    sourceId: string;
+    sourcePath: string;
+    destPath: string;
+    cwd: string;
+    title?: string;
+    importedAt: string;
+}
+export interface ImportIndex {
+    version: 1;
+    items: Record<string, ImportRecord>;
+}
+export interface ImportOptions {
+    sources: ImportSourceId[];
+    /** Only this project. Omit to import every discovered session. */
+    cwd?: string;
+    dryRun: boolean;
+    force: boolean;
+    limit?: number;
+}
+export interface ImportResultItem {
+    source: ImportSourceId;
+    sourceId: string;
+    title: string;
+    cwd: string;
+    destPath?: string;
+    status: "imported" | "skipped" | "empty" | "error";
+    detail?: string;
+}
+export interface ImportSummary {
+    items: ImportResultItem[];
+    imported: number;
+    skipped: number;
+    empty: number;
+    errors: number;
+}

package/dist/import/util.d.ts

@@ -0,0 +1,26 @@
+export declare const MAX_TOOL_RESULT_CHARS = 80000;
+export declare const MAX_TEXT_CHARS = 200000;
+export declare const PREVIEW_TITLE_CHARS = 48;
+export declare function resolveExistingDir(path: string): string | undefined;
+export declare function listHomeClaudeDirs(): string[];
+export declare function uniqueExistingDirs(paths: Array<string | undefined>): string[];
+export declare function encodeClaudeProjectDir(cwd: string): string;
+export declare function samePath(a: string, b: string): boolean;
+/** Nearest git root at or above cwd. Stops at home so `~/` is never treated as a mega-project. */
+export declare function projectRoot(cwd: string): string | undefined;
+/** cwd + ancestors up to the git root (or just cwd when there is no repo). */
+export declare function projectAncestors(cwd: string): string[];
+/** Same folder, anywhere inside this git repo, or the repo root when you're in a subfolder. */
+export declare function sessionBelongsToCwd(sessionCwd: string, wanted: string): boolean;
+export declare function parseJsonLine(line: string): Record<string, unknown> | undefined;
+export declare function asRecord(value: unknown): Record<string, unknown> | undefined;
+export declare function asString(value: unknown): string | undefined;
+export declare function parseTime(value: unknown): number | undefined;
+export declare function truncateText(text: string, max: number): string;
+export declare function formatBytes(n: number): string;
+export declare function oneLine(text: string, max?: number): string;
+export declare function firstMeaningfulLine(text: string): string;
+export declare function parseArgsJson(raw: string): Record<string, unknown>;
+export declare function fileMtimeMs(path: string): number;
+export declare function isProbablyInjection(text: string): boolean;
+export declare function readFirstJsonObject(path: string): Record<string, unknown> | undefined;

package/dist/import/write.d.ts

@@ -0,0 +1,4 @@
+import type { ConvertedSession } from "./types.js";
+export declare function writeConvertedSession(converted: ConvertedSession, destCwd?: string): string;
+export declare function readJsonIfExists(path: string): unknown;
+export declare function writeJson(path: string, value: unknown): void;

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -5,6 +5,7 @@ import { cleanupBrandThemes, ensureBrandPrompt, ensureDefaultSettings, ensurePro
 import { printConsoleBanner } from "./brand.js";
 import { agentDir, apiModelToDef, isPortableInstall, loadConfig, MODELS, persistPreferredModel, PROVIDER_ID, readSettings, resolvePreferredModel, setModelsFromApi, VERSION, } from "./config.js";
 import { applyBrandUi, setUpdateNotice } from "./style.js";
+import { offerStarterTemplates } from "./templates.js";
 import { fetchModels } from "./api.js";
 const PACKAGE_NAME = "u1s1-cli";
 /**
@@ -167,6 +168,7 @@ async function runAgent(cfg, args) {
             name: "u1s1",
             factory: (pi) => {
                 applyBrandUi(pi, VERSION);
+                offerStarterTemplates(pi);
                 // pi 内置只有 /quit；补一个更常见的 /exit，方便新手退出
                 pi.registerCommand("exit", {
                     description: "退出 u1s1",
@@ -241,7 +243,7 @@ async function run() {
     }
     if (cmd === "--help" || cmd === "-h") {
         printConsoleBanner(VERSION);
-        console.log(" u1s1 命令:web(浏览器网页版)· web shortcut(桌面图标)· login / logout · model · usage · update · import");
+        console.log(" u1s1 命令:web(浏览器网页版)· web shortcut(桌面图标)· deploy(发布网页)· login / logout · model · usage · update · import");
         console.log("");
     }
     if (cmd === "web") {
@@ -257,6 +259,13 @@ async function run() {
         await webCommand(cfg, args.slice(1));
         return;
     }
+    if (cmd === "deploy") {
+        const { ensureAuth } = await import("./login.js");
+        const cfg = await ensureAuth();
+        const { deployCommand } = await import("./deploy.js");
+        await deployCommand(cfg, args.slice(1));
+        return;
+    }
     if (cmd === "login") {
         const { login } = await import("./login.js");
         await login(args[1]);