u1s1-cli 0.10.0 → 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/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",

package/dist/login.d.ts

@@ -0,0 +1,16 @@
+import { type CliConfig } from "./config.js";
+/** baseUrl 形如 https://api.u1s1.io/v1;auth 路由挂在同一域名的根路径。 */
+export declare function apiOrigin(cfg: CliConfig): string;
+export interface DeviceStart {
+    verify_url: string;
+    poll_secret: string;
+    interval: number;
+    expires_in: number;
+}
+/** 发起浏览器登录;网关太老或连不上时返回 null,退回手动粘贴。 */
+export declare function startDeviceLogin(origin: string): Promise<DeviceStart | null>;
+/** 轮询等浏览器那边批准;拿到 key 返回,过期返回 null。 */
+export declare function pollDeviceLogin(origin: string, start: DeviceStart): Promise<string | null>;
+export declare function login(keyArg?: string): Promise<CliConfig>;
+/** Returns a config that definitely has an apiKey, prompting the user if needed. */
+export declare function ensureAuth(): Promise<CliConfig>;

package/dist/login.js

@@ -18,11 +18,11 @@ function tryOpenBrowser(url) {
 }
 const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 /** baseUrl 形如 https://api.u1s1.io/v1;auth 路由挂在同一域名的根路径。 */
