u1s1-cli 0.10.0 → 0.11.1

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

@@ -4,7 +4,9 @@ import { writeFileSync } from "node:fs";
 import { cleanupBrandThemes, ensureBrandPrompt, ensureDefaultSettings, ensureProviderModels, writeWebToolsExtension, } from "./agent-setup.js";
 import { printConsoleBanner } from "./brand.js";
 import { agentDir, apiModelToDef, isPortableInstall, loadConfig, MODELS, persistPreferredModel, PROVIDER_ID, readSettings, resolvePreferredModel, setModelsFromApi, VERSION, } from "./config.js";
+import { ensureSearchTools } from "./search-tools.js";
 import { applyBrandUi, setUpdateNotice } from "./style.js";
+import { offerStarterTemplates } from "./templates.js";
 import { fetchModels } from "./api.js";
 const PACKAGE_NAME = "u1s1-cli";
 /**
@@ -116,6 +118,9 @@ async function runAgent(cfg, args) {
     cleanupBrandThemes();
     ensureBrandPrompt();
     ensureDefaultSettings();
+    // 预 seed fd/rg(国内直连 GitHub 不通,pi 自己下不动);与取模型列表并行,
+    // 但必须在进 pi 之前就位,否则 pi 会自己去 GitHub 下载
+    const searchToolsReady = ensureSearchTools(cfg);
     // Fetch model list from server; fall back to built-in MODELS on error.
     // 服务端没开搜索(或老网关没有 features 字段)时不注册 web_search,模型就不会白调
     let webSearchEnabled = true;
@@ -137,6 +142,7 @@ async function runAgent(cfg, args) {
     process.env["U1S1_TOOLS_VIA_EXTENSION"] = "1";
     // hide pi's own "Run pi update" banner; users should run `u1s1 update` instead
     process.env["PI_SKIP_VERSION_CHECK"] = "1";
+    await searchToolsReady;
     const { CustomEditor, main } = await import("@earendil-works/pi-coding-agent");
     // 网页终端(如 Taikula)把 Shift+Enter 发成 ESC+CR(\x1b\r)。pi 在没开 Kitty
     // 协议时把它当成 Alt+Enter:空闲就直接发送,忙碌才排队。先改成 CSI-u 的
@@ -167,6 +173,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/search-tools.d.ts

@@ -0,0 +1,3 @@
+import { type CliConfig } from "./config.js";
+/** 缺哪个装哪个;都在(本地目录或 PATH)则秒退。失败只提示,不阻塞启动。 */
+export declare function ensureSearchTools(cfg: Pick<CliConfig, "baseUrl">): Promise<void>;

package/dist/search-tools.js

@@ -0,0 +1,153 @@
+import { spawnSync } from "node:child_process";
+import { chmodSync, createWriteStream, existsSync, mkdirSync, readdirSync, renameSync, rmSync } from "node:fs";
+import { arch, platform } from "node:os";
+import { join } from "node:path";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { agentDir } from "./config.js";
+/**
+ * 预 seed pi 的搜索组件(fd / ripgrep)到 ~/.u1s1/agent/bin。
+ *
+ * pi 首启发现缺 fd/rg 会从 GitHub 现下,国内直连基本不通:启动时连弹
+ * "Failed to download ... fetch failed",更糟的是 grep/find 工具运行时直接
+ * 报错,没有降级路径。这里在进 pi 之前从自家网关(/tools/<asset>,CF 边缘
+ * 代理 GitHub release,见 gateway/src/index.ts)把二进制放进 pi 的探测目录
+ * (探测顺序:agentDir/bin → PATH);探到本地文件后 pi 不再碰 GitHub。
+ * 任何失败都不阻塞启动——pi 自己的 GitHub 下载仍是兜底(有代理的用户能通)。
+ *
+ * 版本钉死而不是查 latest:免去对 GitHub API 的依赖,且 fd 10.4+ 不再发
+ * x86_64 macOS 产物,统一钉 10.3.0(与 pi 对 darwin-x64 的钉版一致)。
+ */
+const TOOLS = [
+    { bin: "fd", version: "10.3.0", pathNames: ["fd", "fdfind"], asset: fdAsset },
+    { bin: "rg", version: "15.2.0", pathNames: ["rg"], asset: rgAsset },
+];
+const binDir = join(agentDir, "bin");
+const DOWNLOAD_TIMEOUT_MS = 60_000;
+function archStr() {
+    const a = arch();
+    return a === "arm64" ? "aarch64" : a === "x64" ? "x86_64" : null;
+}
+function fdAsset(version) {
+    const a = archStr();
+    if (!a)
+        return null;
+    const p = platform();
+    if (p === "darwin")
+        return `fd-v${version}-${a}-apple-darwin.tar.gz`;
+    if (p === "linux")
+        return `fd-v${version}-${a}-unknown-linux-gnu.tar.gz`;
+    if (p === "win32")
+        return `fd-v${version}-${a}-pc-windows-msvc.zip`;
+    return null;
+}
+function rgAsset(version) {
+    const a = archStr();
+    if (!a)
+        return null;
+    const p = platform();
+    if (p === "darwin")
+        return `ripgrep-${version}-${a}-apple-darwin.tar.gz`;
+    // linux 上 arm64 用 gnu、x64 用 musl:与 pi 的资产选择保持一致
+    if (p === "linux") {
+        return a === "aarch64"
+            ? `ripgrep-${version}-aarch64-unknown-linux-gnu.tar.gz`
+            : `ripgrep-${version}-x86_64-unknown-linux-musl.tar.gz`;
+    }
+    if (p === "win32")
+        return `ripgrep-${version}-${a}-pc-windows-msvc.zip`;
+    return null;
+}
+/** 与 pi 的 commandExists 同语义:能 spawn 就算在 PATH 里(fd 也认 Debian 名 fdfind)。 */
+function inPath(names) {
+    return names.some((name) => {
+        const r = spawnSync(name, ["--version"], { stdio: "pipe" });
+        return r.error === undefined || r.error === null;
+    });
+}
+function run(command, cmdArgs) {
+    const r = spawnSync(command, cmdArgs, { stdio: "pipe" });
+    return !r.error && r.status === 0;
+}
+function extract(archive, dir) {
+    if (archive.endsWith(".zip")) {
+        // 只有 win32 会拿到 zip。System32 的 tar 是 bsdtar,认 zip;Git Bash 的
+        // GNU tar 不认——优先绝对路径,失败再退 powershell Expand-Archive。
+        const sysRoot = process.env["SystemRoot"] ?? process.env["WINDIR"];
+        const sysTar = sysRoot ? join(sysRoot, "System32", "tar.exe") : "tar.exe";
+        if (run(existsSync(sysTar) ? sysTar : "tar.exe", ["xf", archive, "-C", dir]))
+            return true;
+        return run("powershell.exe", [
+            "-NoLogo", "-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-Command",
+            "& { param($a,$d) $ErrorActionPreference='Stop'; Expand-Archive -LiteralPath $a -DestinationPath $d -Force }",
+            archive, dir,
+        ]);
+    }
+    return run("tar", ["xzf", archive, "-C", dir]);
+}
+/** 资产里的二进制可能嵌在版本号目录下(fd 是,rg 也是),递归找。 */
+function findBinary(root, name) {
+    const stack = [root];
+    while (stack.length > 0) {
+        const dir = stack.pop();
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            const full = join(dir, entry.name);
+            if (entry.isFile() && entry.name === name)
+                return full;
+            if (entry.isDirectory())
+                stack.push(full);
+        }
+    }
+    return null;
+}
+async function install(tool, baseUrl, binName) {
+    const asset = tool.asset(tool.version);
+    if (!asset)
+        throw new Error(`不支持的平台 ${platform()}/${arch()}`);
+    mkdirSync(binDir, { recursive: true });
+    const res = await fetch(new URL(`/tools/${asset}`, baseUrl), {
+        signal: AbortSignal.timeout(DOWNLOAD_TIMEOUT_MS),
+    });
+    if (!res.ok || !res.body)
+        throw new Error(`HTTP ${res.status}`);
+    const archive = join(binDir, asset);
+    // fd/rg 并行安装,解压目录按工具名+pid 隔离,避免互踩
+    const extractDir = join(binDir, `preseed_${tool.bin}_${process.pid}`);
+    try {
+        await pipeline(Readable.fromWeb(res.body), createWriteStream(archive));
+        mkdirSync(extractDir, { recursive: true });
+        if (!extract(archive, extractDir))
+            throw new Error(`解压失败 ${asset}`);
+        const found = findBinary(extractDir, binName);
+        if (!found)
+            throw new Error(`包内没有 ${binName}`);
+        renameSync(found, join(binDir, binName));
+        if (platform() !== "win32")
+            chmodSync(join(binDir, binName), 0o755);
+    }
+    finally {
+        rmSync(archive, { force: true });
+        rmSync(extractDir, { recursive: true, force: true });
+    }
+}
+/** 缺哪个装哪个;都在(本地目录或 PATH)则秒退。失败只提示,不阻塞启动。 */
+export async function ensureSearchTools(cfg) {
+    try {
+        const ext = platform() === "win32" ? ".exe" : "";
+        const missing = TOOLS.filter((t) => !existsSync(join(binDir, t.bin + ext)) && !inPath(t.pathNames));
+        if (missing.length === 0)
+            return;
+        console.log(`  正在安装搜索组件(${missing.map((t) => t.bin).join("/")})…`);
+        const results = await Promise.allSettled(missing.map((t) => install(t, cfg.baseUrl, t.bin + ext)));
+        for (let i = 0; i < results.length; i++) {
+            const r = results[i];
+            if (r.status === "rejected") {
+                const msg = r.reason instanceof Error ? r.reason.message : String(r.reason);
+                console.error(`  ${missing[i].bin} 安装失败(${msg}),稍后将尝试 GitHub 直连`);
+            }
+        }
+    }
+    catch {
+        // 预 seed 只是加速,任何意外都不该挡住启动
+    }
+}

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;