-function apiOrigin(cfg) {
+export function apiOrigin(cfg) {
     return cfg.baseUrl.replace(/\/v1\/?$/, "");
 }
 /** 发起浏览器登录;网关太老或连不上时返回 null,退回手动粘贴。 */
-async function startDeviceLogin(origin) {
+export async function startDeviceLogin(origin) {
     try {
         const resp = await fetch(`${origin}/auth/device/start`, { method: "POST" });
         if (!resp.ok)
@@ -42,7 +42,7 @@ async function startDeviceLogin(origin) {
     }
 }
 /** 轮询等浏览器那边批准;拿到 key 返回,过期返回 null。 */
-async function pollDeviceLogin(origin, start) {
+export async function pollDeviceLogin(origin, start) {
     const deadline = Date.now() + start.expires_in * 1000;
     while (Date.now() < deadline) {
         await sleep(start.interval * 1000);

package/dist/model.d.ts

@@ -0,0 +1 @@
+export declare function modelCommand(nameOrAlias?: string): Promise<void>;

package/dist/shortcut.d.ts

@@ -0,0 +1 @@
+export declare function createWebShortcut(): void;

package/dist/style.d.ts

@@ -0,0 +1,7 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export declare function setUpdateNotice(notice: string): void;
+/**
+ * Brand chrome is just the startup hero + window title; everything else
+ * (tool rows, thinking blocks, spinner) stays Pi's default UI.
+ */
+export declare function applyBrandUi(pi: ExtensionAPI, version: string): void;

package/dist/templates.d.ts

@@ -0,0 +1,2 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export declare function offerStarterTemplates(pi: ExtensionAPI): void;

package/dist/templates.js

@@ -0,0 +1,48 @@
+import { readdirSync } from "node:fs";
+/**
+ * 空目录首跑模板(roadmap-next #3):小白第一次在空文件夹里启动 u1s1,
+ * 面对空白输入框往往想不出第一句说什么。弹一个选择器给几个现成的小项目,
+ * 选中后把完整提示词放进输入框——不直接替用户发送,让他看到「原来就是
+ * 说这样一句话」,想改就改,回车才开跑。选「我自己说」或按 Esc 都不打扰。
+ */
+const TEMPLATES = [
+    {
+        label: "🏠 个人主页——介绍我自己的网页",
+        prompt: "帮我做一个个人主页网页,介绍我自己,放上我的爱好和联系方式,风格简洁好看,手机和电脑打开都正常。做完教我怎么在浏览器里预览。",
+    },
+    {
+        label: "📅 倒数日——距离某天还有多少天",
+        prompt: "做一个倒数日网页,可以输入日期和事件名,大字显示距离那天还有多少天,设计得可爱一点。做完教我怎么在浏览器里预览。",
+    },
+    {
+        label: "🖼️ 电子相册——可以翻页的照片墙",
+        prompt: "帮我做一个电子相册网页,照片可以左右翻页,先放几张占位图,并告诉我之后怎么换成自己的照片。做完教我怎么在浏览器里预览。",
+    },
+];
+const SELF_DESCRIBE = "✍️ 不用了,我自己说";
+/** 只看可见条目:.git / .DS_Store 这类隐藏文件不算「有东西」。读不了就当非空,不打扰。 */
+function isEmptyDir(dir) {
+    try {
+        return readdirSync(dir).filter((name) => !name.startsWith(".")).length === 0;
+    }
+    catch {
+        return false;
+    }
+}
+let offered = false;
+export function offerStarterTemplates(pi) {
+    pi.on("session_start", async (_event, ctx) => {
+        // /clear 等新会话也会触发 session_start,每次启动只弹一次
+        if (ctx.mode !== "tui" || offered)
+            return;
+        if (!isEmptyDir(process.cwd()))
+            return;
+        offered = true;
+        const choice = await ctx.ui.select("这个文件夹还是空的,挑一个现成的小项目直接开跑?", [...TEMPLATES.map((t) => t.label), SELF_DESCRIBE]);
+        const t = TEMPLATES.find((x) => x.label === choice);
+        if (!t)
+            return;
+        ctx.ui.setEditorText(t.prompt);
+        ctx.ui.notify("提示词放进输入框了:想改哪句直接改,按回车开跑", "info");
+    });
+}

package/dist/tools.d.ts

@@ -0,0 +1,18 @@
+import { Type } from "typebox";
+import type { CliConfig } from "./config.js";
+/** 联网搜索工具:走 u1s1 网关代理,上游 key 不落到用户机器上。 */
+export declare function createSearchTool(cfg: Pick<CliConfig, "baseUrl" | "apiKey">): import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
+    query: Type.TString;
+    maxResults: Type.TOptional<Type.TNumber>;
+}>, {
+    query: string;
+    count: number;
+}, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
+/** 抓网页:纯客户端出网,不经过我们的服务器,也不额外计费。 */
+export declare const webFetchTool: import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
+    url: Type.TString;
+}>, {
+    url: string;
+    contentType: string;
+    chars: number;
+}, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;

package/dist/update.d.ts

@@ -0,0 +1,8 @@
+export declare const VERSION: string;
+export declare const PACKAGE_NAME = "u1s1-cli";
+/** Detect the package manager that installed u1s1. */
+export declare function detectPackageManager(): string;
+/** Fetch the latest published version from npm registry. */
+export declare function getLatestVersion(): Promise<string | undefined>;
+export declare function compareVersions(a: string, b: string): number;
+export declare function update(): Promise<void>;

package/dist/usage.d.ts

@@ -0,0 +1 @@
+export declare function usage(): Promise<void>;

package/dist/web.d.ts

@@ -0,0 +1,13 @@
+import { type CliConfig } from "./config.js";
+/**
+ * `u1s1 web` — 浏览器网页版。薄包装 pi-web-ui 的服务器:注入我们的 agentDir
+ * (品牌 prompt / models.json / 会话与 TUI 共享)和登录 key,其余原样透传
+ * (--port / --cwd / --no-browser)。
+ */
+/**
+ * 启动 pi-web-ui 服务器前的公共准备:品牌 prompt、模型列表、auth.json 凭据、
+ * 联网工具扩展、默认模型,并返回子进程需要的环境变量。CLI(`u1s1 web`)和
+ * 桌面版 App(packages/app,经 "u1s1-cli/embed" 引入)共用这一份逻辑。
+ */
+export declare function prepareWebEnv(cfg: CliConfig): Promise<Record<string, string>>;
+export declare function webCommand(cfg: CliConfig, args: string[]): Promise<void>;